常见问题 - 2026-10-14

数据日期：2026-10-14

1. Air6205的蓝牙功能可以使用了吗？

解答： 结论：可以。Air6205 是 WiFi 6 + 蓝牙 5.4 的双模模组，蓝牙 BLE 功能一直可用。说明：Air6205 由 Air8000W 的 WiFi 部分拆分而来，支持 WiFi 6（2.4GHz）与双模蓝牙 5.4，蓝牙与 WiFi 共享射频并做了共存（PTA）设计，可避免相互干扰；蓝牙最高发射功率 +15dBm（典型 +6dBm），接收灵敏度 -97dBm（LE 1Mbps）。需要注意：Air6205 只能作从机，通过 AirLink over SPI / AirLink over UART 与 Air780 系列 / Air1601 系列主控配合，业务逻辑由主模组处理，它只负责无线数据透传；另外当前固件下只有 U1_TX 可配置为 AirLink over UART，用 U2 需申请定制固件。参考文档：https://docs.openluat.com/air6205/product/

2. 4G模块能否接入合宙LBS定位服务？

解答： 结论：只有合宙的模组能接入合宙 LBS 定位服务；其他厂家的模块不支持。付费 LBS 需要把设备（IMEI）归属到自己的合宙 IoT 账号下才能使用。说明：合宙定位服务分免费与付费两类。免费服务仅支持单基站定位、无 WiFi 定位，且有限频（10 分钟最多 1 次）；付费服务支持多基站 / 基站 + WiFi 混合定位，精度更高，需先在合宙 IoT 平台开通并获取 id / key。接入的前提是设备归属于本人账号，所以从渠道或经销商处拿到的设备，要让卖方把 IMEI 转移到自己名下。处理步骤： 1. 把设备 IMEI 归属到自己的合宙 IoT 账号（可让购买渠道协助转移）。 2. 在合宙 IoT 云平台开通 LBS 服务并查看 id / key。 3. 按所选库（付费用 airlbs、免费用 lbsloc2）烧录对应 demo，按接口发起定位请求。参考文档：https://docs.openluat.com/air780epm/luatos/app/common/lbswifi/

3. Air780EPT这款4G模组有硬件参考设计吗？

解答： 尚未解答

4. 合宙Air8782P2是否可以独立开发固件？

解答： 结论：可以。Air8782P 系列基于 Air780EPM 设计，直接使用 Air780EPM 的固件即可独立开发；理论上 Air780EPT 的固件也应该适用。说明：Air8782P 系列（P1/P2/P3/P4）是合宙的工业模组，把 SIM 卡座、电源、USB 下载、天线、看门狗等最小系统集成在板载，主控仍是 Air780EPM。固件与脚本按 Air780EPM 走，区别只在于板载外设（485/232 收发器、LED、看门狗芯片等）需要按实际电路去配置引脚。处理步骤： 1. 按 Air8782P 原理图确认板载外设（485/232、LED、看门狗）对应的 GPIO。 2. 使用 Air780EPM 的底层固件与脚本工程开发。 3. 对外设逐一验证后再联调整机功能。参考文档：https://docs.openluat.com/air8782p/product/

5. 看门狗Air153C和Air153D有什么区别？153D能否替代153C？

解答： 结论：Air153D 与 Air153C 其实是同一颗芯片、只是烧录的软件不同；153D 多了一组 STRAP 配置脚（PIN1/PIN6），超时档位可拉长到 10 分钟 / 60 分钟 / 12 小时 / 24 小时，153C 则只有约 200~283 秒。因此 153D 可以替代 153C，但前提是硬件上先把 STRAP 电阻加上并按档位配置好。说明：153D 的 STRAP1(PIN1) 与 STRAP6(PIN6) 是等待喂狗超时时间（T_timeout）的配置管脚，必须接外置上下拉电阻，不能悬空，否则容易受干扰。超时越长，主控越不用频繁醒来喂狗，实测功耗会明显下降，这也是 153D 的最大优点。要注意它不能把 153C 直接焊下来换上 153D 就用——153D 多出了 STRAP 配电阻。处理步骤： 1. 在 PCB 上为 STRAP1、STRAP6 加装上下拉电阻（R1/R2/R3/R4）。 2. 按 STRAP 档位表选定所需的超时档位（含 24 小时档）。 3. 喂狗信号接到休眠不掉电的引脚，复位信号走 NPN 或 PMOS 控制主控 RESET/VBAT。 4. 软件引用 exair153x_wdt 扩展库，按所选档位设置喂狗周期。参考文档：https://docs.openluat.com/accessory/Air153D/

