跳转至

Air700ECP LuatOS固件版本

作者:陆相成 | 最后修改:2026-05-18

最新版本内核固件SDK

特别说明

1. 因Flash空间有限,而LuatOS功能又太多,一个固件无法放下全部功能,所以必须用不同的固件种类,装载不同的核心库组合;

2. Air700ECP/Air780EPM 当前有4种32位固件,4种64位固件,点击此处了解32位固件和64位固件的差异

3. Air780EGP 当前有3种64位固件;

4. Air700ECH/Air780EHM/Air780EHV/Air780EGH/Air780EGG/Air780EHU/Air780EHN 当前有32种固件,32位和64位各16种;

5. 关于差分升级的相关说明;

差分升级只能在同类固件之间进行,

固件1 只能差分升级为固件1,

固件2 只能差分升级为固件2,

固件X 只能差分升级为固件X。

6. Air700ECP 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)使用分析 - 合宙模组资料中心

Air700ECP/Air780EPM/Air780EGP固件支持列表
(1-99号是32位固件; 101-199号是64位固件)
核心库名称 简介 1号 2号 103号 104号 105号 106号 7号 8号
脚本区 代码空间 256KB 288KB 384KB 368KB 256KB 176KB 288KB 288KB
fs 文件系统 168KB 168KB 168KB 168KB 168KB 168KB 168KB 168KB
airlink 芯片间通信 仅支持spi从机模式 支持spi主机和从机模式 支持spi主机和从机、uart模式
airui UI图形化开发
tts 文字转语音
cc 语音通话
airtalk 对讲
camera 摄像头控制
fastlz 压缩和解压缩
fatfs FAT32文件系统
little_flash SPI Flash通用驱动
中文字库 12号中文字库
codec 音频编解码
audio 音频播放和录音
SIP功能 SIP功能
i2s 音频总线控制
ble 低功耗蓝牙
libgnss GNSS定位
sfud Nor Flash驱动
ymodem 文件传输协议
otp 一次性可编程存储
eink 墨水屏操作库
tp 触摸控制
lcd 显示屏控制
u8g2 U8G2图形处理
fft 快速傅里叶变换
hzfont 合宙矢量字库
protobuf ProtoBuff数据操作
sms 短信 (均支持移动/联通 部分支持电信)
支持电信
adc 模数转换
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内存数据操作库

Air700ECP的LuatOS固件版本下载地址

最新版本

LuatOS-SoC_V2034_Air700ECP ,请点击下载。

发布日期:2026.04.28

已知问题

  1. httpdns.ali 接口的超时参数设置无效,解析失败时不会返回错误,导致请求一直挂起,影响后续代码执行;因此 exnetif.set_priority_order 用于设置网卡优先级的接口也会受到影响,可能无法正常切换网卡。

  2. mcu.unique_id() 返回的数据长度错误,应该是8字节, 错误返回10字节

更新记录

  1. add: airlink, 8号固件添加支持airlink over uart模式,可使用airlink的uart模式通讯

  2. add: eink, 添加MODEL_2in13b_V4驱动

  3. add: lcd, lcd.init conf配置中添加lcd_clk_pin,lcd_sda_pin

  4. add: sms, 短信支持7bit编码发送

  5. update: mobile, flymode增加一个参数用来决定是否异步执行飞行模式操作

  6. update: lf, 优化little_flash_wait_busy timeout_us 和 little_flash_erase针对nand擦除大小异常

  7. update: lf, 优化little flash超时

  8. update: network,log, 设置默认网卡的日志太不明显了

  9. update: websocket,关闭接口增加判断,避免重复关闭的问题。

  10. update: airlink,uart模式调整日志输出

  11. fix: airlink, uart模式下用airlink.ready会始终返回false

  12. fix: fs, 修复并优化内存文件系统

  13. fix: protobuf,内部的realloc没有重定向到luat的函数,导致内存分配异常

  14. remove:tp, 去掉调试日志

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

二次开发demo

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

LuaTools工具教程

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

量产多路下载工具

量产多路下载工具使用教程 ,点击此处,跳转阅读;

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

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

LuatOS-SoC_V2032_Air700ECP ,请点击下载。

发布日期:2026.04.09

已知问题

  1. httpdns.ali 接口的超时参数设置无效,解析失败时不会返回错误,导致请求一直挂起,影响后续代码执行;因此 exnetif.set_priority_order 用于设置网卡优先级的接口也会受到影响,可能无法正常切换网卡。

  2. mcu.unique_id() 返回的数据长度错误,应该是8字节, 错误返回10字节

