跳转至

常见问题 - 2026-09-27

数据日期：2026-09-27

1. Air780EPM双卡切换：从卡1（移动）切到卡2（联通）后无法联网，提示 status=2（未注册，搜索网络中）；反向切换同理，如何解决？

解答： 结论：status=2 表示“正在搜网中”（mobile.SEARCH），属于尚未注册上网的状态；切卡后无法联网多数是切卡时序或 SIM 未就绪导致，按官方双卡切换 demo 的流程处理即可。

说明：LuatOS 中 mobile.status() 的数值含义为 0 未注册、1 已注册、2 正在搜网中、3 注册被拒绝、4 状态未知、5 已注册且漫游，只有 1/5 这类已注册状态才算联网成功；切卡的本质是切换 SIM 卡索引后让协议栈重新读卡、重新驻网，期间状态会短暂停留在 2，需要给足时间再判定失败。

处理步骤：

  1. 先用官方 demo module/Air780EPM/demo/mobile/sim_switch_test.lua 跑通，不要自己写切卡逻辑
  2. 该 demo 提供三种模式——轮询指定 simid 切换（mobile.simid(0/1)）、轮询自适应切换（mobile.simid(2)，需 V2022 及以上固件）、WAKEUP0 按键中断切换，三选一在 main.lua 中用 sys.taskInit 启动
  3. 自行实现时注意时序：先让当前卡退出联网（例如 mobile.flymode(simid, true) 断开协议栈），等目标卡 SIM 就绪后再切卡并重新注册，不要 SIM 未就绪就发起注册
  4. 用 mobile.setAuto(10000, 30000, 5) 开启 SIM 脱离后自动恢复，避免一次失败就长期停在 status=2
  5. 用 Luatools 抓 trace 与 4gdiag 日志，确认 CPIN/CSQ/CREG 是否 READY、卡片是否欠费或信号覆盖不足。

参考文档：https://docs.openluat.com/air780epm/luatos/app/common/sim_switch/ 、https://docs.openluat.com/osapi/core/mobile/

2. AIR8000模块上电后NETLED灯微亮、无法识别串口、供电3.9V，是什么原因？

解答： 结论：Air8000 属于免安装 USB 驱动的型号，串口识别不到一般不是驱动问题，建议按“供电是否满足 → 是否正常上电开机 → 数据线与焊接”的顺序排查；NETLED 微亮多说明模组没有正常开机或供电不足。

说明：合宙 4G 模组中只有 Air724/Air795/Air720/Air722 需要单独安装 USB 驱动，780 全系列、700 全系列、8201 全系列、8000 全系列都免驱；如果模组是经板载 TTL 转 USB 芯片（如 CH343、CH347F）接入电脑，才需要安装对应芯片的串口驱动。供电判定：Air8000 的 VBAT 为 PIN7/8，电压 3.9V 在 3.3V~4.35V 范围内属正常，但供电电流要 ≥1A，建议就近并联 220uF 电解或 22uF 钽电容，且上电瞬间 VBAT 起始电压要低于 0.5V，否则可能因临界状态造成时序混乱而无法正常开机。

处理步骤：

  1. 在设备管理器确认是否出现端口
  2. 更换含数据线的 USB 线、换口或换电脑，并确认供电能力足够
  3. 断电冷启动，必要时上电前把 BOOT 与 VDD_EXT 短接进入下载模式
  4. 仍不识别时重点检查焊接，可找代工厂重新焊接；合宙模组批量出货，模组本身一般不会出问题。

参考文档：https://docs.openluat.com/common/usb_drv/ 、https://docs.openluat.com/air8000/luatos/hardware/vbat/

3. Luatools软件翻译不完整、固件列表不显示（chrome/edge都无法显现）怎么办？

解答： 结论：翻译不完整、固件列表不显示都属于 Luatools 工具侧的已知问题（官方已记录，后续版本修改），当前可先按“升级到最新版 → 清缓存/换网络 → 以官网固件页为准”临时规避。

说明：Luatools 的界面语言包和在线固件列表分别依赖工具自带资源与联网获取，翻译缺失通常随版本迭代补齐；固件列表不显示多与工具版本过旧、本地缓存损坏或网络（含代理、防火墙）访问受限有关，chrome/edge 都出现同样现象正说明问题在工具侧而不在浏览器。

处理步骤：

  1. 到官网重新下载最新版 Luatools 覆盖安装并完成更新
  2. 删除或重命名工具目录下的 config、_temp 缓存后重启
  3. 在 Luatools 中配置 HTTP/HTTPS/SOCKS5 代理，或切换网络（如手机热点）后重试
  4. 固件不显示时可直接到对应型号的“固件版本”页下载，再用 Luatools 本地烧录。

参考文档：https://docs.openluat.com/common/Luatools/ 、https://docs.openluat.com/air780epm/luatos/firmware/780epm_version/

4. Air780EGG外挂ES8311，录音完成后调用exaudio.pm(exaudio.SHUTDOWN)关闭I2S和电源，无法进入PSM模式，需要复位重启才行，怎么解决？