6. Air153D芯片有丝印吗？1脚和6脚是做什么用的？

解答： 结论：Air153D 没有丝印；PIN1（STRAP1）和 PIN6（STRAP6）用于配置等待喂狗的超时时间。说明：Air153D 采用 SOT23-6 封装，1 脚为 STRAP1、6 脚为 STRAP6，两者都是预留的配置管脚，通过上下拉组合选择 10 分钟 / 60 分钟 / 12 小时 / 24 小时四档喂狗间隔。这两个脚不能悬空，必须外置上下拉；另外超时时间还会受供电电压影响（电压越高，PWR_OFF 重启时间越短）。处理步骤： 1. 按档位表确定 STRAP1/STRAP6 的高低电平组合。 2. 在 PCB 上给两脚加装对应上下拉电阻，不要悬空。 3. 结合所选档位设置软件喂狗周期，保证在超时前喂到。参考文档：https://docs.openluat.com/accessory/Air153D/

7. 模块能否连接语音数字信号并通过ESP发送到服务器，实现服务器页面实时语音通话？

解答： 结论：实时语音通话建议使用 SIP 语音方案，可参考合宙 Air8784 的产品资料。说明：把语音数字信号通过主控转发到服务器、再由服务器页面实现通话，本质上就是一条实时双向语音链路，用自建协议（如 ESP 透传）实现难度高、时延和互通性都难保证。合宙提供的是标准 SIP 语音方案：Air8784 内置语音编解码能力，按 SIP 协议注册到平台即可与软终端 / 平台页面通话，免去自研语音通道。处理步骤： 1. 先确认终端的语音输入 / 输出硬件（麦克风、扬声器、Codec）是否齐备。 2. 采用 Air8784 的 SIP 方案，按资料完成 SIP 服务器参数配置。 3. 用软终端或 SIP 体验平台做对通验证，再接入自己的服务器页面。参考文档：https://docs.openluat.com/air8784/product/

8. 合宙云平台原来密码无法登录、AI记录丢失怎么办？

解答： 尚未解答

9. Air8000上开RNDIS接视频主控给摄像头联网，同时打开WIFI走数据联网可以吗？

解答： 结论：当前不行。Air8000 上 RNDIS 不参与 NAPT，不能在开 RNDIS 给视频主控联网的同时再用 WiFi 走数据上网；如果核心诉求是走 WiFi，建议考虑用 Air8101 来做。说明：Air8000 的多网融合（exnetif.setproxy）是把某一网卡作为数据出口、其余网卡作为入口，例如 4G 作出口、WiFi/以太网作入口。RNDIS 是把模组当作 USB 网卡给主控用，它本身不是可参与 NAPT 转发的入口网卡，所以无法与 WiFi 同时做数据通道。若产品形态是「视频主控 + 摄像头联网 + WiFi」，更适合用 Air8101 平台。处理步骤： 1. 明确哪个网卡做数据出口、哪些做入口。 2. 若需 4G 供网给 WiFi/以太网设备，参考 4G 出口的多网融合 demo。 3. 若原设计依赖 RNDIS + WiFi 并行，评估改用 Air8101 的方案。参考文档：https://docs.openluat.com/air8000/luatos/app/network_routing/4g_out_ethernet_in_wifi_in/

10. 780ER是否支持安卓4.4？

解答： 结论：不支持。Air780ER 不提供对 Android 4.4 的支持。说明：Air780ER 走 RNDIS，把模组当作标准 USB 网卡给主控上网，这条路对系统版本、内核驱动都有要求。Android 4.4 版本过老，其 RNDIS / ECM 实现与当前模组固件的适配没有官方支持范围，因此不能直接照搬。实际项目请使用官方明确支持的系统环境，并在选型阶段与 FAE 确认。处理步骤： 1. 确认主控系统的版本与 USB 网卡支持情况。 2. 优先采用官方支持的系统与内核。 3. 若必须用在老系统上，先小批量实测并由 FAE 评估。参考文档：https://docs.openluat.com/air780epm/luatos/app/common/rndis/

11. Air8605不支持FLASH、WIFI功能吗？原理图上PIN73是5VOUT_EN，管脚复用表上却是悬空？

