常见问题 - 2026-10-27

数据日期：2026-10-27

1. Air780EPM/Air780E模组如何注册并绑定设备到物联网平台查看数据？

解答： 结论：用合宙 WattScope 平台注册账号，再把设备挂到该账号下，就能在平台上看到设备的真实数据。说明：平台是按 IMEI 把设备归到账号的，注册只是创建账号，还要把注册手机号与设备 IMEI 一起提交给合宙后台做归属绑定；模组侧不需要改固件，只要能正常注网、能跑通 socket 或 mqtt 上报，数据就能上去。处理步骤：① 打开平台登录页完成注册；② 用 mobile.imei() 或模组丝印确认设备 IMEI；③ 提交绑定申请，等后台把设备挂到账号名下；④ 设备上电联网后在平台查看在线状态与数据曲线；⑤ 平台里看不到设备时，先确认设备是否已注网、MQTT 是否连上，再回头查绑定是否生效。参考文档：https://iot.luatos.com/ai_app/luatos/WattScope/login.html、https://docs.openluat.com/osapi/core/mqtt/

2. USB HOST和DEVICE模式是否需要刷特定固件，能否通过上层应用切换？

解答： 结论：不需要刷专用固件，脚本里调用 usb 核心库的 usb.mode() 就能在主从模式之间切换。说明：usb 库把 USB 控制器做成 DEVICE（从机）、HOST（主机）、OTG（协商）三种模式；但所有会改动 USB 配置的接口都必须在 USB 外设掉电状态下调用，USB 正在工作时调用会直接返回 false。处理步骤：① 先 pm.power(pm.USB, false) 给 USB 断电；② 调 usb.mode(0, usb.HOST) 或 usb.mode(0, usb.DEVICE)；③ 主机模式务必在上电之前用 usb.on(cb) 注册好回调，否则会漏掉第一个设备的接入事件；④ 再 pm.power(pm.USB, true) 上电；⑤ EC7xx 建议 V2032 及以后固件，更早的版本回调里拿不到 hub 地址和端口。参考文档：https://docs.openluat.com/osapi/core/usb/

3. USB主机模式是否支持U盘接入？

解答： 结论：支持，主机模式下 U 盘按大容量存储设备（MSC）枚举，用 fatfs 挂到 /udisk 之后就和 TF 卡一样，能直接读写文件。说明：usb 库只负责枚举设备和上报接入/断开事件，真正的文件系统操作交给 fatfs 库完成，所以「先挂载一次」这一步不能省。处理步骤：① 切到主机模式并上电；② 在 usb.on 回调里判断 class == usb.MSC 且 event == usb.EV_CONNECT，取出回调给出的 app_id；③ fatfs.mount(fatfs.USB, "/udisk", app_id)；④ 用 io 库读写，用完先 fatfs.unmount("/udisk") 再拔盘；⑤ 完整示例见 LuatOS 仓库 olddemo/demo/usb 目录（demo 可能滞后，接口以上面的写法为准）。参考文档：https://docs.openluat.com/osapi/core/usb/、https://docs.openluat.com/osapi/core/fatfs/

4. 固件支持TTS功能但未包含TTS资源，需要外挂SPI Flash才能正常工作，怎么处理？

解答： 尚未解答

5. Air1603/Air8603开发板与8607主板能否直接对接？

解答： 尚未解答

6. 8603是否支持人脸识别？能存多少人脸模板？是否支持人脸照片下发？拒真率和防伪率是多少？

解答： 结论：可以用 AirCAMERA_1034 双目 3D 活体摄像头做，但它不支持人脸照片下发，文档也没有给出拒真率、防伪率的具体数值。说明：AirCAMERA_1034 是 USB 双目人脸识别配件板，主打 3D 活体防伪，识别速度小于 0.35 秒，用户容量 100~240 人；人脸模板是在设备侧注册、设备侧保存的，不是把照片传到模组里比对，所以「照片下发」这条路不通。处理步骤：① 先确认主控板 USB 接口与 1034 对接正常，能枚举出摄像头；② 跑通预览与注册流程，确认单次注册、识别都正常；③ 按现场人数评估容量，超过 240 人要考虑多设备或换方案；④ 拒真率、误识率这类指标页面未公开，需要走商务或 FAE 索取。参考文档：https://docs.openluat.com/accessory/AirCAMERA_1034/

