常见问题 - 2026-09-01

数据日期：2026-09-01

1. 刷机软件在哪里下载？

解答： 结论：请从官方 LuaTools 教程页下载 LuaTools v3，直链为 https://cdn18.luatos.com/files/exe/Luatools_v3.exe 。该工具支持 Air780、Air700、Air8xxx、Air6xxx、Air7xx 及 Air820 等产品，运行环境为 Win10 及以上，不支持 Mac/Linux。建议放到磁盘根目录下的独立文件夹运行，并放行杀毒软件拦截。教程页：https://docs.openluat.com/common/Luatools/

2. 设备插上后没反应，没有心跳上报，如何排查？

解答： 结论：先判断是设备未启动/未识别，还是业务脚本未联网、未上报。请从设备上电瞬间开始保存完整 LuaTools 日志，而不是只截取“无心跳”后的片段。排查顺序：1）设备管理器确认是否枚举出串口，必要时按 BOOT 后上电进入下载模式；2）核对供电、SIM 卡、天线和信号；3）用最小联网 demo 验证注网、IP_READY、TCP/MQTT 连接；4）在日志中确认是否执行到上报代码、服务器是否回包。提交日志时附上型号、固件版本、SIM 运营商、服务器协议和复现时间，LuaTools 日志目录说明见 https://docs.openluat.com/common/Luatools/ 。

3. 最新固件版本是哪个？

解答： 结论：固件版本会持续更新，不能脱离具体型号、固件类型和日期固定认定某一个版本为“最新”。请在 LuaTools 中选择准确的产品型号和开发方式（LuatOS/AT），通过“固件工具/资源下载”查看当前可下载的正式版本；项目量产还应记录实际使用的固件编号和版本号。AirM2M_780E_V1183_LTE_LSAT 只能代表当时查到的 Air780E 某个固件文件，不应推广到其他型号。LuaTools：https://docs.openluat.com/common/Luatools/

4. 为什么定时一周唤醒却不能唤醒，定时三天也不能？

解答： 结论：先用官方最小定时唤醒 demo 验证底层定时能力，再排查业务代码和低功耗配置。长时间定时失败常见于定时单位/溢出计算错误、唤醒源被外设阻塞、脚本在入睡前异常重启、业务定时器与低功耗唤醒机制混用等情况。操作步骤：1）只保留 pm 初始化和一个明确周期的唤醒任务，用串口记录启动原因和每次唤醒时间；2）先测 1 分钟、1 小时，再逐步加长到 3 天/7 天；3）确认供电、SIM 检测、串口和 GPIO 唤醒脚不会反复触发；4）对比正式固件下的最小 demo 与项目代码差异。若最小 demo 仍失败，需提供型号、固件版本、完整开机至唤醒失败日志，通过 https://docs.openluat.com/ 对应型号文档或官方技术群排查。

5. 量产的时候，三元组怎么传给模组呢？

解答： 结论：量产工具负责烧录统一的 .soc 固件，不把每台设备不同的云平台三元组直接编译进固件；三元组应在产测/首启阶段按设备唯一标识逐台写入。推荐流程：1）LuaTools 生成量产 .soc；2）用合宙量产烧录工具在线版或脱机版烧录，在线版上传 IOT 平台获取固件编号和密码；3）烧录后读取 IMEI/序列号，扫码绑定设备；4）业务首次启动时从自建产测服务器按 IMEI 拉取三元组，写入 fskv 等掉电存储，之后从本地读取并连云。若云平台支持按 IMEI/序列号动态注册，也可由平台侧完成绑定，避免在产线手工输入密钥。量产工具流程见 https://docs.openluat.com/common/Luat_productiontool/ 。

6. AI TVS有什么用？

解答： 结论：该问题缺少“AI TVS”对应的具体型号、原理图位号或应用接口，不能直接按某个器件结论套用。若这里指 TVS（瞬态电压抑制器），其作用是在静电、浪涌或外部高压冲击时快速钳位，保护电源、SIM、USB、UART、RS485 等接口；选型必须结合工作电压、峰值功率、结电容、封装和接口速率，射频/USB/UART 等高速信号尤其要选低结电容型号。建议提供完整型号或原理图位号，并对照对应产品的硬件设计手册、官方核心板原理图和 BOM 核实，未确认前不要随意在射频或高速线上加普通 TVS。官方资料入口：https://docs.openluat.com/

7. 为什么在7735屏幕就什么都显示？

解答： 结论：ST7735（常被写作 7735）属于 SPI 串口屏，能否正常显示取决于底层 LCD 驱动、初始化命令、分辨率、屏幕偏移和 SPI 引脚配置；在 7735 上“什么都显示”，通常说明该 demo 使用的驱动 IC、分辨率和初始化参数与这块屏匹配，并不代表同一份代码可直接适配所有 LCD。排查其他屏幕时，请核对：屏幕驱动 IC 及厂商初始化序列、LCD 类型是 SPI/QSPI/RGB、分辨率与偏移、SPI 时钟和 CS/DC/RST/BLK 接线、所用固件是否包含对应驱动。官方 LCD API 见 https://docs.openluat.com/osapi/core/lcd/ ，具体型号 demo 以 Gitee 官方仓库和对应产品资料为准。

8. 4G信号用PCB板载天线可以吗？

解答： 结论：可以采用 PCB 板载 4G 天线，但不建议在没有射频设计和调试能力的量产项目中直接照搬走线。4G 天线性能与天线净空、铺地、介质常数、板厚、整机外壳、电池/线束遮挡和匹配网络强相关，设计不当会导致发射功率受限、弱网掉线、功耗升高。验证步骤：1）先使用合宙核心板加经过认证的外置/FPC 天线建立基准；2）PCB 天线按对应产品硬件设计手册的射频走线、阻抗和净空要求设计；3）打样后做无源驻波/效率测试及实网 RSRP、SINR、吞吐、弱网对比；4）根据测试结果调整匹配网络并复测，确认通过后再量产。资料请在 https://docs.openluat.com/ 对应型号的硬件设计章节查阅。

9. 有人驱动过7735吗？

解答： 结论：ST7735/7735 类 SPI LCD 属于常见小尺寸串口屏，但应以当前固件和官方仓库实际适配为准，不能仅凭屏幕丝印判断一定免驱可用。请先在 Gitee 官方 LuatOS 仓库对应产品的 LCD demo、库文件和文档中搜索 ST7735、lcd.init、屏幕分辨率等信息；若已有驱动，按屏幕规格书配置方向、偏移、SPI 频率和背光/复位脚。若未列出该 IC，可用同接口 LCD demo 移植初始化序列，先用纯色、边框、字符测试定位偏移和颜色格式。官方 API：https://docs.openluat.com/osapi/core/lcd/ ，官方代码：https://gitee.com/openLuat/LuatOS/tree/master/module 。

10. 上位机通过网络实现远程语音通话和合宙硬件通讯，这个协议是怎么规定？通过TCP/IP能直接通讯吗？

解答： 结论：不能把普通 TCP/IP 连接等同于电话/SIP 语音通话。TCP/IP 只提供网络传输能力；标准网络电话需要 SIP 负责注册、呼叫建立/修改/结束，SDP 协商媒体格式，RTP 承载实时语音，RTCP 反馈质量，RTP/RTCP 媒体流使用 UDP。LuatOS 的标准语音方案基于 exsip 扩展库，当前文档说明 demo 实现了 TCP 方式的 SIP 信令，音频仅支持 PCMU/PCMA，且需要 SIP 服务器和麦克风/喇叭等音频硬件。若上位机是自定义私有协议，也可以基于 TCP/UDP 自行定义信令和音频包，但不能天然与标准 SIP 话机互通。文档：https://docs.openluat.com/osapi/ext/exsip/ 。

11. 请教下采用Air8000W模块，RTU可通过串口实现连网么？

解答： 结论：可以把 RTU 的串口数据接入 Air8000W，再由 LuatOS 脚本通过 WiFi/4G/以太网上报，但 Air8000W 不是“串口 AT 上网模组”，不能让外部 RTU 直接发 AT 指令驱动它联网。实现方式是在 Air8000W 上用 uart 库接收 RTU 协议数据，在脚本中解析/透传，再通过 socket、mqtt、http 等库连接业务服务器。Air8000 产品页明确该系列只支持 LuatOS 二次开发、不支持 AT 指令：https://docs.openluat.com/air8000/product/ 。

12. RTU设备是否可采用Air8000W模块并通过RTU串口和AT指令实现数据主送上报？

解答： 结论：不能通过 RTU 串口向 Air8000W 发送 AT 指令来实现主动上报，因为 Air8000 系列定位为 LuatOS 工业引擎，官方产品页明确不支持 AT 指令开发。可选方案有两种：1）保留现有 RTU 主控，由 Air8000W 运行 Lua 程序，通过 UART 与 RTU 通信并主动把数据上报到服务器；2）若必须使用标准 AT 指令透传，请改用 AT/DTU 形态的合宙模组或成品 DTU。Air8000 型号说明见 https://docs.openluat.com/air8000/product/ ，选型可参考 https://docs.openluat.com/SelectionGuide/SelectionGuide/ 。

13. 通过扩展HUB芯片，RTU通过LAN实现连网也是可行的？

解答： 结论：可以扩展 LAN 联网，但不是任意“HUB 芯片”插上即可，必须使用 LuatOS 已适配的网卡方案，并在 Lua 中完成网卡初始化和数据转发。官方 exnetif 文档已适配通过 SPI 外挂 CH390D/CH390H 以太网控制器和 RJ45 的方案，可把以太网作为高优先级网络，也可与 WiFi、4G 做多网融合；Air8101 产品页同样说明可通过 SPI + CH390H 扩展以太网。RTU 侧仍建议通过 UART 把业务数据交给模组，由模组脚本完成 TCP/MQTT 上报。文档：https://docs.openluat.com/osapi/ext/exnetif/ 。

14. 83/85我去哪里查？

解答： 结论：83/85 属于 LuatOS 软件使用的 GPIO 编号，不能只按芯片管脚名或模组物理脚位查找。请以对应型号的《GPIO 引脚复用表/管脚图》为准，同时核对 pins、gpio 文档中的编号映射；编写代码时使用 LuatOS 固件定义的 GPIO 号，画原理图时使用对应物理脚名，二者不是同一列。查找步骤：进入 https://docs.openluat.com/ 对应产品资料中心，打开产品页中的管脚图/GPIO 引脚复用表，再结合 https://docs.openluat.com/osapi/core/pins/ 与 https://docs.openluat.com/osapi/core/gpio/ 确认。

15. gpio表格明明写的30和32，代码中为什么要用83和85？

解答： 结论：这是“硬件管脚名/物理脚位”和“LuatOS 软件 GPIO 编号”两套编号体系造成的差异，代码必须传入固件定义的软件 GPIO 号。产品管脚表中的 30、32 常用于硬件设计和管脚复用识别；在特定封装/固件映射下，软件 API 使用的编号可能是 83、85。若在 30/32 上读不到 I2C SCL/SDA 波形，应先确认代码引脚号、管脚复用功能、外部上拉和总线地址，再用逻辑分析仪在对应物理脚上测量。请以所使用型号的 GPIO 引脚复用表为准，并参考 gpio、i2c、pins 文档：https://docs.openluat.com/osapi/core/i2c/ 。