解答： 结论：这属于兼容设计，使用 Air1601 时该脚不用管。说明：Air860X 系列是基于 Air1601/Air1602 MCU 模组开发的工业模组，为兼容不同底板与通信方案（Air780ER2 或 Air6205A），部分管脚做了兼容复用，原理图与管脚复用表上出现命名不一致（如 PIN73 标 5VOUT_EN、复用表标悬空）属于同一管脚的兼容处理。以 Air1601 为主控时，该脚不需要外部作特殊处理。处理步骤： 1. 以实际所用主控（Air1601）的管脚复用表为准，逐脚确认。 2. 兼容脚按原理图标注处理，不额外驱动。 3. 有疑问时结合该型号原理图 PDF 与 FAE 复核。参考文档：https://docs.openluat.com/air1601/product/air860x/overview/

12. Air8101支持AirCAMERA_1032 USB摄像头吗？能否在LCD上做airui摄像头预览？

解答： 结论：可以接。AirCAMERA_1032 是 UVC1.0 免驱 USB 摄像头模组，官方明确可直接搭配 Air8101、Air1601 系列开发板使用，做过 LCD 上的 AirUI 摄像头预览；但它不能像监控摄像头那样做实时视频流传输。说明：AirCAMERA_1032 硬件为 FH8606 主控 + GC20C3 200 万像素传感器，支持 MJPG / H.264 编码，实测 1280×720@20fps，图片分辨率 1920×1080 / 1280×720，纯 USB 总线供电（5V±5%），免驱即插即用。它更适合拍照、录像这类场景；受限于 USB 带宽与模组定位，不适合持续推流。若需人脸识别功能，请另行确认对应摄像头型号。处理步骤： 1. 用 MX1.25 4Pin 端子线按颜色正确接入，严禁 VBUS/GND 反接。 2. 固定使用 MJPG 1280×720 15fps 这一推荐稳定规格。 3. 在 AirUI / LCD 应用中做预览与拍照、录像验证。参考文档：https://docs.openluat.com/accessory/AirCAMERA_1032/

13. 8101B什么时候上架？

解答： 尚未解答

14. 1603是否可以用LuatOS脚本开发UI，不用写LVGL代码？

解答： 结论：可以。Air1603 上可以用 LuatOS 脚本配合 AirUI 开发界面，不需要自己写 LVGL 代码。说明：AirUI 是 LuatOS 的核心库，基于 LVGL 9.4 做图形层封装，把常用组件、事件管理、输入设备和基础视觉主题封装成易上手的 Lua 接口，在支持 LuatOS 的设备和 PC 上都能开发。使用时通过 lcd 库初始化屏幕与背光、tp 库初始化触摸（如 GT911），再把触摸设备绑定到 AirUI 输入系统即可。注意 Air1603 显示接口色彩深度仅 RGB565（65K 色），不支持 24 位全彩。处理步骤： 1. 用 lcd 库初始化 LCD 与背光，配置缓冲区。 2. 用 tp 库初始化触摸控制器并绑定到 AirUI。 3. 按 AirUI 的组件接口编写界面逻辑。参考文档：https://docs.openluat.com/air1603/luatos/app/multimedia/ui/airui/

15. Air780EHV USB枚举出多个虚拟串口能否减少占用，让不用的口处于关闭状态？

解答： 结论：没办法单独关闭某个虚拟串口，要关就只能全部关闭。说明：Air780EHV 的 USB 复合设备在枚举时会一次性把多个虚拟串口（含日志口、用户口等）呈现给主机，这些接口是同一套 USB 配置描述的一部分，无法只挑其中某一个关闭——要么按整体配置全部打开，要么整体关闭。实际项目中如果觉得端口占用过多，应从是否真的需要这些口出发，整体裁剪配置，而不是逐口关闭。处理步骤： 1. 先确认这些虚拟串口各自的用途（下载、日志、用户数据等）。 2. 按实际需要整体开关，不能只关其中一个。 3. 需要精简端口时，与 FAE 确认是否有可用的定制固件方案。参考文档：https://docs.openluat.com/air780epm/luatos/hardware/usb/

16. Air780EPM支持电池接入、自带电源管理吗？

解答： 尚未解答

17. Air153D的4个挡位超时喂狗时间是固定的吗？能配成6小时喂狗一次吗？

解答： 结论：Air153D 的超时喂狗时间是固定的，只有 4 个可选档位，不能配成 6 小时喂狗一次。说明：Air153D 通过 STRAP1/STRAP6 只能选 10 分钟、60 分钟、12 小时、24 小时四档，没有中间值，因此 6 小时这类自定义周期无法实现。需要说明的是：一旦在超时时间内没有收到有效喂狗脉冲，看门狗就会触发复位，这正是它的作用。所以选档时要留出足够余量，让软件喂狗周期明显小于所选档位。处理步骤： 1. 从四档中选一个满足业务的最长档位。 2. 软件喂狗周期设置在远小于该档位的值（如选 60 分钟档，周期设在数分钟级）。 3. 用 exair153x_wdt 的 auto_feed_period_s 配置喂狗周期。参考文档：https://docs.openluat.com/accessory/Air153D/

