Einrichtung des Border-Router-Testkabels

Die Einrichtung des GRL Thread Test Harness und des OpenThread Harness Automation Tools für die Verwendung mit dem OpenThread Border Router (OTBR) Device Under Test (DUT) entspricht dem Leitfaden zur Einrichtung der Zertifizierungsautomatisierung. Verwenden Sie diesen Leitfaden in Verbindung mit den hier beschriebenen Änderungen.

Für ein NCP-Design wie OTBR bietet OpenThread eine OpenThread_WpanCtl.py Beispiel-Thread-Host-Kontrollschnittstelle (THCI), mit der der Test-Harness das NCP steuern kann. Für ein NCP-Gerät gibt es zwei Verbindungsmodi:

  • Über eine serielle Portverbindung (empfohlen für die Verwendung der automatischen Erkennungsfunktion des Test-Harnesses)
  • SSH-Verbindung verwenden

Sofern nicht anders angegeben, werden alle Installations- und Konfigurationsschritte unten auf dem Windows-Computer ausgeführt, auf dem die GRL Test Harness-Software installiert ist. Diese sollte vor dem Fortfahren installiert werden.

THCI-Supportdateien kopieren

Auf dem Windows-Computer muss die neueste Version von THCI installiert sein. Klonen Sie das OpenThread-Repository oder wechseln Sie zum Zweig main, falls Sie es bereits geklont haben:

git clone https://github.com/openthread/openthread
cd openthread
git checkout main

Kopieren Sie die folgenden Dateien aus /tools/harness-thci im geklonten OpenThread-Repository in die angegebenen Verzeichnisse auf dem Windows-Computer:

Quelldatei In Verzeichnis kopieren
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\

Verbindungstyp einrichten

Richten Sie für die Test-Harness-Steuerung des NCP entweder eine serielle Portverbindung oder eine SSH-Verbindung ein.

Aktivieren Sie auf dem Raspberry Pi 3B (RPi3B) den seriellen Port und die Anmelde-Shell:

  1. Öffnen Sie das Konfigurationsmenü:
    sudo raspi-config
  2. Wählen Sie im Konfigurationsmenü 5 Schnittstellenoptionen aus.
  3. Wählen Sie im Menü „Interfacing Options“ (Schnittstellenoptionen) die Option P6 Serial Enable/Disable (P6-Serienschnittstelle aktivieren/deaktivieren) aus.
  4. Starten Sie den RPi3B neu.

Auf dem Windows-Rechner, auf dem der Test-Harness ausgeführt wird:

OTBR FT232-Verbindung
  1. Laden Sie den FT232-Treiber herunter und installieren Sie ihn.
  2. Schließen Sie den FT232-USB-zu-UART-Adapter an einen USB-Anschluss des Windows-Computers an.
  3. Stellen Sie den Spannungsjumper am FT232 auf 3,3 V.
  4. Verbinden Sie den FT232 über die folgenden Pins und Dupont-Leitungen mit dem RPi3B:
    RPi3B-Pin FT232-Pin Dupont Line
    Pin6 GND Weiß
    Pin8 RXD Gelb
    Pin10 TXD Rot
  5. Starten Sie den Windows-Rechner neu, sobald die Verbindung hergestellt ist.
  6. Hardware-ID des seriellen Anschlusses des Geräts mit dem Python-Modul „pySerial“ ermitteln:
    1. Installieren Sie pySerial auf dem Windows-Computer.
    2. Verwenden Sie Python in der Windows-Befehlszeile, um alle Hardware-IDs (VID und PID) für Geräte aufzulisten, die mit dem Computer verbunden sind. In dieser Ausgabe ist ein NCP-Gerät mit der Kennzeichnung VID_0403+PID_6001 verbunden.
      python -m serial.tools.list_ports -v
      COM10
          desc: USB Serial Port (COM10)
          hwid: FTDIBUS\VID_0403+PID_6001+AL01WOSZA\0000
    3. Wenn Sie den COM-Port bereits kennen, können Sie einen anderen Befehl verwenden. Wenn der COM-Port beispielsweise COM10 lautet:
      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. Aktualisieren Sie die Liste der Goldgeräte:
    1. C:\GRL\Thread1.1\Config\Configuration.ini öffnen
    2. Fügen Sie dem GoldenDeviceHardwareIds-Array mit der VID und PID der Geräte eine Gruppierung OpenThread_WpanCtl hinzu:
      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’]}

