# OpenThread Border Router on OpenWRT

## Build

This is for local development.

### 1. Add OpenThread feed

Assuming `OPENWRT_TOP_SRCDIR` is the root of openwrt sources.

```bash
echo src-link openthread "$(pwd)/etc/openwrt" >> ${OPENWRT_TOP_SRCDIR}/feeds.conf
cd "${OPENWRT_TOP_SRCDIR}"
./scripts/feeds update openthread
./scripts/feeds install openthread-br
```

### 2. Enable OpenThread Border Router

OpenThread is not selected by default, so use menuconfig to select openthread-br (OpenThread Border Router).

```bash
make menuconfig
```

In the configure window, use the Up and Down keys to move the cursor and the Left and Right keys to choose an action.

1. Select _Network_ to enter its submenu.
2. Enable _openthread-br_ by moving the cursor to it and pressing **Y**.
3. Select _Exit_ to exit.

### 3. Build OpenThread Border Router

```bash
make package/openthread-br/compile
```

or to do a verbose make for debugging:

```bash
make -j1 V=sc package/openthread-br/compile
```

### 4. Install

Copy the generated **ipk** file into OpenWRT, and install with **opkg**.

```bash
opkg install openthread-br-1.0*.ipk
```

NOTES:

- `openthread-br` requires `ipset` and `iptables-mod-extra` packages if the firewall feature is enabled.
- `openthread-br` requires `libavahi-client` and `avahi-daemon` package if the MDNS feature is enabled.

## Usage

### Start

Start otbr-agent manually:

```bash
# Assuming that ttyACM0 is a RCP with baudrate 115200.
/usr/sbin/otbr-agent -I wpan0 'spinel+hdlc+uart:///dev/ttyACM0?uart-baudrate=115200'
```

Edit the service file `/etc/init.d/otbr-agent` if RCP device is not `/dev/ttyACM0` and then start with:

```bash
service otbr-agent start
```

Note: The service `otbr-agent` require the service `otbr-firewall` to work properly.

On startup the services `otbr-firewall` and `otbr-agent` will be automatically started.

If you need to change the thread network interface (`wpan0` by default), you need to configure it through uci:

```bash
service otbr-firewall stop
service otbr-agent stop
uci set otbr-agent.service.thread_if_name=wpan1
uci commit otbr-agent
service otbr-firewall start
service otbr-agent start
```

### Test

Enter the OpenWRT web GUI. There will be a new item _Thread_ under _Network_. Scan or create network here.