常见问题 - 2026-10-09

数据日期：2026-10-09

1. Air780E和Air780EPM（或EHM/EHV）是否pin to pin，固件和程序能否通用？

解答： 结论：不是 pin to pin，两者属于不同硬件平台，内核固件不通用，不能互烧对方的底层固件；用 CSDK 开发的 780EPM 程序也不能直接跑在 780E 上，换型时脚本里还要注意引脚差异。说明：Air780E 基于 EC618 平台，Air780EPM/EHM/EHV 基于更新的 EC7xx 平台，Flash/RAM、外设与管脚定义都有差异，因此内核固件按平台分别编译、跨平台不通用。官方专门出过《Air780E vs Air780EP/Air780EPS vs Air780EPM/Air780EHM vs Air780EHN/Air780EHU vs Air780EHV vs Air780EGH 九款模组管脚对比》说明兼容性；LuatOS 脚本层 API 大体一致，但引脚映射不同，换型必须重新对脚。注意该对比表在网页上以图片/注释形式呈现，实际以官方 GPIO 复用表（xlsx）配合 Luatools 管脚配置为准。处理步骤： 1. 换型前先下载目标型号的产品手册与管脚对比资料，逐脚核对。 2. 固件必须使用目标型号所属平台的正式固件，严禁跨平台互烧。 3. 脚本中的 GPIO、串口、电源等引脚定义按新板重新配置，并在实机上实测。参考文档：Air780E vs Air780EHM 等九款模组管脚对比 https://docs.openluat.com/air780epm/product/air780exx/ ；合宙选型指南 https://docs.openluat.com/SelectionGuide/SelectionGuide/ 。

2. Air780EGP/780EGH是否支持AT指令？想要低功耗和定位又需要AT该用哪个型号？

解答： 结论：Air780EGP/EGH 这类 LuatOS 智能模组不支持 AT 指令开发；如果需要 AT 方式，可选 4G+定位二合一 AT 模组 Air780EG2，但 EG2 不带 G-sensor。说明：Air780EGP/EGG/EGH 属于 LuatOS 可二次开发模组（内置 4G + GNSS，用 Lua 脚本开发），不提供 AT 指令集；Air780EG2 是官方定义的“4G + 定位二合一 AT 模组”，内置 GNSS、支持 8 路带 TLS 加密的 Socket，规格说明里没有 G-sensor。G-sensor 用于抑制静态漂移，只有 Air780EGG/Air780EGP 这类 LuatOS 型号内置。处理步骤： 1. 先明确项目是否必须用 AT 开发方式。 2. 必须是 AT → 选 Air780EG2；需要 G-sensor 抗静态漂移 → 选 Air780EGG/EGP（LuatOS）。 3. 选型不确定时用合宙选型指南，或官网右下角 AI 助手按需求筛选。参考文档：合宙选型指南 https://docs.openluat.com/SelectionGuide/SelectionGuide/ 。

3. Air780ER3是否支持LBS基站定位？

解答： 结论：支持，LBS 基站定位是 Air780ER3 自带的能力之一。说明：Air780ER3 属于 Air780ER2/ER3 系列，支持 LBS 基站定位。LBS 通过运营商基站信息辅助定位，在室内或 GNSS 失锁场景可作为补充，但精度明显低于 GNSS，通常用于“能定位即可、不要求高精度”的场合。具体调用方式以对应固件与 LBS 说明为准。处理步骤： 1. 确认模组固件已集成 LBS 能力。 2. 按 LBS 定位说明调用、读取返回的基站定位结果。 3. 室内优先 LBS、室外优先 GNSS，两者互补使用。参考文档：Air780ER2/ER3 产品资料 https://docs.openluat.com/air780er2/product/ 。

4. eSIM/贴片卡是否支持BIP协议，能否用eUICC/RSP方案？

解答： 结论：不支持。合宙模组只支持已经开通好的贴片 SIM 卡，本质上与插拔卡无区别，不支持 eUICC/RSP 方案。说明：合宙的“贴片卡”是把普通 SIM 芯片直接焊在板上（MFF2 封装），走的仍是普通 SIM 接口与运营商网络，出厂即已开通，功能与插拔卡一致，不涉及 eUICC 远程配置（RSP）能力，也不使用 BIP 协议（BIP 属于 SIM 应用工具箱 STK 相关能力）。因此需要动态切换运营商配置文件的 eUICC/RSP 场景，当前模组方案不支持。处理步骤： 1. 只需固定运营商上网 → 直接按流量需求选用对应贴片卡。 2. 需要 eUICC/RSP 动态切换 → 需单独定制或另选带 eSIM 的方案，请与合宙对接确认。参考文档：请通过合宙对接确认（当前公开文档未收录 eUICC/RSP 相关说明）。

