跳转至

Air1780P LuatOS固件版本

作者:陆相成 | 最后修改:2026-11-12

最新版本内核固件SDK

特别说明

1. Air1780P 不支持所有与 4G 相关的联网功能,仅可作为 MCU 模组使用;

2. Air1780P LuatOS 内存(RAM)说明;

ram总大小:4MB

用户可用ram:1MB左右Lua 内存+1.5MB左右系统内存

可通过代码准确地获取可用ram:

查询 Lua 虚拟机内存(默认) local total_lua, used_lua, max_used_lua = rtos.meminfo("lua")

查询系统内存 local total_sys, used_sys, max_used_sys = rtos.meminfo("sys")

详细说明见:LuatOS 内存(RAM)使用分析 - 合宙模组资料中心

固件支持核心库列表说明

Air1780P固件支持列表
(1-99号是32位固件;101-199号是64位固件)
核心库名称 简介 101 号
脚本区 代码空间 384KB
fs 文件系统 168KB
airui UI图形化开发 ✓
tts 文字转语音
cc 语音通话
airtalk 对讲
camera 摄像头控制 ✓
fastlz 压缩和解压缩
fatfs FAT32文件系统
little_flash SPI Flash通用驱动
中文字库 12号中文字库
中文灰度点阵字库 16号中文灰度点阵字库 ✓
codec 音频编解码
audio 音频播放和录音
i2s 音频总线控制
ble 低功耗蓝牙
libgnss GNSS定位 ✓
sfud Nor Flash驱动
ymodem 文件传输协议
otp 一次性可编程存储
eink 墨水屏操作库
tp 触摸控制 ✓
lcd 显示屏控制 ✓
u8g2 U8G2图形处理
fft 快速傅里叶变换
hzfont 合宙矢量字库
protobuf ProtoBuff数据操作 ✓
sms 短信(均支持移动/联通 部分支持电信)
adc 模数转换 ✓
airlink 芯片间通信
bit64 32位内核固件上的64位运算 ✓
can CAN总线控制 ✓
crypto 加解密和hash ✓
errDump 远程日志 ✓
fota 远程升级 ✓
fskv kv数据存储 ✓
ftp ftp 客户端 ✓
gmssl 国密算法 ✓
gpio 通用输入输出接口 ✓
hmeta 模组信息 ✓
ht1621 段码屏
http http 客户端 ✓
httpsrv http服务器 ✓
i2c I2C总线控制 ✓
iconv 字符编码转换
io 文件操作 ✓
ioqueue io序列操作
iotauth 物联网云平台鉴权
iperf 网络性能测试 ✓
json JSON数据操作 ✓
log 日志控制 ✓
lora2 lora通信控制
mcu MCU通用功能 ✓
miniz 压缩和解压缩 ✓
mobile 蜂窝通信功能
mqtt mqtt客户端 ✓
netdrv 网卡设备管理 ✓
onewire 单总线协议 ✓
os 操作系统基础功能 ✓
pack 数据打包和解包 ✓
pins 管脚复用 ✓
pm 电源管理 ✓
pwm 脉冲宽度调制 ✓
rsa RSA非对称加解密 ✓
rtc 时钟控制 ✓
rtos 操作系统基础功能 ✓
socket TCP/UDP协议 ✓
spi SPI总线控制 ✓
string 字符串操作 ✓
sys LuatOS运行框架 ✓
sysplus sys库的强力补充 ✓
uart 串口操作库 ✓
wdt 内部软硬件看门狗 ✓
websocket websocket客户端 ✓
wlan WiFi网络控制
xxtea xxtea加解密算法 ✓
zbuff c内存数据操作库 ✓

Air1780P的LuatOS固件版本下载地址

最新版本

LuatOS-SoC_V2056_Air1780P ,请点击下载。

发布日期:2026.11.05

更新记录

1. add: onewire, 单总线增加虚拟总线创建方式

2. update: airui, 优化图片缓存策略,不再一次性全部丢掉缓存图,而是丢最老的,来腾空间

3. update: airlink, airlink.pause扩展到HSPI和UART

4. update: mbedtls, air8000的101/103/105/107/115固件, air1780p的101固件, 关闭mbedtls调试信息

5. update: fatfs, 优化fatfs spi读取速度

6. fix: airlink, 优化airlink uart2导致模块和air1103通信时会让flash擦除超时,回调uart rx fifo中断阈值

7. fix: airlink,netdrv, NAPT 放行 STA 包,修复 4G转WiFi 切热点拿不到 IP(no offer)

8. fix: airlink, 从机UART帧间间隙按帧长自适应, 修复背靠背发帧致主机RX overrun→解析器失步

9. fix: airlink, uart_rx_buffs 加互斥锁,修复串口读旧数据竞态

10. fix: airlink, 修复 rpc_nb_call_yield 早退路径重复 stop/delete 超时定时器导致死机

11. fix: airlink, 从机补发 RPC 能力位并修复通知队列不对称

12. fix: airlink, UART帧间间隙仅EC718启用, 修复6205下载速率回归

13. fix: adc, adc.read失败改为返回-1,而不是255,会有误解

14. fix: tts, 修复部分固件开启了 TTS,却未开启 ONCHIP,因此误走了外置资源路径,导致TTS无法播放

15. fix: romfs, 修正目录深度与文件名长度的两处 off-by-one

16. fix: i2c, i2c.transfer 只发不收时 tx/rx 传参错位, 会向调用者的 tx 缓冲区写入接收数据

17. fix: i2c, i2c.transfer 校验 rx_len 非负并检查 __zbuff_resize 失败, 防止负数导致缩容后堆溢出

18. fix: i2c, i2c.no_block_transfer 校验 rx_len 非负并保证 zbuff 容量, 原来不扩容直接按 rx_len 写穿 zbuff