18. Air153D在-40度低温下能否正常工作？

解答： 尚未解答

19. Air780EHM怎么焊接？可以用热风枪吹着焊吗？

解答： 结论：可以用热风枪吹焊，但需要一定的焊接技术水平。说明：Air780EHM 是邮票孔 / 贴片封装模组，回流焊是最规范的批量焊接方式。手工返修时可以用热风枪，但要控制好风温、风量与受热时间，避免局部过热损伤模组；双面都有器件时，建议先贴没有模组的一面，回流焊完成后再贴模组这一面，以免模组反复受热。处理步骤： 1. 按官方推荐的炉温曲线控制温度与受热时间。 2. 双面器件板先把非模组面回流焊完成，再做模组面。 3. 手工热风枪返修时控制风温风量，避免长时间直吹模组本体。参考文档：https://docs.openluat.com/common/smt/

20. 8784在哪里购买？

解答： 结论：Air8784 的产品与文档资料可在合宙文档站查看，购买可到合宙官方企业店（Luat.taobao.com）。说明：Air8784 是合宙的 SIP 语音方案模组，产品说明、出厂固件手册、SIP 配置与体验平台等资料都在文档站对应页面。选购时建议按所需的 SIP 模式（pair / round / phone）与配套外设确认型号，涉及批量采购、发票与账期等可联系对接销售。处理步骤： 1. 先看 Air8784 产品页确认型号与 SIP 模式需求。 2. 到 Luat.taobao.com 官方店购买（样机 / 小批量）。 3. 批量与商务条款联系合宙对接销售。参考文档：https://docs.openluat.com/air8784/product/

21. Air780E下载时显示无法识别USB设备，但启动后能正常通过USB打印串口信息，是什么原因？

解答： 结论：这类现象通常是 USB 枚举阶段的信号 / 供电问题，先换短线、并插到 USB2.0 口上试试。说明：下载时需要进入下载模式，此时对 USB 枚举的时序与信号完整性要求更高；换成长线、经过 USB Hub 或插入 USB3.0 口时，容易出现枚举失败、系统提示“无法识别 USB 设备”。而正常启动后只是打印串口信息，带宽与时序要求低得多，所以能正常工作。这基本可以排除模组损坏。处理步骤： 1. 换一根确认能传数据的短线直连电脑。 2. 插到电脑的 USB2.0 口（避免经过 Hub 或转接）。 3. 仍无法识别时，用 Luatools 的“保存日志”导出信息并联系对接 FAE。参考文档：https://docs.openluat.com/common/howtodown/

22. 7寸GT911屏能否接Air780EPM？

解答： 结论：可以接，但 Air780EPM 驱动的分辨率不高，建议用 Air1601 / Air1603 这类多媒体平台；Air1603 可支持 1024×600 分辨率的 RGB 屏。说明：7 寸 GT911 触摸屏通常配 1024×600 左右的 RGB 接口。Air780EPM 属 4G Cat.1 平台，主要面向通信与轻量显示，刷这种大屏会比较吃力；Air1603 的显示接口支持 1024×600 RGB 屏（色彩深度为 RGB565），带屏场景更合适。合宙配件中 AirLCD_1090（9 寸）与 AirLCD_1100（10.1 寸）都是 1024×600、JD9165BA 驱动 + GT911 触摸。处理步骤： 1. 先确认屏的分辨率与接口（RGB、触摸 IC）。 2. 带大屏的产品优先选 Air1603 / Air1601 平台。 3. 按屏规格配置 lcd 驱动与 GT911 触摸。参考文档：https://docs.openluat.com/accessory/AirLCD_1090/

23. 1603外挂780E如何给1603模组升级？

解答： 结论：用 airlink_4g 方案，升级方式与 4G 模组的 OTA 一致即可。说明：Air1603 本身不带 4G 基带，外挂 780E 后通过 AirLink（SPI 或 UART）把 4G 能力接进来。Airlink 是 LuatOS 提供的设备间通信协议，Air1603 侧用 airlink_4g 扩展库访问 4G 网络；升级时按 4G 模组的 FOTA / OTA 流程走，由 4G 侧负责联网与下载。处理步骤： 1. 确认 Air1603 与 780E 之间的 AirLink 物理连接（SPI 或 UART）已就绪。 2. 在脚本中引入 airlink_4g 并完成初始化。 3. 按 4G 模组的 OTA 流程配置升级，由 4G 侧联网下载。参考文档：https://docs.openluat.com/osapi/core/airlink/

