This module includes functions for the Thread Commissioner role. More...

Typedefs
typedef enum otCommissionerState	otCommissionerState

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

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

Enumerations
enum	otCommissionerState { OT_COMMISSIONER_STATE_DISABLED = 0, OT_COMMISSIONER_STATE_PETITION = 1, OT_COMMISSIONER_STATE_ACTIVE = 2 }

Functions
OTAPI otError OTCALL	otCommissionerStart (otInstance *aInstance)

OTAPI otError OTCALL	otCommissionerStop (otInstance *aInstance)

OTAPI otError OTCALL	otCommissionerAddJoiner (otInstance aInstance, const otExtAddress aEui64, const char *aPSKd, uint32_t aTimeout)

OTAPI otError OTCALL	otCommissionerRemoveJoiner (otInstance aInstance, const otExtAddress aEui64)

OTAPI otError OTCALL	otCommissionerSetProvisioningUrl (otInstance aInstance, const char aProvisioningUrl)

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

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

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

OTAPI otError OTCALL	otCommissionerSendMgmtGet (otInstance aInstance, const uint8_t aTlvs, uint8_t aLength)

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

OTAPI uint16_t OTCALL	otCommissionerGetSessionId (otInstance *aInstance)

OTAPI otCommissionerState OTCALL	otCommissionerGetState (otInstance *aInstance)

OTAPI otError OTCALL	otCommissionerGeneratePSKc (otInstance aInstance, const char aPassPhrase, const char aNetworkName, const uint8_t aExtPanId, uint8_t *aPSKc)

Detailed Description

This module includes functions for the Thread Commissioner role.

Typedef Documentation

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

This function 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.

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

This function 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.

typedef enum otCommissionerState otCommissionerState

This enumeration defines the Commissioner State.

Enumeration Type Documentation

enum otCommissionerState

This enumeration 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.

Function Documentation

OTAPI otError OTCALL otCommissionerAddJoiner	(	otInstance *	aInstance,
		const otExtAddress *	aEui64,
		const char *	aPSKd,
		uint32_t	aTimeout
	)

This function 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.

Return values

OT_ERROR_NONE	Successfully added the Joiner.
OT_ERROR_NO_BUFS	No buffers available to add the Joiner.
OT_ERROR_INVALID_ARGS	`aEui64` or `aPSKd` is invalid.
OT_ERROR_INVALID_STATE	The commissioner is not active.

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

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

This function 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 energy measurements per channel.
[in]	aPeriod	The time between energy measurements (milliseconds).
[in]	aAddress	A pointer to the IPv6 destination.

Return values

OT_ERROR_NONE	Successfully enqueued the Announce Begin message.
OT_ERROR_NO_BUFS	Insufficient buffers to generate an Announce Begin message.
OT_ERROR_INVALID_STATE	The commissioner is not active.

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

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

This function 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.

Return values

OT_ERROR_NONE	Successfully enqueued the Energy Scan Query message.
OT_ERROR_NO_BUFS	Insufficient buffers to generate an Energy Scan Query message.
OT_ERROR_INVALID_STATE	The commissioner is not active.

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

OTAPI otError OTCALL otCommissionerGeneratePSKc	(	otInstance *	aInstance,
		const char *	aPassPhrase,
		const char *	aNetworkName,
		const uint8_t *	aExtPanId,
		uint8_t *	aPSKc
	)

This method generates PSKc.

PSKc is used to establish the Commissioner Session.

Parameters

[in]	aInstance	A pointer to an OpenThread instance.
[in]	aPassPhrase	The commissioning passphrase.
[in]	aNetworkName	The network name for PSKc computation.
[in]	aExtPanId	The extended pan id for PSKc computation.
[out]	aPSKc	A pointer to the generated PSKc.

Return values

OT_ERROR_NONE	Successfully generate PSKc.
OT_ERROR_INVALID_ARGS	If any of the input arguments is invalid.

OTAPI uint16_t OTCALL otCommissionerGetSessionId ( otInstance * aInstance )

This function returns the Commissioner Session ID.

Parameters

[in] aInstance A pointer to an OpenThread instance.

Returns: The current commissioner session id.

OTAPI otCommissionerState OTCALL otCommissionerGetState ( otInstance * aInstance )

This function returns the Commissioner State.

Parameters

[in] aInstance A pointer to an OpenThread instance.

Return values

OT_COMMISSIONER_STATE_DISABLED	Commissioner disabled.
OT_COMMISSIONER_STATE_PETITION	Becoming the commissioner.
OT_COMMISSIONER_STATE_ACTIVE	Commissioner enabled.

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

This function 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 an Energy Report message.
[in]	aContext	A pointer to application-specific context.

Return values

OT_ERROR_NONE	Successfully enqueued the PAN ID Query message.
OT_ERROR_NO_BUFS	Insufficient buffers to generate a PAN ID Query message.
OT_ERROR_INVALID_STATE	The commissioner is not active.

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

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

This function 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.

Return values

OT_ERROR_NONE	Successfully removed the Joiner.
OT_ERROR_NOT_FOUND	The Joiner specified by `aEui64` was not found.
OT_ERROR_INVALID_ARGS	`aEui64` is invalid.
OT_ERROR_INVALID_STATE	The commissioner is not active.

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

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

This function 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.

Return values

OT_ERROR_NONE	Successfully send the meshcop dataset command.
OT_ERROR_NO_BUFS	Insufficient buffer space to send.

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

This function 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.

Return values

OT_ERROR_NONE	Successfully send the meshcop dataset command.
OT_ERROR_NO_BUFS	Insufficient buffer space to send.

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

This function sets the Provisioning URL.

Parameters

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

Return values

OT_ERROR_NONE	Successfully set the Provisioning URL.
OT_ERROR_INVALID_ARGS	`aProvisioningUrl` is invalid.

OTAPI otError OTCALL otCommissionerStart ( otInstance * aInstance )

This function enables the Thread Commissioner role.

Parameters

[in] aInstance A pointer to an OpenThread instance.

Return values

OT_ERROR_NONE Successfully started the Commissioner role.

OTAPI otError OTCALL otCommissionerStop ( otInstance * aInstance )

This function disables the Thread Commissioner role.

Parameters

[in] aInstance A pointer to an OpenThread instance.

Return values

OT_ERROR_NONE Successfully stopped the Commissioner role.

Typedefs

Enumerations

Functions

Detailed Description

Typedef Documentation

Enumeration Type Documentation

Function Documentation