本頁面由 Cloud Translation API 翻譯而成。

主席
bookmark_border 透過集合功能整理內容你可以依據偏好儲存及分類內容。

本單元包含 Thread Commissioner 角色的函式。

摘要

列舉
`otCommissionerJoinerEvent`	列舉定義有關調試者的加入者事件。
`otCommissionerState{ OT_COMMISSIONER_STATE_DISABLED = 0, OT_COMMISSIONER_STATE_PETITION = 1, OT_COMMISSIONER_STATE_ACTIVE = 2 }`	列舉定義 Commissioner State (委員會州別)。
`otJoinerInfoType{ OT_JOINER_INFO_TYPE_ANY = 0, OT_JOINER_INFO_TYPE_EUI64 = 1, OT_JOINER_INFO_TYPE_DISCERNER = 2 }`	列舉定義彙整器資訊類型。

Typedefs
`otCommissionerEnergyReportCallback)(uint32_t aChannelMask, const uint8_t aEnergyList, uint8_t aEnergyListLength, void aContext)`	typedef `void(*` 委員會收到能源報告時呼叫指標。
`otCommissionerJoinerCallback)(otCommissionerJoinerEvent aEvent, const otJoinerInfo aJoinerInfo, const otExtAddress aJoinerId, void *aContext)`	typedef `void(*` 只要加入器狀態變更，就會呼叫指標。
`otCommissionerJoinerEvent`	typedef `enum otCommissionerJoinerEvent` 定義有關調試者的加入者事件。
`otCommissionerPanIdConflictCallback)(uint16_t aPanId, uint32_t aChannelMask, void *aContext)`	typedef `void(*` 專員收到 PAN ID 衝突訊息時，就會呼叫指標。
`otCommissionerState`	typedef `enum otCommissionerState` 定義 Commissioner State (委員會州別)。
`otCommissionerStateCallback)(otCommissionerState aState, void *aContext)`	typedef `void(*` 每當委員狀態變更時，就會呼叫指標。
`otCommissioningDataset`	typedef `struct otCommissioningDataset` 代表佣金資料集。
`otJoinerInfo`	typedef `struct otJoinerInfo` 代表彙整者資訊。
`otJoinerInfoType`	typedef `enum otJoinerInfoType` 定義彙整器資訊類型。
`otJoinerPskd`	typedef `struct otJoinerPskd` 代表彙整者 PSKd。
`otSteeringData`	typedef `struct otSteeringData` 代表引導資料。

函式
`otCommissionerAddJoiner(otInstance aInstance, const otExtAddress aEui64, const char *aPskd, uint32_t aTimeout)`	`otError` 新增彙整器項目。
`otCommissionerAddJoinerWithDiscerner(otInstance aInstance, const otJoinerDiscerner aDiscerner, const char *aPskd, uint32_t aTimeout)`	`otError` 新增具有指定彙整器 Discerner 值的彙整器項目。
`otCommissionerAnnounceBegin(otInstance aInstance, uint32_t aChannelMask, uint8_t aCount, uint16_t aPeriod, const otIp6Address aAddress)`	`otError` 傳送「開始朗讀」訊息。
`otCommissionerEnergyScan(otInstance aInstance, uint32_t aChannelMask, uint8_t aCount, uint16_t aPeriod, uint16_t aScanDuration, const otIp6Address aAddress, otCommissionerEnergyReportCallback aCallback, void *aContext)`	`otError` 傳送 Energy Scan Query 訊息。
`otCommissionerGetId(otInstance *aInstance)`	`const char *` 傳回 Commissioner ID。
`otCommissionerGetNextJoinerInfo(otInstance aInstance, uint16_t aIterator, otJoinerInfo *aJoiner)`	`otError` 在 aIterator 位置取得加入者資訊。
`otCommissionerGetProvisioningUrl(otInstance *aInstance)`	`const char *` 取得佈建網址。
`otCommissionerGetSessionId(otInstance *aInstance)`	`uint16_t` 傳回 Commissioner Session ID。
`otCommissionerGetState(otInstance *aInstance)`	`otCommissionerState` 傳回 Commissioner State。
`otCommissionerPanIdQuery(otInstance aInstance, uint16_t aPanId, uint32_t aChannelMask, const otIp6Address aAddress, otCommissionerPanIdConflictCallback aCallback, void *aContext)`	`otError` 傳送永久帳號 ID 查詢訊息。
`otCommissionerRemoveJoiner(otInstance aInstance, const otExtAddress aEui64)`	`otError` 移除彙整器項目。
`otCommissionerRemoveJoinerWithDiscerner(otInstance aInstance, const otJoinerDiscerner aDiscerner)`	`otError` 移除彙整器項目。
`otCommissionerSendMgmtGet(otInstance aInstance, const uint8_t aTlvs, uint8_t aLength)`	`otError` 傳送 MGMT_COMMISSIONER_GET。
`otCommissionerSendMgmtSet(otInstance aInstance, const otCommissioningDataset aDataset, const uint8_t *aTlvs, uint8_t aLength)`	`otError` 傳送 MGMT_COMMISSIONER_SET。
`otCommissionerSetId(otInstance aInstance, const char aId)`	`otError` 設定 Commissioner ID。
`otCommissionerSetProvisioningUrl(otInstance aInstance, const char aProvisioningUrl)`	`otError` 設定佈建網址。
`otCommissionerStart(otInstance aInstance, otCommissionerStateCallback aStateCallback, otCommissionerJoinerCallback aJoinerCallback, void aCallbackContext)`	`otError` 啟用 Thread Commissioner 角色。
`otCommissionerStop(otInstance *aInstance)`	`otError` 停用 Thread Commissioner 角色。