16. 请问AIR8101模组只支持H050IWV驱动IC的RGB接口LCD屏吗？

解答： 结论：不是只支持 H050IWV。Air8101 支持 RGB565/RGB888 显示接口，最大支持 1280×720，官方产品页列出的已适配 RGB LCD 包括 NV3052CGRB（720×1280）、HX8282（1024×600）、NT35510（480×854）、GC9503V（480×800）、NT35512（480×800）、H050IWV（800×480）、ST7701SN（480×800）、ST7701S（480×480）和 ST7282（480×272）。未列出的屏幕需要按屏厂初始化时序、RGB 时序参数、背光/复位、分辨率和像素格式单独移植调试。资料：https://docs.openluat.com/air8101/

17. 我想问一下买完Air780EHM，NTRIP协议用自己配置吗？

解答： 结论：NTRIP 不是购买模组后自动生效的运营商功能，需要在 LuatOS 业务中自行配置 Caster 地址、端口、挂载点、账号密码，并把 GNSS GGA 按 NTRIP 协议周期发送。NTRIP 本质上是基于 HTTP/TCP 的差分数据传输，应用负责建立连接、鉴权、发送 GGA 和接收 RTCM 差分数据；若当前官方库未提供专用 NTRIP 客户端，可用 socket 按协议实现，并结合 GNSS 接口完成差分解算。请先核对 Air780EHM 所用固件是否包含所需 GNSS/定位相关能力，再参考 GNSS 教程：https://docs.openluat.com/luatos_lesson/010_luatos_GNSS1/ 。

18. 有人能回答下吗？

解答： 结论：当前问题没有具体现象、型号、日志或截图，无法直接给出技术判断。请补充以下最小信息：1）合宙完整型号和固件版本；2）使用 AT、LuatOS、DTU 还是 iRTU；3）具体故障现象和复现步骤；4）LuaTools 从开机开始的完整日志或 AT 指令交互记录；5）相关接线图、代码片段或报错截图。资料可先在 https://docs.openluat.com/ 按型号检索，代码示例查看 https://gitee.com/openLuat/LuatOS/tree/master/module ，信息补齐后再进行针对性排查。

19. 有电路原理图和pcb的demo嘛官网找不到

解答： 结论：合宙通常会为开发板/核心板提供资料包，其中可能包含原理图、PCB 封装、管脚图、硬件设计指南和 demo，但不同型号公开范围不同，不能只在首页搜索文件名。请按完整型号进入 https://docs.openluat.com/ 对应产品资料中心，依次查看“产品介绍、硬件设计、资料下载、开发板/核心板资料”等栏目；源码和示例工程在 https://gitee.com/openLuat/LuatOS/tree/master/module 对应产品目录。若公开页面未找到原理图/PCB，请记录准确型号和板卡丝印，通过官方技术群或淘宝客服核实该板卡是否公开工程文件。

20. 这个软件能不能给一个旧版的呀，我发现这个新版的点击这个下载脚本，就卡在这了，整个软件关闭也卡的

解答： 结论：优先排查当前安装和烧录链路，不建议仅凭“新版卡顿”长期回退旧版；LuaTools 官方页面保留了版本更新记录，具体历史安装包以官方资源入口提供的文件为准。处理步骤：1）从任务管理器结束残留 LuaTools 进程，重新下载官方 v3 并放到较浅的独立目录；2）检查硬盘剩余空间，关闭电脑蓝牙、杀毒软件和占用串口的其他工具；3）更换短于 1 米、带 DP/DM 的优质数据线和 USB 口；4）先点击下载进入等待，再让设备断电并按住 BOOT 上电；5）保留工具目录 log 下的日志用于定位。教程和版本记录：https://docs.openluat.com/common/Luatools/ ，烧录排查：https://docs.openluat.com/common/howtodown/ 。

21. 这个板支持 wifi,4g,蓝牙，电源输入是12V，是吗？

解答： 结论：不能仅凭照片或“开发板支持 WiFi、4G、蓝牙”推断供电和通信能力，必须以板卡丝印、具体模组型号和硬件手册为准。若该板的 VIN 输入引脚标称支持 12V，可从 VIN 供电，但模组本体通常不是直接承受 12V，板上电源电路会降压到模组工作电压。WiFi/4G/蓝牙还要区分具体型号：例如 Air8101 支持 2.4G WiFi6 和 BLE 5.4，但本身不是 4G 模组，需要通过 AirLink 外挂 4G 模组；Air8000W 的功能配置也需按型号后缀确认。请提供板卡正反面丝印或对应产品页链接后再核对。Air8101 资料：https://docs.openluat.com/air8101/

22. 这个电路板支持蓝牙吗？

解答： 结论：要同时确认“板上模组是否支持蓝牙”和“电路板是否把蓝牙天线/射频资源引出并完成匹配”，两者不能混为一谈。若板载的是 Air8101，官方资料明确 Air8101 支持 BLE 5.4，其中 Air8101/Air8101B 为板载天线版本，Air8101A/Air8101C 无板载天线，需要在整机 PCB 上设计天线；若为 Air8000 系列，也要按 A/W/D/T 等后缀确认是否具备 WiFi/BLE 硬件。请提供板卡丝印、模组型号和正反面照片，再对照产品页天线及管脚说明核实：https://docs.openluat.com/air8101/

23. 780E 是不是买不到了？

解答： 结论：Air780E 的零售/批量供货状态、起订量和交期应以合宙官方店铺及销售回复为准，技术支持不能替代库存确认。新立项项目建议同时评估当前主推的 Air780EPM/EHM 等在产型号，可获得更活跃的固件和文档支持；若为已量产维护项目，请保留准确订货型号并通过官方淘宝店或企业采购渠道确认供货。选型与在产型号参考 https://docs.openluat.com/SelectionGuide/SelectionGuide/ ，样品购买入口 https://luat.taobao.com/ 。

24. 请问780EPT 和 EHT 的规格书在哪里可以下载？

解答： 结论：Air780EPT、Air780EHT 属于 AT 固件型号，规格书和 AT 指令资料应在合宙 AT 模组资料中心下载。请从 https://docs.openluat.com/atmozu/product/shouce/ 进入对应型号栏目，核对完整型号、硬件版本和文件版本；公开的 AT 指令手册文件名通常包含 Air780EHT、Air780EPT 等型号。若页面未直接展示所需硬件规格书，请在该产品页的“资料下载/硬件手册”栏目或官方技术群中提供完整丝印型号索取，不建议使用其他型号文档替代。

25. 给的链接无效

解答： 结论：请不要继续使用失效链接，先从官方文档站首页或对应产品资料中心重新进入，避免复制到临时页、旧域名或带权限的页面。处理步骤：1）打开 https://docs.openluat.com/ ，按完整型号搜索或从产品目录进入；2）工具类资料从“LuatOS 开发工具大全”进入，例如 LuaTools 页面为 https://docs.openluat.com/common/Luatools/ ；3）代码从 https://gitee.com/openLuat/LuatOS/tree/master/module 对应产品目录进入；4）若仍提示 404，请记录完整链接、访问时间和页面截图，通过官方技术群反馈文档链接失效。

26. 请问780ehv能开启Redis吗，一开我的卡就发现不了串口是什么原因？

解答： 结论：这里大概率是指 USB RNDIS 虚拟网卡，而不是数据库 Redis。开启 RNDIS 后，设备在电脑上可能优先枚举为网卡，原虚拟串口数量/端口名发生变化，因此看起来“发现不了串口”。排查步骤：1）打开 Windows 设备管理器，确认是否新增网络适配器以及是否仍有 COM 口；2）按 Air780EHV 对应 RNDIS/ECM demo 的标准顺序执行，避免业务脚本与网卡配置冲突；3）先使用支持该功能的固件和最小 demo，必要时飞行模式下切换 USB 以太网模式后再退出；4）保留物理 UART 作为调试口，避免 USB 枚举变化后看不到日志；5）如果完全不枚举，再按 USB 线、驱动、BOOT 下载模式和供电排查。RNDIS 资料以 https://docs.openluat.com/ 对应型号页面和 demo 为准，烧录排查见 https://docs.openluat.com/common/howtodown/ 。

27. ai问答登录后一直还要让登录

解答： 结论：这通常是浏览器 Cookie、第三方 Cookie、缓存跳转或登录态域名未共享导致的问题，不等于 AI 服务账号未登录成功。处理步骤：1）使用新版 Chrome 或 Edge，打开无痕窗口重新登录；2）确认浏览器允许该站点 Cookie，未开启全局“阻止所有 Cookie”或严格跟踪保护；3）清除 openluat.com、luatos.com 相关站点数据后关闭浏览器重开；4）核对系统时间、代理/VPN 和企业安全策略；5）换网络并重新访问官方 AI 入口。若仍重复跳转，请保留浏览器控制台报错、URL 和时间点反馈官方支持。

28. Air780EPM使用1040和1050摄像头拍照都会有一些黑点，这个有参数可以调吗？

解答： 结论：固定位置黑点通常不是曝光、亮度等普通参数能消除的问题，优先怀疑镜头/保护膜脏污、Sensor 坏点、焊接或硬件损伤；不同摄像头在同一位置都出现黑点时，还要检查模组 FPC 接座、电源噪声和代码取像/缩放算法。处理步骤：1）撕掉镜头保护膜，用无尘布清洁镜头，分别拍摄纯白、纯黑、室外均匀画面；2）更换同款及不同款摄像头、连接座和主板交叉验证；3）使用官方 camera/excamera 最小拍照 demo，保存原图，不经过业务裁剪和压缩；4）检查 FPC 是否反接、压伤，供电纹波是否正常；5）若黑点位置随摄像头变化，属于摄像头个体/来料问题，若固定在主板画面同一位置，检查主板和软件。官方摄像头 API：https://docs.openluat.com/osapi/core/camera/

29. 这个模块经常出现net_lwip_tcp_err_cb error -13，正常吗？

解答： 结论：频繁出现 net_lwip_tcp_err_cb error -13 不是可忽略的正常现象。socket 文档中 -13 表示模块主动断开连接，常见诱因包括长时间无数据触发保活/超时、弱网或切换网络后链路失效、本地资源不足、TLS/业务异常后主动关闭、服务器或中间网络设备先半关闭而本端清理连接等。排查步骤：1）记录断线时 RSRP/SINR、注网状态、IP_READY 和是否切换基站；2）服务器端同时查看 TCP 状态和关闭原因；3）设置合理的应用层心跳和 TCP keepalive，避免 NAT 老化；4）收到错误后关闭旧 socket 并按退避策略重连；5）升级正式固件，保留完整底层日志。错误码说明见 https://docs.openluat.com/osapi/core/socket/ 。

30. Air780EHM/780EHV/780EGH的SIP通话只有audio_v2支持sip_4G桥接通话吗？

