Air8607 下载和调试
本文介绍如何配合 Luatools 对 Air8607 进行固件下载与日志抓取。Air8607 的主控是 Air1603，板上带 USB 转串口芯片，通过 Type-C 口即可下载和抓日志，选内核时按 Air1603 选。
1. 环境准备
1.1 硬件
- Air8607 大屏音视频最小系统板；
- Type-C 数据线（必须是能传数据的线，纯充电线连不上）；
- 屏、触摸、喇叭、SD 卡：按调试内容接上（只看串口日志时可不接屏）；
- 直流电源或电池（可选，USB 供电也可以，供电说明见 电路和使用说明）；
- 电脑：Windows 10 及以上。
1.2 软件
- 合宙官方下载调试工具 Luatools（最新版）：Luatools 下载和详细使用；
- CH343 驱动：板载 USB 转串口芯片对应的驱动，安装说明见 Air1603 软件环境清单；
- 内核固件与打包固件说明见 默认出厂固件。
2. 连接与端口识别
- 用 Type-C 数据线连接 Air8607 和电脑，板子同时取电；
- 打开设备管理器，正确安装 CH343 驱动后可以看到
USB-SERIAL CH343端口； - 识别不到端口时：先装 CH343 驱动，再换一根能传数据的 USB 线 / 换电脑 USB 口。
3. 下载固件
3.1 研发调试：Luatools 烧录
Air1603 的串口烧录流程与 Air1603 开发板一致，详细的串口设置（端口、通用串口打印、波特率）见 如何使用 Luatools 烧录软件。步骤概览：
- 打开 Luatools，选择 CH343 对应的串口，勾选「通用串口打印」，波特率按 Air1603 的默认配置选择，点击「打开串口」；
- 点击「项目管理测试」，新建项目；
- 选择 Air1603 的内核
.soc（内核固件见 Air1603 固件版本）； - 添加脚本和资源文件（出厂固件工程：module/Air8607/project/factory）；
- 勾选「添加默认 lib」（require 了扩展库会直接烧录；不勾选会提示缺少 xxx.lua）；
- 点击「下载底层和脚本」烧录，等待进度完成；
- 若只是脚本变动、固件不变，点「下载脚本」即可。
注意：确认供电正常再点下载；若因电脑 USB 供电不足反复失败，改用外部稳压电源供电。
3.2 产线量产：合宙量产烧录工具
量产阶段请使用合宙多路下载工具：合宙量产烧录工具使用教程。
4. 抓取日志
Air8607 的日志通过板载 USB 转串口输出，Luatools 用「通用串口打印」抓取：
- 在 Luatools 串口设置中选择 CH343 对应的端口，勾选「通用串口打印」，打开串口；
- 上电 / 复位板子，观察日志；典型日志包括 UI/桌面启动、SD 卡挂载、音频播放、各功能模块加载等信息；
- 串口被 Luatools 打开时会独占该端口，直接用文本编辑器看
log文件前，需要先关闭 Luatools。
Luatools 抓取的日志保存在工具目录的 log 文件夹下：
main_当天日期.txt：工具本身的日志，用于工具报错时查找原因；trace_当天日期_首次记录时间.txt：用户日志，记录 LuatOS 里调用 print、log 等 API 输出的日志。
5. 常见问题排查
| 现象 | 排查方向 |
|---|---|
| 设备管理器识别不到端口 | 安装 CH343 驱动；换能传数据的 USB 线；换电脑 USB 口 |
| 点下载没反应 / 提示找不到设备 | 确认串口已选对并「打开串口」；确认供电正常（必要时外接稳压电源）；重新插拔 USB |
| 烧录中途失败 | 电脑 USB 供电不足，改用外部稳压电源；确认没有其他程序占用该串口 |
| 烧录提示缺少 xxx.lua | 项目管理中勾选「添加默认 lib」，或手动补对应 lib 脚本 |
| 屏不亮 / 花屏 | 确认屏型号与工程配置的分辨率、时序一致（见 电路和使用说明），排线是否插紧 |
| 触摸无反应 | 确认触摸控制芯片与 I2C1 引脚（SCL/SDA、TP_RST、TP_INT）配置正确 |
| 喇叭没声音 | 确认 SD 卡/音频文件存在；确认 AUDIOPA_EN（GPIO73）上电拉低、起播时被拉高 |