常见问题 - 2026-10-29

数据日期：2026-10-29

1. 780EP/780EPM模块无法启动，设备管理器识别不到USB设备，换一块即可，是什么原因？

解答： 结论：先怀疑供电与开机时序，模组本身损坏的概率很低——换一块就能用，恰好说明问题多半在供电或焊接。说明：USB 根本识别不到设备时，模组通常连下载模式都没进；电脑 Type-A 口经劣质线缆压降大，VBAT 一旦跌到门槛以下，模组会反复上电复位，表现出来就是“插上没反应”。另外 PWRKEY 需要拉低并保持 1 秒以上才算有效开机，只点一下容易停在上电半途。处理步骤：① 换 Type-C 口直连，或用带外部供电的 HUB；② 用万用表量模组 VBAT 与 GND，确认上电瞬间电压稳定不掉压；③ 把 PWRKEY 短接到 GND 保持 1 秒以上再松开；④ 用 Luatools 观察是否出现下载端口；⑤ 仍无反应就上强制 BOOT（拉高 USB_BOOT）再试一次，能进下载模式说明只是开机时序问题，不能进再查焊接。参考文档：https://docs.openluat.com/air780epm/luatos/hardware/design/poweron/、https://docs.openluat.com/air780epm/luatos/hardware/pwrkey/

2. AIR780EHM用户可以配置几个WAKEUP低功耗唤醒脚？

解答： 尚未解答

3. 设备上电后注册失败/驻网异常，复位后恢复，可能是什么原因？

解答： 结论：复位后能恢复，优先按「SIM 卡鉴权 / 卡状态」方向排查，而不是天线或射频。说明：入网时如果 SIM 鉴权没通过，网络侧会直接拒绝注册；复位把卡会话重新走一遍就恢复，说明射频链路基本正常，问题多出在卡侧（白名单、机卡绑定、卡被停用）或鉴权交互偶发失败。当前公开最新固件是 V2054，旧固件在鉴权异常处理上有已知差异，建议先升级再判断。处理步骤：① 刷到 V2054；② 用 Luatools 保存完整底层日志（先停止打印再保存，别覆盖同名文件）交 FAE 分析；③ 换一张手机卡交叉验证，判断是卡的问题还是设备的问题；④ 用 AT+CSQ 确认信号强度，排除弱信号导致的注册重试；⑤ 若同一张卡在多台设备上都出现，直接找卡商核白名单与机卡绑定状态。参考文档：https://docs.openluat.com/air780epm/luatos/firmware/780epm_version/

4. Luatools左侧没有“模拟器运行”栏目怎么办？

解答： 结论：Luatools 版本太旧，升级到较新版本后左侧就会出现「模拟器运行」。说明：模拟器入口是较新版本才加的功能，V3.4.12、V3.4.14 这类旧版没有这个菜单项，装什么插件都出不来。需要注意模拟器跑的是 PC 平台的 LuatOS，库的支持范围和模组固件并不完全一致，涉及硬件外设的接口在模拟器上会表现为不可用，验证外设功能仍要用真实模组。处理步骤：① 到下载页取最新版 Luatools 覆盖安装；② 重启程序；③ 确认左侧出现「模拟器运行」；④ 若仍没有，检查装的是不是「量产工具」那个分支而不是主程序；⑤ 模拟器只用来跑逻辑，外设相关功能回到硬件上验证。参考文档：https://docs.openluat.com/common/Luatools/

5. Air8000A的GNSS功能需要哪个固件？122号固件不支持libgnss怎么办？

解答： 结论：22/122 号固件确实没有编入 libgnss，需要 GNSS 就得换用带 libgnss 的固件，或向 FAE 索取带 GNSS 的临时版本。说明：V2054 新增的 22/122 号固件定位是「SIP 通话 + AIRUI 带屏」，脚本区只有 512KB，装不下 libgnss、TTS 这类大库；固件页列出的核心库清单里确实没有 libgnss。官方另给了包含 GNSS 且带 SRTP 的临时固件（V2055_Air8000_22），但该版本不在公开固件列表内，属于按需索取。处理步骤：① 先确认当前固件号（看 Luatools 下载记录或固件文件名）；② 需要 GNSS 就向 FAE 索取 V2055_Air8000_22 临时固件；③ 或者退回含 libgnss 的常规固件号，代价是失去 22/122 号上的 voip/airui 相关能力；④ 刷完在脚本里 require libgnss，能加载即说明支持；⑤ 正式量产前等 libgnss 加回公开版本。参考文档：https://docs.openluat.com/air8000/luatos/firmware/

6. AIR780EPM用AI/CLI烧录大脚本后设备无法启动，校准区可能被擦除，如何恢复？

解答： 结论：先用 Luatools 全量重刷固件恢复；如果射频校准区真被擦掉，本地没有恢复手段，只能返厂。说明：校准区是量产阶段写进 flash 的射频校准参数，第三方 AI/CLI 工具直接按地址擦写时很容易把它一并清掉。校准数据丢失后表现是能开机但发射指标异常、注网困难甚至完全搜不到网，这类数据不是刷固件能补回来的。处理步骤：① 用 Luatools 选对固件号做一次全量刷写（内核 + 脚本一起）；② 刷完观察能否正常开机、能否注网；③ 若注网正常、信号也正常，说明校准区没被破坏，继续用即可；④ 若反复搜不到网或信号明显异常，按校准丢失处理，走返厂重做校准；⑤ 后续一律用 Luatools 或官方量产工具烧录，不要用非官方工具直接写 flash。参考文档：https://docs.openluat.com/common/Luatools/、https://docs.openluat.com/common/Luat_productiontool/