5. Air780EPM固件中mqtt.create的verify=0无法跳过服务器证书校验，哪个版本支持彻底跳过证书校验？

解答： 尚未解答

6. 模组的TLS握手被服务器Reset，日志报net_lwip_tcp_err_cb error -14，如何处理？

解答： 尚未解答

7. Air8000播放mjpg视频卡住，报videoplayer decode failed及frame decode failed，是内存不够吗？

解答： 结论：不一定只是内存不够。decode failed / frame decode failed 表示解码链路在某一帧失败，官方建议把完整报错（含错误码 -2/-3）结合 AI 助手与 LuatOS 源码一起分析，先定位是解码器、文件本身还是资源不足。说明：videoplayer 在 Air8000 上支持多媒体播放（含 MJPEG 视频），报错出现在解码阶段。常见原因包括：MJPEG 文件编码不被支持或帧损坏、分辨率/帧率超出播放能力、脚本区或 PSRAM 资源不足、文件读取（fatfs/SD 卡）异常。错误码 -2/-3 的具体含义需对照库源码判断，不宜直接归因为内存。处理步骤： 1. 用官方 demo 在开发板上播放官方示例视频，先排除硬件与基础环境问题。 2. 换一段标准 MJPEG 文件对比，确认是否与特定文件有关。 3. 记录完整日志（含 -2/-3 的上下文）、视频分辨率与帧率。 4. 结合 AI 助手 + LuatOS videoplayer 源码定位；仍无解时把日志交 FAE。参考文档：videoplayer 应用文档 https://docs.openluat.com/air8000/luatos/app/multimedia/ui/videoplayer/ 。

8. httpplus上传文件实际成功但提示HTTP请求超时，是什么原因？

解答： 结论：这是 httpplus 库对响应头 Content-Length 大小写敏感导致的已知问题——服务器返回小写 content-length 时库识别不到，于是一直等待到超时；官方已确认修复。说明：按 HTTP 规范，头字段名大小写不敏感，但库的早期实现只匹配了标准写法 Content-Length，遇到小写 content-length 就取不到长度、无法判断响应结束，于是出现“文件实际已上传成功却报 HTTP 请求超时”的现象，属库的兼容性缺陷，不是上传真的失败。处理步骤： 1. 升级到已修复该问题的固件/库版本。 2. 无法立即升级时，可让服务端统一返回标准大小写的 Content-Length 规避。 3. 升级后复测同一上传流程，确认不再误报超时。参考文档：httpplus 扩展库文档 https://docs.openluat.com/osapi/ext/httpplus/ 。

9. Air8000的2042版本固件官方下载怎么不见了，是有大问题吗？

解答： 结论：该版本联网存在问题，不建议继续使用；请改用官方最新正式固件——Air8000 当前最新为 V2052 系列。说明：版本从“最新版本”入口下架，通常是因为该 build 存在影响功能的问题（如联网异常），官方会以更新的正式版本替代。Air8000 正式固件以固件页“最新版本”为准，历史版本仍可在“所有版本”目录中查阅，但量产应用应使用最新正式版。处理步骤： 1. 打开 Air8000 固件页，下载最新正式固件（当前为 V2052 系列）。 2. 重新烧录后，在自有业务脚本上做一次回归。 3. 若确需复现旧版本问题，保留旧固件与完整日志交 FAE。参考文档：Air8000 LuatOS 固件版本 https://docs.openluat.com/air8000/luatos/firmware/ 。

10. 4G模块如何实现转WiFi或USB给电脑上网？有相关例子吗？

