Modules#

Zll Commissioning Common

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.

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
}
enum
EMBER_RADIO_POWER_MODE_RX_ON
EMBER_RADIO_POWER_MODE_OFF
}

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 71 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 77 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 85 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 94 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 103 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 189 of file app/framework/plugin/zll-commissioning-common/zll-commissioning-common.h

EmberRadioPowerModeEnum#

EmberRadioPowerModeEnum
Enumerator
EMBER_RADIO_POWER_MODE_RX_ON
EMBER_RADIO_POWER_MODE_OFF

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

Variable Documentation#

emAfZllNetwork#

EmberZllNetwork emAfZllNetwork

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

emAfZllFlags#

uint16_t emAfZllFlags

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

emAfInitiatorRejoinRetryCount#

uint8_t emAfInitiatorRejoinRetryCount

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

Macro Definition Documentation#

touchLinkInProgress#

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

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

scanForTouchLink#

#define scanForTouchLink
Value:
()

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

scanForDeviceInformation#

#define scanForDeviceInformation
Value:
()

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

scanForIdentify#

#define scanForIdentify
Value:
()

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

scanForReset#

#define scanForReset
Value:
()

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

targetNetworkFound#

#define targetNetworkFound
Value:
()

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

abortingTouchLink#

#define abortingTouchLink
Value:
()

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

scanComplete#

#define scanComplete
Value:
()

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

touchLinkTarget#

#define touchLinkTarget
Value:
()

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

formingNetwork#

#define formingNetwork
Value:
()

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

resettingToFactoryNew#

#define resettingToFactoryNew
Value:
()

Definition at line 222 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 228 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 229 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 230 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 232 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 233 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 234 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 235 of file app/framework/plugin/zll-commissioning-common/zll-commissioning-common.h

ZLL_HEADER_OVERHEAD#

#define ZLL_HEADER_OVERHEAD
Value:
7

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

debugPrintln#

#define debugPrintln

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

debugPrint#

#define debugPrint

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

debugExec#

#define debugExec

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

emberAfPluginZllCommissioningInitialSecurityStateCallback#

#define emberAfPluginZllCommissioningInitialSecurityStateCallback
Value:
emberAfPluginZllCommissioningCommonInitialSecurityStateCallback

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

emberAfPluginZllCommissioningTouchLinkCompleteCallback#

#define emberAfPluginZllCommissioningTouchLinkCompleteCallback
Value:
emberAfPluginZllCommissioningCommonTouchLinkCompleteCallback

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

emberAfPluginZllCommissioningResetToFactoryNewCallback#

#define emberAfPluginZllCommissioningResetToFactoryNewCallback
Value:
emberAfPluginZllCommissioningCommonResetToFactoryNewCallback

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