跳转至

常见问题 - 2026-09-20

数据日期：2026-09-20

1. Air780EHV是否支持USB耳机（UAC耳机/USB主机模式）实现通话+录音？

解答： 结论：不支持。Air780EHV 与 Air1601 所用的移芯（EigenComm）平台不具备 USB 主机（USB Host）模式，无法接 UAC 耳机做通话与录音。

说明与替代方案：

  1. USB 耳机属于 USB Host 外设，模组侧要当主机去枚举并驱动它，移芯平台没有开放这条通路，只提供 USB Device 能力（虚拟串口、U 盘）。
  2. 要实现通话 + 录音，请走模组原生音频通路：模拟 MIC + 喇叭，或用 PCM/I2S 外接音频 codec；Air780EHV 的音频能力见产品与硬件设计文档。
  3. 若产品形态必须是 USB 耳机，需要在模组之外再挂一颗带 USB Host 的主控，由主控接耳机、再与模组做音频与串口交互。

参考文档：Air780EHV 资料 https://docs.openluat.com/air780ehv/product/ 。

2. 8601的TTS功能怎么用？没有声音，需要用什么参数初始化？

解答： 结论：先换最新固件 + 最新 exaudio 库，TTS 播放没声音基本都是版本不匹配造成的。官方给出的组合是最新的 Air1602 固件（如 LuatOS-SoC_V1027_Air1602_102_20260918.soc）配最新版 exaudio。

处理步骤：

  1. 用 Luatools 刷入最新的 Air1602 固件（V1027 及以上）。
  2. 把工程里使用的 exaudio 换成官方最新版，建议放进项目目录随脚本一起打包，避免继续引用旧的默认 lib。
  3. 按 exaudio 文档初始化音频设备（通道、采样率、音量等）后再调用 TTS 播报。
  4. 仍无声时逐段排查：喇叭/功放供电与接法、音频通道选择是否正确、初始化是否真正成功。

参考文档：https://docs.openluat.com/osapi/ext/exaudio/ ，固件页 https://docs.openluat.com/air1601/luatos/firmware/1602_version/ 。

3. 批量烧录工具不支持CSDK生成的binpkg量产文件，只能用旧版本吗？

解答： 结论：用老版本量产烧录工具即可——v1.0.7 支持烧录 CSDK 生成的 binpkg，从 v1.1.3 起工具限制为只能烧录 soc 文件，不是你的固件有问题。

说明：CSDK 与 LuatOS（soc）两种开发方式产出的量产文件格式不同，新版工具把校验收敛到 soc 上，遇到 binpkg 会直接报不支持，属于工具侧的格式限制。

处理步骤：

  1. 确认手上确为 CSDK 产出的 binpkg，向对接 FAE/销售索取 v1.0.7 版本工具。
  2. 若希望改用新版工具，则需改用 LuatOS 方案产出 soc 文件。
  3. 产线同时存在两种固件时，务必让工具版本与固件格式一一对应，避免混用。

参考文档：量产烧录工具 https://docs.openluat.com/common/Luat_productiontool/ 。

4. Air1103只能在audio_v2上跑，但8000和780EHV没有同时支持airui和audio_v2的固件，需要新增吗？

解答： 结论：需要新增，而且除了编固件之外还要再申请一个新的固件编号。

说明：Air1103 依赖 audio_v2（第二代音频框架）才能跑，而 Air8000 / Air780EHV 当前发布的固件没有把 airui 与 audio_v2 组合在一起，因此需要在发布流程里新增一个「airui + audio_v2」的固件组合。合宙固件按编号发布与管理，新增组合要占用新编号，便于版本追溯与问题定位。

处理建议：

  1. 向对接 FAE/销售提交需求：模组型号 + airui + audio_v2 + Air1103。
  2. 需求确认后排期发布新编号固件。
  3. 发布前可先在已支持 audio_v2 的平台上验证 Air1103 的业务逻辑。

参考文档：音频扩展库 https://docs.openluat.com/osapi/ext/exaudio/ 。

5. 8203的板子支持低功耗吗？PSM+测出来不太对，510W和看门狗供电为VDD_3.3V由VBAT经LDO转换且无管脚控制。

解答： 结论：支持低功耗；硬件电源设计（510W 与看门狗用 VDD_3.3V，由 VBAT 经 LDO 转换且无管脚控制）本身是合理的，3.3V 部分就应当独立并且上电即供电。当前测到的大电流主要来自 MS1631 蓝牙芯片耗电，不是电源拓扑的问题。

处理步骤：

  1. 把 GPIO25 拉高，即可关掉 510W（GNSS）这一路供电。
  2. MS1631C 需按 5101 的 AT 指令设为待机模式，否则会持续耗电。
  3. 关掉这两路后再复测 PSM+ 电流，与手册指标逐项对比。

参考文档：Air8203 系列工业模组使用手册 https://docs.openluat.com/air8203/product/ 。

6. 8203 V1板485_B下面是GND测试没有导通，是贴片问题吗？

解答： 结论：大概率是贴片问题。原理图和位号图中该位置是「贴 R3、不贴 R4」，实际板上若贴错或漏贴，485_B 与 GND 之间自然测不出导通。

处理步骤：

  1. 对照 Air8203 原理图与位号图，核对该位置的实际贴片料号与数量。
  2. 注意 485_B 是复用管脚，兼容隔离式 485 的 B、非隔离 485 的 B、UART3_TX 三种接法；Air8203V1 是隔离式 485 + 780EHV 配置，接法不同对地关系也不同，不能一概而论。
  3. 确认贴错后按图纸返修，再复测通断与通信。

参考文档：Air8203 系列工业模组使用手册 https://docs.openluat.com/air8203/product/ 。

7. 哪颗模组支持VoLTE？用于类似老人机只需实现通话功能。

解答： 结论：大部分 4G 模组都支持 VoLTE（前提是所在网络与卡侧已开通 VoLTE）。若只做类似老人机的纯通话产品，推荐 Air8780V + Air6205 组合。

