Skip to content

Commit 271c1fb

Browse files
committed
Jose review applied
1 parent 21add35 commit 271c1fb

File tree

1 file changed

+20
-20
lines changed
  • content/hardware/03.nano/boards/nano-matter/tutorials/open-thread-border-router

1 file changed

+20
-20
lines changed

content/hardware/03.nano/boards/nano-matter/tutorials/open-thread-border-router/content.md

+20-20
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
beta: true
33
title: 'Open Thread Border Router with Nano Matter & ESP32'
4-
description: 'Learn how to create your own Thread Border Router using OpenThread and Arduino products.'
4+
description: 'Learn how to create your own Thread Border Router using OpenThread and Arduino ecosystem products.'
55
difficulty: advanced
66
compatible-products: [nano-matter]
77
tags:
@@ -17,11 +17,11 @@ hardware:
1717

1818
## Introduction
1919

20-
Thread is a low-power, wireless mesh networking protocol designed for smart homes and IoT devices. A Thread Border Router serves as a bridge between the Thread network and the wider internet or local networks, allowing devices within the Thread network to communicate with external systems.
20+
Thread is a low-power, wireless mesh networking protocol for smart homes and Internet of Things (IoT) devices. A Thread Border Router serves as a bridge between the Thread network and the wider Internet or local networks, allowing devices within the Thread network to communicate with external systems.
2121

2222
![Project overview](assets/thumbnail.png)
2323

24-
Matter devices can use Thread as their primary communication method, especially for low-power devices such as sensors, light bulbs, and door locks. These devices communicate using the Thread protocol and leverage Matter's application layer for interoperability.
24+
Matter devices can use Thread as their primary communication method, especially for low-power devices such as sensors, light bulbs, and door locks. These devices use the Thread protocol and leverage Matter's application layer for interoperability.
2525

2626
### OpenThread Border Router
2727

@@ -30,16 +30,16 @@ An OpenThread Border Router (OTBR) consists of a **Matter Controller** and a **R
3030
- The *Matter Controller* is essential for managing devices using the Matter protocol, which ensures interoperability between nodes. It handles: commissioning, communication and network management.
3131
- The *Radio Co-Processor* (RCP) is dedicated to handling Thread network communications, improving efficiency by offloading radio communication tasks.
3232

33-
The **Arduino Nano Matter** serves as the **RCP**, connected to the **Arduino Nano ESP32** (the Matter Controller) via serial port.
33+
The **Nano Matter** is the **RCP**, connected to the **Nano ESP32** (the Matter Controller) via serial port.
3434

3535
![OpenThread border router architecture](assets/otbr.png)
3636

3737
## Goals
3838

39-
This tutorial main objective is to guide you through the build and configuration of an OpenThread Border Router that will allow you to deploy a Matter network over Thread to integrate Matter devices to your Smart Home system.
39+
This tutorial's main objective is to guide you through the build and configuration of an OpenThread Border Router. This router will allow you to deploy a Matter network over Thread and integrate Matter devices into your Smart Home system.
4040

4141
- Create an OTBR using Arduino products.
42-
- Leverage the Nano Matter as a Radio Co-Processor.
42+
- Leverage the Nano Matter as a Radio Co-Processor (RCP).
4343
- Use the Nano ESP32 as a Matter Controller.
4444
- Integrate a smart outlet based on the Nano Matter to your network.
4545

