伺服器

這個模組包含透過 OpenThread Server 管理本機網路資料的函式。

摘要

函式

otServerAddService(otInstance *aInstance, const otServiceConfig *aConfig)
將服務設定新增至區域網路資料。
otServerGetNetDataLocal(otInstance *aInstance, bool aStable, uint8_t *aData, uint8_t *aDataLength)
提供本機 Thread 網路資料的完整或穩定副本。
otServerGetNextService(otInstance *aInstance, otNetworkDataIterator *aIterator, otServiceConfig *aConfig)
取得區域網路資料中的下一個服務。
otServerRegister(otInstance *aInstance)
立即向主要供應商註冊本機網路資料。
otServerRemoveService(otInstance *aInstance, uint32_t aEnterpriseNumber, const uint8_t *aServiceData, uint8_t aServiceDataLength)
從區域網路資料中移除服務設定。

函式

otServerAddService

otError otServerAddService(
  otInstance *aInstance,
  const otServiceConfig *aConfig
)

將服務設定新增至區域網路資料。

詳細說明
參數
[in] aInstance
指向 OpenThread 執行個體的指標。
[in] aConfig
服務設定的指標。
傳回值
OT_ERROR_NONE
已成功將設定新增至區域網路資料。
OT_ERROR_INVALID_ARGS
一或多個設定參數無效。
OT_ERROR_NO_BUFS
可用空間不足,無法將設定新增至區域網路資料。
另請參閱:
otServerRemoveService
otServerRegister

otServerGetNetDataLocal

otError otServerGetNetDataLocal(
  otInstance *aInstance,
  bool aStable,
  uint8_t *aData,
  uint8_t *aDataLength
)

提供本機 Thread 網路資料的完整或穩定副本。

詳細說明
參數
[in] aInstance
指向 OpenThread 執行個體的指標。
[in] aStable
複製穩定版時為 TRUE,複製完整版本時則為 FALSE。
[out] aData
資料緩衝區的指標。
[in,out] aDataLength
項目上時,aData 指向的資料緩衝區大小。結束時複製的位元組數。

otServerGetNextService

otError otServerGetNextService(
  otInstance *aInstance,
  otNetworkDataIterator *aIterator,
  otServiceConfig *aConfig
)

取得區域網路資料中的下一個服務。

詳細說明
參數
[in] aInstance
指向 OpenThread 執行個體的指標。
[in,out] aIterator
指向網路資料疊代器結構定義的指標。如要取得第一個服務項目,請將該項目設為 OT_NETWORK_DATA_ITERATOR_INIT。
[out] aConfig
指向服務資訊位置的指標。
傳回值
OT_ERROR_NONE
已成功找到下一項服務。
OT_ERROR_NOT_FOUND
Thread 網路資料中沒有後續服務。

otServerRegister

otError otServerRegister(
  otInstance *aInstance
)

立即向主要供應商註冊本機網路資料。

詳細說明
參數
[in] aInstance
指向 OpenThread 執行個體的指標。
傳回值
OT_ERROR_NONE
已成功將「伺服器資料要求」訊息排入傳送佇列。
另請參閱:
otServerAddService
otServerRemoveService

otServerRemoveService

otError otServerRemoveService(
  otInstance *aInstance,
  uint32_t aEnterpriseNumber,
  const uint8_t *aServiceData,
  uint8_t aServiceDataLength
)

從區域網路資料中移除服務設定。

詳細說明
參數
[in] aInstance
指向 OpenThread 執行個體的指標。
[in] aEnterpriseNumber
要刪除的服務項目企業編號。
[in] aServiceData
指向在刪除期間要檢查的服務資料。
[in] aServiceDataLength
aServiceData 的長度 (以位元組為單位)。
傳回值
OT_ERROR_NONE
已成功移除本機網路資料中的設定。
OT_ERROR_NOT_FOUND
找不到邊界路由器項目。
另請參閱:
otServerAddService
otServerRegister

資源

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