说明与建议：

  1. Air8780V 自带音频通路，可直接板载，省掉外挂音频器件。
  2. Air6205 提供 4G 通信 + WiFi，适合做整机联网与语音终端。
  3. 选型前先明确三件事：要不要 WiFi、要不要显示屏、是否双卡，再定模组数量。

参考文档：https://docs.openluat.com/air8780/product/ ，https://docs.openluat.com/air6205/product/ 。

8. 串口下载和Type-C下载有什么区别？

解答： 结论：该下载器本身就是 USB 下载，不支持串口下载，所以二者不是「二选一」的关系。

说明：下载器通过 USB 被主机枚举为串口设备，Luatools 走 USB 通道完成固件下载与日志抓取，Type-C 只是物理接口形态，换成别的 USB 口也一样。若某些工具或第三方上位机只认串口，需要另配 USB 转串口（如 CH343）方案，或改用模组自带的 DBG UART。

参考文档：Luatools 使用说明 https://docs.openluat.com/common/Luatools/ 。

9. 780EPM无法联网（大量出现），换了SD NAND供应商后SD写入慢导致H264不编码，写入SD卡和H264编码能改成异步吗？

解答： 结论：需要与 SD NAND 厂商（天微）一起联合调试，这更像是 SDIO 时序/驱动适配问题，而不是单纯改软件参数能解决的；建议先拉技术支持群，并把板子寄给厂商做适配。

说明与处理：

  1. 换供应商后写入变慢，多半是 SD NAND 的初始化与时序参数和主控 SDIO 不完全匹配，单次写入耗时被拉长，进而把 H264 编码的帧节奏拖垮，表现为丢帧甚至不编码。
  2. SDIO 协议实现是否符合标准，需要由厂商确认。
  3. 适配完成前可以先评估「写入与编码解耦」的临时方案（降低分辨率/帧率、加大缓冲、分片写），但根治仍要解决 SD 写入耗时。
  4. 780EPM 的联网异常建议单独抓一份完整日志，把「网络侧问题」与「SDIO 阻塞」分开判断。

参考文档：Air780EPM 固件与版本 https://docs.openluat.com/air780epm/luatos/firmware/780epm_version/ 。

10. 8781/7871模块连不上互联网，有MQTT之类的demo吗？

解答： 结论：8781 用的模组就是 Air780EPM，因此 Air780EPM 的 demo 都可以直接参考；连不上网时先用官方 demo 做对照，再排查自己的业务代码。

处理步骤：

  1. 参考官方 mqtt demo 与 Air780EPM 的应用文档搭最小可运行工程。
  2. demo 与资料可以问 https://ai.luatos.com/ ，或查文档站与源码仓库 https://gitee.com/openLuat/LuatOS/tree/master/module 。
  3. 网络不通按顺序查：是否注网并拿到 IP（日志出现 IP_READY）、SIM 卡是否欠费或需要专用 APN、定向流量卡是否把服务器域名加入白名单。

参考文档：https://docs.openluat.com/osapi/core/mqtt/ 。

11. 合宙是否提供设计主板/定制板子的服务？有起订量要求吗？

解答： 结论：可以定制，但需要先把需求说清楚，合宙评估后认为合适才承接，并非所有需求都接。

说明：付款方式一般是先付定金，等出货量达到约定数量后，定金开始抵扣货款。这类服务适合已经有明确产品定位、能提供功能框图与接口清单的客户；如果只是前期打样验证，也可以先在官方开发板/核心板上把方案跑通，确认可行后再谈定制，成本与风险都更可控。

处理建议：把功能需求、供电与结构约束、天线形式与净空要求、预计批量整理成一页材料，交给对接的销售/FAE 评估。

参考文档：选型指南 https://docs.openluat.com/SelectionGuide/SelectionGuide/ 。

12. SIP心跳和VOS不兼容怎么办？

解答： 结论：大概率是服务器侧协议差异，可以通过修改 libs 目录下的 exsipclient.lua 来适配。

处理步骤：

  1. 找到工程 lib 里的 exsipclient.lua（或对应的 exsip 扩展库）。
  2. 把 VOS 服务器要求的报文格式、心跳与注册字段说明，连同这个文件一起丢给 AI（https://ai.luatos.com/ ）做适配修改。
  3. 改完单独验证注册、心跳、呼叫三个流程，确认不再不兼容。
  4. 建议把改动后的文件放进项目目录随脚本打包，避免被 Luatools 默认 lib 覆盖。

参考文档：SIP 扩展库 https://docs.openluat.com/osapi/ext/exsip/ 。

13. 780EH2的固件和内核、接口都和之前一样吗？会不会要重新开发？

解答： 结论：内核与接口和之前一样，不需要重新开发；对应固件这几天就会发布，按常规方式刷入即可。

说明：同一系列模组在存储/物料换代时，合宙会保持软件接口兼容，用户的脚本与业务逻辑不用改动；但固件必须换成与型号、编号对应的版本，不能跨型号硬刷，否则可能出现异常甚至变砖。

建议：固件发布后先在一块板上做一次完整回归（注网、联网、核心业务），确认无异常再批量刷产线；疑问可以问 https://ai.luatos.com/ 查资料库。

14. 合宙SIP功能能否支持DTMF按键信令？

解答： 结论：目前还没有，后面可以加上（属于排期中的功能，具体时间以官方发布为准）。

说明：DTMF 按键信令有两种承载方式——带内音频与带外 RFC2833/4733 报文，做语音导航类业务时两者对服务端的要求不同。在官方支持之前，可以先用音频通路自行发送 DTMF，或改用自定义报文把按键事件报给服务器作为过渡。

建议：把使用场景、需要支持的按键范围、对端设备型号反馈给对接 FAE/销售，便于排期与验证。

参考文档：SIP 扩展库 https://docs.openluat.com/osapi/ext/exsip/ 。

15. 1601/1602开发板摄像头支持扫码吗？有能支持扫码的摄像头方案吗？