24. AIR780EPM回流焊255°是否有问题？

解答： 结论：按官方手册来。手册标注的回流焊温度上限在 250℃ 以下，255℃ 已经超出建议范围。说明：Air780EPM 是贴片模组，回流焊要遵循官方推荐的炉温曲线。温度过高、高温持续时间过长，都可能损伤模组内部器件与焊点可靠性。双面都有器件的板子，建议先贴不含模组的一面，回流焊完成后再贴模组面，减少模组反复受热。处理步骤： 1. 下载对应型号的硬件手册，按其炉温曲线设置各温区。 2. 峰值温度控制在手册标注上限以内。 3. 双面器件板分两面焊，模组面放在后一道回流。参考文档：https://docs.openluat.com/common/smt/

25. Air780EPT有ISO9001证书吗？

解答： 结论：Air780EPT 只有入网许可证，没有 ISO9001 证书；模组与整机的认证不能相互套用。说明：型号核准（SRRC）、CCC、入网许可证（CTA/NAL）属于产品准入类认证；ISO9001 是质量管理体系认证，两者性质不同。合宙模组完成的认证不自动覆盖客户整机，客户终端使用合宙模块仍需按需再做终端认证。具体证书清单以对接销售 / FAE 提供的正式文件为准。处理步骤： 1. 明确目标市场需要的认证类别（准入类 / 体系类）。 2. 向对接销售索取对应型号的正式证书文件。 3. 整机认证另行安排，不能直接沿用模组证书。参考文档：https://docs.openluat.com/atmozu/product/renzheng/

26. 国外系列的模块有带AI指令的型号吗？有获得哪些国家认证？

解答： 结论：合宙海外系列目前没有带 AI 指令的型号；已取得的国家 / 地区认证以 CE、FCC 为主。说明：海外型号的差异主要体现在频段（如 Air780EHU 为欧亚版、Air780EHN 为北美版）与认证覆盖上，频段是硬件差异、刷固件改不了。认证方面已有 CE / FCC，具体到某个型号的证书编号与覆盖范围，需要按型号向对接销售 / FAE 索取正式文件。处理步骤： 1. 先按目标国家 / 地区选对型号（如欧亚用 EHU、北美用 EHN）。 2. 向对接销售索取该型号的 CE / FCC 证书。 3. 整机认证单独评估，模组认证不能套用。参考文档：https://docs.openluat.com/atmozu/product/renzheng/

27. Air780EPT有GCF和PTCRB认证吗？

解答： 结论：Air780EPT 没有 GCF 和 PTCRB 认证。说明：GCF 与 PTCRB 分别是欧洲与北美方向的运营商一致性认证，属于测试认证范畴，与型号核准、入网许可证是不同体系。Air780EPT 目前不在这两项认证的覆盖范围内。如果项目所在市场明确要求这两项认证，建议在选型阶段与对接销售 / FAE 确认可选型号。处理步骤： 1. 明确项目是否硬性要求 GCF / PTCRB。 2. 向对接销售索取 Air780EPT 现有认证清单。 3. 有强需求时评估其他型号方案。参考文档：https://docs.openluat.com/atmozu/product/renzheng/

28. Air8000W新旧版本（UART2_TXD/RXD从94/95变更为40/41）如何区分？

解答： 尚未解答

29. 合宙Air780系列支持在Linux下开发烧写吗？

解答： 结论：目前没有 LuaTools 的 Linux 版本，但可以用命令行工具 luatos-cli 在 Linux 下开发与烧写。说明：luatos-cli 是合宙提供的命令行工具，专门面向 AI 与自动化场景，支持 Air780EPM / Air780EHM / Air8000 / Air8101 / Air1601 全系列的刷机、日志查看和 FOTA 包生成，源码在 Gitee 的 openLuat/luatos-cli。可以从 Luatools 的资源下载功能获取，也可从合宙资源站下载。处理步骤： 1. 从合宙资源站下载 luatos-cli（见下方链接）。 2. 用命令行完成烧写、日志查看与升级包生成。 3. 需要图形化界面时仍使用 Windows 下的 LuaTools。参考文档：https://docs.openluat.com/ai/mcp_cli/

