Configuration du test du harnais de bordures

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.

Sur le Raspberry Pi 3B (RPi3B), activez le port série et l'interface système:

  1. Accédez au menu de configuration :
    sudo raspi-config
  2. Dans le menu de configuration, sélectionnez 5 interfaces alternatives.
  3. Dans le menu Options d'interface, sélectionnez Activer/Désactiver le numéro de série P6.
  4. Redémarrez RPi3B.

Sur la machine Windows exécutant le Harnais de test:

Connexion OTBR FT232
  1. Téléchargez et installez le pilote FT232.
  2. Connectez l'adaptateur FT232 USB vers UART à un emplacement USB de l'ordinateur Windows.
  3. Réglez le pont électrique sur le FT232 sur 3,3 V.
  4. 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
  5. Une fois connecté, redémarrez l'ordinateur Windows.
  6. Recherchez l'identifiant matériel du port série de l'appareil à l'aide du module Python pySerial :
    1. Installez pySerial sur la machine Windows.
    2. 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
      COM10
          desc: USB Serial Port (COM10)
          hwid: FTDIBUS\VID_0403+PID_6001+AL01WOSZA\0000
    3. 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']
  7. Mettez à jour la liste des appareils dorés :
    1. Ouvrir C:\GRL\Thread1.1\Config\Configuration.ini
    2. 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’]}

Une fois la configuration terminée:

  1. Lancez le test GRL.
  2. 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:

    1. Assurez-vous que les valeurs correctes de la ligne série (port COM) et de la vitesse (débit en bauds) sont renseignées.
    2. Cliquez sur la flèche située sous le champ Vitesse pour établir la connexion série entre le testeur et l'appareil NCP.
  3. Cochez la case Activer la sélection automatique d'appareils DUT sous la liste "Matériel compatible".

  4. 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.

Certification OTBR SSH

Connexion SSH

Sur RPi3B, activez SSH:

  1. Activez le service SSH au démarrage :
    sudo systemctl enable ssh
  2. 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:

  1. Installez Paramiko pour l'environnement Python de GRL :
    cd C:\GRL\Python2.7
    python -m pip install --upgrade pip
    python -m pip install paramiko
  2. Lancez le test GRL.
  3. 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.
  4. Renseignez l'adresse IP avec 192.168.1.100 et la valeur PORT avec la valeur 22 pour l'appareil.
  5. Cliquez sur la flèche située en dessous du champ PORT pour établir une connexion SSH entre le testeur et l'appareil NCP.
Certification OTBR SSH

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 :

  1. Vérifiez si une connexion Shell fonctionne pour le port série à l'aide d'un outil tel que PuTTY.
    1. Utilisez le port COM pour l'appareil FT232 et une vitesse (débit en bauds) de 115 200.
    2. Si la connexion échoue, redémarrez tous les appareils et réessayez.
  2. Sur le RPi3B, vérifiez l'état de wpantund :
    sudo service wpantund status
    Si l'état est "anormal" :
    1. Assurez-vous que la carte NCP nRF52840 est installée :
      ls /dev/tty*
      /dev/ttyACM0
    2. Vérifiez que ce port correspond à la configuration wpantund :
      // default value in '/etc/wpantund.conf'
      Config:NCP:SocketPath "/dev/ttyACM0"
    3. Redémarrez wpantund :
      sudo service wpantund restart