Air1601 LuatOS 固件和 Demo

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

特别说明

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	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内存数据操作库	√	√

一、最新版本固件

LuatOS-SoC_V1026_Air1601_101.soc 正式版

发布日期：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资源下载界面即可下载

以下为备用地址: https://cdn18.luatos.com/files/Air1601/LuatOS_Air1601/

历史版本

LuatOS-SoC_V1024_Air1601_101.soc 正式版

发布日期：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里面不必要的错误打印

LuatOS-SoC_V1022_Air1601_101.soc 正式版

• 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, 释放错误地址导致死机

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.点击 “打开本地资源目录” ，按路径找到已经下载好的内核固件，