解答： 结论：1601/1602 开发板可以接摄像头，但官方摄像头方案不含扫码（条码/二维码识别）功能，目前没有可直接使用的扫码摄像头方案。

说明：

  1. 硬件上完全支持：Air1601 Turnkey 开发板可选配 200 万像素摄像头（AirCAMERA_1030，USB 接口的配件板），配件与接线方式文档里有现成说明。
  2. 但这类摄像头方案的能力是拍照、录像、图片/视频上传，文档里没有条码/二维码识别相关内容；Air1601 文档中出现的二维码属于界面组件（生成并显示二维码），不是扫码识别。
  3. 目前文档中明确支持扫码的平台是 Air724UG，示例支持 QR-Code 与 CODE-128 两种码型，识别结果通过回调返回，默认 10 秒超时。
  4. 若产品必须扫码，两条路可选：① 沿用已经验证过的 Air724UG 摄像头 + 扫码方案；② 在 1601/1602 上取流后自行实现解码（官方暂无现成解码库），工作量与可行性建议先与对接 FAE 确认。

参考文档：Air1601 Turnkey 开发板 https://docs.openluat.com/air1601/product/air1601_turnkey_devboard/hardware/ ，AirCAMERA_1030 配件板 https://docs.openluat.com/air8101/luatos/app/accessory/AirCAMERA_1030/ ，Air724UG 摄像头与扫码示例 https://docs.openluat.com/air724ug/luatos/app/simpleui/camera/ 。

16. AIR780EPM的程序可以用于AIR780EHU和780EHN吗？

解答： 结论：代码（脚本）可以，固件必须换成 Air780EHU / Air780EHN 对应的版本，不能沿用 780EPM 的固件。

说明：同一平台系列的 LuatOS 脚本接口一致，业务脚本基本可以平移；但各型号射频与硬件配置不同，固件必须与型号匹配。老版本固件在型号不匹配时能被刷进去，但刷完会变砖，新版本固件已经规避了这种误刷。

处理步骤：

  1. 把脚本迁到目标型号的工程里。
  2. 刷入 780EHU / 780EHN 的对应固件。
  3. 回归注网与业务功能；销往海外时还要先核对频段覆盖。

参考文档：https://docs.openluat.com/air780ehnehu/luatos/firmware/version/ 。

17. AIR780E模组AT模式下，RI引脚下降沿脉冲到串口吐数据的时间可以设置吗？

解答： 结论：不能设置。MAIN_RI 的输出脉冲宽度，文档给出的就是固定的 120ms，AT 指令只能控制「哪些事件也产生脉冲」，无法调整脉冲宽度。

说明（引自 Air780E AT 硬件设计-串口章节）：

  1. MAIN_RI 是振铃管脚，模块收到短信时会输出一个 120mS 低脉冲通知主控来信；待机状态下该管脚为高电平。
  2. 通过 AT+CFGRI 可以使能 URC 上报提醒：AT+CFGRI=1 时，数据业务（TCPIP、HTTP、MQTT、FTP）的 URC 上报，以及模块主动发起的其他 URC 上报，也会产生 120ms 低脉冲。
  3. 也就是说 AT+CFGRI 只决定「URC 事件是否也触发脉冲」，不改变 120ms 这个固定宽度，也没有「脉冲到数据输出间隔」这类可配参数。
  4. 正确用法是把 RI 当作提前通知：主控收到下降沿后立即准备接收串口数据，并在主控侧做好缓冲与超时处理，而不是去设定「脉冲后多久数据才到」。

补充：MAIN_DTR、MAIN_RI、MAIN_DCD 严格来说都不属于串口功能，是独立的控制管脚（MAIN_DCD 目前无功能，仅作普通 GPIO）。

参考文档：Air780E AT 硬件设计-串口 https://docs.openluat.com/air780e/at/hardware/design/uart/ 。

18. 合宙模块支持三大运营商的物联网卡吗？

解答： 结论：肯定支持，不支持的话模组根本无法正常工作。

说明：国内型号（如 Air780EPM）按「国内全网通」设计，频段覆盖中国移动、中国电信、中国联通三家，插任意一家的物联网卡都能驻网。物联网卡与普通卡的区别主要在上层计费与定向策略，不影响驻网本身。

真正会影响接通的通常是：定向流量卡未把目标服务器域名加入白名单、卡未激活或欠费、专用 APN 未正确配置。

参考文档：Air780EPM 产品资料 https://docs.openluat.com/air780epm/product/ 。

19. Air780EGH的FOTA升级指南文件在哪里？固件上传后指定设备添加不进去怎么办？

解答： 结论：指南可以在文档站或 AI 问答里查——在 https://docs.openluat.com/ 或 https://ai.luatos.com/ 点右下角的 AI 问答机器人提问即可。注意旧域名 docs.luatos.com 已不可用，请统一改用 docs.openluat.com。

「固件上传后指定设备添加不进去」的处理：

  1. 这类问题必须对照 FOTA 文档一步步定位卡在哪一步。
  2. 常见原因之一是设备未归属到当前账号项目下——平台只会给已归属设备下发任务。
  3. 另一个常见原因是 IMEI 填错，或使用了与设备现网固件不同编号制作的差分包。

参考文档：FOTA 教程 https://docs.openluat.com/air780epm/luatos/app/ota/fota3rd/ 。

20. Air724UG-NFC硬件A16版本和A20版本有什么区别？是否通用？出厂是否带烧录程序？

解答： 结论：硬件上没有区别，A16 与 A20 版本通用；出厂都不带用户程序，需要自己烧录，出货默认为 AT 固件。

说明：通用版本与二次开发版本的差别在软件形态上——通用版出货是 AT 固件，上电即按 AT 指令交互；二次开发版则需要你自行烧录 LuatOS/CSDK 固件与脚本。A16、A20 属于批次/版本标注差异，不影响硬件功能与管脚定义。

建议：拿到板子先读一次版本信息确认实际固件，再按对应开发方式准备工具链。

