跳转至

LuatOS-Air 库函数手册（8910 平台）

作者：黄何　|　最后修改：2026-10-29

本手册是 LuatOS-Air（LuaTask 脚本框架）的库函数参考，面向展锐 8910（RDA8910）平台的合宙 4G 模组。共 49 个库、373 个接口。

LuatOS-Air 与现在 Cat.1 模组上跑的 LuatOS 是两套不同的框架，同名库的接口并不通用。新的 LuatOS 库函数手册见 LuatOS库函数开发手册；两套框架的差异和移植方法见 LuatOS-Air脚本移植到LuatOS版本注意事项。

一、适用范围

1.1 通用范围

层面 说明
运行框架 LuatOS-Air（LuaTask），不是 LuatOS
芯片平台 展锐 8910（RDA8910）
适用机型 Air724UG、Air722UG（V4033 系列）、Air795UG、Air720UH 等 8910 平台老模组
不适用 Air780E / Air780EP / Air780EG 及以后跑 LuatOS 的 Cat.1 模组，以及 Air8000、Air160x、Air8101 等 SoC 平台

这些库在模组里以 .lua 脚本形式随内核发布，使用前用 require "库名" 加载：

require "sys"
require "net"
require "mqtt"

同一功能在 LuatOS 上有同名库，但参数、返回值、回调机制都不一样，不能把本手册的写法直接搬到新模组。

1.2 每个库的适用范围

每页顶部都有「适用范围」表，逐项写明三件事：

  1. 运行环境 —— 固定为 LuatOS-Air + 展锐 8910 平台；
  2. 前提条件 —— 这个库依赖什么硬件、什么外设、什么网络状态，缺了会怎样；
  3. 不适用 —— 明确排除新框架模组。

下表是 49 个库的前提概览，点库名进详情页。

二、和 LuatOS 版本的差别

  • 框架不同：LuatOS-Air 是协程 + 消息驱动的老框架，入口是 require "sys" 加 sys.taskInit；LuatOS 是 sys.taskInit + sys.wait 的新调度模型，库的模块划分也重新做过。
  • GPIO 写法不同：本手册里的引脚是 8910 的 pio.P0_x、pins.setup()；LuatOS 上是 gpio.setup(pin, dir, pull)，引脚编号规则也不同。
  • 同名库不能照抄：cc、audio、socket、http、mqtt、sms、sim、net 这些名字两边都有，但参数、返回值、回调机制都不一样。

三、库索引

3.1 系统与调度（11 个）

库 说明 前提条件 接口数
sys Luat 协程调度框架，任务、定时器、消息 无，所有项目的基础 16
log 分级别日志工具 无；看日志需日志口打开 8
errDump 系统错误日志管理，可上报调试服务器 上报需联网 3
console Luat 控制台 控制台串口已配置 1
common 通用库函数、编码格式转换、时区时间转换 无 15
utils 常用工具类接口，字符串与数值处理 无 16
misc 配置管理：序列号、IMEI、底层版本、时钟、飞行模式、电池电量、PWM 模组本体；PWM 仅 2 路（GPIO_5 / GPIO_13） 16
clib 补充 luat 的 C 库接口 无 1
patch Lua 补丁，热更新脚本片段 无 1
update 远程升级（FOTA） 联网 + 固件支持 FOTA 3
nvm 参数管理，掉电保存的键值对 固件参数区可用 8

3.2 外设与多媒体（8 个）

库 说明 前提条件 接口数
pins GPIO 功能配置：输入输出、上升下降沿中断 目标 GPIO 存在且未被占用 2
led LED 闪灯模块：闪烁、等级指示、呼吸灯 GPIO 外接 LED 3
powerKey 开机键功能配置 模组有 PWRKEY 电路 1
pm 休眠管理 平台支持休眠；休眠会断网 3
uiWin UI 窗口管理 配合 LCD 与显示驱动 3
record 录音处理 麦克风 / 音频输入 + 录音驱动 8
audio 音频播放，支持文件与 TTS 音频 codec + 喇叭 + 音频驱动 10
scanCode 摄像头扫码 摄像头 + 扫码能力 1