7. Luatools编译量产文件时脚本数量只有25个，是不是有数量限制？

解答： 结论：脚本数量没有上限，「只有 25 个」是依赖收集规则导致的漏收，不是限制。说明：Luatools 生成量产文件时按 require 依赖链逐个收集脚本，但对 config.lua 不做依赖分析——这是 Air 固件时期沿用下来的规则。挂在 config.lua 里的 require 不会被顺着找出来，于是只打进 main.lua 那条链上的文件，看起来就像“只能放 25 个脚本”。处理步骤：① 把业务模块的 require 统一写到 main.lua，或在 main.lua 里 require 一个聚合文件；② 重新生成量产文件；③ 打开量产包核对文件列表与工程目录是否一致；④ 仍缺就检查是否存在字符串拼接式的动态 require（静态分析看不到，需改成固定路径）；⑤ 该问题官方已确认后续版本会修，在修好之前按上面的写法规避。参考文档：https://docs.openluat.com/common/Luatools/

8. AIR8607/R205、R206可以改阻值提高背光电流吗？7寸屏180mA背光偏暗怎么办？

解答： 结论：可以改，但必须同时换更大封装的电阻，0201 直接改小阻值会过热。说明：Air8607 的背光由 PWM3（PIN55 = GPIO13，1kHz）做调光，硬件默认限流大概按 40mA 设计，7 寸屏在这个电流下偏暗是正常表现。提高背光电流本质上就是减小背光升压回路的限流电阻，但 0201 封装的额定功率很小，同一个阻值换成 0201 会明显发热甚至烧断。处理步骤：① 对着原理图确认 R205/R206 具体落在背光升压的哪一路（限流还是反馈分压）；② 按目标电流重算阻值，并把封装换成 0603/0805；③ 换完实测背光电流与实际亮度，确认肉眼可见改善；④ 连续点亮半小时观察电阻与背光升压 IC 的温升；⑤ 客户可先小批验证，批量前等官方改版结论，避免和后续版本冲突。参考文档：https://docs.openluat.com/air8607/hardware/circuit/

9. Air780EGT能支持112K本地数据存储吗？

解答： 尚未解答

10. Air780EPM的SIM2是否占用GPIO23？最新硬件SIM2内部上拉是否已去掉？

解答： 结论：GPIO23 在本系列上是 AGPIO3/Vref 脚，兼作外部上拉的参考；把它挪去当 485 的 DE 会影响 SIM2 相关电路，最新 780EPM 硬件已去掉 SIM2 内部上拉。说明：从文档看，GPIO23 对应 PIN99，在 EGP/EGG/EGH 上被内部占用（GNSS 后备供电、G-Sensor 供电），文档明确要求外部用 I2C1 时必须保持 GPIO23 默认输出高。SIM2 的三根信号线是 PIN63 RST / PIN62 CLK / PIN64 DATA，VDD_SIM2 在 PIN65，和 GPIO23 不是同一组管脚，所以“占用”更多体现在上拉/参考电平这条隐式通路上。处理步骤：① 拿最新原理图核对 SIM2 与 GPIO23 的实际连接关系；② 485 的 DE 改到其他空闲 GPIO；③ 若设计上必须用 GPIO23，保持它默认输出高，不要改成推低；④ 最终以官方 GPIO 复用表（xlsx）加 Luatools 管脚配置为准。参考文档：https://docs.openluat.com/air780epm/luatos/hardware/gpio/、https://docs.openluat.com/air780epm/luatos/hardware/design/air780exxpins/

11. Air8000W做音频桥接到云端，通话有噪音、卡顿是什么原因？

解答： 尚未解答

12. Air780EHV/780EH系列会停产或升级吗？

解答： 结论：官方给的口径是不会停产、也不会升级，可以按现有版本做长期设计。说明：这类属于产品生命周期承诺，文档站不会写具体日期，以对接销售/FAE 的答复为准。对设计方的实际意义是：不用担心某天被迫换型，但也别指望后续有新功能补进来，选型和固件版本应当一次定死。处理步骤：① 把当前固件、脚本、原理图、量产文件一并归档，标注固件号；② 量产文件与固件号做一一对应记录，避免以后错配；③ 有新需求另起项目选新型号，不要指望在原型号上升级；④ 供货周期等商务条款单独确认。参考文档：无（属产品生命周期口径，请与对接销售确认）。

13. erp.openluat.com是否还支持自定义定制固件？

解答： 结论：已经不支持，erp 平台上的自定义定制固件通道已关闭。说明：以前可以在 erp 平台上按需求裁剪编译专属固件，现在只能使用公开发布的固件号，业务差异要靠脚本层实现。库级的能力裁剪（例如某个库太大想拿掉）已经不能自助做，需要走 FAE 提需求评估。处理步骤：① 从固件页挑一个库支持最接近需求的公开固件号；② 业务逻辑全部放在脚本里；③ 确认脚本区容量够用（不同固件号脚本区差别很大）；④ 确实缺库能力时，带具体场景提给 FAE 评估，不要自行编译内核。参考文档：https://docs.openluat.com/air8000/luatos/firmware/

14. 哪个型号支持语音通话（VoLTE）功能？想做紧急语音拨打预设号码。