30. Air8202G模块如何添加到IOT账号？

解答： 结论：可以联系合宙商务协助把设备转移到你的账号，或登录合宙设备管理平台查看。说明：设备要能在你的合宙 IoT 账号下使用（含 OTA、LBS 等增值服务），前提是 IMEI 已归属到你的账号与对应项目。从渠道、经销商处拿到的设备，如果还挂在别人的账号上，需要办一次归属转移。注意：一旦设备已归属到某个用户名下，合宙侧就失去转移权限，所以转移要由原归属方发起。处理步骤： 1. 登录 https://device.luatos.com/ 查询设备的当前归属。 2. 由原归属方发起，或联系合宙商务协助转移。 3. 归属完成后确认设备已在目标项目下。参考文档：https://docs.openluat.com/air8202/product/

31. 8202G官方低功耗测试60uA，是否需要拆除板载其它元器件才能降到更低功耗？PCBA能否降到模块本身10uA左右？

解答： 结论：可以先从 GNSS 备电脚入手。该脚同时给三轴加速度传感器和 GNSS 后备电路供电，常开会明显增加静态功耗，关闭后再复测。说明：官方资料在该脚的 GPIO 编号上存在两种标注（GPIO23 / GPIO24），以你所使用模组的 GPIO 复用表为准。注释里给出的量级是：该脚常开时功耗会增高约 0.5~1mA。若项目对功耗要求很高，可以在不需要热启动、不需要保存星历的场景下关闭它；代价是失去热启动能力，下次定位需要重新捕获。处理步骤： 1. 按所用模组的 GPIO 复用表确认该备电脚编号。 2. 在脚本中用 gpio.close() 关闭该脚，复测整机电流。 3. 若仍需热启动与星历保存，评估是否保留部分时间供电。参考文档：https://docs.openluat.com/air780egh/luatos/app/gnss/gnss/

32. 合宙Air780EPM核心板支持北美、带定位的板卡是哪一款？

解答： 结论：推荐使用 Air8000N，规格可在 Air8000 的频段 / 选型页面查看。说明：Air8000N 属于 Air8000 系列中带 GNSS 的型号，面向北美市场，内置 GNSS 与 G-Sensor；官方资料明确 Air8000A/AB/U/N/D/DB 六款都内置 GNSS 和 G-Sensor。选型时要注意这些内置功能会占用部分系统管脚（如 GNSS 供电控制、主控与 GNSS 的 UART、G-Sensor 的 I2C 等），外部不能再随意复用。处理步骤： 1. 在 Air8000 选型 / 频段页确认 Air8000N 的频段覆盖满足北美要求。 2. 确认内置 GNSS 与 G-Sensor 占用的管脚不影响你的外设设计。 3. 需要核心板时按对应型号配套选购。参考文档：https://docs.openluat.com/air8000/product/pinduan/

33. Air780EPM新样品烧录老固件会有什么影响？

解答： 结论：新样品烧录老固件有概率使模组变砖，不要用老固件去测试新样品。说明：新批次的样品在硬件与底层适配上有更新，老固件的启动 / 分区 / 外设初始化行为未必与新样品匹配，存在启动失败甚至无法再进入下载模式（变砖）的风险。测试新样品时应使用与样品配套的当前版本固件，需要回退版本时先与 FAE 确认兼容性。处理步骤： 1. 新样品一律使用配套的当前版本固件测试。 2. 确需回退时先向 FAE 确认该固件与新样品是否兼容。 3. 一旦出现异常，及时用 Luatools 的“保存日志”导出信息并联系 FAE。参考文档：https://docs.openluat.com/air780epm/luatos/firmware/780epm_version/

34. 蜂窝网络定位突然出现大的位置漂移是什么原因？

解答： 结论：免费的单基站（LBS）定位在连接的基站发生变更时，位置就可能跟着改变，这属于该定位方式的固有特性，不一定是设备异常。说明：免费服务只上报单基站信息，由服务器反查该基站位置当作结果，因此当设备连上的基站变了（例如周边基站负载调整、临时基站车、跨区漫游），返回的坐标就会出现明显跳变。官方资料也说明：多基站 / 多 WiFi 定位精度高于单基站，但误差依然较大；需要准确的位置请使用支持 GPS/GNSS 的模组。处理步骤： 1. 确认使用的是免费单基站定位还是付费多基站 / 混合定位。 2. 对比定位时间点与基站变化情况，判断是否为基站切换导致。 3. 对位置精度有要求时改用 GNSS，或开通付费多基站服务。参考文档：https://docs.openluat.com/air780epm/luatos/app/common/lbswifi/

