跳转至

Air8783 下载和调试

作者：拓毅恒　|　最后修改：2026-10-16

本文介绍如何配合 Luatools 对 Air8783 进行固件下载与日志抓取。Air8783 出厂固件基于合宙 4G 模组 Air780ER2 内核（core 选 Air780ER2），因此下载与调试方式与 Air780 系列一致；Air8783 是 USB Dongle 形态，对外只有 USB 口，下载和日志都通过 USB 完成。

1. 环境准备

1.1 硬件环境

  • Air8783 整机；
  • USB 口 / 可传数据的 USB 线：Air8783 直接插到电脑 USB 口即可，用于供电、USB 下载与日志抓取；
  • SIM 卡：装到 Air8783 的 SIM 卡座上，注意方向不要装反；需要短信转发功能时，请使用支持收发短信的 4G 手机 SIM 卡，物联网卡不适用；
  • 4G 天线：Air8783 板载高增益贴片天线，无需外接；
  • 电脑：Windows 10 及以上。

image.png

插入 USB 后红色 LED 亮起，说明供电正常；绿色网络灯一般 5 秒之内驻网成功（灯态说明见 默认出厂固件 的图文使用说明）。

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. 进入下载模式

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

4. 下载固件

4.1 量产文件刷机

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

  1. 把 Air8783 插到电脑 USB 口，设备直连后会自动进入下载模式（无需按键）；
  2. 打开 Luatools，点击「下载固件」；
  3. 在弹出的「下载固件」窗口中点击「量产文件刷机」；
  4. 点击「选择文件」，选中出厂固件解压后得到的 .soc 文件（例如 Air8783_001.999.007_LuatOS-SoC_V2050_Air780ER2_106.soc）；
  5. 点击「下载」，等待进度完成即可。

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

4.2 底层 core + 脚本烧录

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

  1. 把 Air8783 插到电脑 USB 口，设备直连后会自动进入下载模式（无需按键）；

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

    Luatools 项目管理入口

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

  4. 选择底层固件：

  5. 恢复量产功能：选 Air8783 对应的 Air780ER2 内核 .soc；

  6. 二次开发：选 Air780ER2 内核 .soc（与 Air780EX2 为同一主芯片、同一份源码），再添加自己的脚本与资源文件；

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

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

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

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

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

注意：历史版本量产固件在开机时会提示需要本地烧录底层固件后缀为 106 编号的量产固件，升级到 106 编号及以上版本后不再提示。

5. 抓取日志

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

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

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

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

    Air8783 的 trace 打印

  3. 典型日志：USB 设备枚举、驻网注册、USB RNDIS 网卡启动、固件版本信息、短信转发结果等。

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

  • main_当天日期.txt：工具本身的日志，用于工具报错时查找原因；
  • trace_当天日期_首次记录时间.txt：用户日志，记录 LuatOS 里调用 print、log 等 API 输出的日志；
  • 4gdiag 文件夹：底层日志（移芯平台的 AP log），LuatOS 日志无法定位问题时使用；
  • ramdump 文件夹：死机 dump 文件，用于死机问题分析。

日志的详细说明和与 EPAT 的配合使用，见 Luatools 下载和详细使用。

6. 常见问题排查

现象 排查方向
设备管理器识别不到端口 换一根能传数据的 USB 线 / 换电脑 USB 口；确认设备已插紧；检查 USB 驱动
点开始下载没反应 / 提示找不到设备 确认 USB 已直连；重新插拔让设备进入下载模式（看设备管理器虚拟 USB 数量是否增加）
烧录提示缺少 xxx.lua 项目管理中勾选「添加默认 lib」，或手动补对应 lib 脚本
电脑上不了网 确认插了流量卡且已驻网；在 Windows 网络适配器中确认 RNDIS 网卡没有被禁用；验证时拔掉网线或禁用有线网卡
收不到转发短信 确认使用的是支持收发短信的手机 SIM 卡（物联网卡不适用），且转发地址配置正确
搜索