Air1603 LuatOS 固件和 Demo

作者：马梦阳　|　最后修改：2026-10-29

特别说明

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号两种固件，两种都是 64 位固件，支持的核心库完全相同，区别只在分区大小、hzfont 内置字库和 TTS 数据的存放位置：

101号固件：脚本区 1024KB，文件系统 3008KB，hzfont 内置字库直接编进固件程序里，程序体积较大；
102号固件：脚本区扩大到 4096KB，文件系统缩减为 1536KB，hzfont 内置字库改为从固定 flash 地址读取，并单独留出 1MB 的 TTS 数据区，程序体积更小。

两种固件支持的核心库完全一致，选型只看两块空间怎么分：Lua 脚本多（代码 + require 进来的库文件占用大）选 102号；脚本区 1MB 够用、要把图片/音频/字库等文件放进文件系统选 101号。

102号固件从 V1028 版本开始提供，V1026 及更早版本只有 101号固件；两个编号的固件功能一致，按需要的分区大小下载其中一个即可。

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

Air1603 固件支持列表 (101号固件、102号固件均为64位固件)
核心库名称	简介	101号固件	102号固件
101号固件与102号固件有差异的部分
脚本区	代码空间（客户可用）	1024KB	4096KB
fs	文件系统（客户可用）	3008KB	1536KB
hzfont	合宙字库加载模块的内置字库	编入固件程序内	从固定flash地址读取
tts	文字转语音的独立数据区	无	1MB
101号固件与102号固件支持情况完全一致的部分
ram	运行内存（客户可用）	11.8MB	11.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服务端	✓	✓
英文点阵字库	12、16、18、20、22、24、32号英文字母及英文符号	×	×
12号中文点阵字库	12号中文点阵字库	×	×
16号中文灰度点阵字库	16号中文灰度点阵字库	×	×
中文矢量字库	12-255号 GB2312 一级和二级汉字和英文字库	✓	✓
i2c	I2C操作	✓	✓
iconv	iconv操作（非必须）	✓	✓
io	io操作(扩展)	✓	✓
iperf	吞吐量测试	✓	✓
json	json生成和解析库	✓	✓
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	触摸屏	✓	✓
uart	串口操作库	✓	✓
u8g2	u8g2	×	×
websocket	websocket客户端	✓	✓
wdt	watchdog操作库	✓	✓
wlan	局域网操作	✓	✓
xxtea	xxtea加密解密（非必须）	✓	✓
zbuff	c内存数据操作库	✓	✓