35. 新版本LuaTools生成不了OTA差分包怎么办？

解答： 结论：可以从三方面排查——换成纯英文路径、关闭杀毒 / 加密类软件，或改用 LuaTools 3.0.15 版本再试。说明：生成 OTA 差分包要在本地做文件读写与打包，路径含中文、目录权限受限、杀毒或加密软件拦截读写，都会导致生成失败；部分较新版本的 LuaTools 在特定环境下也可能出现兼容问题，换回 3.0.15 版本可以用于交叉验证。这不属于固件或脚本本身的问题。处理步骤： 1. 把工程与输出目录都改到纯英文路径下。 2. 临时关闭杀毒软件、加密 / 沙箱类软件后重试。 3. 仍失败时换用 LuaTools 3.0.15 版本再试。参考文档：https://docs.openluat.com/common/Luatools/

36. libfota3怎么配置，升级包状态显示失败？

解答： 结论：libfota3 上报固件名的显示格式是“型号 + / + 脚本名称”，例如 Air780EPM/FOTA3_NO_UI，这与 libfota2 的格式不同，配置时要注意对上。说明：libfota3 只对接合宙 IoT 平台，扩展库内部完成“检测新版本 → 下载升级包 → 校验 → 写入升级分区 → 重启生效 → 结果上报”的完整闭环。使用前需在合宙 IoT 平台创建项目并取得 project_key；平台上的固件列表、升级配置（目标固件 / 基础固件）要与设备上报的型号、脚本名、版本对应，名称格式不一致就会显示失败。处理步骤： 1. 在脚本中用 libfota3.request() 填入 project_key、script_name、script_version。 2. 在平台按“型号/脚本名”的格式创建固件与升级配置。 3. 确认升级配置状态已从“生成中”变为“已完成”，再让设备检测。参考文档：https://docs.openluat.com/osapi/ext/libfota3/

37. EPM模块烧录程序烧录不了是什么原因？

解答： 结论：常见原因是所处环境存在加密 / 沙箱类软件拦截了烧录读写，可换英文目录、重启 LuaTools、关闭加密软件，或申请临时取消加密后重试。说明：烧录过程需要在本地创建临时文件、访问串口与磁盘，加密软件或沙箱往往会拦截这些操作，表现为“烧录不了”“走到一半失败”等现象。路径含中文也可能加重问题。先排除环境因素，再判断是否为固件或硬件问题。处理步骤： 1. 把 LuaTools 与工程都放在纯英文路径下。 2. 重启 LuaTools，必要时重新插拔 USB。 3. 关闭加密 / 沙箱类软件，或向 IT 申请临时取消加密后重试。参考文档：https://docs.openluat.com/common/Luatools/

38. 780EPM模块死机是什么原因？为什么没有定位到error，软件看门狗也没重启？

解答： 结论：可以先打开 errordump 功能抓一下日志。它能记录并上传脚本运行中的语法错误或自定义错误信息，有助于初步定位死机原因。说明：死机且没有定位到 error、软件看门狗也没重启，说明问题可能发生在脚本之外或看门狗未生效。errordump（errDump）是 LuatOS 提供的错误日志存储与上传功能，建议在 main.lua 中启用并设置上报周期；同时把硬件看门狗（如 Air153C/Air153D）与软件 wdt 的配置一起核对，避免“看似有看门狗但实际没喂到”。处理步骤： 1. 在脚本中启用 errDump：errDump.config(true, 600)。 2. 复现死机后导出日志，结合时间点分析。 3. 核对 wdt 初始化与喂狗逻辑，以及硬件看门狗的喂狗引脚与周期。参考文档：https://docs.openluat.com/air780epm/luatos/app/base/errdump/errdump_780epm/

39. Air8000W升级到V28版本进行WIFI升级怎么操作？

解答： 结论：按 Air8000 的 WiFi 固件升级说明操作即可，参考 updatwifi/update 页面。说明：Air8000W 的 WiFi 部分（Air6205）有独立的固件，需要单独升级。升级流程按官方 update 文档执行：准备好升级用的固件与工具，按说明把 WiFi 固件写入，升级期间注意供电稳定、不要中途断电。若同时使用多网融合（4G 供网给 WiFi 设备），升级完成后按 demo 重新验证联网。处理步骤： 1. 按 update 文档准备对应的 WiFi 升级固件与工具。 2. 保证供电稳定，按步骤执行升级。 3. 升级后重启并验证 WiFi 联网 / 多网融合功能。参考文档：https://docs.openluat.com/air8000/luatos/app/updatwifi/update/

