跳转至

Air1603 LuatOS 固件和 Demo

作者:马梦阳 | 最后修改:2026-11-16

特别说明

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

Air1603 有 101号、102号、103号三种固件,均为 64 位固件,区别只在分区大小、hzfont 内置字库与 TTS 数据的存放位置、以及 103号是否编入 lcd 核心库:

  • 101号固件(BASE):脚本区 1024KB,文件系统 3008KB,hzfont 内置字库直接编进固件程序里,程序体积较大,不含 plcui 核心库;
  • 102号固件(MORE_SCRIPT):脚本区 4096KB,文件系统 1536KB,hzfont 内置字库改为从固定 flash 地址读取,并单独留出 1MB 的 TTS 数据区,支持 plcui 核心库;
  • 103号固件(FAST_RUN):在 102号基础上把脚本区再扩大到 4608KB,同时去掉 lcd 核心库,其余与 102号完全一致。

三种固件除上表列出的差异项外,支持的核心库完全一致,选型看三块空间怎么分:Lua 脚本多(代码 + require 进来的库文件占用大)选 102号或 103号;脚本区 1MB 够用、要把图片/音频/字库等文件放进文件系统选 101号;不用 lcd 核心库、脚本又特别大就选 103号。

102号固件从 V1028 版本开始提供,V1026 及更早版本只有 101号固件;103号固件从 V1032 版本开始提供。

Air1603 与 Air1601、Air1602 使用同一套固件编号和同一套分区方案,同一版本号下这三个型号的 .soc 文件内容一致(型号由固件运行时识别),按型号目录下载即可。