参考文档：Luatools 使用说明 https://docs.openluat.com/common/Luatools/ 。

21. 8201H的云平台免费使用，可以设置云平台接入自己的app吗？

解答： 结论：会收费。

说明：8201H 云平台的免费使用面向既有的标准场景，一旦要接入自己的 App、做二次开发或批量接入，就属于商业化服务，需要付费开通。

建议：把具体用法（接入自建 App、是否需要开放 API、设备数量级）整理清楚，联系合宙商务/对接销售确认资费与开通方式，避免按免费额度评估项目成本。

参考文档：Air8201H 硬件资料 https://docs.openluat.com/air8201/8201Hhardware/ 。

22. 下载固件时有4个文件，要下载哪些？

解答： 结论：下载最新版本那一个即可，上面就有版本号。

说明：固件目录里通常会同时保留历史版本与说明文件，并列出现多个文件并不代表需要全部下载。挑选方法：

  1. 看版本号最大的那个（三段式 x.y.z），版本号越大越新。
  2. 注意区分全量包与差分包——首次烧录、量产用全量包；差分包只在 OTA 升级时使用，且必须与设备现网固件的编号对应，不能跨编号使用。
  3. 拿不准时按对应型号的固件版本页确认，或把文件名发到技术支持群让 FAE 确认。

参考文档：Air780EPM 固件与版本 https://docs.openluat.com/air780epm/luatos/firmware/version/ 。

23. Air8202初次使用是否需要刷固件？默认固件灯不亮怎么办？

解答： 结论：出厂有默认固件，但不一定是最新版本，刷一下也可以；早期版本没有操作指示灯，最新版已加上，升级到最新即可看到灯效。

说明：Air8202 是「上电即用」的整机方案，出厂默认带固件与配置后台，接上电就能联网上报。但如果板子来自早期批次，硬件上就没有操作灯，软件再新也不会亮，先确认批次再决定是刷固件还是接受无灯。

处理步骤：

  1. 用 Luatools 读一次版本信息，确认当前固件版本。
  2. 刷入 Air8202 最新固件。
  3. 上电观察操作灯与联网状态是否正常。

参考文档：Air8202 资料 https://docs.openluat.com/air8202/product/ 。

24. 有Air9000p的技术支持吗？升级提示成功但实际还是V1.0.0，一直提示升级到V1.0.1。

解答： 结论：Air9000P 目前没有收录在公开文档站；「提示升级成功但版本号没变」通常出在升级包类型或版本号来源上，可按下面几步自查，同时把升级日志给对接 FAE。

排查步骤：

  1. 升级包不能混用：官方升级规则是——内核固件仅支持差分升级，脚本支持全量升级。带内核的升级必须对每种现网内核版本分别生成对应的差分包（A1→B、A2→B…），只升脚本则准备一份完整最新脚本即可。两种情况搞混，就会出现「提示成功但版本没变」。
  2. 版本号规则：目标版本需为三段式 x.y.z 且大于设备当前版本（V1.0.1 > V1.0.0 满足）。
  3. 确认版本号来自哪一层：如果升级的是脚本、而界面显示的是内核版本号，就会出现「升级了还是 V1.0.0」的表象。
  4. 平台侧：确认设备已归属到当前账号项目，且 IMEI 在升级名单内（非全项目升级时必须把目标 IMEI 加进名单），否则平台不会下发。
  5. 抓升级日志：看 FOTA 回调码定位卡在哪一步——1 连接失败 / 2 url 错误 / 3 服务器断开 / 4 报文错误 / 5 版本号格式错误。

建议：把设备升级日志与 Air9000P 的型号、固件信息一起提给对接 FAE 确认。

参考文档：FOTA 使用说明（含差分包生成与升级规则）https://docs.openluat.com/air780egh/luatos/app/ota/fota/ ，libfota2 与回调码 https://docs.openluat.com/osapi/ext/libfota2/ 。

25. 量产烧录工具端口配置时，教程中两个模组出现两个串口，但我一个模组出现三个串口，该选哪个？使能5/6/7都失败，退出码2无应答。

解答： 结论：只能选 boot 端口。一个模组进入烧录模式后只会出现一个 boot 端口，而且只能保持约 15 秒，其余串口都不是烧录口。

处理步骤：

  1. 先让模组进入 boot/烧录模式，再刷新端口列表，抓住那个 boot 端口立刻开始烧录。
  2. 超过时间会自动退出烧录模式，需要重新进 boot 再试。
  3. 出现三个串口时逐个核对端口名与描述，只有 boot 那个是有效的。
  4. 不确定如何进 boot 可以问 https://ai.luatos.com/ 。
  5. 退出码 2「无应答」通常是端口选错、没进 boot，或线序/驱动问题。

参考文档：量产烧录工具 https://docs.openluat.com/common/Luat_productiontool/ 。

26. 780EPM外接I2C姿态传感器，用3.6V锂亚电池供电还需要做电平转换吗？

解答： 结论：关键不在「要不要电平转换」，而在 I2C 上拉电阻挂到哪个电压——按 3.3V 域设计就不需要电平转换芯片。

说明：

  1. 模组 IO 是 3.3V 域，对外的 VDD_EXT 与 Vref 就是给外部上拉用的参考电源。官方 485 章节写得很直白：双方都是 3.3V 的 IO 电平时，不需要分立元器件电平转换电路或电平转换芯片，只有双方电平不一致时才需要。
  2. I2C 是开漏总线，总线电平由上拉参考电压决定。正确做法是把 SDA/SCL 上拉到模组的 VDD_EXT（或 Vref），不要上拉到 3.6V 的 VBAT，否则总线会跑到 3.6V，超出 3.3V 域 IO 的耐压范围。
  3. 要不要转换取决于传感器侧的 IO 电平：传感器 IO 属 3.3V 域（或 IO 单独供电、耐压足够）→ 不需要转换；传感器 IO 电平随 3.6V 供电一起走 → 要么给它单独 3.3V 供电，要么加电平转换。
  4. 3.6V 锂亚供电本身没问题：在模组 VBAT 输入 3.3V~4.35V 范围内，读取 VBAT 电压时外部硬件电路无需任何处理。
  5. 容易踩的坑：外设若由独立 LDO 供电，LDO 关闭时其输出管脚会有下拉电阻到地，把 I2C 电平拉低（文档实例：Air780EHM 电平设置为 3.3V 时会被拉低到 2.2V 甚至 2V 以下，造成 I2C 通信不正常）。所以上拉参考电压要选模组 VDD_EXT/Vref，而不是外设自己的 LDO 输出。

