XMOS EQ HID 通信协议规范¶

协议概述 ¶

一、协议基础规范 ¶

1.1 底层通信协议¶

基于USB HID (Human Interface Device) 协议

1.2 HID设备识别¶

1.3 通信机制¶

1.4 数据包结构¶

二、协议命令集 ¶

2.1 命令分类概览¶

2.1.1 命令头定义¶

2.2 详细命令格式¶

2.2.1 切换 EQ 模式（0x8A）¶

功能说明: 切换当前的 EQ 模式

请求格式（64 字节）:

2.2.2 获取当前 EQ 模式信息（0x8B）¶

功能说明: 获取当前模式值、整体增益与模式名称

请求格式（64 字节）:

响应格式（64 字节）:

使用说明:

• 发送 mode = 0xFF 时，返回当前激活的 EQ 模式信息
• 发送 mode = 0-9 时，返回指定模式的增益与名称（不切换当前模式）

2.2.3 设置模式整体增益和名称（0x8C）¶

功能说明: 设置目标模式的整体增益和名称

请求格式（64 字节）:

2.2.4 设置 EQ 参数（0x8D）¶

功能说明: 发送单个滤波器的参数

请求格式（64 字节）:

滤波器类型码:

数值格式说明:

2.2.5 读取 EQ 参数（0x8E）¶

功能说明: 读取指定滤波器的参数

请求格式（64 字节）:

响应格式（64 字节）:

2.2.6 获取设备信息（0x8F）¶

功能说明: 获取设备的基本标识信息

请求格式（64 字节）:

响应格式（64 字节）:

2.2.7 复位 EQ 参数（0x90）¶

功能说明: 复位指定模式或全部模式的 EQ 参数

请求格式（64 字节）:

响应格式（64 字节）:

2.2.8 获取 EQ 模式数量信息（0x91）¶

功能说明: 获取 EQ 模式总数与预定义模式数量（不包含禁用模式）

请求格式（64 字节）:

响应格式（64 字节）:

2.2.9 设置并保存 EQ 模式（0x92）¶

功能说明: 设置当前 EQ 模式并保存到 Flash，开机时自动恢复

请求格式（64 字节）:

响应格式（64 字节）:

2.2.10 设置音量级别（0x93）¶

功能说明: 设置设备输出音量级别

请求格式（64 字节）:

参数说明:

• 音量级别范围：0-60（共61级）
• 0：最小音量（约 -127.5dB）
• 60：最大音量（0dB）

2.2.11 获取音量级别（0x94）¶

功能说明: 读取设备当前音量级别

请求格式（64 字节）:

响应格式（64 字节）:

2.2.12 获取 LED 信息（0x95）¶

功能说明: 读取 LED 索引与 LED 名称

请求格式（64 字节）:

响应格式（64 字节）:

2.2.13 设置 LED 开关（0x96）¶

功能说明: 设置 LED 开关状态

请求格式（64 字节）:

响应格式（64 字节）:

2.2.14 获取 LED 开关状态（0x97）¶

功能说明: 读取 LED 开关状态

请求格式（64 字节）:

响应格式（64 字节）:

2.2.15 获取 LED 状态（0x98）¶

功能说明: 读取 LED 的 RGB 颜色与显示状态

请求格式（64 字节）:

响应格式（64 字节）:

2.2.16 获取 LED 总数（0x99）¶

功能说明: 读取设备支持的 LED 总数

请求格式（64 字节）:

响应格式（64 字节）:

2.2.17 获取 UAC 模式信息（0x9A）¶

功能说明: 读取 UAC 模式数量与名称列表

请求格式（64 字节）:

响应格式（64 字节）:

2.2.18 设置 UAC 模式（0x9B）¶

功能说明: 设置 UAC 模式（UAC1.0/UAC2.0）

请求格式（64 字节）:

设备端处理:

• 注意：设备重启后不会返回响应

2.2.19 获取当前 UAC 模式（0x9C）¶

功能说明: 读取当前 UAC 模式与名称

请求格式（64 字节）:

响应格式（64 字节）:

2.2.20 设置 EQ 使能开关（0x9D）¶

功能说明: 设置 EQ 使能开关（启用/禁用）

请求格式（64 字节）:

响应格式（64 字节）:

2.2.21 获取 EQ 使能开关（0x9E）¶

功能说明: 读取 EQ 使能开关状态

请求格式（64 字节）:

响应格式（64 字节）:

