跳转至

Air1602 LuatOS 固件和 Demo

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

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

Air1602 有 101号、102号两种固件：101号固件拥有文件系统3008KB、脚本区1024KB的分区；102号固件拥有文件系统1536KB、脚本区4096KB的分区。

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

固件支持核心库列表说明

Air1601/Air1602 当前有 2 种固件，101号固件和102号固件，均为 64 位固件；

两种固件支持的核心库完全相同，区别只在分区大小，以及 hzfont 内置字库和 TTS 数据的存放位置：

101号固件：脚本区 1024KB，文件系统 3008KB，内置字库直接编进固件程序里，程序体积较大；

102号固件：脚本区扩大到 4096KB，文件系统缩减为 1536KB，内置字库改为从固定 flash 地址读取，程序体积更小。

固件支持列表：

Air1601/Air1602 固件支持列表
(101号固件、102号固件均为64位固件)
核心库名称 简介 101号固件 102号固件
101号固件与102号固件有差异的部分
脚本区 代码空间（客户可用） 1024KB 4096KB
fs 文件系统（客户可用） 3008KB 1536KB
hzfont 合宙字库加载模块的内置字库 编入固件程序内 从固定flash地址读取
tts 文字转语音的独立数据区 无 1MB
101号固件与102号固件均支持，且支持情况完全一致的核心库
adc 模数转换 ✓ ✓
airlink 设备间通讯协议 ✓ ✓
airUI airui 人机交互处理界面 ✓ ✓
audio 音频多媒体核心库 ✓ ✓
SIP功能 SIP功能 ✓ ✓
bit64 32位数据对64位数据的运算 ✓ ✓
camera 摄像头 ✓ ✓
can can操作库 ✓ ✓
crypto 加解密和hash函数 ✓ ✓
display 新UI库 ✓ ✓
errDump 错误上报 ✓ ✓
fastlz FastLZ压缩 ✓ ✓
fatfs SD&TF卡的接口 ✓ ✓
fft 傅里叶变换（非必须） ✓ ✓
fota 底层固件升级 ✓ ✓
fskv kv数据库,掉电不丢数据 ✓ ✓
ftp ftp 客户端 ✓ ✓
gpio GPIO操作 ✓ ✓
gmssl 国密算法(SM2/SM3/SM4) ✓ ✓
hmeta 硬件元数据 ✓ ✓
http http 客户端 ✓ ✓
httpsrv http服务端 ✓ ✓
中文矢量字库 12-255号 GB2312 一级和二级汉字和英文字库 ✓ ✓
i2c I2C操作 ✓ ✓
iconv iconv操作（非必须） ✓ ✓
io io操作(扩展) ✓ ✓
iperf 吞吐量测试 ✓ ✓
json json生成和解析库 ✓ ✓
lcd lcd驱动模块 ✓ ✓
little_flash 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 触摸屏 ✓ ✓
uart 串口操作库 ✓ ✓
websocket websocket客户端 ✓ ✓
wdt watchdog操作库 ✓ ✓
wlan 局域网操作 ✓ ✓
xxtea xxtea加密解密（非必须） ✓ ✓
zbuff c内存数据操作库 ✓ ✓

一、最新版本固件

V1028

固件：LuatOS-SoC_V1028_Air1602

Demo：LuatOS_Air1601_Air1602_Air1603_Air1604_Air1605

发布日期：2026.10.15

更新记录

1. add: display, 新增 display 核心库

2. add: mplayer, 添加mplayer多媒体播放器库，支持文件格式mp3、mp4，flac、wav、aac

3. add: vidioplayer, 支持 hzv 视频格式播放

4. add: voip, 支持 voip 核心库，支持 sip 通话

5. add: usb, 支持HID协议的USB键盘、鼠标控制

6. add: airlink, 开启控制airlink从机的gpio、uart功能

7. add: hzfont, 新增 getBitmap 接口，获取字符灰度位图

8. add: tp, 增加ft3x68驱动兼容FT5x06家族触摸屏(FT5206/FT5306/FT5406/FT5426/FT5446)

9. add: camera, stream模式下加入支持扫码和帧数据回调控制

10. add: netdrv, net_lwip2 支持设置IPv6地址与自动生成链路本地地址

11. add: netdrv, 新增 netdrv.ipv6 与 netdrv.arp 接口, setup 支持 mac 参数

12. add: airui, 新增相机旋转功能，支持0/90/180/270四种旋转角度设置

13. add: airui, 增加video组件对于mp4的支持；同时移除老的videoplayer上无音频版本的mp4支持

14. add: airui, video在mjpg模式下增加直推参数，支持将视频放到第二图层播放

15. add: airui, 增加对之前lcd库底层驱动的兼容

16. add: airui, 下拉框增加style支持、video增加视频结束回调支持

17. add: airui, video组件增加on_click回调

18. add: gpio,pins, gpio13引脚映射增加Air1601支持

19. add: usb,camera, UVC加入流控功能

20. update: mbedtls, TLS/ECDH 握手性能优化与内存池跨平台化

21. update: airui, 调整LVGL timer handler 的周期为5ms，加快处理速度

22. update: lcd,display, 优化整理airui和videoplay库中lcd和display库的调用

23. update: tp, gt9xx 无中断脚时改用定时轮询

24. update: hzfont, hzfont内置字库允许不内置到程序而是从固定flash地址读取

25. fix: videoplayer, 修复draw_frame丢失导致的死机问题

26. fix: net_lwip2, 修复tcp没有正确绑定本地端口

27. fix: netdrv, ipv6场景下dns失败

28. fix: audio_v2, 修复关闭未播放的优先级请求会死机，回调函数被提前清空了

29. fix: audio_v2, 修复当前正在播放tts任务时，不能正确的被更高优先级任务打断

30. fix: audio_v2, 修复驱动在不支持config情况下仍然调用config会死机

31. fix: audio_v2, mp3跳过id3帧多跳了12字节

32. fix: airlink, 从机UART帧间间隙按帧长自适应, 修复背靠背发帧致主机RX overrun→解析器失步

33. fix: tp, gt9xx 轮询模式清空接触数组, 避免重复上报抬起

历史版本

固件下载地址: 点我打开

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_Air1603_Air1604_Air1605

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

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

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

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

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

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

搜索