Penyiapan Harness Uji Border Router

Penyiapan GRL Thread Test Harness dan OpenThread Harness Automation Tool untuk digunakan dengan OpenThread Border Router (OTBR) Device Under Test (DUT) sama dengan panduan Penyiapan Otomatisasi Sertifikasi. Gunakan panduan tersebut bersama dengan perubahan yang dijelaskan di sini.

Untuk desain NCP seperti OTBR, OpenThread menyediakan OpenThread_WpanCtl.py contoh Thread Host Control Interface (THCI) yang memungkinkan Test Harness mengontrol NCP. Ada dua mode koneksi untuk perangkat NCP:

  • Menggunakan koneksi port serial (direkomendasikan untuk penggunaan fitur penemuan otomatis Test Harness)
  • Menggunakan koneksi SSH

Kecuali dinyatakan lain, semua langkah penginstalan dan konfigurasi di bawah terjadi pada komputer Windows yang menjalankan software GRL Test Harness, yang seharusnya diinstal sebelum melanjutkan.

Salin file dukungan THCI

Pastikan Anda memiliki THCI versi terbaru di komputer Windows. Clone repositori OpenThread, atau jika sudah memilikinya, alihkan ke cabang main:

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

Salin file berikut dari /tools/harness-thci di repositori OpenThread yang di-clone ke direktori yang ditentukan di komputer Windows:

File sumber Salin ke direktori
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\

Siapkan jenis koneksi

Untuk kontrol Test Harness dari NCP, siapkan koneksi port serial atau koneksi SSH.

Di Raspberry Pi 3B (RPi3B), aktifkan port serial dan shell login:

  1. Buka menu konfigurasi:
    sudo raspi-config
  2. Pada menu konfigurasi, pilih 5 Opsi Antarmuka.
  3. Di menu Opsi Interface, pilih Aktifkan/Nonaktifkan Seri P6.
  4. Mulai ulang RPi3B.

Di komputer Windows yang menjalankan Test Harness:

Koneksi OTBR FT232
  1. Download dan instal driver FT232.
  2. Hubungkan adaptor FT232 USB ke UART ke slot USB di mesin Windows.
  3. Atur jumper tegangan pada FT232 ke 3.3V.
  4. Hubungkan FT232 ke RPi3B menggunakan pin dan jalur Dupont berikut:
    PIN RPi3B Pin FT232 Garis Dupont
    Pin6 GND Putih
    Pin8 RXD Kuning
    PIN10 TXD Merah
  5. Setelah terhubung, mulai ulang komputer Windows.
  6. Temukan ID hardware port serial perangkat, menggunakan modul pySerial Python:
    1. Instal pySerial di komputer Windows.
    2. Gunakan Python pada command line Windows untuk menghitung semua ID hardware (VID dan PID) untuk perangkat yang terhubung ke mesin. Dalam output ini, satu perangkat NCP terhubung, dengan ID 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. Jika sudah mengetahui port COM, Anda dapat menggunakan perintah lain. Misalnya, jika port COM adalah 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. Perbarui daftar Perangkat Emas:
    1. Buka C:\GRL\Thread1.1\Config\Configuration.ini
    2. Tambahkan pengelompokan OpenThread_WpanCtl ke array GoldenDeviceHardwareIds dengan VID dan PID perangkat:
      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’]}

Setelah semua konfigurasi selesai:

  1. Mulai GRL Test Harness.
  2. Di halaman Configure Test Bed, perangkat/port sekarang muncul sebagai perangkat OT NCP.

    Jika DUT tidak tercantum di bagian Test Bed setelah Test Harness dimulai, tambahkan secara manual dengan menarik perangkat OpenThread WpanCtl: wpantund+NCP dari bagian Hardware yang Didukung ke bagian Test Bed. Setelah menarik:

    1. Pastikan nilai Serial Line (port COM) dan Speed (baud rate) yang benar diisi.
    2. Klik tombol panah di bawah kolom Speed untuk membuat koneksi serial antara Test Harness dan perangkat OT NCP.
  3. Pilih kotak centang Enable Auto DUT Device Selection di bawah daftar Hardware yang Didukung.

  4. Pilih tombol pilihan Tetapkan sebagai DUT di bagian perangkat/port target untuk menetapkan perangkat OT NCP sebagai DUT.

SSH Sertifikasi OTBR

Koneksi SSH

Pada RPi3B, aktifkan SSH:

  1. Aktifkan layanan SSH saat booting:
    sudo systemctl enable ssh
  2. Mulai layanan SSH:
    sudo systemctl start ssh

Untuk mengaktifkan SSH pada RPi3B headless, lihat Langkah 3 dalam dokumentasi SSH Raspberry Pi.

Di komputer Windows yang menjalankan Test Harness:

  1. Instal Paramiko untuk lingkungan Python GRL:
    cd C:\GRL\Python2.7
    python -m pip install --upgrade pip
    python -m pip install paramiko
  2. Mulai GRL Test Harness.
  3. Di halaman Configure Test Bed, tarik perangkat OpenThread WpanCtl SSH: wpantund+NCP dari bagian Hardware yang Didukung ke bagian Test Bed.
  4. Isi addr IP dengan 192.168.1.100 dan PORT dengan 22 untuk perangkat.
  5. Klik tombol panah di bawah kolom PORT untuk membuat koneksi SSH antara Test Harness dan perangkat OT NCP.
SSH Sertifikasi OTBR

Penyiapan Otomatisasi

Lihat langkah-langkah Penginstalan dan Konfigurasi dari panduan Penyiapan Otomatisasi Sertifikasi untuk mengetahui petunjuk tentang cara menyiapkan Alat Otomatisasi Harness.

Menjalankan kasus pengujian

Lihat Menjalankan Kasus Pengujian Sertifikasi untuk mempelajari cara menjalankan kasus pengujian sertifikasi di OTBR DUT.

Pemecahan masalah

Mulai ulang perangkat

Jika Anda perlu memulai ulang RPi3B, tutup software Test Harness dan tunggu setidaknya 20 detik setelah reboot selesai untuk memulai Test Harness lagi.

Test Harness gagal menemukan Border Router

Saat menggunakan koneksi port serial, Test Harness mungkin tidak menemukan Route Router. Jika demikian:

  1. Periksa apakah login Shell berfungsi untuk port serial atau tidak, gunakan alat seperti PuTTY.
    1. Gunakan port COM untuk perangkat FT232 dan kecepatan (baud rate) 115200.
    2. Jika login gagal, mulai ulang semua perangkat dan coba lagi.
  2. Pada RPi3B, periksa status wpantund:
    sudo service wpantund status
    Jika statusnya "normal":
    1. Pastikan board NCP52840 NCP sudah dipasang:
      ls /dev/tty*
      /dev/ttyACM0
    2. Validasikan bahwa port ini cocok dengan konfigurasi wpantund:
      // default value in '/etc/wpantund.conf'
      Config:NCP:SocketPath "/dev/ttyACM0"
    3. Mulai ulang wpantund:
      sudo service wpantund restart