跳转至

Air1602 LuatOS 固件和 Demo

作者：陈媛媛　|　最后修改：2026-09-09

Air1602 LuatOS 内存(RAM)说明；

ram总大小：32MB

用户可用ram：2MB左右Lua 内存+25.8MB左右系统内存

可通过代码准确地获取可用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)使用分析 - 合宙模组资料中心

Air1601可用固件，拥有文件系统3008k，脚本区1024k的分区。

Air1601 Air1602
脚本区 代码空间（客户可用） 1024KB 1024KB
fs 文件系统（客户可用） 3008KB 3008KB
ram 运行内存（客户可用） 11.8MB / 27.8MB 11.8MB / 27.8MB
adc 模数转换 √ √
airlink 设备间通讯协议 √ √
airUI airui 人机交互处理界面 √ √
audio 音频多媒体核心库 √ (audio_v2) √ (audio_v2)
SIP功能 SIP功能 √ √
bit64 32位数据对64位数据的运算 √ √
ble 蓝牙功能（原生） × ×
camera 摄像头 √ √
can can操作库 √ √
crypto 加解密和hash函数 √ √
errDump 错误上报 √ √
fastlz FastLZ压缩 √ √
fatfs SD&TF卡的接口 √ √
fft 傅里叶变换（非必须） √ √
fota 底层固件升级 √ √
fskv kv数据库,掉电不丢数据 √ √
ftp ftp 客户端 √ √
gpio GPIO操作 √ √
gmssl 国密算法(SM2/SM3/SM4) √ √
hmeta 硬件元数据 √ √
http http 客户端 √ √
httpsrv http服务端 √ √
hzfont 合宙字库加载模块 √ √
英文点阵字库 12、16、18、20、22、24、32号英文字母及英文符号 × ×
12号中文点阵字库 12号中文点阵字库 × ×
16号中文灰度点阵字库 16号中文灰度点阵字库 × ×
中文矢量字库 12-255号 GB2312 一级和二级汉字和英文字库 √ √
i2c I2C操作 √ √
iconv iconv操作（非必须） √ √
io io操作(扩展) √ √
iotauth iot鉴权库, 用于生成各种云平台的参数 √ √
iperf 吞吐量测试 √ √
json json生成和解析库 √ √
lcd lcd驱动模块 √ √
lcd lcd解码大图片 √ √
little f NAND flash操作 √ √
log 日志库 √ √
lora2 lora2驱动模块(支持多挂, 非必须) √ √
mcu 封装mcu一些特殊操作 √ √
miniz 简易zlib压缩 √ √
mqtt mqtt客户端 √ √
netdrv 网络设备管理 √ √
os os操作 √ √
otp OTP操作库 √ √
pack 打包和解包格式串 √ √
pins 管脚复用 √ √
pm 电源管理 √ √
protobuf ProtoBuffs编解码（非必须） √ √
pwm PWM模块 √ √
rsa RSA加密解密（非必须） √ √
rtc 实时时钟 √ √
rtos RTOS底层操作库 √ √
socket 网络接口 √ √
spi spi操作库 √ √
string 字符串操作函数 √ √
sys sys库 √ √
sysplus sys库的强力补充 √ √
tp 触摸屏 √ √
tts 文字转语音 √ √
uart 串口操作库 √ √
u8g2 u8g2 × ×
websocket websocket客户端 √ √
wdt watchdog操作库 √ √
wlan 局域网操作 √ √
xxtea xxtea加密解密（非必须） √ √
zbuff c内存数据操作库 √ √

一、最新版本固件

固件下载地址: 点我打开

V1026 正式版

发布日期：2026.08.28

