跳转至

Air8380 下载和调试

作者：王城钧　|　最后修改：2026-10-22

本文介绍如何配合 Luatools 对 Air8380 工业模组进行固件下载与日志抓取。Air8380 的主控是 Air8000W，选内核时按 Air8000W 选。

1. 环境准备

1.1 硬件

  • Air8380 工业模组（裸板即可，不需要核心板或开发板）；
  • 合宙下载调试转接板 AirBurn8700（6 个 2.54mm 插针：BOOT / DM / DP / GND / VBAT / GND）+ 简易夹具，或自制的 6P 连接线；
  • Type-C 数据线（必须是能传数据的线，纯充电线连不上）——接在转接板一侧；
  • 4G 天线、WiFi 天线（使用无线功能时接上）；
  • SIM 卡（使用 4G 时插入，Micro-SIM 小卡）；
  • 电脑：Windows 10 及以上。

转接板针脚定义、测试点位置与夹具用法见 电路和使用说明 · 下载调试测试点。

1.2 软件

2. 连接方式

2.1 官方推荐：测试点 + 下载调试转接板

  1. 按下载口丝印把转接板的 6 个插针接到 Air8380 下载口的 6 个测试点（可用夹具顶针压住）：
转接板针位 接到 Air8380 下载口
1 BOOT USB_BOOT
2 DM（D-） USB_DM
3 DP（D+） USB_DP
4 GND GND
5 VBAT VBAT
6 GND PWRKEY（接地即自动开机）

转接板针位与下载口脚位号是镜像关系，一律以丝印名称为准。针位表详见 电路和使用说明 · 下载调试测试点。

  1. 转接板 Type-C 口用数据线连电脑；
  2. 转接板通过 USB_VBUS 取 5V，经板载 DCDC 输出 3.8V 给 Air8380 供电，无需另外给板子供电。

此时 VBAT 与模组供电由转接板提供，不要再从邮票孔给板子另外加电，避免双电源对冲。

2.2 自己在产品板上引出 USB

如果 Air8380 已经焊到你的大板上，可以用邮票孔里的 USB 信号直接连 PC：

邮票孔信号 接到
USB_DP（D+） USB D+
USB_DM（D-） USB D-
USB_VBUS USB 5V（也可仅用于检测）
USB_BOOT 需要下载时拉高，配合复位进入 USB BOOT
GND USB GND

供电由你板上的 3.8V/电池电源提供。这种方式没有转接板上的 1.8V BOOT 电路，进入 BOOT 需要通过 USB_BOOT 脚配合上电时序实现。

3. 进入下载模式

  • 免 BOOT 下载（推荐先试）：Air8380 在正常开机状态下可以通过 USB + Luatools 免 BOOT 下载，不需要手动进 BOOT；这种方式操作最简单，但仅适用于正常开机状态，且有一定的失败概率；
  • 强制进入 USB 下载模式（免 BOOT 失败时用）：
  • 用转接板时：把转接板上的 BOOT 拨动开关拨到与 1.8V 相连的位置（相当于按住 BOOT），再上电；
  • 自己引出 USB 时：把 USB_BOOT 拉高后给模组上电（或用复位脚复位）。

Luatools 操作顺序：

  1. 电脑打开 Luatools，设置好下载页面，点击「下载底层和脚本」；
  2. 板子先进入 BOOT 状态（拨动开关 / 拉高 USB_BOOT），然后插上 USB 线或给板子上电；
  3. 当提示已检测到设备时退出 BOOT（拨回开关 / 松开 USB_BOOT），等待下载完成。

划重点：先 BOOT → 再上电 → 提示检测到设备后松开，顺序不要乱。

4. 下载固件

4.1 量产文件刷机

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

  1. 连接 PC，按上一节方式进入下载模式；
  2. 打开 Luatools，点击「下载固件」；
  3. 在弹出的「下载固件」窗口中点击「量产文件刷机」；
  4. 点击「选择文件」，选中出厂固件压缩包解压后得到的 .soc 文件；
  5. 点击「下载」，等待进度完成。

4.2 底层 core + 脚本烧录

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

  1. 连接 PC，进入下载模式；
  2. 打开 Luatools，点击「项目管理测试」入口；

Luatools 项目管理入口

  1. 若未建过项目，先新建一个项目；
  2. 选择底层固件：二次开发选 Air8000W 的内核 .soc，再添加自己的脚本与资源文件；
  3. 添加脚本以及资源文件；
  4. 勾选「添加默认 lib」（require 了扩展库会直接烧录；不勾选会提示缺少 xxx.lua）；
  5. 点击「下载底层和脚本」烧录；

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

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

5. 抓取日志

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

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

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

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

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

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

6. 常见问题排查

现象 排查方向
设备管理器识别不到端口 换一根能传数据的 USB-C 线；检查转接板 5 个针与测试点是否一一对应（BOOT/D-/D+/GND/VBAT 不要错位）；按强制 BOOT 方式上电
免 BOOT 下载失败 免 BOOT 仅在正常开机状态下可用且有失败概率，改用拨动开关/拉 USB_BOOT 的方式
板子不上电 检查转接板 VBAT 与 USB 供电；自己供电时确认 VBAT 在 3.3V~4.3V、VDD_EXT 是否有输出
搜网慢 / 无信号 4G 天线是否接到 LTE ANT 的 SMA 座；SIM 卡是否插好（Micro-SIM，注意方向）
WiFi 连不上 WiFi 协处理器固件版本是否低于 V20，先升级（见 总体说明）
外设不上电 是否已 gpio.setup(20, 1) 打开板载 3.3V LDO
烧录提示缺少 xxx.lua 项目管理中勾选「添加默认 lib」，或手动补对应 lib 脚本

7. 相关文档

搜索