Air8783 软件开发资料-下载和调试

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

Air8783 通过 USB 接口和电脑连接，配合合宙的 Luatools 工具即可完成固件下载、脚本烧录和日志抓取。

一、工具准备

1. 下载安装 Luatools：Luatools v3 下载调试工具
2. Luatools 运行于 win10 及以上系统，不支持 Mac 和 Linux；详细安装和使用方法见 Luatools 下载和详细使用

二、下载固件

1. 把 Air8783 插到电脑 USB 口，等待电脑识别出 Air8783 的 USB 端口（设备管理器/端口中可以看到对应的串口）；
2. 打开 Luatools，在 LuatOS 页面选择要烧录的底层固件（.soc 文件，下载地址见 默认出厂固件）或者脚本项目；
3. 点击下载，等待进度条走完并提示下载完成即可。

注意：Air8783 出厂已烧录支持量产功能的固件，无需额外烧录，需要更新固件时再参考 默认出厂固件 中的固件下载地址。

三、抓取日志

感兴趣的话，可以使用合宙提供的 Luatools 观察 Air8783 吐出的 trace 信息：

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

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

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