Air8300 下载和调试
作者：王城钧 | 最后修改：2026-10-12
本文介绍如何配合 Luatools 对 Air8300 双网口双 485 工控板进行固件下载与日志抓取。Air8300 的主控是 Air8000W，选内核时按 Air8000W 选。
1. 环境准备
1.1 硬件
- Air8300 双网口双 485 工控板；
- Type-C 数据线（必须是能传数据的线，纯充电线连不上）；
- 4G 天线、WiFi 天线（使用无线功能时接上）；
- SIM 卡（使用 4G 时插入）；
- 直流电源或电池（可选，USB 供电也可以，供电说明见 电路和使用说明）；
- 电脑：Windows 10 及以上。
1.2 软件
- 合宙官方下载调试工具 Luatools（最新版）：Luatools 下载和详细使用；
- lib 脚本：用 Luatools 烧录时勾选「添加默认 lib」，使用默认 lib 脚本文件；
- 内核固件与打包固件说明见 默认出厂固件。
2. 连接与进入下载模式
USB 线一端接工控板的 Type-C 口、另一端接电脑，电源指示灯亮起表示已上电。
- 免 BOOT 下载（推荐先试）：Air8300 在正常开机状态下可以通过 USB + Luatools 免 BOOT 下载，不需要手动按住 BOOT 键；这种方式操作最简单，但仅适用于正常开机的状态，且有一定的失败概率；
-
开机即进入 USB 下载模式（免 BOOT 失败时用）：
-
电脑打开 Luatools，设置好下载页面，点击「下载底层和脚本」；
- 板子先按住 BOOT 键，然后插上 USB 线，连接板子和电脑；
- 当提示已检测到设备时松开 BOOT，等待下载完成。
划重点：按住 BOOT 键 → 上电 → 提示检测到设备后松开，顺序不要乱。
3. 下载固件
3.1 量产文件刷机
如果只是要把设备恢复到出厂固件，使用「量产文件刷机」：
-
用 Type-C 数据线连接 PC，按上一节的方式进入下载模式；
-
打开 Luatools，点击「下载固件」；
-
在弹出的「下载固件」窗口中点击「量产文件刷机」；
-
点击「选择文件」，选中出厂固件压缩包解压后得到的
.soc文件（例如Air8300_DataCollector_001.999.001_LuatOS-SoC_Air8000W_101.soc）； -
点击「下载」，等待进度完成即可。
3.2 底层 core + 脚本烧录
如果要二次开发、单独替换脚本或底层 core，请用「项目管理测试」方式：
-
用 Type-C 数据线连接 PC，进入下载模式（方法见上一节）；
-
打开 Luatools，点击「项目管理测试」入口；
-
若未建过项目，先新建一个项目；
-
选择底层固件：二次开发选 Air8000W 的内核
.soc，再添加自己的脚本与资源文件； -
添加脚本以及资源文件；
-
勾选「添加默认 lib」（require 了扩展库会直接烧录；不勾选会提示缺少 xxx.lua）；
-
点击「下载底层和脚本」烧录；
- 若只是脚本变动、固件不变，点「下载脚本」即可。
4. 抓取日志
Air8300 的日志默认通过 USB 虚拟串口输出，Luatools 自动识别，无需设置波特率。
- Luatools「日志打印窗口」勾选「4G 模块 USB 打印」（USB 物理连接时务必勾选）；
- 上电 / 重启设备，观察日志。
Luatools 抓取的日志保存在工具目录的 log 文件夹下：
main_当天日期.txt：工具本身的日志，用于工具报错时查找原因；trace_当天日期_首次记录时间.txt：用户日志，记录 LuatOS 里调用 print、log 等 API 输出的日志；4gdiag文件夹：底层日志，LuatOS 日志无法定位问题时使用；ramdump文件夹：死机 dump 文件，用于死机问题分析。
5. 常见问题排查
| 现象 | 排查方向 |
|---|---|
| 设备管理器识别不到端口 | 换一根能传数据的 USB-C 线；装驱动；按「按住 BOOT 再上电」的方式进入下载模式 |
| 免 BOOT 下载失败 | 免 BOOT 仅在正常开机状态下可用且有失败概率，改用按住 BOOT 上电的方式 |
| 板子不上电 | 检查电源指示灯；使用电池供电时注意极性，电压范围 3.3V~4.3V（建议 3.8V）；VIN 供电范围为 5-12V |
| 某个 485 口不通 | 是否已按 总体说明 复用引脚并拉高使能脚（非隔离 485 供电脚 GPIO29）；A/B 是否接反；波特率是否一致 |
| 烧录提示缺少 xxx.lua | 项目管理中勾选「添加默认 lib」，或手动补对应 lib 脚本 |