解答： 结论：可以实现。Air780EPM 等模组支持通过 RNDIS 把 4G 网络以“USB 网卡”形式共享给电脑上网；要实现 WiFi 上网则需外挂 WiFi 器件或选自带 WiFi 的型号。说明：RNDIS 方案由模组侧起一路 USB 网卡，电脑识别为网卡后即可走 4G 上网，官方提供了现成的 rndis 应用示例。需要别的设备经 WiFi 上网时，模组本身不带 WiFi 射频，应外挂 WiFi（如 Air6205 等）或直接选用自带 WiFi 的方案（Air8000/Air8101 系列）。处理步骤： 1. USB 共享 → 参考 RNDIS 应用文档跑通 demo，电脑侧确认识别到 RNDIS 网卡并设为默认路由。 2. WiFi 共享 → 选自带 WiFi 的型号或外挂 WiFi 器件，按对应产品文档接入。 3. 共享不稳定时先查供电与 USB 线材质量。参考文档：RNDIS 应用示例 https://docs.openluat.com/air780epm/luatos/app/common/rndis/ ；Air8000 产品页 https://docs.openluat.com/air8000/product/ 。

11. 合宙是否提供便宜的流量卡/eSIM卡？最多多少流量？

解答： 结论：有。合宙提供物联网流量卡（插拔卡/贴片卡），常见 30M/月每年含税 2.9 元档；原口径还给出“最多 200M/月、含税 4.9 元”档，具体资费以购买页/对接销售的最新公示为准。说明：流量卡按“月流量 + 年限”组合计费，支持按年或多年购买、到期续费。不同渠道、不同年份公示价可能调整，例如 Air8781P 系列文档中另有“30M/月 2.9/1 年、4.9/3 年”“100M/月 3.9/1 年、6.9/3 年”等档位。最终以下单页面或对接销售的现行报价为准。处理步骤： 1. 先明确单设备月流量与续费年限需求。 2. 到合宙官方店铺或联系对接销售确认现行档位与价格。 3. 批量采购前先小批量验证网络与平台。参考文档：Air8781P 系列型号与流量卡资费说明 https://docs.openluat.com/air8781p/product/ 。

12. 有没有LORAWAN的4G方案，LORAWAN可接的模组？

解答： 结论：有。LuatOS 提供 lora2 核心库，可挂载 LoRa 模组实现 LoRa 通信，配合 4G 模组即可组成“LoRa 汇聚 + 4G 回传”的方案。说明：lora2 核心库支持多设备挂载，当前仅支持 LLCC68、SX1268 两款主流 LoRa 芯片；LoRa 是半双工，发送时无法同时接收，组网时要注意时序。官方文档以 Air780EGP/EGG/EGH 核心板 + LoRa 模块做收发演示，可参考其接线与配置。处理步骤： 1. 选 LLCC68/SX1268 芯片的 LoRa 模块。 2. 按 lora2 库文档接线并跑通收发 demo。 3. 汇聚侧用 4G 模组上行到服务器。 4. 若需要标准 LoRaWAN 协议栈（而非点对点 LoRa），请与合宙对接确认方案。参考文档：lora2 驱动文档 https://docs.openluat.com/air780egh/luatos/app/driver/lora/ 。

13. 哪里能看到Air8000W各种固件区别的文档？

解答： 结论：见 Air8000W Engine 的固件页，里面有默认出厂固件下载与版本说明；也可在 docs.openluat.com 右下角问 AI，获取带链接的详细解答。说明：Air8000W 的 Engine 固件按屏幕尺寸/分辨率等有不同 build（如 4 寸 320×480 版本），页面分“最新版本”与“所有版本”两块，便于按整机配置选择。固件命名里带 LuatOS-SoC 版本号与屏幕参数，可据此区分。处理步骤： 1. 打开 Air8000W Engine 固件页，下载与整机屏幕匹配的版本。 2. 需要对比版本差异时，结合页面说明与官网 AI 助手。 3. 量产前在自有整机上回归验证。参考文档：Air8000W Engine 固件页 https://docs.openluat.com/air8000/product/air8000w_engine/firmware/ 。

14. Air1780P的低功耗睡眠电流大约多少？

解答： 结论：官方暂无实测数据，需要实测；可参考 Air1780P 与 Air780EPM 同源的关系估算，但最终以实测为准。说明：Air1780P 是基于 Air780EPM 改版的 MCU 模组（去掉 4G 功能、管脚与原版兼容），功耗特性与 EPM 相近，但没有了蜂窝发射的瞬时大电流，睡眠电流要按实际固件与外设（LED、看门狗等）配置实测得到。处理步骤： 1. 用最新固件、按目标业务配置进入睡眠/低功耗模式。 2. 用高精度电流表或功耗分析仪实测 VBAT 电流。 3. 逐一关断外设（LED、外置狗、上拉电阻）定位漏电路径。 4. 实测结果与合宙对接确认。参考文档：Air1780 产品页 https://docs.openluat.com/air1780/product/ 。

