Pour fournir un mécanisme configurable de détection du brouillage de signal sur n'importe quel nœud OpenThread, activez la fonctionnalité de détection du brouillage.
Cette fonctionnalité est utile pour les certifications d'appareils qui nécessitent de pouvoir détecter le brouillage du signal sur un canal spécifique. Il peut être configuré pour répondre aux exigences de chaque type de certification.
Fonctionnement
La détection de brouillage surveille le RSSI (indicateur d'intensité du signal reçu) d'un nœud pendant des périodes spécifiées pour déterminer si le canal a été brouillé.
Lorsque la détection de brouillage est activée :
- L'état de la détection de blocage est défini sur
false. - Le nœud échantillonne le RSSI plusieurs fois sur chaque intervalle d'une seconde.
- Si le RSSI sur l'ensemble de cet intervalle d'une seconde reste supérieur au seuil RSSI configuré pour chaque échantillon, cet intervalle d'une seconde est considéré comme saturé.
- Si le nombre cumulé d'intervalles d'une seconde en cas de blocage est supérieur ou égal au nombre cumulé de secondes de la période de pointe configurée dans la fenêtre de détection configurée précédente à un moment donné, l'état de détection de blocage à ce moment est défini sur
true. - Si le nombre cumulé d'intervalles d'une seconde en cas de blocage est inférieur au nombre cumulé de secondes de la période de pointe configurée dans les secondes de la fenêtre de détection configurée précédente à un moment donné, l'état de détection de blocage à ce moment est défini sur
false.
Bitmap d'historique
Dans les propriétés OpenThread API et wpantund, un bitmap des 63 secondes précédentes peut être récupéré. Ce bitmap indique si le RSSI a franchi le seuil RSSI configuré à chacune des 63 secondes précédentes.
Par exemple, vous pouvez récupérer le bitmap suivant:
0xC248068C416E7FF0
La conversion au format binaire produit chaque instance où le RSSI a dépassé le seuil RSSI configuré au cours des 63 secondes précédentes :
11000010 01001000 00000110 10001100 01000001 01101110 01111111 11110000
Si la fenêtre de détection est définie sur 16 secondes et que la période d'activité est définie sur 8 secondes, l'état de détection d'un bouchon passe à true au bout de 51 secondes, car il s'agit de la première instance où le seuil RSSI a été dépassé au moins 8 secondes entières au cours des 16 secondes précédentes. Dans cet exemple, l'état de détection d'encombrement reste true pendant les 13 secondes suivantes.
11000010 01001000 00000110 10001100 01000001 01101110 01111111 11110000
[00001 01101110 011] = 8 in 16
Ce bitmap peut être représenté par le graphique suivant, si le seuil RSSI configuré était de -45 dBm:
Comment l'activer
Cette fonctionnalité est désactivée par défaut.
Par définition
Pour activer la détection des interférences, définissez OPENTHREAD_CONFIG_JAM_DETECTION_ENABLE sur 1 dans le fichier openthread/src/core/config/openthread-core-default-config.h avant de compiler OpenThread :
#ifndef OPENTHREAD_CONFIG_JAM_DETECTION_ENABLE
#define OPENTHREAD_CONFIG_JAM_DETECTION_ENABLE 1
#endif
Par option
Vous pouvez également utiliser l'option de compilation -DOT_JAM_DETECTION=ON lorsque vous compilez OpenThread :
./script/build -DOT_JAM_DETECTION=ON
Paramètres
Les paramètres de détection de bouchon ne peuvent être configurés qu'à l'aide de l'API OpenThread, du protocole Spinel ou de wpanctl, l'outil de ligne de commande wpantund pour la gestion du co-processeur réseau (NCP). Les valeurs par défaut sont appliquées si la fonctionnalité est activée sans configuration ultérieure.
Personnalisez cette fonctionnalité à l'aide des paramètres suivants :
| Paramètres | |||||
|---|---|---|---|---|---|
| Seuil RSSI |
|
||||
| Fenêtre de détection |
|
||||
| Période de disponibilité |
|
||||
API
OpenThread
Utilisez l'API de détection des interférences pour gérer la fonctionnalité de détection des interférences directement dans votre application OpenThread. L'API OpenThread offre les fonctionnalités suivantes :
- Démarrer et arrêter la fonctionnalité
- Afficher l'état de la détection d'encombrement
- Gérer tous les paramètres
- Récupérer le bitmap actuel de l'historique de détection de Jams
- Enregistrer une fonction de rappel en cas de blocage
Spinelle
Le protocole Spinel permet à un appareil hôte de communiquer directement avec un NCP.
Ce protocole expose des propriétés de détection des interférences dans openthread/src/lib/spinel/spinel.h qui fournissent les fonctionnalités suivantes :
- Démarrer et arrêter la fonctionnalité
- Afficher l'état de la détection d'encombrement
- Gérer tous les paramètres
- Récupérer le bitmap de l'historique de la détection des embouteillages actuel
CLI
OpenThread
Aucune commande de la CLI OpenThread n'est associée à cette fonctionnalité.
wpantund
Utilisez la CLI wpanctl pour gérer la fonctionnalité de détection de Jam pour une configuration NCP OpenThread. wpantund conserve toute la configuration de la détection de brouillage lors du réinitialisation du NCP.
wpanctl permet d'accéder aux propriétés wpantund suivantes :
| Propriétés | |||||
|---|---|---|---|---|---|
JamDetection:Status |
|
||||
JamDetection:Enable |
|
||||
JamDetection:RssiThreshold |
|
||||
JamDetection:Window |
|
||||
JamDetection:BusyPeriod |
|
||||
JamDetection:Debug:HistoryBitmap |
|
||||
Par exemple, pour obtenir l'état de la détection de blocage pour un NCP :
sudo wpanctl getprop JamDetection:Status
JamDetection:Status = false
Pour définir le seuil RSSI de détection de brouillage sur -45 dBm sur un NCP :
sudo wpanctl setprop JamDetection:RssiThreshold -45sudo wpanctl getprop JamDetection:RssiThresholdJamDetection:RssiThreshold = -45
Pour en savoir plus sur les propriétés wpantund, consultez le dépôt GitHub wpantund.