跳转至

Air8603 下载和调试

本文介绍如何配合 Luatools 对 Air8603 进行固件下载与日志抓取。Air8603 按装配的联网模组不同分为两个版本：Air6205A 版本（WiFi） 与 Air780EX2 版本（4G）。两个版本的主控均为 Air1603，板上带 USB 转串口电路，通过 Type-C（USB2）即可下载和抓日志；4G 版本另有 USB3 用于 Air780EX2 模组本身的下载与维护。

一、Air6205A 版本（WiFi）

1. 环境准备

硬件：

  • Air8603 W 系列控制板（装配 Air6205A WiFi 模组）；
  • Type-C 数据线（必须是能传数据的线，纯充电线连不上）；
  • DC 12V 电源适配器（整机主电源，J1 输入）；
  • WiFi 天线：板上 IPEX → IPEX 转 SMA 线 → SMA 接头 WiFi 天线（BOM 默认路径）；
  • 屏、触摸、喇叭、SD 卡：按调试内容接上（只看串口日志时可不接屏，但仍需 12V 主电源）；
  • 外设：RS485 / TTL 设备、UVC 摄像头、人脸识别摄像头等按业务接入；
  • 电脑：Windows 10 及以上；
  • 现场可用的 2.4G WiFi 名称与密码。

软件：

  • 合宙官方下载调试工具 Luatools（最新版）：Luatools 下载和详细使用；
  • USB 转串口驱动：按板上实际使用的 USB 转串口芯片安装（以原理图与驱动说明为准）；
  • 内核固件与两个版本的打包固件说明见 默认出厂固件。

2. 连接与端口识别

  1. 接好 WiFi 天线，12V 主电源接入 J1，SW10 打到 ON，板子供电；
  2. 用 Type-C 数据线连接 USB2 与电脑；
  3. 打开设备管理器，驱动正确安装后可看到板载 USB 转串口对应的 COM 端口；
  4. 识别不到端口时：先装驱动，再换一根能传数据的 USB 线 / 换电脑 USB 口；确认 12V 电源与 SW10 状态。

设备管理器中识别 Air8603 的 COM 端口

3. 下载固件

WiFi 与 4G 版本均不提供脚本，只提供一个 .soc 固件文件（脚本已打包进固件），使用 Luatools 的「使用量产文件刷机」方式烧录：

  1. 打开 Luatools，选择 USB2 对应的串口，勾选「通用串口打印」，点击「打开串口」；

Luatools 选择串口并打开串口

  1. 点击「使用量产文件刷机」，在弹出的「下载固件」窗口中点击「选择文件」，选择 WiFi 版本出厂固件 .soc（下载见 默认出厂固件）；
  2. 点击「下载」，等待烧录进度完成。

选择固件后点击下载

烧录完成后在界面中配置 WiFi 名称与密码。

WiFi 版本联网配置界面

WiFi 版本联网配置界面

WiFi 版本联网配置界面

WiFi 版本联网配置界面

注意：确认 12V 供电正常再点下载；外设大负载不要与主板共用调试用的 USB 供电。

二、Air780EX2 版本（4G）

1. 环境准备

硬件：

  • Air8603 M 系列控制板（装配 Air780EX2 4G 模组）；
  • 两根 Type-C 数据线：一根连主控 USB2，一根连 4G 模组 USB3；
  • DC 12V 电源适配器（J1 输入）；
  • 4G 天线：板上 SMA（RF2）→ SMA 接头 4G 天线；
  • 可用的 SIM 卡（装入 CARD1）；
  • 屏、触摸、喇叭、SD 卡与外设按调试内容接入；
  • 电脑：Windows 10 及以上。

软件：

2. 连接与端口识别

  1. 12V 主电源接入 J1，SW10 打到 ON；Type-C 线连接 USB2 与电脑，出现主控侧 COM 端口；
  2. 另用一根 Type-C 线连接 USB3 与电脑，会再出现一个 4G 模组侧端口；
  3. 插入 SIM 卡、接好 SMA 天线，按 KEY6（PWRKEY）开机。

