Skip to content

Commit b4b0788

Browse files
authored
[ot-docs] Radio URL instructions added to Native Install Guide for OTBR (#197)
User feedback requested this additional info.
1 parent af6dcb8 commit b4b0788

1 file changed

Lines changed: 32 additions & 0 deletions

File tree

site/en/guides/border-router/build-native.md

Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -65,6 +65,38 @@ Mar 01 05:46:26 raspberrypi otbr-agent[2997]: [INFO]-PLAT----: Host netif is dow
6565
6666
> 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.
6767
68+
## Edit the Radio URL path
69+
70+
The OTBR agent uses the `/etc/default/otbr-agent` configuration file for its
71+
startup parameters. This file contains the `OTBR_AGENT_OPTS` variable, which
72+
defines settings like the Radio URL. For example,
73+
`spinel+hdlc+uart:///dev/ttyACM0`.
74+
75+
This configuration file is generated by CMake from the
76+
[`otbr-agent.default.in`](https://github.com/openthread/ot-br-posix/blob/74794140358dc91fc697361205ba3882f310e8aa/src/agent/otbr-agent.default.in)
77+
source file. It is then fed into the system service as the
78+
[service start parameters](https://github.com/openthread/ot-br-posix/blob/74794140358dc91fc697361205ba3882f310e8aa/src/agent/otbr-agent.service.in#L8-L9).
79+
80+
To change the Radio URL path on your target system:
81+
82+
1. Open the OTBR agent configuration file in a text editor:
83+
```
84+
$ sudoedit /etc/default/otbr-agent
85+
```
86+
87+
1. Locate the `OTBR_AGENT_OPTS` variable.
88+
89+
1. Locate the Radio URL portion of the string. For example, `spinel+hdlc+uart:///dev/ttyACM0`.
90+
91+
1. Change that string to your new path.
92+
93+
1. Save the file and exit the editor.
94+
95+
1. Restart the `otbr-agent` service to apply the changes:
96+
```
97+
$ sudo systemctl restart otbr-agent
98+
```
99+
68100
## License
69101
70102
Copyright (c) 2021, The OpenThread Authors.

0 commit comments

Comments
 (0)