@@ -62,7 +62,7 @@ Mac OS.
62
62
sudo bash scripts/setup.sh
63
63
```
64
64
65
- Please execute following command export `BOUFFALOLAB_SDK_ROOT` before
65
+ Please execute following command to export `BOUFFALOLAB_SDK_ROOT` before
66
66
building.
67
67
68
68
```
@@ -74,36 +74,27 @@ Mac OS.
74
74
The following steps take examples for BL602 develop board `BL602-IoT-Matter-V1`
75
75
and BL706 develop board `XT-ZB6-DevKit`.
76
76
77
- - Build lighting app
77
+ - Build lighting app with UART baudrate 2000000
78
78
79
79
```
80
80
./scripts/build/build_examples.py --target bouffalolab-bl602-iot-matter-v1-light build
81
81
./scripts/build/build_examples.py --target bouffalolab-xt-zb6-devkit-light build
82
82
```
83
83
84
- - UART baudrate is 2000000 by default; for baudrate 115200, please build
85
- target name with `-115200` appended
84
+ - Build lighting app with UART baudrate 115200
86
85
87
- ```shell
86
+ ```
88
87
./scripts/build/build_examples.py --target bouffalolab-bl602-iot-matter-v1-light-115200 build
89
88
./scripts/build/build_examples.py --target bouffalolab-xt-zb6-devkit-light-115200 build
90
89
```
91
90
92
- - Build target name with `-rpc` appended for rpc enabled as following
93
- commands.
91
+ - Build lighting app with RPC enabled and UART baudrate 115200.
94
92
95
- ```shell
93
+ ```
96
94
./scripts/build/build_examples.py --target bouffalolab-bl602-iot-matter-v1-light-rpc build
97
95
./scripts/build/build_examples.py --target bouffalolab-xt-zb6-devkit-light-rpc build
98
96
```
99
97
100
- - For multiple build options ,such as UART baudrate 115200 + rpc, please try
101
-
102
- ```shell
103
- ./scripts/build/build_examples.py --target bouffalolab-bl602-iot-matter-v1-light-rpc-115200 build
104
- ./scripts/build/build_examples.py --target bouffalolab-xt-zb6-devkit-light-rpc-115200 build
105
- ```
106
-
107
98
## Download image
108
99
109
100
- Using script `*.flash.py`.
@@ -113,9 +104,11 @@ and BL706 develop board `XT-ZB6-DevKit`.
113
104
`chip-bl702-lighting-example.flash.py` will generate under build output
114
105
folder for BL602 or BL702 building.
115
106
116
- > Note, different build options will generate different output folder.
117
-
118
- > Note, make sure terminal is under Matter build environment.
107
+ > Note 1, `*.flash.py` should be ran under Matter build environment; if
108
+ > python module `bflb_iot_tool` is not found, please try to do
109
+ > `source scripts/bootstrap.sh` or install as
110
+ > `pip3 install bflb-iot-tool`.<br> Note 2, different build options will
111
+ > generate different output folder.
119
112
120
113
Download operation steps as below, please check `help` option of script for
121
114
more detail.
@@ -154,7 +147,8 @@ and BL706 develop board `XT-ZB6-DevKit`.
154
147
> Note, better to append --erase option to download image for BL602
155
148
> develop board at first time.
156
149
157
- - Using `Bouffalo Lab` GUI flash tool`BLDevCube`
150
+ - Using `Bouffalo Lab` GUI flash tool `BLDevCube`, please download on
151
+ [this page](https://dev.bouffalolab.com/download).
158
152
- Hold BOOT pin and reset chip, put the board in download mode.
159
153
- Select `DTS` file;
160
154
- Select Partition Table under
@@ -168,7 +162,7 @@ and BL706 develop board `XT-ZB6-DevKit`.
168
162
## Run the example
169
163
170
164
- You can open the serial console. For example, if the device is at
171
- `/dev/ttyACM0`:
165
+ `/dev/ttyACM0` with UART baudrate 2000000 built :
172
166
173
167
```shell
174
168
picocom -b 2000000 /dev/ttyACM0
@@ -182,11 +176,10 @@ and BL706 develop board `XT-ZB6-DevKit`.
182
176
- To do factory reset, press BOOT button over 4 seconds, release BOOT button
183
177
after led blink stopped.
184
178
185
- ## Test with chip-tool
179
+ ## Test Commission and Control with chip-tool
186
180
187
181
Please follow [chip_tool_guide](../../../docs/guides/chip_tool_guide.md) and
188
- [guide](../../chip-tool/README.md) to build and use Matter official test
189
- chip-tool.
182
+ [guide](../../chip-tool/README.md) to build and use chip-tool for test.
190
183
191
184
### Prerequisite for Thread Protocol
192
185
@@ -202,7 +195,7 @@ router to get Thread network credential.
202
195
sudo ot-ctl dataset active -x
203
196
```
204
197
205
- #### Commissioning over BLE
198
+ ### Commissioning over BLE
206
199
207
200
- Reset the board or factory reset the board
208
201
@@ -222,10 +215,10 @@ sudo ot-ctl dataset active -x
222
215
` ` `
223
216
224
217
> ` < node_id> ` , which is node ID assigned to device within chip-tool
225
- > fabric< br> > ` < wifi_ssid> ` , Wi-Fi network SSID< br> > ` < wifi_passwd> ` ,
226
- > Wi-FI network password< br> > ` < thread_operational_dataset> ` , Thread
227
- > network credential which running ` sudo ot-ctl dataset active -x` command
228
- > on border router to get.< br >
218
+ > fabric< br> ` < wifi_ssid> ` , Wi-Fi network SSID< br> ` < wifi_passwd> ` , Wi-FI
219
+ > network password< br> ` < thread_operational_dataset> ` , Thread network
220
+ > credential which running ` sudo ot-ctl dataset active -x` command on border
221
+ > router to get.
229
222
230
223
# ## Cluster control
231
224
@@ -263,7 +256,7 @@ After successful commissioning, cluster commands available to control the board.
263
256
./chip-tool identify identify 10 < node_id> 1
264
257
` ` `
265
258
266
- # # OTA software upgrade with ota-provider-app
259
+ # # Test OTA software upgrade with ota-provider-app
267
260
268
261
Please take [guide](../../ota-provider-app/linux/README.md) for more detail on
269
262
ota-provider-app build and usage.
@@ -309,13 +302,14 @@ ota-provider-app build and usage.
309
302
310
303
# ## Start ota software upgrade
311
304
312
- - BLE commission BL702 lighting if not commissioned.
305
+ - BLE commission BL602/ BL702 lighting if not commissioned.
313
306
- Start OTA software upgrade process
314
307
` ` ` shell
315
308
./chip-tool otasoftwareupdaterequestor announce-ota-provider 1 0 0 0 < node_id_to_lighting_app> 0
316
309
` ` `
317
- where ` < node_id_to_lighting_app> ` is node id of BL702 lighting app.
318
- - After OTA software upgrade gets done, BL702 will get reboot automatically.
310
+ where ` < node_id_to_lighting_app> ` is node id of BL602/BL702 lighting app.
311
+ - After OTA software upgrade gets done, BL602/BL702 will get reboot
312
+ automatically.
319
313
320
314
# # Run RPC Console
321
315
0 commit comments