Wykrywanie Jamu

Ten moduł zawiera funkcje wykrywania zacięć sygnałów.

Podsumowanie

Funkcje w tym module są dostępne, gdy włączona jest funkcja wykrywania zacięć (OPENTHREAD_CONFIG_JAM_DETECTION_ENABLE).

Definicje typów
otJamDetectionCallback)(bool aJamState, void *aContext) typedef
void(*
Wskaźnik jest wywoływany po wykryciu zacięcia sygnału.

Funkcje
otJamDetectionGetBusyPeriod(otInstance *aInstance)
uint8_t
Zacznij korzystać z okresu oczekiwania w przypadku wykrycia Jamu (w sekundach)
otJamDetectionGetHistoryBitmap(otInstance *aInstance)
uint64_t
Pobierz bieżącą bitmapę historii.
otJamDetectionGetRssiThreshold(otInstance *aInstance)
int8_t
Pobierz próg RSSI wykrywania Jamu (w dBm).
otJamDetectionGetState(otInstance *aInstance)
bool
uzyskać stan wykrywania Jamu.
otJamDetectionGetWindow(otInstance *aInstance)
uint8_t
Pobierz okno wykrywania Jamu (w sekundach).
otJamDetectionIsEnabled(otInstance *aInstance)
bool
Sprawdzanie stanu wykrywania Jamu (włączone/wyłączone)
otJamDetectionSetBusyPeriod(otInstance *aInstance, uint8_t aBusyPeriod)
Ustaw okres braku aktywności w wykrywaniu Jamu (w sekundach).
otJamDetectionSetRssiThreshold(otInstance *aInstance, int8_t aRssiThreshold)
Ustaw próg RSSI wykrywania Jamu (w dBm).
otJamDetectionSetWindow(otInstance *aInstance, uint8_t aWindow)
Ustaw okno wykrywania Jamu (w sekundach).
otJamDetectionStart(otInstance *aInstance, otJamDetectionCallback aCallback, void *aContext)
Uruchom wykrywanie zacięć.
otJamDetectionStop(otInstance *aInstance)
Zatrzymaj wykrywanie zacięć.

Definicje typów

otJamDetectionCallback

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

Wskaźnik jest wywoływany po wykryciu zacięcia sygnału.

Szczegóły
Parametry
[in] aJamState
Bieżący stan Jamu (true, jeśli został wykryty, false w przeciwnym razie).
[in] aContext
Wskaźnik do kontekstu aplikacji.

Funkcje

otJamDetectionGetBusyPeriod

uint8_t otJamDetectionGetBusyPeriod(
  otInstance *aInstance
)

Zacznij korzystać z okresu oczekiwania w przypadku wykrycia Jamu (w sekundach)

Szczegóły
Parametry
[in] aInstance
Wskaźnik do instancji OpenThread.
Zwroty
Okres zajęty w wykrywaniu Jamu.

otJamDetectionGetHistoryBitmap

uint64_t otJamDetectionGetHistoryBitmap(
  otInstance *aInstance
)

Pobierz bieżącą bitmapę historii.

Ta wartość dostarcza informacji o bieżącym stanie modułu wykrywania zacięć na potrzeby monitorowania lub debugowania. Zwraca wartość 64-bitową, w której każdy bit odpowiada 1-sekundowemu interwałowi, zaczynając od bitu 0 dla ostatniego interwału i bitu 63 dla najstarszych przedziałów czasu (63 s wcześniej). Bit ma wartość 1, jeśli moduł wykrywania zacięć zaobserwowany/wykrył wysoki poziom sygnału w odpowiednim 1-sekundowym przedziale czasu.

Szczegóły
Parametry
[in] aInstance
Wskaźnik do instancji OpenThread.
Zwroty
Bieżąca bitmapa historii.

otJamDetectionGetRssiThreshold

int8_t otJamDetectionGetRssiThreshold(
  otInstance *aInstance
)

Pobierz próg RSSI wykrywania Jamu (w dBm).

Szczegóły
Parametry
[in] aInstance
Wskaźnik do instancji OpenThread.
Zwroty
Próg RSSI wykrywania Jamu.

otJamDetectionGetState

bool otJamDetectionGetState(
  otInstance *aInstance
)

uzyskać stan wykrywania Jamu.

Szczegóły
Parametry
[in] aInstance
Wskaźnik do instancji OpenThread.
Zwroty
stan wykrywania Jamu (wykryto true jam; w przeciwnym razie „false”);

otJamDetectionGetWindow

uint8_t otJamDetectionGetWindow(
  otInstance *aInstance
)

Pobierz okno wykrywania Jamu (w sekundach).

Szczegóły
Parametry
[in] aInstance
Wskaźnik do instancji OpenThread.
Zwroty
Okno wykrywania Jamu.

otJamDetectionIsEnabled

bool otJamDetectionIsEnabled(
  otInstance *aInstance
)

Sprawdzanie stanu wykrywania Jamu (włączone/wyłączone)

Szczegóły
Parametry
[in] aInstance
Wskaźnik do instancji OpenThread.
Zwroty
stan wykrywania Jamu (prawda, jeśli włączono, fałsz, w przeciwnym razie ma wartość prawda).

otJamDetectionSetBusyPeriod

otError otJamDetectionSetBusyPeriod(
  otInstance *aInstance,
  uint8_t aBusyPeriod
)

Ustaw okres braku aktywności w wykrywaniu Jamu (w sekundach).

Liczba zbiorczych sekund w oknie wykrywania, w której RSSI musi przekroczyć próg, aby aktywować wykrywanie.

Szczegóły
Parametry
[in] aInstance
Wskaźnik do instancji OpenThread.
[in] aBusyPeriod
Okres zajęty w wykrywaniu Jamu (nie powinien być równy 0 i nie może przekraczać okna wykrywania Jamu)
Zwracane wartości
OT_ERROR_NONE
Okno zostało ustawione.
OT_ERROR_INVALID_ARGS
Podana wartość nie mieści się w prawidłowym zakresie.

otJamDetectionSetRssiThreshold

otError otJamDetectionSetRssiThreshold(
  otInstance *aInstance,
  int8_t aRssiThreshold
)

Ustaw próg RSSI wykrywania Jamu (w dBm).

Szczegóły
Parametry
[in] aInstance
Wskaźnik do instancji OpenThread.
[in] aRssiThreshold
Próg RSSI.
Zwracane wartości
OT_ERROR_NONE
Próg został ustawiony.

otJamDetectionSetWindow

otError otJamDetectionSetWindow(
  otInstance *aInstance,
  uint8_t aWindow
)

Ustaw okno wykrywania Jamu (w sekundach).

Szczegóły
Parametry
[in] aInstance
Wskaźnik do instancji OpenThread.
[in] aWindow
Okno wykrywania Jamu (prawidłowy zakres to od 1 do 63)
Zwracane wartości
OT_ERROR_NONE
Okno zostało ustawione.
OT_ERROR_INVALID_ARGS
Podany parametr wejściowy nie mieści się w prawidłowym zakresie (1–63)

otJamDetectionStart

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

Uruchom wykrywanie zacięć.

Szczegóły
Parametry
[in] aInstance
Wskaźnik do instancji OpenThread.
[in] aCallback
Wskaźnik do funkcji wywołanej, by powiadomić o zmianie stanu zacięcia.
[in] aContext
Wskaźnik do kontekstu aplikacji.
Zwracane wartości
OT_ERROR_NONE
Wykrywanie zacięć zostało rozpoczęte.
OT_ERROR_ALREADY
Wykrywanie Jamu zostało już rozpoczęte.

otJamDetectionStop

otError otJamDetectionStop(
  otInstance *aInstance
)

Zatrzymaj wykrywanie zacięć.

Szczegóły
Parametry
[in] aInstance
Wskaźnik do instancji OpenThread.
Zwracane wartości
OT_ERROR_NONE
Wykrywanie zacięć zostało zatrzymane.
OT_ERROR_ALREADY
Wykrywanie Jamu jest już zatrzymane.

Zasoby

Tematy referencyjne interfejsu OpenThread API pochodzą z kodu źródłowego dostępnego w GitHub. Aby dowiedzieć się więcej lub dołączyć do naszej dokumentacji, skorzystaj z sekcji Zasoby.