From 464ae5f8d3da21241cba4a0eceec4cf6b455b862 Mon Sep 17 00:00:00 2001 From: PhatenIoT-yan <168261949+PhatenIoT@users.noreply.github.com> Date: Tue, 21 Apr 2026 17:43:55 +0800 Subject: [PATCH] update MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 更新免开发文档的内容和协议文档 --- .../std_product/hifi_audio/hf83311_vc1.md | 4 +-- .../std_product/hifi_audio/hf86611_vc1.md | 4 +-- .../std_product/hifi_audio/hf87621_vc1.md | 4 +-- .../protocols/xu316_zerocode_protocol.md | 33 ++++++++++++++++++- .../std_product/hifi_audio/hf83311_vc1.md | 6 ++-- .../std_product/hifi_audio/hf86611_vc1.md | 6 ++-- .../std_product/hifi_audio/hf87621_vc1.md | 6 ++-- .../protocols/xu316_zerocode_protocol.md | 33 ++++++++++++++++++- 8 files changed, 79 insertions(+), 17 deletions(-) mode change 100644 => 100755 zh/docs/dev_doc/protocols/xu316_zerocode_protocol.md diff --git a/en/docs/dev_doc/datasheet/std_product/hifi_audio/hf83311_vc1.md b/en/docs/dev_doc/datasheet/std_product/hifi_audio/hf83311_vc1.md index 5060e81..3c990a9 100644 --- a/en/docs/dev_doc/datasheet/std_product/hifi_audio/hf83311_vc1.md +++ b/en/docs/dev_doc/datasheet/std_product/hifi_audio/hf83311_vc1.md @@ -179,8 +179,8 @@ HF83311_VC1/HF83311Q_VC1 provides multiple input and output modes, including USB | 20 | GND | P | Module ground | | 21 | X0D30 | I/O | CTL_MUTE; control output, active high | | 22 | X0D31 | I/O | NC | -| 23 | X0D32 | I/O | NC | -| 24 | X0D33 | I/O | NC | +| 23 | X0D32 | I/O | 49.152 MHz clock control | +| 24 | X0D33 | I/O | 45.1584 MHz clock control | | 25 | GND | P | Module ground | | 26 | GND | P | Module ground | | 27 | GND | P | Module ground | diff --git a/en/docs/dev_doc/datasheet/std_product/hifi_audio/hf86611_vc1.md b/en/docs/dev_doc/datasheet/std_product/hifi_audio/hf86611_vc1.md index 792c481..c149e84 100644 --- a/en/docs/dev_doc/datasheet/std_product/hifi_audio/hf86611_vc1.md +++ b/en/docs/dev_doc/datasheet/std_product/hifi_audio/hf86611_vc1.md @@ -165,8 +165,8 @@ HF86611_VC1/HF86611Q_VC1 provides multiple input and output modes, including USB | 20 | GND | P | Module ground | | 21 | X0D30 | I/O | CTL_MUTE; control output, active high | | 22 | X0D31 | I/O | NC | -| 23 | X0D32 | I/O | NC | -| 24 | X0D33 | I/O | NC | +| 23 | X0D32 | I/O | 49.152 MHz clock control | +| 24 | X0D33 | I/O | 45.1584 MHz clock control | | 25 | GND | P | Module ground | | 26 | GND | P | Module ground | | 27 | GND | P | Module ground | diff --git a/en/docs/dev_doc/datasheet/std_product/hifi_audio/hf87621_vc1.md b/en/docs/dev_doc/datasheet/std_product/hifi_audio/hf87621_vc1.md index 6c66758..0902aad 100644 --- a/en/docs/dev_doc/datasheet/std_product/hifi_audio/hf87621_vc1.md +++ b/en/docs/dev_doc/datasheet/std_product/hifi_audio/hf87621_vc1.md @@ -182,8 +182,8 @@ HF87621_VC1/HF87621Q_VC1 provides multiple input and output modes, including USB | 20 | GND | P | Module Ground | | 21 | X0D30 | I/O | CTL_MUTE；控制输出，高电平有效 | | 22 | X0D31 | I/O | NC | -| 23 | X0D32 | I/O | NC | -| 24 | X0D33 | I/O | NC | +| 23 | X0D32 | I/O | 49.152 MHz clock control | +| 24 | X0D33 | I/O | 45.1584 MHz clock control | | 25 | GND | P | Module Ground | | 26 | GND | P | Module Ground | | 27 | GND | P | Module Ground | diff --git a/en/docs/dev_doc/protocols/xu316_zerocode_protocol.md b/en/docs/dev_doc/protocols/xu316_zerocode_protocol.md index d3da4cf..4319443 100644 --- a/en/docs/dev_doc/protocols/xu316_zerocode_protocol.md +++ b/en/docs/dev_doc/protocols/xu316_zerocode_protocol.md @@ -225,6 +225,7 @@ sequenceDiagram | 0x24 | XU316 send playback volume | XU316→MCU | | 0x25 | Send recording volume | XU316→MCU | | 0x26 | Switch MCLK | MCU→XU316 | + | 0x29 | Report USB connection status | XU316→MCU | === "HID-MCU Passthrough Commands (0xEE-0xEF)" | Command | Command Description | Direction | @@ -745,7 +746,37 @@ sequenceDiagram === "Function Description" - Send audio format time delay -#### 3.3.10 Get Firmware Version Command (0xF1) +#### 3.3.10 Report USB Connection Status (0x29) + +=== "Command Format" + **XU316 Sends** + ``` + Frame Header: 2 bytes - 0x55aa + Version: 1 byte - 0x00 + Command: 1 byte - 0x29 + Data Length: 1 byte - 0x01 (1 byte) + Data: 1 byte - USB connection status + 0x00 USB disconnected / not connected + 0x01 USB connected + Checksum: 1 byte - Sum of all bytes from frame header, modulo 256 + ``` + + **MCU Returns** + ``` + Frame Header: 2 bytes - 0x55aa + Version: 1 byte - 0x03 + Command: 1 byte - 0x29 + Data Length: 1 byte - 0x00 + Data: 0 bytes + Checksum: 1 byte - Sum of all bytes from frame header, modulo 256 + ``` + +=== "Function Description" + - This command is used by XU316 to report the current USB connection status to the MCU + - When the USB connection status changes (connect or disconnect), XU316 proactively sends this command + - The MCU can use this information to update the UI or adjust related functions + +#### 3.3.11 Get Firmware Version Command (0xF1) === "Command Format" **MCU Sends** diff --git a/zh/docs/dev_doc/datasheet/std_product/hifi_audio/hf83311_vc1.md b/zh/docs/dev_doc/datasheet/std_product/hifi_audio/hf83311_vc1.md index be1f6fc..4be21a3 100644 --- a/zh/docs/dev_doc/datasheet/std_product/hifi_audio/hf83311_vc1.md +++ b/zh/docs/dev_doc/datasheet/std_product/hifi_audio/hf83311_vc1.md @@ -179,8 +179,8 @@ HF83311_VC1/HF83311Q_VC1提供多种输入输出模式，包括USB输入/I²S输 | 20 | GND | P | 模组地 | | 21 | X0D30 | I/O | CTL_MUTE；控制输出，高电平有效 | | 22 | X0D31 | I/O | NC | -| 23 | X0D32 | I/O | NC | -| 24 | X0D33 | I/O | NC | +| 23 | X0D32 | I/O | 控制49.152M 时钟 ；控制输出，高电平有效 | +| 24 | X0D33 | I/O | 控制45.1584M 时钟 ；控制输出，高电平有效 | | 25 | GND | P | 模组地 | | 26 | GND | P | 模组地 | | 27 | GND | P | 模组地 | @@ -227,4 +227,4 @@ HF83311_VC1/HF83311Q_VC1提供多种输入输出模式，包括USB输入/I²S输 --8<-- "common/customer_form.md" - \ No newline at end of file + diff --git a/zh/docs/dev_doc/datasheet/std_product/hifi_audio/hf86611_vc1.md b/zh/docs/dev_doc/datasheet/std_product/hifi_audio/hf86611_vc1.md index ea83835..10d66e6 100644 --- a/zh/docs/dev_doc/datasheet/std_product/hifi_audio/hf86611_vc1.md +++ b/zh/docs/dev_doc/datasheet/std_product/hifi_audio/hf86611_vc1.md @@ -164,8 +164,8 @@ HF86611_VC1/HF86611Q_VC1提供多种输入输出模式，包括USB输入/I²S输 | 20 | GND | P | 模组地 | | 21 | X0D30 | I/O | CTL_MUTE；控制输出，高电平有效 | | 22 | X0D31 | I/O | NC | -| 23 | X0D32 | I/O | NC | -| 24 | X0D33 | I/O | NC | +| 23 | X0D32 | I/O | 控制49.152M 时钟 ；控制输出，高电平有效 | +| 24 | X0D33 | I/O | 控制45.1584M 时钟 ；控制输出，高电平有效 | | 25 | GND | P | 模组地 | | 26 | GND | P | 模组地 | | 27 | GND | P | 模组地 | @@ -212,4 +212,4 @@ HF86611_VC1/HF86611Q_VC1提供多种输入输出模式，包括USB输入/I²S输 --8<-- "common/customer_form.md" - \ No newline at end of file + diff --git a/zh/docs/dev_doc/datasheet/std_product/hifi_audio/hf87621_vc1.md b/zh/docs/dev_doc/datasheet/std_product/hifi_audio/hf87621_vc1.md index 9743836..1ee9515 100644 --- a/zh/docs/dev_doc/datasheet/std_product/hifi_audio/hf87621_vc1.md +++ b/zh/docs/dev_doc/datasheet/std_product/hifi_audio/hf87621_vc1.md @@ -182,8 +182,8 @@ HF87621_VC1/HF87621Q_VC1提供多种输入输出模式，包括USB输入/I²S输 | 20 | GND | P | 模组地 | | 21 | X0D30 | I/O | CTL_MUTE；控制输出，高电平有效 | | 22 | X0D31 | I/O | NC | -| 23 | X0D32 | I/O | NC | -| 24 | X0D33 | I/O | NC | +| 23 | X0D32 | I/O | 控制49.152M 时钟 ；控制输出，高电平有效 | +| 24 | X0D33 | I/O | 控制45.1584M 时钟 ；控制输出，高电平有效 | | 25 | GND | P | 模组地 | | 26 | GND | P | 模组地 | | 27 | GND | P | 模组地 | @@ -230,4 +230,4 @@ HF87621_VC1/HF87621Q_VC1提供多种输入输出模式，包括USB输入/I²S输 --8<-- "common/customer_form.md" - \ No newline at end of file + diff --git a/zh/docs/dev_doc/protocols/xu316_zerocode_protocol.md b/zh/docs/dev_doc/protocols/xu316_zerocode_protocol.md old mode 100644 new mode 100755 index 7f8c384..240865c --- a/zh/docs/dev_doc/protocols/xu316_zerocode_protocol.md +++ b/zh/docs/dev_doc/protocols/xu316_zerocode_protocol.md @@ -225,6 +225,7 @@ sequenceDiagram | 0x24 | xu316发送播放音量 | XU316→MCU | | 0x25 | 发送录音音量 | XU316→MCU | | 0x26 | 切换MCLK | MCU→XU316 | +| 0x29 | 报告USB连接状态 | XU316→MCU | === "HID-MCU互相透传命令(0xEE-0xEF)" | 命令字 | 命令描述 | 发送方向 | @@ -745,7 +746,37 @@ sequenceDiagram === "功能说明" - 发送音频格式的时间延迟 -#### 3.3.10 获取固件版本命令（0xF1） +#### 3.3.10 报告USB连接状态（0x29） + +=== "命令格式" + **XU316发送** + ``` + 帧头: 2字节 - 0x55aa + 版本: 1字节 - 0x00 + 命令字: 1字节 - 0x29 + 数据长度: 1字节 - 0x01 (即1字节) + 数据: 1字节 - USB连接状态 + 0x00 USB未连接/断开 + 0x01 USB已连接 + 校验和: 1字节 - 从帧头开始按字节求和，结果对256求余 + ``` + + **MCU返回** + ``` + 帧头: 2字节 - 0x55aa + 版本: 1字节 - 0x03 + 命令字: 1字节 - 0x29 + 数据长度: 1字节 - 0x00 + 数据: 0字节 + 校验和: 1字节 - 从帧头开始按字节求和，结果对256求余 + ``` + +=== "功能说明" + - 该命令用于XU316向MCU报告当前USB连接状态 + - 当USB连接状态发生变化时（连接或断开），XU316主动发送此命令 + - MCU可根据此信息更新UI显示或调整相关功能 + +#### 3.3.11 获取固件版本命令（0xF1） === "命令格式" **MCU发送**