Hello ReadWrite#
在 Hello Notify 的服务发现和订阅流程上,增加 Client 主动读取和写入 Characteristic。
本篇新增内容#
Data Characteristic 提供 Read、Write 属性和相应权限。
WS53 在读请求回调中返回当前值。
WS53 在写请求回调中校验 Handle 和长度,再更新 RAM (Random Access Memory) 中的值。
外部 Client 按实际 Value Handle 发起读写并处理响应状态。
连接、配对、服务发现、CCCD (Client Characteristic Configuration Descriptor) 和 Notification 流程请参考前两篇。本篇仍使用同一个 ble_hello 案例,不需要切换配置项。
三种交互方式#
方式 |
发起方 |
适用场景 |
|---|---|---|
Notification |
WS53 Server |
状态变化和周期数据推送 |
Read |
外部 Client |
查询版本、状态或当前配置 |
Write |
外部 Client |
下发参数、控制命令或配置 |
数据交互流程#
sequenceDiagram
participant C as External BLE Client
participant S as WS53 BLE Server
Note over C,S: 已完成连接、配对和服务发现
C->>S: Read Request(Data Value Handle)
S-->>C: Read Response(当前值)
C->>S: Write Request(新值)
S-->>C: Write Response(Status)
C->>S: Read Request(Data Value Handle)
S-->>C: Read Response(新值)
Data Characteristic#
项目 |
当前值 |
|---|---|
UUID |
|
属性 |
Read、Write |
初始值 |
|
缓冲区大小 |
32 字节 |
合法写入长度 |
1~31 字节 |
WS53 不会把远端数据直接当作无界 C 字符串使用。写入前会检查 Handle 和长度,清空本地缓冲区后再复制数据,从而为字符串结束符保留空间。
异常情况 |
返回状态 |
|---|---|
读取或写入错误 Handle |
|
写入长度为 0 或大于等于 32 字节 |
|
本地复制失败 |
|
广播状态字节#
写入成功后,案例会同步更新广播 Service Data 中的状态字节:
状态字节 |
Data 当前状态 |
|---|---|
|
当前值为默认值 |
|
RAM 中保存了其他写入值 |
状态字节只反映当前运行期间的 RAM 值。WS53 复位后,Data 恢复为默认值。
源码对应关系#
src/application/samples/bt/ble/ble_hello/
└── ble_hello_server/src/ble_hello_server.c
重点查看:
ble_hello_read_request_cb():校验 Handle 并返回当前 Data。ble_hello_write_request_cb():校验写入并更新 RAM 值。ble_hello_send_response():发送 GATT 读写响应。
操作与验证#
按照 Hello BLE 配置、编译、烧录并连接 WS53,然后执行:
发现 Service
0x3333和 Data Characteristic0x3434。读取 Data,确认返回
device_status_ok。向 Data 写入不超过 31 字节的新值,例如
new_config_value。再次读取 Data,确认返回新值。
尝试写入空数据或 32 字节数据,确认 WS53 拒绝更新。
WS53 正常输出:
[ble hello server] read response sent: value=device_status_ok
[ble hello server] property updated: new_config_value
[ble hello server] write response sent: success
该示例只在 RAM 中保存数据,不提供 NV (Non-Volatile) 持久化。只重连 Client 时可以读取当前值;WS53 复位后恢复默认值。