7. Air780EPM/Air780EG等开发板如何获取排针引脚映射资料（1～80排针对应信号、GND等）？

解答： 结论：合宙官方开发板的 1~80 排针映射在对应版本的硬件手册与原理图里；非官方开发板没有这份资料，只能找卖家要。说明：叫 Air780EPM 的开发板有好几个版本（V1.2、V1.3、核心板等），排针定义按版本不同，不能混用；判断版本看板子丝印，别照着别的版本接线。处理步骤：① 看丝印确认开发板版本；② 打开该型号 hardware 目录下的电路说明与使用手册，对照排针表；③ 用 pins 库把排针信号复用成 GPIO、串口或 I2C；④ 手册里查不到的信号，把丝印照片发给 FAE 或问 ai.luatos.com 确认。参考文档：https://docs.openluat.com/air780epm/product/air780epm_devboard_v1_3/hardware/、https://docs.openluat.com/osapi/core/pins/

8. Air8301的触摸屏去哪里购买？

解答： 结论：8301 的 4.3 寸触摸屏目前不单独开放购买，它是随工控板整机配套的。说明：Air8301 是 4G 大屏工控板（基于 Air8000W 主控），标准配件里本来就含一块 4.3 寸 480×272 电容触摸屏（驱动 IC ST6201、触摸 IC GT911，最多 5 点），所以官方不单卖这块屏。处理步骤：① 需要屏就按整机或开发板一起采购，配件清单里已经包含；② 已有 8301 但屏损坏，凭采购信息找商务申请配件；③ 想自己配别的屏，要先确认接口、分辨率与驱动 IC 能否匹配，再谈适配。参考文档：https://docs.openluat.com/air8301/product/

9. DC座可以输入DC12V吗？

解答： 结论：看具体是哪块板子——工控板类的 VIN 明确支持 5~12V，普通 EVB 开发板只有 5V 供电，直入 12V 会烧板。说明：以 Air8300 双网口双 485 工控板为例，VIN 接口的供电范围是 5-12V，此外还能用 3.3~4.3V 的电池接口或 Type-C 的 5V；而 EVB 类开发板本身就是按 USB 5V 设计的，没有 12V 输入通路。处理步骤：① 先翻该板子的硬件手册，确认 DC 座或 VIN 的输入范围；② 范围不明时先用 USB 5V 供电，不要冒险；③ 确认标注支持 12V 的输入口再上 12V，并注意正负极；④ 12V 长期供电要确认板上 DCDC 的散热余量。参考文档：https://docs.openluat.com/air8300/hardware/circuit/

10. Air780ER/Air780ER2/Air780ER3的数据手册或用户手册在哪里获取？

解答： 结论：Air780ER2 的资料入口是 /air780er2/product/，Air780ER 也有独立产品页；Air780ER3 目前查不到独立文档树。说明：同一系列的不同型号，文档树是分开的，产品页里有硬件手册、规格书与固件下载入口；数据手册这类 PDF 一般挂在 product 目录下的附件里，可以直接下载。处理步骤：① 打开 Air780ER2 产品页找规格书与硬件手册；② Air780ER 走 /air780er/product/；③ Air780ER3 暂时查不到，把型号和需求发给 FAE 或问 ai.luatos.com，确认资料是否已经上线；④ 只要接口参数的话，can、uart 这类核心库页面也能反推部分硬件能力。参考文档：https://docs.openluat.com/air780er2/product/、https://docs.openluat.com/air780er/product/

11. MCP在哪里配置？昨天直播说的两个MCP是哪两个？

