Google is committed to advancing racial equity for Black communities. See how.
Cette page a été traduite par l'API Cloud Translation.
Switch to English

Détection de bourrage

Ce module comprend des fonctions pour la fonction de détection de brouillage du signal.

Résumé

Les fonctions de ce module sont disponibles lorsque la fonction de détection de bourrage ( OPENTHREAD_CONFIG_JAM_DETECTION_ENABLE ) est activée.

Typedefs

otJamDetectionCallback )(bool aJamState, void *aContext) typedef
void(*
Ce pointeur de fonction est appelé si la détection de bourrage de signal est activée et qu'un bourrage est détecté.

Les fonctions

otJamDetectionGetBusyPeriod ( otInstance *aInstance)
uint8_t
Obtenir la période d'occupation de la détection de bourrage (en secondes)
otJamDetectionGetHistoryBitmap ( otInstance *aInstance)
uint64_t
Obtenez le bitmap de l'historique actuel.
otJamDetectionGetRssiThreshold ( otInstance *aInstance)
int8_t
Obtenez le seuil RSSI de détection de bourrage (en dBm).
otJamDetectionGetState ( otInstance *aInstance)
bool
Obtenez l'état de détection de bourrage.
otJamDetectionGetWindow ( otInstance *aInstance)
uint8_t
Obtenez la fenêtre de détection de bourrage (en secondes).
otJamDetectionIsEnabled ( otInstance *aInstance)
bool
Obtenir l'état de détection de bourrage (activé / désactivé)
otJamDetectionSetBusyPeriod ( otInstance *aInstance, uint8_t aBusyPeriod)
Définissez la période d'occupation de la détection de bourrage (en secondes).
otJamDetectionSetRssiThreshold ( otInstance *aInstance, int8_t aRssiThreshold)
Définissez le seuil RSSI de détection de bourrage (en dBm).
otJamDetectionSetWindow ( otInstance *aInstance, uint8_t aWindow)
Définissez la fenêtre de détection de bourrage (en secondes).
otJamDetectionStart ( otInstance *aInstance, otJamDetectionCallback aCallback, void *aContext)
Démarrez la détection de brouillage.
otJamDetectionStop ( otInstance *aInstance)
Arrêtez la détection de brouillage.

Typedefs

otJamDetectionCallback

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

Ce pointeur de fonction est appelé si la détection de bourrage de signal est activée et qu'un bourrage est détecté.

Détails
Paramètres
[in] aJamState
État actuel du bourrage ( true si un bourrage est détecté, false cas contraire).
[in] aContext
Un pointeur vers le contexte spécifique à l'application.

Les fonctions

otJamDetectionGetBusyPeriod

uint8_t otJamDetectionGetBusyPeriod(
  otInstance *aInstance
)

Obtenir la période d'occupation de la détection de bourrage (en secondes)

Détails
Paramètres
[in] aInstance
Un pointeur vers une instance d'OpenThread.
Retour
Période occupée de détection de bourrage.

otJamDetectionGetHistoryBitmap

uint64_t otJamDetectionGetHistoryBitmap(
  otInstance *aInstance
)

Obtenez le bitmap de l'historique actuel.

Cette valeur fournit des informations sur l'état actuel du module de détection de brouillage à des fins de surveillance / débogage. Il renvoie une valeur de 64 bits où chaque bit correspond à un intervalle d'une seconde commençant par le bit 0 pour l'intervalle le plus récent et le bit 63 pour les intervalles les plus anciens (63 secondes plus tôt). Le bit est mis à 1 si le module de détection de brouillage a observé / détecté un niveau de signal élevé pendant l'intervalle d'une seconde correspondant.

Détails
Paramètres
[in] aInstance
Un pointeur vers une instance d'OpenThread.
Retour
Le bitmap de l'historique actuel.

otJamDetectionGetRssiThreshold

int8_t otJamDetectionGetRssiThreshold(
  otInstance *aInstance
)

Obtenez le seuil RSSI de détection de bourrage (en dBm).

Détails
Paramètres
[in] aInstance
Un pointeur vers une instance d'OpenThread.
Retour
Le seuil RSSI de détection de bourrage.

otJamDetectionGetState

bool otJamDetectionGetState(
  otInstance *aInstance
)

Obtenez l'état de détection de bourrage.

Détails
Paramètres
[in] aInstance
Un pointeur vers une instance d'OpenThread.
Retour
L'état de détection de bourrage (un true bourrage est détecté, «faux» dans le cas contraire).

otJamDetectionGetWindow

uint8_t otJamDetectionGetWindow(
  otInstance *aInstance
)

Obtenez la fenêtre de détection de bourrage (en secondes).

Détails
Paramètres
[in] aInstance
Un pointeur vers une instance d'OpenThread.
Retour
La fenêtre de détection de bourrage.

otJamDetectionIsEnabled

bool otJamDetectionIsEnabled(
  otInstance *aInstance
)

Obtenir l'état de détection de bourrage (activé / désactivé)

Détails
Paramètres
[in] aInstance
Un pointeur vers une instance d'OpenThread.
Retour
L'état de détection de bourrage (vrai si activé, faux dans le cas contraire).

otJamDetectionSetBusyPeriod

 otError otJamDetectionSetBusyPeriod(
  otInstance *aInstance,
  uint8_t aBusyPeriod
)

Définissez la période d'occupation de la détection de bourrage (en secondes).

Le nombre de secondes agrégées dans la fenêtre de détection où le RSSI doit être supérieur au seuil pour déclencher la détection.

Détails
Paramètres
[in] aInstance
Un pointeur vers une instance d'OpenThread.
[in] aBusyPeriod
La période occupée de détection de bourrage (doit être différente de zéro et inférieure ou égale à la fenêtre de détection de bourrage)
Valeurs de retour
OT_ERROR_NONE
Définissez la fenêtre avec succès.
OT_ERROR_INVALID_ARGS
L'entrée donnée n'est pas dans la plage valide.

otJamDetectionSetRssiThreshold

 otError otJamDetectionSetRssiThreshold(
  otInstance *aInstance,
  int8_t aRssiThreshold
)

Définissez le seuil RSSI de détection de bourrage (en dBm).

Détails
Paramètres
[in] aInstance
Un pointeur vers une instance d'OpenThread.
[in] aRssiThreshold
Le seuil RSSI.
Valeurs de retour
OT_ERROR_NONE
Définissez le seuil avec succès.

otJamDetectionSetWindow

 otError otJamDetectionSetWindow(
  otInstance *aInstance,
  uint8_t aWindow
)

Définissez la fenêtre de détection de bourrage (en secondes).

Détails
Paramètres
[in] aInstance
Un pointeur vers une instance d'OpenThread.
[in] aWindow
La fenêtre de détection de bourrage (la plage valide est comprise entre 1 et 63)
Valeurs de retour
OT_ERROR_NONE
Définissez la fenêtre avec succès.
OT_ERROR_INVALID_ARGS
Le paramètre d'entrée donné n'est pas dans la plage valide (1-63)

otJamDetectionStart

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

Démarrez la détection de brouillage.

Détails
Paramètres
[in] aInstance
Un pointeur vers une instance d'OpenThread.
[in] aCallback
Un pointeur vers une fonction appelée pour notifier le changement d'état de brouillage.
[in] aContext
Un pointeur vers le contexte spécifique à l'application.
Valeurs de retour
OT_ERROR_NONE
Démarrage réussi de la détection de brouillage.
OT_ERROR_ALREADY
La détection de bourrage a déjà été lancée.

otJamDetectionStop

 otError otJamDetectionStop(
  otInstance *aInstance
)

Arrêtez la détection de brouillage.

Détails
Paramètres
[in] aInstance
Un pointeur vers une instance d'OpenThread.
Valeurs de retour
OT_ERROR_NONE
Arrêt réussi de la détection de brouillage.
OT_ERROR_ALREADY
La détection de bourrage est déjà arrêtée.