xref: /nrf52832-nimble/README.md (revision 150812a83cab50279bd772ef6db1bfaf255f2c5b)
1# NRF52832 Nimble BSP 使用说明
2
3## 简介
4
5该 BSP 基于 Nordic 公司的 nrf52832 MCU,提供 RT-Thread bluetooth 协议栈的相关功能。
6
7
8## 外设支持
9
10本 BSP 目前对外设的支持情况如下:
11
12| **片内外设**      | **支持情况** | **备注**                              |
13| :----------------- | :----------: | :------------------------------------- |
14| OS_Tick        |     支持      |                                       |
15| UART           |     TX-->6;RX-->8     |  |
16## 使用说明
17
18bluetooth 协议栈当前是以软件包的形式发布,因此如果需使用 BLE 的相关功能,首先需要拉取该软件包。
19
20### 编译及烧写
21
22- 设置 RTT_ROOT 路径
23
24因为当前 BSP 尚未合并入 RT-Thread 仓库,所以编译之前需要手动设置 RTT_ROOT 的路径,即打开 ENV 工具,输入 ``set RTT_ROOT=D:\dev\rt_code\rt-thread``。
25
26- 拉取 BLE 软件包
27
28打开 ENV 工具,然后输入 ``pkgs --update``,会自动从 github 拉取 BLE 协议栈。
29
30- 编译工程
31
32成功拉取协议栈之后,需要重新生成 MDK 工程。仍然在 ENV 目录下,输入 ``scons --target=mdk5``,此时会重新生成新的 MDK5 工程。
33打开该工程,点击 build 按钮,编译生成 hex 文件。
34
35- 烧写
36
37使用 JLINK 连接板子,选择对应的芯片型号,点击 Download 按钮进行烧写。
38
39### 运行结果
40
41烧写完成后,正确连接板载串口至终端软件,复位重新执行,打印如下信息,此时标志 RT-Thread 已经在正常工作,可输入其它 FINSH 命令查看系统状态信息,如 ``ps`` 、 ``free`` 等。
42
43```
44 \ | /
45- RT -     Thread Operating System
46 / | \     4.0.0 build Jan 23 2019
47 2006 - 2018 Copyright by rt-thread team
48hello world
49msh />
50```
51
52### BLE 的简单使用
53
54当前工程提供一个 Heart rate 示例。系统正常运行后,在 Finsh 命令行 输入 `` ble_hr ``,执行该 Demo。如下:
55
56```
57msh />ble_hr
58[I/nimble] GAP procedure initiated: stop advertising.
59[I/nimble] GAP procedure initiated: advertise; disc_mode=2 adv_channel_map=0 own_addr_type=0 adv_filter_policy=0 adv_itvl_min=0 adv_itvl_max=0
60msh />
61```
62
63此时手机打开 `nRF Master Control Panel` APP,能够扫描到名为 `ble_sensor` 的设备,连接之后,模拟的 Heart rate 示例开始运行。现象如下:
64
65![heart_rate](docs/figures/heart_rate.png)
66
67## 注意事项
68
69- 该BSP UART默认使用 TX--->6;RX--->8 引脚,可根据板载设计自行修改;
70- RT-Ththread bluetooth 协议栈移植自开源方案 Nimble,相关介绍及 API 说明可参考``http://mynewt.apache.org/latest/network/docs/index.html``。
71
72
73