跳转至

Air1601 LuatOS 固件和 Demo

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

特别说明

Air1601 LuatOS 内存(RAM)说明；

ram总大小：16MB

用户可用ram：2MB左右Lua 内存+9.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_Air1601_101.soc 正式版

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

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

  • update: 更新图片解码驱动

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

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

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

历史版本

固件：LuatOS-SoC_V1010_Air1601.soc

脚本区代码空间：1024K

文件系统：文件系统3008KB

  1. add: 适配图片硬解码驱动

  2. add: usb, 支持usb host主机cdc_acm串口

  3. add: usb, 支持摄像头热插拔，启用和停止

  4. add: usb, uvc支持H264格式解析

  5. add: tp, 支持gt927触屏

  6. add: airui, 支持table插入行或者列; 支持跳转或者跑马灯两种自动滚动方式

  7. add: airui, 增加table组件支持样式设置; 增加或者移除一行或者一列

  8. add: airui, 增加button、dropdown、keyboard、table、tabview、win组件中字号任意大小的设置能力

  9. add: airui, 添加animimg组件

  10. add: airui, TabView组件支持获取标签页数量、添加新标签页和移除指定标签页的功能

  11. add: airui, table支持边框宽度、单元格文本对齐和垂直对齐属性设置

  12. add: airui, 支持lvgl原生旋转功能

  13. add: airui, 容器组件增加移动的接口

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

  15. add: airui, 增加video组件，当前只支持mjpg解码

  16. add: airui, 给button、image、label增加移动的子方法

  17. add: airui, 增加spinner组件

  18. update: airui, 优化内存管理

  19. update: airui, 优化textarea代码布局

  20. update: airui, 调高分配缓存为1/2屏幕，能有效提高旋转屏幕刷新效率

  21. update: airui, 调整hzfont的默认缓存数量为1024

  22. update: aiui,log, 关闭airui日志系统，减少固件大小

  23. update: adc, 优化一下adc功能

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

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

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

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

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

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

  30. update: wdt, 之前WDT中断优先级没有调整到最高导致普通中断死循环后无法触发WDT，重启后默认重启原因临时改成WDT，现在不用了

  31. fix: airui, 修复spi屏幕上出现颜色反转问题

  32. fix: airui, 修复animimg组件play播放异常的问题

  33. fix: airui, 修复airui长时间计算时会导致真机没有时间喂狗死机的问题

  34. fix: airui, 修复键盘预览框光标无法被选择的问题

  35. fix: airui, 修复hw循环解码时，硬解码器中间没有释放的问题

  36. fix: usb, 解决hub反复拔插死机问题，优化cdc acm串口打开概率失败的问题

  37. fix: lcd, 修复中断死机问题

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

固件：LuatOS-SoC_V1008_Air1601.soc

V1008固件更新说明 (2026-03-20)

  1. add: usb, 可以支持usb_hub了，并可以识别出摄像头以及相关信息。

  2. add: usb, usb host模式支持识别cdc acm虚拟串口

  3. add: airui, 支持jpg硬件解码

  4. add: airui, 添加win标题对齐方式配置支持

  5. add: airui, table组件增加行高设置功能，也支持单独设置列宽

  6. update: airui, 支持图片缓存，默认最大1MB缓存大小

  7. update: airui, jpg图片支持旋转、透明、缩放

  8. update: airui, 下拉框组件增加获取当前内容的子方法

  9. update: airui, 添加libjpeg-turbo支持用于PC模拟器的JPEG解码

  10. update: airui, 图表组件没有值时默认为空

  11. update: airui, wakeup支持配置是否唤醒后自动刷新

  12. update: airui, 键盘组件的选字候选框从5%高度提高到10%

  13. update: airui, 休眠时增加power_down_lcd参数控制是否关闭lcd电源

  14. update: airui, 更新hzfont设置字体大小的底层设计，同时增加button支持自定义字体和大小

  15. update: airui, 缓冲区大小调整为2*四分之一屏幕，减少内存占用

  16. update: airui, 将XML支持的配置移至LUAT_USE_AIRUI_XML宏下，作为可选配置

  17. update: lf, little_flash库, lf.getInfo(flash) 接口,添加擦除最小大小返回

  18. update: sfud, 同步更新 sfud.getInfo(flash) 接口,添加擦除最小大小返回

  19. update: dac, 优化adc读取

  20. fix: airui, 修复tabview回调函数参数index会始终为nil，而不是页面标签

  21. fix: airui, 修复二维码组件设置颜色和大小失效的问题

  22. fix: airui, 修复textarea组件处理text文本慢的问题

  23. fix: dac, adc切换通道后读数异常

