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)使用分析 - 合宙模组资料中心
固件支持核心库列表说明
| 核心库名称 | 简介 | 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
更新记录
-
add: air1780p, 禁用jpg硬解功能
-
add: fota, 差分升级增加检查ota包长度是否越界,避免远程升级出现问题。
-
update: ftp,netdrv,lwip,ble, 修正/增加/移除了一些调试日志,出现问题时更好的帮助分析
-
fix: air1780p, 修复dtimer唤醒出现死机
-
fix: onewire, 修复可能出现的内存泄漏
-
fix: i2s,log, 修复加载/保存i2s配置的打印中i2s_id有的时候是0,有的时候是1
LuatOS核心库列表及功能详解 ,点击此处,跳转阅读;
LuatOS-SoC_V2048_Air1780P ,请点击下载。
发布日期:2026.08.03
更新记录
Air1780P的第一个LuatOS固件版本
- 管脚与原版兼容:基于经典 4G Cat.1 模组改版,除不支持 4G 功能(SIM/天线)外,其余管脚完全兼容;
- 沿用 LuatOS 核心库/扩展库,新项目快速上手,老项目可快速更换
- 增强了选型的灵活性:可选择符合功能的 MCU 模组,自由外挂其它通信模组
Air1780P 不支持所有与 4G 相关的联网功能,仅可作为 MCU 模组使用;