3.3 网络通信（16 个）

库 说明 前提条件 接口数
net 网络管理、信号查询、GSM 状态、临近小区信息 SIM 卡 + 射频，已驻网 19
netLed 网络指示灯与 LTE 指示灯 GPIO 外接 LED，依赖 net 状态 2
link 数据链路激活：创建、连接、状态维护 SIM 卡 + 数据链路（PPP） 4
socket SOCKET 管理：创建、连接、收发、状态维护 link 层已就绪 7
socket4G 基于模组内置 4G 链路的 socket 封装 内置 4G 链路已激活 12
socketCh395 基于外挂 CH395 以太网芯片的 socket 封装 外挂 CH395（SPI） 14
socketESP8266 基于外挂 ESP8266 WiFi 的 socket 封装 外挂 ESP8266（UART AT） 9
http HTTP 客户端，支持 GET/POST 与下载到文件 链路已建立 1
mqtt MQTT 客户端 链路 + broker 地址与鉴权 7
ftp FTP 客户端 链路 + FTP 服务器；仅 PASV 模式 13
websocket WebSocket 客户端 链路 + WebSocket 服务端 10
ntp 网络授时 链路 + NTP 服务器可达 1
ril 虚拟串口 AT 命令交互管理 基带 AT 通道（内部库） 4
wifiRil ESP8266 WiFi 模块 AT 交互管理 外挂 ESP8266 4
wifiScan WiFi 扫描 外挂 ESP8266 1
lbsLoc 基站 / WiFi 定位查询 已驻网；仅中国区域 1

3.4 定位与 AGPS（8 个）

四套 GPS 驱动按 GPS 芯片选一套，不能混用；agps 系列是配套的星历加速服务，页面只有说明、没有对外接口（require 后自动运行）。

库 说明 适用 GPS 芯片 接口数
gps GPS 模块管理 通用 NMEA；专用功能仅 Air530 26
gps9701 GPS 模块管理 Air512G / Air551G / Air552G 27
gpsHxxt GPS 模块管理 和芯星通芯片，Air530H / Air82x 系列 26
gpsZkw GPS 模块管理 中科微芯片，Air530Z / Air82X 系列 26
agps 星历更新服务 配合 Air800 / Air530，需联网 —
agps9701 星历更新服务 配合 Air512G / Air551G / Air552G，需联网 —
agpsHxxt 星历更新服务 配合 Air530H / Air82x 系列，需联网 —
agpsZkw 星历更新服务 配合 Air530Z / Air82X 系列，需联网 —

3.5 蜂窝通信（4 个）

库 说明 前提条件 接口数
sim SIM 卡状态、ICCID、IMSI、MCC、MNC，支持双卡 SIM 卡槽 + 已插卡 9
sms 短信收发 SIM 卡 + 已驻网 + 短信业务 2
cc 通话管理：拨号、接听、DTMF、通话中放音 VoLTE / CS 通话能力 + 音频硬件 8
pb 电话簿管理 SIM 卡，且仅 SM 存储区 4

3.6 云平台（2 个）

库 说明 前提条件 接口数
aLiYun 阿里云物联网套件客户端，支持一机一密 / 一型一密 链路 + 三元组 14
aLiYunOta 阿里云物联网套件 OTA，固件签名算法仅支持 MD5 链路 + 阿里云 OTA 服务 3

四、常见问题

1. require 之后是 nil？

8910 平台的库随内核脚本区发布，内核版本太老或脚本区被裁剪时找不到对应库。确认内核版本（misc.getVersion()）与所用库匹配，Air724UG 建议 CORE_V4035 及以上。

2. 同一功能该用哪个库？

  • 联网收发：走模组自带 4G 用 socket / socket4G，外挂以太网用 socketCh395，外挂 WiFi 用 socketESP8266。
  • 定位：先按 GPS 芯片选 gps / gps9701 / gpsHxxt / gpsZkw，再配同名 agps 加速首次定位。

3. 这些接口在 Air780E 系列上能用吗？

不能。Air780E 及以后的 Cat.1 模组跑的是 LuatOS，库函数以 LuatOS库函数开发手册 为准。

搜索