結構
otCommissioningDataset	代表佣金資料集。
otJoinerInfo	代表彙整者資訊。
otJoinerPskd	代表彙整者 PSKd。
otSteeringData	代表引導資料。

列舉

otCommissionerJoinerEvent

 otCommissionerJoinerEvent

定義有關調試者的加入者事件。

otCommissionerState

 otCommissionerState

定義 Commissioner State (委員會州別)。

屬性
`OT_COMMISSIONER_STATE_ACTIVE`	調試者角色有效。
`OT_COMMISSIONER_STATE_DISABLED`	已停用調試者角色。
`OT_COMMISSIONER_STATE_PETITION`	目前正在伸張正義，成為委員。

otJoinerInfoType

 otJoinerInfoType

定義彙整器資訊類型。

屬性
`OT_JOINER_INFO_TYPE_ANY`	接受任何彙整者 (未指定 EUI64 或 Discerner)。
`OT_JOINER_INFO_TYPE_DISCERNER`	已指定彙整器捨棄器 (`otJoinerInfo` 中的 `mSharedId.mDiscerner`)。
`OT_JOINER_INFO_TYPE_EUI64`	已指定彙整者 EUI-64 (`otJoinerInfo` 中的 `mSharedId.mEui64`)。

Typedefs

otCommissionerEnergyReportCallback

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

委員會收到能源報告時呼叫指標。

詳細說明

參數

`[in] aChannelMask`	通道遮罩值。
`[in] aEnergyList`	指向能源測量清單的指標。
`[in] aEnergyListLength`	`aEnergyListLength` 中的項目數量。
`[in] aContext`	指向應用程式特定背景資訊的指標。

otCommissionerJoinerCallback

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

只要彙整器狀態變更，就會呼叫指標。

詳細說明

參數

`[in] aEvent`	加入者事件類型。
`[in] aJoinerInfo`	指向「彙整者資訊」的指標。
`[in] aJoinerId`	指向加入者 ID 的指標 (如果不明，則為空值)。
`[in] aContext`	指向應用程式特定背景資訊的指標。

otCommissionerJoinerEvent

enum otCommissionerJoinerEvent otCommissionerJoinerEvent

定義有關調試者的加入者事件。

otCommissionerPanIdConflictCallback

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

專員收到 PAN ID 衝突訊息時，就會呼叫指標。

詳細說明

參數

`[in] aPanId`	永久帳號 ID 值。
`[in] aChannelMask`	通道遮罩值。
`[in] aContext`	指向應用程式特定背景資訊的指標。

otCommissionerState

enum otCommissionerState otCommissionerState

定義 Commissioner State (委員會州別)。

otCommissionerStateCallback

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

每當委員狀態變更時，就會呼叫指標。

詳細說明

參數

`[in] aState`	委員州。
`[in] aContext`	指向應用程式特定背景資訊的指標。

otCommissioningDataset

struct otCommissioningDataset otCommissioningDataset

代表佣金資料集。

otJoinerInfo

struct otJoinerInfo otJoinerInfo

