常见问题 - 2026-09-02
数据日期：2026-09-02
1. Luatools工具的最新版本是多少？官网的是最新版吗？
解答： 截至本数据日期（2026-09-02），Luatools 最新版为 3.4.8（2026-08-28 发布）；官网下载页始终提供当前最新版，无需担心拿到旧版（3.4.9 于次日 2026-09-03 发布，以官网实际页面为准）。下载地址（直接下载最新安装包）：https://cdn18.luatos.com/files/exe/Luatools_v3.exe ，完整版本发布记录见官方文档：https://docs.openluat.com/common/Luatools/#luatools_2 。如遇旧版异常，建议先升级到最新版再复测。
2. AIR724UG插着USB数据线到电脑上能正常运行程序，拔掉后程序运行一会儿就卡住，是哪里的问题？
解答： 结论：典型的供电能力不足问题。USB 数据线由电脑 USB 口供电（5V，通常可提供 500mA 以上瞬态电流），而模块在 4G 发射瞬间峰值电流可达 2A 左右，外接电源若带载能力不足或线上压降过大，VBAT 被拉低即触发欠压保护/复位，表现为运行一会儿就卡住或重启。排查步骤：①用示波器或万用表监测 VBAT 在发射瞬间的电压跌落，要求最低不低于模组手册规定的下限（通常 3.3V 左右）；②确认外接电源额定电流≥2A，VBAT 就近并 100uF 以上低 ESR 电容（必要时加 470~1000uF），走线尽量短粗；③确认 PWRKEY 开机时序满足手册要求（拉低时长、释放后保持），排除开机不稳定；④检查电池是否老化、保护板限流；⑤替换优质 USB 线对比（劣质线阻抗大也会导致 USB 供电时好时坏）。AIR724UG 为早期型号，建议同步核对该型号硬件手册的电源设计章节，文档入口：https://docs.openluat.com/ 。
3. IoT平台设备转移到本账号其他项目后，为什么总是自动跑回去？
解答： 结论：这不是平台故障，而是设备固件中烧录的项目 Key 未变更导致的"自动归属"。原理：设备发起 FOTA 升级/上报请求时携带的是固件内置的项目 Key（量产时在 Luatools 项目参数中配置并随脚本烧录），平台每次收到请求都会按 Key 把设备归到对应项目；在网页上手动"转移到其他项目"只改变当前归属关系，设备下一次请求时仍会被 Key 重新拉回原项目。解决办法（二选一）：①在 Luatools 中把项目参数改为新项目 Key，重新烧录脚本/固件后设备即固定归属新项目；②同账号下需要保留现网固件不变的，使用 IoT 平台（iot.openluat.com）提供的批量转移功能做正式转移，而非网页单次手动转移。设备归属规则详见：https://docs.openluat.com/air780epm/product/attributioniot/ 。
4. 升级请求时设备会自动归属到对应项目，触发自动归属的具体机制是什么？是key还是url的问题？
解答： 结论：触发自动归属的是项目 Key（project_key），不是 URL。原理：使用合宙 IoT 平台升级时，libfota2 的 opts.project_key 默认取脚本中的全局变量 PRODUCT_KEY（即 Luatools 项目参数里填写的项目 Key，随固件烧录到设备），设备标识 opts.imei 默认取 IMEI；设备每次向平台发起升级请求（默认平台地址 iot.openluat.com），平台据此把该 IMEI 归到 Key 对应的项目下。URL 的作用仅在于指定升级服务器（合宙平台或自建 HTTP 服务器），自建服务器时 project_key 不参与归属。因此想把设备固定归属到新项目，必须修改 PRODUCT_KEY 并重新烧录，仅改 URL 不会改变归属。接口细节见：https://docs.openluat.com/osapi/ext/libfota2/ 。
5. 烧录完没有任何提示是什么原因？
解答： 结论：先按"连接—驱动—电源—下载模式"四步定位，绝大多数"无提示"都不是设备损坏。排查步骤：①确认 Luatools 已升级到最新版，下载日志区有正常输出；②设备管理器确认 USB 枚举正常、驱动无黄色感叹号，必要时重装官方 USB 驱动（https://docs.openluat.com/common/usb_drv/ ）；③更换长度 1 米以内、带数据芯的优质 USB 线和 USB 2.0 口，确认独立电源/电池供电充足（4G 发射时瞬态电流大，供电不足会导致枚举或下载中断）；④让设备进入强制下载模式：按住 BOOT 键再上电/复位，Luatools 识别到端口后再下载，下载完成后正常重启（boot 模式约 18 秒自动退出，端口检测超时约 30 秒属正常）；⑤确认所选固件/脚本与型号匹配、硬盘剩余空间充足、关闭 PC 端蓝牙等可能占用串口的程序。完整排查流程见官方文档：https://docs.openluat.com/common/howtodown/ 。
6. 底层固件与脚本对应关系的最新表格在哪里查看？
解答： 结论：LuatOS 固件（core）与脚本没有"一一对应表格"，兼容性以内核大版本（32 位/64 位）和型号为准，获取最新内核的正确入口是 Luatools 在线列表和官方型号固件页。说明：①固件按位宽分两条线，1–99 为 32 位固件、101–199 为 64 位固件，选型说明见 https://docs.openluat.com/common/core_32_64/ ；②每个型号的内核固件发布记录在该型号文档站的"LuatOS → 固件版本"页（例如 Air780EPM：https://docs.openluat.com/air780epm/luatos/firmware/780epm_version/ ），页面持续更新；③实际项目开发时，在 Luatools"选择内核固件"处直接选最新正式版即可，脚本通过 require 调用核心库 API，只要位宽/型号匹配，新版内核向下兼容旧脚本；④如需严格锁定版本，项目中记录 Luatools 固件文件名与 rtos.version()、rtos.bsp() 返回值即可。
7. 固件版本号对应不上（如Luatools显示1-21/101-121，网页写1-19/101-119），如何对应？
解答： 结论：两边都没写错，是更新时间差导致的，按 Luatools 在线列表为准即可。对应规则：①两组编号是同一型号内核固件的发布序号，1–99 为 32 位、101–199 为 64 位，同批发布的 32/64 位固件序号相差 100（如"21"对应"121"，"19"对应"119"），即"1-21/101-121"比"1-19/101-119"更新两个批次；②Luatools 的内核列表在线实时更新，型号固件页（如 https://docs.openluat.com/air780epm/luatos/firmware/780epm_version/ ）随版本发布人工维护，存在短暂滞后属正常现象；③设备实际运行的内核版本以脚本中 rtos.version() 返回值为准，型号以 rtos.bsp() 为准，FOTA 升级时固件名默认就是 _G.PROJECT.."_LuatOS-SoC_"..rtos.bsp()，无需人工对照网页序号。
8. 有没有同时支持4G和局域网交互的模块？
解答： 结论：有，推荐 Air8000W（Air8000 系列子型号），单模组同时具备 4G Cat.1、WiFi 6（AP/STA）和以太网口，并支持 BLE5.4。原理：Air8000 系列内置"多网融合"能力，4G、WiFi、以太网任一通路有网即可通信，还支持 4G 转 WiFi，特别适合既需要蜂窝广域网、又需要局域网（以太网线或 WiFi）交互的设备。其他子型号按接口裁剪，选型时请以官方选型指南的功能矩阵为准：https://docs.openluat.com/SelectionGuide/SelectionGuide/ ，型号介绍见 https://docs.openluat.com/air8000/product/ 。
9. Luatools升级后8101一直报gpio11已占用，无法下载固件，是什么原因？
解答： 结论："gpio11 已占用"是脚本下载前的管脚复用冲突提示（GPIO11 在 Air8101 上常被复用为特定功能脚，如启动配置/外设功能），它导致工程校验不通过、无法进入下载；与 Luatools 版本升级本身无必然因果。处理步骤：①检查 main.lua 及各模块中是否对 GPIO11 做了 gpio.setup(11, ...)，若该脚已被其他外设（SPI/I2C/UART/摄像头等）占用，先去掉重复初始化或更换空闲脚；②在 Luatools 中新建一个空白 demo 工程试下载，若能下载则确认是用户脚本占用；③确认 GPIO11 未被硬件外设拉死，必要时断开外部负载再试；④让设备进入强制下载模式（按住 BOOT 键上电）后重新下载；⑤升级到最新版 Luatools 并使用与 Air8101 匹配的最新正式内核固件复测。若按以上步骤仍报错，保留完整下载日志到合宙技术论坛（https://chat.openluat.com/ ）或企业微信支持群反馈。
10. 转发功能入口在哪里？只有固件不知道怎么设置转发地址。
解答： 结论：Air8783 短信转发棒没有独立 App 或网页配置入口，出厂固件已内置转发功能，转发地址通过手机发送配置短信设置。操作方法：①Air8783 插手机 SIM 卡（物联网卡不适用）并接入 USB 供电；②用任意手机给设备卡号码发送指令短信，格式为 密码#指令#参数JSON，初始密码 123456；③配置企业微信：123456#QIWEI#{"webhook":"https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=xxx"}，配置钉钉用 DING（含 secret）、飞书用 FEISHU（含 ver_token），转发到手机号用 PHONES（最多 5 个，需验证码确认）；④设备执行后回执短信，可用 123456#GETCFG#{} 查询当前配置。官方也提供"Air8783 配置指令生成工具"网页辅助生成指令。完整指令集和 webhook 获取方法见：https://docs.openluat.com/air8783/product/config/ 。
11. AI会话登录后仍无法使用AI问答，是什么问题？
解答： 结论：多为浏览器环境/会话缓存问题，建议按以下顺序处理：①优先改用电脑端 Chrome/Edge 最新版浏览器访问，避免移动端或小众内置浏览器的兼容问题；②清除浏览器缓存与 Cookie，或使用无痕窗口重新登录；③确认账号登录状态已刷新（退出后重新登录一次）；④换网络环境测试，排除公司网络拦截；⑤若多台设备均异常，将报错截图、账号信息和时间点通过合宙官方企业微信支持群或技术论坛（https://chat.openluat.com/ ）反馈核查。
12. 信号满值是多少？网上说35？
解答： 结论：CSQ 满值是 31，不是 35。原理：mobile.csq() 对应标准 AT+CSQ（3GPP TS 27.007）的第一返回值，有效范围 0–31，数值越大信号越好，31 为满格；返回 99 表示不可测/无服务。网传的 35 没有协议依据，可能是把 RSRP 等其他指标混淆了。实际项目中建议同时使用更精确的 LTE 物理层指标判断信号：mobile.rssi()（dBm）、mobile.rsrp()（参考信号接收功率）、mobile.rsrq()（参考信号接收质量）、mobile.snr()（信噪比），接口文档：https://docs.openluat.com/osapi/core/mobile/#mobilecsq 。
13. 如何申请合宙云平台账户？
解答： 结论：直接在合宙 IoT 云平台官网自助注册即可，无需审批。步骤：①浏览器打开 https://iot.openluat.com/ （云平台控制台直达地址 https://iot.openluat.com/cloud/main ）；②点击注册，可用手机号注册，也支持微信扫码登录/绑定；③登录后即可新建项目、获取项目 Key（PRODUCT_KEY）用于设备接入与 FOTA。一个账号可创建多个项目，设备按 IMEI 归属到具体项目，归属规则见 https://docs.openluat.com/air780epm/product/attributioniot/ 。
14. 设备关机期间，手机网关会回执结果给设备吗，还是等开机后再回？
解答： 结论：等设备开机重新联网后才能收到，关机期间无法实时回执。原理：设备是 TCP/MQTT 长连接的客户端，关机或 PSM+ 模式下 4G 链路断开、IP 离线，服务器/手机网关无法向一个离线连接主动推送数据；设备重新开机注网并重建连接后，才会拉取到延迟的下行消息（若平台/应用服务器做了离线消息缓存），未做缓存的消息则直接丢失。设计建议：需要可靠送达的业务，应在应用层加入"上线后主动查询/补发"机制，或利用平台的离线消息/ QoS 能力，而不要依赖关机期间的实时回执。
15. Air780EGP使用lf.chipErase擦除4MB flash耗时50多秒且过程阻塞，之前用Air780EG和sfud库不到5秒，怎么排查？
解答： 结论：50 多秒属于整片擦除（Chip Erase）的正常量级，不是故障；sfud"不到 5 秒"通常擦的是按扇区/块组织的实际占用区域，而非整片，两者不具可比性。原因：①NOR/ NAND Flash 的擦除时间由芯片 die 的物理工艺决定，4MB 整片擦除在多数料号上为数十秒级，具体以所用 Flash 数据手册的 Chip Erase（典型/最大值）参数为准；②lf.chipErase 是同步阻塞调用，执行期间 Lua 任务无法调度，故表现为"卡住"。排查与优化建议：①打印 Flash 型号 ID，对照数据手册确认整片擦除标称时间；②业务上避免运行时整片擦除，仅在出厂初始化等离线环节执行，日常改用按扇区/4KB 或块/64KB 擦除；③若必须擦大块，可分片擦除并在分片间隙 sys.wait() 让出调度、及时 wdt.feed() 喂狗，避免看门狗复位；④确认 sfud 工程当时实际擦除的地址范围与大小；⑤核对 EGP 所用 lf 库版本说明，确认是否有异步/非阻塞擦除接口。sfud 文档：https://docs.openluat.com/osapi/core/sfud/ 。
16. Air780EGP的AT固件在哪里下载？
解答： 结论：Air780EGP 没有对外发布的 AT 固件，官方定位为 LuatOS 二次开发型号。出厂时模块内可能带有工厂测试用的 AT 固件，但那仅用于产线测试，不对客户开放、也不作为正式版本维护；客户使用必须烧录 LuatOS 内核固件加脚本开发。EGP 的 LuatOS 固件下载页：https://docs.openluat.com/air780egh/luatos/firmware/780egp_version/ 。若项目必须用 AT 指令开发，通信+定位场景请选用 AT 定位型号 Air780EG2（AT 固件见 https://docs.openluat.com/atmozu/product/firmware/ ），选型以官方选型指南为准：https://docs.openluat.com/SelectionGuide/SelectionGuide/ 。
17. Air780E的程序直接下载到Air780EPM能正常运行吗？
解答： 结论：业务脚本基本通用，但不能保证直接下载就完全正常，主要差异在内核固件、管脚复用和外设资源。要点：①Air780E 与 Air780EPM/EHM/EHV 是不同硬件平台，必须使用 EPM 对应的 LuatOS 内核（core），不能烧 E 的底层；②Lua 业务层 API 大部分一致，但管脚编号、复用关系不同，凡涉及 GPIO/UART/SPI/I2C 等引脚初始化的代码都要按 EPM 硬件手册和 pins 核心库重新核对，建议用 pins.setup/各外设库按 EPM 管脚表改一遍再下载；③EPM 无音频 Codec，需要播放/录音等音频功能请选内置 ES8311 的 Air780EHV；④迁移后先跑官方 demo（socket/mqtt/外设）验证硬件链路，再合并业务代码。型号差异见 https://docs.openluat.com/air780epm/product/ 。
18. Air780EPM支持MP3播放吗？Air780EHM加上TM8211可以播放MP3吗？
解答： 结论：Air780EPM 不支持 MP3 播放；Air780EHM 外接 TM8211（I2S 音频 DAC）后可以播放 MP3。原理：音频播放需要音频编解码通路，EPM 既无内置 Audio Codec，硬件资源也不开放音频功能，软件上无法播放；EHM 同样没有内置 Codec，但保留了 I2S 数字音频接口，可外接 TM8211 等 I2S DAC，再经功放/喇叭出声，LuatOS 侧使用音频播放接口输出 PCM/MP3 数据。若希望省掉外部 DAC、直接做语音类产品，建议选内置 ES8311 Codec 的 Air780EHV。型号资源差异以官方产品页为准：https://docs.openluat.com/air780epm/product/ 。
19. 嘉立创EDA里780EPT的参考封装为什么只显示一部分？能用780E的封装替代吗？
解答： 结论：不要用 Air780E 的封装替代 Air780EPT，两者虽同为 Cat.1 模组，但管脚数量、编号和功能定义存在差异，直接套用会导致焊接错位或功能脚接错。嘉立创 EDA 中参考封装只显示一部分，通常是元件库绘制不完整或被丝印/禁布层遮挡，并非真实管脚缺失。正确做法：①以合宙官方发布的 Air780EPT 硬件设计手册中的"推荐 PCB 封装（Recommended PCB Footprint）"尺寸图为准，包含焊盘排布、钢网、本体和禁布区；②从官方资料下载 DXF/封装文件，或在官方库中核对完整封装后自行在 EDA 中补齐；③制板前用模组 3D/实物核对一号脚定位和管脚一一对应。AT 模组资料入口：https://docs.openluat.com/atmozu/product/shouce/ 。
20. AIR780E还有在卖吗？是否有AT开发的demo？
解答： 结论：Air780E 的供货状态请以合宙官方淘宝店实时商品页为准（https://luat.taobao.com/ ），文档站仍保留其全套资料；新项目选型建议参考官方选型指南确认当前主推替代型号。Air780E 本身支持 AT 指令开发，AT 固件与使用资料（含 AT 手册、固件版本、硬件设计指导等）统一在 AT 模组资料中心获取：https://docs.openluat.com/atmozu/product/shouce/ ，AT 固件版本页：https://docs.openluat.com/atmozu/product/firmware/ 。若只是需要快速联网透传，也可直接评估合宙 DTU 整机方案（https://dtu.openluat.com/ ），免二次开发。
21. Air780EHV的全套资料（含屏幕等相关资料）在哪里？
解答： 结论：型号基础资料与屏幕等配件资料的入口不同，按下面路径取。①Air780EHV 官方资料中心（产品介绍、硬件手册、LuatOS 固件、demo、低功耗/音频等应用文档）：https://docs.openluat.com/air780ehv/product/ ；②EHV 内置 ES8311 音频 Codec，语音相关示例在其 LuatOS 应用文档中；③开发板配套 LCD 屏等外设的接线与驱动说明，在该型号"开发板硬件环境介绍/规格书/原理图PCB封装"等栏目中按开发板名称查找（产品手册汇总页 https://docs.openluat.com/air780ehv/product/shouce/ 内含规格书、硬件设计手册、管脚映射、开发板资料等下载项），配件清单也可在合宙官方淘宝店商品详情页核对：https://luat.taobao.com/ 。若按型号+开发板版本仍找不到对应屏幕资料，记录开发板丝印版本号通过官方企业微信群获取直链。
22. 查询固件升级日志提示无权限，说明设备没有烧录我创建项目的key吗？
解答： 结论："无权限"不一定是 Key 没烧对，根本前提是该 IMEI 当前是否归属在你账号下的项目里——只有归属者能查升级日志、给设备下发升级。处理办法：①登录 IoT 平台确认该 IMEI 是否在你的项目设备列表中；②合宙官方渠道采购的设备，可凭订单信息联系官方客服协助归属（官方电商订单也可在 crm.luatos.com 用下单手机号、初始密码 88888888 自助查询，限 2025 年 10 月之后的订单）；③第三方渠道采购的设备，需先由原账号方在平台上移除/释放，再添加到你的项目；④确认归属后，再检查设备固件烧录的 PROJECT_KEY 是否为你项目的 Key（Key 决定设备上线后自动归属到哪个项目）。完整规则见 https://docs.openluat.com/air780epm/product/attributioniot/ 。
23. 设备被其他账号添加过，有没有强制解除转移到我账号下的办法？
解答： 结论：平台不支持跨账号"强制解除"归属，设备同一时间只能归属于一个账号项目，必须由原归属方释放，或凭采购凭证走官方渠道处理，这是为了防止设备被恶意抢绑。按采购来源处理：①合宙官方电商购买（2025 年 10 月后订单）：在 crm.luatos.com 用下单手机号登录（初始密码 88888888），查到订单对应的 IMEI 后可自助/联系客服归属到你的账号；②线下批量采购：在 iot.openluat.com 通过"批量转移"功能，凭采购信息处理；③第三方/渠道商购买：只能联系卖家，让其从原账号移除该 IMEI 后你再添加，合宙官方没有权限绕过原账号；④若与原账号方存在纠纷，需双方协商或凭合同、发票等凭证通过官方企业微信支持群提交工单处理。规则详见：https://docs.openluat.com/air780epm/product/attributioniot/ 。
24. 8101核心板USB HUB接4个摄像头，固定拔插第四个会导致崩溃重启，是什么原因？
解答： 结论：Air8101 的 USB Host 设计上不建议在业务运行中带电热插拔摄像头，固定第四个口拔插就崩溃，通常是热插拔瞬间的电源冲击/USB 重新枚举导致协议栈或供电异常重启，而非摄像头本身损坏。原因与对策：①4 路摄像头满接时 HUB 电流已接近上限，拔出/插入瞬间的浪涌会拉低 VBUS，优先给 HUB 和摄像头使用带外部独立供电的有源 HUB，不要全部从模组 USB 口取电；②更换不同主控方案、带过流保护的优质 HUB 交叉验证，排除单颗 HUB 的枚举兼容性问题；③软件上避免运行中拔插，需要更换摄像头时先在应用层停止采集、关闭 USB 设备再操作，或统一上电后再启动程序；④抓取出事时的 Luatools trace/log（log 目录含 AP/CP 日志和 ramdump），确认是欠压复位、看门狗还是 USB 枚举异常，必要时升级到 Air8101 最新正式内核固件。日志提交路径见 https://docs.openluat.com/common/howtouselog/ 。
25. luatos AI底层对接了哪个模型？与直接和模型对话有何区别？会更懂合宙产品、更权威吗？
解答： 结论：合宙 AI 问答（ai.luatos.com）是面向合宙产品的检索增强（RAG）智能助手，底层具体对接哪个大模型属于平台实现细节，官方未对外公布固定型号，且会持续迭代更换。与直接和通用大模型对话的区别在于：①语料不同——它优先检索合宙官方文档站（docs.openluat.com）、LuatOS API 手册、各型号硬件手册和 demo，回答带官方出处链接，而通用模型依赖自身训练数据，容易出现过时或编造的 API/参数；②范围受控——聚焦合宙模组选型、LuatOS 开发、烧录、云平台等问题，不做无关发散；③时效性更好——官方文档更新后检索结果随之更新。使用建议：涉及具体 API 名、参数、固件结论时，以 AI 给出的官方文档链接原文为准并交叉核对；AI 不能替代人工判断，关键设计请查选型指南 https://docs.openluat.com/SelectionGuide/SelectionGuide/ 和 API 文档 https://docs.openluat.com/osapi/ 。
26. 8202G进度如何？现在能买到吗？
解答： 结论：Air8202G（免开发 GPS 定位器/定位模组）已在合宙官方淘宝店上架销售，可直接下单；早期批次为无外壳的工程/试产形态，非正式整机版本，正式外壳整机版本随后发售（具体到货时间以下单页面和客服回复为准）。购买入口：合宙官方淘宝店 https://luat.taobao.com/ ，产品资料（功能介绍、配置说明、固件等）见 https://docs.openluat.com/air8202/product/ 。出货前建议向客服确认当前批次是否为带外壳的正式版，并在采购页面保留版本备注。
27. 用合宙模块配置新密码收不到任何回复是什么原因？
解答： 结论（以 Air8783 短信转发棒为例）：密码错误时设备会直接静默丢弃指令、不回复任何短信，所以"收不到任何回复"首先应怀疑指令中的旧密码不对，而非设备故障。按以下顺序排查：①核对指令格式必须严格为 密码#SETPWD#{"new_pwd":"6位以上新密码"}，初始密码 123456，若之前改过又忘记，旧密码不正确时无回执；②新密码不少于 6 位字符，否则按规则应回执"new_pwd必须不少于6位字符"，若连这条都没有，多半是短信未按配置指令解析（如多了空格/签名/长短信被拆分）；③确认使用的是普通手机 SIM 卡（物联网卡通常不支持短信）、设备卡有短信资费且信号正常、发送号码无拦截；④让设备给该号码发普通短信验证收发链路，再用 GETCFG 指令验证密码；⑤JSON 必须为英文半角符号，建议用官方"Air8783 配置指令生成工具"生成后原样发送。指令规则见：https://docs.openluat.com/air8783/product/config/ 。
28. 有没有air1601的PDF资料？
解答： 结论：有 PDF 资料，在 Air1601 官方资料中心可直接下载。入口：Air1601 产品手册汇总页 https://docs.openluat.com/air1601/product/shouce/ （规格书/原理图 PCB 封装/参考设计/开发板/核心板/引擎主机），页面列出各硬件版本的规格书、硬件设计手册 PDF 及封装压缩包；Air1602 引擎主机、TurnKey 开发板的资料分别在其硬件介绍页（如 https://docs.openluat.com/air1601/product/air1602_engine/hardware/ 、https://docs.openluat.com/air1601/product/air1601_turnkey_devboard/hardware/ ）；LuatOS 固件版本、烧录、demo、应用文档在 https://docs.openluat.com/air1601/ 对应栏目。若页面改版后找不到某一具体文件，记录所需文件名称（如"Air1601 规格书"）和硬件版本号，通过官方企业微信群索取最新直链；实物配件清单也可在合宙官方淘宝商品页核对：https://luat.taobao.com/ 。
29. Air8783如何设置短信转企微webhook地址？
解答： 结论：通过给 Air8783 设备卡号码发送一条配置短信即可设置企微（企业微信）机器人 webhook，无需烧录或登录后台。操作步骤：①在企业微信群添加"群机器人"，复制其 Webhook 地址（形如 https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=xxx，企微机器人无加签 secret，仅靠 key 鉴权，注意保密）；②用手机给 Air8783 内 SIM 卡号码发短信，内容为：123456#QIWEI#{"webhook":"https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=xxx"}（123456 为初始密码，已改密用新密码；如需自定义鉴权头可加 custom_headers 字段）；③设备校验密码成功后回执"企业微信配置已更新"，之后收到的普通短信即会 HTTP 推送到该群；④发送 123456#GETCFG#{} 可查询当前配置，删除地址时把 webhook 置空即可。务必使用普通手机 SIM 卡，物联网卡不适用。完整说明见官方文档：https://docs.openluat.com/air8783/product/config/#333 。
30. Air780EGG在低功耗模式+飞行模式、常规模式+飞行模式下的均衡待机功耗数据有吗？
解答： 结论：官方已公布 EPM/EHM 同平台（Air780EXX 系列）的分模式功耗基线，EGG 因内置 GNSS+G-Sensor 会额外增加约 30uA 静态电流；"飞行模式"叠加各功耗模式的具体数值官方未给出统一表格，需要按低功耗教程实测。可直接引用的官方数据（3.8V 供电、合宙服务器、5 分钟心跳条件）：①常规模式（联网在线）平均约 7~8mA；②低功耗模式（联网在线、RAM 保持）平均约 1.5~2mA；③PSM+ 模式（4G 离线即飞行、RAM 掉电、唤醒从头运行）3~12uA；④EGG 的 GPIO23 默认拉高，GNSS 备电与 G-Sensor 电源在低功耗/PSM+ 下合计约 30uA，需计入总功耗。对于"常规模式+飞行模式"（用 mobile.flymode(0,true) 关射频但 CPU 满频）和"低功耗模式+飞行模式"（射频关闭、RAM 保持，官方提供 prj_1_uart_camera 示例），由于没有网络寻呼，电流会明显低于对应联网值，建议用 Air9000P 功耗仪按教程实测取数。教程：https://docs.openluat.com/air780epm/luatos/app/lowpower/sleep/ ，通用功耗说明：https://docs.openluat.com/common/airpower/ 。
31. 有没有一种模式可以让4G射频完全关闭、其他功能正常、支持每10s唤醒读传感器、RAM数据不丢？休眠功耗大概多少？
解答： 结论：需求对应的组合是 "低功耗模式（pm.WORK_MODE=1）+ 飞行模式"，不是 PSM+。要点：①用 mobile.flymode(0, true) 关闭 4G 射频（协议栈离线），再用 pm.power(pm.WORK_MODE, 1) 进入低功耗模式，此时 CPU 降频、RAM 保持供电、唤醒后程序从原处继续运行，普通定时器（sys.timerStart/sys.wait/sys.timerLoopStart）可正常每 10 秒唤醒读传感器；②该模式下只有 AGPIO 可保持电平、普通 GPIO 随 VDD_EXT 间歇掉电，读传感器时要确认所接 I2C/UART 引脚域和传感器供电（必要时用 AGPIO/Vref 做保持电源）；③注意它不能被服务器 4G 唤醒，需要联网发数据时先 mobile.flymode(0, false) 退出飞行、重新注网；④功耗：射频关闭后没有寻呼电流，平台级待机远低于联网低功耗的 1.5~2mA，实际值与外设有强相关，官方未给该组合统一标称值，建议按教程用功耗仪实测；若可接受"唤醒后从头运行"，PSM+（WORK_MODE=3）可达 3~12uA，关键数据用 fskv 落盘。参考：https://docs.openluat.com/common/airpower/ 与 https://docs.openluat.com/air780epm/luatos/app/lowpower/sleep/ 。
32. 飞行模式就是PSM+模式吗？
解答： 结论：不是同一个概念，不能划等号，但两者有交集。区别：①飞行模式是"射频开关"概念，调用 mobile.flymode(0, true) 只是让 4G 协议栈脱网、关闭射频，CPU 照常全速运行、RAM 不掉电、代码不停，此时默认仍是常规功耗（7~8mA 量级），因此"飞行模式"本身不省电；②PSM+（pm.power(pm.WORK_MODE, 3)）是一种功耗管理模式，进入后模组处于飞行状态（4G 不可用），同时 CPU 深度休眠、RAM 掉电，只能靠 dtimer 定时器或 WAKEUP/PWRKEY 唤醒，唤醒后程序从头运行，待机 3~12uA；③两者可以组合：常规模式/低功耗模式下都可以再开飞行模式，其中"低功耗模式（WORK_MODE=1）+飞行模式"能做到关射频且 RAM 保持、代码继续跑。所以准确表述是：PSM+ 一定处于飞行（离线）状态，但飞行状态不等于 PSM+。详见 https://docs.openluat.com/common/airpower/ 。
33. 在合宙IoT页面的设备，如何转移到合宙LBS页面的项目里？air780eg需要购买LBS服务。
解答： 结论：设备不需要在两个平台之间做物理转移。IoT 平台（iot.openluat.com，设备接入/FOTA）和 LBS 基站定位服务是同一账号体系下的不同业务，设备始终归属在你账号的 IoT 项目中，LBS 服务按"账号/项目"开通授权，开通后该项目下的设备即可调用 LBS 定位接口。操作步骤：①确认设备已归属到你账号的 IoT 项目（否则先按归属流程处理：https://docs.openluat.com/air780epm/product/attributioniot/ ）；②在 LBS 服务页面用同一账号登录，购买/开通 LBS 服务并绑定目标项目（Air780EG 支持基站定位，GNSS+LBS 混合定位需配合相应脚本库）；③脚本中按 LBS 文档接入定位请求接口，用项目 Key/IMEI 鉴权。若 LBS 控制台找不到对应项目，检查登录账号是否与 IoT 平台一致，或通过官方企业微信支持群让客服协助项目绑定。
34. Air780EPM硬件有对应的AT固件吗？
解答： 结论：Air780EPM 没有对外发布的正式 AT 固件，它是 LuatOS 二次开发专用型号。出厂固件中可能带少量产线测试用 AT 指令，但不构成完整 AT 指令集、也不对外维护，不能作为 AT 模组使用。若产品确定走 AT 开发路线，应直接选型同规格的 AT 型号（如 Air780EPT 等），AT 模组的指令手册、固件与硬件设计资料统一在 AT 模组资料中心：https://docs.openluat.com/atmozu/product/shouce/ ，固件下载见 https://docs.openluat.com/atmozu/product/firmware/ 。选型以官方选型指南为准：https://docs.openluat.com/SelectionGuide/SelectionGuide/ 。
35. 有新版本Luateools时所有人不是同时收到推送吗？是按区域推送吗？
解答： 结论：Luatools 新版本不按区域分批推送，所有人看到的是同一个最新版；没收到更新提示，通常是本机更新检测时机、缓存或网络差异，而非灰度/区域策略。说明与处理：①Luatools 启动或点击"检查更新"时才向服务器请求版本信息，企业网络/代理拦截、杀软拦截都可能使检测失败；②不依赖推送，直接从官方地址下载最新完整安装包覆盖安装即可，数据日期当天最新版为 3.4.8，下载：https://cdn18.luatos.com/files/exe/Luatools_v3.exe ；③更新记录见 https://docs.openluat.com/common/Luatools/#luatools_2 ；④安装路径建议放在磁盘根目录附近的浅层级文件夹（如 D:\Luatools），避免因路径过深引发异常。
36. 使用2050版本固件会反复出现MQTT error -13，如何解决？
解答： 结论：MQTT 官方文档定义的错误事件只有 connect/tx/conack/other 四类，没有"-13"这个标准错误码，它属于底层网络/协议栈返回的负向错误值，反复出现一般不是业务脚本写错，而是链路在弱网或心跳保活环节被断开。处理建议：①先升级到该型号最新正式版内核固件（2050 属较旧版本，官方在后续版本持续修复网络稳定性问题），再用官方 demo 复现确认；②确认 keepalive 设置与运营商 NAT 老化时间匹配（库默认 240 秒，实际按约 0.75 周期发送心跳），弱网/复杂 NAT 环境下适当缩短心跳间隔；③用 mobile.rsrp()/rsrq()/snr() 检查现场信号，弱信号（如地下室）会导致 TCP 被基站或中间网关静默回收；④应用层实现掉线重连和消息补发——注意模块端 MQTT 库不做 QoS 重发，发布 QoS1 消息的应答与重传需自行保证；⑤抓取出事时段 Luatools trace（AP/CP 日志）提交官方支持群定位。MQTT 接口说明：https://docs.openluat.com/osapi/core/mqtt/ 。
37. 默认项目使用prj_1_mqtt_long打开日志也经常error -13，是什么原因？
解答： 结论：官方默认工程 prj_1_mqtt_long 在你这里也频繁报 -13，基本可以排除用户业务代码问题，问题出在网络链路质量或旧内核固件。-13 并非 MQTT 库文档定义的错误事件（文档只定义 connect/tx/conack/other），属于底层网络返回值，常见诱因：①弱信号导致 TCP 连接被静默回收；②运营商/中间网络 NAT 会话老化时间短于心跳间隔；③旧固件协议栈已知缺陷。验证与解决：①升级到该型号最新正式内核固件后用同一 demo 复测；②在出错点同时打印 mobile.csq()/rsrp()/rsrq() 和网络注册状态，确认是否伴随掉线、重注网；③把 keepalive 从默认值调小（如 60~120 秒）观察频率变化；④换一张不同运营商的 SIM 卡、换测试地点对比，判断是否为特定网络环境；⑤保留带时间戳的 trace 日志，必要时连同 IMEI、固件版本提交官方技术支持。文档：https://docs.openluat.com/osapi/core/mqtt/ 。
38. 任务里怎么设置关闭基站授时、开启NTP授时？
解答： 结论：两条配置配合使用——脚本中关闭基站自动授时，再启用 NTP 同步；iRTU 任务方式则在任务配置项中设置。①LuatOS 脚本：调用 mobile.syncTime(false) 关闭基站授时（该函数控制注网后是否用网络时间自动设置 RTC），然后使用 socket 库的 SNTP 能力 socket.sntp(tz) 向 NTP 服务器获取时间，时间结果可订阅系统消息 NTP_UPDATE（消息中可区分来源），再写入 RTC；②iRTU 平台任务：在 iRTU 后台的任务配置中找到时间同步相关选项，关闭"基站授时/NITZ"、开启"NTP 授时"并按需配置 NTP 服务器与时区，保存后重新下发任务即可（适合已在现场、不方便重新烧录的设备）。函数说明见 mobile 文档锚点：https://docs.openluat.com/osapi/core/mobile/#mobilesynctimeenable ，时间同步整体方案见：https://docs.openluat.com/common/time_sync/ ，iRTU 任务配置见：https://docs.openluat.com/value/irtu/docs/task/ 。
39. 780E 4G模块获取时间返回错误，怎么解决？
解答： 结论：先关闭基站授时、改用 NTP 授时即可解决绝大多数"时间错误"问题。原因：模块注网时默认接受运营商基站下发的时间（NITZ），个别运营商/物联网卡下发的时区或时间不准，会导致 RTC 时间偏差；而 NTP 时间来自公网时间服务器，精度和一致性更好。处理：①脚本中调用 mobile.syncTime(false) 关闭基站自动授时；②调用 socket.sntp(tz) 发起 NTP 同步（tz 为时区，如东八区传 8），成功后设置 RTC，业务时间统一从 RTC 读取；③同步建议在联网成功（IP_READY/网络就绪）后执行，并在每次唤醒联网后做一次校时；④已部署到现场、不便重新烧录的 iRTU 设备，在 iRTU 后台任务配置里增加"关闭基站授时 + 开启 NTP 授时"并重新下发任务。参考：https://docs.openluat.com/common/time_sync/ 与 https://docs.openluat.com/osapi/core/mobile/#mobilesynctimeenable 。
40. IoT升级里“全部升级”按钮建议增加二级验证或授权，全部升级不需要填IMEI就会升级全部设备，是否合理？
解答： 结论：这是合宙 IoT 平台的设计行为而非缺陷——"升级全部设备"是创建固件时的勾选项，一旦勾选，该项目下所有设备（含后续新归属的设备）请求升级时都会匹配到此固件，不需要逐个填写 IMEI；增加二次确认的建议合理，平台侧也在持续优化操作安全。原理：平台对一个固件提供两种升级范围，二选一即可——①创建固件时勾选"升级全部设备"，则整个项目下设备全部升级；②不勾选则需在创建后通过"指定设备"填写要升级的 IMEI 白名单（8101 等无 IMEI 的型号填 STA MAC）；两者都不配置时，该固件不会升级任何设备。规避误升级的操作建议：①正式推送前先用"指定设备"填 1~2 台测试机 IMEI 做灰度，验证回调码 0 且设备 rtos.reboot() 后版本正确，再改"全部升级"；②项目按产品/批次拆分，避免测试设备与量产设备混在同一项目；③版本号严格按 A.B.C 规则递增，错误版本号会被平台拒绝（回调码 5），同版本反复推送会触发"连续 6 次升级后禁止再升级"的保护；④上传固件时核对固件名与 rtos.bsp() 返回型号一致。规则说明见官方教程：https://docs.openluat.com/air8101/luatos/app/base/fota/ ，平台入口：https://iot.openluat.com/ 。对操作安全的功能建议可通过官方企业微信支持群提交产品反馈。
41. 780E用了一段时间后AT+CPIN?返回10（未插卡），约1500台设备中已有10例，是什么问题？
解答： 结论：1500 台中 10 例（约 0.7%）在用一段时间后报"未插卡"，属小批量硬件失效，首要怀疑 SIM 卡座焊点虚焊/接触不良，其次是 SIM 卡本身氧化或卡座检测脚异常。AT+CPIN? 返回 10（SIM not inserted）表示模块在卡座触点上检测不到卡，与基带软件无关。排查与处理：①复现设备先换一张确定正常的 SIM 卡对比，排除卡体氧化/焊脚松脱（贴片卡在振动场景下也会掉焊）；②显微镜检查 SIM 卡座 6 个触点（VDD/GND/CLK/DATA/RST/检测脚）的焊点有无虚焊、裂纹，补焊一遍后复测；③检查卡座簧片弹力与 SIM 卡厚度，换用品牌连接器、加卡托或点胶固定；④示波器/逻辑分析仪量测开机时 SIM_VDD（典型 1.8/3.0V）是否正常上电、CLK 有无时钟波形、DATA 线有无应答，无波形沿卡座方向查；⑤DATA/RST/CLK 走线加的 ESD/滤波器件若漏电也会拉死信号，可临时摘掉对比；⑥统计失效设备的生产批次、卡座料号和波峰焊/回流焊炉温曲线（炉温参考 https://docs.openluat.com/common/smt/ ），同批次加严 AOI 与 SIM 通信功能测试。SIM 硬件设计可参考 Air8780 工业模组的 SIM 卡座电路说明：https://docs.openluat.com/air8780/luatos/hardware/module/circuit/sim/ 。
42. 主控芯片是AIR1602，串口烧录具体接哪几根线？
解答： 结论：使用官方烧录方案时不需要自己接线——Air1602 引擎主机/开发板已板载 CH343 USB 转串口，用 Type-C 数据线接电脑，Luatools 选 "USB-Enhanced-SERIAL CH343" 端口、波特率设 6000000（6M）即可烧录，背面拨码开关需拨到 160X 侧（烧录 Air6205 时拨 6205 侧，走 CH340、波特率 2000000）。若做自研板、从芯片 UART 裸烧，至少需要接 4 根线：模块 TXD→USB转串口 RXD、模块 RXD→USB转串口 TXD、GND 共地、RESET（复位脚，由下载工具在下载前后拉低复位以进入/退出烧录时序），另需保证模块供电可靠并按上电/下载时序控制启动脚；USB 转串口建议用 CH343 等高速器件并把波特率设为 6000000。接线前务必对照 Air1601/Air1602 硬件手册的管脚复用表确认所用 UART 引脚号（官方提供管脚复用表 xlsx：https://docs.openluat.com/air1601/product/shouce/ ）。完整烧录步骤（驱动安装、拨码、Luatools 配置）见官方教程：https://docs.openluat.com/air1601/product/air1602_engine/download/ 。
43. Air1601与串口屏幕通信的时序到底哪个是对的？
解答： 结论：以官方 demo 中自带的上电与通信时序为准，串口屏（尤其带驱动板/字库的智能串口屏）对复位脉宽、上电后等待时长和首条指令顺序有要求，网上不同版本的时序延时不一致，照搬容易出现黑屏或首帧丢失。正确做法：①从官方 demo 仓库获取与屏幕型号匹配的工程（Air1601/Air1602 demo：https://gitee.com/openLuat/LuatOS/tree/master/module/Air1601_Air1602 ，demo 使用指南：https://docs.openluat.com/air1601/luatos/demo/ ）；②严格复刻其中的时序：上电→复位脚拉低/释放的脉宽→上电后固定延时（一般数百 ms 等待屏内 MCU 启动）→按波特率（8N1）发送初始化指令→等待应答后再发显示数据；③用 pins.setup 控制复位/背光脚，uart.setup 后用 uart.on(..., "receive") 收屏端 ACK，不要用固定死等替代应答；④波特率、电平（3.3V TTL，勿直接接 RS232 电平）、TX/RX 交叉、共地逐一核对；⑤若仍异常，用逻辑分析仪抓官方 demo 与自有代码的波形对比复位脉宽和首字节时间差，按实测补齐延时。UART 接口说明：https://docs.openluat.com/air1601/luatos/app/driver/uart/ 。
44. 780EX2给1602供网只烧固件可以吗？
解答： 结论：不可以只烧底层固件，必须"带 Airlink over UART 能力的 8 号固件 + 配套 Airlink 脚本"两者都烧，1602 侧还要运行 airlink 通信脚本，链路才能打通。原理：Air1601/1602 自身不带 4G，外挂 4G 模组供网走的是 Airlink over UART（芯片间网络透传协议，核心库 airlink），4G 模组不是拨号后就能共享网络，必须在模组侧运行 Airlink 服务脚本，把 socket 数据通过 UART 转发给 1602。以官方 TurnKey 开发板外挂 Air780EPM 的标准做法为参照（Air780EX2 与 Air780EPM/ER2 使用同一主芯片，源码同在 Gitee 的 Air780EPM 目录）：①4G 模组烧录 V2034 及以上、支持 Airlink over UART 的 8 号固件（如 LuatOS-SoC_V2034_Air780EPM_8.soc），EX2/ER2 机型在 Luatools 中按实际型号选择对应 8 号固件，以设备 rtos.bsp() 返回值与 Luatools 固件列表为准；②烧录官方工程 module/Air1601_Air1602/project/Air1601_turnkey_devboard/Air780EPM 下的配套脚本（EX2 机型同目录参考），脚本负责开机注网、建立 Airlink；③1602 侧 main.lua 按引擎主机版本选对屏幕驱动，并启用 airlink 组网；④硬件上 UART 的 TX/RX 交叉、共地，供电满足 4G 发射峰值电流。教程与脚本：https://docs.openluat.com/air1601/product/air1601_turnkey_devboard/download/ （4.1 节 Airlink over uart），https://gitee.com/openLuat/LuatOS/tree/master/module/Air1601_Air1602/project/Air1601_turnkey_devboard/Air780EPM 。
45. EX2用ER2固件吗？
解答： 结论：不能简单按"EX2 烧 ER2 固件"理解。官方已明确说明 Air780ER2 / Air780EX2 / Air780EPM / Air780EGP 等部分型号使用同一主芯片，LuatOS 源码共用 Gitee 上 Air780EPM 的同一目录，但同芯片不等于固件文件可混烧——不同型号的射频校准、封装外设和 rtos.bsp() 标识不同。选型与烧录规则：①在 Luatools"选择内核固件"列表中按你模组丝印的完整型号（Air780EX2 / Air780EX2T-3.3V / Air780ER2）选择对应固件，列表里有该型号条目就用该条目，不要手动替用其他型号；②AT 开发走 AT 固件，Air780EX2T 的 AT 固件在 AT 固件版本页按 780EX2T 分类下载（https://docs.openluat.com/atmozu/product/firmware/ ）；③LuatOS 开发时以设备实际打印的 rtos.bsp() 返回值为准，FOTA 固件名默认是 _G.PROJECT.."_LuatOS-SoC_"..rtos.bsp()，烧错型号会导致升级匹配失败；④Air780EX2 产品页：https://docs.openluat.com/air780ex2/product/ ，同芯片说明见 Air8783 产品页：https://docs.openluat.com/air8783/product/ 。若 Luatools 列表中找不到具体型号，将模组完整丝印和 rtos.bsp() 打印值通过官方企业微信支持群确认后再烧录。
46. 合宙的4G模块有全球通用版本吗？比如同一个型号支持全球认证和频段？
解答： 结论：没有单一"全球通"型号，合宙 4G 模组按认证区域分系列供货，同一芯片平台会出国内、欧亚、北美、日本等不同频段/认证版本，选型按目标销售区域对号入座。以 Air8000 系列为例：①国内型号 Air8000/Air8000A/W/D/T 等，频段 B1/B3/B5/B8/B34/B38/B39/B40/B41；②欧亚型号 Air8000U，B1/B3/B5/B7/B8/B20/B28/B38/B40/B41（欧洲/亚洲，日本除外），具体覆盖国家列表见 https://docs.openluat.com/air8000/product/pinduan/ ；③北美型号 Air8000N，B2/B4/B5/B7/B12/B13/B17/B18/B19/B25/B26/B66/B71/B38/B41。各区域版本硬件兼容、软件共用，但认证与频段不同，不能用国内版出口北美或反之。Air780 系列同样按后缀区分区域（如 EHN/EHU 等海外型号）。完整型号-频段-认证对照以官方选型指南为准：https://docs.openluat.com/SelectionGuide/SelectionGuide/ （其中"海外需求"章节按单 4G、4G+定位、4G+WiFi+蓝牙+定位分别列型号）；多区域出货请按区域分别备料、分别过认证，具体型号认证证书可向官方销售索取。
47. Air780EGP的8号固件在哪里下载？
解答： 结论：Air780EGP 的 LuatOS 固件只发布带 GNSS 能力的 103/104/105 等编号固件（64 位线），普通编号固件不含 libgnss 定位核心库，烧入后无法使用 GNSS；所谓"8 号固件"是外挂场景下的功能裁剪编号（如 Airlink over UART 专用的 _8.soc），EGP 选型时以其固件版本页实际列出的编号为准。下载方式（两种，内容一致）：①官方固件版本页按版本号直接下载：https://docs.openluat.com/air780egh/luatos/firmware/780egp_version/ （EGP 归属 Air780EGH 文档站，不是 air780epm 路径）；②打开 Luatools → 项目管理 → 选择内核固件，型号选 Air780EGP，列表即拉取最新固件，注意 1–99 为 32 位、101–199 为 64 位，EGP 请用页面指定的 64 位 GNSS 固件。烧录后用 rtos.version()、rtos.bsp() 打印核对，定位功能用官方 libgnss demo 验证。EGP 为 LuatOS 开发型号，无对外 AT 固件。
48. Luatools生成量产文件时多出现了一个Air8000A目录，导致固件无法远程升级，怎么回事？
解答： 结论：这是量产包固件名（firmware_name）与云平台配置不匹配导致的——新版 Luatools 按设备实际 rtos.bsp() 生成了 Air8000A 目录/固件后缀，而 IoT 平台固件列表里登记的仍是 Air8000，设备请求升级时按 _G.PROJECT.."_LuatOS-SoC_"..rtos.bsp() 拼出的固件名在平台匹配不到，自然无法远程升级。处理步骤：①在设备上打印 rtos.bsp()，确认实际型号字符串到底是 Air8000 还是 Air8000A（Air8000A 是国内系列子型号，硬件/频段定义不同，属正常型号，不是工具出错）；②登录 IoT 平台，在固件列表中把固件名改成与设备实际型号完全一致的字符串，或新建一条以 Air8000A 命名的固件记录再上传升级包；③升级范围勾选"升级全部设备"或配置"指定设备"IMEI，二者皆不配则不会升级；④重新生成量产文件时保持 Luatools 为最新版，核对项目名（PROJECT）与平台固件前缀一致；⑤若同一项目下混有 Air8000 与 Air8000A 设备，需分别上传两份对应固件。型号与命名规则参考 Air8000 系列介绍：https://docs.openluat.com/air8000/product/ ，FOTA 固件名机制见 https://docs.openluat.com/osapi/ext/libfota2/ 。
49. 使用合宙云平台远程FOTA升级，为什么设备一直提示升级失败？
解答： 结论：本案例已定位为设备归属账号问题——只有 IMEI 归属在你账号的项目下、且固件烧录了该项目的 PROJECT_KEY，平台才允许下发升级；归属在其他账号（含渠道商、原厂测试账号）时升级请求会被拒绝。处理与通用排查：①在 IoT 平台（iot.openluat.com）确认该 IMEI 是否出现在你账号的项目设备列表中，不在则先按归属流程处理：官方渠道订单可在 crm.luatos.com 用下单手机号（初始密码 88888888）查询并联系客服归属，第三方采购需原账号方先移除；②Luatools 项目参数中填入你项目的 Key 重新烧录，设备上线后即按 Key 自动归属；③归属正确后仍失败的，按 libfota2 回调码定位：1 连接失败（查信号/APN/服务器地址）、2 URL 错误、3 服务器断开、4 接收报文错误（含"已是最新版本"）、5 版本号格式错误（IoT 平台版本必须为 xxx.yyy.zzz 三段式且按规则递增）、0 成功后必须调用 rtos.reboot() 才会完成切换；④核对云平台固件名与 rtos.bsp() 一致、升级范围已配置（全部升级或指定 IMEI）。归属规则：https://docs.openluat.com/air780epm/product/attributioniot/ ，FOTA 教程：https://docs.openluat.com/air8101/luatos/app/base/fota/ ，回调码：https://docs.openluat.com/osapi/ext/libfota2/ 。
50. 是否能帮忙把几片AIR780EGH的IMEI添加到采购账号下？
解答： 结论：技术支持群不直接执行归属操作，设备归属必须由账号持有人按平台规则自助完成或凭采购凭证走官方渠道，这是为了防止设备被恶意抢绑。按采购来源处理：①合宙官方电商（淘宝店）购买、2025 年 10 月之后的订单：用下单手机号登录 crm.luatos.com（初始密码 88888888），在订单中查到对应 IMEI 后自助归属，或联系官方客服/销售凭订单信息归属到你的 iot.openluat.com 账号项目；②线下合同/批量采购：准备合同、发票、IMEI 清单，通过官方企业微信支持群或对接销售提交，使用 IoT 平台"批量转移"功能处理；③第三方/渠道商购买：设备当前在渠道商账号下的，必须由对方先在平台移除该 IMEI，你才能在自己项目中添加，合宙官方无法绕过原账号强制转移；④归属后在 Luatools 项目参数中填入你的 PROJECT_KEY 重新烧录，设备后续请求会固定归属到你的项目。归属规则与流程：https://docs.openluat.com/air780epm/product/attributioniot/ 。
51. Air780EG核心板烧录不了，EPM调试用什么软件？有EPM的core链接吗？
解答： 结论：Air780EPM（及 Air780EG 核心板）的调试、烧录统一使用官方工具 Luatools，底层 core 从 Luatools 在线固件列表直接选取，也可在固件版本页下载。资源链接：①Luatools 最新版直链 https://cdn18.luatos.com/files/exe/Luatools_v3.exe ，使用教程 https://docs.openluat.com/common/Luatools/ ；②Air780EPM LuatOS 固件版本页：https://docs.openluat.com/air780epm/luatos/firmware/780epm_version/ ；③Air780EG 为已停产老型号，其固件/资料仍在文档站对应型号栏目保留。Air780EG 核心板烧录不了的排查：①升级到最新 Luatools，安装官方 USB 驱动（https://docs.openluat.com/common/usb_drv/ ），设备管理器确认枚举到端口、无黄色感叹号；②换短的带数据线和 USB2.0 口，外接电源保证 4G 发射时供电充足；③按住 BOOT 键再上电进入强制下载模式后下载；④核对选的 core 型号与板上模组一致（EG 不能直接烧 EPM 的底层，反之亦然）。完整烧录排查见 https://docs.openluat.com/common/howtodown/ 。
52. 780EG已停产，现在想开发新项目应该选什么型号？
解答： 结论：按开发路线对号替换 Air780EG（4G+GNSS 定位模组）——走 AT 指令开发选 Air780EG2，走 LuatOS 二次开发选 Air780EGP。说明：①Air780EG2 是 AT 定位型号，AT 固件与指令手册在 AT 模组资料中心（固件 https://docs.openluat.com/atmozu/product/firmware/ ，资料 https://docs.openluat.com/atmozu/product/shouce/ ）；②Air780EGP 是 LuatOS 定位型号，内置 GNSS，固件须用带 libgnss 的 103/104/105 等编号版本（https://docs.openluat.com/air780egh/luatos/firmware/780egp_version/ ），无对外 AT 固件；③两者与 EG 同为 4G+定位平台，但管脚封装和复用需重新核对硬件手册，PCB 不能默认直接替用，迁移外设代码时按 pins 表逐一核对；④若还需要 G-sensor、AGPS 等特性可看 Air780EGG。最终选型（含海外区域型号、封装尺寸、认证）以官方选型指南为准：https://docs.openluat.com/SelectionGuide/SelectionGuide/ 。
53. 现在没有AHT20的库了吗？之前有AHT10的，能否帮忙封装？AHT10停产了。
解答： 结论：AHT20 与 AHT10 同为 I2C 接口温湿度传感器，通信协议基本兼容（设备地址 0x38、初始化与测量命令序列一致），在官方专用驱动发布前，可直接用 I2C 核心库按数据手册时序自写驱动，或在 AHT10 例程基础上验证使用；官方传感器扩展库在持续扩充，适配进度以官方仓库为准。可操作步骤：①硬件按 I2C 接 SCL/SDA、VDD（2.0~5.5V，建议 3.3V）、GND，SDA/SCL 加 4.7kΩ~10kΩ 上拉；②软件用 i2c.setup(i2cid, speed) 初始化后，发送 0xBE 软复位→等待 40ms→发送 0xAC,0x33,0x00 触发测量→等待 80ms→读 6 字节，按手册把 20 位湿度/20 位温度换算为相对湿度 %RH 与 ℃；③上电后先发 0x71 读状态字确认校准位（Bit3）为 1，否则发 0xBE 初始化。i2c 接口文档：https://docs.openluat.com/osapi/core/i2c/ ，官方传感器驱动目录（可关注 AHT 系列更新）：https://gitee.com/openLuat/LuatOS/tree/master/module 。若需要官方出专用库，可通过官方企业微信支持群提交器件型号与数据手册申请适配。
54. spi以太网按原libfota2方式升级，4G-uart-airlink走fota_manage方式，会不会有影响？
解答： 结论：两条升级通路相互独立、可以共存，互不影响——SPI 以太网通路继续按原 libfota2 方式接入平台升级；4G-UART-Airlink 通路（外挂 4G 模组经 Airlink over UART 共享网络）按 fota_manage 方式进行。原理：libfota2 是设备自身直接通过当前可用网络链路（此处为 SPI 以太网）向升级服务器发起请求；fota_manage 用于管理跨芯片/Airlink 场景下的升级调度，两者检测时机、通道和目标固件各自独立。落地要点：①不要在同一任务里同时触发两路升级，建议由业务根据当前联网方式（以太网优先、4G 兜底）选择一条通路执行，另一条不启动；②两路上报到平台的固件名必须与各自 rtos.bsp() 一致、版本号分别按 A.B.C 规则递增；③外挂 4G 模组需烧支持 Airlink over UART 的 8 号固件及配套脚本（见 https://docs.openluat.com/air1601/product/air1601_turnkey_devboard/download/ ）；④升级成功回调（result==0）后都必须调用 rtos.reboot() 完成切换。libfota2 接口：https://docs.openluat.com/osapi/ext/libfota2/ ，FOTA 教程：https://docs.openluat.com/air8101/luatos/app/base/fota/ 。
55. 设备MQTT批量掉线，重启后恢复，可能是什么原因？
解答： 结论：批量设备同时掉线、重启后恢复，通常是网络链路/NAT 老化或旧内核固件稳定性问题，而非单台设备业务逻辑故障（MQTT 库错误事件仅定义 connect/tx/conack/other，负向错误码如 -13 来自底层网络）。排查与解决：①统一升级到该型号最新正式版内核固件（2050 为较旧版本，后续版本修复了多项网络稳定性问题），先用官方 mqtt demo 在同区域、同运营商 SIM 卡下复现；②检查 keepalive 与运营商 NAT 老化时间匹配（库默认 240 秒、约 0.75 周期发心跳），弱网/复杂 NAT 下缩短到 60~120 秒；③确认掉线时段信号质量，打印 mobile.csq()/rsrp()/rsrq()/snr() 及注网状态，地下车库等弱信号场景会导致 TCP 被静默回收；④应用层必须实现掉线自动重连与 QoS1 消息补发（模块端 MQTT 库不做 QoS 重发），并加"网络看门狗"：长时间无心跳响应则主动断开重连、必要时重启协议栈；⑤批量同时掉线还要排查平台侧连接数上限、客户服务器负载与运营商基站侧故障，保留带时间戳的 AP/CP trace（https://docs.openluat.com/common/howtouselog/ ）交叉分析。MQTT 接口：https://docs.openluat.com/osapi/core/mqtt/ 。
56. Air780EPM SDK V2018是否支持TLS1.3？
解答： 结论：V2018 属较早期内核版本，是否支持 TLS1.3 必须以该版本固件的实际协议协商结果为准，不能仅凭口头确认；TLS 由内核内置的 mbedTLS/SSL 协议栈提供，LuatOS 脚本层没有单独的"开启 TLS1.3"开关，握手时由模组与服务器按双方都支持的最高版本自动协商。建议按以下步骤确认并落地：①升级到 Air780EPM 最新正式版内核固件（新内核持续跟进 mbedTLS 版本与加密套件，TLS1.3 支持以新版为准）：https://docs.openluat.com/air780epm/luatos/firmware/780epm_version/ ；②用官方 socket/mqtt demo 连一个 TLS1.3 测试服务器（或自建服务器强制仅允许 TLS1.3），握手成功且抓包看到 ServerHello 中 negotiated version 为 0x0304 即支持；若服务器仅允许 TLS1.3 而握手失败，则该内核不支持，必须升级内核；③生产环境建议服务器同时开启 TLS1.2/TLS1.3 兼容，避免老内核设备失联；④确需在 V2018 上锁定结论，保留握手 trace 或 Wireshark 抓包提交官方企业微信支持群，由固件工程师按该版本 mbedTLS 配置确认。加解密/SSL 相关能力可参考 crypto 库说明：https://docs.openluat.com/osapi/core/crypto/ 。
57. Air780EPM开发板BAT脚输出4.0V，是否能直接接3.7V聚合物锂电池？商家说电池截止充电电压4.2V会导致充不满，如何解决？
解答： 结论：不能把 BAT 脚简单当作"充电输出"直接给 3.7V 聚合物锂电池充电，必须经专用锂电池充电管理 IC（恒流恒压 CC/CV 充电，充满截止电压 4.2V）；BAT 脚测到 4.0V 是电池在充电过程中的端电压或板载充电电路在该工况下的电压，不能据此判断"充不满"。原理：3.7V 是锂电池标称电压，满电截止电压 4.2V，充电必须按"预充→恒流（典型 0.5C）→4.2V 恒压截止（截止电流约 0.05C）"曲线进行，直供 4.0V 恒压既无法把电池充到 4.2V（确会充不满、容量损失），又缺少过充/过放/过流/温度保护，存在安全隐患。解决方案：①使用带板载充电管理电路的开发板/工业板版本（如 Air8780 系列带锂电池插座及充电电路，参考其充电电路说明 https://docs.openluat.com/air8780/luatos/hardware/module/circuit/charge/ ），电池接板上 BAT 插座即可；②自研板在 VBUS(5V) 与电池之间加专用充电管理芯片（如 TP4056/TP4054、CN3163、SGM41511 等，按电池容量设充电电流），模组 VBAT 接充电芯片 SYSTEM/BAT 输出；③用万用表在充电末期量电池端电压能否到 4.15~4.2V、电流是否降到截止电流来判断是否真充满；④不要用模组 GPIO/普通 LDO 直接给电池充电。低功耗与供电设计可参考 https://docs.openluat.com/common/airpower/ 。
58. 有没有高性价比的模组推荐？参考合宙Air780EG的功能用于BMS采集。
解答： 结论：BMS 电池采集场景若需要"4G+GNSS 定位"且追求快速量产，可参考 Air8202G（免开发 GPS 定位器方案，4G/GNSS 天线官方已调通、定位快、整机资料齐全）：https://docs.openluat.com/air8202/product/ ；若 BMS 板上已有主控 MCU，只需一个串口 AT 透传的 4G 数传模组，可用 Air780EX2T 等邮票孔/插针 AT 型号（AT 固件 https://docs.openluat.com/atmozu/product/firmware/ ）；若希望单模组完成"采集+4G+定位"的 LuatOS 二次开发，Air780EG 的在产替代是 Air780EGP（LuatOS 路线）或 Air780EG2（AT 路线）。选型要点：BMS 场景多在电池包内，GNSS 天线环境差，优先确认安装位置能否引出天线，并关注低功耗（PSM+ 3~12uA 量级）与 UART/ADC 资源。最终型号以官方选型指南的功能矩阵为准：https://docs.openluat.com/SelectionGuide/SelectionGuide/ ，样品可在官方淘宝店对比验证：https://luat.taobao.com/ 。
59. 远程OTA的教程有吗？为什么每次重启都执行一次升级，删除固件后仍这样？
解答： 结论：有完整官方教程（Air8101 FOTA 远程升级：https://docs.openluat.com/air8101/luatos/app/base/fota/ ，libfota2 接口：https://docs.openluat.com/osapi/ext/libfota2/ ）；"每次重启都升级、删了固件仍这样"不是本地残留，而是设备端与平台端三个常见原因之一：①升级成功回调（result==0）后没有调用 rtos.reboot()，新固件未生效，平台侧版本号比对仍旧，于是再次下发；②新固件版本号没有按规则递增，平台一直判定"有新版本"；③云端升级任务配置为"升级全部设备"，设备归属在该项目下就会被持续命中。删除本地固件文件不影响云端升级任务，只要设备还在升级范围内，平台就会继续推送。
原理：libfota2 每次上电联网后携带 project_key、imei、firmware_name（默认 _G.PROJECT.."_LuatOS-SoC_"..rtos.bsp()）和当前脚本版本号去平台查询；平台按版本号比对结果决定是否下发。回调码含义：0=升级成功（必须重启生效）、1=连接服务器失败、2=URL 错误、3=服务器断开、4=接收报文错误（含"已是最新"）、5=版本号格式错误。同一设备连续升级 6 次后平台会临时封禁，需先排查再重试。
操作步骤：①确认回调里写了成功后重启：
libfota2.request(opts)
-- opts.fota_cb: function(received,total,result)
-- if result == 0 then rtos.reboot() end -- 成功后必须重启
rtos.bsp() 一致、升级范围（创建设备时勾选"升级全部设备"=项目全量；创建后用"指定设备"填 IMEI=仅命中该设备）、设备归属的项目是否正确；④验证阶段先"指定设备"填 1~2 台 IMEI 做灰度，确认回调为 0、设备自动重启、平台版本号刷新后，再放开范围。
60. 软件版本号里“1.0.0”三位数字有什么特殊含义吗？
解答： 结论：脚本版本号必须是 A.B.C 三段数字（如 1.0.0），平台按段比较决定是否下发升级，不是任意字符串；在合宙 IoT 平台（https://iot.openluat.com/ ）创建固件时版本号必须严格为 xxx.yyy.zzz 三段纯数字格式（每段数字，不要带 v、日期或中文），否则 libfota2 回调会返回 5（版本号格式错误）。
含义与比较规则：A=大版本（架构/不兼容变更）、B=次版本（功能新增，向后兼容）、C=修订号（问题修复）。两段版本号 A1.B1.C1（设备当前）与 A2.B2.C2（云端固件）比较：①A2=A1 时，必须 C2>C1 才升级（即同大版本内修订号递增即命中，B 不单独决定）；②A2>A1 时，C2>=C1 即可升级（跨大版本要求新固件修订号不低于旧版）。实践要点：每次发布固件三段中至少递增对应段（修复 bug 建议递增 C，如 1.0.0→1.0.1）；不要回退、不要重复使用同一版本号，否则平台判定"已是最新"（回调码 4）不下发。参考 Air8101 FOTA 教程：https://docs.openluat.com/air8101/luatos/app/base/fota/ 。
61. GNSS原始NMEA数据显示一直在移动，但解析出的经纬度一直不变，是哪里问题？
解答： 结论：GNSS 模组原始 NMEA 在变化而解析结果不变，基本可以确定是设备端解析/取字段的软件逻辑问题，模组本身已在正常输出定位数据。按以下顺序排查：
①确认 NMEA 语句有效：$GNGGA/$GNRMC 中定位状态须有效（RMC 的第 2 字段为 A=有效定位，V=无效；GGA 第 6 字段定位质量为 1/2/4/5，而非 0），且卫星数、HDOP 正常。若语句本身是 V 或质量 0，经纬度字段会保持原值或全 0。
②核对取的字段下标：NMEA 以逗号分隔，GGA 第 2/4 字段是纬度/经度（格式 ddmm.mmmm），第 3/5 字段是 N/S、E/W 方向；RMC 第 3/4、5/6 字段同理。字段错位（少逗号、语句类型判断错）会取到固定字段。
③确认度分转换：原始值是"度分"不是十进制度，须 度 + 分/60（如 2235.1234 = 22 + 35.1234/60），南纬/西纬取负；漏掉转换或方向处理会得到看似不变的数值。
④确认用的是同一帧/全局缓存：解析回调里若把结果写进了被覆盖的 buffer，或只在初始化时解析一次，打印出的经纬度就会恒定；应每帧解析后立即拷贝到独立变量。
⑤优先直接用官方 libgnss：LuatOS 的 libgnss 已完成多卫星系统语句解析，直接读 gnss_data["lat"]/["lng"]/["fixType"] 即可，避免手写解析。对照官方 GNSS demo（Gitee：https://gitee.com/openLuat/LuatOS/tree/master/module 下对应模组的 demo 目录）和 libgnss 文档 https://docs.openluat.com/osapi/core/libgnss/ 验证；先用官方 demo 跑通可快速区分是模组问题还是应用代码问题。
62. Air780EX-3.3V和Air780EX2T-3.3V选哪个？
解答： 结论：两者都是 LCC 邮票孔封装、IO 固定 3.3V、串口 AT 指令开发的 4G Cat.1 数传模组，定位相同；Air780EX2T 是 Air780EX2 系列的 AT 版本（选型手册注明 Air780EX2"兼容老型号 Air780EX"），属于更新一代选型，官方选型指南 AT 模组系列中在产推荐的是 Air780EX2T（8 路带 TLS 的 Socket、60KB 上下行串口速率、支持 128K Byte 及以下文件下载，参考价 16.9 元）。新设计直接选 Air780EX2T-3.3V，供货周期和固件维护更有保障；老产品维护、已有 EX 库存则继续用 Air780EX-3.3V 即可。
选型与设计要点：①两款都是 AT 固件（非 LuatOS 二次开发），AT 固件下载页 https://docs.openluat.com/atmozu/product/firmware/ ；②虽然 EX2 设计上兼容老型号 EX，两款又同为 3.3V 邮票孔，但画板前仍须分别对照各自硬件设计手册逐脚核对（电源、UART 主串口、PWRKEY/RESET、NETLIGHT、SIM、天线等），不要仅凭"3.3V、邮票孔"直接判定管脚完全一致；③注意供电能力与上电时序、射频天线预留；④最终功能矩阵与在产状态以官方选型指南为准：https://docs.openluat.com/SelectionGuide/SelectionGuide/ ，样品可在官方淘宝店对比验证：https://luat.taobao.com/ 。
63. 更新Luatools后生成量产文件有两个文件夹里的bin，哪个是升级用的？为什么低版本无法自动升级到004版本？
解答： 结论：两个文件夹分别对应不同 rtos.bsp() 型号（同系列存在子型号，Luatools 会按 BSP 名分目录输出），以设备实际 rtos.bsp() 返回值所在目录为准，不能凭文件夹名猜；远程 FOTA 用的是平台固件列表中的 .bin 升级包，本地量产/烧录用的是 .soc 整包，两者用途不同。低版本无法自动升到 004，通常就是固件名（firmware_name 默认 _G.PROJECT.."_LuatOS-SoC_"..rtos.bsp()）与上传目录的 BSP 名不一致，平台匹配不到对应型号的升级包，于是不下发。
操作步骤：①在设备脚本里打印 log.info("bsp", rtos.bsp())，按返回的完整型号选同名目录下的 bin；②登录 IoT 平台 https://iot.openluat.com/ ，在该项目下按该 BSP 型号新建/上传固件，固件名与 rtos.bsp() 严格一致（含大小写），版本号按 xxx.yyy.zzz 递增；③升级范围先"指定设备"填 IMEI 灰度验证，观察 libfota2 回调码：0=成功须 rtos.reboot()、4=已是最新/报文错误、5=版本号格式错误；④使用最新版 Luatools 重新生成量产文件与升级包，避免旧工具产物目录结构与新固件命名不匹配；⑤确认低版本固件中 FOTA 脚本与 project_key、PRODUCT_KEY 与该项目一致。FOTA 流程参考 https://docs.openluat.com/air8101/luatos/app/base/fota/ 。
64. LBS项目删不掉吗？
解答： 结论：LBS（基站/WiFi 定位）不是一个可以单独删除的"独立项目"，它是挂在 IoT 平台普通项目下的一项服务——免费单基站定位（lbsLoc2）直接用项目的 key 调用，付费多基站/WiFi 定位（airlbs）也是在"订单管理"中给项目开通。因此你在列表里看到的"LBS 项目"本质上还是 IoT 项目，项目删不掉通常是删除前置条件未满足，而不是 LBS 本身锁定。
排查与处理步骤：①登录 https://iot.openluat.com/ 进入该项目，先在"设备列表"中移除/删除项目下全部设备（项目下还有设备时不允许删除）；②检查固件列表，删除该项目下上传的固件/升级任务；③在上方"订单管理"中确认是否已开通 airlbs 付费套餐及订单状态，付费服务未到期或存在关联订单时按平台提示处理（到期不续或联系销售），收费规则见 https://docs.openluat.com/value/basestation/fee/ ；④完成清空后再回到项目管理执行删除；⑤若按钮置灰或提示异常，换 Chrome 重新登录再试，仍无法删除时带上账号、项目 ID 和页面截图，通过官方企业微信群或平台工单渠道反馈后台核查。接口说明可参考基站/WiFi 定位文档 https://docs.openluat.com/air780ex/luatos/app/common/lbswifi/ 。
65. air8000w的45引脚VDD_EXT电压域是3.3V吗？可以拿来做GPIO上拉吗？
解答： 结论：VDD_EXT 是模组内部 LDO 输出的 3.3V 电源域，电平上是 3.3V，常规工作模式下可作为小电流外设电源；但不建议拿它当 GPIO 的保持上拉电源——该电源受模组工作状态管理，在低功耗（休眠/PSM+）等场景下会关断或间歇输出，上拉电平会丢失，导致休眠期间 GPIO 电平漂移、误唤醒或漏电。需要"始终有效"的上拉，应接到板上不受模组休眠控制的稳定 3.3V（或主 GPIO 对应的 VDD_IO 域电源），并串联合适阻值（常用 10K~100K，按信号速率和功耗权衡）。
设计与核查步骤：①管脚功能、电压域、最大输出电流、休眠时状态属于硬件硬性指标，以官方《Air8000 硬件设计手册 V1.0.8》和《8000 管脚映射表.xlsx》中 45 脚的描述为准（手册索引页 https://docs.openluat.com/air8000/product/shouce/ ，内含规格书、硬件设计手册与管脚映射表下载）；②先确认 45 脚在你所用具体型号（Air8000/Air8000W 等）上是否就是 VDD_EXT、有无复用功能；③万用表/示波器实测该脚上电、联网、休眠各状态下的电压，确认其在你的低功耗策略下是否保持；④上拉、外部负载电流总和不得超过手册给该电源的限额，超限须外加 LDO。若手册中该脚电气参数与应用需求冲突，可在官方企业微信群附原理图请硬件同事评审。
66. AI问答经常提示网络错误是什么原因？
解答： 结论：AI 问答偶发"网络错误"多为本地浏览器缓存、网络链路到服务端不稳定或长连接超时所致，可按从易到难的顺序自助排查：①不要立即连续重试或退出页面，等待 10~30 秒后重发一次，服务端短时抖动通常会自行恢复；②清除浏览器缓存与 Cookie，或直接用无痕/隐私窗口打开；③换用最新版 Chrome/Edge，关闭代理、VPN、广告拦截类插件，必要时切换网络（手机热点对比）验证是否为本地链路问题；④若在公司内网，确认网络未拦截 AI 服务域名/长连接。若以上处理后仍稳定复现，请保留包含问题发生时间、账号、完整报错截图（含浏览器地址栏）以及提问内容，通过官方企业微信群或页面反馈入口提交，便于后台按时间点排查日志。
67. 1601 10.1寸屏供电电压正常（电池7.5V）但屏幕不亮，可能是什么原因？
解答： 结论：电池端 7.5V 正常只代表电池有电，屏幕点不亮通常出在"屏版本与固件/屏参不匹配、背光使能、FPC 连接、下载拨码/供电链路"四个环节，按以下顺序定位（10.1 寸 1024*600 RGB 屏对应官方 Air1602_V001 配置，屏幕型号与版本对应关系见 https://docs.openluat.com/air1601/product/air1602_engine/hardware/ ）：
①版本/屏参是否选对：10.1 寸必须使用 V001 对应的固件与屏幕参数（V000/V004 是 7 寸 1024600，V002/V003 是 5 寸 7201280），刷错版本分辨率/初始化序列不匹配，屏会无显示；先烧录官方该版本出厂固件与 demo（https://docs.openluat.com/air1601/product/air1602_engine/firmware/ ）验证，排除自研代码问题。 ②背光与显示分开判断：RGB 屏"背光不亮"和"有背光无图像"是两类故障——用手电贴近屏面斜照，若能看到隐约画面，说明主控已输出图像、问题在背光供电/背光使能脚；若完全无图像，查 LCD 初始化时序与屏参。自研板需确认背光使能 GPIO 已在脚本中用 pins.setup 正确拉高（注意复用冲突）。 ③连接与硬件：重新插拔 FPC 排线并确认无反插、锁扣压紧、排线无折伤；核对屏所需供电轨（IOVCC/AVDD 等）与复位、上电时序，不能只量电池电压。 ④下载与供电链路：按官方烧录说明使用 CH343 口、6000000 波特率、拨码切到 160X 侧（https://docs.openluat.com/air1601/product/air1602_engine/download/ ）；电池 7.5V 需经板载稳压，确认稳压输出、充电 IC（V003/V004 起带充电 IC）与供电拨码正常，大压降会导致背光/屏初始化失败。 ⑤替换验证：用同型号官方引擎主机或已知好屏交叉测试，区分是屏体损坏还是主板问题。若官方固件+官方硬件仍不亮，带版本号、接线照片和日志进官方企业微信群排查。
68. 有没有8202G定位器打样板的开源源码？
解答： 结论：Air8202G 是"免开发定位器"整机方案，官方提供完整资料与可直接烧录的出厂固件/工程，资料导航页为 https://docs.openluat.com/air8202/product/ （规格书、硬件、固件版本与源码入口均汇总于此）；LuatOS 脚本类源码统一在 Gitee 官方仓库 https://gitee.com/openLuat/LuatOS/tree/master/module 下按产品目录查找。使用方式：①先打开产品页确认当前固件版本与"默认出厂固件和源码"栏目，按页面给出的仓库路径克隆对应工程；②在 Gitee 仓库 module 目录中找 Air8202/Air8201G 对应 demo（定位、低功耗、上报等），结合出厂固件源码二次修改；③用 Luatools 烧录验证。若产品页未直接列出你所需的打样板具体工程，可在官方企业微信群报板卡丝印/版本号索取对应版本源码。
69. Air780EPM的AT固件哪里可以下载？
解答： 结论：Air780EPM 是 LuatOS 二次开发型号，不提供对外 AT 固件，不能通过刷固件把 EPM 变成 AT 模组使用；需要串口 AT 透传请直接采购 AT 定位型号——同系列对应 Air780EPT（或免开发的 Air878x 工业模组成品板），不要尝试把 EPT 的 AT 固件混烧到 EPM。AT 固件统一在 AT 模组固件下载页获取：https://docs.openluat.com/atmozu/product/firmware/ （按实际采购的完整丝印型号选择固件）。选型以官方选型指南为准：https://docs.openluat.com/SelectionGuide/SelectionGuide/ ，样品可在 https://luat.taobao.com/ 对比购买；若已批量采购 EPM 又必须用 AT，可在官方企业微信群反馈，由销售/技术协助换货或评估改用 LuatOS 脚本实现透传。
70. 设备找不到了，如何放到指定账号的项目下？
解答： 结论：设备在 IoT 平台"找不到"，绝大多数是设备已归属在其他账号/项目下（一台设备同一时间只能归属一个项目），按设备来源走归属/转移流程即可，操作说明见 https://docs.openluat.com/air780epm/product/attributioniot/ 。
处理步骤：①在 IoT 平台 https://iot.openluat.com/ 用 IMEI（Air8101 等 WiFi 类设备用 STA MAC）搜索设备，确认是否已在其他项目；②设备从合宙官方电商采购（约 2025 年 10 月后订单），可登录客户管理平台 https://crm.luatos.com/ （初始密码 88888888）查询/变更归属；③线下合同订单联系对应销售办理归属；④设备来自第三方（经销商/别人账号），须由当前归属账号先在项目设备列表中移除设备，再在目标账号的项目里添加该 IMEI；⑤添加后确认设备脚本中的 project_key（PRODUCT_KEY）与目标项目一致，设备重新上线即在新项目下。若按上述流程仍无法添加（提示被占用但找不到归属方），带采购凭证和 IMEI 清单通过官方企业微信群申请后台核查。
71. 使用微信登录过合宙云平台，现在忘记密码且手机号已注册无法新注册，怎么办？
解答： 结论：微信登录本质上也绑定了一个平台账号（通常就是你当时用的手机号），不需要重新注册；"手机号已注册"恰恰说明该手机号对应的账号已存在，直接找回该账号密码即可。
操作步骤：①在 IoT 平台登录页 https://iot.openluat.com/ 选择"忘记密码/找回密码"，输入该手机号，通过短信验证码重置密码，然后用"手机号+新密码"登录；②若希望继续用微信，先用手机号登录后在账号设置里绑定/确认微信，之后两种方式都能进入同一账号；③若收不到短信验证码，检查手机号输入、短信拦截，并换 Chrome/无痕窗口重试；④若提示手机号不属于该账号（微信当初绑的是别的手机号或邮箱），直接用微信扫码登录，进入"账号设置"查看当前绑定的手机号，再对该手机号做找回，或在设置中换绑成你现在的手机号；⑤以上均无法解决时，通过官方企业微信群提供微信昵称、手机号和报错截图，由平台后台协助核对账号。
72. 主板带的4G模块是全网通的吗？支持电信卡吗？
解答： 结论：合宙 Air780 系列（如 Air780E/EPM/EX 等）国内版 4G Cat.1 模组为全网通，支持中国移动/联通/电信 4G 卡，频段为 LTE-FDD B1/B3/B5/B8、LTE-TDD B34/B38/B39/B40/B41（具体子型号以其规格书为准，不同海外后缀型号频段不同）。
使用电信卡的注意事项：①Cat.1 模组工作在 4G LTE 数据域，电信卡需开通 4G 数据（物联网卡建议直接办理电信 IoT 卡并确认 APN）；②语音通话依赖 VoLTE，需要电信网络覆盖、卡已开通 VoLTE 且模组固件支持，不需要也不能回落到 2G/3G（电信 2G/3G 已退网），纯数传业务则无需关注语音；③插卡后用 AT+CPIN? 确认认卡、AT+CESQ/AT+CSQ 看信号、AT+CEREG? 看注网状态，无法注网时优先换卡/换位置对比并核对 APN；④确认你板上具体型号及频段可查该型号产品页规格书或选型指南 https://docs.openluat.com/SelectionGuide/SelectionGuide/ 。
73. 发送485正常可以开锁，但收不到485返回数据是什么原因？
解答： 结论：RS485 是半双工差分总线，能发不能收，最常见原因就是方向控制脚（DE/RE，常由同一 GPIO 控制）时序不对——发送后没有及时切回接收态，或方向电平极性写反，对端返回的数据被本地发送器占用总线而收不到。
原理与代码要点：485 收发芯片中 DE=1 使能发送、RE#=0 使能接收（多数电路把 DE 与 RE# 接同一个方向脚，拉高=发、拉低=收）。正确时序为：①空闲常态保持接收态（方向脚拉低）；②发送前拉高方向脚；③调用 uart.write 发送后，必须等待最后一个字节真正移出 UART 移位寄存器再拉低方向脚——只等发送缓冲区为空是不够的，切早了会截断末尾字节，切晚了则对端的回复被自己发态挡住。LuatOS 推荐用 UART 的发送完成事件/等待机制处理，例如：
-- 方向脚按实际硬件修改
pins.setup(485_DIR, nil, 0) -- 默认接收态
local function rs485_send(data)
pins.setPull(485_DIR, nil, 1) -- 进入发送态
uart.write(uartid, data)
sys.waitUntil(uartid .. "_TX_DONE", 100) -- 等发送完成事件，保证末位移出
pins.setPull(485_DIR, nil, 0) -- 立即回接收态
end
74. 为什么Luatools生成差分包时一直显示开始但不动？
解答： 结论：Luatools 生成差分包长时间停在"开始合成"不动，多为工具版本缺陷、工程路径含中文/空格/特殊字符、源固件与目标固件选错（非同 BSP 或非可差分版本）导致，按以下步骤处理：
①升级最新版 Luatools（官网 https://docs.openluat.com/common/Luatools/ 下载），旧版本差分合成异常在新版中已有修复，不要长期混用新旧版本；②把新旧固件、输出目录全部放到纯英文短路径（如 D:\fota\），关闭占用该目录的杀毒扫描后重试；③核对差分两端：必须是同一 rtos.bsp() 型号、固件类型一致（.soc 与脚本包按 Luatools 要求选择），且源版本确实早于目标版本、版本号为 xxx.yyy.zzz；④合成时确认磁盘剩余空间充足、固件文件未损坏（必要时重新下载官方固件）；⑤换一台干净电脑仅装最新版 Luatools 合成，排除环境干扰。设备端注意：差分升级回调返回 0 只代表写入完成，必须等待设备自动重启进入新固件后版本才会更新，重启期间不要断电；若平台已显示成功但版本仍旧，见下一条排查。若最新版仍无法合成，记录 Luatools 版本号、两个固件文件名并截图日志，通过官方企业微信群反馈。
75. 合宙平台显示差分包升级成功，为什么自己平台上报的还是旧程序版本？
解答： 结论：平台显示"升级成功"表示差分包已下载并写入完成，此时设备还运行在旧内存映像中，必须等 libfota2 回调 result==0 后执行 rtos.reboot() 重启进入新固件，期间你自己平台若立刻查询就会拿到旧版本号；若重启后仍上报旧版本，再查版本号上报逻辑与差分合成目标版本。
排查步骤：①确认代码中升级成功后立即重启，且不要在重启前又发起一次升级请求：
-- fota 回调
if result == 0 then
rtos.reboot() -- 必须重启，新固件才生效
end
VERSION/_G.VERSION），而不是写死的常量或旧的 fskv 缓存值；④在 IoT 平台核对设备详情里的实际版本与本次差分的"目标版本"是否一致——若差分包合成时目标版本号填错（仍填成旧版号），刷进去后上报自然还是旧号，需用正确目标版本重新合成差分包（源版本→目标版本、同一 rtos.bsp()）；⑤串口日志确认重启后固件版本字符串、libfota2 查询返回 4（已是最新）而不是再次下发。参考 FOTA 教程 https://docs.openluat.com/air8101/luatos/app/base/fota/ 。
76. 如何转移云端IoT设备的归属到指定账号项目？
解答： 结论：IoT 设备按 IMEI 唯一归属，同一时间只能属于一个账号下的一个项目，转移本质是"原账号移除 + 目标账号添加"，官方完整流程见 https://docs.openluat.com/air780epm/product/attributioniot/ 。按采购来源操作：
①合宙官方电商购买（约 2025 年 10 月后订单）：登录客户管理平台 https://crm.luatos.com/ （初始密码 88888888）按订单将设备归属到目标账号/项目；②线下/合同渠道购买：联系对应销售，提供目标账号与 IMEI 清单办理；③第三方或设备在其他用户账号下：由当前归属账号登录 https://iot.openluat.com/ ，在原项目"设备列表"中删除/移除该 IMEI（Air8101 等 WiFi 设备用 STA MAC），再由目标账号在自己项目的设备列表中添加；④转移后必须把设备脚本中的 project_key（PRODUCT_KEY）改成目标项目的 key，设备重新上线才会连到新项目；⑤操作顺序建议先在目标项目完成固件/升级配置再切 key，避免设备短暂离线。若提示设备被占用且无法定位归属账号，携带采购凭证、IMEI 清单通过官方企业微信群申请后台核查处理。