常见问题 - 2026-08-06
数据日期：2026-08-06
1. 如何得知4G模块Air780E通过AT+MPUBEX发送数据已成功发出？
解答： 结论：AT指令模式下，发送AT+MPUBEX后模组返回OK仅表示指令被受理，并不代表消息已成功发到MQTT服务器；数据是否真正发出，需结合QoS等级和串口响应判断。
原理：MQTT发布的可靠性由QoS决定。QoS0（发完即忘）无回执，无法确认送达；QoS1/QoS2时协议层有PUBACK/PUBREC确认，模组会在串口输出对应的成功响应或ERROR失败信息。
操作步骤： 1. 发送时将QoS设为1或2，观察模组串口是否返回发布成功的响应码，若返回ERROR则发布失败； 2. 用MQTTX等客户端订阅同一主题，确认是否收到消息，验证链路； 3. 完整的指令格式、参数和响应码说明见AT指令手册MQTT章节：https://docs.openluat.com/atmozu/product/command/mqtt/#81
2. MQTT登录失败，有办法查询具体失败原因吗？
解答： 结论：MQTT登录失败的原因会以错误码/附加信息形式打印在串口日志中，抓完整日志即可定位。
操作步骤：
1. 用串口工具抓取从上电到登录失败全过程的完整日志，重点查看ERROR、+MQTT状态码或登录返回码前的附加信息，常见原因为clientid/username/password错误、服务器地址端口错误、设备未联网、SIM卡欠费；
2. 先用MQTTX客户端（测试服务器 lbsmqtt.airm2m.com:1884，用户名密码随意）验证服务器参数本身是否正确，排除服务器侧问题；
3. 确认模组已注网并获取IP后再发起MQTT连接。
各错误码含义对照AT指令手册：https://docs.openluat.com/atmozu/product/file/Air780EHT%26EGT%26EVT%26Air700ECT%26Air780EPT%26EG2%26EX2T_AT%E6%8C%87%E4%BB%A4%E6%89%8B%E5%86%8CV1.0.13.pdf
3. 固件下载失败、烧录时提示解压出错或下载到一半失败是什么原因？
解答： 结论：下载/烧录失败多为工具缓存、固件与型号不匹配或USB连接不稳定三类原因，按下列顺序排查即可解决大部分情况。
排查步骤：
1. 更新Luatools到最新版本，并删除Luatools目录下的_temp缓存文件夹后重启工具重试；
2. 确认所选固件与模组型号完全一致——刷错型号固件会直接下载失败；
3. 更换优质USB数据线（非纯充电线）、换USB口、换电脑，排除供电不足和USB枚举异常；
4. 若免BOOT下载失败，改为：板子先按住BOOT键再上电/插USB，待Luatools提示检测到设备后松开BOOT，强制进入下载模式烧录；
5. 仍失败时用Luatools抓取完整下载日志联系技术支持。注意：本地烧录须用完整固件包，不同底层版本分区布局不同，禁止用差分包跨大版本升级。
4. Luatools下载工具打不开，显示无法访问此网站，是什么问题？
解答： 结论：Luatools启动时显示"无法访问此网站"，一般是工具版本过旧或其内嵌资源/更新页面加载失败，不是模组问题。
处理步骤：
1. 将Luatools更新到最新版本（下载地址：https://luatos.com/luatools/download/last ），新版本会修复内置页面链接；
2. 检查电脑网络与代理设置，关闭拦截工具访问网络的防火墙/代理后重试；
3. 以管理员权限运行Luatools；若仍异常，彻底删除Luatools目录（含_temp）后重新下载解压使用。
5. Air780EGP进入Slp1并由RTC周期唤醒时偶发AON Watchdog复位，是怎么回事？
解答： 结论：Slp1低功耗状态下由RTC周期性唤醒时偶发AON Watchdog（常开域硬件看门狗）复位，属于休眠/唤醒流程配置或固件时序问题，可通过规范唤醒流程和升级固件解决。
原因说明：AON WDT是位于芯片Always-On电源域的硬件看门狗，由内核固件自动喂狗，正常情况下软件无需干预；若RTC唤醒后系统恢复流程耗时过长或唤醒时序异常导致喂狗未及时执行，看门狗计数溢出即触发复位。
处理建议： 1. 升级到Air780EGP最新正式版LuatOS固件（低功耗相关问题持续修复中），固件列表见：https://docs.openluat.com/air780egh/luatos/firmware/780egp_version/ 2. 参照官方低功耗demo（module/Air780EPM/demo/lowpower/）配置休眠与RTC唤醒，唤醒回调中避免执行长时间阻塞操作； 3. 用Luatools抓取复位前完整日志，确认复位原因为AON_WDT后，结合最小复现工程联系技术支持分析。
6. USB插上电脑无法识别，没有端口出现，怎么刷固件？
解答： 结论：USB插入后无端口，多为数据线、供电或驱动问题，可按硬件替换法快速定位。
排查步骤： 1. 更换数据线（必须是带数据针脚的数据线，纯充电线不会枚举端口）、换USB口（优先直连主板USB口，避免劣质HUB）、换电脑交叉验证； 2. 打开电脑设备管理器，查看是否有未知设备/带感叹号设备或端口出现后立即消失（多为USB电涌、供电不足或驱动异常），重新安装Luatools自带驱动； 3. 确认模组已正常上电（电源灯/开机时序正常）； 4. 强制下载模式：板子按住BOOT键后再插USB上电，待工具识别到端口后松开BOOT，再烧录固件； 5. 仍无任何枚举，检查模组USB管脚焊接与供电，按硬件方向排查。
7. Air8000W的UART11/UART12无法使用，需要什么特殊配置吗？
解答： 结论：无需特殊配置，这是Air8000固件已知问题——V2048版本存在"uart11/uart12向外发数据发不出去"的缺陷，升级固件即可解决。
处理建议： 1. 升级到Air8000最新正式版固件（V2048之后版本已修复），固件下载见：https://docs.openluat.com/air8000/luatos/firmware/ 2. 代码中按常规方式调用uart.setup()配置波特率等参数即可，UART11/UART12与UART1/2/3同为通用串口，使用方法一致； 3. 升级后若仍异常，抓取串口初始化日志确认波特率是否设置成功，并对照UART使用文档：https://docs.openluat.com/air8000/luatos/hardware/uart/
8. Air8000文档中PIN94写的是UART2接收数据，与管脚复用表UART2_TXD不符，以哪个为准？
解答： 结论：以官方管脚复用表（管脚复用表/PIN脚定义）为准，网页中PIN94标注"UART2接收"与复用表"UART2_TXD"不一致时，管脚复用表是硬件设计的权威依据。
说明：UART收发功能管脚以管脚复用表中的UART2_TXD/UART2_RXD定义为准进行原理图设计，文档页面的个别文字标注错误不影响实际管脚功能。最新硬件资料统一以新版文档为准：https://docs.openluat.com/air8000/luatos/hardware/
9. 样机稳定运行3天后突然一直复位，重刷固件和脚本才正常，可能是什么原因？
解答： 结论：长时间稳定运行后突然反复复位，属运行期异常，必须依靠复位日志定位根因；重刷固件和脚本恢复正常，说明问题大概率出在脚本/固件匹配或升级流程上，而非硬件损坏。
可能原因与排查： 1. 设备若开启了FOTA远程升级，可能后台误触发下载了其他工程或不匹配的脚本/固件，导致脚本与底层固件不兼容而反复重启，应核对升级服务器上发布的工程、版本号和设备分组是否正确； 2. 用Luatools抓取复位时完整日志，查看复位原因（看门狗/异常/panic）及复位前最后执行的代码； 3. 排查脚本中是否存在内存泄漏、数组越界、死循环喂狗失败等问题； 4. 量产前做好固件与脚本版本绑定管理，避免错刷、误升级。
10. 代码下载到一半显示下载失败一般什么原因？
解答： 结论：代码下载到一半失败，原因与烧录失败一致，集中在USB连接不稳、工具缓存异常、固件型号不匹配三方面，按顺序排查即可。
排查步骤：
1. 删除Luatools目录下的_temp文件夹，重启Luatools后重试；
2. 更换带数据针脚的优质USB数据线、更换USB口（直连电脑主板），避免用HUB，排除供电不足导致中途断连；
3. 更新Luatools到最新版本，确认选择的固件与模组型号一致；
4. 改用强制下载模式：按住BOOT键再上电/插USB，检测到设备后松开BOOT再点下载；
5. 仍失败则用Luatools抓取下载过程的完整日志，根据报错定位。
11. 临时固件不能远程升级吗？正式版本固件不一样是不是升级不了？
解答： 结论：临时固件（测试/定制固件）不支持FOTA远程升级，只有正式发布版固件之间才能远程升级；且远程升级要求固件分区布局一致。
说明： 1. 临时固件主要用于本地验证，未纳入FOTA版本管理体系，无法通过远程差分/整包升级； 2. 正式版固件可以远程升级，但必须做好版本管理——升级包基于设备当前固件生成，新旧固件分区（脚本区/文件系统区大小等）必须一致，否则校验不通过； 3. 跨大版本或分区不同的固件，需本地用Luatools烧录完整固件包，不能走远程差分。FOTA原理可参考：https://docs.openluat.com/luatos_lesson/009_luatos_fota/
12. 固件版本不一样会进行IOT升级吗？直接跨底层号差分升级会怎样？
解答： 结论：IOT远程升级必须在分区布局一致的固件之间进行；直接跨底层版本号做差分升级，会因分区地图不匹配导致升级失败甚至设备死机，禁止这样操作。
原理：FOTA差分包是对比新旧两个.soc固件生成的，.soc包内info.json记录了固件编号和分区地址，升级时会做分区对齐与MD5/签名校验。不同底层版本的脚本区、文件系统区大小等分区布局可能不同，差分包无法与现有固件正确合并。
建议： 1. 同一系列、分区一致的正式版固件之间可正常差分升级； 2. 跨底层大版本或分区变更时，改用整包升级，或本地用Luatools烧录完整固件； 3. 发布前确认升级包对应的起始固件版本，避免误推。参考：https://docs.openluat.com/luatos_lesson/009_luatos_fota/
13. 不知道出厂烧录的具体底层固件号，还能远程升级吗？
解答： 结论：远程升级依赖设备当前固件的具体版本号（分区编号）来生成匹配的升级包；若不清楚出厂烧录的底层固件号，则无法保证差分包与设备匹配，不建议盲目远程升级。
处理建议： 1. IOT平台通常只能看到大版本号，无法区分同版本下不同分区/编号固件； 2. 可取一台同批次设备，用Luatools连接查看开机日志中打印的完整固件版本号（如LuatOS-SoC_Vxxxx_型号_编号），据此确定固件基线； 3. 确认基线后，在FOTA平台基于该版本制作升级包；若版本无法确认，优先让设备本地烧录已知版本的完整固件，纳入版本管理后再走远程升级。
14. 780EPM用什么固件？支持AT指令吗？
解答： 结论：Air780EPM使用LuatOS固件（LuatOS二次开发），不支持AT指令开发；固件在官方固件页按型号选择下载。
说明： 1. Air780EPM是LuatOS脚本开发模组，需下载LuatOS-SoC固件并用Lua脚本开发，固件列表见：https://docs.openluat.com/air780epm/luatos/firmware/780epm_version/ 2. 若项目必须用AT指令开发，应选用AT型号模组，如Air780EHT、Air780EPT、Air780EX2等； 3. 选型时按开发方式（AT / LuatOS）区分，详见选型指南：https://docs.openluat.com/SelectionGuide/SelectionGuide/
15. Air780EVT与Air780EPM引脚完全兼容吗？能否直接替换？
解答： 结论：二者不能直接替换。Air780EVT是AT指令固件型号，Air780EPM是LuatOS二次开发型号，软件开发方式不同，且部分管脚定义存在差异，替换需修改软硬件。
说明： 1. 软件上：AT指令工程与LuatOS Lua脚本工程不通用，替换后需按目标型号重新开发； 2. 硬件上：虽然同为Air780E系列封装，但个别管脚功能/复用不同，设计前必须对照管脚定义核对； 3. 各型号管脚差异与系列对比见：https://docs.openluat.com/air780epm/product/air780exx/
16. Air780EPM能直接用Air780E的Lua脚本吗？
解答： 结论：大部分LuatOS API和脚本逻辑可直接复用，但不能保证完全无感移植——涉及管脚号、外设复用的部分需要对照Air780EPM管脚定义修改。
操作要点： 1. 同属Air780E系列，常用库（gpio、uart、i2c、spi、mqtt、mobile等）接口一致，业务逻辑基本可沿用； 2. 重点检查gpio.setup/uart.setup等传入的管脚号、复用功能是否与Air780EPM管脚定义一致，SIM、LCD、键盘等复用管脚差异需逐一核对； 3. 移植后先跑对应外设demo验证，再合入业务代码。管脚定义见：https://docs.openluat.com/air780epm/product/air780exx/
17. Air780E停产了吗？有没有不改电路不改脚本直接替换的型号？
解答： 结论：Air780E处于正常供货状态，可继续使用；但新项目推荐选用升级型号Air780EPM。
说明： 1. Air780E正常供货，存量项目可继续采购使用； 2. 新项目建议使用Air780EPM（资源更新、固件持续维护）； 3. 二者同系列封装相近，但开发方式与部分管脚有差异，从Air780E迁移到Air780EPM时需对照管脚定义核对硬件并调整脚本中的管脚配置。选型参考：https://docs.openluat.com/SelectionGuide/SelectionGuide/
18. Air780EHM固件能不能用在Air780EHU上？
解答： 结论：不能通用。Air780EHU与Air780EHM硬件兼容，但二者使用各自独立的内核固件，Air780EHM固件不能刷到Air780EHU上，必须下载对应型号的固件。
说明：不同型号即使管脚兼容，底层内核固件也按型号分别发布，刷错固件可能导致功能异常或无法启动。烧录前在Luatools中选择与模组丝印型号完全一致的固件。
19. Air780EHU的LuatOS固件该下载哪个？
解答： 结论：Air780EHU需下载型号对应的Air780EHU专用LuatOS固件，按功能需求（如是否需要TTS/音频、定位等）选择对应编号固件。
操作要点： 1. 在官方固件页选择Air780EHU型号固件（固件按功能分编号，如1号/2号等，页面有各编号支持的核心库列表）； 2. 参考固件版本说明页确认各编号功能差异后下载； 3. iRTU免开发固件也有Air780EHU独立版本，见iRTU固件页：https://docs.openluat.com/value/irtu/firmware/
20. Air780EPM低功耗时GPIO21会自动拉低吗？
解答： 结论：低功耗模式下GPIO21不会被系统"自动拉低"，其电平状态完全取决于进入低功耗前的配置；出现异常拉低多为管脚模式配置或唤醒脚配置问题。
原理与排查： 1. 进入低功耗/PSM+后所有GPIO不可再控制，WAKEUP/AGPIO可保持电平、输入和中断功能，普通IO状态由进入前的gpio.setup决定，必须在进低功耗前配置好； 2. 确认GPIO21是否被复用为WAKEUP唤醒脚（Air780EXX系列WAKEUP3对应GPIO20/21一带），若被配成唤醒/中断功能，其内外上下拉和电平会按唤醒配置保持； 3. 若外接外设要求休眠期间保持高电平，进低功耗前显式配置为输出高或设置合适的上下拉； 4. 对照官方低功耗demo（module/Air780EPM/demo/lowpower/）检查管脚配置。参考：https://docs.openluat.com/air780epm/luatos/app/lowpower/sleep/
21. 低功耗模式下出现规律电流波形（约30秒一次）是正常和基站通讯吗？
解答： 结论：正常。低功耗模式下模组仍保持4G在线长连接，约30秒一次的规律性电流脉冲，是模组与基站保持连接（寻呼/心跳/链路维持）所产生的收发电流，属正常现象。
说明：低功耗模式下4G处于在线长连接状态，协议栈需周期性与基站交互，因此会出现周期性电流波形；若进入PSM+模式则4G离线（飞行模式），电流更低但不再保持实时在线。功耗模式对比见：https://docs.openluat.com/air780epm/luatos/app/lowpower/sleep/
22. 单总线使用两个18B20切换时系统内存一直增长怎么办？
解答： 结论：内存持续增长是典型的资源未释放问题，多为切换传感器时反复创建zbuff/单总线对象却未正确释放，需对照官方多传感器demo规范写法。
处理建议： 1. 参考官方多DS18B20切换demo（module/Air780EPM/demo/onewire/onewire_multi_app.lua），其演示了同一条单总线分时复用两个18B20（含电源GPIO控制、引脚切换、复位检测）的完整正确写法； 2. 检查切换流程中是否每次都新建zbuff而未zbuff.release()，或onewire初始化/反初始化未成对调用，确保切换时释放上一次占用的缓冲区与总线； 3. 切换间隔满足DS18B20上电恢复时间（推荐≥100ms），避免异常重试导致资源堆积； 4. 用rtos.meminfo("lua")周期性打印Lua内存确认泄漏点，仍无法定位时提供最小复现工程分析。
23. fatfs.getfree获取TF卡扇区信息有时要等一分钟，期间所有进程停止，是什么原因？
解答： 结论：fatfs.getfree()偶发耗时长达一分钟并阻塞其他任务，是文件系统在扫描/整理TF卡FAT表（元数据扇区）所致，与TF卡本身文件系统状态和卡片质量有关；该接口为同步阻塞调用，期间无法调度其他任务。
原因与处理： 1. 当卡内文件碎片多、FAT表较大或卡片读写速度慢时，统计空闲簇需要遍历较多元数据扇区，耗时明显增加；在电脑上重新格式化后不复现，正说明与卡片文件系统状态相关； 2. 建议：在电脑/模组上对TF卡做格式化（FAT32），减少碎片；选用正规高速TF卡； 3. 避免在关键实时任务中频繁调用fatfs.getfree()，改为低频调用（如开机或需要时调用一次），或在独立任务中调用并接受其偶发耗时； 4. TF卡挂载与使用可参考官方demo（module/Air8201/demo/tf_card/tfcard_app.lua）。
24. 设备升级V20后WiFi DHCP不下发IP、无法联网，如何处理？
解答： 结论：升级V20后WiFi无法DHCP获取IP、连不上网，优先排查WiFi模组与主控之间SPI0接口的焊接质量，连锡/虚焊会导致通信异常。
排查步骤： 1. 重点检查模组焊盘底部SPI0相关管脚是否有连锡、虚焊、漏焊，补焊或重新植球验证； 2. 抓取开机日志确认WiFi固件版本是否为V20、WiFi芯片是否初始化成功、SPI通信有无报错； 3. 确认WiFi名称密码正确、路由器DHCP已开启； 4. 对照官方WiFi使用与升级教程核对固件和脚本版本：https://docs.openluat.com/air8000/luatos/app/base1/wifi/
25. Air8000的WiFi固件包哪里下载？升级时网页无法访问、404怎么办？
解答： 结论：Air8000的WiFi固件需通过官方WiFi升级教程下载和烧录；若页面404/无法访问，是链接路径变更，应从Air8000文档中心的WiFi应用目录进入最新页面。
操作要点： 1. WiFi固件升级完整教程（含固件包获取、升级脚本、验证方法）见fota方式升级WiFi文档：https://docs.openluat.com/air8000/luatos/app/wifi/fota_wifi/ 2. WiFi基础使用教程：https://docs.openluat.com/air8000/luatos/app/base1/wifi/ 3. 若旧链接404，访问Air8000文档首页 https://docs.openluat.com/air8000/ 在"应用-WiFi"目录下找最新页面，勿使用已失效的历史链接。
26. Air8000升级WiFi固件后WIFI_FW版本不变化是什么原因？
解答： 结论：升级后日志中WIFI_FW版本号不变化，说明WiFi固件实际未升级成功，需从升级流程执行、版本验证和固件包三方面排查。
排查步骤：
1. 验证方式：设备重启后查看开机日志中打印的WiFi固件版本号，只有升级真正完成并重启后版本才会更新（参考升级文档"升级结果验证"章节）；
2. 确认升级脚本已正确运行：日志中应能看到WiFi固件版本检查、下载、安装的完整过程，若中途报错（下载失败、校验失败、SPI写入失败）则不会更新，重点排查SPI0焊接与网络；
3. 确认使用的WiFi固件包为最新且与Air8000型号匹配，升级脚本中的固件路径/版本号正确；
4. 注意fota升级脚本验证通过后，量产环境建议注释掉require "check_wifi"，避免自动升级到未测试版本。参考：https://docs.openluat.com/air8000/luatos/app/wifi/fota_wifi/
27. 不用4G功能，可以屏蔽Air8000的4G射频吗？
解答： 结论：可以。调用mobile.flymode(0, true)让4G进入飞行模式即可关闭LTE射频，此时WiFi和蓝牙功能不受影响、可正常使用。
说明与要点： 1. mobile.flymode(index, enable)用于进出飞行模式，进入飞行模式只会关闭蜂窝（4G）射频，不会断开WiFi或以太网； 2. 注意固件版本差异：V2034以下固件没有第三个参数，按mobile.flymode(index, enable)使用；V2024及以下固件返回值含义与新版本不同； 3. 低功耗场景下也可在进入低功耗前开启飞行模式进一步降低功耗，参考低功耗demo（module/Air8000/demo/lowpower/）。API说明见：https://docs.openluat.com/osapi/core/mobile/
28. Air8000 PSE辐射超标怎么解决？
解答： 结论：PSE（辐射发射）超标需从电源噪声和射频辐射两方面做EMC整改，LuatOS没有提供调低4G发射功率的API，功率由协议栈按网络要求自动控制。
整改方向： 1. 电源噪声：DCDC开关频率及其倍频杂散、输出纹波、功率电感磁场泄漏是常见辐射源。优化电源Layout、电感加屏蔽、输入输出加滤波电容； 2. 可在电源线上靠近板子电源入口处套磁环（绕制多匝）测试，对抑制共模辐射常有明显效果； 3. 射频部分：保证4G/WiFi天线匹配与走线、天线远离干扰源、必要时加屏蔽罩； 4. EMC整改需结合实测频谱定位超标频点后针对性处理，建议联系合宙技术支持或参考硬件设计指南。
29. Air8101B烧录固件和脚本一直下载失败，删除_temp也不行，是什么原因？
解答： 结论：一直下载失败先确认模组具体型号——Air8101与Air8101B固件不同（Air8101B核心板未对外公开发售），刷错型号固件会失败；再按标准流程排查。
排查步骤：
1. 更新Luatools到最新版本，删除_temp缓存后重试；
2. 核对板子丝印，确认是Air8101还是Air8101B，选择完全对应型号的固件；
3. 烧录时可尝试不勾选"清除KV/校准区"，避免误清校准数据；
4. 用强制下载模式：按住BOOT键再上电，识别后松开再下载；
5. 换USB数据线/USB口，抓下载日志进一步定位。
30. Air8101引擎主机测试WiFi连接时发生错误重启，是什么问题？
解答： 结论：WiFi连接时错误重启，基本是固件/demo与实际板型不匹配导致，必须使用与核心板版本和配件板对应的固件与demo。
处理步骤： 1. 确认核心板硬件版本（如核心板1.0）及所接配件板型号，下载并烧录对应型号、对应版本的固件； 2. 运行官方针对该配件板提供的demo验证WiFi，而非通用demo；核心板1.0可使用Air8101配件板demo：https://gitee.com/openLuat/LuatOS/tree/master/module/Air8101/demo/accessory_board/AirLCD_1020/airui 3. 抓取重启时完整日志，查看panic/内存/看门狗信息； 4. 若demo正常、自己工程异常，则对比demo的初始化顺序与内存配置排查应用代码。
31. Luatools 3.4版本下载不了，用3.1的可以，什么原因？
解答： 结论：Luatools 3.4下载异常而3.1正常，多为新版工具缓存或兼容性问题，可先用3.1完成烧录，同时按以下方式排查3.4。
处理建议：
1. 临时方案：继续使用3.1版本完成下载，不影响烧录结果；
2. 排查3.4：彻底删除3.4安装目录（含_temp缓存文件夹）后重新下载解压最新版，以管理员权限运行；
3. 检查电脑网络/代理/防火墙是否阻止3.4访问下载资源；
4. 若仍失败，用3.4抓取操作时的完整日志反馈给技术支持定位。
32. 更新过最新WiFi固件还是不能用，怎么排查？
解答： 结论：更新最新WiFi固件后仍不能用，按"确认版本→最小demo验证→抓日志"三步定位。
排查步骤： 1. 确认WiFi固件确实升级成功：重启后查看开机日志中WiFi固件版本号已更新到目标版本（如V20），未更新则先解决升级问题（见第26条）； 2. 烧录官方最简单的WiFi连接demo，只做连接路由器/获取IP，排除应用代码干扰，确认硬件链路是否正常； 3. 用Luatools抓取从上电到WiFi失败的完整日志，重点看WiFi芯片初始化、SPI通信、DHCP获取IP各环节的报错； 4. 日志若有SPI错误/芯片无响应，重点检查WiFi模组SPI0焊接。参考：https://docs.openluat.com/air8000/luatos/app/base1/wifi/
33. 正式产品上BOOT和RESET按钮是否可以取消？
解答： 结论：可以取消。BOOT和RESET按钮主要用于开发调试（强制进入下载模式、手动复位），正式量产产品不是必须焊接的器件。
说明与建议： 1. 正常上电即可自动开机运行，量产时可省去这两个按键以降本； 2. 但建议在PCB上保留BOOT/RESET相关测试点或预留焊盘，以便产线烧录和售后维护时能通过短接方式进入下载模式/复位； 3. 具体管脚和下载模式进入方式以对应型号硬件手册为准。
34. Air780EGP找不到型号相关信息，哪里可以获取？
解答： 结论：Air780EGP的型号资料可在合宙文档中心查询。Air780EGP属于Air780EXX系列（通信+GNSS定位二合一，内含GNSS与G-sensor），其LuatOS固件与硬件资料在文档中心对应目录下。
资料入口： 1. 文档中心首页 https://docs.openluat.com/ 按型号"Air780EGP"检索； 2. Air780EGP固件下载见：https://docs.openluat.com/air780egh/luatos/firmware/780egp_version/ 3. 注意：Air780EGP为LuatOS二次开发型号，出厂AT固件仅供工厂测试，正式使用需烧录LuatOS固件和脚本。
35. 合宙4G模块支持VPN拨号（L2TP）吗？
解答： 结论：合宙4G Cat.1模组（LuatOS固件）不支持L2TP等VPN拨号功能。
说明：现有LuatOS固件网络协议栈支持TCP/UDP、MQTT、HTTP(S)、SSL/TLS、Socket等常用物联网协议，但未集成L2TP/PPTP等VPN拨号客户端。如业务必须走VPN，建议在服务端/网关侧建立VPN隧道，模组通过普通TCP/MQTT接入网关，由网关转发至VPN内网。选型与功能以选型指南和固件支持列表为准：https://docs.openluat.com/SelectionGuide/SelectionGuide/
36. Air780E只能搜到4G网络吗？能否配置仅搜索LTE？
解答： 结论：Air780E属于4G Cat.1（LTE）模组，仅支持4G网络，不支持2G/3G，也无法搜出2G/3G制式。
说明： 1. Air780E是面向国内的全网通LTE Cat.1模组，支持移动/电信/联通三大运营商的4G网络； 2. 模组默认按LTE制式搜网注网，无需额外配置"仅搜索LTE"——硬件本身就只有LTE； 3. 若现场搜不到网，应排查SIM卡、频段覆盖、天线和信号，而非制式设置。频段与制式见模组产品页：https://docs.openluat.com/air780e/
37. Air780EPM低功耗时MQTT长连接10分钟唤醒一次耗电十几毫安，怎么降低？
解答： 结论：低功耗模式下保持MQTT长连接、每10分钟唤醒一次仍有十几毫安，主要耗电来自长连接维持和唤醒工作电流，可通过减少唤醒频率、改用PSM+短连接或优化服务器来降低。
优化方向： 1. 功耗模式选择：低功耗模式4G保持在线长连接，周期性与基站交互有基础电流；若业务允许，改用PSM+模式（4G离线、飞行模式）+ 每次唤醒建立短连接发数据，平均电流可大幅降低（仅开4G不连MQTT的低功耗场景可做到约1mA量级）； 2. 延长唤醒/上报周期（如10分钟改为更长），减少高频唤醒； 3. 服务器选择低延迟的合宙测试服务器 lbsmqtt.airm2m.com，缩短每次连接/收发的工作时间； 4. 唤醒后尽快完成收发并回到低功耗，避免长时间停留在常规模式； 5. 以官方低功耗demo（prj_1_mqtt_long等，module/Air780EPM/demo/lowpower/）实测电流做基准对比。参考：https://docs.openluat.com/air780epm/luatos/app/lowpower/sleep/
38. Air780EP芯片温度上升后电量计算不准，是什么原因？
解答： 结论：电量是通过ADC采集电池电压换算的，芯片/电池温度上升会改变电池放电曲线和ADC采样基准，导致温度高时电量估算偏差，属物理特性影响。
原因与建议： 1. 锂电池电压与剩余电量的对应关系随温度变化（高温/低温下放电平台电压不同），且模组温升会影响ADC采样精度，简单按电压线性换算电量必然在温度变化时出现偏差； 2. 用稳压电源（可调电源模拟固定电压）代替电池测试，可排除电池本身因素，确认是温度-电压换算问题还是采样问题； 3. 电量估算建议结合温度做补偿，或使用带库仑计/电量计芯片的方案；ADC接口可参考adc.open(adc.CH_VBAT)采集电池电压，详见adc库文档。
39. Air780EP带读卡器的屏幕一直黑屏是什么问题？
解答： 结论：合宙只提供Air780EP模组，带读卡器屏幕的整机为第三方厂商基于模组开发的产品，整机黑屏应优先联系整机厂商售后。
处理建议： 1. 区分责任边界：屏幕、读卡器、供电等整机外设由整机厂商设计集成，黑屏优先找整机售后； 2. 若需判断是否模组问题：给模组接USB，用Luatools抓取开机日志，看模组是否正常启动、有无反复复位或panic； 3. 模组日志正常则问题在整机外设/供电/屏幕驱动，模组异常（无日志/复位）再按模组方向排查供电、固件、焊接。
40. 使用双卡模组时SIM1（电信esim）无法注网，跑mobile demo再刷回自己项目就正常，为什么？
解答： 结论：这是切卡逻辑问题。跑官方mobile demo后正常，说明SIM卡本身和硬件没问题，问题在自己工程的选卡配置——不应使用mobile.simid(2)自适应模式，应明确指定mobile.simid(0)或mobile.simid(1)。
原因与要点： 1. mobile.simid(2)为自适应选卡模式，需固件版本≥V2022才支持，低版本会在sim0有卡时一直读sim0卡槽、无法自适应切换，导致SIM1（电信eSIM）注网异常； 2. 若固定使用某张卡，在代码开头明确设置mobile.simid(0)（卡槽1）或mobile.simid(1)（卡槽2）； 3. 注意切卡前若处于飞行模式需先退出飞行模式，否则会因底层自动进出飞行与实际状态冲突导致设置失败； 4. 建议参照官方双卡切换demo重构切卡逻辑：https://gitee.com/openLuat/LuatOS/blob/master/module/Air780EPM/demo/mobile/sim_switch_test.lua
41. 780EP支持双卡吗？SIM2一直上不了线怎么排查？
解答： 结论：780EP（Air780EPM系列）支持双卡，但为"双卡单待"——同一时间只使用一张卡，通过mobile.simid()切换；SIM2无法上线需从硬件管脚、选卡配置、固件版本三方面排查。
背景说明：模组SIM1为原生SIM卡接口；SIM2的数字信号由GPIO模拟（USIM2_RST/CLK/DAT与CAM/GPIO等管脚复用），电源共用SIM1的VDD_SIM。因此使用SIM2时，相关复用GPIO不能再作其他用途。
排查步骤： 1. 硬件：确认SIM2卡座焊接、SIM2_CLK(PIN62)/SIM2_DAT(PIN64)/SIM2_RST(PIN63)/VDD_SIM2(PIN65)接线正确，且这些复用管脚未被其他外设占用； 2. 选卡：代码中用mobile.simid(1)固定切到卡槽2测试；若用mobile.simid(2)自适应，固件必须≥V2022，否则无法自适应；切卡前确保不在飞行模式； 3. 订阅SIM_IND事件查看SIM卡状态（RDY正常/NORDY无卡），用mobile demo先验证SIM2能否识别注网； 4. 参照双卡切换demo：https://gitee.com/openLuat/LuatOS/blob/master/module/Air780EPM/demo/mobile/sim_switch_test.lua ，硬件管脚见：https://docs.openluat.com/air780epm/luatos/hardware/sim/
42. Air724UG透传固件怎么下载不到了？
解答： 结论：透传/iRTU固件配置服务现已改为免费获取，不再需要旧的付费/授权下载流程，按新平台免费流程操作即可。
操作要点： 1. iRTU/DTU配置服务已全面免费：新平台 iRTU.openLuat.com，老平台 DTU.openLuat.com； 2. 登录 iot.openluat.com，在"订单管理"中新建DTU订单、添加IMEI提交（费用0元），即可获取配置，订单页：https://iot.openluat.com/finance/order 3. 若添加IMEI提示异常，多为IMEI与DTU账号不在同一账号下，需先做设备归属，参考归属文档：https://docs.openluat.com/air780epm/product/attributioniot/ 4. 免费政策说明见：https://docs.openluat.com/value/irtu/free/
43. 新版iRTU可以用了吗？固件在哪里下载？
解答： 结论：新版iRTU已可使用，配置服务已全面免费开放；相关资料、配置文档和固件统一在iRTU文档中心获取。
资料入口： 1. iRTU功能状态与使用说明：https://docs.openluat.com/value/irtu/state/ 2. iRTU免开发固件（按型号下载，含Air780EHU等型号）：https://docs.openluat.com/value/irtu/firmware/ 3. 配置平台：新平台 iRTU.openLuat.com ，老平台 DTU.openLuat.com；配置服务免费说明见 https://docs.openluat.com/value/irtu/free/
44. DTU功能用Air780EX测试可以吗？为什么配置AT指令没反应？
解答： 结论：测试DTU功能必须使用Air780EX2，不能用Air780EX。两款是不同型号，底层固件不通用，刷错型号固件会导致AT指令无响应或功能异常。
处理建议： 1. 核对模组丝印型号，DTU/iRTU透传功能选用Air780EX2，并下载Air780EX2对应的固件； 2. Air780EX与Air780EX2底层固件不同，不能混用； 3. AT指令无反应时，先确认烧录的固件型号与模组一致、串口连接和波特率正确。型号选型参考：https://docs.openluat.com/SelectionGuide/SelectionGuide/
45. Air7810/其他型号的modem，RNDIS和PSM+低功耗功能是否所有固件都支持？
解答： 结论：RNDIS和PSM+等功能并非所有固件都默认支持，不同型号、不同编号固件开启的功能不同，必须以对应型号的官方"固件支持核心库列表"为准。
说明与建议： 1. 每个型号（如Air780EHU等）都有独立的内核固件，固件按编号（1号、2号……）区分功能，RNDIS、PSM+、音频、TTS等是否包含，需查该型号固件页的"固件支持核心库列表"； 2. Air780EHU等型号固件见固件版本页（按型号选择）：https://docs.openluat.com/air780epm/luatos/firmware/ 3. 需要某功能时，在固件列表中勾选支持该核心库的编号固件下载；若列表中没有，说明该固件未开放此功能，可联系技术支持确认。
46. Air1602必须有VRTC吗？晶振在哪里？
解答： 结论：若需要RTC在主电源断电后继续走时，VRTC管脚必须供电（通常接纽扣电池或备用电源）；不接VRTC时模块每次上电时间都会复位、无法保持。晶振位置以硬件手册和开发板原理图为准。
说明与建议： 1. VRTC是RTC域的供电脚，主电源存在时可由系统供电，掉电后需由VRTC外接备用电源维持RTC计时；不要求掉电走时的应用可不接，但时间不会在断电后保持； 2. RTC所需32.768kHz晶振的连接管脚/是否内置，请查阅Air1601/Air1602硬件手册与管脚复用表，并对照官方开发板原理图设计； 3. 硬件资料见Air160X开发板资料页（含硬件手册PDF、管脚复用表）：https://docs.openluat.com/air1601/product/shouce/
47. Air1601/1602支持I2S核心库吗？
解答： 结论：Air1601/Air1602不提供独立I2S总线核心库，音频功能直接使用内置DAC通过audio（音频）库实现即可，无需也无法按I2S外接Codec方式开发。
说明： 1. Air1601/Air1602音频走内置DAC通道，使用audio库进行播放/录音等操作； 2. 需要外接ES8311等I2S Codec的场景应选用支持I2S/音频Codec的型号（如Air780EHM/EHV等）； 3. 具体音频能力以Air1601固件支持列表和audio库文档为准：https://docs.openluat.com/air1601/luatos/firmware/1601_version/
48. 模组录音有办法降低功耗吗？低功耗模式能否录音？
解答： 结论：录音期间无法进入低功耗——录音需要主控、音频外设和内存全速工作，低功耗/PSM+模式下CPU降频或挂起，不能同时录音。录音功耗无法通过低功耗模式降低。
说明与建议： 1. 录音时主控须全速运行以实时采集和存储音频数据，这是功能本身决定的，没有"低功耗录音"模式； 2. 降低整体功耗的思路是缩短录音时长：需要录音时唤醒进入常规模式录音，录完立即进入低功耗/PSM+，用占空比控制平均电流； 3. 选用内置音频Codec、录音链路效率更高的型号，并优化采样率/码率以减少处理开销；音频开发参考audio库及对应demo。
49. Air8780V2电路图哪里能找到？
解答： 结论：Air8780（含Air8780V2）工业模组的电路图/原理图在官方文档中心"板载硬件电路说明"页提供，可直接下载PDF。
获取方式： 1. 访问Air8780硬件电路说明页：https://docs.openluat.com/air8780/luatos/hardware/module/circuit/ ，页面提供模组原理图PDF（如Air8780_V4版本原理图），并对SIM卡座、天线、音频（仅V版）、网络灯、USB-BOOT按键、电源等板载电路分节说明； 2. Air8780为内置全套外围电路的工业模组，硬件设计直接参考该原理图即可； 3. 产品资料汇总入口：https://docs.openluat.com/air8780/product/
50. Air8783 USB上网卡文档在哪里？
解答： 结论：Air8783（USB上网卡/工业模组）相关文档在合宙文档中心Air8783产品页汇总提供。
资料入口：https://docs.openluat.com/air8783/product/ 该页面包含产品简介、硬件设计、固件/demo、使用说明等资料；如需USB RNDIS/ECM拨号上网相关功能，可在该页及LuatOS固件支持列表中确认对应固件是否开启USB网卡功能。
51. 如何把合宙模组归属/绑定到指定账号？
解答： 结论：把模组归属/绑定到指定账号（如IOT平台、DTU/iRTU配置账号），按官方"设备归属"文档操作即可。
操作要点： 1. 归属操作完整流程见文档：https://docs.openluat.com/air780epm/product/attributioniot/ 2. 典型场景：在iot.openluat.com新建DTU订单添加IMEI时若提示异常，通常是该IMEI设备归属在其他账号下，需按文档先完成归属转移/绑定，再添加设备； 3. 归属需用到模组IMEI等信息，按文档在对应平台提交绑定申请。
52. iot.openluat.com新建订单添加IMEI时点击项目显示无结果怎么办？
解答： 结论：新建订单添加IMEI时点击"项目"显示无结果，是因为当前账号下还没有可用项目，需先创建项目再回来添加设备。
操作步骤： 1. 先登录IOT平台，在项目管理页新建项目：https://iot.openluat.com/lbs/project-list 2. 新建项目后，再进入订单管理新建订单、添加设备序列号（IMEI），此时"项目"下拉即可选择刚创建的项目； 3. 若添加IMEI仍提示异常，检查设备是否已归属到本账号（参见设备归属文档：https://docs.openluat.com/air780epm/product/attributioniot/ ）。