Kompilacja i konfiguracja routera obramowania OpenThread

Wyświetl źródło na GitHubie

Ten przewodnik zawiera podstawowe informacje o podstawowych kompilacjach i konfiguracji routera OpenThread Border Router (OTBR). Po zakończeniu tej procedury otrzymasz OTBR, który będzie działać jako urządzenie z pełnym wątkiem (FTD) w projekcie RCP.

Skonfiguruj platformę

Skonfiguruj obsługiwaną platformę sprzętową:

Utwórz i Flash RCP

OTBR działa w modelu RCP. Wybierz obsługiwaną platformę OpenThread, której chcesz używać jako RCP, i postępuj zgodnie z instrukcjami budowania oraz błyskania na tej platformie.

Omówienie kompilacji OpenThread znajdziesz w tym artykule.

Szczegółowe instrukcje tworzenia obsługiwanych platform za pomocą narzędzi GNU Autotools znajdziesz w folderze platformy każdego przykładu.

Zainstaluj OTBR

OTBR komunikuje się z RCP za pomocą terminala. Aby zainstalować OTBR na skonfigurowanej platformie sprzętowej, wykonaj te czynności.

Skopiuj repozytorium OTBR:

git clone https://github.com/openthread/ot-br-posix

Instalowanie zależności

W przypadku większości platform konfiguracja domyślna umożliwia BORDER_ROUTING. Pełną listę flag domyślnych OTBR znajdziesz w przykładach platformy na GitHubie. Wybierz platformę, a następnie kliknij default, jeśli jest dostępna.

  • Domyślne użycie:

    cd ot-br-posix
    ./script/bootstrap
    
  • BeagleBone Black z menedżerem sieci (opcjonalnie):

    cd ot-br-posix
    NETWORK_MANAGER=1 NETWORK_MANAGER_WIFI=1 ./script/bootstrap
    

Kompilowanie i instalowanie OTBR

  • Domyślne użycie. Skrypt konfiguracji domyślnie włącza routing obramowania. Aby włączyć bramę, określ interfejs Ethernet lub Wi-Fi platformy:

    Użyj sieci Ethernet:

    INFRA_IF_NAME=eth0 ./script/setup
    

    Użyj Wi-Fi:

    INFRA_IF_NAME=wlan0 ./script/setup
    
  • BeagleBone Black. Użyj Menedżera sieci (opcjonalnie):

    NETWORK_MANAGER=1 NETWORK_MANAGER_WIFI=1 ./script/setup
    

Podłączanie i konfigurowanie urządzenia RCP

Podłącz podłączone urządzenie RCP do platformy granicznej routera przez USB.

Aby skonfigurować port szeregowy urządzenia RCP w otbr-agent, najpierw określ nazwę portu szeregowego urządzenia RCP, zaznaczając /dev:

ls /dev/tty*

Następnie sprawdź ustawienia otbr-agent.

cd /etc/default
cat otbr-agent

Plik konfiguracji otbr-agent zawiera nazwę interfejsu Thread, nazwę interfejsu Ethernet lub Wi-Fi oraz nazwę portu szeregowego RCP.

OTBR_AGENT_OPTS="-I wpan0 -B OTBR_INFRA_IF_NAME spinel+hdlc+uart:///dev/ttyACM0 trel://OTBR_INFRA_IF_NAME"

Nie wszystkie urządzenia są podłączone z taką samą nazwą portu szeregowego. Najczęściej używane nazwy portów to ttyACM* i ttyUSB*. Oczekiwaną nazwę portu szeregowego znajdziesz w dokumentacji urządzenia.

W razie potrzeby zaktualizuj plik konfiguracyjny otbr-agent. Na przykład w przypadku interfejsu Wi-Fi i numeru seryjnego portu ttyUSB0:

OTBR_AGENT_OPTS="-I wpan0 -B wlan0 spinel+hdlc+uart:///dev/ttyUSB0 trel://wlan0"

Aby zaktualizować interfejs Ethernet:

OTBR_AGENT_OPTS="-I wpan0 -B eth0 spinel+hdlc+uart:///dev/ttyUSB0 trel://eth0"

Wyłącz i włącz router graniczny. Jeśli używasz platformy BeagleBone Black, pamiętaj, by w trakcie przytrzymywania przycisku BOOT nie blokować ekranu.

Usługa OTBR powinna zostać uruchomiona podczas uruchamiania.

Zweryfikuj usługi

Sprawdź, czy wszystkie wymagane usługi są włączone:

sudo systemctl status

