ftyyda/phaten-audio
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

update

Browse Source
This commit is contained in:
PhatenIoT-yan
2025-12-25 14:21:26 +08:00
parent ed34548c71
commit 00f42eab80
72 changed files with 2193 additions and 471 deletions
Download Patch File Download Diff File Expand all files Collapse all files

231
zh/docs/dev_doc/EQ_Protocols/EQ_HID_Protocol.md Normal file
View File

@@ -0,0 +1,231 @@
---
title: 免开发系列固件 EQ HID 控制协议与命令集
description: 适用于 免开发固件系列设备的 EQ HID 控制协议，包含报文结构、命令集与字段说明，用于模式切换、参数读写与设备信息获取。
keywords: EQ, HID, 控制协议, 命令集, USB HID, XU316,免开发固件, Phaten Audio
---
--8<-- "common/phaten_xmos_support_img.md"
# 免开发系列固件 EQ HID 控制协议与命令集
## 1. 协议基础规范
### 1.1 底层通信协议
基于 USB HID (Human Interface Device) 协议。
| 参数 | 值 |
| :--- | :--- |
| Report ID | 0x01 |
| 数据包大小 | 64 字节 |
| 传输方向 | 双向 (Host <-> Device) |
### 1.2 报文格式与数据传输
**通用报文格式**
所有命令和响应均遵循以下 Report 结构：
| 字段 | 字节数 | 说明 |
| :--- | :--- | :--- |
| Report ID | 1 | 固定为 `0x01` |
| 同步头 | 1 | 固定为 `0x77` (作为命令起始标识) |
| 命令码 | 1 | 指示具体的操作 (如 `0x8A`) |
| 数据区 | 61 | 具体的数据内容 (不足部分通常补0) |
**数据传输说明**
* **字节序**：所有多字节数据均采用 **小端模式 (Little Endian)** 传输。
* **浮点数**：遵循 IEEE 754 float 格式。
---
## 2. 协议命令集
### 2.1 命令分类概览
| 命令码 | 命令描述 | 发送方向 | 功能说明 |
| :--- | :--- | :--- | :--- |
| **0x8A** | SET_EQ_MODE | 主机→设备 | 切换当前的 EQ 模式 |
| **0x8B** | GET_EQ_MODE | 主机→设备 | 获取当前 EQ 模式信息 (模式号、增益、名称) |
| **0x8C** | SET_MODE_GAIN_AND_NAME | 主机→设备 | 设置指定模式的整体增益和名称 |
| **0x8D** | SET_EQ_PARAMS | 主机→设备 | 发送单个滤波器的参数 |
| **0x8E** | GET_EQ_PARAMS | 主机→设备 | 读取单个滤波器的参数 |
| **0x8F** | GET_DEVICE_INFO | 主机→设备 | 获取设备基础信息 (PID, VID, SN等) |
| **0x90** | RESET_EQ_PARAMS | 主机→设备 | 复位 EQ 参数 (恢复预设) |
---
## 3. 基础功能命令详解
### 3.1 切换 EQ 模式 (0x8A)
**主机发送**
| 字节位置 | 长度 | 内容 | 说明 |
| :--- | :--- | :--- | :--- |
| 0 | 1 | `0x01` | Report ID |
| 1 | 1 | `0x77` | 同步头 |
| 2 | 1 | `0x8A` | 命令码 |
| 3 | 1 | `Mode` | 模式值<br>0-5: 预设模式<br>6-8: 用户模式<br>9: Bypass |
| 4-63 | 60 | `Reserved` | 保留字节 (0x00) |
---
### 3.2 获取当前 EQ 模式信息 (0x8B)
**主机发送**
| 字节位置 | 长度 | 内容 | 说明 |
| :--- | :--- | :--- | :--- |
| 0 | 1 | `0x01` | Report ID |
| 1 | 1 | `0x77` | 同步头 |
| 2 | 1 | `0x8B` | 命令码 |
| 3-63 | 61 | `Reserved` | 保留字节 (0x00) |
**设备返回 (响应)**
| 字节位置 | 长度 | 内容 | 说明 |
| :--- | :--- | :--- | :--- |
| 0 | 1 | `0x01` | Report ID |
| 1 | 1 | `0x77` | 同步头1 |
| 2 | 1 | `0x8B` | 同步头2 (回响命令码) |
| 3 | 1 | `Mode` | 当前模式值 |
| 4-7 | 4 | `Gain` | 整体增益 (int32, 小端序, 范围 0~-50dB) |
| 8-23 | 16 | `Name` | 模式名称 (UTF-8 字符串) |
| 24-63 | 40 | `Reserved` | 保留字节 |
---
### 3.3 设置模式整体增益和名称 (0x8C)
**主机发送**
| 字节位置 | 长度 | 内容 | 说明 |
| :--- | :--- | :--- | :--- |
| 0 | 1 | `0x01` | Report ID |
| 1 | 1 | `0x77` | 同步头 |
| 2 | 1 | `0x8C` | 命令码 |
| 3 | 1 | `Mode` | 目标模式值 (0-9) |
| 4-7 | 4 | `Gain` | 整体增益 (int32, 小端序) |
| 8-23 | 16 | `Name` | 模式名称 (UTF-8 字符串) |
| 24-63 | 40 | `Reserved` | 保留字节 |
---
### 3.4 发送 EQ 参数 (0x8D)
**主机发送**
| 字节位置 | 长度 | 内容 | 说明 |
| :--- | :--- | :--- | :--- |
| 0 | 1 | `0x01` | Report ID |
| 1 | 1 | `0x77` | 同步头 |
| 2 | 1 | `0x8D` | 命令码 |
| 3 | 1 | `Mode` | 模式值 (0-9) |
| 4 | 1 | `Band` | 滤波器索引 (0-7) |
| 5 | 1 | `Type` | 滤波器类型 (见下表) |
| 6-9 | 4 | `Freq` | 中心频率 Hz (float, 小端序) |
| 10-13 | 4 | `Q` | Q值 (float, 小端序) |
| 14-17 | 4 | `BW` | 带宽 Hz (float, 小端序) |
| 18-21 | 4 | `Gain` | 增益 dB (float, 小端序) |
| 22-63 | 42 | `Reserved` | 保留字节 |
**滤波器类型码**
| 代码 | 类型 | 代码 | 类型 |
| :--- | :--- | :--- | :--- |
| 0x00 | Bypass | 0x06 | 带阻 (Band Reject) |
| 0x01 | 全通 (All Pass) | 0x07 | 陷波 (Notch) |
| 0x02 | 峰值 (Peak) | 0x08 | 恒定Q (Constant Q) |
| 0x03 | 低通 (Low Pass) | 0x09 | 低架 (Low Shelf) |
| 0x04 | 高通 (High Pass) | 0x0A | 高架 (High Shelf) |
| 0x05 | 带通 (Band Pass) | | |
---
### 3.5 读取 EQ 参数 (0x8E)
**主机发送**
| 字节位置 | 长度 | 内容 | 说明 |
| :--- | :--- | :--- | :--- |
| 0 | 1 | `0x01` | Report ID |
| 1 | 1 | `0x77` | 同步头 |
| 2 | 1 | `0x8E` | 命令码 |
| 3 | 1 | `Mode` | 模式值 (0-9) |
| 4 | 1 | `Band` | 滤波器索引 (0-7) |
| 5-63 | 59 | `Reserved` | 保留字节 |
**设备返回 (响应)**
| 字节位置 | 长度 | 内容 | 说明 |
| :--- | :--- | :--- | :--- |
| 0 | 1 | `0x01` | Report ID |
| 1 | 1 | `0x77` | 同步头1 |
| 2 | 1 | `0x8E` | 同步头2 (回响命令码) |
| 3 | 1 | `Mode` | 模式值 |
| 4 | 1 | `Band` | 滤波器索引 |
| 5 | 1 | `Type` | 滤波器类型 |
| 6-9 | 4 | `Freq` | 中心频率 (float, 小端序) |
| 10-13 | 4 | `Q` | Q值 (float, 小端序) |
| 14-17 | 4 | `BW` | 带宽 (float, 小端序) |
| 18-21 | 4 | `Gain` | 增益 (float, 小端序) |
| 22-63 | 41 | `Reserved` | 保留字节 |
---
### 3.6 获取设备信息 (0x8F)
**主机发送**
| 字节位置 | 长度 | 内容 | 说明 |
| :--- | :--- | :--- | :--- |
| 0 | 1 | `0x01` | Report ID |
| 1 | 1 | `0x77` | 同步头 |
| 2 | 1 | `0x8F` | 命令码 |
| 3-63 | 61 | `Reserved` | 保留字节 |
**设备返回 (响应)**
| 字节位置 | 长度 | 内容 | 说明 |
| :--- | :--- | :--- | :--- |
| 0 | 1 | `0x01` | Report ID |
| 1 | 1 | `0x77` | 同步头1 |
| 2 | 1 | `0x8F` | 同步头2 (回响命令码) |
| 3-4 | 2 | `PID` | 产品ID (uint16, 小端序) |
| 5-6 | 2 | `VID` | 厂商ID (uint16, 小端序) |
| 7-22 | 16 | `Product` | 产品字符串 (UTF-8) |
| 23-38 | 16 | `Vendor` | 厂商字符串 (UTF-8) |
| 39-54 | 16 | `SN` | 序列号字符串 (UTF-8) |
| 55-63 | 9 | `Reserved` | 保留字节 |
---
### 3.7 复位 EQ 参数 (0x90)
**主机发送**
| 字节位置 | 长度 | 内容 | 说明 |
| :--- | :--- | :--- | :--- |
| 0 | 1 | `0x01` | Report ID |
| 1 | 1 | `0x77` | 同步头 |
| 2 | 1 | `0x90` | 命令码 |
| 3 | 1 | `Mode` | 模式号 (0-9)<br>`0xFF` 表示复位所有模式 |
| 4-63 | 60 | `Reserved` | 保留字节 |
**设备返回 (响应)**
| 字节位置 | 长度 | 内容 | 说明 |
| :--- | :--- | :--- | :--- |
| 0 | 1 | `0x01` | Report ID |
| 1 | 1 | `0x77` | 同步头1 |
| 2 | 1 | `0x90` | 同步头2 (回响命令码) |
| 3 | 1 | `Status` | 状态码 (0x00=成功, 0x01=失败) |
| 4-63 | 60 | `Reserved` | 保留字节 |
## 咨询反馈
<details>
<summary>点击展开咨询反馈表单</summary>
--8<-- "common/customer_form.md"
</details>

232
zh/docs/dev_doc/datasheet/std_product/ai_dnr/dnr65211_vc1.md Normal file
View File