更新记录

  1. add: airlink, 8号固件增加添加支持airlink_uart模式

  2. add: tp, 支持gt927触屏

  3. add: sms, 支持发件人type bit6-bit4为101时,按照7bit解析发件人

  4. add: miniz, 新增unzip函数,支持目录解压

  5. update: network,log, TLS握手失败的日志,改成hex值输出

  6. update: network,log, 当指定网卡未就绪时,打印一下日志

  7. update: websocket,log, 调试日志关闭

  8. update: dhcp,log, 隐藏ip4_dhcp_run的周期性日志

  9. update: miniz, unzip的目标路径,强制要求必须/结尾

  10. update: miniz, unzip解压文件时,将路径分割符一律替换成/,增强zip解压兼容性

  11. update: usb,camera, usb设备插入拔出有更详细的回调

  12. update: usb,camera, 接触不稳导致传输停止时可以手动快速恢复

  13. fix: mcu, 修复unique_id错误返回10字节的问题

  14. fix: websocket, 请求的headers改成一次性发出,改善对非标服务器的兼容性

  15. fix: sms, 短信toa处理异常,完善toa类型判断

  16. fix: can, 修复can接收数据异常的问题

  17. fix: i2c, i2c从机默认地址是0x55,改成0

  18. fix: vfs,mem, 修正/ram/的lsdir无法正常工作的问题

LuatOS-SoC_V2028_Air700ECP ,请点击下载。

发布日期:2026.03.11

已知问题

  1. httpdns.ali 接口的超时参数设置无效,解析失败时不会返回错误,导致请求一直挂起,影响后续代码执行;因此 exnetif.set_priority_order 用于设置网卡优先级的接口也会受到影响,可能无法正常切换网卡。
  2. mcu.unique_id() 返回的数据长度错误,应该是8字节, 错误返回10字节

更新记录

  1. add: 新增8号固件,功能上在7号固件的基础上移除u8g2核心库,增加了websocket、fastlz两个核心库

  2. change: 因部分功能需求调整,内存紧张,因此调整以下固件功能

  3. 2/103/104号固件,关闭airlink功能

  4. 1号固件, airlink保留支持airlink spi slave从模式,不支持airlink spi master主模式

  5. change: netdrv,ch390,隐藏"lwip待发送到硬件层 xx "的底层日志

  6. change: lf,大数组循环擦写添加busy等待,极大程度提升稳定性

  7. fix: audio,修复没有寄存器的芯片设置音量时出现死机的问题

  8. fix: audio,解决播放结束的爆破音

  9. fix: http,请求失败后超时时间失效,不会触发失败回调

  10. fix: http,防御重复close和free

LuatOS-SoC_V2026_Air700ECP ,请点击下载。

发布日期:2026.02.28

  1. add: codec, codec.create支持设置channels以及sample_rate参数
  2. add: netdrv, ready函数支持获取netdrv整体状态
  3. add: httpsrv, 真实处理请求的headers,返回到lua层
  4. add: icmp, 添加ttl回调参数
  5. add: tp, tp.init接口添加direction参数配置
  6. add: tp, tp.init接口添加swap_xy参数配置
  7. change: icmp, 优化日志打印,把具体是哪个网络报错,展示出来
  8. change: http, 重写逻辑,在tcp关闭时,才上报http结果,解决多次上报的问题
  9. change: http, 调整event日志,并防御http_ctrl->netc为NULL的场景
  10. change: http, 隐藏idp日志
  11. change: http,fota, 在fota下载的时候加些打印,打印出长度
  12. change: net_lwip2, 默认填充的dns服务器,应该放在2/3位置,然后客户使用0和1, 在lua脚本的角度是1和2
  13. change: airlink, fota和uart指令应该立即执行
  14. change: can, 优化can接收中断处理,和uart一样不再每次接收中断都给luatos发送消息了
  15. fix: http, fota收到状态码不是200的时候,不应该直接上报报错,依然要等服务器断开链接
  16. fix: iperf, 有概率启动失败,原因是ctx是临时变量,tcpip_callback之后可能已经释放了
  17. fix: netdrv,napt, 对icmp的改写,当ETH->ETH,数据包依然再次给了lwip,那是不对的
  18. fix: netdrv,ch390, 修改中断为下降沿触发
  19. fix: audio, audio.config里的dacDelay单位正确应该是100ms
  20. fix: ftp, 修复ftp上传大小异常时候却返回为true的问题
  21. fix: pack, zbuff.pack对c的边界值处理,在部分bsp上有问题, 需要明确声明
  22. fix: mobile, mobile.flymode 返回值反了
  23. fix: mobile, sim卡pin解锁成功后,读不到卡
  24. fix: audio, record功能,在32bit数据情况下录音长度,时间计算不对