更新记录：

  1. add: usb, 支持作为 U 盘挂载 fatfs

  2. add: usb, 支持 ECM/RNDIS 协议

  3. add: usb, 支持 UAC 协议

  4. add: usb,camera, 支持原始图像回调

  5. add: usb, host 枚举时打印 device 的厂家、产品、序列号

  6. add: hmeta, 添加获取 muid 和 devid 的接口

  7. add: rtc, 增加 RTC 误差自校准检测

  8. add: airui, 支持 camera 摄像头组件进行缩放和裁切操作

  9. update: usb, usb camera 预览自动适配 lcd 大小

  10. update: usb, 部分命令兼容按照 linux 标准修改，适配 linux 环境

  11. update: usb, 虚拟串口本地未打开时，不响应 acm 接收数据

  12. update: airui, 图片缓存增大为 3M，避免使用全屏幕缓冲刷新出现闪烁

  13. update: airui, 修改 jpg 硬解逻辑为风险预判 + 硬解失败可软解回退

  14. update: i2c, 修改 SCL2 引脚映射，i2c 初始化顺序

  15. update: can, 修改 can2 引脚也支持复用

  16. update: flash, 增加脚本区 flash 擦写保护

  17. update: jpg 硬件解码增加线程保护

  18. update: lora2, 裁剪掉 fsk 模式

  19. update: netdrv,ch390, 增加快速读取 RX 数据路径，增加配置轮询间隔的宏 (默认 5ms)

  20. fix: timer, 静态定时器会被删除

  21. fix: airlink,spi, 修复 airlink 30M 通讯 crc16 校验失败问题

  22. fix: airui, 修复摄像头组件闪烁的问题

  23. fix: lcd, 修复 rgb 绘制图片超出范围导致死机的问题

  24. fix:lcd, 修复大图绘制越界写穿显存

  25. fix: gpio, Air1602 的 gpio13 默认映射改为 77 脚，上电默认即 GPIO13

  26. fix: fs, 文件写入到 16k 失败

  27. fix: spi, 修复 spi_fast_transfer 在没有 rx 的情况下会修改 tx 的值

  28. fix: spi,crypto, 修复 SPI 内存泄漏及 crypto 缓冲区安全问题

  29. fix: usb, bulk-only 协议传输异常的问题

  30. fix: usb, host 虚拟串口没有打开时，插入带虚拟串口功能的 usb 设备会死机

  31. fix: tls, 修正 tls 双向认证时，客户端证书无法释放的问题

  32. fix: luatos,log, 修复 print 日志打印缓冲区 offset=511 时 1 字节栈溢出

通过luatools资源下载界面即可下载

历史版本

V1024

发布日期：2026.07.07

更新记录

  1. add: audio_v2, 增加新audio_v2核心库已调试到相对稳定可公开使用的阶段

  2. add: audio,i2s, 支持录音功能，所有常见录音采样率已支持（8000,16000,24000,32000,48000,96000,11025,22050,44100）

  3. add: airlink,把mobile/rpc功能都打开

  4. add: airui, jpg软解码添加解码失败时的log，方便定位问题

  5. add: airui, 支持chart组件设置渐变色

  6. update: airlink,uart,等待事件超时改成默认500ms

  7. update: camera, 预览限制放宽，只判断宽度

  8. update: spi, 调整spi的sram分配，确保实际传输速度在48M以上

  9. update: spi, device驱动CS脚改成内部上拉,原本是bsp根据管脚自行选择pull设置

  10. update: audio, 音频库PA_GPIO控制, 也改成默认上拉

  11. update: airui, 优化内存分配提升一定性能

  12. update: airui, png软解码添加解码失败时的log方便定位问题

  13. update: airui, jpg和png缓存时进行8位内存对齐

  14. update: airui, 优化jpg和png软解码报错打印信息说明

  15. fix: audio_v2, 修复驱动播放和录音是独立工作时，录音不正常的问题

  16. fix: audio_v2, 修复录音可能会死机的问题

  17. remove: airui, 移除decoder_info里面不必要的错误打印

