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	`0x3434`
属性	Read、Write
初始值	`device_status_ok`
缓冲区大小	32 字节
合法写入长度	1～31 字节

WS53 不会把远端数据直接当作无界 C 字符串使用。写入前会检查 Handle 和长度，清空本地缓冲区后再复制数据，从而为字符串结束符保留空间。

异常情况	返回状态
读取或写入错误 Handle	`GATT_STATUS_INVALID_HANDLE`
写入长度为 0 或大于等于 32 字节	`GATT_STATUS_INVALID_ATTRIBUTE_VALUE_LENGTH`
本地复制失败	`GATT_STATUS_UNLIKELY_ERROR`

广播状态字节

写入成功后，案例会同步更新广播 Service Data 中的状态字节：

状态字节	Data 当前状态
`0x00`	当前值为默认值 `device_status_ok`
`0x01`	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 Characteristic 0x3434。
读取 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 复位后恢复默认值。