LuatOS-SoC_V2026_Air700ECH ,请点击下载。

发布日期:2026.02.28

  1. add: airui, 添加键盘背景颜色配置和子方法设置支持
  2. add: airui, 添加容器组件边框颜色和宽度设置功能
  3. add: airui, 增加label支持颜色和不同字号的设置
  4. add: airui, bar组件支持进度条文字打印
  5. add: airui, 支持同一个键盘绑定多个输入框
  6. add: airui, Container组件的支持可选透明度,可使用颜色设置接口设置
  7. add: airui, 支持通过设置组件parent为窗口win来添加内容
  8. add: airui, 键盘模式设置时添加日志打印记录以便于观察是否设置正确
  9. add: airui, 添加lv_font_misans_16字体支持,字符范围为gb2312
  10. add: airui, 添加Chart组件实现
  11. add: airui, 增加airui.debug接口,用于调试airui性能
  12. add: airui, 增加获取AIRUI库版本号的接口
  13. add: codec, codec.create支持设置channels以及sample_rate参数
  14. add: netdrv, ready函数支持获取netdrv整体状态
  15. add: httpsrv, 真实处理请求的headers,返回到lua层
  16. add: icmp, 添加ttl回调参数
  17. add: tp, tp.init接口添加direction参数配置
  18. add: tp, tp.init接口添加swap_xy参数配置
  19. change: luatos,780ehm,114号固件移除eink库
  20. change: airui, 调整自动刷新周期至33ms,也就是每秒30帧
  21. change: airui, img图片组件拦截jpg图片设置透明度和大小缩放
  22. change: airui, 更改airui常量,去掉AIRUI_开头部分,减少重复
  23. change: airui, 更改airui刷新方式为定时刷新
  24. change: airui, 更新14和20号misans字符范围为gb2312,同时支持备用lvgl默认字体
  25. change: airui, 添加多个组件元类型定义,支持组件回调时使用self自引用
  26. change: airui, 修改luatos真机按键LVGL键值和sdl模拟器一致,在模块真机上面也能使用按键功能了
  27. change: pinyin, 优化拼音表排序,常规字放前面,多音字放后面
  28. change: icmp, 优化日志打印,把具体是哪个网络报错,展示出来
  29. change: http, 重写逻辑,在tcp关闭时,才上报http结果,解决多次上报的问题
  30. change: http, 调整event日志,并防御http_ctrl->netc为NULL的场景
  31. change: http, 隐藏idp日志
  32. change: http,fota, 在fota下载的时候加些打印,打印出长度
  33. change: net_lwip2, 默认填充的dns服务器,应该放在2/3位置,然后客户使用0和1, 在lua脚本的角度是1和2.
  34. change: airlink, fota和uart指令应该立即执行
  35. fix: airui, 修复加载hzfont字体时画面卡顿问题,同时添加hzfont调试统计功能,支持字符串渲染耗时统计并输出日志
  36. fix: airui, 修复切换按键中set_state子方法调用后死机问题
  37. fix: airui, 修复label设置大小后会影响其它组件字体的问题
  38. fix: airui, 修复键盘自动隐藏失败的问题
  39. fix: airui, 修复win组件点击关闭后关闭整个win而不是标题
  40. fix: http, fota收到状态码不是200的时候,不应该直接上报报错,依然要等服务器断开链接
  41. fix: iperf, 有概率启动失败,原因是ctx是临时变量,tcpip_callback之后可能已经释放了
  42. fix: netdrv,napt, 对icmp的改写,当ETH->ETH,数据包依然再次给了lwip,那是不对的
  43. fix: netdrv,ch390, 修改中断为下降沿触发
  44. fix: pinyin, 调整pinyin表顺序,修复部分拼音无法正确找到候选字的问题
  45. fix: audio, audio.config里的dacDelay单位正确应该是100ms
  46. fix: ftp, 修复ftp上传大小异常时候却返回为true的问题
  47. fix: pack, zbuff.pack对c的边界值处理,在部分bsp上有问题, 需要明确声明
  48. fix: mobile, mobile.flymode 返回值反了
  49. fix: mobile, sim卡pin解锁成功后,读不到卡
  50. fix: audio, record功能,在32bit数据情况下录音长度,时间计算不对

LuatOS-SoC_V2024_Air700ECP ,请点击下载。

