Phát hiện Jam

Mô-đun này bao gồm các hàm cho tính năng phát hiện nhiễu tín hiệu.

Tóm tắt

Bạn có thể sử dụng các chức năng trong mô-đun này khi tính năng phát hiện kẹt xe (OPENTHREAD_CONFIG_JAM_DETECTION_ENABLE) đang bật.

Typedef
otJamDetectionCallback)(bool aJamState, void *aContext) typedef
void(*
Con trỏ sẽ được gọi nếu tính năng phát hiện kẹt tín hiệu được bật và phát hiện thấy kẹt.

Hàm
otJamDetectionGetBusyPeriod(otInstance *aInstance)
uint8_t
Xem Khoảng thời gian bận khi phát hiện Jam (tính bằng giây)
otJamDetectionGetHistoryBitmap(otInstance *aInstance)
uint64_t
Tải bitmap lịch sử hiện tại.
otJamDetectionGetRssiThreshold(otInstance *aInstance)
int8_t
Nhận ngưỡng RSSI của tính năng phát hiện Jam (tính bằng dBm).
otJamDetectionGetState(otInstance *aInstance)
bool
Xem trạng thái phát hiện Jam.
otJamDetectionGetWindow(otInstance *aInstance)
uint8_t
Tải Cửa sổ phát hiện Jam (tính bằng giây).
otJamDetectionIsEnabled(otInstance *aInstance)
bool
Xem Trạng thái phát hiện Jam (bật/tắt)
otJamDetectionSetBusyPeriod(otInstance *aInstance, uint8_t aBusyPeriod)
Đặt Khoảng thời gian bận khi phát hiện Jam (tính bằng giây).
otJamDetectionSetRssiThreshold(otInstance *aInstance, int8_t aRssiThreshold)
Đặt Ngưỡng RSSI phát hiện Jam (tính bằng dBm).
otJamDetectionSetWindow(otInstance *aInstance, uint8_t aWindow)
Thiết lập Cửa sổ phát hiện lỗi (tính bằng giây).
otJamDetectionStart(otInstance *aInstance, otJamDetectionCallback aCallback, void *aContext)
Bắt đầu phát hiện tình trạng nghẽn.
otJamDetectionStop(otInstance *aInstance)
Dừng tính năng phát hiện tình trạng nghẽn.

Typedef

otJamDetectionCallback

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

Con trỏ sẽ được gọi nếu tính năng phát hiện kẹt tín hiệu được bật và phát hiện thấy kẹt.

Thông tin chi tiết
Thông số
[in] aJamState
Trạng thái jam hiện tại (true nếu phát hiện jam, nếu không thì false).
[in] aContext
Con trỏ đến ngữ cảnh dành riêng cho ứng dụng.

Hàm

otJamDetectionGetBusyPeriod

uint8_t otJamDetectionGetBusyPeriod(
  otInstance *aInstance
)

Xem Khoảng thời gian bận khi phát hiện Jam (tính bằng giây)

Thông tin chi tiết
Thông số
[in] aInstance
Con trỏ đến một thực thể OpenThread.
Trả về
Giai đoạn bận phát hiện Jam.

otJamDetectionGetHistoryBitmap

uint64_t otJamDetectionGetHistoryBitmap(
  otInstance *aInstance
)

Tải bitmap lịch sử hiện tại.

Giá trị này cung cấp thông tin về trạng thái hiện tại của mô-đun phát hiện tình trạng gây nhiễu cho mục đích giám sát/gỡ lỗi. Nó trả về giá trị 64 bit, trong đó mỗi bit tương ứng với một khoảng thời gian giây bắt đầu bằng bit 0 cho khoảng thời gian gần đây nhất và bit 63 cho khoảng thời gian cũ nhất (63 giây trước đó). Bit được đặt thành 1 nếu mô-đun phát hiện nhiễu quan sát/phát hiện được mức tín hiệu cao trong khoảng thời gian một giây tương ứng.

Thông tin chi tiết
Thông số
[in] aInstance
Con trỏ đến một thực thể OpenThread.
Trả về
bitmap lịch sử hiện tại.

otJamDetectionGetRssiThreshold

int8_t otJamDetectionGetRssiThreshold(
  otInstance *aInstance
)

Nhận ngưỡng RSSI của tính năng phát hiện Jam (tính bằng dBm).

Thông tin chi tiết
Thông số
[in] aInstance
Con trỏ đến một thực thể OpenThread.
Trả về
Ngưỡng RSSI phát hiện Jam.

otJamDetectionGetState

bool otJamDetectionGetState(
  otInstance *aInstance
)

Xem trạng thái phát hiện Jam.

Thông tin chi tiết
Thông số
[in] aInstance
Con trỏ đến một thực thể OpenThread.
Trả về
Trạng thái Phát hiện Jam (đã phát hiện true kẹt, nếu không thì "false" (sai).

otJamDetectionGetWindow

uint8_t otJamDetectionGetWindow(
  otInstance *aInstance
)

Tải Cửa sổ phát hiện Jam (tính bằng giây).

Thông tin chi tiết
Thông số
[in] aInstance
Con trỏ đến một thực thể OpenThread.
Trả về
Cửa sổ phát hiện Jam.

otJamDetectionIsEnabled

bool otJamDetectionIsEnabled(
  otInstance *aInstance
)

Xem Trạng thái phát hiện Jam (bật/tắt)

Thông tin chi tiết
Thông số
[in] aInstance
Con trỏ đến một thực thể OpenThread.
Trả về
Trạng thái Phát hiện Jam (true nếu được bật, false nếu không bật).

otJamDetectionSetBusyPeriod

otError otJamDetectionSetBusyPeriod(
  otInstance *aInstance,
  uint8_t aBusyPeriod
)

Đặt Khoảng thời gian bận khi phát hiện Jam (tính bằng giây).

Số giây tổng hợp trong khoảng thời gian phát hiện khi RSSI phải cao hơn ngưỡng để kích hoạt tính năng phát hiện.

Thông tin chi tiết
Thông số
[in] aInstance
Con trỏ đến một thực thể OpenThread.
[in] aBusyPeriod
Giai đoạn bận phát hiện Jam (phải khác 0 và nhỏ hơn hoặc bằng Cửa sổ phát hiện Jam)
Giá trị trả về
OT_ERROR_NONE
Đã đặt cửa sổ thành công.
OT_ERROR_INVALID_ARGS
Giá trị nhập vào không nằm trong phạm vi hợp lệ.

otJamDetectionSetRssiThreshold

otError otJamDetectionSetRssiThreshold(
  otInstance *aInstance,
  int8_t aRssiThreshold
)

Đặt Ngưỡng RSSI phát hiện Jam (tính bằng dBm).

Thông tin chi tiết
Thông số
[in] aInstance
Con trỏ đến một thực thể OpenThread.
[in] aRssiThreshold
Ngưỡng RSSI.
Giá trị trả về
OT_ERROR_NONE
Đã đặt ngưỡng thành công.

otJamDetectionSetWindow

otError otJamDetectionSetWindow(
  otInstance *aInstance,
  uint8_t aWindow
)

Thiết lập Cửa sổ phát hiện lỗi (tính bằng giây).

Thông tin chi tiết
Thông số
[in] aInstance
Con trỏ đến một thực thể OpenThread.
[in] aWindow
Cửa sổ phát hiện Jam (phạm vi hợp lệ là 1 đến 63)
Giá trị trả về
OT_ERROR_NONE
Đã đặt cửa sổ thành công.
OT_ERROR_INVALID_ARGS
Tham số đầu vào đã cho không nằm trong phạm vi hợp lệ (1-63)

otJamDetectionStart

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

Bắt đầu phát hiện tình trạng nghẽn.

Thông tin chi tiết
Thông số
[in] aInstance
Con trỏ đến một thực thể OpenThread.
[in] aCallback
Con trỏ đến một hàm được gọi để thông báo về sự thay đổi trạng thái gây nhiễu.
[in] aContext
Con trỏ đến ngữ cảnh dành riêng cho ứng dụng.
Giá trị trả về
OT_ERROR_NONE
Đã bắt đầu phát hiện hiện tượng nghẽn.
OT_ERROR_ALREADY
Tính năng phát hiện Jam đã được bắt đầu trước đó.

otJamDetectionStop

otError otJamDetectionStop(
  otInstance *aInstance
)

Dừng tính năng phát hiện tình trạng nghẽn.

Thông tin chi tiết
Thông số
[in] aInstance
Con trỏ đến một thực thể OpenThread.
Giá trị trả về
OT_ERROR_NONE
Dừng thành công tính năng phát hiện nhiễu.
OT_ERROR_ALREADY
Tính năng phát hiện Jam đã dừng hoạt động.

Tài nguyên

Các chủ đề tham khảo API OpenThread bắt nguồn từ mã nguồn, có trên GitHub. Để biết thêm thông tin hoặc để đóng góp cho tài liệu của chúng tôi, hãy tham khảo Tài nguyên.