setup_ot_borderrouter.md

Setup OpenThread Border Router on Qorvo's QPG7015M Gateway development kit

In this guide, step by step instructions are given to setup an OpenThread Border Router, using Qorvo's QPG7015M Gateway Development Kit. This enables the user to set up a Matter network and control Matter devices over Wi-Fi/ethernet with the QPG7015M operating as an OpenThread Border Router, using the Android chip-tool, or the POSIX CLI chip-tool.

Required Hardware:

• Access point/Router to connect your QPG7015M Gateway development kit to a local area network (LAN).
• Qorvo's QPG7015M Gateway development kit:

Index

1. Step 1: Establish access to the QPG7015M Gateway Development Kit
2. Step 2: Configure the QPG7015M Gateway Development Kit for OpenThread Border Router
3. Step 3: Start the OpenThread Border Router
4. Step 4: Stop the OpenThread Border Router
5. Step 5: Factory reset the OpenThread Border Router

Step 1: Establish access to the QPG7015M Gateway Development Kit

Described in the section "Accessing the QPG7015M Gateway Development Kit's terminal" of the QPG7015M Gateway DK Setup guide.

Step 2: Configure the QPG7015M Gateway Development Kit for OpenThread Border Router

How to edit the configuration file is described in the section "Configure the QPG7015M Gateway Development Kit" of the QPG7015M Gateway DK Setup guide. In Stack configuration disable the unwanted stacks and enable following parameters:

QORVO_OT_BR=1
QORVO_OT_BRBB_INTERFACE=wlan0

Step 3: Start the OpenThread Border Router

Now the QPG7015M Gateway Development Kit, must be started to run with the configuration set in Step 2. This is described in the section "Start the QPG7015M Gateway Development Kit" of the QPG7015M Gateway DK Setup guide. Make sure you see following logging:

Loading ot-br docker image from file!
3a7cc06ad581: Loading layer [==================================================>]  48.07MB/48.07MB
57fa7918522d: Loading layer [==================================================>]  81.91MB/81.91MB
d626ab464e19: Loading layer [==================================================>]  197.7MB/197.7MB
Loaded image: connectedhomeip/otbr:te7
55dbfafd48f5297dbceb19d76e407d873e6657bf47de246908a705515164f9ba
Gateway does not start automatically at boot

-------

Docker container otbr_docker_0 is running and Up 6 seconds.

You can now start ot-ctl command-line utility, and get logs by entering the following commands:

docker exec -it otbr_docker_0 ot-ctl
docker logs otbr_docker_0

-------
GATEWAY STARTED AND READY TO USE!

The OpenThread Border Router launches a Wi-Fi Access Point BorderRouter-AP with password Qorvo_QPG7015M. The user is now able to access the OpenThread Border Router via its IP address or hostname on a device that's connected to that Wi-Fi Access point. Matter devices can be joined to the network using the Android chip-tool or the POSIX CLI chip-tool.

Step 4: Stop the OpenThread Border Router

This is described in the section "Stop the QPG7015M Gateway Development Kit" of the QPG7015M Gateway DK Setup guide. Stopping the DK will NOT delete the info of the joined devices.

Step 5: Factory reset the OpenThread Border Router

This is described in the section "Factory reset the QPG7015M Gateway Development Kit" of the QPG7015M Gateway DK Setup guide. This action WILL delete the info of all joined devices. Pay attention to following logging:

pi@[hostname]:~ $ ./factory_reset_gateway.sh 
FACTORY RESETTING GATEWAY...
STOPPING GATEWAY...

...

Total reclaimed space: 0B
Deleted Images:
untagged: connectedhomeip/otbr:te7
deleted: sha256:ba054de35dcad1ffaf528a028f2310411f24715880cef036f8351cfbebeb5bfd
deleted: sha256:b033431b9748e9f80ee127caf8596b3a5746cc44d7165ed94f98cef8a9eb8797
deleted: sha256:f8263691911c51510a7fe67946455f6a068093a0249acbfba1f6365e9eeea937
deleted: sha256:3a7cc06ad5817e6e36c96383ae1de75e1c9fc86fcb1fa65892fb30c7194a096e

Total reclaimed space: 318.1MB
GATEWAY IS FACTORY RESET!