Air1603 固件支持列表
(101号固件、102号固件、103号固件均为64位固件)
核心库名称 简介 101号固件 102号固件 103号固件
101号、102号、103号固件有差异的部分
脚本区 代码空间(客户可用) 1024KB 4096KB 4608KB
fs 文件系统(客户可用) 3008KB 1536KB 1536KB
hzfont 合宙字库加载模块的内置字库 编入固件程序内 从固定flash地址读取 从固定flash地址读取
tts 文字转语音的独立数据区 无 1MB 1MB
lcd lcd驱动模块 / 大图片解码 ✓ ✓ ✗
plcui plcui 工控 UI(人机界面) × ✓ ✓
101号、102号、103号固件支持情况完全一致的部分
ram 运行内存(客户可用) 11.8MB 11.8MB 11.8MB
adc 模数转换 ✓ ✓ ✓
airlink 设备间通讯协议 ✓ ✓ ✓
airUI airui 人机交互处理界面 ✓ ✓ ✓
audio 音频多媒体核心库 ✓ (audio_v2) ✓ (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服务端 ✓ ✓ ✓
英文点阵字库 12、16、18、20、22、24、32号英文字母及英文符号 × × ×
12号中文点阵字库 12号中文点阵字库 × × ×
16号中文灰度点阵字库 16号中文灰度点阵字库 × × ×
中文矢量字库 12-255号 GB2312 一级和二级汉字和英文字库 ✓ ✓ ✓
i2c I2C操作 ✓ ✓ ✓
iconv iconv操作(非必须) ✓ ✓ ✓
io io操作(扩展) ✓ ✓ ✓
iperf 吞吐量测试 ✓ ✓ ✓
json json生成和解析库 ✓ ✓ ✓
little_flash NAND flash操作 ✓ ✓ ✓
log 日志库 ✓ ✓ ✓
lora2 lora2驱动模块(支持多挂, 非必须) ✓ ✓ ✓
mcu 封装mcu一些特殊操作 ✓ ✓ ✓
miniz 简易zlib压缩 ✓ ✓ ✓
mqtt mqtt客户端 ✓ ✓ ✓
netdrv 网络设备管理 ✓ ✓ ✓
onewire 单总线驱动(如 DS18B20) ✓ ✓ ✓
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 串口操作库 ✓ ✓ ✓
u8g2 u8g2 × × ×
websocket websocket客户端 ✓ ✓ ✓
wdt watchdog操作库 ✓ ✓ ✓
wlan 局域网操作 ✓ ✓ ✓
ws2812 WS2812 幻彩灯带驱动 ✓ ✓ ✓
xxtea xxtea加密解密(非必须) ✓ ✓ ✓
zbuff c内存数据操作库 ✓ ✓ ✓

备注:用户可用 RAM 约 11.8MB(2MB 左右 Lua 内存 + 9.8MB 左右系统内存),以实际固件中 rtos.meminfo 查询结果为准。

一、最新版本固件

V1032

固件(101号):LuatOS-SoC_V1032_Air1603_101.soc

固件(102号):LuatOS-SoC_V1032_Air1603_102.soc

固件(103号):LuatOS-SoC_V1032_Air1603_103.soc

备用下载地址(版本目录,含 101号、102号、103号三个文件):

https://cdn18.luatos.com/files/Air1603/LuatOS_Air1603/LuatOS-SoC_V1032_Air1603/

Demo:LuatOS_Air1601_Air1602_Air1603_Air1604_Air1605

发布日期:2026.11.16

更新记录

1. add: luatos, 新增 103 号固件,在 102 号(AIRUI+PLCUI)基础上关闭 U8G2/LCD/EINK 显示驱动,脚本区由 4MB 增至 4.5MB,其他不变。 2. add: plcui, 102/103号固件支持plcui核心库,目前为1.0.2版本,更新以下功能: - 增加animing组件和slider滑动组件 - 键盘增加中文拼音支持 - 图片组件增加局部裁剪、旋转、透明、缩放等接口。 3. add: airlink,ble, 启用Air160x的AirLink蓝牙接口 4. add: airlink,ble, 完善AirLink蓝牙RPC及BLE对象生命周期 5. add: airui, 增加LUAT_CONF_USE_HZFONT_BUILTIN_REGULAR 这个更细的字体,并作为air1603和pc的默认字体;容器增加scrollable参数,支持容器不触发内部滚动显示 6. add: airui, chart图表增加多纵轴模式支持 7. add: image, 排查连续切页时 JPG 输出缓冲分配失败留下的诊断增强,能打印更加详细的诊断信息 8. add: onewire, onewire搜索ROM ID所需的API 9. add: pwm, pwm多步脉冲核心api框架 10. add: ws2812, 开启ws2812核心库 11. update: airui, 兼容和plcui在一个固件号中使用 12. update: airui, lvgl内存部分调整,兼容plcui 13. update: fatfs, 支持多盘同时挂载 14. update: fota, fota写flash后喂狗,防止写入时间太长导致看门狗复位。 15. update: fota, fota校验MD5前移除重复的DCache失效操作 16. update: fota, fota写入时数据长度做4字节对齐 17. update: hzfont, 增加5个支持的字符 18. update: luatos, udisk支持多盘挂载, 适配LuatOS fatfs多盘符改造 19. update: onewire, 虚拟onewire主体功能完成 20. update: onewire, onewire gpio不再内部上拉,只依靠外部上拉 21. update: pwm, pwm1关闭后,对应pad设置到GPIO模式 22. update: usb, switch BSP to USB HID Lua binding 23. update: usb, move HID Lua subscriptions into usb 24. update: usb, usb主机允许强制配置成FS模式 25. update: usb, 减少usb hid数据接收链路,加快中断运行速度 26. update: usb, usb hid部分相关函数放进psram 27. update: usb, usb host允许强制FS模式 28. update: ws2812, ws2812使用特定的gpio驱动 29. fix: crypto, AES-GCM 解密校验 tag, 去掉硬编码 AAD 30. fix: fota, fota失败时清除升级标志并复位状态 31. fix: fota, fix RAM memcpy and Flash/FOTA erase handling 32. fix: http, FOTA失败及时上报并清理升级状态 33. fix: usb, usb hub拔出后,没有解除connect状态 34. fix: mp4player, 关闭逐帧解码详细性能日志 35. fix: mp4player, 修正音频时钟同步参数计算逻辑 36. fix: netdrv, netdrv NAPT 支持 STA 回程及共享出口切换 37. fix: network, 修复重连首请求失败及HTTP和DHCP资源清理 38. fix: rtmp, 修复S0+S1+S2同段到达时握手超时 39. fix: rtmp, 修复destroy后摄像头帧拷贝泄漏

备注:103号固件相对 102号的实际差异,是去掉 lcd 核心库并把脚本区由 4096KB 扩大到 4608KB;U8G2、EINK 在 101号、102号固件里本来就没有编入,并非 103号独有关闭。

历史版本

V1030

固件(101号):LuatOS-SoC_V1030_Air1603_101.soc

固件(102号):LuatOS-SoC_V1030_Air1603_102.soc

备用下载地址(版本目录,含 101号、102号两个文件):

https://cdn18.luatos.com/files/Air1603/LuatOS_Air1603/LuatOS-SoC_V1030_Air1603/

Demo:LuatOS_Air1601_Air1602_Air1603_Air1604_Air1605

发布日期:2026.11.05

更新记录

1. add: luatos, 启用支持 netdrv 新 DNS 客户端

2. add: luatos, 启用支持 L2TPv2 客户端 (netdrv.L2TP), 实测连通运营商 LNS

3. add: usb,camera, UVC识别可以控制的CT PU功能,适配uvc的标准控制平面对接api

4. add: airui, 支持 airui HW JPEG 硬解任意尺寸并扩大图片缓存

5. add: airui, 打开map组件

6. add: airui, shape组件增加圆弧arc的支持

7. add: airui, 按键和键盘支持渐变色设置,键盘增加style设置支持

8. add: adc, 增加adc快速读取API并大幅度提升ADC clk

9. add: hzfont, 默认ttf字库增加“·”字符

10. update: nes,airlink, 关闭nes库, 开启airlink的ble库

11. update: fatfs, 优化加快读取tf卡速率

12. update: pm, 优化时钟工作状态,将平均电流从220+MA降到150-MA

13. update: usb,camera, UVC支持多个data intf,当前支持3个

14. update: pwm, 控制频率现在最大值支持到60M了

15. update: uart, 普通接收中断不再考虑是否cache接近溢出的问题,以求尽可能缩短处理时间

16. update: airui, 优化图片缓存策略,不再一次性全部丢掉缓存图,而是丢最老的,来腾空间

17. update: airlink, airlink.pause扩展到HSPI和UART

18. fix: lcd, 修复纯RGB时序面板无SPI引脚时重复调用无效引脚的问题

19. fix: pwm, 避免pwm结束的短脉冲,解决首个pwm波形不正确的问题

20. fix: i2c, 在只写的时候触发assert

21. fix: airlink, 优化airlink uart2导致模块和air1103通信时会让flash擦除超时,回调uart rx fifo中断阈值

22. fix: airlink,netdrv, NAPT 放行 STA 包,修复 4G转WiFi 切热点拿不到 IP(no offer)

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

24. fix: airlink, uart_rx_buffs 加互斥锁,修复串口读旧数据竞态

25. fix: airlink, 修复 rpc_nb_call_yield 早退路径重复 stop/delete 超时定时器导致死机

26. fix: airlink, 从机补发 RPC 能力位并修复通知队列不对称

27. fix: audio_v2, 修复 extern_source 收尾时 current_request_block 空指针解引用导致的死机

28. fix: adc, adc.read失败改为返回-1,而不是255,会有误解

29. fix: romfs, 修正目录深度与文件名长度的两处 off-by-one

30. fix: i2c, i2c.transfer 只发不收时 tx/rx 传参错位, 会向调用者的 tx 缓冲区写入接收数据

31. fix: i2c, i2c.transfer 校验 rx_len 非负并检查 __zbuff_resize 失败, 防止负数导致缩容后堆溢出

32. fix: i2c, i2c.no_block_transfer 校验 rx_len 非负并保证 zbuff 容量, 原来不扩容直接按 rx_len 写穿 zbuff

33. fix: i2s, 接收回调 memcpy 使用已钳制的 len, 否则 rx_len 大于 zbuff 时堆溢出, i2s id 越界校验, recv/on 拒绝负数 id, 事件回调防越界索引

34. fix: spi, spi_device 的 close/transfer/send/recv/no_block_transfer 改用 luaL_checkudata 校验 self

35. fix: spi, spi_device:transfer 的 send_len 不得超出 data 实际长度, 否则越界读并把堆内容发到总线

36. fix: bit64, bit64.to32 长度不是9字节时补 return, 避免读取 data[8] 越界

37. fix: bit64, bit64.show 钳制输出长度, 不依赖 snprintf_ 按 maxsize 截断返回的实现细节

38. fix: bit64, 整除遇除数为0时返回错误, 整数除零是UB, ARM上可能触发SIGFPE

39. fix: iconv, iconv_convert 的句柄范围校验恒为假, 任意 iconv_t 都能直接调用, 改为 uintptr_t 区间判断

40. fix: string.split 比较分隔符前先查边界, 靠近结尾时会读越字符串末尾

41. fix: mqtt, 心跳定时器回调内禁止重排定时器

42. fix: log, printf浮点格式化改用精确dtoa

V1028

固件(101号):LuatOS-SoC_V1028_Air1603_101.soc

固件(102号):LuatOS-SoC_V1028_Air1603_102.soc

备用下载地址(版本目录,含 101号、102号两个文件):

https://cdn18.luatos.com/files/Air1603/LuatOS_Air1603/LuatOS-SoC_V1028_Air1603/

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 轮询模式清空接触数组, 避免重复上报抬起

Air1603 自 V1028 版本起提供固件,cdn18 上目前只有 V1028 这一个版本(同一个版本目录下同时提供 101号、102号两个文件),暂时没有更早的历史版本。

二、demo:LuatOS_Air1601_Air1602_Air1603_Air1604_Air1605

三、Luatools 工具使用教程(点击此处,跳转阅读)

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

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

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

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

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

搜索