解答： 结论：直播里说的两个 MCP 是 docs-ai（文档检索）和 code-ai（LuatOS 代码与示例检索），都是远程 MCP 服务，把 JSON 配置粘给 AI 助手就能加上。说明：docs-ai 提供 docs.openluat.com 的全量文档、文档图片识别与资料包检索，是合宙的权威知识库；code-ai 提供 module 下的 demo、turnkey 方案和扩展库源码检索，包含部分闭源 C 代码，比本地克隆的仓库更全。处理步骤：① 打开 Air8607 UI 教程的 3.4 节，复制两段 mcpServers 配置；② 在 CodeBuddy、Trae、WorkBuddy 等助手的 MCP 设置里分别添加；③ 让它检索一次验证是否生效；④ 只加一个也行，查资料用 docs-ai、查代码用 code-ai。参考文档：https://docs.openluat.com/ai/air8607-ui/

12. Air8607支持多大分辨率的屏幕？

解答： 结论：上限是 1280×800，接口必须是 RGB565；典型规格是 1024×600。说明：Air8607 板载的是 RGB 接口，只要是 RGB565 的屏都能接，超过 1280×800 或者不是 RGB 接口（比如 MIPI）就不在支持范围内；7 寸、9 寸、10.1 寸是常见的 1024×600 规格，文档里也按这三个尺寸描述。处理步骤：① 先确认屏是 RGB565 接口、分辨率不超过 1280×800；② 核对屏的驱动 IC 是否在 lcd 库已适配列表里；③ 自己适配不了，可以把屏或规格书寄给合宙协助适配；④ 具体在售屏型号与货期以官方渠道当期信息为准。参考文档：https://docs.openluat.com/air8607/product/

13. Air8607烧录程序后屏幕只亮背光，模拟运行正常，是什么原因？

解答： 结论：背光亮但不出画面，问题基本在数据通路上——先查 FPC 排线，再查屏参（驱动 IC、分辨率）与供电。说明：背光是独立的一路供电，亮了只说明背光正常；黑屏说明 RGB 数据或时序没通。最常见的是 FPC 没插到底、方向插反、锁扣没压紧，其次是固件里选的驱动 IC、分辨率和实物屏不一致。处理步骤：① 断电后重新插拔 FPC，确认金手指方向正确、锁扣压紧；② 量屏的供电与背光使能是否正常；③ 核对固件里 LCD 的驱动 IC 与分辨率参数是否与实物一致；④ 有条件换一块已知能亮的屏交叉验证，换屏能亮就说明是屏或屏参问题。参考文档：https://docs.openluat.com/air8607/hardware/circuit/、https://docs.openluat.com/osapi/core/lcd/

14. Luatools为什么没有Mac版？

解答： 结论：Luatools 官方只提供 Windows 版，明确不支持 Mac 和 Linux；原答说的「可以自己编译」是指自己搭环境去跑，不是官方有 Mac 版。说明：Luatools 文档里写得很清楚——不支持 Mac 和 Linux。它是基于 Windows 串口与图形界面的工具，在 macOS 上不能直接运行，也没有官方移植版本。处理步骤：① Mac 上装 Parallels 或 VMware，跑一个 Windows 虚拟机；② 在虚拟机设置里把 USB 设备直通给 Windows；③ 再在虚拟机里装 Luatools 做烧录、看日志；④ 需要批量烧录或产线方案，直接找 FAE 沟通工具支持。参考文档：https://docs.openluat.com/common/Luatools/

15. Air780EG2替换Air780EG，硬件是否只需变更GNSS_VCC？USB拨号是否有影响？

解答： 尚未解答

16. Air780EPM低功耗模式唤醒后偶尔出现卡注册被拒绝，是什么原因？

解答： 尚未解答

17. Air780EHM是否支持IPv6？支持哪种IPv6？

解答： 尚未解答

18. Air8000串口1输出“hitf:W(2326):get sean result: empty”是什么原因？

