Air1602 LuatOS 固件和 Demo
作者：陈媛媛 | 最后修改：2026-06-11
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 |
| fs | 文件系统（客户可用） | 3008KB |
| ram | 运行内存（客户可用） | 11.8MB / 27.8MB |
| adc | 模数转换 | √ |
| airlink | 设备间通讯协议 | √ |
| airUI | airui 人机交互处理界面 | √ |
| audio | 音频多媒体核心库 | √ (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内存数据操作库 | √ |
一、最新版本固件
LuatOS-SoC_V1020_Air1602_101.soc 正式版
-
add: lcd,png, 支持png软解
-
update: pm, 恢复核电压调整
-
update: 更新图片解码驱动
-
fix: app_engine, 修复引擎板app的项目中各类死机问题，优化稳定性
-
fix: spi, 修复spi2用GPIO4做片选会死机的问题
-
通过luatools资源下载界面即可下载
历史版本
LuatOS-SoC_V1018_Air1602_101.soc
-
add: 支持png软硬件解码功能
-
add: airlink, 支持airlink的ping功能和fota功能
-
add: airui, 添加checkbox组件
-
add: airui, table组件添加行单元格合并支持
-
fix: usb, 解决uvc jpg数据长度检查没起作用
-
fix: luatos, 解决部分死机问题
-
update: uart, 去除uart里的部分打印
-
update: lcd, 软件绘图改成了DMA2D绘图，fb改为了静态，使用了8字节对齐，提升性能
通过luatools资源下载界面即可下载
以下为备用地址: https://cdn18.air32.cn:19443/files/Air1601/LuatOS_Air1601/
LuatOS-SoC_V1016_Air1602_101.soc
-
add: nes, 添加支持nes模拟器
-
add: airui, 支持获取win窗口标题和table单元的text信息
-
add: airui, 添加table跳转功能
-
add: airui, 键盘订阅添加回退键常量
-
update: airui, 优化video组件为双缓冲减少copy复制时间
-
update: airui, 支持多点触控，当前支持2点进行组件控制，最多订阅5点触控位置
-
update: videoplayer, 优化内存拷贝；打开debug时打印当前每秒各个计算的耗时
-
fix: airui, 重新创建键盘前先移除 IME 删除回调并清空 session/coordinator 悬挂指针
-
fix: airui, 修复旧 keyboard 销毁后，仍有外部事件回调保留着 user_data=keyboard 的旧指针的问题
-
fix: airui, 修复键盘中文选字框失效问题；修复部分键盘销毁逻辑
-
fix: airui, 修复共享键盘 data->target 变成悬空指针，第二次打开弹窗时在解绑旧 target 回调处踩到已释放对象问题
-
fix: airui, 修复键盘候选字面板有时消失的问题
-
fix: airui, 修复键盘在没有打开预览框时候选区选字被当成外部点击收起键盘
通过luatools资源下载界面即可下载
LuatOS-SoC_V1014_Air1602_101.soc
-
add: fft, 支持并默认开启fft库
-
add: lcd, rgb支持 pclk 配置
-
add: lcd, rgb添加自定义命令函数
-
add: mreport, 添加遥测功能
-
add: can, 添加支持can功能
-
add: crypto,添加统一的签名/验签函数,添加密钥生成函数
-
add: airui, 添加is_destroyed方法以检查组件是否被销毁
-
add: airui, 增加图片内容适配模式设置功能，支持center、contain、cover和stretch选项
-
fix: airui, 修复airui_switch_set_state 无论状态是否变化创建的时候底层都会发送 LV_EVENT_VALUE_CHANGED的问题
-
update: audio,dac, 完善dac dma输出，以支持音频播放
-
update: uart, 优化ramrun的uart接收，可以稳定支持6M
-
update: usb, uvc加入图像最小长度判断，剔除部分错误图片
-
update: lcd, rgb 去掉rst拉低控制，不然会导致屏幕一直黑屏
-
fix: uart, 修复串口第二次打开会死机
-
fix: fs, 修复写文件系统随机死机
-
fix: i2c, 修复会扫到自己的从机地址
-
fix: i2c, 从机地址默认不可以是0，会响应所有的主机
-
fix: protobuff, 修复encode会失败
-
fix: fota, 修复写入fota之后重启，读取出现对齐长度错误导致升级不成功
-
fix: fota,http, 修复在fota升级过程中因为网络断开或其他外界因素导致http提前结束触发死机
-
fix: errdump, 修复没有获取到唯一id导致上报不了iot平台
通过luatools资源下载界面即可下载
以下为备用地址:
https://cdn18.air32.cn:19443/files/Air1602/LuatOS_Air1602/
LuatOS-SoC_V1012_Air1602_101.soc 正式版
-
add: videoplayer, 支持视频播放功能及其硬解码功能
-
add: luatos,开启httpsrv和iotauth库
-
add: airui, 优化pc模拟器界面超出屏幕时自动缩放到90%屏幕处；支持拖拽自动缩放画面
-
add: airui, button增加get_text和set_disabled子方法
-
add: airui, 增加刷新消息重试超时时间以支持画面刷新重试
-
add: airui, 增加获取当前airui状态的接口"status"
-
add: airui, 增加设置图片旋转中心点的子方法
-
add: airui, 增加shape组件，当前支持直线、圆形、椭圆、矩形/圆角矩形绘制
-
update: log, log波特率提升到6M
-
update: log, 固件版本不应该出现硬件版本
-
update: pins, 补全一下pins功能
-
update: usb, cdc acm兼容sscom，但是需要sscom勾选RTS再打开
-
update: 时钟所有项目都统一用外部晶振
-
update: mcu, 唯一ID改成MAC
-
update: airui, 仅在调试模式下记录未处理消息的重试信息
-
update: airui, 所有组件的xywh位置自动向下取整
-
fix: lcd, 修复pclk采样相位错位，导致像素错位，lcd显示图片有问题的情况
-
fix: sys, timer有可能不能正确运行下一个定时器
-
fix: airui, 使用LUAT_USE_AIRUI_DISPLAY_BUFFER_SIZE_DIVISOR配置airui的缓存画面为一整个屏幕，解决组件滑动时分离问题
-
fix: airui, 组件采用共享缓存解决销毁组件被访问的问题和定位
-
fix: airui, 修复键盘预览框在键盘被销毁时没有一起被销毁
-
fix: airui, 修复键盘auto_hide失效的问题
-
fix: airui, 通过seq方案部分修复ui刷新消息丢失的问题
-
remove: airui, 彻底移除xml的支持
二、demo：LuatOS_Air1601_Air1602
三、Luatools 工具使用教程（点击此处，跳转阅读）
可以通过Luatools工具，对内核固件进行下载，步骤如下：
1.打开Luatools工具，点击左上角的 “合宙各种资源入口” 按钮，点击 “软件资源下载”（直接打开luatools工具的时候，也会自动弹出）
2.在弹出的窗口中，选择您所需要的内核固件版本，点击 “开始下载”
3.下载完成后，会有提示，点击 “OK”
4.点击 “打开本地资源目录” ，按路径找到已经下载好的内核固件，
