1. 从“点灯”到“对话”BLE Hello World的进阶意义上一篇文章我们聊了如何用一块开发板和一个手机App实现最简单的BLE“点灯”功能。那感觉就像是第一次让两个设备握上了手知道了彼此的存在。但握手之后呢总不能一直傻站着吧真正的交流还没开始。所以这个“Part 2 - Hello World”在我看来才是BLE项目从玩具走向工具的关键一步。它不再是单向的指令发射而是双向的、有来有回的“对话”。这个“Hello World”要做什么核心就一件事让我们的BLE设备Peripheral外设不仅能被手机Central中心设备发现和连接还能主动向手机“说话”发送数据。比如一个温湿度传感器周期性地报告读数或者一个按键被按下时主动通知手机。这背后依赖的就是BLE通信中一个极其核心的机制通知Notification。很多新手会觉得我手机去读一下设备的数据不就行了但在实际应用中尤其是传感器类设备由设备主动、及时地推送数据远比让手机频繁地去“问”读要高效、省电得多。这个项目就是带你亲手打通这条主动汇报的通道。2. 硬件选型与工程框架再审视在开始写代码前我们得再盘一盘手里的家伙事儿因为“Part 2”对硬件和软件框架的要求比“Part 1”稍微高那么一点。2.1 开发板的核心要求硬件定时器与低功耗考量如果你用的还是Part 1里那款最基础的、只有GPIO和BLE广播功能的板子可能会在这里卡住。实现周期性的数据发送比如每秒发送一次模拟的“Hello World”字符串需要一个可靠的定时器。虽然用软件延时循环也能模拟但那会严重阻塞主线程影响BLE协议栈的正常运行导致连接不稳定甚至断开。因此一块合格的、用于本项目的开发板应该具备硬件定时器Hardware Timer用于产生精确的、不阻塞主循环的定时中断在中断服务程序里安全地触发数据更新和发送。更完善的BLE协议栈支持需要支持GATT服务器GATT Server的完整功能特别是“通知”Notify和“指示”Indicate特性的配置与发送。像ESP32、nRF52系列、STM32WB等主流芯片的原生SDK都对此有良好支持。以常见的ESP32-DevKitC为例其内置的ESP-IDF SDK提供了丰富的定时器API和完整的GATT服务器示例是我们实现本项目的理想选择。2.2 软件工程结构的清晰化在Part 1我们可能把所有代码都塞进了main.c。到了Part 2为了可读性和可维护性建议对工程结构做简单划分your_ble_project/ ├── main/ │ ├── main.c // 主循环、硬件初始化 │ ├── ble_app.c // BLE应用层逻辑服务、特性定义、事件处理 │ └── ble_app.h ├── components/ (可选) // 如果有自定义组件 └── Makefile / CMakeLists.txt重点在于将BLE相关的初始化和业务逻辑特别是GATT表构建和事件回调函数剥离到独立的ble_app.c/h文件中。这样main.c主要负责启动调度器、初始化硬件如定时器而ble_app.c则专心处理BLE的连接、数据发送等。3. 构建GATT服务定义“对话”的协议BLE设备之间的所有数据交换都基于一个叫做GATT通用属性协议的“语言规则”。而服务Service和特性Characteristic就是这种语言里的基本词汇和句子。3.1 设计我们的“Hello World”服务我们需要创建一个自定义的GATT服务其中包含一个用于发送“Hello World”数据的特性。服务UUID可以自定义一个128位的UUID例如0xABCD1234-5678-90EF-1234-567890ABCDEF。为了简化在测试阶段也可以使用一个标准的“用户数据”服务UUID但自定义UUID更能体现项目特点。特性Characteristic这是数据的载体。我们需要定义一个特性比如叫HELLO_WORLD_CHAR_UUID。特性的属性Properties这是关键为了能让设备主动通知手机这个特性的属性必须包含NOTIFY。完整的属性可能是ESP_GATT_CHAR_PROP_BIT_NOTIFY在ESP-IDF中。如果还需要手机向设备写数据本项目不需要则可以加上WRITE。3.2 在代码中实现GATT表以下以ESP-IDF框架为例展示如何定义这个服务结构。这是一个声明式的配置告诉BLE协议栈我们有哪些“能力”。// ble_app.h #define GATTS_TAG BLE_HELLO_WORLD // 自定义服务UUID (128-bit格式可自行修改) #define HELLO_WORLD_SERVICE_UUID 0xABCD, 0x1234, 0x5678, 0x90EF, 0x1234, 0x5678, 0x90AB, 0xCDEF // 自定义特性UUID #define HELLO_WORLD_CHAR_UUID 0x1234, 0x5678, 0x90AB, 0xCDEF, 0x1234, 0x5678, 0x90AB, 0xCDEF // 特性的值句柄用于后续发送数据 static uint16_t hello_world_char_handle; // GATT数据库服务与特性的定义表 static const esp_gatts_attr_db_t gatt_db[HRS_IDX_NB] { // 服务声明 [IDX_SVC] {{ESP_GATT_AUTO_RSP}, {ESP_UUID_LEN_16, (uint8_t *)primary_service_uuid, ESP_GATT_PERM_READ, sizeof(uint16_t), sizeof(HELLO_WORLD_SERVICE_UUID), (uint8_t *)HELLO_WORLD_SERVICE_UUID}}, // “Hello World”特性声明 [IDX_CHAR] {{ESP_GATT_AUTO_RSP}, {ESP_UUID_LEN_16, (uint8_t *)character_declaration_uuid, ESP_GATT_PERM_READ, CHAR_DECLARATION_SIZE, CHAR_DECLARATION_SIZE, (uint8_t *)char_prop_notify}}, // “Hello World”特性的值 [IDX_CHAR_VAL] {{ESP_GATT_AUTO_RSP}, {ESP_UUID_LEN_128, (uint8_t *)HELLO_WORLD_CHAR_UUID, ESP_GATT_PERM_READ, sizeof(hello_world_value), sizeof(hello_world_value), (uint8_t *)hello_world_value}}, };这段代码定义了一个简单的GATT表一个服务声明下面挂载了一个特性。该特性的属性被设置为NOTIFY并且我们预留了一个值句柄hello_world_char_handle和存储值的数组hello_world_value。注意这里使用了“自动响应”ESP_GATT_AUTO_RSP。对于简单的读写操作这很方便。但在生产环境中对于WRITE操作你可能需要手动响应ESP_GATT_RSP_BY_APP以便进行数据验证或处理。4. 核心机制通知Notification的启用与发送定义了“能力”接下来就要实现“动作”。通知机制是一个“订阅-发布”模型。4.1 客户端特性配置描述符CCCD是关键手机客户端想要接收通知必须先在设备服务器上“订阅”。这个订阅动作本质上是向一个特殊的描述符——客户端特性配置描述符Client Characteristic Configuration Descriptor, CCCD——写入一个值。写入0x0001表示启用通知Notification。写入0x0002表示启用指示Indicate带确认的通知。写入0x0000表示取消订阅。在我们的GATT表定义中通常SDK会自动为具有NOTIFY属性的特性添加这个CCCD描述符。我们不需要手动定义它但需要在代码中处理对它的写操作。4.2 在事件回调中处理订阅BLE应用是事件驱动的。当手机App如nRF Connect点击了那个小小的“通知订阅按钮”通常是一个向下的箭头图标时我们的设备会收到一个ESP_GATTS_WRITE_EVT事件。我们需要在事件回调函数中识别出这是对CCCD的写操作并记录订阅状态。static void gatts_event_handler(esp_gatts_cb_event_t event, esp_gatt_if_t gatts_if, esp_ble_gatts_cb_param_t *param) { switch (event) { case ESP_GATTS_WRITE_EVT: { // 判断是否是CCCD写入 if (param-write.handle hello_world_char_handle 1) { // CCCD句柄通常是特性值句柄1 uint16_t cccd_value param-write.value[0] | (param-write.value[1] 8); if (cccd_value 0x0001) { ESP_LOGI(GATTS_TAG, Notification enabled by client.); is_notification_enabled true; // 设置一个全局标志位 } else if (cccd_value 0x0000) { ESP_LOGI(GATTS_TAG, Notification disabled by client.); is_notification_enabled false; } } // 其他写事件处理... break; } // 处理其他事件如连接、断开等... } }这里我们通过判断写入的句柄是否是CCCD的句柄特性值句柄1是一个常见约定具体需参考SDK文档来得知手机是否订阅了通知。我们用is_notification_enabled这个全局变量来记录这个状态。4.3 定时发送“Hello World”数据现在我们结合硬件定时器在定时器中断中检查订阅状态并发送数据。// 定时器中断服务程序ISR static void IRAM_ATTR timer_isr(void *arg) { // 1. 清除定时器中断标志 timer_group_clr_intr_status_in_isr(TIMER_GROUP_0, TIMER_0); // 2. 通知主任务有事件发生通过队列、信号量等 BaseType_t xHigherPriorityTaskWoken pdFALSE; xTimerPendCallbackSendFromISR(timer_callback_task, xHigherPriorityTaskWoken); // 假设我们使用一个回调任务 // 3. 如果需要进行任务切换 if (xHigherPriorityTaskWoken) { portYIELD_FROM_ISR(); } } // 在定时器回调任务或主循环中 void check_and_send_notification(void) { if (is_notification_enabled is_connected) { // 确保已连接且已订阅 // 准备数据例如一个递增的计数和“Hello World” static uint8_t count 0; char message[20]; int len snprintf(message, sizeof(message), Hello %d, count); // 发送通知 esp_ble_gatts_send_indicate(gatts_if, conn_id, hello_world_char_handle, len, (uint8_t *)message, false); // 最后一个参数为false表示Notification为true表示Indication ESP_LOGI(GATTS_TAG, Sent notification: %s, message); } }关键点解析中断内不处理复杂逻辑在定时器中断服务程序ISR里只做最必要的操作清中断、发通知将实际的业务逻辑组包、发送放到一个任务或主循环中执行。这是保持系统稳定的黄金法则。esp_ble_gatts_send_indicate这个API用于发送通知或指示。注意最后一个参数false代表发送的是通知设备发送后不关心对方是否收到true代表指示设备会等待对方的确认更可靠但开销稍大。对于“Hello World”这种非关键数据通知足矣。连接状态检查发送前务必检查is_connected。尝试向一个已断开的连接发送数据会导致错误。5. 手机端验证不只是“看到”还要“收到”设备端代码写完并烧录后真正的考验在手机端。你需要一个能处理通知的BLE调试App。5.1 使用nRF Connect进行深度测试扫描与连接与Part 1一样扫描并找到你的设备连接。发现服务连接后App会自动发现并列出GATT表。你应该能看到你自定义的HELLO_WORLD_SERVICE和里面的那个特性。启用通知点击该特性右侧的“三个点”或向下箭头图标选择“启用通知”。这是最关键的一步此时你的设备日志应该打印出“Notification enabled by client.”。观察数据流如果一切正常你会在该特性的“日志”或“值”显示区域看到设备定时发送上来的“Hello 0”、“Hello 1”…… 字符串。数据是自动推送上来的你不需要手动点击“读”。5.2 常见问题与排查链路当你点击了“启用通知”但收不到数据时不要慌按照以下链路排查问题现象可能原因排查步骤点击“启用通知”无反应/设备无日志1. CCCD写入事件未正确处理。2. 特性属性未包含NOTIFY。3. 手机与设备连接已断开。1. 检查设备串口日志过滤WRITE_EVT确认是否收到CCCD写入句柄和值。2. 在nRF Connect中长按特性查看属性列表确认是否有Notify。3. 检查App连接状态图标。设备日志显示已启用通知但收不到数据1. 定时器未正确工作或未触发发送。2.is_connected标志为假。3. 发送API调用失败参数错误。1. 在定时器ISR里加一个GPIO翻转用示波器或逻辑分析仪看波形。2. 确保在ESP_GATTS_CONNECT_EVT和ESP_GATTS_DISCONNECT_EVT事件中正确更新is_connected。3. 检查esp_ble_gatts_send_indicate的返回值并打印错误码。收到一次数据后停止1. 数据发送后is_notification_enabled被意外重置。2. 定时器只触发了一次。1. 检查是否有其他代码如断开事件处理错误地修改了该标志。2. 确认定时器配置为自动重载Auto-reload模式。手机App闪退或断开连接1. 设备发送的数据长度超过特性声明的最大长度。2. 发送频率过高导致协议栈缓冲区溢出。1. 确保snprintf不会溢出message数组且发送长度len小于特性定义时的最大长度。2. 降低发送频率如改为每2秒一次BLE协议栈处理需要时间。5.3 一个真实的踩坑记录句柄偏移的玄学我在早期使用某款芯片的SDK时曾遇到一个诡异的问题通知能启用但发送总是失败返回无效句柄错误。折腾半天才发现问题出在句柄的分配上。那个SDK在创建服务时动态分配的句柄值并不是严格按照我们定义GATT表的顺序从0开始累加而是有一个基础的起始句柄。我错误地以为特性值句柄是hello_world_char_handle而CCCD句柄是hello_world_char_handle 1。解决方案不要假设句柄的数值关系。正确的做法是在ESP_GATTS_REG_EVT服务注册完成事件或ESP_GATTS_CREATE_EVT服务创建完成事件的回调中SDK会通过参数param-create.service_handle和param-create.char_handle等返回实际分配给你的各个属性的句柄。一定要用这些返回的句柄值存到你自己的全局变量里后续的读写、发送操作都基于这些“官方认证”的句柄。这是血泪教训。6. 功耗初探与优化方向实现了功能我们还得考虑现实问题——功耗。一个始终以最快速度广播和发送数据的BLE设备电池可能撑不过一天。6.1 连接参数协商BLE连接后中心设备和外设会协商一组“连接参数”主要包括连接间隔Connection Interval两次数据通信事件之间的时间。单位是1.25ms。范围通常是7.5ms到4s。间隔越长功耗越低但数据实时性越差。从机延迟Slave Latency允许外设从机跳过多少个连接事件而不必回应。用于进一步降低功耗。监督超时Supervision Timeout连接超时时间。在ESP-IDF中你可以在ESP_GATTS_CONNECT_EVT事件中调用esp_ble_gap_update_conn_params来向手机端建议一组更省电的参数。但最终决定权在手机中心设备手里。很多手机为了自身省电会倾向于使用较长的连接间隔。6.2 业务逻辑的功耗优化对于我们的“Hello World”项目可以做的优化降低发送频率如果不是必须每秒发送可以改为每5秒、10秒甚至更长。动态调整频率在check_and_send_notification函数中可以根据业务状态调整定时器周期。例如当数据变化缓慢时自动延长发送间隔。在断开连接后停止定时器在ESP_GATTS_DISCONNECT_EVT事件中停止硬件定时器彻底杜绝不必要的功耗开销。等到下次连接时再启动。case ESP_GATTS_DISCONNECT_EVT: ESP_LOGI(GATTS_TAG, Disconnected, stop timer.); is_connected false; is_notification_enabled false; // 安全起见一并重置 timer_pause(timer_group, timer_idx); // 暂停定时器 break; case ESP_GATTS_CONNECT_EVT: ESP_LOGI(GATTS_TAG, Connected, start timer.); is_connected true; timer_start(timer_group, timer_idx); // 启动定时器 // 可以在这里发起连接参数更新请求 esp_ble_conn_update_params_t conn_params {...}; esp_ble_gap_update_conn_params(conn_params); break;7. 从“Hello World”走向真实项目这个能主动说话的“Hello World”项目已经具备了大多数BLE传感器应用的骨架。你可以很容易地将它改造成一个实用的设备环境传感器将snprintf(message, ...)里的内容替换为从I2C或SPI温湿度传感器如SHT30、DHT22读取的真实数据。遥控器/按键将定时发送改为事件驱动。配置一个GPIO引脚为中断模式当按键按下时在中断服务程序里通知主任务然后立即发送一个按键状态的通知。数据打包与协议不再发送简单的字符串而是定义一套二进制协议。例如用一个结构体来打包数据#pragma pack(push, 1) // 按1字节对齐避免填充字节 typedef struct { uint8_t type; // 数据类型如0x01温度0x02湿度 uint16_t value; // 数据值单位0.1摄氏度或0.1%RH uint32_t timestamp; // 时间戳 } sensor_data_t; #pragma pack(pop)发送时直接发送这个结构体的字节流。手机端App则需要按照同样的协议进行解析。这种方式效率更高也更专业。走到这一步你已经掌握了BLE外设开发中最核心的主动通信能力。下一步可以探索更复杂的多服务/多特性管理、安全配对绑定、大数据传输长特性、分包等主题。但无论如何这个能主动说“Hello World”的设备已经是一个真正意义上的、可交互的物联网节点了。
