常见问题 - 2026-08-19
数据日期：2026-08-19
1. Air8000怎么配不了网/是否支持ESP配网/是否支持蓝牙配网？
解答： Air8000 不支持 ESP-Touch（espconfig）、airkiss、smartconfig 等配网方式；当前官方仅支持蓝牙配网和 SoftAP 配网两种方式。建议将固件升级到最新版本，并参考官方配网教程开发：蓝牙配网 https://docs.openluat.com/air8000/luatos/app/wifi/ble/ ，SoftAP 配网 https://docs.openluat.com/air8000/luatos/app/wifi/ ，配网总览 https://docs.openluat.com/air8000/luatos/app/wifi/ 。
2. Air8000核心板识别不到SIM卡，插USB后芯片发烫，是什么问题？
解答： 识别不到 SIM 卡且芯片异常发烫，通常由供电不足或 SIM 卡硬件回路异常引起，排查步骤：1）先立即断电，避免长时间高温损伤芯片；2）确认供电方式：核心板通过 Type-C 供电时，USB 口和线材需具备足够供电能力（建议换原装数据线、直连电脑 USB3.0 口或使用外接电源），合宙实测 USB 供电能力不足会导致模组重启、注册网络异常；3）检查 SIM 卡是否正确安装、卡座是否接触良好、SIM 卡是否有效未损坏；4）用万用表测量 SIM_VDD，开机时正常应输出检测脉冲，若一直为低电平说明模组未检测到卡，重点检查卡座焊接与 SIM 信号线；5）检查 VBAT 供电电容是否按参考设计布局。参考 SIM 硬件说明 https://docs.openluat.com/air780epm/luatos/hardware/sim/ 。
3. Air724UG烧录固件失败后USB不显示，成砖了怎么恢复？
解答： 模组不会真正"成砖"。重新进入 USB BOOT 下载模式后烧录官方原始固件即可恢复：1）按住 BOOT 键（或用 3.3V 拉高 USB_BOOT 引脚）再给模组上电/复位，使模组进入强制下载模式；2）打开 LuaTools，确认电脑设备管理器中出现下载端口；3）在 LuaTools 中选择 Air724UG 对应的官方固件重新烧录。若 USB 仍不显示，请更换 USB 数据线、确认 USB 驱动已安装、检查 BOOT 引脚电平。参考烧录时序 https://docs.openluat.com/air780epm/luatos/hardware/boottime/ 。
4. 合宙官网/AI/文档打不开或者报502，是什么问题？
解答： 502 一般是网站服务端临时异常。请稍后重试，或检查本地网络/DNS；官方文档站也可直接访问 https://docs.openluat.com/ ，合宙 AI 助手地址为 https://ai.luatos.com/ 。若长时间无法访问，可联系官方企业微信群反馈。
5. Air780E的AT固件基站定位指令AT+CIPGSMLOC=1,1最近有变动吗？批量产品拿不到位置了。
解答： AT+CIPGSMLOC 是免费的单基站定位指令，定位结果依赖合宙 LBS 基站数据库服务，批量设备突然全部拿不到位置时，按以下方向排查：1）确认设备是否正常驻网、信号是否正常（AT+CSQ）、APN/数据连接是否正常；2）确认 SIM 卡是否欠费、是否被运营商限制；3）用单台设备交叉测试，排除账户侧定位服务授权或调用频率限制问题；4）该指令固件侧未变动时，问题多与网络环境或 LBS 服务状态有关，可稍后重试或咨询官方确认服务状态。相关文档 https://docs.openluat.com/atmozu/product/command/lbswifi/ 。
6. 780EPM和780EHM Open开发是否受10月1日固件升级通知影响？
解答： 受影响。无论是 LuatOS 脚本二次开发还是 CSDK 开发，10月1日之后新采购/新出货的模组都必须配套使用最新版本固件和最新仓库代码；已出货产品不受影响，无需处理。请及时同步 gitee 上 LuatOS 仓库的最新代码和官方发布的最新固件。
7. 10月1日之前采购/出货的模块是否需要升级固件？
解答： 不需要。10月1日之前采购或已出货的模组可继续使用原有固件正常生产和运行；只有10月1日之后新采购、新出货的模组才必须使用新固件。
8. 新固件兼容旧芯片/旧模块吗？
解答： 兼容。新固件（软件）向下兼容旧模组，可以给旧模组烧新固件；但新出货的模组硬件有调整，不能烧旧版本固件，否则可能无法正常工作。即"新软件兼容旧模块，新模块不能用旧软件"。
9. 已经出货的产品是否能远程升级到最新固件？
解答： 技术上支持通过 FOTA 远程升级，但已出货产品没有强制升级必要——10月1日固件升级要求仅针对之后新生产出货的模组，存量产品继续使用原固件即可。固件下载见 https://docs.openluat.com/air780epm/luatos/firmware/780epm_version/ 。
10. 780EPM不同固件版本能否用同一个OTA升级包？
解答： 不能。FOTA 升级包是基于"当前版本→目标版本"生成的差分包，不同底层固件版本必须分别生成、分别推送对应的 OTA 升级包，不能跨版本混用。自建服务器时需自行用官方差分工具制作差分包，参考 https://docs.openluat.com/atmozu/product/command/fota/ 。
11. Air780E从LuatOS二开改用其他型号，对标的基础款是哪个？
解答： 直接对标 Air780EPM（Cat.1 全网通、LuatOS 二次开发基础款）。若项目还需要语音通话/音频等能力，可评估 Air780EHM/EHV 等配置更高的型号，选型可参考合宙选型指南 https://docs.openluat.com/SelectionGuide/SelectionGuide/ 。
12. Air780E在港澳台地区可以使用吗？
解答： Air780E 为国内频段版本，不建议在港澳台地区使用；港澳台场景请选用 Air780EHU，其频段覆盖更全。具体频段以产品手册为准，选型参考 https://docs.openluat.com/SelectionGuide/SelectionGuide/ 。
13. Air724模块在刚果金能用吗？
解答： Air724 为国内频段模组，不适用非洲（刚果金）网络。海外场景建议选用 Air780EHU 等频段覆盖更广的型号，但下单前务必核对目标国家运营商的频段是否与模组支持频段完全匹配。频段信息以官方产品手册为准。
14. Air780EHV配物联网流量卡能直接打电话吗？
解答： 普通物联网数据卡（流量卡）不含语音业务，强行拨号会被运营商限制甚至锁卡，不能直接打电路域电话。需要语音功能时，请使用开通语音业务的卡，或采用 SIP/VoIP 公网对讲方案——语音走数据网络（4G 流量）传输，不受语音卡限制。Air780EHV 支持音频和 SIP 通话，官方提供 exsip 库和 demo。
15. SIP方案是否必须使用合宙的服务器？
解答： 不限制。SIP 为标准协议，模组侧通过 exsip 扩展库实现 SIP/VoIP 客户端，服务器端可使用任意标准 SIP 服务器（如 FreeSWITCH、Asterisk 等自建服务器）。建议先用官方 demo 和默认配置跑通通话流程，再对接自建服务器。官方 demo 见 gitee LuatOS 仓库 module/Air8201/demo/sip、module/Air8000/demo/sip 等目录，库文件为 script/libs/exsip.lua。
16. Air780EH的MAIN_RI和MAIN_DTR引脚作用是什么？
解答： 两者用于模组与外部 MCU 之间的休眠唤醒配合：MAIN_RI 为模组输出，模组在休眠状态下收到来电、短信、服务器下发数据等事件时会拉低 RI（典型拉低约120ms）通知并唤醒外部 MCU；MAIN_DTR 为模组输入，外部 MCU 通过拉低 DTR 来唤醒处于休眠状态的模组。即一个是"模组唤醒 MCU"，一个是"MCU 唤醒模组"。参考低功耗文档 https://docs.openluat.com/atmozu/product/command/lowpower/ 。
17. Mac上怎么配置LuaTools？有替代吗？
解答： LuaTools 官方仅支持 Windows 10 及以上系统，不支持 macOS/Linux（说明见 https://docs.openluat.com/common/Luatools/ ）。Mac 用户可使用官方开源命令行工具 luatos-cli 完成固件和脚本烧录，项目地址在 Gitee 搜索 openLuat/luatos-cli 即可获取。
18. VSCode的LuatOS插件不能用了是什么原因？
解答： 插件异常多为版本兼容或服务端临时问题。建议：1）将 VSCode 内 LuatOS 插件升级到最新版本；2）重启 VSCode 后重试；3）临时可使用 LuaTools（Windows）或 luatos-cli（Mac/Linux）烧录调试，不影响项目开发。若升级后仍异常，可在官方企业微信群反馈。
19. VSCode的LuatOS插件报错：reasoning_content in thinking mode must be passed back怎么办？
解答： 该报错为插件 AI 对话链路的兼容性问题。请先将 LuatOS 插件更新到最新版本后重启 VSCode 重试；烧录、下载等核心功能不受影响，期间可正常使用 LuaTools 或 luatos-cli 完成开发。若最新版仍复现，可通过官方企业微信群提交报错截图反馈。
20. luatos-cli是官方的吗？Air780EGP可以用吗？
解答： 是官方工具。luatos-cli 是合宙官方开源的命令行烧录工具，与 Gitee 上 openLuat/luatos-cli 为同一项目，支持 Air780EGP 等全系 LuatOS 模组的固件/脚本烧录，Windows/Mac/Linux 均可使用。
21. Air780EPM串口1只能接收不能发送数据是什么原因？
解答： 能接收说明串口初始化基本成功，发送失败按以下顺序排查：1）确认 uart.setup 的 TX/RX 引脚参数与实际硬件接线一致，模组 TX 必须接对端 RX，且共地；2）确认调用了 uart.write(uartid, data) 发送数据，参考 API 文档 https://docs.openluat.com/osapi/core/uart/ ；3）检查 TX 引脚是否被其他代码复用为 GPIO、LCD、Camera 等功能导致冲突；4）确认对端串口工具波特率（如115200）、电平（模组为 3.3V TTL，不可直连 RS232 电平）是否匹配；5）用 USB 转 TTL 模块直连模组 UART1 自发自收交叉验证，定位是模组侧还是对端设备问题。注意：Air8000 V2048 固件存在 uart11/uart12 无法向外发送数据的已知问题，若使用该型号请升级固件；Air780EPM 无此问题。
22. Air1602的CAN2发送数据，CAN盒监测不到，是什么原因？
解答： 该现象为旧版本固件 CAN2 引脚复用问题，已在 V1026 正式版固件中修复（更新记录第15条："update: can, 修改 can2 引脚也支持复用"）。请升级到 V1026 或更新版本固件后重新测试，升级后 CAN2 收发即可正常。固件下载与更新记录见 https://docs.openluat.com/air1601/luatos/firmware/1602_version/ 。
23. Air780EPM的LCD库固件从V2046升到V2048后不显示图片/显示异常怎么办？
解答： 该问题已确认为 V2048 底层固件的已知缺陷，临时规避方案：先回退使用 V2046 版本固件进行开发和量产验证；待官方发布修复版本后再升级。固件版本历史见 https://docs.openluat.com/air780epm/luatos/firmware/780epm_version/ ，建议关注该页面更新记录。
24. Air780EPM V2048 2号固件无法显示JPG怎么处理？
解答： 已确认为 V2048 固件底层 JPG 解码相关问题，官方已在跟进修复。当前请先使用 V2046 固件规避，或关注固件发布页面 https://docs.openluat.com/air780epm/luatos/firmware/780epm_version/ ，待修复版本发布后升级。
25. MQTT遗嘱功能怎样测试？有相关资料吗？
解答： MQTT 遗嘱（Last Will）通过 mqttc 客户端在连接时向 broker 注册遗嘱主题和内容，当客户端异常断线时 broker 自动发布遗嘱消息。测试方法：1）连接时调用遗嘱接口设置 will topic/payload/qos/retain；2）订阅该遗嘱主题；3）直接给模组断电（模拟异常掉线，不要正常 disconnect），观察订阅端是否收到遗嘱消息。接口文档见 https://docs.openluat.com/osapi/core/mqtt/ 。
26. airtalk功能如何获取PRODUCT_KEY？
解答： PRODUCT_KEY 即合宙 IoT 平台的项目 KEY。登录 https://iot.openluat.com/ ，在对应项目的项目信息中复制项目 Key，填入脚本的全局变量 PRODUCT_KEY 即可（FOTA、AirCloud、airtalk 等云功能均使用该 Key）。注意设备 IMEI 必须归属在该项目所在账号下。
27. Air780EHV+AirTalk登录失败怎么处理？
解答： 官方已定位该现象与云端数据队列写入较慢、任务阻塞有关，设备上线后批量数据入库期间可能出现登录超时，入库完成后重启设备即可恢复正常。处理建议：1）确认 PRODUCT_KEY 与 IoT 平台项目 Key 一致、设备 IMEI 已归属该账号；2）确认 SIM 卡数据网络正常、信号良好；3）入库高峰期出现登录失败时，重启设备后观察；4）如持续失败，抓取运行日志通过官方企业微信群反馈。
28. 合宙模组是否支持NTRIP协议？
解答： LuatOS 官方固件和库中目前没有内置 NTRIP 客户端（代码库中无相关实现）。NTRIP 本质是基于 HTTP/socket 传输差分数据的应用层协议，若项目确有需要，可基于 socket 库按 NTRIP 协议规范自行实现客户端，差分数据通过 GNSS 串口写入定位芯片。通用差分定位原理可参考 GNSS 教程 https://docs.openluat.com/luatos_lesson/010_luatos_GNSS1/ 。
29. Air8000W跑程序特别慢正常吗？
解答： 若运行速度明显异常，先从以下方面排查：1）确认使用的是官方最新正式版固件（固件列表见 https://docs.openluat.com/air8000/luatos/firmware/ ），旧版本可能存在性能问题；2）检查脚本中是否存在密集循环、频繁打日志、阻塞式延时等写法，避免在主任务中执行耗时操作；3）WiFi 扫描、网络连接等操作本身耗时属正常现象；4）对比官方 demo（如 blink 例程）在同一块板子上的运行速度，若 demo 也明显卡顿，升级固件后仍异常请抓日志联系官方支持。
30. Air510W关机后功耗测过么？
解答： Air510W 为 GNSS 定位模组，关机/低功耗电流以官方产品手册和低功耗文档标注数据为准。建议使用合宙 Air9000/Air9000P 功耗分析仪（上位机 https://hezhouyibiao.com/ ）实测关机、待机、定位各状态电流，实测值与供电电压、有源天线、外围电路均有关系；产品资料入口 https://docs.openluat.com/air530z/product/ （定位类产品文档）。
31. 天线RF端口上的TVS有什么推荐型号？
解答： 官方文档未指定统一的 RF 端口 TVS 型号。射频端口 ESD/浪涌防护需选用低结电容（通常要求 ≤0.5pF）、低钳位电压、工作频段覆盖模组全部频段的专用射频 ESD 器件，且靠近天线座布局，射频走线严格做 50Ω 阻抗控制。建议：1）参考对应型号硬件设计文档的天线章节 https://docs.openluat.com/air780epm/luatos/hardware/ant/ ；2）向 ESD 器件厂商（如硕凯、安森美、村田等）报频段和功率参数索取选型；3）外置天线场景保证 PCB 走线 50Ω 阻抗即可，TVS 选型不当反而会恶化驻波比。
32. 自己的板子用780EPM休眠功耗有10~30mA，是卡无效卡影响的吗？是不是要联网才能进入低功耗？
解答： 10~30mA 远高于正常休眠电流（PSM+ 模式待机可低至微安级），与是否联网无直接关系——低功耗模式不要求必须先联网，但无效卡/未驻网会导致模组持续搜网重试，协议栈无法进入睡眠，是休眠电流偏高的常见原因之一。排查步骤：1）先换一张确定有效的物联网卡对比测试；2）确认代码中已调用 pm.power(pm.WORK_MODE, 1)（或 PSM+ 模式 pm.power(pm.WORK_MODE, 2)）开启低功耗；3）进休眠前主动关闭 USB（USB 挂着会阻止休眠）；4）排查外设漏电：LCD/SPI 引脚电平、VDD_EXT 外挂负载（外部负载建议不超过50mA）、DCDC 自身静态电流与损耗、GPIO 上下拉；5）对比官方核心板 PCB 与自有 PCB 逐项排查。完整排查指南见 https://docs.openluat.com/air780epm/luatos/app/lowpower/sleep/ 。
33. Air8202C能否和Air780E适配？
解答： 没有必要。Air8202 系列本身就是基于 Air780EGP（4G）+ 定位等外设集成的通信定位一体模组，已内置 4G 通信能力，再外挂 Air780E 属于 4G 功能重复。若已有 Air780E 做主控、仅需扩展定位，直接搭配 Air510W（GNSS 定位模组）即可；选型参考 https://docs.openluat.com/SelectionGuide/SelectionGuide/ 。
34. 8201G-BLMQ套件，调试板接Type-C能否给外挂电池充电？
解答： 可以。调试板通过 Type-C 接入后可经板载充电管理电路为外接锂电池充电。注意：新出货套件均为新版 FPC 线，支持正常充电电流；若使用早期版本 FPC 线，其载流能力较差，会出现充电很慢的现象，更换新版 FPC 线即可。
35. 8201G-BLMQ开发套件推荐配什么阻抗和功率、什么接口的喇叭？
解答： 推荐选用 8Ω（8欧）2W 或 4Ω（4欧）3W 的扬声器，通过板载音频功放（PA）驱动；合宙官方测试使用 8Ω 5W 喇叭音量充足，喇叭阻抗/功率与 PA 不匹配会导致声音小。接口按开发板喇叭焊盘/座子定义直接连接即可，无需外加功放。音频相关说明可参考合宙音频配件板文档 https://docs.openluat.com/accessory/mulu/audio/ 。
36. 8201H开发板BTB引脚对应在哪里看？
解答： BTB/FPC 引脚定义以官方硬件资料为准，可查看 Air8201 硬件文档 https://docs.openluat.com/air8201/hardware/ （含管脚定义与原理图），或在合宙 AI 助手 https://ai.luatos.com/ 直接提问获取。
37. 8201H用TTS demo播放不了音频，可能是什么原因？
解答： 常见原因及处理：1）供电不足：USB 口供电能力有限，播放音频时 PA 瞬时电流较大，建议接上电池或改用供电能力更强的电源；2）IO 电平不匹配：部分外设要求 1.8V 电平，需在初始化时调用 pm.ioVol(pm.IOVOL_ALL_GPIO, 1800) 将 GPIO 高电平设置为 1.8V（该接口当前仅 Air780EXXX 系列可用，取值单位 mV）；3）确认音频功放使能脚、喇叭接线正确，参考官方 TTS/audio demo 逐一核对。
38. 8201H电池充电有指示灯吗？
解答： 开发板/模组本身没有充电状态指示灯。如需充电指示，可自行用一个 GPIO 控制 LED：通过充电管理 IC（YHM2712A，驱动库 exs_yhm2712a）查询充电状态（充电中/充电完成/故障），在代码中驱动 LED 显示。充电库文档 https://docs.openluat.com/osapi/ext/charger/exs_yhm2712a/ 。
39. 8201H用电池供电后不能关机了，有电池充放电资料吗？
解答： 关机行为与供电方式和 PWRKEY 设计有关：1）pm.shutdown() 软件关机后，必须通过 PWRKEY 按键（拉低开机键）才能重新开机，软件无法自行唤醒；若 PWRKEY 直接接地设计为上电自动开机，则软件关机后需重新插拔电池/断电再上电才能开机，这是正常机制；2）Air8201H 板载 YHM2712A 充电管理 IC，支持船运模式（exs_yhm2712a.ship_mode()）：出厂前调用可断开电池与系统连接，用户插入 USB 充电器后自动退出船运模式并开机，适合"电池预装、插电开机"场景；3）充放电参数（截止电压4.2V/4.35V、充电电流、状态查询）见充电库文档 https://docs.openluat.com/osapi/ext/charger/exs_yhm2712a/ ，pm.shutdown 说明见 https://docs.openluat.com/osapi/core/pm/ 。
40. Air780EGH用SPI0接W25Q512测试失败是什么原因？
解答： 建议先按官方验证过的标准方案跑通基线，再对比自有设计：1）使用合宙 AirSPINAND_1000 配件板和官方 little_flash（lf）demo，软硬件完全按文档连接，确认官方方案可正常读写（配件说明 https://docs.openluat.com/accessory/AirSPINAND_1000/ ）；2）基线通过后再接入 W25Q512，重点核对：SPI 引脚接线（CLK/MOSI/MISO/CS）、供电电压、片选引脚配置、Flash 容量与驱动支持列表（V2048 固件 little_flash 已增加 W25Q256FV 支持，更大容量需确认固件支持情况）；3）SPI 速率先降低测试，排除走线过长/干扰。
41. IOT平台要交年费吗？irtu免费吗？
解答： 合宙 IoT 平台（iot.openluat.com）的部分增值服务（如 LBS 付费定位等）按服务收费；FOTA 远程升级目前免费使用。iRTU（DTU 配置服务）自 2026年7月7日起配置服务永久免费，新平台 iRTU.openLuat.com 与老平台 DTU.openLuat.com 同步生效，iRTU 仅提供参数配置功能。免费政策公告见 https://docs.openluat.com/hezhou_publish/ ，免费使用说明 https://docs.openluat.com/value/irtu/free/ 。
42. 买了8201G完整套件是按购买年限免费吗？
解答： iRTU/DTU 配置服务自 2026年7月7日起已全面永久免费，与套件购买时间、购买年限无关，新老平台均免费使用。直接登录新平台 https://iRTU.openLuat.com 或老平台 https://DTU.openLuat.com 使用即可，说明文档 https://docs.openluat.com/value/irtu/free/ 。
43. IOT账号没交费怎么办？irtu必须在iot账号下吗？
解答： iRTU 配置时，设备 IMEI 必须归属在当前登录的 IoT 平台账号下（设备与账号需有归属关系），否则添加 IMEI 时会提示异常。iRTU 配置服务本身已永久免费、无需缴费；若提示 IMEI 不在账号下，请按 IoT 归属文档处理：https://docs.openluat.com/air780epm/product/attributioniot/ 。
44. Air780E/EPM的固件升级通知中，基于SDK二次开发是否有影响？
解答： Air780E 不受本次升级通知影响；Air780EPM/EHM 受影响——无论 LuatOS 脚本开发还是 CSDK 开发，10月1日后新出货的模组都必须将代码更新到官方仓库最新版本、配套最新固件使用；已出货产品无需处理。
45. luatos-soc-2024-master这个SDK是Air780EPM的，会受影响吧？
解答： 会受影响。基于 luatos-soc-2024-master SDK 开发的 Air780EPM 项目，请及时拉取 gitee 官方仓库最新代码同步更新，并配合最新版本固件进行编译、测试和出货。
46. 已经生产的模块用的是V2007固件，还能升级吗？
解答： 可以升级。已生产设备可通过 FOTA 远程升级到新固件，但注意：不同底层固件版本之间的差分包不通用，V2007 与其他版本不能共用同一个 OTA 升级包，需要针对实际版本分别制作差分升级包，参考 https://docs.openluat.com/atmozu/product/command/fota/ 。
47. 固件版本不一样会影响脚本程序OTA吗？
解答： 会。FOTA 差分包与"当前固件版本→目标版本"严格对应，不同底层固件版本必须分别生成、分别推送升级包，不能混用。平台侧请按固件版本分组管理升级任务。
48. 怎么区分新采购的模组应该用哪个固件？
解答： 原则是"新软件兼容旧模块，新模块不能用旧软件"：10月1日之后新采购/新出货的模组必须烧录官方最新发布的固件；旧模组烧新固件不受影响。实际操作中请始终从官方固件页面下载最新正式版使用：https://docs.openluat.com/air780epm/luatos/firmware/780epm_version/ ，不要使用历史旧版本固件烧录新出货模组。
49. 旧型号的724UG还能采购到吗？
解答： 老型号供货状态需以官方商务答复为准。有历史采购记录的客户可联系对接销售确认供货；新客户、新项目建议直接选用官方主推的在售型号（如 Air780EPM 等 Cat.1 系列），生命周期和供货更有保障，选型参考 https://docs.openluat.com/SelectionGuide/SelectionGuide/ 。
50. 模块烧录后发AT指令没反应，升级后退不回AT，怎么处理？
解答： 烧录 LuatOS 固件后模组运行的是 Lua 脚本系统，不响应 AT 指令属正常现象（如 Air780EPM/EHM 为 LuatOS 二开型号，本身不支持 AT 指令开发；需要 AT 开发应选用 780EPT/780EHT 等 AT 型号）。若需要恢复 AT 固件：1）在 LuaTools 中选择对应型号的官方 AT 固件（可从 LuaTools 资源下载目录的 resource 文件夹获取）；2）让模组进入 BOOT 下载模式（LuatOS 模式下串口烧录需重启模组进入下载模式）；3）重新烧录 AT 固件后即可恢复 AT 指令通信。操作说明见 https://docs.openluat.com/common/Luatools/ 。
51. Air724UG-NFC是否受固件升级通知影响？
解答： 不受影响。本次固件升级通知针对的是 Air780EPM/EHM 等新出货 Cat.1 模组，Air724UG-NFC 可继续按原有固件和方案正常使用。
52. 同一个模组出现2个IMEI号是什么原因？
解答： 模组的 IMEI 是全球唯一固定的，正常情况下不会出现两个 IMEI。该现象多为卡商/平台侧读取或绑定记录异常：1）先确认该 SIM 卡是否曾在其他设备中使用过、卡商平台是否缓存了旧设备的 IMEI；2）联系卡商核对其系统读取到的 IMEI 来源和绑定记录；3）模组侧可通过 AT+GSN（AT 固件）或 mobile 相关接口读取本机真实 IMEI 进行比对。
53. 77936和7796是哪一款屏幕？
解答： 按官方屏幕配件对应关系：V001 为 4 寸屏，V000 为 4.3 寸屏。具体屏幕型号、分辨率和驱动 IC 请以对应开发板/配件的官方资料页面为准。
54. Air1780H V001有几个电阻需要改一下，不然屏幕不会显示，具体怎么改？
解答： 该电阻改动属于特定批次硬件的 BOM/贴片适配问题，需以官方发布的该批次硬件更改通知（ECO）或原理图为准，文档站未收录通用改电阻说明。建议：1）核对 Air1780H 官方产品资料和对应屏幕配件的硬件文档 https://docs.openluat.com/SelectionGuide/SelectionGuide/ ；2）将开发板丝印版本号、屏幕型号和照片提供给官方销售/技术支持，索取该批次的具体改板说明；3）在合宙 AI 助手 https://ai.luatos.com/ 提供板号查询。
55. 4+4型号还不支持pm.chgcmd接口吗？
解答： 4+4 配置型号（Flash 4MB+RAM 4MB）固件未开启 YHM2711 充电 IC 相关支持，因此 pm.chgcmd 接口在该型号上不可用。pm.chgcmd 仅适用于内置/外挂 YHM27XX 系列充电 IC 的型号（如 Air8000 系列）；新项目建议改用 exchg/exs_yhm2712a 充电扩展库实现充电管理，接口说明见 https://docs.openluat.com/osapi/core/pm/ 。
56. 8202G有用到yhm2712a，是否要开启？
解答： Air8202 采用的是 Air780EGP + YHM2712 充电 IC 的组合，充电管理通过官方 exs_yhm2712a 扩展库驱动（不需要也不使用 pm.chgcmd）。请在脚本中 require("exs_yhm2712a") 并按文档初始化配置 CMD 引脚、截止电压、充电电流等参数即可，库文档 https://docs.openluat.com/osapi/ext/charger/exs_yhm2712a/ 。
57. RNDIS配置不同指令在电脑上显示的IP都一样，实际效果有区别吗？
解答： RNDIS/ECM 模式下模组作为 USB 虚拟网卡，其局域网侧 IP 由模组内部固定分配，当前不支持自定义修改，因此不同配置指令下电脑看到的 IP 相同属正常现象，不影响上网和数据转发功能。RNDIS 适用于 Windows，ECM 适用于 Linux/macOS（免驱），说明见 https://docs.openluat.com/air780epm/luatos/app/common/rndis/ 。
58. LuaTools关键词查找窗口拉宽后右边多了一块区域，有影响吗？
解答： 不影响任何下载、调试功能，仅为界面布局显示问题，可正常使用。后续版本会优化该界面细节，也欢迎在官方渠道提交 issue 反馈。
59. Air780EX的AT+ROUTEIP指令从哪个版本开始生效？
解答： AT+ROUTEIP 指令从 780EX2T_V2013 / 3013 版本固件开始生效。使用该指令的客户下单采购时请备注所需固件版本号，确保出货固件满足要求。
60. Air780EX用URL方式升级有什么缺陷？
解答： URL 方式升级存在管理局限：一旦通过某 URL 升级后，后续升级路径与 URL 绑定，不同版本对应的升级 URL 不同，不利于批量设备的版本统一管理和维护。建议批量项目使用合宙 IoT 云平台 FOTA 升级——差分包自动生成、按版本分组推送、升级状态可追踪，参考 https://docs.openluat.com/atmozu/product/command/fota/ 。
61. 把升级固件文件挂到公网地址上就能升级，不一定用云平台吧？
解答： 技术上可行：模组支持从自建 HTTP 服务器下载固件升级（服务器返回 200 及文件内容即升级，返回 300 以上状态码表示不升级），差分包可使用官方差分工具自行制作。但合宙 IoT 云平台在批量升级管理、版本分组、差分自动生成、升级状态统计方面更方便可靠，批量项目推荐使用云平台，参考 https://docs.openluat.com/air780epm/luatos/app/ota/fota/ 。
62. AT+AIRLBS和AT+CIPGSMLOC的区别是什么？收费版精度更高吗？
解答： 两者定位原理不同：AT+CIPGSMLOC 为单基站定位（免费）；AT+AIRLBS（付费版）支持多基站 + WiFi 混合定位，可采集周围 WiFi 热点信息辅助定位，在基站密集的城市/室内环境定位精度通常更优。收费版本质差异在于定位方式和请求频率权限（付费版按请求频率分档收费），并非同一数据提高精度；实际精度取决于周边基站/WiFi 密度。版本要求：780E 需固件版本 > v1172，780EHT/EGT/EVT/700ECT 需 > v2017。说明见 https://docs.openluat.com/atmozu/product/command/lbswifi/ 。
63. 780EQ整机认证测试4G协议fail，最小功率大、最大功率没功率、邻道泄露超标，怎么解决？
解答： 这类射频指标失效通常与整机射频设计有关，而非模组本身问题（模组已单独通过 SRRC/CCC/CTA 认证）。处理建议：1）送测前务必先完成射频性能摸底测试，不要直接送测；2）重点检查天线匹配（天线驻波比、50Ω 阻抗走线、π 型匹配电路）、天线与模组的一致性、整机结构/金属外壳对天线的影响，建议联系天线厂用暗室调试；3）将送测准备和沟通委托给专业第三方认证服务机构（官方推荐上海隆测），可显著提高通过率。认证指导文档 https://docs.openluat.com/air780epm/product/renzheng/ ，天线设计 https://docs.openluat.com/air780epm/luatos/hardware/ant/ 。
64. Air780EPM推荐电源芯片JW5357HFM不好买，JW5357MSOTB可以吗？
解答： 官方资料未给出 JW5357HFM 与 JW5357MSOTB 的直接替代结论，不能仅凭型号相近直接替换。DCDC 选型必须满足模组供电硬性要求：VBAT 电压范围 3.3V~4.35V、输出电流能力 1A 以上（4G 发射瞬时电流大），并按参考设计在 VBAT 端并联 220μF 电解电容或 22μF 钽电容保证瞬态响应。替代前请：1）对比两款芯片的数据手册（输入输出范围、电流能力、外围电路、封装）；2）以官方参考设计和核心板 PCB 为基准进行替换验证；3）实测发射最大功率时 VBAT 不跌落、整机不误重启。供电要求见 https://docs.openluat.com/air780epm/luatos/hardware/vbat/ 。
65. AI编程780EPM代码时，有没有办法让AI直接编译或调用LuaTools下载日志形成闭环？
解答： 支持。VSCode 中的 LuatOS 插件（AI 编程环境）集成了编译检查、一键下载和日志查看能力，可在 AI 生成代码后直接在插件内完成烧录和运行日志抓取，形成开发闭环；命令行场景也可使用 luatos-cli 完成烧录。
66. IOT平台新建项目后，订单管理中没有默认项目可选怎么办？
解答： LBS 基站定位服务的项目需要在 LBS 平台单独创建：登录 https://iot.openluat.com/lbs/bs ，在"我的项目"中新建 LBS 项目后，订单管理中即可选择对应项目。IoT 平台项目与 LBS 项目为不同业务入口，请注意区分。
67. 合宙Air530Z不满足2025协议双频多模要求，有对应产品吗？
解答： 合宙现有单功能 GNSS 定位产品线（如 Air530Z）为单频多模/四频单模类产品，目前没有满足双频多模（如双频多系统高精度）要求的对标的定位模组。双频多模高精度需求可关注合宙后续产品规划，或向官方销售提交具体需求评估；定位产品资料见 https://docs.openluat.com/air530z/product/ ，选型参考 https://docs.openluat.com/SelectionGuide/SelectionGuide/ 。
68. Air780EGH模组的3C认证证书可以提供吗？
解答： 可以提供。合宙模组已通过相关认证，证书可在合宙文档站对应型号的产品资料/认证页面查询下载，或联系官方销售/商务直接索取；认证相关说明见 https://docs.openluat.com/air780epm/product/renzheng/ 。
69. Air780ET的入网证信息/证书能提供吗？
解答： 可以提供。入网许可证（CTA/NAL）等认证证书可在合宙文档站对应型号产品资料中查询，或联系官方销售/商务索取电子版证书；认证相关说明见 https://docs.openluat.com/air780epm/product/renzheng/ 。
70. LuatOS接口文档网页打不开了，是网站问题吗？
解答： LuatOS 官方文档已统一迁移到合宙文档中心，请使用新地址 https://docs.openluat.com/ （API 文档入口 https://docs.openluat.com/osapi/core/ ）。旧域名 wiki.luatos.com 等历史地址已停止维护，可能无法访问，请更新浏览器书签。
71. Air780EPM的API文档链接发一下。
解答： LuatOS 核心 API 文档：https://docs.openluat.com/osapi/core/ ；Air780EPM 型号专属文档（硬件设计、软件教程、固件下载）入口：https://docs.openluat.com/air780epm/ 。
72. 最新版LuaTools放脚本的地方在哪？
解答： 在 LuaTools 主界面的"项目管理"区域中选择/创建项目后，即可在项目配置中添加和管理脚本文件（底层 core 与脚本文件在同一下载配置页选择）；界面显示较紧凑时，将窗口最大化或放大显示比例即可看到完整的脚本添加区域。工具教程见 https://docs.openluat.com/common/Luatools/ 。