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)
|
Typdefvoid(*
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 |
|
Funktionen
otJamDetektorionGetBusyPeriod
uint8_t otJamDetectionGetBusyPeriod( otInstance *aInstance )
Zeitraum für die Jam Detection-Nutzungszeit in Sekunden abrufen
Details | |||
---|---|---|---|
Parameter |
|
||
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 |
|
||
Rückgabe |
Aktuelle Bitmap des Verlaufs
|
otJamDetectionGetRssiThreshold
int8_t otJamDetectionGetRssiThreshold( otInstance *aInstance )
Abrufen des Jam Detection-RSSI-Grenzwerts (in dBm).
Details | |||
---|---|---|---|
Parameter |
|
||
Rückgabe |
Der RSSI-Grenzwert für die Jam-Erkennung.
|
otJamDetectionGetState
bool otJamDetectionGetState( otInstance *aInstance )
Rufe den Status der Jam-Erkennung ab.
Details | |||
---|---|---|---|
Parameter |
|
||
Rückgabe |
Der Status der Jam-Erkennung (
true Jam wurde erkannt, „falsch'“ usw.). |
otJamDetektor
uint8_t otJamDetectionGetWindow( otInstance *aInstance )
Rufe das Fenster zur Jam-Erkennungserkennung in Sekunden auf.
Details | |||
---|---|---|---|
Parameter |
|
||
Rückgabe |
Das Jam-Erkennungsfenster.
|
otJamDetectionIsEnabled
bool otJamDetectionIsEnabled( otInstance *aInstance )
Status der Jam-Erkennung abrufen (aktiviert/deaktiviert)
Details | |||
---|---|---|---|
Parameter |
|
||
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 |
|
||||
Rückgabewerte |
|
otJamDetectionSetRssiThreshold
otError otJamDetectionSetRssiThreshold( otInstance *aInstance, int8_t aRssiThreshold )
Legen Sie den Grenzwert für die Jam-Erkennung (RSSI) fest.
Details | |||||
---|---|---|---|---|---|
Parameter |
|
||||
Rückgabewerte |
|
otJamDetectionSetWindow
otError otJamDetectionSetWindow( otInstance *aInstance, uint8_t aWindow )
Legen Sie das Zeitfenster für die Jam-Erkennungserkennung fest (in Sekunden).
Details | |||||
---|---|---|---|---|---|
Parameter |
|
||||
Rückgabewerte |
|
otJamDetektor
otError otJamDetectionStart( otInstance *aInstance, otJamDetectionCallback aCallback, void *aContext )
Starten Sie die Jam-Erkennung.
Details | |||||||
---|---|---|---|---|---|---|---|
Parameter |
|
||||||
Rückgabewerte |
|
otJamDetectionStop
otError otJamDetectionStop( otInstance *aInstance )
Beenden Sie die Jam-Erkennung.
Details | |||||
---|---|---|---|---|---|
Parameter |
|
||||
Rückgabewerte |
|
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.