2.2.22 获取采样率与格式（0x9F）¶

功能说明: 读取当前采样率与 DSD 模式

请求格式（64 字节）:

响应格式（64 字节）:

自动上报机制:

• 设备在采样率或 DSD 模式发生变化时，可自动上报对应的 0x9F 响应数据包

2.2.23 设置增益模式（0xA0）¶

功能说明: 设置增益模式

请求格式（64 字节）:

2.2.24 获取增益模式（0xA1）¶

功能说明: 读取设备当前增益模式

请求格式（64 字节）:

响应格式（64 字节）:

2.2.25 设置滤波器模式（0xA2）¶

功能说明: 设置滤波器模式（0-7，共8种）

请求格式（64 字节）:

滤波器模式值定义:

• 0: Minimum Phase filter (default)
• 1: Linear Phase Apodizing Fast Roll-off filter
• 2: Linear phase fast roll-off filter
• 3: Linear Phase Fast Roll-off low-ripple filter
• 4: Linear phase slow roll-off filter
• 5: Minimum phase fast roll-off filter
• 6: Minimum phase slow roll-off filter
• 7: Minimum Phase Fast Roll-Off Low Dispersion

2.2.26 获取滤波器模式（0xA3）¶

功能说明: 读取设备当前滤波器模式

请求格式（64 字节）:

响应格式（64 字节）:

2.2.27 设置游戏模式（0xA4）¶

功能说明: 设置游戏模式

请求格式（64 字节）:

2.2.28 获取游戏模式（0xA5）¶

功能说明: 读取设备当前游戏模式

请求格式（64 字节）:

响应格式（64 字节）:

2.2.29 获取固件版本号（0xA6）¶

功能说明: 读取设备固件版本号（BCD 格式）

请求格式（64 字节）:

响应格式（64 字节）:

版本号格式说明:

• 版本号采用 BCD（Binary Coded Decimal）格式
• 例如：0x01 0x00 0x0C 表示版本 1.0.12

2.2.30 发送 EX3D 命令（0xB0）¶

功能说明: 发送 EX3D 设置命令，封装所有 EX3D SET 命令

请求格式（64 字节）:

EX3D 命令码说明:

• 基础命令码范围: 0x80-0x94
• SET 命令格式: 基础命令码 & ~0x0100（清除第 9 位）
• 支持的 SET 命令：
• 0x81: CMD_OPEN（打开 EX3D）
• 0x82: CMD_ONOFF（设置 EX3D 开关）
• 0x83: CMD_ANGLE（设置角度）
• 0x84: CMD_SOUND_FIELD（设置声场模式）
• 0x85: CMD_MUTE（设置静音）
• 0x86: CMD_ON_GAIN（设置开启增益）
• 0x87: CMD_LMT_THRESHOLD（设置限制器阈值）
• 0x88: CMD_UPMIX（设置上混）
• 0x89: CMD_LFE（设置 LFE 增益）
• 0x8A: CMD_OFF_GAIN（设置关闭增益）
• 0x8E: CMD_LMT_ATTACKK_TIME（设置限制器攻击时间）
• 0x8F: CMD_LMT_RELEASE_TIME（设置限制器释放时间）
• 0x90: CMD_TEST_CANCEL（取消测试）
• 0x91: CMD_TEST_STEP（测试步骤）
• 0x92: CMD_TEST_ROTATE（测试旋转）
• 0x93: CMD_EXPAND_GAIN（设置扩展增益）
• 0x94: CMD_REDUCE_GAIN（设置减少增益）

设备端处理:

• 解析 EX3D 命令码，提取基础命令码和参数
• 调用相应的 EX3D 处理函数（hid_receive_task_in_c）
• 根据命令类型执行相应的设置操作

响应格式（64 字节）:

使用说明:

• 该命令用于统一封装所有 EX3D 设置命令
• 参数格式与原始 EX3D 协议保持一致
• 详细的 EX3D 命令说明请参考 ex3d_protocol.md 文档

2.2.31 读取 EX3D 命令（0xB1）¶

功能说明: 读取 EX3D 参数，封装所有 EX3D GET 命令

请求格式（64 字节）:

EX3D 命令码说明:

