Deteksi Kemacetan

Modul ini mencakup fungsi untuk fitur deteksi gangguan sinyal.

Ringkasan

Fungsi dalam modul ini tersedia saat fitur deteksi kemacetan ( OPENTHREAD_CONFIG_JAM_DETECTION_ENABLE ) diaktifkan.

Typedefs
`otJamDetectionCallback )(bool aJamState, void *aContext)`	typedef `void(*` Penunjuk fungsi ini dipanggil jika deteksi kemacetan sinyal diaktifkan dan kemacetan terdeteksi.

Fungsi
`otJamDetectionGetBusyPeriod ( otInstance *aInstance)`	`uint8_t` Dapatkan Deteksi Kemacetan Periode Sibuk (dalam hitungan detik)
`otJamDetectionGetHistoryBitmap ( otInstance *aInstance)`	`uint64_t` Dapatkan bitmap riwayat saat ini.
`otJamDetectionGetRssiThreshold ( otInstance *aInstance)`	`int8_t` Dapatkan Deteksi Kemacetan RSSI Threshold (dalam dBm).
`otJamDetectionGetState ( otInstance *aInstance)`	`bool` Dapatkan Status Deteksi Kemacetan.
`otJamDetectionGetWindow ( otInstance *aInstance)`	`uint8_t` Dapatkan Jendela Deteksi Deteksi Kemacetan (dalam hitungan detik).
`otJamDetectionIsEnabled ( otInstance *aInstance)`	`bool` Dapatkan Status Deteksi Kemacetan (diaktifkan / dinonaktifkan)
`otJamDetectionSetBusyPeriod ( otInstance *aInstance, uint8_t aBusyPeriod)`	`otError` Atur Periode Sibuk Deteksi Kemacetan (dalam detik).
`otJamDetectionSetRssiThreshold ( otInstance *aInstance, int8_t aRssiThreshold)`	`otError` Setel Deteksi Kemacetan RSSI Threshold (dalam dBm).
`otJamDetectionSetWindow ( otInstance *aInstance, uint8_t aWindow)`	`otError` Setel Jendela Deteksi Deteksi Kemacetan (dalam detik).
`otJamDetectionStart ( otInstance aInstance, otJamDetectionCallback aCallback, void aContext)`	`otError` Mulai deteksi gangguan.
`otJamDetectionStop ( otInstance *aInstance)`	`otError` Hentikan deteksi gangguan.

Typedefs

otJamDetectionCallback

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

Penunjuk fungsi ini dipanggil jika deteksi kemacetan sinyal diaktifkan dan kemacetan terdeteksi.

Detail

Parameter

`[in] aJamState`	Status kemacetan saat ini ( `true` jika kemacetan terdeteksi, `false` jika tidak).
`[in] aContext`	Penunjuk ke konteks khusus aplikasi.

Fungsi

otJamDetectionGetBusyPeriod

uint8_t otJamDetectionGetBusyPeriod(
  otInstance *aInstance
)

Dapatkan Deteksi Kemacetan Periode Sibuk (dalam hitungan detik)

Detail

Parameter

[in] aInstance

Penunjuk ke instance OpenThread.

Kembali

Deteksi Kemacetan Periode Sibuk.

otJamDetectionGetHistoryBitmap

uint64_t otJamDetectionGetHistoryBitmap(
  otInstance *aInstance
)

Dapatkan bitmap riwayat saat ini.

Nilai ini memberikan informasi tentang status modul deteksi gangguan saat ini untuk tujuan pemantauan / debugging. Ini mengembalikan nilai 64-bit di mana setiap bit sesuai dengan interval satu detik dimulai dengan bit 0 untuk interval terbaru dan bit 63 untuk interval terlama (63 detik sebelumnya). Bit disetel ke 1 jika modul deteksi gangguan mengamati / mendeteksi level sinyal tinggi selama interval satu detik yang sesuai.

Detail

Parameter

[in] aInstance

Penunjuk ke instance OpenThread.

Kembali

Bitmap riwayat saat ini.

otJamDetectionGetRssiThreshold

int8_t otJamDetectionGetRssiThreshold(
  otInstance *aInstance
)

Dapatkan Threshold RSSI Deteksi Kemacetan (dalam dBm).

