update en+zh

免开发串口协议脚本

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
+
+<div class="grid cards" markdown>
+
+-   :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).
+
+    <!-- <a id="designDownloadBtn" class="md-button md-button--primary" href="javascript:void(0);" onclick="checkLogin('https://phaten-audio.com/en/services_support/tools_software/')">:material-download: Download</a> -->
+    [:octicons-link-external-16: Open Tools & Software Center](../../../services_support/tools_software/index.md){ .md-button target="_blank" rel="noopener" }
+
+</div>
+
+## 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)
+
+## 咨询反馈
+
+<details>
+<summary>点击展开咨询反馈表单</summary>
+
+--8<-- "common/customer_form.md"
+
+</details>