参考文档：Air780EPM 硬件设计-485 https://docs.openluat.com/air780epm/luatos/hardware/485/ ，ADC 与 VBAT https://docs.openluat.com/air780epm/luatos/hardware/adc/ ，音频设计（LDO 下拉导致 I2C 电平被拉低）https://docs.openluat.com/air780epm/luatos/hardware/audio/ ，管脚详细说明 https://docs.openluat.com/air780epm/product/air780exxpins/ 。

27. air780ept有STM32的demo吗？

解答： 结论：没有。Air780EPT 是 AT 模组，只提供 AT 指令手册，没有针对 STM32 的示例工程。

说明：AT 模组把联网能力封装成串口指令，主控换成 STM32 并不影响用法——STM32 侧只需要一个 UART 驱动加 AT 指令收发逻辑，具体写法参考你自己的 STM32 串口例程即可；AT 手册里每条指令都带使用示例，照着拼报文就行。

资料可以在 https://ai.luatos.com/ 的资料库里查询。

28. air780基站定位免费使用有什么限制吗？

解答： 结论：有明确限制——免费版只支持单基站定位（不含 WiFi 定位），且请求频率限制为 10 分钟最多 1 次。

说明（引自 Air780EGH 基站定位文档）：

  1. 免费服务仅支持单基站定位，无 WiFi 定位，使用旧的后台接口，只使用合宙数据库，当前请求频率限制：10 分钟最多 1 次。
  2. 付费版才有多基站定位与 WiFi + 基站混合定位，相比免费的单基站定位精度更高。
  3. 精度：多基站一般精度在 10~300 米内，单基站误差有可能在 1.5 公里内；搜索到的基站/WiFi 越多，精度越高。

参考文档：基站定位（LBS/WiFi）https://docs.openluat.com/air780egh/luatos/app/common/lbswifi/ 。

29. 新版底层模组（换过存储的版本）什么时候发货？新固件和旧模块兼容性如何？

解答： 结论：工厂目前还在用老版芯片，新版尚未采购。发货节奏与兼容性如下：

  1. 10 月 1 日之后发货：必须使用新固件（底层版本 ≥ V2036）。
  2. 此前已收到的货：可以继续用老固件，不受影响。
  3. 兼容性：新固件兼容旧模块。
  4. 新单：预计 12 月初发货。

建议：产线提前把固件版本管理起来，按批次对应固件，避免 10 月后出现「新固件配旧模块」或「老固件配新模块」的混用。

30. 4G模块有调试指令吗？能打开看log吗？抓到的日志怎么转pcap分析？

解答： 结论：可以，模组支持抓取底层 log，并可按文档转成 pcap 用 Wireshark 分析。

处理步骤：

  1. 按文档说明打开模组日志抓取（需要对应的调试指令与抓取工具）。
  2. 把抓到的日志按文档给的步骤做格式转换，得到 pcap 文件。
  3. 用 Wireshark 打开 pcap，按协议过滤查看信令流程，用于定位注网、鉴权、TCP/MQTT 交互等环节的问题。

参考文档：https://doc.openluat.com/wiki/21?wiki_page_id=1975 与 https://doc.openluat.com/wiki/21?wiki_page_id=2451 。

31. 8601运行中自动重启（看门狗超时），首页待机时发生，什么原因？

解答： 结论：「看门狗超时」意味着喂狗动作没有在超时窗口内执行。既然发生在首页待机时，优先怀疑待机态下有操作占住了 CPU，或让喂狗任务停下来了。

排查方向：

  1. 先确认复位原因：抓串口日志确认是否确实是看门狗复位，而不是掉电、欠压或其他复位源。
  2. 待机态是否被阻塞：首页待机时若有循环 UI 刷新、图像取流、网络等待等阻塞式操作，会挤占喂狗任务的执行时机。
  3. 是否进了低功耗/休眠：进入某些休眠状态后喂狗会停止，若看门狗仍在计时就会超时复位。
  4. 喂狗与业务的时序冲突（本仓库已有先例）：FAQ 2026-09-19 第 16 题记录过同类问题——看门狗库旧版的喂狗逻辑与 SIP 心跳存在时序冲突，导致心跳发不出去并重启，换用新版 exair153x_wdt.lua 即修复。建议先核对你当前使用的看门狗库是否为最新版本。
  5. 复现时记录待机到重启的时长，与看门狗超时值对比，可判断是「偶发一次没喂」还是「稳定周期性没喂」。

建议：把串口日志（含待机阶段与复位前最后几条）提供给对接 FAE 定位。

参考文档：看门狗扩展库 https://docs.openluat.com/osapi/ext/exair153x_wdt/ ，Air860x 系列型号说明 https://docs.openluat.com/air1601/product/air860x/module/model/ ，FAQ 2026-09-19 第 16 题 https://docs.openluat.com/faq/2026-09-19/ 。

32. 付费基站定位选择5年创建订单后自动变成4年金额，是bug吗？

解答： 尚未解答

33. 780EPM的AT模块可以刷成LuatOS的吗？

解答： 结论：可以，刷好对应固件即可。AT 与 LuatOS 只是同一硬件上的两套固件形态，模组硬件本身不变。