19. fix: i2s, 接收回调 memcpy 使用已钳制的 len, 否则 rx_len 大于 zbuff 时堆溢出, i2s id 越界校验, recv/on 拒绝负数 id, 事件回调防越界索引

20. fix: spi, spi_device 的 close/transfer/send/recv/no_block_transfer 改用 luaL_checkudata 校验 self

21. fix: spi, spi_device:transfer 的 send_len 不得超出 data 实际长度, 否则越界读并把堆内容发到总线

22. fix: bit64, bit64.to32 长度不是9字节时补 return, 避免读取 data[8] 越界

23. fix: bit64, bit64.show 钳制输出长度, 不依赖 snprintf_ 按 maxsize 截断返回的实现细节

24. fix: bit64, 整除遇除数为0时返回错误, 整数除零是UB, ARM上可能触发SIGFPE

25. fix: iconv, iconv_convert 的句柄范围校验恒为假, 任意 iconv_t 都能直接调用, 改为 uintptr_t 区间判断

26. fix: string.split 比较分隔符前先查边界, 靠近结尾时会读越字符串末尾

27. fix: mqtt, 心跳定时器回调内禁止重排定时器

28. fix: log, printf浮点格式化改用精确dtoa

已知问题

1. V2056 版本固件使用 UART3 进行收发会死机:调用 uart.setup 打开 uart3 后,一旦收发数据就会死机重启,UART3 暂时不可用。需要 UART3 的项目建议暂缓升级、继续使用上一个版本 V2054 的固件;该问题修复后会更新本页。

2. 着急量产的项目:可先烧录 V2054 版本固件,同时在脚本里预留 OTA 升级逻辑,等 V2058 版本发布后再做远程 OTA 升级。

二次开发demo

LuatOS-Air780EPM-demo ,点击此处,跳转阅读;

LuaTools工具教程

Luatools工具使用教程 ,点击此处,跳转阅读;

合宙量产烧录工具

合宙量产烧录工具使用教程 ,点击此处,跳转阅读;

历史版本固件SDK(仅限对比测试使用,推荐使用最新版本)

Air1780P的LuatOS固件历史版本下载地址

LuatOS-SoC_V2054_Air1780P ,请点击下载。

发布日期:2026.10.13

更新记录

1. add: netdrv, 支持ipv6读取本地地址和全局地址

2. update: tp, gt9xx 无中断脚时改用定时轮询

3. update: luatos,log, 优化lua log输出,减少时间消耗

4. update: mbedtls, 重要变更, air780epm全系禁用mbedtls的调试日志输出,air780ehm/air8000的17/117固件也禁用,节省flash资源

5. fix: mbedtls,开启椭圆算法加速时改大tcpip线程栈

6. fix: tts, 修复tts结束时会产生一次多余释放动作

7. fix: netdrv, 修复ipv6不会主动发送rs

8. fix: tp, gt9xx 轮询模式清空接触数组, 避免重复上报抬起

9. fix: airlink,uart, 主机UART解析器残帧吞帧失步修复,消除下载截断/链路超时

10. fix: uart, 启用UART 接收阈值并设为5

LuatOS-SoC_V2052_Air1780P ,请点击下载。

发布日期:2026.09.16

更新记录

1. add: luatos, 增加支持 ioqueue 核心库

2. update: mbedtls, TLS/ECDH 握手性能优化与内存池跨平台化

3. update: mbedtls, 重要变更,关闭AES-CCM系列加密套件; 椭圆算法仅保留SECP256+和22519,验签保留SECP256和SECP384

4. update: luatos, air8000/air780ehm的1/5/7/101/105/107固件,裁剪eink支持的型号列表

5. update: tick, 优化RTC时间获取,接近满1秒时主动加1秒

6. update: airlink, HSPI INT 引脚默认gpio12,改为可配置化,未配置则不初始化

7. fix: socket, socket.read大包(>256B)读取触发luaL_Buffer栈损坏崩溃, 调整push顺序

8. fix: net_lwip2, tcp没有正确绑定本地端口

9. fix: airlink, 修复空帧内存泄漏与扫描结果帧积压

10. fix: iotauth, 修复qcloud conn_id生成, signed char取模导致非字母字符

11. fix: pm, 修复mcu模块下HIB/SLEEP2唤醒死机问题

12. fix: pm, mcu模式dtimer休眠按真实SC校准, 修复提前唤醒

LuatOS-SoC_V2050_Air1780P ,请点击下载。

发布日期:2026.08.21

更新记录

  1. add: air1780p, 禁用jpg硬解功能

  2. add: fota, 差分升级增加检查ota包长度是否越界,避免远程升级出现问题。

  3. update: ftp,netdrv,lwip,ble, 修正/增加/移除了一些调试日志,出现问题时更好的帮助分析

  4. fix: air1780p, 修复dtimer唤醒出现死机

  5. fix: onewire, 修复可能出现的内存泄漏

  6. fix: i2s,log, 修复加载/保存i2s配置的打印中i2s_id有的时候是0,有的时候是1

LuatOS核心库列表及功能详解 ,点击此处,跳转阅读;

LuatOS-SoC_V2048_Air1780P ,请点击下载。

发布日期:2026.08.03

更新记录

Air1780P的第一个LuatOS固件版本

  1. 管脚与原版兼容:基于经典 4G Cat.1 模组改版,除不支持 4G 功能(SIM/天线)外,其余管脚完全兼容;
  2. 沿用 LuatOS 核心库/扩展库,新项目快速上手,老项目可快速更换
  3. 增强了选型的灵活性:可选择符合功能的 MCU 模组,自由外挂其它通信模组

Air1780P 不支持所有与 4G 相关的联网功能,仅可作为 MCU 模组使用;

搜索