Air8380 总体说明
作者：王城钧 | 最后修改：2026-10-22
本文介绍 Air8380 工业模组软件开发的基础信息：用哪颗模组、能直接复用哪些资料与代码、板级相关的软件要点。
一、使用的基础模组型号
Air8380 基于 合宙 Air8000W 设计。Air8000W 内置 4G Cat.1 和 WiFi/BLE 双处理器：
- 4G Cat.1 SoC 为主处理器：我们平时二次开发的软件，就是基于主处理器写的 Lua 代码；
- WiFi/BLE SoC 为协处理器：固件由合宙提供，不可二次开发，当前最新版本为 V20；当你的 Air8000W 的 WiFi/BLE SoC 版本低于 V20 时，请务必升级到 V20（见 USB 方式升级 WiFi 固件）。
因此 Air8380 的软件功能直接落在 Air8000W 系列固件的能力范围内。开发前建议先看 Air8000 系列资料：https://docs.openluat.com/air8000/。
选内核时按 Air8000W 选，不是 Air8000/Air8000P。
二、可以直接参考的固件和代码
1、Air8000W 基础模组资料
| 内容 | 链接 | 说明 |
|---|---|---|
| Air8000 资料中心 | https://docs.openluat.com/air8000/ | 产品、硬件、LuatOS 全部文档入口 |
| Air8000 内核固件版本 | https://docs.openluat.com/air8000/luatos/firmware/ | 内核版本与更新说明 |
| Air8000 应用示例 | https://docs.openluat.com/air8000/luatos/app/ | 联网、内置网页、Modbus/485、网络切换等 |
| LuatOS 库函数开发手册 | https://docs.openluat.com/osapi/ | 全部内置库与扩展库 API |
| Luatools 下载调试工具 | https://docs.openluat.com/common/Luatools/ | 烧录、日志、量产刷机 |
2、Air8380 出厂固件与工程
| 内容 | 链接 | 说明 |
|---|---|---|
| 出厂固件（量产刷机包） | 默认出厂固件 | Air8380_Factory_001.999.001_LuatOS-SoC_V2054_Air8000W_113.soc，下载目录 cdn18.luatos.com/files/Air8380/ |
| 出厂固件源码 | module/Air8380/project/factory | 出厂工程，板级配置集中在 board.lua |
板级 demo 工程（以太网 / SPI NAND / 多网切换的最小示例）尚未整理，发布后请同步更新本页与 默认出厂固件。
三、Air8380 板级软件要点
1、外设 3.3V 电源（GPIO20）
板载 3.3V LDO 由 GPIO20（AGPIO） 控制，高电平打开、低电平关闭，常规/低功耗/PSM+ 模式下电平都能保持：
gpio.setup(20, 1) -- 打开 3.3V 外设电源
外设第一次上电不工作的，先查这一步有没有拉高。
2、可用的串口
Air8380 引出的是 Air8000W 的模组管脚，串口使用前需要先做引脚复用（pins.setup），再按 uart.setup 配置。丝印上可直接看到：
UART11_RX/WGPIO129（PIN02）、UART11_TX/WGPIO128（PIN03）；UART12_RX/WGPIO168（PIN12）、UART12_TX/WGPIO169（PIN13）；LCD_CS/I2C0_SCL/UART3_TXD/GPIO35、LCD_CLK/I2C0_SDA/UART3_RXD/GPIO34可作为 UART3；CAM_RX0/UART2_RX/GPIO7（PIN36）及其配对的CAM_RX1/UART2_TX可作为 UART2；- 底部邮票孔中另有
UART1_TXD/UART1_RXD两个引出脚，可作为 UART1； - UART0 未引出（用于调试/日志），不要占用。
具体脚号以 GPIO 复用表 和原理图为准。
3、板载 SPI NAND
板载 SPI NAND 挂在 SPI1 上（原理图标 GD5F1GM7UEYIGR，实板 JEDEC 实测 EF AE21 → W25N01KVZEIR，1Gbit = 128MB，半双工 2MHz）：
- 片选：
FLASH_CS/GPIO16 - 总线：
SPI1_CLK/GPIO15、SPI1_MOSI/GPIO13、SPI1_MISO/GPIO14 - 供电：独立 LDO，EN =
FLASH_LDO_EN/GPIO2
LuatOS 侧可用 little_flash（SPI NAND 推荐）或 sfud 挂载。
4、以太网
板载 CH390H（SPI 接口 10/100M 以太网控制器），软件侧按 netdrv + SPI 以太网方案接入，可与 4G/WiFi 做多网选路：
- SPI1 与板载 SPI NAND 共用，CH390H 片选 =
SPI1_CS/GPIO12 - 中断：
ETH_INT= GPIO17（中断模式收包） - 供电：独立 LDO，EN =
CH390_LDO_EN/GPIO1
5、低功耗
- 需要在低功耗/PSM+ 下保持电平的外设使能脚，请选 AGPIO（GPIO20~GPIO25）或 WGPIO；
- 普通 GPIO 在低功耗/PSM+ 下电平无法保持，不要用来控制外设电源；
- WAKEUP0/WAKEUP2/PWRKEY/CHG_DET 可配置单边或双边中断，用于唤醒。