15. 点阵屏是否有休眠模式，休眠功耗和IO状态如何，I2C总线低功耗怎么处理？

解答： 结论：点阵屏设置“不显示”即为休眠模式；其具体 IO 状态与休眠功耗需向屏的驱动厂家确认。I2C 总线工作时所有挂在该总线上的设备都必须上电，否则会拉低总线导致通讯失败。说明：点阵屏（如 u8g2 驱动的 OLED/LED 点阵）一般通过关闭显示进入低功耗，但不同屏的休眠电流与 IO 默认电平各不相同，官方无法给出统一值。I2C 是开漏总线，只要有一个挂载器件断电，其 IO 就可能把总线拉低，导致整条 I2C 通讯失败。处理步骤： 1. 屏的休眠电流与 IO 状态向驱动厂家索取规格书。 2. 低功耗设计建议：G-sensor、气压计等一组常电；点阵屏用独立可控电源 + 独立 I2C，避免互相拉低。 3. 不需要显示时下发“关闭显示”指令进入休眠。 4. 实测整机休眠电流验证效果。参考文档：u8g2 点阵屏应用文档 https://docs.openluat.com/air780epm/luatos/app/multimedia/ui/u8g2/ 。

16. Air8784的底噪/回音抑制效果如何？

解答： 结论：底噪会有一点但不明显、不影响通话质量，后续会继续优化；回声抑制效果取决于实现方式，软件实现的效果比较满意。说明：Air8784 是基于 Air780EHM 与合宙自研语音芯片设计的 SIP 对讲方案，官方口径是回声抑制接近零回声，回采（AEC 参考）与声学设计出厂即调好。实际底噪与回声表现同喇叭/麦克风的布置、音量、外壳腔体与供电稳定性密切相关。处理步骤： 1. 按官方参考设计的声学布局搭（喇叭与 MIC 位置、增益、走线）。 2. 用一对设备实打一遍，重点听对端是否能听到自己的声音。 3. 底噪或回声异常时，先查音频接线、供电稳定性与音量设置。参考文档：Air8784 产品页 https://docs.openluat.com/air8784/product/ 。

17. 8784设备和手机直接通话如何实现，是否要插SIM卡？

解答： 结论：分两种链路：纯 SIP 的设备↔设备（或设备↔软终端）通话，插物联网卡即可（走 4G 数据流量）；要与普通手机（蜂窝电话）直接通话，属 SIP_CC 桥接场景，设备里必须插一张已实名、开通 VoLTE 的手机卡，设备做音频桥接。说明：SIP_CC（phone 分支）把 SIP 侧与蜂窝电话侧桥接起来，设备相当于一个网关；物联网卡只能上网、不能打普通电话，所以 CC 场景必须有可通话的手机卡。SIP 侧账号约定：服务器 cc.luatos.com、端口 8910/UDP、密码 123456，设备账号为 IMEI+0、对端软终端为 IMEI+1。处理步骤： 1. 设备↔软终端 → 建 pair 任务（目标选“本机对端账号”），插物联网卡即可。 2. 与普通手机通话 → 建 phone（SIP_CC）任务，插实名且开通语音的手机卡。 3. 在 sip.luatos.com 控制台配置任务并点“检查并下发”。 4. 按设备 SOS 发起呼叫，长按 UP 挂断。参考文档：Air8784 出厂固件使用说明 https://docs.openluat.com/air8784/software/default_factory_firmware/ 。

18. 如果有两个8784设备，能否向同一个软终端/手机拨号？

解答： 结论：按当前版本口径还不支持，同一时刻只有一个能接通，群组功能仍在开发中。说明：控制台目前提供“双设备互通（pair，单目标）”“多设备轮拨（round，最多 3 个目标、30 秒未接听顺延）”“群组通话”等场景入口，但“多个设备同时向同一软终端/手机拨号并全部接通”这种群组能力尚未完成，实机行为以当前固件版本为准。处理步骤： 1. 需要顺序呼叫多目标 → 用“多设备轮拨”，首个目标接通后不再继续拨后续目标。 2. 需要真正多方同时在线 → 等群组功能发布，或提前与合宙对接定制。 3. 具体能力以实机固件版本为准。参考文档：Air8784 出厂固件使用说明 https://docs.openluat.com/air8784/software/default_factory_firmware/ 。

19. Air8784有没有完整的设置全流程攻略（图文和视频教程）？

