Wykrywanie Jamów

Ten moduł zawiera funkcje służące do wykrywania zakłóceń.

Podsumowanie

Funkcje w tym module są dostępne po włączeniu funkcji wykrywania Jamów (OPENTHREAD_CONFIG_JAM_DETECTION_ENABLE).

Definicja typów
otJamDetectionCallback)(bool aJamState, void *aContext) definicja typu
void(*
Wskaźnik jest wywoływany, gdy włączone jest wykrywanie sygnału i wykrycie Jamu.

Functions
otJamDetectionGetBusyPeriod(otInstance *aInstance)
uint8_t
Uzyskaj informacje o czasie pracy w systemie wykrywania Jamów (w sekundach)
otJamDetectionGetHistoryBitmap(otInstance *aInstance)
uint64_t
Pobierz bieżącą mapę bitową historii.
otJamDetectionGetRssiThreshold(otInstance *aInstance)
int8_t
Pobierz próg RSSI wykrywania w Jamach (w dBm).
otJamDetectionGetState(otInstance *aInstance)
bool
Pobieranie stanu wykrywania Jamów.
otJamDetectionGetWindow(otInstance *aInstance)
uint8_t
Pobierz okno wykrywania wykrywania Jamów (w sekundach).
otJamDetectionIsEnabled(otInstance *aInstance)
bool
Pobieranie stanu wykrywania Jamów (włączone/wyłączone)
otJamDetectionSetBusyPeriod(otInstance *aInstance, uint8_t aBusyPeriod)
Ustaw okres zajętości przez wykrywanie Jamu (w sekundach).
otJamDetectionSetRssiThreshold(otInstance *aInstance, int8_t aRssiThreshold)
Ustaw próg RSSI wykrywania usługi Jam (w dBm).
otJamDetectionSetWindow(otInstance *aInstance, uint8_t aWindow)
Ustaw czas wykrywania Jamu (w sekundach).
otJamDetectionStart(otInstance *aInstance, otJamDetectionCallback aCallback, void *aContext)
Rozpocznij wykrywanie zakłóceń.
otJamDetectionStop(otInstance *aInstance)
Zatrzymaj wykrywanie zakłóceń.

Definicja typów

Funkcja wywołania zwrotnego otJamDetection

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

Wskaźnik jest wywoływany, gdy włączone jest wykrywanie sygnału i wykrycie Jamu.

Szczegóły
Parametry
[in] aJamState
Obecny stan Jamu (true, jeśli zostanie wykryty Jam lub false).
[in] aContext
Wskazanie kontekstu aplikacji.

Functions

WykrywanieJotJGetBusyOkres

uint8_t otJamDetectionGetBusyPeriod(
  otInstance *aInstance
)

Uzyskaj informacje o czasie pracy w systemie wykrywania Jamów (w sekundach)

Szczegóły
Parametry
[in] aInstance
Wskaźnik do instancji OpenThread.
Zwroty
Okres zajętości przez wykrywanie Jamów.

Funkcja wykrywania historii zakupów

uint64_t otJamDetectionGetHistoryBitmap(
  otInstance *aInstance
)

Pobierz bieżącą mapę bitową historii.

Ta wartość dostarcza informacji o bieżącym stanie modułu wykrywania Jamów na potrzeby monitorowania i debugowania. Zwraca wartość 64-bitową, gdzie każdy bit odpowiada 1 sekundie od fragmentu 0 w ostatnim interwale i 63 sekundy w najstarszych interwałach (63 sekundy wcześniej). Bit jest ustawiony na 1, jeśli moduł wykrywania zagłuszania zaobserwował/wykrył wysoki poziom sygnału w odpowiednim przedziale sekundowym.

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

Próg wykrywania nieostrości

int8_t otJamDetectionGetRssiThreshold(
  otInstance *aInstance
)

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

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

OTJamDetectionGetState

bool otJamDetectionGetState(
  otInstance *aInstance
)

Pobieranie stanu wykrywania Jamów.

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

Okno wykrywania okien

uint8_t otJamDetectionGetWindow(
  otInstance *aInstance
)

Pobierz okno wykrywania wykrywania Jamów (w sekundach).

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

Funkcja otJamDetectionIsEnabled

bool otJamDetectionIsEnabled(
  otInstance *aInstance
)

Pobieranie stanu wykrywania Jamów (włączone/wyłączone)

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

Zestaw otJamDetectionSetBusyOkres

otError otJamDetectionSetBusyPeriod(
  otInstance *aInstance,
  uint8_t aBusyPeriod
)

Ustaw okres zajętości przez wykrywanie Jamu (w sekundach).

Łączna liczba sekund w okresie wykrywania, gdy wskaźnik RSSI musi przekraczać próg, aby można było aktywować wykrywanie.

Szczegóły
Parametry
[in] aInstance
Wskaźnik do instancji OpenThread.
[in] aBusyPeriod
Okres zajętości przez wykrywanie Jamów (nie może wynosić zero ani być krótszy niż okno wykrywania Jamu)
Wartości zwracane
OT_ERROR_NONE
Okno zostało ustawione.
OT_ERROR_INVALID_ARGS
Podana wartość jest poza dozwolonym zakresem.

Zestaw otJamDetectionSetRssiThreshold

otError otJamDetectionSetRssiThreshold(
  otInstance *aInstance,
  int8_t aRssiThreshold
)

Ustaw próg RSSI wykrywania usługi Jam (w dBm).

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

Okno wykrywania okien

otError otJamDetectionSetWindow(
  otInstance *aInstance,
  uint8_t aWindow
)

Ustaw czas wykrywania Jamu (w sekundach).

Szczegóły
Parametry
[in] aInstance
Wskaźnik do instancji OpenThread.
[in] aWindow
Okno wykrywania Jamu (prawidłowy zakres to 1–63)
Wartości zwracane
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
)

Rozpocznij wykrywanie zakłóceń.

Szczegóły
Parametry
[in] aInstance
Wskaźnik do instancji OpenThread.
[in] aCallback
Wskaźnik funkcji zwanej powiadamianiem o zmianie stanu zablokowania.
[in] aContext
Wskazanie kontekstu aplikacji.
Wartości zwracane
OT_ERROR_NONE
Rozpoczęto blokowanie Jamu.
OT_ERROR_ALREADY
Wykrywanie Jamu zostało już uruchomione.

OTJamDetectionStop

otError otJamDetectionStop(
  otInstance *aInstance
)

Zatrzymaj wykrywanie zakłóceń.

Szczegóły
Parametry
[in] aInstance
Wskaźnik do instancji OpenThread.
Wartości zwracane
OT_ERROR_NONE
Udało się zatrzymać wykrywanie zakłóceń.
OT_ERROR_ALREADY
Wykrywanie Jamów zostało już zatrzymane.

Zasoby

Tematy referencyjne interfejsu API OpenThread pochodzą z kodu źródłowego dostępnego w GitHub. Aby dowiedzieć się więcej lub dodać treści do naszej dokumentacji, zapoznaj się z materiałami.