处理步骤：

  1. 在固件页确认要刷入的 Air780EPM LuatOS 固件版本。
  2. 用 Luatools 让模组进入 boot 模式，刷入 LuatOS 固件。
  3. 刷完用 Luatools 重新下载 Lua 脚本工程。
  4. 注意刷机会覆盖原来的 AT 固件，若之后还要恢复 AT 功能，请先留好原固件包。

参考文档：Air780EPM 固件与版本 https://docs.openluat.com/air780epm/luatos/firmware/780epm_version/ 。

34. 1020音频板的喇叭怎么接？2pin接口不是0.254间距吗？

解答： 结论：直接插进去试即可，喇叭没有正负之分，接反也不会损坏。

说明：这类音频板的扬声器接口在电气上是对称的，正负极互换只影响相位，对单喇叭播放没有实际影响。装配时如果觉得插拔偏紧，先确认接口型号与线端端子是否匹配，不要用蛮力硬插，避免损伤座子。

参考文档：1020 音频板资料 https://docs.openluat.com/accessory/airaudio_1020/ 。

35. D0003设备一会儿有电一会儿掉线，排查不出问题，和天线有关吗？

解答： 结论：有可能。天线脱落会让信号变差，从而掉线；同时也建议排查保险丝。

排查步骤：

  1. 检查 4G/GNSS 天线是否接好，IPEX 座子有无松动，天线是否被金属外壳遮挡。
  2. 信号弱时模组会反复重搜网，表现就是「一会儿有电一会儿掉线」。
  3. 检查供电保险丝是否接触不良或选型偏小，瞬态大电流时压降过大可能导致复位。
  4. 抓一份完整日志，看掉线前后的信号强度与注网事件，区分是射频问题还是供电问题。

参考文档：可到 https://ai.luatos.com/ 查对应产品资料与排查思路。

36. Air1601资料中有一组USB下载接口（34、35脚），为什么开发板通过Type-C接CH343转UART下载？

解答： 结论：资料里没有说那组 USB 是下载口，Air1601 只能用 DBG UART 下载；各模块的下载方式本来就不一样。

说明：资料中标注的 USB 管脚是模组的 USB 信号，并不等于可烧录接口。Air1601 的官方下载通路是 DBG UART，开发板用 Type-C 接 CH343 转成串口，就是为了接这条 UART。

建议：遇到下载口疑问，先按对应型号的烧录文档确认，不要拿其他型号的习惯套用。

参考文档：Air1601/Air1602 烧录说明 https://docs.openluat.com/air1601/luatos/firmware/burn/ 。

37. RGB转HDMI用的什么模块？有开发板可以验证吗？

解答： 结论：转换模块目前还没加上，后面可能会做一块单独的功能板；单模组形态不好做。

说明：RGB 转 HDMI 需要独立的转换芯片（含 TMDS 编码），对时钟与布线要求较高，塞进模组形态受限，更可行的方式是把转换芯片放在一块功能板/扩展板上。

建议：把你的分辨率、刷新率、接口形式（RGB 位数、并口速率）反馈给对接 FAE/销售，便于评估是否做板以及需要哪些器件。

参考文档：可到 https://ai.luatos.com/ 查已有配件板与方案。

38. Air780EHV在日本为何大部分运营商驻不上网？

解答： 结论：频段不匹配，跟 APN 无关。日本 Docomo/SoftBank/KDDI 的主力覆盖靠 800MHz 的 B19/B18/B26、1.5GHz 的 B11 以及 B21/B42，而 Air780EHV 覆盖的是国内频段（LTE-FDD B1/B3/B5/B8 等），这些频段模组并不覆盖，自然驻不上网。

判断方法：能否驻网只看使用地运营商的频段集合与模组覆盖的频段是否重合，而且必须覆盖该运营商用到的全部频段——只重合一两个频段不能认为可用，因为无法保证所在区域的基站都支持那几个频段。日本方向请改用覆盖对应频段的海外型号。

参考文档：Air780EHV 产品资料 https://docs.openluat.com/air780ehv/product/ ，频段与国家的对应关系 https://docs.openluat.com/air780ehnehu/product/air780ehufreq/ 。

39. 780EGH PSM模式电流维持在70mA左右，手册写的是4uA，怎么回事？

解答： 结论：70mA 说明它根本没有进入 PSM+，或者有额外负载在耗电——文档里常规模式的典型功耗才 7~8mA，70mA 比常规模式还高近 10 倍，不可能是「进了 PSM+ 但没达标」。

先看文档给出的功耗口径（Air780EXX 系列三个模式）：

模式 典型功耗表现
常规模式 较低，7~8mA
低功耗模式 均衡，1.5~2mA
PSM+ 模式 极低，3~12uA

排查方向（按可能性排序）：

  1. 确认真的进了 PSM+：PSM+ 下代码停止运行、RAM 掉电、普通 GPIO 掉电、外设驱动掉电，唤醒后程序从头运行。若日志显示程序在反复重启/唤醒，说明它没有稳定停留在这个状态。
  2. USB 是否还插着：USB 供电与枚举会持续耗电。正式测低功耗必须拔掉 USB，改用电池或程控电源供 VBAT。
  3. 外围电路：LED、电平转换、I2C 上拉、外设 LDO 的静态电流都会叠加到总电流里。
  4. GNSS 是否在主动搜星：含 GNSS 与 Gsensor 的型号（如 Air780EGG、Air780EGP），GPIO23 是 GNSS 备电与 Gsensor 的电源使能脚，两者电源开启后功耗总和约 30uA（属备电功耗）；但主动搜星是 mA 级，若 GNSS 在持续定位，电流就会上到 mA 甚至更高。含 Audio Codec 的型号还会多约 45uA。
  5. 测量方法：需要能测到 uA 级的程控电源或功耗分析仪，普通万用表串联测不准 PSM+ 的真实值。
  6. 手册上的 4uA 是理想条件下的 PSM+ 值，实测要扣掉模组自带 GNSS/Gsensor/Audio Codec 的固有功耗（文档中均有标注）。

参考文档：低功耗模式与 PSM+ 说明 https://docs.openluat.com/air780egh/luatos/app/lowpower/sleep/ 。