解答： 结论：要做 VoLTE 语音通话，选 Air780EHV 及板载它的整机型号（如 Air8780V）；EC7xx 里不带通话能力的型号刷固件也变不出来。说明：VoLTE 是基带与音频通路的能力，属于硬件+固件一起决定的，不能靠换固件加上。Air8780V 板载的就是 Air780EHV，所以 8780 系列里只有 V 这一档具备话音能力。做紧急拨号这类应用，除了选对型号，还要确认是否需要本地音频 codec 与 PA。处理步骤：① 先明确场景是双工通话（要 mic + speaker）还是只要语音播报；② 双工通话选 EHV 系（8780V、Air8784 等）；③ 只要 TTS 播报可选带 TTS 的型号，成本更低；④ 拿不准具体型号能力时用官方型号能力查询工具交叉确认。参考文档：https://docs.openluat.com/air780ehv/product/、https://docs.openluat.com/air8780/product/

15. 8301/8300工控板的工作温度范围是多少？

解答： 结论：模组级标称是 -40℃ ~ +85℃，但 Air8301 整机要把屏算进去，实际只有 -20℃ ~ +70℃。说明：Air8301 的电路说明里明确写了「工作温度是本板短板：屏为 -20~+70℃，整机工作温度应以最窄器件为准」。8301 标配含 4.3 寸触摸屏，所以给客户报整机温度时不能直接套模组的 -40~+85℃，否则低温下屏先失效。处理步骤：① 对外报参数按整机最窄器件（屏）来报；② 低温项目要么换工业级屏，要么去掉屏只做模组方案；③ 需要 -40℃ 起工作的场景，选纯模组形态（如 8300 类无屏方案）再单独确认；④ 高低温实测以整机为准，别只看单器件规格书。参考文档：https://docs.openluat.com/air8301/hardware/circuit/

16. 8301开发板能否扩展485接口？

解答： 尚未解答

17. Air8607两路UART能否用来自定义驱动外设？

解答： 尚未解答

18. 合宙是否有能适配node-red的模块/方案？

解答： 尚未解答

19. AIR780EPM插入物联网卡偶发鉴权失败（未读到0088内部认证指令），报NAS Event 6 Reject 111，如何排查？

解答： 结论：分两条线查——卡侧（白名单 / 机卡绑定）和卡座链路（7816 信号完整性）。说明：日志里没读到 0088 内部认证指令，说明 7816 链路上的 APDU 交互根本没走完；Reject 111 是网络侧拒绝，两者叠加更像卡会话没建立成功，而不是射频弱。偶发、复位可恢复这两个特征都指向时序或卡状态，而不是硬件损坏。处理步骤：① 用同一张卡在手机上抓 7816 的 CLK/RST/IO 波形，和模组侧对比，看是没发复位还是应答超时；② 换卡、换设备交叉验证，把问题定位到卡还是设备；③ 找卡商确认是否有白名单与机卡绑定，并要求提供停机前后的识别 IMEI；④ 刷到 V2054 后抓底层日志给 FAE，让研发看鉴权交互细节；⑤ 卡座焊接与触点清洁也要排一遍，虚焊会表现为偶发读不到卡。参考文档：https://docs.openluat.com/air780epm/luatos/firmware/780epm_version/

20. 使用iRTU固件时如何远程查看系统日志？

解答： 结论：iRTU 是开源的，自己把 errDump 接上并上报到自己的服务器即可，没有现成的远程日志开关。说明：iRTU 固件本身不带远程日志通道，日志默认走 USB / 串口，人不在现场就拿不到。errDump 库的作用是接管运行时错误输出，把回调里的内容转发到 mqtt 或 http 就能实现远程查看。处理步骤：① 取 iRTU 源码工程；② 在脚本里注册 errDump 回调，把内容 publish 到自建 topic 或 POST 到自己的接口；③ 重新打包脚本烧录；④ 服务端订阅同一 topic 就能远程看日志；⑤ 注意上报频率，日志多了会明显增加流量与功耗，建议只在异常时上报。参考文档：https://gitee.com/openLuat/LuatOS/tree/master/module/iRTU、https://docs.openluat.com/osapi/core/errDump/

21. Air8700P iRTU配置后拉取不到信息，默认固件能用吗？是否需要烧录夹具？

解答： 结论：8700P 出厂固件不是标准 iRTU 程序（只是连 AirCloud 的演示），要自己烧 iRTU 固件，后台无法直接升级。说明：演示固件里没有 iRTU 的配置解析逻辑，所以在 iRTU 后台怎么配都拉不到信息。另外 iRTU 固件不在云端 OTA 通道里，只能本地用 Luatools 烧。处理步骤：① 从 iRTU 固件页下载对应型号的固件；② 用 Luatools 烧录；③ 再回 iRTU 后台做参数配置；④ 确认设备已连上配置平台、能看到心跳；⑤ 首次调试建议先用串口确认固件确实起来了，再排查后台配置。参考文档：https://docs.openluat.com/value/irtu/firmware/

22. Air780EHM用iRTU固件，内置流量卡不能上线，另插卡才可以，怎么办？