解答： 结论：SIP 网络语音能力首先要求模组固件包含 exsip，并具备对应的音频硬件和音频框架；sip_4G 桥接通话属于特定桥接能力，应以所用固件中 exsip/音频 demo 的适配说明为准，不能简单理解为“只要支持 audio 就一定支持桥接”。在当前已确认的方案说明中，支持音频的型号可运行 SIP 通话相关能力，而 sip_4G 桥接通话按 audio_v2 方案适配。选型时还要区分 Air780EHM、Air780EHV、Air780EGH 的 Codec/语音资源差异，建议先获取对应型号 SIP demo 和固件功能列表验证。文档：https://docs.openluat.com/osapi/ext/exsip/

31. 设备离线，TCP连接出现异常，怎么处理？

解答： 结论：TCP 离线是蜂窝网络、服务器、DNS/TLS、长连接保活和业务重连策略共同作用的结果，设备端必须把断线重连作为正常流程处理。排查步骤：1）监听网络状态，确认离线时是否仍驻网、是否有 IP、信号是否过弱；2）在 socket 回调中记录完整返回值，-13 为模块主动断开，-14 为服务器主动断开；3）服务器端查看是否 RST、超时或负载均衡断连；4）增加应用心跳、TCP keepalive 和指数退避重连，重连前关闭旧连接；5）网络长时间未恢复时可飞行模式重启协议栈，谨慎使用整机复位作为兜底。错误码见 https://docs.openluat.com/osapi/core/socket/ 。

32. SIM卡锁死了，模块连不上网要过好久才休眠，怎么处理？

解答： 结论：PIN/PUK 锁死的 SIM 卡无法通过模组自动解锁，协议栈会持续尝试读卡和注网，因此进入休眠变慢属于异常卡状态下的重试现象。处理步骤：1）先把该卡装入手机，按运营商流程输入正确 PIN/PUK 解锁，PUK 输错次数超限后只能换卡；2）业务启动时先读取 SIM 状态，发现 PIN/PUK 锁定、无卡或 SIM 异常时不要反复发起联网，可直接进入受控低功耗并上报告警；3）检查卡座焊接、卡方向、ESD/TVS 和 SIM 走线，排除接触不良导致的误判；4）更换已知正常的移动/电信/联通卡交叉验证；5）若正常卡也延迟休眠，再抓取注网、SIM 和 PM 日志分析。相关移动网络 API：https://docs.openluat.com/osapi/core/mobile/

33. 客户反馈AirM2M_780E_V1167在运营商反应活动态频繁发TAU导致被运营商踢掉，更新固件能解决吗？

解答： 结论：不能把根因简单归结为固件版本，频繁 TAU 通常与设备活动态周期、网络注册参数、APN 保活和运营商策略有关；升级固件可能包含协议栈优化，但是否解决必须以运营商日志和升级前后对比为准。建议先从运营商侧取得 IMEI、时间点和 TAU 触发原因，同时在设备端检查应用是否周期性唤醒、重建数据链路或频繁飞行模式切换；在满足业务时延的前提下拉长心跳/唤醒/数据上报间隔，避免无意义活动态更新。随后升级到当前正式固件做 A/B 对比，并保留 CP/AP 日志。若升级后仍被踢下线，需将运营商日志与模组日志提交官方分析，入口见 https://docs.openluat.com/ 。

34. lcd.image2raw接口支持选择返回RGB565和RGB888格式的RAW数据和图片长宽？

解答： 结论：按当前官方 lcd 文档，函数签名为 lcd.image2raw(file)，仅列出 file 一个参数，没有公开“选择 RGB565/RGB888 输出格式”或“指定图片长宽”的参数，因此业务代码不应假设可通过该接口直接选择输出格式。该接口用于把图片文件解码为可供脚本处理的 RAW 数据；实际返回数据结构、像素格式和尺寸应以所使用固件版本的官方 demo 返回值实测为准，并结合屏幕初始化的像素格式处理。若需要缩放或色彩转换，应在脚本侧按返回数据处理，或使用图形/AirUI 相关能力。文档：https://docs.openluat.com/osapi/core/lcd/

35. win11家庭版，ai给的方法都试了，还是不行，有办法彻底解决吗？

解答： 结论：Win11 家庭版可以运行 LuaTools，问题要先定位到驱动签名、串口枚举、USB 连接还是工具安装本身，不能以等待签名证书作为唯一处理方式。处理步骤：1）确认系统为 Win10 及以上，使用官方最新 LuaTools，并放到磁盘浅路径、以管理员身份运行；2）Air780/Air8000/Air8201 系列按官方说明无需安装 Windows 驱动，Air722/724/720/795/820 需安装 USB 驱动；3）更换短于 1 米且带数据针脚的 USB 线和直连 USB 口，关闭电脑蓝牙和 VPN/安全软件；4）若为旧平台驱动签名拦截，记录设备管理器的硬件 ID、报错代码和截图，再按 Windows 提示处理或反馈官方；5）按 BOOT 下载流程验证。官方排查：https://docs.openluat.com/common/howtodown/

36. 4G，以太网，WIFI都用了，发现以太网，WIFI工作一会就会提示异常，该怎么办？

解答： 结论：这是多网优先级检测和链路可用性配置问题，不能只通过更换某个固件版本判断。exnetif 会按优先级持续检测网络，默认可能通过 ping 外网判断链路；如果以太网/WiFi 实际只能访问内网、禁止 ICMP、网关无外网或 DNS/ping 目标不可达，就会被判定异常并回落到 4G。处理步骤：1）在 exnetif.set_priority_order 中为内网场景设置 need_ping = false 或 local_network_mode = true；2）允许 ping 时把 ping_ip 改成链路上稳定可达的固定地址，并合理设置 ping_time；3）分别单独测试以太网、WiFi、4G，确认网卡初始化和 IP_READY 正常；4）检查 CH390 供电、SPI 接线、中断脚和 WiFi 信号；5）确认固件已包含当前 exnetif 版本。文档：https://docs.openluat.com/osapi/ext/exnetif/

37. 我配置了exnetif.check_network_status(20000)，日志显示自动切换成了4G？

解答： 结论：这是 exnetif 的预期行为。exnetif.check_network_status(20000) 表示按约 20 秒周期检查当前网络状态；当高优先级的以太网或 WiFi 未通过连通性检测、IP 丢失、网关不可达或 ping 失败时，库会自动降级到低优先级的 4G，以保证业务连接不中断。若设备处于内网，应在 set_priority_order 中配置 local_network_mode = true，或设置 need_ping = false/使用内网稳定可达的 ping_ip，避免因无法访问默认外网探测地址而误切换。切换后还要注意 auto_socket_switch 的行为，必要时手动重连 MQTT/TCP。文档：https://docs.openluat.com/osapi/ext/exnetif/

38. ping失败后状态变成了OPENED，这个逻辑问题会修复吗？

解答： 结论：网卡状态 OPENED 与 ping 检测通过不是同一个概念，OPENED 只能说明网卡/链路已初始化或获得网络接口，不代表外网一定可达。多网管理中需要区分三层状态：驱动和网卡已打开、已获取 IP/链路就绪、ping 目标可达；内网禁 ping、网关无外网、DNS 或路由异常时，前两者可以成功但 ping 失败。建议在状态回调中同时记录网卡类型、IP_READY、ping 结果和当前默认路由，业务以最终连通性结果决定是否发送数据；内网环境配置 local_network_mode = true 或改用稳定内网探测地址。是否调整日志命名或状态机，请以 exnetif 当前版本说明和官方更新为准：https://docs.openluat.com/osapi/ext/exnetif/

39. AIR700E只支持移动4G吗？

解答： 结论：Air700E 系列定位为中国移动网络型号，不能按全网通型号选型；频段细分以对应型号硬件规格书为准。当前选型资料中，Air700E、Air700ECP、Air700ECH 均面向中国移动网络，资源配置不同，Air700ECP 为 4MB+4MB，Air700ECH 为 8MB+8MB；若项目需要电信、联通卡或海外网络，应选择明确标注全网通或目标区域频段的型号。选型时请核对规格书中的 LTE-TDD/LTE-FDD Band，不要只依据模组名称判断。选型入口：https://docs.openluat.com/SelectionGuide/SelectionGuide/ ，Air8700P/H 与 Air700ECP/ECH 对应关系见 https://docs.openluat.com/air8700/luatos/hardware/module/model/ 。

40. 怎么分得是700E还是700ECP和700ECH？

解答： 结论：优先通过模组丝印/订货型号、IMEI 标签和软件返回的硬件信息三者交叉识别。LuatOS 可运行官方 hmeta 最小 demo，使用 hmeta.model() 读取模组名称，hmeta.hwver() 读取硬件版本，hmeta.chip() 读取原始芯片型号；4G 模组还可用 hmeta.devid() 读取 IMEI。识别时不要只看板卡名称，例如 Air8700P 板载 Air700ECP，Air8700H 板载 Air700ECH。若丝印磨损，以订货记录和规格书标签为准。hmeta 文档：https://docs.openluat.com/osapi/core/hmeta/

41. AIR700ECT有移动FDD吗？

解答： 结论：Air700ECT 属于面向中国移动网络的 AT 型号，项目资料按支持中国移动相关 FDD/TDD 频段描述；但“具体支持哪些 Band”必须以该型号最新硬件规格书和入网信息为准，不能用其他 Air700Exx 型号替代。设计和送样前建议向官方渠道索取 Air700ECT 规格书，重点核对 LTE-FDD、LTE-TDD Band 列表、固件类型和运营商认证状态。AT 指令与型号资料入口：https://docs.openluat.com/atmozu/product/shouce/ ，选型总览：https://docs.openluat.com/SelectionGuide/SelectionGuide/ 。

42. AIR700ECT支持电信联通吗？

解答： 结论：Air700E/ECP/ECH/ECT 均按中国移动网络型号设计，不应承诺支持中国电信、中国联通网络。即使个别 SIM 卡在测试环境能搜网，也不能作为量产依据，最终取决于硬件频段、运营商入网认证和固件配置。若设备需要三网通用，请改选明确标注全网通的 Air780EPM/EHM/EHV 等型号，并在选型指南和规格书中核对目标运营商频段。选型入口：https://docs.openluat.com/SelectionGuide/SelectionGuide/ ，全网通 Air780EPM/EHM 资料：https://docs.openluat.com/air780epm/product/ 。

43. Air780EGP实测过程中，移动模块位置超过100m后将近10min后才有数据变化，有什么方案可以满足5s一次定位更新的要求吗？

解答： 结论：先确认 GNSS 是否真正定位成功以及是否开启了静态抑制；5 秒一次更新用 1Hz 定位即可满足，但移动后约 10 分钟才变化不应视为正常动态轨迹。exgnss.setup 支持 hz=1/2/4/5，也支持 static=1..100（单位 cm/s）静态抑制；开启静态抑制后，速度低于阈值会持续上报最后一条位置，直到速度超过阈值。排查步骤：1）关闭或调高 static 阈值做动态对比；2）日志中记录 GGA/RMC 的 fix 状态、卫星数、HDOP、经纬度和速度；3）确认 AGPS 打开、天线为有源 GNSS 天线且在开阔天空测试；4）设置 hz=1 即每秒输出，业务每 5 秒取一次；5）若位置仍不变化，检查 GNSS 天线、供电和遮挡。文档：https://docs.openluat.com/osapi/ext/exgnss/