解答： 尚未解答

5. AIR8000开启GPS热启动后，休眠电流约700uA（demo注释写80uA），是否正常？

解答： 结论：正常，约 700uA 处于 500~1000uA 的正常量级内。

原理：Air8000A/U/N/D/DB/AB 六款内置 GNSS 与 Gsensor，GPIO24 同时是 GNSS 备电电源使能脚和 Gsensor 电源使能脚，默认固定输出高电平；热启动与保存星历依赖 GNSS 备电维持，绝大多数场景下该脚需要默认常开，因此常开功耗会增高 0.5~1mA 左右，休眠电流落在 500~1000uA 属正常。说明：官方文档给出，在低功耗模式与 PSM+ 模式下，GNSS 备电电源和 Gsensor 电源同时开启时两者功耗总和约 88uA；demo 中的 88uA 是合宙官方核心板条件下的数据，自研板以自己的硬件实测为准。

处理步骤：

  1. 确认 GPIO24 是否被脚本或硬件常开、是否同时开启了 Gsensor
  2. 若业务上确实不需要热启动，可考虑按需开关 GNSS 备电，但会牺牲热启动速度与星历保存
  3. 用功耗分析仪在整机 VBAT 端实测，排除其它外设（指示灯、LDO 漏电）的贡献
  4. 若实测明显超出 1mA 且与 GNSS 无关，再按低功耗章节逐项排查。

参考文档：https://docs.openluat.com/air8000/luatos/app/lowpower/sleep/ 、https://docs.openluat.com/air8000/luatos/hardware/gnss/

6. Air1601/Air1602与屏幕通信应该用串口1还是串口2？原理图与文档不一致。

解答： 结论：不要只看文档描述就投板，建议先买开发板或 Air8601/Air8602 实测确认，再做硬件设计。

说明：Air1601/Air1602 用户可用串口为 UART1、UART2、UART3、UART5，其中 UART4 是下载/调试专用串口，不能接任何外设；各串口需先按管脚复用表把管脚复用为对应 UART 功能后才可使用，屏幕接在哪一路 UART，要以管脚复用表定义的引脚功能为准。原理图与文档不一致，通常是版本迭代中管脚复用或屏接口定义发生变更，旧文档与最新原理图对不上。

处理步骤：

  1. 以最新《Air1601_1602 管脚复用表》和最新原理图/PCB 为准，确认屏幕接的是哪路 UART 及对应 PIN
  2. 先在开发板或 Air8601/Air8602 上用 uart.setup 与 uart.on 把屏跑通、验证收发正常
  3. 确认无误后再固化到自己的原理图
  4. 仍无法判断时，把原理图与文档截图一并反馈给合宙确认。

参考文档：https://docs.openluat.com/air1601/luatos/app/driver/uart/ 、https://docs.openluat.com/air1601/product/

7. 现在主推50PIN还是40PIN的LCD屏幕？屏幕接口座的封装/型号、PIN脚间距是什么？是否单独售卖屏幕？

解答： 结论：合宙不主推特定屏幕，可在市场上自行选择 40PIN 或 50PIN 的 LCD，选好后与合宙确认，只要能驱动合宙都可以帮忙把驱动调好。

说明：合宙已有的标准配件屏是 SPI 接口小屏（如 AirLCD_1000，3.5 寸、480×320、驱动 IC 为 ST7796），40PIN/50PIN 这类 RGB 屏由客户自选；能否驱动取决于屏的驱动 IC、分辨率与接口时序，以及所选核心板/开发板是否支持对应接口。接口座的封装、型号与 PIN 脚间距，可直接从对应开发板的原理图/PCB 资料获取，官方提供 PADS 版本（无 AD 版本）。

处理步骤：

  1. 先确定屏的接口类型（SPI/RGB 等）、分辨率、驱动 IC 与 PIN 数（40/50PIN）
  2. 从开发板原理图/PCB 中提取接口座封装与 PIN 间距，用于自己的硬件设计
  3. 把屏的规格书与接口方式发给合宙确认能否驱动
  4. 屏幕自行采购，合宙不单独售卖通用屏，标准配件屏可在官方淘宝店选购。

参考文档：https://docs.openluat.com/accessory/ 、https://docs.openluat.com/air780epm/product/shouce/

8. 模块的IO电压是否读不到？

解答： 尚未解答

9. 有采购对接吗？想咨询定制。

解答： 结论：有，可通过合宙官方渠道对接采购与定制。

说明：合宙模组、核心板、开发板与标准配件统一通过官方淘宝店购买，批量采购、方案定制与商务合作可通过 docs.openluat.com 网站底部的二维码扫码加微信对接，也可加入官方企业微信群沟通。

处理步骤：

  1. 标准品直接到官方淘宝店 https://luat.taobao.com/ 搜索型号下单
  2. 批量或定制需求，先整理好型号、数量与功能需求，再扫码加微信对接
  3. 产品资料与技术文档统一在 https://docs.openluat.com/ 查询。

参考文档：https://docs.openluat.com/ 、https://luat.taobao.com/

搜索