ZLL Commissioning Common#

API and Callbacks for the ZLL Commissioning Common Component.

Common code for the ZigBee 3.0 touchlink commissioning mechanism. This component is required for both server and client side implementations.

Modules#

Zll Commissioning Common

API#

Generate a random network key and initializes the security state of the device.

bool

Indicate whether a touch link procedure is currently in progress.

void

Reset the local device to a factory new state.

Disable touchlink processing.

Enable touchlink processing.

Enumerations#

enum
INITIAL = 0x0000
SCAN_FOR_TOUCH_LINK = 0x0001
SCAN_FOR_DEVICE_INFORMATION = 0x0002
SCAN_FOR_IDENTIFY = 0x0004
SCAN_FOR_RESET = 0x0008
TARGET_NETWORK_FOUND = 0x0010
ABORTING_TOUCH_LINK = 0x0020
SCAN_COMPLETE = 0x0040
TOUCH_LINK_TARGET = 0x0080
FORMING_NETWORK = 0x0100
RESETTING_TO_FACTORY_NEW = 0x0200
}

Macros#

#define
#define
#define
#define
#define
#define
#define
#define
#define
emberAfPluginZllCommissioningInitialSecurityStateCallback emberAfPluginZllCommissioningCommonInitialSecurityStateCallback
#define
emberAfPluginZllCommissioningTouchLinkCompleteCallback emberAfPluginZllCommissioningCommonTouchLinkCompleteCallback
#define
emberAfPluginZllCommissioningResetToFactoryNewCallback emberAfPluginZllCommissioningCommonResetToFactoryNewCallback

API Documentation#

emberAfZllSetInitialSecurityState#

EmberStatus emberAfZllSetInitialSecurityState (void)

Generate a random network key and initializes the security state of the device.

Parameters
N/A

This function is a convenience wrapper for emberZllSetInitialSecurityState, which must be called before starting or joining a network. The plugin initializes the security state for the initiator during touch linking. The target must initialize its own security state prior to forming a network either by using this function or by calling emberZllSetInitialSecurityState directly.

Returns

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


Definition at line 62 of file app/framework/plugin/zll-commissioning-common/zll-commissioning-common.h

emberAfZllTouchLinkInProgress#

bool emberAfZllTouchLinkInProgress (void)

Indicate whether a touch link procedure is currently in progress.

Parameters
N/A

Returns

  • True if a touch link is in progress or false otherwise.


Definition at line 68 of file app/framework/plugin/zll-commissioning-common/zll-commissioning-common.h

emberAfZllResetToFactoryNew#

void emberAfZllResetToFactoryNew (void)

Reset the local device to a factory new state.

Parameters
N/A

This function causes the device to leave the network and clear its network parameters, resets its attributes to their default values, and clears the group and scene tables.


Definition at line 76 of file app/framework/plugin/zll-commissioning-common/zll-commissioning-common.h

emberAfZllDisable#

EmberStatus emberAfZllDisable (void)

Disable touchlink processing.

Parameters
N/A

This function will cause the device to refuse network start/join requests if it receives them and will not allow touchlinking. Note that this will have the effect of overriding the emberAfZllNoTouchlinkForNFN function.


Definition at line 85 of file app/framework/plugin/zll-commissioning-common/zll-commissioning-common.h

emberAfZllEnable#

EmberStatus emberAfZllEnable (void)

Enable touchlink processing.

Parameters
N/A

This function will cause the device to accept network start/join requests if it receives them and will not allow touchlinking. Note that this will have the effect of overriding the emberAfZllNoTouchlinkForNFN function.


Definition at line 94 of file app/framework/plugin/zll-commissioning-common/zll-commissioning-common.h

Enumeration Documentation#

StateEnum#

StateEnum
Enumerator
INITIAL
SCAN_FOR_TOUCH_LINK
SCAN_FOR_DEVICE_INFORMATION
SCAN_FOR_IDENTIFY
SCAN_FOR_RESET
TARGET_NETWORK_FOUND
ABORTING_TOUCH_LINK
SCAN_COMPLETE
TOUCH_LINK_TARGET
FORMING_NETWORK
RESETTING_TO_FACTORY_NEW

Definition at line 180 of file app/framework/plugin/zll-commissioning-common/zll-commissioning-common.h

Variable Documentation#

sli_zigbee_af_zll_network#

EmberZllNetwork sli_zigbee_af_zll_network

Definition at line 161 of file app/framework/plugin/zll-commissioning-common/zll-commissioning-common.h

sli_zigbee_af_zll_flags#

uint16_t sli_zigbee_af_zll_flags

Definition at line 162 of file app/framework/plugin/zll-commissioning-common/zll-commissioning-common.h

sli_zigbee_af_initiatorRejoinRetryCount#

uint8_t sli_zigbee_af_initiatorRejoinRetryCount

Definition at line 163 of file app/framework/plugin/zll-commissioning-common/zll-commissioning-common.h

Macro Definition Documentation#

touchLinkInProgress#

#define touchLinkInProgress
Value:
(sli_zigbee_af_zll_flags \
& (SCAN_FOR_TOUCH_LINK \
| SCAN_FOR_DEVICE_INFORMATION \
| SCAN_FOR_IDENTIFY \
| SCAN_FOR_RESET \
| TOUCH_LINK_TARGET))

