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

路由器/主管

這個模組含有「執行緒路由器」和「領導者」功能。

摘要

列舉

otCacheEntryState 列舉
這個列舉定義了 EID 快取項目的狀態。
otNeighborTableEvent{
  OT_NEIGHBOR_TABLE_EVENT_CHILD_ADDED,
  OT_NEIGHBOR_TABLE_EVENT_CHILD_REMOVED,
  OT_NEIGHBOR_TABLE_EVENT_CHILD_MODE_CHANGED,
  OT_NEIGHBOR_TABLE_EVENT_ROUTER_ADDED,
  OT_NEIGHBOR_TABLE_EVENT_ROUTER_REMOVED
}
列舉
這個列舉定義了在 otNeighborTableCallback 中使用的常數,以指出相鄰的資料表變更。

Typedefs

otCacheEntryInfo typedef
這個結構代表 EID 快取項目。
otCacheEntryIterator typedef
此類型代表用於疊代 EID 快取資料表項目的疊代器。
otCacheEntryState typedef
這個列舉定義了 EID 快取項目的狀態。
otChildIp6AddressIterator typedef
uint16_t
用來疊代 Thread Child 項目的 IPv6 位址。
otNeighborTableCallback)(otNeighborTableEvent aEvent, const otNeighborTableEntryInfo *aEntryInfo) typedef
void(*
呼叫此函式指標以通知鄰居表格有變更。

Functions

otThreadBecomeLeader(otInstance *aInstance)
成為領先者,建立新分區。
otThreadBecomeRouter(otInstance *aInstance)
嘗試成為路由器。
otThreadGetChildInfoById(otInstance *aInstance, uint16_t aChildId, otChildInfo *aChildInfo)
依據子項 ID 或 RLOC16 取得附加子項的診斷資訊。
otThreadGetChildInfoByIndex(otInstance *aInstance, uint16_t aChildIndex, otChildInfo *aChildInfo)
此函式會保留內部表格索引所附加子項的診斷資訊。
otThreadGetChildNextIp6Address(otInstance *aInstance, uint16_t aChildIndex, otChildIp6AddressIterator *aIterator, otIp6Address *aAddress)
此函式會取得指定子項的下一個 IPv6 位址 (使用疊代器)。
otThreadGetContextIdReuseDelay(otInstance *aInstance)
uint32_t
取得「領導」角色中使用的 CONTEXT_ID_REUSE_DELAY 參數。
otThreadGetJoinerUdpPort(otInstance *aInstance)
uint16_t
取得彙整 UDP 通訊埠。
otThreadGetLocalLeaderWeight(otInstance *aInstance)
uint8_t
取得在領導角色營運時使用的執行緒主管權重。
otThreadGetMaxAllowedChildren(otInstance *aInstance)
uint16_t
取得目前允許的子項數目上限。
otThreadGetMaxChildIpAddresses(otInstance *aInstance)
uint8_t
取得每部 MTD 子項向這個裝置註冊的 IP 位址數目上限,以註冊為家長的裝置。
otThreadGetMaxRouterId(otInstance *aInstance)
uint8_t
這個函式會傳回允許的路由器 ID 上限。
otThreadGetNetworkIdTimeout(otInstance *aInstance)
uint8_t
取得路由器角色中使用的 NETWORK_ID_TIMEOUT 參數。
otThreadGetNextCacheEntry(otInstance *aInstance, otCacheEntryInfo *aEntryInfo, otCacheEntryIterator *aIterator)
此函式會取得下一個 EID 快取項目 (使用 iterator)。
otThreadGetNextHopAndPathCost(otInstance *aInstance, uint16_t aDestRloc16, uint16_t *aNextHopRloc16, uint8_t *aPathCost)
void
這個函式會取得特定 RLOC16 目的地的下一個躍點和路徑費用。
otThreadGetParentPriority(otInstance *aInstance)
int8_t
取得指定的父項優先順序。
otThreadGetPreferredLeaderPartitionId(otInstance *aInstance)
uint32_t
取得在領導角色中執行時偏好的執行緒執行緒分區分區 ID。
otThreadGetPskc(otInstance *aInstance, otPskc *aPskc)
void
取得執行緒 PSKc。
otThreadGetPskcRef(otInstance *aInstance)
取得儲存 Thread PSKc 的金鑰參考。
otThreadGetRouterDowngradeThreshold(otInstance *aInstance)
uint8_t
取得路由器角色中使用的 ROUTER_DOWNPARAGRAPH_THRESHOLD 參數。
otThreadGetRouterIdRange(otInstance *aInstance, uint8_t *aMinRouterId, uint8_t *aMaxRouterId)
void
這個函式會取得可指派給執行緒網路中節點的路由器 ID 範圍。
otThreadGetRouterIdSequence(otInstance *aInstance)
uint8_t
取得目前的路由器 ID 序列。
otThreadGetRouterInfo(otInstance *aInstance, uint16_t aRouterId, otRouterInfo *aRouterInfo)
這個函式會保留特定執行緒路由器的診斷資訊。
otThreadGetRouterSelectionJitter(otInstance *aInstance)
uint8_t
取得 REED/Router 角色中使用的 ROUTER_SELECTION_JITTER 參數。
otThreadGetRouterUpgradeThreshold(otInstance *aInstance)
uint8_t
取得 REED 角色中使用的 ROUTER_UPGrade_THRESHOLD 參數。
otThreadIsRouterEligible(otInstance *aInstance)
bool
這個方法會指出裝置是否具備路由器資格。
otThreadRegisterNeighborTableCallback(otInstance *aInstance, otNeighborTableCallback aCallback)
void
這個函式會註冊鄰居表格的回呼函式。
otThreadReleaseRouterId(otInstance *aInstance, uint8_t aRouterId)
釋出裝置在「領導」角色中分配的路由器 ID。
otThreadSetCcmEnabled(otInstance *aInstance, bool aEnabled)
void
這個函式可設定裝置是否使用 CCM 委任。
otThreadSetContextIdReuseDelay(otInstance *aInstance, uint32_t aDelay)
void
設定「領導」角色中使用的 CONTEXT_ID_REUSE_DELAY 參數。
otThreadSetJoinerUdpPort(otInstance *aInstance, uint16_t aJoinerUdpPort)
設定彙整器 UDP 通訊埠。
otThreadSetLocalLeaderWeight(otInstance *aInstance, uint8_t aWeight)
void
設定在負責人角色運作時使用的執行緒主管權重。
otThreadSetMaxAllowedChildren(otInstance *aInstance, uint16_t aMaxChildren)
設定目前允許的子項數量上限。
otThreadSetMaxChildIpAddresses(otInstance *aInstance, uint8_t aMaxIpAddresses)
設定或還原每個 MTD 子項向這個裝置註冊的 IP 位址數量上限 (以家長為基準)。
otThreadSetNetworkIdTimeout(otInstance *aInstance, uint8_t aTimeout)
void
設定「領導」角色中使用的 NETWORK_ID_TIMEOUT 參數。
otThreadSetParentPriority(otInstance *aInstance, int8_t aParentPriority)
設定父項的優先順序。
otThreadSetPreferredLeaderPartitionId(otInstance *aInstance, uint32_t aPartitionId)
void
設定在領導角色中執行時,偏好的執行緒執行緒分區分區 ID。
otThreadSetPreferredRouterId(otInstance *aInstance, uint8_t aRouterId)
設定偏好的路由器 ID。
otThreadSetPskc(otInstance *aInstance, const otPskc *aPskc)
設定執行緒 PSKc。
otThreadSetPskcRef(otInstance *aInstance, otPskcRef aKeyRef)
設定執行緒 PSKc。
otThreadSetRouterDowngradeThreshold(otInstance *aInstance, uint8_t aThreshold)
void
設定「領導」角色中使用的 ROUTER_DOWNGrade_THRESHOLD 參數。
otThreadSetRouterEligible(otInstance *aInstance, bool aEligible)
這個函式可設定裝置是否具備路由器資格。
otThreadSetRouterIdRange(otInstance *aInstance, uint8_t aMinRouterId, uint8_t aMaxRouterId)
這個函式可以設定路由器 ID 範圍,該範圍可指派給執行緒網路中的節點。
otThreadSetRouterSelectionJitter(otInstance *aInstance, uint8_t aRouterJitter)
void
設定 REED/Router 角色中使用的 ROUTER_SELECTION_JITTER 參數。
otThreadSetRouterUpgradeThreshold(otInstance *aInstance, uint8_t aThreshold)
void
設定「領導」角色中使用的 ROUTER_UPGrade_THRESHOLD 參數。
otThreadSetSteeringData(otInstance *aInstance, const otExtAddress *aExtAddress)
void
設定方向盤資料。
otThreadSetThreadVersionCheckEnabled(otInstance *aInstance, bool aEnabled)
void
這個函式可以設定是否啟用用於轉送轉送的安全性政策 TLV 版本門檻 (VR 欄位)。

結構

otCacheEntryInfo

這個結構代表 EID 快取項目。

otCacheEntryIterator

此類型代表用於疊代 EID 快取資料表項目的疊代器。

otChildInfo

此結構包含 Thread Child 的診斷資訊。

otNeighborTableEntryInfo

此類型代表相鄰的資料表項目資訊 (子項或路由器),做為相鄰資料表回呼 otNeighborTableCallback 中的參數。

列舉

otCacheEntryState

 otCacheEntryState

這個列舉定義了 EID 快取項目的狀態。

OTNeighborTableEvent

 otNeighborTableEvent

這個列舉定義了在 otNeighborTableCallback 中使用的常數,以指出相鄰的資料表變更。

屬性
OT_NEIGHBOR_TABLE_EVENT_CHILD_ADDED

正在新增孩童。

OT_NEIGHBOR_TABLE_EVENT_CHILD_MODE_CHANGED

現有的子模式已變更。

OT_NEIGHBOR_TABLE_EVENT_CHILD_REMOVED

正在移除孩童。

OT_NEIGHBOR_TABLE_EVENT_ROUTER_ADDED

正在新增路由器。

OT_NEIGHBOR_TABLE_EVENT_ROUTER_REMOVED

正在移除路由器。

Typedefs

otCacheEntryInfo

struct otCacheEntryInfo otCacheEntryInfo

這個結構代表 EID 快取項目。

otCacheEntryIterator

struct otCacheEntryIterator otCacheEntryIterator

此類型代表用於疊代 EID 快取資料表項目的疊代器。

如要初始化疊代器並從快取資料表中的第一個項目開始,請將結構中的所有欄位設定為零 (例如,memset 的疊代器為零)。

otCacheEntryState

enum otCacheEntryState otCacheEntryState

這個列舉定義了 EID 快取項目的狀態。

otChildIp6AddressIterator

uint16_t otChildIp6AddressIterator

用來疊代 Thread Child 項目的 IPv6 位址。

OTNeighborTableCallback

void(* otNeighborTableCallback)(otNeighborTableEvent aEvent, const otNeighborTableEntryInfo *aEntryInfo)

呼叫此函式指標以通知鄰居表格有變更。

詳細資料
參數
[in] aEvent
事件標記。
[in] aEntryInfo
指向表格項目資訊的指標。

Functions

OTThread 成為主管

otError otThreadBecomeLeader(
  otInstance *aInstance
)

成為領先者,建立新分區。

詳細資料
參數
[in] aInstance
指向 OpenThread 執行個體的指標。
回傳值
OT_ERROR_NONE
成功成為領導者,並已開始進行新的分區。
OT_ERROR_INVALID_STATE
執行緒已停用。

otThreadMakeRouter

otError otThreadBecomeRouter(
  otInstance *aInstance
)

嘗試成為路由器。

詳細資料
參數
[in] aInstance
指向 OpenThread 執行個體的指標。
回傳值
OT_ERROR_NONE
已成功嘗試成為路由器。
OT_ERROR_INVALID_STATE
執行緒已停用。

otThreadGetChildInfoById

otError otThreadGetChildInfoById(
  otInstance *aInstance,
  uint16_t aChildId,
  otChildInfo *aChildInfo
)

依據子項 ID 或 RLOC16 取得附加子項的診斷資訊。

詳細資料
參數
[in] aInstance
指向 OpenThread 執行個體的指標。
[in] aChildId
附加子項的子項 ID 或 RLOC16。
[out] aChildInfo
指向子項資訊的位置。
回傳值
OT_ERROR_NONE
已成功將「aChildInfo」更新為指定 ID 的資訊。
OT_ERROR_NOT_FOUND
這個子 ID 沒有有效的子項。
OT_ERROR_INVALID_ARGS
如果 aChildInfo 為 NULL。

otThreadGetChildInfoByIndex

otError otThreadGetChildInfoByIndex(
  otInstance *aInstance,
  uint16_t aChildIndex,
  otChildInfo *aChildInfo
)

此函式會保留內部表格索引所附加子項的診斷資訊。

詳細資料
參數
[in] aInstance
指向 OpenThread 執行個體的指標。
[in] aChildIndex
資料表索引。
[out] aChildInfo
指向子項資訊的位置。
回傳值
OT_ERROR_NONE
已成功更新「aChildInfo」的指定索引資訊。
OT_ERROR_NOT_FOUND
這個索引中沒有任何有效的子項。
OT_ERROR_INVALID_ARGS
aChildInfo 為 NULL,或 aChildIndex 超出範圍 (高於資料表索引上限)。
另請參閱:
otGetMaxAllowedChildren

otThreadGetChildNextIp6 地址

otError otThreadGetChildNextIp6Address(
  otInstance *aInstance,
  uint16_t aChildIndex,
  otChildIp6AddressIterator *aIterator,
  otIp6Address *aAddress
)

此函式會取得指定子項的下一個 IPv6 位址 (使用疊代器)。

詳細資料
參數
[in] aInstance
指向 OpenThread 執行個體的指標。
[in] aChildIndex
子索引。
[in,out] aIterator
指向疊代器的指標。成功更新時,疊代器會更新為清單中的下一個項目。如要取得第一個 IPv6 位址,該疊代器應設為 OT_CHILD_IP6_ADDRESS_ITERATOR_INIT。
[out] aAddress
指向下一個下一個位址的 IPv6 指標 (成功時)。
回傳值
OT_ERROR_NONE
已成功找到下一個 IPv6 位址 (aAddress 已成功更新)。
OT_ERROR_NOT_FOUND
子項沒有後續的 IPv6 位址輸入。
OT_ERROR_INVALID_ARGS
aIteratoraAddress 為 NULL,或位於 aChildIndex 的子項無效。
另請參閱:
otThreadGetChildInfoByIndex

otThreadGetContextIdReuseDelay

uint32_t otThreadGetContextIdReuseDelay(
  otInstance *aInstance
)

取得「領導」角色中使用的 CONTEXT_ID_REUSE_DELAY 參數。

詳細資料
參數
[in] aInstance
指向 OpenThread 執行個體的指標。
傳回
CONTEXT_ID_REUSE_DELAY 值。
另請參閱:
otThreadSetContextIdReuseDelay

otThreadGetJoinerUdpPort

uint16_t otThreadGetJoinerUdpPort(
  otInstance *aInstance
)

取得彙整 UDP 通訊埠。

詳細資料
參數
[in] aInstance
指向 OpenThread 執行個體的指標。
傳回
追蹤者 UDP 通訊埠編號。
另請參閱:
otThreadSetJoinerUdpPort

otThreadGetLocalLeaderWeight (otThreadGetLocalLeaderWeight)

uint8_t otThreadGetLocalLeaderWeight(
  otInstance *aInstance
)

取得在領導角色營運時使用的執行緒主管權重。

詳細資料
參數
[in] aInstance
指向 OpenThread 執行個體的指標。
傳回
執行緒負責人權重值。
另請參閱:
otThreadSetLeaderWeight

otThreadGetMaxAllowedChildren

uint16_t otThreadGetMaxAllowedChildren(
  otInstance *aInstance
)

取得目前允許的子項數目上限。

詳細資料
參數
[in] aInstance
指向 OpenThread 執行個體的指標。
傳回
目前允許的子項數量上限。
另請參閱:
otThreadSetMaxAllowedChildren

otThreadGetMaxChildIpAddress

uint8_t otThreadGetMaxChildIpAddresses(
  otInstance *aInstance
)

取得每部 MTD 子項向這個裝置註冊的 IP 位址數目上限,以註冊為家長的裝置。

詳細資料
參數
[in] aInstance
指向 OpenThread 執行個體的指標。
傳回
每個 MTD 子項可向此裝置註冊為父項的 IP 位址數量上限。
另請參閱:
otThreadSetMaxChildIpAddress

otThreadGetMaxRouterId

uint8_t otThreadGetMaxRouterId(
  otInstance *aInstance
)

這個函式會傳回允許的路由器 ID 上限。

詳細資料
參數
[in] aInstance
指向 OpenThread 執行個體的指標。
傳回
允許的路由器 ID 數量上限。

otThreadGetNetworkIdTimeout

uint8_t otThreadGetNetworkIdTimeout(
  otInstance *aInstance
)

取得路由器角色中使用的 NETWORK_ID_TIMEOUT 參數。

詳細資料
參數
[in] aInstance
指向 OpenThread 執行個體的指標。
傳回
NETWORK_ID_TIMEOUT 值。
另請參閱:
otThreadSetNetworkIdTimeout

otThreadGetNextCacheEntry

otError otThreadGetNextCacheEntry(
  otInstance *aInstance,
  otCacheEntryInfo *aEntryInfo,
  otCacheEntryIterator *aIterator
)

此函式會取得下一個 EID 快取項目 (使用 iterator)。

詳細資料
參數
[in] aInstance
指向 OpenThread 執行個體的指標。
[out] aEntryInfo
指向 EID 快取項目資訊的位置。
[in,out] aIterator
指向疊代器的指標。以在成功時更新項目。若要取得第一個項目,請將所有欄位設為零 (例如,memset 的疊代器結構的零)。
回傳值
OT_ERROR_NONE
已成功為下一個 EID 快取項目填入 aEntryInfo
OT_ERROR_NOT_FOUND
地址快取表格中沒有其他項目。

otThreadGetNextHopAndPath 費用

void otThreadGetNextHopAndPathCost(
  otInstance *aInstance,
  uint16_t aDestRloc16,
  uint16_t *aNextHopRloc16,
  uint8_t *aPathCost
)

這個函式會取得特定 RLOC16 目的地的下一個躍點和路徑費用。

此函式可與 aNextHopRloc16aPathCost 搭配使用,用來表示呼叫者不想取得該值。

詳細資料
參數
[in] aInstance
指向 OpenThread 執行個體的指標。
[in] aDesRloct16
目的地的 RLOC16。
[out] aNextHopRloc16
傳回下一個躍點 RLOC16 的指標,如果沒有下一個躍點,則傳回 0xfffe。
[out] aPathCost
傳回前往目的地路徑費用的指標。

otThreadGetParentPriority

int8_t otThreadGetParentPriority(
  otInstance *aInstance
)

取得指定的父項優先順序。

詳細資料
參數
[in] aInstance
指向 OpenThread 執行個體的指標。
傳回
指定父項優先順序值,-2 表示未指派。
另請參閱:
otThreadSetParentPriority

otThreadGetPreferredLeaderPartitionId

uint32_t otThreadGetPreferredLeaderPartitionId(
  otInstance *aInstance
)

取得在領導角色中執行時偏好的執行緒執行緒分區分區 ID。

詳細資料
參數
[in] aInstance
指向 OpenThread 執行個體的指標。
傳回
執行緒主管的分區 ID 值。

otThreadGetPskC

void otThreadGetPskc(
  otInstance *aInstance,
  otPskc *aPskc
)

取得執行緒 PSKc。

詳細資料
參數
[in] aInstance
指向 OpenThread 執行個體的指標。
[out] aPskc
指向 otPskc 的指標,以擷取擷取的 Thread PSKc。
另請參閱:
otThreadSetPskc

OTThreadGetPskcRef

otPskcRef otThreadGetPskcRef(
  otInstance *aInstance
)

取得儲存 Thread PSKc 的金鑰參考。

這項功能需要啟用建構時間功能 OPENTHREAD_CONFIG_PLATFORM_KEY_REFERENCES_ENABLE

詳細資料
參數
[in] aInstance
指向 OpenThread 執行個體的指標。
傳回
PSKc 金鑰參考
另請參閱:
otThreadSetPskcRef

otThreadGetRouterDowngradeThreshold

uint8_t otThreadGetRouterDowngradeThreshold(
  otInstance *aInstance
)

取得路由器角色中使用的 ROUTER_DOWNPARAGRAPH_THRESHOLD 參數。

詳細資料
參數
[in] aInstance
指向 OpenThread 執行個體的指標。
傳回
ROUTER_DOWNGrade_THRESHOLD 的值。
另請參閱:
otThreadSetRouterDowngradeThreshold

otThreadGetRouterIdRange

void otThreadGetRouterIdRange(
  otInstance *aInstance,
  uint8_t *aMinRouterId,
  uint8_t *aMaxRouterId
)

這個函式會取得可指派給執行緒網路中節點的路由器 ID 範圍。

詳細資料
參數
[in] aInstance
指向 OpenThread 執行個體的指標。
[out] aMinRouterId
路由器 ID 數量下限。
[out] aMaxRouterId
路由器 ID 上限。
另請參閱:
otThreadSetRouterIdRange

otThreadGetRouterIdSequence

uint8_t otThreadGetRouterIdSequence(
  otInstance *aInstance
)

取得目前的路由器 ID 序列。

詳細資料
參數
[in] aInstance
指向 OpenThread 執行個體的指標。
傳回
路由器 ID 序列。

otThreadGetRouterInfo 資訊

otError otThreadGetRouterInfo(
  otInstance *aInstance,
  uint16_t aRouterId,
  otRouterInfo *aRouterInfo
)

這個函式會保留特定執行緒路由器的診斷資訊。

詳細資料
參數
[in] aInstance
指向 OpenThread 執行個體的指標。
[in] aRouterId
特定路由器的路由器 ID 或 RLOC16。
[out] aRouterInfo
指向路由器資訊的位置。
回傳值
OT_ERROR_NONE
已成功擷取指定 ID 的路由器資訊。
OT_ERROR_NOT_FOUND
沒有具有指定 ID 的路由器項目。
OT_ERROR_INVALID_ARGS
aRouterInfo 為 NULL。

otThreadGetRouterSelectionJitter

uint8_t otThreadGetRouterSelectionJitter(
  otInstance *aInstance
)

取得 REED/Router 角色中使用的 ROUTER_SELECTION_JITTER 參數。

詳細資料
參數
[in] aInstance
指向 OpenThread 執行個體的指標。
傳回
ROUTER_SELECTION_JITTER 值。
另請參閱:
otThreadSetRouterSelectionJitter

otThreadGetRouterUpgradeThreshold

uint8_t otThreadGetRouterUpgradeThreshold(
  otInstance *aInstance
)

取得 REED 角色中使用的 ROUTER_UPGrade_THRESHOLD 參數。

詳細資料
參數
[in] aInstance
指向 OpenThread 執行個體的指標。
傳回
ROUTER_UPGrade_THRESHOLD 的值。
另請參閱:
otThreadSetRouterUpgradeThreshold

otThreadIsRouter 符合資格

bool otThreadIsRouterEligible(
  otInstance *aInstance
)

這個方法會指出裝置是否具備路由器資格。

詳細資料
參數
[in] aInstance
指向 OpenThread 執行個體的指標。
回傳值
TRUE
裝置是否符合路由器的使用資格。
FALSE
裝置不符合路由器設定條件。

otThreadRegisterNeighborTableCallback

void otThreadRegisterNeighborTableCallback(
  otInstance *aInstance,
  otNeighborTableCallback aCallback
)

這個函式會註冊鄰居表格的回呼函式。

當鄰居資料表中有任何變更 (例如,新增/移除子項或路由器的相鄰項目,或是現有子模式發生變更時),系統會叫用所提供的回呼 (如果不是 NULL)。

後續對這個方法的呼叫將會覆寫先前的回呼。請注意,在更新相鄰/子項資料表期間,一律在 otStateChangedCallback 之前已叫用這個回呼。

詳細資料
參數
[in] aInstance
指向 OpenThread 執行個體的指標。
[in] aCallback
回呼處理常式函式的指標。

otThreadReleaseRouterId

otError otThreadReleaseRouterId(
  otInstance *aInstance,
  uint8_t aRouterId
)

釋出裝置在「領導」角色中分配的路由器 ID。

詳細資料
參數
[in] aInstance
指向 OpenThread 執行個體的指標。
[in] aRouterId
要釋出的路由器 ID。有效範圍為 [0, 62]。
回傳值
OT_ERROR_NONE
已成功釋出路由器 ID。
OT_ERROR_INVALID_ARGS
aRouterId不在 [0, 62] 的範圍內。
OT_ERROR_INVALID_STATE
此裝置目前並非領導者。
OT_ERROR_NOT_FOUND
目前尚未分配路由器 ID。

otThreadSetCcm 的已啟用

void otThreadSetCcmEnabled(
  otInstance *aInstance,
  bool aEnabled
)

這個函式可設定裝置是否使用 CCM 委任。

詳細資料
參數
[in] aInstance
指向 OpenThread 執行個體的指標。
[in] aEnabled
如果裝置受 CCM 委託開發,則為 TRUE,否則傳回 FALSE。

otThreadSetContextIdReuseDelay

void otThreadSetContextIdReuseDelay(
  otInstance *aInstance,
  uint32_t aDelay
)

設定「領導」角色中使用的 CONTEXT_ID_REUSE_DELAY 參數。

詳細資料
參數
[in] aInstance
指向 OpenThread 執行個體的指標。
[in] aDelay
CONTEXT_ID_REUSE_DELAY 值。
另請參閱:
otThreadGetContextIdReuseDelay

otThreadSetJoinerUdp 埠

otError otThreadSetJoinerUdpPort(
  otInstance *aInstance,
  uint16_t aJoinerUdpPort
)

設定彙整器 UDP 通訊埠。

詳細資料
參數
[in] aInstance
指向 OpenThread 執行個體的指標。
[in] aJoinerUdpPort
追蹤者 UDP 通訊埠編號。
回傳值
OT_ERROR_NONE
已成功設定彙整器 UDP 通訊埠。
另請參閱:
otThreadGetJoinerUdpPort

otThreadSetLocalLeaderWeight (otThreadSetLocalLeaderWeight)

void otThreadSetLocalLeaderWeight(
  otInstance *aInstance,
  uint8_t aWeight
)

設定在負責人角色運作時使用的執行緒主管權重。

詳細資料
參數
[in] aInstance
指向 OpenThread 執行個體的指標。
[in] aWeight
執行緒負責人權重值。
另請參閱:
otThreadGetLeaderWeight

OTThreadSetMaxAllowedChildren

otError otThreadSetMaxAllowedChildren(
  otInstance *aInstance,
  uint16_t aMaxChildren
)

設定目前允許的子項數量上限。

只有在 Thread 通訊協定作業停止時,才能設定這個參數。

詳細資料
參數
[in] aInstance
指向 OpenThread 執行個體的指標。
[in] aMaxChildren
允許的子項數量上限。
回傳值
OT_ERROR_NONE
成功設定最高
OT_ERROR_INVALID_ARGS
如果 aMaxChildren 不在範圍 [1, OPENNON_CONFIG_MLE_MAX_CHILDREN] 內。
OT_ERROR_INVALID_STATE
如果 Thread 並未停止運作,
另請參閱:
otThreadGetMaxAllowedChildren

otThreadSetMaxChildIpAddress

otError otThreadSetMaxChildIpAddresses(
  otInstance *aInstance,
  uint8_t aMaxIpAddresses
)

設定或還原每個 MTD 子項向這個裝置註冊的 IP 位址數量上限 (以家長為基準)。

傳遞 0 即可清除設定並還原預設值。

必須啟用 OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE 才能使用此功能。

詳細資料
參數
[in] aInstance
指向 OpenThread 執行個體的指標。
[in] aMaxIpAddresses
每個 MTD 子項可向此裝置註冊為父項的 IP 位址數量上限。0 可清除設定並還原預設值。
回傳值
OT_ERROR_NONE
已成功設定/清除號碼。
OT_ERROR_INVALID_ARGS
超過允許的數量上限。
另請參閱:
otThreadGetMaxChildIpAddress

otThreadSetNetworkIdTimeout

void otThreadSetNetworkIdTimeout(
  otInstance *aInstance,
  uint8_t aTimeout
)

設定「領導」角色中使用的 NETWORK_ID_TIMEOUT 參數。

詳細資料
參數
[in] aInstance
指向 OpenThread 執行個體的指標。
[in] aTimeout
NETWORK_ID_TIMEOUT 值。
另請參閱:
otThreadGetNetworkIdTimeout

otThreadSetParentPriority

otError otThreadSetParentPriority(
  otInstance *aInstance,
  int8_t aParentPriority
)

設定父項的優先順序。

詳細資料
參數
[in] aInstance
指向 OpenThread 執行個體的指標。
[in] aParentPriority
父項優先順序值。
回傳值
OT_ERROR_NONE
已成功設定上層優先順序。
OT_ERROR_INVALID_ARGS
如果父項優先順序值不在 1、0、-1 和 -2 之間。
另請參閱:
otThreadGetParentPriority

otThreadSetPreferredLeader 分區資料表 ID

void otThreadSetPreferredLeaderPartitionId(
  otInstance *aInstance,
  uint32_t aPartitionId
)

設定在領導角色中執行時,偏好的執行緒執行緒分區分區 ID。

詳細資料
參數
[in] aInstance
指向 OpenThread 執行個體的指標。
[in] aPartitionId
執行緒主管的分區 ID 值。

otThreadSetPreferredRouterId

otError otThreadSetPreferredRouterId(
  otInstance *aInstance,
  uint8_t aRouterId
)

設定偏好的路由器 ID。

成為路由器/領導者後,節點會嘗試使用這個路由器 ID。如果未設定偏好的路由器 ID,或是無法使用,系統會挑選隨機產生的路由器 ID。只有在裝置角色卸離或停用時,您才能設定這項屬性。

詳細資料
參數
[in] aInstance
指向 OpenThread 執行個體的指標。
[in] aRouterId
偏好的路由器 ID。
回傳值
OT_ERROR_NONE
已成功設定偏好的路由器 ID。
OT_ERROR_INVALID_STATE
無法設定 (角色未卸離或停用)

OTThreadSetPsKC

otError otThreadSetPskc(
  otInstance *aInstance,
  const otPskc *aPskc
)

設定執行緒 PSKc。

只有在 Thread 通訊協定已停用時,此函式才會成功。成功呼叫這個函式也會使非易變記憶體中的有效和待處理的作業資料集失效。

詳細資料
參數
[in] aInstance
指向 OpenThread 執行個體的指標。
[in] aPskc
指向新執行緒 PSKc 的指標。
回傳值
OT_ERROR_NONE
已成功設定 Thread PSKc。
OT_ERROR_INVALID_STATE
已啟用執行緒通訊協定。
另請參閱:
otThreadGetPskc

OTThreadSetPskcRef

otError otThreadSetPskcRef(
  otInstance *aInstance,
  otPskcRef aKeyRef
)

設定執行緒 PSKc。

這項功能需要啟用建構時間功能 OPENTHREAD_CONFIG_PLATFORM_KEY_REFERENCES_ENABLE

只有在 Thread 通訊協定已停用時,此函式才會成功。成功呼叫這個函式也會使非易變記憶體中的有效和待處理的作業資料集失效。

詳細資料
參數
[in] aInstance
指向 OpenThread 執行個體的指標。
[in] aKeyRef
新執行緒 PSKc 的參考鍵。
回傳值
OT_ERROR_NONE
已成功設定 Thread PSKc。
OT_ERROR_INVALID_STATE
已啟用執行緒通訊協定。
另請參閱:
otThreadGetPskcRef

otThreadSetRouterDowngradeThreshold

void otThreadSetRouterDowngradeThreshold(
  otInstance *aInstance,
  uint8_t aThreshold
)

設定「領導」角色中使用的 ROUTER_DOWNGrade_THRESHOLD 參數。

詳細資料
參數
[in] aInstance
指向 OpenThread 執行個體的指標。
[in] aThreshold
ROUTER_DOWNGrade_THRESHOLD 的值。
另請參閱:
otThreadGetRouterDowngradeThreshold

otThreadSetRouter 符合資格

otError otThreadSetRouterEligible(
  otInstance *aInstance,
  bool aEligible
)

這個函式可設定裝置是否具備路由器資格。

如果 aEligible 為 false,且裝置目前是以路由器的形式運作,那麼這場通話會導致裝置卸離並嘗試以兒童重新連接。

詳細資料
參數
[in] aInstance
指向 OpenThread 執行個體的指標。
[in] aEligible
設為 TRUE,即可將裝置設為路由器符合條件,否則設為 FALSE。
回傳值
OT_ERROR_NONE
已成功調整路由器適用的設定。
OT_ERROR_NOT_CAPABLE
裝置無法做為路由器。

otThreadSetRouterIdRange

otError otThreadSetRouterIdRange(
  otInstance *aInstance,
  uint8_t aMinRouterId,
  uint8_t aMaxRouterId
)

這個函式可以設定路由器 ID 範圍,該範圍可指派給執行緒網路中的節點。

詳細資料
參數
[in] aInstance
指向 OpenThread 執行個體的指標。
[in] aMinRouterId
路由器 ID 數量下限。
[in] aMaxRouterId
路由器 ID 上限。
回傳值
OT_ERROR_NONE
已成功設定範圍。
OT_ERROR_INVALID_ARGS
aMinRouterId > aMaxRouterId,或者範圍未包含在 [0, 62] 範圍內。
另請參閱:
otThreadGetRouterIdRange

otThreadSetRouterSelectionJitter

void otThreadSetRouterSelectionJitter(
  otInstance *aInstance,
  uint8_t aRouterJitter
)

設定 REED/Router 角色中使用的 ROUTER_SELECTION_JITTER 參數。

詳細資料
參數
[in] aInstance
指向 OpenThread 執行個體的指標。
[in] aRouterJitter
ROUTER_SELECTION_JITTER 值。
另請參閱:
otThreadGetRouterSelectionJitter

otThreadSetRouter 升級閾值

void otThreadSetRouterUpgradeThreshold(
  otInstance *aInstance,
  uint8_t aThreshold
)

設定「領導」角色中使用的 ROUTER_UPGrade_THRESHOLD 參數。

詳細資料
參數
[in] aInstance
指向 OpenThread 執行個體的指標。
[in] aThreshold
ROUTER_UPGrade_THRESHOLD 的值。
另請參閱:
otThreadGetRouterUpgradeThreshold

otThreadSetSteeringData

void otThreadSetSteeringData(
  otInstance *aInstance,
  const otExtAddress *aExtAddress
)

設定方向盤資料。

設定選項 OPENTHREAD_CONFIG_MLE_STEERING_DATA_SET_OOB_ENABLE 應設為啟用從頻帶傳輸資料的功能。

詳細資料
參數
[in] aInstance
指向 OpenThread 執行個體的指標。
[in] aExtAddress
用來更新轉向資料的地址。全部的零都會清除轉向資料 (無轉向資料)。設定轉向資料/花卉篩選器的所有 0xFF,藉此接受/允許所有。之後會加到目前導引資料/花卉篩選器的一個特定 II64。

otThreadSetThreadVersionCheckEnabled

void otThreadSetThreadVersionCheckEnabled(
  otInstance *aInstance,
  bool aEnabled
)

這個函式可以設定是否啟用用於轉送轉送的安全性政策 TLV 版本門檻 (VR 欄位)。

詳細資料
參數
[in] aInstance
指向 OpenThread 執行個體的指標。
[in] aEnabled
設為 TRUE 表示啟用安全性政策 TLV 版本門檻,設為 FALSE,否則為 FALSE。

巨集

OT_CHILD_IP6_ADDRESS_ITERATOR_INIT

 OT_CHILD_IP6_ADDRESS_ITERATOR_INIT 0

otChildIP6AddressIterator 的初始化器。

資源

OpenThread API 參考資料主題來自原始碼,可在 GitHub 取得。如需詳細資訊或為說明文件貢獻一己之力,請參閱資源