常见问题 - 2026-08-26
数据日期：2026-08-26
1. Air780E2T在PSM+模式下，AT指令唤醒后为什么读不到SIM卡/不能联网？
解答： 这是2025年8月之后新版底层固件的预期行为变更：PSM+模式下模组会进入飞行状态（退网、SIM卡停止工作），AT指令只能唤醒串口/应用核，不会自动重新驻网，因此读不到卡、不能联网。正确操作流程：① 唤醒后先发送 AT+POWERMODE="CLOSE" 退出PSM+模式；② 等待模组重新搜网驻网（可通过AT+CSQ、AT+CEREG查询状态）；③ 联网发送数据；④ 数据发送完成后再发 AT+POWERMODE="PSM+" 重新进入低功耗。若希望用硬件方式唤醒，可外部拉低DTR引脚，或拉高VBUS引脚。注意：此时发送 AT+CFUN=1 也无法联网，必须先退出PSM+模式。
2. 从PSM+唤醒后要联网，需要发AT+CFUN吗？
解答： 不需要。PSM+状态下唤醒后模组不会自动驻网，AT+CFUN也无法在PSM+状态下恢复网络。正确流程为：先发送 AT+POWERMODE="CLOSE" 退出PSM+模式，等待模组重新驻网成功后再联网发送数据，发送完成后再发 AT+POWERMODE="PSM+" 重新进入低功耗。
3. AT+POWERMODE的PRO模式和以前的STD模式有什么区别？
解答： 两者是同一模式，STD为旧版固件中的叫法，新版本已统一命名为PRO。直接使用 AT+POWERMODE="PRO" 即可进入PRO模式，功能与原STD模式一致。
4. Air780EP(780EP)支持iRTU固件吗？为什么binpkg能烧录但soc文件烧录失败？
解答： Air780EP已停产且不再提供技术支持，建议新项目改用Air780EPM，官方iRTU固件也仅提供Air780EPM版本。binpkg与soc是两种不同类型的固件包：soc属于底层固件，不能在Luatools的普通脚本下载页面烧录，需按照Luatools文档中底层固件烧录章节的说明，使用对应的烧录入口操作；binpkg可以下载而soc烧录失败，通常是烧录入口或操作方式不正确导致。
5. 新版Luatools不能烧录BINPKG，怎么办？
解答： 这是新版Luatools的刻意限制，并非故障。binpkg整包烧录无法清除文件系统（fs）与kv存储区域，旧数据残留容易引发异常，因此官方不再建议使用binpkg烧录。Air780EPM等主推型号均提供soc固件包，请改用soc方式烧录底层固件。
6. 生成量产文件时提示libfota3，但代码里没有使用libfota3，正常吗？
解答： 不影响固件功能。该提示是扩展库（soc_script）打包时多余文件或文档被误纳入打包清单导致，官方已安排清理并重新发布；更新到最新版soc_script后重新生成量产文件即可，也可直接忽略该提示。
7. 为什么生成量产文件不包含我文件系统的文件？
解答： 量产固件包默认只打包脚本代码（.lua及脚本资源清单中列出的文件），文件系统中的数据文件（字体、图片、配置文件等）不会被自动打入。处理步骤：① 在Luatools的项目管理中，将需要的文件添加到下载资源列表（与main.lua放在同一项目目录并勾选下载）；② 确认文件名和路径均为英文、不含中文及特殊字符；③ 重新生成量产文件并烧录；④ 烧录后可在脚本中用io.exists等接口检查文件是否就位。若仍缺失，请更新到最新版Luatools后重试。
8. Air8000A/8000最新底层固件下，串口11、串口12不能正常收发，只有串口1可以？
解答： 建议先确认并升级底层固件到最新版本（当前为V2050及以后）后重新测试；若使用WiFi/airlink固件，请同步将airlink升级到最新版本。升级后仍异常时按以下步骤排查：① 核对串口引脚复用配置与硬件接线（TX/RX是否交叉连接、电平是否匹配、共地是否良好）；② 确认串口初始化的波特率、数据位、校验位与外设一致；③ 使用官方uart demo对各串口逐一测试验证。仍无法解决时请抓取底层trace日志联系官方支持。
9. Air8000可以同时运行WiFi、4G、有线以太网吗？
解答： 可以。Air8000平台支持WiFi、4G蜂窝网络与有线以太网同时工作，可在Lua脚本中分别初始化对应网卡，并按业务需求配置数据链路与路由。建议参考官方多网卡联网相关demo进行验证。
10. Air8000能不能获取LVGL/显存/截屏数据用于发送给外设？
解答： 新平台未提供直接读取显存或截屏的接口（disp.getframe()是Air724等老平台接口，新平台暂无对应实现）。现有替代能力：LCD初始化完成后，提供将jpg图片硬解码到zbuff的接口，可把图像数据解码到内存缓冲区后自行读取或转发给外设。若业务需要外发屏幕内容，建议在应用层自行维护绘图数据缓冲区，而不是从显存回读。
11. LuatOS的SIP协议是否支持TLS通信？
解答： 支持。在SIP配置中正确加载CA证书（若服务器要求双向认证，还需提供客户端证书与私钥）后，即可走TLS加密通信，已有客户项目实际使用。
12. 购买现成的8201G模块量产，板上有BTB端子吗？固件怎么烧录？
解答： 淘宝在售模块的BTB连接器默认未焊接，但主板上预留有USB焊盘。量产烧录时可从USB焊盘飞线引出USB母口（D+、D-、VBUS、GND），连接电脑后使用Luatools烧录。设计量产治具时建议预留烧录测试点或专用烧录夹具，以提高生产效率。
13. 8201G/8210G-BLMQ的软件通用吗？
解答： 通用，两者软件与固件兼容，同一套脚本可直接在两个型号上运行。
14. Air8202G什么时候上架/销售？8202C的光敏电阻电路还在吗？
解答： Air8202G测试已接近完成，上市后将主推Air8202G。Air8202C上的光敏检测电路仍然保留，只是光敏元件默认未焊接；该电路已更新为通过WAKEUP中断方式上报光照变化事件，这也是推出Air8202C版本的原因之一。具体上架时间以淘宝店（https://luat.taobao.com/）实际销售为准。
15. Air8203什么时候有样品？是量产版本吗？天线是什么形式？
解答： Air8203尚未正式开售，测试已接近完成，提供的即为量产版本；天线形式为IPEX外接天线。样品/到货时间请关注合宙淘宝店或咨询官方商务。
16. Air8202G样品大概什么时候可以购买？Air8202的专用iRTU固件开源吗？
解答： Air8202G样品即将上架，具体以淘宝店实际上架时间为准。Air8202专用iRTU固件目前就是开源的，官方文档中已给出源码与固件获取链接，可按文档说明下载使用。
17. luatos中的sip协议是否支持tls通信？
解答： 支持。在SIP配置中正确提供证书后即可启用TLS加密通信，目前已有客户在实际项目中使用。
18. 有没有支持主机模式、模块能连接蓝牙耳机并输出I2S或PCM的模组？
解答： 目前合宙LuatOS模组暂不支持"蓝牙主机模式连接蓝牙耳机并直接输出I2S/PCM音频"的应用形态。若有音频输出需求，建议选用带I2S/PCM音频接口的型号配合外部蓝牙音频方案，或联系合宙商务确认在研型号路线。选型可参考官方选型指南：https://docs.openluat.com/SelectionGuide/SelectionGuide/
19. Air780E模块的GNSS天线部分电路图有吗？怎么调都没有位置数据？
解答： GNSS天线及硬件设计资料可在官方文档站 https://docs.openluat.com/ 的Air780E产品页查阅硬件设计手册，也可在文档站右下角向AI助手提问获取对应参考资料。无定位数据排查要点：① 确认有源天线的LNA供电正常、天线选型与走线符合手册要求；② 在室外开阔环境测试，冷启动首次定位可能需要数分钟；③ 检查GNSS串口TX/RX接线与串口参数配置；④ 确认脚本中GNSS功能已正确开启。
20. Air208S模组是否支持A5/3？
解答： 不支持。具体能力以官方规格书/选型指南为准，可在 https://docs.openluat.com/ 查阅Air208S产品页确认。
21. 合宙有参加深圳物联网展吗？
解答： 合宙不参加线下展会。产品资料与技术交流主要通过官方文档站（https://docs.openluat.com/）、合宙淘宝店（https://luat.taobao.com/）及官方企业微信群进行。
22. luatools烧录时电脑一直弹“无法识别的USB设备”，换线换电脑也不行怎么办？
解答： 按以下步骤排查：① 按住BOOT键不松开，再点按一下RESET键，强制模组进入下载模式，观察电脑设备管理器是否出现新端口；② 更换确认带数据线的USB线（部分线材仅供电无数据），优先直连电脑主板USB口，避免使用扩展坞；③ 按照官方烧录文档（howtodown）逐项检查驱动安装与模组供电；④ 以上均无效则可能为硬件故障，请联系合宙淘宝客服走售后流程。
23. Air780EPM的52、53引脚能复用为I2C0通道吗？
解答： 可以复用为I2C0，但不是按普通GPIO方式配置，需要按照引脚复用（pin mux）方式将对应引脚切换到I2C功能后，再使用i2c库初始化。具体复用参数请查阅Air780EPM硬件设计手册中的引脚复用表。
24. Air780EPM可以配置APN吗？
解答： 可以。AT固件下可通过AT+CGDCONT等指令配置专网卡APN；LuatOS脚本模式下可在mobile网络配置接口中设置APN参数，具体用法以官方mobile库文档为准。
25. 设备用PSM+低功耗定时唤醒，工作几天后突然一直不上报，现场重启又正常，可能是什么原因？
解答： 建议按链路分层排查：① 硬件看门狗：确认看门狗电路实际工作正常（喂狗逻辑、超时配置），可用示波器确认看门狗是否真正触发复位；② 唤醒链路：确认定时/中断唤醒是否真实发生，记录每次唤醒的日志计数；③ 驻网与连接：唤醒后是否成功退出PSM+、是否驻网成功、TCP/MQTT是否重连成功；④ 复现问题时务必抓取模组串口0的底层trace日志，定位卡在哪一环节。常见根因为唤醒后未正确退出PSM+导致未驻网，或看门狗未能有效复位。
26. EPAT软件可以设置保存日志，电脑带走后下次故障再提取日志吗？
解答： 不可以。EPAT支持按大小分段保存日志（如每100MB保存一段），但日志抓取依赖电脑实时连接模组运行；电脑不在现场期间无法事后补采。无人值守场景需让电脑或专用采集设备持续挂测，或改用模组本地写文件日志、云端日志等方案。
27. 低功耗模式下USB终端打印停止，唤醒后终端不恢复打印，USB功能需要重新打开吗？
解答： 低功耗休眠时USB会断电挂起，唤醒后USB串口通常需要重新枚举/初始化才能恢复打印。建议不要自行使用pm.request，严格按照官方lowpower demo的休眠/唤醒流程编写代码（demo中对USB与打印处理有完整注释）；若唤醒后需要打印，可在唤醒回调中重新初始化USB/串口，或直接使用硬件串口（UART0）输出trace日志。
28. 低功耗时还需要保持数据采集能力，用什么模式？
解答： 可根据采集频率选择官方lowpower demo中的对应低功耗模式：周期采集、周期上报的场景使用PSM+定时唤醒模式；需要保持RAM快速恢复的场景使用轻量休眠模式。按demo注释配置唤醒源与采集任务即可，demo路径可在 https://gitee.com/openLuat/LuatOS/tree/master/module 对应型号目录下查找。
29. MQTT唤醒用哪个接口？
解答： 请直接参考官方lowpower/MQTT低功耗demo中的用法，demo内对如何注册网络/MQTT数据作为唤醒源、唤醒后如何重连有完整注释说明，按demo流程调用即可，不要自行组合pm.request。
30. Air8783短信转发功能有配置说明吗？
解答： 有。配置文档为《Air8783短信转发功能本地配置使用说明》，已在官方文档站 https://docs.openluat.com/ 发布并同步到用户群，按文档步骤进行本地配置即可。
31. Air8783烧录生产固件后，有些能发短信有些不能发短信，需要提交什么信息排查？
解答： 请收集以下信息后提交官方支持：① 正常设备与异常设备的固件版本号（确认是否为同一版本生产固件）；② 异常设备的IMEI号、SIM卡运营商及卡类型（是否物联网专网卡、是否欠费停机、短信业务是否开通）；③ 异常设备发送短信时的底层trace日志；④ 交叉验证结果：异常设备换正常卡、正常设备换异常卡分别测试，以区分是卡、网络还是模组问题；⑤ 生产固件的短信中心号码与转发规则配置截图。常见原因为SIM卡未开通短信/欠费、短信中心号码错误、信号弱或专网卡限制短信功能。
32. GNSS定位后，系统自己又开启一次GPS定位是什么原因？
解答： 这是AGPS辅助定位流程：GNSS启动时默认开启约20秒的辅助星历下载（AGPS服务器地址为 http://download.openluat.com）；若使用专网卡或卡异常导致星历下载失败，下次启动GNSS时会重新走辅助定位流程，表现为"又开启一次定位"。使用专网卡或不需要辅助定位时，可在GNSS配置中关闭AGPS功能即可避免。
33. GNSS静态漂移大，有办法优化吗？
解答： 静止场景下GNSS定位结果天然存在小幅漂移，主要通过算法层面优化规避（静止状态判定、位置滤波/平滑处理）。exgnss.setup接口中提供static相关参数，可按库说明开启静止模式相关配置进行测试验证。
34. Air780E2T从PSM+唤醒后，检测不到卡，是什么问题？
解答： 这是2025年8月之后新版固件的预期行为：PSM+模式下模组默认进入飞行状态（退网、SIM卡停止工作），AT指令唤醒后不会自动驻网，因此检测不到卡、不驻网属正常现象。需先发送 AT+POWERMODE="CLOSE" 退出PSM+模式，待重新驻网后再联网；也可使用外部拉低DTR引脚或拉高VBUS引脚的方式硬件唤醒。
35. Air780E2T PSM+模式下，发AT指令能唤醒，还需要发AT+CFUN=1吗？
解答： 不需要。AT指令只能唤醒模组，但唤醒后不会自动驻网，发送AT+CFUN=1也无法在PSM+状态下恢复网络。必须先退出PSM+模式（AT+POWERMODE="CLOSE"），模组才会重新搜网驻网。
36. 为什么旧780EX模块AT唤醒后直接TCP联网就可以，新780EX2T不行？
解答： 这是固件行为变更：2025年8月之后的新固件中，PSM+模式默认进入飞行状态，指令唤醒后模组不会驻网，必须显式退出PSM+才能联网；旧模块/旧固件无此行为。软件需按新流程适配：唤醒 → 退出PSM+ → 等待驻网成功 → 再建立TCP连接联网。
37. Air780EPM/780EPM从PSM+唤醒后需要发AT+CFUN吗？
解答： 不需要，但唤醒后模组不会自动联网，需先发送 AT+POWERMODE="CLOSE" 退出PSM+模式，待重新驻网后再执行联网流程。
38. Air780E2T可以同时连接两个服务器吗？AT模式下数据内混入AT+CIPSEND怎么解决？
解答： ① 多服务器连接：AT固件下支持建立多路连接，使用AT+CIPSTART为不同连接分配不同连接ID（如0、1路）分别连接服务器，具体指令以对应型号AT手册为准；LuatOS脚本模式下可直接创建多个socket客户端，更适合多服务器业务。② 数据中混入AT+CIPSEND：属于AT指令与数据的时序问题。发送数据时必须严格遵守时序：发送AT+CIPSEND后等待模组返回">"提示符，再发送数据内容，并按手册要求结束数据发送；不要把下一帧AT指令拼在数据尾部发出，透传模式下需用+++正确切回指令模式。建议在MCU侧实现"指令态/数据态"状态机；业务复杂时推荐改用LuatOS脚本开发，从根本上避免AT时序混淆。
39. AT模式下自动上报的^MODE、+E_UTRAN Service、+CGEV等数据可以关闭吗？
解答： 不可以。这些是协议栈的网络状态URC主动上报（注册状态、小区变化、PDP事件等），无法关闭。MCU侧应在串口数据解析时识别并过滤这些URC，不要将其当作业务数据处理。
40. 恢复iot.openluat.com密码怎么办？
解答： 访问 https://iot.openluat.com/cloud/main ，在登录页面点击"找回密码"，按绑定的邮箱或手机号流程重置密码即可。
41. LuatOS的AI有没有MCP或skill接入指引？想接到自己的codex里，官方插件很慢。
解答： 官方AI服务的接入说明见 https://docs.openluat.com/ai/ ，文档中有MCP/skill接入自有客户端的配置指引，按文档操作即可。若网页响应慢，可尝试清理浏览器缓存或更换网络后重试。
42. Air1601有LoRa通信的应用吗？
解答： 目前暂无现成的LoRa应用demo。Air1601可通过SPI/GPIO外接LoRa射频模组（如SX1278等），使用Lua脚本驱动即可实现LoRa通信。
43. 有没有像700ECH这么小体积且带重力加速度传感器的模组？
解答： Air700ECH体积更小但不带重力加速度传感器；内置G-sensor且体积最小的型号为Air780EGP。完整选型对比请以官方选型指南为准：https://docs.openluat.com/SelectionGuide/SelectionGuide/
44. Air780E新项目还能用吗？带音频输出有什么推荐？
解答： 新项目不建议再选用Air780E/Air780EQ/Air780EPT等老型号，推荐使用Air780EVT；需要音频输出时，在板级设计中增加一颗音频功放电路即可驱动扬声器。选型可参考官方选型指南：https://docs.openluat.com/SelectionGuide/SelectionGuide/
45. Air780EGH/780EGP的定位开发板有吗？能提供7.5~24V供电、外接10~24V、4.2V电池、有源天线的方案吗？
解答： 类似定位器应用需求可参考Air8202/Air8203方案：Air8203为量产版本、采用IPEX外接天线（尚未正式开售），Air8202可先行测试。宽压输入（7.5~24V）、外接电源、4.2V电池充放电及有源天线供电等，需按官方硬件设计手册进行电源架构设计（DCDC+充电管理+PMU），建议参考文档站硬件资料并联系合宙商务确认定位开发板配套情况。
46. 8201G模块量产时模块上有BTB端子吗？固件怎么烧录？
解答： 淘宝在售模块的BTB连接器默认未焊接，但主板上预留有USB焊盘。量产烧录时可从USB焊盘飞线引出USB母口（D+、D-、VBUS、GND），连接电脑后使用Luatools烧录；建议设计量产烧录治具预留测试点。
47. Air724UG/DTC模块的规格书有吗？
解答： 规格书及产品资料见官方文档站：https://docs.openluat.com/air724ug/product/
48. 能不能在Luatools里增加一个用户自定义扩展库目录，避免每次更新lib后手动移动RC522等库文件？
解答： 无需放入soc_script目录。将rc522.lua等扩展库文件直接放在自己的项目目录下（与main.lua同目录或其子目录），脚本中正常require即可随项目一起打包下载，更新lib时也不会被覆盖。
49. Air780EHM支持2Gb的nand flash吗？
解答： 该参数请以Air780EHM硬件设计手册/规格书中的存储器配置表为准，可在 https://docs.openluat.com/ 的Air780EHM产品页查阅；若使用第三方nand颗粒，建议先提供颗粒datasheet联系合宙技术支持确认兼容性后再投板。涉及大容量存储的选型，也可通过官方企业微信群直接确认当前固件支持的nand容量与颗粒型号清单。
50. Air780E2T模块和之前780EX模块兼容吗？换上新模块后读卡失败。
解答： 若设备使用PSM+模式：2025年8月之后新固件PSM+默认进入飞行状态，唤醒后不联网、读卡可能异常，需按新流程先退出PSM+再驻网（详见PSM+相关说明）。若与低功耗无关，则检查硬件：SIM卡槽焊接是否良好、SIM_DATA数据线上拉电阻、卡供电及新旧模块引脚定义差异，需对照两份硬件设计手册逐一核线。
51. 电脑一直弹无法识别的USB设备，换线换电脑都不行，怎么处理？
解答： 按以下步骤排查：① 按住BOOT键再点按RESET键，强制模组进入下载模式，查看设备管理器是否识别到端口；② 更换确认带数据功能的USB线并直连电脑主板USB口；③ 按官方烧录文档（howtodown）检查驱动与供电；④ 以上均无效请联系合宙淘宝客服走售后。
52. Luatools的PC模拟器有新版吗？
解答： PC模拟器V2037已发布更新，下载地址：https://gitee.com/openLuat/LuatOS/releases/tag/v2037.pc.release
53. SoC_Script Libs扩展库更新了吗？
解答： 已更新，下载地址：https://gitee.com/openLuat/LuatOS/releases/tag/v2026.08.26.13-soc_script
54. 生成固件时提示libfota3但代码里没有，正常吗？
解答： 该提示来自soc_script打包清单中误纳入的多余文件（如exs_mcp23s17.md等无关文件被一并计入），并非工程实际引用，不影响固件功能；官方已安排删除并重新发布，更新到最新版soc_script后提示即会消失。
55. 从10月1号之后出货的模组是否必须用新固件？对AT固件用户有影响吗？
解答： 2025年10月1日之后出厂的模组，必须搭配较新版本的底层固件（LuatOS底层固件版本≥V2036）方可正常使用；此前已出货的模组不受影响。AT固件在出厂时已默认烧录最新版本，AT固件用户无需额外操作。
56. 10月1号后的模组和之前不一样吗？
解答： 是的，新出货模组配套的底层固件版本高于V2036，按正常流程烧录、使用即可，对用户使用没有其他影响。
57. 烧录binpkg时提示不支持直接烧录binpkg，是什么意思？
解答： 这是新版Luatools的刻意限制：binpkg整包烧录无法清除文件系统（fs）与kv区域，旧数据残留容易导致异常，因此不再建议使用binpkg烧录。有soc固件包的型号请使用soc方式烧录。
58. Air8101 LCD触摸区域问题，触摸点Y值没有大于404，怎么解决？
解答： 触摸坐标范围与触摸（tp）初始化方向、LCD初始化参数相关。处理要点：① 先初始化触摸芯片并配置好显示方向（横屏/竖屏需与LCD一致）；② 触摸中断配置为下降沿触发进行测试；③ tp与lcd的分辨率、方向、镜像参数必须保持匹配；④ 对照官方lcd/tp demo核对初始化序列后，触摸坐标即可正确映射到全屏范围。
59. LuatOS的AI服务回复错误或没有回复怎么办？
解答： 若遇到"对话服务错误"或无响应，可先多次重试；若问题持续复现或回复内容错误，可通过合宙官方企业微信群反馈，附上问题截图与提问内容，便于官方优化。
60. iot.openluat.com登录时提示已登录但微信扫码登录不了，怎么办？
解答： 可访问 https://iot.openluat.com/cloud/main ，在登录页点击"找回密码"设置账号密码，然后改用账号密码方式登录。
61. Air8300W双网口双485工控板有资料吗？
解答： Air8000W已更名为Air8300工控板，相关资料已在官方文档站更新，按Air8300（EXB_8000_CH390）命名查阅即可。
62. Air8300的资料链接有吗？
解答： 资料地址：https://docs.openluat.com/exb/EXB_8000_CH390_1/
63. iRTU固件烧录失败，soc文件下载失败是什么原因？
解答： soc属于底层固件，不是在Luatools普通脚本下载页面烧录的，需按照Luatools文档中底层固件烧录章节的说明，使用对应烧录入口操作。binpkg能下载而soc烧录失败，通常是烧录入口或操作方式不正确，按文档指引重新操作即可。
64. 生成量产文件时提示libfota3，实际上只require了libfota，这是什么情况？
解答： 该提示并非工程真实引用，而是soc_script/扩展库打包清单中误包含了libfota3相关条目（依赖扫描时把扩展库目录下的libfota3文件一并计入）。处理方法：① 更新到最新版soc_script扩展库（多余文件已清理）；② 检查工程目录及lib目录下是否残留libfota3相关文件，有则删除；③ 重新生成量产文件。该提示不影响固件实际功能。
65. lcd库支持ST7567吗？
解答： 请先在LuatOS代码仓库 https://gitee.com/openLuat/LuatOS/tree/master/module 对应型号的demo与库目录中查看lcd驱动支持列表，确认是否已内置ST7567驱动。若暂无内置驱动：ST7567为常见单色点阵LCD（SPI/并口接口），可参考现有lcd驱动结构用Lua编写初始化与刷屏函数，或在平台已适配u8g2库时直接用u8g2驱动；也可在官方企业微信群确认最新库是否已新增ST7567支持。
66. 合宙DTU模块芯片Air724UG规格书有吗？
解答： 规格书及产品资料见官方文档站：https://docs.openluat.com/air724ug/product/
67. Air780EPT连接两个服务器，AT能连接成功但数据内混入AT+CIPSEND？
解答： 多路连接时每一路需使用独立连接ID，发送数据严格遵守时序：发送AT+CIPSEND指定连接ID与数据长度 → 等待模组返回">"提示符 → 再发送数据内容 → 等待SEND OK。数据中混入AT+CIPSEND通常是以下原因：① 未等待">"提示符就开始发数据；② 把下一帧指令拼接到了数据尾部；③ 透传模式下未用+++正确切回指令模式。建议在MCU侧实现"指令态/数据态"状态机；业务较复杂时推荐改用LuatOS脚本方式开发多socket业务，从根本上避免AT时序问题。
68. p8000的测试工具不能用了怎么办？
解答： 请访问 https://iot.luatos.com/#/p8000/netlab 开启并使用p8000网络测试工具。
69. 专属固件在网站上下载不了，724UG能直接归属到项目下吗？
解答： 非官方授权渠道无法将模块直接归属到项目下。专属固件的下载权限与商务授权相关，请联系合宙商务或技术支持确认账号权限与固件归属事宜。
70. Air780EXA单价多少？是老型号吗？
解答： Air780EA含税批量单价约39元，属于老型号，已不再提供技术支持，新项目建议选用当前主推型号，选型参考官方选型指南：https://docs.openluat.com/SelectionGuide/SelectionGuide/ （价格以淘宝店实时报价为准）。
71. Air780EX 3.3V版本单价多少？
解答： Air780EX-3.3V含税批量单价约25元，实际价格以合宙淘宝店（https://luat.taobao.com/）实时报价为准。
72. Air8000D不能控制WGPIO吗？
解答： 请按以下方向排查：① 查阅Air8000硬件手册引脚表，确认WGPIO对应的GPIO编号与引脚复用配置（WGPIO可能为扩展/WiFi侧GPIO，需使用手册指定的编号，而非普通GPIO号）；② 按官方gpio demo使用gpio.setup配置输出、gpio.set控制电平，用万用表验证引脚电平；③ 确认底层固件已升级到支持WGPIO的最新版本；④ 若WGPIO由协处理器管理，可能需通过特定接口控制。可在官方文档站Air8000产品页查阅WGPIO说明，或通过官方企业微信群确认具体控制方式。
73. Luatools卡死进不去烧录怎么办？
解答： ① 先在任务管理器中结束Luatools进程后重新打开；② 仍卡死则卸载后安装最新版Luatools；③ 检查Luatools安装路径与工程路径是否全为英文（含中文、空格会导致异常）；④ 暂时关闭杀毒软件及其他占用USB端口的程序后重试。
74. Luatools报路径不存在，但路径实际存在，怎么解决？
解答： 该问题通常由路径中包含中文、空格或特殊字符引起。请将Luatools安装目录与工程目录移动到全英文短路径下（如D:\luat\proj），重新打开工程后即可正常识别。
75. Air8000W上电后自动升级，重启过程中黑屏几十秒正常吗？
解答： 正常。模组FOTA下载升级包后会重启并刷写新固件，刷写过程中屏幕黑屏几十秒属正常现象，耐心等待升级完成自动启动即可，期间切勿断电，否则可能导致固件损坏。
76. Air780EHM/Air780EHV/Air780EGH录音AMR-WB流式回调数据异常，是什么原因？
解答： 请按以下步骤排查：① 核对音频编码参数（AMR-WB采样率16kHz、帧长、回调缓冲区大小需与帧大小匹配）；② 回调函数中不要做耗时处理，收到数据应立即写入文件或队列，回调内阻塞会导致丢帧、数据错位；③ 确认AMR-WB文件头与帧头写入正确，可用播放器校验录音文件；④ 升级到最新底层固件与audio库后重试；⑤ 参考官方audio录音demo核对流程，并抓取异常时的trace日志提交官方支持分析。
77. 6205模组多少钱？和6208有什么区别？
解答： Air6205目前同时带蓝牙和WiFi；Air6208后续版本将去掉蓝牙，两者封装兼容、可直接替换；Air6208含税单价约7.9元（价格以淘宝店实时报价为准）。
78. 8700H搭配什么模组可以实现手机连硬件热点通讯？
解答： 8700H搭配Air6205模组可以实现手机连接硬件热点通讯，官方提供有相关示例demo，可在代码仓库对应型号目录下获取参考。
79. 用8000W是不是也可以实现WiFi热点功能？
解答： 可以，Air8000W支持WiFi热点（AP）功能，按官方WiFi demo配置开启热点即可。
80. Air8780V4开发板上没找到DCDC模块，是不是没焊上的都没用？
解答： 是的，开发板上未焊接的器件默认不贴装，对应功能不可用。手册中说明：仅使用Type-C供电时，电流先经过TP4056充电管理，再给EHV模组供电。详情见硬件手册：https://docs.openluat.com/air8780/luatos/hardware/module/
81. Air8780P电池电压检测部分是否模块内部已实现，不需要外部电阻分压？
解答： 请以Air8780硬件设计手册中电池电压检测（VBAT/ADC）章节说明为准，手册地址：https://docs.openluat.com/air8780/luatos/hardware/module/ 。若手册要求外部分压，则需按参考电路在电池与ADC引脚之间设计电阻分压（注意电池最高电压不得超过ADC量程）；脚本中使用adc库读取对应通道并换算成实际电压验证。拿不准时可将原理图提交官方企业微信群确认。
82. Air8780P的电源开关如何设计？需要上电开机还是留PWRKEY按键？
解答： 推荐上电开机方案：将PWRKEY接地，模组上电即自动开机，外壳上使用拨动开关控制总电源通断即可。若同时需要"上电开机+软件可关机后再开机"，则必须将PWRKEY引出外接开机按键，否则软件关机后将无法重新开机。
83. Air780E2T在用PSM+时，如何通过外部引脚唤醒并联网？
解答： 进入PSM+后模组会退网，需要联网时必须先退出PSM+模式。外部唤醒方式：拉低DTR引脚，或拉高VBUS引脚触发唤醒；唤醒后再执行"退出PSM+ → 等待驻网 → 联网发送数据 → 重新进入PSM+"的完整流程。
84. 之后模块进入超低功耗模式后自己唤不醒，怎么解决？
解答： 该问题与看门狗方案设计相关，建议尽快切换到153D看门狗方案（下次投板时修改PCB），其12小时、24小时周期模式非常适合低功耗定时唤醒场景，可在模组异常挂死时自动复位恢复，避免设备永久唤不醒。
85. 模组在超低功耗模式下用了一段时间后就自己唤不醒了，是怎么回事？
解答： 该现象多为看门狗未能在模组异常时有效复位导致。建议切换到153D看门狗方案并优化看门狗电路设计，保证超低功耗运行期间设备异常可自动复位恢复；具体电路设计可参考官方硬件设计手册。
86. Air780EPM的PSM+模式会断开IO电平和进飞行模式吗？
解答： 是的，这是正常行为。PSM+模式下模组进入超低功耗状态，IO供电会断开（IO电平不保持），同时自动进入飞行模式（退网）。需要IO保持电平或维持网络连接的场景不应使用PSM+，应选择其他低功耗模式，并在唤醒后重新初始化IO。
87. 生成量产文件时提示exs_mcp23s17.md是什么？
解答： 这是soc_script打包时误纳入的一个说明文档（.md）文件，与用户工程无关，不影响固件功能；官方已安排删除并重新发布soc_script，更新到最新版本后该提示即消失。
88. 同一个硬件，刷PSM模式休眠程序就不读卡，刷正常程序就可以读卡，为什么？
解答： PSM+模式下模组会退网并进入飞行状态，SIM卡停止工作，因此读不到卡、无法联网属于预期行为；需要读卡或联网时必须先退出PSM+模式。若业务要求休眠期间仍保持读卡能力，应评估选用其他低功耗模式而非PSM+。
89. websocket在1780H上一直连上又断开，是实时性要求高吗？8000上正常，1780H+6205会断开。
解答： 与实时性要求无直接关系，建议按以下方向排查：① 对比两端的websocket库版本与底层固件版本，将1780H侧升级到最新；② 链路差异：1780H+6205的网络链路（WiFi/4G）NAT超时时间可能更短，建议缩短应用层心跳/ping间隔（如30秒以内），防止连接被中间网络设备回收；③ 同时抓取模组侧trace日志与服务器侧日志，确认断开是服务器主动关闭、TCP RST还是超时导致；④ 核对两端websocket握手参数（Origin、子协议、TLS证书）是否一致；⑤ 代码中增加断线自动重连机制。排查后仍无法解决时，将trace日志提交官方支持分析。
90. 推理时间28.76ms是Air718的时间吗？8201G推理性能如何？
解答： 28.76ms是Air718的单次推理耗时；Air1602单次推理约2.76ms。AI性能数据请以官方AI性能测试文档/文档站公布数据为准。
91. Air718/8201G音频推理最优情况如何？
解答： 最优测试条件下（未运行LTE网络）：推理输出结果正确，单次推理约28.76ms，连续推理100次耗时基本无差异；stack分配32KB可满足运行需求；PCM音频由硬件自动采集，不会丢帧。需要注意：该数据为脱离网络的最优值，实际运行LTE网络后性能会下降；若单帧音频（如20ms音频数据）的处理耗时超过帧长，则无法满足实时性要求，需按实测性能裕量评估方案。
92. 有没有离线文档？
解答： 官方文档以在线站点 https://docs.openluat.com/ 为主，内容最新最全。离线获取途径：① LuatOS代码仓库 https://gitee.com/openLuat/LuatOS 中各module目录下附带demo与说明文件，可整仓克隆后离线查看；② 文档站页面可通过浏览器打印/另存为PDF保存；③ Luatools安装目录下附带部分离线资料。
93. Air780E2T模块从PSM+唤醒后检测不到SIM卡是怎么回事？
解答： 这是2025年8月之后新版固件的预期行为：PSM+模式下模组默认进入飞行状态（退网、SIM卡停止工作），AT指令唤醒后不会自动驻网，因此检测不到卡、不驻网属于正常现象。需先发送 AT+POWERMODE="CLOSE" 退出PSM+模式，待重新驻网后再联网；也可通过外部拉低DTR引脚或拉高VBUS引脚进行硬件唤醒。
94. Air780E2T PSM+模式下是否可以直接从PSM切到PRO模式？
解答： 不能直接切换。需先发送 AT+POWERMODE="CLOSE" 退出PSM+模式，再发送 AT+POWERMODE="PRO" 进入PRO模式。
95. Air780E2T新模块和之前780EX模块的PSM唤醒联网行为不一样，怎么解决？
解答： 2025年8月之后的新固件中，PSM+模式默认进入飞行状态，唤醒后不联网；旧模块/旧固件唤醒后可直接联网。软件请按新固件行为适配：唤醒后先发送 AT+POWERMODE="CLOSE" 退出PSM+，等待模组驻网成功后再联网发送数据，完成后再重新进入PSM+。
96. Air780E2T固件最新版本是多少？
解答： 当前最新底层固件版本为V2050，实际最新版本以gitee发布页（https://gitee.com/openLuat/LuatOS/releases）公布为准。
97. Air780EPM的Io口能不能通过pm切到低功耗模式？应该怎么用？
解答： 不要自行调用pm.request去切换IO低功耗，请按照官方lowpower demo中推荐的低功耗配置方式使用，demo对IO在休眠/唤醒时的处理有完整注释与正确用法，参考demo编写即可。
98. Air780EPM模块低功耗唤醒后，MQTT有数据但终端不打印，为什么？
解答： 请按官方lowpower demo编写休眠/唤醒流程，不要自行使用pm.request。原因是低功耗状态下USB会断电挂起，唤醒后USB串口未重新枚举，所以终端没有打印输出；MQTT能收到数据说明业务已正常恢复。若唤醒后需要打印日志，可在唤醒后重新初始化USB/串口，或改用硬件串口（UART0）输出trace。