40. 780EPM可以接哪些摄像头？

解答： 结论：具体支持哪些型号建议去 https://ai.luatos.com/ 问，那边的资料比人工回答更细；文档侧可以先看 Air780EPM 的摄像头应用与硬件说明。

说明：Air780EPM 支持外接摄像头，官方提供了 AirCAMERA_1040 / AirCAMERA_1050 等配件板与对应 demo，可以直接用现成配件板起步验证。选型时重点核对接口形式、供电方式、分辨率，以及是否需要 H264 编码。

参考文档：https://docs.openluat.com/air780epm/luatos/app/multimedia/excamera/ ，硬件设计说明 https://docs.openluat.com/air780epm/luatos/hardware/design/camera/ 。

41. Air8000W样片远程升级报没有权限错误，在IoT账号我的设备里找不到IMEI怎么办？

解答： 结论：这是两个连着的问题——「我的设备里找不到 IMEI」说明设备尚未归属到你的账号；「报没有权限」多半是平台侧的禁止升级限制。两步都要处理。

处理步骤：

  1. 先做设备归属（设备未归属时，平台不会给它下发任何任务）：电商渠道购买的核心板或测试模组，可以烧录 IoT 平台生成的专属固件把设备归属到该项目名下，或联系店铺客服提供 IMEI 完成归属；批量采购与样片则联系对接商务或 FAE，把 IMEI 清单归属到你提供的 IoT 账号项目下。
  2. 解除「禁止升级」限制：在平台的「我的设备」中选择该 IMEI 所在的项目，点击右边的「解除禁止升级」。文档特别提示：确定导致设备循环升级的异常已经处理完成后，再点击确定解除。
  3. 确认升级名单：非全项目升级时，必须把目标 IMEI 加入升级名单，否则不会下发。
  4. 归属完成后，在「我的设备」按 IMEI 能查到即为成功，此时再创建升级任务。

参考文档：FOTA 使用说明（「解除禁止升级」章节）https://docs.openluat.com/air780egh/luatos/app/ota/fota/ ，设备归属说明 https://docs.openluat.com/air780epm/product/attributioniot/ 。

42. 12V转4V供电电路，输入8.35V能正常输出4V，加到8.4V输出就为0，是什么情况？

解答： 尚未解答

43. 生成量产文件有必要勾选烧录文件系统吗？文件系统镜像制作失败（已用281KB，可用38KB，超出244KB）怎么OTA升级？

解答： 结论：用到文件系统才需要勾选，没用到就关掉。你这次的报错本质是文件太多放不下——已用 281KB、可用只有 38KB，超出 244KB。

处理步骤：

  1. 先确认业务是否真的需要文件系统（只是脚本加少量资源的话，关掉即可）。
  2. 需要的话精简要打包进文件系统的文件：删掉冗余图片/音频/日志模板，或把大文件放到外部存储。
  3. 重新生成量产文件，确认文件系统镜像制作通过。
  4. OTA 升级与文件系统打包不是同一件事：升级包按对应型号与编号制作，差分包不可跨编号使用。

参考文档：量产烧录工具 https://docs.openluat.com/common/Luat_productiontool/ 。

44. 远程表（724UG）无法升级，IOT升级失败和成功都没有日志，怎么抓log？

解答： 结论：多次上报都查不到日志，基本可以判断请求根本没发到服务器，需要抓设备侧 log 定位。

处理步骤：

  1. 抓模组完整日志（Luatools 日志或串口 log），看设备是否成功联网、有没有发起过升级查询请求。
  2. 若根本没发包，重点查 SIM 卡——定向流量卡是否把 iot.openluat.com 加入了白名单。
  3. 确认设备已归属到当前账号项目下，否则平台不会给它下发任务。
  4. 再看升级回调码定位：1 连接失败 / 2 url 错误 / 3 服务器断开 / 4 报文错误 / 5 版本号格式错误。

参考文档：libfota2 与回调码 https://docs.openluat.com/osapi/ext/libfota2/ 。

45. AIR8000W的峰值电流是多大？

解答： 结论：按 1.5A 量级评估。Air8000W 在 4G 发射的同时还要带 WiFi，瞬态电流会比纯 4G 型号更高。

说明：模组的峰值电流出现在发射瞬间，设计供电时必须按峰值留足余量。官方硬件设计文档里给出 Air8000 系列「传输数据时峰值电流可达 1A」，同时配套电源选型要求器件（如功率电感）的饱和电流高于最大峰值电流——例如 DCDC 最大输出 1A 时按峰值 1.5A 选型。电源能力不足通常表现为复位、掉网、开机失败，而不是慢慢变慢。

参考文档：Air8000 硬件设计-电源部分 https://docs.openluat.com/air8000/luatos/hardware/design/power/ 。

46. 连接摄像头有图像出来，但仍弹出摄像头模块初始化超时，还要连接串口吗？

解答： 结论：图像能出来，说明摄像头链路其实已经通了——这个「初始化超时」是软件层的等待超时判定，不是摄像头没工作。串口不是「必须接」，但要定位这个问题，串口日志几乎是必要的。

说明与排查方向：

  1. 官方示例里大量使用「等待某个事件 + 超时」的写法。以 AirCAMERA_1030 的示例为例：等待「摄像头上传完成」事件时设置了 120 秒超时，另外还有 30 秒超时退出阻塞等待的分支——超时提示往往来自「等待某事件」的分支，而图像可能已经由另一条通路取到了。
  2. 所以先要确认这条超时提示来自哪个文件、哪个函数、超时值是多少，只看提示文字无法判断。
  3. 需要补充的信息：完整串口日志，并标出超时提示出现的时机（开机初始化时？拍照后？录像过程中？），以及用的是哪一款摄像头配件板与哪个示例工程。

建议：附上串口日志与摄像头型号、示例工程名，再判断是超时阈值偏短、事件名与实际回调不匹配，还是某一路状态标志没有复位。

