常见问题 - 2026-07-31
数据日期：2026-07-31
1. 8201G烧录不进去，哪里按boot键？
解答： 8201G进入烧录模式需要按住板上的BOOT键再上电（或上电瞬间按下BOOT键），使模组进入USB下载模式，随后在Luatools中选择固件与脚本下载。操作步骤、按键位置及烧录演示视频可参考官方快速上手文档：https://docs.openluat.com/air8201/hardware/8201G_guide/ 。若仍无法识别，可更换USB线/USB口或使用带外部供电的Hub后重试。
2. 8201G的pin108（1pps）能软件关闭吗？
解答： 不能。pin108的1PPS秒脉冲信号由GNSS模块定位授时后由硬件直接输出，LuatOS固件未提供关闭该输出的软件接口。若应用中不使用该信号，将该引脚悬空不连接即可，不影响模组正常工作；注意不要将该引脚与其他复用功能引脚冲突使用。
3. 128G TF卡读出来磁盘状态不对，是不支持128G吗？
解答： 支持128G大容量TF卡。LuatOS的fatfs文件系统基于FAT32/exFAT格式挂载大容量卡，磁盘状态异常通常是卡的兼容性或固件版本问题：①优先使用主流品牌（闪迪、金士顿、三星等）正规卡，杂牌/盗版卡容易出现识别失败或容量异常；②使用最新固件与官方tf_card demo验证；③用电脑将卡格式化为FAT32（或单分区exFAT）后再挂载。官方demo参考：https://gitee.com/openLuat/LuatOS/tree/master/module/Air8000/demo/tf_card 。飞线环境建议SPI时钟不超过10MHz，自行画板可提高至约24MHz。
4. 700ECP做tcpserver只能连接单个TCPCLIENT么？
解答： 是的，当前固件下一个TCP server对象同一时刻仅支持一路client连接，这在官方socket server demo中有明确注释。需要支持多个客户端时，可为每个客户端分别创建server socket对象（或在独立任务中管理多路监听/连接）；UDP协议本身无连接，一个UDP socket可与多个对端收发数据。官方server demo参考：https://gitee.com/openLuat/LuatOS/tree/master/module/Air8201/demo/socket 。
5. 8700H估计什么时候会有？需要大一点的内存。
解答： Air8700H已量产上市，可直接在合宙官方淘宝店（https://luat.taobao.com/ ）选购。Air8700H对应Air700ECH规格，内置8MB Flash，仅支持移动网络，适合需要更大内存资源的应用；选型与规格对比可参考合宙产品选型指南：https://docs.openluat.com/SelectionGuide/SelectionGuide/ 。
6. 780EPM的SIM2和780E的SIM2有区别吗？电信卡在SIM2上不了网。
解答： SIM2的使用方式与780E一致，均为GPIO4/5/6模拟的SIM接口，供电与SIM1共用，使用前需调用mobile.simid(1)切换到SIM2，并注意GPIO23（Vref）上拉。电信卡在SIM2无法上网时按以下顺序排查：①确认SIM1下同一张卡可正常上网，以排除卡欠费/未开通问题；②调用mobile.simid(1)后查看mobile.iccid()能否读到卡号，读不到则检查SIM2卡座焊接与VDD_SIM波形（开机时会输出约4次1.8V/3.3V交替检测脉冲，无电是检测失败的结果而非原因）；③能读到卡但注网失败，需与运营商确认该卡的APN参数及当地电信Cat.1频段覆盖情况。硬件说明参考：https://docs.openluat.com/air780epm/luatos/hardware/sim/ 。
7. 烧录demo第一次连不上，重启完可以连上，是什么原因？
解答： 这是典型的开机后网络尚未就绪就发起连接导致的现象。模组上电后需要依次完成SIM卡检测、搜网注网、PDP激活获取IP，整个过程可能需要数秒到数十秒，若demo在获取IP前就发起socket连接必然失败；重启时网络已驻留，因此能连上。正确做法是在业务任务中先等待IP_READY消息再发起连接，例如使用libnet.waitLink(taskName, timeout, ...)或sys.waitUntil("IP_READY", 超时)，并在连接失败时加重试逻辑，而不是依赖手动重启。
8. 用demo烧录也是连不上，重启一次就能连上，是不是APN设置的缘故？
解答： 与APN关系不大，主要原因仍是首次开机注网耗时长、demo未等待网络就绪就发起连接（参见上条）。APN异常的典型表现是一直无法获取IP或重启后也无法上网，而不是“重启即好”。若使用的是专网卡/物联网卡，则需额外确认：①该卡是否在专网白名单内、是否定向APN；②必要时通过mobile.apn设置专用APN或使用AT+CPNETAPN配置后再激活。排查时先抓日志确认SIM卡状态、注网状态和IP获取情况，再判断是否为APN问题。SIM卡硬件与网络排查参考：https://docs.openluat.com/air780epm/luatos/hardware/sim/ 。
9. tcp server一对多最多可以几个客户端连接？
解答： 需要更正：当前固件下一个TCP server对象同一时刻仅支持一路client连接（官方socket server demo中明确注释“一个tcp server仅支持一路client连接”），并非31个。需要多路客户端接入时，应为每个客户端分别建立server socket并在各自任务中处理；UDP无连接限制，一个UDP socket可同时与多个对端通信。官方demo参考：https://gitee.com/openLuat/LuatOS/tree/master/module/Air8201/demo/socket 。
10. 同一个SPI接口挂载多个设备时，后续挂载设备SPI初始化波特率不一致时，需要进行日志提醒？
解答： SPI总线共享同一组CLK时钟引脚，同一总线上的所有设备必须按统一波特率工作——后初始化设备的时钟配置会改变总线时钟，导致先挂设备以超出其额定范围的时钟通信而出错。当前固件不会对波特率不一致输出告警日志，需要开发者自行保证同一SPI总线上各设备初始化时传入相同的时钟频率，并按各设备支持的最低时钟取值。代码评审时应将“同一SPI总线设备时钟一致”作为检查项；相关需求可向官方反馈。
11. 双网口使用exnetif管理，初始化SPI方式是spi.setup，little_flash初始化方式是spi.deviceSetup，这两种方式一起用会不会冲突？
解答： 不会冲突。spi.setup是旧式全局配置接口，spi.deviceSetup是新式设备化接口（自动管理片选，返回spi device对象），两者可以在同一总线上配合使用。注意两点：①同一总线上两处初始化的波特率必须设置一致（设备化接口最终按实际配置的时钟驱动总线）；②共用总线时设备数量增多、片选切换频繁，整体访问速率会变慢，属正常现象。新设计建议统一使用spi.deviceSetup方式。SPI接口说明参考：https://docs.openluat.com/osapi/core/spi/ 。
12. 8000W挂载nand_flash V2046 114号固件应该没问题吧，需要用临时固件吗？
解答： V2046版本固件已支持通过lf（little_flash）库挂载SPI NAND Flash，不需要临时固件。挂载流程为：先spi.deviceSetup创建SPI设备，再lf.init初始化、lf.mount挂载（NAND与NOR均支持，首次使用若挂载失败可重试一次）。另外需要确认文件系统相关配置（tfs）已正确开启，否则可能出现存储查询缓慢等问题。官方NAND挂载demo参考：https://gitee.com/openLuat/LuatOS/tree/master/module/Air8201/demo/accessory_board/AirSPINAND_1000 。
13. 开机第一次WIFI扫描必定失败，第二次就成功，有什么解决方法吗？
解答： 这是WiFi扫描的异步时序特性导致，并非不可解决的硬件缺陷。wlan.scan()是异步接口，调用后扫描在后台进行，扫描完成才会上报WLAN_SCAN_DONE消息；开机后WiFi协议栈刚初始化完成时立即发起第一次扫描，可能因底层未就绪而失败，第二次扫描时栈已稳定所以成功。解决方法：①开机后延时数百毫秒或等待WiFi初始化完成消息后再发起扫描；②收到扫描失败/超时后自动重试1~2次，以重试成功为准；③不要在有大量网络数据交换的同时扫描。WiFi接口说明参考：https://docs.openluat.com/osapi/core/wlan/ 。
14. GNSS有报文但没PPS信号这种情况正常吗？
解答： 分两种情况：①开机初期正常——GNSS能输出NMEA报文不代表已完成有效定位，1PPS秒脉冲必须在完成有效定位授时（报文中定位有效标志位有效、时间同步完成）后才会稳定输出；②长时间（室外开阔环境下冷启动超过数分钟）仍无PPS则异常，需检查：天线是否接好、天线供电是否正常、是否处于室内/遮挡环境（需室外开阔天空）、固件版本是否最新。建议先在室外开阔地实测，对比NMEA报文中的定位状态字段确认定位有效性后再判断PPS是否异常。
15. 使用tft彩屏必须在OTA之前取消airui的init才能OTA成功，否则就会死机，释放了内存但没法用，为什么？
解答： 原因是RAM资源竞争：airui/彩屏显示初始化后会持续占用framebuffer显存和图形缓冲（大块连续RAM），而FOTA升级需要在RAM中缓冲下载的升级包并做校验，二者同时存在时内存不足导致升级过程异常重启。另外注意产品支持矩阵：Air780EPM、EGP等型号不支持airui，彩屏应用建议使用支持UI的型号（如Air780EHV）。推荐做法：①升级前先调用显示反初始化接口（关闭刷新、释放framebuffer缓冲）再发起fota，升级重启后重新初始化显示；②或采用fota.file文件方式，将升级包写入Flash文件而非全部缓存于RAM，降低峰值内存占用。FOTA流程参考：https://docs.openluat.com/air8000/luatos/app/ota/fota/ 。
16. Air8000的ADC分压电阻推荐用MΩ级别的吗？
解答： 不推荐MΩ级。ADC输入引脚存在输入漏电流和采样保持电容，MΩ级分压电阻阻抗过高，采样瞬间信号源无法及时给采样电容充电，会导致读数偏低甚至测不到电压。分压电阻应选KΩ级别（如几十KΩ），保证信号源内阻远小于ADC输入阻抗，采集值才准确。Air8000使用AUXADC，量程分0~1.5V（RANGE_MIN）和0~3.3V（RANGE_MAX），需在adc.open前通过adc.setRange设置量程，推荐使用adc.get读取（返回mV值）。ADC使用说明参考：https://docs.openluat.com/air8000/luatos/hardware/adc/ 。
17. 合宙云平台（合宙iRTU后台管理平台）允许API接口调用吗？
解答： 允许。合宙AirCloud（合宙云）提供标准化的开放数据接口，第三方服务器/后台可通过API查询设备上报数据、下发指令等，无需依赖网页后台手工操作。接口协议与调用方式参考开放平台文档：https://docs.openluat.com/protocols/aircloud/ 。
18. Air780EGP需要用软件控制机器的开关，有对应接口协议文档吗？
解答： 可通过GPIO输出电平控制外部继电器/MOS管来实现机器电源的通断。使用gpio.setup配置引脚为输出模式，gpio.set输出高低电平即可；注意模组GPIO驱动能力有限，不能直接驱动大电流负载，需经三极管/MOS管/继电器隔离驱动。GPIO驱动说明参考：https://docs.openluat.com/air780egh/luatos/app/driver/gpio/ 。
19. Air8781在配置的时候开启了GPIO配置就会不断重启，关闭了这个配置就不会，是什么原因？
解答： 原因是网络指示灯引脚配置不完整：配置中NETLED和NETRDY两个指示灯引脚需要同时配置（或同时留空），只配置其中一个时，底层初始化另一个引脚会取到非法值导致异常重启。请在配置界面将NETLED和NETRDY两项都填写为实际使用的GPIO引脚（不使用指示灯则两项都留空），保存后重新烧录即可。
20. fota2不能升级，升级链接放浏览器显示请求过于频繁。
解答： 这是FOTA升级的限频机制：同一设备10分钟内不允许重复发起升级请求，浏览器直接访问升级链接也会占用请求次数。处理方法：①等待10分钟后再触发升级，调试期间不要反复请求；②确认升级链接、固件文件名与版本号（IoT平台VERSION需为xxx.yyy.zzz形式）配置正确；③通过fota回调ret值定位错误：0成功、1连接失败、2 URL错误、3服务器断开、4报文错误、5版本格式错误。FOTA说明参考：https://docs.openluat.com/air8000/luatos/app/ota/fota/ 。
21. Air780EGP出厂固件在哪里下载？
解答： Air780EGP是LuatOS二次开发型号，不支持AT固件——出厂预置的AT程序仅为工厂产测使用，正式应用必须烧录LuatOS固件和用户脚本。LuatOS固件下载地址：https://docs.openluat.com/air780egh/luatos/firmware/780egp_version/ 。
22. 用合宙模块是不是一定得和合宙绑定，能用自己的物联卡吗？
解答： 不绑定。合宙模组不锁卡、不强制接入合宙平台，可以使用任意运营商的物联网卡（移动/联通/电信），也可以连接自建服务器。专网卡/定向卡需按卡商要求配置APN并确认专网白名单。
23. 想本地录一段猫狗的叫声上传到云端，可以吗？
解答： 可以。使用带音频功能的型号（如Air780EHV），通过音频接口外接麦克风/喇叭即可实现本地录音，录音文件可通过HTTP/socket上传到自己的服务器或云平台。多媒体音频开发文档：https://docs.openluat.com/air780ehv/luatos/app/multimedia/audio/ 。
24. 想要WiFi和蓝牙的功能，能用一个ESP32S3录制，再通过合宙的4G模块上传吗？
解答： 双MCU方案可行，但更推荐单芯片方案：Air8000W同时集成WiFi、蓝牙和4G蜂窝通信，LuatOS脚本即可统一控制，省去双MCU之间的串口通信开发与硬件成本。产品说明参考：https://docs.openluat.com/air8000/product/notice/ 。若沿用ESP32-S3采集+4G模组上传的架构，两端通过UART透传数据即可。
25. Air780EGT AT指令的模组，按图操作发送指令①②正常，发指令③④没有任何回复，可能是什么原因？
解答： 前两条有回复说明串口物理连接和波特率正常，后续指令无回复通常是指令时序或前置条件问题：①AT指令必须逐条发送，等待上一条返回OK后再发下一条，连续发送会导致后续指令丢失；②③④指令若涉及网络/SIM操作（如注网、激活PDP、联网），必须等SIM卡就绪、搜网注网完成后再发，开机后立即发送会无响应或报错，建议每条指令后等待并解析返回，必要时查询CSQ/CREG/CGREG状态；③检查③④指令的参数格式是否符合AT手册（字符串参数引号、逗号分隔）；④确认串口工具未开启自动追加错误字符。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 。
26. 做透传用哪个模组比较简单？
解答： 追求最简单可选用免开发透传方案（如Air8782P等透传型号）：无需编写任何AT指令或代码，通过串口工具或网页配置好目标服务器地址和端口后，串口数据与服务器数据直接双向转发。若需要一定自定义逻辑，Cat.1 AT模组配合AT指令建链透传也很简单。选型对比可参考产品选型指南：https://docs.openluat.com/SelectionGuide/SelectionGuide/ 。
27. 用手机小程序控制单片机，是不是还要用到服务器做中转？
解答： 是的。手机小程序运行在公网，单片机/4G模组通常在内网，双方无法直接寻址，需要一台公网服务器做中转：模组与服务器保持长连接，小程序通过服务器API下发指令、服务器转发给设备，设备数据经服务器回传小程序。服务器可选用阿里云、腾讯云等公有云，按带宽和价格选择即可。
28. AT+CFG="urcdelay",500这个指令在780EHT生效吗？
解答： 以对应型号AT指令手册为准：手册中收录该指令则支持，未收录则该固件版本不支持。Air780EHT等型号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 。
29. 定位模块烧完固件在哪里看定位？APP、小程序？
解答： 定位数据需要由你的应用服务器接收解析：模组通过GNSS获取经纬度后经4G/WiFi上报到你的服务器，在服务端后台或自行开发的APP/小程序中展示；也可以直接使用合宙官方服务器/示例平台查看。目前配套以开发文档为主。GNSS开发可参考LuatOS定位教程：https://docs.openluat.com/luatos_lesson/010_luatos_GNSS1/ 。
30. 定位推荐哪个开发板？
解答： 推荐Air8201系列开发板，集成GNSS定位与4G通信，官方提供完整开发文档和演示视频：https://docs.openluat.com/air8201/ 。
31. 模组能不能支持通话功能？电话功能。
解答： 可以，推荐Air780EHV：支持4G语音通话和SIP网络电话，配合音频外设（麦克风、喇叭）即可实现电话功能。产品介绍：https://docs.openluat.com/air780ehv/product/ 。
32. 摄像头支持AI算法吗？可以自动识别电动车之类的。
解答： 合宙模组侧摄像头仅负责图像采集与照片上传，模组本身不运行AI识别算法。电动车识别等AI分析需在服务器/云端平台侧完成：设备上传图片，云端调用AI算法识别后将结果回传。方案设计时按“端侧采集+云端识别”架构即可。
33. 模块的入网许可证有吗？
解答： 有，合宙在售模组均具备工信部入网许可证等合规资质，证书资料可在对应型号产品手册中查询。780系列参考：https://docs.openluat.com/air780epm/product/shouce/ ；8000系列参考：https://docs.openluat.com/air8000/product/shouce/ 。
34. 2000个Air780EPM模组，ADC采样读数整体偏高，是什么问题？
解答： 大批量模组读数整体偏高，批次硬件差异的可能性很低，通常是固件ADC校准问题——旧固件ADC增益/校准参数不完善会导致系统性偏高。建议先抽取2~3片模组刷入最新固件做对比验证：若最新固件读数恢复正常，安排批量升级即可。固件下载：https://docs.openluat.com/air780epm/luatos/firmware/780epm_version/ 。
35. 系统内存的历史最高一直增加，当前使用没有那么多，是什么原因？
解答： 历史最高内存占用只增不减是正常统计特性——它记录的是运行以来出现过的峰值，不会随内存释放而下降。但如果峰值持续单调上涨，则说明存在内存泄漏：代码中有申请的内存（如zbuff、string拼接、table、http响应体等）使用后未释放。排查方法：定期打印rtos.meminfo()观察used与max值，二分定位泄漏模块，检查大缓冲是否close/置nil、循环中是否有字符串不断拼接、回调中是否持续创建对象；可配合collectgarbage()回收Lua内存。内存监控示例参考：https://gitee.com/openLuat/LuatOS/tree/master/module/Air780EPM/demo/luatos_framework/luatos_task 。
36. 系统内存的used_lua、max_used_lua是什么关系？
解答： used_lua是Lua虚拟机当前实时占用的RAM（随分配/释放动态变化），max_used_lua是运行以来Lua内存占用的历史最高峰值（只增不减，模组重启后清零重新统计）。二者关系：used_lua ≤ max_used_lua恒成立。通过rtos.meminfo()可获取这三个返回值——总RAM大小、实时已用、历史最高；调用rtos.meminfo("sys")获取的是内核侧（sys域）RAM占用，zbuff等底层缓冲统计在该域。应用中周期性打印这几个值即可判断内存趋势：max_used持续抬高说明存在泄漏风险。
37. 780E能读SIM卡卡号，但读不到手机卡卡号，没有1.8V供电，怎么判断原因？
解答： 能读物联卡说明SIM接口硬件基本正常，手机卡读不到且VDD_SIM无电，说明SIM卡检测阶段失败：模组开机时会在SIM_VDD输出约两次（1.8V/3.3V交替）检测脉冲，卡握手失败后引脚拉低——“无1.8V供电”是检测失败的结果而非原因。排查方向：①换一张手机卡交叉验证，排除该卡氧化/损坏；②检查SIM卡座焊接是否虚焊、卡塞是否接触不良、SIM_IO/SIM_CLK/SIM_RST走线是否正常；③确认该手机卡未欠费且未设PIN锁。SIM硬件设计与排查完整说明参考：https://docs.openluat.com/air780epm/luatos/hardware/sim/ 。
38. 模组发送短信提交给运营商后，绑定关系会存多久？
解答： 这里涉及两个概念：①短信在短信中心（SMSC）的存储有效期——短信提交后若接收方关机/不在服务区，短信中心会在有效期内重试投递，超期丢弃。该有效期可通过sms.setVp(vp)设置（V2050及以上固件支持，vp为协议编码的有效期值），实际有效期同时受运营商短信中心上限约束；②设备与云平台的绑定关系保存在平台侧，与短信机制无关，长期有效，换绑/转移需在平台操作。短信接口说明参考：https://docs.openluat.com/osapi/core/sms/ 。
39. 以太网AirETH_1000能替换成air8101开发板配套的LAN8720吗？
解答： 不能直接替换，二者不是同一颗物料：AirETH_1000配件采用CH390H芯片，通过SPI接口与模组通信（netdrv.CH390驱动），适用于Air780E、Air8000、Air8101等多个系列；LAN8720是RMII接口的以太网PHY芯片，Air8101开发板通过RMII并行接口驱动，接线和底层驱动完全不同。新设计建议采用CH390 SPI方案，跨型号通用性好且官方驱动成熟。AirETH_1000配件说明：https://docs.openluat.com/accessory/AirETH_1000/ ；netdrv多路网卡demo参考：https://gitee.com/openLuat/LuatOS/tree/master/module/Air8201/demo/netdrv 。
40. EPM的最高工作温度是多少度？
解答： 具体工作温度范围以硬件手册电气参数章节为准（工业级/商业级温度等级不同）。Air780EPM硬件手册：https://docs.openluat.com/air780epm/product/file/Air780EPM%26Air780EHM%E7%A1%AC%E4%BB%B6%E6%89%8B%E5%86%8CV1.4.pdf 。
41. Air8000模拟SPI的速率是1M，速度是固定的吗？
解答： 前提需要更正：软件模拟SPI（spi.createSoft）的最高可用时钟约为100KHz级别，达不到1MHz，且速率不固定——软SPI时序由GPIO翻转模拟，实际速率随CPU负载、中断频率波动，总线负载越重速率越低。对速率有要求的外设（如LCD、高速Flash、以太网）必须使用硬件SPI，硬件SPI时钟最高可达25.6MHz且稳定。SPI接口说明参考：https://docs.openluat.com/osapi/core/spi/ 。
42. 软件SPI好像有点问题，transfer读取的是FF9D39，逻辑分析仪抓的数据是正确的，读到的不对。
解答： 逻辑分析仪抓波形正确但读取值错误，说明从机输出的波形正常，问题出在软SPI主机的采样时序上：软SPI用GPIO模拟，采样点受CPU中断/任务调度影响会抖动，速率偏高时采样窗口偏离数据有效区导致误码。排查与解决：①降低软SPI时钟（建议100KHz以内）验证；②核对SPI模式参数CPOL/CPHA组合（mode 0~3）与从机要求一致，位序bitdict（高位/低位先行）设置正确；③确认MISO引脚配置为输入且无上拉/下拉冲突；④根本解决方式是改用硬件SPI，硬件SPI有专用时钟控制器和采样电路，时序稳定可靠。SPI接口说明参考：https://docs.openluat.com/osapi/core/spi/ 。
43. air8000有没有接口获取系统启动至当前运行多少ms？
解答： 有。mcu.ticks()返回系统启动至今的毫秒数；需要更高精度可用mcu.tick64()返回微秒数（64位），配合mcu.hz()获取tick频率。接口文档：https://docs.openluat.com/osapi/core/mcu/#mcuticks 。
44. 怎么实现互斥锁或者调度器上锁，保护共享资源？
解答： LuatOS的Lua任务是基于协程的协作式调度，单个Lua任务内不会被其他任务抢占，因此：①临界区代码中只要不调用会让出CPU的阻塞接口（sys.wait、sys.waitUntil、socket收发等），对共享变量的读写天然是原子的，无需加锁；②需要跨任务保护或任务间同步时，使用消息机制sys.publish/sys.waitUntil（或sys.subscribe）传递状态，将共享资源收敛到单一任务内串行处理；③对硬件外设等资源，由初始化它的任务统一管理，其他任务通过消息发请求。这是LuatOS推荐的标准同步方式。框架与任务模型说明参考：https://docs.openluat.com/luatos_lesson/006_luatos_sys/ 。
45. 固件名称都对，但是OTA升级失败了，怎么查原因？
解答： 按fota回调ret值定位：0成功、1连接失败（检查URL拼写、服务器是否内网、网络是否通）、2 URL错误、3服务器断开、4接收报文错误（升级包损坏/信号差导致下载不完整）、5版本格式错误（IoT平台VERSION需为xxx.yyy.zzz形式）。排查步骤：①确认升级包与当前固件型号匹配、版本号高于现网版本；②浏览器直连升级URL验证可下载；③在信号良好环境测试，4G信号差会导致下载中断；④按官方FOTA文档的演示流程逐步验证。文档参考：https://docs.openluat.com/air8000/luatos/app/ota/fota/ 。
46. 设备账号迁移的时候卡住了有什么办法解决么？
解答： 账号/设备归属迁移需在平台侧按转移流程操作，页面卡住通常是网络或平台会话问题：刷新页面重试、确认操作账号对源设备和目标账号均有权限、按页面提示完成转移确认。设备归属转移的条件与操作步骤参考官方说明：https://docs.openluat.com/air780epm/product/attributioniot/ 。若按文档操作仍无法迁移，提供设备IMEI与操作时间联系官方技术支持核查后台状态。
47. 合宙的Air103/Air105芯片相关固件和资料怎么找不到了？
解答： Air103/Air105属于早期MCU产品，目前已不在主推产品线，官方不再持续维护与提供技术支持，相关资料已从主站下线。新项目建议选用当前主推的LuatOS型号（如Air780EPM、Air8000、Air8201等），生态资料、固件更新和技术支持均有保障；存量维护所需的历史资料可联系官方技术支持获取。选型参考：https://docs.openluat.com/SelectionGuide/SelectionGuide/ 。
48. 换一个电脑烧录就可以成功，为什么？
解答： 这基本可以确定是原电脑侧的问题，而非模组问题：①USB口供电能力不足（尤其前置USB口/笔记本口），烧录瞬态电流不够导致下载失败，换用带外部电源的USB Hub或主板后置USB口；②USB线为充电线（数据线芯缺失）或线损过大；③原电脑USB驱动异常或被其他软件占用端口。更换电脑/线材/Hab后即可正常烧录。
49. 4G模组怎么读取卡号？
解答： 通过mobile.iccid()读取SIM卡的ICCID（20位集成电路卡标识，即卡身上印的号码）；mobile.imsi()读取IMSI。注意手机号（MSISDN）通常不存储在SIM卡上，运营商网络一般也不开放读取，无法直接获取。接口文档：https://docs.openluat.com/osapi/core/mobile/#mobileiccidid 。
50. 模组能支持2G/3G通话功能吗？
解答： 当前合宙主推模组均为4G Cat.1制式，不支持2G/3G网络；国内2G/3G网络运营商也在逐步退网，新设计不建议依赖2G/3G。需要语音通话请选用支持4G语音/SIP的Air780EHV：https://docs.openluat.com/air780ehv/product/ 。
51. Air780EPM + CH390做自动切换时，不接网线时libnet.waitLink会一直阻塞？
解答： 原因是默认网卡选择逻辑：创建socket时默认绑定优先级最高的网卡（以太网），当以太网网线未接入、网卡未就绪时，即使4G网卡已就绪，libnet.waitLink仍按默认网卡等待，从而长时间阻塞。解决方法：①调用libnet.waitLink时传入超时时间（timeout参数），超时后按业务逻辑走4G链路；②通过exnetif.set_priority_order合理设置网卡优先级，或在socket创建时显式指定adapter；③结合网卡状态消息（exnetif.notify_status）动态切换。注意该接口只能在sys.taskInitEx创建的任务中使用。多路网卡demo参考：https://gitee.com/openLuat/LuatOS/tree/master/module/Air8201/demo/netdrv 。
52. 780EPM PWM0 PWM3 PWM4可以休眠之前设置成高阻模式吗？
解答： 可以。PWM使用完毕后调用pwm.close关闭输出，再通过gpio.setup将对应引脚重新配置为输入（高阻）状态，或使用pins.close释放引脚复用，即可在休眠前将引脚置为高阻，避免漏电。注意各引脚的PWM/GPIO复用关系以GPIO复用表为准：https://docs.openluat.com/air780egh/product/file/Air780EPM%26EHM%26EHV%26EGH%26EGG%26EGP%26EHN%26EHU%26EX2_GPIO%E5%A4%8D%E7%94%A8%E8%A1%A8_20260605.xlsx 。
53. 有没有支持屏的安卓模组？要在安卓里跑个应用。
解答： 合宙模组产品线为AT固件模组和LuatOS二次开发模组，没有运行安卓系统的模组。需要屏幕显示的应用可选用支持LCD/UI的LuatOS型号（如Air780EHV）用Lua开发界面；若业务必须运行安卓APK，建议采用安卓主板+合宙4G模组（通过AT/串口提供联网能力）的组合方案。
54. 模组可以支持全功能物理按键吗？哪一款？
解答： 各款模组均可通过GPIO外接物理按键实现，推荐Air780EPM配合官方AirKEY_1000按键配件：提供8个独立按键，支持GPIO中断检测，开箱即用。矩阵键盘需自行外挂并配置GPIO行列扫描。配件文档：https://docs.openluat.com/air780epm/luatos/app/accessory/AirKEY_1000/ 。
55. 矩阵按键+LCD显示方案用哪个？
解答： 推荐Air780EHV：带音频能力、支持LCD显示与UI开发，适合带屏带键盘的终端（如对讲/话机类产品）。矩阵键盘自行外挂后用GPIO行列扫描；音频开发参考：https://docs.openluat.com/air780ehv/luatos/app/multimedia/audio/ ；UI开发参考：https://docs.openluat.com/air780ehv/luatos/app/multimedia/ui/ ；产品介绍：https://docs.openluat.com/air780ehv/product/ 。
56. AIR780EGG核心板I2C1外接音频板后，内置G-SENSOR无法正常工作，怎么处理？
解答： 原因是I2C1总线资源冲突：EGG核心板内置G-Sensor挂在I2C1上（对应PIN66/67），而音频Codec（ES8311）在未供电状态下其I2C引脚呈下拉状态，挂到同一总线后会把I2C1时钟/数据线拉死，导致G-Sensor通信失败。两者不建议在I2C1上分时复用。解决方法：将外接音频板改挂到I2C0总线（EGG引出有I2C0），G-Sensor继续使用I2C1，两条总线互不影响。I2C硬件说明参考：https://docs.openluat.com/air780epm/luatos/hardware/i2c/ 。
57. 如果使用8Ω1W（最大输出）是否能匹配8201G？
解答： 8Ω 1W喇叭可以发声但不推荐长期满功率使用：1W额定功率小于模组音频通道的推荐驱动能力，大音量下容易失真、长时间工作有损坏风险。8201G官方推荐喇叭规格为8Ω 2W或4Ω 3W，按此规格选型音量和音质均有保证。
58. 795UG模块用于美国，DTU固件的网络灯常亮是什么状态？
解答： DTU固件有两个网络指示灯：①NETRDY（默认GPIO27）——连上服务器时常亮，未连上时熄灭；②NETLED（默认GPIO26）——未联网时100ms快闪，联网但未连上服务器时亮500ms灭500ms，连上服务器后亮200ms灭1800ms（慢闪）。若NETRDY常亮表示设备已正常连接到服务器。指示灯定义参考：https://docs.openluat.com/irtu/docs/gpio/ 。
59. air8000W作为AP能接多少个station？
解答： 最多支持4个station接入。AP通过wlan.createAP(ssid, passwd, gateway, netmask, channel, opts)创建。接口文档：https://docs.openluat.com/osapi/core/wlan/#412-wlancreateapssid-passwd-gateway-netmask-channel-opts 。
60. esim卡能读出来信息和号码，但获取不到信号，插手机上没问题。
解答： 能读卡说明SIM接口正常，无信号属注网/配置问题：①eSIM多为专网卡/定向卡，需向卡商确认APN参数，并在模组上配置对应APN（mobile.apn或AT+CPNETAPN）；②确认该卡已开通模组对应地区的频段/运营商权限（尤其海外卡需匹配模组支持的频段）；③确认卡未机卡绑定（部分eSIM与首次设备绑定）。SIM与网络排查参考：https://docs.openluat.com/air780epm/luatos/hardware/sim/ 。
61. AIR780EHV初始化之后不会执行下面的是我买的不对吗？
解答： 不是买错了。Air780EHV是LuatOS二次开发模组，出厂不带用户业务逻辑，必须烧录LuatOS固件和脚本后才会运行用户代码；仅上电不烧脚本时不会执行任何业务。请下载对应固件并烧录脚本：https://docs.openluat.com/air780ehv/luatos/ 。
62. 固件不知道为什么烧录不进去？
解答： 最常见原因是烧录时只选择了脚本、没有选择底层固件（Luatools中固件与脚本需分别勾选）。完整烧录步骤：①按住BOOT键后给模组上电（或上电瞬间按BOOT）进入下载模式；②USB连接电脑并在Luatools中识别到端口；③同时勾选正确的固件文件（.soc/.bin）和脚本文件；④点击下载，等待烧录完成后复位。若仍失败，更换USB线/USB口或使用带外部供电的Hub。烧录说明参考：https://docs.openluat.com/common/howtodown/ 。
63. air8000，100以上的引脚都不能用做片选角么？
解答： Air8000引脚号大于100的是WGPIO（WiFi侧扩展GPIO），与普通GPIO特性不同：低功耗/PSM状态下无中断能力，用作中断需固件版本≥2018且WiFi固件≥V18。用作SPI片选（CS）这类普通输出场景一般可行，但建议优先选用100以内的常规GPIO做片选以保证时序稳定和低功耗行为正常。GPIO说明参考：https://docs.openluat.com/air8000/luatos/hardware/gpio/ 。
64. 合宙的模块蓝牙、wifi、luat二次开发都能控制吗？
解答： 可以，在支持WiFi/蓝牙的型号（如Air8000W）上，WiFi、蓝牙和外设逻辑全部通过LuatOS脚本统一控制，无需另接MCU：wlan库管理WiFi连接/扫描/AP，bluetooth/ble库管理蓝牙，gpio/spi/i2c等库控制外设，均为Lua API。WiFi接口参考：https://docs.openluat.com/osapi/core/wlan/ ；产品说明参考：https://docs.openluat.com/air8000/product/notice/ 。
65. 8000的资料链接找不到？
解答： Air8000产品资料汇总入口（含硬件手册、固件、开发文档、demo链接）：https://docs.openluat.com/air8000/product/notice/ 。
66. 设置APN用AT+CSTT还是AT+CPNETAPN？能否直接用AT+CSTT=设置？
解答： 普通公网卡一般无需手动设置APN，模组自动获取即可；专网卡/定向卡推荐使用AT+CPNETAPN=mode,"apn","user","pwd",authmode配置专用APN（支持认证方式参数，专网卡场景兼容性更好），配置后重启或重新激活PDP生效。AT+CSTT是标准TCP/IP栈初始化指令，也可带APN参数，但专网卡鉴权场景建议用CPNETAPN。注意若返回CME 302错误，APN等字符串参数需加双引号。指令详情参考：https://docs.openluat.com/atmozu/product/command/dncard/ 。
67. SMB导线的屏蔽线需要接板子的地吗？
解答： 需要。同轴线/屏蔽线的屏蔽层必须可靠接到板子的地（单端接地，通常在连接器端），屏蔽层才能起到抗干扰作用；悬空不接会使屏蔽失效，射频/高速信号容易受干扰也容易对外辐射。
68. IOT平台转移不了？
解答： 设备归属转移需满足平台规定的转移条件并按流程操作（设备在线状态、源账号与目标账号权限、转移确认等）。具体条件和操作步骤参考：https://docs.openluat.com/air780epm/product/attributioniot/ 。
69. 8201的板子带着软排线，排线两头座子是相同序号的引脚连在一起吗？有没有交叉？
解答： 软排线为直通连接，两端座子相同序号的引脚一一对应，没有交叉。主板与调试板的原理图均在官网公开，可自行对照核对：https://docs.openluat.com/air8201/ 。
70. 对方未接听为什么还会先显示CC状态PLAY然后十多秒显示挂断？怎么判断对面没接听？
解答： PLAY状态表示通话音频通道已打开（正在播放回铃音“嘟——嘟——”声），并不代表对方已接听；对方真正接听后状态才会变为CONNECTED。对方未接听时，网络侧播放约十几秒回铃音后超时拆线，随后上报DISCONNECTED（DISCONNECTED在提示音播放结束后触发，所以有十余秒延迟）。判断对端是否接听应以CONNECTED状态为准：收到CONNECTED前的PLAY均为回铃阶段；可订阅cc的CC_IND消息并打印全部状态（READY/INCOMINGCALL/CONNECTED/DISCONNECTED/PLAY等）观察时序。通话状态说明参考：https://docs.openluat.com/osapi/core/cc/ 。
71. 模组不连合宙服务器可以用自己的物联卡吗？
解答： 可以。模组不强制接入合宙云平台，物联卡也不绑定合宙，使用自己的物联卡连接自建服务器完全不受影响。
72. LUA不会，有教程吗？
解答： 官方文档站提供完整的LuatOS系列教程，从Lua语法基础、LuatOS框架原理到外设驱动开发均有覆盖，零基础可按顺序学习：https://docs.openluat.com/luatos_lesson/001_luatos_framework/ （教程目录在文档站内可连续浏览）。
73. AIR780EPT支持双卡吗？
解答： 支持双卡单待（同一时刻使用一张卡，可通过指令切换）。切换方法及相关AT指令以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 。
74. 淘宝上买的8201天线信号差怎么办？
解答： 淘宝零售的多为通用测试天线，未针对具体产品外壳和结构做匹配调优，信号指标一般。量产产品建议联系天线厂家，提供整机外壳和结构，由天线厂定制匹配天线并做无源/有源调试。天线设计与调试指南参考：https://docs.openluat.com/air780egh/luatos/hardware/design/antenna/ 。
75. Air780EHV能支持2G/3G通话吗？
解答： 不支持。Air780EHV为4G Cat.1模组，仅支持4G语音通话和SIP网络电话，无2G/3G制式；当前合宙主推产品线也没有支持2G/3G通话的型号。4G通话方案参考：https://docs.openluat.com/air780ehv/product/ 。
76. AIR780EX、EX2、ER2这三个是不是pin2pin兼容的，把ex的模组吹掉换成ER2？
解答： 不能直接互换。三款并非全部pin2pin兼容：Air780EX2T的3.3V版本（EX2T-3.3V）可直接替代Air780EX的3.3V版本（EX-3.3V），封装引脚兼容；但Air780ER2属于AT固件型号且不是二次开发模组，硬件引脚定义与EX/EX2存在差异，不能直接吹换替代。替换前务必对照两款型号硬件手册的引脚定义逐一核对，并确认固件形态（LuatOS/AT）与业务匹配。
77. 用旧固件2005出现ADC采样偏高，是不是批次模组问题？
解答： 不是批次问题，是旧固件ADC校准不完善导致的系统性偏差。2005等早期固件的ADC增益校准参数有已知问题，升级到最新固件即可解决。建议先抽2片模组刷最新固件对比验证，确认后安排批量升级。固件下载：https://docs.openluat.com/air780epm/luatos/firmware/780epm_version/ 。
78. 为什么升级全部固件不起作用，提示设备不在升级设备列表中？
解答： 原因是升级平台上存在同名同版本的多个固件，服务器无法区分目标固件，设备匹配升级列表时失败。处理方法：在平台上删除重复的同名同版本固件，仅保留一个，再重新创建升级任务即可。FOTA升级说明参考：https://docs.openluat.com/air8000/luatos/app/ota/fota/ 。
79. Air780EPM HTTP/HTTPS传输二进制数据如何提速？测试数据上传速度有300K，自己程序只有30K不到。
解答： 模组为单核、不支持多线程并发，吞吐差距主要来自应用层实现：①避免小包频繁发送，攒大包（如一次数KB）再提交，减少每包协议栈开销和任务切换；②使用zbuff承载二进制数据做零拷贝传递，避免Lua字符串反复拼接/复制；③HTTP使用POST body流式写入，减少中间缓冲；④测试基准需在服务器带宽充足、4G信号良好（CSQ高、无弱网重传）的环境下取得，弱网下TCP重传会显著拉低速率；⑤HTTPS加解密开销大于HTTP，对速率敏感且链路可控的场景可评估HTTP。优化后速率应能接近官方测试水平。
80. 4G模组能驱动WS2812吗？
解答： 不能可靠驱动。WS2812采用单总线800KHz NRZ严格时序，每位数据高低电平宽度仅数百纳秒且要求不可打断，4G模组上无论GPIO模拟还是硬件外设都无法保证时序精度（中断/任务调度会插入抖动），数据会错乱。可改用时序宽松的灯珠：如WS2801为双线（时钟+数据）接口，时钟由主机控制、对时序无严格要求，可用GPIO纯Lua模拟驱动。
81. 780E系列的pin108（1pps）能软件关闭吗？
解答： 不能。pin108的1PPS秒脉冲由GNSS定位授时后硬件输出，固件未提供软件关闭接口。应用中不使用该信号时将引脚悬空即可，不影响其他功能，注意避免与该引脚的其他复用功能冲突。