docs(zero3): add FAQ with boot troubleshooting based on support cases

docs/zero/zero3/faq.md

@@ -0,0 +1,145 @@
+---
+sidebar_position: 10
+---
+
+# FAQ
+
+## Q1： 联系社区
+
+请参考 https://docs.radxa.com/welcome
+
+## Q2： Radxa ZERO 3 无法从 microSD 卡启动
+
+如果您的 Radxa ZERO 3 无法从 microSD 卡启动，请按照以下步骤排查：
+
+### 检查电源
+- 确保使用 **5V** 电源适配器
+- 推荐使用 [Radxa Power PD30W](../accessories/power/pd_30w)
+- 检查 Type-C 线缆是否正常工作
+- 确保电源接口连接正确（USB 2.0 OTG Type-C 端口）
+
+### 检查 microSD 卡
+1. **卡质量**：使用高质量、品牌可靠的 microSD 卡
+2. **容量**：确保卡容量 ≥8GB
+3. **烧录工具**：使用推荐的烧录工具（如 balenaEtcher）
+4. **镜像完整性**：重新下载镜像并验证哈希值
+5. **烧录过程**：确保烧录过程完整完成，没有中断
+
+### 启动指示灯
+- 正常启动时，电源指示灯应常亮
+- 如果指示灯闪烁或不亮，可能是电源问题
+
+### 串口调试
+如果以上步骤都正常，可以通过串口连接查看启动日志：
+1. 连接 UART 转 USB 适配器到调试串口
+2. 使用串口工具（如 minicom、screen）查看输出
+3. 观察启动过程中的错误信息
+
+## Q3： Radxa ZERO 3 支持哪些存储设备启动？
+
+Radxa ZERO 3 支持从以下设备启动：
+- **microSD 卡**（主要启动方式）
+- **eMMC**（需要额外模块）
+- **USB 存储设备**（通过 USB 启动）
+
+## Q4： 如何安装操作系统到 eMMC？
+
+请参考 [安装操作系统到 eMMC](../low-level-dev/install-os-on-emmc) 指南。
+
+## Q5： Radxa ZERO 3 的供电要求是什么？
+
+Radxa ZERO 3 **只支持 5V 供电**：
+- **输入电压**：5V DC
+- **推荐功率**：≥15W（用于稳定运行）
+- **接口**：USB 2.0 OTG Type-C 端口
+
+:::warning 重要提示
+请勿使用高于 5V 的电源适配器，这可能会损坏设备。
+:::
+
+## Q6： 如何通过串口调试 Radxa ZERO 3？
+
+1. **连接串口**：
+   - 使用 UART 转 USB 适配器
+   - 连接 GND、TX、RX 引脚
+   - 波特率：1500000
+
+2. **查看启动日志**：
+   - 连接串口后上电
+   - 在串口终端中查看启动过程
+
+3. **常见串口工具**：
+   ```bash
+   # Linux/macOS
+   screen /dev/ttyUSB0 1500000
+
+   # Windows
+   # 使用 PuTTY 或 Tera Term
+   ```
+
+## Q7： Radxa ZERO 3 的默认登录凭证是什么？
+
+对于 Radxa OS 镜像：
+- **用户名**：`radxa`
+- **密码**：`radxa`
+
+对于 Debian/Ubuntu 镜像：
+- **用户名**：`root`
+- **密码**：`radxa`
+
+## Q8： 如何更新系统软件包？
+
+```bash
+# 更新软件包列表
+sudo apt update
+
+# 升级已安装的软件包
+sudo apt upgrade
+
+# 清理不再需要的包
+sudo apt autoremove
+```
+
+## Q9： Radxa ZERO 3 支持 Wi-Fi 和蓝牙吗？
+
+是的，Radxa ZERO 3 支持 Wi-Fi 和蓝牙：
+- **Wi-Fi**：支持 2.4GHz 和 5GHz 频段
+- **蓝牙**：支持 Bluetooth 5.0
+
+如果遇到连接问题：
+1. 检查天线是否连接（如有）
+2. 确保驱动已正确加载
+3. 检查网络配置
+
+## Q10： 如何检查硬件信息？
+
+```bash
+# 查看 CPU 信息
+cat /proc/cpuinfo
+
+# 查看内存信息
+free -h
+
+# 查看存储设备
+lsblk
+
+# 查看网络接口
+ip addr
+
+# 查看系统版本
+cat /etc/os-release
+```
+
+## Q11： 遇到其他问题怎么办？
+
+1. **查看官方文档**：https://docs.radxa.com/zero/zero3
+2. **访问社区论坛**：获取社区支持
+3. **联系技术支持**：通过官方渠道提交问题
+
+:::tip
+在寻求帮助时，请提供以下信息：
+- 使用的镜像版本
+- 硬件配置
+- 错误日志或截图
+- 已尝试的解决步骤
+:::