44. 我们一个项目要求定位5s更新一次，误差5m，AIR780EGP能满足吗？

解答： 结论：5 秒更新一次在接口能力上可以满足，exgnss.setup 支持 1/2/4/5Hz，默认 1Hz 每秒定位一次，业务每 5 秒取点即可；但 5 米误差属于场景指标，不能在遮挡、室内、城市峡谷、天线受干扰的环境下无条件承诺。开阔天空、卫星数充足、HDOP 较好且完成辅助定位时，GNSS 更容易达到米级动态定位效果。项目验证时应在实际安装位置和运动路线记录 GGA/RMC、卫星数、HDOP、速度和轨迹偏差，必要时配合 AGPS、合适的有源天线和 NTRIP 差分。文档：https://docs.openluat.com/osapi/ext/exgnss/

45. 4G模块使用过程中发生无法上网的情况，更换普通手机卡可以上网，换回物联网卡又正常，这种情况遇到过么？

解答： 结论：换手机卡能上网、再换回物联网卡恢复，问题通常不在某一个固定代码点，而在物联网卡状态、APN、机卡绑定、运营商网络策略、SIM 接触或异常恢复逻辑。排查步骤：1）在运营商平台核查物联卡是否激活、停机、限速、过期、是否绑定 IMEI/APN，以及是否有专网定向限制；2）复现时记录 SIM 状态、注网状态、信号、IP_READY、APN 和模组日志；3）同一位置用手机卡和物联卡多次交叉测试，并更换同运营商不同物联卡；4）检查卡座、SIM 走线、ESD、低功耗唤醒后的重新注网逻辑；5）网络异常时按状态机重驻网/重连，而不是等待业务超时；6）升级当前正式固件验证。移动网络接口见 https://docs.openluat.com/osapi/core/mobile/ 。

46. AIR530Z有2米定位精度的测试报告吗？

解答： 结论：是否有“2 米定位精度测试报告”必须以 Air530Z 公开资料或官方质量/认证渠道提供的正式报告为准，技术支持不能口头替代测试报告。GNSS 精度受开阔度、卫星数、HDOP、多径、天线、差分辅助和测试方法影响，单次实测定格不能作为量产承诺。操作步骤：1）在 https://docs.openluat.com/ 进入 Air530Z 资料页查找测试报告、数据手册和实测数据；2）若公开页面未提供 2 米精度报告，请通过官方技术群或采购渠道提交完整型号、应用场景和报告用途索取；3）项目关键指标应在实际安装环境中按统一测试方法做对比验证。

47. 通过TOOL下载脚本的时候会出现问题，导致无法下载脚本，怎么办？

解答： 结论：按官方烧录排查顺序处理，不能先归因于“电涌”。Air780/Air8000/Air8201 系列通常无需安装 Windows 驱动，请依次检查：1）使用长度小于 1 米、带屏蔽且具备 DP/DM 的优质数据线，排除只充电线；2）确认硬盘剩余空间充足，关闭 PC 蓝牙、其他串口工具和安全软件拦截；3）模组断电，LuaTools 点击“下载”进入等待后，按住 BOOT 再上电，必要时长按开机键，开始下载后松开；4）用合宙核心板或另一台电脑对比，区分自研板硬件问题；5）保留 LuaTools log 目录日志。官方步骤见 https://docs.openluat.com/common/howtodown/ ，工具教程见 https://docs.openluat.com/common/Luatools/ 。

48. 合宙现在有没有离线语音唤醒的功能？

解答： 结论：离线语音唤醒需要低功耗语音前端、唤醒词引擎、麦克风输入和相关音频处理资源，不能仅凭通用 audio/录音 API 判断已具备完整功能；当前是否已有可量产方案，应以具体型号的固件功能列表和官方语音 demo 为准。方案上可分两类：1）对唤醒功耗和离线识别要求高的项目，优先选用专用离线语音芯片/模块，通过 UART/GPIO 与合宙 4G 模组联动；2）在主控资源和麦克风硬件满足要求时，基于官方音频接口评估软件唤醒方案，并同步解决 AEC、降噪、双麦/单麦、底噪和功耗。请提供目标型号、待机功耗、唤醒词数量和麦克风方案后，再在 https://docs.openluat.com/ 对应产品音频章节核实。

49. 780EHV只支持单路Mic吗？两个音源并到一起通过关闭偏置电压能实现吗？

解答： 结论：不应把两路麦克风直接并接到一个 Mic 输入，也不能依赖关闭内部偏置电压来切换两个音源。麦克风偏置、输入阻抗、极性、共模电平及音频通道由硬件设计决定，直接并联会造成偏置负载异常、两路信号互相干扰、底噪增大甚至录音失真。Air780EHV 的具体可用 Mic 通道数以该型号硬件设计手册和音频 demo 为准；若需要双音源，应采用以下方案之一：选择原生支持多路 Mic 输入的硬件设计、使用外部模拟开关/音频 Codec 并保证切换时偏置和阻抗正确，或改为数字麦克风/外部音频处理方案。设计前请对照官方原理图与 https://docs.openluat.com/ 对应音频资料评审。

50. 你们预计多久能出双音源方案？

解答： 结论：技术沟通中不应承诺“至少两周”等未经发布流程确认的排期，具体方案和时间以官方产品路线图、固件发布记录或商务正式回复为准。若项目时间紧张，建议并行推进可落地的硬件方案：按双 Mic/双音源需求选择原生支持足够音频通道的型号，或使用外部音频 Codec、模拟开关、独立语音前端，先完成原理图评审和样机验证，再根据官方固件支持情况更新软件。请通过官方技术群或商务渠道提供需求表（型号、Mic 数量、采样率、AEC、唤醒、目标功耗和量产时间）获取正式方案。资料入口：https://docs.openluat.com/

51. Air780 GNSS搜星大概需要多长时间？

解答： 结论：冷启动首次定位通常需要约 35 秒，但实际时间与星历是否有效、AGPS 是否启用、天空开阔度、天线性能、射频干扰和是否为冷/温/热启动有关。exgnss 文档说明，不启用辅助定位时，下次可能进入冷启动，约 35 秒；开启 AGPS、保留有效星历且卫星条件良好时，定位会更快，而室内遮挡、天线接反或供电不稳可能长时间无法 FIX。验证时请记录启动方式、GGA 定位状态、可见/参与定位卫星数、HDOP 和原始 NMEA 日志。文档：https://docs.openluat.com/osapi/ext/exgnss/

52. 如何添加设备AIR8783以及如何使用？

解答： 结论：先确认 AIR8783 的实际使用形态和固件类型，再决定是在 IOT 平台添加设备、设置设备归属，还是仅作为 USB 上网/短信转发设备使用。若设备运行合宙云固件，需要先在对应平台账号下创建设备或项目，再按设备 IMEI/序列号完成归属和固件升级；电商渠道设备可通过 crm.luatos.com 处理归属，线下/IOT 批量设备通过 iot.openluat.com 的“我的设备/批量转移”等入口处理。设备归属步骤可参考 https://docs.openluat.com/air780epm/product/attributioniot/ ，但 AIR8783 的具体功能和限制仍应以其产品页或选型指南为准。

53. 项目没有办法删除，删了会自己重新创建？

解答： 结论：项目删除后又出现，通常是项目下仍有设备归属，或设备脚本仍在使用原项目的产品信息上线，平台根据上报数据重新建立了项目/设备关系。处理步骤：1）进入 IOT 平台项目详情，确认是否还有设备、分组、固件、定时任务或规则关联；2）先迁移或删除项目下设备，并解除产品/固件绑定；3）暂停设备上线或修改脚本中的项目/产品参数，避免旧三元组继续上报；4）刷新页面确认账号和企业空间选择正确；5）若平台提示项目不可删除，按提示处理关联资源。平台入口：https://iot.openluat.com/

54. nvm为什么会存不上数据了？是有读写次数限制还是什么原因？

解答： 结论：存不上不一定是 Flash 寿命耗尽，更常见是键值初始化失败、写入时机过早、剩余空间不足、异常断电、Key/数据长度或写入频率不合理。LuatOS 推荐使用 fskv 做掉电键值存储，底层 Flash 确实有擦写寿命，因此不能把 KV 当成高频日志区持续写入。排查步骤：1）检查 fskv.init、fskv.set 返回值和错误码；2）确认写入前文件系统/KV 已初始化，写入后再重启或断电；3）减少周期性写入，合并数据并做脏标记；4）读取剩余空间并尝试清理非必要键；5）备份重要数据后在明确影响的前提下清 KV/文件系统验证；6）若怀疑硬件寿命，记录擦写频率、运行时长和日志提交分析。fskv 文档：https://docs.openluat.com/osapi/core/fskv/

55. 触摸屏gt911初始化不成功，I2C通信异常？

解答： 结论：GT911 初始化失败优先查硬件连接、供电时序、I2C 地址/引脚号和中断/复位时序，不能先认定触摸芯片需要另烧固件。排查步骤：1）用逻辑分析仪或示波器确认 SCL/SDA 有波形、地址有 ACK，检查上拉电阻、电平、接线和引脚复用；2）确认 RST、INT 引脚与代码一致，按 GT911 要求完成复位和中断配置时序；3）核对触摸板 I2C 地址选择、3.3V/1.8V 供电和上电延时；4）用官方 i2c、tp/extp 最小 demo 扫描地址，排除业务代码占用引脚；5）向屏厂确认 GT911 是否需要预配置或出厂参数。I2C 文档：https://docs.openluat.com/osapi/core/i2c/

56. 如何快速找到合宙的日志串口？

解答： 结论：最快的方法是让设备进入正常开机和 BOOT 两种状态，对比 Windows 设备管理器中的 USB 串口变化，并结合 VID/PID、端口名称和枚举顺序识别。操作步骤：1）打开设备管理器“端口（COM 和 LPT）”；2）拔掉设备记录原端口，再插入设备查看新增 COM；3）双击端口，在“详细信息-硬件 ID”中核对 USB VID/PID；4）进入 BOOT 模式时通常只出现一个 boot 端口，正常开机后可能枚举出日志、AT/数据等多个端口；5）在 LuaTools 中选择带 trace 输出的端口，打开日志窗口确认有开机打印。LuaTools 日志目录说明见 https://docs.openluat.com/common/Luatools/ 。

57. 内网环境需要怎么处理或者说怎么配置呢？

解答： 结论：内网环境不要继续使用默认外网 ping 探测，否则 exnetif 可能因 ping 不通公网而把以太网/WiFi 判定异常并切到 4G。配置以太网或 WiFi 优先级时，可将该网络的 need_ping 设为 false，仅依据 IP_READY/链路状态判断；或设置 local_network_mode = true，让库按局域网模式处理；如果需要严格探活，则把 ping_ip 配置为内网固定、允许 ICMP 且长期在线的地址，并按需设置 ping_time。同时确认业务服务器地址、DNS、网关和路由在内网可达；若关闭 auto_socket_switch，网卡切换后业务要自行断开并重连 MQTT/TCP。文档：https://docs.openluat.com/osapi/ext/exnetif/

58. 用取件码开柜，没有打印串口接收内容，485通讯可以发送收不到接收数据？

