otCommissionerStart(otInstance *aInstance, otCommissionerStateCallback aStateCallback, otCommissionerJoinerCallback aJoinerCallback, void *aCallbackContext)

Enables the Thread Commissioner role.

otError

otCommissionerStop(otInstance *aInstance)

Disables the Thread Commissioner role.

const char *

otCommissionerGetId(otInstance *aInstance)

Returns the Commissioner Id.

otError

otCommissionerSetId(otInstance *aInstance, const char *aId)

Sets the Commissioner Id.

otError

otCommissionerAddJoiner(otInstance *aInstance, const otExtAddress *aEui64, const char *aPskd, uint32_t aTimeout)

Adds a Joiner entry.

otError

otCommissionerAddJoinerWithDiscerner(otInstance *aInstance, const otJoinerDiscerner *aDiscerner, const char *aPskd, uint32_t aTimeout)

Adds a Joiner entry with a given Joiner Discerner value.

otError

otCommissionerGetNextJoinerInfo(otInstance *aInstance, uint16_t *aIterator, otJoinerInfo *aJoiner)

Get joiner info at aIterator position.

otError

otCommissionerRemoveJoiner(otInstance *aInstance, const otExtAddress *aEui64)

Removes a Joiner entry.

otError

otCommissionerRemoveJoinerWithDiscerner(otInstance *aInstance, const otJoinerDiscerner *aDiscerner)

Removes a Joiner entry.

const char *

otCommissionerGetProvisioningUrl(otInstance *aInstance)

Gets the Provisioning URL.

otError

otCommissionerSetProvisioningUrl(otInstance *aInstance, const char *aProvisioningUrl)

Sets the Provisioning URL.

otError

otCommissionerAnnounceBegin(otInstance *aInstance, uint32_t aChannelMask, uint8_t aCount, uint16_t aPeriod, const otIp6Address *aAddress)

Sends an Announce Begin message.

otError

otCommissionerEnergyScan(otInstance *aInstance, uint32_t aChannelMask, uint8_t aCount, uint16_t aPeriod, uint16_t aScanDuration, const otIp6Address *aAddress, otCommissionerEnergyReportCallback aCallback, void *aContext)

Sends an Energy Scan Query message.

otError

otCommissionerPanIdQuery(otInstance *aInstance, uint16_t aPanId, uint32_t aChannelMask, const otIp6Address *aAddress, otCommissionerPanIdConflictCallback aCallback, void *aContext)

Sends a PAN ID Query message.

otError

otCommissionerSendMgmtGet(otInstance *aInstance, const uint8_t *aTlvs, uint8_t aLength)

Sends MGMT_COMMISSIONER_GET.

otError

otCommissionerSendMgmtSet(otInstance *aInstance, const otCommissioningDataset *aDataset, const uint8_t *aTlvs, uint8_t aLength)

Sends MGMT_COMMISSIONER_SET.

uint16_t

otCommissionerGetSessionId(otInstance *aInstance)

Returns the Commissioner Session ID.

otCommissionerState

otCommissionerGetState(otInstance *aInstance)

Returns the Commissioner State.

Macros#

#define

OT_COMMISSIONING_PASSPHRASE_MIN_SIZE 6

Minimum size of the Commissioning Passphrase.

#define

OT_COMMISSIONING_PASSPHRASE_MAX_SIZE 255

Maximum size of the Commissioning Passphrase.

#define

OT_PROVISIONING_URL_MAX_SIZE 64

Max size (number of chars) in Provisioning URL string (excludes null char).

#define

OT_STEERING_DATA_MAX_LENGTH 16

Max steering data length (bytes)

#define

OT_JOINER_MAX_PSKD_LENGTH 32

Maximum string length of a Joiner PSKd (does not include null char).

Enumeration Documentation#

otCommissionerState#

otCommissionerState

Defines the Commissioner State.

Enumerator
OT_COMMISSIONER_STATE_DISABLED	Commissioner role is disabled.
OT_COMMISSIONER_STATE_PETITION	Currently petitioning to become a Commissioner.
OT_COMMISSIONER_STATE_ACTIVE	Commissioner role is active.

Definition at line 62 of file include/openthread/commissioner.h

otCommissionerJoinerEvent#

otCommissionerJoinerEvent

Defines a Joiner Event on the Commissioner.

Enumerator
OT_COMMISSIONER_JOINER_START
OT_COMMISSIONER_JOINER_CONNECTED
OT_COMMISSIONER_JOINER_FINALIZE
OT_COMMISSIONER_JOINER_END
OT_COMMISSIONER_JOINER_REMOVED

Definition at line 73 of file include/openthread/commissioner.h

otJoinerInfoType#

otJoinerInfoType

Defines a Joiner Info Type.