代表彙整者資訊。

otJoinerInfoType

enum otJoinerInfoType otJoinerInfoType

定義彙整器資訊類型。

otJoinerPskd

struct otJoinerPskd otJoinerPskd

代表彙整者 PSKd。

otSteeringData

struct otSteeringData otSteeringData

代表引導資料。

函式

otCommissionerAddJoiner

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

新增彙整器項目。

詳細說明

參數

`[in] aInstance`	指向 OpenThread 執行個體的指標。
`[in] aEui64`	指向任何加入者的 IEEE EUI-64 或 NULL 指標。
`[in] aPskd`	PSKd 的指標。
`[in] aTimeout`	經過的時間 (以秒為單位)，系統會自動移除彙整器。

傳回值

`OT_ERROR_NONE`	已成功新增彙整者。
`OT_ERROR_NO_BUFS`	沒有可新增彙整器的緩衝區。
`OT_ERROR_INVALID_ARGS`	`aEui64` 或 `aPskd` 無效。
`OT_ERROR_INVALID_STATE`	代理人未啟用。

otCommissionerAddJoinerWithDiscerner

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

新增具有指定彙整器 Discerner 值的彙整器項目。

詳細說明

參數

`[in] aInstance`	指向 OpenThread 執行個體的指標。
`[in] aDiscerner`	遊標移合器的指標。
`[in] aPskd`	PSKd 的指標。
`[in] aTimeout`	經過的時間 (以秒為單位)，系統會自動移除彙整器。

傳回值

`OT_ERROR_NONE`	已成功新增彙整者。
`OT_ERROR_NO_BUFS`	沒有可新增彙整器的緩衝區。
`OT_ERROR_INVALID_ARGS`	`aDiscerner` 或 `aPskd` 無效。
`OT_ERROR_INVALID_STATE`	代理人未啟用。

otCommissionerAnnounceBegin

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

傳送「開始朗讀」訊息。

詳細說明

參數

`[in] aInstance`	指向 OpenThread 執行個體的指標。
`[in] aChannelMask`	通道遮罩值。
`[in] aCount`	每個管道的公告訊息數量。
`[in] aPeriod`	兩次 MLE 連續朗讀傳輸作業的間隔時間 (以毫秒為單位)。
`[in] aAddress`	指向 IPv6 目的地的指標。

傳回值

`OT_ERROR_NONE`	已成功將「宣布開始」訊息排入佇列。
`OT_ERROR_NO_BUFS`	緩衝區不足，無法產生「開始朗讀」訊息。
`OT_ERROR_INVALID_STATE`	代理人未啟用。

otCommissionerEnergyScan

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

傳送 Energy Scan Query 訊息。

詳細說明

參數

`[in] aInstance`	指向 OpenThread 執行個體的指標。
`[in] aChannelMask`	通道遮罩值。
`[in] aCount`	每個通路的能量測量數。
`[in] aPeriod`	測量能量的間隔時間 (毫秒)。
`[in] aScanDuration`	每次能源測量的掃描時間長度 (毫秒)。
`[in] aAddress`	指向 IPv6 目的地的指標。
`[in] aCallback`	指向接收能源報告訊息的函式。
`[in] aContext`	指向應用程式特定背景資訊的指標。

傳回值

`OT_ERROR_NONE`	成功將 Energy Scan Query 訊息排入佇列。
`OT_ERROR_NO_BUFS`	緩衝區不足，無法產生能源掃描查詢訊息。
`OT_ERROR_INVALID_STATE`	代理人未啟用。

otCommissionerGetId

const char * otCommissionerGetId(
  otInstance *aInstance
)

傳回 Commissioner ID。

詳細說明

參數

[in] aInstance

指向 OpenThread 執行個體的指標。

傳回

調試者 ID。

otCommissionerGetNextJoinerInfo

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

在 aIterator 位置取得加入者資訊。

詳細說明

參數

`[in] aInstance`	執行個體的指標。
`[in,out] aIterator`	指向加入器資訊疊代器結構定義的指標。
`[out] aJoiner`	加入者資訊的參照。

傳回值

`OT_ERROR_NONE`	已成功取得彙整者資訊。
`OT_ERROR_NOT_FOUND`	找不到下一個彙整者。

otCommissionerGetProvisioningUrl

const char * otCommissionerGetProvisioningUrl(
  otInstance *aInstance
)

