1. 理解UUID：公有与私有的本质区别
在BLE（蓝牙低功耗）开发中，UUID（通用唯一标识符）是服务与特性的核心标识。就像现实生活中的身份证系统，UUID也分为"公有"和"私有"两种类型，它们在使用场景和实现方式上有着根本性的差异。
公有UUID相当于官方发行的标准身份证件。它们由蓝牙技术联盟（SIG）统一分配管理，具有全球唯一性。例如电池服务（Battery Service）的标准UUID是0x180F，任何遵循蓝牙规范的设备都能识别这个标识符。使用公有UUID时，我们只需要指定16位的短代码，协议栈会自动将其映射到完整的128位UUID。
私有UUID则像是企业自制的员工工牌。当我们需要实现自定义服务时，必须首先定义一个128位的基础UUID（通常采用厂商特定的格式），然后在此基础上派生16位的服务UUID和特性UUID。这就好比先设计工牌的模板（基础UUID），再为不同部门和员工分配工号（短UUID）。
关键区别：公有UUID直接使用16位短代码，私有UUID需要先注册128位基础UUID模板。
2. UUID的层级结构解析
2.1 基础UUID：服务的DNA
基础UUID是128位的唯一标识符，通常采用以下格式：
code复制xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
对于私有服务，我们需要先定义这样一个基础UUID。例如Nordic的LED按钮服务（LBS）可能使用：
c复制#define LBS_UUID_BASE {0x23,0xD1,0xBC,0xEA,0x5F,0x78,0x23,0x15,0xDE,0xEF,0x12,0x12,0x00,0x00,0x00,0x00}
这个"模板"将被协议栈用于后续所有相关UUID的生成。
2.2 服务UUID：功能模块的身份证
服务UUID标识具体的功能模块。在公有服务中，它直接对应蓝牙规范定义的16位值：
c复制#define BLE_UUID_BATTERY_SERVICE 0x180F // 电池服务
而私有服务的服务UUID则是基于基础UUID派生的16位值：
c复制#define LBS_UUID_SERVICE 0x1523 // 自定义LED服务
2.3 特性UUID：具体功能的门牌号
特性UUID标识服务中的具体属性或功能。公有特性如电池电量：
c复制#define BLE_UUID_BATTERY_LEVEL_CHAR 0x2A19
私有特性则同样基于基础UUID：
c复制#define LBS_UUID_LED_CHAR 0x1525 // LED控制特性
3. 公有UUID的配置实践
3.1 公有服务初始化
配置公有服务时，我们只需要指定16位的服务UUID：
c复制ble_uuid_t ble_uuid;
BLE_UUID_BLE_ASSIGN(ble_uuid, BLE_UUID_BATTERY_SERVICE); // 0x180F
这里的关键点：
- 直接使用预定义的16位UUID
- 不需要显式指定基础UUID
- 协议栈内部已经预置了标准UUID模板
3.2 公有特性添加
添加公有特性时同样简洁：
c复制static ret_code_t battery_level_char_add(ble_bas_t * p_bas) {
ble_gatts_char_md_t char_md = {0};
ble_gatts_attr_md_t attr_md = {0};
ble_gatts_attr_t attr_char_value = {0};
// 特性UUID直接使用16位值
ble_uuid_t uuid = {BLE_UUID_BATTERY_LEVEL_CHAR, BLE_UUID_TYPE_BLE};
// ...其他参数配置
return sd_ble_gatts_characteristic_add(p_bas->service_handle,
&char_md,
&attr_char_value,
&p_bas->battery_level_handles);
}
4. 私有UUID的完整实现流程
4.1 基础UUID定义与注册
私有服务需要先定义并注册128位基础UUID：
c复制// 1. 定义基础UUID
ble_uuid128_t base_uuid = {LBS_UUID_BASE};
// 2. 注册到协议栈
uint8_t uuid_type;
sd_ble_uuid_vs_add(&base_uuid, &uuid_type);
这个操作相当于告诉协议栈："后续所有使用这个uuid_type的16位UUID，都需要加上我定义的前缀"。
4.2 私有服务声明
使用注册的uuid_type来声明服务：
c复制ble_uuid_t service_uuid;
service_uuid.uuid = LBS_UUID_SERVICE; // 16位服务ID
service_uuid.type = uuid_type; // 关联到注册的基础UUID
sd_ble_gatts_service_add(BLE_GATTS_SRVC_TYPE_PRIMARY,
&service_uuid,
&p_lbs->service_handle);
4.3 私有特性实现
添加特性时同样需要指定uuid_type：
c复制ble_uuid_t char_uuid;
char_uuid.uuid = LBS_UUID_LED_CHAR; // 16位特性ID
char_uuid.type = uuid_type; // 使用相同的基础UUID
ble_gatts_char_md_t char_md = {0};
ble_gatts_attr_md_t attr_md = {0};
ble_gatts_attr_t attr_char_value = {0};
// ...配置其他参数
sd_ble_gatts_characteristic_add(p_lbs->service_handle,
&char_md,
&attr_char_value,
&p_lbs->led_char_handles);
5. 关键区别与选择策略
5.1 内存占用对比
| 类型 | 存储需求 | 协议栈开销 |
|---|---|---|
| 公有UUID | 仅需存储16位短代码 | 低 |
| 私有UUID | 需存储128位基础UUID+短代码 | 中 |
5.2 使用场景建议
选择公有UUID当：
- 实现标准蓝牙服务（如电池、设备信息）
- 需要与其他厂商设备互操作
- 希望最小化内存占用
选择私有UUID当：
- 开发厂商特定功能
- 需要完全控制服务架构
- 不要求与其他设备兼容
5.3 性能考量
- 公有UUID的查找速度更快，因为协议栈有优化
- 私有UUID会增加约10-15%的协议栈处理开销
- 广播包中使用短UUID可以节省空中传输时间
6. 实战经验与避坑指南
6.1 常见错误排查
问题1：服务无法被发现
- 检查uuid_type是否正确传递
- 确认sd_ble_uuid_vs_add返回值是否为NRF_SUCCESS
- 验证基础UUID是否正确定义
问题2：特性读写失败
- 确保特性UUID的type字段与服务一致
- 检查GATT表是否正确定义了权限
- 使用nRF Connect等工具验证原始数据
6.2 优化技巧
- UUID布局设计：
c复制// 基础UUID模板
#define BASE_UUID {0x23,0xD1,0xBC,0xEA,0x5F,0x78,0x23,0x15,0xDE,0xEF,0x12,0x12,0x00,0x00,0x00,0x00}
// 服务UUID从0x1500开始
#define SERVICE_A 0x1500
#define CHAR_A1 0x1501
#define CHAR_A2 0x1502
// 服务B从0x1600开始
#define SERVICE_B 0x1600
#define CHAR_B1 0x1601
这种布局便于维护和扩展。
- 内存管理：
- 集中注册所有基础UUID在初始化阶段
- 对不常用的私有服务考虑动态注册/注销
- 使用const修饰符节省RAM
- 调试技巧：
c复制// 打印UUID信息
void print_uuid(ble_uuid_t *uuid) {
if(uuid->type == BLE_UUID_TYPE_BLE) {
printf("Public UUID: 0x%04X\n", uuid->uuid);
} else {
printf("Private UUID(type=%d): 0x%04X\n", uuid->type, uuid->uuid);
}
}
7. 进阶应用：混合使用策略
在实际项目中，我们经常需要混合使用公有和私有UUID。例如智能手环可能同时包含：
- 标准电池服务（公有 0x180F）
- 标准设备信息服务（公有 0x180A）
- 自定义运动数据服务（私有）
- 自定义配置服务（私有）
实现要点：
- 先初始化所有公有服务
- 再按需注册私有基础UUID
- 为每个服务明确区分uuid_type
- 在GATT表中合理排序服务（标准服务通常放在前面）
示例代码结构：
c复制void services_init(void) {
// 1. 初始化公有服务
battery_service_init();
device_info_service_init();
// 2. 注册私有基础UUID
ble_uuid128_t base_uuid = {CUSTOM_UUID_BASE};
uint8_t custom_uuid_type;
sd_ble_uuid_vs_add(&base_uuid, &custom_uuid_type);
// 3. 初始化私有服务
motion_service_init(custom_uuid_type);
config_service_init(custom_uuid_type);
}
通过合理规划UUID架构，可以在保证兼容性的同时实现丰富的自定义功能。在实际项目中，我通常会绘制一张UUID映射表，明确每个服务的类型、UUID值和功能描述，这在后期维护和团队协作中非常有价值。