Nach Abschluss der Konfiguration:

  1. Starten Sie das GRL-Test-Harnisch.
  2. Auf der Seite Testbed konfigurieren wird das Gerät/der Anschluss jetzt als OT-NCP-Gerät angezeigt.

    Wenn das DUT nach dem Starten des Test-Harnesses nicht im Bereich Test Bed aufgeführt ist, fügen Sie es manuell hinzu. Ziehen Sie dazu das Gerät OpenThread WpanCtl:wpantund+NCP aus dem Bereich Unterstützte Hardware in den Bereich Test Bed. Nach dem Ziehen:

    1. Prüfen Sie, ob die richtigen Werte für Serielle Linie (COM-Port) und Geschwindigkeit (Baudrate) eingetragen sind.
    2. Klicken Sie auf die Pfeilschaltfläche unter dem Feld Speed (Geschwindigkeit), um die serielle Verbindung zwischen dem Test-Harness und dem OT NCP-Gerät herzustellen.
  3. Aktivieren Sie unter der Liste der unterstützten Hardware das Kästchen Automatische DUT-Geräteauswahl aktivieren.

  4. Wählen Sie unter dem Zielgerät/-port das Optionsfeld Als DUT festlegen aus, um das OT NCP-Gerät als DUT festzulegen.

SSH für die OTBR-Zertifizierung

SSH-Verbindung

Aktivieren Sie auf dem RPi3B SSH:

  1. Aktivieren Sie den SSH-Dienst beim Starten:
    sudo systemctl enable ssh
  2. Starten Sie den SSH-Dienst:
    sudo systemctl start ssh

Informationen zum Aktivieren von SSH auf einem headless RPi3B finden Sie in Schritt 3 der SSH-Dokumentation für Raspberry Pi.

Auf dem Windows-Rechner, auf dem der Test-Harness ausgeführt wird:

  1. Installieren Sie Paramiko für die Python-Umgebung von GRL:
    cd C:\GRL\Python2.7
    python -m pip install --upgrade pip
    python -m pip install paramiko
  2. Starten Sie den GRL-Test-Harness.
  3. Ziehen Sie auf der Seite Testbed konfigurieren das Gerät OpenThread WpanCtl SSH: wpantund+NCP aus dem Bereich Unterstützte Hardware in den Bereich Testbed.
  4. Geben Sie für das Gerät 192.168.1.100 für IP addr und 22 für PORT ein.
  5. Klicken Sie auf die Pfeilschaltfläche unter dem Feld PORT, um eine SSH-Verbindung zwischen dem Test-Harness und dem OT-NCP-Gerät herzustellen.
OTBR-Zertifizierung SSH

Automatisierung einrichten

Eine Anleitung zum Einrichten des Harness Automation Tools finden Sie in der Anleitung zur Einrichtung der Zertifizierungsautomatisierung unter den Schritten Installieren und Konfigurieren.

Testfälle ausführen

Unter Zertifizierungstestfälle ausführen erfahren Sie, wie Sie Zertifizierungstestläufe für den OTBR-DUT ausführen.

Fehlerbehebung

Gerät startet neu

Wenn Sie den RPi3B neu starten müssen, schließen Sie die Test Harness-Software und warten Sie nach dem Neustart mindestens 20 Sekunden, bevor Sie den Test Harness wieder starten.

Test-Harnisch kann Border Router nicht erkennen

Bei Verwendung einer seriellen Portverbindung erkennt der Test Harness den Border Router möglicherweise nicht. Trifft das auf Sie zu, haben Sie folgende Möglichkeiten:

  1. Prüfen Sie mit einem Tool wie PuTTY, ob eine Shell-Anmeldung am seriellen Port funktioniert.
    1. Verwenden Sie den COM-Port für das FT232-Gerät und eine Geschwindigkeit (Baudrate) von 115200.
    2. Wenn die Anmeldung fehlschlägt, starten Sie alle Geräte neu und versuchen Sie es noch einmal.
  2. Prüfen Sie auf dem RPi3B den Status von wpantund:
    sudo service wpantund status
    Wenn der Status „Abnormal“ lautet:
    1. Achten Sie darauf, dass das nRF52840 NCP-Board montiert ist:
      ls /dev/tty*
      /dev/ttyACM0
    2. Prüfen Sie, ob dieser Port mit der wpantund-Konfiguration übereinstimmt:
      // default value in '/etc/wpantund.conf'
      Config:NCP:SocketPath "/dev/ttyACM0"
    3. Starten Sie wpantund neu:
      sudo service wpantund restart