菜单
LuatOS 固件开发专家。用于编写/修改 LuatOS C 核心库、Lua 扩展库、模块 Demo、测试用例，理解架构层次，调试嵌入式问题。72 核心库 API + 44 扩展库 Lua 文件（其中 32 有正式文档）。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
LuatOS 在真机模组上跑测试的完整工作流——build .soc → flash → 抓启动日志 → 关键字判定 PASS/FAIL。覆盖 luatos-cli 全模组族(Air1601/1602/CCM4211、Air8000/EC7xx/Air780E、Air8101/BK7258、Air6208/XT804/Air101/103、Air8101-SF32)。用于"在 air1601 上跑 pgfs"、"刷机调试"、"真机回归测试"、"flash air8000"等场景。
LuatOS Demo 代码与文档设计规范。编写/审查 demo 代码、readme 时必须遵循：文件结构、命名规范（常量/变量/函数）、注释格式、禁止闭包和匿名函数。
LuatOS 文档助手。用于查询 LuatOS API、AT 指令、模组资料、FAQ、工具使用说明，编写/修改文档。72 核心库 API 文档 + 32 扩展库 API 文档（实际 44 个 Lua 文件）。
基于 SOC 职业分类
| name | luatos-dev |
| description | LuatOS 固件开发专家。用于编写/修改 LuatOS C 核心库、Lua 扩展库、模块 Demo、测试用例，理解架构层次，调试嵌入式问题。72 核心库 API + 44 扩展库 Lua 文件（其中 32 有正式文档）。 |
LuatOS 是合宙（openLuat）基于 Lua 5.3.5 的嵌入式 IoT 操作系统，支持 Air8000/Air8101/Air780E 系列等硬件平台。
构建系统: xmake (3.0.4+) 目标平台: ARM/RISC-V MCU + PC 模拟器 (Windows/Linux/macOS) 许可证: MIT
核心库 (Core Library) = 固件内置的 C 代码层功能。位于 components/ 和 luat/modules/。固件编译时内置，无需加载，直接调用。例如：gpio.setup()、socket.tcp()、mqtt.create()。
文档收录 72 个核心库 API（编号 1-72）。
扩展库 (Extension Library) = 对核心库接口的 Lua 二次封装。位于 script/libs/ 下的 .lua 文件。代码内需要 require 加载才能使用。例如：require("libnet")、require("exgnss")。
script/libs/ 实际有 44 个 .lua 文件，其中 32 个有正式文档收录，12 个未收录的为变体或底层驱动。
每个型号的固件封装的核心库不同 → 功能不同。核心库功能只要固件内存在就可以直接调用其接口。
┌─────────────────────────────┐
│ Layer 4: 脚本层 (script/) │ Lua 库 + 应用模板
│ corelib/ | libs/ | turnkey/│
├─────────────────────────────┤
│ Layer 3: 组件层 │ 60+ 子组件
│ components/ │ 网络/安全/GUI/多媒体/存储/IoT
├─────────────────────────────┤
│ Layer 2: 核心框架 (luat/) │ HAL + VFS + 任务调度
│ modules/ | vfs/ | include/ │
├─────────────────────────────┤
│ Layer 1: Lua 虚拟机 (lua/) │ Lua 5.3.5 优化版
└─────────────────────────────┘
↕ BSP 层 (bsp/) 平台适配
lua/) — Lua 5.3.5 优化版luat/)luat/include/ — 核心 C 头文件luat/modules/ — C 实现的 Lua 库luat/vfs/ — 虚拟文件系统components/) — 60+ 子组件| 类别 | 组件 |
|---|---|
| GUI | airui/, lvgl/, u8g2/ |
| 网络 | network/ (LwIP, MQTT, HTTP, WebSocket, CoAP) |
| 安全 | mbedtls/, crypto/, gmssl/, xxtea/ |
| 多媒体 | audio/, videoplayer/, camera/, codec/, multimedia/ |
| 存储 | fatfs/, lfs/, sfud/, flashdb/, fskv/ |
| IoT协议 | mqtt/, coap/, websocket/, rtmp/, rtsp/ |
| 硬件 | adc/, can/, i2c/, spi/, uart/, pwm/ |
| BLE | bluetooth/, nimble/ |
| 定位 | minmea/ (libgnss), lbs/ |
| 其他 | fota/, eink/, nes/, mgba/, airlink/, airtalk/ |
★=已收录文档 ☆=未收录变体/驱动
| 文件 | 文档 | 功能 |
|---|---|---|
libnet.lua | ★ | socket 同步阻塞 API |
libfota.lua | ★ | 固件空中升级 |
libfota2.lua | ★ | 固件空中升级 v2 |
exgnss.lua | ★ | GNSS 定位扩展 |
exmodbus.lua | ★ | Modbus 协议（总入口） |
exmodbus_tcp.lua | ☆ | Modbus TCP 变体 |
exmodbus_rtu_ascii.lua | ☆ | Modbus RTU/ASCII 变体 |
exaudio.lua | ★ | 音频播放扩展 |
excamera.lua | ★ | 摄像头扩展 |
exlcd.lua | ★ | LCD 显示扩展 |
exftp.lua | ☆ | FTP 客户端 |
exsip.lua | ★ | SIP/VoIP 通话 |
exsipclient.lua | ☆ | SIP 客户端 |
exsipproto.lua | ☆ | SIP 协议底层 |
excloud.lua | ★ | 云平台对接 |
exeasyui.lua | ★ | EasyUI 界面 |
exnetif.lua | ★ | 网络接口管理 |
exmux.lua | ★ | MUX 多路复用 |
exremotecam.lua | ★ | 远程摄像头 |
exremotefile.lua | ★ | 远程文件管理 |
httpplus.lua | ★ | HTTP 增强 |
httpdns.lua | ★ | HTTP DNS 解析 |
dnsproxy.lua | ★ | DNS 代理 |
dhcpsrv.lua | ★ | DHCP 服务 |
udpsrv.lua | ★ | UDP 服务 |
lbsLoc.lua | ★ | 免费版单基站定位 |
lbsLoc2.lua | ★ | 免费版单基站定位 v2 |
airlbs.lua | ★ | 收费版基站/WiFi 定位 |
extalk.lua | ★ | 对讲功能 |
extp.lua | ★ | 触摸屏 |
exvib.lua | ★ | 振动检测 |
exvib1.lua | ★ | 振动监测 |
exwin.lua | ★ | UI 窗口管理 |
exfotawifi.lua | ★ | WiFi FOTA |
exapp.lua | ☆ | 应用框架 |
exril_5101.lua | ★ | RIL 蓝牙驱动 |
exmtn.lua | ☆ | 移动网络管理 |
netLed.lua | ☆ | 网络指示灯 |
xmodem.lua | ★ | XModem 协议 |
air153C_wtd.lua | ★ | 外部看门狗 |
bf30a2.lua | ☆ | BF30A2 传感器 |
dhcam.lua | ☆ | DHCam 摄像头 |
gc0310.lua | ☆ | GC0310 传感器 |
gc032a.lua | ☆ | GC032A 传感器 |
module/ 下按硬件型号组织：
| 模块 | 说明 |
|---|---|
| Air780EPM/EHM | 4G 数传，默认型号 |
| Air780EHM/EHV/EGH | 含语音/GNSS |
| Air8000 | 多网融合 UI SoC |
| Air8101 | WiFi UI SoC |
| Air1601/Air1602 | MCU UI SoC |
| Air780EGP/EGG | 4G+GNSS |
| Air780EHN/EHU | 海外型号 |
| Air700ECH/ECP | 迷你封装 |
| Air510W/Air530W | GNSS 模块 |
| iRTU | 透传固件 |
| PC | PC 模拟器 |
adc, airlink, airui, audio, bit64, ble, camera, can, cc, codec, crypto, eink, errDump, fastlz, fatfs, fft, fota, fs, fskv, ftp, gmssl, gpio, hmeta, ht1621, http, httpsrv, hzfont, i2c, i2s, iconv, io, ioqueue, iotauth, iperf, json, lcd, libgnss, little_flash, log, lora2, mcu, miniz, mobile, mqtt, netdrv, onewire, os, otp, pack, pins, pm, protobuf, pwm, rsa, rtc, rtmp, rtos, sfud, sms, socket, spi, string, sys, tp, u8g2, uart, wdt, websocket, wlan, xxtea, ymodem, zbuff
禁止直接运行 xmake -y — 必须用批处理脚本：
| 脚本 | 用途 |
|---|---|
build_windows_32bit_msvc.bat | 日常增量编译 (推荐) |
build_windows_32bit_msvc_gui.bat | GUI 变更验证 |
位置: bsp/pc/，运行: cmd /c build_windows_32bit_msvc.bat
luat_ 前缀luat_lib_<module>.c#include "luat_base.h" 必须作为第一个 includesys.taskInit(function() ... end) 用于异步sys.run() 必须在末尾log.info/warn/error(tag, msg)local mod = {} → 函数 → return modlocal mylib = require("mylib")sys.wait()luat_ APImodules/ 加平台特定代码testcase/
├── common/scripts/ # testrunner.lua, testsuite.lua
├── unit_testcase_tools/
├── unit_testcase_driver/
├── function_testcase_network/
└── memprof/
运行: build/out/luatos-lua.exe ../../testcase/common/scripts/ ../../testcase/<feature>/<feature>_basic/scripts/
创建测试: metas.json + main.lua + <feature>_test.lua (函数名 test_ 开头)
lua_newuserdata 不会零初始化 → 必须 memsetremove_files 后 add_files 无效os.exit(0)，写在 sys.run() 之前| 文件 | 说明 |
|---|---|
AGENTS.md | 主 AI 配置 (454行) |
luat/include/luat_base.h | 核心定义 |
luat/include/luat_libs.h | 库注册表 |
script/corelib/sys.lua | 任务系统核心 |
bsp/pc/xmake.lua | 构建配置 |
bsp/pc/AGENTS.md | PC 模拟器文档 |
testcase/README.md | 测试指南 (458行) |
mcp/README.md | MCP 服务器文档 |