Jeśli skrypt setup zakończy się powodzeniem, w danych wyjściowych pojawią się te usługi:

  • mdns.service
  • otbr-agent.service
  • otbr-web.service

Przykład:

● raspberrypi
    State: running
     Jobs: 0 queued
   Failed: 0 units
    Since: Thu 1970-01-01 00:00:01 UTC; 47 years 7 months ago
   CGroup: /
           ├─user.slice
           │ └─user-1000.slice
           │   ├─user@1000.service
           │   │ └─init.scope
           │   │   ├─576 /lib/systemd/systemd --user
           │   │   └─580 (sd-pam)
           │   └─session-c1.scope
           │     ├─480 /bin/login --
           │     └─585 -bash
           ├─init.scope
           │ └─1 /sbin/init
           └─system.slice
             ├─systemd-timesyncd.service
             │ └─334 /lib/systemd/systemd-timesyncd
             ├─dbus.service
             │ └─339 /usr/bin/dbus-daemon --system --address=systemd: --nofork --nopidfile --systemd-activation
             ├─hciuart.service
             │ └─442 /usr/bin/hciattach /dev/serial1 bcm43xx 921600 noflow -
             ├─ssh.service
             │ └─621 /usr/sbin/sshd -D
             ├─avahi-daemon.service
             │ ├─341 avahi-daemon: running [raspberrypi.local]
             │ └─361 avahi-daemon: chroot helper
  # enabled  ├─otbr-web.service
             │ └─472 /usr/sbin/otbr-web
             ├─triggerhappy.service
             │ └─354 /usr/sbin/thd --triggers /etc/triggerhappy/triggers.d/ --socket /run/thd.socket --user nobody --deviceglob /dev/input/event*
             ├─systemd-logind.service
             │ └─353 /lib/systemd/systemd-logind
  # enabled  ├─otbr-agent.service
             │ └─501 /usr/sbin/otbr-agent -I wpan0
             ├─cron.service
             │ └─350 /usr/sbin/cron -f
             ├─systemd-udevd.service
             │ └─154 /lib/systemd/systemd-udevd
             ├─rsyslog.service
             │ └─345 /usr/sbin/rsyslogd -n
             ├─bluetooth.service
             │ └─445 /usr/lib/bluetooth/bluetoothd
  # enabled  ├─mdns.service
             │ └─725 /usr/sbin/mdnsd
             ├─systemd-journald.service
             │ └─136 /lib/systemd/systemd-journald
             └─dhcpcd.service
               ├─409 wpa_supplicant -B -c/etc/wpa_supplicant/wpa_supplicant.conf -iwlan0
               └─466 /sbin/dhcpcd -q -w

Jeśli te usługi są uruchomione, ale RPi jest w stanie pogorszonym, niektóre inne usługi nie zostały uruchomione. Sprawdź, które z tych działań:

sudo systemctl --failed

Możesz też sprawdzić każdą usługę z osobna:

sudo service mdns status
sudo service otbr-agent status
sudo service otbr-web status

Funkcja otbr-web jest domyślnie włączona na większości platform. Jeśli nie, otbr-web, spróbuj przesłać flagę WEB_GUI:

WEB_GUI=1 ./script/bootstrap
INFRA_IF_NAME=wlan0 WEB_GUI=1 ./script/setup

Zweryfikuj RCP

Sprawdź, czy RCP ma prawidłowy stan:

sudo ot-ctl state

ot-ctl to narzędzie wiersza poleceń udostępniane przez OTBR. Służy do komunikacji z interfejsem Thread PAN (domyślnie jest to wpan0), z którym otbr-agent jest powiązany w projekcie RCP.

Jeśli protokół RCP jest uruchomiony, a węzeł nie jest członkiem sieci, dane wyjściowe powinny wyglądać mniej więcej tak:

disabled

Jeśli dane wyjściowe to OpenThread daemon is not running, rozwiąż je, wykonując te czynności:

  1. Sprawdź, czy router graniczny ma wystarczająco moc (użyj odpowiedniego zewnętrznego zasilacza).
  2. Odłącz tablicę RCP i podłącz ją ponownie do platformy granicznej.
  3. Sprawdź, czy urządzenie szeregowe RCP jest dostępne. Jeśli na przykład urządzenie ma być podłączone do /dev/ttyUSB0:

    ls /dev/ttyUSB*
    /dev/ttyUSB0
    
  4. Zresetuj RCP za pomocą polecenia sudo ot-ctl reset.

Ponownie sprawdź stan RCP w polu sudo ot-ctl state.