La configuration du harnais de test de thread GRL et de l'outil d'automatisation OpenThread Harness pour une utilisation avec l'appareil de test OTBR (OpenThread Border Router) est identique au guide de configuration d'automatisation de certification. Utilisez ce guide conjointement avec les modifications détaillées ici.
Pour une conception NCP comme OTBR, OpenThread fournit un OpenThread_WpanCtl.py
exemple d'interface de contrôle d'hôte de thread (THCI)
qui permet au harnais de test de contrôler le NCP. Il existe deux modes de connexion pour un appareil NCP:
- Utiliser une connexion au port série (recommandé pour l'utilisation de la fonctionnalité de détection automatique de Harnais de test)
- Utiliser une connexion SSH
Sauf indication contraire, toutes les étapes d'installation et de configuration ci-dessous s'effectuent sur la machine Windows exécutant le logiciel GRL Test Harness, qui doit être installé avant de continuer.
Copier les fichiers d'assistance THCI
Vérifiez que vous disposez de la dernière version de THCI sur l'ordinateur Windows. Clonez le dépôt OpenThread ou, si vous en avez déjà un, basculez vers la branche main
:
git clone https://github.com/openthread/openthread
cd openthread
git checkout main
Copiez les fichiers suivants de /tools/harness-thci
dans le dépôt cloné OpenThread dans les répertoires spécifiés de la machine Windows:
Fichier source | Copier dans le répertoire |
---|---|
deviceInputFields.xml |
C:\GRL\Thread1.1\Web\data\ |
OpenThread_WpanCtl.py |
C:\GRL\Thread1.1\Thread_Harness\THCI\ |
OpenThread_WpanCtl.png |
C:\GRL\Thread1.1\Web\images\ |
Configurer le type de connexion
Pour contrôler l'exécution du test du NCP, configurez une connexion de port série ou SSH.
Connexion au port série (recommandé)
Sur le Raspberry Pi 3B (RPi3B), activez le port série et l'interface système:
- Accédez au menu de configuration :
sudo raspi-config
- Dans le menu de configuration, sélectionnez 5 interfaces alternatives.
- Dans le menu Options d'interface, sélectionnez Activer/Désactiver le numéro de série P6.
- Redémarrez RPi3B.
Sur la machine Windows exécutant le Harnais de test:
- Téléchargez et installez le pilote FT232.
- Connectez l'adaptateur FT232 USB vers UART à un emplacement USB de l'ordinateur Windows.
- Réglez le pont électrique sur le FT232 sur 3,3 V.
- Connectez le FT232 au RPi3B à l'aide des broches et des lignes Dupont suivantes:
Code PIN RPi3B FT232 Ligne Dupont Repère 6 GND Blanc Repère 8 RXD Jaune Repère 10 Transfert Rouge - Une fois connecté, redémarrez l'ordinateur Windows.
- Recherchez l'identifiant matériel du port série de l'appareil à l'aide du module Python pySerial :
- Installez pySerial sur la machine Windows.
- Utilisez Python sur la ligne de commande Windows pour énumérer tous les identifiants matériels (VID et PID) des appareils connectés à la machine. Dans cette sortie, un appareil NCP est connecté, avec l'identifiant
VID_0403+PID_6001
.python -m serial.tools.list_ports -v
COM10desc: USB Serial Port (COM10)
hwid: FTDIBUS\VID_0403+PID_6001+AL01WOSZA\0000
- Si vous connaissez déjà le port COM, vous pouvez utiliser une autre commande. Par exemple, si le port COM est
COM10
:python -c "import serial.tools.list_ports;print [ports[2] for ports in serial.tools.list_ports.comports() if ports[0] == 'COM10']"
['FTDIBUS\VID_0403+PID_6001+AL01WP6MA\0000']
- Mettez à jour la liste des appareils dorés :
- Ouvrir
C:\GRL\Thread1.1\Config\Configuration.ini
- Ajoutez un regroupement OpenThread_WpanCtl au tableau
GoldenDeviceHardwareIds
avec le VID et le PID des appareils :GoldenDeviceHardwareIds = {
'NXP': ['VID:PID=1FC9:0300','VID:PID=15A2:0300','VID:PID=1366:1015'],
'SiLabs': 'VID:PID=10C4:8A5E',
'ARM': 'VID:PID=0D28:0204',
'OpenThread':['VID:PID=10C4:EA60', 'VID:PID=1915:CAFE'],
'OpenThread_WpanCtl':['VID_0403+PID_6001’]}
- Ouvrir
Une fois la configuration terminée:
- Lancez le test GRL.
Sur la page Configurer la table de test, l'appareil/port apparaît désormais en tant que périphérique NCP OT.
Si l'appareil testé n'est pas répertorié dans la section Test Bed après le démarrage du test Harness, ajoutez-le manuellement en faisant glisser l'appareil OpenThread WpanCtl: wpantund+NCP de la section Supported Hardware vers la section Test Bed. Après le déplacement:
- Assurez-vous que les valeurs correctes de la ligne série (port COM) et de la vitesse (débit en bauds) sont renseignées.
- Cliquez sur la flèche située sous le champ Vitesse pour établir la connexion série entre le testeur et l'appareil NCP.
Cochez la case Activer la sélection automatique d'appareils DUT sous la liste "Matériel compatible".
Cochez la case d'option Set as DUT (Définir en tant que DUT) sous l'appareil ou le port cible pour définir l'appareil OTNCP en tant que DUT.
Connexion SSH
Sur RPi3B, activez SSH:
- Activez le service SSH au démarrage :
sudo systemctl enable ssh
- Démarrez le service SSH :
sudo systemctl start ssh
Pour activer SSH sur un RPi3B sans interface graphique, consultez l'étape 3 de la documentation SSH de Raspberry Pi.
Sur la machine Windows exécutant le Harnais de test:
- Installez Paramiko pour l'environnement Python de GRL :
cd C:\GRL\Python2.7
python -m pip install --upgrade pip
python -m pip install paramiko
- Lancez le test GRL.
- Sur la page Configurer un lit test, faites glisser l'appareil OpenThread WpanCtl SSH : wpantund+NCP de la section Matériel compatible vers la section Test Bed.
- Renseignez l'adresse IP avec 192.168.1.100 et la valeur PORT avec la valeur 22 pour l'appareil.
- Cliquez sur la flèche située en dessous du champ PORT pour établir une connexion SSH entre le testeur et l'appareil NCP.
Configuration de l'automatisation
Consultez les étapes Installer et Configurer du guide de configuration de l'automatisation de certification pour savoir comment configurer l'outil d'automatisation du harnais.
Exécuter des scénarios de test
Consultez la section Exécuter des scénarios de test de certification pour savoir comment exécuter des scénarios de test de certification sur le service OTBR.
Dépannage
L'appareil redémarre
Si vous devez redémarrer RPi3B, fermez le logiciel de test de harnais et attendez au moins 20 secondes une fois le redémarrage terminé pour le redémarrer.
Test Harness ne parvient pas à détecter Border Router
Lorsque vous utilisez une connexion au port série, le testeur peut ne pas détecter le routeur de bordure. Dans ce cas :
- Vérifiez si une connexion Shell fonctionne pour le port série à l'aide d'un outil tel que PuTTY.
- Utilisez le port COM pour l'appareil FT232 et une vitesse (débit en bauds) de 115 200.
- Si la connexion échoue, redémarrez tous les appareils et réessayez.
- Sur le RPi3B, vérifiez l'état de
wpantund
:
Si l'état est "anormal" :sudo service wpantund status
- Assurez-vous que la carte NCP nRF52840 est installée :
ls /dev/tty*
/dev/ttyACM0 - Vérifiez que ce port correspond à la configuration
wpantund
:// default value in '/etc/wpantund.conf' Config:NCP:SocketPath "/dev/ttyACM0"
- Redémarrez
wpantund
:sudo service wpantund restart
- Assurez-vous que la carte NCP nRF52840 est installée :