Air8301 总体说明
作者：王城钧 | 最后修改：2026-10-10
一、使用的基础模组型号
Air8301 基于 合宙 Air8000W开发。
Air8301 支持二次开发，核心功能如下：
4G + WiFi + 以太网 多网融合，双 RS485/双 RS232 电平转换、DI/DO、4.3 寸触摸屏（ST6201 + GT911）、SPI NAND Flash 与 Air153D 外部硬件看门狗。
因此 Air8301 的软件功能在 Air8000W 系列固件的能力范围内直接复用；
开发前建议先看 Air8000 系列资料：https://docs.openluat.com/air8000/。
二、各软件功能模块开发可以参考的固件和代码
1、默认出厂固件
- 打包好的默认出厂固件、源码与图文使用说明：Air8301默认出厂固件
- 本板出厂已默认烧录固件，插上 USB 线供电即可运行；
- 内核固件：Air8301 出厂固件基于 Air8000 的 114 号固件（2052-114），理论 2026.10.9 之后的 114 号固件都支持；Air8000 各版本固件说明见 Air8000 固件版本
2、主控型号对应的软件代码
| 代码/文档 | 链接 | 说明 |
|---|---|---|
| LuatOS 源码仓库 | https://gitee.com/openLuat/LuatOS/tree/master/module/Air8301 | Air8301 的源码目录 |
| 出厂固件工程 | module/Air8301/project/factory | 出厂固件：继电器控制 + 网口/485 数据服务 + 内置网页 + 触屏本地操作 + AirCloud 上云 + FOTA |
| 硬件测试工程 | module/Air8301/project/hardware_test | 板级外设逐项测试：网络、双 485/双 232、DI/DO、蜂鸣器、状态灯、看门狗、SPI Flash、屏幕与触摸 |
| 业务示例工程 | module/Air8301/project/electric_device | 基于 Air8301 的整机业务示例 |
三、驱动开发注意事项
1、必须按本板原理图改脚位
| 外设 | 引脚 |
|---|---|
| LCD | LCD_EN=GPIO28, LCD_RST=GPIO36, 背光 PWM0=GPIO1_PWM0 |
| 触摸 | GT911, I2C0, TP_RESET=GPIO26, TP_INT=WAKEUP0 |
| 以太网1 | CH390H, SPI1/CS=GPIO12, INT=GPIO20, 供电=GPIO32 |
| 以太网2 | CH390H, SPI1/CS=GPIO5, INT=CHG_DET, 供电=GPIO33 |
| RS485_1 | UART1, RE/DE=GPIO2, 供电=GPIO29 |
| RS485_2 | UART11, RE/DE=GPIO153, 供电=GPIO147 |
| RS232_1 | UART2, 供电=GPIO30 |
| RS232_2 | UART12, 供电=GPIO146 |
| DI1/DI2 | GPIO16/GPIO17 |
| DO1/DO2 | GPIO24/GPIO25 |
| 蜂鸣器 | PWM2 (PIN98) |
| 看门狗 | GPIO27 |
| Flash | SPI1/CS2=GPIO4, 供电=GPIO140 |
| 状态灯 | 4G=GPIO21, WiFi=GPIO141 |
| 复位 | WAKEUP2 |
2、先开外设供电使能，再谈驱动
本板 9 路外设电源域由主控 GPIO 单独控制（详见 电路和使用说明 的「9 路外设供电使能」），固件初始化时必须显式把这些 EN 置到需要的状态，否则会出现"硬件是好的、但某个外设就是不通电"的假故障。
- ⚠️ 官方以太网示例里的
pwrpin = 140是官方核心板点位；本板GPIO140是 SPI NAND Flash 的电源使能，任何情况下不要挪用（一个gpio.setup(140, 0)就能让板子起不来）。本板两路网口的供电使能是GPIO32/GPIO33； - 串口端子供电与外设使能共用 GPIO，关掉端子供电这一路的收发器会跟着断电、串口就不通了；
- 屏幕要显示，必须显式打开
LCD_EN（GPIO28）并让GPIO1_PWM0输出 PWM 背光，两条缺一不可（出厂固件已自动做这一步，自己烧录的固件不会自动做）。