解答： 结论：有。图文教程见 Air8784 软件资料（总览 + 出厂固件使用说明 + 下载调试），视频教程见 B 站。说明：Air8784 的完整流程（登录控制台、SIP 账号约定、四类场景配置、任务下发、实机拨测）都写在软件资料里。注意原答给出的 air8784_firmware_manual 链接已随官方文档改版失效，现应指向 software 目录下的页面。处理步骤： 1. 先看软件资料总览，了解资料结构。 2. 按“出厂固件使用说明”一步步配置任务。 3. 用“下载和调试”页完成烧录与日志查看。 4. 配合 B 站视频教程理解操作。参考文档：Air8784 软件资料 https://docs.openluat.com/air8784/software/ ；Air8784 产品页 https://docs.openluat.com/air8784/product/ 。

20. 项目需要4G Cat1+gps定位的模组，有推荐吗？

解答： 结论：推荐 Air780EGP（4G + 定位二合一，4MB Flash+RAM，性价比高）；也可选 Air8780G（基于 Air780EGP 设计的 4G + 定位二合一方案）。资料都在 docs.openluat.com。说明：Air780EGP 是 4G + GNSS 二合一模组，内置 G-sensor 抑制静态漂移；Air8780G 基于 Air780EGP 设计，同为 4G + 定位二合一。若项目还需要音频能力，EGP 因只有 4MB 资源不支持 Audio，需改选 8MB 的 Air780EGG/Air780EGH。处理步骤： 1. 用选型指南确认定位精度、内存、是否需要音频等需求。 2. 打开对应产品页下载手册与固件。 3. 若必须用 AT 方式，则另选 Air780EG2。参考文档：Air780EGH/EGG/EGP 产品资料 https://docs.openluat.com/air780egh/product/ ；合宙选型指南 https://docs.openluat.com/SelectionGuide/SelectionGuide/ 。

21. 使用4G Cat1模组仅控制一个继电器，有推荐便宜的模组吗？

解答： 结论：可看 Air8781P1。它是 Air8781P 系列中“无板载 DCDC、有看门狗 + LED 状态灯”的型号，价格亲民，搭配 LuatOS-iRTU 面向串口透传/GPIO 控制（如拉继电器）场景。说明：Air8781P 系列面向串口透传场景，可搭配 LuatOS-iRTU 实现透传与 GPIO 控制。系列按是否板载 DCDC/看门狗/LED/贴片 SIM 细分为 P1~P4。仅控制一个继电器这类简单需求，选 P1（19.9 元档）即可。处理步骤： 1. 确认项目是否需要板载 DCDC 与硬件看门狗。 2. 按需求在 P1/P2/P3/P4 中选型。 3. 用 iRTU 配置串口透传与 GPIO 动作。参考文档：Air8781P 系列型号说明 https://docs.openluat.com/air8781p/product/ 。

22. Air8202是否支持一次性电池（不可充电电池）长期户外使用？Air8202T出了吗？

解答： 结论：Air8202 目前只支持可充电电池（官方整机配 18500 锂电池）；一次性电池电压太低，当前 8202 不支持；Air8202T 尚未推出。说明：Air8202C/G 板上采用充电管理 + 可充电锂电池（默认 2000mAh、充电电流 500mA），供电架构面向可充电电池设计。一次性锂电（如锂亚电池）电压平台与放电特性不同，无法匹配其供电/充电设计，因此不能直接替代。处理步骤： 1. 若必须用一次性电池做长期户外应用 → 需与合宙对接评估或改用适配的供电方案。 2. 常规应用按官方配置使用可充电锂电池。 3. 关注后续型号（Air8202T）的发布情况。参考文档：Air8202 产品页 https://docs.openluat.com/air8202/product/ 。

23. Air8000A定位精度不准、有数据漂移是什么原因？

解答： 结论：99% 是 GNSS 天线不佳导致。建议先确认天线与 CN 值（信噪比），再排查定位环境。说明：GNSS 定位精度高度依赖天线性能与安装环境。有源天线的供电范围（开发板内置 3.3V LDO，仅支持 3.3V 有源天线）、馈线损耗、天线朝向与遮挡都会直接影响 CN 值和定位漂移。CN 值越大代表信号越好。处理步骤： 1. 读取并观察 CN 值，判断信号质量。 2. 确认天线类型与供电匹配，检查接头与馈线是否良好。 3. 到户外开阔处、天线朝上做对比测试。 4. 需要抑制静态漂移时，选内置 G-sensor 的型号。参考文档：Air8000 GNSS 应用文档 https://docs.openluat.com/air8000/luatos/app/gnss/gnss/ ；GNSS 硬件设计指导 https://docs.openluat.com/air8000/luatos/hardware/gnss/ 。

