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

update

Browse Source 
更新免开发协议内容，加入0x30.修改其他错误
This commit is contained in:
PhatenIoT-yan
2026-06-06 11:17:45 +08:00
parent 1542d74792
commit 68212b418b
3 changed files with 223 additions and 29 deletions
Download Patch File Download Diff File Expand all files Collapse all files

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

@@ -228,6 +228,7 @@ sequenceDiagram
| 0x27 | 设置 unmute | MCU→XU316 |
| 0x28 | 发送音频格式的时间延迟 | MCU→XU316 |
| 0x29 | 报告USB连接状态 | XU316→MCU |
| 0x30 | 设置Mute引脚反转 | MCU→XU316 |
=== "HID-MCU互相透传命令(0xEE-0xEF)"
| 命令字 | 命令描述 | 发送方向 |
@@ -373,7 +374,7 @@ sequenceDiagram
**命令示例**
```
55 AA 03 01 3C 20 B1 00 17 20 B1 00 16 50 48 41 54 45 4E 00 00 00 00 00 00 00 00 00 00 58 55 33 31 36 20 44 41 43 00 00 00 00 00 00 00 53 4E 32 34 30 30 30 31 00 00 00 00 00 00 00 00 12 34 56 78 D9
55 AA 03 01 3C 20 B1 00 17 20 B1 00 16 50 48 41 54 45 4E 00 00 00 00 00 00 00 00 00 00 58 55 33 31 36 20 44 41 43 00 00 00 00 00 00 00 53 4E 32 34 30 30 30 31 00 00 00 00 00 00 00 00 27 2B F6 44 51
```
**逐段解析**
@@ -391,8 +392,8 @@ sequenceDiagram
| ManufactureName | 16字节 | `50 48 41 54 45 4E 00 00 00 00 00 00 00 00 00 00` | ASCII 字符串 `PHATEN`，后面不足 16 字节的部分用 `00` 补齐 |
| ProductName | 16字节 | `58 55 33 31 36 20 44 41 43 00 00 00 00 00 00 00` | ASCII 字符串 `XU316 DAC`，后面用 `00` 补齐到 16 字节 |
| SerialNumber | 16字节 | `53 4E 32 34 30 30 30 31 00 00 00 00 00 00 00 00` | ASCII 字符串 `SN240001`，后面用 `00` 补齐到 16 字节 |
| CRC | 4字节 | `12 34 56 78` | 产品基础信息的 32 位 CRC 校验值，这里仅作为示例演示 |
| 校验和 | 1字节 | `D9` | 从 `55` 开始到 `78` 结束，所有字节相加后对 256 取余的结果 |
| CRC | 4字节 | `27 2B F6 44` | 产品基础信息的 32 位 CRC 校验值（小端序），这里仅作为示例演示 |
| 校验和 | 1字节 | `51` | 从 `55` 开始到 `44` 结束，所有字节相加后对 256 取余的结果 |
#### 3.2.3 读取上电配置信息（0x02）
@@ -437,7 +438,7 @@ sequenceDiagram
**命令示例**
```
55 AA 03 02 0E 01 00 00 00 00 01 2C 20 30 30 11 22 33 44 6A
55 AA 03 02 0E 01 00 00 00 00 01 2C 20 30 30 C1 7A 1E 1A 33
```
**逐段解析**
@@ -453,8 +454,8 @@ sequenceDiagram
| 麦克风默认音量 | 1字节 | `20` | 示例默认麦克风音量 |
| DAC左声道默认音量 | 1字节 | `30` | 示例默认左声道音量 |
| DAC右声道默认音量 | 1字节 | `30` | 示例默认右声道音量 |
| CRC | 4字节 | `11 22 33 44` | 上电配置的 32 位 CRC 校验值，这里仅作为示例演示 |
| 校验和 | 1字节 | `6A` | 从 `55` 开始到 `44` 结束，所有字节相加后对 256 取余的结果 |
| CRC | 4字节 | `C1 7A 1E 1A` | 上电配置的 32 位 CRC 校验值（小端序），这里仅作为示例演示 |
| 校验和 | 1字节 | `33` | 从 `55` 开始到 `1A` 结束，所有字节相加后对 256 取余的结果 |
#### 3.2.4 获取当前输入输出模式（0x03）
@@ -534,7 +535,7 @@ sequenceDiagram
**命令示例**
```
55 AA 03 04 0E 02 00 00 00 00 00 C8 18 28 28 55 66 77 88 00
55 AA 03 04 0E 02 00 00 00 00 00 C8 18 28 28 3A 8A 5B 2E 93
```
**逐段解析**
@@ -550,8 +551,8 @@ sequenceDiagram
| 麦克风音量 | 1字节 | `18` | 示例当前麦克风音量 |
| DAC左声道音量 | 1字节 | `28` | 示例当前左声道音量 |
| DAC右声道音量 | 1字节 | `28` | 示例当前右声道音量 |
| CRC | 4字节 | `55 66 77 88` | 用户配置的 32 位 CRC 校验值，这里仅作为示例演示 |
| 校验和 | 1字节 | `00` | 从 `55` 开始到 `88` 结束，所有字节相加后对 256 取余的结果 |
| CRC | 4字节 | `3A 8A 5B 2E` | 用户配置的 32 位 CRC 校验值（小端序），这里仅作为示例演示 |
| 校验和 | 1字节 | `93` | 从 `55` 开始到 `2E` 结束，所有字节相加后对 256 取余的结果 |
#### 3.2.6 启动完成命令（0x05）
@@ -700,6 +701,7 @@ sequenceDiagram
=== "MCU发送示例"
**命令示例**
```
55 AA 03 21 01 02 26
```
@@ -790,6 +792,7 @@ sequenceDiagram
=== "MCU发送示例"
**命令示例**
```
55 AA 03 23 05 02 00 00 00 00 2C
```
@@ -925,6 +928,7 @@ sequenceDiagram
=== "MCU发送示例"
**命令示例**
```
55 AA 03 26 01 01 2A
```
@@ -1039,7 +1043,64 @@ sequenceDiagram
| 数据长度 | 1字节 | `00` | 表示这是一条纯确认帧，不携带额外数据 |
| 校验和 | 1字节 | `2B` | 从 `55` 开始到 `00` 结束，所有字节相加后对 256 取余的结果 |
#### 3.3.11 获取固件版本命令（0xF1）
#### 3.3.11 设置Mute引脚反转（0x30）
=== "命令格式"
**MCU发送**
```
帧头: 2字节 - 0x55aa
版本: 1字节 - 0x03
命令字: 1字节 - 0x30
数据长度: 1字节 - 0x01
数据: 1字节
B0: 反转标志
0x00 = 正常逻辑（高电平解除静音，低电平静音）
0x01 = 反转逻辑（低电平解除静音，高电平静音）
校验和: 1字节 - 从帧头开始按字节求和，结果对256求余
```
**XU316返回**
```
帧头: 2字节 - 0x55aa
版本: 1字节 - 0x00
命令字: 1字节 - 0x30
数据长度: 1字节 - 0x01
数据: 1字节
B0: 当前反转标志状态
0x00 = 正常逻辑
0x01 = 反转逻辑
校验和: 1字节 - 从帧头开始按字节求和，结果对256求余
```
=== "功能说明"
1. 该命令用于设置Mute引脚的输出逻辑反转
2. 当某些硬件设计的Mute逻辑与默认相反时，使用此命令进行适配
3. 配置会自动保存到Flash，断电后保持
4. 设置后立即生效，并返回当前状态
=== "使用场景"
- 硬件设计中Mute脚极性与默认相反
- 需要适配不同硬件版本的设备
=== "MCU示例"
**命令示例**
```
55 AA 03 30 01 01 34
```
**逐段解析**
| 字节段 | 长度 | 示例值 | 说明 |
|:-------|:-----|:-------|:-----|
| 帧头 | 2字节 | `55 AA` | 固定帧头 |
| 版本 | 1字节 | `03` | MCU发送给XU316 |
| 命令字 | 1字节 | `30` | 设置Mute引脚反转 |
| 数据长度 | 1字节 | `01` | 1字节数据 |
| 反转标志 | 1字节 | `01` | 0x01=反转逻辑 |
| 校验和 | 1字节 | `34` | 从 `55` 开始到反转标志结束，所有字节相加后对 256 取余的结果 |
#### 3.3.12 获取固件版本命令（0xF1）
=== "命令格式"
**MCU发送**
@@ -1067,6 +1128,7 @@ sequenceDiagram
=== "MCU发送示例"
**命令示例**
```
55 AA 03 F1 02 00 00 F5
```
@@ -1115,6 +1177,7 @@ sequenceDiagram
=== "MCU发送示例"
**命令示例**
```
55 AA 03 F0 04 00 00 00 00 F6
```