跳转至

Air8607A 下载和调试

本文介绍 Air8607A 完整的下载与调试过程：用 USB 转 TTL 模块搭配下载夹具连接板子的 J2 下载口，通过 Luatools 完成串口烧录，再用同一套连接抓取日志进行调试。

Air8607A 的主控是 Air1603，选内核时按 Air1603 选；本板没有板载 USB 转串口，直接用 Type-C 连电脑不会出现串口，必须经过 J2 + 外接下载链路。

1. 环境准备

1.1 硬件

物品 说明
Air8607A 主板 屏、触摸、喇叭按调试内容接上（只看日志时可不接屏）
USB 转 TTL 模块 4～5 根引出线：VCC/3V3（可不接）、GND、TXD、RXD，带 DTR/RTS 更便于复位
下载夹具 把 TTL 的信号压接到 J2 焊盘，并给出复位时序；临时验证也可用排线对接
供电 按场景从 J1 电源端子或 Type-C 供电；接 USB 外设时必须由 J1 供电
电脑 Windows 10 及以上

Air8607A USB 转 TTL 与下载夹具

1.2 软件

  • 合宙官方下载调试工具 Luatools（最新版）：Luatools 下载和详细使用；
  • USB 转 TTL 模块的串口驱动：按模块实际芯片安装（CH340 / CP2102 / FT232 等，装完后设备管理器里出现对应 COM 口）；
  • 内核固件与打包固件说明见 默认出厂固件。

2. 连接

2.1 J2 下载口针脚定义

J2 针号 信号 USB 转 TTL 侧对应
1 VBAT 一般不接（由 J1/Type-C 给主板供电；确需由 TTL 供电时按专用下载器设计接入，不可直接接普通 5V 输出）
2 GND GND，必须共地
3 DBGUART_RXD TTL 的 TXD（交叉）
4 DBGUART_TXD TTL 的 RXD（交叉）
5 1603_RESET 经下载夹具接复位时序

2.2 连接顺序

  1. 断电状态下，把 USB 转 TTL 的 GND / TXD / RXD 三根线按上表接到下载夹具输入端（TX、RX 交叉，不要接反）；
  2. 夹具对准主板背面的 J2 五个焊盘压接，注意 J2（下载）与 J110（扩展）两排焊盘不要混用；
  3. 复位线由夹具按设计接好——烧录依赖复位时序，这是普通杜邦线直接连 TTL 烧不进去的原因；
  4. 给主板上电（J1 或 Type-C），TTL 的 USB 插入电脑。

整体接线与供电关系见官方说明图。

连接完成后的整体实拍与夹具压接特写：

Air8607A 下载调试整体连接实拍：主板 + 下载夹具 + 转接板

下载夹具压接主板背面：丝印可见 DBGUART_RX / DBGUART_TX、RESET、VBAT

3. 串口下载烧录

连接完成后，烧录分两条路径：

路径 烧什么 什么时候用
路径一：factory 脚本 + Air1603 内核（分开烧） Air1603 内核 .soc（LuatOS-SoC_V1030_Air1603_102 号）+ factory 工程脚本，在项目管理里分开添加 二次开发、修改代码
路径二：整包固件直接烧（内核+脚本一起） 一个完整的 .soc（内核与出厂脚本已打包），无需添加脚本 恢复出厂状态、快速验证整板功能

两条路径用同一套连接（见第 2 章），都在 Luatools 中完成；串口设置细节见 如何使用 Luatools 烧录软件。

3.1 路径一：烧录 factory 脚本 + Air1603 内核（二次开发）

需要修改代码时，用「项目管理测试」把内核和脚本分开烧。Luatools 正常下载界面如下：

Luatools 正常下载界面

  1. 打开 Luatools，选择 TTL 模块对应的 COM 口，勾选「通用串口打印」，波特率按 Air1603 的默认配置选择，点击「打开串口」；

Luatools 选择串口（COM25）并勾选「通用串口打印」，下方为实时日志输出 2. 点击主界面右上角的「项目管理」，新建项目：

Luatools 主界面右上角进入「项目管理」

  1. 底层（core）：选择 Air1603 内核 LuatOS-SoC_V1030_Air1603_102.soc（102 号内核，与出厂固件所用内核版本一致）——点此直接下载；其他版本见 Air1603 固件版本；

在「选择底层CORE」中选中 102 号内核 .soc

  1. 脚本和资源：从 Gitee 的 factory 工程 下载出厂代码，通过「增加目录（递归）」把 factory 工程目录整个加入（main.lua 为入口，app/、config/、drv/、ui/、res/ 等子目录一并加入）；

