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

三、数据流程和时序 ¶

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. 参数验证: 设备端会验证参数范围，超出范围的值会被限制或拒绝

咨询反馈¶