esp-ble-prov

!NPM version

> An ESP32 WiFi provisioning library for the web, using WebBluetoothAPI.

Features

- WiFi provisioning supporting Security0 and Security1.
- Automatic discovery of provisioning and custom endpoints.

Installation

``bash
$ npm install esp-ble-prov
`

`typescript
const textDecoder = new TextDecoder();
const textEncoder = new TextEncoder();

const provisioner = new ESPProvisioner({
deviceNamePrefix: "PROV_",
serviceUUID: "YOUR_SERVICE_UUID",
security: new Security1({ pop: "test" }) // or new Security1() without PoP. Security0 is the default
})

// Scan for available devices and connect to one
await provisioner.connect();

// Establish Security0 session
await provisioner.establishSession();

// Scan for available WiFi networks
const networks = await provisioner.scan();

// Read value from custom endpoint
let deviceId = await provisioner.readValueFromEndpoint("device-id")
.then(value => textDecoder.decode(value));

// Write value to custom endpoint
await provisioner.writeValueToEndpoint("device-id", textEncoder.encode("test"));

// Connect to WiFi
await provisioner.sendCredentials({
ssid,
passphrase: textEncoder.encode(passphrase),
bssid,
channel
}).then(() => {
console.log("Successfully connected to WiFi!")
}).catch(() => {
console.log("Failed to connect to WiFi")
})

// Reset provisiong state
await provisioner.ctrlReset();

// Reprov
await provisioner.ctrlReprov();
``

Contributing

Feel free to contribute to the project.
Currently not implemented features:

- Security2 Session