取得佈建網址。

詳細說明

參數

[in] aInstance

指向 OpenThread 執行個體的指標。

傳回

網址字串的指標。

otCommissionerGetSessionId

uint16_t otCommissionerGetSessionId(
  otInstance *aInstance
)

傳回 Commissioner Session ID。

詳細說明

參數

[in] aInstance

指向 OpenThread 執行個體的指標。

傳回

目前的委員工作階段 ID。

otCommissionerGetState

otCommissionerState otCommissionerGetState(
  otInstance *aInstance
)

傳回 Commissioner State。

詳細說明

參數

[in] aInstance

指向 OpenThread 執行個體的指標。

傳回值

`OT_COMMISSIONER_STATE_DISABLED`	已停用調試者。
`OT_COMMISSIONER_STATE_PETITION`	成為總裁。
`OT_COMMISSIONER_STATE_ACTIVE`	已啟用調試者。

otCommissionerPanIdQuery

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

傳送永久帳號 ID 查詢訊息。

詳細說明

參數

`[in] aInstance`	指向 OpenThread 執行個體的指標。
`[in] aPanId`	要查詢的永久帳號 ID。
`[in] aChannelMask`	通道遮罩值。
`[in] aAddress`	指向 IPv6 目的地的指標。
`[in] aCallback`	指向接收 PAN ID 衝突訊息時呼叫的函式。
`[in] aContext`	指向應用程式特定背景資訊的指標。

傳回值

`OT_ERROR_NONE`	已成功將永久帳號 ID 查詢訊息排入佇列。
`OT_ERROR_NO_BUFS`	緩衝區不足，無法產生永久帳號 ID 查詢訊息。
`OT_ERROR_INVALID_STATE`	代理人未啟用。

otCommissionerRemoveJoiner

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

移除彙整器項目。

詳細說明

參數

`[in] aInstance`	指向 OpenThread 執行個體的指標。
`[in] aEui64`	指向任何加入者的 IEEE EUI-64 或 NULL 指標。

傳回值

`OT_ERROR_NONE`	已成功移除彙整者。
`OT_ERROR_NOT_FOUND`	找不到 `aEui64` 指定的彙整者。
`OT_ERROR_INVALID_ARGS`	`aEui64` 無效。
`OT_ERROR_INVALID_STATE`	代理人未啟用。

otCommissionerRemoveJoinerWithDiscerner

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

移除彙整器項目。

詳細說明

參數

`[in] aInstance`	指向 OpenThread 執行個體的指標。
`[in] aDiscerner`	遊標移合器的指標。

傳回值

`OT_ERROR_NONE`	已成功移除彙整者。
`OT_ERROR_NOT_FOUND`	找不到 `aEui64` 指定的彙整者。
`OT_ERROR_INVALID_ARGS`	`aDiscerner` 無效。
`OT_ERROR_INVALID_STATE`	代理人未啟用。

otCommissionerSendMgmtGet

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

傳送 MGMT_COMMISSIONER_GET。

詳細說明

參數

`[in] aInstance`	指向 OpenThread 執行個體的指標。
`[in] aTlvs`	指向 TLV 的指標。
`[in] aLength`	TLV 的長度。

傳回值

`OT_ERROR_NONE`	已成功傳送 Meshcop 資料集指令。
`OT_ERROR_NO_BUFS`	緩衝空間不足，無法傳送。
`OT_ERROR_INVALID_STATE`	代理人未啟用。

otCommissionerSendMgmtSet

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

傳送 MGMT_COMMISSIONER_SET。

詳細說明

參數

`[in] aInstance`	指向 OpenThread 執行個體的指標。
`[in] aDataset`	調試資料集的指標。
`[in] aTlvs`	指向 TLV 的指標。
`[in] aLength`	TLV 的長度。

傳回值

`OT_ERROR_NONE`	已成功傳送 Meshcop 資料集指令。
`OT_ERROR_NO_BUFS`	緩衝空間不足，無法傳送。
`OT_ERROR_INVALID_STATE`	代理人未啟用。

otCommissionerSetId

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

設定 Commissioner ID。

詳細說明

參數

`[in] aInstance`	指向 OpenThread 執行個體的指標。
`[in] aId`	指向字串字元陣列的指標。必須為空值終止。

傳回值