24. 合宙MQTT有测试用的服务器吗？

解答： 尚未解答

25. 阿里云IOT升级用的差分包如何制作（724UG Lua平台）？

解答： 结论：可在合宙云平台的小工具里制作。说明：差分包用于 FOTA 升级，必须与目标固件严格对应——合宙固件差分升级只能在同类固件之间进行（固件 1 只能差分升级为固件 1）。用官方工具生成可避免包体不匹配。处理步骤： 1. 登录合宙云平台 https://iot.openluat.com/cloud/main 。 2. 在云平台的小工具中，按固件版本生成差分包。 3. 将差分包上传到阿里云 IoT 平台用于 FOTA 升级。 4. 升级前确认现网固件与差分包属同一类固件。参考文档：合宙云平台 https://iot.openluat.com/cloud/main 。

26. Air510W等型号非质量问题是否可退换？批量采购前要不要先测试？

解答： 结论：非质量问题不退货不换货；建议批量采购前先小批量测试，验证网络与功能后再放量。说明：这属于商务/售后事项，不在技术文档管辖范围内。技术侧能提供的是：确认型号、封装、频段与整机需求是否匹配，以及做必要的小批量验证。处理步骤： 1. 批量前先取小批量样机，实测网络与功能。 2. 核对型号、封装、频段与整机设计是否匹配。 3. 退换与售后规则按购买渠道/对接销售的口径执行。参考文档：无（属商务/售后事项，请通过购买渠道或对接销售确认）。

27. Air780EHT订货后用新固件，对已有的AT指令MQTT连接和电路代码有影响吗？

解答： 结论：AT 指令层面没有影响。说明：Air780EHT 是 AT 开发方式的模组，AT 指令集保持兼容；更新固件通常只在功能与稳定性上做增强，既有的 AT 指令用法与流程不受影响。电路代码同样不受固件版本影响，因为固件不会改变硬件接口定义。处理步骤： 1. 直接烧录新版固件。 2. 用原有 AT 流程回归一次 MQTT 连接，确认正常。 3. 若遇到行为差异，记录固件版本与 AT 指令日志交 FAE。参考文档：合宙选型指南（Air780EHT 说明）https://docs.openluat.com/SelectionGuide/SelectionGuide/ 。

28. Air8000开发板开启WiFi或RJ45时电话拨入模组会死机重启，是什么原因？

解答： 结论：大概率是供电能力不足导致，先保证供电再排查。说明：同时开启 WiFi/RJ45 等外设时整机电流需求上升，若供电（尤其 USB 供电或电源路径）能力不足、VBAT 跌落，会触发模组异常复位；4G 发射本身有毫秒级脉冲电流，叠加外设后更易掉电。电话拨入瞬间往往正是电流快速变化的时刻。处理步骤： 1. 换用能力足够的稳压电源（VBAT 3.8V、持续 ≥1A、瞬态 ≥2A），就近并联大容量低 ESR 电容。 2. 用示波器观察拨入瞬间 VBAT 是否跌落。 3. 逐个开启外设，定位是哪一路把电流抬高。 4. 仍复现则保留完整日志交 FAE。参考文档：Air8000 产品页 https://docs.openluat.com/air8000/product/ 。

29. Air724UG模块不上线，同事说要续费，怎么操作？

解答： 尚未解答

30. 模块和芯片从合宙购买是否有二手货？贴片后出现故障如何排查？

解答： 结论：从合宙购买的均为新芯片，没有二手货；贴片后出现连续故障更可能是焊接或元器件贴错问题，建议重新焊接排查。说明：合宙官方渠道出货均为新品。模组/芯片在 SMT 后出现批量或连续故障，常见原因是焊接虚焊/连锡/回流曲线不当、外围元件贴错、供电与地设计问题，而非器件本身。处理步骤： 1. 核对器件丝印与 BOM 是否一致，确认没有贴错。 2. 检查焊接质量（回流曲线、虚焊、连锡）。 3. 用最小系统上电验证功能。 4. 记录不良率与现象，必要时交 FAE 分析。参考文档：无（属品质/工艺排查，请通过购买渠道或对接 FAE 确认）。

