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

Jam 偵測

這個模組包含訊號幹擾偵測功能。

總結

啟用 Jam 偵測功能 (OPENTHREAD_CONFIG_JAM_DETECTION_ENABLE) 時,可使用此模組中的函式。

Typedefs

otJamDetectionCallback)(bool aJamState, void *aContext) typedef
void(*
如果訊號訊號偵測已啟用且偵測到 Jam,就會呼叫此函式指標。

函式

otJamDetectionGetBusyPeriod(otInstance *aInstance)
uint8_t
取得 Jam 偵測忙碌期間 (以秒為單位)
otJamDetectionGetHistoryBitmap(otInstance *aInstance)
uint64_t
取得目前的紀錄點陣圖。
otJamDetectionGetRssiThreshold(otInstance *aInstance)
int8_t
取得 Jam 偵測 RSSI 閾值 (dBm)。
otJamDetectionGetState(otInstance *aInstance)
bool
取得 Jam 偵測狀態。
otJamDetectionGetWindow(otInstance *aInstance)
uint8_t
取得 Jam 偵測偵測視窗 (以秒為單位)。
otJamDetectionIsEnabled(otInstance *aInstance)
bool
取得 Jam 偵測狀態 (啟用/停用)
otJamDetectionSetBusyPeriod(otInstance *aInstance, uint8_t aBusyPeriod)
設定 Jam 偵測忙碌時段 (以秒為單位)。
otJamDetectionSetRssiThreshold(otInstance *aInstance, int8_t aRssiThreshold)
設定 Jam 偵測 RSSI 閾值 (以 dBm 為單位)。
otJamDetectionSetWindow(otInstance *aInstance, uint8_t aWindow)
設定 Jam 偵測視窗 (以秒為單位)。
otJamDetectionStart(otInstance *aInstance, otJamDetectionCallback aCallback, void *aContext)
啟動幹擾偵測。
otJamDetectionStop(otInstance *aInstance)
停止偵測幹擾。

Typedefs

otJamDetectionCallback

void(* otJamDetectionCallback)(bool aJamState, void *aContext)

如果訊號訊號偵測已啟用且偵測到 Jam,就會呼叫此函式指標。

詳細資料
參數總數
[in] aJamState
目前的 Jam 狀態 (true 偵測到 Jam 時,false 不可有此情況)。
[in] aContext
應用程式專屬背景資訊。

函式

otJamDetectionGetBusyPeriod

uint8_t otJamDetectionGetBusyPeriod(
  otInstance *aInstance
)

取得 Jam 偵測忙碌期間 (以秒為單位)

詳細資料
參數總數
[in] aInstance
指向 OpenThread 執行個體的指標。
傳回
Jam 偵測繁忙時段。

otJamDetectionGetHistoryBitmap

uint64_t otJamDetectionGetHistoryBitmap(
  otInstance *aInstance
)

取得目前的紀錄點陣圖。

這個值可提供監測偵測模組目前狀態的相關資訊,方便您進行監控/偵錯。它返回一個 64 位值,其中每個位對應於一個第二時間,從最後的時間的位 0 為最後的間隔,位 63 用於最古老的時間段(63 秒之前)。如果在對應的一秒鐘間隔內,結果中偵測到/偵測出高度訊號水平,該位元就會設為 1。

詳細資料
參數總數
[in] aInstance
指向 OpenThread 執行個體的指標。
傳回
目前的記錄點陣圖。

otJamDetectionGetRssiThreshold

int8_t otJamDetectionGetRssiThreshold(
  otInstance *aInstance
)

取得 Jam 偵測 RSSI 閾值 (dBm)。

詳細資料
參數總數
[in] aInstance
指向 OpenThread 執行個體的指標。
傳回
Jam 偵測 RSSI 門檻。

otJamDetectionGetState

bool otJamDetectionGetState(
  otInstance *aInstance
)

取得 Jam 偵測狀態。

詳細資料
參數總數
[in] aInstance
指向 OpenThread 執行個體的指標。
傳回
Jam 偵測狀態 (偵測到 true 個 Jam,否則為「false'」。

otJamDetectionGetWindow

uint8_t otJamDetectionGetWindow(
  otInstance *aInstance
)

取得 Jam 偵測偵測視窗 (以秒為單位)。

詳細資料
參數總數
[in] aInstance
指向 OpenThread 執行個體的指標。
傳回
Jam 偵測視窗。

otJamDetectionIsEnabled

bool otJamDetectionIsEnabled(
  otInstance *aInstance
)

取得 Jam 偵測狀態 (啟用/停用)

詳細資料
參數總數
[in] aInstance
指向 OpenThread 執行個體的指標。
傳回
Jam 偵測狀態 (如果已啟用,則值為 true,否則為 false)。

otJamDetectionSetBusyPeriod

otError otJamDetectionSetBusyPeriod(
  otInstance *aInstance,
  uint8_t aBusyPeriod
)

設定 Jam 偵測忙碌時段 (以秒為單位)。

在偵測期間,RSSI 必須高於門檻值才會觸發偵測程序的匯總秒數。

詳細資料
參數
[in] aInstance
指向 OpenThread 執行個體的指標。
[in] aBusyPeriod
Jam 偵測忙碌時段 (不得為零且小於或等於 Jam 偵測視窗)
傳回值
OT_ERROR_NONE
已成功設定視窗。
OT_ERROR_INVALID_ARGS
提供的輸入內容不在有效範圍內。

otJamDetectionSetRssiThreshold

otError otJamDetectionSetRssiThreshold(
  otInstance *aInstance,
  int8_t aRssiThreshold
)

設定 Jam 偵測 RSSI 閾值 (以 dBm 為單位)。

詳細資料
參數總數
[in] aInstance
指向 OpenThread 執行個體的指標。
[in] aRssiThreshold
RSSI 門檻。
傳回值
OT_ERROR_NONE
已成功設定門檻。

otJamDetectionSetWindow

otError otJamDetectionSetWindow(
  otInstance *aInstance,
  uint8_t aWindow
)

設定 Jam 偵測視窗 (以秒為單位)。

詳細資料
參數總數
[in] aInstance
指向 OpenThread 執行個體的指標。
[in] aWindow
Jam 偵測視窗 (有效範圍為 1 至 63)
傳回值
OT_ERROR_NONE
已成功設定視窗。
OT_ERROR_INVALID_ARGS
指定的輸入參數不在有效範圍內 (1-63)

otJamDetectionStart

otError otJamDetectionStart(
  otInstance *aInstance,
  otJamDetectionCallback aCallback,
  void *aContext
)

啟動幹擾偵測。

詳細資料
參數
[in] aInstance
指向 OpenThread 執行個體的指標。
[in] aCallback
指向 " 函式 (指向幹擾狀態變更的通知) 的指標。
[in] aContext
應用程式專屬背景資訊。
傳回值
OT_ERROR_NONE
已成功啟動幹擾偵測。
OT_ERROR_ALREADY
Jam 偵測作業已開始。

otJamDetectionStop

otError otJamDetectionStop(
  otInstance *aInstance
)

停止偵測幹擾。

詳細資料
參數總數
[in] aInstance
指向 OpenThread 執行個體的指標。
傳回值
OT_ERROR_NONE
已成功停止幹擾偵測。
OT_ERROR_ALREADY
Jam 偵測功能已經停止。

資源

OpenThread API 參考主題源自原始碼,可從 GitHub 取得。如要瞭解詳情或參閱說明文件,請參閱資源