`OT_ERROR_NONE`	已成功設定佣金 ID。
`OT_ERROR_INVALID_ARGS`	名字過長。
`OT_ERROR_INVALID_STATE`	委員已啟用，因此無法變更 ID。

otCommissionerSetProvisioningUrl

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

設定佈建網址。

詳細說明

參數

`[in] aInstance`	指向 OpenThread 執行個體的指標。
`[in] aProvisioningUrl`	指向佈建網址的指標 (可以設為空字串為 NULL)。

傳回值

`OT_ERROR_NONE`	已成功設定佈建網址。
`OT_ERROR_INVALID_ARGS`	`aProvisioningUrl` 無效 (過長)。

otCommissionerStart

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

啟用 Thread Commissioner 角色。

詳細說明

參數

`[in] aInstance`	指向 OpenThread 執行個體的指標。
`[in] aStateCallback`	指向執行者狀態變更時呼叫的函式。
`[in] aJoinerCallback`	出現透過彙整器事件呼叫的函式指標。
`[in] aCallbackContext`	指向應用程式特定背景資訊的指標。

傳回值

`OT_ERROR_NONE`	成功啟動 Commissioner 服務。
`OT_ERROR_ALREADY`	調試者已啟動。
`OT_ERROR_INVALID_STATE`	裝置目前未連上網路。

otCommissionerStop

otError otCommissionerStop(
  otInstance *aInstance
)

停用 Thread Commissioner 角色。

詳細說明

參數

[in] aInstance

指向 OpenThread 執行個體的指標。

傳回值

`OT_ERROR_NONE`	已成功停止 Commissioner 服務。
`OT_ERROR_ALREADY`	調試者已停止運作。

巨集

OT_COMMISSIONING_PASSPHRASE_MAX_SIZE

 OT_COMMISSIONING_PASSPHRASE_MAX_SIZE 255

「調試通關密語」的大小上限。

OT_COMMISSIONING_PASSPHRASE_MIN_SIZE

 OT_COMMISSIONING_PASSPHRASE_MIN_SIZE 6

「調試通關密語」的最小尺寸。

OT_JOINER_MAX_PSKD_LENGTH

 OT_JOINER_MAX_PSKD_LENGTH 32

彙整器 PSKd 的字串長度上限 (不含空值字元)。

OT_PROVISIONING_URL_MAX_SIZE

 OT_PROVISIONING_URL_MAX_SIZE 64

佈建網址字串的大小上限 (字元數) (不含空值字元)。

OT_STEERING_DATA_MAX_LENGTH

 OT_STEERING_DATA_MAX_LENGTH 16

導引資料長度上限 (位元組)

資源

OpenThread API 參考資料主題源自原始碼，請前往 GitHub 取得。如要瞭解詳情或對說明文件做出貢獻，請參閱資源。

主席 bookmark_borderbookmark 透過集合功能整理內容 你可以依據偏好儲存及分類內容。

摘要

列舉

Typedefs

函式

結構

列舉

otCommissionerJoinerEvent

otCommissionerState

otJoinerInfoType

Typedefs

otCommissionerEnergyReportCallback

otCommissionerJoinerCallback

otCommissionerJoinerEvent

otCommissionerPanIdConflictCallback

otCommissionerState

otCommissionerStateCallback

otCommissioningDataset

otJoinerInfo

otJoinerInfoType

otJoinerPskd

otSteeringData

函式

otCommissionerAddJoiner

otCommissionerAddJoinerWithDiscerner

otCommissionerAnnounceBegin

otCommissionerEnergyScan

otCommissionerGetId

otCommissionerGetNextJoinerInfo

otCommissionerGetProvisioningUrl

otCommissionerGetSessionId

otCommissionerGetState

otCommissionerPanIdQuery

otCommissionerRemoveJoiner

otCommissionerRemoveJoinerWithDiscerner

otCommissionerSendMgmtGet

otCommissionerSendMgmtSet

otCommissionerSetId

otCommissionerSetProvisioningUrl

otCommissionerStart

otCommissionerStop

巨集

OT_COMMISSIONING_PASSPHRASE_MAX_SIZE

OT_COMMISSIONING_PASSPHRASE_MIN_SIZE

OT_JOINER_MAX_PSKD_LENGTH

OT_PROVISIONING_URL_MAX_SIZE

OT_STEERING_DATA_MAX_LENGTH

資源

主席
bookmark_border 透過集合功能整理內容你可以依據偏好儲存及分類內容。