4G 模组侧 USB 端口识别（USB 串行设备）

3. 下载固件

主控： 与 WiFi 版本一致，通过 USB2 使用「使用量产文件刷机」烧录 Air780EX2 版本出厂固件 .soc（不提供脚本）。

4G 模组： 板载 Air780EX2 采用定制配置，只能烧录 Air8603 专用 4G 固件，不能使用 Air780EX2 公版出厂固件：

  • 固件文件名：Air8603_Air8605_4G_Air780EX2_001.999.000_LuatOS-SoC_V2054_Air780EX2_109.soc；
  • 文件名同时包含 Air8603 / Air8605，表示这是适用于这两款整机的同一份适配固件；
  • 用 Type-C 线连接 USB3 与电脑，Luatools 中选择该 .soc 烧录；后续重新烧录或升级也请使用该文件；
  • 烧录其他固件可能导致 4G 无法正常联网；需要进入下载模式时，使用 KEY4（USB_BOOT）配合 KEY3（RESET）、KEY6（PWRKEY）。

4G 专用固件烧录界面（下载成功）

注意：下载 4G 固件时必须保证电压稳定，电压波动可能导致烧录失败或固件异常。

SIM 卡座与 4G 天线（SMA）连接实拍

三、抓取日志

Air8603 的日志通过板载 USB 转串口（USB2）输出，Luatools 用「通用串口打印」抓取：

  1. 在 Luatools 串口设置中选择 USB2 对应的端口，勾选「通用串口打印」，打开串口；
  2. 上电 / 复位（SW7）板子，观察日志；典型日志包括 UI/桌面启动、SD 卡挂载、音频播放、串口外设与网络模块加载等信息；
  3. 4G 模组底层日志走板内 DBG_TXD/DBG_RXD 测试点，不是通用的 TTL 外设口，需按 4G 模组调试方式查看；
  4. 串口被 Luatools 打开时会独占该端口，直接用文本编辑器看 log 文件前，需要先关闭 Luatools。

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

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

四、产线量产

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

五、常见问题排查

现象 排查方向
设备管理器识别不到端口 安装板载 USB 转串口驱动；换能传数据的 USB 线；换电脑 USB 口；确认 12V 与 SW10
点下载没反应 / 提示找不到设备 确认串口已选对并「打开串口」；确认 12V 供电正常；重新插拔 USB2
烧录中途失败 12V 适配器功率不足或外设大负载干扰，改用匹配电源；确认没有其他程序占用串口
烧录提示缺少 xxx.lua 项目管理中勾选「添加默认 lib」，或手动补对应 lib 脚本
4G 无法联网 确认烧录的是 Air8603 专用 4G 固件；确认 SIM 卡与天线（SMA/RF2）连接；确认 KEY6 已开机
WiFi 无法联网 确认天线经 IPEX 转 SMA 线接好；确认型号为 W 系列、固件为 WiFi 版本
屏不亮 / 花屏 确认屏针数（40PIN P1 / 50PIN J2）与工程配置的分辨率、时序一致；排线是否插紧
触摸无反应 确认触摸 FPC（TP2）插好，触摸 IC 与 I2C1 配置（TP_RST、WAKEUP）正确
喇叭没声音 确认 SD 卡/音频文件存在；确认 5V_EN 已使能、J13 接线为 SPK+/SPK−
RS485 通信异常 确认型号后缀对应的端子（J21/J22 隔离、J20 非隔离）与 485_EN 状态；核对 A/B 线序与终端电阻
TTL 串口接不通 确认是 TTL 逻辑电平（J7 或 J20 TTL 配置），不要按 RS232/RS485 接线；核对 TX/RX 交叉与电平匹配
USB 外设不识别 核对 UVC_EN 供电、J8/J14 共用一路 USB 的限制与外设规格
RJ45 / IPC 不通（4G） 确认是 M 系列且已装配 CH390H、使用支持转发的专用固件；IPC 需独立供电，无 PoE
搜索