当前位置：首页 > news >正文

从零构建BLE应用：深入解析服务、特征与UUID的实战指南

news 2026/4/18 23:08:22

1. 为什么BLE开发离不开服务、特征与UUID？

第一次接触BLE开发时，我盯着那些Service、Characteristic和UUID也是一头雾水。直到做了一个温湿度传感器项目才明白，这三者就像快递柜的取件系统：服务是快递柜的某个区域（比如生鲜区），特征是具体的快递格口，UUID则是每个格口的唯一编号。没有这套体系，手机和蓝牙设备就像找不到快递的收件人。

经典蓝牙和BLE最大的区别在于能耗设计。我做过对比测试：同样传输温度数据，经典蓝牙平均功耗15mA，BLE仅需0.01mA。这就是为什么智能手环能用小电池续航一周，而传统蓝牙耳机每天都要充电。但BLE每次只能传20字节数据，所以开发时要像发短信一样精简内容。

2. 手把手设计温湿度传感器的蓝牙服务

2.1 服务(Service)的规划逻辑

去年给农场做环境监测系统时，我把蓝牙服务分成三个模块：

设备信息服务（0x180A）：包含固件版本、电量等固定信息
环境数据服务（自定义UUID）：处理实时温湿度数据
配置服务（自定义UUID）：接收报警阈值设置

用Android Studio的Bluetooth LE Scanner工具扫描，能看到设备广播的服务列表就像餐厅菜单。标准服务用SIG定义的16位UUID（如0x180A），自定义服务则需要生成完整的128位UUID。这里有个坑：iOS对自定义UUID的缓存机制可能导致服务刷新不及时，解决方法是在设备断开连接时手动清除缓存。

2.2 特征(Characteristic)的属性配置

特征才是真正的数据通道，我的温湿度传感器用了这些配置：

// 温度读取特征（只读+通知） BLECharacteristic tempCharacteristic( "00002A6E-0000-1000-8000-00805F9B34FB", // 标准温度UUID BLERead | BLENotify, 4 // 32位浮点数占4字节 ); // 阈值设置特征（可写） BLECharacteristic thresholdCharacteristic( "C3F11001-0000-1000-8000-00805F9B34FB", // 自定义UUID BLEWrite, 2 // 16位整数足够 );

特别注意属性权限的设置：

BLERead：手机可以主动读取
BLENotify：设备主动推送（温度变化时）
BLEWriteWithoutResponse：快速写入不等待确认（适合频繁配置）
BLEIndicate：带确认的通知（关键报警）

实测发现如果误将只读特征设为可写，Android会直接报"WRITE_NOT_PERMITTED"错误，而iOS可能静默失败。

3. UUID的实战选用策略

3.1 标准UUID与自定义UUID的抉择

蓝牙技术联盟（SIG）已经定义了大量标准UUID，比如：

电池服务：0x180F
心率测量：0x2A37
设备名称：0x2A00

在项目中应优先使用标准UUID，有两个好处：

跨平台兼容性好
客户端无需额外文档就能理解功能

但当需要传输特殊数据时（比如土壤酸碱度），就得用自定义UUID。生成时建议遵循这个格式：

"XXXXXXXX-0000-1000-8000-00805F9B34FB"

前4字节自定义，后面固定。用在线工具生成时要注意：有些工具会产生完全随机的UUID，可能导致某些手机系统无法识别。

3.2 UUID的存储与调用技巧

在Arduino代码中，我习惯用宏定义管理UUID：

#define ENV_SERVICE_UUID "C3F11000-0000-1000-8000-00805F9B34FB" #define TEMP_CHAR_UUID "00002A6E-0000-1000-8000-00805F9B34FB" #define HUMIDITY_CHAR_UUID "C3F11001-0000-1000-8000-00805F9B34FB" BLEService envService(ENV_SERVICE_UUID);

这样修改时只需调整一处。曾经因为手误写错一个字符，调试了两天才发现UUID不匹配的问题。

4. 完整实现流程与避坑指南

4.1 设备端固件开发步骤

以ESP32为例，完整流程如下：

初始化BLE服务

BLEDevice::init("EnvSensor"); BLEServer *pServer = BLEDevice::createServer(); BLEService *pService = pServer->createService(ENV_SERVICE_UUID);

添加特征并设置回调

BLECharacteristic *pChar = pService->createCharacteristic( TEMP_CHAR_UUID, BLERead | BLENotify ); pChar->setValue(0.0f); // 初始值 // 写入回调示例 class Callbacks: public BLECharacteristicCallbacks { void onWrite(BLECharacteristic *pChar) { uint8_t* data = pChar->getData(); // 处理配置数据 } }; pChar->setCallbacks(new Callbacks());

启动服务并广播

pService->start(); BLEAdvertising *pAdvertising = pServer->getAdvertising(); pAdvertising->start();

常见问题排查：

手机搜不到设备：检查广播间隔（建议20-100ms）
连接频繁断开：增大MTU大小（ESP32默认23字节）
数据传输错误：检查特征值的字节序

4.2 手机端开发关键代码

Android端的核心操作：

// 发现特征后设置通知 fun enableNotification(characteristic: BluetoothGattCharacteristic) { gatt?.setCharacteristicNotification(characteristic, true) val descriptor = characteristic.getDescriptor(CLIENT_CHARACTERISTIC_CONFIG_UUID) descriptor.value = BluetoothGattDescriptor.ENABLE_NOTIFICATION_VALUE gatt?.writeDescriptor(descriptor) } // 接收通知数据 override fun onCharacteristicChanged( gatt: BluetoothGatt, characteristic: BluetoothGattCharacteristic ) { when(characteristic.uuid) { TEMP_CHAR_UUID -> { val temp = characteristic.getFloatValue(BluetoothGattCharacteristic.FORMAT_FLOAT, 0) updateUI(temp) } } }

iOS端需要特别注意：