Jam-Erkennung

Dieses Modul enthält Funktionen zur Erkennung von Signalblockierungen.

Zusammenfassung

Die Funktionen in diesem Modul sind verfügbar, wenn die Jam-Erkennung (OPENTHREAD_CONFIG_JAM_DETECTION_ENABLE) aktiviert ist.

Typdef.

otJamDetectionCallback)(bool aJamState, void *aContext) Typdef
void(*
Dieser Funktionszeiger wird aufgerufen, wenn die Signalstörerkennung aktiviert und ein Jam erkannt wurde.

Funktionen

otJamDetectionGetBusyPeriod(otInstance *aInstance)
uint8_t
Zeitraum für die Jam Detection-Nutzungszeit in Sekunden abrufen
otJamDetectionGetHistoryBitmap(otInstance *aInstance)
uint64_t
Aktuelle Bitmap für den Verlauf abrufen
otJamDetectionGetRssiThreshold(otInstance *aInstance)
int8_t
Abrufen des Jam Detection-RSSI-Grenzwerts (in dBm).
otJamDetectionGetState(otInstance *aInstance)
bool
Rufe den Status der Jam-Erkennung ab.
otJamDetectionGetWindow(otInstance *aInstance)
uint8_t
Rufe das Fenster zur Jam-Erkennungserkennung in Sekunden auf.
otJamDetectionIsEnabled(otInstance *aInstance)
bool
Status der Jam-Erkennung abrufen (aktiviert/deaktiviert)
otJamDetectionSetBusyPeriod(otInstance *aInstance, uint8_t aBusyPeriod)
Legen Sie den Zeitraum für die Jam Detect-Nutzung in Sekunden fest.
otJamDetectionSetRssiThreshold(otInstance *aInstance, int8_t aRssiThreshold)
Legen Sie den Grenzwert für die Jam-Erkennung (RSSI) fest.
otJamDetectionSetWindow(otInstance *aInstance, uint8_t aWindow)
Legen Sie das Zeitfenster für die Jam-Erkennungserkennung fest (in Sekunden).
otJamDetectionStart(otInstance *aInstance, otJamDetectionCallback aCallback, void *aContext)
Starten Sie die Jam-Erkennung.
otJamDetectionStop(otInstance *aInstance)
Beenden Sie die Jam-Erkennung.

Typdef.

otJamDetectionCallback

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

Dieser Funktionszeiger wird aufgerufen, wenn die Signalstörerkennung aktiviert und ein Jam erkannt wurde.

Details
Parameter
[in] aJamState
Aktueller Jam-Status (true, wenn ein Jam erkannt wurde, andernfalls false).
[in] aContext
Ein Hinweis auf den anwendungsspezifischen Kontext.

Funktionen

otJamDetektorionGetBusyPeriod

uint8_t otJamDetectionGetBusyPeriod(
  otInstance *aInstance
)

Zeitraum für die Jam Detection-Nutzungszeit in Sekunden abrufen

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
Rückgabe
Zeitraum für die Jam-Erkennung.

otJamDetectionGetHistoryBitmap

uint64_t otJamDetectionGetHistoryBitmap(
  otInstance *aInstance
)

Aktuelle Bitmap für den Verlauf abrufen

Dieser Wert enthält Informationen zum aktuellen Status des Jamming-Erkennungsmoduls zum Monitoring/Debugging. Er gibt einen 64-Bit-Wert zurück, wobei jedes Bit einem 1-Sekunden-Intervall entspricht und mit Bit 0 für das letzte Intervall und Bit 63 für das älteste Intervall (63 Sekunden früher) beginnt. Das Bit wird auf 1 gesetzt, wenn das Jamerkennungsmodul während des entsprechenden Intervalls von einer Sekunde ein hohes Signalsignal erkannt oder erkannt hat.

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
Rückgabe
Aktuelle Bitmap des Verlaufs

otJamDetectionGetRssiThreshold

int8_t otJamDetectionGetRssiThreshold(
  otInstance *aInstance
)

Abrufen des Jam Detection-RSSI-Grenzwerts (in dBm).

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
Rückgabe
Der RSSI-Grenzwert für die Jam-Erkennung.

otJamDetectionGetState

bool otJamDetectionGetState(
  otInstance *aInstance
)

Rufe den Status der Jam-Erkennung ab.

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
Rückgabe
Der Status der Jam-Erkennung (true Jam wurde erkannt, „falsch&#39“ usw.).

otJamDetektor

uint8_t otJamDetectionGetWindow(
  otInstance *aInstance
)

Rufe das Fenster zur Jam-Erkennungserkennung in Sekunden auf.

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
Rückgabe
Das Jam-Erkennungsfenster.

otJamDetectionIsEnabled

bool otJamDetectionIsEnabled(
  otInstance *aInstance
)

Status der Jam-Erkennung abrufen (aktiviert/deaktiviert)

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
Rückgabe
Der Status der Jam-Erkennung (wahr, wenn aktiviert, sonst falsch).

otJamDetectionSetBusyPeriod

otError otJamDetectionSetBusyPeriod(
  otInstance *aInstance,
  uint8_t aBusyPeriod
)

Legen Sie den Zeitraum für die Jam Detect-Nutzung in Sekunden fest.

Die Anzahl der aggregierten Sekunden innerhalb des Erkennungsfensters, in denen der RSSI-Wert über dem Grenzwert liegen muss, um die Erkennung auszulösen.

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
[in] aBusyPeriod
Der Zeitraum für die Jam-Erkennung ist beschäftigt (muss nicht null und kleiner oder gleich dem Jam-Erkennungsfenster sein)
Rückgabewerte
OT_ERROR_NONE
Fenster wurde eingerichtet.
OT_ERROR_INVALID_ARGS
Die angegebene Eingabe liegt nicht innerhalb des gültigen Bereichs.

otJamDetectionSetRssiThreshold

otError otJamDetectionSetRssiThreshold(
  otInstance *aInstance,
  int8_t aRssiThreshold
)

Legen Sie den Grenzwert für die Jam-Erkennung (RSSI) fest.

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
[in] aRssiThreshold
Der RSSI-Grenzwert.
Rückgabewerte
OT_ERROR_NONE
Schwellenwert wurde festgelegt.

otJamDetectionSetWindow

otError otJamDetectionSetWindow(
  otInstance *aInstance,
  uint8_t aWindow
)

Legen Sie das Zeitfenster für die Jam-Erkennungserkennung fest (in Sekunden).

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
[in] aWindow
Das Jam-Erkennungsfenster (gültiger Bereich zwischen 1 und 63)
Rückgabewerte
OT_ERROR_NONE
Fenster wurde eingerichtet.
OT_ERROR_INVALID_ARGS
Der angegebene Eingabeparameter liegt nicht innerhalb des gültigen Bereichs (1–63)

otJamDetektor

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

Starten Sie die Jam-Erkennung.

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
[in] aCallback
Ein Zeiger auf eine Funktion, die aufgerufen wird, um eine Benachrichtigung über eine Jam-Statusänderung zu erhalten.
[in] aContext
Ein Hinweis auf den anwendungsspezifischen Kontext.
Rückgabewerte
OT_ERROR_NONE
Die Jam-Erkennung wurde gestartet.
OT_ERROR_ALREADY
Die Jam-Erkennung wurde bereits gestartet.

otJamDetectionStop

otError otJamDetectionStop(
  otInstance *aInstance
)

Beenden Sie die Jam-Erkennung.

Details
Parameter
[in] aInstance
Ein Zeiger auf eine OpenThread-Instanz.
Rückgabewerte
OT_ERROR_NONE
Die Jam-Erkennung wurde gestoppt.
OT_ERROR_ALREADY
Die Jam-Erkennung wurde bereits beendet.

Ressourcen

Die Themen der Referenzthread API basieren auf dem Quellcode, der auf GitHub verfügbar ist. Weitere Informationen sowie die Möglichkeit, in unserer Dokumentation mitzuwirken, finden Sie unter Ressourcen.