发布日期:2026.1.29

  1. add: pm,airlink,用pm.power(pm.WIFI, 0)关掉wifi电源,也将airlink暂停工作
  2. add: audio,新增audio.finish()接口,在raw play模式下,写入最后一块数据后,通知多媒体通道已经没有更多数据需要播放了
  3. add:tp,添加tp.sleep接口,已适配的tp ic:GT911
  4. update: httpsrv,增加httpsrv.debug函数,修正空连接时死机的问题
  5. update: log,优化log输出,不会出现因软复位开机打印频繁,或者USB插拔(或枚举丢失又重连)太频繁都会触发的看门狗重启。
  6. fix: gpio,修复gpio.setup上拉后会触发上升沿中断
  7. fix: http,在下载chunked编码格式的文件时,会出现异常关闭链接的情况
  8. fix: http,兼容headers中匹配"Content-Length: xxx"格式不标准,导致底层获取不到正确长度
  9. fix: http,body数据接收完整之后,没有将检测完整的状态变量同步,导致下载文件结束后认为数据没有接收完,就把文件删除了
  10. fix: http,chunked下载文件,headers没有Content-Length时 文件下载失败
  11. fix: http,判断响应没有接收完整数据以及是否处于下载模式才会关闭文件并删除
  12. fix: can,修正64bit固件取id值出错的问题

LuatOS-SoC_V2022_Air700ECP ,请点击下载。

发布日期:2026.1.16

  1. add: crypto,gcm模式增加tag的输出和输入校验
  2. add: lf,little flash添加支持型号 nand flash: MX35LF512
  3. add: pm,添加新接口"pm.keep(role_id, on_off)"用于设置休眠投票机制
  4. add: pm,pm.lastReson增加一个返回值,用于指示具体哪些pad唤醒的
  5. add: sms,支持参考序号为2byte的长短信
  6. add: sms,添加PDU短信解包"sms.unpack"函数
  7. add: sms,添加debug函数
  8. change: sms,兼容更多pdu格式,启发式检测UDH头
  9. change: json,不再转义/字符
  10. change: httpsrv,优化代码实现,防御越界和非法的URL攻击
  11. change: multimedia,优化出现pop音的问题
  12. change: airlink,优化主机等待slave的逻辑,改善开机airlink_ready的时间
  13. fix: crypto,mbedtls2.18下计算aes-128-gcm输出数据iv值不生效的问题
  14. fix: pack,pack函数对A格式字符的处理不正确
  15. fix: gpio,获取WAKEUP6和CHG_DET电平返回值不对
  16. fix: can,在休眠唤醒后无法接收到数据
  17. fix: pm,修复HIB休眠模式下lpuart低功耗串口唤醒死机问题
  18. fix: sim,修复硬件设计双卡槽的情况下无法识别到sim卡2(sim1接口)
  19. fix: sms,修正处理长短信可能溢出的问题
  20. fix: sms,修正unpack函数无法解析出7bit短信息的问题
  21. fix: http,处理chunked编码格式时概率出现body数据接收不全的问题
  22. fix: http,fs,频繁进行fs操作的同时进行http下载,在出现下载失败可能出现竞态或在不安全上下文释放资源从而触发死机
  23. fix: airlink,Air780EPM/EHM系列模块做airlink从机,Air8101做airlink主机时收不到4g的IP_READY消息事件
  24. fix: airlink,netdrv,在用LWIP_GP_GW做4g代理网卡的时候,Air8101经常网络不通

LuatOS-SoC_V2020_Air700ECP ,请点击下载。