解答： 结论：能发送、收不到，先把隔离 485 的参考地接好，再按方向控制、串口参数、接线和回调四步排查。原因：板上是隔离型 RS485，A/B 是差分信号线，但隔离收发器和隔离电源的副边仍需要一个稳定的参考地；只接 A/B、不接信号地，双方地电位差较大时共模电压超出收发器范围，就会出现只能发不能收或乱码。操作步骤：1）将板上隔离侧的 GND 与锁控板/对端 485 接口的地相连（注意是隔离侧地，不是直接短接系统主地），A 接 A、B 接 B，必要时在总线两端各加 120Ω 终端电阻；2）确认收发方向引脚在发送后置为接收态，半双工 485 方向控制时序不对会直接收不到回复；3）核对两边波特率、数据位、校验位、停止位完全一致；4）确认串口接收回调已注册并在回调里 log.info 打印数据，先用回环或串口助手验证收发。仍异常时用示波器/逻辑分析仪抓 A/B 差分波形和方向脚时序，区分是对端没回复还是本端没收到。参考：https://docs.openluat.com/osapi/core/uart/

59. 新版本DTU不支持配置阿里云腾讯云这些了吗？

解答： 结论：仍然支持连接阿里云、腾讯云等第三方 MQTT 服务器，只是配置入口从旧 DTU 平台迁到了新的 iRTU 配置平台。原理：iRTU 是参数配置后台，负责把“要连接哪个云、地址/端口、三元组或用户名密码”等参数下发给设备；设备本质是标准 MQTT/TCP 客户端，并不限定只能连合宙平台。操作步骤：1）登录新平台 https://iot.openluat.com/irtu/project-list ；2）新建或进入对应项目，在云平台/连接参数页面把 Broker 地址、端口、ClientID、用户名、密码等按阿里云/腾讯云的物模型或直连规则填写并提交；3）重启设备，设备开机会同步一次配置，设备参数版本与项目参数版本一致即生效；4）连接后的 topic、物模型、数据解析仍在阿里云/腾讯云控制台配置。文档：https://docs.openluat.com/value/irtu/web/

60. 780EPM刷的iRTU 5.0.4 DTU配置没有更新成功？

解答： 结论：Air780EPM 属于新型号，必须使用新 iRTU 配置平台 https://iot.openluat.com/irtu/project-list ，旧平台 dtu.openluat.com 已停止维护，在旧平台下发的配置 EPM 不会获取。配置未生效按以下顺序排查：1）确认设备 IMEI 已归属到当前账号且在目标项目分组下，跨账号或未归组会导致拉不到配置（归属方法见 https://docs.openluat.com/air780epm/product/attributioniot/ ）；2）在新平台修改参数后必须逐页提交，设备只在开机时与后台同步一次，已在线的设备需要重启才会拉取；3）在设备列表核对“设备参数版本”与“项目参数版本”，一致才表示已获取；4）确认设备已正常注网联网（IP_READY），否则无法连接配置服务器；5）若设备处于“未分组”或被转到免配置项目，也不会获取参数。配置平台说明：https://docs.openluat.com/value/irtu/web/

61. Air780ehu出厂固件是AT固件，能否通过IoT后台远程刷成LuatOS固件？

解答： 结论：不能通过 IoT 后台远程把 AT 固件刷成 LuatOS 固件，首次从 AT 切换到 LuatOS 必须用 LuaTools 本地烧录。原理：LuatOS 的 FOTA（libfota/libfota2）运行在 LuatOS 体系内，升级对象是 LuatOS 的 core（差分）和 script（全量覆盖）；AT 固件与 LuatOS 固件是两套不同的底层固件体系，AT 固件里没有 LuatOS 的 FOTA 流程，因此不会响应 LuatOS IoT 平台下发的升级包。可操作步骤：1）安装 LuaTools（https://docs.openluat.com/common/Luatools/ ）；2）选择 Air780EHU 对应的 LuatOS 官方底层固件和脚本，勾选“下载底层和脚本”本地烧录；3）烧成功后设备即进入 LuatOS 体系，之后同体系内的 core/script 升级才能走 FOTA 远程升级（https://docs.openluat.com/osapi/ext/libfota/ ）。若本地烧录识别不到端口，按 https://docs.openluat.com/common/howtodown/ 排查线缆、驱动和 BOOT 模式。

62. 做人脸识别用推荐air8101还是哪个呢？

解答： 结论：合宙选型指南中没有标注任何一款模组内置“人脸识别算法”，因此不能把某个型号直接等同于人脸识别成品；若方案是“本地采集图像 + 屏幕交互 + 上传到服务器做人脸比对”，Air8101 是选型指南里多媒体能力最匹配的型号；若要在设备端离线做人脸检测/识别，需自行评估并移植算法，不能按现成功能选型。依据（选型指南与 Air8101 资料中心）：Air8101 是 2.4G WiFi6 + BLE5.4 多媒体 SoC，支持 DVP/UVC 摄像头（最大 200W 像素拍照，可外接多路但同一时刻只能用一路）、RGB565/RGB888 最大 1280×720 显示和触摸，并基于 LVGL9.4 提供 AirUI 图形库，适合做人脸采集终端；但官方资料未提供人脸识别算法库。建议步骤：1）明确是云端比对还是本地离线识别、活体检测、人脸库规模、识别速度要求；2）云端比对可选 Air8101 采图，配合自建服务器实现；3）需要蜂窝网络时可用 Air8101 经 AirLink 外挂 Air780EPM 等 4G 模组；4）以选型指南逐项核对后再定型号。选型指南：https://docs.openluat.com/SelectionGuide/SelectionGuide/ ，Air8101 资料：https://docs.openluat.com/air8101/

63. AI访问不了？

解答： 结论：先确认“AI”具体指哪个入口（合宙 AI 问答平台、iot.openluat.com 控制台，还是 Trae 里的 luatos-docs-code 智能体），再按网络、账号、浏览器三步排查，目前无法仅凭“访问不了”定位。可操作步骤：1）先打开 https://docs.openluat.com/ 和 https://iot.openluat.com/ 验证是整站不通还是单个页面异常；2）换网络（手机热点）、关闭代理/VPN/公司防火墙后重试，排除内网拦截；3）用 Chrome/Edge 无痕窗口打开，清除该站点 Cookie 与站点数据，确认系统时间正确，再重新登录；4）若提示登录后仍反复要求登录，重点检查是否禁用了第三方 Cookie；5）Trae 智能体不可用时，按 https://docs.openluat.com/ai/trae%2Bluatos-docs-code/question/ 的问题汇总核对版本并更新插件。若以上仍不通，请记录具体网址、报错截图、时间和运营商网络，通过 docs.openluat.com 底部官方企业微信群反馈。AI 专区入口：https://docs.openluat.com/ai/

64. 这个目前可能还不是很方便给出来，你们能过来趟最好（指原理图PCB）？

解答： 结论：是否安排现场支持需通过商务渠道确认；但无论线上还是现场，评审或改版都需要先有明确的设计输入。仅说“修改电路板”无法直接开展，必须知道要改什么。建议按以下清单准备资料后提交给对接销售或官方企业微信：1）现有原理图、PCB 图或至少提供完整的功能框图、接口定义和引脚连接表；2）当前问题现象（如某接口不通、功耗偏高、音频有噪声）及测试波形/日志；3）本次改版目标（增减接口、换型型号、天线/电源调整、尺寸/结构限制等）；4）目标型号、量产数量和时间节点。资料越完整，定位和改版越准确；涉及电路评审服务可参考 https://docs.openluat.com/value/drawcheck/ 。商务与服务入口：https://luat.taobao.com/ 或 docs.openluat.com 底部官方企业微信群。

65. 用你们的8000W芯片替换现有的724UG，有技术能支持下吗？

解答： 结论：可以基于 LuatOS 做迁移，但 Air724UG（RDA8910 平台，老 LuatOS-Air/LuatTask 体系）与 Air8000W（Air8000 系列多网融合 SoC，仅支持 LuatOS、不支持 AT）在硬件封装、引脚、外设和固件体系上都不兼容，属于重新设计而非直接替换。迁移要点：1）硬件上按 Air8000W 硬件设计手册重新做原理图、PCB、供电、天线和接口，不能沿用 724UG 管脚直接对贴；2）软件上老 LuatTask 脚本不能直接运行，需按 https://docs.openluat.com/common/Luatos-air_to_LuatOS/ 的移植说明改用 LuatOS API（mobile/socket/mqtt/gpio/uart 等）重写；3）若原系统需要外挂主控通过 AT 驱动，要改为主控 UART 与 Air8000W 自定义协议通信，或保留一颗 AT/DTU 模组；4）先在 Air8000W 开发板上用官方 demo 验证联网、外设和业务再画板。技术支持请优先查 https://docs.openluat.com/air8000/product/ 和 Gitee demo，未覆盖的问题带型号、原理图和日志到 docs.openluat.com 底部官方企业微信群咨询。

66. AI反应太慢，你们有没有做电路板开发业务这块的，我们出费用？

解答： 结论：定制电路板开发/方案服务以商务正式回复为准，需先提交可评估的需求资料，不能在技术问答里直接报价或承诺周期。建议准备：1）产品功能与应用场景；2）选用或意向的合宙型号；3）原理图、PCB 或功能框图、接口/结构尺寸要求；4）供电方式、功耗目标、天线形式、外设清单；5）预计量产数量和交付时间。资料齐后通过官方店铺 https://luat.taobao.com/ 或 docs.openluat.com 底部官方企业微信群联系商务，由其转交方案团队评估可行性、费用与排期；仅原理图评审可先参考 https://docs.openluat.com/value/drawcheck/ 。AI 响应慢可换网络、避开高峰或直接用上述人工渠道。

67. 为什么当时正常，现在不行了呢？是工具升级的原因？

解答： 结论：多数情况是 LuaTools 升级或更换电脑后，本地缺少 Air724UG 的历史资源包（底层固件/库/资源文件），导致原来能下载的工程现在找不到依赖文件，属于资源缺失而非工程本身损坏。原因：Air724UG 是 RDA8910 老平台，使用 LuatOS-Air（LuatTask）资源，新版工具默认不会自动携带全部老平台资源。处理步骤：1）在 LuaTools 中使用“资源下载/管理资源”功能，选择 Air724UG，下载其 LuatTask（LuatOS-Air）对应资源包；2）确认工程目录里引用的底层 .soc/.pac、lib 库文件和资源文件已随包恢复；3）重新选择与工程匹配的底层固件和脚本下载；4）若仍异常，到工具 exe 同目录的 project、resource 目录核对文件是否齐全，必要时重新下载资源。工具教程：https://docs.openluat.com/common/Luatools/ ，历史固件/脚本以官方资源下载列表和 Gitee 仓库为准。

68. 以前的代码(大概23年左右)，内核是LuatOS-Air_V3209_RDA8910_TTS_NOVOLTE_FLOAT.pac，下载时提示执行引用的文件都找不到，如何处理？

