You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: examples/coex_app/readme.md
+71-30Lines changed: 71 additions & 30 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,18 +1,21 @@
1
1
Overview
2
2
========
3
+
3
4
The example to demonstrate the usage of Bluetooth BT/BLE and WiFi profiles coexistence.
4
5
5
-
Before building the example application select Wi-Fi module macro in the app_config.h. (see #define WIFI_<SoCName>_BOARD_<ModuleName>).
6
+
Before building the example application select Wi-Fi module macro in the app_config.h. (see #define WIFI_`<SoC Name>`_BOARD_`<Module Name>`).
6
7
7
8
This document provides step-by-step procedures to build and test the example,
8
9
and also instructions for running the included sample applications.
9
10
10
11
SDK version
11
12
===========
13
+
12
14
- Version: 2.16.100
13
15
14
16
Toolchain supported
15
17
===================
18
+
16
19
Coex environment is suited to be run on a Linux-based OS (Ubuntu OS for example), WSL (Ubuntu 20.04 on Windows) or Windows (command line). There are three tools that need to be installed:
17
20
18
21
- CMake
@@ -22,46 +25,50 @@ Coex environment is suited to be run on a Linux-based OS (Ubuntu OS for example)
22
25
Depending on system used installing each tool done differently.
23
26
24
27
**NOTE:**
28
+
25
29
1. Make sure that the paths of all these tools are set into the Path system variable.
26
30
2. Tri radio coex app currently **only supports arm-gcc** compilation.
27
31
28
32
Hardware requirements
29
33
=====================
34
+
30
35
- Micro USB cable
31
36
- RD-RW61X-BGA/FRDMRW612 board
32
37
- Personal Computer
33
38
34
39
Board settings
35
40
==============
36
41
37
-
PIN NAME | RDRW612-BGA
38
-
-------------|--------------------------
39
-
FC0_UART_TXD | HD2(pin 3) <---> HD3(TX)
40
-
FC0_UART_RXD | HD2(pin 2) <---> HD3(RX)
42
+
|PIN NAME | RDRW612-BGA|
43
+
|------------|------------------------|
44
+
|FC0_UART_TXD | HD2(pin 3) <---> HD3(TX)|
45
+
|FC0_UART_RXD | HD2(pin 2) <---> HD3(RX)|
41
46
42
47
**NOTE:**
48
+
43
49
1. For RDRW612-BGA/QFN A1&A2 board, need to confirm the following settings.
44
50
- unload JP19, load JP9, JP23
45
51
- Connect JP47 to GND.
46
52
47
53
> _Connecting JP47 to GND only needs to be GND once after power-on, and then it can be removed. Both A1&A2 JP47 and A0 JP30 are grounded to close U51._
48
54
>
49
-
> <fontcolor=red>_The pins corresponding to U51 on different boards may not be JP47 or JP30, please check._</font>
55
+
> `<font color=red>`_The pins corresponding to U51 on different boards may not be JP47 or JP30, please check._`</font>`
56
+
>
50
57
2. WiFi and BLE use `FC3` UART and OT uses `FC0` UART.
51
58
52
-
53
-
54
59
Building the examples
55
60
=====================
56
61
57
62
### 1. Downloading repo:
58
63
59
64
Download the mcu-sdk-2.0 SDK package:
65
+
60
66
```bash
61
67
$ cd<path-to-sdk>/
62
68
```
63
69
64
70
Download the ot-nxp repo to `<path-to-sdk>/middleware/wireless/coex/third_party/`:
> NOTE: Please use the command "help" to view the specific commands supported by the example.
252
+
227
253
- BLE scan devices (the BLE host must initialized before):
254
+
228
255
```bash
229
256
@Coex> bt.init
230
257
@Coex> Bluetooth initialized
@@ -249,7 +276,9 @@ Bluetooth active scan enabled
249
276
Scan successfully stopped
250
277
@Coex>
251
278
```
279
+
252
280
- BLE advertise (the BLE host must initialized before):
281
+
253
282
```bash
254
283
@Coex> bt.init
255
284
@Coex> Bluetooth initialized
@@ -258,15 +287,19 @@ Advertising started
258
287
@Coex> bt.advertise off
259
288
Advertising stopped
260
289
```
290
+
261
291
- BLE connect (the BLE host must initialized before):
292
+
262
293
```bash
263
294
@Coex> bt.init
264
295
@Coex> Bluetooth initialized
265
296
@Coex> bt.connect C0:95:63:23:55:87 random
266
297
Connection pending
267
298
Connected: 7D:FD:FD:4D:FD:90 (random)
268
299
```
300
+
269
301
- BLE pairing and bonding:
302
+
270
303
```bash
271
304
GATT peripheral role side,
272
305
1. Initialize the Host, press "bt.init",
@@ -285,7 +318,9 @@ GATT central role side,
285
318
it could be started from central side by pressing "bt.security <level>", such as "bt.security 2".
286
319
6. If the bondable is unsupported by central role, press "bt.bondable off". Then start step 5.
287
320
```
321
+
288
322
- BLE 1M/2M/Coded PHY update:
323
+
289
324
```bash
290
325
GATT peripheral role side,
291
326
1. Initialize the Host, press "bt.init",
@@ -307,7 +342,9 @@ GATT central role side,
307
342
such as "bt.phy-update 2 2".
308
343
6. The message "LE PHY updated: TX PHY LE 2M, RX PHY LE 2M" would be printed if the phy is updated. note, if peer do not support phy update, then this message will not be printed.
309
344
```
345
+
310
346
- BLE Data Packet Length Extension update:
347
+
311
348
```bash
312
349
GATT peripheral role side,
313
350
1. Initialize the Host, press "bt.init".
@@ -359,7 +396,9 @@ LE data len updated: TX (len: 50 time: 512) RX (len: 27 time: 328)
359
396
7. When LE data len is updated by the peer device, below information will be printed.
360
397
LE data len updated: TX (len: 50 time: 512) RX (len: 65 time: 632)
361
398
```
399
+
362
400
- BLE GATT data signing:
401
+
363
402
```bash
364
403
GATT peripheral role side,
365
404
1. Initialize the Host, press "bt.init",
@@ -385,7 +424,9 @@ GATT central role side,
385
424
perform the GATT data signing sequence, press "gatt.signed-write <handle> <data> [length] [repeat]",
0 commit comments