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

TREL - 執行緒堆疊

這個模組可定義基礎架構上的 Thread Radio Encapsulation Link (TREL) API。

摘要

您需要啟用 OPENTHREAD_CONFIG_RADIO_LINK_TREL_ENABLE 才能使用這個模組中的函式。

類型

otTrelPeer typedef
struct otTrelPeer
這個結構代表 TREL 對等點。
otTrelPeerIterator typedef
uint16_t
這個類型代表用來疊代 TREL 對等資料表項目的疊代器。

函式

otTrelDisable(otInstance *aInstance)
void
這個函式會停用 TREL 作業。
otTrelEnable(otInstance *aInstance)
void
這個函式會啟用 TREL 作業。
otTrelGetNextPeer(otInstance *aInstance, otTrelPeerIterator *aIterator)
const otTrelPeer *
這個函式會重複解析對等資料表項目,然後從資料表中取得下一個項目。
otTrelInitPeerIterator(otInstance *aInstance, otTrelPeerIterator *aIterator)
void
這個函式會初始化對等資料表疊代器。
otTrelIsEnabled(otInstance *aInstance)
bool
此函式會指出是否要啟用 TREL 作業。
otTrelIsFilterEnabled(otInstance *aInstance)
bool
此函式會指出篩選器模式是否已啟用。
otTrelSetFilterEnabled(otInstance *aInstance, bool aEnable)
void
這個函式會設定篩選器模式 (啟用/停用篩選功能)。

結構

otTrelPeer

這個結構代表 TREL 對等點。

類型

otTrelPeer

struct otTrelPeer otTrelPeer

這個結構代表 TREL 對等點。

otTrelPeerIterator

uint16_t otTrelPeerIterator

這個類型代表用來疊代 TREL 對等資料表項目的疊代器。

函式

otTrelDisable

void otTrelDisable(
  otInstance *aInstance
)

這個函式會停用 TREL 作業。

這個函式會停止以服務名稱「_trel._udp」進行 DNS-SD 瀏覽、停止宣傳 TREL DNS-SD 服務,並清除 TREL 對等互連資料表。

說明
參數
[in] aInstance
OpenThread 執行個體。

otTrelEnable

void otTrelEnable(
  otInstance *aInstance
)

這個函式會啟用 TREL 作業。

這個函式會啟動本機瀏覽網域中服務名稱「_trel._udp」進行中的 DNS-SD 瀏覽,藉此找出其他支援 TREL 的裝置。裝置也會註冊使用 DNS-SD 進行宣傳的新服務,服務名稱是「_trel._udp」,代表其支援 TREL。裝置就可以開始接收對等端的 TREL 訊息。

說明
參數
[in] aInstance
OpenThread 執行個體。

otTrelGetNextPeer

const otTrelPeer * otTrelGetNextPeer(
  otInstance *aInstance,
  otTrelPeerIterator *aIterator
)

這個函式會重複解析對等資料表項目,然後從資料表中取得下一個項目。

說明
參數
[in] aInstance
OpenThread 執行個體。
[in] aIterator
疊代器。必須初始化。
退貨
在表格中指向其他 otTrelPeer 項目;如果沒有表格中的項目,則改為指向 NULL

otTrelInitPeerIterator

void otTrelInitPeerIterator(
  otInstance *aInstance,
  otTrelPeerIterator *aIterator
)

這個函式會初始化對等資料表疊代器。

說明
參數
[in] aInstance
OpenThread 執行個體。
[in] aIterator
要初始化的疊代器。

otTrelIs

bool otTrelIsEnabled(
  otInstance *aInstance
)

此函式會指出是否要啟用 TREL 作業。

說明
參數
[in] aInstance
OpenThread 執行個體。
傳回值
TRUE
如果 TREL 作業啟用了,
FALSE
如果 TREL 作業已停用,

otTrelIsFilterEnabled

bool otTrelIsFilterEnabled(
  otInstance *aInstance
)

此函式會指出篩選器模式是否已啟用。

說明
參數
[in] aInstance
OpenThread 執行個體。
傳回值
TRUE
FALSE
如果 TREL 篩選器模式處於停用狀態

otTrelSetFilterEnabled

void otTrelSetFilterEnabled(
  otInstance *aInstance,
  bool aEnable
)

這個函式會設定篩選器模式 (啟用/停用篩選功能)。

啟用篩選器模式後,所有 rx 和 tx 流量都會透過 TREL 介面自動捨棄。這主要主要用於測試,

otTrel{Enable/Disable}() 完全啟動/停止 TREL 作業不同,但啟用篩選器模式時,TREL 介面會繼續啟用。

說明
參數
[in] aInstance
OpenThread 執行個體。
[in] aFiltered
TRUE 鍵可啟用篩選器模式,FALSE [停用] 模式。

資源

OpenThread API 參照主題來自原始碼,位於 GitHub。 如需更多資訊或參閱我們的說明文件,請參閱資源