常见问题 - 2026-08-05
数据日期：2026-08-05
1. 语音通话中TTS文本较长且未播放完就挂断，再次拨打时TTS无声音或报busy，是什么原因？
解答： 没有收到EXT_SRC_DONE消息，再播就会占用。播放前先调用cc.extern_source(nil)清一下状态。官方demo的TTS文本较短，建议用长文本复现；播放完的话下次不会报错。
2. Air8000模块在Luatools烧录时提示开始通信后下载失败，且USB端口消失，是什么原因？
解答： 可能进入了boot模式或USB驱动问题；可以尝试更新Luatools到最新版本、更换USB线、先按boot键再上电、在boot模式下重新烧录；烧录完成后无端口可能是固件异常或校准区数据丢失，需用最新固件和正确方式烧录。
3. Air780EGP使用IRTU配置后GNSS/GPS一直无法定位成功怎么办？
解答： 检查gnss默认串口ID是否为2，确认是否在室外测试，确认有源天线接法是否正确（PIN2接有源天线，PIN98接47nH再接天线），也可用官方开发板烧录相同固件对比确认是硬件还是软件配置问题。
4. 模块进入低功耗模式（pm.power(pm.WORK_MODE, 1)）后USB断开，如何继续下载脚本？
解答： 进入低功耗必须关闭USB，否则低功耗进不去；需要将USBBOOT引脚拉高重新上电进入boot模式，再通过Luatools下载；建议更新Luatools和SOC到最新版本。
5. air780egg/Air780EPM 支持定时唤醒吗？
解答： 可以的，具体可参考文档或询问 ai.luatos.com。
6. 如何远程更换设备的服务器IP或域名？
解答： 有两个方法：1、远程升级固件更换；2、aircloud协议有getip指令，可以给设备分配新的域名。建议使用域名而不是IP。
7. HTTPS请求在更换服务器证书后失败，Air720G老设备对证书有什么要求？
解答： 720G太老旧，基本没有什么解决方案了；如果服务器不需要证书可以传nil，需要证书就必须内置对应的CA证书；证书过期后会导致请求失败，需更新证书。
8. 固件远程升级（FOTA）时，差分包太大是否会导致模组变砖？应该注意什么？
解答： 会的，老版本固件对过大差分包没有防御，可能烧坏校准区导致变砖且线刷也无法恢复；差分包大小应控制在600KB以内，跨度太大时需加中间版本逐步升级；新版本固件已增加防御。
9. Air780EPM 从2005版本FOTA升级到2046版本失败变砖，怎么办？
解答： 2005到2046跨度太大且差分包可能过大，会导致模组变砖且线刷也无法恢复；需要选择中间版本逐步升级，并保证差分包小于600KB；建议使用新版本固件（有防御）并严格控制差分包大小。
10. 使用软件I2C读取数据出现时钟暂停，硬件I2C对0x55从机地址支持不一致是什么原因？
解答： 2032版本固件对0x55默认地址有修改，2032版本以后I2C 0x55地址可用；建议升级到2048版本并使用硬件I2C（iicid写1）。
11. AIR780E内置字库缺少生僻字，有什么办法显示？
解答： 可以用airui自定义TTF字体，放到文件系统里；或参考字库指南https://docs.openluat.com/common/luatos_font_guide/，使用15/115号固件把字体放到文件系统。
12. Luatools新版本下载脚本时提示错误或下载失败怎么办？
解答： 可以更新Luatools到最新3.4.0，检查项目路径是否有中文或特殊符号，删除log文件夹后重启Luatools，或关闭软件重新打开。
13. AIR780EPM 深度休眠时能否定时唤醒？
解答： 可以，具体参考文档或咨询 ai.luatos.com。
14. Air724UG使用HTTP_GET整包下载OTA固件，MCU RAM太小无法整包缓存怎么办？
解答： 可以利用模组自身存储：把HTTP下载的数据存到文件系统或zbuff缓冲区，再分段读出来发给MCU。
15. 物联网卡连不上网且模组一直重启是什么原因？
解答： 1、物联网卡问题，需要问卡商，可把卡插手机测试能否驻网，检查流量是否用完或机卡绑定；2、检查脚本里是否有驻网失败就重启的逻辑。
16. AIR780EPM含税批量价格是多少？有阶梯价吗？
解答： AIR780EPM含税批量单价15.8元，没有阶梯价；累计出货量达到30K是15元的价格。
17. Air780EPM/Air780EHV等型号如何查看CPU是否进入睡眠、低功耗电流如何测试？
解答： 可参考合宙低功耗测量文档 https://docs.openluat.com/value/drawcheck/ 。
18. Air8000的USB能否像U盘一样在电脑上显示TF卡内容？
解答： 不能，Air8000的USB不支持U盘模式，只能使用虚拟串口转发功能。
19. Air8000 SPI只有一路，又想扩展以太网又想扩展串口，是否可行？
解答： 一个SPI口可以挂多个设备，通过CS片选分时复用；如果串口数量不够，也可以考虑外接其他MCU（如1602）扩展。
20. 780EHU和780EPM是否pin to pin兼容，硬件不用改？
解答： 是pin to pin兼容，硬件不用改；但天线不同，因为频段变了，国内4G天线不能用于海外频段，需要单独配海外频段天线。
21. QMC5883L停产了，可以用QMC5883P替代吗？
解答： 5883L确实停产，迭代型号是5883P，硬件和软件区别需要与传感器原厂沟通确认，软件上需要新增5883P的扩展库。
22. 有没有支持VoLTE的4G模块中价格最低的型号？
解答： 合宙4G模块普遍支持VoLTE，新项目建议选主推型号，具体价格可咨询商务；LuatOS开发可选用780EHV等。
23. RAM dump文件（ramdump.bin）有没有工具可以分析？
解答： 现在基本不分析死机日志了，建议把功能挨个关闭排查死机发生在哪个功能上，然后单独测试；如果无法解决，提供最短可复现代码，可复现死机后分析底层。
24. Luatools更新到3.4.0后日志不打印、COM口消失是什么问题？
解答： 可能模块进入boot模式，需要退出boot；新版本Luatools界面变化也可能与屏幕分辨率有关，可以缩放窗口或删掉ui文件夹重新打开。
25. airtest.openluat.com服务是否异常？
解答： 尚未解答
26. Air780EPM 从2044升级到2048没成功，如何排查？
解答： 差分包升级需要主动HTTP请求一次；确认差分包小于600KB，排除网络、信号、卡等问题后一般一次就可成功；可提供IMEI让官方排查。
27. FOTA升级同一台设备10分钟内只能升级一次吗？
解答： 对，大批量是这样；调试设备可以设置最多3台不受10分钟限制。
28. 如何把模块添加到自己的设备/项目里？
解答： 模块需要归属到账号下，可通过文档 https://docs.openluat.com/air780epm/product/attributioniot/ 查看归属和分配方法；也可以提供IMEI让官方协助转移。
29. Air724UG的net_mode为低电平是什么意思？
解答： 尚未解答
30. 写程序后模块USB连不上，boot接地再通电也不行，如何解决？
解答： boot引脚应该接VDD_EXT而不是接地，接3.3V再上电试试。
31. 有没有电池供电版的屏幕/开发板？
解答： 没有，屏幕功耗太高不适合电池供电。
32. Air780E的SPI接口能否外扩2G SPI NAND FLASH用于存储临时数据？
解答： 尚未解答
33. 合宙是否有贴片SIM卡售卖？
解答： 有，找合宙商务购买。
34. 专网卡设置APN后一直报+CME ERROR: 302怎么办？
解答： 中间APN加上双引号试试，例如AT+CPNETAPN=2,"CMMTMXYKJ.SN",,,0。
35. 新卡注册状态一直为2（未激活）怎么办？
解答： 先确认固件版本和APN设置，可参考对应AT固件文档中的方案排查；运营商后台未激活需要找运营商处理。
36. 4G模块时钟同步精度能到多少？有没有高精度时间同步的方法？
解答： 做好网络时间同步即可，精度取决于网络；Docs有时间同步详细说明，也可问ai.luatos.com。
37. fskv中存储的数据能被读出来吗？如何加密？
解答： 脚本烧录到模组后已经是机器码，读出来也没用；fskv数据无法直接加密，可以自己先加密再写入fskv，读取后再解密使用。
38. AI使用中遇到回复错误或没有回复怎么办？
解答： 如果遇到“对话服务错误”，重试几次；可到docs.openluat.com右下角咨询，发现回复有错误可以找官方反馈。