Configurazione del cablaggio di prova per il router di confine

La configurazione di GRL Thread Test Harness e OpenThread Harness Automation Tool per l'utilizzo con il router OpenBorder Border Router (OTBR) in fase di test è la stessa della guida alla configurazione per l'automazione della certificazione. Utilizza la guida in combinazione con le modifiche qui descritte.

Per una progettazione NCP come OTBR, OpenThread fornisce un OpenThread_WpanCtl.pyesempio di Thread Host Control Interface (THCI) che consente al Test Harness di controllare l'NCP. Per un dispositivo NCP sono disponibili due modalità di connessione:

  • Con una connessione alla porta seriale (opzione consigliata per l'utilizzo della funzionalità di rilevamento automatico di Test Harness)
  • Utilizzo di una connessione SSH

Se non diversamente indicato, tutti i passaggi di installazione e configurazione descritti di seguito si verificano sul computer Windows che esegue il software GRL Test Harness, che deve essere installato prima di continuare.

Copia file di assistenza THCI

Assicurati di avere la versione più recente di THCI sul computer Windows. Clona il repository OpenThread o, se lo hai già, passa al ramo main:

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

Copia i seguenti file da /tools/harness-thci nel repository OpenThread clonato nelle directory specificate sulla macchina Windows:

File di origine Copia nella directory
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\

Configura tipo di connessione

Per il controllo Test Harness dell'NCP, configura una connessione alla porta seriale o una connessione SSH.

Su Raspberry Pi 3B (RPi3B), abilita la porta seriale e la shell di accesso:

  1. Apri il menu di configurazione:
    sudo raspi-config
  2. Nel menu di configurazione, seleziona 5 opzioni di interfacciamento.
  3. Nel menu Opzioni di interfaccia, seleziona Attiva/Disattiva seriale P6.
  4. Riavvia l'RPi3B.

Sul computer Windows che esegue il test Harness:

Connessione OTBR FT232
  1. Scarica e installa il driver FT232.
  2. Collega l'adattatore FT232 da USB a UART a uno slot USB della macchina Windows.
  3. Imposta il ponticello di tensione sull'FT232 su 3,3 V.
  4. Collega l'FT232 all'RPi3B utilizzando i seguenti pin e linee Dupont:
    Pin RPi3B Pin FT232 Linea Dupont
    Pin6 GND Bianco
    Pin8 RXD Giallo
    Pin10 TXD Rosso
  5. Una volta connesso, riavvia il computer Windows.
  6. Trova l'identificatore hardware della porta seriale del dispositivo, utilizzando il modulo Python pySerial:
    1. Installa pySerial sulla macchina Windows.
    2. Utilizza Python sulla riga di comando di Windows per enumerare tutti gli identificatori hardware (VID e PID) per i dispositivi connessi alla macchina. In questo output è connesso un dispositivo NCP, con un identificatore 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. Se conosci già la porta COM, puoi utilizzare un comando diverso. Ad esempio, se la porta COM è 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. Aggiorna l'elenco dei dispositivi dorati:
    1. Apri C:\GRL\Thread1.1\Config\Configuration.ini
    2. Aggiungi un raggruppamento OpenThread_WpanCtl all'array GoldenDeviceHardwareIds con il VID e il PID dei dispositivi:
      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’]}

Una volta completata la configurazione:

  1. Inizia il test GRL.
  2. Nella pagina Configura letto di prova, il dispositivo/porta viene ora visualizzato come dispositivo NCP OT.

    Se il DUT non è elencato nella sezione Test Bed dopo l'avvio del Test Harness, aggiungilo manualmente trascinando il dispositivo OpenThread WpanCtl: wpantund+NCP dalla sezione Hardware supportato nella sezione Test Bed. Dopo il trascinamento:

    1. Assicurati che i valori Line Line (porta COM) e Velocità (baud rate) corretti siano compilati.
    2. Fai clic sul pulsante a freccia sotto il campo Velocità per stabilire la connessione seriale tra il cablaggio di prova e il dispositivo NCP OT.
  3. Seleziona la casella di controllo Abilita la selezione automatica di dispositivi DUT sotto l'elenco Hardware supportato.

  4. Seleziona il pulsante di opzione Imposta come DUT sotto il dispositivo/la porta di destinazione per impostare il dispositivo OT NCP come DUT.

Certificazione OTBR SSH

Connessione SSH

Su RPi3B, abilita SSH:

  1. Attiva il servizio SSH all'avvio:
    sudo systemctl enable ssh
  2. Avvia il servizio SSH:
    sudo systemctl start ssh

Per attivare SSH su un RPi3B headless, consulta il passaggio 3 della documentazione relativa a SSH su Raspberry Pi.

Sul computer Windows che esegue il test Harness:

  1. Installa Paramiko per l'ambiente Python di GRL:
    cd C:\GRL\Python2.7
    python -m pip install --upgrade pip
    python -m pip install paramiko
  2. Inizia il test GRL.
  3. Nella pagina Configura letto di prova, trascina il dispositivo OpenThread WpanCtl SSH: wpantund+NCP dalla sezione Hardware supportato alla sezione Test Bed.
  4. Completa l'indirizzo IP con 192.168.1.100 e PORT con 22 per il dispositivo.
  5. Fai clic sul pulsante freccia sotto il campo PORTA per stabilire una connessione SSH tra il cablaggio di prova e il dispositivo CP NCP.
Certificazione OTBR SSH

Configurazione automazione

Per istruzioni su come configurare lo strumento Harm Automation, consulta i passaggi per l'installazione e la configurazione della guida alla configurazione dell'automazione della certificazione.

Esegui scenari di test

Consulta Esecuzione degli scenari di test per la certificazione per scoprire come eseguire gli scenari di test per la certificazione sul DUT OTBR.

Risoluzione dei problemi

Riavvii dei dispositivi

Se devi riavviare RPi3B, chiudi il software Test Harness e attendi almeno 20 secondi dal completamento del riavvio per riavviare il test.

Test Harness non riesce a rilevare il router di confine

Quando utilizzi una connessione alla porta seriale, il test di cablaggio potrebbe non rilevare il router di confine. In questo caso:

  1. Controlla se un accesso Shell funziona per la porta seriale, utilizzando uno strumento come PuTTY.
    1. Utilizza la porta COM per il dispositivo FT232 e una velocità (baud rate) di 115200 f/s.
    2. Se l'accesso non va a buon fine, riavvia tutti i dispositivi e riprova.
  2. Su RPi3B, controlla lo stato di wpantund:
    sudo service wpantund status
    Se lo stato è "anomalo":
    1. Assicurati che la scheda NCP nRF52840 sia montata:
      ls /dev/tty*
      /dev/ttyACM0
    2. Verifica che la porta corrisponda alla configurazione wpantund:
      // default value in '/etc/wpantund.conf'
      Config:NCP:SocketPath "/dev/ttyACM0"
    3. Riavvia wpantund:
      sudo service wpantund restart