@@ -50,7 +50,7 @@ This tutorial main objective is to guide you through the build and configuration
5050
- [Nano Matter](https://store.arduino.cc/products/nano-matter) (x2)
5151
- [Nano ESP32](https://store.arduino.cc/products/nano-esp32) (x1)
5252
- Linux Computer (Laptop/PC) (x1)
53-
- USB-C® cable (x1)
53+
- [USB-C® cable](https://store.arduino.cc/products/usb-cable2in1-type-c) (x1)
5454

5555
### Software Requirements
5656

@@ -68,9 +68,9 @@ This section outlines the steps to build the RCP firmware for the Nano Matter.
6868

6969
#### Create a New Project
7070

71-
- Download Simplicity Studio, this is an IDE provided by Silicon Labs. It is designed to simplify the development process for Silicon Labs hardware platforms. Download latest version [here](https://www.silabs.com/developers/simplicity-studio).
71+
- Download Simplicity Studio. Silicon Labs provides this IDE, which is designed to simplify the development process for Silicon Labs hardware platforms. Download latest version [here](https://www.silabs.com/developers/simplicity-studio).
7272

73-
- Open Simplicity Studio and create a new project by clicking on **File > New > Silicon Labs Project Wizard**.
73+
- Open Simplicity Studio and create a new project by clicking **File > New > Silicon Labs Project Wizard**.
7474

7575
![New project creation](assets/new-project.png)
7676

@@ -148,7 +148,7 @@ To set up the environment for the ESP32 firmware development use the following c
148148
sudo apt-get install git wget flex bison gperf python3 python3-pip python3-venv cmake ninja-build ccache libffi-dev libssl-dev dfu-util libusb-1.0-0
149149
```
150150

151-
***If you are using a different Linux distribution, search for the right commands [here](https://docs.espressif.com/projects/esp-idf/en/stable/esp32s3/get-started/linux-macos-setup.html#for-linux-users).***
151+
***Search for the correct commands [here](https://docs.espressif.com/projects/esp-idf/en/stable/esp32s3/get-started/linux-macos-setup.html#for-linux-users) if you use a different Linux distribution.***
152152

153153
- Install the **ESP-IDF**:
154154

@@ -237,7 +237,7 @@ idf.py -p /dev/ttyACM0 flash monitor
237237

238238
### OTBR Assembly
239239

240-
After configuring and flashing the Nano Matter and Nano ESP32 separately, it is time to connect them together. As their communicate through a serial connection you can stack them using breakout headers or using jumper wires as follows:
240+
After configuring and flashing the Nano Matter and Nano ESP32 separately, it is time to connect them. As they communicate through a serial connection, you can stack them using breakout headers or jumper wires as follows:
241241

242242
![Nano ESP32 + Nano Matter wiring](assets/connection.png)
243243
![Nano ESP32 + Nano Matter stacking](assets/connection-2.png)
@@ -246,11 +246,11 @@ After configuring and flashing the Nano Matter and Nano ESP32 separately, it is
246246

247247
### CHIP Tool
248248

249-
**CHIP Tool** is a command-line tool used for *commissioning*, *controlling*, and *managing* **Matter** devices within a Matter network.
249+
**CHIP Tool** is a command-line tool for *commissioning*, *controlling*, and *managing* **Matter** devices within a Matter network.
250250

251251
Due to its high demand for storage space and computational power it must be executed on a separate, more powerful device, such as a Unix laptop (macOS or Linux), that is connected to the same Wi-Fi network.
252252

253-
This third device will handle the complex tasks required by CHIP Tool, while the Nano ESP32 acts as the Matter Controller in the network.
253+
This third device will handle the complex tasks, while the Nano ESP32 acts as the Matter Controller in the network.
254254

255255
![Network layout](assets/chip-tool.png)
256256

@@ -306,7 +306,7 @@ This section provides an example of commissioning and communication over Matter
306306

307307
As the *end-device* we are going to use a Nano Matter configured as **Smart Outlet**.
308308

309-
- Make sure you have the Silicon Labs boards package installed in the Arduino IDE 2.
309+
- Ensure the Silicon Labs boards package is installed in the Arduino IDE 2.
310310

311311
![Silicon Labs board package](assets/silabs-pckg.png)
312312

@@ -344,11 +344,11 @@ For example:
344344

345345
### Matter Commissioning
346346

347-
Commissioning refers to the process of setting up and integrating a new device into the Matter network.
347+
Commissioning refers to setting up and integrating a new device into the Matter network.
348348

349-
In this case, commissioning will occur via **Bluetooth**, where the laptop or PC with CHIP Tool installed will communicate with the end device using a Bluetooth connection.
349+
In this case, commissioning will occur via **Bluetooth**, where the laptop or PC with the CHIP Tool installed will communicate with the end device using a Bluetooth connection.
350350

351-
- Open the terminal on the system where **CHIP Tool** is running, and execute the following command:
351+
- Open the terminal on the system where the **CHIP Tool** is running, and execute the following command:
352352

353353
```bash
354354
./out/debug/chip-tool pairing code-thread <node-id> hex:<thread-network-dataset> <end-device-pairing-code>
@@ -380,12 +380,12 @@ To control the Smart Outlet use the following command format:
380380
./out/debug/chip-tool onoff toggle 1 0x03
381381
```
382382

383-
- `onoff`: This specifies that the command pertains to the On/Off cluster, which controls the power state (on/off) of the device.
383+
- `onoff`: This specifies that the command pertains to the On/Off cluster, which controls the device's power state (on/off).
384384
- `toggle`: This command switches the current state of the device.
385385
- `1`: This is the Node ID of the device receiving the command.
386386
- `0x03`: This is the endpoint ID of the device (fixed to 0x03 for Silicon Labs device).
387387

388-
Every time you run the command the Smart Outlet will toggle, turning on or off the load connected.
388+
Every time you run the command, the Smart Outlet toggles, turning the connected load on or off.
389389

390390
![Smart outlet working demo](assets/final-demo.gif)
391391

@@ -395,5 +395,5 @@ This tutorial showed how to create an OpenThread Border Router using the Arduino
395395

396396
### Next Steps
397397

398-
Now that you know how to create your own Thread Border Router you can continue developing a custom platform or application that uses the CHIP Tool API to control the Matter end-devices from a mobile app or web platform with user-friendly dashboards and interfaces.
398+
Now that you know how to create your own Thread Border Router, you can continue developing a custom platform or application that uses the CHIP Tool API to control Matter end devices from a mobile app or web platform with user-friendly dashboards and interfaces.
399399

0 commit comments

Comments
 (0)