解答： 结论：在脚本里把默认上网卡指定为 SIM1，内置卡就走通了。说明：内置贴片卡与外部卡座一般分别接在 SIM1、SIM2 上，双卡单待时只有一个卡槽参与注网。默认卡槽不是内置卡那一路，就会表现为“内置卡上不了、另插一张能上”。另插卡可用也说明射频和基带都正常，问题只在卡槽选择。处理步骤：① 看原理图确认内置卡接的是 SIM1 还是 SIM2；② 在脚本初始化时把上网卡槽设成内置卡那一路；③ 重启验证能否注网；④ 仍不行就查 VDD_SIM 供电是否起来，以及卡座检测脚状态；⑤ 双卡型号注意 SIM2 与 Camera 复用同一组信号，不能同时用。参考文档：https://docs.openluat.com/air780epm/luatos/hardware/design/air780exxpins/

23. Luatools下载一直报错，不接USB也报错怎么办？

解答： 结论：先关掉 360 这类杀毒 / 加密软件再试，多半就是它拦的。说明：这类软件会拦截 Luatools 对串口的独占访问、对临时目录的写入，甚至直接拦进程创建，表现出来就是一直报错。特别注意「不接 USB 也报错」这个现象——如果连设备都没插还报错，说明拦的是程序本身而不是通信过程。处理步骤：① 退出或卸载 360 等安全软件；② 临时关掉 Windows Defender 实时防护试一次；③ 右键以管理员身份运行 Luatools；④ 换一根质量好的 USB 线和主板后置 USB 口；⑤ 仍报错就用「保存日志」导出 ZIP 发给技术支持，里面有具体报错码。参考文档：https://docs.openluat.com/common/Luatools/

24. Air780EVT的4G通话对讲音量如何调节？USB能否上网？

解答： 结论：本地播放音量在脚本里调，通话音量用 AT+CLVL 调；USB 上网通过 RNDIS 实现。说明：+CLVL 调的是通话链路的音量等级，和本地音频播放音量是两套通路，改错地方就会“调了没反应”。USB 上网需要固件带 RNDIS 能力，PC 侧识别成一块网卡，模组侧还要配好 APN 才能真正通网。处理步骤：① 先 AT+CLVL=? 看取值范围，再用 AT+CLVL=<等级> 设定通话音量；② 本地播放音量改脚本里的音频增益参数，不要用 AT 指令；③ USB 模式切到 RNDIS，PC 侧确认出现新网卡并拿到 IP；④ 网卡起来但上不了网，检查 APN 与路由配置；⑤ 双向都验证一遍再定版。参考文档：https://docs.openluat.com/osapi/core/cc/

25. Air780EHM做被叫自动接听时收不到DTMF，主叫正常，是什么原因？

解答： 结论：要收 DTMF 必须用编入了 cc.dtmfRx 的固件，公开版本的默认固件不一定开了这个能力。说明：DTMF 接收由 cc 库里的 DTMF_RX 功能控制，属于编译期开关，没编进去时脚本里调 dtmfRx 只会拿到失败或 nil。主叫侧正常、被叫侧收不到，通常是能力开关问题，不是音频通路问题；接听后媒体没建立、或被下位机提前挂断也会表现成收不到。处理步骤：① 先读 cc.DTMF_RX_VERSION 探测当前固件是否带 DTMF 接收能力；② 不带就向 FAE 索取带该能力的固件（如 V2055_Air780EHM_13 这类合成版本，不在公开列表内）；③ 确认接听后媒体已建立再开始收号；④ 检查是否同时加载了两份 audio_drv.lua，重复加载会互相打断；⑤ 用固定频率的测试音先验证接收，再上真实对端。参考文档：https://docs.openluat.com/osapi/core/cc/

26. 合宙Air510W模组第10、11脚（天线/北斗）测出短路、模块发烫电流达500mA，是什么问题？

解答： 结论：是该批次参考设计的问题，拆掉模块内的一颗电感 L0103 即可，后续试产大板要按最新参考设计改。说明：10、11 脚被设计成天线/北斗相关脚位，测得短路并且电流到 500mA，说明这条通路上存在直流低阻回路，模块发烫就是这个电流造成的。属于硬件设计批次问题，改软件没有意义。处理步骤：① 先断电，用万用表确认 10、11 脚对地阻抗，确认确实是低阻；② 拆掉 L0103 后复测阻抗，应恢复正常；③ 上电观察电流与温度是否回到正常范围；④ 试产大板按最新参考设计修改，不要沿用旧版；⑤ 批量前找 FAE 确认受影响的批次范围。参考文档：https://docs.openluat.com/air510w/product/

27. AIR8607的R205/R206背光电流只有40mA，7寸屏很暗，能改吗？

解答： 结论：可以改，换成 0603/0805 大封装电阻后背光电流能提到约 100mA，亮度改善明显。说明：8607 背光默认按 40mA 左右设计，7 寸屏在这个电流下偏暗。限流电阻封装是 0201，额定功率很小，直接换小阻值会过热，所以必须同时放大封装。官方在同步做测试与改版。处理步骤：① 按原理图确认 R205/R206 的位置与作用；② 按目标电流（约 100mA）重算阻值，选 0603/0805 封装；③ 换完实测背光电流和实际亮度；④ 连续点亮观察温升；⑤ 先小批验证亮度是否满足，批量前等官方改版结论。参考文档：https://docs.openluat.com/air8607/hardware/circuit/

28. Air8607播放视频文件不成功，支持什么格式？