Enumerator
OT_JOINER_INFO_TYPE_ANY	Accept any Joiner (no EUI64 or Discerner is specified).
OT_JOINER_INFO_TYPE_EUI64	Joiner EUI-64 is specified (`mSharedId.mEui64` in `otJoinerInfo`).
OT_JOINER_INFO_TYPE_DISCERNER	Joiner Discerner is specified (`mSharedId.mDiscerner` in `otJoinerInfo`).

Definition at line 131 of file include/openthread/commissioner.h

Typedef Documentation#

otCommissionerState#

typedef enum otCommissionerState otCommissionerState

Defines the Commissioner State.

Definition at line 67 of file include/openthread/commissioner.h

otCommissionerJoinerEvent#

typedef enum otCommissionerJoinerEvent otCommissionerJoinerEvent

Defines a Joiner Event on the Commissioner.

Definition at line 80 of file include/openthread/commissioner.h

otSteeringData#

typedef struct otSteeringData otSteeringData

Represents the steering data.

Definition at line 97 of file include/openthread/commissioner.h

otCommissioningDataset#

typedef struct otCommissioningDataset otCommissioningDataset

Represents a Commissioning Dataset.

Definition at line 114 of file include/openthread/commissioner.h

otJoinerPskd#

typedef struct otJoinerPskd otJoinerPskd

Represents a Joiner PSKd.

Definition at line 125 of file include/openthread/commissioner.h

otJoinerInfoType#

typedef enum otJoinerInfoType otJoinerInfoType

Defines a Joiner Info Type.

Definition at line 136 of file include/openthread/commissioner.h

otJoinerInfo#

typedef struct otJoinerInfo otJoinerInfo

Represents a Joiner Info.

Definition at line 152 of file include/openthread/commissioner.h

otCommissionerStateCallback#

typedef void(* otCommissionerStateCallback) (otCommissionerState aState, void *aContext) )(otCommissionerState aState, void *aContext)

Pointer is called whenever the commissioner state changes.

Parameters

[in]	aState	The Commissioner state.
[in]	aContext	A pointer to application-specific context.

Definition at line 161 of file include/openthread/commissioner.h

otCommissionerJoinerCallback#

typedef void(* otCommissionerJoinerCallback) (otCommissionerJoinerEvent aEvent, const otJoinerInfo *aJoinerInfo, const otExtAddress *aJoinerId, void *aContext) )(otCommissionerJoinerEvent aEvent, const otJoinerInfo *aJoinerInfo, const otExtAddress *aJoinerId, void *aContext)

Pointer is called whenever the joiner state changes.

Parameters

[in]	aEvent	The joiner event type.
[in]	aJoinerInfo	A pointer to the Joiner Info.
[in]	aJoinerId	A pointer to the Joiner ID (if not known, it will be NULL).
[in]	aContext	A pointer to application-specific context.

Definition at line 172 of file include/openthread/commissioner.h

otCommissionerEnergyReportCallback#

typedef void(* otCommissionerEnergyReportCallback) (uint32_t aChannelMask, const uint8_t *aEnergyList, uint8_t aEnergyListLength, void *aContext) )(uint32_t aChannelMask, const uint8_t *aEnergyList, uint8_t aEnergyListLength, void *aContext)

Pointer is called when the Commissioner receives an Energy Report.

Parameters

[in]	aChannelMask	The channel mask value.
[in]	aEnergyList	A pointer to the energy measurement list.
[in]	aEnergyListLength	Number of entries in `aEnergyListLength`.
[in]	aContext	A pointer to application-specific context.

Definition at line 369 of file include/openthread/commissioner.h

otCommissionerPanIdConflictCallback#

typedef void(* otCommissionerPanIdConflictCallback) (uint16_t aPanId, uint32_t aChannelMask, void *aContext) )(uint16_t aPanId, uint32_t aChannelMask, void *aContext)

Pointer is called when the Commissioner receives a PAN ID Conflict message.

Parameters

[in]	aPanId	The PAN ID value.
[in]	aChannelMask	The channel mask value.
[in]	aContext	A pointer to application-specific context.

Definition at line 410 of file include/openthread/commissioner.h

Function Documentation#

otCommissionerStart#

otError otCommissionerStart (otInstance * aInstance, otCommissionerStateCallback aStateCallback, otCommissionerJoinerCallback aJoinerCallback, void * aCallbackContext)

Enables the Thread Commissioner role.

Parameters

[in]	aInstance	A pointer to an OpenThread instance.
[in]	aStateCallback	A pointer to a function that is called when the commissioner state changes.
[in]	aJoinerCallback	A pointer to a function that is called with a joiner event occurs.
[in]	aCallbackContext	A pointer to application-specific context.

Definition at line 190 of file include/openthread/commissioner.h

otCommissionerStop#

otError otCommissionerStop (otInstance * aInstance)

Disables the Thread Commissioner role.

Parameters

[in]

