常见问题与排障汇总
本篇把前面各篇的”坑”汇总成一张速查表。遇到问题先来这里扫一眼，能省很多时间。
上电 / 启动类
| 现象 |
先查 |
| 串口完全无输出 |
波特率非 115200 8N1；TX/RX 接反；板子没上电 |
| 串口是乱码 |
波特率不对；USB 转串口非 3.3V TTL |
| 启动卡住不动 |
电源功率不足；NAND 固件损坏（重烧，见《固件烧录与系统升级》） |
| 起不来 / 变砖 |
PhoenixSuit 整包重烧；确认固件匹配板型与 NAND 容量档 |
显示类
| 现象 |
先查 |
| 黑屏 |
display_mode 与实际接的屏一致吗（《屏幕与显示切换》）；屏供电/排线；PA20 使能脚 |
| RGB 花屏 |
屏时序与设备树是否匹配 |
| HDMI 无输出 |
已 switch_display hdmi 并 reboot；显示器支持 1080p |
网络类
| 现象 |
先查 |
| 看不到 eth0/eth1 |
驱动未加载；确认 gmac0/gmac1 使能 |
| 获取不到 IP |
网线/路由器 DHCP；换另一个口试 |
| ping 外网域名失败 |
DNS，手动写 /etc/resolv.conf |
| 速率只有 100M |
网线/水晶头不达标，换千兆线 |
GPIO / PWM 类
| 现象 |
先查 |
gpiodetect 无 chip |
内核 GPIO 驱动未开 |
gpioget 报 busy |
该脚被别的功能占用；换空闲脚（《GPIO 控制实战》占用表） |
| 算的 offset 对不上 |
用 gpioinfo 以真实 chip 为准，别盲算 |
| PWM 无输出 |
确认 /sys/class/pwm/ 有 chip；先设 period 再设 duty |
串口 / I2C 类
| 现象 |
先查 |
/dev/ttyAS3 不存在 |
uart3 未使能；重烧启用后的固件 |
| 串口通信乱码 |
两端波特率/数据位/流控不一致，统一 115200 8N1 无流控 |
| 高波特率丢数据 |
线材/模块不支持 3M；降速 |
i2cdetect 扫不到设备 |
芯片未上电/未焊接/地址错；I2C 必须上拉 |
外设功能类
| 现象 |
先查 |
| 开机 Logo 不换 |
文件名必须 bootlogo.bmp；记得 reboot |
| 音频无声 |
音量静音/过低；alsamixer 调；接口对否 |
| RTC 断电丢时间 |
纽扣电池没装/没电 |
| 触摸无反应 |
i2cdetect 看 0x5d；中断脚配置 |
存储 / 文件类
| 现象 |
先查 |
| overlay 文件没出现 |
路径相对根 /；确认重新 pack 并重烧 |
| 根文件系统写满 |
df -h；删文件或扩 rootfsA 分区 |
| 改了配置重启丢 |
用了临时位置/重烧了；用 overlay 预置 |
以上每类问题在对应篇章有更详细的排查步骤，可按目录回到对应篇。
作者：Mai 创建时间：2026-10-20 16:38
最后编辑：Mai 更新时间：2026-11-05 14:56