V1022

  • add: audio,tts, 支持TTS播放

  • add: gmssl, 新增SM2曲线点乘/点加/模n运算接口，支持GB/T 32918.3-2016密钥交换

  • add: gmssl, 添加gm3和gm4算法参数合法性拦截

  • add: socket,dtls, 添加 dtls 协议，支持PSA、CA证书验证

  • add: camera,lcd, 支持摄像头预览

  • add: airui, 深度休眠时支持tp休眠的触控芯片会进入休眠模式

  • add: airui, 支持软解png和jpg耗时打印

  • add: airui, 添加slider组件支持

  • add: airui, 输入框组件支持密码模式

  • add: airui, 输入框组件支持style设置，增加disable和文字对齐设置

  • add: usb, host支持的驱动加入对应协议简称，方便查看

  • add: http, http.request 添加"Connection"参数 支持自定义header请求头，当携带"Connection"参数时，不再指定请求头为"Connection: Close\r\n"

  • add: tp, 增加tp.wakeup(tp_device)接口，支持深度睡眠唤醒

  • update: gpio, 更新gpio的判断范围，防止使用内部占用的io

  • update: uart, 优化一下串口接收处理，大幅度减少高速传输出错的情况

  • update: airui, 更改长按逻辑从超时触发改为定时判断触发

  • fix: https,crypto,rsa, 修复因硬件随机数生成异常，导致https tls、crypto、rsa加解密和随机数相关的功能都出现了错误。

  • fix: socket,dtls, 修复dtls服务器会出现握手成功、证书验证成功，但还是会连接失败的问题

  • fix: airlink,uart, 修复airlink over uart模式下，没有pkg的统计数据

  • fix: tls, 应该在只有传递server_cert证书时，才会设置将verify_mode=2(强制验证服务器证书)，不应该只传入客户端证书也会验证server_cert

  • fix: airui, png和jpg软解码耗时打印修复

  • fix: airui, 修复滑动时会触发点击的问题

  • fix: airui, 修复tp长按保持异常问题

  • fix: adc, 修复第一次测试读取数据不准的问题

  • fix: luatos,rtos, 修复获取固件数字编号总是0

  • fix: luatos,rtos, 修复获取Air1602模块名称却返回的是Air1601

  • fix: hmeta, 修复返回的芯片名称,一直是错的

  • fix: nes, 释放错误地址导致死机

V1020

  • add: lcd,png, 支持png软解

  • update: pm, 恢复核电压调整

  • update: 更新图片解码驱动

  • fix: app_engine, 修复引擎板app的项目中各类死机问题，优化稳定性

  • fix: spi, 修复spi2用GPIO4做片选会死机的问题

  • 通过luatools资源下载界面即可下载

V1018

  1. add: 支持png软硬件解码功能

  2. add: airlink, 支持airlink的ping功能和fota功能

  3. add: airui, 添加checkbox组件

  4. add: airui, table组件添加行单元格合并支持

  5. fix: usb, 解决uvc jpg数据长度检查没起作用

  6. fix: luatos, 解决部分死机问题

  7. update: uart, 去除uart里的部分打印

  8. update: lcd, 软件绘图改成了DMA2D绘图，fb改为了静态，使用了8字节对齐，提升性能

V1016

  1. add: nes, 添加支持nes模拟器

  2. add: airui, 支持获取win窗口标题和table单元的text信息

  3. add: airui, 添加table跳转功能

  4. add: airui, 键盘订阅添加回退键常量

  5. update: airui, 优化video组件为双缓冲减少copy复制时间

  6. update: airui, 支持多点触控，当前支持2点进行组件控制，最多订阅5点触控位置

  7. update: videoplayer, 优化内存拷贝；打开debug时打印当前每秒各个计算的耗时

  8. fix: airui, 重新创建键盘前先移除 IME 删除回调并清空 session/coordinator 悬挂指针

  9. fix: airui, 修复旧 keyboard 销毁后，仍有外部事件回调保留着 user_data=keyboard 的旧指针的问题

  10. fix: airui, 修复键盘中文选字框失效问题；修复部分键盘销毁逻辑

  11. fix: airui, 修复共享键盘 data->target 变成悬空指针，第二次打开弹窗时在解绑旧 target 回调处踩到已释放对象问题

  12. fix: airui, 修复键盘候选字面板有时消失的问题

  13. fix: airui, 修复键盘在没有打开预览框时候选区选字被当成外部点击收起键盘

