跳转至

Air8300 总体说明

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

本文介绍 Air8300 双网口双 485 工控板软件开发的基础信息与参考资料。

一、使用的基础模组型号

Air8300 基于 合宙 Air8000W 设计：Air8000W 内置 4G Cat.1 和 WiFi/BLE 双处理器，其中

  • 4G Cat.1 SoC 为主处理器：我们平时二次开发的软件，就是基于主处理器写的 Lua 代码；
  • WiFi/BLE SoC 为协处理器：固件由合宙提供，不可二次开发，当前最新版本为 V20；当你的 Air8000W 的 WiFi/BLE SoC 版本低于 V20 时，请务必升级到 V20。

因此 Air8300 的软件功能在 Air8000W 系列固件的能力范围内直接复用。开发前建议先看 Air8000 系列资料：https://docs.openluat.com/air8000/。

二、各软件功能模块开发可以参考的固件和代码

1、默认出厂固件

2、基础模组型号对应的软件代码

代码/文档 链接 说明
Air8000 基础模组代码 module/Air8000 Air8000 系列 demo 与 project 工程
Air8300 出厂固件源码 module/Air8300/project/factory Air8300 出厂固件工程
Air8300 板级示例 module/Air8300/demo 板级 demo：modbus rtu / modbus tcp、netdrv、network_routing（多网互备路由）
数据采集器示例工程 module/Air8300/project/dtu_rtu 局域网数据采集终端：内置 Web 配置页面 + AirCloud 上云，演示过程见 数据采集器演示
Air8300 其他工程 module/Air8300/project 工程根目录（factory、dtu_rtu、collect_gateway、edge_gateway）

3、基础模组型号对应的 docs 文章

三、驱动开发注意事项

1、以太网

两个网口共用 SPI1：

  • 网口 1：CS 为 GPIO21，使能为 GPIO16，中断为 WAKEUP0；
  • 网口 2：CS 为 GPIO20，使能为 GPIO17，中断为 WAKEUP6。

2、非隔离 485 接口

使用 UART3，需要做引脚复用：27 脚复用为 GPIO36（收发使能），25 脚复用为 UART3_RX，26 脚复用为 UART3_TX；485 供电脚为 GPIO29，初始化时需要拉高。

pins.setup(27,"GPIO36")
pins.setup(25,"UART3_RX")
pins.setup(26,"UART3_TX")
pins.setup(18,"GPIO29")

local uartid = 3
local uart485Pin = 36 -- 用于控制485接收和发送的使能引脚
gpio.setup(29, 1, gpio.PULLUP) -- 打开电源(工控板485供电脚是gpio29，测试需要开机初始化拉高gpio29)

3、隔离 485 接口

使用 UART1，需要做引脚复用：28 脚复用为 GPIO37（收发使能）。

pins.setup(28,"GPIO37")

local uartid = 1
local uart485Pin = 37 -- 用于控制485接收和发送的使能引脚

4、三色 LED

代码中拉高对应的 GPIO 即可：

gpio.setup(26, 1, gpio.PULLUP)
gpio.setup(27, 1, gpio.PULLUP)
gpio.setup(28, 1, gpio.PULLUP)

供电、开关、外设分布的完整说明见 电路和使用说明。

搜索