@@ -0,0 +1,232 @@
---
title: DNR6521x-VC1 单通道超低延时Ai深度降噪处理器集成USB及I2S接口
description: DNR6521x-VC1 单通道超低延时Ai深度降噪处理器集成USB及I2S接口规格书
author: 技术文档部
date: 2025-05-14
print_page: true
---
--8<-- "common/phaten_xmos_support_img.md"
<div class="grid" markdown>
<div class="card-wide" markdown>
# DNR6521x-VC1
__单通道超低延时Ai深度降噪处理器集成USB及I2S接口__
</div>
</div>
## 1、简介
### 1.1 产品描述
DNR65211是基于XMOS处理器架构的高性能AI深度降噪产品，专为音频设备制造商提供卓越的音频处理能力。产品集成两套独立优化的AI降噪模型。
- 强降噪模型采用深度神经网络架构，能够有效处理复杂声学环境中的各种稳态和非稳态噪声，在保证人声高还原度的同时实现最大程度噪声抑制
- 唱歌降噪模型通过轻量化设计将处理延时降低至11毫秒，在有效抑制背景噪声的同时完整保留歌声特性。
- 产品支持I2S音频输入，可同时输出至USB和I2S接口，广泛适用于直播设备、会议系统、录音设备、户外运动DV等多个应用领域。
### 1.2 产品特性
**音频性能特性**
- Ai深度降噪
- 消除各种稳态和非稳态噪声，适应复杂声学环境
- 有效消除按键声、键盘声、脚步声等突发噪音
- 双AI降噪模型
- 强降噪模型适用于复杂声学场景:户外录音，游戏等场景
- 唱歌降噪模型适用于室内直播唱歌或访谈场景
- 超低延时实时处理
- 强降噪模型延时<50ms，满足音画同步要求
- 唱歌降噪模型延时<11ms，满足严格的直播唱歌要求
- 高保真人声还原
- 强降噪模型，完整保留人声特性
- 唱歌降噪模型，不但完整保留人声特性，还能完整保留唱歌的尾音
**USB接口特性**
- 支持UAC 2.0
- 支持OTG连接
- 即插即用，无需驱动安装
- 支持HID配置
**系统兼容性**
- 支持多种操作系统，如Windows，Linux，Android，macOS和iOS等
- 无需安装特殊驱动
**Codec支持**
- 支持NAU88l21
### 1.3 应用场景
- 直播设备
- 有效抑制各种环境噪音，适应多样化直播场景
- 游戏竞技耳机
- 消除键盘声、鼠标点击声和背景噪音，提供清晰的队友沟通体验
- 户外运动设备
- 抑制运动场景中的风噪和环境噪声干扰，为户外运动爱好者提供清晰的通话和录制体验
- 户外录音设备
- 在复杂户外声学环境中实现高质量录音，满足现场采访和内容创作的专业需求
- 会议系统设备
- 处理办公室环境中的空调声、脚步声等背景噪音
- 通话设备
- 通话设备适用于对实时性要求严格的商务通话，提供无感知延时的语音处理体验
### 1.4 产品功能框图
<figure markdown="span">
![DNR65211框图](/assets/images/hifi_audio/dnr65211_diagram.png "DNR6521x-VC1框图"){width=600}
<figcaption>图1: DNR6521x-VC1框图</figcaption>
</figure>
### 1.5 订购信息
| PRODUCT MODEL | ORDERING NUMBER | PACKAGE BODY | SIZE (NOM) | Hardware Model | Comments |
|:--------|:----------------|:-------------|:-----------|:------------|:------------|
| DNR65211-VC1 | DNR65211-VC1 | SMT LGA-52 | 13x13mm | A316-Mini-V1 | 单通道超低延时Ai深度降噪处理器集成USB及I2S接口，唱歌+强降噪模型，3档降噪 |
| DNR65212-VC1 | DNR65212-VC1 | SMT LGA-52 | 13x13mm | A316-Mini-V1 | 单通道超低延时Ai深度降噪处理器集成USB及I2S接口，强降噪模型，2档降噪 |
## 2、模式及指标
### 2.1 支持的输入输出模式
| 模式编号 | 输入输出模式 | 说明 |
|:--------:|:------------------------|:------------------------|
| 1 | I²S In(Master) → Ai DNR → USB(UAC2.0) <br> I²S In(Master) → Ai DNR → I²S Out(Master) | 支持USB和I²S输入，USB和I²S输出,内部做Ai降噪 |
### 2.2 各工作模式详细参数
#### 2.2.1 USB(UAC2.0) ←→ I²S(Master) 模式
**输入/输出参数:**
| 参数 | 输入/输出 | 输入/输出 |
|:---------|:-------------|:-------------|
| **接口** | USB Audio Class 2.0 | I²S(Master) |
| **音频格式** | PCM | PCM |
| **采样率** | 48KHz/24bit | 48kHz/24bit |
| **位深** | 固定24bit | 固定24bit |
#### 2.2.2 支持Codec
- 该产品适配Codec型号为NAU88l21
### 2.3 降噪性能对比
!!! info ""
<div class="sticky-column" markdown>
| 对比维度 | DNR65211 强降噪模型 | DNR65211 唱歌降噪模型 | 传统降噪技术 |
|----------------|---------------------------------------------|-----------------------------------------------|---------------------------------|
| **技术原理** | 深度神经网络架构，AI算法实时分析频谱特征，智能识别人声和噪声成分 | 在强降噪模型基础上，专门优化音乐场景处理，保留歌声音调和音色特性 | 频域滤波方法，基于统计模型和固定算法参数 |
| **处理延时** | < 50ms 满足音画同步 | < 11ms 超低延时 | 延时中等 |
| **噪声处理能力** | 有效处理稳态和非稳态噪声 | 专门优化音乐内容处理 | 对非平稳噪声处理能力有限 |
| **人声保真度** | 完整保留人声特性 | 完整保留唱歌的尾音细节 | 可能出现音质损失 |
| **环境适应性** | 处理各种复杂声学环境 | 专门针对音乐场景优化 | 适用于相对稳定的声学环境 |
| **典型应用** | 户外直播设备、游戏耳机, 会议系统、专业录音设备 | 室内直播设备、K歌设备, 音乐录制、在线访谈系统 | 传统电话系统、简单会议设备, 基础音频处理 |
</div>
## 3、管脚配置和功能
### 3.1 DNR65211_VC1管脚布局
<figure markdown="span">
![DNR6521x-VC1管脚图](/assets/images/hifi_audio/a316_pin.png "DNR6521x-VC1管脚图"){width=400}
<figcaption>图2: DNR65211_VC1管脚排列示意图</figcaption>
</figure>
### 3.2 DNR65211_VC1管脚描述
| 管脚序号 | 名称 | 类型 | 功能 |
|:--------:|:----------|:------|:-----------------------------|
| 1 | 3.3V | P | 模组3.3V供电 |
| 2 | X1D13 | I/O | NC |
| 3 | X1D16 | I/O | NC |
| 4 | GND | P | 模组地 |
| 5 | X1D17 | I/O | NC |
| 6 | X1D18 | I/O | NC |
| 7 | X1D19 | I/O | NC |
| 8 | X1D22 | I/O | NC |
| 9 | X0D29 | I/O | 低电平有效<br><br>DNR65211功能定义<br>{低降噪等级LED指示<br>慢闪:唱歌降噪模型. <br>常亮:强降噪模型}<br><br>DNR65212功能定义<br>{关降噪LED指示，常亮 } |
| 10 | X0D35 | I | I²S_IN_SCLK(MASTER,接NAU88L21) |
| 11 | X0D36 | I | I²S_IN_LRCLK(MASTER,接NAU88L21) |
| 12 | X0D37 | I/O | I²S_IN_DATA0(MASTER,接NAU88L21) |
| 13 | X0D38 | O | I²S_OUT_DATA0(MASTER,接NAU88L21) |
| 14 | X0D40 | I/O | 低电平有效<br><br>DNR65211功能定义<br>{短按循环切换降噪强度：关，低，中，高。<br>长按：切换降噪模型。 }<br><br>DNR65212功能定义<br>{短按循环切换降噪强度：关，低，高。 } |
| 15 | X0D39 | I | I²S_OUT_MCLK(MASTER,接NAU88L21) |
| 16 | X0D42 | I/O | 麦克风MUTE_SW，低电平有效，关闭MIC输入 |
| 17 | X0D41 | I/O | 麦克风音量+，低电平有效 |
| 18 | X0D43 | I/O | 麦克风音量-，低电平有效 |
| 19 | X1D34 | I/O | NC |
| 20 | GND | P | 模组地 |
| 21 | X0D30 | I/O | 低电平有效<br><br>DNR65211功能定义<br>{中降噪等级LED指示<br>慢闪:唱歌降噪模型. <br>常亮:强降噪模型}<br><br>DNR65212功能定义<br>{低降噪等级LED指示，常亮 } |
| 22 | X0D31 | I/O | 低电平有效<br><br>DNR65211功能定义<br>{高降噪等级LED指示<br>慢闪:唱歌降噪模型. <br>常亮:强降噪模型}<br><br>DNR65212功能定义<br>{高降噪等级LED指示，常亮 } |
| 23 | X0D32 | I/O | SPK音量+，低电平有效 |
| 24 | X0D33 | I/O | SPK音量-，低电平有效 |
| 25 | GND | P | 模组地 |
| 26 | GND | P | 模组地 |
| 27 | GND | P | 模组地 |
| 28 | X0D00 | I/O | I2C_SCL(接NAU88L21) |
| 29 | X0D11 | I/O | I2C_SDA(接NAU88L21) |
| 30 | X1D00 | I/O | NC |
| 31 | X1D01 | I/O | NC |
| 32 | GND | P | 模组地 |
| 33 | X1D09 | I/O | NC |
| 34 | X1D10 | I/O | NC |
| 35 | X1D11 | O | XU316内部时钟输出，连接X0D39 |
| 36 | GND | P | 模组地 |
| 37 | GND | P | 模组地 |
| 38 | TDI | I/O | XTAG调试PIN |
| 39 | TDO | I/O | XTAG调试PIN |
| 40 | TMS | I/O | XTAG调试PIN |
| 41 | TCK | I/O | XTAG调试PIN |
| 42 | RST_N | I/O | 系统复位，低电平有效 |
| 43 | 1.8V | P | 模组1.8V供电 |
| 44 | GND | P | 模组地 |
| 45 | USB_DM | I/O | USB_DM |
| 46 | USB_DP | I/O | USB_DP |
| 47 | GND | P | 模组地 |
| 48 | 0.9V | P | 模组0.9V供电 |
| 49 | GND | P | 模组地 |
| 50 | GND | P | 模组地 |
| 51 | GND | P | 模组地 |
| 52 | GND | P | 模组地 |
!!! info "管脚类型说明"
表中I/O类型定义：I=输入，O=输出，P=电源，I/O=输入/输出
## 4、硬件参数
### 4.1、正常工作条件
--8<-- "dev_doc/datasheet/modules/a316_mini_v1_datasheet.md:op"
### 4.2 产品尺寸
--8<-- "dev_doc/datasheet/modules/a316_mini_v1_datasheet.md:size"
### 4.3 模组封装图
<figure markdown="span">
![A316-Mini-V1封装图](/assets/images/hifi_audio/a316_size.png "A316-Mini-V1封装图"){width=400}
<figcaption></figcaption>
</figure>
## 5 产品包装信息
--8<-- "dev_doc/datasheet/modules/a316_mini_v1_datasheet.md:package"
## 6、修订历史
| 版本 | 日期 | 描述 | 修订者 |
|:------|:-------------|:---------------------------------------|:-------------|
| V1.0 | 2025-08-10 | 初始版本发布 | |
| | | | |
## 7、咨询反馈
<details>
<summary>点击展开咨询反馈表单</summary>
--8<-- "common/customer_form.md"
</details>

2
zh/docs/dev_doc/datasheet/std_product/hifi_audio/hf83311_vb1.md
View File

@@ -169,7 +169,7 @@ HF83311_VB1/HF83311Q_VB1提供多种输入输出模式，包括USB输入/I²S输
| 8 | X0D11 | I/O | UART_RX，连接MCU_TX |
| 9 | X0D00 | I/O | UART_TX，连接MCU_RX |
| 10 | X0D31 | I/O | NC |
| 11 | X0D30 | I/O | CTL_MUTE |
| 11 | X0D30 | I/O | CTL_MUTE；控制输出，高电平有效 |
| 12 | X1D34 | I/O | S/PDIF输出 |
| 13 | X0D43 | I/O | NC |
| 14 | X0D41 | I/O | NC |

4
zh/docs/dev_doc/datasheet/std_product/hifi_audio/hf83311_vc1.md
View File

@@ -177,10 +177,10 @@ HF83311_VC1/HF83311Q_VC1提供多种输入输出模式，包括USB输入/I²S输
| 18 | X0D43 | I/O | NC |
| 19 | X1D34 | I/O | S/PDIF输出 |
| 20 | GND | P | 模组地 |
| 21 | X0D30 | I/O | CTL_MUTE |
| 21 | X0D30 | I/O | CTL_MUTE；控制输出，高电平有效 |
| 22 | X0D31 | I/O | NC |
| 23 | X0D32 | I/O | NC |
| 24 | X0D32 | I/O | NC |
| 24 | X0D33 | I/O | NC |
| 25 | GND | P | 模组地 |
| 26 | GND | P | 模组地 |
| 27 | GND | P | 模组地 |

