diff --git a/assets/download/tools_software/XU316测试脚本-20260107.exe b/assets/download/tools_software/XU316测试脚本-20260107.exe new file mode 100644 index 0000000..fbf191d Binary files /dev/null and b/assets/download/tools_software/XU316测试脚本-20260107.exe differ diff --git a/en/docs/assets/download/tools_software/XU316测试脚本-20260107.exe b/en/docs/assets/download/tools_software/XU316测试脚本-20260107.exe new file mode 100644 index 0000000..fbf191d Binary files /dev/null and b/en/docs/assets/download/tools_software/XU316测试脚本-20260107.exe differ diff --git a/en/docs/assets/images/hifi_audio/dnr65221_vc1.png b/en/docs/assets/images/hifi_audio/dnr65221_vc1.png new file mode 100644 index 0000000..54e98f6 Binary files /dev/null and b/en/docs/assets/images/hifi_audio/dnr65221_vc1.png differ diff --git a/en/docs/assets/images/hifi_audio/dnr65231_vc1.png b/en/docs/assets/images/hifi_audio/dnr65231_vc1.png new file mode 100644 index 0000000..022b602 Binary files /dev/null and b/en/docs/assets/images/hifi_audio/dnr65231_vc1.png differ diff --git a/en/docs/dev_doc/sdk_examples/XU316_MCU_Communication_Examples/ZeroCode_Test_Script.md b/en/docs/dev_doc/sdk_examples/XU316_MCU_Communication_Examples/ZeroCode_Test_Script.md new file mode 100644 index 0000000..9a3b441 --- /dev/null +++ b/en/docs/dev_doc/sdk_examples/XU316_MCU_Communication_Examples/ZeroCode_Test_Script.md @@ -0,0 +1,81 @@ +--- +title: Zero-Code Firmware UART Protocol Test Script Guide +login: true +hide: + -toc +--- + +--8<-- "common/checklogin_form.md" +--8<-- "common/phaten_xmos_support_img.md" + +# Zero-Code Firmware UART Protocol Test Script Guide +The Zero-Code Firmware UART Protocol Test Script is provided by Phaten Cloud (Phaten) for the XMOS XU316 platform. It is designed for hardware/firmware and test engineers to quickly validate UART communication and control between an MCU and the audio processor. Without writing extra application code, it can cover connection, handshake, mode switching, and common control operations. + +!!! info "Intended Audience & Use Cases" + - Audience: Hardware/Firmware Engineers, Test Engineers + - Use Cases: UART command interaction, parameter read/write, status query, mode switching verification + - Platform: XMOS XU316 (flashed with firmware that supports the Zero-Code command set) + +## Script Download And Tools Entry + +
+ +- :material-download: __Zero-Code Firmware UART Test Script Download__ + + --- + + Get the latest script and companion tools from the Phaten (Phaten Cloud) Tools & Software Center (login required). + + + [:octicons-link-external-16: Open Tools & Software Center](../../../services_support/tools_software/index.md){ .md-button target="_blank" rel="noopener" } + +
+ +## Prerequisites +- Operating System: Windows +- Hardware Connection: Connect the device to the PC via USB/UART and confirm the COM port appears in Device Manager +- Driver: Install and confirm the UART driver opens correctly +- UART Settings: 115200 / 8-N-1 (follow firmware documentation if different) + + + +## Quick Start +1. Launch the script +2. Select the UART port: The tool scans available ports; select the COM port for the XU316. Refresh if the list is not updated +3. Power-on handshake: The tool listens to the device boot output, prints received data, and sends required responses automatically until the “Firmware Selection Menu” appears +4. Select firmware: + - hf83311 / hf86611 / hf87611 / hf87621 + - ph73211_lp / ph73311_lp / ph83211_lp / ph83311_lp + - Full-mode test (covers all supported modes; recommended if firmware is unknown or for full validation) +5. Run features from the menu: In the main menu, perform media control, mode switching, MCLK switching, unmute, audio latency configuration, firmware version query, and more + +!!! tip "Observability During Execution" + - The tool prints TX/RX data in real time for troubleshooting + - For steps that require device responses, the script waits and confirms automatically + +## Feature Overview +- Boot handshake: Verifies normal startup and completes the handshake sequence +- Firmware selection with mode mapping: Only shows input/output modes supported by the selected firmware to avoid wrong selections +- Input/Output mode switching: Validates switching across audio paths (request → confirm → configure → result) +- Media control: Validates the control path for volume, play/pause, previous/next, and more +- MCLK switching: Switches between internal/external MCLK and validates clock configuration takes effect +- Common controls: Unmute, audio format/latency configuration, firmware version query, and more + +## Troubleshooting +- UART port not found: Check cables and drivers, and confirm the COM port appears in Device Manager +- No output after selecting the port: Confirm the correct port is selected, power-cycle the device, and observe boot logs +- Mode switching fails: Confirm the selected firmware matches the device; switch to a basic mode first and then validate other modes + +## Terms & Parameters +- COM port: The UART device identifier on Windows +- 8-N-1: 8 data bits, no parity, 1 stop bit +- MCLK: Master Clock (MCLK) + +## 咨询反馈 + +
+点击展开咨询反馈表单 + +--8<-- "common/customer_form.md" + +
diff --git a/en/docs/products/ai_dnr/dnr65211_vc1.md b/en/docs/products/ai_dnr/dnr65211_vc1.md index b484194..39caa64 100644 --- a/en/docs/products/ai_dnr/dnr65211_vc1.md +++ b/en/docs/products/ai_dnr/dnr65211_vc1.md @@ -1,10 +1,11 @@ --- title: DNR65211_VC1 +login: true hide: -toc --- - +--8<-- "common/checklogin_form.md" --8<-- "common/phaten_xmos_support_img.md"
diff --git a/en/docs/products/ai_dnr/dnr65221_vc1.md b/en/docs/products/ai_dnr/dnr65221_vc1.md index c5aa60f..f223482 100644 --- a/en/docs/products/ai_dnr/dnr65221_vc1.md +++ b/en/docs/products/ai_dnr/dnr65221_vc1.md @@ -1,9 +1,11 @@ --- title: DNR65221_VC1 +login: true hide: -toc --- +--8<-- "common/checklogin_form.md" --8<-- "common/phaten_xmos_support_img.md" @@ -88,7 +90,7 @@ DNR65221-VC1 is a high-performance AI deep noise reduction product based on XMOS | Type | Title | Download | |:--------:|:------------------------|:------------------------| | Product Datasheet | [:material-file-document-outline: DNR65221-VC1 Datasheet](../../dev_doc/datasheet/std_product/ai_dnr/DNR65221_vc1.md) | [:material-download:] | - | Reference Design | | [:material-download:] | + | Reference Design | | :material-download: | | Application Manual | | [:material-download:] | @@ -120,7 +122,7 @@ DNR65221-VC1 is a high-performance AI deep noise reduction product based on XMOS | Product Name | Product Model | Product Image | |:--------|:------------------------|:------------------------:| -| Single-Channel Ultra-Low Latency AI Deep Noise Reduction Processor with USB and PDM Interface | DNR65221-VC1 |![DNR65221-VC1](/assets/images/hifi_audio/DNR65221_vc1.png "DNR65221-VC1"){align=center width=120} | +| Single-Channel Ultra-Low Latency AI Deep Noise Reduction Processor with USB and PDM Interface | DNR65221-VC1 |![DNR65221-VC1](/assets/images/hifi_audio/dnr65221_vc1.png "DNR65221-VC1"){align=center width=120} | ## Related Evaluation Boards diff --git a/en/docs/products/ai_dnr/dnr65231_vc1.md b/en/docs/products/ai_dnr/dnr65231_vc1.md index 1edca79..bb5f4f2 100644 --- a/en/docs/products/ai_dnr/dnr65231_vc1.md +++ b/en/docs/products/ai_dnr/dnr65231_vc1.md @@ -1,9 +1,11 @@ --- title: DNR65231_VC1 +login: true hide: -toc --- +--8<-- "common/checklogin_form.md" --8<-- "common/phaten_xmos_support_img.md" @@ -88,7 +90,7 @@ DNR65231 is a high-performance AI deep noise reduction product based on XMOS pro | Type | Title | Download | |:--------:|:------------------------|:------------------------| | Product Datasheet | [:material-file-document-outline: DNR65231-VC1 Datasheet](../../dev_doc/datasheet/std_product/ai_dnr/dnr65231_vc1.md) | [:material-download:] | - | Reference Design | | [:material-download:] | + | Reference Design | | :material-download: | | Application Manual | | [:material-download:] | diff --git a/en/docs/products/ai_mic/ls67211_vc1.md b/en/docs/products/ai_mic/ls67211_vc1.md index f574c03..1e91996 100644 --- a/en/docs/products/ai_mic/ls67211_vc1.md +++ b/en/docs/products/ai_mic/ls67211_vc1.md @@ -1,10 +1,11 @@ --- title: LS67211_VC1 +login: true hide: -toc --- - +--8<-- "common/checklogin_form.md" --8<-- "common/phaten_xmos_support_img.md"
@@ -65,8 +66,8 @@ The 48KHz low-latency AI noise reduction USB streaming microphone audio processo | Type | Title | Download | |:--------:|:------------------------|:------------------------| - | Product Datasheet | [:material-file-document-outline: LS67211-VC1 Datasheet](../../dev_doc/datasheet/std_product/ai_dnr/ls67211_vc1.md) | [:material-download:] | - | Reference Design | | [:material-download:] | + | Product Datasheet | [:material-file-document-outline: LS67211-VC1 Datasheet]( "No datasheet available" ) | [:material-download:] | + | Reference Design | LS67211 schematic diagram | :material-download: | | Application Manual | | [:material-download:] | diff --git a/en/docs/services_support/tools_software/index.md b/en/docs/services_support/tools_software/index.md index 1c5de81..cd57ed7 100644 --- a/en/docs/services_support/tools_software/index.md +++ b/en/docs/services_support/tools_software/index.md @@ -18,4 +18,5 @@ login: true | Zadig | Windows USB driver | :material-download: | | tuning_gui | XMOS DSP and EQ debugging tool | :material-download: | | XT25F16F_QSPI.spec | Xflash configuration file, applicable to: A316-Mini-V1, A316-LS-MIC-V2, A316-V71-GAME-V1 | :material-download: | +| XU316测试脚本-20260107.exe | XU316 No-Code Firmware Serial Test Script （Chinese version） | :material-download: | diff --git a/zh/docs/assets/download/tools_software/XU316测试脚本-20260107.exe b/zh/docs/assets/download/tools_software/XU316测试脚本-20260107.exe new file mode 100644 index 0000000..fbf191d Binary files /dev/null and b/zh/docs/assets/download/tools_software/XU316测试脚本-20260107.exe differ diff --git a/zh/docs/dev_doc/sdk_examples/XU316_MCU_Communication_Examples/ZeroCode_Test_Script.md b/zh/docs/dev_doc/sdk_examples/XU316_MCU_Communication_Examples/ZeroCode_Test_Script.md new file mode 100644 index 0000000..6d14e50 --- /dev/null +++ b/zh/docs/dev_doc/sdk_examples/XU316_MCU_Communication_Examples/ZeroCode_Test_Script.md @@ -0,0 +1,81 @@ +--- +title: 免开发固件串口协议测试脚本说明 +login: true +hide: + -toc +--- + +--8<-- "common/checklogin_form.md" +--8<-- "common/phaten_xmos_support_img.md" + +# 免开发固件串口协议测试脚本说明 +免开发固件串口协议测试脚本由飞腾云（Phaten）基于 XMOS XU316 平台提供，面向硬件/固件工程师，用于快速验证 MCU 与音频处理器之间的串口通信与控制，无需额外业务代码即可覆盖连接、握手、模式切换与常用控制项。 + +!!! info "适用读者与场景" + - 读者：硬件/固件工程师、测试工程师 + - 场景：串口指令交互、参数读写、状态查询、模式切换验证 + - 平台：XMOS XU316（已烧录支持 免开发固件指令集的固件） + +## 下载脚本与工具入口 + +
+ +- :material-download: __免开发固件串口测试脚本下载__ + + --- + + 在飞腾云（Phaten）配置及调试工具获取最新版本脚本与配套工具（需登录后下载）。 + + + [:octicons-link-external-16: 打开配置及调试工具](../../../services_support/tools_software/index.md){ .md-button target="_blank" rel="noopener" } + +
+ +## 准备工作 +- 操作系统：Windows +- 硬件连接：将设备通过 USB/串口连接至电脑，确保设备管理器可见对应 COM 口 +- 驱动：安装并确认串口驱动可正常打开 +- 串口参数：115200 / 8-N-1（如固件有特殊约定，以固件说明为准） + + + +## 快速上手 +1. 启动脚本程序 +2. 选择串口：自动扫描可用端口，选择与 XU316 对应的 COM 口；如列表未更新可手动刷新 +3. 上电握手：程序监听设备上电数据，打印接收内容并自动完成必要回应，直至进入“固件选择菜单” +4. 选择固件： + - hf83311 / hf86611 / hf87611 / hf87621 + - ph73211_lp / ph73311_lp / ph83211_lp / ph83311_lp + - 全模式测试（覆盖所有支持模式，适用于固件未知或需全面验证） +5. 执行功能菜单：在主菜单中进行媒体控制、模式切换、MCLK 切换、unmute、设置音频延迟、获取固件版本等操作 + +!!! tip "执行过程中的可观测性" + - 程序实时打印发送/接收数据，便于排查问题 + - 需要等待设备回应的流程中，脚本会自动等待与确认 + +## 功能说明 +- 启动握手：确认设备正常启动并完成握手流程 +- 固件选择与模式联动：仅展示所选固件支持的输入/输出模式，避免误选 +- 输入/输出模式切换：验证不同音频路径的切换能力（请求→确认→配置→结果） +- 媒体控制：验证音量、播放/暂停、上一曲/下一曲等控制链路 +- MCLK 切换：在内部/外部 MCLK 间切换，验证时钟配置生效 +- 常用控制项：unmute、音频格式延迟设置、查询固件版本等 + +## 常见问题排查 +- 找不到串口：检查连接与驱动，确认设备管理器识别到 COM 口 +- 选择串口后无输出：确认端口选择正确，重新上电后观察启动打印 +- 模式切换失败：确认固件选择是否匹配，先切换到基础模式再验证其他模式 + +## 术语与参数 +- COM 口：Windows 下串口设备标识 +- 8-N-1：数据位 8、无校验、1 位停止位 +- MCLK：主时钟（Master Clock） + +## 咨询反馈 + +
+点击展开咨询反馈表单 + +--8<-- "common/customer_form.md" + +
diff --git a/zh/docs/services_support/tools_software/index.md b/zh/docs/services_support/tools_software/index.md index 5177386..018f78a 100644 --- a/zh/docs/services_support/tools_software/index.md +++ b/zh/docs/services_support/tools_software/index.md @@ -19,4 +19,5 @@ login: true | tuning_gui | XMOS 调试DSP和EQ工具 | :material-download: | | XT25F16F_QSPI.spec | Xflash配置文件, 适用于：A316-Mini-V1, A316-LS-MIC-V2, A316-V71-GAME-V1 | :material-download: | | WiFi-Audio-TRX-V1 固件烧录工具 | WiFi-Audio-TRX-V1 固件烧录工具, 适用模组和评估板的烧录 | :material-download: | +| 免开发固件串口测试脚本 | 免开发固件串口协议测试脚本 | :material-download: | diff --git a/zh/mkdocs.yml b/zh/mkdocs.yml index 7108bff..2e72cc4 100644 --- a/zh/mkdocs.yml +++ b/zh/mkdocs.yml @@ -304,6 +304,7 @@ nav: - dev_doc/sdk_examples/index.md - A316免开发固件MCU开发指南: - dev_doc/sdk_examples/XU316_MCU_Communication_Examples/index.md + - 免开发串口协议测试脚本说明: dev_doc/sdk_examples/XU316_MCU_Communication_Examples/ZeroCode_Test_Script.md - 免开发固件开发问题指南: dev_doc/faq/technical_faq/a316_firmware_dev_faq.md - XU316与MCU通信协议命令宏定义: dev_doc/sdk_examples/XU316_MCU_Communication_Examples/Command_Macros.md - XU316与MCU通信协议参考: dev_doc/sdk_examples/XU316_MCU_Communication_Examples/Command_Reference.md