react-native-esp-idf-provisioning
v0.2.0
Published
Android and iOS wrapper for ESP IDF provisioning
Downloads
3
Maintainers
Readme
react-native-esp-idf-provisioning
Android (not yet) and iOS wrapper for ESP IDF provisioning.
Installation
npm install @orbital-systems/react-native-esp-idf-provisioning
Usage
import {
ESPProvisionManager,
ESPDevice,
ESPTransport,
ESPSecurity,
} from '@orbital-systems/react-native-esp-idf-provisioning';
// Method 1.
// Get devices...
const devices = ESPProvisionManager.searchESPDevices('prefix');
// ... and select device (using picklist, dropdown, w/e)
const device = devices[0];
// Method 2.
// If you know device name and transport/security settings, create a device class instance
const device = new ESPDevice({
name: 'name',
transport: ESPTransport.ble,
security: ESPSecurity.secure2,
});
// Connect to device with proofOfPossesion
const proofOfPossesion = 'pop';
await device.connect(proofOfPosession);
// Get wifi list
const wifiList = await device.scanWifiList();
// Provision device
const ssid = 'ssid';
const passphrase = 'passphrase';
await device.provision(ssid, passphrase);
// Disconnect
device.disconnect();
Enums
enum ESPTransport {
ble = 'ble',
softap = 'softap',
}
enum ESPSecurity {
unsecure = 0,
secure = 1,
secure2 = 2,
}
enum ESPWifiAuthMode {
open = 0,
wep = 1,
wpa2Enterprise = 2,
wpa2Psk = 3,
wpaPsk = 4,
wpaWpa2Psk = 5,
}
Permissions
Android
See AndroidManifest.xml in the example project.
iOS
Since iOS 13, apps that want to access SSID (Wi-Fi network name) are required to have the location permission. Add key
NSLocationWhenInUseUsageDescription
in Info.plist with proper description. This permission is required to verify iOS device is currently connected with the SoftAP.Since iOS 14, apps that communicate over local network are required to have the local network permission. Add key
NSLocalNetworkUsageDescription
in Info.plist with proper description. This permission is required to send/receive provisioning data with the SoftAP devices.
Contributing
See the contributing guide to learn how to contribute to the repository and the development workflow.
License
MIT
Made with create-react-native-library