解答： 结论：这条不是报错，是 WiFi 扫描没扫到 AP 的提示性日志，升级到 V2054 之后可以消掉。说明：hitf:W(...) 是 WiFi 子系统日志的前缀，get sean result: empty 表示这一次扫描结果为空——可能没开 WiFi、周围没有可用 AP，或者扫描还没完成就已经取结果了。它不影响 4G 联网和业务逻辑，看到这一行不必紧张。处理步骤：① 先确认工程里是否真的用到 wlan，不用就不用管；② 升级到最新固件 V2054 复测；③ 如果同时伴随业务异常，抓完整日志（含前后几十行）一起反馈，只看这一行判断不了根因。参考文档：https://docs.openluat.com/air8000/luatos/firmware/、https://docs.openluat.com/osapi/core/wlan/

19. Air780EPM NTP时间同步成功后返回错误秒数，毫秒数正确，如何解决？

解答： 结论：先升级到 V2054 复测，这类秒级时间异常在跨版本里已经修过。说明：从 2036 到 2054 中间隔了很多个版本，时间基准、时区与换算逻辑都改过；秒数错而毫秒数对，说明毫秒链路是通的，问题出在秒字段的基准处理上，不是网络丢包。处理步骤：① 升级 V2054 后重新对时；② 观察返回值里秒与毫秒两个字段是否同时正确；③ 仍然复现的话，把 socket.ntpTime 的原始返回值、模组 RTC 当前时间、NTP 服务器地址一起记录反馈；④ 临时规避可以在应用层拿服务器返回的秒值自己再换算一次。参考文档：https://docs.openluat.com/air780epm/luatos/firmware/780epm_version/、https://docs.openluat.com/osapi/core/socket/

20. Air780EPM模块无法读取ICCID返回nil，是什么原因？

解答： 尚未解答

21. Air820UG模块电脑识别不到USB，无法烧录和查看日志，如何恢复？

解答： 结论：把 USB_BOOT 上拉到 1.8V 再上电，等电脑枚举出端口后用 Luatools 完整擦除重烧，基本都能救回来。说明：820UG 是 EC618 平台，USB_BOOT 属于 1.8V 电平域，不能直接拉 3.3V；另外「识别不到 USB」有很大比例其实是驱动没装，或者线材只有充电功能、没有数据线芯。处理步骤：① 先装合宙 USB 驱动，换一根确认能传数据的线；② 断电，把 USB_BOOT 上拉到 1.8V；③ 保持上拉再上电，等电脑枚举出下载口；④ 用 Luatools 做完整擦除并重烧固件；⑤ 烧录成功后把 USB_BOOT 恢复原状，重新上电验证。参考文档：https://docs.openluat.com/common/Luatools/

22. Air8300的隔离485串口发送收不到数据，非隔离485正常，是什么原因？

解答： 结论：隔离 485 和非隔离 485 走的是不同串口、不同使能脚，先把供电脚和使能脚对清楚，再查拨码与接线。说明：非隔离 485 用串口 3，27 脚复用成 GPIO36 做收发使能，GPIO29 是 485 的供电脚，开机必须拉高；隔离 485 用串口 1，28 脚复用成 GPIO37 做收发使能，隔离侧还有 SEL 拨码用来选总线侧 3.3V 或 5V。处理步骤：① gpio.setup(29, 1, gpio.PULLUP) 先把 485 供电打开；② 隔离口按 uart1 + GPIO37 使能配置，非隔离口按 uart3 + GPIO36；③ 检查 SEL 拨码位置与对端设备电平是否一致；④ 确认 A 接 A、B 接 B，收不到就交换 A/B 再试；⑤ 仍不通用示波器看使能脚翻转和总线波形。参考文档：https://docs.openluat.com/air8300/hardware/circuit/

23. Air8101+Air_camera_1034画面预览不出画面、分辨率无法调整、解码失败，是否有demo？

解答： 尚未解答

24. Air780E/Air780EPM等模组的MQTT服务器有推荐吗？