2
zh/docs/dev_doc/datasheet/std_product/hifi_audio/hf86611_vb1.md
View File

@@ -157,7 +157,7 @@ HF86611_VB1/HF86611Q_VB1提供多种输入输出模式，包括USB输入/I²S输
| 8 | X0D11 | I/O | UART_RX，连接MCU_TX |
| 9 | X0D00 | I/O | UART_TX，连接MCU_RX |
| 10 | X0D31 | I/O | NC |
| 11 | X0D30 | I/O | CTL_MUTE |
| 11 | X0D30 | I/O | CTL_MUTE；控制输出，高电平有效 |
| 12 | X1D34 | I/O | S/PDIF通道3输入 |
| 13 | X0D43 | I/O | NC |
| 14 | X0D41 | I/O | NC |

4
zh/docs/dev_doc/datasheet/std_product/hifi_audio/hf86611_vc1.md
View File

@@ -162,10 +162,10 @@ HF86611_VC1/HF86611Q_VC1提供多种输入输出模式，包括USB输入/I²S输
| 18 | X0D43 | I/O | NC |
| 19 | X1D34 | I/O | S/PDIF通道3输入 |
| 20 | GND | P | 模组地 |
| 21 | X0D30 | I/O | CTL_MUTE |
| 21 | X0D30 | I/O | CTL_MUTE；控制输出，高电平有效 |
| 22 | X0D31 | I/O | NC |
| 23 | X0D32 | I/O | NC |
| 24 | X0D32 | I/O | NC |
| 24 | X0D33 | I/O | NC |
| 25 | GND | P | 模组地 |
| 26 | GND | P | 模组地 |
| 27 | GND | P | 模组地 |

2
zh/docs/dev_doc/datasheet/std_product/hifi_audio/hf87611_vb1.md
View File

@@ -196,7 +196,7 @@ HF87611_VB1./hf87611Q_VB1提供多种输入输出模式，包括USB输入/I²S
| 8 | X0D11 | I/O | UART_RX，连接MCU_TX |
| 9 | X0D00 | I/O | UART_TX，连接MCU_RX |
| 10 | X0D31 | I/O | NC |
| 11 | X0D30 | I/O | CTL_MUTE |
| 11 | X0D30 | I/O | CTL_MUTE；控制输出，高电平有效 |
| 12 | X1D34 | I/O | S/PDIF输出 |
| 13 | X0D43 | I/O | NC |
| 14 | X0D41 | I/O | NC |

6
zh/docs/dev_doc/datasheet/std_product/hifi_audio/hf87611_vc1.md
View File

@@ -199,10 +199,10 @@ HF87611_VC1/HF87611Q_VC1提供多种输入输出模式，包括USB输入/I²S输
| 18 | X0D43 | I/O | NC |
| 19 | X1D34 | I/O | S/PDIF输出 |
| 20 | GND | P | 模组地 |
| 21 | X0D30 | I/O | CTL_MUTE |
| 21 | X0D30 | I/O | CTL_MUTE；控制输出，高电平有效 |
| 22 | X0D31 | I/O | NC |
| 23 | X0D32 | I/O | 控制49.152M 时钟 |
| 24 | X0D33 | I/O | 控制45.1584M 时钟 |
| 23 | X0D32 | I/O | 控制49.152M 时钟 ；控制输出，高电平有效 |
| 24 | X0D33 | I/O | 控制45.1584M 时钟 ；控制输出，高电平有效 |
| 25 | GND | P | 模组地 |
| 26 | GND | P | 模组地 |
| 27 | GND | P | 模组地 |

2
zh/docs/dev_doc/datasheet/std_product/hifi_audio/hf87621_vb1.md
View File

@@ -177,7 +177,7 @@ HF87621_VB1/HF87621Q_VB1提供多种输入输出模式，包括USB输入/I²S输
| 8 | X0D11 | I/O | UART_RX，连接MCU_TX |
| 9 | X0D00 | I/O | UART_TX，连接MCU_RX |
| 10 | X0D31 | I/O | NC |
| 11 | X0D30 | I/O | CTL_MUTE |
| 11 | X0D30 | I/O | CTL_MUTE；控制输出，高电平有效 |
| 12 | X1D34 | I/O | S/PDIF通道3输入 |
| 13 | X0D43 | I/O | NC |
| 14 | X0D41 | I/O | NC |

4
zh/docs/dev_doc/datasheet/std_product/hifi_audio/hf87621_vc1.md
View File

@@ -180,10 +180,10 @@ HF87621_VC1/HF87621Q_VC1提供多种输入输出模式，包括USB输入/I²S输
| 18 | X0D43 | I/O | NC |
| 19 | X1D34 | I/O | S/PDIF通道3输入 |
| 20 | GND | P | 模组地 |
| 21 | X0D30 | I/O | CTL_MUTE |
| 21 | X0D30 | I/O | CTL_MUTE；控制输出，高电平有效 |
| 22 | X0D31 | I/O | NC |
| 23 | X0D32 | I/O | NC |
| 24 | X0D32 | I/O | NC |
| 24 | X0D33 | I/O | NC |
| 25 | GND | P | 模组地 |
| 26 | GND | P | 模组地 |
| 27 | GND | P | 模组地 |

140
zh/docs/dev_doc/evb/wifi_8711_speaker/RTL8711dev_board.md Normal file
View File

@@ -0,0 +1,140 @@
---
title: WiFi-Audio-TRX-V1 开发评估板规格书
description: WiFi-Audio-TRX-V1 开发评估板外观尺寸、特性参数、应用方向、管脚定义与原理图说明，统一图片样式提升可读性。
keywords: WiFi-Audio-TRX-V1, RTL8711, 开发评估板, 外观尺寸, 特性, 管脚定义, 原理图
---
# WiFi-Audio-TRX-V1 开发评估板规格书
## 产品概述
WiFi-Audio-TRX-V1 具有丰富的功能和出色的性能，适用于多种物联网应用场景。该模组集成了高性能的 MCU、双频 WiFi 和蓝牙功能，可满足不同设备的通信需求。其内部结构设计合理，通过嵌入式调节器为各模块提供稳定的电源供应，同时具备多种电源管理模式以降低功耗。丰富的接口资源使其能够方便地与外部设备进行连接和通信，如传感器、显示屏等。在射频性能方面，无论是 WiFi 还是蓝牙，都能提供可靠的无线连接，确保数据传输的稳定性和高效性。该模组在智能家居、工业物联网、智能穿戴设备等领域具有广泛的应用前景，能够为各类智能设备提供强大的无线通信能力和数据处理能力，助力实现智能化控制和数据交互。
## 外观尺寸
### 产品图片
**正面**
![开发板正面](/assets/images/speaker/11-08/dome/PCB-EV721D00-2v0_Top.png){ width="60%" }
**背面**
![开发板背面](/assets/images/speaker/11-08/dome/PCB-EV721D00-2v0_Bottom.png){ width="60%" }
### 产品尺寸
**_长：65mm ；宽：30mm_**
## 特性
- **支持双频 WiFi 和蓝牙**：支持 WLAN 双频（2.4GHz 和 5GHz）以及低功耗蓝牙 5.0，集成了 Real - M300 高性能 MCU、WLAN MAC、基带、射频和蓝牙等功能，可实现完整的 Wi - Fi 和 BLE 5.0 协议功能。
- **多种工作模式与节能机制**：工作电压范围为 3.0V - 3.6V，支持多种低功耗模式，如睡眠模式和深度睡眠模式，在不同模式下各功能模块可灵活配置电源和时钟以降低功耗。例如，在睡眠模式下，多数功能模块可进行电源门控或时钟门控；在深度睡眠模式下，除 AON 功能外所有功能关闭，以实现超低功耗。
- **丰富的接口资源**：提供可配置的 GPIO 口，便于控制外围设备；集成内部存储器，支持简单应用程序开发；具备多种通信接口，如 UART、SPI、QSPI/OSPI、I2C 等，还提供高速连接接口 SDIO 和 USB，以及音频功能（包括数字麦克风接口和 I2S）。
- **高性能处理器**：内置低功耗 KM4 MCU（基于 Armv8.1 - M 架构，兼容 Cortex - M55 指令集），主频最高可达 345MHz，具有增强的调试功能、浮点计算、数字信号处理扩展指令等特性；同时还有低功耗 KM0 MCU（基于 Armv8 - M 基线架构，兼容 Cortex - M23 指令集），主频最高可达 115MHz，指令集简单、代码尺寸小，与 KM4 处理器代码和工具兼容，适用于对功耗敏感的快速响应操作，如电源管理和网络协议处理。
- **可靠的射频性能**
- **WiFi 射频特性**：在 2.4GHz 频段，遵循 IEEE 802.11b/g/n 标准，支持多种调制方式和传输速率，发射功率和接收灵敏度表现良好；在 5GHz 频段，遵循 IEEE 802.11a/n 标准，同样具备出色的发射和接收性能，且天线具备多样性功能，可通过外部 RF 开关选择最佳天线以减少信道衰落影响，同时采用实时校准机制确保无线电系统稳定运行。
- **蓝牙射频特性**：符合蓝牙 5.0 规格，在 2.4GHz 频段工作，发射功率和接收灵敏度满足相关标准，支持多种蓝牙功能，如快速 AGC 控制、多种功率等级、增强型功率控制以及低功耗模式（如 BLE）。
## 应用方向
* 智能家居（照明控制、开关和插头、家电等）
* 工业 4.0
* 低功耗物联网设备（低功耗 Wi-Fi 摄像头、智能门锁等）
* 智能穿戴设备
* 便携式设备
* 游戏配件
* 无线音频设备
* 智能交互玩具等
## 主要参数
**电气参数**
* 工作电压：3.0V - 3.6V。
* 工作温度：-30℃ to 85℃。
* 存储温度：-40℃ to 125℃。
**射频参数**
WiFi（2.4GHz）
* 发射功率：802.11b@11Mbps 可达 18dBm；802.11g@54Mbps 可达 17dBm；802.11n@N20 MCS7 可达 16dBm；802.11n@N40_MCS7 可达 16dBm。
* 接收灵敏度：802.11b@11Mbps 可达 - 85dBm；802.11g@54Mbps 可达 - 73dBm；802.11n@N20 MCS7 可达 - 68dBm；802.11n@N40 MCS7 可达 - 65dBm。
WiFi（5GHz）
* 发射功率：802.11a@54Mbps 可达 13dBm；802.11n@N20_MCS7 可达 12dBm；802.11n@N40_MCS7 可达 12dBm。
* 接收灵敏度：802.11a@54Mbps、802.11n@N20 MCS7、802.11n@N40 MCS7 相关参数未详细给出（参考文档后续部分或实际产品详细规格）。
*
**蓝牙**
* 发射功率：0 - 10dBm（BLE，GPSK/1Mbps 和 GPSK/2Mbps）。
* 接收灵敏度：≤ - 95dB（灵敏度 LE1M@PER<30.8%）；≤ - 93dB（灵敏度 LE2M@PER<30.8%）。
## 管脚定义
| 引脚编号 | 名称 | 功能描述 |
|------|-------|-------------------------------------------------------------------------------|
| 1 | VD33 | 3.3v供电 |
| 2 | VD5V | 5v供电 |
| 3 | PB30 | 唤醒引脚。此引脚在复位期间应保持上拉。默认功能为通用输入/输出，并且可以配置为其他功能 |
| 4 | VD5V | 5v供电 |
| 5 | PB31 | 唤醒引脚。IC的工作模式由电源开启过程中陷阱引脚PB31/TM_DIS的电平决定。1：正常模式0：测试模式默认功能为通用输入/输出，并且可以配置为其他功能 |
| 6 | PB_2 | 默认功能为通用输入/输出，并且可以配置为其他功能 |
| 7 | PA12 | 默认功能为通用输入/输出，并且可以配置为其他功能 |
| 8 | PB_2 | 默认功能为通用输入/输出，并且可以配置为其他功能 |
| 9 | PA_28 | 默认功能为通用输入/输出，并且可以配置为其他功能 |
| 10 | PB_3 | 默认功能为通用输入/输出，并且可以配置为其他功能 |
| 11 | PA_28 | 默认功能为通用输入/输出，并且可以配置为其他功能 |
| 12 | PB_15 | 默认功能为通用输入/输出，并且可以配置为其他功能 |
| 13 | PB7 | 功率输入到数字I/O电源域 |
| 14 | PB_15 | 默认功能为通用输入/输出，并且可以配置为其他功能 |
| 15 | PB9 | 默认功能为通用输入/输出，并且可以配置为其他功能 |
| 16 | PB8 | 功率输入到数字I/O电源域 |
| 17 | VD33 | 3.3v供电 |
| 18 | PB13 | 默认功能为通用输入/输出，并且可以配置为其他功能 |
| 19 | PA23 | 默认功能为通用输入/输出，并且可以配置为其他功能 |
| 20 | PB14 | 默认功能为通用输入/输出，并且可以配置为其他功能 |
| 21 | PA_20 | 默认功能为通用输入/输出，并且可以配置为其他功能 |
| 22 | PB14 | 默认功能为通用输入/输出，并且可以配置为其他功能 |
| 23 | PA_30 | 默认功能为SWD CLK，在IC启动后可以配置为其他功能 |
| 24 | PA_21 | 功率输入到数字I/O电源域。默认功能为通用输入/输出，并且可以配置为其他功能 |
| 25 | PB_0 | 默认功能为通用输入/输出，并且可以配置为其他功能 |
| 26 | PA22 | 默认功能为通用输入/输出，并且可以配置为其他功能 |
| 27 | PB0 | 默认功能为通用输入/输出，并且可以配置为其他功能 |
| 28 | PB_15 | 默认功能为通用输入/输出，并且可以配置为其他功能 |
| 29 | PA_29 | 默认功能为通用输入/输出，并且可以配置为其他功能 |
| 30 | PB_21 | 默认功能为通用输入/输出，并且可以配置为其他功能 |
| 31 | PB_18 | 默认功能为通用输入/输出，并且可以配置为其他功能 |
| 32 | PB_21 | 默认功能为通用输入/输出，并且可以配置为其他功能 |
| 33 | PB_19 | 默认功能为通用输入/输出，并且可以配置为其他功能 |
| 34 | PB_22 | 默认功能为通用输入/输出，并且可以配置为其他功能 |
| 35 | PB20 | 默认功能为通用输入/输出，并且可以配置为其他功能 |
| 36 | PB_22 | 默认功能为通用输入/输出，并且可以配置为其他功能 |
| 37 | PB6 | 默认功能为通用输入/输出，并且可以配置为其他功能 |
| 38 | PB_22 | 默认功能为通用输入/输出，并且可以配置为其他功能 |
| 39 | GND | 接地 |
| 40 | GND | 接地 |
## 原理图
![开发板原理图](/assets/images/speaker/11-08/dome/8711开发板原理图.png){ width="80%" }
## 咨询反馈
<details>
<summary>点击展开咨询反馈表单</summary>
--8<-- "common/customer_form.md"
</details>

