Diese Seite wurde von der Cloud Translation API übersetzt.

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)`	`otError` Legen Sie den Zeitraum für die Jam Detect-Nutzung in Sekunden fest.
`otJamDetectionSetRssiThreshold(otInstance *aInstance, int8_t aRssiThreshold)`	`otError` Legen Sie den Grenzwert für die Jam-Erkennung (RSSI) fest.
`otJamDetectionSetWindow(otInstance *aInstance, uint8_t aWindow)`	`otError` Legen Sie das Zeitfenster für die Jam-Erkennungserkennung fest (in Sekunden).
`otJamDetectionStart(otInstance aInstance, otJamDetectionCallback aCallback, void aContext)`	`otError` Starten Sie die Jam-Erkennung.
`otJamDetectionStop(otInstance *aInstance)`	`otError` 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.