解答： 结论：要先把视频转成 hzv 格式，mp4 直接放是播不了的。说明：8607 上的 video 组件走 hzv 封装格式（视频与音频打包在一起），不是通用解码器，支持面比“能放 mp4”窄得多。Luatools 后续会增加 mp4 转 hzv 的功能，目前需要按协议自己打包。处理步骤：① 按 hzv 协议把视频转封装；② 放到文件系统或 TF 卡里；③ 用 video 组件加载播放；④ 播放失败时先确认文件本身完整、路径正确；⑤ 关注 Luatools 的格式转换功能更新，能省掉自己打包这一步。参考文档：https://docs.openluat.com/protocols/hzv/

29. Air8607的USB口插不稳/质量差怎么处理？

解答： 尚未解答

30. 5V输入给8607最少需要几A？电脑USB供电会导致重启吗？

解答： 结论：按 5V / 2A 以上准备电源，整机功耗按 10W 量级估算；电脑 USB 口带不动，会重启。说明：8607 带 7 寸屏加背光，峰值电流主要被屏和背光吃掉，官方参考设计用 JW5357 输出 10W 以上。电脑 USB 口一般只有 5V/0.5~0.9A，一带背光就掉压，表现就是反复重启或屏闪。处理步骤：① 换 5V/2A 以上的充电器，优先用 USB3.0 口或独立适配器；② 用电流表测上电瞬间峰值电流；③ 换短而粗的线，排除线损压降；④ 仍重启就看是不是背光与主控同时上电，必要时做上电时序；⑤ 长期运行留 30% 以上余量。参考文档：https://docs.openluat.com/air8607/hardware/circuit/

31. Air8380什么时候上市？

解答： 结论：纯邮票孔封装的 8380 即将开始销售，具体时间以官方渠道公告为准。说明：上市时间属商务信息，文档站不发布日期，也不做交期承诺。已有的 8380 资料（硬件、产品、软件三块）都在文档树里，可以先按资料做设计验证。处理步骤：① 关注官方公众号 / 官网的新品公告；② 需要样品或批量交期直接找对接销售确认；③ 设计阶段先按现有硬件资料评估封装与管脚；④ 不要按未公布的时间节点排量产计划。参考文档：无（属商务事项，请通过购买渠道或对接销售确认）。

32. Air780EPM和780EPT的功耗、AT指令有区别吗？能pin to pin替换吗？

解答： 结论：功耗几乎相同，但「能 pin to pin」不能只凭经验判断，AT 指令与管脚都要逐项核对。说明：780EPM 与 780EPT 同属 EC7xx 这一代，CSDK 库共用、接口一致，所以基础功耗接近；但两者的管脚定义、可用外设和部分型号专属 AT 指令存在差异，直接替换可能踩到复用脚。处理步骤：① 下载两款模组的管脚复用表（xlsx）逐脚比对，重点看电源、SIM、USB、复位、BOOT 这几组；② 用 Luatools 的管脚配置页面核对功能映射；③ AT 侧用 ATI / AT+CGMM 确认实际型号与支持能力，再逐条比对自己用到的指令；④ 有差异的脚在 PCB 上留兼容设计（如 0 欧电阻跳接）；⑤ 不要直接把 780EP 的板子当 780EPM 量产。参考文档：https://docs.openluat.com/air780epm/product/air780exx/、https://docs.openluat.com/SelectionGuide/SelectionGuide/

33. 780E系列模组被基站踢下线是什么情况，断电重启能恢复吗？

解答： 结论：被基站踢下线属网络侧策略问题，没有统一规律，但可以用飞行模式快速恢复驻网。说明：基站侧的寻呼策略、小区重选、邻区配置都可能让终端被踢，同一张卡在不同地点表现也可能不一样，所以官方不给“必现原因”。断开后进飞行模式 1~2 分钟再退出，等于强制重新搜网注册，多数情况能恢复。处理步骤：① 记录掉线时间点、所在小区与信号强度，判断是否集中在某类场景；② 脚本里加掉线检测，触发后进飞行模式 1~2 分钟再退出；③ 配合应用层心跳与重连，避免业务层长时间假在线；④ 频繁掉线的点位拿日志找 FAE 与运营商核对；⑤ 780EPT 目前未发现该现象，可作为对比参考。参考文档：https://docs.openluat.com/osapi/core/mobile/

34. Air780EHM/Air780E品类的内置卡、SIM卡偶发不识别（读不到卡号），换724模块正常，是什么原因？

解答： 结论：大概率是卡侧问题（机卡分离 / 机卡绑定），不是模组读卡电路坏了。说明：换 724 模块能正常读卡，说明卡本身和卡座接触都没问题，差异在“这张卡认不认这台设备的 IMEI”。运营商侧做了机卡绑定或把卡停用后，模组就只能读到卡但拿不到卡号，表现出来像是偶发不识别。处理步骤：① 找卡商提供停机前后识别到的 IMEI；② 和模组实际 IMEI（mobile.imei() 或丝印）逐位对比；③ 用一张手机卡插到同一台设备上验证，能读卡说明设备没问题；④ 确认卡座触点干净、无氧化、无虚焊；⑤ 需要换绑时让卡商在后台改 IMEI 白名单。参考文档：无（属运营商卡侧问题，请与卡商核对机卡绑定状态）。

35. 8607/8603能否驱动7寸、10寸大屏？RGB转HDMI/LVDS后画面如何缩放？

