Name Date Size #Lines LOC

..--

apps/H25-Apr-2025-22,58916,262

docs/H25-Apr-2025-4,7863,783

ext/tinycrypt/H25-Apr-2025-6,5302,913

nimble/H25-Apr-2025-146,856101,437

porting/H25-Apr-2025-14,8559,084

.gitignoreH A D25-Apr-202552 43

.rat-excludesH A D25-Apr-2025440 2922

.travis.ymlH A D25-Apr-20253 KiB13298

CODING_STANDARDS.mdH A D25-Apr-20255.5 KiB268191

LICENSEH A D25-Apr-202511.8 KiB218181

NOTICEH A D25-Apr-2025248 96

README.mdH A D25-Apr-20255.9 KiB165139

SConscriptH A D25-Apr-20256.9 KiB238205

repository.ymlH A D25-Apr-20251.1 KiB3713

version.ymlH A D25-Apr-2025931 231

README.md

1# 1 介绍
2
3NimBLE 软件包是 RT-Thread 基于 [Apache NimBLE](https://github.com/apache/mynewt-nimble) 开源蓝牙 5.0 协议栈的移植实现，该协议栈提供完整的 Host 层和 Controller 层支持，目前支持 Nordic nRF51 和 nRF52 系列芯片。
4
5## 1.1 主要特性
6
7- 扩展广播(LE Advertising Extensions)
8- 2Mbit/s比特率的物理层
9- 长距离编码(Coded PHY for LE Long Range)
10- 高速不可连接广播(High Duty Cycle Non-Connectable Advertising)
11- 新的跳频算法(Channel Selection Algorithm #2)
12- 隐私1.2(LE Privacy 1.2)
13- 安全管理(SM),支持传统配对(LE Legacy Pairing),安全连接(LE Secure Connections),特定秘钥分发(Transport Specific Key Distribution)
14- 链路层PDU数据长度扩展(LE Data Length Extension)
15- 多角色并发(主机(central)/从机(peripheral), server/client)
16- 同时广播和扫描
17- 低速定向广播(Low Duty Cycle Directed Advertising)
18- 连接参数请求(Connection parameters request procedure)
19- LE Ping
20- 完整的GATT客户端，服务端，以及子功能
21- 抽象HCI接口层
22
23## 1.2 Profile和Service支持
24
25- 警报通知服务(ANS)
26- 即时报警服务(IAS)
27- 链路丢失服务(LLS)
28- 电池服务(BAS)
29- 设备信息服务(DIS)
30- 心率服务(HRS)
31- 自行车速度及步调(CSC)
32- 射频功率(TPS)
33
34## 1.3 Mesh 特性
35
36- 广播和GATT承载(Advertising and GATT bearers)
37- PB-GATT 和 PB-ADV provisioning
38- 模型层(Foundation Models (server role))
39- 支持中继(Relay support)
40- 支持GATT代理(GATT Proxy)
41
42更多关于 NimBLE Stack 的介绍请参考 ``http://mynewt.apache.org/latest/network/docs/index.html``。
43
44## 1.4  目录结构
45
46```
47NimBLE
48   ├───apps                   /* Bluetooth 示例应用程序 */
49   │   ├───blecent
50   │   ├───blecsc
51   │   ├───blehci
52   │   ├───blehr
53   │   ├───blemesh
54   │   ├───blemesh_light
55   │   ├───blemesh_shell
56   │   ├───bleprph
57   │   ├───bleuart
58   │   ├───btshell
59   │   ├───ext_advertiser
60   │   └───ibeacon
61   ├───docs                   /* 官方文档及 API 说明 */
62   ├───ext
63   │   └───tinycrypt          /* Tinycrypt 加密库 */
64   ├───nimble
65   │   ├───controller         /* Controller 实现 */
66   │   │   ├───include
67   │   │   └───src
68   │   ├───drivers            /* Nordic 系列 Phy 驱动 */
69   │   │   ├───nrf51
70   │   │   └───nrf52
71   │   ├───host               /* Host Stack(主机控制器)实现 */
72   │   │   ├───include
73   │   │   ├───mesh           /* Mesh 组网功能 */
74   │   │   ├───pts            /* PTS 测试相关 */
75   │   │   ├───services       /* 通用的 Profile */
76   │   │   │   ├───ans
77   │   │   │   ├───bas
78   │   │   │   ├───bleuart
79   │   │   │   ├───dis
80   │   │   │   ├───gap
81   │   │   │   ├───gatt
82   │   │   │   ├───ias
83   │   │   │   ├───lls
84   │   │   │   └───tps
85   │   │   ├───src
86   │   │   ├───store
87   │   │   ├───tools
88   │   │   └───util
89   │   ├───include
90   │   │   └───nimble
91   │   ├───src
92   │   └───transport          /* HCI 传输抽象层 */
93   │       ├───emspi
94   │       ├───ram
95   │       ├───socket
96   │       └───uart
97   └───porting                /* OS 抽象层及系统配置 */
98       ├───nimble
99       │   ├───include
100       │   └───src
101       └───npl
102           └───rtthread       /* RT-Thread OS 接口实现 */
103               ├───include
104               │   ├───config /* NimBLE 协议栈配置选项 */
105               │   ├───console
106               │   └───nimble
107               └───src
108```
109
110## 1.5 许可证
111
112NimBLE 软件包遵循 Apache-2.0 许可，详见 LICENSE 文件。
113
114## 1.6 依赖
115
116- RT_Thread 3.0+
117
118## 2 获取软件包
119
120使用 NimBLE 软件包需要在 RT-Thread 的包管理中选中它，具体路径如下：
121
122```
123RT-Thread online packages
124    IoT - internet of things  --->
125--- NimBLE:An open-source Bluetooth 5.0 stack porting on RT-Thread
126      Bluetooth Role support  --->
127      Host Stack Configuration  --->
128      Controller Configuration  --->
129      Bluetooth Mesh support  --->
130      HCI Transport support  ----
131      Device Driver support  ----
132      Log level (INFO)  --->
133      Bluetooth Samples (Not enable sample)  --->
134(1)   Maximum number of concurrent connections
135[*]   Device Whitelist Support
136(0)   The number of multi-advertising instances
137[ ]   Extended Advertising Feature Support
138      Version (latest)  --->
139
140```
141
142**Bluetooth Role support**  ：  配置 BLE角色支持(Central/Peripheral/Broadcaster/Observer) ；
143**Host Stack Configuration**  ：  配置 Host 相关功能；
144**Controller Configuration**  ：  配置 Controller 相关功能；
145**Bluetooth Mesh support**  ：  Mesh 特性支持及配置；
146**HCI Transport support** ： 配置HCI层传输方式
147**Device Driver support ** ： 底层 SOC Phy 支持
148**Log level (INFO)**  ：  配置协议栈日志等级；
149**Bluetooth Samples**  ：  配置示例应用；
150**Version**  ：  软件包版本选择；
151
152配置完成后让 RT-Thread 的包管理器自动更新，或者使用 pkgs --update 命令更新包到 BSP 中。
153
154## 3 使用 NimBLE 软件包
155
156配合独立的 nrf52832-nimble bsp 使用，参考 https://github.com/EvalZero/nrf52832-nimble 。
157
158## 4 注意事项
159- NimBLE 当前处于开发阶段，暂时只支持 Nodic nRF52832 MCU，参见 [nrf52832-bsp](https://github.com/EvalZero/nrf52832-nimble)
160
161## 5、联系方式 & 感谢
162
163- 维护：RT-Thread 开发团队
164- 主页：https://github.com/RT-Thread-packages/nimble
165