@@ -11,10 +11,11 @@ The steps were verified on `Bouffalo Lab` BL602 and BL706 development board.
11
11
- ` BL602-NIGHT-LIGHT `
12
12
- ` XT-ZB6-DevKit `
13
13
- ` BL706-NIGHT-LIGHT `
14
- - ` BL704L-DVK `
14
+ - ` BL706DK `
15
+ - ` BL704LDK `
15
16
16
- > Warning: Changing the PID may cause compilation problems, we recommend leaving
17
- > it as the default while using this example.
17
+ > Warning: Changing the VID/ PID may cause compilation problems, we recommend
18
+ > leaving it as the default while using this example.
18
19
19
20
## BL602
20
21
@@ -24,10 +25,17 @@ BL602/BL604 is combo chip-set for Wi-Fi 802.11b/g/n and BLE 5.0 base-band/MAC.
24
25
25
26
<img src =" ../../platform/bouffalolab/doc/chart/BL602-IoT-Matter_V1.png " style =" zoom :25% ;" />
26
27
27
- ## BL706
28
+ ## BL70x
28
29
29
- BL702/BL706 is combo chip-set for BLE and IEEE 802.15.4/ZigBee/Thread. In some
30
- cases, e.g. in SDK, we use BL702 as a general name for BL702/BL706 family.
30
+ BL70x is combo chip-set for BLE and IEEE 802.15.4/ZigBee/Thread.
31
+
32
+ - BL702/BL706 has 14dbm tx power and is recommended for routing devices. SDK
33
+ uses BL702 as a general name.
34
+ - BL702L/BL704L is designed for low power application. SDK uses BL702L as a
35
+ general name.
36
+
37
+ BL70x has fully certified with all Thread 1.3 features, included Thread ` SSED `
38
+ and Thread Border Router with ` DUA manager ` .
31
39
32
40
### ` XT-ZB6-DevKit `
33
41
@@ -47,12 +55,12 @@ Mac OS.
47
55
git clone https://github.com/project-chip/connectedhomeip.git
48
56
cd connectedhomeip
49
57
git submodule update --init --recursive
50
- source ./scripts/activate.sh
58
+ source ./scripts/activate.sh -p bouffalolab
51
59
```
52
60
53
- > After environment setup Bouffalolab flash tool, `bflb-iot-tool`, imports
54
- > under this environment. If not, please try `scripts/bootstrap.sh` for
55
- > matter environment update.
61
+ > After environment setup `Bouffalo Lab` flash tool, `bflb-iot-tool`,
62
+ > imports under this environment. If not, please try
63
+ > `scripts/bootstrap.sh -p bouffalolab` for matter environment update.
56
64
57
65
- Setup build environment for `Bouffalo Lab` SoC
58
66
@@ -72,15 +80,17 @@ Mac OS.
72
80
73
81
## Build CHIP Lighting App example
74
82
75
- The following steps take examples for BL602 develop board `BL602-IoT-Matter-V1`,
76
- BL706 develop board `XT-ZB6-DevKit` and BL704L DVK board `BL704L-DVK`
83
+ The following steps take examples for `BL602-IoT-Matter-V1` bl602 board, BL706
84
+ develop `XT-ZB6-DevKit` and `BL706DK` bl706 board, and `BL704LDK` BL704L board .
77
85
78
86
- Build lighting app with UART baudrate 2000000
79
87
80
88
```
81
89
./scripts/build/build_examples.py --target bouffalolab-bl602-iot-matter-v1-light build
82
90
./scripts/build/build_examples.py --target bouffalolab-xt-zb6-devkit-light build
83
- ./scripts/build/build_examples.py --target bouffalolab-bl704l-dvk-light build
91
+ ./scripts/build/build_examples.py --target bouffalolab-bl704ldk-light build
92
+ ./scripts/build/build_examples.py --target bouffalolab-bl706dk-light-ethernet build
93
+ ./scripts/build/build_examples.py --target bouffalolab-bl706dk-light-wifi build
84
94
```
85
95
86
96
- Build lighting app with UART baudrate 115200
@@ -97,14 +107,39 @@ BL706 develop board `XT-ZB6-DevKit` and BL704L DVK board `BL704L-DVK`
97
107
./scripts/build/build_examples.py --target bouffalolab-xt-zb6-devkit-light-rpc build
98
108
```
99
109
110
+ ### Build options with build_examples.py
111
+
112
+ - `-shell`, enable UART command line
113
+ - `-115200`, set UART baudrate to 115200 for log and command line
114
+ - `-rpc`, enable Pigweed RPC feature
115
+ - `-cdc`, enable USB CDC feature, only support for BL706, and can't work with
116
+ Ethernet Board
117
+ - `-resetCnt`, enable feature to do factory reset when continues power cycle
118
+ is greater than 3
119
+ - `-mfd`, enable Matter factory data feature, which load factory data from
120
+ `DTS` region and `MFD` partition
121
+ - Please contact to `Bouffalo Lab` for Matter factory data support.
122
+ - `-mfdtest`, enable Matter factory data module, but only load factory data
123
+ from `FactoryDataProvider.cpp` file.
124
+ - `-wifi`, to specify that connectivity Wi-Fi is enabled for Matter
125
+ application.
126
+ - `-ethernet`, to specify that connectivity Ethernet is enabled for Matter
127
+ application.
128
+ - `-thread`, to specify that connectivity Thread is enabled for Matter
129
+ application.
130
+ - `-fp`, to specify to enable frame pointer feature to print call stack when
131
+ hit an exception for debug purpose.
132
+
100
133
## Download image
101
134
102
135
- Using script `*.flash.py`.
103
136
104
- After building gets done, python script
105
- `chip-bl602-lighting-example.flash.py` or
106
- `chip-bl702-lighting-example.flash.py` will generate under build output
107
- folder for BL602 or BL702 building.
137
+ After building gets done, python script `*.flash.py` will generate under
138
+ build output folder, such as
139
+
140
+ - `chip-bl602-lighting-example.flash.py` for BL602
141
+ - `chip-bl702-lighting-example.flash.py` for BL702
142
+ - `chip-bl702l-lighting-example.flash.py` for BL702L
108
143
109
144
> Note 1, `*.flash.py` should be ran under Matter build environment; if
110
145
> python module `bflb_iot_tool` is not found, please try to do
@@ -126,12 +161,13 @@ BL706 develop board `XT-ZB6-DevKit` and BL704L DVK board `BL704L-DVK`
126
161
- Type following command for image download. Please set serial port
127
162
accordingly, here we use /dev/ttyACM0 as a serial port example.
128
163
129
- - `bl602-iot-matter-v1` and `bl704l-dvk` without additional build
130
- options
164
+ - `bl602-iot-matter-v1`, `xt-zb6-devkit` and `bl704ldk` without
165
+ additional build options
131
166
132
167
```shell
133
168
./out/bouffalolab-bl602-iot-matter-v1-light/chip-bl602-lighting-example.flash.py --port /dev/ttyACM0
134
- ./out/bouffalolab-bl704l-dvk-light/chip-bl702l-lighting-example.flash.py --port /dev/ttyACM0
169
+ ./out/bouffalolab-xt-zb6-devkit-light/chip-bl702-lighting-example.flash.py --port /dev/ttyACM0
170
+ ./out/bouffalolab-bl704ldk-light/chip-bl702l-lighting-example.flash.py --port /dev/ttyACM0
135
171
```
136
172
137
173
- `xt-zb6-devkit` with 115200 baudrate setting
@@ -146,7 +182,7 @@ BL706 develop board `XT-ZB6-DevKit` and BL704L DVK board `BL704L-DVK`
146
182
```shell
147
183
./out/bouffalolab-bl602-iot-matter-v1-light/chip-bl602-lighting-example.flash.py --port /dev/ttyACM0 --erase
148
184
./out/bouffalolab-xt-zb6-devkit-light-115200/chip-bl702-lighting-example.flash.py --port /dev/ttyACM0 --erase
149
- ./out/bouffalolab-bl704l-dvk -light/chip-bl702l-lighting-example.flash.py --port /dev/ttyACM0 --erase
185
+ ./out/bouffalolab-bl704ldk -light/chip-bl702l-lighting-example.flash.py --port /dev/ttyACM0 --erase
150
186
```
151
187
152
188
> Note, better to append --erase option to download image for BL602
0 commit comments