update en+zh

免开发串口协议脚本

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（已烧录支持 免开发固件指令集的固件）
+
+## 下载脚本与工具入口
+
+<div class="grid cards" markdown>
+
+-   :material-download: __免开发固件串口测试脚本下载__
+
+    ---
+
+    在飞腾云（Phaten）配置及调试工具获取最新版本脚本与配套工具（需登录后下载）。
+
+    <!-- <a id="designDownloadBtn" class="md-button md-button--primary" href="javascript:void(0);" onclick="checkLogin('https://phaten-audio.com/zh/services_support/tools_software/')">:material-download: 下载</a> -->
+    [:octicons-link-external-16: 打开配置及调试工具](../../../services_support/tools_software/index.md){ .md-button target="_blank" rel="noopener" }
+
+</div>
+
+## 准备工作
+- 操作系统：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）
+
+## 咨询反馈
+
+<details>
+<summary>点击展开咨询反馈表单</summary>
+
+--8<-- "common/customer_form.md"
+
+</details>