update hid

zh/docs/dev_doc/protocols/XMOS_EQ_HID_Protocol.md

@@ -102,6 +102,8 @@ search:
 | 0xA4 | SET_GAME_MODE | 设置游戏模式 | PC → 设备 |
 | 0xA5 | GET_GAME_MODE | 获取游戏模式 | PC ↔ 设备 |
 | 0xA6 | GET_FIRMWARE_VERSION | 获取固件版本号 | PC ↔ 设备 |
+| 0xA7 | SET_EQ_BAND_COUNT | 设置 EQ 段数 | PC → 设备 |
+| 0xA8 | GET_EQ_BAND_COUNT | 获取 EQ 段数 | PC ↔ 设备 |
 | 0xB0 | SET_EX3D_CMD | 发送 EX3D 命令（封装所有 EX3D SET 命令） | PC ↔ 设备 |
 | 0xB1 | GET_EX3D_CMD | 读取 EX3D 参数（封装所有 EX3D GET 命令） | PC ↔ 设备 |
 | 0x80 | SET_UPSAMPLE | 设置采样率升频开关 | PC → 设备 |
@@ -801,7 +803,60 @@ search:
 - 版本号采用 BCD（Binary Coded Decimal）格式
 - 例如：`0x01 0x00 0x0C` 表示版本 `1.0.12`
 
-#### 2.2.30 发送 EX3D 命令（0xB0）
+#### 2.2.30 设置 EQ 段数（0xA7）
+
+**功能说明**: 设置 EQ 段数，支持 8/16/24/32 段动态切换，控制参与处理的 DSP 核数
+
+**请求格式（64 字节）**:
+
+| 偏移 | 长度 | 字段名 | 描述 |
+|:----:|:----:|:------:|:----:|
+| 0 | 1 | report_id | 固定为 0x01 |
+| 1 | 1 | sync_header | 同步头: 0x77 |
+| 2 | 1 | cmd_header | 命令头: 0xA7 |
+| 3 | 1 | band_count | EQ 段数（8=仅 Core0, 16=Core0+Core1, 24=Core0+Core1+Core2, 32=全部 4 核） |
+| 4-63 | 60 | reserved | 保留字段（填充0） |
+
+**设备端处理**:
+
+- 仅接受 8、16、24、32 四个有效值，其他值拒绝
+- 设置后保存到 Flash（独立文件 eq_band_cnt），开机时自动恢复
+
+**响应格式（64 字节）**:
+
+| 偏移 | 长度 | 字段名 | 描述 |
+|:----:|:----:|:------:|:----:|
+| 0 | 1 | report_id | 固定为 0x01 |
+| 1 | 1 | sync_header | 同步头: 0x77 |
+| 2 | 1 | cmd_header | 命令头: 0xA7（回显） |
+| 3 | 1 | status | 状态码（0x00=成功, 0x01=失败） |
+| 4 | 1 | band_count | 当前 EQ 段数（8/16/24/32） |
+| 5-63 | 59 | reserved | 保留字段（填充0） |
+
+#### 2.2.31 获取 EQ 段数（0xA8）
+
+**功能说明**: 读取当前 EQ 段数
+
+**请求格式（64 字节）**:
+
+| 偏移 | 长度 | 字段名 | 描述 |
+|:----:|:----:|:------:|:----:|
+| 0 | 1 | report_id | 固定为 0x01 |
+| 1 | 1 | sync_header | 同步头: 0x77 |
+| 2 | 1 | cmd_header | 命令头: 0xA8 |
+| 3-63 | 61 | reserved | 保留字段（填充0） |
+
+**响应格式（64 字节）**:
+
+| 偏移 | 长度 | 字段名 | 描述 |
+|:----:|:----:|:------:|:----:|
+| 0 | 1 | report_id | 固定为 0x01 |
+| 1 | 1 | sync_header | 同步头: 0x77 |
+| 2 | 1 | cmd_header | 命令头: 0xA8（回显） |
+| 3 | 1 | band_count | 当前 EQ 段数（8/16/24/32） |
+| 4-63 | 60 | reserved | 保留字段（填充0） |
+
+#### 2.2.32 发送 EX3D 命令（0xB0）
 
 **功能说明**: 发送 EX3D 设置命令，封装所有 EX3D SET 命令
 
@@ -865,7 +920,7 @@ search:
 - 参数格式与原始 EX3D 协议保持一致
 - 详细的 EX3D 命令说明请参考 ex3d_protocol.md 文档
 
-#### 2.2.31 读取 EX3D 命令（0xB1）
+#### 2.2.33 读取 EX3D 命令（0xB1）
 
 **功能说明**: 读取 EX3D 参数，封装所有 EX3D GET 命令
 
@@ -936,7 +991,7 @@ search:
 - 参数格式与原始 EX3D 协议保持一致
 - 详细的 EX3D 命令说明请参考 ex3d_protocol.md 文档
 
-#### 2.2.32 设置采样率升频（0x80）
+#### 2.2.34 设置采样率升频（0x80）
 
 **功能说明**: 设置设备采样率升频开关
 
@@ -958,7 +1013,7 @@ search:
 
 无直接返回值。如需确认升频状态，请使用 GET_UPSAMPLE (0x81) 命令读取。
 
-#### 2.2.33 获取采样率升频（0x81）
+#### 2.2.35 获取采样率升频（0x81）
 
 **功能说明**: 读取设备当前采样率升频状态