26
zh/docs/dev_doc/evb/wifi_8711_speaker/design_docs.md Normal file
View File

@@ -0,0 +1,26 @@
---
title: WiFi-Audio-TRX-V1 Wi‑Fi 音频评估板设计文档
hide:
- toc
login: true
description: Phaten Audio WiFi-Audio-TRX-V1 基于 Realtek RTL8711 的 Wi‑Fi 音频评估板设计资料入口，包含原理图、BOM 与元器件规格说明。
keywords: Phaten Audio, WiFi-Audio-TRX-V1, RTL8711, Wi‑Fi 音频, 评估板, 设计文档, 原理图, BOM
---
# WiFi-Audio-TRX-V1 Wi‑Fi 音频评估板设计文档
--8<-- "common/phaten_xmos_support_img.md"
--8<-- "common/checklogin_form.md"
| 类型 | 标题 | 下载 |
| :----------------: | :------------------------------------------------------------------ | :---------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 评估板的模组规格书 | :material-file-document-outline: WiFi-Audio-TRX-V1 评估板模组规格书 | <a href="javascript:void(0);" onclick="checkLogin('/assets/download/factory_img/wifi_audio_trx/WB30D-1711DCMV1 模组规格书(1).pdf')"> :material-download: </a> |
| 评估板原理图 | :material-file-document-outline: WiFi-Audio-TRX-V1 评估板原理图 | <a href="javascript:void(0);" onclick="checkLogin('/assets/download/factory_img/wifi_audio_trx/8711evb原理图.pdf')"> :material-download: </a> |
## 咨询反馈
<details>
<summary>点击展开咨询反馈表单</summary>
--8<-- "common/customer_form.md"
</details>

59
zh/docs/dev_doc/evb/wifi_8711_speaker/firmware_flashing.md Normal file
View File

@@ -0,0 +1,59 @@
---
login: true
description: RTL8711/RTL8730 烧录工具与评估板烧录流程，含进入烧录与打印模式步骤与注意事项。
keywords: RTL8711, RTL8730, 烧录工具, WiFi-Audio-TRX-V1, 评估板, 下载, 固件
---
--8<-- "common/checklogin_form.md"
# WiFi-Audio-TRX-V1系列烧录说明
该工具是RTL8711Dx的烧录工具，支持8711和8730。
## 准备工作
烧录工具下载：<a href="javascript:void(0);" onclick="checkLogin('/assets/download/a316-8711-5.1make/ImageTool-调试烧录8711-8730工具.zip')">:material-download:</a>
### 模组进入烧录模式
![8711 模组烧录接线示意](/assets/images/speaker/11-08/model/8711模组烧录方式.jpg){width="48%"} ![8711 模组外观](/assets/images/speaker/11-08/model/8711%20模组图片.png){width="48%"}
### 评估板进入烧录模式
先按住 download 按键，再按住 chip 按键。串口打印\0。然后一起放手
### 打印模式
按一下 chip 按键 可以复位
![评估板按键与接口示意](/assets/images/speaker/shaolu-1.png){width="65%"}
!!! note
**图中download按键右边是只供电的type-c接口，最右边的type-c接口可用于供电和串口打印**
## 操作步骤
### 步骤一：下载好工具并双击打开
![工具所在目录示意](/assets/images/speaker/shaolu-2.png){width="70%"}
### 步骤二：打开软件，点击“File”→“Open”选取文件
![软件主界面与打开文件](/assets/images/speaker/shaolu-3.png){width="70%"}
### 步骤三：选择配置文件
选择 "AmebaDplus FreeRTOS NOR.rdev"（第 3 个）用于 8711；第 6 个为 8730，按需选用。
![选择 rdev 配置文件](/assets/images/speaker/shaolu-4.png){width="70%"}
### 步骤四：选择需要烧录的固件
确保固件名称与配置一致。
![选择固件文件](/assets/images/speaker/shaolu-5.png){width="70%"}
### 步骤五：按需添加 VFS 文件
如需添加额外 VFS，请自定义文件名，例如 "vfs.bin"。
![添加 VFS 文件示意](/assets/images/speaker/addVFS.png){width="60%"}
### 步骤六：选择串口与波特率并开始烧录
按图选择串口、波特率（通常自动选择），核对无误后点击下方 "Download" 开始烧录。
![开始烧录流程与设置](/assets/images/speaker/shaolu-6.png){width="70%"}
## 咨询反馈
<details>
<summary>点击展开咨询反馈表单</summary>
--8<-- "common/customer_form.md"
</details>

31
zh/docs/dev_doc/evb/wifi_8711_speaker/index-chanpliebiao.md Normal file
View File

@@ -0,0 +1,31 @@
---
title: Wi‑Fi 无线音响系列核心固件
hide:
- toc
---
--8<-- "common/phaten_xmos_support_img.md"
# Wi‑Fi 无线音响
!!! info "产品列表"
<div class="sticky-column" markdown>
| **产品(功能:material-arrow-down:)(型号:material-arrow-right:)** | [WB8711_ZW](./wb8711_zw.md) |
|---------------------|---------------------|
| **无线规格** | 2.4 / 5GHz Wi‑Fi，BLE 5.0 |
| **配置与部署** | ZeroConfig + Web 配置中心 |
| **应用方向** | 家庭影院无线音频/智能音箱 |
| **参考规格** | [WB8711-ZW 模组规格](../../dev_doc/wifi_speaker/wb8711_zw.md) |
| **Status** | Active |
</div>
## 咨询反馈
<details>
<summary>点击展开咨询反馈表单</summary>
--8<-- "common/customer_form.md"
</details>

136
zh/docs/dev_doc/evb/wifi_8711_speaker/index.md Normal file
View File

