TREL - 執行緒堆疊
這個模組可定義基礎架構上的 Thread Radio Encapsulation Link (TREL) API。
摘要
您需要啟用 OPENTHREAD_CONFIG_RADIO_LINK_TREL_ENABLE
才能使用這個模組中的函式。
類型 |
|
---|---|
otTrelPeer
|
typedefstruct otTrelPeer
這個結構代表 TREL 對等點。 |
otTrelPeerIterator
|
typedefuint16_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 對等點。 |
類型
otTrelPeerIterator
uint16_t otTrelPeerIterator
這個類型代表用來疊代 TREL 對等資料表項目的疊代器。
函式
otTrelDisable
void otTrelDisable( otInstance *aInstance )
這個函式會停用 TREL 作業。
這個函式會停止以服務名稱「_trel._udp」進行 DNS-SD 瀏覽、停止宣傳 TREL DNS-SD 服務,並清除 TREL 對等互連資料表。
說明 | |||
---|---|---|---|
參數 |
|
otTrelEnable
void otTrelEnable( otInstance *aInstance )
這個函式會啟用 TREL 作業。
這個函式會啟動本機瀏覽網域中服務名稱「_trel._udp」進行中的 DNS-SD 瀏覽,藉此找出其他支援 TREL 的裝置。裝置也會註冊使用 DNS-SD 進行宣傳的新服務,服務名稱是「_trel._udp」,代表其支援 TREL。裝置就可以開始接收對等端的 TREL 訊息。
說明 | |||
---|---|---|---|
參數 |
|
otTrelGetNextPeer
const otTrelPeer * otTrelGetNextPeer( otInstance *aInstance, otTrelPeerIterator *aIterator )
這個函式會重複解析對等資料表項目,然後從資料表中取得下一個項目。
說明 | |||||
---|---|---|---|---|---|
參數 |
|
||||
退貨 |
在表格中指向其他
otTrelPeer 項目;如果沒有表格中的項目,則改為指向 NULL 。 |
otTrelInitPeerIterator
void otTrelInitPeerIterator( otInstance *aInstance, otTrelPeerIterator *aIterator )
這個函式會初始化對等資料表疊代器。
說明 | |||||
---|---|---|---|---|---|
參數 |
|
otTrelIs
bool otTrelIsEnabled( otInstance *aInstance )
此函式會指出是否要啟用 TREL 作業。
說明 | |||||
---|---|---|---|---|---|
參數 |
|
||||
傳回值 |
|
otTrelIsFilterEnabled
bool otTrelIsFilterEnabled( otInstance *aInstance )
此函式會指出篩選器模式是否已啟用。
說明 | |||||
---|---|---|---|---|---|
參數 |
|
||||
傳回值 |
|
otTrelSetFilterEnabled
void otTrelSetFilterEnabled( otInstance *aInstance, bool aEnable )
這個函式會設定篩選器模式 (啟用/停用篩選功能)。
啟用篩選器模式後,所有 rx 和 tx 流量都會透過 TREL 介面自動捨棄。這主要主要用於測試,
與 otTrel{Enable/Disable}()
完全啟動/停止 TREL 作業不同,但啟用篩選器模式時,TREL 介面會繼續啟用。
說明 | |||||
---|---|---|---|---|---|
參數 |
|