aInstance

A pointer to an OpenThread instance.

Definition at line 204 of file include/openthread/commissioner.h

otCommissionerGetId#

const char * otCommissionerGetId (otInstance * aInstance)

Returns the Commissioner Id.

Parameters

[in]

aInstance

A pointer to an OpenThread instance.

Returns

The Commissioner Id.

Definition at line 214 of file include/openthread/commissioner.h

otCommissionerSetId#

otError otCommissionerSetId (otInstance * aInstance, const char * aId)

Sets the Commissioner Id.

Parameters

[in]	aInstance	A pointer to an OpenThread instance.
[in]	aId	A pointer to a string character array. Must be null terminated.

Definition at line 227 of file include/openthread/commissioner.h

otCommissionerAddJoiner#

otError otCommissionerAddJoiner (otInstance * aInstance, const otExtAddress * aEui64, const char * aPskd, uint32_t aTimeout)

Adds a Joiner entry.

Parameters

[in]	aInstance	A pointer to an OpenThread instance.
[in]	aEui64	A pointer to the Joiner's IEEE EUI-64 or NULL for any Joiner.
[in]	aPskd	A pointer to the PSKd.
[in]	aTimeout	A time after which a Joiner is automatically removed, in seconds.

Note

Only use this after successfully starting the Commissioner role with otCommissionerStart().

Definition at line 245 of file include/openthread/commissioner.h

otCommissionerAddJoinerWithDiscerner#

otError otCommissionerAddJoinerWithDiscerner (otInstance * aInstance, const otJoinerDiscerner * aDiscerner, const char * aPskd, uint32_t aTimeout)

Adds a Joiner entry with a given Joiner Discerner value.

Parameters

[in]	aInstance	A pointer to an OpenThread instance.
[in]	aDiscerner	A pointer to the Joiner Discerner.
[in]	aPskd	A pointer to the PSKd.
[in]	aTimeout	A time after which a Joiner is automatically removed, in seconds.

Note

Only use this after successfully starting the Commissioner role with otCommissionerStart().

Definition at line 266 of file include/openthread/commissioner.h

otCommissionerGetNextJoinerInfo#

otError otCommissionerGetNextJoinerInfo (otInstance * aInstance, uint16_t * aIterator, otJoinerInfo * aJoiner)

Get joiner info at aIterator position.

Parameters

[in]	aInstance	A pointer to instance.
[inout]	aIterator	A pointer to the Joiner Info iterator context.
[out]	aJoiner	A reference to Joiner info.

Definition at line 282 of file include/openthread/commissioner.h

otCommissionerRemoveJoiner#

otError otCommissionerRemoveJoiner (otInstance * aInstance, const otExtAddress * aEui64)

Removes a Joiner entry.

Parameters

[in]	aInstance	A pointer to an OpenThread instance.
[in]	aEui64	A pointer to the Joiner's IEEE EUI-64 or NULL for any Joiner.

Note

Only use this after successfully starting the Commissioner role with otCommissionerStart().

Definition at line 298 of file include/openthread/commissioner.h

otCommissionerRemoveJoinerWithDiscerner#

otError otCommissionerRemoveJoinerWithDiscerner (otInstance * aInstance, const otJoinerDiscerner * aDiscerner)

Removes a Joiner entry.

Parameters

[in]	aInstance	A pointer to an OpenThread instance.
[in]	aDiscerner	A pointer to the Joiner Discerner.

Note

Only use this after successfully starting the Commissioner role with otCommissionerStart().

Definition at line 314 of file include/openthread/commissioner.h

otCommissionerGetProvisioningUrl#

const char * otCommissionerGetProvisioningUrl (otInstance * aInstance)

Gets the Provisioning URL.

Parameters

[in]

aInstance

A pointer to an OpenThread instance.

Returns

A pointer to the URL string.

Definition at line 324 of file include/openthread/commissioner.h

otCommissionerSetProvisioningUrl#

otError otCommissionerSetProvisioningUrl (otInstance * aInstance, const char * aProvisioningUrl)

Sets the Provisioning URL.

Parameters

[in]	aInstance	A pointer to an OpenThread instance.
[in]	aProvisioningUrl	A pointer to the Provisioning URL (may be NULL to set as empty string).

Definition at line 336 of file include/openthread/commissioner.h

otCommissionerAnnounceBegin#

otError otCommissionerAnnounceBegin (otInstance * aInstance, uint32_t aChannelMask, uint8_t aCount, uint16_t aPeriod, const otIp6Address * aAddress)

Sends an Announce Begin message.

Parameters

[in]	aInstance	A pointer to an OpenThread instance.
[in]	aChannelMask	The channel mask value.
[in]	aCount	The number of Announcement messages per channel.
[in]	aPeriod	The time between two successive MLE Announce transmissions (in milliseconds).
[in]	aAddress	A pointer to the IPv6 destination.