Definition at line 198 of file app/framework/plugin/zll-commissioning-common/zll-commissioning-common.h

scanForTouchLink#

#define scanForTouchLink
Value:
()

Definition at line 204 of file app/framework/plugin/zll-commissioning-common/zll-commissioning-common.h

scanForDeviceInformation#

#define scanForDeviceInformation
Value:
()

Definition at line 205 of file app/framework/plugin/zll-commissioning-common/zll-commissioning-common.h

scanForIdentify#

#define scanForIdentify
Value:
()

Definition at line 206 of file app/framework/plugin/zll-commissioning-common/zll-commissioning-common.h

scanForReset#

#define scanForReset
Value:
()

Definition at line 207 of file app/framework/plugin/zll-commissioning-common/zll-commissioning-common.h

targetNetworkFound#

#define targetNetworkFound
Value:
()

Definition at line 208 of file app/framework/plugin/zll-commissioning-common/zll-commissioning-common.h

abortingTouchLink#

#define abortingTouchLink
Value:
()

Definition at line 209 of file app/framework/plugin/zll-commissioning-common/zll-commissioning-common.h

scanComplete#

#define scanComplete
Value:
()

Definition at line 210 of file app/framework/plugin/zll-commissioning-common/zll-commissioning-common.h

touchLinkTarget#

#define touchLinkTarget
Value:
()

Definition at line 211 of file app/framework/plugin/zll-commissioning-common/zll-commissioning-common.h

formingNetwork#

#define formingNetwork
Value:
()

Definition at line 212 of file app/framework/plugin/zll-commissioning-common/zll-commissioning-common.h

resettingToFactoryNew#

#define resettingToFactoryNew
Value:
()

Definition at line 213 of file app/framework/plugin/zll-commissioning-common/zll-commissioning-common.h

ZLL_FRAME_CONTROL_LEGACY#

#define ZLL_FRAME_CONTROL_LEGACY
Value:
0x00

Definition at line 219 of file app/framework/plugin/zll-commissioning-common/zll-commissioning-common.h

ZLL_FRAME_CONTROL_CLIENT_TO_SERVER#

#define ZLL_FRAME_CONTROL_CLIENT_TO_SERVER
Value:
0x11

Definition at line 220 of file app/framework/plugin/zll-commissioning-common/zll-commissioning-common.h

ZLL_FRAME_CONTROL_SERVER_TO_CLIENT#

#define ZLL_FRAME_CONTROL_SERVER_TO_CLIENT
Value:
0x19

Definition at line 221 of file app/framework/plugin/zll-commissioning-common/zll-commissioning-common.h

ZLL_HEADER_FRAME_CONTROL_OFFSET#

#define ZLL_HEADER_FRAME_CONTROL_OFFSET
Value:
0

Definition at line 223 of file app/framework/plugin/zll-commissioning-common/zll-commissioning-common.h

ZLL_HEADER_SEQUENCE_NUMBER_OFFSET#

#define ZLL_HEADER_SEQUENCE_NUMBER_OFFSET
Value:
1

Definition at line 224 of file app/framework/plugin/zll-commissioning-common/zll-commissioning-common.h

ZLL_HEADER_COMMAND_ID_OFFSET#

#define ZLL_HEADER_COMMAND_ID_OFFSET
Value:
2

Definition at line 225 of file app/framework/plugin/zll-commissioning-common/zll-commissioning-common.h

ZLL_HEADER_TRANSACTION_ID_OFFSET#

#define ZLL_HEADER_TRANSACTION_ID_OFFSET
Value:
3

Definition at line 226 of file app/framework/plugin/zll-commissioning-common/zll-commissioning-common.h

ZLL_HEADER_OVERHEAD#

#define ZLL_HEADER_OVERHEAD
Value:
7

Definition at line 227 of file app/framework/plugin/zll-commissioning-common/zll-commissioning-common.h

debugPrintln#

#define debugPrintln

Definition at line 236 of file app/framework/plugin/zll-commissioning-common/zll-commissioning-common.h

debugPrint#

#define debugPrint

Definition at line 237 of file app/framework/plugin/zll-commissioning-common/zll-commissioning-common.h

debugExec#

#define debugExec

Definition at line 238 of file app/framework/plugin/zll-commissioning-common/zll-commissioning-common.h

emberAfPluginZllCommissioningInitialSecurityStateCallback#

#define emberAfPluginZllCommissioningInitialSecurityStateCallback
Value:
emberAfPluginZllCommissioningCommonInitialSecurityStateCallback

Definition at line 242 of file app/framework/plugin/zll-commissioning-common/zll-commissioning-common.h

emberAfPluginZllCommissioningTouchLinkCompleteCallback#

#define emberAfPluginZllCommissioningTouchLinkCompleteCallback
Value:
emberAfPluginZllCommissioningCommonTouchLinkCompleteCallback

Definition at line 244 of file app/framework/plugin/zll-commissioning-common/zll-commissioning-common.h

emberAfPluginZllCommissioningResetToFactoryNewCallback#

#define emberAfPluginZllCommissioningResetToFactoryNewCallback
Value:
emberAfPluginZllCommissioningCommonResetToFactoryNewCallback

Definition at line 246 of file app/framework/plugin/zll-commissioning-common/zll-commissioning-common.h