provision

abstract suspend fun provision(device: UnprovisionedDevice, networkKey: NetworkKey, unicastAddress: MeshAddress.UnicastAddress, oobAuth: OobAuthentication = OobAuthentication.None): ProvisioningResult

Provision a discovered unprovisioned device.

Runs the full provisioning protocol and returns a ProvisioningResult containing the new MeshNode and provisioning data.

The node is NOT automatically added to any MeshNetwork. The caller must call network.addNode(result.node) to add it.

Return

The provisioning result with the new node.

Parameters

device

The unprovisioned device to provision.

networkKey

The NetKey to share with the device.

unicastAddress

The unicast address to assign to the primary element.

oobAuth

The OOB authentication method (default: None).

Throws

if provisioning fails at any phase.