ZLL Commissioning Client#

emberAfZllInitiateTouchLink#

EmberStatus emberAfZllInitiateTouchLink (void)

Initiate the touch link procedure.

This function causes the stack to broadcast a series of ScanRequest commands via inter-PAN messaging. The plugin selects the target that sent a ScanResponse command with the strongest RSSI and attempts to link with it. If touch linking completes successfully, the plugin calls emberAfPluginZllCommissioningTouchLinkCompleteCallback with information about the network and the target. If touch linking fails, the plugin calls emberAfPluginZllCommissioningTouchLinkFailedCallback.

Returns

• An EmberStatus value that indicates the success or failure of the command.

emberAfZllDeviceInformationRequest#

EmberStatus emberAfZllDeviceInformationRequest (void)

Initiate a touch link to retrieve information about a target device.

As with a traditional touch link, this function causes the stack to broadcast messages to discover a target device. When the target is selected (based on RSSI), the plugin will retrieve information about it by unicasting a series of DeviceInformationRequest commands via inter-PAN messaging. If the process completes successfully, the plugin calls emberAfPluginZllCommissioningTouchLinkCompleteCallback with information about the target. If touch linking fails, the plugin calls emberAfPluginZllCommissioningTouchLinkFailedCallback.

Returns

• An EmberStatus value that indicates the success or failure of the command.

emberAfZllIdentifyRequest#

EmberStatus emberAfZllIdentifyRequest (void)

Initiate a touch link to cause a target device to identify itself.

As with a traditional touch link, this function causes the stack to broadcast messages to discover a target device. When the target is selected (based on RSSI), the plugin will cause it to identify itself by unicasting an IdentifyRequest command via inter-PAN messaging. If the process completes successfully, the plugin calls emberAfPluginZllCommissioningTouchLinkCompleteCallback with information about the target. If touch linking fails, the plugin calls emberAfPluginZllCommissioningTouchLinkFailedCallback.

Returns

• An EmberStatus value that indicates the success or failure of the command.

emberAfZllResetToFactoryNewRequest#

EmberStatus emberAfZllResetToFactoryNewRequest (void)

Initiate a touch link for the purpose of resetting a target device.

As with a traditional touch link, this function causes the stack to broadcast messages to discover a target device. When the target is selected (based on RSSI), the plugin will reset it by unicasting a ResetToFactoryNewRequest command via inter-PAN messaging. If the process completes successfully, the plugin calls emberAfPluginZllCommissioningTouchLinkCompleteCallback with information about the target. If touch linking fails, the plugin calls emberAfPluginZllCommissioningTouchLinkFailedCallback.

Returns

• An EmberStatus value that indicates the success or failure of the command.

emberAfZllAbortTouchLink#

void emberAfZllAbortTouchLink (void)

Abort the touch link procedure.

This function can be called to cancel the touch link procedure. This can be useful, for example, if the touch link target is incorrect.