El router de borde OpenThread (OTBR) requiere un nodo RCP de Thread para unirse a una red de Thread. OTBR Docker admite un RCP físico (llave de dongle de OpenThread) o un RCP simulado.
Conecta el RCP
Usa cualquier plataforma OpenThread compatible para el RCP físico. Consulta el paso Build and flash RCP de la guía de compilación y configuración del router de borde OpenThread para obtener más información.
- Después de compilar y actualizar la memoria flash, conecta el dispositivo RCP a la máquina que ejecuta el Docker de OTBR a través de USB.
- Para determinar el nombre del puerto serie del dispositivo RCP, verifica
/dev
:ls /dev/tty*
/dev/ttyACMO
Crea un archivo de entorno de OTBR
Crea un archivo otbr-env.list
para almacenar las variables de entorno de Docker de OTBR.
OT_RCP_DEVICE=spinel+hdlc+uart:///dev/ttyACM0?uart-baudrate=1000000 OT_INFRA_IF=wlan0 OT_THREAD_IF=wpan0 OT_LOG_LEVEL=7
OT_RCP_DEVICE
: Especifica la conexión al coprocesador de radio de Thread (RCP).OT_INFRA_IF
: Es la interfaz de red que se usa para la red de infraestructura adyacente (por lo general, Wi-Fi o Ethernet).OT_THREAD_IF
: Es el nombre de la interfaz de red que se usa para la red Thread.OT_LOG_LEVEL
: Es el nivel de verbosidad de los registros que genera OpenThread.
Inicia el contenedor de Docker de OTBR
Crea y ejecuta un contenedor nuevo a partir de la imagen de OTBR.
docker run --name=otbr --detach --network=host --cap-add=NET_ADMIN --device=/dev/ttyACM0 --device=/dev/net/tun --volume=/var/lib/otbr:/data --env-file=otbr-env.list --restart=always openthread/border-router
docker run
: Es el comando base para ejecutar un contenedor de Docker.--name=otbr
: Asigna el nombre "otbr" al contenedor en ejecución. Esto facilita la referencia al contenedor más adelante para acciones como detenerlo, iniciarlo o inspeccionarlo.--detach
: Ejecuta el contenedor en modo desconectado, lo que significa que se ejecuta en segundo plano y no conecta la terminal a las entradas, salidas o flujos de errores estándar del contenedor.--network=host
: Hace que el contenedor use directamente la pila de red de la máquina anfitrión. Esto suele ser necesario para la OTBR, ya que necesita tener acceso directo a las interfaces de red.--cap-add=NET_ADMIN
: Otorga al contenedor la capabilityNET_ADMIN
. Esto es necesario para que el contenedor realice tareas de administración de redes, como configurar interfaces de red y enrutamiento.--device=/dev/ttyACM0
: Asigna el dispositivo/dev/ttyACM0
del host al contenedor. Por lo general, es el puerto en serie conectado al coprocesador de radio de Thread (RCP). El nombre específico del dispositivo (ttyACM0) puede variar según el sistema.--device=/dev/net/tun
: Asigna el dispositivo/dev/net/tun
del host al contenedor. Esto es necesario para crear y usar interfaces de red virtuales, que usa OTBR.--volume=/var/lib/otbr:/data
: Activa el directorio del host/var/lib/otbr
en el contenedor en/data
. Esto permite que el contenedor conserve datos, como la configuración de red, incluso cuando se detiene o reinicia.--env-file=otbr-env.list
: Lee las variables de entorno del archivo especificado y las establece dentro del contenedor. Es probable que estas variables de entorno sean parámetros de configuración para el OTBR.--restart=always
: Configura el daemon de Docker para que reinicie automáticamente el contenedor si se detiene. Esto garantiza que el OTBR siempre se esté ejecutando. openthread/border-router: Especifica la imagen de Docker que se usará para el contenedor. En este caso, es la imagen oficial del router de borde OpenThread.
Ejecuta ot-ctl
ot-ctl
es una utilidad de línea de comandos que proporciona una forma de interactuar con un router de borde OpenThread (OTBR) o un dispositivo OpenThread. Te permite controlar y supervisar la red OpenThread desde tu máquina anfitrión.
Para ejecutar ot-ctl
, sigue estos pasos:
docker exec -it otbr ot-ctl
Usa el comando help
para ver la lista de comandos disponibles:
help
attachtime
ba
bbr
br
bufferinfo
ccathreshold
channel
child
childip
childmax
...
Visualiza registros de Docker
Usa el siguiente comando en el host para ver los registros:
docker logs otbr
Si OTBR se ejecuta de forma correcta, deberías obtener un resultado similar al siguiente:
s6-rc: info: service mdns: starting s6-rc: info: service s6rc-oneshot-runner: starting Starting mDNSResponder... Default: mDNSResponder (Engineering Build) (Mar 26 2025 19:39:09) starting s6-rc: info: service mdns successfully started s6-rc: info: service s6rc-oneshot-runner successfully started s6-rc: info: service fix-attrs: starting s6-rc: info: service fix-attrs successfully started s6-rc: info: service legacy-cont-init: starting s6-rc: info: service legacy-cont-init successfully started s6-rc: info: service otbr-agent: starting Configuring OpenThread firewall... Configuring OpenThread NAT64... Starting otbr-agent... [NOTE]-AGENT---: Running 0.3.0-da4b5cf [NOTE]-AGENT---: Thread version: 1.4.0 [NOTE]-AGENT---: Thread interface: wpan0 [NOTE]-AGENT---: Radio URL: spinel+hdlc+uart:///dev/ttyACM0?uart-baudrate=1000000 [NOTE]-AGENT---: Radio URL: trel://wlan0 [NOTE]-ILS-----: Infra link selected: wlan0 [INFO]-RCP_HOS-: OpenThread log level changed to 5 49d.18:38:43.301 [D] P-SpinelDrive-: Sent spinel frame, flg:0x2, iid:0, tid:0, cmd:RESET 49d.18:38:43.301 [D] P-SpinelDrive-: Waiting response: key=0 49d.18:38:43.311 [D] P-SpinelDrive-: Received spinel frame, flg:0x2, iid:0, tid:0, cmd:PROP_VALUE_IS, key:LAST_STATUS, status:RESET_POWER_ON 49d.18:38:43.311 [I] P-SpinelDrive-: co-processor reset: RESET_POWER_ON 49d.18:38:43.311 [C] P-SpinelDrive-: Software reset co-processor successfully 49d.18:38:43.311 [D] P-SpinelDrive-: Sent spinel frame, flg:0x2, iid:0, tid:1, cmd:PROP_VALUE_GET, key:PROTOCOL_VERSION 49d.18:38:43.311 [D] P-SpinelDrive-: Waiting response: key=1 49d.18:38:43.312 [D] P-SpinelDrive-: Received spinel frame, flg:0x2, iid:0, tid:1, cmd:PROP_VALUE_IS, key:PROTOCOL_VERSION, major:4, minor:3 49d.18:38:43.312 [D] P-SpinelDrive-: Sent spinel frame, flg:0x2, iid:0, tid:1, cmd:PROP_VALUE_GET, key:NCP_VERSION 49d.18:38:43.312 [D] P-SpinelDrive-: Waiting response: key=2 49d.18:38:43.313 [D] P-SpinelDrive-: Received spinel frame, flg:0x2, iid:0, tid:1, cmd:PROP_VALUE_IS, key:NCP_VERSION, version:OPENTHREAD/7a25828-dirty; NRF52840; Mar 25 2025 15:51:02 49d.18:38:43.313 [D] P-SpinelDrive-: Sent spinel frame, flg:0x2, iid:0, tid:1, cmd:PROP_VALUE_GET, key:CAPS 49d.18:38:43.313 [D] P-SpinelDrive-: Waiting response: key=5 49d.18:38:43.314 [D] P-SpinelDrive-: Received spinel frame, flg:0x2, iid:0, tid:1, cmd:PROP_VALUE_IS, key:CAPS, caps:COUNTERS UNSOL_UPDATE_FILTER 802_15_4_2450MHZ_OQPSK CONFIG_RADIO MAC_RAW RCP_API_VERSION RCP_MIN_HOST_API_VERSION OPENTHREAD_LOG_METADATA 49d.18:38:43.376 [D] P-SpinelDrive-: Sent spinel frame, flg:0x2, iid:0, tid:1, cmd:PROP_VALUE_GET, key:HWADDR 49d.18:38:43.376 [D] P-RadioSpinel-: Wait response: tid=1 key=8 49d.18:38:43.376 [D] P-SpinelDrive-: Received spinel frame, flg:0x2, iid:0, tid:1, cmd:PROP_VALUE_IS, key:HWADDR, eui64:f4ce3693ab886040 49d.18:38:43.376 [D] P-SpinelDrive-: Sent spinel frame, flg:0x2, iid:0, tid:2, cmd:PROP_VALUE_GET, key:RCP_API_VERSION 49d.18:38:43.376 [D] P-RadioSpinel-: Wait response: tid=2 key=176 49d.18:38:43.377 [D] P-SpinelDrive-: Received spinel frame, flg:0x2, iid:0, tid:2, cmd:PROP_VALUE_IS, key:RCP_API_VERSION, version:11 49d.18:38:43.377 [D] P-SpinelDrive-: Sent spinel frame, flg:0x2, iid:0, tid:3, cmd:PROP_VALUE_GET, key:RCP_MIN_HOST_API_VERSION 49d.18:38:43.377 [D] P-RadioSpinel-: Wait response: tid=3 key=177 49d.18:38:43.378 [D] P-SpinelDrive-: Received spinel frame, flg:0x2, iid:0, tid:3, cmd:PROP_VALUE_IS, key:RCP_MIN_HOST_API_VERSION, min-host-version:4 49d.18:38:43.378 [D] P-SpinelDrive-: Sent spinel frame, flg:0x2, iid:0, tid:4, cmd:PROP_VALUE_GET, key:RADIO_CAPS 49d.18:38:43.378 [D] P-RadioSpinel-: Wait response: tid=4 key=4619 49d.18:38:43.379 [D] P-SpinelDrive-: Received spinel frame, flg:0x2, iid:0, tid:4, cmd:PROP_VALUE_IS, key:RADIO_CAPS, caps:255 49d.18:38:43.410 [D] P-Trel--------: platformTrelInit(aTrelUrl:"trel://wlan0") 49d.18:38:43.410 [D] P-Trel--------: otSysTrelInit(aInterfaceName:"wlan0") [DEBG]-TrelDns-: Initialized on netif "wlan0" [DEBG]-TrelDns-: Netif wlan0 is ready: index = 3 49d.18:38:43.411 [I] P-Netif-------: Sent request#1 to set addr_gen_mode to 1 00:00:00.000 [D] P-SpinelDrive-: Sent spinel frame, flg:0x2, iid:0, tid:5, cmd:PROP_VALUE_GET, key:PHY_CHAN_SUPPORTED 00:00:00.000 [D] P-RadioSpinel-: Wait response: tid=5 key=34 00:00:00.001 [D] P-SpinelDrive-: Received spinel frame, flg:0x2, iid:0, tid:5, cmd:PROP_VALUE_IS, key:PHY_CHAN_SUPPORTED, channelMask:0x07fff800 00:00:00.001 [D] P-SpinelDrive-: Sent spinel frame, flg:0x2, iid:0, tid:6, cmd:PROP_VALUE_SET, key:PHY_ENABLED, enabled:1 00:00:00.001 [D] P-RadioSpinel-: Wait response: tid=6 key=32 00:00:00.003 [D] P-SpinelDrive-: Received spinel frame, flg:0x2, iid:0, tid:6, cmd:PROP_VALUE_IS, key:PHY_ENABLED, enabled:1 00:00:00.003 [D] P-SpinelDrive-: Sent spinel frame, flg:0x2, iid:0, tid:7, cmd:PROP_VALUE_SET, key:MAC_15_4_PANID, panid:0xffff 00:00:00.003 [D] P-RadioSpinel-: Wait response: tid=7 key=54 00:00:00.003 [D] P-SpinelDrive-: Received spinel frame, flg:0x2, iid:0, tid:7, cmd:PROP_VALUE_IS, key:MAC_15_4_PANID, panid:0xffff 00:00:00.003 [D] P-SpinelDrive-: Sent spinel frame, flg:0x2, iid:0, tid:8, cmd:PROP_VALUE_SET, key:MAC_15_4_SADDR, saddr:0x0000 00:00:00.003 [D] P-RadioSpinel-: Wait response: tid=8 key=53 00:00:00.004 [D] P-SpinelDrive-: Received spinel frame, flg:0x2, iid:0, tid:8, cmd:PROP_VALUE_IS, key:MAC_15_4_SADDR, saddr:0x0000 00:00:00.004 [D] P-SpinelDrive-: Sent spinel frame, flg:0x2, iid:0, tid:9, cmd:PROP_VALUE_GET, key:PHY_RX_SENSITIVITY 00:00:00.004 [D] P-RadioSpinel-: Wait response: tid=9 key=39 00:00:00.005 [D] P-SpinelDrive-: Received spinel frame, flg:0x2, iid:0, tid:9, cmd:PROP_VALUE_IS, key:PHY_RX_SENSITIVITY, sensitivity:-100 00:00:00.005 [D] P-SpinelDrive-: Sent spinel frame, flg:0x2, iid:0, tid:10, cmd:PROP_VALUE_SET, key:RCP_MAC_KEY, keyIdMode:8, keyId:1, prevKey:***, currKey:***, nextKey:*** 00:00:00.005 [D] P-RadioSpinel-: Wait response: tid=10 key=2048 00:00:00.007 [D] P-SpinelDrive-: Received spinel frame, flg:0x2, iid:0, tid:10, cmd:PROP_VALUE_IS, key:LAST_STATUS, status:OK 00:00:00.007 [D] P-SpinelDrive-: Sent spinel frame, flg:0x2, iid:0, tid:11, cmd:PROP_VALUE_SET, key:MAC_15_4_LADDR, laddr:a2566e135ad5df32 00:00:00.007 [D] P-RadioSpinel-: Wait response: tid=11 key=52 00:00:00.008 [D] P-SpinelDrive-: Received spinel frame, flg:0x2, iid:0, tid:11, cmd:PROP_VALUE_IS, key:MAC_15_4_LADDR, laddr:a2566e135ad5df32 00:00:00.008 [D] P-SpinelDrive-: Sent spinel frame, flg:0x2, iid:0, tid:12, cmd:PROP_VALUE_SET, key:MAC_15_4_SADDR, saddr:0xfffe 00:00:00.008 [D] P-RadioSpinel-: Wait response: tid=12 key=53 00:00:00.009 [D] P-SpinelDrive-: Received spinel frame, flg:0x2, iid:0, tid:12, cmd:PROP_VALUE_IS, key:MAC_15_4_SADDR, saddr:0xfffe 00:00:00.009 [D] P-SpinelDrive-: Sent spinel frame, flg:0x2, iid:0, tid:13, cmd:PROP_VALUE_SET, key:MAC_SRC_MATCH_SHORT_ADDRESSES, saddr:none 00:00:00.009 [D] P-RadioSpinel-: Wait response: tid=13 key=4868 00:00:00.010 [D] P-SpinelDrive-: Received spinel frame, flg:0x2, iid:0, tid:13, cmd:PROP_VALUE_IS, key:LAST_STATUS, status:OK 00:00:00.011 [D] P-SpinelDrive-: Sent spinel frame, flg:0x2, iid:0, tid:14, cmd:PROP_VALUE_SET, key:MAC_SRC_MATCH_EXTENDED_ADDRESSES, extaddr:none 00:00:00.011 [D] P-RadioSpinel-: Wait response: tid=14 key=4869 00:00:00.012 [D] P-SpinelDrive-: Received spinel frame, flg:0x2, iid:0, tid:14, cmd:PROP_VALUE_IS, key:LAST_STATUS, status:OK 00:00:00.012 [I] CslTxScheduler: Set frame request ahead: 6200 usec 00:00:00.012 [I] ChildSupervsn-: Timeout: 0 -> 190 00:00:00.013 [D] P-Trel--------: PrepareSocket() [DEBG]-TrelDns-: Start browsing _trel._udp services ... 00:00:00.013 [I] TrelInterface-: Enabled interface, local port:52346 00:00:00.013 [I] RoutingManager: Initializing - InfraIfIndex:3 00:00:00.013 [I] InfraIf-------: Init infra netif 3 00:00:00.013 [N] RoutingManager: No valid /48 BR ULA prefix found in settings, generating new one 00:00:00.038 [I] Settings------: Saved BrUlaPrefix fd92:6043:f0e2::/48 00:00:00.038 [N] RoutingManager: BR ULA prefix: fd92:6043:f0e2::/48 (generated) 00:00:00.038 [I] RoutingManager: Generated local OMR prefix: fd92:6043:f0e2:1::/64 00:00:00.038 [I] RoutingManager: Generated local NAT64 prefix: fd92:6043:f0e2:2:0:0::/96 00:00:00.038 [N] RoutingManager: Local on-link prefix: fdde:ad00:beef:cafe::/64 00:00:00.038 [I] InfraIf-------: State changed: NOT RUNNING -> RUNNING 00:00:00.038 [I] RoutingManager: Enabling 00:00:00.038 [I] Nat64---------: IPv4 CIDR for NAT64: 192.168.255.0/24 (actual address pool: 192.168.255.1 - 192.168.255.254, 254 addresses) [INFO]-UTILS---: Set state callback: OK 00:00:00.039 [I] Nat64---------: NAT64 translator is now NotRunning [DEBG]-TrelDns-: mDNS Publisher is Ready [INFO]-TrelDns-: TREL DNS-SD Is Now Ready: Netif=wlan0(3), SubscriberId=1, Register=! [INFO]-MDNS----: Subscribe service ._trel._udp (total 1) [INFO]-MDNS----: DNSServiceBrowse _trel._udp [INFO]-BA------: Start Thread Border Agent [INFO]-ADPROXY-: Started [INFO]-DPROXY--: Started [INFO]-APP-----: Co-processor version: OPENTHREAD/7a25828-dirty; NRF52840; Mar 25 2025 15:51:02 00:00:00.039 [I] Notifier------: StateChanged (0x40038210) [MLAddr NetData PanId NetName ExtPanId Nat64] 00:00:00.041 [I] Platform------: Execute command `ipset flush otbr-ingress-allow-dst-swap` = 0 00:00:00.042 [I] Platform------: Execute command `ipset flush otbr-ingress-deny-src-swap` = 0 00:00:00.044 [I] Platform------: Execute command `ipset add otbr-ingress-deny-src-swap fdde:ad00:beef:0::/64 -exist` = 0 00:00:00.046 [I] Platform------: Execute command `ipset swap otbr-ingress-deny-src-swap otbr-ingress-deny-src` = 0 00:00:00.047 [I] Platform------: Execute command `ipset swap otbr-ingress-allow-dst-swap otbr-ingress-allow-dst` = 0 00:00:00.047 [I] P-Netif-------: NAT64 CIDR updated to 192.168.255.0/24. 00:00:00.047 [I] P-Netif-------: Sent request#2 to delete route 192.168.255.0/24 00:00:00.047 [I] P-Netif-------: Deleting route for NAT64 00:00:00.047 [I] RouterTable---: Route table 00:00:00.047 [I] TrelInterface-: Registering DNS-SD service: port:52346, txt:"xa=a2566e135ad5df32, xp=dead00beef00cafe" [DEBG]-TrelDns-: Register _trel._udp service: port=52346, TXT=24 bytes [DEBG]-TrelDns-: Using instance name a2566e135ad5df32 [INFO]-MDNS----: Registering service a2566e135ad5df32._trel._udp 00:00:00.058 [I] Settings------: Saved BorderAgentId {id:27a9a3c44dd733402e8a940a20fc1051} [INFO]-BA------: Result of decoding MeshCoP TXT data from OT: OK [INFO]-BA------: Publish meshcop service OpenThread BorderRouter #DF32._meshcop._udp.local. [INFO]-MDNS----: Registering service OpenThread BorderRouter #DF32._meshcop._udp 00:00:00.059 [I] P-Netif-------: Host netif is down 00:00:00.059 [I] P-Netif-------: Succeeded to process request#1 00:00:00.060 [W] P-Netif-------: Failed to process request#2: No such process s6-rc: info: service otbr-agent successfully started ...