40. 代码评审和修改需要提供哪些资料？

解答： 结论：合宙不对客户代码做代码评审，只提供定制开发：客户输出需求并交付定金，合宙完成开发、出货达到约定数量后返还定金。说明：这属于商务合作事项，不在技术文档管辖范围内。流程大致是：客户先给出清晰的功能与技术需求；双方确认开发范围与交付物；客户支付定金；合宙完成开发后按约定出货，达到约定的数量后退还定金。处理步骤： 1. 整理需求文档（功能、接口、外设、验收标准）。 2. 联系合宙对接销售确认开发范围、定金与出货约定。 3. 签署合作条款后启动开发。参考文档：无（属商务合作事项，请通过购买渠道或对接销售确认）。

41. Air8000U是否自带GNSS？

解答： 结论：Air8000U 自带 GNSS。说明：官方资料明确，Air8000A / AB / U / N / D / DB 六款支持 LuatOS 二次开发的型号都内置 GNSS 和 G-Sensor（其中 Air8000D/DB 与 A/AB/U/N 相比没有 WiFi / BLE 功能）。内置 GNSS 会占用部分系统管脚，例如 GNSS 供电控制、主控与 GNSS 的 UART2 通信等，这些管脚外部不可再随意复用；GNSS 天线则需外部设计并做 50Ω 阻抗匹配。处理步骤： 1. 按硬件资料确认内置 GNSS 占用的管脚不会影响你的外设。 2. 设计 GNSS 天线并做好阻抗匹配。 3. 参考 GNSS 应用文档完成定位功能开发与验证。参考文档：https://docs.openluat.com/air8000/luatos/hardware/gnss/

42. 合宙IOT平台有没有公司账户？怎么申请？

解答： 结论：注册即可，合宙 IoT 平台没有单独的“公司账户”申请流程。说明：合宙 IoT 平台按账号组织项目与设备，注册一个账号后即可创建项目、归属设备并使用 OTA、LBS 等能力。企业使用时，用公司信息注册账号，并按需要把设备 IMEI 归属到该账号下的对应项目即可。设备归属一旦完成，合宙侧不再保留转移权限，所以归属前要想清楚归属到哪个账号。处理步骤： 1. 打开合宙 IoT 平台注册账号。 2. 创建项目，获取 project_key 等信息。 3. 按归属流程把设备 IMEI 转移到该项目下。参考文档：https://docs.openluat.com/air780epm/product/attributioniot/

43. Air6208为什么定位是纯WIFI从机，而不是低成本WIFI+蓝牙从机？

解答： 结论：Air6208 本身没有蓝牙功能，所以定位是纯 WiFi 从机；带蓝牙的是 Air6205。说明：Air6208 是合宙面向低成本 WiFi 从机场景推出的模块，聚焦纯数据传输，不含蓝牙射频。Air6205 才是 WiFi 6 + 蓝牙 5.4 的双模模组，可同时提供 WiFi 与 BLE 能力。选型时如果需要蓝牙，应选 Air6205；只需要 WiFi 从机、追求成本，则用 Air6208。处理步骤： 1. 明确产品是否需要蓝牙 / BLE 能力。 2. 需要蓝牙选 Air6205，只需 WiFi 从机选 Air6208。 3. 向对接销售 / FAE 确认所选型号的供货与资料。参考文档：https://docs.openluat.com/air6205/product/

44. 如何配置AI助手MCP CLI？

解答： 结论：把文档站 https://docs.openluat.com/ai/mcp_cli/ 发给你自己的 AI 助手，让它自行下载并完成配置即可。说明：合宙提供了一系列 MCP 服务与 CLI 工具供 AI 工具使用，包括 docs-ai（文档检索）、code-ai（代码库 / 示例库检索）、luatos-cli（命令行刷机 / 日志 / 升级包生成）、luatpower（功耗分析仪）、aircloud-ai（设备与服务器双向通信）等。官方建议不要手动拷贝配置，直接把该网址交给 AI 助手，由助手按页面给出的配置信息完成安装与配置。处理步骤： 1. 打开 https://docs.openluat.com/ai/mcp_cli/ 查看各服务与配置信息。 2. 把该网址发给你的 AI 助手，让它按页面内容自行下载与配置。 3. 需要身份密钥的服务（如 AirCloud）按页面提示在合宙 IoT 平台获取密钥后再填入。参考文档：https://docs.openluat.com/ai/mcp_cli/