解答： 结论：主控最大支持 1280×800，超过这个分辨率效果不做保证；RGB 转 HDMI 到大屏依赖显示器自身缩放。说明：8607 / 8603 的主控是 Air1603 这一代，RGB 输出分辨率上限就是 1280×800，且只支持 RGB565。往上接 10 寸这类 1920×1080 的屏，靠转接板把 RGB 变 HDMI/LVDS，能不能看取决于转换芯片与显示器是否支持自动缩放，LVDS 转接官方仍在验证中。处理步骤：① 屏选型控制在 1280×800 以内，避免分辨率不匹配；② 必须转 HDMI 时，先确认显示器支持自动缩放与 EDID 兼容；③ LVDS 方案先小批验证再量产；④ 需要更大分辨率与更高帧率，直接换支持 MIPI/RGB 高分辨率的平台；⑤ 分辨率相关的库限制见固件支持列表。参考文档：https://docs.openluat.com/air780epm/luatos/firmware/780epm_version/

36. 合宙开放LVGL吗？

解答： 尚未解答

37. Air780EGP支持WiFi吗？

解答： 结论：Air780EGP 不支持 WiFi，EC7xx 这一代没有 WiFi 射频。说明：780 系列是 4G Cat.1 模组，射频部分只有蜂窝，没有 2.4G WiFi 通路，刷什么固件都开不出来。需要 WiFi 有两条路：换带 WiFi 的平台（如 Air8000 系列、Air8101），或外挂 WiFi 模组 / SPI 以太网。处理步骤：① 先确认需求是 WiFi 上网、还是只要局域网通信；② 要 WiFi 选 Air8000 系列等双模平台；③ 只要联网也可以走 4G + 以太网（外挂 SPI 网卡）；④ 选型拿不准用官方型号能力查询工具确认，别按同系列推。参考文档：https://docs.openluat.com/SelectionGuide/SelectionGuide/

38. Air8000做应用，需要50ms读6轴、每秒取角度、10分钟上传一次，能低功耗吗？

解答： 尚未解答

39. 合宙有没有单北斗的4G低功耗模组？

解答： 尚未解答

40. 用AirMaster删除项目后文件被从硬盘删除，还能找回吗？

解答： 尚未解答

41. Air1602硬件能否用1601的固件？PC模拟器与硬件屏显示不一致怎么办？

解答： 结论：可以用 1601 的固件，Air1602 与 Air1601 在同一版本号下的固件是同一份。说明：1601/1602（含 1603）在同一版本号下，各型号 .soc 的 md5 完全一致，型号靠运行时识别，所以烧 1601 的固件在 1602 上跑是正常的。两个型号都只有 101 号（BASE）与 102 号（MORE_SCRIPT）两种固件，核心库完全相同，差别只在分区大小与字库存放位置。处理步骤：① 先确定用 101 还是 102 号（看脚本区与文件系统需求）；② 直接烧 1601 对应版本固件；③ 若 PC 模拟器与硬件屏显示不一致，先核对底层固件版本是否一致；④ PC 模拟器只跑逻辑，显示效果以硬件屏为准；⑤ 差异明显时拍照 + 固件版本一起给 FAE 定位。参考文档：https://docs.openluat.com/air1601/luatos/firmware/1602_version/

42. iRTU固件在海外（南非）无法联网怎么办？

解答： 结论：先烧最新版 iRTU 固件、核对当地 APN、再确认驻网频段是否匹配。说明：海外场景最常见的两个坑是 APN 不对和频段不匹配。南非当地运营商的 APN 与国内不同，配置里沿用国内值就上不去；频段方面如果模组不支持当地主力频段，会表现为能搜到网但注册失败。处理步骤：① 烧录最新合成的 iRTU 固件（老版本对海外卡兼容性差）；② 在配置里填当地运营商 APN，必要时填用户名密码；③ 用 cellular-z 之类工具看实际驻网频段与信号强度；④ 换一张当地卡交叉验证，区分是卡的问题还是频段问题；⑤ 频段不匹配只能换型号，频段是硬件差异刷固件改不了。参考文档：https://docs.openluat.com/value/irtu/firmware/

43. 合宙4G模块除了串口，能否用SPI或并口传输数据？200KB要30多秒。

解答： 尚未解答

44. 合宙是否有能连USB摄像头、2路串口、至少5个GPIO且4G联网的模块推荐？

解答： 尚未解答

45. Air780EHM/780EG的模组IMEI如何添加到自己的IoT账号下？

解答： 结论：设备已归属到别人账号下时，自己无法直接转移，要由当前归属人操作。说明：平台按 IMEI 决定设备归属，一旦归属成功，合宙侧也不再保留单方面转移的权限——这是为了保护双方数据，否则任何人拿到 IMEI 就能把设备抢走。所以只能走“归属人主动解绑/转移”这条路。处理步骤：① 先用 IMEI 查设备当前归属（平台里添加设备会提示已被占用）；② 联系归属人，请对方在自己的账号下解绑或操作转移；③ 对方操作完成后，你再把设备添加到自己项目下；④ 无法联系到归属人时，准备采购凭证找对接销售协助核实；⑤ 后续设备入库就登记归属，避免二次流转。参考文档：https://iot.luatos.com/

46. AIR780EPM/AIR780E烧录后找不到下载设备，只有一个按键是BOOT还是开机？

