常见问题 - 2026-08-18
数据日期：2026-08-18
1. 8201G模块用USB转串口连接下载固件能识别却失败是怎么回事？
解答： 板上引出的TX/RX是DBG_UART（调试串口，固定921600bps），仅用于输出底层运行日志，不具备固件烧录功能，所以Luatools能识别到串口但烧录必然失败。固件下载必须通过模组的USB焊盘（DM/DP/VBUS/GND）连接电脑，在Luatools中选择"4G模块USB打印/下载"进行烧录。补充说明：Cat.1模组中仅780EP/780EQ/700ECQ/780EPS/Air8201/780E支持串口烧录，且只能走MAIN_UART（UART1）、模块正常工作时才行，串口烧录不能救砖；救砖必须用USB+BOOT方式。工具教程：https://docs.openluat.com/common/Luatools/
2. 8201G板子外接电池需要什么规格的锂电池？
解答： Air8201G电池供电应接到BAT引脚，使用标称3.7V、充满电压约4.2V的常规聚合物锂电池（建议容量900mAh以上，容量仅决定续航）。模组板载充电管理电路，通过USB供电时可自动为电池充电。注意：调试板上的VBAT引脚仅为电压测量点，不能直接外接电源向模组供电；电池选型与接线以硬件设计文档为准。参考资料：https://docs.openluat.com/air8201/
3. GNSS配置了但不打印定位信息，一定要接天线且在室外才能有定位信息吗？
解答： 是的。GNSS（GPS/北斗）定位依赖直接接收卫星信号，必须满足两个前提：①正确连接GNSS天线并确保天线座子焊接/接触良好；②天线置于室外或靠窗等开阔无遮挡环境。原理：卫星信号到达地面时强度极弱（约-160dBm级别），室内、金属遮挡、天线未接时GNSS芯片无法锁定足够卫星，自然不会输出有效定位信息。调试时可先在室外开阔地冷启动等待数分钟，确认能输出经纬度后再安装；日志中若一直无GNVIG/GNRMC等定位语句，优先排查天线连接与安装位置。参考资料：https://docs.openluat.com/air8201/
4. VSCode现在是不是只装一个LuatOS扩展就够了？
解答： 是的，VSCode中只需在扩展市场搜索"LuatOS"并安装LuatOS官方扩展即可，它已集成代码提示、烧录、日志查看等开发所需功能，无需再安装其他第三方LuatOS相关插件。注意：Trae、Qoder、Cursor等IDE无法直接访问VSCode扩展市场时，需手动下载LuatOS扩展的.vsix安装包进行离线安装。参考资料：https://docs.openluat.com/osapi/markdown/vscode/
5. LUATOOLS 3.4.5运行弹出的资源管理界面没有8201G的资源怎么办？
解答： Air8201G是基于Air780EGH芯片（SoC）开发的定位模组，其底层固件、脚本API和软件资料与Air780EGH完全通用，因此在Luatools的资源管理界面中选择Air780EGH对应的固件/资源下载使用即可。烧录时选择"4G模块USB打印/下载"并按Air780EGH的流程操作。参考资料：https://docs.openluat.com/common/Luatools/
6. 请问780EHM的那个全部功能的代码在哪？
解答： Air780EHM没有单独的"全部功能"单一工程，官方按功能提供完整的demo集合，涵盖GPIO、UART、I2C、SPI、ADC、PM、mqtt、socket、fs、disp、wdt、audio等常用外设与网络功能，位于LuatOS代码仓库的module目录下。获取方式：打开 https://gitee.com/openLuat/LuatOS/tree/master/module/Air780EHM_Air780EHV_Air780EGH ，其中demo子目录为各功能示例脚本，project子目录为综合工程示例；也可以直接在Luatools的"项目管理测试"中选择Air780EHM，工具会自动下载对应的底层固件和demo脚本。产品文档：https://docs.openluat.com/air780epm/product/shouce/
7. Air780EG2搜星时功耗是多少？测的是60mA这么高吗？
解答： 仅GNSS处于连续搜星/定位状态时，模组总电流典型值为20多mA，正常不会达到60mA。若实测明显偏高，排查方向：①确认测量点是否把4G收发、屏幕、外设等电流一并计入（4G发射瞬时电流远高于GNSS）；②GNSS天线不匹配或未接好时，芯片长时间搜不到星会持续高功耗工作；③测量仪表采样方式问题（建议用功耗分析仪或串小电阻+示波器看平均电流）。硬件电气参数以对应产品数据手册为准，参考：https://docs.openluat.com/air8201/
8. 请问Air724UG-NA和Air724UG-NFC是什么区别呢？
解答： Air724UG-NA是Air724UG系列较早的老版本型号，不建议新项目选用；Air724UG-NFC（及NFM）是后续迭代版本，二者主要差异在蓝牙功能配置上，NFC/NFM变体包含蓝牙相关功能，NA版本不具备。新项目请优先选用当前主推的Cat.1模组（如Air780EPM/Air780EHM等），资料与供货更有保障。产品选型可参考：https://docs.openluat.com/SelectionGuide/SelectionGuide/
9. 模块有对接过声网的SDK吗？
解答： 目前LuatOS官方未适配声网（Agora）的SDK，也没有现成的对接demo。可行的替代思路：①语音通话类需求可使用LuatOS已支持的VoLTE通话或基于LuatOS音频接口（audio/exaudio）自行实现音频采集、编码与网络传输；②若必须使用声网服务，需在Lua脚本层基于其通信协议自行对接，或与合宙技术支持沟通定制适配可行性。音频相关API文档：https://docs.openluat.com/osapi/core/audio/
10. 再问下780EHV购买1000片以上是什么价格？
解答： Air780EHV在1000片以上批量采购时，参考价格为含税21.8元/片。说明：芯片价格随市场行情、采购数量波动，实际成交价格以合宙官方淘宝店（https://luat.taobao.com/ ）实时报价或联系合宙商务获取的正式报价单为准。
11. LUATOOLS升级后路径不能再使用中文了吗？
解答： 正确。Luatools的安装目录以及下载/选择的固件文件所在路径均不能包含中文字符（含空格、特殊符号也建议避免），否则可能出现固件下载失败、资源列表为空等异常；而Lua脚本源码工程所在路径可以包含中文，不影响烧录。建议：将Luatools安装在如 D:\Luatools\ 这类纯英文路径下，固件包统一放在英文目录中。工具教程：https://docs.openluat.com/common/Luatools/
12. Luatools日志大量打印时，整个程序会未响应，怎么解决？
解答： 该现象是日志输出量过大导致的：DBG_UART固定为921600bps，当log打印速度远超串口实际发送能力时，日志缓冲阻塞会拖慢整个脚本运行，表现为程序"未响应"。解决办法：①精简日志，注释或删除循环内的高频打印（如定时器、while循环中的log.info）；②在Luatools烧录界面将"调试信息"选项改为"无"或较低等级，减少底层日志输出；③量产版本可关闭DEBUG打印。排查阶段建议只保留关键节点日志。工具教程：https://docs.openluat.com/common/Luatools/
13. log日志可以输出到其他的串口去吗？比如把debug日志通过uart1或者uart2输出？
解答： 底层DEBUG日志固定从DBG_UART输出，不能重定向到uart1/uart2等业务串口。现场无DBG口时的替代方案：①使用errDump库，调用 errDump.config(true, 3600, nil, nil, "dev_msg1.openluat.com", 12425) 可将异常日志自动通过4G上报到合宙IOT平台；②也可用 errDump.dump(zbuff, type, isDelete) 获取日志内容后，在脚本层自行通过MQTT/TCP/蓝牙等任意通道发出；③业务自定义日志可在脚本中直接写入业务串口。errDump文档：https://docs.openluat.com/osapi/core/errDump/
14. 780EHV支持WIFI吗？
解答： Air780EHV支持WiFi扫描定位（通过扫描周边WiFi热点的MAC辅助定位），但不支持WiFi联网通信，不能像普通WiFi模块那样连接路由器上网。若项目需要"4G+WiFi通信"（如WiFi联网、双链路备份、USB供网等），应选用Air8000W（Air8000系列内置4G Cat.1+WiFi）。选型参考：https://docs.openluat.com/SelectionGuide/SelectionGuide/
15. 8000W这个WIFI是2.4G还是WIFI 5G？
解答： Air8000W的WiFi仅支持2.4GHz频段（802.11 b/g/n），不支持5GHz频段。目前合宙在售的带WiFi模组均为2.4G，暂无支持5G WiFi的产品。部署时请确保现场路由器/热点开启2.4GHz SSID。Air8000资料：https://docs.openluat.com/air8000/product/
16. 8000W做USB上网卡，WIFI可以作为上网出口嘛？类似WIFI网卡给电脑供网？
解答： 目前不支持。Air8000W的USB RNDIS（USB上网卡）功能仅支持以4G蜂窝网络作为出口给电脑/主机供网，WiFi链路不能反向通过USB共享给上位机，即不能实现"WiFi网卡给电脑供网"的用法。WiFi可用于模组自身联网通信或定位辅助。相关功能说明以Air8000产品文档为准：https://docs.openluat.com/air8000/product/
17. 有没有支持日本版本的模组，同时支持SIP和WIFICALLING通话？
解答： LuatOS方案可以支持SIP网络电话类应用，但WiFi Calling（运营商WiFi语音）依赖运营商核心网与基带协议栈支持，标准模组固件不提供该功能。SIP通话需要音频采集与播放，Cat.1模组本身没有完整音频通道，必须外挂音频CODEC芯片（如ES8311）并配合麦克风、扬声器使用，在脚本层基于exaudio接口实现音频采集、编解码与网络传输。海外频段方面，销往日本/欧亚区域建议选用Air780EHU等对应频段版本。选型参考：https://docs.openluat.com/SelectionGuide/SelectionGuide/
18. core5的固件能OTA升级到core13的固件吗？
解答： 不能直接OTA。常规FOTA差分包只支持在同一底层（core）大版本内升级脚本与资源；跨core版本（如core5升到core13）涉及底层固件更换，不能用普通差分包升级，需使用Luatools（3.0.9及以上版本）制作包含完整底层固件的升级包。注意：跨度过大的底层升级有变砖风险，建议跨大版本升级优先采用本地烧录方式验证，正式批量前充分测试。FOTA说明：https://docs.openluat.com/common/fotaindexhh/
19. 客户那边的设备反复重启，日志显示poweron reason:6，请问这个一般是什么方面的原因？
解答： 不能只看reason:6这一项，需调用 pm.lastReson() 获取全部4个返回值（a, b, c, d）综合判断：当a=0时看c值——0为上电/powerkey开机、3为软件重启、5为RESET键、6为异常重启（死机/崩溃）、8为内部看门狗复位、9为高温高压保护、10为充电开机；当a≠0时看a值——1为休眠定时器唤醒、2为WAKEUP脚、3为UART唤醒、5为PWR_KEY、6为CHG_DET。若对应c=6，说明设备发生了异常死机重启，应抓取死机前的完整日志、检查是否有内存越界/野指针/flash写入异常，并按Luatools提示上传死机信息。API文档：https://docs.openluat.com/osapi/core/pm/
20. 设备在现场不工作，没法打印日志，想通过蓝牙把日志输出来看一下，可以吗？
解答： 可以，但需要在脚本层自行实现，系统不会自动把日志存文件或从蓝牙发出。实现要点：①通过 errDump.dump(zbuff, type, isDelete) 读取errDump缓存的异常日志，或在关键流程中自行记录日志字符串；②调用BLE相关API（bt/ble库）将日志内容通过蓝牙连接发送到手机/对端设备；③可在脚本中用io/fs库把日志写入flash文件，再择机通过蓝牙或4G读出。errDump文档：https://docs.openluat.com/osapi/core/errDump/
21. 合宙有人脸识别的方案吗？场地内1k-2k会员刷脸开仓
解答： 有成熟方案。①快速落地可选Air8601人脸识别寄存柜工业模组：以Air1601为主控，搭配7寸1024×600显示屏与USB人脸摄像头，出厂预装刷脸存取件程序，适合寄存柜/储物柜类场景直接二次开发；②通用人脸硬件可选AirCAMERA_1034双目3D活体摄像头，端侧支持约100~240人的本地人脸库，识别速度小于0.35秒，具备活体防伪能力。针对本场景1k~2k会员规模，超出端侧本地库容量，建议采用"设备端采集+服务器端比对识别"的架构：设备通过4G将人脸照片/特征上传至服务端完成1:N比对后下发开仓指令。产品资料：https://docs.openluat.com/SelectionGuide/SelectionGuide/
22. 1601怎么获取780的4G信号强度？需要参考具体dbi值
解答： Air1601通过挂载的Air780ER2 4G模组获取信号，脚本侧有三个指标可用：①mobile.csq()返回CSQ值（0-31，<10差、10-25中等、>25好，99为卡异常），但CSQ仅作粗略参考；②真正反映信号强度的是mobile.rsrp()（参考信号接收功率，-44~-140dBm，≥-85良好、-95~-85中等、<-95较差，-999为卡异常）和mobile.rsrq()（参考信号接收质量，-3~-19.5dB，≥-10良好、-15~-10中等、<-15较差）。在4G模组侧脚本中读取后通过串口/消息传给Air1601主控即可，dBm值即对应您说的dbi指标。API文档：https://docs.openluat.com/osapi/core/mobile/
23. TTS语音在亮屏情况下声音非常小是什么原因？
解答： 该问题多与音频通路供电和音量配置有关，排查步骤：①确认exaudio.setup()初始化参数正确——使用ES8311时必须填i2c_id并在pins工具配置I2C引脚，pa_ctrl（音频放大器电源控制脚）与dac_ctrl（CODEC电源控制脚，Air780EHV固定为GPIO20）必须配置且硬件上电时序正常；②音量必须在exaudio.setup()初始化成功后调用exaudio.vol(play_volume)设置才生效（取值0-100），ES8311未上电/未初始化时设置音量无效，亮屏后若重新初始化音频通路但未重新设置音量，就会表现为声音变小；③TTS播放时还可在播放文本中以特殊格式串设置TTS参数（如"[参数XXX]文本"形式）；④检查喇叭功率与音频放大器功率是否匹配、PA使能脚是否被屏幕相关操作复用拉低。exaudio文档：https://docs.openluat.com/osapi/ext/exaudio/
24. 485读卡器接端子的供电，读卡时会停止工作，使用可调电源时正常，是什么原因？
解答： 原因是端子供电能力不足。读卡器在读卡瞬间（射频发射/电机动作）会产生较大的脉冲电流，若开发板485端子所在电源轨的限流或走线压降过大，瞬时电压被拉低就会导致读卡器复位停摆；而可调电源电流余量充足所以工作正常。排查与解决：①查读卡器规格书的工作电压和峰值电流，对比开发板该路电源的最大输出能力；②用示波器测量读卡器电源脚在读卡瞬间的电压跌落；③在读卡器电源端就近增加大容量储能电容（如100μF以上电解电容+0.1μF陶瓷电容）；④若板载电源轨余量不足，改为外部独立电源给读卡器供电，共地即可。
25. EHU用国外的卡需要配置APN吗？
解答： 一般情况下不需要。海外运营商的普通SIM卡通常支持模组自动获取APN（即插即用），插卡注册网络后即可正常联网。若遇到个别运营商卡无法注网/不能拨号，可向该运营商客服索取APN参数，在入网前调用 mobile.apn(index, cid, name, user, pwd, ip_type, protocol, is_del) 手动配置APN后重启再试。注意：该接口必须在入网前设置才生效。另外Air780EHU为欧亚频段版本，使用前确认当地运营商频段与EHU支持的频段匹配。mobile API文档：https://docs.openluat.com/osapi/core/mobile/
26. 用EHU在国内装国内的卡，链接涂鸦的新加坡数据中心，一直连不上，是什么原因？
解答： 这属于国内物联网卡访问境外服务器的网络连通性问题，与模组本身关系不大。原因与排查：①国内多数物联网卡（尤其专网卡/定向卡）默认只开放国内白名单地址，访问新加坡等境外数据中心会被运营商拦截，需向售卡方/运营商确认该卡是否开通境外访问权限及目标域名/IP是否在白名单内；②公网卡虽可访问境外，但跨境链路可能存在端口限制或丢包，可用电脑/手机同网环境测试涂鸦服务器域名与端口的连通性作对比；③与涂鸦确认其服务器对国内卡接入是否有区域限制、是否提供国内接入点。建议优先使用开通了境外漫游/公网权限的卡，或让涂鸦提供国内可直连的接入地址。
27. socket.bind为何总是运行不下去？还是不再用这个方法了？
解答： LuatOS中不存在 socket.bind 这个函数，调用它必然运行报错中断。UDP服务端（监听本地端口接收数据）的标准做法是使用socket库的UDP接口或官方封装的udpsrv/libnet，按"创建socket→绑定本地端口→等待接收"的流程编写。官方提供了可直接参考的UDP服务端demo，路径：https://gitee.com/openLuat/LuatOS/tree/master/module/Air8201/demo/socket/server/udp （其他模组在对应module目录的demo/socket下同样有udp示例）。建议以官方demo为基础修改端口和业务逻辑。socket API文档：https://docs.openluat.com/osapi/core/socket/
28. Air8000A在低功耗情况下外接器件还能使用吗？
解答： 取决于所处的功耗模式，合宙模组共有三种功耗模式：①常规模式——网络在线、CPU满频，所有外设功能全部可用（GPIO/UART/I2C/SPI/WiFi等均可正常操作）；②低功耗模式——网络在线、可随时响应服务器，CPU降频，仅AGPIO/WGPIO可保持电平状态，普通GPIO、uart10及以上串口等外设不可用，WiFi功能不可用；③PSM+模式——网络离线、不响应服务器命令，4G与WiFi均不可用，仅AGPIO可保持电平但无法控制，靠内部定时器或外部中断唤醒。因此外接器件若挂在普通GPIO/高位UART上，进入低功耗或PSM+后将无法通信，低功耗设计时必须把唤醒与保持电平的外设接到AGPIO上。低功耗指南：https://docs.openluat.com/common/airpower/
29. Air780EHV的MQTT不能发送大于32K的数据包吗？
解答： MQTT发送侧没有固定的32K限制，单条消息能发多大取决于模组可用内存（RAM/PSRAM），数据量过大时内存申请失败会导致发送失败甚至触发内存不足重启。需要注意的是接收侧：mqtt.create(adapter, host, port, ssl, opts) 的opts.rxSize用于指定接收缓冲区大小（官方库默认配置为32KB，带PSRAM的模组默认可到64KB、不带PSRAM默认约4KB），下发消息超过rxSize会接收异常。实践建议：①大数据（如固件、图片、批量记录）不要用单条MQTT消息传输，应在应用层分包（如每包2-4KB）并在接收端组包；②接收大包时按内存情况调大opts.rxSize；③固件升级类场景使用FOTA/HTTP通道而非MQTT。mqtt文档：https://docs.openluat.com/osapi/core/mqtt/
30. 用8000W做USB上网卡，WIFI可以作为上网出口嘛？类似WIFI网卡给电脑供网？
解答： 当前不支持。Air8000W的USB RNDIS（USB上网卡）功能仅支持将4G蜂窝网络作为出口共享给电脑/上位机，WiFi不能作为USB供网的上行链路，即无法实现"WiFi网卡给电脑供网"。WiFi链路可供模组自身联网通信或WiFi扫描定位使用。Air8000产品文档：https://docs.openluat.com/air8000/product/
31. 硬件IIC挂两个从机没问题吧？
解答： I2C总线本身就是多从机总线，同一组硬件I2C挂两个甚至多个从机没有问题，前提是：①各从机的I2C设备地址不能冲突（相同地址的器件不能挂同一总线，可通过器件地址引脚改址）；②SCL/SDA线必须接4.7kΩ~10kΩ上拉电阻到电源（总线上只需一组，不要重复多组过强上拉）；③总线上所有器件电平一致（3.3V/1.8V混用需电平转换）；④总线走线不宜过长，避免挂太多容性负载导致通信失败。接线后可用i2c扫描demo确认两个地址均能应答。i2c文档：https://docs.openluat.com/osapi/core/i2c/
32. 触摸几次后报错i2c_failed 140:i2c1 从机地址5d 传输超时，但触摸还是正常，是什么原因？
解答： "触摸正常但偶发传输超时"说明I2C物理层大部分时间可用、个别事务失败，常见原因与排查：①上拉电阻问题——SCL/SDA必须接4.7kΩ~10kΩ上拉电阻，上拉缺失或阻值过大会导致上升沿变慢、高频通信时偶发超时；可适当降低上拉阻值或降低I2C时钟速率验证；②总线干扰——触摸FPC排线靠近电源/背光走线时引入干扰，检查排线屏蔽与走线，缩短飞线；③从机偶尔拉死总线——某从机在异常时序下将SDA拉住，可切换到软件I2C，在超时时手动产生9个SCL时钟脉冲并发STOP条件恢复总线；④地址0x5D器件（触摸/传感类）的中断脚与复位脚时序是否正确，初始化前先硬复位该从机；⑤用i2c扫描demo长期监测地址应答情况。软件恢复手段参考i2c库文档：https://docs.openluat.com/osapi/core/i2c/
33. Air1602 V09421 两个新板子刷入相同的SOC和demo，一个一直死机，一个正常，怎么排查？
解答： 相同固件一块正常一块死机，问题多在异常板子的硬件个体差异或flash文件系统脏数据，按以下步骤排查：①抓取死机前最后一句lua日志，定位崩溃前执行的业务；②确认死机前是否有flash写入/文件操作（文件系统损坏会导致反复死机）；③用Luatools重新烧录时勾选"清除文件系统"（格式化flash）后再测试；④对比两块板子的供电纹波、焊接质量（尤其电源、flash、主控焊盘）和外设挂载差异；⑤按Luatools提示上传死机dump信息与所用固件版本，提交到 https://gitee.com/openLuat/LuatOS/issues 由官方分析。工具教程：https://docs.openluat.com/common/Luatools/
34. 8781P无板载DCDC意思是5-12V宽压输入引脚是悬空的吗？
解答： 是的，可以这样理解。Air8781P（基于Air780EPM的透传工业模组）的5-12V宽压输入（VIN）支路由JW5357 DCDC芯片及周边电感、电容等组成，出厂时这路DCDC的物料未焊接，因此VIN引脚处于悬空无效状态，不能直接接5-12V供电。当前版本请使用模组标称的常规供电电压（如3.4V-4.3V主电源）供电；若需要5-12V宽压输入，需自行按参考设计补齐JW5357及周边物料，具体以Air8781P硬件设计文档/原理图为准。资料：https://docs.openluat.com/air8781p/product/
35. 780EPM模块的原理图+PCB+BOM，你们这个有本安防爆的认证吗？或者可以提供资料协助认证吗？
解答： Air780EPM模组本身没有做本安防爆认证（本质安全型防爆认证属于整机/系统级认证，需由终端设备厂商在成品上完成）。合宙可以提供认证所需的支持资料：模组的原理图、PCB、BOM、规格书以及关键元器件参数等，用于客户整机的本安认证送测。需要资料请通过合宙官方企业微信群或商务渠道联系获取。官方支持渠道：https://docs.openluat.com/
36. 780EPM是否支持2812？
解答： 支持。Air780EPM可以驱动WS2812（2812B）全彩灯珠，有两种方式：①使用底层sensor库——sensor.ws2812b(pin, data, T0H, T0L, T1H, T1L) 用GPIO方式输出时序（另有sensor.ws2812b_pwm/sensor.ws2812b_spi方式，需对应外设能输出800kHz/5MHz时序）；②使用ws2812 Lua库，接口为 ws2812.create(ws2812.GPIO, 1, gpio_num) 创建对象，再用 ws2812.set() 设置灯珠颜色、ws2812.send() 刷新发送，官方air_card工程（led_util.lua）中有现成用法可参考。注意GPIO电平为3.3V，灯珠供电与电流要充足。参考：https://docs.openluat.com/osapi/ext/sensor/
37. LUATOOLS有打印吗？电脑能识别到端口吗？
解答： 有的。模组正常运行时，Luatools连接对应串口/USB端口即可实时查看底层与脚本的log打印。操作要点：①用USB线连接模组USB焊盘（DM/DP/VBUS/GND），电脑设备管理器中应枚举出4G模块的USB打印/下载端口；Luatools主界面会自动识别该端口，点击"串口日志"即可查看打印；②若电脑识别不到端口，检查USB数据线是否为数据线（非纯充电线）、驱动是否安装、模组是否正常上电；③注意DBG_UART（TX/RX调试串口，固定921600bps）只输出日志不能烧录。工具教程：https://docs.openluat.com/common/Luatools/
38. IRTU是你们的底层固件库吗？
解答： iRTU不是单纯的底层库，而是合宙提供的DTU/RTU量产固件产品：它基于LuatOS底层固件，内置了串口数据透传、云平台连接、网页配置后台、远程task脚本下发等完整功能，用户无需编写Lua代码即可让模组作为DTU使用，也可通过网页配置或下发task脚本扩展业务。使用时在Luatools中下载最新版本iRTU固件即可（当前推荐5.0.4及以上版本）。iRTU文档：https://docs.openluat.com/value/irtu/
39. 阿里云的这个证书变化对现有的设备是否会有影响？
解答： 证书更换是否影响设备，取决于设备端的TLS/SSL校验配置：①如果设备连接阿里云时开启了服务器证书校验（SSL单向/双向认证中校验CA），当阿里云更换根证书/中间证书后，设备内置的旧CA证书将校验失败导致断连，需更新设备端CA证书；②若连接时未做证书校验（如ssl配置为不验证），则不受影响。处理建议：向阿里云确认证书切换时间与新证书链，提前在设备端更新CA证书并做OTA灰度验证。LuatOS侧mqtt/socket的ssl参数配置可参考 https://docs.openluat.com/osapi/core/mqtt/ ；云平台侧的证书策略以阿里云官方公告为准。
40. 你们的API连接阿里云的代码需不需要变动？
解答： 不需要因为连接阿里云而改动LuatOS的API。LuatOS不提供专用的"阿里云连接API"，而是提供通用的通信协议库（mqtt、socket、http、ssl等），设备使用标准MQTT/TCP协议连接阿里云物联网平台即可。这些通信协议本身是稳定的标准协议，不会因云平台变动而变化；需要变动的只有连接参数（如服务器域名、端口、ProductKey/DeviceName/DeviceSecret三元组、CA证书）。证书轮换等云平台侧变更只需更新设备端对应配置。mqtt文档：https://docs.openluat.com/osapi/core/mqtt/
41. Air724UG-NA和Air724UG-NFC有什么区别呢？
解答： Air724UG-NA是Air724UG系列较早的老版本，不建议新项目选用；Air724UG-NFC（及NFM）为后续迭代版本，二者的主要差异在蓝牙功能——NFC/NFM变体包含蓝牙功能，NA版本不具备。新项目建议选用当前主推的Cat.1模组（如Air780EPM/Air780EHM等），资料与供货更完善。选型参考：https://docs.openluat.com/SelectionGuide/SelectionGuide/
42. NFC是你们的新型号吗？带蓝牙吗？
解答： Air724UG-NFC不是全新型号，而是Air724UG系列的一个硬件变体版本，该变体（NFC/NFM）是带蓝牙功能的版本，与其对应的NA老版本差异主要就在蓝牙配置上。需要说明的是，Air724UG系列属于早期产品，新项目不建议选用，如需Cat.1+蓝牙能力，建议选用当前主推的Air780EHM/Air780EPM/Air8201G等模组（均支持BLE）。选型参考：https://docs.openluat.com/SelectionGuide/SelectionGuide/
43. 1280*800的10.1寸屏选择哪款液晶？
解答： 合宙Air1601/Air8601方案官方适配的显示组合为7寸1024×600 RGB屏（Air8601人脸识别套件出厂即配7寸1024×600屏）。1280×800的10.1寸屏超出官方参考设计范围：RGB并口屏在1280×800分辨率下对显存、带宽和时序配置要求更高，需自行完成LCD初始化时序、显存分配与airui界面适配，官方不保证直接兼容。建议：①优先选用7寸1024×600规格的RGB屏与配套触摸，直接复用官方demo；②确需10.1寸1280×800时，参考airui/lcd文档自行适配并在选型前与合宙技术支持确认。UI框架文档：https://docs.openluat.com/osapi/core/airui/ ；硬件选型：https://docs.openluat.com/SelectionGuide/SelectionGuide/
44. 请问这个能带多大的电子屏？
解答： 该方案是用WS2812（2812B）全彩灯珠驱动的电子屏，能带多少颗灯取决于WS2812的级联能力：WS2812采用单线级联协议，理论上可无限串联，实际限制因素为——①刷新速度：灯珠越多整屏刷新越慢（每颗灯24bit数据，数量大时帧率下降）；②内存：每颗灯需3字节颜色缓冲区（RGB），灯数受模组可用RAM/PSRAM限制；③供电：每颗全亮约50-60mA，灯珠多时必须独立供电、分段供电，不能靠模组3.3V供电。在上述条件满足的范围内，几百到上千颗灯珠均可驱动。WS2812接口参考ws2812.create/ws2812.set/ws2812.send及sensor.ws2812b，文档：https://docs.openluat.com/osapi/ext/sensor/
45. 物联网卡到期了咋买新的，或者可以续费的那种？
解答： 两种途径：①续费——联系原物联网卡供应商/售卡代理，提供卡号（ICCID）办理流量续费或套餐续约，卡内号码与设备配置不变；②换新卡或改用合宙卡——若原渠道服务不便，可通过合宙官方采购物联网卡，联系合宙商务或在合宙官方淘宝店（https://luat.taobao.com/ ）咨询，合宙卡的流量、续费、卡状态问题均由合宙统一处理。注意换卡后若为专网卡/定向卡，需重新确认APN与服务器白名单配置。
46. AT指令的固件在哪里下载？官网没找到下载地址
解答： Air780E的AT指令固件（含MAIN串口支持AT指令的版本）可在官方文档站的Air780E AT固件页面下载，地址：https://docs.openluat.com/air780e/at/app/ 。进入页面后按指引获取对应版本AT固件包，使用Luatools烧录即可；烧录与工具教程参考 https://docs.openluat.com/common/Luatools/ 。其他模组的AT固件在文档站对应产品目录下同样可找到。
47. 新项目用的话别用780E开发了，这款产品咋了？
解答： Air780E没有停产，也不存在质量问题，已批量出货的项目可以继续正常使用与供货。建议新项目选用迭代升级款Air780EPM，原因是：Air780EPM在同价位下提供更大内存（带PSRAM）、更强性能和更丰富的外设资源，软件API与Air780E高度兼容、迁移成本低，且是当前主推与持续维护的型号，长期供货和技术支持更有保障。选型参考：https://docs.openluat.com/SelectionGuide/SelectionGuide/
48. 请问固件在哪里下载，官网上没找到下载地址？Air780E，需要MAIN串口支持AT指令的固件
解答： Air780E支持MAIN串口（UART1）AT指令的固件，在官方文档站Air780E的AT固件页面下载：https://docs.openluat.com/air780e/at/app/ 。下载后用Luatools烧录，AT指令默认从MAIN串口收发（注意区分DBG_UART调试口）。烧录教程：https://docs.openluat.com/common/Luatools/
49. 客户装了QODER的该怎么使用咱哪个agent？
解答： Qoder、Trae、Cursor等IDE基于VSCode内核但无法直接访问微软扩展市场，需手动安装LuatOS扩展的.vsix安装包：①先在能访问VSCode市场的环境或合宙官方资料中获取LuatOS扩展的.vsix文件；②在Qoder的扩展面板中选择"从VSIX安装"，选中该.vsix文件完成安装；③安装后即可使用LuatOS扩展的代码提示、烧录、日志等功能。原生VSCode中则直接在扩展市场搜索"LuatOS"在线安装即可。参考资料：https://docs.openluat.com/osapi/markdown/vscode/
50. AT指令的固件在哪里下载，Air780E需要MAIN串口支持AT指令？
解答： Air780E支持MAIN串口AT指令的固件在官方文档站下载：https://docs.openluat.com/air780e/at/app/ 。该固件烧录后AT指令通过MAIN串口（UART1）收发，DBG_UART仅输出调试日志。固件用Luatools烧录，教程见 https://docs.openluat.com/common/Luatools/
51. 咱们这边有CRC校验的程序段没？贴一段参考下
解答： LuatOS在crypto库中内置了CRC8函数，无需自行实现，参考用法（与官方onewire demo一致）：local crc = crypto.crc8(data, 0x31, 0, true)。其中data为待校验数据（字符串或zbuff），0x31为多项式（poly），第三个参数为初始值，第四个参数为是否按常见CRC8字节序处理；具体参数含义与取值可查阅crypto库文档。使用库函数可避免手写位运算在Lua数值类型上出错。crypto文档：https://docs.openluat.com/osapi/core/crypto/
52. CRC8校验时，网页在线测试可以正常通过的程序段，下载到开发版后，校验的数据不对
解答： 网页版CRC能通过而模组上结果不对，问题出在手写算法与Lua语言特性上，常见原因：①Lua的number为双精度浮点型，手写位运算时若数值超过31位安全位宽或未做位掩码（&0xFF），结果会出错；②数据类型不一致——网页工具输入的是十六进制字节，Lua中字符串每字节需用 string.byte() 取值，直接对字符串做位运算会得到错误结果；③多项式、初始值、异或输出、字节序等参数与网页工具设置不一致。最稳妥的做法是弃用手写实现，直接调用LuatOS内置 crypto.crc8(data, 0x31, 0, true)（参数按实际协议调整），库函数为底层实现，不存在Lua数值精度问题。crypto文档：https://docs.openluat.com/osapi/core/crypto/
53. 使用V2048版本后，CRC8校验出现的情况还是一样的！
解答： 更换固件版本后CRC结果依旧错误，说明问题与底层固件版本无关，仍在数据处理逻辑本身。建议直接弃用手写CRC代码，改用LuatOS内置的crypto库函数 crypto.crc8(data, 0x31, 0, true)，并逐一核对：①传入data的字节内容是否与网页工具输入完全一致（用 string.byte() 逐字节打印对比）；②多项式、初始值、是否异或输出、位序（MSB/LSB）四个参数是否与网页工具的设置项对应一致——参数任一项不同CRC结果就不同；③确认协议要求的CRC8变体（如CRC-8/MAXIM/DALLAS等多项式不同）。crypto文档：https://docs.openluat.com/osapi/core/crypto/
54. LUATOOLS有打印嘛？电脑能识别到端口嘛？
解答： Luatools支持日志打印，电脑正常情况下能识别到端口。确认方法：①用USB数据线（非纯充电线）连接模组USB焊盘（DM/DP/VBUS/GND），模组上电后Windows设备管理器会枚举出4G模块端口，Luatools主界面自动识别并可在"串口日志"窗口查看实时打印；②若识别不到端口，依次排查：USB线是否为数据线、模组是否正常上电启动、USB驱动是否安装、是否误用了DBG_UART（TX/RX调试串口，固定921600bps，仅输出日志，不能烧录也不枚举下载口）；③设备管理器中端口带感叹号时重新安装Luatools自带驱动。工具教程：https://docs.openluat.com/common/Luatools/
55. MQTT接收大量数据时mqtt会关闭重连，这个问题还没有修复吗？
解答： 这不是固件缺陷，而是接收缓冲区/内存不足导致的连接异常。原因：mqtt.create()时通过opts.rxSize指定接收缓冲区，下发的单条消息超过缓冲区容量时，MQTT库无法完整接收，会触发错误并关闭重连；不带PSRAM的模组默认缓冲约4KB，内存紧张时更明显。解决方法：①创建mqtt客户端时显式调大rxSize，例如 mqtt.create(socket.dft(), host, port, ssl, {rxSize = 32*1024})（带PSRAM模组可设更大，以实际可用内存为准）；②应用层将大数据分包下发/上报（建议每包2-4KB），接收端组包，这是最可靠的方式；③固件升级、文件传输等场景改用HTTP/FOTA通道而非MQTT；④检查脚本是否及时消费回调数据，避免数据堆积占用内存。mqtt文档：https://docs.openluat.com/osapi/core/mqtt/
56. MQTT的rxSize是固定的还是动态申请的？
解答： rxSize是在mqtt客户端创建时静态分配确定的，不是运行中动态申请的。它通过 mqtt.create(adapter, host, port, ssl, opts) 的opts.rxSize参数指定，客户端创建后该缓冲区大小即固定，运行过程中不能动态调整；若创建时不显式传opts.rxSize，则使用默认值（官方封装库常用32KB，带PSRAM模组默认可达64KB、不带PSRAM默认约4KB）。因此需要多大的接收缓冲，必须在创建mqtt对象前评估并一次性传入；创建后想改大小只能关闭旧客户端（mqtt.close）后用新的rxSize重新create。mqtt文档：https://docs.openluat.com/osapi/core/mqtt/
57. USB数据线线刷的话要用什么线？连接哪里？
解答： 线刷需使用普通USB数据线（确保是数据线而非纯充电线），连接模组的4个USB信号/电源焊盘：DM（D-）、DP（D+）、VBUS（5V电源正）、GND（地），与USB线对应芯线一一连接（建议加USB座子方便反复插拔）。连接后电脑枚举到4G模块端口，在Luatools中选择"4G模块USB打印/下载"即可烧录。注意：DBG_UART的TX/RX只输出日志不能烧录；救砖时用USB连接并拉BOOT脚进入下载模式。工具教程：https://docs.openluat.com/common/Luatools/
58. Air780EX固件升级哪种最简单啊？看着挺复杂
解答： 最简单的是URL远程升级方式：将固件放在HTTP/HTTPS服务器上，通过AT指令 AT+UPGRADE="URL","固件下载地址" 让模组自动下载并升级，无需本地连线，具体参数以Air780EX的AT指令手册中AT+UPGRADE说明为准。重要注意事项：Air780EX的URL升级功能存在缺陷——一旦使用过URL升级，后续设备将只能继续通过URL方式升级，无法再走其他升级通道；因此每次URL升级完成后，必须执行 AT+UPGRADE="URL","" 清除URL配置以恢复正常升级策略。AT指令资料：https://docs.openluat.com/air780ex/at/
59. 通过URL升级后还需要做什么？
解答： URL升级完成并确认新版本运行正常后，必须发送AT指令 AT+UPGRADE="URL","" 清除已保存的升级URL配置。原因：Air780EX存在URL升级通道锁定的缺陷，若不清除，设备之后将只能使用URL方式升级，无法再使用其他升级方式；清空后设备恢复正常升级策略。建议将该指令作为URL升级流程的固定收尾步骤。AT指令资料：https://docs.openluat.com/air780ex/at/
60. IOT平台调试日志没找到异常报错，设备4-10分钟出现重启
解答： 平台日志看不到异常说明重启可能发生在底层，需在设备端通过 pm.lastReson() 读取全部4个返回值（a,b,c,d）定位原因：a=0时以c为准——0上电/powerkey、3软件重启、5 RESET键、6异常死机重启、8内部看门狗、9高温高压保护、10充电开机；a≠0时以a为准——1休眠定时器、2 WAKEUP脚、3 UART唤醒、5 PWR_KEY、6 CHG_DET。4-10分钟周期性重启重点怀疑：①业务逻辑中周期性内存泄漏导致内存耗尽死机（对应c=6）；②看门狗喂狗不及时（c=8）；③供电在网络发射瞬间跌落导致重启（硬件层面，电源原因日志往往无异常）。建议同时记录重启前内存 rtos.meminfo() 与供电波形。API文档：https://docs.openluat.com/osapi/core/pm/
61. Air8000W设备反复重启，日志显示poweron reason:6，一般是什么原因？
解答： poweron reason中对应值为6，表示设备发生了异常重启（死机/崩溃后被看门狗或系统复位），不能只凭猜测下结论。Air8000W常见诱因：①内存不足——大数据收发、缓冲区未释放、内存泄漏导致申请内存失败崩溃（可用rtos.meminfo()监控重启前空闲内存）；②脚本异常——空指针、数组越界、死循环导致硬件看门狗超时复位；③WiFi与4G并发工作时瞬时电流大，若供电能力不足导致电压跌落也会表现为异常重启。排查步骤：用pm.lastReson()取全4个返回值确认，抓取死机前完整日志（errDump可上报），监控内存趋势，检查供电波形，按Luatools提示上传死机dump。API文档：https://docs.openluat.com/osapi/core/pm/
62. 云平台上只能查看固件的版本号，看不到后面的后缀，导致升级错误，有什么解决办法？
解答： 解决办法是在合宙IOT云平台按项目/固件类型做项目分组（产品分组），把不同硬件、不同固件后缀的设备划分到独立分组下，每个分组只挂对应固件，升级任务按分组下发，避免平台仅凭主版本号匹配而误推错误固件。若设备已经被误升级：①可重新上传正确固件并让设备再次FOTA升级恢复；②若设备已无法正常联网升级，则只能通过USB线刷重新烧录正确固件。后续建议在固件命名与版本号中保留可区分的完整后缀，并在分组管理中严格隔离。FOTA平台说明：https://docs.openluat.com/common/fotaindexhh/
63. FTOTA升级有频繁升级限制吗？
解答： 有限制。合宙FOTA平台对大批量设备设有频率限制：同一设备10分钟内只允许升级1次，短时间内重复请求升级会被平台拒绝（属正常防刷保护机制）。调试阶段可在平台将设备添加为调试设备（最多支持3台），调试设备不受该频率限制，便于反复升级测试。另外走AT指令路径的升级限制为1小时6次、24小时10次，超限后需在平台手动解除。FOTA说明：https://docs.openluat.com/common/fotaindexhh/
64. 以前可以连续两次升级不受限，现在好像不可以了，是更改了升级规则吗？
解答： FOTA频率限制规则一直存在（同一设备10分钟内限升级1次），此前能连续升级是因为设备处于调试豁免状态。若需在开发阶段反复升级测试，可在合宙IOT平台将设备设置为调试设备，调试设备（最多3台）可豁免频率限制；正式批量设备受10分钟1次的限制，这是平台侧的防刷保护。若因测试导致设备被限流，可在平台手动解除限制。FOTA说明：https://docs.openluat.com/common/fotaindexhh/
65. 这个测试数据不准确，能校准吗？
解答： 模组/传感器相关射频与基础参数在出厂时已完成校准，正常使用不需要用户再校准，测量偏差通常不来自"未校准"。若数据与预期不符，建议先排查：①供电是否稳定、外围电路是否按参考设计；②读取到的原始数据换算公式、单位是否正确；③是否存在环境干扰或安装方式影响；④对比多个模组的读数确认是否为个体差异。如确有异常，请提供具体测试数据、测试方法和对应传感器型号，通过官方渠道反馈分析。官方支持：https://docs.openluat.com/
66. Luatools的airmaster提几个建议，用户输入的问题在窗口里面没有显示，输出没有换行
解答： 感谢反馈，airmaster窗口交互问题（用户输入内容不回显、输出无换行）已记录并安排优化，后续版本会改进输入显示与输出排版。如遇功能异常，可提供Luatools版本号与截图，通过合宙官方企业微信群或gitee issues（https://gitee.com/openLuat/LuatOS/issues）提交，便于定位修复。
67. 4G Core(.blf)文件有地方找到吗？
解答： .blf是Vector公司CAN/LIN总线分析工具（CANoe/CANalyzer）的二进制日志文件格式，用于记录CAN总线报文，LuatOS模组本身不会生成.blf文件，官方资源中也不提供该类文件。若您的需求是：①抓4G通信日志——应使用Luatools的串口日志或合宙IOT平台的设备日志；②抓CAN总线数据——需使用CAN分析仪（如Vector工具、周立功CAN卡）在CAN总线上录制生成.blf；③若您看到的"4G Core"是指模组底层core固件，固件包为.bin/.lod格式，通过Luatools下载。建议确认所需文件的实际用途与来源，通过官方企业微信群进一步说明场景以获取对应资料。官方支持：https://docs.openluat.com/
68. 阿里云的这个证书变化对现有的设备是否会有影响？需要怎么处理？
解答： 是否影响取决于设备端SSL校验方式：①连接阿里云时开启了服务器CA证书校验的设备，在阿里云更换证书链后会因校验失败而断连，需在设备端更新新的CA证书并重新烧录/OTA下发；②未开启证书校验（不验证）的设备不受影响。处理步骤：向阿里云确认证书切换时间、新旧证书链；在mqtt/socket的ssl配置中替换为新CA证书；小批量灰度验证后再全量推送。合宙提供通用mqtt/socket/ssl库（配置方式见 https://docs.openluat.com/osapi/core/mqtt/ ），但云平台侧证书策略、切换节奏属于阿里云服务范畴，需以阿里云官方公告与技术支持为准，设备端代码由客户按上述方式自行适配。
69. 如何通过蓝牙把日志输出？
解答： 需要在脚本层自行实现，系统不会自动把日志导向蓝牙。实现思路：①用errDump库的 errDump.dump(zbuff, type, isDelete) 读取缓存的异常/调试日志，或在业务关键点把日志拼成字符串；②初始化BLE（bt/ble库）并建立与手机/对端的连接，通过BLE notify/写特征值把日志内容分包发出；③手机端用通用BLE调试助手或自研App接收显示；④日志量大时可先写入flash文件（io/fs库）再择机发送，避免阻塞主业务。errDump文档：https://docs.openluat.com/osapi/core/errDump/ ，BLE示例见LuatOS仓库demo/bt目录：https://gitee.com/openLuat/LuatOS
70. 需要修改固件中的路径才能让云端task中写的代码在触发DTU自动软重启后执行吗？
解答： 不需要修改固件中的路径。iRTU设备每次开机时才会与网页配置后台同步一次（拉取配置与task代码），运行过程中不会自动同步。排查要点：①确认云端task代码本身能正常运行——先下发一段简单测试代码（如定时log.info打印）验证task机制是否生效，排除是业务代码语法错误/运行异常导致不执行；②确认设备软重启后已联网并成功与后台完成同步（设备只在开机时同步一次，若重启后未联网则拉取不到最新task）；③task代码中避免使用阻塞死循环，遵守iRTU task运行规范。task开发文档：https://docs.openluat.com/value/irtu/docs/task/
71. 一般卡商是否默认开启BIP？
解答： BIP（Bearer Independent Protocol，卡上开通道/STK相关协议）是否默认开启由卡商/运营商决定，不同卡商策略不同，没有统一标准，需向具体卡商确认。对不使用BIP功能的项目，建议购卡时直接要求卡商关闭BIP，可避免卡侧主动发起BIP/STK会话导致模组异常重启等兼容问题（部分场景下甚至无需更换固件）。最终是否受影响仍需以实际插卡测试为准；若已出现BIP相关重启，可联系合宙获取关闭BIP处理的测试固件验证。
72. BIP是什么？
解答： BIP（Bearer Independent Protocol，承载无关协议）是SIM卡与模组之间的一套协议，配合STK（SIM卡工具包）使用，允许SIM卡主动请求模组建立数据通道（如打开socket、收发数据、发USSD/短信等），常用于卡端OTA、菜单应用等。在部分物联网卡上，若卡商默认开启BIP/STK，卡会在开机或运行中主动发起BIP会话，个别情况下会触发模组兼容问题导致异常重启。是否开启由卡商控制，请联系卡商确认当前卡是否默认开启BIP；不需要该功能时建议要求卡商关闭。
73. 你们这个测试固件和原先会重启的固件有何区别？
解答： 区别在于BIP处理逻辑：原固件运行过程中会响应SIM卡发起的BIP/STK会话，当特定物联网卡默认开启BIP时，模组进入BIP相关处理流程后触发异常重启；测试固件关闭（屏蔽）了BIP相关处理，使模组不再响应卡的BIP请求，从而规避重启。该改动仅影响BIP/STK卡应用功能，正常的数据连网、短信、透传等业务不受影响；但如果项目本身依赖卡端STK菜单/BIP通道，则需谨慎使用，最终以完整业务回归测试为准。长期方案建议联系卡商关闭BIP或使用正式修复版本固件。
74. 同一批卡，新生产的出问题了，连不上服务器，什么原因？
解答： 同批次设备只有新生产的连不上服务器，且问题集中在某批卡上，大概率是卡本身或卡配置问题，排查方向：①把问题卡放到已知正常的设备上、把正常卡放到问题设备上交叉测试，区分是卡还是设备；②查卡状态——是否欠费/停机/到期、是否被运营商关停、APN是否变化（可用mobile.csq()判断，返回99通常为卡异常）；③专网卡/定向卡确认服务器域名/IP是否仍在白名单内、卡商是否调整了套餐；④同批卡若部分异常，联系售卡代理商/运营商核查该批卡的开户与入网状态。若希望售后责任统一，可改用合宙提供的物联网卡，卡相关问题由合宙统一处理。
75. 客户测试EG2定位功能测出了60mA，正常吗？
解答： 单纯GNSS连续定位时电流典型值为20多mA，60mA偏高，需确认测量口径。排查：①GNSS定位时若4G同时在注网/收发数据，4G发射瞬时电流很大，整机平均电流会明显升高，建议在4G入网稳定后再单独测GNSS电流；②GNSS天线未接好或天线性能差时，芯片长时间搜星会持续高功耗；③确认测量仪器取的是平均值而非峰值，建议用功耗分析仪或串小电阻用示波器测平均电流。电气参数以产品数据手册为准，参考：https://docs.openluat.com/air8201/
76. 设备在外地不工作，无法打印日志，想用蓝牙把日志输出来看
解答： 可以，但需在脚本层自行实现，系统不会自动把日志从蓝牙输出。实现要点：①用 errDump.dump(zbuff, type, isDelete) 读取errDump缓存的日志，或在关键流程自行拼接日志字符串；②初始化BLE（bt/ble库）建立连接，通过BLE特征值把日志分包发给手机端BLE调试助手；③日志量较大时先写入flash文件（io/fs库）再分批发送。若设备现场完全无法本地连接，也可直接用 errDump.config(true, 3600, nil, nil, "dev_msg1.openluat.com", 12425) 让日志经4G自动上报合宙IOT平台查看。errDump文档：https://docs.openluat.com/osapi/core/errDump/
77. Air780E的核心板4G还需要单独的天线吗？
解答： Air780E核心板/开发板通常已集成板载4G天线（PCB天线或IPEX外接天线座），常规测试无需额外接天线即可注网。注意：①板载天线性能有限，金属外壳遮挡、信号弱的现场或量产整机中，建议通过IPEX座外接4G天线并引出壳外，以保证信号质量；②若板上同时使用GNSS定位，GNSS天线必须外接并置于室外/无遮挡位置（与4G天线相互独立）。信号质量可用mobile.rsrp()/mobile.csq()评估。产品资料：https://docs.openluat.com/air780e/
78. 3.3V_8311测试有3.3V吗？
解答： 测量3.3V_8311没有电压，是因为8311音频CODEC的供电使能脚未被拉通。排查要点：①ES8311的电源（含dac_ctrl控制的CODEC供电）与屏幕vlcd供电是独立控制的，使用I2C操作8311前，必须在脚本中同时打开8311供电使能和vlcd供电使能（两者都拉高后），I2C通信才能成功，否则会报"ES8311通讯失败，请检查硬件"；②用万用表/示波器确认8311供电脚实际电压为3.3V；③确认exaudio.setup()中i2c_id、pa_ctrl、dac_ctrl引脚配置与硬件一致（Air780EHV的dac_ctrl固定为GPIO20）。exaudio文档：https://docs.openluat.com/osapi/ext/exaudio/
79. 8000W有完整WIFI功能，5G wifi有成熟的产品吗？
解答： Air8000W具备完整WiFi功能，但仅支持2.4GHz频段（802.11 b/g/n）；目前合宙在售的WiFi类模组均不支持5GHz WiFi，暂无5G WiFi成熟产品。现场部署时请确保路由器/热点开启2.4GHz SSID。Air8000资料：https://docs.openluat.com/air8000/product/
80. Air8201G这个板子只能用在 ?
解答： Air8201G是超低功耗定位工业模组，集成4G Cat.1+BLE5.2+GNSS/LBS多重定位能力，采用Air780EGH芯片，软件资料与Air780EGH通用。它并非"只能"用于某一场景，典型适用场景包括：老人/儿童手环、宠物追踪器、学生工牌/电子校牌、人员与资产管理、冷链物流监控、车载防盗/电动车定位、共享设备等以"定位+低功耗+移动网络上报"为核心的应用。硬件上电池经BAT引脚接3.7V左右锂电池供电，GNSS天线需置于无遮挡位置，适合电池供电的便携/穿戴类定位终端。产品资料与选型：https://docs.openluat.com/air8201/ 、https://docs.openluat.com/SelectionGuide/SelectionGuide/
81. 环境中有多路网口SPI只能跑到5Mhz，且有一路有问题，帮我看看网口部分电路
解答： SPI多路网口时钟上不去、其中一路异常，通常与硬件走线强相关（SPI时钟线过长/阻抗不连续、多设备负载导致信号边沿变差、电源去耦不足、片选与中断走线干扰等），需要结合原理图具体分析。建议使用合宙提供的免费原理图评审服务：在 https://docs.openluat.com/value/drawcheck/ 提交原理图（注明网口SPI器件型号、时钟频率、各路走线情况），硬件工程师会给出评审意见。提交前建议自查：SPI走线长度与等长、串联匹配电阻、电源去耦电容、各设备共地与片选连接。
82. 云平台不显示固件号怎么解决？
解答： 在合宙IOT云平台通过项目分组（产品分组）管理解决：将不同固件、不同硬件的设备划分到不同项目分组中，每个分组独立配置固件版本号与升级策略，云平台即可按分组正确显示和区分固件号，避免不同项目设备混在一起导致版本显示/升级错误。若设备固件号上报不完整，也请确认设备端上报的版本字符串包含完整版本后缀。FOTA/平台说明：https://docs.openluat.com/common/fotaindexhh/
83. 设备升级后掉线了是什么原因？
解答： 升级后掉线多为刷入了不匹配/有误的固件（如错刷其他硬件版本的固件导致网络参数或驱动异常）。处理方式：①若设备还能联网并与平台通信，可在云平台重新上传正确固件，让设备再次FOTA升级恢复；②若设备已完全掉线、无法触发远程升级，则只能通过USB线刷（DM/DP/VBUS/GND连接，Luatools选择"4G模块USB打印/下载"）重新烧录正确固件，必要时拉BOOT脚进下载模式救砖；③恢复后在平台按硬件版本做项目分组并核对固件版本号，避免再次误推。烧录教程：https://docs.openluat.com/common/Luatools/
84. 官网没有找到Air780E的AT固件下载地址
解答： Air780E的AT指令固件（含MAIN串口支持AT指令的版本）可在官方文档站直接下载，地址：https://docs.openluat.com/air780e/at/app/ 。进入该页面后获取对应AT固件包，使用Luatools烧录即可；其他模组的AT固件在文档站（https://docs.openluat.com/ ）对应产品目录下的"AT应用"栏目中查找。烧录教程：https://docs.openluat.com/common/Luatools/