跳转至

下载和调试

王世豪

本文介绍如何配合 Luatools 对 Air8784 进行固件下载与日志抓取。Air8784 出厂固件基于合宙 4G 模组 Air780EHM 内核（core 选 Air780EHM），因此下载与调试方式与 Air780 系列一致。

1. 环境准备

1.1 硬件环境

  • Air8784 整机；
  • USB Type-C 数据线（用于供电、USB 下载与日志抓取）；
  • SIM 卡（视场景：纯 SIP 数据业务用物联网卡即可；CC 桥接打普通手机需用已实名且开通 VoLTE 的手机卡，物联网卡不能打普通电话）；
  • 4G 天线（Air8784 整机已安装好天线）；
  • 电脑：Windows 10 及以上。

Air8784 整机外观

1.2 软件环境

  • Luatools 调试工具（最新版，下载地址）；
  • lib 脚本：用 Luatools 烧录时勾选「添加默认 lib」，使用默认 lib 脚本文件。

内核固件、出厂打包固件、Lua 应用脚本与资源文件已在 出厂固件使用说明 中说明。

2. 安装 Luatools

  1. 运行环境：Windows 10 及以上；不支持 Mac 和 Linux。
  2. 下载 Luatools v3（文件名 Luatools_v3.exe）。
  3. 建议在某个盘（如 D 盘）根目录新建 Luatools 文件夹，把 Luatools_v3.exe 放进去（目录过深可能导致部分功能异常）。
  4. 双击 Luatools_v3.exe 启动，关闭每日 tips，点「开始」更新；若被杀软拦截，请务必放行。
  5. 更新完成后会生成 _temp / config / log / resource / project 等文件夹。

向合宙技术人员寻求远程支持时，需提交 log 目录下的文件（如 4gdiag 底层日志、ramdump 死机文件、trace_* 调试日志）。

3. 进入下载模式

Air8784 整机通过 USB 直连即可进入下载模式，无需按住 boot 键，直接烧录。

4. 下载固件

4.1 量产文件刷机

如果只是要把设备恢复到出厂固件，使用「量产文件刷机」：

  1. 用 USB Type-C 连接 PC，设备直连后会自动进入下载模式（无需按键）；
  2. 打开 Luatools，点击「下载固件」；
  3. 在弹出的「下载固件」窗口中点击「量产文件刷机」；
  4. 点击「选择文件」，选中出厂固件压缩包解压后得到的 .soc 文件（例如 Air8784_Factory_001.000.002_LuatOS-SoC_V2052_Air780EHM_13.soc）；
  5. 点击「下载」，等待进度完成即可。

Luatools 量产文件刷机：选择 .soc 文件后点击下载

4.2 底层 core + 脚本烧录

如果要二次开发、单独替换脚本或底层 core，请用「项目管理测试」方式：

  1. 用 USB Type-C 连接 PC，设备直连后会自动进入下载模式（无需按键）；

  2. 打开 Luatools，点击「项目管理测试」入口；

Luatools 项目管理入口

  1. 若未建过项目，先新建一个项目；

  2. 选择底层固件：

  3. 二次开发：选 Air780EHM 的内核 .soc，再添加自己的脚本与资源文件；

  4. 添加脚本以及资源文件；

  5. 勾选「添加默认 lib」（require 了扩展库会直接烧录；不勾选会提示缺少 xxx.lua）；

  6. 点击「下载底层和脚本」烧录； ；

  7. 若只是脚本变动、固件不变，点「下载脚本」即可。

LuatOS 项目管理界面：选择底层 core、添加脚本、勾选添加默认 lib、下载底层和脚本

5. 抓取日志

Air8784 的日志默认通过 USB 虚拟串口输出，Luatools 自动识别，无需设置波特率。

  1. Luatools「日志打印窗口」勾选「4G 模块 USB 打印」（USB 物理连接时务必勾选）；

Luatools 日志打印窗口，勾选「4G 模块 USB 打印」

  1. 上电 / 重启设备，观察日志；

  2. 典型日志：进入业务模式、SIP 注册成功、exsip init completed；通话信令会看到 180 Ringing、200 OK，超时返回 486 Busy Here 等。

若改用通用串口（UART0 / DBG_UART）抓取底层日志，需在「串口打印」中选择对应 COM 口，波特率按出厂默认配置（具体见出厂固件说明）；注意串口日志会独占该端口，用文本编辑器直接看 log 文件前需先关闭 Luatools。

6. 常见问题排查

现象 排查方向
设备管理器识别不到端口 确认 USB 线可传数据；进入下载模式看虚拟 USB 数量是否增加；检查 USB 驱动
点开始下载没反应 / 提示找不到设备 确认 USB 已直连、设备已进入下载模式（看设备管理器虚拟 USB 数量是否增加）；自画板需按硬件手册拉高 boot 引脚
烧录提示缺少 xxx.lua 项目管理中勾选「添加默认 lib」，或手动补对应 lib 脚本
搜索