添加脚本：选中 factory 工程目录后「增加目录（递归）」

  1. 勾选「添加默认 lib」（require 了扩展库会直接烧录；不勾选会提示缺少 xxx.lua）；
  2. 点击「下载底层和脚本」，Luatools 会复位板子并经 J2 烧录，等待进度完成；

项目管理中依次完成：① 选择底层 CORE ② 增加脚本或资源文件 ③ 下载底层和脚本

  1. 烧录完成后复位验证，随后即可用 §4 抓取日志 观察输出。

后续只改脚本（.lua、资源文件）时：底层不动，在项目管理里点「下载脚本」即可，速度快得多；config/ 下的板级配置按 Air8607A 维护。

3.2 路径二：整包固件直接烧（内核+脚本一起，恢复出厂）

  1. 确认第 2 章连接完成、板子已上电、TTL 已接电脑；
  2. 打开 Luatools，通过快捷菜单的「固件下载」入口选择整包出厂固件：Engine_Air8607A_10inch_1024x600_000_V000_001.999.006_LuatOS-SoC_V1030_Air1603_102.soc（从 默认出厂固件 页下载；内核与出厂脚本已打包在内——Luatools 识别为"LuatOS固件，已包含脚本"，不需要再添加脚本）；
  3. 开始下载，等待烧录完成；
  4. 复位板子，屏幕点亮进入出厂桌面（10 寸 1024×600，含 UVC 摄像头预览与外设管理），烧录成功。

整包固件烧录操作界面（Luatools）

注意：两条路径烧录失败时都先检查三件事——夹具是否压紧（J2 接触不良）、TX/RX 是否交叉、复位线是否接好；其次确认供电正常（必要时改用外部稳压电源从 J1 供电）。

3.3 产线量产

量产阶段请使用合宙多路下载工具：合宙量产烧录工具使用教程。

4. 抓取日志调试

下载和调试用同一套连接，烧完不拆线，直接用 Luatools 的「通用串口打印」抓日志——同一个窗口，先看到下载进度走到 100%，紧接着就是板子的启动日志：

Luatools：下载 100% 完成后，同一窗口继续输出启动日志（红框）

  1. 保持 Luatools 中 TTL 对应的串口为打开状态（勾选「通用串口打印」）；
  2. 复位 / 重新上电板子，观察启动日志：桌面/UI 构建、触摸标定、UVC 摄像头枚举、音频播放、各功能模块加载等信息都会在这里输出（见上图红框）；
  3. 调试过程中脚本里的 print / log 输出实时可见，配合断点/打印定位业务问题；
  4. J2 专用于下载调试：业务串口（J110）接的外设与日志抓取互不影响；
  5. 串口被 Luatools 打开时会独占该端口，直接用文本编辑器看 log 文件前，需要先关闭 Luatools。

Luatools 抓取的日志保存在工具目录的 log 文件夹下：

  • main_当天日期.txt：工具本身的日志，用于工具报错时查找原因；
  • trace_当天日期_首次记录时间.txt：用户日志，记录 LuatOS 里调用 print、log 等 API 输出的日志。

5. 常见问题排查

现象 排查方向
设备管理器识别不到 COM 口 安装 TTL 模块芯片对应驱动；换能传数据的 USB 线；换电脑 USB 口
完全无打印 TX/RX 是否交叉接反；是否共地；夹具是否对准 J2（别压到 J110）
有打印但烧录失败 / 点下载没反应 检查复位线与时序；重新压接夹具；确认串口已选对并「打开串口」
烧录中途失败 供电不足或不稳，改用外部稳压电源从 J1 供电；确认没有其他程序占用该串口
烧录提示缺少 xxx.lua 项目管理中勾选「添加默认 lib」，或手动补对应 lib 脚本
不接夹具、杜邦线直连 TTL 只能看日志不能烧录 属正常：缺复位时序；烧录必须经下载夹具
屏不亮 / 花屏 确认屏型号与工程配置的分辨率、时序一致（见 电路和使用说明），排线是否插紧
触摸无反应 确认触摸 I2C1 引脚（SCL/SDA、TP_RST、TP_INT）配置正确，屏旋转后同步检查坐标映射
喇叭没声音 确认音频文件存在；确认 AUDIOPA_EN（GPIO73）起播时被拉高；SPK- 不能接地

6. 相关文档

搜索