31. Air720UG的DTU固件配置里日志一直打印，如何关闭日志？

解答： 结论：把配置里的 nolog 参数设为 1 即可关闭日志。说明：Air720 系列（含 720UG）的 DTU/iRTU 固件通过配置项控制日志输出，nolog=1 表示关闭日志。属配置项用法，改完保存并重启生效。处理步骤： 1. 打开 DTU 配置页，找到 nolog 参数。 2. 将其值设为 1。 3. 保存配置并重启模组。 4. 确认日志已停止打印。参考文档：合宙 iRTU/DTU 配置说明 https://docs.openluat.com/value/irtu/docs/ 。

32. Air780EPM的ADC不同板子采集值不一致，多次采集到0导致平均值不对，是什么原因？

解答： 结论：ADC 采到 0 常见于输入接了 GND、悬空或负载（如电机）工作瞬间电压跌落；建议先升级到最新固件，再做硬件排查。说明：ADC 输入悬空时读数会跳变甚至为 0；若采集的是电机等动态负载的电源分压，负载启动瞬间电压跌落也会导致采样为 0。不同板子读数不一致，多与分压电阻精度、参考源与走线有关。处理步骤： 1. 升级到最新固件。 2. 用万用表量 ADC 输入端实际电压，确认不是 GND 或悬空。 3. 检查分压电阻精度与参考源。 4. 采动态负载时加滤波（多次采样去极值取平均），并避开负载切换瞬间。参考文档：Air780EPM ADC 应用文档 https://docs.openluat.com/air780epm/luatos/app/driver/adc/ 。

33. 使用手册中如何搭建LuatOS的开发、下载、调试环境？

解答： 结论：调试统一用 Luatools（合宙官方工具）；开发问题可问 ai.luatos.com，官网右下角 AI 也能给详细解答与文档链接，另有 LuatOS 上手课程可参考。说明：LuatOS 的标准环境是 Luatools，负责固件烧录、脚本下载与日志查看，配合编辑器编写 Lua 脚本；官网提供了从零上手的教程。处理步骤： 1. 下载并安装 Luatools。 2. 按烧录教程连接硬件、准备驱动（780/8000/8201 系列免驱）。 3. 用 Luatools 烧内核固件 + 下载脚本 + 查看日志。 4. 开发问题查官方文档或问 AI 助手。参考文档：Luatools 教程 https://docs.openluat.com/common/Luatools/ ；LuatOS 上手课程 https://docs.openluat.com/luatos_lesson/ 。

34. Air780EPM核心板是否支持用Lua实现DMA SPI收发？

解答： 结论：不用关心底层是否 DMA，直接用 LuatOS 的 SPI 核心库调用即可，效率足够。说明：LuatOS 的 SPI 核心库已在底层做了优化，应用层通过库接口收发数据；是否走 DMA 由底层实现决定，属于实现细节，不影响业务使用。处理步骤： 1. 按 SPI 核心库文档初始化（选通道、CS、速率等）。 2. 用库提供的接口收发数据。 3. 速率不够时先核对 SPI 时钟与接线，而不是纠结是否 DMA。参考文档：SPI 核心库文档 https://docs.openluat.com/osapi/core/spi/ 。

35. Air8202G整机重量偏重（约72g），宠物定位器想更轻有什么方案？

解答： 结论：有方案，可与合宙销售对接确认轻量化方案。说明：这属于选型/定制类事项。整机重量主要由电池、外壳与 PCB 决定，宠物定位器可评估更小的电池/外壳，或改用更轻的模组组合。原答口径为“有方案，可联系销售同事对接”。处理步骤： 1. 明确目标重量与续航要求。 2. 与销售/FAE 对接，评估电池容量、外壳材质与模组选型。 3. 打样验证重量与定位续航。参考文档：无（属选型/定制事项，请对接合宙销售或 FAE）。

36. 合宙远程升级平台libfota2/libfota3相关的介绍和文档在哪里？

解答： 结论：libfota2 的 API 文档在 osapi/ext/libfota2，应用说明见 docs 中 FOTA 章节；libfota3 是整机成品 FOTA 库。说明：libfota2 面向 LuatOS 应用的远程升级（对接合宙云平台），libfota3 面向整机成品形态的 FOTA。具体接口与用法见对应文档页。处理步骤： 1. 看 libfota2 API 文档了解接口。 2. 看 FOTA 应用章节（含差分/全量升级说明）。 3. 整机方案参考 libfota3。参考文档：libfota2 API 文档 https://docs.openluat.com/osapi/ext/libfota2/ ；libfota3 https://docs.openluat.com/osapi/ext/libfota3/ ；FOTA 应用说明 https://docs.openluat.com/air780epm/luatos/app/ota/fota/ 。