@@ -0,0 +1,136 @@
---
title: WiFi-Audio-TRX-V1 Wi‑Fi 音频评估板
description: 基于 Realtek RTL8711 平台的 Wi‑Fi 无线音响评估板/固件参考页面，支持 ZeroConfig 与 Web 配置，适配 2.4/5.8GHz 与 BLE 5.0。
keywords: Wi‑Fi 无线音响, RTL8711, ZeroConfig, Web 配置, BLE 5.0, 评估板
hide:
- toc
login: true
---
<!-- 结构化数据标记（SEO） -->
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Product",
"name": "WiFi-Audio-TRX-V1 Wi‑Fi 音频评估板",
"description": "基于 Realtek RTL8711 平台的 Wi‑Fi 无线音响评估板/固件参考，支持 ZeroConfig 与 Web 配置，适配 2.4/5GHz 与 BLE 5.0。",
"brand": {
"@type": "Brand",
"name": "Phaten Audio"
}
}
</script>
--8<-- "common/checklogin_form.md"
--8<-- "common/phaten_xmos_support_img.md"
<div class="grid" markdown>
<div class="card-wide" markdown>
# WiFi-Audio-TRX-V1
__免开发 ZeroConfig + Web 配置的 Wi‑Fi 无线音响固件（Realtek RTL8711Dx 平台）__
</div>
</div>
<div class="result" markdown>
![WiFi-Audio-TRX-V1示意图](/assets/images/evb/8711_wifi_speaker/8711kf.png){align=right width=400}
WiFi-Audio-TRX-V1 面向 Wi‑Fi 无线音响、智能音箱等场景的用户自定义固件，支持开箱即用的 ZeroConfig 流程与 Web 配置界面；基于 Realtek `RTL8711Dx` 系列模组，支持 2.4 / 5.8GHz 双频 Wi‑Fi 与 BLE 5.0，满足高可靠连接与便捷部署需求。
- ZeroConfig 首次上电引导，热点快速配置音响通道
- 内置 Web 配置中心
- 支持配置导入/导出，适配批量交付
[:shopping_cart: 样品购买](){.md-button }
</div>
## 特性与文档
=== "关键特性"
- Wi‑Fi 5.8G 无线音频链路，低延迟、强抗干扰、稳定可靠（可支持最高10声道传输，取决于项目配置）。
- ZeroConfig 首次上电引导与 Web 可视化配置，支持自动重连。
- 场景化声道配置：标准5.1、紧凑3.1、简约2.1，可扩展至7.1.2；灵活的通道映射与设备分组。
=== "无线音频传输"
- 5.8GHz Wi‑Fi 无线传输，最远可达20米，优化音频链路的延迟与抖动，支持主机（Soundbar）与后置环绕/低音炮的多点连接。
- 多链路协同与抗干扰策略：自动信道选择、回连与容错，适配复杂环境。
- 基于BLE用于快速配对/辅助配置（具体取决于硬件平台能力）。
=== "音频规格与同步"
- 支持多种高解析度音频：PCM 默认最高192kHz/48bit。
- 动态范围优化与缓冲同步策略，保障高保真与稳定播放，降低卡顿与失步。
- 支持主从转换，播放延迟20ms。
=== "声道与角色"
- 角色定义：主机（Soundbar/Master）、后置环绕（Rear L/R）、低音炮（Sub），支持自定义扩展。
- 通道映射：支持在 Web 配置中直观分配声道至设备，适配不同房间布局。
- 设备分组与组网：支持组ID与自动发现，便于多套系统并行部署。
=== "Web 配置"
- 配置中心：网络（AP/STA）、设备配对、声道映射、声道试听。
> 以上硬件参数与能力参考自 Realtek `RTL8711Dx` 系列模组规格，具体以实际选型与规格书为准。
=== "技术文档"
| 类型 | 标题 | 链接 |
| :----------: | :------------------------------------------------ | :-------------------------- |
| 使用说明 | [:material-file-document-outline: 使用说明] | [:material-open-in-new:](./user_guide.md) |
| Web 配置指南 | [:material-file-document-outline: Web 配置使用说明] | [:material-open-in-new:](./web_config_guide.md) |
| 固件烧录说明 | [:material-file-document-outline: 固件烧录步骤] | [:material-open-in-new:](./firmware_flashing.md) |
| 硬件规格书 | [:material-file-document-outline: 硬件规格书] | [:material-open-in-new:](./RTL8711dev_board.md) |
| 设计资料 | [:material-file-document-outline: 设计资料] | [:material-open-in-new:](./design_docs.md) |
=== "固件列表"
| 文件名称 | 固件版本 | 发布日期 | 固件说明 | 下载 |
|:--------------------|:---------|:--------|:--------------------|:--------------------|
| WiFi-Audio-TRX-V1 Factory Image | v1.0 | | 评估板出厂镜像，基础固件 | <a href="javascript:void(0);" onclick="checkLogin('/assets/download/factory_img/wifi_audio_trx/WiFi-Audio-TRX-V1.zip')">:material-download:</a> |
| WiFi-Audio-TRX-V1 VFS Config Firmware | v1.0 | | 配置固件，需要与基础固件一起烧录使用 | <a href="javascript:void(0);" onclick="checkLogin('/assets/download/factory_img/wifi_audio_trx/VFS-config.zip')">:material-download:</a> |
=== "工具和软件"
| 类型 | 描述 | 下载 |
| :----------: | :---------------------- | :-------------------------------------------------------------------------------------------------------------------------------------- |
| 调试工具 | 调试工具合集 | [:material-toolbox: 工具与软件](../../../services_support/tools_software/index.md) |
| 驱动程序 | USB 驱动 | [:material-usb-flash-drive-outline: USB驱动](../../../services_support/driver/index.md) |
## 应用场景
- 多声道家庭影院无线应用
- 标准5.1、紧凑3.1、简约2.1声道配置，可扩展至7.1.2
- 支持主机（Soundbar/Master）与后置环绕/低音炮的多点连接
- 可扩展场景与部署
- 酒店、公寓、商超等公共空间的批量快速部署
- 家庭与工作室的网络化音频播放系统，多套系统并行组网
- 支持设备分组、自动发现与声道映射，适配不同房间布局
## 订购信息
| 产品名称 | 产品型号 | 产品图片 |
| :----------------- | :-------- | :-------------------------------------------------------------------------------------------: |
| Wi‑Fi 无线免开发音响评估板 | WiFi-Audio-TRX-V1 | ![WiFi-Audio-TRX-V1](/assets/images/evb/8711_wifi_speaker/8711kf.png "Wi-Fi Audio TRX V1评估板"){align=center width=120} |
> 可根据实际模组/机型提供定制化固件（主题、功能裁剪、出厂参数）。
<!-- ## 支持的产品
<div class="grid cards" markdown>
- :material-developer-board: __RTL8711 系列 Wi‑Fi 音频评估板与固件__
---
提供网络配置与音频路由评估，便于快速验证固件能力（示例）。
[:octicons-arrow-right-24: 查看产品页](../../../products/wifi_speaker/WiFi-Audio-TRX-V1.md)
</div> -->
## 咨询反馈
<details>
<summary>点击展开咨询反馈表单</summary>
--8<-- "common/customer_form.md"
</details>

46
zh/docs/dev_doc/evb/wifi_8711_speaker/user_guide.md Normal file
View File

