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:
- Sprawdź, czy router graniczny ma wystarczająco moc (użyj odpowiedniego zewnętrznego zasilacza).
- Odłącz tablicę RCP i podłącz ją ponownie do platformy granicznej.
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/ttyUSB0Zresetuj RCP za pomocą polecenia
sudo ot-ctl reset
.
Ponownie sprawdź stan RCP w polu sudo ot-ctl state
.