37. Air8784整机到手后如何玩/测试，网页端如何下发任务？

解答： 结论：在网页控制台选择设备后“检查并下发”任务，提示“任务配置完成”即成功；详细步骤见 Air8784 软件资料里的出厂固件使用说明。说明：流程大致为——登录 sip.luatos.com 控制台 → 选场景建任务（双设备互通/多设备轮拨/设备与手机/群组通话）→ 保存 → 检查并下发 → 按设备 SOS 发起呼叫。注意原答给出的 air8784_firmware_manual 链接已随官方文档改版失效，现指向 software 目录页面。处理步骤： 1. 登录控制台并确认设备已归属到项目。 2. 选择场景、建任务并“检查并下发”。 3. 设备侧按 SOS 拨测、长按 UP 挂断。 4. 看日志确认 SIP 注册成功。参考文档：Air8784 出厂固件使用说明 https://docs.openluat.com/air8784/software/default_factory_firmware/ 。

38. LuatOS的VSCode插件总是中断、分析一大堆然后断掉是什么原因？

解答： 结论：可继续使用；也可用 docs.openluat.com 右下角的 AI 辅助分析。说明：VSCode 插件在分析工程时，可能因工程较大、索引/网络波动而中断，属工具侧现象，一般不影响脚本本身的功能。处理步骤： 1. 重启 VSCode 或插件后继续使用。 2. 精简工程规模、排除无关目录，减少分析压力。 3. 用官网 AI 助手辅助分析代码。 4. 若持续异常，可反馈给合宙。参考文档：LuatOS VSCode 插件文档 https://docs.openluat.com/osapi/markdown/vscode/ 。

39. Luatools报ModuleNotFoundError: No module named 'bcj._bcj'是什么原因？

解答： 结论：重启一下 Luatools 即可。说明：这是 Luatools（打包程序）运行过程中内部模块加载异常导致的报错，属工具运行态问题，重启通常可恢复。处理步骤： 1. 关闭并重新打开 Luatools。 2. 仍报错则重新安装最新版 Luatools。 3. 持续复现请保留截图反馈。参考文档：Luatools 教程 https://docs.openluat.com/common/Luatools/ 。

40. 1M脚本区固件与512K脚本区固件有什么区别，如何选择？

解答： 结论：区别在“脚本区”大小——脚本区越大，能容纳的 Lua 脚本与资源越多。12 号/112 号固件脚本区为 1024KB（1M），多数固件为 512KB；需按项目脚本与资源体量选择合适脚本区大小的固件。说明：Air8000 因 Flash 有限、LuatOS 功能多，需用不同编号固件装载不同的核心库组合与脚本区/文件系统大小，官方固件页有编号表逐列列出脚本区与文件系统（fs）大小。脚本区越大可放的内容越多，但会挤占文件系统空间。原口径另提到“23 号临时固件为 512K”，23 号属临时固件、不在标准编号表内，其脚本区大小请以固件页最新说明为准。处理步骤： 1. 估算脚本与资源的实际体量。 2. 在固件页编号表里选脚本区合适的编号。 3. 注意差分升级只能在同类固件之间进行。参考文档：Air8000 LuatOS 固件版本（编号表）https://docs.openluat.com/air8000/luatos/firmware/ 。

41. Air8000想定制固件，增加fatfs、中文字库并缩减文件系统，能否自己勾选功能生成固件？

解答： 结论：可联系官方定制，官方已出 23 号临时固件（支持 fatfs、中文字体、脚本区 1M、文件系统 1.9M）；自行勾选功能生成固件的需求暂未开放。说明：Air8000 的功能组合由官方按固件编号维护（不同编号对应不同核心库组合与脚本区/文件系统配置），目前不开放用户自助勾选生成。有定制需求走官方定制渠道。处理步骤： 1. 整理所需功能（fatfs、中文字库、文件系统大小等）。 2. 联系合宙官方定制。 3. 使用官方提供的 23 号临时固件验证功能。 4. 量产前在自有业务脚本上回归。参考文档：Air8000 LuatOS 固件版本 https://docs.openluat.com/air8000/luatos/firmware/ 。