解答： 结论：这块板是 Air8201，板上的单键是开机键不是 BOOT，所以要进强制 BOOT 模式才能烧录。说明：8201 类整机板通常只引出一个按键用于开机，没有独立的 BOOT 键。正常开机会直接进业务程序甚至进低功耗，USB 端口不会枚举成下载设备，Luatools 自然找不到设备。处理步骤：① 断电后按住开机键再上电，看是否能进下载模式；② 不行就用强制 BOOT：把 USB_BOOT 拉高后上电，再放开；③ Luatools 里出现下载端口后再执行烧录；④ 烧录失败时换 USB 口与线缆排除链路问题；⑤ 量产阶段建议在板上预留 BOOT 测试点。参考文档：https://docs.openluat.com/air8201/product/

47. 8067/8603大屏人脸识别能否用于支付宝微信刷脸支付？

解答： 结论：不行，这类方案只做识别记录与本地解锁，不能用于支付宝 / 微信的刷脸支付。说明：刷脸支付要接入支付机构的专用 SDK，并通过安全芯片与整机认证，涉及活体检测等级、加密链路、密钥管理一整套合规要求。合宙的大屏方案做的是人脸识别（比对、记录、解锁门禁类动作），不包含支付级的安全模块与认证。处理步骤：① 明确需求是“识别记录”还是“支付”；② 支付类需求必须选已过认证的支付终端方案；③ 识别类可以继续用现有方案，注意活体检测能力边界；④ 涉及个人信息采集要按当地法规做告知与存储合规；⑤ 具体型号能力找 FAE 确认，不要自行推定。参考文档：无（涉及支付合规与认证，请与对接销售及支付机构确认）。

48. 合宙配套SIM卡如何充值？

解答： 尚未解答

49. AIR700E开发板（EVB_Air700E_V1.0）能否烧录Air700EAQ固件？资料在哪里下载？

解答： 结论：Air700E 已不再支持，建议直接换型号；Air700EAQ 是电信版，和这块开发板不是一套。说明：700 系列现在在文档站上有资料的是 ECP / ECH / ECT 这几款，分别对应移动 / 移动 / 移动版本（EC7xx 的 700 系按运营商分型号），EAQ 属早期的电信版本，配套资料与固件都已停更。开发板 EVB_Air700E_V1.0 是为老型号做的，继续用会卡在固件与资料上。处理步骤：① 先确认项目用哪家运营商；② 按运营商选 Air700ECP / ECH / ECT 中对应型号；③ 资料与固件到对应型号的文档树下取；④ 重新评估开发板，老 EVB 不要继续用于新项目；⑤ 已有量产设计要做替换时，按管脚复用表核对兼容性。参考文档：https://docs.openluat.com/air700ech/product/shouce/

50. Luatools左侧没有“模拟器运行”入口，需要点击哪里？

解答： 结论：把 Luatools 升级到较新版本，左侧菜单里就会多出「模拟器运行」。说明：这个入口是随版本新增的，V3.4.12 这类老版本界面上根本没有这一项，反复点也点不出来。升级不需要额外插件，覆盖安装重启即可。处理步骤：① 从下载页取最新版 Luatools；② 覆盖安装并重启；③ 看左侧菜单是否出现「模拟器运行」；④ 若装的是量产工具分支则没有该入口，改回主程序；⑤ 模拟器只用于跑逻辑，外设功能回硬件验证。参考文档：https://docs.openluat.com/common/Luatools/

51. 合宙拓展屏上电有裂纹，烧录测试代码或仅接背光都显示，是屏坏了吗？

解答： 尚未解答

52. Air780EX/Air780EX-3.3V的GNSS定位 demo 间隔70秒、定位慢怎么解决？

解答： 结论：先核对脚本里的 key / id 配置，再用官方提供的 key 测一次，判断是配置问题还是定位环境问题。说明：GNSS 定位除了卫星信号，还可能走 AGNSS / 基站辅助定位，辅助定位要有效 key 才给数据，key 错或过期会表现为“能搜星但迟迟定不下来”。另外冷启动首次定位本来就慢，70 秒在弱信号或室内属于正常范围，热启动才会快。处理步骤：① 检查脚本里 key / id 是否填对、是否过期；② 换成官方提供的 key 和设备跑一次，看定位时间是否正常；③ 区分冷启动 / 热启动，冷启动留足时间；④ 天线侧确认使用有源天线、馈线不要过长；⑤ 室外开阔处复测，室内不要拿来判定位性能。参考文档：https://docs.openluat.com/air780epm/luatos/hardware/gnss/

53. 旧的doc.openluat.com/wiki社区打不开、资料未迁移完整怎么办？

解答： 结论：老社区整体已下线，资料以 docs.openluat.com 为准；少量老短链仍能打开，但不要指望它们长期可用。说明：doc.openluat.com/wiki/21?wiki_page_id=<id> 这类短链目前多数还能返回内容，但社区形态已经不再维护，评论区、附件、搜索都不可用。迁移过程中确实有部分历史帖子没搬过来。处理步骤：① 先在 docs.openluat.com 站内搜索对应型号与关键词；② 老短链能打开的就地保存一份本地副本；③ 确实找不到的资料，把原帖标题或 wiki_page_id 一并提给 FAE 协助找回；④ 不要在新文档里继续引用老社区地址，统一指 docs.openluat.com。参考文档：https://docs.openluat.com/

54. Air780EPM用SDK V2052比V2004联网慢（8秒 vs 4秒），SIM卡就绪回调有两次，正常吗？