• 基础命令码范围: 0x80-0x94
• GET 命令格式: 基础命令码 | 0x0100（设置第 9 位）
• 支持的 GET 命令：
• 0x180: CMD_CH_NUM（获取通道数量）
• 0x182: CMD_ONOFF（获取 EX3D 开关）
• 0x183: CMD_ANGLE（获取角度）
• 0x184: CMD_SOUND_FIELD（获取声场模式）
• 0x185: CMD_MUTE（获取静音）
• 0x186: CMD_ON_GAIN（获取开启增益）
• 0x187: CMD_LMT_THRESHOLD（获取限制器阈值）
• 0x188: CMD_UPMIX（获取上混）
• 0x189: CMD_LFE（获取 LFE 增益）
• 0x18A: CMD_OFF_GAIN（获取关闭增益）
• 0x18B: CMD_SOUND_FIELD_NUM（获取声场模式数量）
• 0x18C: CMD_SOUND_FIELD_NAME（获取声场模式名称）
• 0x18D: CMD_LEVEL（获取电平）
• 0x18E: CMD_LMT_ATTACKK_TIME（获取限制器攻击时间）
• 0x18F: CMD_LMT_RELEASE_TIME（获取限制器释放时间）
• 0x193: CMD_EXPAND_GAIN（获取扩展增益）
• 0x194: CMD_REDUCE_GAIN（获取减少增益）

设备端处理:

• 解析 EX3D 命令码，提取基础命令码和参数
• 调用相应的 EX3D 处理函数（hid_receive_task_in_c）
• 返回当前参数值

响应格式（64 字节）:

返回值说明:

• 返回值数量和格式取决于具体的 EX3D 命令
• 单值命令：返回 1 个 uint32 值
• 多值命令（如角度、多通道数据）：返回多个 uint32 值
• 字符串命令（如声场名称）：先返回长度（uint32），然后返回字符串数据
• 详细的返回值格式请参考 ex3d_protocol.md 文档

使用说明:

• 该命令用于统一封装所有 EX3D 读取命令
• 参数格式与原始 EX3D 协议保持一致
• 详细的 EX3D 命令说明请参考 ex3d_protocol.md 文档

2.2.32 设置采样率升频（0x80）¶

功能说明: 设置设备采样率升频开关

请求格式（64 字节）:

参数说明:

• 升频状态：0=禁用升频，1=使能升频

返回值:

无直接返回值。如需确认升频状态，请使用 GET_UPSAMPLE (0x81) 命令读取。

2.2.33 获取采样率升频（0x81）¶

功能说明: 读取设备当前采样率升频状态

请求格式（64 字节）:

响应格式（64 字节）:

三、数据流程和时序 ¶

3.1 典型操作流程¶

3.1.1 模式切换流程¶

1. GUI发送SET_EQ_MODE命令 (0x8A)
2. 设备更新内部模式状态
3. GUI发送GET_EQ_MODE命令 (0x8B) 确认
4. 设备响应当前模式状态

3.1.2 参数设置流程¶

1. GUI发送SET_EQ_MODE命令切换到相应模式 (0x8A)
2. 逐个发送8个滤波器的命令 (0x8D)
3. 设备接收并更新内部参数缓存
4. 可选: 发送GET_EQ_PARAMS命令验证参数 (0x8E)

3.1.3 参数读取流程¶

1. GUI发送SET_EQ_MODE命令切换到相应模式 (0x8A)
2. GUI发送GET_EQ_PARAMS请求 (0x8E)
3. 设备准备响应数据
4. GUI读取响应

3.2 时序要求与约束¶

四、预设模式定义 ¶

4.1 模式分类¶

五、关键特性 ¶

5.1 设备端系数计算¶

• 主机只发送参数（freq/q/bw/gain）
• 设备端根据参数实时计算滤波器系数

5.2 参数格式¶

• 浮点参数：freq、q、bw、gain 使用 IEEE 754 float（小端序）
• 整体增益：int32（小端序，范围 -50dB ~ 0dB）

5.3 错误处理¶

• 数据包长度检查
• 同步头验证
• 参数范围检查
• 滤波器索引边界检查

5.4 模式管理¶

• 支持 EQ 模式切换与保存
• 模式切换后建议通过读取命令进行状态同步

六、注意事项 ¶

1. 时序要求: 发送参数后需要等待设备处理完成再发送下一条命令
2. 数据完整性: 所有8个滤波器的参数都需要发送，即使某些滤波器未使用
3. 模式同步: 设置模式后建议调用读取模式确保数据同步
4. 错误恢复: 通信失败时需要重新建立连接并重试
5. 参数验证: 设备端会验证参数范围，超出范围的值会被限制或拒绝

咨询反馈¶