固件：LuatOS-SoC_V1004_Air1601.soc

请使用LuaTools的资源下载器进行下载，备用下载地址：https://gitee.com/openLuat/LuatOS/releases/tag/v1004.air1601.release

V1004固件更新说明 (2026-02-28)

  1. add: i2c,收发总线添加空闲判断

  2. add: usb,usb虚拟串口ota功能

  3. add: airui, 添加键盘背景颜色配置和子方法设置支持

  4. add: airui, 添加容器组件边框颜色和宽度设置功能

  5. add: airui, 增加label支持颜色和不同字号的设置

  6. add: airui, bar组件支持进度条文字打印

  7. add: airui, 支持同一个键盘绑定多个输入框

  8. add: airui, Container组件的支持可选透明度，可使用颜色设置接口设置

  9. add: airui, 支持通过设置组件parent为窗口win来添加内容

  10. add: airui, 键盘模式设置时添加日志打印记录以便于观察是否设置正确

  11. add: airui, 添加lv_font_misans_16字体支持，字符范围为gb2312

  12. add: airui, 添加Chart组件实现

  13. add: airui, 增加airui.debug接口，用于调试airui性能

  14. add: airui, 增加获取AIRUI库版本号的接口

  15. change: usb,更新usb host驱动代码

  16. change: usb,增加class时，usb.HID_CM和usb.HID_KB互斥，只保留最后一个

  17. change: airui, 调整自动刷新周期至33ms，也就是每秒30帧

  18. change: airui, img图片组件拦截jpg图片设置透明度和大小缩放

  19. change: airui, 更改airui常量，去掉AIRUI_开头部分，减少重复

  20. change: airui, 更改airui刷新方式为定时刷新

  21. change: airui, 更新14和20号misans字符范围为gb2312，同时支持备用lvgl默认字体

  22. change: airui, 添加多个组件元类型定义，支持组件回调时使用self自引用

  23. change: airui, 修改luatos真机按键LVGL键值和sdl模拟器一致,在模块真机上面也能使用按键功能了

  24. fix: i2c,数据传输前需要确保总线是no busy的

  25. fix: pwm,arr psc计算有误，导致超过16bit

  26. fix: pwm,最大通道判断错误导致pwm3无法使用

  27. fix: airui, 修复加载hzfont字体时画面卡顿问题，同时添加hzfont调试统计功能，支持字符串渲染耗时统计并输出日志

  28. fix: airui, 修复切换按键中set_state子方法调用后死机问题

  29. fix: airui, 修复label设置大小后会影响其它组件字体的问题

  30. fix: airui, 修复键盘自动隐藏失败的问题

  31. fix: airui, 修复win组件点击关闭后关闭整个win而不是标题

固件：LuatOS-SoC_V1002_Air1601.soc

V1002固件更新说明 (2026-02-10)

  1. Air1601的初始正式版本

  2. 支持以下核心库：

(1) 合宙特有：AirUI、HZFont、Airlink

(2) 外设相关：uart/i2c/spi/adc/pwm/lcd/tp/ch390/elink/wdt/usb从机模式

(3) 网络相关：http/tcp/udp/mqtt/ftp/websocket/iperf/fota/netdrv

(4) 其他库：u8g2 英文以及中文12号字体/sd卡/nand flash/protobuf/miniz/fastlz/crypto/iconv/gmssl/rsa/json/zbuff/fskv/xxtea/.....

  1. 支持RGB565/RGB888/SPI接口LCD/支持触摸屏

  2. 脚本区大小：1MB

  3. 文件系统区大小：1MB

  4. 预期计划，后续将继续实现支持：

(1) 音频（dac）

(2) usb主机模式

(3) camera（支持100万像素拍照、扫码）

(4) 低功耗模式

请使用LuaTools的资源下载器进行下载

二、demo：LuatOS_Air1601_Air1602

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

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

1.打开Luatools工具，点击左上角的 “账户” 按钮，点击 “打开资源下载”（直接打开luatools工具的时候，也会自动弹出）

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

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

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