i18n/en/docusaurus-plugin-content-docs/current/zero/zero3/faq.md

@@ -0,0 +1,145 @@
+---
+sidebar_position: 10
+---
+
+# FAQ
+
+## Q1: Community Support
+
+Please refer to https://docs.radxa.com/welcome
+
+## Q2: Radxa ZERO 3 Unable to Boot from microSD Card
+
+If your Radxa ZERO 3 cannot boot from a microSD card, follow these troubleshooting steps:
+
+### Check Power Supply
+- Ensure using a **5V** power adapter
+- Recommended: [Radxa Power PD30W](../accessories/power/pd_30w)
+- Check if the Type-C cable is working properly
+- Ensure the power interface is correctly connected (USB 2.0 OTG Type-C port)
+
+### Check microSD Card
+1. **Card Quality**: Use high-quality, reliable brand microSD cards
+2. **Capacity**: Ensure card capacity ≥8GB
+3. **Burn Tool**: Use recommended burning tools (like balenaEtcher)
+4. **Image Integrity**: Redownload the image and verify the hash
+5. **Burn Process**: Ensure the burning process completes fully without interruption
+
+### Boot Indicators
+- During normal boot, the power LED should stay on
+- If the LED blinks or remains off, there may be a power issue
+
+### Serial Debugging
+If all above steps are normal, connect via serial port to check boot logs:
+1. Connect UART to USB adapter to the debug serial port
+2. Use serial tools (like minicom, screen) to view output
+3. Observe error messages during the boot process
+
+## Q3: What Storage Devices Does Radxa ZERO 3 Support for Boot?
+
+Radxa ZERO 3 supports booting from:
+- **microSD Card** (primary boot method)
+- **eMMC** (requires additional module)
+- **USB Storage Devices** (via USB boot)
+
+## Q4: How to Install OS to eMMC?
+
+Please refer to the [Install OS to eMMC](../low-level-dev/install-os-on-emmc) guide.
+
+## Q5: What Are the Power Requirements for Radxa ZERO 3?
+
+Radxa ZERO 3 **only supports 5V power supply**:
+- **Input Voltage**: 5V DC
+- **Recommended Power**: ≥15W (for stable operation)
+- **Interface**: USB 2.0 OTG Type-C port
+
+:::warning Important
+Do not use power adapters above 5V as this may damage the device.
+:::
+
+## Q6: How to Debug Radxa ZERO 3 via Serial Port?
+
+1. **Connect Serial Port**:
+   - Use UART to USB adapter
+   - Connect GND, TX, RX pins
+   - Baud rate: 1500000
+
+2. **View Boot Logs**:
+   - Connect serial port before powering on
+   - View boot process in serial terminal
+
+3. **Common Serial Tools**:
+   ```bash
+   # Linux/macOS
+   screen /dev/ttyUSB0 1500000
+
+   # Windows
+   # Use PuTTY or Tera Term
+   ```
+
+## Q7: What Are the Default Login Credentials for Radxa ZERO 3?
+
+For Radxa OS images:
+- **Username**: `radxa`
+- **Password**: `radxa`
+
+For Debian/Ubuntu images:
+- **Username**: `root`
+- **Password**: `radxa`
+
+## Q8: How to Update System Packages?
+
+```bash
+# Update package lists
+sudo apt update
+
+# Upgrade installed packages
+sudo apt upgrade
+
+# Clean up unnecessary packages
+sudo apt autoremove
+```
+
+## Q9: Does Radxa ZERO 3 Support Wi-Fi and Bluetooth?
+
+Yes, Radxa ZERO 3 supports Wi-Fi and Bluetooth:
+- **Wi-Fi**: Supports 2.4GHz and 5GHz bands
+- **Bluetooth**: Supports Bluetooth 5.0
+
+If experiencing connection issues:
+1. Check if antenna is connected (if applicable)
+2. Ensure drivers are properly loaded
+3. Check network configuration
+
+## Q10: How to Check Hardware Information?
+
+```bash
+# View CPU information
+cat /proc/cpuinfo
+
+# View memory information
+free -h
+
+# View storage devices
+lsblk
+
+# View network interfaces
+ip addr
+
+# View system version
+cat /etc/os-release
+```
+
+## Q11: What to Do for Other Issues?
+
+1. **Check Official Documentation**: https://docs.radxa.com/zero/zero3
+2. **Visit Community Forum**: Get community support
+3. **Contact Technical Support**: Submit issues through official channels
+
+:::tip
+When seeking help, please provide:
+- Image version used
+- Hardware configuration
+- Error logs or screenshots
+- Steps already attempted to resolve
+:::