常见问题 - 2026-09-03
数据日期：2026-09-03
1. AT+POWERMODE="PRO"低功耗为什么降不下去，一直4毫安左右？
解答： 结论：4mA 不一定代表 PRO 命令无效。PRO 是低功耗长连接模式，不是完全关机，典型平均电流约 1.5~2mA（AT 手册标称约 1mA），但实测值受网络环境和板载电路影响，4mA 在实网信号偏差或有外设漏电时较常见。
原理：PRO 模式下模组仍保持 4G 注册、PDP/长连接、协议栈寻呼、小区测量与重选、保活心跳等网络交互，只是 CPU 降频；若现场 RSRP/RSRQ 偏差、DRX 周期短或心跳频繁，平均电流会明显抬高。
排查步骤（逐项排除）：
1. 先确认命令已掉电保存并生效：执行 AT+POWERMODE?（或重新发送 AT+POWERMODE="PRO"，返回 OK），重启后复查；
2. 断开 USB/VBUS 供电改用电池或精密电源经 VBAT 供电测量，VBUS 插入会阻止进入低功耗；同时确认 DTR 电平符合休眠要求；
3. 去除板上漏电项：网络指示灯、VREF（进入低功耗前建议 AT+VREF=0，VREF/GPIO23 会显著影响 PSM+ 功耗）、ESD 管、传感器、电平转换芯片等；
4. 用 AT+CSQ、AT+CESQ 确认信号质量，在信号良好的位置复测，并换运营商卡对比；
5. 降低应用层心跳频率、确认无周期性串口数据唤醒；PRO 下建议串口波特率设为 9600，避免休眠后第一包 AT 数据丢失；
6. 若业务允许网络离线，再评估 PSM+ 模式（典型 3~12uA，唤醒后需先 AT+POWERMODE="CLOSE" 联网再重新进入）。
参考官方文档：低功耗说明 https://docs.openluat.com/atmozu/product/command/lowpower/ ，通用功耗说明 https://docs.openluat.com/common/airpower/ ，AT 命令手册 https://docs.openluat.com/atmozu/product/shouce/
2. 进入飞行模式后Air780EGG还能通过mobile.getCellInfo()、mobile.enbid()、mobile.eci()接收更新新的服务小区变化吗？
解答： 结论：不能。进入飞行模式后射频收发和协议栈小区测量、重选流程均停止，mobile.getCellInfo()、mobile.enbid()、mobile.eci() 不会再返回新的服务小区变化，读到的是进入飞行模式前的缓存值。
原理：mobile.flymode(0, true) 开启飞行模式后，模组关闭射频收发机并停止驻网，协议栈不再进行小区测量与重选，因此服务小区信息（eNB ID、ECI、EARFCN/PCI 等）不会更新；系统消息 CELL_INFO_UPDATE/SCELL_INFO 也不会再因服务小区变化而上报。
操作建议：
1. 需要持续跟踪服务小区时，保持正常驻网状态，调用 mobile.reqCellInfo(timeout) 主动刷新，再读 mobile.getCellInfo()，或订阅 CELL_INFO_UPDATE/SCELL_INFO 系统消息被动接收变化；
2. 若之前因修改 mobile.config(mobile.CONF_XXX, ...) 等高级配置进入了飞行模式，配置完成后必须执行 mobile.flymode(0, false) 退出飞行模式，等待 mobile.status() 返回 mobile.REGISTERED（或漫游已注册）后再读取小区信息；
3. 退出飞行模式后重新驻网需要数秒到数十秒（取决于搜网与注册速度），建议在注册成功消息或状态轮询确认后再取值。
参考官方文档：mobile 核心库 https://docs.openluat.com/osapi/core/mobile/ ，demo：https://gitee.com/openLuat/LuatOS/tree/master/module/Air780EPM/demo/mobile
3. Air780EGG的4G天线端口确认无任何上行发射的情况下，mobile.getCellInfo()能否持续获得新的服务小区变化？
解答： 结论：在正常驻网状态下，物理层不存在"完全没有上行发射"的状态，因此该前提不成立；只要模组已注册 4G 网络，即使应用层不发送任何业务数据，协议栈仍会产生必要的上行交互，同时 mobile.getCellInfo() 可以持续反映服务小区的变化。
原理（应用层无数据 ≠ 空口无上行）：
1. 附着/注册后，协议栈要周期性完成 TAU（跟踪区更新）、鉴权、连接保持、测量报告上报、PUCCH/PUSCH 上的 ACK 与调度请求等控制面信令，这些都属于上行发射；
2. 小区重选（idle 态）主要由模组对邻区的下行测量结果触发，但驻留过程仍伴随上述上行信令；
3. 只有进入飞行模式（mobile.flymode(0, true)）或 PSM/PSM+ 深睡区间，射频才真正停止发射，此时小区信息也随之停止更新（参见第 2 条）。
验证与操作建议：
1. 用 mobile.dataTraffic() 统计上下行流量，区分"应用层无业务"与"协议栈无流量"；
2. 用 mobile.reqCellInfo(timeout) 刷新后读取 mobile.getCellInfo()，或订阅 CELL_INFO_UPDATE/SCELL_INFO 消息观察服务小区变化；
3. 如需在实验室确认空口上行，应使用综测仪/频谱仪在屏蔽环境观测，并配合 mobile.setBand() 锁定频段；仅靠普通天线端口无法判定"无上行"；
4. 若业务目标是降低上行发射以省电，应优化心跳/TAU 周期或使用 PRO/PSM+ 低功耗模式，而不是依赖"零上行"假设。
参考官方文档：mobile 核心库 https://docs.openluat.com/osapi/core/mobile/ ，功耗说明 https://docs.openluat.com/common/airpower/
4. AI是每次问了都要刷新一次，是因为上下文太大了吗？
解答： 结论：普通 AI 问答页面在上下文较长或页面状态异常时，可能出现回答显示不全、需要刷新才能继续的情况；如果需要持续保留多轮技术对话的上下文，推荐使用 CRM 中的 AI 助手，它会记录历史对话，不必每次刷新重开。
使用建议：
1. 访问合宙 CRM：https://crm.luatos.com/ ，登录后在其中打开 AI 助手进行提问，历史会话会被保留，可围绕同一问题连续追问；
2. 单次会话不要无限堆叠上下文：一个话题收敛后点击"新建会话"，把关键结论（型号、固件版本、已尝试的操作、报错原文）带入新会话，比不断刷新更稳定；
3. 若页面只显示一半内容，可使用页面上的"全屏"按钮展开查看（见第 32 条），或换用 Chrome/Edge 最新版、清除缓存后重试；
4. 提问时一次性提供完整信息：产品型号（如 Air780EGG）、固件版本号（AT 版本可用 AT*I 或 AT+VERSION 查询）、LuatOS 脚本库版本、复现步骤与日志，可显著减少往返次数。
5. 这个箭头是板载天线还是只是天线接口呢？
解答： 结论：从合宙 Cat.1 模组/开发板的常见设计看，丝印箭头所指的小型贴片金属座通常是 IPEX/U.FL（一代）或 MHF 系列射频同轴座，它只是天线接口，本身不等于天线，必须扣合对应频段的外置天线（或用 IPEX 转 SMA 馈线接棒状/吸盘天线）才能正常收发。
判断与操作建议：
1. 看实物：板载 PCB 天线一般是板边缘一段蛇形/倒 F 形铜箔走线，旁边常印 ANT、4G、GSM、BT、WIFI 等字样且靠近净空区；小型矩形金属扣座（约 2.0×2.0mm）则是 IPEX/U.FL 外接座；
2. 以官方硬件资料为准：打开对应产品文档站（https://docs.openluat.com/ ）中该型号"硬件设计/硬件手册"章节，对照位号图和丝印说明确认该位置的定义，不同型号（Air780E/EG/EGG/EHV、Air8000、Air8202 等）天线数量和用途不同（4G 主集、GNSS、WiFi/BT 等）；
3. 未接天线时不要长时间大功率发射，避免失配导致射频指标恶化；装机时天线要远离金属屏蔽罩并预留净空，4G 天线需支持对应工作频段；
4. 如无法从丝印判断，请在合宙官方企业微信群（文档站底部二维码）发送板子正反面照片和完整型号，请技术支持确认。
6. Air8780V1最大电流是多大？
解答： 结论：官方在 Air8780 产品页只规定了输入电压范围（板载 DCDC，VIN 为 5V~12V），没有公布 Air8780V1（板载 Air780EHV 模组）整板的固定"最大电流"指标。整板电流取决于 4G 发射工况、外设负载和 DCDC 效率，不能用一个固定值概括，供电设计应按模组峰值电流并留足余量。
原理与取值依据： 1. Cat.1 模组耗电呈脉冲特性：待机平均电流很小，但在附着、TAU、TCP/TLS 建链、上行发送瞬间功率等级最高，Air780EHV 模组 VBAT 侧典型工作电压 3.3~4.35V（典型 3.8V），发射峰值电流约 1A 量级，具体以 Air780EHV 产品手册的电气参数表为准； 2. Air8780V1 板载 DCDC 把 VIN（5~12V）降到模组 VBAT，输入侧峰值电流随输入电压升高而降低，且需除以 DCDC 效率；以 5V 输入估算时输入电流需求最大； 3. 板载 LDO 还提供 3.3V/300mA 对外输出（杰华特 JW7809），若给外设供电需叠加这部分电流。
设计与实测建议： 1. 电源适配器/端子供电能力按"模组 VBAT 峰值约 1A 折算到 VIN 侧 + 外设电流 + 至少 30%~50% 余量"选取，5V 输入时建议电源持续输出能力不低于 1A、瞬态响应能承受脉冲拉载不跌落； 2. 用直流电源串联电流表或功率计（如支持瞬态的 INA226/电源分析仪）实测：在弱信号位置反复做注册+大数据上行，记录 VIN 端峰值电流和最低电压，确认 DCDC 输入端不欠压复位； 3. 关注电源线径和端子接触电阻，长走线需加大线宽，避免发射瞬间电压跌落导致模组重启； 4. 最终参数以下面官方页面和 Air780EHV 模组手册为准，批量设计前建议向合宙商务/技术支持确认 DCDC 芯片限流规格： - Air8780 系列工业模组：https://docs.openluat.com/air8780/luatos/hardware/module/ - 合宙文档站（查 Air780EHV 产品手册）：https://docs.openluat.com/
7. 可以加接WIFI不？
解答： 结论：单纯的 Cat.1 4G 模组（如 Air780E 系列）本身不提供 Wi-Fi 能力，不能通过简单"接线"给它增加 Wi-Fi；合宙有多种带 Wi-Fi 的产品和 Wi-Fi 扩展方案，应按主控架构选型，而不是在 4G 模组上外加 Wi-Fi。
根据合宙官方选型指南（https://docs.openluat.com/SelectionGuide/SelectionGuide/ ，"2.2 需要 Wi-Fi 功能"/"2.5 需要 4G+Wi-Fi+蓝牙+定位四合一"章节），可选方案： 1. Air8000 系列 SoC 引擎（Air8000A/W 等）：4G + Wi-Fi + 蓝牙一体化方案，适合要在一套 LuatOS 体系内同时使用 4G 与 Wi-Fi 的项目；注意 Air8000 当前配网只支持蓝牙配网和 SoftAP 配网，不支持 airkiss/smartconfig（见 https://docs.openluat.com/air8000/luatos/app/wifi/ ）； 2. Air8101/Air8101A：多媒体 Wi-Fi SoC，集成 2.4G Wi-Fi 6 和 BLE 5.4，适合以 Wi-Fi 为主、需要显示屏/摄像头的应用（不带 4G）； 3. Air6205/Air6205A：Wi-Fi 6 + 双模蓝牙 5.4 从机模组，仅可搭配合宙 Air1601/Air7xx 系列主控，通过 AirLink over SPI/UART 连接，适合在合宙主控体系上扩展 Wi-Fi； 4. 若现网设备是普通 Cat.1 模组、主控是第三方 MCU，建议直接评估更换为 Air8000 系列，或由 MCU 外接通用 Wi-Fi 模组自行开发驱动（不属于 Air780 系列固件支持范围）。
选型建议：告知应用场景（是否保留 4G、是否要蓝牙/定位、主控型号、成本目标），对照选型指南确认；也可在合宙官方企业微信群（https://docs.openluat.com/ 网站底部二维码扫码加入）报需求获取推荐。
8. Air780EGH做成产品后，后续模组固件如果需要升级，都有哪些途径？
解答： 结论：Air780EGH（LuatOS 方案）做成产品后，固件升级主要有三类途径：①远程 FOTA 差分升级（量产设备主要方式，可用合宙 iot 平台或自建 HTTP 服务器）；②生产/维护阶段通过 USB 串口用 Luatools 本地整包下载；③批量产线使用合宙量产烧录工具。产品设计阶段就应把远程 FOTA 通道规划好（SIM 流量、服务器、版本管理）。
原理与各途径说明：
1. 远程 FOTA：LuatOS 固件由底层 core 与上层脚本/资源组成，官方提供 libfota/libfota2 扩展库和 fota 核心库。libfota2 走合宙升级平台（iot.openluat.com，按项目/IMEI 灰度与版本管理），也支持自定义 HTTP 升级服务器；远程升级使用差分包（dfota 包），只传输差异部分以节省流量，要求基线版本、目标版本、型号严格匹配，升级过程中不能断电；文档：https://docs.openluat.com/osapi/ext/libfota2/ 、https://docs.openluat.com/osapi/core/fota/ ；
2. USB/串口本地升级：研发和售后返修场景用 Luatools（教程 https://docs.openluat.com/common/Luatools/ ），整机需预留 USB 或下载串口与 BOOT 触发方式；
3. 产线批量烧录：合宙量产烧录工具（在线版/脱机版，仅支持 Windows 10 及以上），支持 Air780E 全系列（含 EGH），可清 KV/清 FS、自动循环烧录：https://docs.openluat.com/common/Luat_productiontool/ 。
实施要点：
1. 在 iot.openluat.com 创建项目并绑定/归属设备 IMEI，固件版本按规范命名后上传，再配置升级范围；
2. 应用层实现升级流程：检测新版本→下载差分包→校验→重启进入升级→上报结果，并处理弱网重试与失败回滚保护；
3. 提前确认设备供电能支撑升级全程（建议外部稳压电源或电量充足），Flash 中用户文件/KV 的保留策略以所用 fota 库文档说明为准，重要参数升级前自行备份；
4. AT 固件设备则用 AT+UPGRADE 走平台 FOTA（错误码与流程见 AT 手册 https://docs.openluat.com/atmozu/product/shouce/ ）。
9. AT模式下，在MQTT长连接保持的情况下，再通过AT+MIPSTART方式建立一个HTTP短连接，是否一定会因为资源冲突而导致错误？返回+CME ERROR:3是什么问题？
解答： 结论：这里存在概念误解——AT+MIPSTART 不是 HTTP 命令，而是 MQTT 客户端的 TCP 建链命令（SSL 场景对应 AT+SSLMIPSTART）。在一条 MQTT 连接已经建立的状态下再次发送 AT+MIPSTART，属于"当前状态不允许该操作"，返回 +CME ERROR: 3（operation not allowed，操作不允许）是符合预期的，不是资源冲突类故障。HTTP 短连接应使用 HTTP 指令组（AT+HTTPINIT/AT+HTTPPARA/AT+HTTPDATA/AT+HTTPACTION，HTTPS 先配置 AT+HTTPSSL/AT+SSLCFG），与 MQTT 通道互不相同。
原理（AT MQTT 标准时序）：
1. 标准流程为 AT+MCONFIG=clientid,user,password → AT+MIPSTART="服务器","端口"（返回 OK 仅表示开始处理，必须等到 CONNECT OK，且要紧接着发下一条）→ AT+MCONNECT=1,60（等到 CONNACK OK）→ AT+MSUB/AT+MPUB 收发 → AT+MDISCONNECT→AT+MIPCLOSE 关闭；
2. AT 固件中 MQTT 客户端实例在已连接/正在连接状态下不允许再次 MIPSTART，必须先 AT+MDISCONNECT、AT+MIPCLOSE 释放后才能重新建链；
3. +CME ERROR: 3 在 HTTP/SSL 命令中同样表示当前状态/顺序不允许（例如未 HTTPINIT 就发 ACTION、SSL 上下文未配置好），历史案例多为命令顺序问题，需按手册要求的顺序执行。
排查与操作步骤：
1. 确认需求：要 HTTP 短连接就改用 HTTP 指令组，与 MQTT 长连接并行使用，不要用 MIPSTART；MQTT 长连接期间可以正常做 HTTP 请求，但两者各自走自己的 bearer/套接字，注意总并发能力和内存；
2. 若本意是重连 MQTT：先 AT+MDISCONNECT、AT+MIPCLOSE，再从 MCONFIG→MIPSTART→MCONNECT 完整走一遍；
3. 发送 MIPSTART 后若只收到 OK 而没有 CONNECT OK，不要继续发后续命令，等待结果 URC（可用 AT+MIPCALL?、AT+CSQ、AT+CEREG? 确认 PDP 与注册状态）；
4. HTTPS 场景按"先配置 SSL（AT+SSLCFG）→AT+HTTPSSL=1→AT+HTTPINIT"的顺序操作，避免触发 +CME ERROR: 3。
参考官方文档：MQTT AT 指令 https://docs.openluat.com/atmozu/product/command/mqtt/ ，AT 命令手册 https://docs.openluat.com/atmozu/product/shouce/
10. Air780EX2T通过USB或者FOTA更新固件时，之前设置的IMEI和CA证书会被擦掉吗？
解答： 结论：正常的远程 FOTA 差分升级不会修改独立的 FSKV 参数分区，也不会删除用户文件系统里自建的文件，业务参数与写入文件系统的 CA 证书通常会保留；IMEI 属于设备出厂/校准类数据，存放于受保护的独立分区，常规固件升级不应擦除。但通过 USB/Luatools 做整包下载时，如果手动勾选了擦除选项（擦除参数/恢复出厂/格式化文件系统等），则可能清除相关数据，因此升级前必须按下面步骤备份核对，不要把"通常保留"当作无条件承诺。
原理（分区视角）： 1. LuatOS Flash 划分为 ap/cp 固件分区、FOTA 专用分区、脚本分区、FSKV 参数分区、用户文件系统等；官方 FOTA 课程明确：远程升级主要操作 FOTA 分区、ap/cp 分区和用户脚本分区，"默认不会清除 FSKV 数据"，"用户文件系统中自行创建的文件会保留"（见 https://docs.openluat.com/luatos_lesson/009_luatos_fota/ 8.5.1/8.5.2 节）； 2. IMEI 等设备标识在协议栈受保护区域，FOTA 差分包只包含固件差异，不覆盖该区域；但跨大版本、更换不同型号固件或使用恢复出厂类操作时行为可能不同，Air780EX2T 的具体擦除边界应以该型号固件发布说明和 Luatools 实际勾选界面为准。
升级前操作清单：
1. 记录升级前信息：AT 固件执行 AT*I、AT+GSN（或读取 IMEI 的命令）、固件版本号；LuatOS 用 mobile.imei() 记录；
2. 备份 CA 证书：把 AT+FSLIST 列出的证书文件（如 ca.crt）通过 AT+FSREAD 导出到 PC；LuatOS 用 io/fs 接口读出备份；同时记录 AT+SSLCFG 各项上下文配置；
3. FOTA 优先：量产设备尽量走平台差分包升级，确保升级项目中的固件型号与设备一致（不能把其他型号包发给 EX2T）；
4. USB 整包升级前仔细核对 Luatools 下载界面，只选必要项，不明确定义的"擦除/恢复出厂"勾选项保持不选；升级完成后重新查询 IMEI、重新下发证书并做一次 TLS 连接验证；
5. 若升级后 IMEI 异常或证书丢失，凭 IMEI、购买记录联系合宙官方技术支持处理，不要自行多次写入 IMEI。
参考：FOTA 分区与数据保留说明 https://docs.openluat.com/luatos_lesson/009_luatos_fota/ ，Air780Exx 下载接口说明 https://docs.openluat.com/air780epm/luatos/hardware/download/ ，AT 手册 https://docs.openluat.com/atmozu/product/shouce/
11. 我在淘宝上买的模组可以FOTA吗？怎么绑定到我的账号下？
解答： 结论：可以 FOTA，但要先把设备归属（绑定）到你自己的合宙账号下，再在 iot.openluat.com 的项目中配置升级固件；能否自助转移取决于购买渠道是否为合宙官方电商。合宙官方电商渠道只有三个：Luat.taobao.com（合宙淘宝企业店）、"降功耗找合宙"微信公众号菜单的微信商城、该公众号链接的视频号微信小店。
操作步骤（官方电商购买，适用于 2025 年 10 月及以后的电商订单）：
1. 登录 https://crm.luatos.com/ ，账号为下单手机号，初始密码 88888888（登录不上可直接注册）；CRM 与 iot 平台是同一个合宙账号；
2. 进入"客户服务 → 首次设置设备归属（限官方店铺）"，输入淘宝订单编号和物流（快递）单号，系统列出该订单中的设备；
3. 勾选设备后点"设置设备归属"单个转移，或点顶部"批量设置 IMEI 归属"选择 iot 项目批量提交；项目可在 iot 平台"我的项目"中查看；
4. 归属完成后登录 iot.openluat.com，在对应项目中即可看到设备并上传固件、配置 FOTA 升级任务（LuatOS 用 libfota2，AT 用 AT+UPGRADE）。
其他渠道的处理： 1. 若不是从上述官方渠道购买（经销商、第三方店铺、二手等），设备所有权属于对应渠道商，合宙客服无权限直接转移，需联系该渠道销售/客服，把官方归属说明文档发给对方协助转移； 2. 合宙官方线下批量订单：设备发货时一般已按客户要求归属到指定账号，不确定时先问公司采购，或登录 iot 平台在"我的设备→合宙标准模块"中查找，再用"操作→批量转移"转到目标账号/项目； 3. 设备一旦设置到你名下，合宙也无法再替他人转移，请用本人账号操作。
参考文档：合宙的设备如何归属到自己账号名下 https://docs.openluat.com/air780epm/product/attributioniot/
12. AT+UPGRADE返回+UPGRADEIND: -1003是什么错误？
解答： 结论：根据官方 AT 命令手册（V1.0.10，3.6 节 AT+UPGRADE 参数定义），+UPGRADEIND/查询结果中的错误码 -1003 = 无效固件（UPGRADE_INVALID_FILE），即模组下载到的升级包对当前设备而言不是合法可用的固件，常见原因是型号不匹配、基线版本不匹配、上传的不是差分 bin、文件损坏或平台配置错误。
错误码体系（手册原文）：-1000 无效 URL、-1001 网络错误、-1002 服务器链接错误、-1003 无效固件、-1004 http 应答错误、-1005 存储固件错误、-1006 其他错误；平台侧 fotaerrorcause：3 无效设备、17 无权限、25 无效项目、26 无效固件、27 已是最新版本（或未打开升级开关、未指定 IMEI）。
排查步骤（逐项核对）：
1. 核对项目与型号：第三代 AT 型号（780EHT/EGT/EPT/EVT、700ECT、780EG2 等）FOTA 项目名必须为"Air7XXF 标准模块"，不能把别的型号固件传错项目；确认设备 IMEI 已归属到该项目；
2. 核对升级包类型：AT 固件远程升级使用的是固件包解压后的差分升级文件（平台升级上传 dfota 类 bin；自建 HTTP 服务器必须用合宙差分工具基于"设备当前版本→目标版本"生成差分包，不能直接传整包）；
3. 核对基线版本：差分包与设备当前运行的版本号严格对应，跨版本升级要逐级或重新生成对应差分包；
4. 核对文件完整性：重新从官方固件页（https://docs.openluat.com/atmozu/product/firmware/ ）下载、解压、上传，避免传输损坏，文件名不要自行改成与内容不符；
5. 平台检查：固件列表中"允许升级"选"是"并提交；非全项目升级时要把 IMEI 加入升级名单，否则可能返回 cause 27；
6. 用 AT+UPGRADE? 查询完整结果（state/errorcode/httprespone/fotaerrorcause），并在 iot 平台"升级日志/升级统计"中查看具体失败原因后再重试；升级触发后全程禁止断电重启。
参考文档：AT FOTA 说明 https://docs.openluat.com/atmozu/product/command/fota/ ，AT 命令手册 PDF https://docs.openluat.com/atmozu/product/shouce/
13. air780ems支持LuatOS吗？
解答： 结论：在合宙官方文档站、选型指南和在售产品列表中均检索不到"Air780EMS"这一型号，因此目前无法确认它支持 LuatOS，也不能提供对应的固件与技术支持。请先核对模组金属屏蔽罩上的完整丝印，避免把相近字母看错（Air780 系列后缀较多，如 E/EP/EPM/EHM/EGH/EGG/EGP/EHV/EPT/EHT/EVT/EX2T 等）。
核实步骤：
1. 直接在合宙文档站 https://docs.openluat.com/ 顶部搜索框输入完整丝印型号，能搜到产品资料中心即说明是公开型号，进入对应"LuatOS 固件版本"页面即可下载固件和 demo；
2. 用 Luatools 读取模组信息（或 AT 固件发 AT*I 查看 Manufacturer/Model/Revision），把读到的 Model 与丝印一并核对；
3. 对照合宙选型指南 https://docs.openluat.com/SelectionGuide/SelectionGuide/ 确认该型号归属（AT 模组或 LuatOS 模组）；
4. 若该器件来自第三方或非合宙官方渠道、丝印确实为 Air780EMS 且官方无任何记录，则它不属于合宙公开发售的标准产品，合宙无法提供 LuatOS 固件和售后，请向供货方确认其真实来源、定制固件与技术支持方式；
5. 仍无法判断时，把模组正反面高清照片（含丝印）、购买链接和 AT*I 日志发到合宙官方企业微信群（文档站底部二维码）由技术支持确认。
14. 合宙IOT里的绑定设备提示：绑定失败：设备不在白名单列表中，但我在iot.openluat.com能看见设备，要怎么处理？
解答： 结论："能在 iot.openluat.com 看见设备"和"设备在当前操作账号/项目的可绑定白名单内"是两件事。该提示一般出现在：设备已归属到其他账号或其他项目、你要加入的目标项目与设备所属项目不一致、或设备归属尚未转移到你名下。先确认 IMEI 的实际归属账号和项目，再做归属转移，而不是在当前页面反复绑定。
排查与处理步骤： 1. 登录 iot.openluat.com，用"我的设备"按 IMEI 精确查询，确认设备当前显示在哪个账号、哪个项目（如线下采购默认在采购人手机号账号的"Air7XXF 标准模块/Air7XXE 标准模块"或"合宙标准模块"项目内）； 2. 如果设备在本账号但在其他项目：在"我的设备"中勾选设备，用"操作 → 批量转移 → 转移到其他项目"把它移入目标项目；批量转移支持上传 IMEI 清单； 3. 如果设备在其他人/采购或渠道商账号下： - 合宙官方电商渠道订单：按 https://docs.openluat.com/air780epm/product/attributioniot/ 第一章，登录 crm.luatos.com，"客户服务 → 首次设置设备归属（限官方店铺）"，输入订单号和快递单号后转移（2025 年 10 月及以后订单适用）； - 合宙官方线下渠道：由归属账号登录 iot 平台用"批量转移 → 转移到其他账号"操作，目标填你的账号和项目； - 非官方渠道/第三方购买：合宙客服无权限转移，需联系该渠道销售/客服协助； 4. 做 FOTA 还要注意项目类型：第三代 AT 型号升级项目名必须为"Air7XXF 标准模块"，项目选错时即使看得到设备也无法正常绑定升级； 5. 转移成功后退出页面重新进入，再执行绑定/加入项目操作；仍提示白名单问题时，截图 IMEI 查询页、报错页和订单/归属记录，通过合宙官方企业微信群（https://docs.openluat.com/ 底部二维码）联系平台技术支持核查。
参考文档：设备归属流程 https://docs.openluat.com/air780epm/product/attributioniot/ ，AT FOTA 项目配置 https://docs.openluat.com/atmozu/product/command/fota/
15. 模块进入低功耗模式后，唤醒后接收CAN数据会触发内部看门狗复位，是什么问题？
解答： 结论：这基本不是 CAN 外设本身的问题，而是唤醒后短时间内 CAN 接收处理（回调/解析/阻塞收发）占用 CPU 时间过长，导致内部硬件看门狗在唤醒后的首个超时窗口内没有被及时喂狗而复位。Air700/Air780/Air8000 系列的内部硬件看门狗由内核自动开启、用户不能设置超时，官方《LuatOS 看门狗统一说明》明确：从 PSM+ 唤醒重启后第一次超时时长固定为 8 秒；在这 8 秒内成功喂狗之后，超时时长变为 28 秒；其他重启/开机场景固定 28 秒。唤醒首包若处理过重，最容易踩到 8 秒窗口。
原理：
1. CAN 接收回调若在回调里直接做长耗时操作（大数据拼包解析、阻塞式 can.tx、写 Flash/文件、同步 socket 发送、打印海量日志、等待信号量），会阻塞内核任务调度，使内核自动喂狗和用户 wdt.feed() 都无法及时执行；
2. PSM+ 唤醒本质上是一次重启流程（协议栈重新初始化、重新驻网），系统本身启动负载就高，8 秒窗口更紧张；
3. PSM+ 深睡区间内看门狗停止工作，所以复位集中发生在"刚唤醒"阶段。
处理步骤：
1. 回调轻量化：CAN 接收回调里只做"收数存入 ringbuffer/队列 + 置标志位"，解析和业务逻辑放到独立 task 中分片处理；
2. 在唤醒后的主流程开始处和长循环中主动调用 wdt.feed()（文档：https://docs.openluat.com/osapi/core/wdt/ ），确保任何单段处理都远小于 8 秒；
3. 拆分 CAN 数据处理任务：单帧处理、分批 yield（sys.wait()），避免 while 死循环；Flash/socket 操作全部异步化并加超时；
4. 检查 CAN 初始化时序：唤醒后先完成必要初始化、注册接收回调，再进入业务；避免在唤醒中断上下文中执行初始化；
5. 用日志定位：打开 log，记录唤醒事件、每帧接收时间戳、喂狗时间点和复位前日志，确认是哪段代码超过 8 秒；必要时先在非 PSM+ 的 PRO 模式复现，排除网络驻网耗时干扰；
6. 若产品对可靠性要求高，可增加外部硬件看门狗方案（如 Air153C/Air5101S 互喂狗）。
参考文档：看门狗统一说明 https://docs.openluat.com/common/watchdog/ ，wdt 核心库 https://docs.openluat.com/osapi/core/wdt/ ，CAN 核心库 https://docs.openluat.com/osapi/core/can/
16. Air780E是否支持语音播放？应该烧录哪个固件？
解答： 结论：需要区分具体型号和固件形态，不能一概而论"Air780E 不支持音频"： 1. 老款 Air780E（第二代 Cat.1 型号）官方新项目不再推荐用于音频场景，LuatOS 音频体系也主要面向 Air780EXX 新一代型号维护； 2. 新一代 Air780EXX 中，Air780EHV 内部集成 es8311 codec，直接支持录音、音频播放和 TTS，并用 GPIO20 控制 es8311 使能；Air780EHM/EGH/EGG 等型号内部不含 es8311，但属于"支持 Audio 功能的型号"，外挂 ES8311（可用官方 AirAUDIO_1010 配件板验证）并在板子上加音频功放即可； 3. 选型建议（官方 FAQ 2026-08-26 第 44 条）：新上带音频输出的项目不建议用 780E/780EQ/780EPT，建议用 Air780EVT，板子上加一颗音频功放即可；要内置 codec、省外挂器件则选 Air780EHV。注意部分型号（如 EHU/EHN）无 TTS 能力，选型时在固件发布说明中确认。
固件与软件怎么选：
1. 烧录该型号对应的 LuatOS 固件（在文档站该型号"LuatOS 固件历史版本"页面下载），因 Flash 空间有限，固件按功能组合区分，请在发布说明中选择包含音频组件的固件种类；
2. 软件优先使用 exaudio 扩展库（官方明确：老的 audio 核心库基于 es8311、参数过多、历史包袱重，新项目建议用 exaudio）；文档：exaudio https://docs.openluat.com/osapi/ext/exaudio/ ，audio 核心库 https://docs.openluat.com/osapi/core/audio/ ；
3. 硬件上 Speaker 不能直接挂 codec 输出，必须经音频 PA；Mic 偏置、PA 使能脚按 demo 配置；
4. 如果你用的是 AT 固件而不是 LuatOS 二次开发，音频/TTS 指令支持范围以对应 AT 型号手册为准，老 Air780E AT 固件与 Air780EVT/EHV AT 固件能力不同，不要混刷。
参考：AirAUDIO_1010 配件板（外挂 ES8311+PA，适配 Air8000 全系、Air780EHM/EGH/EGG 等）https://docs.openluat.com/accessory/airaudio_1010/ ，合宙选型指南 https://docs.openluat.com/SelectionGuide/SelectionGuide/
17. 有哪些命令行下载工具？
解答： 结论：合宙官方主力图形化工具是 Luatools（研发下载/日志），批量产线用合宙量产烧录工具（在线版/脱机版，支持循环烧录，仅 Windows 10 及以上）；需要在终端/脚本中触发下载时，可使用 luatos-cli 命令行工具（在官方 FAQ 中有明确提及：可从 GitHub 或 Luatools 资源入口获取），具体命令参数和支持型号请以随工具发布的说明与官方工具页最新内容为准。
工具选择与要点：
1. Luatools：日常开发首选，支持固件下载、脚本/资源更新、串口日志、量产文件生成；教程 https://docs.openluat.com/common/Luatools/ ；
2. 合宙量产烧录工具：面向产线，分在线版（MES 授权，可限次数/有效期）和脱机版；用 port_config.ini 配置烧录端口（Air8101 烧录端口即对应串口，其他型号为模组进入 boot 模式后出现的 boot 端口，boot 模式最多保持约 15 秒）；可勾选"清 KV""清 FS""自动循环烧录"；支持 Air780E/EP/EPM、780EHM/EGH/EGG/EGP/EHV、Air8000A/W/D/T/AB/DB、Air8101 等，支持 lua/csdk 互刷：https://docs.openluat.com/common/Luat_productiontool/ ；
3. luatos-cli：适合 CI/自动化脚本中通过命令行完成烧录，获取方式以 Luatools"软件资源下载"和官方 GitHub 仓库为准，使用前先核对其支持的型号与固件格式；
4. 硬件前提：单板下载用 USB 或下载串口，批量下载最小系统需引出 PWRKEY、VDD_EXT、USB_BOOT（USB_EXT 与 VDD_EXT 短接可上电即进 USB 下载模式）、VBAT、GND 等，参见 https://docs.openluat.com/air780epm/luatos/hardware/download/ 。
说明：命令行工具的版本更新较快，若 luatos-cli 在你的型号上行为与文档不符，请以官方工具页面说明或合宙官方企业微信群（https://docs.openluat.com/ 底部二维码）确认为准，不要使用来源不明的第三方刷写工具。
18. luatos写应用现在是不是也都可以用AI实现了，修改驱动什么的？
解答： 结论：AI（如合宙官方 Trae + luatos-docs-code 智能体、crm.luatos.com 的 AI 助手）已经可以高效完成大部分 LuatOS 上层应用开发，包括按需求生成 main.lua、调用官方库（mqtt/socket/http/mobile/gpio/i2c 等）、解释报错和移植 demo；但"外设驱动适配"和"BSP/内核修改"要分层看，不能一概认为所有驱动都能让 AI 直接改好。
按层级说明可行性： 1. 应用层业务逻辑（数据采集、上报、定时任务、低功耗流程、UI）：AI 可直接生成大部分代码，官方提供了从 Hello LuatOS 到 MQTT 温湿度上报等项目实战教程（https://docs.openluat.com/ai/trae+luatos-docs-code/project/ ），生成的代码基于官方库和 demo，准确度较高； 2. 已有扩展库支持的外设（常见传感器、GPIO/I2C/SPI/UART 器件、exmodbus、exvib、传感器扩展库 exs_xxx 等）：AI 可按数据手册帮你写初始化和读写逻辑，但仍需用真机核对电平、时序、地址和中断接线； 3. 官方库未覆盖的新外设：需要有人按芯片数据手册用 i2c/spi/uart 原语实现驱动，AI 能辅助编写和排查，但无法凭空保证寄存器级正确性，必须有数据手册和实机波形验证； 4. BSP/内核/核心库 C 代码修改（新芯片平台移植、内核调度、协议栈、USB 驱动等）：不属于普通 Lua 脚本开发范畴，需要 csdk/固件源码级开发与编译环境，AI 只能辅助分析，不能替代原厂内核维护，这类需求建议走合宙定制或在 Gitee 官方仓库（https://gitee.com/openLuat/LuatOS ）提 Issue 评估。
建议工作方式：先在文档站确认该外设是否已有官方库/demo；让 AI 基于官方文档和 Gitee 上对应产品目录的 demo 生成代码；保留日志与最小复现工程；涉及核心库行为时以 https://docs.openluat.com/osapi/ 官方 API 文档为准，不要让 AI 虚构函数名。
19. Air780EPM想要用作上网工具，应该怎么处理？
解答： 结论：如果需求是"插上就能上网"的 USB 4G 上网棒，不建议用 Air780EPM 自行开发，直接选合宙 Air8783 免开发 USB Dongle 4G 上网棒（选型指南明确推荐，29 元）：三网通（移动/联通/电信），USB 上网支持 Windows、Linux，上网方式支持 USB-RNDIS/ECM，Windows 免驱，自带独立硬件看门狗，还支持短信转发到手机号/企业微信/飞书/钉钉。产品说明：https://docs.openluat.com/air8783/product/ ，选型指南：https://docs.openluat.com/SelectionGuide/SelectionGuide/ 。
注意事项： 1. Air8783 明确不支持 Android 系统下的 USB RNDIS 上网，安卓场景请勿选用； 2. 短信转发需使用支持 4G 的手机 SIM 卡，物联网卡不适用；转发到钉钉/飞书/企微走 HTTP 推送消耗 4G 流量，转发到手机号消耗短信费； 3. Air8783 基于 Air780ER2 设计，出厂已烧录 RNDIS+短信转发固件，无需自行开发；有特殊需求可用官方提供的 LuatOS demo 二次开发。
为什么不推荐直接拿 Air780EPM 做：Air780EPM 是 OpenCPU 模组，本身不附带"USB 即插即用网卡"成品固件，要实现上网棒功能需要自行解决 USB RNDIS/ECM 网卡设备描述与拨号数据通道（可研究 mobile.config(mobile.CONF_USB_ETHERNET, ...) 等配置）、天线与射频、供电、4G 注网与断线重连、外壳和认证，开发与验证成本远高于直接用 Air8783。只有在需要深度定制业务逻辑、且具备 LuatOS 开发能力时，才评估基于 Air780EPM 自研，并先阅读该型号产品资料与 USB 网卡相关 demo（Gitee：https://gitee.com/openLuat/LuatOS/tree/master/module ）。
20. Air8000开发板用12V/15W的电源供电可以吗？12V电源，蓝牙wifi4G都支持吗？
解答： 结论：官方公开教程中，Air8000 核心/开发板的标准供电方式是 Type-C USB 口供电（板上"外部供电/USB 供电"拨动开关拨到 USB 供电端）和白色电池卡扣接可充电锂电池；官方页面没有公布"12V 直流电源插座"及其额定功率（15W）规格，因此不能直接承诺 12V/15W 适配器可用于你手上的具体板卡，请先以该板随附的原理图/硬件手册和供电接口丝印为准，确认是否存在 12V DCDC 输入回路后再接线，盲目加 12V 有损坏板子的风险。
供电核实步骤： 1. 确认板卡完整型号（Air8000A/W/D/T/AB/DB 等，核心板与 TurnKey 开发板外设不同），打开 https://docs.openluat.com/air8000/ 对应产品的"硬件设计/硬件手册"，查供电框图和外部输入电压范围； 2. 实物核对：若只有 Type-C 与电池座，则用 5V/≥2A 的优质 USB 电源（4G 发射瞬间电流较大，劣质电源会导致重启）；若有独立 DC 端子且原理图标注支持 12V，再按其标称电压/功率选适配器，功率留 30% 以上余量； 3. 12V/15W 即 1.25A 额定输出，能否用取决于板上 DCDC 是否支持 12V 输入、能否承受 4G 发射峰值，而不是功率"够大"就可以；电压不匹配时功率再大也会烧板。
无线能力（按型号区分，官方硬件资料明确）： 1. Air8000 系列中支持 WiFi/BLE 的型号为 Air8000A、Air8000AB、Air8000U、Air8000N、Air8000W（内置 4G 主控 + WiFi/BLE 芯片，经 SPI/AirLink 互连）；不是所有后缀都带 WiFi/蓝牙； 2. 4G 能力按具体型号（A/W/D/T 等）对应频段和制式不同，需查该型号产品页；使用时分别接好 4G 主天线和 2.4G WiFi 天线、插可上网的 SIM 卡； 3. WiFi 当前配网仅支持蓝牙配网和 SoftAP，不支持 airkiss/smartconfig（https://docs.openluat.com/air8000/luatos/app/wifi/ ）。
参考：Air8000 文档站 https://docs.openluat.com/air8000/ ，WiFi/BLE 硬件说明 https://docs.openluat.com/air8000/luatos/hardware/wifi&ble/ ，选型指南 https://docs.openluat.com/SelectionGuide/SelectionGuide/
21. 为什么用电信的卡试了不行，用流量卡就可以？
解答： 结论：换卡能上网基本可以排除硬件损坏，问题集中在"电信卡本身（套餐/专网/欠费/鉴权）、APN 配置、模组固件对电信的支持、频段/注册"四个方向。先区分你的模组跑的是 AT 固件还是 LuatOS，再按下列顺序用指令定位，不要只换卡试。
一、先确认模组固件是否支持电信：
1. Air780EXX 的 AT 固件中，v20xx 系列支持移动/联通，电信卡需要 v30xx 系列固件（仅 Air780EPT/EG2/EX2T 等指定 AT 型号），固件版本不对时电信卡无法正常注册；先用 AT*I 查看 Model 与 Revision；
2. LuatOS 固件按型号支持全网通，但仍受频段和当地网络影响。
二、按官方 AT 手册第 18 章（SIM/APN/联网排查）逐项检查：
1. SIM：AT+CPIN? 返回 +CPIN: READY 为正常；返回 SIM NOT INSERTED/SIM REMOVED 检查卡方向、触点、卡座和供电跌落；
2. 注册：AT+CEREG? 看 stat——1 已注册本地网、5 已注册漫游、2 正在搜网、0 未搜网、3 注册被拒绝；电信卡常见 stat=2/3，多为套餐、APN 或鉴权问题；
3. 信号：AT+CSQ（第一个值 99 表示不可测，检查天线 IPEX/SMA 是否接好）、AT+CESQ 读 RSRP/RSRQ，弱场换位置或加天线；
4. 运营商：AT+COPS? 看是否搜到中国电信（MNC=11；移动 00、联通 01、广电 15），可用 AT+COPS=? 全频段扫网（耗时较长），并结合 AT*BANDIND? 确认频段支持；
5. 附着：AT+CGATT? 返回 1 才表示已附着；
6. APN：公网卡一般自动获取，专网卡必须配置。查询用 AT+CGDCONT?、AT+CPNETAPN?、AT+CSTT?、AT+SAPBR=4,1；电信专网卡按运营商提供的 APN/用户名/密码设置，如 AT+CPNETAPN=2,"apnname","user","pwd",authmode，设置后协议栈重启并重新激活 PDP，看到 +CGEV: ME PDN ACT 1 才表示联网成功；
7. TCP/UDP/PING 场景可用 AT+CIPSHUT → AT+CSTT="apn" → AT+CIICR → AT+CIFSR 重新激活；HTTP/FTP 场景用 AT+SAPBR=3,1,"APN","x" → AT+SAPBR=1,1。
三、卡本身排查：把电信卡放手机确认能上网（电信 4G/5G 卡需开通数据、非物联专网限制）；确认不是专网卡（专网卡只能访问私有 APN 或白名单 IP，访问公网失败属正常）；若是电信物联网卡，找发卡方确认 APN、是否有机卡绑定、是否欠费停机。
参考：AT 命令手册（第 18 章 SIM 卡和 APN 联网问题排查）https://docs.openluat.com/atmozu/product/shouce/ ，专网卡配置 https://docs.openluat.com/atmozu/product/command/dncard/ ，固件下载 https://docs.openluat.com/atmozu/product/firmware/
22. 8780写一个简单喂狗，哪里找这个文件？
解答： 结论：Air8780 板载了外置看门狗电路（Air153C/Air153D，喂狗信号为 GPIO24），LuatOS 下统一使用官方扩展库 exair153x_wdt（兼容 Air153C 和 Air153D），旧的 air153C_wtd 扩展库已不再维护，新项目不要再用。库文档与完整示例：https://docs.openluat.com/osapi/ext/exair153x_wdt/ ，Air8780 看门狗硬件说明：https://docs.openluat.com/air8780/luatos/hardware/module/circuit/wdt/ 。
最简单的喂狗代码（main.lua 中）：
-- Air8780：板载看门狗喂狗脚为 GPIO24
local exair153x_wdt = require("exair153x_wdt")
sys.taskInit(function()
-- init 会完成 GPIO 配置、立即喂一次狗，并启动自动喂狗常驻任务
-- auto_feed_period_s 默认 180 秒，强制最小 150 秒，小于 150 初始化失败返回 false
local ok = exair153x_wdt.init({
wdt_pin = 24,
auto_feed_period_s = 180,
})
log.info("wdt", "外部看门狗初始化", ok)
end)
init 成功后库内 task 自动喂狗；长时间阻塞操作或用 fota 核心库升级时，可手动调用 exair153x_wdt.feed() 补喂（libfota/libfota2 已内置自动补喂）；
2. 主动强制复位用 exair153x_wdt.trigger_reset()；查库版本用 exair153x_wdt.version()；
3. 时序参数：Air153C 超时固定 4 分钟（实测约 209~283 秒）；Air153D 与 C 是同一颗芯片、仅软件/STRAP 档位不同，可配置 4 分钟/90 分钟/13 小时/26 小时，档位由 STRAP1/STRAP6 上电电平硬件决定；
4. 注意这是外部硬件看门狗，与模组内部看门狗（wdt 核心库，内核自动管理）相互独立，两者不是一回事；统一说明见 https://docs.openluat.com/common/watchdog/ 。
23. Air8781P这个设备文档上只写了5-12V，电流多少？
解答： 结论：官方硬件文档对 Air8781P 只给出了输入电压范围（PIN7 VIN 为板载 DCDC 输入，5V~12V，DCDC 为杰华特 JW5357，芯片最高输入 18V，限制 12V 是留余量），没有标注整板的固定工作电流，因此不存在一个可直接照抄的"电流规格"。整机电流要按板载 Air780EPM 模组的工况和你外接的负载实测确定。
原理与估算： 1. 电流随 4G 工况大幅波动：待机平均电流小，在注册、TAU、建链、上行发射时出现脉冲峰值。Air780EPM 模组 VBAT（3.3~4.35V，典型 3.8V）侧发射峰值电流约 1A 量级，以 Air780EPM 产品手册电气参数为准； 2. VIN 侧电流 = 模组与板上负载功率 ÷ VIN 电压 ÷ DCDC 效率，输入电压越低（5V）输入电流越大，12V 时输入电流更小但要按 5V 最不利情况选电源； 3. Air8781P 为插针工业模组，外设负载取决于你挂在插针上的器件，需要叠加。
设计建议： 1. 电源按 5V 输入下能持续供应 1A 以上、并能承受秒级脉冲拉载不欠压来选，建议留 30%~50% 余量（如 5V/2A）；端子和线径按峰值电流设计； 2. 用直流电源/功率分析仪在弱信号环境下反复执行注网+大数据上行，实测 VIN 端峰值电流、平均电流和最低电压，作为适配器与电池选型依据； 3. 查 JW5357 规格书（官方页面附 PDF）可得到芯片限流与效率曲线，进一步核算 DCDC 余量。
参考文档：Air8781P VIN 电路说明 https://docs.openluat.com/air8781p/luatos/hardware/module/circuit/vin/ ，Air8781P 硬件总览 https://docs.openluat.com/air8781p/luatos/hardware/overview/ ，通用功耗说明 https://docs.openluat.com/common/airpower/
24. Issues提交不了，填好内容点提交就回到选择类型界面怎么办？
解答： 结论：填完 Issue 点提交却退回"选择类型"界面，通常是表单校验未通过导致的页面回退（必填项缺失、附件超限/上传未完成、登录态过期），或浏览器对 Gitee 页面的兼容/缓存问题，不是代码权限被拒。官方没有单独的 Issue 提交故障文档，可按下列步骤逐项排查。
排查步骤：
1. 先看页面是否有红色报错提示：Issue 类型、标题等是必选项，退回时留意顶部/字段下方的校验提示，按提示补齐；
2. 确认登录态：重新登录 Gitee（https://gitee.com/openLuat/LuatOS/issues ），确认账号已验证邮箱，再进入 Issues → 新建 Issue，避免会话过期导致提交被重定向；
3. 附件处理：日志/截图不要直接粘贴超大内容，先在本地确认附件已 100% 上传完成（出现文件名/可删除标记）再提交；超大日志建议压缩后上传，或贴到 Gist/网盘后只放链接；正文过长时先精简成"型号+固件版本+复现步骤+日志"再提交；
4. 浏览器环境：换 Chrome/Edge 最新版，关闭广告拦截/脚本类插件，清理 gitee.com 的 Cookie 与缓存后重试，或用浏览器无痕窗口；
5. 网络与重试：公司网络/代理可能拦截提交请求，可换网络重试；提交失败后不要连续猛点，先刷新确认 Issue 是否其实已经创建（回到 Issues 列表按标题搜索，避免重复单）；
6. 正确入口：LuatOS 主仓库 Issue 地址 https://gitee.com/openLuat/LuatOS/issues ；属于具体 module（如 Air780EPM、Air8000）的问题，也可提到对应仓库/目录，提交时写清产品型号、固件版本号（AT*I 或 LuatOS 版本）、复现步骤和最小日志；
7. 若以上均无效，把报错页面截图、浏览器控制台（F12 → Console/Network）失败请求截图发到合宙官方企业微信群（https://docs.openluat.com/ 网站底部二维码），或先在群内/CRM AI 描述问题，由技术支持协助反馈，不影响问题受理。
25. air780ehv，sip桥接模式，主叫挂电话就死机，怎么办？
解答： 结论：主叫挂断（对端发 BYE）就死机/重启，多数是应用层挂断事件处理不当造成的：回调里执行了阻塞/重操作、挂断后仍在访问已释放的通话资源、未正确调用挂断接口，或使用的 exsip 库/固件版本存在已知缺陷。Air780EHV 内置 es8311，是官方 SIP 通话支持型号；SIP 通话请使用 exsip 扩展库，按官方事件模型实现，不要在回调里"硬处理"。
正确的 API 与协议要点（官方文档 https://docs.openluat.com/osapi/ext/exsip/ ）：
1. 接口名与大小写：配置 exsip.init(config)（config 含 sip_server_addr/port/domain/username/password/sip_transport/auto_answer 等）、exsip.start()、exsip.stop()、exsip.dial(target)、exsip.accept()、挂断为 exsip.hangUp()（注意大写 U）、事件注册 exsip.on(callback)、exsip.off(event)、exsip.get_current_call()、exsip.version()；
2. 编码仅支持 PCMU/PCMA（G.711 μ/A 律），SDP 里不要协商其他编码；SIP 信令传输用 exsip.TRANSPORT_TCP 或 exsip.TRANSPORT_UDP，官方明确当前 demo 的 SIP 信令主要实现了 TCP，UDP 仍在调试，桥接场景建议先用 TCP 复现验证；
3. RTP/RTCP 走 UDP，偶数端口承载 RTP、相邻奇数端口承载 RTCP。
排查步骤：
1. 回调轻量化：在 exsip.on 的挂断/BYE 类事件回调中只做标志置位和必要的状态记录，资源释放、音频停播、重新拨号等动作放到独立 task 中执行，严禁在回调里死循环、阻塞 socket、大量写 flash 或打印；
2. 状态保护：挂断后用 exsip.get_current_call() 判断是否仍存在通话，再决定是否访问通话资源，避免对已结束会话重复 hangUp()/拨号造成空指针或断言；
3. 抓信令日志：串口开启完整 SIP 日志，复现主叫先挂场景，确认是否正常收到 BYE、是否回 200 OK、死机前最后一条日志；同时在服务器侧/Wireshark 抓 SIP（TCP 5060 或自定义端口）与 RTP 包，判断是信令异常还是媒体资源未释放；
4. 版本核对：用 exsip.version() 确认扩展库版本（当前文档版本 202607021200，2026-07-17 更新），升级到最新 exsip 库和 Air780EHV 最新 LuatOS 固件后复测，旧版本挂断路径可能有已修复缺陷；
5. 对照官方 demo（Gitee LuatOS 仓库各产品目录下 demo/sip：https://gitee.com/openLuat/LuatOS/tree/master/module ）检查桥接逻辑是否自行改动了挂断/音频通路；
6. 若仍必现死机，按"型号+固件版本+exsip 版本+最小复现脚本+死机前后完整串口日志+SIP/RTP 抓包"在 Gitee 提 Issue 或发合宙官方企业微信群（https://docs.openluat.com/ 底部二维码）支持。
26. Air720UX模块能加入到我账号中吗？
解答： 结论：可以，但合宙设备的"加入账号"本质是设备归属转移，能否自助完成取决于购买渠道和当前归属状态。Air720UX 属于早期 Air 系列型号，请先在 iot.openluat.com 用 IMEI 查询当前归属，再按官方归属流程处理。
操作路径（官方说明：https://docs.openluat.com/air780epm/product/attributioniot/ ，流程对全系合宙设备通用）： 1. 登录 iot.openluat.com → "我的设备"，输入模块 IMEI 查询当前所在账号/项目； 2. 设备当前已在你账号下：直接在项目间"批量转移"即可，无需重复加入； 3. 设备在合宙官方电商订单中：登录 crm.luatos.com，"客户服务 → 首次设置设备归属（限官方店铺）"，输入订单号、快递单号后转移到你的账号和 iot 项目； 4. 设备在合宙官方线下批量订单的采购账号下：由当前归属账号登录 iot 平台，用"操作 → 批量转移 → 转移到其他账号"，填入你的手机号账号、目标项目和 IMEI； 5. 设备来自经销商/第三方：设备所有权属于该渠道，合宙客服无权限直接转移，需联系对方销售/客服协助，并把上述归属文档发给对方； 6. Air720UX 为老型号，若你还要使用平台 FOTA，项目类型要与该代际型号对应（早期型号归属"Air72XUX 标准模块"类项目），创建项目前建议在官方企业微信群（https://docs.openluat.com/ 底部二维码）确认项目配置。
27. AIR153C这颗料停产了？
解答： 结论：截至目前，合宙官方文档和官方淘宝店仍将 Air153C 作为在售标准配件维护（配件页 2026-01-21 仍有更新，标价 0.45 元，SOT23-6 封装），未发布停产（EOL/PCN）公告。因此"已停产"的说法没有官方依据；但供货状态、交期和生命周期以商务最新通知为准，大批量项目建议下单前向合宙商务书面确认。
选型建议：
1. Air153C 与 Air153D 是同一颗芯片，仅软件/配置不同：Air153C 的 PIN1/PIN6 悬空，超时时间硬件固定为 4 分钟（实测约 209~283 秒），不可修改；Air153D 用 PIN1/PIN6（STRAP）上电电平选择 4 分钟/90 分钟/13 小时/26 小时四档，灵活性更高；
2. 新设计如果希望超时时间可配置、减少未来换料风险，可优先评估 Air153D；如果只需要固定 4 分钟硬件看门狗，Air153C 仍可正常使用，二者喂狗/复位电路一致，软件统一用 exair153x_wdt 扩展库；
3. 生命周期和供货承诺请通过合宙官方淘宝店客服或商务获取书面确认，不要以聊天记录作为长周期项目的唯一依据。
参考：Air153C 配件页（含设计手册与购买链接）https://docs.openluat.com/accessory/Air153C/ ，exair153x_wdt 库（C/D 差异表）https://docs.openluat.com/osapi/ext/exair153x_wdt/
28. AIR153C这颗料有停产计划吗？
解答： 结论：目前没有查询到合宙官方发布的 Air153C 停产计划或 EOL/PCN 公告，官方配件页和官方店铺仍显示正常在售（0.45 元），可正常设计和采购。需要澄清一点：Air153C 与 Air153D 在硬件上是同一颗芯片，差异在于 Air153D 通过 STRAP 引脚在上电时配置超时档位，Air153C 固定 4 分钟超时；这属于功能配置差异，不是"新旧替代芯片"的关系。
建议：
1. 对生命周期敏感的项目（尤其要备货多年的量产品类），不要仅凭口头答复，直接联系合宙商务获取供货周期、最小订量和生命周期书面确认；
2. 新设计可直接按 Air153D 画兼容封装（保留 STRAP1/STRAP6 上拉/下拉），软件统一用 exair153x_wdt，这样贴 C 或 D 均无需改板；
3. 关注官方配件页与选型指南，如未来有 PCN/EOL 会通过官方渠道发布。
参考：Air153C 配件页 https://docs.openluat.com/accessory/Air153C/ ，exair153x_wdt（含 C/D 硬件差异对照与 STRAP 档位表）https://docs.openluat.com/osapi/ext/exair153x_wdt/
29. 780EPT的参考封装导入嘉立创，原理图上为什么只有一部分？
解答： 结论：合宙官方提供的硬件资料中包含立创EDA（嘉立创）可直接导入的原理图符号与 PCB 封装，另外也提供 PADS/Altium Designer 等格式；"导入后原理图只有一部分引脚/符号"基本是导入方式或文件选择问题（只导入了 PCB 封装没导入符号、库映射不完整、把封装库当原理图库打开），不是官方资料缺件。请重新从官方渠道下载并按格式分别导入。
操作步骤： 1. 打开官方 AT 产品资料页（780EPT 与 700ECT/EX2T/EHT/EVT/EG2/EGT 同属一个产品手册/资料集合）：AT 手册与原理图/PCB 封装/参考设计入口 https://docs.openluat.com/atmozu/product/shouce/ ；也可在 https://docs.openluat.com/ 搜索"780EPT 封装/原理图"； 2. 区分文件类型：原理图库（符号，.eliSchLib/SchLib 等）和 PCB 封装库（.elibPcb/PcbLib 等）是两个文件，必须分别导入并在元件属性中做好"符号—封装"关联；只导封装时原理图自然显示不全； 3. 立创EDA专业版/标准版导入：使用"文件 → 导入 → Altium/立创"对应入口导入完整工程或库文件，导入后在"元件库"中确认 Air780EPT 符号引脚数量与硬件手册管脚表一致（16×18mm，LCC 邮票孔封装）； 4. 若是 PADS 等第三方格式转到立创，转换过程可能丢失部分图形/属性，建议优先直接使用合宙提供的立创EDA原生文件，避免二次转换； 5. 导入后对照官方硬件手册管脚定义逐脚核对电源（VBAT/GND/VDD_EXT）、SIM、USB、UART、天线等关键引脚，再开始画板； 6. 如果从官方页面下载的原始文件导入后仍缺引脚，请保留原文件和报错截图，在合宙官方企业微信群（https://docs.openluat.com/ 底部二维码）反馈，注明 EDA 版本号，由技术支持核对资料版本。
30. Air780ET和Air780EPT通用吗？软件硬件要改动不？
解答： 结论：请先核对丝印——合宙第三代 AT 公开型号中并没有名为"Air780ET"的模组，发音/丝印容易混淆的是 Air780EHT。官方产品手册将 Air780EPT/EHT/EVT/EG2/EGT 归在同一尺寸平台（16×18×2.3mm），其中已明确 Air780EPT 与 Air780EHT 管脚一致；在不使用差异功能、且软件按各自固件发布说明核对的前提下，同封装替换通常不需要改板，但必须以你板子实际用到的引脚逐一比对，不能口头判定"完全通用"。
硬件/软件替换检查项：
1. 用 AT*I 或模组丝印确认真实型号（EPT/EHT/EVT/EGT/EX2T 等后缀功能不同，例如 EHV 是音频型号、EGT/EG2 带定位，不能互代）；
2. 到官方产品手册（https://docs.openluat.com/atmozu/product/shouce/ ，"700ECT/780EX2T/EPT/EHT/EVT/EG2/EGT 产品手册"）下载对应管脚定义，逐 PIN 核对你实际使用的电源、SIM、USB、UART、音频、按键/状态脚是否完全一致；
3. 射频与天线：核对频段支持是否满足运营商需求，天线匹配和布局按硬件设计手册复查；
4. 软件：AT 固件需烧录对应型号的固件版本（EPT 与 EHT 固件不能混刷），替换后重新验证注网、拨号、MQTT/HTTP、低功耗、FOTA 全流程；外设初始化参数按新型号管脚复核；
5. 认证与量产：终端认证型号、IMEI 标签、采购 BOM 要同步更新；
6. 若你手上的丝印确实是"Air780ET"而不是 EHT，官方资料中无此型号，请拍清丝印和 AT*I 输出，通过合宙官方企业微信群（https://docs.openluat.com/ 底部二维码）确认来源后再做替换决策。
31. Air780ET说停产了？有替代的性价比高的吗？
解答： 结论：合宙官方公开型号中没有"Air780ET"这一型号，因此不存在它的官方停产公告和官方替代价目，请先核实模组真实型号；停产状态、交期和单价以官方产品页、官方淘宝店（luat.taobao.com）页面及商务书面报价为准，口头单价不能作为选型依据。发音和丝印上最容易与 Air780EHT 混淆，也可能是 Air780EVT/EGT 等后缀。
核实与替代步骤：
1. 看模组金属屏蔽罩完整丝印，或发 AT*I 确认 Manufacturer/Model/Revision，把丝印照片与 AT*I 输出核对清楚；
2. 在文档站 https://docs.openluat.com/ 搜索完整型号，确认是否有公开产品资料中心；
3. 确认型号后，在选型指南 https://docs.openluat.com/SelectionGuide/SelectionGuide/ 中按"同尺寸、同功能"选择在产替代：音频需求选 Air780EVT/EHV 等音频型号，GNSS 定位需求选 Air780EGT/Air780EG2，不要跨功能线替代；
4. 替代时逐 PIN 比对管脚、频段和外设差异，固件必须烧录新型号对应版本，型号之间固件不可混刷；
5. 生命周期、批量价格和供货周期请通过官方店铺客服或合宙商务获取书面确认，勿以聊天转述的单价为准。
参考：合宙选型指南 https://docs.openluat.com/SelectionGuide/SelectionGuide/ ，官方店铺 https://luat.taobao.com/
32. AI问答如何像你一样显示完整？我的只能显示一半？
解答： 结论：AI 问答回复只显示一半，多为页面渲染区高度、浏览器缩放或缓存导致的前端显示问题，不是回答内容本身被截断。按下列顺序处理即可恢复完整展示：
操作步骤： 1. 点问答界面上的"全屏"按钮，展开为全屏会话视图，长回复可完整滚动查看； 2. 新建一个会话重新提问，排除单条消息渲染异常； 3. 将 Chrome/Edge 更新到最新版本，刷新页面重试； 4. 清理浏览器缓存与 Cookie，或直接用无痕窗口打开； 5. 按 Ctrl+0 把浏览器缩放恢复为 100%（Ctrl+加号/减号会改变显示比例），再检查滚动条； 6. 仍显示不全时，换一个浏览器或设备登录验证，并把页面截图反馈到合宙官方企业微信群（https://docs.openluat.com/ 网站底部二维码扫码加入）。
参考：合宙官方文档站 https://docs.openluat.com/
33. Air780EX2T核心板淘宝买的，怎么归类到我的账号下呢？
解答： 结论：设备归类到自己账号即"设置设备归属"，能否自助办理取决于该淘宝订单的店铺是否为合宙官方电商。合宙官方电商为 luat.taobao.com（合宙淘宝企业店）、"降功耗找合宙"公众号商城及其视频号小店；官方店订单可在 CRM 自助归属，第三方店铺购买的需联系卖家转移。办理前先准备好设备 IMEI（AT*I/AT+GSN 或模组丝印、包装盒标签均可查询）。
操作步骤： 1. 官方店订单：用下单手机号登录 https://crm.luatos.com/ ，初始密码 88888888（登录不上可直接注册，CRM 与 iot 平台同一账号）； 2. 进入"客户服务 → 首次设置设备归属（限官方店铺）"，填写淘宝订单号和快递（物流）单号，系统列出该订单内设备； 3. 勾选 Air780EX2T 后单个设置归属，或用顶部"批量设置 IMEI 归属"直接转入指定 iot 项目；之后在 iot.openluat.com 对应项目即可看到设备并配置 FOTA； 4. 第三方淘宝店铺购买：设备归属在卖家渠道账号下，合宙客服无权限直接转移，请联系卖家客服提供 IMEI 协助把设备过户到你的账号，并将官方归属说明文档发给对方； 5. 转移完成后在 iot 平台核对 IMEI、项目是否正确；归属有争议时，凭订单号、快递单号、IMEI 购买凭证通过合宙官方企业微信群（https://docs.openluat.com/ 网站底部二维码）联系支持。
参考文档：设备归属说明 https://docs.openluat.com/air780epm/product/attributioniot/ ，CRM 平台 https://crm.luatos.com/
34. 官店卖的核心板好像没有USB？
解答： 结论：合宙官方核心板（Air780EPM/EHM/EVT 等核心板系列）均板载 Type-C USB 插座，并配有 ON/OFF 供电拨动开关，不存在"官方核心板没有 USB 口"的情况；插上后电脑不识别，通常是线材、开关状态或开机状态问题。如果是裸模组/邮票孔产品，USB 信号在模组管脚上，需要自行做底板引出。
排查步骤： 1. 确认线材：使用带数据线芯的 USB 数据线，纯充电线无 D+/D-，设备管理器不会出现端口；可换手机能传文件的线验证； 2. 确认供电开关：核心板上的 ON/OFF 拨动开关拨到 ON，PWR 灯应亮起；部分板子还需短按 PWRKEY 开机，只有模组开机后 Windows 设备管理器才枚举出 USB 端口； 3. 驱动与端口：安装 Luatools（会自动安装驱动），开机后查看设备管理器是否出现 USB 枚举设备/串口； 4. 区分产品形态：买到的若是邮票孔模组（如 Air780EPM 模组本体）而非核心板，USB（USB_DP/USB_DM、VBUS）在管脚/邮票孔焊盘上，必须在底板走线引出 USB 座并保证 VBUS 检测，不能直接插线； 5. 型号核对：按订单型号和板子丝印在 https://docs.openluat.com/ 对应产品的"硬件设计/硬件手册"中确认 USB 管脚位置，不要凭外观臆断； 6. 以上均正常仍无枚举：换 USB 口（直连主机，不用扩展坞）、换线、用 Luatools 重新进 BOOT 下载模式验证，仍不行时附订单型号、板子正反面照片和设备管理器截图到合宙官方企业微信群（https://docs.openluat.com/ 网站底部二维码）支持。
参考：Luatools 下载工具 https://docs.openluat.com/common/Luatools/ ，核心板选购与对比 https://luat.taobao.com/ ，选型指南 https://docs.openluat.com/SelectionGuide/SelectionGuide/
35. 8300这个开发板有没有iRTU固件？
解答： 结论：Air8300（EXB_8000_CH390_1）官方版本页面目前仅发布了"数据采集器量产固件"（DataCollector，基于 Air8000W），该页面明确标注"支持二次开发"，并未提供 iRTU 固件，因此不能把它当作 iRTU 成品使用；如确有 iRTU 需求，需通过合宙官方企业微信确认是否有适配计划或定制方案。
处理步骤： 1. 打开官方版本页 https://docs.openluat.com/exb/EXB_8000_CH390_1/version/ ，核对当前发布的固件名称与说明，确认只有数据采集器量产固件； 2. 数据采集场景可直接使用该量产固件，并按页面说明做二次开发配置； 3. 需要自定义逻辑时，确认其基于 Air8000W，可参考 Air8000W 的 LuatOS 资料和 Gitee demo（https://gitee.com/openLuat/LuatOS/tree/master/module ）评估自行开发； 4. 必须使用 iRTU 固件时，到合宙官方企业微信群（https://docs.openluat.com/ 网站底部二维码扫码加入）提供完整型号和需求，由官方确认可行性，不要刷写其他型号的 iRTU 包（型号不匹配会刷写失败甚至变砖）。
参考：Air8300 版本页 https://docs.openluat.com/exb/EXB_8000_CH390_1/version/ ，合宙文档站 https://docs.openluat.com/
36. Air780EHV可以用780EGH的固件吗？
解答： 结论：不可以。合宙固件按型号独立发布，即使版本号相同也不能混刷：Air780EHV 固件页与 Air780EGG/Air780EGH 固件页当前都发布到 V2050，但它们是不同型号的固件包，互相刷写可能直接刷写失败，或刷入后音频等功能异常甚至无法正常启动。Lua API 层面兼容只代表业务脚本可复用，不等于固件二进制通用。
原理（硬件差异）： 1. Air780EHV 内置 es8311 codec，并用 GPIO20 控制 codec 使能，可直接做录音/播放/TTS； 2. Air780EGG/EGH 内部不含 es8311，音频方案需外挂 codec（官方建议外挂 DA221/codec 时参照 EGG 的 I2C0、WAKEUP2 等接线），固件的器件配置与 EHV 不同； 3. 固件包与型号、硬件配置强绑定，升级校验会核对型号信息，版本号一致不代表包通用。
操作步骤：
1. 用 AT*I 或模组丝印确认手上设备的真实型号；
2. 只从该型号自己的固件页下载：EHV 走 https://docs.openluat.com/air780ehv/luatos/firmware/version/ ，EGG/EGH 走 https://docs.openluat.com/air780egh/luatos/firmware/780egg&780egh_version/ ；
3. 已经刷错导致不开机/识别异常时，使模组进入强制 BOOT（下载）模式，用 Luatools 重新烧录对应型号的正确固件恢复，下载全程不要断电；
4. 业务迁移时，Lua 脚本可在 API 兼容范围内复用，但音频相关的使能脚、codec 初始化和硬件必须按目标型号重配。
参考：Air780EHV 固件版本 https://docs.openluat.com/air780ehv/luatos/firmware/version/ ，Air780EGG/EGH 固件版本 https://docs.openluat.com/air780egh/luatos/firmware/780egg&780egh_version/ ，选型指南 https://docs.openluat.com/SelectionGuide/SelectionGuide/
37. 为什么进入深度休眠会卡住？把飞行模式那一行去掉就没事了
解答： 结论：你观察到的现象方向是对的——使用 PSM+ 深度休眠时，飞行模式由低功耗机制默认自行管理，应用层不需要、也不应再重复手动调用 mobile.flymode 关飞行模式；额外重复切换，或在唤醒回调里做阻塞操作，都会导致状态机冲突，表现为"进入深度休眠后卡住/唤不醒"。
原理：
1. PSM+ 深睡区间内协议栈近似关机，系统在需要时自行处理射频上下电与飞行状态，应用再插入一次 mobile.flymode 会与自管流程打架；
2. 唤醒在 LuatOS 中近似一次重启流程，若唤醒回调/唤醒后首个任务里有阻塞死循环、长时间同步 socket/Flash 操作或重复定时器未清理，也会表现成"卡住"；
3. PSM+ 下仍存在周期性 TAU（约 54 分钟一次，具体以网络侧配置为准）与下行可达窗口，业务时序要按这个特性设计。
排查步骤：
1. 删掉应用中自加的 mobile.flymode 调用，让 PSM+ 自行管理飞行模式，仅保留官方低功耗 demo 的标准配置；
2. 按 pm 库文档 https://docs.openluat.com/osapi/core/pm/ 与低功耗说明 https://docs.openluat.com/air780epm/luatos/app/lowpower/sleep/ 逐项检查锁（wake lock）是否成对释放、是否有外设/串口保持唤醒；
3. 审查唤醒回调和唤醒后任务：禁止回调阻塞，重操作放到独立 task 并分片 sys.wait()，清理不再需要的定时器；
4. 升级到该型号最新正式固件（历史版本有过低功耗相关修复，旧的 v2050 不一定是最新，以固件页为准）后复测；
5. 用日志记录"进入深睡—唤醒—回调返回"时间点，确认卡在哪个阶段；仍复现时带型号、固件版本、最小复现脚本和完整日志到合宙官方企业微信群（https://docs.openluat.com/ 网站底部二维码）支持。
参考：pm 核心库 https://docs.openluat.com/osapi/core/pm/ ，低功耗（休眠）说明 https://docs.openluat.com/air780epm/luatos/app/lowpower/sleep/
38. AT+POWERMODE="PRO"低功耗为什么降不下去，一直4毫安左右？
解答： 结论：AT 命令手册中 AT+POWERMODE="PRO" 模式的典型休眠电流约 1mA 量级；实测持续 4mA 左右通常不是 PRO 模式失效，而是外围条件、串口配置、控制电平、外部漏电或测量方法造成的，需逐项排查而不是只盯着电源模式指令。
排查步骤：
1. 电平参考：确认已设置 AT+VREF=0（按硬件实际 VREF 电路核对），错误的 IO 电平参考会增加漏电；
2. 串口：休眠相关测试把波特率降到 9600，并核对 AT+CFGRI 等 RI/唤醒配置，高波特率持续时钟和未关闭的串口收发会抬高底电流；
3. 休眠控制脚：检查 DTR、VBUS 等控制电平是否符合进入休眠的要求（USB 插着时 VBUS 常高可能阻止深睡，测试低功耗建议断开 USB、用独立电源在 VBAT 侧测量）；
4. 外设漏电：检查 GPIO 上下拉、外接传感器/LED/电平转换、卡座和电源走线，悬空或被外部上拉的管脚会产生漏电流；逐一摘除外设验证；
5. 网络侧：弱信号下设备会频繁重传、驻留困难，平均电流明显增大，换到信号良好处（用 AT+CSQ/AT+CESQ 确认）再测；
6. 固件与测量：升级到该型号最新正式 AT 固件；用高精度万用表/直流电源分析仪的电流量程串入 VBAT，采样足够长时间取周期平均，避开注网/TAU/上报脉冲窗口，并确认 PRO 设置已保存生效（查询当前 POWERMODE）。
参考：AT 命令手册（POWERMODE/低功耗章节）https://docs.openluat.com/atmozu/product/shouce/ ，通用功耗与测量说明 https://docs.openluat.com/common/airpower/ ，固件下载 https://docs.openluat.com/atmozu/product/firmware/
39. 收短信是不是有长度限制？长短信收不到
解答： 结论：不存在所谓"平台限制 1400 字节、后台已调整"的说法。短信长度遵循运营商标准：单条短信最多 160 个 7-bit 字符（英文/数字）；中文按 UCS2 编码，单条最多 70 个汉字。超过单条容量的长短信由发送侧和运营商网络自动分片下发，终端负责重组；收不到长短信，问题一般出在分片接收、存储区配置或新消息通知时序上。
原理与排查：
1. 编码确认：中文短信用 UCS2（AT+CSCS="UCS2"），单条 70 字；长短信每片有效载荷约 67 字，N 条分片由网络依次送达，模组需收齐全部分片才能重组；
2. 存储区：用 AT+CPMS? 检查并合理设置 ME/SM 存储区容量（如 AT+CPMS="ME","ME","ME"），存储区满会导致后续分片或整条长短信无法落库；
3. 新消息通知时序：核对 AT+CNMI（新消息提示方式）、AT+CSMS（选择消息服务）以及 URC 到达后 AT+CNMA（新消息确认）的响应时序，响应不及时或模式配置不当会丢片；
4. 发送侧与卡：确认对端/短信网关确实按长短信分片发送（部分私网/物联网卡或平台短信通道不支持长短信、不带头部分片标识），换手机对发、换普通卡交叉验证；
5. 网络与固件：分片到达有间隔，弱网下补齐时间更长，观察串口完整 URC；升级到该型号最新 AT 固件后复测，仍异常时抓 AT+CMGL 列表与完整日志反馈。
参考：短信 AT 指令（CSCS/CPMS/CNMI/CSMS/CNMA/CMGL 等）https://docs.openluat.com/atmozu/product/command/sms/ ，AT 命令手册 https://docs.openluat.com/atmozu/product/shouce/
40. AT^WAKEUPHEX设置了过滤字符串后，MQTT收到消息RI引脚不输出脉冲，是固件不支持这个字符串过滤功能吗？
解答： 结论：不是固件不支持。AT^WAKEUPHEX 对包含 MQTT（+MSUB 新消息 URC）在内的所有 URC 都生效，原"MQTT 不支持字符串过滤"的说法不正确。不输出脉冲通常是前置条件或匹配串格式不对：必须先使能 RI 唤醒（先 AT+CFGRI=1 并 AT+CFGRISAVE=1 保存），且过滤串必须是完整 URC 文本的 ASCII 十六进制，而不是明文。
原理：
1. AT^WAKEUPHEX 的匹配对象是模组实际打印出的 URC 字符串本身，MQTT 下行通知形如 +MSUB: ...，属于可匹配范围；
2. 匹配串取完整 URC 的 ASCII HEX，例如要匹配前缀 +MSUB:，其 HEX 为 2B4D5355423A（+=2B、M=4D、S=53、U=55、B=42、:=3A）；少字符、大小写不符或写成明文都会导致不匹配；
3. 只有 AT+CFGRI=1 且保存后，匹配命中才会在 RI 脚产生脉冲。
验证步骤（由简到繁）：
1. 先执行 AT^WAKEUPHEX="" 清空过滤串，仅保留 AT+CFGRI=1、AT+CFGRISAVE=1，发一条 MQTT 消息确认 RI 能产生脉冲，验证 RI 硬件通路和基础使能正常；
2. 再按完整 URC 文本计算 ASCII HEX，逐步加上过滤前缀（如 2B4D5355423A 对应 +MSUB:），用串口实际打印出的 URC 原文逐字符核对，不要凭想象拼写；
3. 确认 +MSUB 订阅和下行正常（先不做过滤时能稳定收到 URC），再开启过滤；
4. 保存配置后复位复测；用示波器/逻辑分析仪或万用表在脉冲期间抓 RI 电平；
5. 按上述步骤仍无脉冲时，记录型号、固件版本（AT*I）、完整串口 URC 原文和设置指令，到合宙官方企业微信群（https://docs.openluat.com/ 网站底部二维码）核实该型号固件的 WAKEUPHEX 行为。
参考：AT 命令手册（CFGRI/WAKEUPHEX 等章节）https://docs.openluat.com/atmozu/product/shouce/ ，MQTT AT 指令 https://docs.openluat.com/atmozu/product/command/mqtt/
41. 8202的G-sensor和8201的G-sensor参数一样吗？
解答： 结论：不能认为两者参数一样。当前 Air8202G（即 Air780EGG 配置）内置的是苏州明皜 DA221 三轴加速度计，经 I2C0 通信、WAKEUP2 接收运动中断，可用官方 exvib 扩展库直接驱动；而 Air8201 的 G-sensor 具体型号与参数官方未公开，没有公开资料证明二者相同，因此不能套用同一套参数。
Air8202G（DA221 + exvib）已公开的用法：
1. 三应用模式：exvib.open(mode)，mode=1 微小震动检测（量程 2g，如敲击桌面）、mode=2 运动检测（量程 4g，行车/走路跑步）、mode=3 跌倒检测（量程 8g）；
2. exvib.read_xyz() 读取 x/y/z 三轴数据（静止时存在噪声属正常），exvib.close() 关闭；中断脚固定为 gpio.WAKEUP2，可配合 gpio.debounce 做防抖；
3. 内置 DA221 的型号包括 Air780EGG/EGP、Air8000A/D/U/N/DB/AB 等；早期 EGP 配置可能存在差异，以实物 AT*I 与该批次硬件为准。
核实步骤：
1. Air8202G 按 exvib 文档开发即可：https://docs.openluat.com/osapi/ext/exvib/ ；
2. Air8201 不要直接照搬 DA221 参数，先用 AT*I、板子丝印和随附硬件资料确认传感器型号，若公开资料中没有，到合宙官方企业微信群（https://docs.openluat.com/ 网站底部二维码）凭具体批次确认；
3. 若为外接加速度计（如在 EGH 上外挂），官方建议同样使用 I2C0 和 WAKEUP2（EGH 对应 PIN79 USIM_DET），以便无缝使用 exvib。
参考：exvib 扩展库 https://docs.openluat.com/osapi/ext/exvib/ ，Gitee demo（gsensor/vibration）https://gitee.com/openLuat/LuatOS/tree/master/module
42. 这个设备能上自研平台吗？
解答： 结论：可以。LuatOS/OpenCPU 设备不绑定合宙平台，可通过标准协议接入你自己的自研服务器平台：支持 MQTT、HTTP/HTTPS、TCP/UDP、WebSocket 等，云端只要提供对应协议的 Broker/API 即可对接，数据格式由应用层自定义。需要说明的是，官方开源的是 LuatOS 框架、库与 demo（在 Gitee），不承诺"全部源码给你"；基于设备的定制业务开发属于商务合作范畴。
对接步骤： 1. 确定协议：弱网/长连接/下行控制优先 MQTT，周期上报可用 HTTP/HTTPS，自定义二进制协议用 TCP/UDP； 2. 参考官方 demo 开发，MQTT 示例见 https://gitee.com/openLuat/LuatOS/tree/master/module/Air8000/demo/mqtt （各产品目录下还有 socket/http 等 demo）； 3. 在自研平台侧实现对应服务（如 MQTT Broker、鉴权、Topic 规划、QoS 与心跳策略），设备端配置你自己的服务器地址/端口/ClientID/账号密码； 4. 处理好断线重连、重连后重新订阅、异常补发与 TLS/CA 证书（HTTPS/MQTTS），并在服务器侧记录设备上下线与消息日志； 5. 开发方式上可借助合宙官方 Trae + luatos-docs-code 智能体基于官方库和 demo 生成业务代码；若需官方承接完整定制开发，通过合宙商务或官方企业微信沟通需求与交付边界。
参考：LuatOS 代码仓库（module/demo）https://gitee.com/openLuat/LuatOS/tree/master/module ，MQTT demo https://gitee.com/openLuat/LuatOS/tree/master/module/Air8000/demo/mqtt ，API 文档 https://docs.openluat.com/osapi/
43. Air8000A mqtt传输数据丢数据，有核心库MQTT的源码吗？
解答： 结论：MQTT 核心库是开源 C 组件 libemqtt，源码就在 LuatOS 官方仓库；但"丢数据"绝大多数是 QoS/时序/弱网/服务端处理问题，而不是库源码缺陷，应先按可靠性链路排查，再决定是否需要读源码。
源码与文档位置： 1. C 核心库源码（libemqtt）：https://gitee.com/openLuat/LuatOS/tree/master/components/network/libemqtt/ ； 2. Lua 层用法与 demo： https://gitee.com/openLuat/LuatOS/tree/master/module/Air8000/demo/mqtt/ ； 3. MQTT 应用教程（Air780EPM，API 与排查思路通用）：https://docs.openluat.com/air780epm/luatos/app/socket/mqtt/ 。
丢数据排查步骤：
1. QoS：不能丢的消息发布和订阅都用 QoS1 或 QoS2，QoS0 只发一次、无确认，弱网必丢；
2. CONNACK 门控：必须等连接真正建立（CONNACK 成功）后再发订阅和发布，避免在连接未完成时丢消息；
3. 心跳：keepalive 按网络环境合理设置，及时发现半开连接；
4. 重连订阅：断线重连成功后必须重新 SUBSCRIBE，并在重连期间把待发消息本地缓存，连上后补发；
5. 发布确认与应用 ACK：以 PUBACK（QoS1）作为送达依据，必要时在业务层做应用应答、序号去重和 Broker 离线消息/持久会话；
6. 交叉定位：在 Broker 侧查看日志确认消息是否到达、QoS 与客户端 ID 是否冲突，弱信号位置用 AT+CSQ 等评估网络；用最小 demo 复现，逐步加业务，确认丢在哪一段后再去对照 libemqtt 源码。
参考：libemqtt 源码 https://gitee.com/openLuat/LuatOS/tree/master/components/network/libemqtt/ ，MQTT demo https://gitee.com/openLuat/LuatOS/tree/master/module/Air8000/demo/mqtt/ ，MQTT 教程 https://docs.openluat.com/air780epm/luatos/app/socket/mqtt/
44. Air8202的运动传感器是几轴的？
解答： 结论：当前 Air8202G（Air780EGG 配置）内置的运动传感器是 三轴加速度计（G-sensor），型号为苏州明皜 DA221，经 I2C0 与主控通信，运动中断接 WAKEUP2，可用于震动、运动和跌倒检测。
使用说明：
1. LuatOS 下用官方 exvib 扩展库驱动：exvib.open(mode) 中 mode=1 微小震动（量程 2g）、mode=2 运动检测（量程 4g）、mode=3 跌倒检测（量程 8g）；exvib.read_xyz() 读取 x/y/z 三轴数据，exvib.close() 关闭；
2. 中断脚固定为 gpio.WAKEUP2（默认双边沿），可配合 gpio.debounce 防抖，完整示例见 Gitee Air8000 产品目录 demo/gsensor/vibration；
3. 官方明确 DA221 在 LuatOS 上仅支持运动检测这一类功能（震动/运动/跌倒、配合 GNSS 做震动定位），其它传感器功能需自行研究；
4. 注意按具体配置区分：Air8201 的传感器参数官方未公开，早期 EGP 配置可能不同，以实物 AT*I 和批次硬件资料为准。
参考：exvib 扩展库 https://docs.openluat.com/osapi/ext/exvib/ ，Gitee demo https://gitee.com/openLuat/LuatOS/tree/master/module
45. Air8202电池能工作多久？
解答： 结论：Air8202 产品页明确其不含电池，官方也没有公布统一的电池容量或续航数字，因此不存在一个可直接照抄的"能用多久"。续航取决于你选配电池的有效容量、自放电和整个业务周期的平均电流，必须实测；可先按下式估算再用实测修正：
工作时长 t ≈ 电池有效容量 × 放电/转换效率 ÷ 一个业务周期的平均电流
估算与实测步骤： 1. 拆分业务周期：把深睡时长/深睡电流、定时唤醒、GNSS 定位时长、注网/TAU、MQTT/HTTP 上报时长与发射峰值电流逐段列出，按时间加权得到周期平均电流； 2. 代入上式估算（注意容量单位统一为 mAh、电流为 mA，结果为小时），并对低温、电池老化（有效容量打折）留 30% 以上余量； 3. 实测为准：用直流电源分析仪/高精度电流表串入电池回路，跑完整业务周期测平均电流，再用真实电池跑寿命验证，弱信号下发射与重传会显著拉低续航； 4. 充电管理：Air8202 板载充电管理 YH2712A，可按电池类型设置 4.2V（普通锂电）/4.35V（高压电芯）充电上限，选配电池要与该设置一致，避免过充； 5. 选型与续航优化可参考选型指南和通用功耗文档，并在官方企业微信群就具体电池配置确认。
参考：Air8202 产品页 https://docs.openluat.com/air8202/product/ ，通用功耗说明 https://docs.openluat.com/common/airpower/ ，选型指南 https://docs.openluat.com/SelectionGuide/SelectionGuide/
46. At固件中底层的升级包只能用差分升级？不支持整包覆盖升级吗？
解答： 结论：要区分升级通道。远程 FOTA 升级只支持 dfota.bin 差分包（平台下发或自建 HTTP 服务器，由 AT+UPGRADE 触发，差分包与设备当前版本和型号严格对应）；但本地升级并非只能差分——通过 Luatools 或合宙量产烧录工具走 USB，可以用整包固件直接覆盖烧录，并可按需勾选"清 KV""清 FS"。因此"只能差分、必须分多次升级"的说法不成立。
操作步骤：
1. 远程升级（量产设备）：在 iot 平台或自建 HTTP 上使用与设备型号、当前基线匹配的 dfota 差分包，型号必须一致，升级全程不断电；远程通道不能用整包；
2. 本地升级（研发/售后/救砖）：用 USB 连接，打开 Luatools 或量产烧录工具，使模组进入下载模式，选择该型号完整固件整包烧录即可覆盖，无需逐级差分；
3. 需要恢复出厂状态时，在烧录工具中按需勾选清 KV（参数区）/清 FS（文件系统），注意会清除相应业务数据；
4. 跨大版本或型号变更时，优先用本地整包方式刷到目标版本，之后再走远程差分包；
5. 固件一律从该型号官方固件页获取，型号不可混刷，烧录前记录 AT*I 版本与 IMEI。
参考：AT FOTA 说明（dfota 差分包/AT+UPGRADE）https://docs.openluat.com/atmozu/product/command/fota/ ，量产烧录工具 https://docs.openluat.com/common/Luat_productiontool/ ，Luatools https://docs.openluat.com/common/Luatools/
47. 780EPM模块联网很慢，大概35秒，查看日志发现dtu.openluat.com请求返回code 99操作失败，是什么问题？
解答： 结论："code 99"在官方 AT 手册和 iRTU/DTU 平台公开文档中没有对应错误码定义，不能据此判定为平台故障，"后台已修复""把设备放到未分组规避"也没有官方依据。该请求是设备向 iRTU/DTU 配置服务拉取配置，失败应分两层排查：先解决模组本身联网慢，再核对平台地址、订单与设备归属、配置拉取日志。
排查步骤：
1. 基础注网：用 AT+CPIN?（READY）、AT+CEREG?（stat=1/5）、AT+CSQ/AT+CESQ、AT+CGATT?（1）依次确认 SIM、注册、信号、附着；弱场或天线不良会把注网拉长到数十秒；
2. APN/PDP：公网卡自动获取，专网卡按运营商配置 APN（AT+CGDCONT?/AT+CPNETAPN 等），确认拿到 IP、DNS 正常；
3. 连通性：激活 PDP 后用 PING/HTTP 访问 dtu.openluat.com，排查 DNS 解析和到服务器 80/443 的连通性，必要时更换网络/SIM 交叉验证；
4. 平台地址：iRTU 配置服务自 2026-07-07 起永久免费，并注意区分新平台 iRTU.openLuat.com 与老平台 DTU.openLuat.com，确认固件/配置中填的地址与你在平台创建项目、添加设备所用的平台一致；
5. 订单与归属：登录 iot/crm 核查该 IMEI 的订单、设备归属和项目分组是否正确（归属不对可能拉不到配置），核对设备拉取配置时上报的识别信息；
6. 日志取证：保留完整串口日志（注网到请求返回全过程）和平台侧配置拉取记录，若基础联网正常、地址与归属无误仍持续返回 code 99，带 IMEI、固件版本（AT*I）和时间点到合宙官方企业微信群（https://docs.openluat.com/ 网站底部二维码）由技术支持结合后台日志定位。
参考：AT 命令手册（SIM/APN/联网排查）https://docs.openluat.com/atmozu/product/shouce/ ，设备归属 https://docs.openluat.com/air780epm/product/attributioniot/ ，合宙文档站 https://docs.openluat.com/