@@ -0,0 +1,46 @@
---
title: WiFi-Audio-TRX-V1 用户使用指南
description: WiFi-Audio-TRX-V1 评估板使用指南，涵盖硬件准备、按键与指示灯焊接说明、固件烧录与 Web 配置入口。
keywords: WiFi-Audio-TRX-V1, RTL8711, 评估板, 用户指南, 固件烧录, Web配置
---
# WiFi-Audio-TRX-V1 用户使用指南
适用于 WiFi-Audio-TRX-V1 评估板的快速入门与使用说明，包含硬件准备、TX 按键与指示灯焊接、固件烧录与 Web 配置入口。
## 硬件设备准备
### 评估板
- [WiFi-Audio-TRX-V1 评估板](./index.md)
WiFi-Audio-TRX-V1 可作为发送板或接收板使用：统一命名为发送板为 TX，接收板为 RX。
!!! warning "注意"
1. TX 板 需要与RX板配套使用
2. RX 板 不包含扬声器，需要额外连接扬声器。
3. TX 板 pin28脚位连接GND，保持2秒以上(串口打印关键字：FTYWiFiSpeaker)，即可进入web配置模式。
4. TX 板 开发了额外的指示灯和按键，用于调试和配置。（详细请参考[TX 发送板的硬件调整](./user_guide.md#tx)）
### TX 发送板的硬件调整(可选)
!!! note "焊接额外的按键和指示灯"
1. `PB_17` 脚位连接指示灯 IO，灯串联 1k 电阻后接 `GND`
2. 板子上的 `GND` 连接按键一端
3. `PB_1` 连接按键的另一端（`GND`）
![TX 侧边按键焊接示意](/assets/images/evb/8711_wifi_speaker/side-key0.jpeg){width="60%"}
![TX 侧边按键与指示灯位置](/assets/images/evb/8711_wifi_speaker/side-key01.png){width="45%"} ![TX 侧边按键背面示意](/assets/images/evb/8711_wifi_speaker/side-key02.png){width="45%"}
## [烧录固件](./firmware_flashing.md)
## [web配置与验证固件功能](./web_config_guide.md)
## 咨询反馈
<details>
<summary>点击展开咨询反馈表单</summary>
--8<-- "common/customer_form.md"
</details>

62
zh/docs/dev_doc/evb/wifi_8711_speaker/web_config_guide.md Normal file
View File

@@ -0,0 +1,62 @@
---
title: WiFi-Audio-TRX-V1 Web 配置指南
description: WiFi-Audio-TRX-V1 音响评估板 TX/RX Web 配网教程
keywords: Wi‑Fi音响,WB8711_ZW,RTL8711,WiFi-Audio-TRX-V1,Web配置,配网,评估板
hide:
- toc
---
# WiFi-Audio-TRX-V1 Web 配置指南
适用于 WiFi-Audio-TRX-V1 无线音响固件与评估板的 Web 配网和设备管理操作，帮助你快速完成 TX 与 RX 的扫描、配对与参数配置。
## 准备工作
- TX 上电后，默认按固件配置进入配网模式；需进入 Web 配置时请按住 TX 指示灯按钮（详细请参考[TX 发送板的硬件调整](user_guide.md###tx-发送板的硬件调整) 如无调试开关，可杜邦线短接 `pin28` 至 `GND`，保持 2 秒以上）。
- RX 上电待机，确保未与其他 TX 配对。
- 搜索并连接 TX 发出的 Wi‑Fi（示例：`FTYWiFiSpeaker_7BA3`），默认密码为 `12345678`，不可更改。
- 连接成功后会自动弹出浏览器进入 Web 配置页面。建议复制页面中的 IP，另开浏览器窗口访问，以提升稳定性。
- 设备建议：安卓手机、Windows 电脑、macOS。苹果手机不建议使用。
![alt text](/assets/images/evb/8711_wifi_speaker/web-config.png)
## 开启 Web 配置模式（TX）
1. TX 通电后长按指示灯按钮（或短接 `pin28` 至 `GND` 2 秒以上），进入 Web 配置模式。
2. Web 页面加载后，默认进入配网扫描模式；页面上的【Start Scanning】按钮为红色，TX 指示灯快闪表示正在扫描。
## 连接 RX 并扫描
1. RX 通电后，会自动连接到 TX，并在 Web 页面显示连接状态。
2. 如需停止扫描，点击红色【Start Scanning】按钮，按钮变为绿色表示停止扫描。
3. 新近连接成功的 RX 会显示在【Scanned Devices】区域，状态为“已连接 - 未配对”。
4. 如需添加新的 RX，可反复开启/关闭【Start Scanning】按钮（红色为开启，绿色为关闭）。
## 配置 RX 参数
1. 在中间区域【Network Control】，通过【Device-Type】选择当前 TX 的通道配置。该选项不保存记忆，离开页面后需重新选择。
2. 在下方【Device Management】区域，可查看各 RX 的连接状态，并进行如下操作：
- 选择通道：【Channel】
- 修改名称：【Device Name】
- 执行配对：【Pair】
- 测试声音：【Test】
3. 已完成配对的 RX 将锁定到当前 TX，无法再与其他 TX 配对；未配对的 RX 断电后可与其他 TX 重新连接。
## 完成配置与播放
1. 确认所有 RX 的参数与配对后，点击【Paired Complete】完成 Web 配置。
2. TX 会自动重启并退出 Web 配置模式，此时不会再出现配网 Wi‑Fi 信号。
3. 待 RX 重新回连后，TX 仅连接已配对的 RX，即可开始正常播放。
## 常见问题与排障
- RX 通电后未显示在页面上：请确认 RX 未与其他 TX 配对；重置 RX 并在 TX 页面重新开启扫描。
- Web 配置模式下无法播放电脑声音：属正常现象，配置模式仅支持测试音。请点击【Paired Complete】结束配置后再测试播放。
- 手机连接 Wi‑Fi 后页面无法正常刷新：TX 发出的 Wi‑Fi 为非路由器认证网络，部分手机/电脑会将其判定为“需验证网络”。连接后请使用浏览器按 IP 访问，稳定性更好。
- TX 页面无法刷新或连接断开：请重新上电 TX，并长按进入 Web 配置模式；重新连接配网 Wi‑Fi 并按 IP 访问。
## 咨询反馈
<details>
<summary>点击展开咨询反馈表单</summary>
--8<-- "common/customer_form.md"
</details>

340
zh/docs/dev_doc/protocols/XMOS_EQ_HID_Protocol.md
View File

@@ -1,7 +1,7 @@
---
title: XMOS EQ HID 通信协议规范
status: new
description: XMOS EQ HID 通信协议规范文档
description: 适用于免开发固件系列设备的 EQ HID 控制协议，包含报文结构、命令集与字段说明，用于模式切换、参数读写与设备信息获取。
keywords: EQ, HID, 控制协议, 命令集, USB HID, XU316,免开发固件, Phaten Audio
authors:
- admin
tags:
@@ -34,21 +34,21 @@ search:
| 数据包大小 | 64字节（包含1字节Report ID 0x01） |
| 有效数据 | 63字节 |
| 字节序 | 小端序（Little Endian） |
| 同步头 | 0x77 (固定第一个字节) |
| 同步头 | 0x77（固定第1字节，Report ID 为第0字节） |
### 1.2 HID设备识别
| 参数 | 值 | 说明 |
|:----------:|:--------:|:-----------------------------------------:|
| Usage Page | 0xff82 或 0xff83 | HID设备类型标识 |
| Report ID | 0x01 | 发送时作为第一个字节 |
| Report ID | 0x01 | 发送时作为第一个字节（第0字节） |
| 传输模式 | 非阻塞模式 | 避免GUI卡顿 |
### 1.3 通信机制
!!! warning "数据传输说明"
- 所有数据均采用小端序（Little Endian）传输
- 同步头0x77必须作为每个数据包的第一个字节
- 同步头 0x77 固定在第 1 字节（第 0 字节为 Report ID = 0x01）
- 建议命令间隔5ms以上，避免设备处理不及时
## 二、协议命令集 :material-code-tags:
@@ -56,229 +56,219 @@ search:
### 2.1 命令分类概览
!!! note "命令使用说明"
1. 所有命令必须包含同步头0x77作为第一个字节
2. 数据包总长度固定为63字节（不含Report ID）
1. 所有命令必须包含 Report ID 0x01（第0字节）与同步头 0x77（第1字节）
2. 数据包总长度固定为 64 字节（含 Report ID）
3. 未使用的字节必须填充为0
#### 2.1.1 命令头定义
| 命令头 | 命令名称 | 功能描述 | 方向 |
|:------:|:--------:|:--------:|:----:|
| 0x8B | READ_EQ_MODE | 读取EQ模式状态 | PC → 设备 |
| 0x8C | SET_EQ_MODE | 设置EQ模式 | PC → 设备 |
| 0x8D | SET_EQ_PARAMS | 设置EQ参数 | PC → 设备 |
| 0x8E | READ_EQ_PARAMS | 读取EQ参数 | PC ↔ 设备 |
| 0x8F | SAVE_USER_MODE | 保存用户模式 | PC → 设备 |
| 0x90 | READ_ALL_MODES | 读取所有模式信息 | PC ↔ 设备 |
| 0x91 | RESET_USER_MODE | 重置用户模式 | PC → 设备 |
| 0x92 | GET_DEVICE_INFO | 获取设备信息 | PC ↔ 设备 |
| 0x8A | SET_EQ_MODE | 切换当前的 EQ 模式 | PC → 设备 |
| 0x8B | GET_EQ_MODE | 获取当前 EQ 模式信息（模式号、增益、名称） | PC → 设备 |
| 0x8C | SET_MODE_GAIN_AND_NAME | 设置指定模式的整体增益和名称 | PC → 设备 |
| 0x8D | SET_EQ_PARAMS | 发送单个滤波器的参数 | PC → 设备 |
| 0x8E | GET_EQ_PARAMS | 读取单个滤波器的参数 | PC ↔ 设备 |
| 0x8F | GET_DEVICE_INFO | 获取设备基础信息（PID/VID/SN） | PC ↔ 设备 |
| 0x90 | RESET_EQ_PARAMS | 复位 EQ 参数（恢复预设） | PC ↔ 设备 |
### 2.2 详细命令格式
#### 2.2.1 读取EQ模式（0x8B）
#### 2.2.1 切换 EQ 模式（0x8A）
**功能说明**: 读取当前设备EQ模式值
**功能说明**: 切换当前的 EQ 模式
**请求格式（63字节）**:
**请求格式（64 字节）**:
| 偏移 | 长度 | 字段名 | 描述 |
|:----:|:----:|:------:|:----:|
| 0 | 1 | sync_header | 同步头: 0x77 |
| 1 | 1 | cmd_header | 命令头: 0x8B |
| 2 | 4 | sample_rate | 采样率 (Hz, 32位小端) |
| 6 | 1 | mode | 查询的模式值 |
| 7-62 | 56 | reserved | 保留字段（填充0） |
| 0 | 1 | report_id | 固定为 0x01 |
| 1 | 1 | sync_header | 同步头: 0x77 |
| 2 | 1 | cmd_header | 命令头: 0x8A |
| 3 | 1 | mode | 模式值（0-5: 预设, 6-8: 用户, 9: Bypass） |
| 4-63 | 60 | reserved | 保留字段（填充0） |
#### 2.2.2 设置EQ模式（0x8C）
#### 2.2.2 获取当前 EQ 模式信息（0x8B）
**功能说明**: 正式的模式设置命令
**功能说明**: 获取当前模式值、整体增益与模式名称
**数据包格式（63字节）**:
**请求格式（64 字节）**:
| 偏移 | 长度 | 字段名 | 描述 |
|:----:|:----:|:------:|:----:|
| 0 | 1 | sync_header | 同步头: 0x77 |
| 1 | 1 | cmd_header | 命令头: 0x8C |
| 2 | 4 | sample_rate | 采样率 (Hz, 32位小端) |
| 6 | 1 | mode | 模式值 (0-5: 预设模式, 6-7: 用户模式, 8: 禁用EQ) |
| 7-62 | 56 | reserved | 保留字段（填充0） |
| 0 | 1 | report_id | 固定为 0x01 |
| 1 | 1 | sync_header | 同步头: 0x77 |
| 2 | 1 | cmd_header | 命令头: 0x8B |
| 3-63 | 61 | reserved | 保留字段（填充0） |
#### 2.2.3 设置EQ参数（0x8D）
**功能说明**: 发送单个滤波器的完整参数和系数
**数据包格式（63字节）**:
**响应格式（64 字节）**:
| 偏移 | 长度 | 字段名 | 描述 |
|:----:|:----:|:------:|:----:|
| 0 | 1 | sync_header | 同步头: 0x77 |
| 1 | 1 | cmd_header | 命令头: 0x8D |
| 2 | 4 | sample_rate | 采样率 (Hz, 32位小端) |
| 6 | 1 | total_gain_db | 总增益补偿 (dB, 8位有符号整数) |
| 7 | 1 | filter_index | 滤波器索引 (0-7) |
| 8 | 1 | filter_type | 滤波器类型码 |
| 9 | 4 | fc | 中心频率 (Hz, 32位无符号整数) |
| 13 | 4 | q_value | Q值 (Q15.15格式, 32位有符号整数) |
| 17 | 4 | bandwidth | 带宽 (Hz, 32位无符号整数) |
| 21 | 4 | gain | 增益 (Q15.15格式, 32位有符号整数) |
| 25 | 38 | reserved | 保留字段（填充0） |
| 0 | 1 | report_id | 固定为 0x01 |
| 1 | 1 | sync_header | 同步头: 0x77 |
| 2 | 1 | cmd_header | 命令头: 0x8B（回显） |
| 3 | 1 | mode | 当前模式值 |
| 4-7 | 4 | gain | 整体增益（int32, 小端序，范围 -50dB ~ 0dB） |
| 8-23 | 16 | name | 模式名称（UTF-8 字符串） |
| 24-63 | 40 | reserved | 保留字段（填充0） |
**滤波器类型码定义**:
#### 2.2.3 设置模式整体增益和名称（0x8C）
| 类型码 | 滤波器类型 | 英文名称 |
|:------:|:----------:|:--------:|
| 0x00 | bypass滤波器 | Bypass Filter |
| 0x01 | 全通滤波器 | All-pass Filter |
| 0x02 | 峰值滤波器 | Peaking Filter |
| 0x03 | 低通滤波器 | Low-pass Filter |
| 0x04 | 高通滤波器 | High-pass Filter |
| 0x05 | 带通滤波器 | Band-pass Filter |
| 0x06 | 带阻滤波器 | Band-stop Filter |
| 0x07 | 陷波滤波器 | Notch Filter |
| 0x08 | 恒定Q值滤波器 | Constant-Q Filter |
| 0x09 | 低架滤波器 | Low-shelf Filter |
| 0x0A | 高架滤波器 | High-shelf Filter |
**功能说明**: 设置目标模式的整体增益和名称
**数值格式定义**:
**请求格式（64 字节）**:
!!! info "Q15.15格式说明"
- **Q15.15格式**: 16位整数部分 + 16位小数部分
- 例如: Q值1.414 → 0x00016A09
| 偏移 | 长度 | 字段名 | 描述 |
|:----:|:----:|:------:|:----:|
| 0 | 1 | report_id | 固定为 0x01 |
| 1 | 1 | sync_header | 同步头: 0x77 |
| 2 | 1 | cmd_header | 命令头: 0x8C |
| 3 | 1 | mode | 目标模式值（0-9） |
| 4-7 | 4 | gain | 整体增益（int32, 小端序） |
| 8-23 | 16 | name | 模式名称（UTF-8 字符串） |
| 24-63 | 40 | reserved | 保留字段（填充0） |
#### 2.2.4 读取EQ参数（0x8E）
#### 2.2.4 设置 EQ 参数（0x8D）
**功能说明**: 发送单个滤波器的参数
**请求格式（64 字节）**:
| 偏移 | 长度 | 字段名 | 描述 |
|:----:|:----:|:------:|:----:|
| 0 | 1 | report_id | 固定为 0x01 |
| 1 | 1 | sync_header | 同步头: 0x77 |
| 2 | 1 | cmd_header | 命令头: 0x8D |
| 3 | 1 | mode | 模式值（0-9） |
| 4 | 1 | band | 滤波器索引（0-7） |
| 5 | 1 | type | 滤波器类型码 |
| 6-9 | 4 | freq | 中心频率 Hz（float, 小端序） |
| 10-13 | 4 | q | Q 值（float, 小端序） |
| 14-17 | 4 | bw | 带宽 Hz（float, 小端序） |
| 18-21 | 4 | gain | 增益 dB（float, 小端序） |
| 22-63 | 42 | reserved | 保留字段（填充0） |
**滤波器类型码**:
| 代码 | 类型 | 代码 | 类型 |
|:----:|:----:|:----:|:----:|
| 0x00 | Bypass | 0x06 | 带阻（Band Reject） |
| 0x01 | 全通（All Pass） | 0x07 | 陷波（Notch） |
| 0x02 | 峰值（Peak） | 0x08 | 恒定Q（Constant Q） |
| 0x03 | 低通（Low Pass） | 0x09 | 低架（Low Shelf） |
| 0x04 | 高通（High Pass） | 0x0A | 高架（High Shelf） |
| 0x05 | 带通（Band Pass） | | |
**数值格式说明**:
!!! info "浮点数与字节序"
- 所有浮点数遵循 IEEE 754 float，采用小端序
- 所有多字节整数均采用小端序（Little Endian）
#### 2.2.5 读取 EQ 参数（0x8E）
**功能说明**: 读取指定滤波器的参数
**请求格式（63字节）**:
**请求格式（64 字节）**:
| 偏移 | 长度 | 字段名 | 描述 |
|:----:|:----:|:------:|:----:|
| 0 | 1 | sync_header | 同步头: 0x77 |
| 1 | 1 | cmd_header | 命令头: 0x8E |
| 2 | 4 | sample_rate | 采样率 (Hz, 32位小端) |
| 6 | 1 | eq_index | 要读取的EQ索引 (0-7) |
| 7-62 | 56 | reserved | 保留字段（填充0） |
| 0 | 1 | report_id | 固定为 0x01 |
| 1 | 1 | sync_header | 同步头: 0x77 |
| 2 | 1 | cmd_header | 命令头: 0x8E |
| 3 | 1 | mode | 模式值（0-9） |
| 4 | 1 | band | 滤波器索引（0-7） |
| 5-63 | 59 | reserved | 保留字段（填充0） |
**响应格式（63字节）**:
**响应格式（64 字节）**:
| 偏移 | 长度 | 字段名 | 描述 |
|:----:|:----:|:------:|:----:|
| 0 | 1 | sync_header | 同步头: 0x77 |
| 1 | 1 | cmd_header | 命令头: 0x8E (回显) |
| 2 | 4 | sample_rate | 采样率 (Hz, 32位小端) |
| 6 | 1 | total_gain_db | 总增益补偿 (dB, 8位有符号整数) |
| 7 | 1 | eq_index | EQ索引 (0-7) |
| 8 | 1 | filter_type | 滤波器类型码 |
| 9 | 4 | fc | 中心频率 (Hz, 32位无符号整数) |
| 13 | 4 | q_value | Q值 (Q15.15格式, 32位有符号整数) |
| 17 | 4 | bandwidth | 带宽 (Hz, 32位无符号整数) |
| 21 | 4 | gain | 增益 (Q15.15格式, 32位有符号整数) |
| 25 | 38 | reserved | 保留字段（填充0） |
| 0 | 1 | report_id | 固定为 0x01 |
| 1 | 1 | sync_header | 同步头: 0x77 |
| 2 | 1 | cmd_header | 命令头: 0x8E（回显） |
| 3 | 1 | mode | 模式值 |
| 4 | 1 | band | 滤波器索引 |
| 5 | 1 | type | 滤波器类型码 |
| 6-9 | 4 | freq | 中心频率 Hz（float, 小端序） |
| 10-13 | 4 | q | Q 值（float, 小端序） |
| 14-17 | 4 | bw | 带宽 Hz（float, 小端序） |
| 18-21 | 4 | gain | 增益 dB（float, 小端序） |
| 22-63 | 41 | reserved | 保留字段（填充0） |
#### 2.2.5 保存用户模式（0x8F）
**功能说明**: 将当前EQ参数保存到指定用户模式
**请求格式（63字节）**:
| 偏移 | 长度 | 字段名 | 描述 |
|:----:|:----:|:------:|:----:|
| 0 | 1 | sync_header | 同步头: 0x77 |
| 1 | 1 | cmd_header | 命令头: 0x8F |
| 2 | 4 | sample_rate | 采样率 (Hz, 32位小端) |
| 6 | 1 | user_mode | 用户模式索引 (6-7) |
| 7 | 1 | source_mode | 源模式索引 (当前活动模式，用于复制参数) |
| 8-62 | 55 | reserved | 保留字段（填充0） |
#### 2.2.6 读取所有模式信息（0x90）
**功能说明**: 获取所有模式的基本信息和状态
**请求格式（63字节）**:
| 偏移 | 长度 | 字段名 | 描述 |
|:----:|:----:|:------:|:----:|
| 0 | 1 | sync_header | 同步头: 0x77 |
| 1 | 1 | cmd_header | 命令头: 0x90 |
| 2 | 4 | sample_rate | 采样率 (Hz, 32位小端) |
| 6-62 | 57 | reserved | 保留字段（填充0） |
**响应格式（63字节）**:
| 偏移 | 长度 | 字段名 | 描述 |
|:----:|:----:|:------:|:----:|
| 0 | 1 | sync_header | 同步头: 0x77 |
| 1 | 1 | cmd_header | 命令头: 0x90 (回显) |
| 2 | 4 | sample_rate | 采样率 (Hz, 32位小端) |
| 6 | 1 | current_mode | 当前活动模式 |
| 7 | 1 | eq_enabled | EQ总开关状态 (0: 关闭, 1: 开启) |
| 8 | 8 | mode_status | 模式状态数组 (每字节对应一个模式: 0=默认, 1=已修改, 2=已保存) |
| 16 | 8 | mode_names | 模式名称索引 (预设模式的名称标识) |
| 24 | 39 | reserved | 保留字段（填充0） |
#### 2.2.7 重置用户模式（0x91）
**功能说明**: 将用户模式重置为默认状态
**请求格式（63字节）**:
| 偏移 | 长度 | 字段名 | 描述 |
|:----:|:----:|:------:|:----:|
| 0 | 1 | sync_header | 同步头: 0x77 |
| 1 | 1 | cmd_header | 命令头: 0x91 |
| 2 | 4 | sample_rate | 采样率 (Hz, 32位小端) |
| 6 | 1 | user_mode | 要重置的用户模式索引 (6-7, 0xFF表示重置所有用户模式) |
| 7-62 | 56 | reserved | 保留字段（填充0） |
#### 2.2.8 获取设备信息（0x92）
#### 2.2.6 获取设备信息（0x8F）
**功能说明**: 获取设备的基本标识信息
**请求格式（63字节）**:
**请求格式（64 字节）**:
| 偏移 | 长度 | 字段名 | 描述 |
|:----:|:----:|:------:|:----:|
| 0 | 1 | sync_header | 同步头: 0x77 |
| 1 | 1 | cmd_header | 命令头: 0x92 |
| 2 | 4 | sample_rate | 采样率 (Hz, 32位小端) |
| 6-62 | 57 | reserved | 保留字段（填充0） |
| 0 | 1 | report_id | 固定为 0x01 |
| 1 | 1 | sync_header | 同步头: 0x77 |
| 2 | 1 | cmd_header | 命令头: 0x8F |
| 3-63 | 61 | reserved | 保留字段（填充0） |
**响应格式（63字节）**:
**响应格式（64 字节）**:
| 偏移 | 长度 | 字段名 | 描述 |
|:----:|:----:|:------:|:----:|
| 0 | 1 | sync_header | 同步头: 0x77 |
| 1 | 1 | cmd_header | 命令头: 0x92 (回显) |
| 2 | 4 | sample_rate | 采样率 (Hz, 32位小端) |
| 6 | 2 | vendor_id | 厂商ID (VID, 16位小端) |
| 8 | 2 | product_id | 产品ID (PID, 16位小端) |
| 10 | 2 | device_version | 设备版本号 (BCD格式) |
| 12 | 32 | device_name | 设备名称 (UTF-8编码, 以\0结尾) |
| 44 | 4 | serial_number | 序列号 (32位无符号整数) |
| 48 | 2 | protocol_ver | 协议版本 (主版本.次版本, 各占1字节) |
| 50 | 1 | eq_band_count | 支持的EQ频段数量 |
| 51 | 1 | mode_count | 支持的模式数量 |
| 52 | 11 | reserved | 保留字段（填充0） |
| 0 | 1 | report_id | 固定为 0x01 |
| 1 | 1 | sync_header | 同步头: 0x77 |
| 2 | 1 | cmd_header | 命令头: 0x8F（回显） |
| 3-4 | 2 | pid | 产品ID（uint16, 小端序） |
| 5-6 | 2 | vid | 厂商ID（uint16, 小端序） |
| 7-22 | 16 | product | 产品字符串（UTF-8） |
| 23-38 | 16 | vendor | 厂商字符串（UTF-8） |
| 39-54 | 16 | sn | 序列号字符串（UTF-8） |
| 55-63 | 9 | reserved | 保留字段（填充0） |
#### 2.2.7 复位 EQ 参数（0x90）
**功能说明**: 复位指定模式或全部模式的 EQ 参数
**请求格式（64 字节）**:
| 偏移 | 长度 | 字段名 | 描述 |
|:----:|:----:|:------:|:----:|
| 0 | 1 | report_id | 固定为 0x01 |
| 1 | 1 | sync_header | 同步头: 0x77 |
| 2 | 1 | cmd_header | 命令头: 0x90 |
| 3 | 1 | mode | 模式号（0-9，0xFF 表示复位所有模式） |
| 4-63 | 60 | reserved | 保留字段（填充0） |
**响应格式（64 字节）**:
| 偏移 | 长度 | 字段名 | 描述 |
|:----:|:----:|:------:|:----:|
| 0 | 1 | report_id | 固定为 0x01 |
| 1 | 1 | sync_header | 同步头: 0x77 |
| 2 | 1 | cmd_header | 命令头: 0x90（回显） |
| 3 | 1 | status | 状态码（0x00=成功, 0x01=失败） |
| 4-63 | 60 | reserved | 保留字段（填充0） |
## 三、数据流程和时序 :material-timeline-clock:
### 3.1 典型操作流程
#### 3.1.1 模式切换流程
1. GUI发送SET_EQ_MODE命令 (0x8C)
1. GUI发送SET_EQ_MODE命令 (0x8A)
2. 设备更新内部模式状态
3. GUI发送READ_EQ_MODE命令 (0x8B) 确认
3. GUI发送GET_EQ_MODE命令 (0x8B) 确认
4. 设备响应当前模式状态
#### 3.1.2 参数设置流程
1. GUI发送SET_EQ_MODE命令切换到相应模式 (0x8C)
1. GUI发送SET_EQ_MODE命令切换到相应模式 (0x8A)
2. 逐个发送8个滤波器的命令 (0x8D)
3. 设备接收并更新内部参数缓存
4. 可选: 发送READ_EQ_PARAMS命令验证参数
4. 可选: 发送GET_EQ_PARAMS命令验证参数 (0x8E)
#### 3.1.3 参数读取流程
1. GUI发送SET_EQ_MODE命令切换到相应模式 (0x8C)
2. GUI发送READ_EQ_PARAMS请求 (0x8E)
1. GUI发送SET_EQ_MODE命令切换到相应模式 (0x8A)
2. GUI发送GET_EQ_PARAMS请求 (0x8E)
3. 设备准备响应数据
4. GUI读取响应
@@ -292,18 +282,19 @@ search:
!!! danger "协议限制和约束"
**硬件限制**
- **滤波器数量**: 固定8个滤波器（MAX_EQ_BANDS = 8）
- **模式数量**: 支持8个EQ模式（0-5为预设模式，6-7为用户模式）+ 1个禁用模式（8）
- **采样率支持**: 44.1kHz, 48kHz, 88.2kHz, 96kHz, 176.4kHz, 192kHz
- **滤波器数量**: 固定 8 个滤波器（MAX_EQ_BANDS = 8）
- **模式数量**: 0-5 为预设模式，6-8 为用户模式，9 为 Bypass 模式
- **采样率支持**: 44.1kHz, 48kHz, 88.2kHz, 96kHz, 176.4kHz, 192kHz（设备能力，与协议字段独立）
**参数范围**
| 参数 | 范围 | 格式 |
|:----:|:----:|:----:|
| 中心频率 (fc) | 20Hz - 20kHz | 32位无符号整数 |
| Q值 | 0.1 - 30.0 | Q15.15格式 |
| 增益 | -24dB - +24dB | Q15.15格式 |
| 总增益 | -24dB - 0dB | 8位有符号整数 |
| 中心频率 (freq) | 20Hz - 20kHz | float（小端） |
| Q值 (q) | 0.1 - 30.0 | float（小端） |
| 带宽 (bw) | 1Hz - 20kHz | float（小端） |
| 增益 (gain) | -24dB - +24dB | float（小端） |
| 整体增益 (mode gain) | -50dB - 0dB | int32（小端） |
## 四、预设模式定义 :material-equalizer:
@@ -311,7 +302,7 @@ search:
| 模式索引 | 模式名称 | 用途描述 | 类型 |
|:--------:|:--------:|:--------:|:----:|
| 0 | Flat/Linear | 平坦响应，无EQ处理 | 预设模式 |
| 0 | Flat/Linear | 平坦响应，无 EQ 处理 | 预设模式 |
| 1 | Pop/Rock | 流行摇滚音乐优化 | 预设模式 |
| 2 | Classical | 古典音乐优化 | 预设模式 |
| 3 | Jazz | 爵士音乐优化 | 预设模式 |
@@ -319,12 +310,13 @@ search:
| 5 | Bass Boost | 低音增强 | 预设模式 |
| 6 | User 1 | 用户自定义模式1 | 用户模式 |
| 7 | User 2 | 用户自定义模式2 | 用户模式 |
| 8 | Disabled | EQ功能禁用 | 特殊模式 |
| 8 | User 3 | 用户自定义模式3 | 用户模式 |
| 9 | Bypass | EQ 功能旁路 | 特殊模式 |
!!! info "模式特性说明"
- **预设模式**: 出厂预设，不可修改，针对特定音乐类型优化
- **用户模式**: 支持用户自定义参数，可保存和重置
- **禁用模式**: 完全关闭EQ处理，音频信号直通
- **旁路模式**: 完全关闭 EQ 处理，音频信号直通（Bypass）
---

225
zh/docs/dev_doc/protocols/XMOS_EQ_UART_Protocol.md Normal file
View File

@@ -0,0 +1,225 @@
---
title: XMOS EQ UART 控制协议与命令集
description: EQ 参数配置与控制的 UART 串口通信协议规范，涵盖帧格式、命令集与字段说明，适用于 XU316 等相关产品。
keywords: EQ, UART, 串口协议, 通信协议, 命令集, XU316,免开发固件, Phaten Audio
---
# XMOS EQ UART 控制协议与命令集
--8<-- "common/phaten_xmos_support_img.md"
## 1. 协议基础规范
### 1.1 底层通信协议
基于 UART (Universal Asynchronous Receiver/Transmitter) 协议。
| 参数 | 值 |
| :--- | :--- |
| 波特率 | 115200 bps |
| 数据位 | 8 |
| 奇偶校验 | 无 |
| 停止位 | 1 |
| 数据流控 | 无 |
### 1.2 帧格式与数据传输
**通用帧格式**
所有命令和响应均遵循以下帧格式：
| 字段 | 字节数 | 说明 |
| :--- | :--- | :--- |
| 帧头 | 2 | 固定为 `0x55 0xAA` |
| 版本 | 1 | 协议版本号 (通常为 `0x00`) |
| 命令字 | 1 | 指示帧的功能 (如 `0x30`) |
| 数据长度 | 1 | 后续数据的长度 N |
| 数据 | N | 具体的数据内容 |
| 校验和 | 1 | 从帧头开始按字节求和，结果对 256 求余 (Sum % 256) |
**数据传输说明**
* **字节序**：所有大于1个字节的数据均采用 **小端模式 (Little Endian)** 传输（注：与XU316标准协议的大端序不同，请以本协议为准）。
* **浮点数**：遵循 IEEE 754 float 格式。
---
## 2. 协议命令集
### 2.1 命令分类概览
| 命令字 | 命令描述 | 发送方向 | 功能说明 |
| :--- | :--- | :--- | :--- |
| **0x30** | SET_EQ_MODE | 主机→设备 | 切换当前的 EQ 模式 |
| **0x31** | GET_EQ_MODE | 主机→设备 | 获取当前 EQ 模式信息 (模式号、增益、名称) |
| **0x32** | SET_MODE_GAIN_AND_NAME | 主机→设备 | 设置指定模式的整体增益和名称 |
| **0x33** | SET_EQ_PARAMS | 主机→设备 | 发送单个滤波器的参数 (Freq, Q, Gain 等) |
| **0x34** | GET_EQ_PARAMS | 主机→设备 | 读取单个滤波器的参数 |
| **0x35** | RESET_EQ_PARAMS | 主机→设备 | 复位 EQ 参数 (恢复预设) |
---
## 3. 基础功能命令详解
### 3.1 切换 EQ 模式 (0x30)
**主机发送**
| 字节位置 | 长度 | 内容 | 说明 |
| :--- | :--- | :--- | :--- |
| Frame Header | 2 | `0x55 0xAA` | 固定帧头 |
| Version | 1 | `0x00` | 协议版本 |
| Command | 1 | `0x30` | 命令字 |
| Length | 1 | `0x01` | 数据长度 |
| Data | 1 | `Mode` | 模式值<br>0-5: 预设模式<br>6-8: 用户模式<br>9: Bypass |
| Checksum | 1 | `Sum` | 校验和 |
**设备端处理**
* 直接设置当前运行的 EQ 模式。
* 不涉及参数传输或计算。
---
### 3.2 获取当前 EQ 模式信息 (0x31)
**主机发送**
| 字节位置 | 长度 | 内容 | 说明 |
| :--- | :--- | :--- | :--- |
| Frame Header | 2 | `0x55 0xAA` | 固定帧头 |
| Version | 1 | `0x00` | 协议版本 |
| Command | 1 | `0x31` | 命令字 |
| Length | 1 | `0x00` | 无数据 |
| Checksum | 1 | `Sum` | 校验和 |
**设备返回 (响应)**
| 字节位置 | 长度 | 内容 | 说明 |
| :--- | :--- | :--- | :--- |
| Frame Header | 2 | `0x55 0xAA` | 固定帧头 |
| Version | 1 | `0x00` | 协议版本 |
| Command | 1 | `0x31` | 命令字 |
| Length | 1 | `0x15` | 数据长度 (21字节) |
| Data | 1 | `Mode` | 当前模式值 |
| | 4 | `Gain` | 整体增益 (int32, 小端序, 范围 0~-50dB) |
| | 16 | `Name` | 模式名称 (UTF-8 字符串) |
| Checksum | 1 | `Sum` | 校验和 |
---
### 3.3 设置模式整体增益和名称 (0x32)
**主机发送**
| 字节位置 | 长度 | 内容 | 说明 |
| :--- | :--- | :--- | :--- |
| Frame Header | 2 | `0x55 0xAA` | 固定帧头 |
| Version | 1 | `0x00` | 协议版本 |
| Command | 1 | `0x32` | 命令字 |
| Length | 1 | `0x15` | 数据长度 (21字节) |
| Data | 1 | `Mode` | 目标模式值 (0-9) |
| | 4 | `Gain` | 整体增益 (int32, 小端序) |
| | 16 | `Name` | 模式名称 (UTF-8 字符串) |
| Checksum | 1 | `Sum` | 校验和 |
**设备端处理**
* 设置指定模式的增益和名称，自动应用到所有采样率。
---
### 3.4 发送 EQ 参数 (0x33)
**主机发送**
| 字节位置 | 长度 | 内容 | 说明 |
| :--- | :--- | :--- | :--- |
| Frame Header | 2 | `0x55 0xAA` | 固定帧头 |
| Version | 1 | `0x00` | 协议版本 |
| Command | 1 | `0x33` | 命令字 |
| Length | 1 | `0x15` | 数据长度 (21字节) |
| Data | 1 | `Mode` | 模式值 (0-9) |
| | 1 | `Band` | 滤波器索引 (0-7) |
| | 1 | `Type` | 滤波器类型 (见下表) |
| | 4 | `Freq` | 中心频率 Hz (float, 小端序) |
| | 4 | `Q` | Q值 (float, 小端序) |
| | 4 | `BW` | 带宽 Hz (float, 小端序) |
| | 4 | `Gain` | 增益 dB (float, 小端序) |
| Checksum | 1 | `Sum` | 校验和 |
**滤波器类型码**
| 代码 | 类型 | 代码 | 类型 |
| :--- | :--- | :--- | :--- |
| 0x00 | Bypass | 0x06 | 带阻 (Band Reject) |
| 0x01 | 全通 (All Pass) | 0x07 | 陷波 (Notch) |
| 0x02 | 峰值 (Peak) | 0x08 | 恒定Q (Constant Q) |
| 0x03 | 低通 (Low Pass) | 0x09 | 低架 (Low Shelf) |
| 0x04 | 高通 (High Pass) | 0x0A | 高架 (High Shelf) |
| 0x05 | 带通 (Band Pass) | | |
---
### 3.5 读取 EQ 参数 (0x34)
**主机发送**
| 字节位置 | 长度 | 内容 | 说明 |
| :--- | :--- | :--- | :--- |
| Frame Header | 2 | `0x55 0xAA` | 固定帧头 |
| Version | 1 | `0x00` | 协议版本 |
| Command | 1 | `0x34` | 命令字 |
| Length | 1 | `0x02` | 数据长度 |
| Data | 1 | `Mode` | 模式值 (0-9) |
| | 1 | `Band` | 滤波器索引 (0-7) |
| Checksum | 1 | `Sum` | 校验和 |
**设备返回 (响应)**
| 字节位置 | 长度 | 内容 | 说明 |
| :--- | :--- | :--- | :--- |
| Frame Header | 2 | `0x55 0xAA` | 固定帧头 |
| Version | 1 | `0x00` | 协议版本 |
| Command | 1 | `0x34` | 命令字 |
| Length | 1 | `0x15` | 数据长度 (21字节) |
| Data | 1 | `Mode` | 模式值 |
| | 1 | `Band` | 滤波器索引 |
| | 1 | `Type` | 滤波器类型 |
| | 4 | `Freq` | 中心频率 (float, 小端序) |
| | 4 | `Q` | Q值 (float, 小端序) |
| | 4 | `BW` | 带宽 (float, 小端序) |
| | 4 | `Gain` | 增益 (float, 小端序) |
| Checksum | 1 | `Sum` | 校验和 |
---
### 3.6 复位 EQ 参数 (0x35)
**主机发送**
| 字节位置 | 长度 | 内容 | 说明 |
| :--- | :--- | :--- | :--- |
| Frame Header | 2 | `0x55 0xAA` | 固定帧头 |
| Version | 1 | `0x00` | 协议版本 |
| Command | 1 | `0x35` | 命令字 |
| Length | 1 | `0x01` | 数据长度 |
| Data | 1 | `Mode` | 模式号 (0-9)<br>`0xFF` 表示复位所有模式 |
| Checksum | 1 | `Sum` | 校验和 |
**设备返回 (响应)**
| 字节位置 | 长度 | 内容 | 说明 |
| :--- | :--- | :--- | :--- |
| Frame Header | 2 | `0x55 0xAA` | 固定帧头 |
| Version | 1 | `0x00` | 协议版本 |
| Command | 1 | `0x35` | 命令字 |
| Length | 1 | `0x01` | 数据长度 |
| Data | 1 | `Status` | 状态码 (0x00=成功, 0x01=失败) |
| Checksum | 1 | `Sum` | 校验和 |
## 咨询反馈
<details>
<summary>点击展开咨询反馈表单</summary>
--8<-- "common/customer_form.md"
</details>

4
zh/docs/dev_doc/protocols/xu316_zerocode_protocol.md
View File

@@ -754,7 +754,7 @@ sequenceDiagram
版本: 1字节 - 0x03
命令字: 1字节 - 0xF1
数据长度: 1字节 - 2
数据: 2字节 -
数据: 0字节 -
校验和: 1字节 - 从帧头开始按字节求和，结果对256求余
```
@@ -764,7 +764,7 @@ sequenceDiagram
版本: 1字节 - 0x00
命令字: 1字节 - 0xF1
数据长度: 1字节 - 0
数据: 0字节
数据: 3字节
校验和: 1字节 - 从帧头开始按字节求和，结果对256求余
```

6
zh/docs/dev_doc/sdk_examples/XU316_MCU_Communication_Examples/index.md
View File

@@ -19,7 +19,7 @@ keywords: XU316开发, MCU通信开发, 音频接口控制, 通信协议, 开发
=== "第一步：了解基础概念和协议结构"
**目标**：理解XU316与MCU通信的基本概念和协议结构
**参考文档**：[:material-file-document-outline: XU316与MCU通信协议命令宏定义](命令的相关宏.md)
**参考文档**：[:material-file-document-outline: XU316与MCU通信协议命令宏定义](./Command_Macros.md)
**学习要点**：
@@ -31,7 +31,7 @@ keywords: XU316开发, MCU通信开发, 音频接口控制, 通信协议, 开发
=== "第二步：实现基础通信功能"
**目标**：实现XU316与MCU的基础通信功能
**参考文档**：[:material-file-document-outline: XU316与MCU通信协议参考](命令相关.md)
**参考文档**：[:material-file-document-outline: XU316与MCU通信协议参考](./Command_Reference.md)
**开发任务**：
@@ -44,7 +44,7 @@ keywords: XU316开发, MCU通信开发, 音频接口控制, 通信协议, 开发
=== "第三步：配置音频接口和参数"
**目标**：配置XU316的音频接口和相关参数
**参考文档**：[:material-file-document-outline: XU316音频接口控制代码示例](产品内容相关.md)
**参考文档**：[:material-file-document-outline: XU316音频接口控制代码示例](./Product_Content.md)
**开发任务**：