解答： 结论：这是 Air724UG（RDA8910）老 LuatOS-Air/LuatTask 工程，提示“引用的文件找不到”是因为当前 LuaTools 本地缺少该工程对应的底层 .pac 固件和历史库资源，重新下载对应资源包即可恢复。处理步骤：1）在 LuaTools 的“资源下载/管理资源”中选择 Air724UG，下载其 LuatTask（LuatOS-Air）资源包；2）在工程下载配置里重新选择存在的底层内核文件（如 LuatOS-Air_V3209_RDA8910_TTS_NOVOLTE_FLOAT.pac 或资源包内对应版本），不要引用已被移动/删除的旧路径；3）核对脚本里 require 的库文件在资源包 lib 目录中存在，缺失文件按资源包补齐；4）再勾选底层+脚本重新下载。注意 TTS、NOVOLTE、FLOAT 是不同功能组合的内核，需与原工程功能一致，不要随意换型号内核。工具教程：https://docs.openluat.com/common/Luatools/ ；老脚本迁移到新 LuatOS 可参考 https://docs.openluat.com/common/Luatos-air_to_LuatOS/ 。

69. 咱这型号的进网许可是试用批文吗？有没有正式的？

解答： 结论：模组当前对应的进网许可/核准状态要以该型号产品资料中附带的正式证书或标签为准，技术答疑渠道不能凭口头替代合规证明；请通过商务或官方企业微信群索取该型号的进网许可、CCC、型号核准等证书扫描件核实是正式许可还是试用批文。需要特别说明的边界：1）合宙模组取得的认证只覆盖模组本身，且通常要求按官方参考设计、指定天线和射频条件使用；2）用该模组成的终端整机，一般仍需由整机厂按产品类别自行完成入网许可/CCC/无线电核准等认证，模组认证不能直接等同于整机认证；3）若产品用于送检或投标，请以证书编号在主管部门官网核验有效期和状态。建议在设计冻结前通过 https://luat.taobao.com/ 或 docs.openluat.com 底部官方企业微信群向商务确认证书清单，避免合规风险。

70. 帮忙看看麦的设计有没有问题，录音有很大的沙沙背景声？

解答： 结论：持续的“沙沙”底噪绝大多数来自麦克风通道的硬件设计和供电，不是单纯调软件音量能解决的，需先按官方音频硬件参考设计核对，再用软件参数交叉验证。排查要点：1）确认硬件形态——除 Air780EHV 内置 codec 外，其他型号录音需外置音频 codec（如 ES8311），麦克风类型（模拟驻极体/数字 MEMS）要与 codec MIC 通道匹配；2）供电是首要噪声源，MIC 偏置和 codec 模拟供电必须低纹波、独立去耦，避开 DC-DC 大电流开关回路，模拟地与数字地分区单点连接；3）MICP/MICN 差分走线等长、紧耦合、包地、远离天线和高速线，尽量用差分输入抑制共模噪声；4）偏置电阻、耦合电容、增益配置按参考设计取值，增益过高会把底噪一起放大，可适当降低 MIC 增益再录音对比；5）确认无 50Hz 工频干扰（接地/共地问题）和 PA、GSM 发射间隙的 TDMA 电流声（天线与 MIC 走线隔离、供电去耦不足）。软件侧用 exaudio.setup 配置 codec 后调用 exaudio.record_start 录 PCM（如 exaudio.PCM_16000），用 exaudio.mic_vol 调整录音增益并与官方 demo 对比。请提供原理图 MIC/codec/电源页、PCB 走线和录音文件，到 docs.openluat.com 底部官方企业微信群进一步评审。文档：https://docs.openluat.com/osapi/ext/exaudio/ ，评审服务：https://docs.openluat.com/value/drawcheck/

71. 这个3年免流量(100M/月)卡只能通过iRTU配置终端上传到第三方服务器吗？

解答： 结论：从模组能力看，这张流量卡提供的是通用蜂窝数据通道，设备可以连接任意 TCP/MQTT/HTTP 第三方服务器，并非只能连 iRTU 服务器；iRTU 配置平台本身不收取平台费用。但“免流/定向流量”的可达范围以卡套餐和运营商 APN 策略为准。需要确认两点：1）该 100M/月是公网通用流量还是定向流量（定向流量通常只能访问套餐白名单内地址，连第三方服务器前要把你的服务器域名/IP 加入白名单或开通通用流量）；2）是否有机卡绑定、专网 APN 限制。iRTU 只是把服务器地址等参数下发给设备的配置工具，不限制数据最终发往哪里。建议先用标准 socket/mqtt demo 直连你的第三方服务器实测，连不通时优先排查卡的定向白名单和 APN，而不是平台限制。iRTU 说明：https://docs.openluat.com/value/irtu/web/

72. Air8780V4 + 3年免流量(100M/月)卡6.9元，只能连接iRTU的服务器吗？使用iRTU平台还有其他费用吗？

解答： 结论：Air8780V4 配这张卡并非只能连 iRTU 服务器，设备作为数据终端可以访问任意第三方 TCP/MQTT/HTTP 服务器；iRTU 配置平台本身不另收平台费（早期有过 0 元下单的开通流程，目前已回归免费使用）。需要注意的是流量可达范围由卡套餐决定：1）购买前向销售/卡商确认该卡是公网通用流量还是定向流量，定向流量只能访问白名单地址，连自建服务器需先加白；2）确认是否机卡绑定、是否限制 APN 或公网协议；3）6.9 元这类套餐的具体内容（年限、月流量、是否可续费、超套规则）以购买页面和卡商协议为准，技术侧无法承诺资费。建议设备到手后用 socket/mqtt demo 直连目标服务器实测。平台入口：https://iot.openluat.com/irtu/project-list ，说明：https://docs.openluat.com/value/irtu/free/

73. 这个脚本和底层CORE应该选哪个文件才能匹配固件呢？

解答： 结论：底层 CORE 必须按“具体型号 + 硬件版本”从 LuaTools 资源下载列表中选择对应的官方固件，脚本则是你自己的 LuatOS 工程，二者靠型号匹配，而不是靠文件名凑。LuatOS 固件由 core（底层核心固件）和 script（用户脚本）两部分组成，选错型号的 core 会导致外设异常甚至无法开机。操作步骤：1）先用 hmeta.model()、hmeta.hwver()、hmeta.chip() 或模块丝印确认准确型号和硬件版本；2）在 LuaTools“资源下载”里选该型号，下载其最新稳定固件资源；3）新建工程时选择刚下载的、与型号一致的底层 core 文件，再选择脚本目录，勾选“下载底层和脚本”一起烧录；4）脚本中的 API 必须是该固件支持的库，可参考该型号固件支持列表和 Gitee demo（https://gitee.com/openLuat/LuatOS/tree/master/module ）。不要把别的型号 core 强行套用，也不要用来路不明的合并文件。工具教程：https://docs.openluat.com/common/Luatools/

74. 合宙的OTP锁定后还可读，是硬件不支持吗？

解答： 结论：不是硬件不支持，这正是 OTP 的设计行为——otp.lock(zone) 加锁后该区域变为只读，不能再写入或擦除，但仍然可以用 otp.read(zone, offset, len) 正常读取。原理：OTP（一次性可编程存储）用于保存设备唯一 ID、密钥、生产信息等需要永久保存且允许读取的数据，加锁的目的是防止内容被篡改，而不是禁止读取。要点：1）一旦加锁永久不可解锁，加锁前务必确认数据正确、地址未用过；2）读写长度和偏移需按 4 字节对齐且不超出该 zone 容量；3）写、擦、锁操作需在飞行模式下调用，否则有死机风险；4）OTP 写入后不可擦除，仅 Air780E 系列/Air8000 系列支持写入后擦除（但加锁后同样只读）。文档：https://docs.openluat.com/osapi/core/otp/

75. 724和8000支持3G网吗？

解答： 结论：Air724 系列和 Air8000 系列都是 4G LTE Cat.1 模组，官方频段表只列出 LTE-FDD/LTE-TDD，不支持 WCDMA/CDMA/EVDO 等 3G 制式，因此不能把它们当 3G 模组使用。以 Air8000 为例，国内型号支持的是 LTE-TDD B34/B38/B39/B40/B41 和 LTE-FDD B1/B3/B5/B8，上行理论最大 5Mbps、下行 10Mbps（Cat.1 典型速率）；Air724（RDA8910）同为 Cat.1。说明：实际驻网仍依赖运营商当地是否开通对应 4G 频段，运营商退网或该区域只有 2/3G 覆盖时设备无法通过 3G 回退。频段以具体型号规格书/产品页为准。Air8000 频段：https://docs.openluat.com/air8000/product/

76. RTC是否能设置为重启后时间不重置？

解答： 结论：当前合宙主流模组的内部 RTC 在完全掉电以及软件重启（含 rtos.reboot、看门狗复位）后都会恢复默认时间（多数型号为 2000-01-01，Air8101 为 1970-01-01 00:00:15），无法通过设置让内部 RTC 跨复位保持，需要靠“掉电保存时间戳 + 重启恢复 + 联网对时”或外部 RTC 实现。方案：1）每次成功对时后用 fskv 保存时间戳和当时的开机毫秒计数（mcu.ticks() 或 os.time()），重启后读出并结合断电时长补偿，再用 rtc.set() 写回；2）联网后优先用更可靠的对时纠正累计误差——可用 socket.sntp() 走 NTP，或默认开启的基站授时（mobile.syncTime，成功后发 NTP_UPDATE，tp=1 为基站、tp=0 为 NTP），业务对时间要求严格时建议由自建服务器下发时间；3）设备完全长期断电且要求高精度时，外挂带后备电池的外部 RTC 芯片，开机后通过 I2C 读取。注意 NTP 成功后直接用 os.date() 取本地时间即可，不必再手动 rtc.set。文档：https://docs.openluat.com/osapi/core/rtc/ 、https://docs.openluat.com/common/time_sync/

77. 流量用完或者停机的情况下还能基站授时吗？还能发短信获取时间吗？

解答： 结论：基站授时走的是蜂窝信令通道而不是数据流量，理论上只要 SIM 卡未停机、能正常注册上网络就能收到基站时间；一旦停机欠费导致无法驻网，基站授时和短信都会失效。流量用完但未停机时，通常仍可驻网，基站授时（mobile.syncTime，默认开启，成功发 NTP_UPDATE 且 tp=1）一般可用，但 NTP 等数据通道对时会因无流量而失败。短信方式（收到短信后依据 SMS_INC 的 metas 用 rtc.set 对时）依赖卡开通短信业务：普通手机卡具备短信能力且未停机才可收发；多数物联网卡默认不含短信业务，无法使用此方式，且官方不推荐短信授时（误差可达分钟级）。建议：正式产品让业务服务器在建链后下发时间，最可靠；基站授时作为补充。文档：https://docs.openluat.com/common/time_sync/

78. Air780E这个合宙4G模组在接收数据的时候，一次接收的数据量有限制吗？使用的是MQTT协议

