From da3315e5b68d1afbc05075e1feb2fc83deaab3ce Mon Sep 17 00:00:00 2001 From: Jeff Rhodie Date: Thu, 9 Apr 2026 23:52:41 +0000 Subject: [PATCH 1/7] Radio URL instructions --- site/en/guides/border-router/build-native.md | 23 ++++++++++++++++++++ 1 file changed, 23 insertions(+) diff --git a/site/en/guides/border-router/build-native.md b/site/en/guides/border-router/build-native.md index 65024368..893e8141 100644 --- a/site/en/guides/border-router/build-native.md +++ b/site/en/guides/border-router/build-native.md @@ -65,6 +65,29 @@ Mar 01 05:46:26 raspberrypi otbr-agent[2997]: [INFO]-PLAT----: Host netif is dow > Note: If you receive an "InvalidArguments" error, make sure your RCP board is connected as `/dev/ttyACM0`. It happens that the device path may change to `/dev/ttyACM1` after flashing the RCP. Re-plugging the RCP should solve this. +## How to edit the Radio URL path + +The OTBR agent uses the `/etc/default/otbr-agent` configuration file for its +startup parameters. This file contains the `OTBR_AGENT_OPTS` variable, which +defines settings like the Radio URL (for example, +`spinel+hdlc+uart:///dev/ttyACM0`). + +This configuration file is generated by CMake from the +[`otbr-agent.default.in`](https://github.com/openthread/ot-br-posix/blob/74794140358dc91fc697361205ba3882f310e8aa/src/agent/otbr-agent.default.in) +source file. It is then fed into the system service as the +[service start parameters](https://github.com/openthread/ot-br-posix/blob/74794140358dc91fc697361205ba3882f310e8aa/src/agent/otbr-agent.service.in#L8-L9). + +To change the Radio URL path on your target system: + +1. Open the OTBR agent configuration file in a text editor (for example, + `sudo nano /etc/default/otbr-agent`). +1. Locate the `OTBR_AGENT_OPTS` variable. +1. Update the Radio URL portion of the string (for example, change + `spinel+hdlc+uart:///dev/ttyACM0` to your new path). +1. Save the file and exit the editor. +1. Restart the `otbr-agent` service to apply the changes (for example, + `sudo systemctl restart otbr-agent`). + ## License Copyright (c) 2021, The OpenThread Authors. From dbe51a030da438cfd82a9985bce023be97d1dfd4 Mon Sep 17 00:00:00 2001 From: Jeff Rhodie Date: Fri, 10 Apr 2026 17:19:05 +0000 Subject: [PATCH 2/7] Radio URL instructions --- site/en/guides/border-router/build-native.md | 29 ++++++++++++++------ 1 file changed, 21 insertions(+), 8 deletions(-) diff --git a/site/en/guides/border-router/build-native.md b/site/en/guides/border-router/build-native.md index 893e8141..a33584bc 100644 --- a/site/en/guides/border-router/build-native.md +++ b/site/en/guides/border-router/build-native.md @@ -79,14 +79,27 @@ source file. It is then fed into the system service as the To change the Radio URL path on your target system: -1. Open the OTBR agent configuration file in a text editor (for example, - `sudo nano /etc/default/otbr-agent`). -1. Locate the `OTBR_AGENT_OPTS` variable. -1. Update the Radio URL portion of the string (for example, change - `spinel+hdlc+uart:///dev/ttyACM0` to your new path). -1. Save the file and exit the editor. -1. Restart the `otbr-agent` service to apply the changes (for example, - `sudo systemctl restart otbr-agent`). +1. Open the OTBR agent configuration file in a text editor: + ``` + $ sudoedit /etc/default/otbr-agent + ``` + +1. Locate the `OTBR_AGENT_OPTS` variable. + +1. Locate the Radio URL portion of the string. For example: + + ``` + $ spinel+hdlc+uart:///dev/ttyACM0 + ``` + +1. Change that string to your new path. + +1. Save the file and exit the editor. + +1. Restart the `otbr-agent` service to apply the changes: + ``` + $ sudo systemctl restart otbr-agent + ``` ## License From 72da8c849ed4818b218204d54d66058dbd3d0f7b Mon Sep 17 00:00:00 2001 From: Jeff Rhodie Date: Fri, 10 Apr 2026 17:35:26 +0000 Subject: [PATCH 3/7] Radio URL instructions --- site/en/guides/border-router/build-native.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/site/en/guides/border-router/build-native.md b/site/en/guides/border-router/build-native.md index a33584bc..b72a5315 100644 --- a/site/en/guides/border-router/build-native.md +++ b/site/en/guides/border-router/build-native.md @@ -65,7 +65,7 @@ Mar 01 05:46:26 raspberrypi otbr-agent[2997]: [INFO]-PLAT----: Host netif is dow > Note: If you receive an "InvalidArguments" error, make sure your RCP board is connected as `/dev/ttyACM0`. It happens that the device path may change to `/dev/ttyACM1` after flashing the RCP. Re-plugging the RCP should solve this. -## How to edit the Radio URL path +## Edit the Radio URL path The OTBR agent uses the `/etc/default/otbr-agent` configuration file for its startup parameters. This file contains the `OTBR_AGENT_OPTS` variable, which From d97f103f796ac02cdf892f24671bb32b8346bd86 Mon Sep 17 00:00:00 2001 From: Jeff Rhodie Date: Fri, 10 Apr 2026 23:11:49 +0000 Subject: [PATCH 4/7] Radio URL instructions --- site/en/guides/border-router/build-native.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/site/en/guides/border-router/build-native.md b/site/en/guides/border-router/build-native.md index b72a5315..f90f8a64 100644 --- a/site/en/guides/border-router/build-native.md +++ b/site/en/guides/border-router/build-native.md @@ -69,8 +69,8 @@ Mar 01 05:46:26 raspberrypi otbr-agent[2997]: [INFO]-PLAT----: Host netif is dow The OTBR agent uses the `/etc/default/otbr-agent` configuration file for its startup parameters. This file contains the `OTBR_AGENT_OPTS` variable, which -defines settings like the Radio URL (for example, -`spinel+hdlc+uart:///dev/ttyACM0`). +defines settings like the Radio URL. for example, +`spinel+hdlc+uart:///dev/ttyACM0`. This configuration file is generated by CMake from the [`otbr-agent.default.in`](https://github.com/openthread/ot-br-posix/blob/74794140358dc91fc697361205ba3882f310e8aa/src/agent/otbr-agent.default.in) @@ -89,7 +89,7 @@ To change the Radio URL path on your target system: 1. Locate the Radio URL portion of the string. For example: ``` - $ spinel+hdlc+uart:///dev/ttyACM0 + spinel+hdlc+uart:///dev/ttyACM0 ``` 1. Change that string to your new path. From 3880c78003e763e1cd10e535860ad58eab55f7d1 Mon Sep 17 00:00:00 2001 From: Jeff Rhodie Date: Fri, 10 Apr 2026 23:24:26 +0000 Subject: [PATCH 5/7] Radio URL instructions --- site/en/guides/border-router/build-native.md | 6 ++---- 1 file changed, 2 insertions(+), 4 deletions(-) diff --git a/site/en/guides/border-router/build-native.md b/site/en/guides/border-router/build-native.md index f90f8a64..f33e74a1 100644 --- a/site/en/guides/border-router/build-native.md +++ b/site/en/guides/border-router/build-native.md @@ -87,10 +87,8 @@ To change the Radio URL path on your target system: 1. Locate the `OTBR_AGENT_OPTS` variable. 1. Locate the Radio URL portion of the string. For example: - - ``` - spinel+hdlc+uart:///dev/ttyACM0 - ``` +` + `spinel+hdlc+uart:///dev/ttyACM0` 1. Change that string to your new path. From a48440585ed1b9199a8d16e3645ecc0b98f4fe1f Mon Sep 17 00:00:00 2001 From: Jeff Rhodie Date: Fri, 10 Apr 2026 23:34:01 +0000 Subject: [PATCH 6/7] Radio URL instructions --- site/en/guides/border-router/build-native.md | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/site/en/guides/border-router/build-native.md b/site/en/guides/border-router/build-native.md index f33e74a1..da85b44a 100644 --- a/site/en/guides/border-router/build-native.md +++ b/site/en/guides/border-router/build-native.md @@ -86,9 +86,7 @@ To change the Radio URL path on your target system: 1. Locate the `OTBR_AGENT_OPTS` variable. -1. Locate the Radio URL portion of the string. For example: -` - `spinel+hdlc+uart:///dev/ttyACM0` +1. Locate the Radio URL portion of the string. For example: `spinel+hdlc+uart:///dev/ttyACM0` 1. Change that string to your new path. From e33f4ed57f9e34875a2d0c5bac7d2bd14c8ebffb Mon Sep 17 00:00:00 2001 From: Jeff Rhodie Date: Mon, 13 Apr 2026 20:25:04 +0000 Subject: [PATCH 7/7] Radio URL instructions --- site/en/guides/border-router/build-native.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/site/en/guides/border-router/build-native.md b/site/en/guides/border-router/build-native.md index da85b44a..1b6a2d43 100644 --- a/site/en/guides/border-router/build-native.md +++ b/site/en/guides/border-router/build-native.md @@ -69,7 +69,7 @@ Mar 01 05:46:26 raspberrypi otbr-agent[2997]: [INFO]-PLAT----: Host netif is dow The OTBR agent uses the `/etc/default/otbr-agent` configuration file for its startup parameters. This file contains the `OTBR_AGENT_OPTS` variable, which -defines settings like the Radio URL. for example, +defines settings like the Radio URL. For example, `spinel+hdlc+uart:///dev/ttyACM0`. This configuration file is generated by CMake from the @@ -86,7 +86,7 @@ To change the Radio URL path on your target system: 1. Locate the `OTBR_AGENT_OPTS` variable. -1. Locate the Radio URL portion of the string. For example: `spinel+hdlc+uart:///dev/ttyACM0` +1. Locate the Radio URL portion of the string. For example, `spinel+hdlc+uart:///dev/ttyACM0`. 1. Change that string to your new path.