参考文档：AirCAMERA_1030 配件板（等待上传完成事件、120 秒超时）https://docs.openluat.com/air8101/luatos/app/accessory/AirCAMERA_1030/ ，Air780EPM 摄像头应用 https://docs.openluat.com/air780epm/luatos/app/multimedia/excamera/ ，摄像头硬件设计 https://docs.openluat.com/air780epm/luatos/hardware/design/camera/ 。

47. 低功耗模式的状态灯一直闪烁，可以关掉吗？

解答： 结论：可以关掉；也可以先去 https://ai.luatos.com/ 问，那边有详细答复和文档链接。要点是别让指示灯挂在「低功耗下无法保持电平」的管脚上。

说明与建议：

  1. 若指示灯由普通 GPIO 驱动，低功耗模式下该 GPIO 可能无法保持高电平，灯就会随唤醒/休眠闪烁。
  2. Air8203 这类板子上 GPIO28 是 AGPIO，低功耗模式下可以保持输出高或输出低，用 AGPIO 控制就能稳定关灯。
  3. 也可以进入低功耗前显式把灯对应的 GPIO 置为关闭状态，并在业务里取消心跳闪灯逻辑。

参考文档：Air8203 系列工业模组使用手册 https://docs.openluat.com/air8203/product/ 。

48. 想自建固件升级服务器，有什么文档吗？

解答： 结论：可以自建，详细答复和文档链接可以去 https://ai.luatos.com/ 获取。

说明：FOTA 的服务器侧协议是公开的，升级查询与下载报文、版本号格式、差分包与编号的对应关系都有明确要求，自建服务器只要按协议返回正确报文即可。

建议：先跑通官方 iot.openluat.com 的升级流程，抓包对照后再自建，能少踩协议细节的坑。注意差分包必须与设备现网固件的编号一致，全量包与差分包不能混用。

参考文档：libfota2 说明 https://docs.openluat.com/osapi/ext/libfota2/ 。

49. 客户在中亚使用780EPM，有哪个型号可以平替？

解答： 结论：Air780EHU。它是亚欧版，覆盖 B1/B3/B5/B7/B8/B20/B28/B38/B40/B41，正好对应中亚与欧洲区域运营商的常用频段。

说明：Air780EPM 是国内全网通型号（B1/B3/B5/B8 + B34/B38/B39/B40/B41），拿到中亚后很可能遇到频段不覆盖的问题。判断标准是模组必须覆盖当地运营商用到的全部频段，只重合一两个频段不算可用。Air780EHU 与 Air780EPM 软件接口一致，脚本基本可直接平移，只需换成 780EHU 的固件。

参考文档：Air780EHU 支持频段及对应国家 https://docs.openluat.com/air780ehnehu/product/air780ehufreq/ ，固件版本 https://docs.openluat.com/air780ehnehu/luatos/firmware/version/ 。

50. Air780EGH用PROTEL99，封装哪里有？资料上的封装尺寸数据有错。

解答： 结论：官方提供的是 PADS / AD / 立创（LCEDA） 三种格式的参考封装，没有 Protel99 格式；Protel99 请取 AD 版本转换。

说明：

  1. 封装下载：Air780EGH 产品手册的「原理图及PCB封装」栏提供 Air780EGH_参考封装20251216(PADS/AD/LCEDA)（Air780EGP、Air780EGG 各有同名文件）。这是官方来源，其他渠道的封装不建议直接使用。
  2. 关于 Protel99：Protel99 是 1999 年的软件（Altium 的前身），官方资料不提供该格式。可行做法是取 AD 版本（可导出 Protel 99SE 兼容格式，兼容性最好），或取立创格式再自行转换。
  3. 「资料上的封装尺寸数据有错」：请指明具体是哪一项尺寸（引脚间距 / 本体长宽 / 焊盘尺寸），并与官方的管脚详细说明交叉核对；确认有误的请反馈给对接 FAE/销售，由原厂修正资料。

参考文档：Air780EGH 产品手册 https://docs.openluat.com/air780egh/product/shouce/ ，管脚详细说明 https://docs.openluat.com/air780egh/product/air780exxpins/ 。

51. VSCode的LuatOS插件是否收费、免费到什么时候？

解答： 结论：目前都是免费的，暂未公布收费时间点，可以放心使用。

说明：LuatOS 的 VSCode 插件与文档、示例一起免费提供，装好后可以完成创建工程、语法检查、下载脚本等操作；同类能力的 Luatools 也一直是免费工具。政策如有调整会在官方渠道公告。

参考文档：VSCode 插件说明 https://docs.openluat.com/osapi/markdown/vscode/ 。

52. Air8202的GNSS天线/4G天线如何选择，推荐的AirANT1564A和J1800哪里采购？

解答： 结论：J1800 是位号，不是天线型号；天线也不能直接照用，必须结合自己的板子和外壳去调。

处理步骤：

  1. 先明确天线形式与安装位置（板载陶瓷或外置 IPEX-SMA、净空区大小、是否金属外壳）。
  2. 找天线厂按你的结构做匹配调试（驻波、效率、方向图）。
  3. AirANT1564A 可以作为起步参考，但最终要用实测结果定型号。
  4. 采购与选型细节可以去 https://ai.luatos.com/ 问。

参考文档：Air8202 资料 https://docs.openluat.com/air8202/product/ 。

53. 合宙能帮忙做板子吗？有这个业务吗？

解答： 结论：有这个业务，可以定制；细节需要私信/联系对接人沟通，做板子一般是有费用的。

说明：定制板通常包含原理图/PCB 设计、打样与调试验证，费用与周期取决于功能复杂度、结构要求和批量。建议先整理需求——功能框图、接口清单、供电与结构约束、天线形式、预计批量，再交给合宙商务评估。如果只是前期验证，也可以先在官方开发板或核心板上把方案跑通，降低定制风险。

参考文档：选型指南 https://docs.openluat.com/SelectionGuide/SelectionGuide/ 。

搜索