解答： 结论：官方 mqtt 核心库文档没有规定单条消息的固定字节上限，下行消息在 recv 事件中以完整字符串 payload 形式回调给出；实际能收多大取决于固件可用内存（RAM）、MQTT broker 及运营商链路，而不是某个固定协议字节数。原理：MQTT 3.1.1 本身不限制单包大小，但模组是资源受限的嵌入式设备，单条消息需要在内存中完整缓存，消息过大可能申请不到内存而丢包或断连；LuatOS 的 mqtt 库也不会自动把一条消息分块交付。建议：1）不要设计单条超大报文，按业务拆成多条小消息或分页下发；2）大文件（图片、固件）改用 HTTP 分块/分片下载或 OTA，而不是塞进单条 MQTT payload；3）用 mqttc:on 的 recv 回调实测不同长度 payload，结合内存情况确定安全上限，并在弱网下控制发送节奏；4）可参考 LuatOS 内存说明评估可用 RAM。文档：https://docs.openluat.com/osapi/core/mqtt/ 、https://docs.openluat.com/common/LuatOS_ram/

79. 700e可以在新加坡用吗？

解答： 结论：能否在新加坡使用，取决于该 Air700E 具体型号支持的 LTE 频段是否覆盖新加坡运营商网络，不能只凭“700e”名称直接判定，必须以该型号官方规格书的频段表与当地运营商频段做比对。判断方法：1）先确认完整型号（Air700E/ECP/ECH/ECT 等）和销售区域版本，用 hmeta.model() 或规格书确认；2）查阅该型号规格书支持的 LTE-FDD/TDD Band；3）核对新加坡主流运营商（Singtel、StarHub、M1、SIMBA）现网在用的 4G 频段是否有交集，并确认 SIM 卡类型（普通卡/物联卡）和漫游许可。说明：Air700E 系列主要面向国内移动网络设计，未在可核实的官方资料中查到新加坡频段覆盖结论，因此不能口头承诺可用；若需要明确支持海外的型号，请以选型指南“海外需求”章节和产品规格书为准选型，并向商务确认是否有对应海外版本。选型指南：https://docs.openluat.com/SelectionGuide/SelectionGuide/

80. 通讯+WIFI天线改版后有推荐的样式吗？周五前简化后的通讯板+4.3屏幕能出来资料吗？

解答： 结论：蜂窝天线和 WiFi 天线的形式（板载 PCB 天线、FPC、外置棒状/吸盘天线）要根据整机结构、净空和频段决定，建议优先沿用官方开发板/参考设计的天线方案，并以实网和无源测试验证；资料发布时间不能口头承诺，需以官方资料中心实际上线或商务回复为准。天线建议：1）4G 与 WiFi 是不同频段，天线需分别满足各自频段，优先选官方验证过的型号，保证 50Ω 阻抗匹配、π 型匹配网络预留和足够净空；2）多天线注意隔离度，避免金属外壳、电池、屏的 FPC 遮挡；3）打样后用网络分析仪测回波损耗，再做实网吞吐/注网测试，不能只看“能连上”。关于“周五前出通讯板+4.3 寸屏资料”：这类排期需向商务或官方企业微信群正式确认，技术答疑不能承诺交付时间；时间紧时建议先用官方现有开发板和已适配的屏幕做功能演示样机，再推进量产板。产品资料以 https://docs.openluat.com/ 对应型号页面为准。

81. 8202预计什么时候放货呀？

解答： 结论：具体放货/到货时间以官方店铺和商务的实时库存为准，技术答疑无法给出确定日期，也不应以“最快今天”这类口头说法作为采购依据。选型指南中已收录 Air8202G（免开发定位器，基于 Air8201 超低功耗定位模组），说明该产品方向已在官方选型体系内。建议：1）直接在官方店铺 https://luat.taobao.com/ 搜索 Air8202/Air8202G 查看是否已上架及可下单数量；2）若店铺未上架或需批量，通过 docs.openluat.com 底部官方企业微信群或店铺客服联系销售确认放货时间、批量交期；3）项目时间紧张时，可同时评估选型指南中的 Air8201G/H 或 Air8202G 等替代/同源方案先做开发验证。产品资料以 https://docs.openluat.com/air8201/ 和选型指南为准。

82. 有没有这个开发板的电流功率等参数？

解答： 结论：开发板/模组的电流、功耗参数需以具体型号的官方“实网功耗数据/硬件设计手册”为准，不同型号、网络状态（常规/低功耗/PSM+）、外设挂载和供电电压下数值差异很大，不能给一个通用数字。获取方式：1）先确认开发板和板载模组的准确型号（丝印或 hmeta.model()）；2）到 https://docs.openluat.com/ 对应型号资料中心查找“实网功耗数据/功耗指南”，例如 Air8101 资料页给出了常规模式 3.3V 平均 8.17mA、低功耗 DTIM10 约 400μA、PSM+ 约 13μA，Air8000/Air8201 也有各自 4G 实网功耗页；3）通用低功耗设计可参考 https://docs.openluat.com/common/airpower/ 。注意官方数据多为模组本体在特定条件下的实测值，开发板因带 LDO、串口电平转换、外设等，整体电流会高于模组数值，量产功耗请以自己整机实网实测为准。

83. 现在订货780ept还是原来的固件吧？后续10月之后固件配套模组出货，还需要单独更新吗？

解答： 结论：随货固件版本会随批次更新，不能假定一直是“原来的固件”，是否需要单独升级取决于出货固件是否已包含你要的功能/修复，以及开发方式（AT 还是 LuatOS）。说明与建议：1）模组出厂固件以实际批次为准，下单前可向销售确认当前随货版本，并在入库/上线前用 hmeta.version() 等方式记录版本；2）AT 开发方式下，只要随货 AT 固件满足业务且无已知问题，通常无需再单独刷底层，但新功能或问题修复仍需按官方固件更新；3）LuatOS 开发方式下，固件由 core+script 构成，建议在量产前锁定一个经过验证的版本统一烧录，后续更新可走 FOTA（libfota2，支持 core 差分和 script 全量），不必依赖随货版本；4）所谓“10 月后配套出货”的具体安排要以官方固件发布和商务通知为准，技术侧不能承诺。固件支持与升级：https://docs.openluat.com/osapi/ext/libfota2/ ，型号资料见 docs.openluat.com 对应产品页。

84. 更新完下载调试软件项目都没有了，怎么办？

解答： 结论：升级 LuaTools 后项目列表为空，通常是新版 exe 的解压/安装位置与旧版不同，工程文件并未丢失，它们保存在 LuaTools exe 所在目录下的 project 文件夹中。处理步骤：1）找到旧版 LuaTools 的安装/解压目录，进入其 project 子目录，确认历史工程文件夹都在；2）把旧 project 目录整体复制到新版 exe 同级目录覆盖合并，或在新版 LuaTools 中手动“打开/导入项目”，定位到旧 project 里的工程；3）若新旧版本在同一目录覆盖升级仍不显示，检查是否解压到了带权限限制的路径（如 Program Files），改用普通用户目录并以管理员身份运行；4）日常应把工程源码单独用 Git/网盘备份，不要只依赖工具目录。工具目录结构和使用见 https://docs.openluat.com/common/Luatools/ 。

85. 我用的是Air8000D，底层core选哪一个？

解答： 结论：Air8000A/W/D/T/AB/DB/U/N 八个型号共用同一套软件，固件后缀统一为 _Air8000，因此不存在“Air8000D 专属 core”，你应在 LuaTools 资源下载里选择 Air8000 的固件版本，再按“功能需求 + 位数”选具体固件号，而不是按型号字母选。选择方法：1）版本选官方最新稳定版（如当前 LuatOS-SoC_V2050_Air8000，历史版本在同页可查）；2）Air8000 因 Flash 有限提供多种固件，32 位为 1–99 号、64 位为 101–199 号，每种固件装载的核心库组合不同（如 TTS、cc 通话、SIP、camera、airui、audio_v2、短信/电信支持等），对照官方“固件支持核心库列表”挑包含你所需库、且脚本区/文件系统空间够用的固件号；3）普通联网业务选常用号即可，做 UI 选带 airui/hzfont 的号，SIP 语音桥接仅 13/113 号支持，新音频框架 audio_v2 仅特定号支持；4）注意差分升级只能在同类固件号之间进行，选定后量产尽量不换号，否则只能整包/本地升级。烧录时勾选“下载底层和脚本”。固件列表与功能表：https://docs.openluat.com/air8000/luatos/firmware/ ，32/64 位差异：https://docs.openluat.com/common/core_32_64/

86. 这个设备怎么导入项目呢？

解答： 结论：设备不能脱离账号“直接加入”项目，必须先归属到你的 IoT 账号，再在账号内把设备转移到目标项目。操作步骤：1）确认设备当前归属——淘宝等电商渠道购买的设备默认在 crm.luatos.com 体系，线下/IoT 渠道购买的在 iot.openluat.com 体系，跨体系需先按归属规则转移到你的账号；2）登录 https://iot.openluat.com/ ，进入“我的设备”，用 IMEI 找到该设备，点击操作中的“转移/批量转移”；3）选择“转移到我的项目”，指定目标项目（可新建项目），确认后设备即归入该项目；4）若提示 IMEI 不在当前账号或已被占用，需由原归属账号转出或走设备归属流程。归属与转移说明：https://docs.openluat.com/air780epm/product/attributioniot/

87. SPK那一端接两个音源行不行，同时只有一个有声音，通过控制引脚控制功放是否打开？

解答： 结论：不能把两个音频输出端直接并在同一组 SPK/喇叭上，即使软件上保证同一时刻只播一路也不行，仅靠控制功放使能脚无法消除另一路输出级对线路的影响。原因：模组/功放的 SPK 输出多为差分（BTL）推挽结构，直接并接时，未被“关闭”的那一路输出仍带直流偏置和交流信号，会通过另一个功放的输出 MOS 形成灌电流/抽电流，造成功放发热、失真甚至损坏，且两路上电时序不同时风险更高。正确做法：1）每路音源各用一个独立 PA 驱动独立喇叭；2）若必须共用一只喇叭，用硬件做切换——在两路基带/线路输出端用模拟开关（或带多路输入、硬件静音的功放/Codec）选通一路后再进同一个 PA，并用 GPIO 控制选通和 PA 使能，保证未选中的一路高阻/静音；3）合宙所有型号都需外置 PA，音频输入/输出与 PA 控制建议按 exaudio 参考设计（ES8311 Codec + pa_ctrl/dac_ctrl 时序）实现。文档：https://docs.openluat.com/osapi/ext/exaudio/

88. 关于固件合并netLed.lua缺失问题？

解答： 结论：netLed.lua 不是内核固件或系统库的一部分，而是早期 demo 中的“网络状态指示灯”示例脚本；新版官方脚本仓库已不再随库提供该文件，因此合并固件或升级脚本资源后提示找不到该文件属于示例文件缺失，不影响模组固件本身，也不影响联网功能。处理步骤：1）若你的业务不需要该灯效，直接删除或注释 main.lua 中的 require "netLed" 及相关调用，重新下载脚本即可；2）若需要联网指示灯，建议用现有官方 API 自行实现，而不是从来源不明的旧工程中复制：订阅网络与 SIM 状态（如 IP_READY、mobile.status()、SIM_IND），用 GPIO 控制 LED 的亮、灭或闪烁即可；3）确需沿用旧逻辑时，只从与当前 core 同代的官方历史版本脚本库中获取该文件，并核对其依赖的 API 在当前固件仍可用，避免引入已废弃接口。移动网络状态接口见 https://docs.openluat.com/osapi/core/mobile/ ，GPIO 接口见 https://docs.openluat.com/osapi/core/gpio/ ，官方脚本仓库 https://gitee.com/openLuat/LuatOS

