Deteksi Jam

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.

Typedef
otJamDetectionCallback)(bool aJamState, void *aContext) typedef
void(*
Pointer dipanggil jika deteksi kemacetan sinyal diaktifkan dan kemacetan terdeteksi.

Fungsi
otJamDetectionGetBusyPeriod(otInstance *aInstance)
uint8_t
Mendapatkan Periode Sibuk Deteksi Jam (dalam detik)
otJamDetectionGetHistoryBitmap(otInstance *aInstance)
uint64_t
Mendapatkan bitmap histori saat ini.
otJamDetectionGetRssiThreshold(otInstance *aInstance)
int8_t
Mendapatkan Batas RSSI Deteksi Jam (dalam dBm).
otJamDetectionGetState(otInstance *aInstance)
bool
Mendapatkan Status Deteksi Jam.
otJamDetectionGetWindow(otInstance *aInstance)
uint8_t
Dapatkan Jendela Deteksi Jam (dalam hitungan detik).
otJamDetectionIsEnabled(otInstance *aInstance)
bool
Mendapatkan Status Deteksi Jam (diaktifkan/dinonaktifkan)
otJamDetectionSetBusyPeriod(otInstance *aInstance, uint8_t aBusyPeriod)
Tetapkan Periode Sibuk Deteksi Jam (dalam detik).
otJamDetectionSetRssiThreshold(otInstance *aInstance, int8_t aRssiThreshold)
Menyetel Batas RSSI Deteksi Jam (dalam dBm).
otJamDetectionSetWindow(otInstance *aInstance, uint8_t aWindow)
Menyetel Jendela Deteksi Jam (dalam detik).
otJamDetectionStart(otInstance *aInstance, otJamDetectionCallback aCallback, void *aContext)
Mulai deteksi gangguan.
otJamDetectionStop(otInstance *aInstance)
Hentikan deteksi kemacetan.

Typedef

otJamDetectionCallback

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

Pointer dipanggil jika deteksi kemacetan sinyal diaktifkan dan kemacetan terdeteksi.

Detail
Parameter
[in] aJamState
Status kemacetan saat ini (true jika macet terdeteksi, false jika tidak).
[in] aContext
Pointer ke konteks khusus aplikasi.

Fungsi

otJamDetectionGetBusyPeriod

uint8_t otJamDetectionGetBusyPeriod(
  otInstance *aInstance
)

Mendapatkan Periode Sibuk Deteksi Jam (dalam detik)

Detail
Parameter
[in] aInstance
Pointer ke instance OpenThread.
Hasil
Periode Sibuk Deteksi Kemacetan.

otJamDetectionGetHistoryBitmap

uint64_t otJamDetectionGetHistoryBitmap(
  otInstance *aInstance
)

Mendapatkan bitmap histori saat ini.

Nilai ini memberikan informasi tentang status modul deteksi gangguan saat ini untuk tujuan pemantauan/proses debug. Ia 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 ini disetel ke 1 jika modul deteksi gangguan mengamati/mendeteksi level sinyal tinggi selama interval satu detik yang sesuai.

Detail
Parameter
[in] aInstance
Pointer ke instance OpenThread.
Hasil
Bitmap histori saat ini.

otJamDetectionGetRssiThreshold

int8_t otJamDetectionGetRssiThreshold(
  otInstance *aInstance
)

Mendapatkan Batas RSSI Deteksi Jam (dalam dBm).

Detail
Parameter
[in] aInstance
Pointer ke instance OpenThread.
Hasil
Batas RSSI Deteksi Jam.

otJamDetectionGetState

bool otJamDetectionGetState(
  otInstance *aInstance
)

Mendapatkan Status Deteksi Jam.

Detail
Parameter
[in] aInstance
Pointer ke instance OpenThread.
Hasil
Status Deteksi Jam (true jam terdeteksi, `salah' jika tidak).

otJamDetectionGetWindow

uint8_t otJamDetectionGetWindow(
  otInstance *aInstance
)

Dapatkan Jendela Deteksi Jam (dalam hitungan detik).

Detail
Parameter
[in] aInstance
Pointer ke instance OpenThread.
Hasil
Jendela Deteksi Jam.

otJamDetectionIsEnabled

bool otJamDetectionIsEnabled(
  otInstance *aInstance
)

Mendapatkan Status Deteksi Jam (diaktifkan/dinonaktifkan)

Detail
Parameter
[in] aInstance
Pointer ke instance OpenThread.
Hasil
Status Deteksi Jam (true jika diaktifkan, false jika tidak).

otJamDetectionSetBusyPeriod

otError otJamDetectionSetBusyPeriod(
  otInstance *aInstance,
  uint8_t aBusyPeriod
)

Tetapkan Periode Sibuk Deteksi Jam (dalam detik).

Jumlah detik gabungan dalam jendela deteksi dengan RSSI yang harus berada di atas ambang batas untuk memicu deteksi.

Detail
Parameter
[in] aInstance
Pointer ke instance OpenThread.
[in] aBusyPeriod
Periode sibuk Deteksi Jam (harus bukan nol dan kurang dari atau sama dengan Jendela Deteksi Jam)
Nilai Pengembalian
OT_ERROR_NONE
Berhasil menyetel jendela.
OT_ERROR_INVALID_ARGS
Input yang diberikan tidak berada dalam rentang yang valid.

otJamDetectionSetRssiThreshold

otError otJamDetectionSetRssiThreshold(
  otInstance *aInstance,
  int8_t aRssiThreshold
)

Menyetel Batas RSSI Deteksi Jam (dalam dBm).

Detail
Parameter
[in] aInstance
Pointer ke instance OpenThread.
[in] aRssiThreshold
Nilai minimum RSSI.
Nilai Pengembalian
OT_ERROR_NONE
Berhasil menetapkan batas.

otJamDetectionSetWindow

otError otJamDetectionSetWindow(
  otInstance *aInstance,
  uint8_t aWindow
)

Menyetel Jendela Deteksi Jam (dalam detik).

Detail
Parameter
[in] aInstance
Pointer ke instance OpenThread.
[in] aWindow
Jendela Deteksi Jam (rentang yang valid adalah 1 hingga 63)
Nilai Pengembalian
OT_ERROR_NONE
Berhasil menyetel jendela.
OT_ERROR_INVALID_ARGS
Parameter input yang diberikan tidak berada dalam rentang yang valid (1-63)

otJamDetectionStart

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

Mulai deteksi gangguan.

Detail
Parameter
[in] aInstance
Pointer ke instance OpenThread.
[in] aCallback
Pointer ke fungsi yang dipanggil untuk memberi tahu perubahan status gangguan.
[in] aContext
Pointer ke konteks khusus aplikasi.
Nilai Pengembalian
OT_ERROR_NONE
Berhasil memulai deteksi gangguan.
OT_ERROR_ALREADY
Deteksi kemacetan telah dimulai sebelumnya.

otJamDetectionStop

otError otJamDetectionStop(
  otInstance *aInstance
)

Hentikan deteksi kemacetan.

Detail
Parameter
[in] aInstance
Pointer ke instance OpenThread.
Nilai Pengembalian
OT_ERROR_NONE
Berhasil menghentikan deteksi gangguan.
OT_ERROR_ALREADY
Deteksi kemacetan sudah dihentikan.

Referensi

Topik Referensi OpenThread API berasal dari kode sumber yang tersedia di GitHub. Untuk informasi selengkapnya, atau untuk berkontribusi pada dokumentasi kami, lihat Referensi.