V1014

  1. add: fft, 支持并默认开启fft库

  2. add: lcd, rgb支持 pclk 配置

  3. add: lcd, rgb添加自定义命令函数

  4. add: mreport, 添加遥测功能

  5. add: can, 添加支持can功能

  6. add: crypto,添加统一的签名/验签函数,添加密钥生成函数

  7. add: airui, 添加is_destroyed方法以检查组件是否被销毁

  8. add: airui, 增加图片内容适配模式设置功能，支持center、contain、cover和stretch选项

  9. fix: airui, 修复airui_switch_set_state 无论状态是否变化创建的时候底层都会发送 LV_EVENT_VALUE_CHANGED的问题

  10. update: audio,dac, 完善dac dma输出，以支持音频播放

  11. update: uart, 优化ramrun的uart接收，可以稳定支持6M

  12. update: usb, uvc加入图像最小长度判断，剔除部分错误图片

  13. update: lcd, rgb 去掉rst拉低控制，不然会导致屏幕一直黑屏

  14. fix: uart, 修复串口第二次打开会死机

  15. fix: fs, 修复写文件系统随机死机

  16. fix: i2c, 修复会扫到自己的从机地址

  17. fix: i2c, 从机地址默认不可以是0，会响应所有的主机

  18. fix: protobuff, 修复encode会失败

  19. fix: fota, 修复写入fota之后重启，读取出现对齐长度错误导致升级不成功

  20. fix: fota,http, 修复在fota升级过程中因为网络断开或其他外界因素导致http提前结束触发死机

  21. fix: errdump, 修复没有获取到唯一id导致上报不了iot平台

V1012

  1. add: videoplayer, 支持视频播放功能及其硬解码功能

  2. add: luatos,开启httpsrv和iotauth库

  3. add: airui, 优化pc模拟器界面超出屏幕时自动缩放到90%屏幕处；支持拖拽自动缩放画面

  4. add: airui, button增加get_text和set_disabled子方法

  5. add: airui, 增加刷新消息重试超时时间以支持画面刷新重试

  6. add: airui, 增加获取当前airui状态的接口"status"

  7. add: airui, 增加设置图片旋转中心点的子方法

  8. add: airui, 增加shape组件，当前支持直线、圆形、椭圆、矩形/圆角矩形绘制

  9. update: log, log波特率提升到6M

  10. update: log, 固件版本不应该出现硬件版本

  11. update: pins, 补全一下pins功能

  12. update: usb, cdc acm兼容sscom，但是需要sscom勾选RTS再打开

  13. update: 时钟所有项目都统一用外部晶振

  14. update: mcu, 唯一ID改成MAC

  15. update: airui, 仅在调试模式下记录未处理消息的重试信息

  16. update: airui, 所有组件的xywh位置自动向下取整

  17. fix: lcd, 修复pclk采样相位错位，导致像素错位，lcd显示图片有问题的情况

  18. fix: sys, timer有可能不能正确运行下一个定时器

  19. fix: airui, 使用LUAT_USE_AIRUI_DISPLAY_BUFFER_SIZE_DIVISOR配置airui的缓存画面为一整个屏幕，解决组件滑动时分离问题

  20. fix: airui, 组件采用共享缓存解决销毁组件被访问的问题和定位

  21. fix: airui, 修复键盘预览框在键盘被销毁时没有一起被销毁

  22. fix: airui, 修复键盘auto_hide失效的问题

  23. fix: airui, 通过seq方案部分修复ui刷新消息丢失的问题

  24. remove: airui, 彻底移除xml的支持

二、demo：LuatOS_Air1601_Air1602

三、Luatools 工具使用教程（点击此处，跳转阅读）

可以通过Luatools工具，对内核固件进行下载，步骤如下：

1.打开Luatools工具，点击左上角的 “合宙各种资源入口” 按钮，点击 “软件资源下载”（直接打开luatools工具的时候，也会自动弹出）

2.在弹出的窗口中，选择您所需要的内核固件版本，点击 “开始下载”

3.下载完成后，会有提示，点击 “OK”

4.点击 “打开本地资源目录” ，按路径找到已经下载好的内核固件，

搜索