解答： 结论：临时测试可以直接用合宙的 airtest.openluat.com，商用必须自己部署或买云服务。说明：合宙这个服务器是免费但明确不可商用的测试服务器，host 为 airtest.openluat.com、端口 1883、SSL 端口 8883，用户名 root、密码 luat123456，走 SSL 需要装 mqttcerts.zip 里的证书。处理步骤：① 测试阶段直接用上面的参数连；② 商用选腾讯云、阿里云 IoT，或者自建 EMQX/Mosquitto；③ 换服务器时注意 clientId 唯一、keepalive 与断线重连策略；④ 选型拿不准可以问 ai.luatos.com。参考文档：https://docs.openluat.com/common/air_tools/、https://docs.openluat.com/osapi/core/mqtt/

25. Air724UG模块刷程序后十多分钟因内存空间不足重启，是什么原因？

解答： 尚未解答

26. Air780EX2T的发射功率能否调至100mW以下？当前资料为200mW。

解答： 尚未解答

27. 合宙模块是否有免费样品？

解答： 结论：合宙没有免费样品，样品在淘宝店 luat.taobao.com 购买，开发板 39.9 元。说明：合宙走电商零售，不做免费样机申请；验证阶段买核心板或开发板是最快的方式，型号和价格在淘宝店与选型页都能看到。处理步骤：① 打开 luat.taobao.com 找对应型号；② 按需选核心板（自己做底板）或开发板（快速验证）；③ 批量采购与报价走商务；④ 型号拿不准，可以先问 ai.luatos.com 或 FAE 再下单，避免买错版本。参考文档：https://luat.taobao.com、https://docs.openluat.com/SelectionGuide/SelectionGuide/

28. 模块是否支持强制升级？产品灌胶无法烧录时怎么办？

解答： 结论：合宙的 FOTA 是模组主动发起的 HTTP 请求，灌胶后接不了串口就只能靠远程升级，所以设计阶段一定要预留本地升级口。说明：升级包放在服务器上，由模组按业务逻辑主动去拉，服务端没法反向「推」给模组；如果产品灌胶封死了 USB 和 BOOT，一旦远程升级失败就没有本地恢复通道，只能返修。处理步骤：① 结构设计阶段就预留 USB 口或 BOOT/RESET 测试点；② 业务上留一条「远程触发升级」的通道，比如平台下发指令；③ 灌胶前完整跑通一次远程升级，确认能升上去；④ 现场设备建议保留可拆结构或测试焊盘。参考文档：https://docs.openluat.com/osapi/core/fota/

29. Air724UG/Air722是否还继续支持新版本LuatOS？

解答： 结论：Air722UG 现在两条线都在维护——老的 LuatOS-Air（V4033，RDA8910 系列）继续可用，新的 LuatOS-SoC 也在持续发布（最新 V1008，2026.8.11），两套固件不兼容、不能互刷；Air724UG 走的是老 LuatOS-Air 体系。说明：LuatOS-Air 与 LuatOS-SoC 是两代不同的软件栈，脚本写法与库都不一样。刷 LuatOS-SoC 需要 Luatools 3.1.1 以上；如果模组原本是 LuatOS-Air 固件，要先按 BOOT 键进刷机模式才能烧，AT 固件则可以直接烧。处理步骤：① 先确定项目用哪套软件栈，新项目建议 LuatOS-SoC；② 已量产的老项目不要动，继续用 LuatOS-Air；③ 换栈前先在样机上验证脚本与库的兼容性；④ 固件从对应型号的固件版本页下载。参考文档：https://docs.openluat.com/air722ug/luatos/firmware/version/、https://docs.openluat.com/air724ug/

30. Luatools更新后binpkg无法烧录、soc文件报内部错误，如何解决？

解答： 结论：先核对文件格式与模组是否匹配，再排查 boot 模式与工具版本；「soc 文件内部错误」多半是固件包损坏或工具与固件版本不配套。说明：binpkg 主要用于 Air780E、Air780EX 这类模组，Air780EP、Air780EPS、Air700 系列要用 .soc，Air724 用 .pac。Luatools 新版本遇到不支持的 binpkg 会直接提示改用 SOC 文件，所以格式对不上时怎么重试都不会成功。处理步骤：① 核对型号对应的固件格式；② 关掉 Luatools 重新打开，重新选一次文件；③ 确认模组已经进 boot 模式再烧；④ 重新下载一次固件包，必要时换旧版 Luatools；⑤ 还是失败就改用 SOC 整包烧录。参考文档：https://docs.openluat.com/common/Luatools/