Note

Only use this after successfully starting the Commissioner role with otCommissionerStart().

Definition at line 354 of file include/openthread/commissioner.h

otCommissionerEnergyScan#

otError otCommissionerEnergyScan (otInstance * aInstance, uint32_t aChannelMask, uint8_t aCount, uint16_t aPeriod, uint16_t aScanDuration, const otIp6Address * aAddress, otCommissionerEnergyReportCallback aCallback, void * aContext)

Sends an Energy Scan Query message.

Parameters

[in]	aInstance	A pointer to an OpenThread instance.
[in]	aChannelMask	The channel mask value.
[in]	aCount	The number of energy measurements per channel.
[in]	aPeriod	The time between energy measurements (milliseconds).
[in]	aScanDuration	The scan duration for each energy measurement (milliseconds).
[in]	aAddress	A pointer to the IPv6 destination.
[in]	aCallback	A pointer to a function called on receiving an Energy Report message.
[in]	aContext	A pointer to application-specific context.

Note

Only use this after successfully starting the Commissioner role with otCommissionerStart().

Definition at line 393 of file include/openthread/commissioner.h

otCommissionerPanIdQuery#

otError otCommissionerPanIdQuery (otInstance * aInstance, uint16_t aPanId, uint32_t aChannelMask, const otIp6Address * aAddress, otCommissionerPanIdConflictCallback aCallback, void * aContext)

Sends a PAN ID Query message.

Parameters

[in]	aInstance	A pointer to an OpenThread instance.
[in]	aPanId	The PAN ID to query.
[in]	aChannelMask	The channel mask value.
[in]	aAddress	A pointer to the IPv6 destination.
[in]	aCallback	A pointer to a function called on receiving a PAN ID Conflict message.
[in]	aContext	A pointer to application-specific context.

Note

Only use this after successfully starting the Commissioner role with otCommissionerStart().

Definition at line 429 of file include/openthread/commissioner.h

otCommissionerSendMgmtGet#

otError otCommissionerSendMgmtGet (otInstance * aInstance, const uint8_t * aTlvs, uint8_t aLength)

Sends MGMT_COMMISSIONER_GET.

Parameters

[in]	aInstance	A pointer to an OpenThread instance.
[in]	aTlvs	A pointer to TLVs.
[in]	aLength	The length of TLVs.

Definition at line 448 of file include/openthread/commissioner.h

otCommissionerSendMgmtSet#

otError otCommissionerSendMgmtSet (otInstance * aInstance, const otCommissioningDataset * aDataset, const uint8_t * aTlvs, uint8_t aLength)

Sends MGMT_COMMISSIONER_SET.

Parameters

[in]	aInstance	A pointer to an OpenThread instance.
[in]	aDataset	A pointer to commissioning dataset.
[in]	aTlvs	A pointer to TLVs.
[in]	aLength	The length of TLVs.

Definition at line 463 of file include/openthread/commissioner.h

otCommissionerGetSessionId#

uint16_t otCommissionerGetSessionId (otInstance * aInstance)

Returns the Commissioner Session ID.

Parameters

[in]

aInstance

A pointer to an OpenThread instance.

Returns

The current commissioner session id.

Definition at line 476 of file include/openthread/commissioner.h

otCommissionerGetState#

otCommissionerState otCommissionerGetState (otInstance * aInstance)

Returns the Commissioner State.

Parameters

[in]

aInstance

A pointer to an OpenThread instance.

Definition at line 488 of file include/openthread/commissioner.h

Macro Definition Documentation#

OT_COMMISSIONING_PASSPHRASE_MIN_SIZE#

#define OT_COMMISSIONING_PASSPHRASE_MIN_SIZE

Value:

Minimum size of the Commissioning Passphrase.

Definition at line 82 of file include/openthread/commissioner.h

OT_COMMISSIONING_PASSPHRASE_MAX_SIZE#

#define OT_COMMISSIONING_PASSPHRASE_MAX_SIZE

Value:

Maximum size of the Commissioning Passphrase.

Definition at line 83 of file include/openthread/commissioner.h

OT_PROVISIONING_URL_MAX_SIZE#

#define OT_PROVISIONING_URL_MAX_SIZE

Value:

Max size (number of chars) in Provisioning URL string (excludes null char).

Definition at line 85 of file include/openthread/commissioner.h

OT_STEERING_DATA_MAX_LENGTH#

#define OT_STEERING_DATA_MAX_LENGTH

Value:

Max steering data length (bytes)

Definition at line 87 of file include/openthread/commissioner.h

OT_JOINER_MAX_PSKD_LENGTH#

#define OT_JOINER_MAX_PSKD_LENGTH

Value:

Maximum string length of a Joiner PSKd (does not include null char).

Definition at line 116 of file include/openthread/commissioner.h