89. 为什么当时正常，现在不行了呢？是工具升级的原因？

解答： 结论：“以前能烧、现在不能烧”不能直接归因于 LuaTools 升级，烧录链路涉及工具、驱动、数据线、USB 口、供电、设备端 boot 逻辑和固件资源，任一环节变化都会导致失败，应按固定次序逐项排查。处理步骤：1）先确认故障范围——同一台电脑烧合宙官方核心板是否正常，正常则问题在你的板卡或接线；多台电脑都失败则问题在设备端；2）从任务管理器结束残留 LuaTools 进程，重新从官方入口下载最新 v3，放到磁盘根目录等浅路径（如 D:\Luatools），杀软拦截项一律放行；3）确认硬盘剩余空间充足、关闭电脑蓝牙和其他占用串口的软件、Air722/Air724/Air720 等老型号装好 USB 驱动（Air780/Air8000/Air8201 系列免驱）；4）更换短于 1 米、带数据芯线的优质数据线和 USB 口；5）按官方强制 boot 时序操作：先点“下载”进入等待，再断电、按住 BOOT 上电，必要时同时长按开机键；6）设备端业务脚本异常快速重启会导致免 boot 烧录失败，此时必须用手动 boot 方式；7）保留工具目录 log 下的 main/trace 日志用于定位。排查指南：https://docs.openluat.com/common/howtodown/ ，工具文档与版本更新记录：https://docs.openluat.com/common/Luatools/

90. 这个软件能不能给一个旧版的呀，下载脚本就卡住了？

解答： 结论：不建议把“回退旧版 LuaTools”作为首选方案——卡在下载脚本绝大多数是烧录链路或本地环境问题，旧版同样会失败；官方安装包入口 https://luatos.com/luatools/download/last 提供的是当前 v3 正式版，工具文档页保留了 LuaTools 版本更新记录，确有兼容性需要时应通过官方渠道获取经确认的历史版本，不要使用第三方网盘来历不明的安装包。处理步骤：1）任务管理器结束所有残留 LuaTools 进程后重开工具；2）把工具放到磁盘根目录等浅路径（如 D:\Luatools），检查硬盘剩余空间，放行杀软拦截；3）关闭电脑蓝牙和其他占用串口的软件，拔掉多余 USB 设备；4）换短于 1 米、带 DP/DM 芯线的优质数据线和直连电脑的 USB 口（不要用扩展坞）；5）点击“下载”进入等待后，给设备断电、按住 BOOT 再上电，必要时同时长按开机键，手动强制进入 boot 下载模式；6）老型号（Air722/Air724/Air720/Air795/Air820）先安装对应 USB 驱动；7）若仍卡住，提交工具目录 log 下当天的 main 和 trace 日志请官方支持定位。排查指南：https://docs.openluat.com/common/howtodown/ ，版本记录：https://docs.openluat.com/common/Luatools/#luatools_2

91. 屏幕不亮/黑屏了，怎么回事？

解答： 结论：黑屏要区分“背光不亮”和“背光亮但无画面”，并用与屏幕接口（SPI/QSPI/RGB）一致的官方最小 demo 交叉验证，才能判断是硬件还是软件问题，单跑业务代码无法定位。排查步骤：1）先只测背光：确认屏幕供电电压/电流满足规格、背光使能脚电平正确、排线无反接或虚插，背光完全不亮优先查供电、使能电路和 FPC；2）背光亮但无画面时，烧录与你屏幕驱动 IC 对应的官方 lcd demo（内置型号直接选型号，非内置型号用 custom 并按屏幕手册填写初始化指令、分辨率、SPI 速率、lcd.init 参数），不要拿 RGB 屏 demo 跑 SPI 屏或反过来；3）检查复位/DC/CS 引脚、SPI 速率先降频、确认屏幕方向与偏移参数、调用 lcd.on()/lcd.wakeup() 并在 lcd.flush() 后观察；4）RGB 屏还要核对时序参数、帧缓冲内存是否分配成功（Air8101/Air8000 等按其显示文档接线）；5）换同款好屏和主板交叉验证，排线、接座和焊接不良是黑屏高发原因；6）官方 demo 也黑屏且背光异常，基本可定位为硬件问题。LCD 接口与 API：https://docs.openluat.com/osapi/core/lcd/ ，复杂 UI 项目改用 AirUI：https://docs.openluat.com/osapi/core/airui/

92. SIM卡锁死了，模块连不上网要过好久才休眠？

解答： 结论：PIN 锁定/PUK 锁死的 SIM 无法由模组自动恢复，协议栈会持续读卡、搜网和重试附着，期间外设与基带保持活动，因此无法及时进入低功耗，“过很久才休眠”是异常卡状态下的重试现象，不是休眠功能本身故障。处理步骤：1）先解卡——把卡装入手机，按运营商提示输入 PIN；已要求 PUK 的用运营商提供的 PUK 通过 mobile.simPin(0, mobile.PIN_UNBLOCK, puk, newpin) 解锁，PUK 输错超限的卡永久作废只能换卡；2）业务中订阅 SIM_IND 识别卡状态（RDY 就绪、NORDY 无卡、SIM_PIN 待输入 PIN），在未就绪时不启动 socket/MQTT 等联网业务，避免无意义的搜网和重连把功耗拖住；3）对确认锁死/无卡的设备直接上报告警并进入受控低功耗，或降低 mobile.setAuto 的 SIM 检测与无网恢复频率，必要时先飞行模式再休眠，避免周期性进出飞行模式反复唤醒；4）检查卡座、卡方向、ESD 和 SIM 走线，并用已知正常的卡交叉验证，排除接触不良误判；5）换正常卡后仍延迟休眠，再抓注网和 PM 日志分析是否有 wakelock 或外设未释放。API 文档：https://docs.openluat.com/osapi/core/mobile/ ，电源管理：https://docs.openluat.com/osapi/core/pm/

93. 新版本DTU不支持配置阿里云腾讯云这些了么？

解答： 结论：支持。新版 iRTU（DTU）并没有取消对接第三方云平台，设备本质上是标准 MQTT/TCP 客户端，只要网络可达、鉴权参数正确，就可以接入阿里云、腾讯云等第三方平台；变化的是配置入口——Air780EHM/EPM/EGG/EGH/EGP/EHV、Air700ECP/ECH、Air8000 等新型号统一使用新 iRTU 配置平台 https://iot.openluat.com/irtu/project-list ，旧平台 dtu.openluat.com 仅维护 Air724、Air780E/EX/EG 等老型号且已停止更新。配置要点：1）在新项目中按第三方云平台要求填写服务器地址/端口、ClientID、用户名、密码（阿里云/腾讯云通常还需按平台规则计算三元组或密钥参数）；2）设备开机时只同步一次项目配置，修改后需重启设备，并确认“设备参数版本”与“项目参数版本”一致；3）配置按项目分组统一下发，单台设备独立配置时应单独建分组；4）确认物联卡未限制访问目标云域名，必要时用通用流量卡验证。新平台说明：https://docs.openluat.com/value/irtu/web/

94. 780EPM刷的iRTU 5.0.4 DTU配置没有更新成功，固件版本也没更新？

解答： 结论：Air780EPM 属于新型号，iRTU 配置只能在新平台 https://iot.openluat.com/irtu/project-list 进行，旧平台 dtu.openluat.com 上的配置对它不生效；“配置不更新”和“固件不更新”是两条独立链路，需分别排查。配置排查：1）确认设备已归属当前账号并加入目标项目、所在分组正确；2）设备仅在开机时向平台同步一次配置，平台改完参数后必须重启设备；3）查看设备详情中“设备参数版本”是否已等于“项目参数版本”，不一致即未同步成功；4）确认设备已注网并拿到 IP（日志出现 IP_READY）、物联卡可访问 iot.openluat.com；5）未分组的设备不会收到项目配置。固件排查：iRTU 固件升级是平台 FOTA 流程，需要在平台为对应型号/分组创建升级任务、设备在线且当前版本处于升级策略覆盖范围；FOTA 失败看信号、电量、任务状态和日志，紧急或跨版本时用 LuaTools 勾选“下载底层和脚本”本地烧录一次最新 iRTU 固件后再观察后续 FOTA。配置平台文档：https://docs.openluat.com/value/irtu/web/ ，烧录排查：https://docs.openluat.com/common/howtodown/

95. Air780E这个合宙4G模组在接收数据的时候，一次接收的数据量有限制吗？

解答： 结论：socket 官方接口没有规定一个固定的“单次最大接收字节数”，数据到达后先缓存在底层，应用通过 socket.rx(ctrl, buff) 取出，传入的 zbuff 缓冲区不够大时会自动扩容，因此实际一次可读取的长度主要受模组可用 RAM（Lua 堆）和底层缓存容量限制，而不是某个固定 API 数值。使用要点：1）推荐用 zbuff 方式接收：local buff = zbuff.create(2048)，收到 socket.EVENT/socket.RX_NEW 后调用 socket.rx(ctrl, buff)，返回的第二个值即本次读取长度；也可用 2024.1.5 新增的 limit 参数只读前 N 字节（socket.rx(ctrl, buff, nil, 1500)）；2）TCP 是流式协议，一次事件不保证对应对端一次发送，剩余数据不会丢弃、可继续读取，但未读完前不会再触发新的接收事件，应用必须循环读到无数据为止；3）UDP 模式下一次 socket.rx 只取出一个完整数据包，limit 小于包长时超出部分直接丢弃；4）发送方向官方明确建议 UDP 单包不超过 1460 字节，否则容易失败；5）超大报文（如文件）应在应用层分包/组包或直接走 HTTP/FOTA 通道，避免占用过多内存。接口文档：https://docs.openluat.com/osapi/core/socket/ ，内存说明可参考 https://docs.openluat.com/common/LuatOS_ram/

96. 网站还没好吗？ai问答登录后一直还要让登录

解答： 结论：这通常是本地浏览器登录态（Cookie/第三方 Cookie/缓存跳转）或网络代理问题，不等于服务未恢复，先按下列步骤自查，不要只反复点登录。处理步骤：1）使用新版 Chrome 或 Edge 打开无痕窗口访问官方 AI 问答入口并重新登录；2）确认浏览器允许该站点保存 Cookie，未开启“阻止所有 Cookie”或严格跟踪防护，若登录跳转涉及多个域名，需允许第三方 Cookie；3）清除 openluat.com、luatos.com 相关站点的 Cookie 和站点数据后，完全关闭浏览器再重开；4）核对系统日期/时间是否准确，关闭异常代理、VPN、广告拦截插件和企业安全策略后重试，并换一条网络（手机热点）验证；5）换设备或浏览器仍重复登录，再记录账号、时间点、浏览器控制台（F12 Console/Network）报错和完整跳转 URL，通过官方企业微信群或文档页支持入口反馈为登录态故障。官方文档入口 https://docs.openluat.com/