发布日期:2025.12.31

  1. add: netdrv,ping函数,支持ipv6地址的ping(需要对应网卡支持ipv6)
  2. add: netdrv,ch390,支持关闭phy,关闭spi通信
  3. add: ws2812,gpio加入一个无中断保护的快速发送模式
  4. add: ftp,添加支持SIZE命令
  5. add: camera,添加2个配置项;可设置uvc的帧率和日志级别
  6. add: airlink,适配支持Air780EPM/Air780EHM/EGH/EHV 4g模块做从机,与Air8101 wifi模块做airlink主机进行数据通讯
  7. add: lfs2,little flash nand添加W25N01GVZEIR和W25N01GVZEIG支持
  8. add: fatfs,支持格式化成exfat格式的tf卡
  9. add: mobile,底层添加发出"SMS_READY"事件消息
  10. add: mobile,收到TIME_SYNC消息时,把当前timestamp打印出来
  11. add: rtos,version函数增加一个返回值,输出底层固件是64bit还是32bit
  12. add: rtos,补充rtos.version的api文档,支持额外返回数字固件编号的
  13. add: audio,multimedia,添加amr解码器
  14. change: luatos,启动日志加上dbversion的显示
  15. change: usb,添加透传收发和消息回调
  16. change: netdrv,napt,优化性能
  17. change: ntp,mobile,在获取基站时间和sntp时,发送NTP_UPDATE增加一个额外的参数, 0代表sntp, 1代表基站时间更新
  18. change: http,请求中应该总是发送Connection: Close头部,建立短连接,请求处理完后断开
  19. change: pwm,调整pwm.setFreq和pwm.setDuty的行为, 仅在open/setup状态下立即生效
  20. change: camera,恢复H264的P帧数量设置功能
  21. change: tp,优化gt911初始化以及通讯时序
  22. change: ftp,兼容命令端口直接下发 关闭数据端口,但是数据并未传输完的服务器
  23. change: ftp,优化ftp下载速度
  24. change: fs,memfs,调整最大文件名称到63字节
  25. fix: fs,memfs,当先seek后write,文件被截断的问题
  26. fix: fatfs,兼容wb也可以用于截断文件
  27. fix: fatfs,netdrv,修复当tf和其他外设使用同一路spi,同时工作时tf读写发cmd可能会出现c1,c2错误
  28. fix: fskv,最后一块4K flash无法擦除
  29. fix: mobile,修复sim卡切换的问题
  30. fix: gpio,进入普通休眠前配置gpio以及agpio为中断模式,唤醒后却无法正常触发中断
  31. fix: lpuart,在休眠中低功耗串口遇到异常后无法恢复
  32. fix: eink,修复eink.setup/eink.init默认刷新模式实际为局部刷新,而不是全局刷新模式
  33. fix: eink,修复eink阻塞模式 使用spidevice错误
  34. fix: eink,修复eink.init使用spidevice初始化后,dc引脚控制异常
  35. fix: lcd,修复使用外部字体文件方式之后切换回内置字体异常问题
  36. fix: http,当服务器返回提前关闭,且已经完成数据,但body长度是0时,会提示close错误,实际应该返回http常规code
  37. fix: http,请求下载文件失败或者请求错误的时候没有把fd关闭close,导致fd数量堆叠直到超过上限,会影响tf卡读写和请求下载文件
  38. fix: websocket,服务器下发PING请求,回复PONG时应该带上payload,否则服务器会认为不合法
  39. fix: websocket,sent事件从未触发
  40. fix: mqtt,连接到非法的mqtt服务器地址会死机
  41. fix: netdrv,兼容p->tot_len不等于p->len的场景
  42. fix: network,解决同一个network_ctrl连续连接和释放tcp情景下,port重复的问题
  43. fix: fota,如果中途升级失败时,http结束两次,导致资源重复释放
  44. fix: crypto,修复crc16的outReverse没有生效
  45. fix: crypto,内置的crc16定义,都应该默认不需要反转输出结果
  46. fix: crypto,修正crc7算法
  47. fix: sys,修复sys.waitMsg会导致task一直阻塞,无法退出
  48. remove: 移除modbus核心库,使用exmodbus扩展库替代

LuatOS-SoC_V2018_Air700ECP ,请点击下载。

发布日期:2025.11.8

1. add: 增加106号固件,支持电信卡短信收发,不支持libgnss、protobuf

2. add: lvgl,添加支持外部加载bin字体文件

3. add: lcd,新增lcd.getStrWidth函数以获取字符串的像素宽度

4. add: mobile,通过频点查找频段,mobile.scell增加频段信息

5. add: rtos,version函数增加可选的第二个返回值,可获取数字固件的编号

6. add: errdump,支持自定义adapter参数

7. add: log,添加开机的调试打印,会把开机原因pm.lastReson的值打印出来

8. add: sms,短信添加发送结果回调消息"SMS_SENT"

9. add: netdrv,mreport,遥测添加可指定网络适配器的参数配置,以及更改上报参数

10. fix: 修复2/103/106号的固件不支持airlink功能,已重新开启

11. fix: tp,tp触摸无反应

12. fix: lcd,drawLine若x1>x2,或者y1>y2时,会申请一个负数长度的内存块

15. fix: lcd,lvgl,解决jd9261屏幕触摸或者刷屏会出现花屏的现象

17. fix: netdrv,ch390,修复4g转wan以太网功能长时间挂测概率出现掉网问题

18. fix: httpsrv,当请求的数据长度大于mtu,出现分包时,会出现数据处理非常慢的情况

19. fix: os,修改clock实现,应返回的计数器是带小数,而不是直接返回整数

20. change: pins,自动加载json文件时,支持全小写的文件名

21. change: rtc,时间未同步前日期设置到2000/1/1 0:0:0

22. change: mobile,优化getBand接口total_num没有初始值,可能导致客户应用判断返回值出现问题

23. change: 去除一些底层调试性的打印