Demo:Btble - 版本历史

2025年7月29日 (二) 09:12 武楷轩

2025-07-29T09:12:28Z

←上一版本		2025年7月29日 (二) 09:12的版本
第166行：		第166行：
	</syntaxhighlight>''<big>上述的函数相关具体说明，全部保存在SDK的路径下： docs/en/api_reference/ble.rst</big>''		</syntaxhighlight>''<big>上述的函数相关具体说明，全部保存在SDK的路径下： docs/en/api_reference/ble.rst</big>''

	=== ~~BLE基本通信流程：~~ ~~GATT服务是什么：~~ ===		=== BLE基本通信流程 GATT服务框架： ===
	[[文件:BLE.png\|链接=https://docs.bouffalolab.com/%E6%96%87%E4%BB%B6:BLE.png\|左\|450x450像素]]		[[文件:BLE.png\|链接=https://docs.bouffalolab.com/%E6%96%87%E4%BB%B6:BLE.png\|左\|450x450像素]]
	[[文件:GATT.png\|链接=https://docs.bouffalolab.com/%E6%96%87%E4%BB%B6:GATT.png\|居中\|450x450像素]]		[[文件:GATT.png\|链接=https://docs.bouffalolab.com/%E6%96%87%E4%BB%B6:GATT.png\|居中\|450x450像素]]

武楷轩：/* BLE基本通信流程： GATT服务是什么： */

2025-07-29T09:10:14Z

BLE基本通信流程： GATT服务是什么：

←上一版本		2025年7月29日 (二) 09:10的版本
第166行：		第166行：
	</syntaxhighlight>''<big>上述的函数相关具体说明，全部保存在SDK的路径下： docs/en/api_reference/ble.rst</big>''		</syntaxhighlight>''<big>上述的函数相关具体说明，全部保存在SDK的路径下： docs/en/api_reference/ble.rst</big>''

	=== ~~'''~~BLE基本通信流程：~~'''~~ ~~'''~~GATT服务是什么：~~'''~~ ===		=== BLE基本通信流程： GATT服务是什么： ===
	[[文件:BLE.png\|链接=https://docs.bouffalolab.com/%E6%96%87%E4%BB%B6:BLE.png\|左\|450x450像素]]		[[文件:BLE.png\|链接=https://docs.bouffalolab.com/%E6%96%87%E4%BB%B6:BLE.png\|左\|450x450像素]]
	[[文件:GATT.png\|链接=https://docs.bouffalolab.com/%E6%96%87%E4%BB%B6:GATT.png\|居中\|450x450像素]]		[[文件:GATT.png\|链接=https://docs.bouffalolab.com/%E6%96%87%E4%BB%B6:GATT.png\|居中\|450x450像素]]


	CCC则是一个订阅开关，本质上是一个数值，服务端会监控这个数值，假设该数值变化了，那么服务端则认为连接设备需要订阅消息。		CCC则是一个订阅开关，本质上是一个数值，服务端会监控这个数值，假设该数值变化了，那么服务端则认为连接设备需要订阅消息。

2025年7月29日 (二) 09:08 武楷轩

2025-07-29T09:08:59Z

←上一版本		2025年7月29日 (二) 09:08的版本
第166行：		第166行：
	</syntaxhighlight>''<big>上述的函数相关具体说明，全部保存在SDK的路径下： docs/en/api_reference/ble.rst</big>''		</syntaxhighlight>''<big>上述的函数相关具体说明，全部保存在SDK的路径下： docs/en/api_reference/ble.rst</big>''

	'''BLE基本通信流程：''' '''GATT服务是什么：'''		=== '''BLE基本通信流程：''' '''GATT服务是什么：''' ===
	[[文件:BLE.png\|链接=https://docs.bouffalolab.com/%E6%96%87%E4%BB%B6:BLE.png\|左\|450x450像素]]		[[文件:BLE.png\|链接=https://docs.bouffalolab.com/%E6%96%87%E4%BB%B6:BLE.png\|左\|450x450像素]]
	[[文件:GATT.png\|链接=https://docs.bouffalolab.com/%E6%96%87%E4%BB%B6:GATT.png\|居中\|450x450像素]]		[[文件:GATT.png\|链接=https://docs.bouffalolab.com/%E6%96%87%E4%BB%B6:GATT.png\|居中\|450x450像素]]

2025年7月29日 (二) 09:07 武楷轩

2025-07-29T09:07:15Z

←上一版本		2025年7月29日 (二) 09:07的版本
第120行：		第120行：

	P4：Application key index.		P4：Application key index.
			</syntaxhighlight>

			== blemesh_simple ==
			该demo的功能与上述的一致，但是该demo不需要前置的命令操作，在板子上电后会自动启动 blue mesh 网络，你可以参考blemesh_cli中的连接步骤直接进行节点连接。

			如果你需要发送指令来控制，你可以发送以下指令：

			"gen_cli_send dstaddress"将控制数据发送到指定的设备地址或这组地址。

			== btble_cli ==
			该demo会启动一个基本的BLE设备。你需要使用命令去进行操控该设备。

			如果您不熟悉BLE的通信流程，请参考以下基本流程。<syntaxhighlight lang="bash" line="1">
			#服务端执行
			ble_init
			ble_start_adv 0 0 0x80 0x80

			#客户端设备执行
			ble_start_scan 0 1 0x80 0x50

			#scan后会获取到对应的地址进行连接这里是示例地址
			#连接成功后服务端的终端会显示 connected
			ble_connect 0 B40ECF2E90FC

			#查询GATT服务这里是通用服务码
			ble_discover 0 0x1800 0x1 0xffff 或者 ble_discover 0 0x1801 0x1 0xffff

			#如果要查询特殊码（这里可以省略这一步）
			ble_discover 3 0x1800 0x1 0xffff

			#查询到服务后，可以选择直接读写：
			ble_read 0x7 0
			ble_write 0x7 0 2 0102

			#也可以通过CCC进行订阅操作
			ble_subscribe 0x4 0x3 0x1
			#取消订阅：
			ble_unsubscribe






			</syntaxhighlight>''<big>上述的函数相关具体说明，全部保存在SDK的路径下： docs/en/api_reference/ble.rst</big>''

			'''BLE基本通信流程：''' '''GATT服务是什么：'''
			[[文件:BLE.png\|链接=https://docs.bouffalolab.com/%E6%96%87%E4%BB%B6:BLE.png\|左\|450x450像素]]
			[[文件:GATT.png\|链接=https://docs.bouffalolab.com/%E6%96%87%E4%BB%B6:GATT.png\|居中\|450x450像素]]
			CCC则是一个订阅开关，本质上是一个数值，服务端会监控这个数值，假设该数值变化了，那么服务端则认为连接设备需要订阅消息。

			== btble_controller_test ==
			BLE控制器测试demo,终端返回 pwr_mod is bf 则表示正常。

			== btble_central ==
			该demo上电后会直接自动扫描周围的BLE设备，当设备存在并且名称匹配时，会直接进行连接并扫描对应的GATT服务然后进行订阅。

			设备名称，GATT服务等都是程序提前设定好的，这部分设定在同级目录下的 config.h 文件中。

			这里展示一部分：<syntaxhighlight lang="bash" line="1">
			#endif

			/**
			* CONFIG_BT_DEVICE_NAME:Bluetooth device name. Name can be up
			* to 248 bytes long (excluding NULL termination). Can be empty string
			*/
			#ifndef CONFIG_BT_DEVICE_NAME
			#if defined(CONFIG_AUTO_PTS)
			#define CONFIG_BT_DEVICE_NAME "AUTO_PTS_TEST0123456789012345"
			#else
			#if defined(BL602)
			#define CONFIG_BT_DEVICE_NAME "BL602-BLE-DEV"
			#elif defined(BL702)
			#define CONFIG_BT_DEVICE_NAME "BL702-BLE-DEV"
			#elif defined(BL702L)
			#define CONFIG_BT_DEVICE_NAME "BL702L-BLE-DEV"
			#else
			#define CONFIG_BT_DEVICE_NAME "BTBLE-DEV"
			#endif
			#endif
			#endif
			/**
			</syntaxhighlight>

			== btble_periphral ==
			该demo测试了BLE的OAD服务，上电后会直接执行GATT的OAD服务注册，然后进行广播，所有了连接上该服务端的设备订阅OAD服务都可以进行OAD远程升级。

			注意这部分代码需要分区表，所以在烧录时必须进行 make whole 将分区表信息烧录进去。

			OAD烧录的固件需要手动生成：<syntaxhighlight lang="bash" line="1">
			#其中FW.bin 是你要进行升级的bin
			python3 components/wireless/bluetooth/tools/GenerateOAD.py FW.bin FW.bin.sha256

	</syntaxhighlight>		</syntaxhighlight>

武楷轩：添加blemesh_cli

2025-07-16T08:30:29Z

添加blemesh_cli

←上一版本		2025年7月16日 (三) 08:30的版本
第1行：		第1行：
	~~Demo介绍：~~

	~~这部分Demo主要是蓝牙通讯相关的实例代码，保存在SDK的~~ example/btble路径下。		== Demo介绍： ==
			'''这部分Demo主要是蓝牙通讯相关功能的实例代码，这些demo保存在SDK的 example/btble路径下。'''

			== blemesh_cli: ==

			=== 基本介绍： ===
			该demo创建了一个 Bluetooth mesh 网络，通过向串口发送指令进行初始化后，就可以通过手机APP在mesh网络中进行添加并连接。

			DEMO命令和输出：<syntaxhighlight lang="bash" line="1">
			bouffalolab />blemesh_init #初始化bluemesh网络
			#输出：
			Init successfully
			Env[LOCAL_NAME] Data len[10], setting_env_cb
			Use pb-adv or pb-gatt to enable advertising

			bouffalolab />blemesh_pb 2 1
			#输出：
			PB-GATT enabled

			</syntaxhighlight>执行完上述命令后，就可以使用手机APP进行NODE的添加和连接。

			添加的步骤如下：<gallery>
			文件:APPopen.png\|step1
			文件:Meshnode2.png\|step2
			文件:Meshnode3.png\|step3
			文件:Meshnode4.png\|step4
			文件:Meshnode5.png\|step5
			文件:Meshnode6.png\|ste6
			文件:Meshnode7.png\|step7
			文件:Meshnode8.png\|step8
			文件:Meshnode9.png\|step9
			文件:Meshnode10.png\|step10
			文件:Meshnode11.png\|step11
			文件:Meshnode12.png\|step12
			文件:Meshnode13.png\|step13
			</gallery>

			=== 如何使用配网器 Provisioner 将新设备添加进网络中： ===
			大概流程如下：

			'''1.打开未配网设备 ---- 2.启动配网器Provisioner ---- 3.监听设备广播 ---- 4.添加设备到网络 ---- 5.获取设备信息 ---- 6.分配密钥'''

			provisioner设备编译时，必须更改一个编译选项：

			CONFIG_BT_MESH_PROVISIONER=1

			==== 执行步骤1：打开未配网设备并且输入以下命令： ====
			<syntaxhighlight lang="bash" line="1">
			blemesh_init # 初始化Mesh协议栈
			blemesh_pb 1 1 # 开启PB-ADV和PB-GATT配网承载
			</syntaxhighlight>

			==== 执行步骤2：打开配网器设备输入以下命令： ====
			<syntaxhighlight lang="bash" line="1">
			bouffalolab />blemesh_pvnr_init #初始化Provisioner
			#得到输出：
			.........
			Local node provisioned, net_idx 0x0000 address 0x0001

			Network key:8fe7deea92943001567251dc1f9b0f03

			Dev key:89c2f18f9f286661c6bbb1430d7aadb7

			Provisioning completed
			</syntaxhighlight>

			* <code>net_idx 0x0000</code>：网络索引
			* <code>address 0x0001</code>：Provisioner自身地址
			* <code>Network key</code>：网络层加密密钥
			* <code>Dev key</code>：设备专属配置密钥

			==== 执行步骤3：打开广播 ====
			执行以下命令：
			blemesh_beacon_listen 0x01 # 开启广播监听

			* 扫描周围广播Mesh信标的设备
			* 捕获并显示未配网设备的UUID（如：<code>07af000011112222333318b905de96c2</code>）
			* UUID包含设备身份信息（厂商ID、产品ID等）

			==== 执行步骤4：在配网器设备上执行添加设备到网络命令 ====
			<syntaxhighlight lang="bash" line="1">
			bouffalolab />blemesh_provision_adv 07af000011112222333318b905de96c2 0 3 0
			#输出
			P1：“07af000011112222333318b905de96c2" is UUID information.
			P2：0：net_idx
			P3：3： assign node unicast address。
			P4：0：attention_duration
			</syntaxhighlight>

			* <code>UUID</code>：目标设备的唯一标识
			* <code>net_idx 0</code>：使用的网络索引
			* <code>address 3</code>：分配给设备的单播地址(0x0003)
			* <code>attention_duration 0</code>：配网指示时长（0=无提示）

			==== 执行步骤5：获取设备信息 ====
			执行的命令与输出内容：<syntaxhighlight lang="bash" line="1">
			bouffalolab /> blemesh_get_comp 0x0000 0x0003 0x00
			#输出：
			P1：net index.

			P2：dst address.

			P3：page number.
			</syntaxhighlight>

			* <code>net_idx 0x0000</code>：网络索引
			* <code>dst 0x0003</code>：目标设备地址
			* <code>page 0x00</code>：组成数据页码

			==== 执行步骤6：分配密钥key ====
			<syntaxhighlight lang="bash" line="1">
			bouffalolab /> blemesh_app_key_add 0x0000 0x0003 0x0000 0x0000
			#输出
			P1：net index.

			P2：dst address.

			P3：Network key index。

			P4：Application key index.
			</syntaxhighlight>

武楷轩：武楷轩移动页面Demo：Btble至Demo:Btble

2025-07-16T05:49:52Z

武楷轩移动页面Demo：Btble至Demo:Btble

←上一版本	2025年7月16日 (三) 05:49的版本
（没有差异）

武楷轩：创建

2025-07-09T07:14:13Z

创建

新页面

Demo介绍：

这部分Demo主要是蓝牙通讯相关的实例代码，保存在SDK的 example/btble路径下。

Demo:Btble - 版本历史

2025年7月29日 (二) 09:12 武楷轩

武楷轩：​/* BLE基本通信流程： GATT服务是什么： */

2025年7月29日 (二) 09:08 武楷轩

2025年7月29日 (二) 09:07 武楷轩

武楷轩：​添加blemesh_cli

武楷轩：​武楷轩移动页面Demo：Btble至Demo:Btble

武楷轩：​创建

武楷轩：/* BLE基本通信流程： GATT服务是什么： */

武楷轩：添加blemesh_cli

武楷轩：武楷轩移动页面Demo：Btble至Demo:Btble

武楷轩：创建