解答： 结论：先把测试代码剥掉只留联网逻辑再对比，两次 SIM 就绪回调需要单独确认成因。说明：演示或测试脚本里常带频段扫描、AT 探测这类动作，会明显拖慢注网时间，用它比较版本差异得不出结论。SIM 就绪回调触发两次，一般是重插检测或重试逻辑引起的，也可能是卡在初始化阶段被复位过一次。处理步骤：① 写一个只做上电、注网、打印耗时三件事的最小脚本；② 在 V2052 与 V2004 上各跑多次取平均，避免单次抖动误导；③ 在回调里打时间戳，看两次回调间隔多久、中间有没有重插事件；④ 把时间戳日志和固件版本一起给 FAE；⑤ 确认差异稳定存在后再定性为版本问题。参考文档：https://docs.openluat.com/air780epm/luatos/firmware/780epm_version/

55. Air780EGH模组UART3接雷达模块无反馈，怎么排查？

解答： 结论：先用 USB 转 TTL 直接接到 UART3 上随便发数据，看模组能不能收到，一步就能分清是模组侧还是下位机侧。说明：UART3 收不到数据通常是三类原因——引脚复用没配对、波特率或电平不匹配、收发方向控制不对（雷达是 RS485 时还需要 DE 控制）。用 TTL 直连可以把“线序/对端”这个变量先排除掉。处理步骤：① USB 转 TTL 的 RX 接模组 TX、TX 接模组 RX、共地；② 模组侧脚本开 UART3 接收并打印；③ 上位机随便发一串字符，能打印说明模组与引脚配置没问题，问题在下位机或线序；④ 收不到就核对引脚复用表与波特率；⑤ 若雷达走 RS485，检查 DE 方向控制与终端电阻。参考文档：https://docs.openluat.com/air780epm/luatos/hardware/design/uart/

56. MQTTS比MQTT多约2mA功耗，能否优化？

解答： 结论：多出的约 2mA 主要是 TLS 会话维持与加解密运算的固有开销，能优化但降不到和明文 MQTT 一样。说明：MQTTS 要维持一条 TLS 记录层，心跳包也要加密发送，每一次收发都带 AES 运算和额外的记录头，功耗自然上去。这部分不是配置能消掉的，只能靠拉长心跳、减少连接次数来摊薄。官方已在和研发沟通进一步优化。处理步骤：① 把心跳周期拉长到业务允许的上限，减少唤醒次数；② 合并上报，一次连接多发几条，避免频繁建链；③ 配合低功耗模式（PSM+ 或 dtimer 唤醒）做批量上报；④ 数据敏感度不高时评估改回明文 MQTT；⑤ 优化前后用同一脚本实测平均电流对比。参考文档：https://docs.openluat.com/osapi/core/mqtt/

57. Air780E想把IO状态、ADC、位置信息上传自己服务器并接收指令控制IO，有例程吗？

解答： 尚未解答

58. 10寸屏开孔尺寸多少合适？

解答： 结论：开孔尺寸要按外壳结构定，通常先定开孔、再按开孔定做外壳。说明：这属于结构设计参数，和屏的可视区、边框宽度、装配方式、面板厚度都相关，文档不会给一个通用毫米数。直接按屏外形尺寸开孔，往往会因为边框遮挡或装配公差出现露边。处理步骤：① 先拿到屏的机械图，确认可视区（AA 区）与外形尺寸；② 按外壳面板厚度和装配方式留 0.5~1mm 公差；③ 先做手板验证可视区是否被遮挡；④ 尺寸定稿后再开模做外壳；⑤ 批量前用实物屏做首件确认。参考文档：无（属结构设计参数，请结合屏机械图与外壳方案确定）。

59. Air8607最小系统设备默认烧的是哪份代码？

解答： 结论：Air8607 最小系统设备默认烧的是 8607 的板级出厂固件（Air1603 主控、102 号分区），不是 iRTU。说明：固件页写明的出厂固件是 Air8607_Factory_001.999.001_LuatOS-SoC_V1028_Air1603_102.soc，源码在 LuatOS 仓库的 module/Air8607/project/factory，是一套带桌面 UI、音视频、文件管理的板级工程。iRTU 是另一套通用透传方案，需要在对应型号上单独烧录，两者不是同一份代码。处理步骤：① 到 Air8607 默认出厂固件页确认当前版本号；② 需要恢复出厂行为就烧这份 .soc；③ 要跑 iRTU 则按 iRTU 固件页单独烧，覆盖后出厂 UI 不再存在；④ 二次开发基于 factory 工程改，不要从零重写；⑤ 版本迭代以源码仓库最新提交为准。参考文档：https://docs.openluat.com/air8607/software/default_factory_firmware/、https://gitee.com/openLuat/LuatOS/tree/master/module/Air8607/project/factory

60. 合宙模组刚上电时有概率很长时间上不了网，和固件有关吗？

解答： 尚未解答

61. Air8101反馈的两个问题是否为bug，需要等官方修复吗？

解答： 结论：这两个问题目前仍在测试确认中，结论出来后官方会同步，暂不做修复承诺。说明：反馈的问题需要研发复现并判断是软件缺陷、配置问题还是硬件限制，在定性之前给不出修复版本与时间点。这类待确认问题不适合写进文档，避免形成错误预期。处理步骤：① 把复现步骤、固件版本、现象日志整理成一份完整记录；② 尽量提供最小复现工程，方便研发定位；③ 关注后续版本更新说明里是否提到该问题；④ 影响交付的先用规避方案顶上，不要阻塞项目；⑤ 结论出来后按官方口径更新设计。参考文档：无（问题待确认，结论以官方后续同步为准）。