Modules#

ZLL Commissioning

ZLL Commissioning Client#

API and Callbacks for the ZLL Commissioning Cluster Client Component.

Client side implementation of the ZigBee 3.0 touchlink commissioning mechanism.

API#

EmberStatus

Initiate the touch link procedure.

EmberStatus

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

EmberStatus

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

EmberStatus

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

void

Abort the touch link procedure.

API Documentation#

emberAfZllInitiateTouchLink#

EmberStatus emberAfZllInitiateTouchLink (void )

Initiate the touch link procedure.

Parameters
N/A

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.


Definition at line 53 of file app/framework/plugin/zll-commissioning-client/zll-commissioning-client.h

emberAfZllDeviceInformationRequest#

EmberStatus emberAfZllDeviceInformationRequest (void )

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

Parameters
N/A

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.


Definition at line 70 of file app/framework/plugin/zll-commissioning-client/zll-commissioning-client.h

emberAfZllIdentifyRequest#

EmberStatus emberAfZllIdentifyRequest (void )

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

Parameters
N/A

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.


Definition at line 87 of file app/framework/plugin/zll-commissioning-client/zll-commissioning-client.h

emberAfZllResetToFactoryNewRequest#

EmberStatus emberAfZllResetToFactoryNewRequest (void )

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

Parameters
N/A

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.


Definition at line 103 of file app/framework/plugin/zll-commissioning-client/zll-commissioning-client.h

emberAfZllAbortTouchLink#

void emberAfZllAbortTouchLink (void )

Abort the touch link procedure.

Parameters
N/A

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


Definition at line 110 of file app/framework/plugin/zll-commissioning-client/zll-commissioning-client.h