常见问题与故障排查

硬件与供电

Q1：上电后设备无反应

• 检查电源适配器规格是否满足 12V/3A（推荐）。
• 确认电源接口连接正确，插头无松动。
• 若使用 Type-C 供电，请确认硬件已按要求完成对应电阻焊接。

Q2：串口无输出

• 确认使用的是调试串口（J7）并选择正确串口号。
• 串口参数建议：115200, 8N1。
• 更换数据线排查“仅充电线”问题。

ADB 与 SSH

Q3：adb devices 未识别设备

adb kill-server
adb start-server
adb devices

• 确认设备已正常上电。
• 重新插拔 USB 数据线，必要时更换线材。

Q4：SSH 连接超时

• 先执行 ping <A8625_IP> 确认网络可达。
• 核对登录命令：ssh aidlux@<A8625_IP>。
• 确认设备与主机处于同一网段。

驱动与网络

Q5：驱动安装失败（dpkg 提示找不到文件）

• 先进入驱动包所在目录再执行安装命令。
• 用 ls 检查驱动包文件名是否匹配 a8625-driver-ubuntu_*.deb。

Q6：网络配置重启后失效

• ifconfig/ip route 命令通常为临时配置，重启后可能失效。
• 建议通过系统网络管理方式进行持久化配置。

编译与烧录

Q7：编译脚本执行失败

• 确认已进入源码根目录。
• 确认 Aidlux_build.sh 具备执行权限。
• 避免使用 root 用户直接编译。

Q8：烧录后无法正常启动

• 确认刷机文件版本与设备型号匹配。
• 检查 QFIL 日志中是否出现中断或报错。
• 若使用拨码强制刷机，烧录完成后请恢复拨码到正常启动位置。