31. 合宙云平台验证码/图形验证码刷不出来，无法登录，怎么办？

解答： 结论：先把 VPN 和代理关掉，再换浏览器无痕窗口或换网络试；平台侧的验证码问题已经反馈处理中。说明：图形验证码的图片通常来自第三方 CDN，开了 VPN 或公司代理时资源加载会失败，表现就是验证码框一片空白；浏览器缓存、插件拦截也会造成同样现象。处理步骤：① 关闭 VPN 和系统代理；② 用 Chrome 无痕窗口打开，清一次缓存；③ 换网络，比如切到手机热点再试；④ 换浏览器或换账号，确认是不是账号侧问题；⑤ 仍然不行，把截图和时间点发给 FAE。参考文档：https://docs.openluat.com

32. Air780E的开发板引脚资料怎么查？

解答： 结论：走官方文档站的对应型号产品树——Air780E 看 /air780e/product/，Air780EPM 系列看 /air780epm/product/ 下对应版本。说明：同名的开发板常有多个硬件版本（Air780EPM 下有 V1.2、V1.3、核心板等各一版），每一版都有自己的硬件手册、电路说明与引脚复用表；丝印上的版本号决定该看哪一份，别照着别的版本接线。处理步骤：① 看板子丝印确认版本；② 打开对应版本的 hardware 目录，查排针与引脚说明；③ 引脚复用写法参考 pins 库；④ 非合宙官方板子没有这份资料，向卖家索取或问 ai.luatos.com。参考文档：https://docs.openluat.com/air780e/product/、https://docs.openluat.com/osapi/core/pins/

33. Air700ECH+Air1103是否可用？是否可先用ES8311替代？

解答： 结论：Air1103 是合宙自研的语音芯片、走串口通信，和 ES8311（I2S 接口的 codec）不是同一类东西，不能直接互替；Air700ECH 上要用 Air1103，得选 13/113 号音频固件。说明：Air1103 通过 UART 与主控交互，PCM 和命令都走串口，自带离线 TTS 与识别能力；ES8311 只是音频 codec，TTS 还得靠主控侧的 audio/audio_v2 生成，再经 I2S 送出去。700ECH 的 13/113 号固件同时带 codec、i2s、audio 和 tts，两条路都能走，官方推荐 Air1103；目前 Air1103 还没开放销售。处理步骤：① 固件选 13/113 号（音频/SIP 专用）；② 要做离线 TTS 优先 Air1103；③ 已有 ES8311 方案就按 i2s + codec 配置；④ 采购节奏与替代方案问商务或 FAE。参考文档：https://docs.openluat.com/air700ech/luatos/firmware/700ech_version/、https://docs.openluat.com/air8784/product/air1103/

34. Air780EPM和Air780EGH/780EHM等模组如何选型？

解答： 结论：先定「要不要音频和通话」——780EPM 是低功耗通用联网型，固件里没有 audio 这一组；要 TTS、录音或 SIP 通话就选 EHM/EHV/EGH。说明：从固件差异表看，780EPM 的 audio（音频播放和录音）、tts、codec、i2s 几行都是空的，说明这几组核心库不在 EPM 固件里；EHM、EHV、EGH 系列带 audio、audio_v2、codec、i2s，通话类业务也集中在这一档。除音频外还要看要不要带屏、要不要摄像头。处理步骤：① 列需求：是否要音频、是否要通话、是否带屏、功耗与成本要求；② 打开选型页按这几项筛；③ 拿不准把需求描述丢给 ai.luatos.com，它的对比比人工更细；④ 最终型号与价格以商务报价为准。参考文档：https://docs.openluat.com/air780epm/luatos/firmware/780epm_version/、https://docs.openluat.com/SelectionGuide/SelectionGuide/

35. 合宙模组是否保障供货周期？

解答： 尚未解答