常见故障排查¶
故障排查应先确认供电和串口，再检查启动介质和具体外设。一次只改变一个条件，并保留完整串口日志。
串口没有输出¶
- 确认连接的是
DEBUGType-C，不是OTGType-C。 - 串口参数设置为
115200 8N1，关闭硬件流控。 - 检查电脑是否识别到 CH340 串口设备。
- 保持串口终端打开，按一下板上的
RESET。 - 更换确认支持数据传输的 USB 线。
Linux 可检查：
lsusb
ls -l /dev/ttyUSB*
dmesg | tail -n 30
反复重启或启动中断¶
- 只保留一种可靠的 5V 供电来源，避免 DEBUG、OTG 和扩展排针同时接入不同电源。
- 断开屏幕、USB 外设和扩展模块后重新启动。
- 检查串口是否出现欠压、看门狗复位、内核异常或文件系统错误。
- TF 卡启动时重新校验并写入完整镜像；NAND 启动时重新执行完整擦除和烧录。
无法进入 FEL¶
正确顺序是按住 FEL、短按 RESET、等待 2 到 3 秒后松开 FEL。数据线必须连接 OTG Type-C。
lsusb
xfel version
仍无法识别时，依次检查 USB 数据线、电脑 USB 端口和 Linux 的 libusb 权限。普通系统启动时，xfel 显示 No FEL device found 不代表工具损坏。
NAND 烧录后不能启动¶
确认五个烧录文件来自同一套构建结果，并使用以下固定偏移：
| 内容 | 偏移 |
|---|---|
| SPL | spinand splwrite 1024 0 |
| U-Boot | 0x020000 |
| Linux 设备树 | 0x100000 |
| zImage | 0x120000 |
| UBI 根文件系统 | 0x720000 |
不要使用 SPI NOR 设备树或 JFFS2 根文件系统。串口停在 Starting kernel 附近时优先检查设备树和内核；出现 UBI/UBIFS 挂载错误时重新生成并烧录 ubi.img。
TF 卡不能启动¶
sha256sum -c SHA256SUMS
lsblk
sudo fdisk -l /dev/sdX
确认镜像写入的是整盘 /dev/sdX，不是 /dev/sdX1。写卡完成后执行 sync 并安全移除读卡器。开发板上电前应先插好 TF 卡。
有线网络不通¶
在开发板检查链路和地址：
cat /sys/class/net/eth0/carrier
cat /sys/class/net/eth0/speed
ifconfig eth0
route -n
carrier 应为 1。默认系统通过 DHCP 获取地址；没有 DHCP 服务时，按“有线网络”页面设置同网段静态地址。先互相 Ping 同网段电脑，再检查网关和 DNS。
Wi-Fi 接口不存在¶
lsmod | grep 8723
ip link show wlan0
dmesg | grep -iE 'mmc|sdio|8723|firmware'
检查 r8723bs.ko、模块依赖文件和 RTL8723BS 固件是否都在根文件系统中。内核、模块和根文件系统覆盖层必须来自同一套发布包。
蓝牙启动失败¶
/etc/init.d/S12rtl8723bs restart
hciconfig -a
dmesg | grep -iE 'bluetooth|hci|rtl'
蓝牙使用 UART2。H2 排针上的 UART2 发送和接收引脚默认被 NC 电阻隔离，不应与外部串口设备并联使用。
没有显示或触摸无响应¶
显示和触摸需要匹配具体屏幕的引脚、时序和设备树配置。先检查设备节点：
ls -l /dev/fb0 /dev/input/event*
cat /sys/class/graphics/fb0/virtual_size
显示异常时检查 LCD 排线方向、供电、背光和设备树时序。触摸异常时使用 cat /proc/bus/input/devices 确认事件节点，不要固定假设一定是 event1。
音频无声或无法录音¶
cat /proc/asound/cards
aplay -l
arecord -l
amixer contents
先按“音频”页面设置输出或采集通道，再使用与硬件一致的采样率、位宽和通道数测试。播放和录音正常后再排查应用程序。