Detail

Parameter

[in] aInstance

Penunjuk ke instance OpenThread.

Kembali

Ambang Batas RSSI Deteksi Kemacetan.

otJamDetectionGetState

bool otJamDetectionGetState(
  otInstance *aInstance
)

Dapatkan Status Deteksi Kemacetan.

Detail

Parameter

[in] aInstance

Penunjuk ke instance OpenThread.

Kembali

Negara Jam Detection ( true kemacetan terdeteksi, `palsu' sebaliknya).

otJamDetectionGetWindow

uint8_t otJamDetectionGetWindow(
  otInstance *aInstance
)

Dapatkan Jendela Deteksi Deteksi Kemacetan (dalam hitungan detik).

Detail

Parameter

[in] aInstance

Penunjuk ke instance OpenThread.

Kembali

Jendela Deteksi Kemacetan.

otJamDetectionIsEnabled

bool otJamDetectionIsEnabled(
  otInstance *aInstance
)

Dapatkan Status Deteksi Kemacetan (diaktifkan / dinonaktifkan)

Detail

Parameter

[in] aInstance

Penunjuk ke instance OpenThread.

Kembali

Status Deteksi Kemacetan (benar jika diaktifkan, salah jika tidak).

otJamDetectionSetBusyPeriod

otError otJamDetectionSetBusyPeriod(
  otInstance *aInstance,
  uint8_t aBusyPeriod
)

Atur Periode Sibuk Deteksi Kemacetan (dalam detik).

Jumlah detik gabungan dalam jendela deteksi di mana RSSI harus di atas ambang batas untuk memicu deteksi.

Detail

Parameter

`[in] aInstance`	Penunjuk ke instance OpenThread.
`[in] aBusyPeriod`	Periode sibuk Deteksi Kemacetan (harus bukan nol dan kurang dari atau sama dengan Jendela Deteksi Kemacetan)

Kembalikan Nilai

`OT_ERROR_NONE`	Berhasil mengatur jendela.
`OT_ERROR_INVALID_ARGS`	Input yang diberikan tidak dalam kisaran yang valid.

otJamDetectionSetRssiThreshold

otError otJamDetectionSetRssiThreshold(
  otInstance *aInstance,
  int8_t aRssiThreshold
)

Setel Deteksi Kemacetan RSSI Threshold (dalam dBm).

Detail

Parameter

`[in] aInstance`	Penunjuk ke instance OpenThread.
`[in] aRssiThreshold`	Ambang RSSI.

Kembalikan Nilai

OT_ERROR_NONE

Berhasil mengatur ambang batas.

otJamDetectionSetWindow

otError otJamDetectionSetWindow(
  otInstance *aInstance,
  uint8_t aWindow
)

Setel Jendela Deteksi Deteksi Kemacetan (dalam detik).

Detail

Parameter

`[in] aInstance`	Penunjuk ke instance OpenThread.
`[in] aWindow`	Jendela Deteksi Kemacetan (kisaran yang valid adalah 1 hingga 63)

Kembalikan Nilai

`OT_ERROR_NONE`	Berhasil mengatur jendela.
`OT_ERROR_INVALID_ARGS`	Parameter masukan yang diberikan tidak dalam kisaran yang valid (1-63)

otJamDetectionStart

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

Mulai deteksi gangguan.

Detail

Parameter

`[in] aInstance`	Penunjuk ke instance OpenThread.
`[in] aCallback`	Penunjuk ke fungsi yang dipanggil untuk memberi tahu perubahan status gangguan.
`[in] aContext`	Penunjuk ke konteks khusus aplikasi.

Kembalikan Nilai

`OT_ERROR_NONE`	Berhasil memulai deteksi gangguan.
`OT_ERROR_ALREADY`	Deteksi kemacetan telah dimulai sebelumnya.

otJamDetectionStop

otError otJamDetectionStop(
  otInstance *aInstance
)

Hentikan deteksi gangguan.

Detail

Parameter

[in] aInstance

Penunjuk ke instance OpenThread.

Kembalikan Nilai

`OT_ERROR_NONE`	Berhasil menghentikan deteksi gangguan.
`OT_ERROR_ALREADY`	Deteksi kemacetan sudah dihentikan.