跳转至

常见问题 - 2026-09-21

数据日期：2026-09-21

1. Air780EP 是否有私有 AT 命令可写 SN（AT+SN=）

解答： 结论：没有。合宙公开的 AT 指令集里不存在 AT+SN= 这类写 SN 的私有命令，也没有对用户开放的 SN 存储区。

说明：AT 固件面向的是标准模组通信能力（网络注册、PDP、短信、TCP/UDP 等），身份类信息不通过 AT 指令暴露；模组的 SN 属于产线与业务侧数据，只能在应用层自行落地。

处理步骤：

  1. 走 AT 方案时，SN 存在外挂 MCU 的 Flash/EEPROM，或由服务器侧按 IMEI 映射下发，不要指望模组内部有 SN 字段。
  2. 走 LuatOS 方案时，可在脚本里自建 SN 文件（如 io/fskv 存储），由上位机写号工具通过串口下发并落盘。
  3. 量产写号可参考合宙量产/写号工具的做法，先写后校验，保证每台设备的 SN 唯一。

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

2. 使用 4G 模块但想充分利用芯片引脚怎么办

解答： 结论：换引脚引出更多的型号，并按管脚定义表规划复用。4G 模组本身的可用 IO 数量由封装和管脚定义决定，不是靠软件“打开”的。

说明：Air780E 系列模组上，UART1/UART2、USB、SIM、音频、PWRKEY 等已经占掉大量管脚，真正能自由支配的 GPIO 有限；其中部分 IO 还能复用成 PWM、I2C、SPI、ADC。

处理步骤：

  1. 先看目标模组的管脚说明，逐个标出哪些脚是纯 GPIO、哪些有复用、哪些被固定外设占用。
  2. 需要较多 IO 时，优先选 Air780EHM/Air780EPM 这类引出较多的型号或开发板。
  3. IO 仍不够就外扩：用 I2C/SPI 接 IO 扩展芯片，或干脆加一颗小 MCU 做外设管理，模组只负责联网。

参考文档：Air780EPM/Air780EHM 管脚说明 https://docs.openluat.com/air780epm/luatos/hardware/pins/ ，Air780E 资料中心 https://docs.openluat.com/air780e/ 。

3. Air8780P4 主板 PSM++ 休眠电流 1.5mA、拆掉电源指示灯 0.4mA，正常吗？

解答： 结论：不能直接用 1.5mA 判断异常。合宙文档给出的功耗数据都是单模组测试值，整机 1.5mA 说明外围电路在持续耗电，属于需要自行排查的范畴。

说明：拆掉电源指示灯后电流从 1.5mA 掉到 0.4mA，说明指示灯（含限流电阻）占了大约 1.1mA；剩下的 0.4mA 还可能来自 LDO 静态电流、光敏/传感器回路、以及休眠时悬空或带上拉的 IO。

处理步骤：

  1. 烧录合宙的 PSM+ demo，用同一块板做对照，先把“模组本体”与“外围电路”的电流分开。
  2. 逐个拆件（指示灯、光敏电阻、蓝牙、传感器）看电流台阶，台阶大小即该支路的功耗。
  3. 对照原理图检查 LDO 静态电流（qμA 级还是 mA 级）、未使用 IO 是否悬空、上下拉电阻是否一直在耗电。

参考文档：Air8780 资料中心 https://docs.openluat.com/air8780/product/ 。

4. Air8780P4 的 PIN10 3.3V 在进入 PSM++ 模式前后会不定时掉电再上电，正常吗？

解答： 结论：不正常。3.3V 是固定输出，不应该随 PSM++ 进入/退出而掉电再上电。

说明：这类 3.3V 一般来自模组的 VDD_EXT 或板载 LDO。VDD_EXT 属于常开域，PSM 模式下不应被关断；如果是板载 LDO 输出，则要怀疑它的使能脚或输入被其他信号牵动。

处理步骤：

  1. 多测几块板子，先判断是共性问题还是单板问题。
  2. 用示波器同时抓 VBAT 与该 3.3V，看是谁先掉、谁跟着掉，判断是输入被拉垮还是输出被反灌。
  3. 核对原理图：该 3.3V 的来源、LDO 的 EN 脚接法、VBAT 与 LDO IN 是否直连、有没有 IO 反灌路径。

参考文档：Air8780 资料中心 https://docs.openluat.com/air8780/product/ 。

5. Air8203 的 GPIO37 已在软件中拉低，为什么低功耗下仍无法保持低电平？

解答： 结论：GPIO37 不是 AGPIO，进入低功耗后它的状态不受软件保证，只靠代码拉低是留不住的，必须用硬件电阻强下拉。

原理：AGPIO 属于常开供电域，休眠时仍保持输出锁存和电平；普通 GPIO 在深睡时供电域可能被关断或发生复位，输出锁存失效，脚位就浮起来了。R490 用 100K 也偏大，压不住漏电流。

处理步骤：

  1. 把 R490 由 100K 改为 10K 或 5.1K，用硬件强下拉把电平焊死。
  2. 若该脚需要长期保持低电平且对功耗敏感，改用 AGPIO 来驱动。
  3. 板子进休眠后实测该脚电压，确认已稳定在低电平。

参考文档：Air8203 资料中心 https://docs.openluat.com/air8203/product/ 。

6. 8203 V1 板 485_B 下面的 GND 不导通，R3/R4 贴哪个？

解答： 结论：隔离 485 贴 R3，非隔离 485 贴 R4。V1 板上 485_B 下面的 GND 不导通是正常的，不是板子坏。

说明：R3/R4 是 485 接口隔离/非隔离方案的选择电阻，用来决定 485 侧地与主控侧地是否连通。隔离方案两侧地不能共，所以该位置天然不导通；非隔离方案才需要把地打通。

处理步骤：

  1. 先确定自己是隔离 485 还是非隔离 485。
  2. 隔离方案贴 R3，并给隔离侧配独立的隔离电源。
  3. 非隔离方案贴 R4，此时 485 侧 GND 与主控 GND 连通。

参考文档：Air8203 资料中心 https://docs.openluat.com/air8203/product/ 。

7. 8203 充电部分原理图 R436 为 1K，实测 2K，是否正常？

解答： 结论：2K 是正确的。原理图上标 1K 属于标注未同步，按实测 2K 理解即可，不影响充电功能。

说明：这颗电阻只参与充电检测/限流的设定，1K 与 2K 在功能上都能工作，差异体现在检测阈值上；既然批量板实测都是 2K，说明生产 BOM 用的就是 2K。

处理步骤：

  1. 以实测 2K 作为本批板的基准，后续同批板按 2K 核对。
  2. 如对充电电流或检测阈值有明确指标要求，向对接 FAE 确认该电阻的最终取值再定 BOM。

参考文档：Air8203 资料中心 https://docs.openluat.com/air8203/product/ 。

8. 8203 V1/V2 板 PSM+ 下光敏电阻直接接 VBAT 无法关掉，导致功耗偏高，怎么办？

解答： 结论：光敏电阻直连 VBAT 无法被 PSM+ 关断，这部分功耗省不掉；文档侧给出的量级是光照条件下约 1.2mA、暗光下约 1.0mA。先按“拆件法”定位再谈改板。

说明：光敏分压回路直接挂在 VBAT 上，PSM+ 只能关模组内部模块，关不掉这条常通通路；而且暗光下仍有约 1.0mA，说明除光敏之外还有别的支路在耗电（如蓝牙芯片、上下拉、未处理 IO）。

处理步骤：

  1. 先用吹掉法逐个排查：去掉光敏电阻、去掉蓝牙芯片，看电流台阶落在哪一项上。
  2. GPIO37 需要硬件强下拉（R490 由 100K 改 10K/5.1K），否则休眠态电平不定，会带来额外漏电。
  3. 光敏若必须保留，改板时给它的供电加可控开关（MOS 或 LDO 使能），休眠时整条支路断掉。

参考文档：Air8203 资料中心 https://docs.openluat.com/air8203/product/ 。

9. 8183/8783 电信信号总是断，有没有解决办法？

解答： 结论：分两步定位——先用手机确认当地电信信号是否本身就差，再看模组侧抓到的信号值，两者都排除后再怀疑硬件设计。

说明：信号断续常见原因有三类：当地覆盖弱、模组频段与基站不匹配、天线匹配或结构遮挡导致驻波变差。单看现象无法区分，必须拿到信号量。

处理步骤：

  1. 同一位置用手机（电信卡）对比，看是否也明显断续，先判断是网络侧问题还是设备侧问题。
  2. 板子接电脑抓日志，记录 RSRP/CSQ 数值和掉网、重注册的时间点，观察是否有规律。
  3. 换位置、换天线、换卡做交叉验证，把日志与对比结果一起反馈给 FAE 进一步分析。

参考文档：Air8783 资料中心 https://docs.openluat.com/air8783/ 。

10. Air780EPM 有规格书吗？

解答： 结论：有。合宙资料全部公开，Air780EPM/Air780EHM 的产品手册可以直接下载，遇到参数不确定时也可以直接问 ai.luatos.com。

说明：Air780EPM 与 Air780EHM 共用同一份产品手册（文档标题即“Air780EPM/Air780EHM 产品手册”），频段、尺寸、电气参数、管脚定义都在里面。

处理步骤：

  1. 打开 Air780EPM 产品手册页，先看频段、封装尺寸与工作电压是否满足需求。
  2. 硬件设计细节再看对应的硬件设计文档（电源、天线、SIM、UART 等分册）。
  3. 手册里没有的参数，用 ai.luatos.com 提问或找对接 FAE 要正式规格书。

参考文档：Air780EPM/Air780EHM 产品手册 https://docs.openluat.com/air780epm/product/shouce/ 。

11. Air700E 模块的网络频段是多少？700E 分 ECQ/EAQ/EMQ 是哪款？

解答： 结论：Air700E 是超小封装系列，按运营商分成三款：Air700ECQ（移动）、Air700EAQ（电信）、Air700EMQ（联通），三款频段各不相同，不是一颗模组覆盖全网通。

说明：按仓库文档口径，Air700ECQ 支持 FDD B3/B8 + TDD B34/B38/B39/B40/B41；Air700EAQ 支持 FDD B1/B3/B5；Air700EMQ 支持 FDD B1/B3/B8。三款软件硬件互相兼容，按产品实际用的 SIM 卡运营商选型号即可。原文里给的“FDD B1/B3/B5/B8 + TDD B34/B38/B39/B40/B41”其实是 Air780ER/Air780EPM 这类国内全网通模组的频段集合，不是 700E 的频段。

处理步骤：

  1. 先确定产品用哪家运营商的卡（移动/电信/联通），对应选 ECQ/EAQ/EMQ。
  2. 到对应型号的资料中心核对频段是否覆盖目标地区，必要时出货前做场测。
  3. 需要一颗覆盖三家的型号时，改用 Air780 系列国内全网通模组。

参考文档：Air700EAQ 资料中心 https://docs.openluat.com/air700eaq/ ，产品选型手册 https://docs.openluat.com/SelectionGuide/SelectionGuide/ 。

12. 电瓶车内安装定位并外接 INA228 采样，选哪个模组？

解答： 结论：推荐 Air8203 系列。它是这三款里外接最方便的。

说明：Air8202 没有多余接口，留给外设的通道不够；Air8201 系列外接需要经过 BTB 连接线，走线和装配都更麻烦；Air8203 系列引出更充裕，外接 INA228 这类 I2C 采样器件更直接。

处理步骤：

  1. 先确认 INA228 的接口（I2C）与供电需求，核对 Air8203 的 I2C 管脚与电平。
  2. 到 Air8203 资料中心看参考设计和管脚定义，规划采样点（分流电阻位置）与走线。
  3. 若对功耗有要求，注意 INA228 的静态电流与采样频率对整机休眠电流的影响。

参考文档：Air8203 资料中心 https://docs.openluat.com/air8203/product/ 。

13. IOT SIM 卡去哪里买？

解答： 结论：IOT SIM 卡通过合宙商务渠道购买，群里已对接到购买入口。

说明：IOT SIM 卡属于商务物料，不通过文档站自助下单，需要按项目需求（流量套餐、数量、开卡方式）走商务流程。

处理步骤：

  1. 整理项目信息：设备数量、预估月流量、是否需要固定 IP/定向流量、开卡与实名要求。
  2. 联系对接的销售/商务或在技术群里提出需求，由其提供套餐与报价。
  3. 收到卡后先用少量设备验证网络注册与 APN，确认无误再批量开卡。

14. IOT 平台账号（iot.openluat.com）相关问题：添加不了 IMEI、固件分类丢失、页面无反应怎么办？

解答： 结论：页面无反应先清缓存硬刷新；IMEI 误删或添加不了由合宙协助处理；固件列表在平台的“固件升级”里找。

说明：iot.openluat.com 是网页前端，缓存或浏览器插件造成渲染异常是最常见原因；IMEI 与账号的绑定关系在后端，前端无法自行恢复。

处理步骤：

  1. F12 打开开发者工具，清空缓存（Application → Clear storage），再 Ctrl+F5 硬刷新；也可用无痕窗口排除插件影响。
  2. 设备 IMEI 被误删或添加不进账号的，把 IoT 平台账号提供给合宙，由合宙重新添加。
  3. 找不到固件分类时，进平台的固件升级页面查看，固件列表在该功能下管理。

参考文档：合宙 IoT 平台 https://iot.openluat.com/ 。

15. Air780EHU 初始化新音频框架总是失败（同代码在 780EHV 正常），什么原因？

解答： 尚未解答

16. FOTA 差分包：724UG 生成的是 pac 文件，怎么只做差分文件？

解答： 结论：724UG 生成的是 pac 全量包，差分升级要用专用的 dfota 文件；具体生成与使用流程见 Air724UG 的 FOTA 文档。

说明：Air724UG 基于 RDA8910 平台，用常规方式打包产出的是 pac 格式全量固件，不能直接当差分升级包用；差分包需要按 FOTA 工具的方式产出 .dfota.bin。

处理步骤：

  1. 先通读 Air724UG 的 FOTA 文档，确认差分包的制作与下发流程。
  2. 需要现成文件时可直接使用官方提供的 AIR724UG_1.0.1_LuatOS-HMI_V4035_RDA8910.dfota.bin。
  3. 做升级包时注意版本号必须是 xxx.yyy.zzz 形式，否则服务器侧版本比较会出错。

参考文档：Air724UG FOTA https://docs.openluat.com/air724ug/luatos/app/netapp/fota/ 。

17. 升级后一直循环升级且版本号不对（差分包 2022.55-2048.57 升上来是 2048.55），是什么原因？

解答： 尚未解答

18. libfota2 和 libfota3 的区别是什么？

解答： 尚未解答

19. Air780EPM 在香港能直接用吗？和 EHU 是否 pin-to-pin？

解答： 结论：Air780EPM 在香港不能直接用，香港要用 Air780EHU；两者的管脚是兼容的（pin-to-pin），价格需咨询商务。

说明：Air780EPM 是国内频段型号（FDD B1/B3/B5/B8 + TDD B34/B38/B39/B40/B41），不覆盖香港运营商使用的部分频段；Air780EHU 是欧亚版，支持 FDD B1/B3/B5/B7/B8/B20/B28 + TDD B38/B40/B41，覆盖香港（如中国移动香港的 B3/B7/B40）。文档明确写了 EHN/EHU 与 EPM 这类国内型号的差别是硬件差别，不能靠刷不同固件来切换支持地区。

处理步骤：

  1. 确认产品面向香港市场，选型直接改为 Air780EHU。
  2. 香港用卡务必留意 APN：海外运营商一般需要手动设置 APN，设计中要留出配置入口。
  3. 批量出货前做实地场测，同时向商务确认 EHU 的价格与交期。

参考文档：Air780EHU 支持频段及对应国家 https://docs.openluat.com/air780ehnehu/product/air780ehufreq/ 。

20. Air8000 用静态 IP 上以太网时仍自动分配 IP，无法上网怎么办？

解答： 结论：内网没有 DHCP 时必须手动配静态 IP；如果是用 V2050 底层出现的“配了静态 IP 仍自动分配”，升级到 Luatools 3.4.12 版本、或使用该版本配套的 lib 即可解决。

说明：模组侧默认走 DHCP 取址，内网无 DHCP 服务器时自然拿不到地址；而 V2050 上出现的手动配静态 IP 仍被覆盖属于已知问题，已在 3.4.12 的 lib 侧修掉。

处理步骤：

  1. 先确认内网确实没有 DHCP，并准备好可用的静态地址、掩码、网关与 DNS。
  2. 检查代码里静态 IP 配置的调用时机——要在启动网络之前配置，配完再启动网卡。
  3. 升级 Luatools 到 3.4.12，并把工程使用的 lib 换成该版本配套的版本，避免继续引用旧库。
  4. 仍不通时抓网络日志，核对实际生效的 IP、网关与路由表。

参考文档：Luatools 版本更新记录 https://docs.openluat.com/common/Luatools/ ，AirETH_1000 以太网配件 https://docs.openluat.com/air8000/luatos/app/accessory/AirETH_1000/ 。

21. Luatoos 下载文件一直失败，怎么查看日志？

解答： 结论：日志在 Luatools 根目录下的 log 文件夹里，主日志文件名是 main.txt（新版本可能已改名），把日志发出来即可分析；也可以先升级到 3.4.12 版本再复现一次。

说明：下载失败的原因（校验不通过、串口超时、进 boot 失败、固件与型号不匹配）都会记录在这份运行日志中，只看界面提示无法定位。

处理步骤：

  1. 打开 Luatools 安装目录，进入 log 目录，按修改时间找到最近一次的日志文件。
  2. 复制失败前后的完整日志段落（不要只截最后一行报错），连同模组型号、固件版本一起反馈。
  3. 同时把 Luatools 升级到 3.4.12，排除旧版本已修问题造成的干扰，再复现一次。

参考文档：Luatools https://docs.openluat.com/common/Luatools/ 。

22. 脱机/离线下载工具烧录失败（SOC 包，正常单路升级没问题）是什么原因？

解答： 结论：绝大多数是 soc 包在生成或传输环节损坏——重新生成 .soc 文件并重新压缩，同时按工具说明确认进 boot 的方式与端口。单路升级正常说明固件本身没有问题。

说明：脱机/离线下载工具读的是完整压缩包，只要包体在传输中被改动（尤其微信直传 .soc 容易丢包），校验就过不去；而单路升级是逐个文件下发，对包体完整性不敏感，所以会出现“单路能升、脱机不行”的现象。

处理步骤：

  1. 重新生成一个新的 .soc 文件，然后重新压缩成压缩包，不要复用旧包。
  2. 传输时不要用微信直接传 .soc，改用压缩包或网盘，收到后核对文件大小/校验值。
  3. 先读一遍工具的使用说明，确认进 boot 的操作方式与 boot 端口号设置是否正确。
  4. 仍失败时用单路升级交叉验证，并用同一台电脑、同一根线做对比，排除环境因素。

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

23. Air1602 开发板 S11 拨码开关的使用目的和场景是什么？

解答： 结论：S11 是串口复用开关，在贴 Air1602 时让串口 3 和串口 6 可以同时工作，从而 WiFi 与 4G 能并行使用；Air1601 没有 UART6，所以只有 Air1602 支持这个用法。

说明：S9 用于串口通道切换——拨到上面接串口 3，拨到下面接串口 6。S11 解决的是 UART3 被多个外设复用时的冲突问题，让 Air1602 的 UART3 与 UART6 各自独立，一块板同时挂 WiFi 与 4G。

处理步骤：

  1. 按需求确定串口分配：只用 4G 时按 S9 拨到串口 3；要同时用 WiFi 就配合 S11 使用。
  2. 贴的是 Air1601 时不要期待 UART6 可用，它没有这一路。
  3. 拨码改完后重启设备，用日志确认两路串口都正常收发再开始调试。

参考文档：Air1601 Turnkey 开发板下载与调试 https://docs.openluat.com/air1601/product/air1601_turnkey_devboard/download/ 。

24. Air8000 芯片 GPIO 口无效（默认读到 1，接地仍为 1）如何排查？

解答： 结论：先用合宙开发板做对照——同一份代码在开发板上正常，就说明问题出在自研板的硬件设计上，而不是芯片或固件。

说明：GPIO 默认读到 1、接地仍是 1，典型原因是该脚被别的电路强行拉高（外部上拉、驱动反灌）、被配置成了其他复用功能、或者根本没被配置成输入，也可能是读取的 GPIO 编号与实际管脚对不上。

处理步骤：

  1. 对照合宙开发板原理图与管脚定义，核对自己板子上这个 GPIO 的编号、复用关系和外围接法。
  2. 在开发板上跑同一套代码验证（开发板正常即排除软件），再回自研板复现。
  3. 用万用表直接量管脚对地电压：接地时仍为高，说明有外部上拉或反灌路径，顺原理图把这条支路找出来。
  4. 检查是否有其它外设（如 SD、LCD、传感器）复用了同一管脚，导致实际电平被它们决定。

参考文档：Air8000 GPIO 说明 https://docs.openluat.com/air8000/luatos/hardware/gpio/ 。

25. 780 的核心板想后加一个 SIM 卡槽，用现有引脚可以实现吗？

解答： 结论：可以，但要先看核心板的引脚定义。合宙资料全部公开，SIM 所需的 USIM_VDD/CLK/RST/DAT 是否引出、有没有被复用占走，都能查到。

说明：模组本体一定有 SIM 接口，但核心板把他们引到排针时可能被复用（例如与 UART、LCD 共用管脚），能不能后加卡槽取决于这些脚在成品板上是否还空闲。

处理步骤：

  1. 到核心板的资料页查引脚定义表，确认 USIM 四根信号线是否都已引出。
  2. 确认这些脚没有被其他功能复用占用，如果占用了需要先腾出来。
  3. 顺便考虑 SIM_DET（插拔检测）是否也需要——不用检测可以省一根 IO。
  4. 走线尽量短、远离射频与开关电源，并按 SIM 卡的布局要求就近放置卡座。

参考文档：Air780EPM/Air780EHM 管脚说明 https://docs.openluat.com/air780epm/luatos/hardware/pins/ 。

26. 模组 IMEI 前 8 位一批设备都一样吗？

解答： 结论：不能保证一样，同一型号通常共用 TAC，但不同批次、不同型号都可能不同，实际以出货时提供的 IMEI 清单为准。

说明：IMEI 共 15 位，前 8 位是 TAC（型号核准码），由分配机构按型号核准；后 6 位是序列号，1 位为校验位。因此前 8 位是否一致取决于是否属于同一个 TAC，不能作为设备唯一识别依据。

处理步骤：

  1. 设备唯一标识统一用完整 15 位 IMEI，不要用前 8 位做区分。
  2. 量产时以出货随附的 IMEI 清单为准入库，避免自行推定。
  3. 需要把设备与账号绑定时，直接用完整 IMEI 到平台登记。

27. Air720UH 在内蒙用联通卡无法拨通 110，移动卡正常，什么原因？

解答： 结论：走的是 VoLTE，紧急号码由运营商网络侧决定能否接通；Air720UH 本身带 GSM，用移动卡可以强制降 GSM 拨通，联通卡在该区域不行。模组已过维护期，无法通过修改固件解决，只能靠基站侧配合。

说明：Air720UH 同时支持 LTE 与 GSM，Air820UG 则不带 GSM。紧急呼叫的落地方式由网络决定，不同运营商对 VoLTE 紧急呼叫的处理策略不同，就会出现“移动能通、联通不通”的现象。

处理步骤：

  1. 用移动卡在同一位置复测，确认确实存在运营商差异。
  2. 需要 GSM 兜底时，用移动卡并强制降到 GSM 后拨号。
  3. 把现象、位置、时间、卡类型整理后反馈给运营商/基站侧处理。

参考文档：合宙产品选型手册 https://docs.openluat.com/SelectionGuide/SelectionGuide/ 。

28. Air820UG 能回落到 GSM 状态打电话吗？

解答： 结论：不能。Air820UG 不带 GSM，无法回落到 GSM 状态打电话；带 GSM 的是 Air720UH。

说明：是否支持 GSM 回落由模组支持的制式决定，属于硬件能力，不是靠配置开关能补上的。在 VoLTE 不可用的区域，820UG 就只能停留在 LTE 网络上。

处理步骤：

  1. 产品明确需要 GSM 兜底时，选型改用 Air720UH。
  2. 只用 4G 数据业务的场景，820UG 不受影响，按原方案继续即可。
  3. 需要确认目标地区是否有 GSM 覆盖，出货前做实地验证。

参考文档：合宙产品选型手册 https://docs.openluat.com/SelectionGuide/SelectionGuide/ 。

29. Air724UG 新模组里是 LuatOS 固件，可自行烧录 AT 固件吗？A16 和 A20 可替换吗？

解答： 结论：可以自行烧录 AT 固件（例如 AirM2M_720U_V401886_LTE_AT）；A16 与 A20 属于正常的 PCB 版本管理，对用户没有区别，现在出货的都是 A20。

说明：Air724UG 模组不锁固件类型，LuatOS 固件与 AT 固件可以互刷，换固件后按对应开发方式使用即可。A16/A20 这类代号是生产端的板级版本标识，电气与功能一致，不影响应用开发。

处理步骤：

  1. 用 Luatools 按 Air724UG 的烧录流程刷入目标 AT 固件。
  2. 刷完后确认模块能正常注册网络、AT 指令有响应，再进入业务调试。
  3. 拿到不同批次的模组时不必纠结 A16/A20 标识，按同一套资料开发即可。

参考文档：Air724UG 资料中心 https://docs.openluat.com/air724ug/ 。

30. Air700E 有没有合适的信号放大器（类似室内手机信号放大器）？

解答： 结论：合宙没有模组专用的信号放大器。模组的射频表现与手机基本一致，需要增强就按手机信号放大器的方案自行选型，可在淘宝等渠道搜索。

说明：模组本身已是标准 4G 射频前端，室内信号放大器属于外部系统（室外天线 + 放大 + 室内天线），是否有效取决于现场基站覆盖与安装方式，不是换个模组或加个配件就能解决的。另外 Air700ECT 只支持移动频段，选放大器时要与频段对应。

处理步骤：

  1. 先用手机在同一位置看信号格数与实测速率，判断是否确实处于弱覆盖区。
  2. 选放大器时核对支持频段是否覆盖设备使用的运营商频段。
  3. 安装后做前后对比测试（RSRP、速率），确认确有改善再批量使用。

参考文档：Air700EAQ 资料中心 https://docs.openluat.com/air700eaq/ 。

31. Air780EHM 以太网传输卡顿（4G/串口不卡），如何解决？

解答： 结论：用内置 CRC 库替换自己写的 crc32 即可解决卡顿。

原理：以太网收发时需要对整包数据做 CRC 校验。在脚本层逐字节自己实现 crc32，开销随包长线性增长，大包或高流量时会把 CPU 时间吃掉，表现出来就是“4G/串口不卡、以太网卡”。改用内置的 C 实现，同样的数据量下耗时大幅下降。

处理步骤：

  1. 找到工程里自实现的 crc32 函数，改为调用内置 CRC 接口。
  2. 顺便检查数据搬运链路（如逐字节拷贝、频繁字符串拼接）是否也有类似开销，能下沉到底层实现的尽量下沉。
  3. 改完用同样的测试条件复测卡顿是否消失，并观察 CPU 占用变化。

参考文档：Air780EPM 常用加解密示例 https://docs.openluat.com/air780epm/luatos/app/common/crypto/ 。

32. Air780EGH 用脱机软件一个都烧录不了，怎么办？

解答： 结论：先查三件事——是否真的进了 boot、boot 端口号是否选对、是否按工具说明操作；再确认这批板子之前有没有成功烧录过。

说明：“一个都烧录不了”通常不是固件问题，而是进 boot 的时序/按键操作或端口选择出了问题；如果连之前成功过的板子现在也烧不进，则要怀疑工具版本、驱动或线材。

处理步骤：

  1. 严格按工具使用说明重做一次进 boot 的操作，确认工具能识别到 boot 端口。
  2. 核对工具里选中的端口号与设备管理器里出现的端口是否一致（不要选到普通日志口）。
  3. 换一根 USB 线、换一个 USB 口、换一台电脑交叉验证。
  4. 确认这批板子在改动前是否成功烧录过，用“能烧的板子”做对照缩小范围。

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

33. Air510U 首次上电 AT+CIICR 报 +CME ERROR:3，连上后不断电就正常，为什么？

解答： 结论：多数是还没完成网络附着就发起了 PDP 激活。先用 AT+CGATT? 轮询等到返回 +CGATT: 1，再做 AT+CIICR，就不会再报 +CME ERROR: 3。

说明：+CME ERROR: 3 表示操作不被允许，常见于附着未完成或 SIM/网络状态不满足条件时强行激活 PDP；“连上后不断电就一直正常”也印证了这只是首次上电时的时序问题。

处理步骤：

  1. 上电后先 AT+CPIN? 确认 SIM 已就绪，再 AT+CREG?/AT+CGREG? 确认注册状态。
  2. 用 AT+CGATT? 轮询，等到 +CGATT: 1 后再执行 AT+CIICR；不要用固定延时硬等。
  3. 检查 APN 设置是否正确，必要时用 AT+CSTT 指定运营商 APN 后再激活。
  4. 仍复现时把完整 AT 交互日志（含时间戳）发出来分析。

参考文档：Air510W/Air510U 资料中心 https://docs.openluat.com/air510w/product/ 。

34. Air510W 的 1PPS 管脚能否关闭？

解答： 结论：1PPS 可以通过 GNSS 对应串口发指令关闭，具体指令见 Air510W 使用手册 V1.3。需要注意：红灯由 GPIO16 控制、蓝灯由 GPIO1 控制，这两路可以关；黄灯接的是定位 PPS，不能单独关掉（除非关掉 PPS 输出本身）。

说明：1PPS 是 GNSS 秒脉冲同步信号（精度 20ns/24h RMS），由 GNSS 芯片输出，开关在 GNSS 的配置指令里，不在模组的通用 IO 控制里。

处理步骤：

  1. 打开 Air510W 使用手册 V1.3 的“配置与控制指令”章节，找到 PPS 脉冲设置相关指令。
  2. 通过 GNSS 对应的串口发送关闭指令，观察 1PPS 管脚输出是否停止。
  3. 若只为省功耗而关灯，可只关红灯/蓝灯（GPIO16、GPIO1），保留 PPS 供定位同步使用。

参考文档：Air510W 使用手册——配置与控制指令 https://docs.openluat.com/air510w/product/UserManual_510W/07-%E9%85%8D%E7%BD%AE%E4%B8%8E%E6%8E%A7%E5%88%B6%E6%8C%87%E4%BB%A4/ 。

35. 780EHU 初始化音频框架失败、EHV 正常；另外语音验证码场景（仅转发 PCM）如何实现？

解答： 结论：仅转发 PCM 数据这个过程需要定制固件（不走本地解码播放），选型上国内用 Air780EHM、欧亚用 Air780EHU。

说明：标准固件里的音频框架是“收 → 解码 → 本地播报”的完整链路，语音验证码场景只需要把 PCM 原样转出去，链路上的解码与播放模块要裁掉或旁路，属于固件层面的裁剪，所以要定制。前提是先解决音频框架初始化失败的问题，否则定制也跑不起来。

处理步骤：

  1. 先定位 EHU 上音频框架初始化失败的原因（固件版本与库版本是否匹配、音频通道配置是否正确），保证基础链路可用。
  2. 把需求（型号 + 仅转发 PCM + 目标运营商区域）提交给对接 FAE/销售，确认定制固件与固件编号。
  3. 国内选 Air780EHM、欧亚选 Air780EHU，避免选到不匹配区域的型号。

参考文档：Air780EHU/EHN 产品手册 https://docs.openluat.com/air780ehnehu/product/shouce/ 。

36. 780EHT 收到 URC 后 RI 下降沿到串口输出数据延时约 480uS，MCU 唤醒丢数据，能否延长该延时？

解答： 结论：这个功能本身是支持的——Air780EHT 收到 URC 就会产生 RI 脉冲，在 9600 波特率下“收到即唤醒”不会丢数据。如果仍然丢数据，建议用合宙核心板单独测试以排除自研板硬件问题，固件可用 2025 版本。

说明：RI 脉冲宽度是模组侧给出的、固定的，可配置余地有限；“下降沿到串口输出延时约 480uS”是模组内部处理时间。对丢数据的场景来说，关键不是去延长这个延时，而是让 MCU 在脉冲内完成唤醒并做好串口接收缓冲。

处理步骤：

  1. 用合宙核心板搭最小系统复现，先确认是模组侧问题还是自研板（电平转换、串口走向、MCU 唤醒电路）问题。
  2. 核对 MCU 的唤醒时间与串口波特率设置，确保唤醒后能及时进入接收状态。
  3. 检查 RI 是否接了上拉/电平转换，避免边沿被拖缓或整形失败。
  4. 保留实测波形与串口日志，连同现象一起反馈给 FAE。

参考文档：Air780EHU/EHN 固件版本页 https://docs.openluat.com/air780ehnehu/luatos/firmware/version/ 。

37. LuaToos 的 MCP 工具还能用吗？

解答： 结论：可以用。按官方文档完成配置即可在 Luatools 里使用 MCP 工具。

说明：MCP（Model Context Protocol）这一路是把 Luatools 的能力暴露给 AI 助手调用的通道，配置方式与支持的客户端都在文档里说明。注意工具版本要跟上，旧版本可能没有该入口或配置项已变更。

处理步骤：

  1. 打开 MCP 配置文档，按步骤填写服务地址与启动参数。
  2. 先在客户端侧确认能列出工具列表，再让助手实际调用一次验证连通。
  3. 调不通时先升级 Luatools 到较新版本，并检查本机防火墙是否拦了本地端口。

参考文档：Luatools MCP 工具配置 https://docs.openluat.com/ai/mcp_cli/ 。

38. IoT 物联网卡管理平台怎么换绑手机号？

解答： 结论：管理平台只用于管理与查询，不支持自助换绑手机号。

说明：物联网卡管理平台的账号信息与开卡时的登记信息绑定，手机号属于实名/通知用信息，前端没有开放修改入口。

处理步骤：

  1. 把需要变更的账号、原手机号与新手机号整理好。
  2. 联系对接的销售/商务提交变更，由后台处理。
  3. 变更后用新号码验证登录或短信通知是否正常。

参考文档：合宙 IoT 平台 https://iot.openluat.com/ 。

39. Air8000W 作为中继，通过蓝牙收集其他设备数据再上报服务器，能实现吗？

解答： 结论：可以实现，已有用户在按这个方案做功能开发（Air8000W 做蓝牙采集 + 4G 上报的中继）。所需的 IOT SIM 卡可联系合宙购买。

说明：Air8000 系列本身支持 BLE 与 4G 并发，作为中继即由它充当 BLE 侧的主机/从机，把周边设备的数据收上来，再通过 4G 链路转发到服务器。数据格式转换、缓存与断网补传都在脚本层实现。

处理步骤：

  1. 先明确蓝牙侧的角色（中心设备还是外围设备）、对端协议与数据速率，据此确定并发数量与 MTU 分包策略。
  2. 确定 4G 上报协议（MQTT/HTTP/TCP），并设计断网时的本地缓存与补传逻辑。
  3. 与合宙沟通 IOT SIM 卡的套餐与开卡方式，先用少量样机打通端到端链路。
  4. 注意 BLE 与 4G 同时工作时对功耗和内存的占用，必要时做任务优先级安排。

参考文档：Air8000 资料中心 https://docs.openluat.com/air8000/product/ 。

40. 合宙是否提供 layout 服务？自画板子对照参考什么？

解答： 结论：合宙不提供代做 layout 的服务，但自画板子可以对照合宙开发板/核心板的原理图逐项检查，遇到问题也建议先跟官方原理图对比着排查。

说明：模组类产品的踩坑点高度集中在电源、射频走线、SIM 走线、复位与进 boot 电路这几块，合宙的参考资料（开发板与核心板原理图、硬件设计分册）正是针对这些点写的，对照检查能覆盖绝大多数常见故障。

处理步骤：

  1. 从目标模组的资料中心下载开发板/核心板原理图与硬件设计文档。
  2. 逐项核对：供电与去耦、VBAT 走线宽度、天线 50Ω 匹配与净空、SIM 走线长度与防护、PWRKEY/RESET 与进 boot 时序。
  3. 把差异项列成清单，必要时把原理图局部截图给 FAE 复核。

参考文档：Air780EPM/Air780EHM 硬件设计文档 https://docs.openluat.com/air780epm/luatos/hardware/ 。

41. Air8101 淘宝店价格不对，是否不散卖？

解答： 尚未解答

42. 嘉立创 EDA / PROTEL99 的封装有吗？

解答： 结论：没有 PROTEL99 封装；封装资料以官方文档提供的下载为准（常见为 PADS、AD、立创 EDA 等格式）。

说明：Protel99 已是十分老的 EDA 工具，官方不再维护对应格式；若必须用它，可从现有封装（如 AD/PADS）转换，但转换后务必逐脚核对，尤其是焊盘尺寸与管脚编号。

处理步骤：

  1. 到目标型号的资料中心，在文件下载区确认可用的封装格式。
  2. 用其他格式转换或按机械尺寸图自行绘制 Protel99 封装。
  3. 投板前用 1:1 打印图与实物模组/机械图对比，确认管脚间距与外形尺寸无误。

参考文档：合宙资料中心（以具体型号为准，如 Air780EPM https://docs.openluat.com/air780epm/product/ ）。

43. 有没有推荐入门的开发板？

解答： 结论：入门推荐 Air780E 系列开发板，资料最全、例程最多、社区问题也最好搜。

说明：Air780E 是 4G Cat.1 的经典型号，官方文档覆盖了从烧录、联网、socket、低功耗到各类外设的完整链路，适合先把“烧固件 → 跑 demo → 改代码”这条主线走通。

处理步骤：

  1. 到 Air780E 资料中心看“快速上手”部分，按说明装好 Luatools、连上开发板。
  2. 先烧录官方 demo 验证工具链与硬件都正常，再逐步改自己的业务代码。
  3. 后续按项目需要（外设接口、功耗、海外频段）再切换到对应型号，如 Air780EPM/780EHM、Air780EHU。

参考文档：Air780E 资料中心 https://docs.openluat.com/air780e/ 。

44. AirLCD 1070 屏幕的软件资料可以发一下吗？

解答： 结论：AirLCD 1070 的软件资料在配件文档页，可直接打开获取。

说明：AirLCD_1070 属于配件类，文档归在 /accessory/ 下，与本体模组的资料分开，里面的软件包、例程与接线说明以该页为准。

处理步骤：

  1. 打开 AirLCD_1070 文档页，先看硬件接口与接线要求。
  2. 在其软件/例程区下载配套资料，按例程初始化屏幕（分辨率、接口、时序）。
  3. 与模组的管脚定义交叉核对，确认所用接口（SPI/RGB）与供电满足要求再上板。

参考文档：AirLCD_1070 https://docs.openluat.com/accessory/AirLCD_1070/ 。

45. 700E 模块网络频段是多少？

解答： 结论：Air700E 分 ECQ/EAQ/EMQ 三款，频段各不相同：Air700ECQ（移动）为 FDD B3/B8 + TDD B34/B38/B39/B40/B41，Air700EAQ（电信）为 FDD B1/B3/B5，Air700EMQ（联通）为 FDD B1/B3/B8。

说明：Air700E 是 10×13×1.7mm 的超小封装系列，硬件上无法一颗同时覆盖三家运营商，所以按运营商拆成三个版本。原文给出的“FDD B1/B3/B5/B8 + TDD B34/B38/B39/B40/B41”是 Air780ER/Air780EPM 这类国内全网通模组的频段集合，不是 Air700E 的频段，选型时不要按这个口径判断。

处理步骤：

  1. 先确定产品用哪家运营商的卡，对应选 ECQ（移动）/ EAQ（电信）/ EMQ（联通）。
  2. 到对应型号的资料中心核对频段覆盖，海外或偏远地区出货前务必场测。
  3. 需要一颗覆盖三大运营商的方案，改用 Air780 系列国内全网通模组。

参考文档：Air700EAQ 资料中心 https://docs.openluat.com/air700eaq/ ，Air700EAQ 产品页 https://docs.openluat.com/air700eaq/product/ 。

46. Air780ER 用到哪几个频段？

解答： 结论：Air780ER 支持 FDD B1/B3/B5/B8 + TDD B34/B38/B39/B40/B41，这一组频段可以覆盖中国移动、电信、联通三大运营商。

说明：Air780ER 是国内 4G Cat.1 模组，17.7×15.8×2.3mm 封装。对国内项目来说这组频段已经是全网通规格；若面向海外，则要换成对应区域的型号（如北美 Air780EEN、欧亚 Air780EEU 等），频段完全不同。

处理步骤：

  1. 国内项目直接用默认频段方案，无需额外筛选。
  2. 海外项目先确认目标国家/运营商频段，再对照选型手册选对应型号。
  3. 印度、东南亚等地区虽然频段接近，但运营商众多，出货前必须场测。

参考文档：Air780ER 产品页 https://docs.openluat.com/air780er/product/ 。

47. Air780EPM 料号有规格书吗？

解答： 结论：有规格书。合宙资料全部公开，Air780EPM/Air780EHM 的产品手册可直接在线查看或下载，也可用 ai.luatos.com 快速定位。

说明：料号与模组型号是一一对应的，规格书按型号发布，不按料号单独出；选型或采购时把料号对回型号再看手册即可。

处理步骤：

  1. 用料号确认对应型号（Air780EPM / Air780EHM）。
  2. 打开产品手册页，核对频段、封装尺寸、工作电压与功耗等关键参数。
  3. 需要正式盖章版本或商务资料，联系对接销售/FAE 提供。

参考文档：Air780EPM/Air780EHM 产品手册 https://docs.openluat.com/air780epm/product/shouce/ 。

48. 原来推荐的降压芯片 RY8132 停产了，有替换型号推荐吗？

解答： 结论：可以选 JW5357 或 JWH5103，也可以按合宙的硬件文档自己选型。

说明：这类降压芯片的替换核心看三点——输入电压范围要覆盖 VBAT（含充电时的最高电压）、持续与峰值电流要留足发射时的尖峰余量、效率与静态电流是否满足低功耗要求。合宙的电源设计文档里给了完整的选型思路和参考型号。

处理步骤：

  1. 先算清负载：模组发射时的峰值电流是选型的主要约束，不能只按平均电流选。
  2. 对照硬件设计文档的电源章节，按输入范围、电流能力、效率与封装逐项比对 JW5357/JWH5103。
  3. 打样后实测带载与动态响应，重点看发射瞬间电压跌落是否在允许范围内。

参考文档：Air780EPM 电源设计 https://docs.openluat.com/air780epm/luatos/hardware/design/power/ 。

49. Air724UG 可以用 SPI0 同时接 CH390H 和 LoRa SX1262 吗（片选互锁）？

解答： 结论：可以，通过 CS/NSS 片选互锁让两个从机分时复用同一条 SPI0；前提是确认 luat_spi_lock / luat_spi_unlock 在你的固件版本上是有效实现。

原理：SPI 是总线型接口，MOSI/MISO/CLK 三线可以共享，靠各自独立的片选决定当前与谁通信。所谓“互锁”就是保证同一时刻只有一个片选有效，并在切换前完成总线占用与释放，否则会出现两个从机同时驱动 MISO 导致数据错乱。

处理步骤：

  1. 硬件上把 CH390H 与 SX1262 的 SCLK/MOSI/MISO 并联，CS 各自独立接到不同 GPIO。
  2. 软件上用加锁接口包住一次完整的事务（拉低片选 → 收发 → 拉高片选 → 释放），不要跨事务持锁。
  3. 两个从机的 SPI 模式（CPOL/CPHA）与最高时钟要分别设置，切换时重新配置总线参数。
  4. 先用单从机分别验证通路，再合起来测并发场景，用逻辑分析仪看片选与数据的时序关系。

参考文档：Air724UG SPI 驱动说明 https://docs.openluat.com/air724ug/luatos/app/driver/spi/ 。

50. Air8780 模块大多数引脚是否引出？

解答： 结论：Air8780 模块大多数引脚都引出来了，具体管脚定义见模块文档页。

说明：Air8780 属于引出较全的类型，做定制底板时可用 IO 比较充裕；但仍有部分脚被固定功能（电源、射频、USB、SIM 等）占用，规划前要按管脚表逐个确认复用关系。

处理步骤：

  1. 打开 Air8780 模块文档页，按管脚表标注哪些是纯 GPIO、哪些有复用、哪些被固定外设占用。
  2. 把项目所需外设（UART/I2C/SPI/PWM/ADC）与管脚表对照，确认没有冲突。
  3. 低功耗场景要额外确认所选 IO 的供电域，需要休眠保持的优先用 AGPIO。

参考文档：Air8780 模块文档 https://docs.openluat.com/air8780/hardware/ 。

51. Air780EPM 香港/海外使用选型问题

解答： 结论：Air780EPM 在香港不能直接用，香港及海外场景要选 Air780EHU；两者管脚兼容，可以直接替换。

说明：Air780EPM 是国内频段型号，覆盖 FDD B1/B3/B5/B8 + TDD B34/B38/B39/B40/B41；Air780EHU 是欧亚版，支持 FDD B1/B3/B5/B7/B8/B20/B28 + TDD B38/B40/B41，能对上香港运营商（如中国移动香港 B3/B7/B40）的频段。文档明确写了这类型号之间的差别是硬件差别，刷固件换不了地区。

处理步骤：

  1. 面向香港/海外市场的项目，选型阶段就锁定 Air780EHU，不要先按 EPM 画板。
  2. 保留手动设置 APN 的入口——海外运营商基本都需要配 APN 才能入网。
  3. 批量出货前做实地场测，并把价格与交期向商务确认。

参考文档：Air780EHU 支持频段及对应国家 https://docs.openluat.com/air780ehnehu/product/air780ehufreq/ 。

52. Air780 连不上网，最近出现很多次找不到原因，怎么办？

解答： 尚未解答

53. Air720UG-NFC 买的 780EPM 在 IoT 平台误删 IMEI，如何重新添加到账号下？

解答： 结论：把 IoT 平台账号提供给合宙，由合宙重新把 IMEI 添加回你的账号下。

说明：IMEI 与平台账号的绑定关系存在后端，设备被误删后前端没有自助恢复入口；只要设备本身没变，IMEI 仍可被重新登记。

处理步骤：

  1. 先把被删设备的完整 15 位 IMEI 整理成清单。
  2. 把 IoT 平台账号与 IMEI 清单一起提供给合宙对接人，申请重新添加。
  3. 恢复后在平台确认设备已回列表，并做一次联网验证确保数据上报正常。

参考文档：合宙 IoT 平台 https://iot.openluat.com/ 。

54. Air8000 使用以太网静态 IP 上不了网、仍自动分配 IP 怎么办？

解答： 结论：升级到 Luatools 3.4.12、并使用该版本配套的最新 lib，这个“配了静态 IP 仍自动分配 IP”的问题即解决。

说明：问题出在库侧的处理逻辑，不在用户代码；升级工具并同步换库后生效，只升工具不换 lib 可能仍复现。

处理步骤：

  1. 把 Luatools 升级到 3.4.12。
  2. 把工程里引用的网络 lib 换成该版本配套的最新版，避免继续走旧实现。
  3. 重新配置静态 IP（地址、掩码、网关、DNS）后再启动网卡，用日志确认实际生效的地址。

参考文档：Luatools 版本更新记录 https://docs.openluat.com/common/Luatools/ 。

55. Air780EHM 的 fota2 和 fota3 区别是什么？

解答： 尚未解答

56. Air780EHV 人脸识别失败会死机，如何解决？

解答： 结论：换用合宙提供的新固件 Air8601_deposit_cabinet_20260921.luatos，该版本已修复人脸识别失败后死机的问题。

说明：这个现象是人脸识别流程异常时没有做兜底保护，导致后续处理卡死；新固件在识别失败分支上加了容错，属于已知问题已修复，不是硬件故障。

处理步骤：

  1. 用 Luatools 把 Air8601 相关固件升级到 Air8601_deposit_cabinet_20260921.luatos 这一版。
  2. 升级后重复原来会死机的操作步骤（多次识别失败、遮挡摄像头等）做回归验证。
  3. 若仍复现，保留完整串口日志与复现步骤反馈给 FAE，便于定位具体分支。

参考文档：Air8601 人脸识别寄存柜模组使用手册 https://docs.openluat.com/air1601/product/air860x/air8601/luatos/ 。

57. Air780EHV 机器简单的广告、视频播放可以实现吗？对视频格式、容量有要求吗？

解答： 结论：可以实现简单的广告/视频播放。视频本身没有特殊格式要求，大视频放 TF 卡；单个视频转成 MJPG 格式后，1024×600 分辨率、30fps 目前看是有希望的，还在测试中。

说明：MJPG 是逐帧 JPEG 压缩，解码开销低，适合这类没有硬件视频解码器的平台；分辨率与帧率越高，脚本层搬运和解码的负担越大，所以容量与码率要控制。

处理步骤：

  1. 素材先转成 MJPG 格式，分辨率对齐到 1024×600，帧率先按 30fps 试，不行再下调。
  2. 大文件放 TF 卡，走文件读取播放；小片段也可打包进固件资源。
  3. 先跑通单段循环播放，再叠加广告轮播（列表、切换时机）等业务逻辑。
  4. 实测流畅度与内存占用，留出余量后再确定最终分辨率/帧率组合。

参考文档：Air780EHV 视频播放器 https://docs.openluat.com/air780ehv/luatos/app/multimedia/ui/videoplayer/ 。

58. Air8601 固件合并失败，提示缺少 sd_card.lua、存在同名文件，怎么处理？

解答： 结论：先把固件资源梳理清楚再合并——缺少的 lua 文件补齐，重名文件改名或只保留一个；另外确认 Luatools 的扩展卡版本是否一致。

说明：合并固件时工具会把项目里的资源一起打包，遇到同名文件会冲突或互相覆盖；提示缺少 sd_card.lua 说明资源清单里有引用但目录里没有实际文件，属于资源不完整。

处理步骤：

  1. 按报错逐个核对资源清单，把缺失的 lua 文件从原始工程或官方 demo 里补齐。
  2. 把重名但内容不同的文件改名并同步修改引用，内容相同的只保留一份。
  3. 确认 Luatools 版本与工程使用的扩展卡（固件资源）版本一致，避免清单口径不同。
  4. 重新合并并烧录验证，确认挂载的文件系统里文件齐全。

参考文档：Air8601 使用手册 https://docs.openluat.com/air1601/product/air860x/air8601/luatos/ 。

59. Air780EHV 录音定位工牌用脱机软件无法烧录怎么办？

解答： 结论：多为 soc 包损坏或进 boot 操作不对——重新生成 .soc 并重新压缩，注意不要用微信直传 .soc，再按工具说明确认进 boot 的方式与端口。

说明：脱机烧录读的是完整包体，传输中改动一个字节就会校验失败；而单路升级对包体完整性不敏感，所以常表现为“单路能升、脱机不行”。

处理步骤：

  1. 重新生成 .soc 文件并重新压缩成包，不复用旧包。
  2. 用压缩包或网盘传输，避免微信直接传 .soc 造成丢包。
  3. 严格按工具使用说明做进 boot 的操作，核对 boot 端口号是否选对。
  4. 仍失败时用单路升级做对照，并用同一台电脑与同一根线复测，排除环境影响。

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

60. Air780EHU 初始化新音频框架失败，同代码在 780EHV 正常，什么原因？

解答： 尚未解答

61. Air780EHV/EHU 语音验证码（仅转发 PCM 数据）如何实现？

解答： 结论：仅转发 PCM 的语音验证码场景需要定制固件；国内用 Air780EHM，欧亚用 Air780EHU。

说明：标准固件的音频链路会做本地解码与播放，而这个场景只需要把 PCM 原样转出去，属于链路上的裁剪，需要在固件层面处理。型号必须与目标运营商区域匹配，否则即使定制也入不了网。

处理步骤：

  1. 明确需求细节：PCM 的采样率/位宽/通道、转发接口（UART/USB/I2S）、是否需要双向。
  2. 按区域选型号：国内 Air780EHM，欧亚 Air780EHU，避免选错频段。
  3. 把需求提交给对接 FAE/销售，确认定制固件与固件编号后再推进。

参考文档：Air780EHU/EHN 产品手册 https://docs.openluat.com/air780ehnehu/product/shouce/ 。

62. Air780EGH 用脱机工具下载失败，单路升级正常，是什么问题？

解答： 结论：按 soc 包损坏的思路处理——重新生成 .soc 并重新压缩，注意微信传输可能丢包，同时确认 boot 端口与工具使用说明。单路升级正常说明固件本身没问题。

说明：脱机/离线工具对包体完整性要求严格，传输环节的丢包或压缩工具差异都会导致失败；单路升级逐文件下发，对完整性不敏感，两者表现不一致正是这个原因。

处理步骤：

  1. 重新生成 .soc 并重新压缩，不要复用之前的包。
  2. 改用压缩包/网盘传输，收到后核对文件大小。
  3. 按工具说明确认进 boot 方式，核对 boot 端口号与设备管理器一致。
  4. 用单路升级交叉验证，确认固件可用后，再排查脱机流程本身。

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

63. Air8201 资料在哪里？

解答： 结论：Air8201 的资料在它的资料中心页，直接打开即可。

说明：Air8201 系列（含 8201G 等）统一归在 Air8201 系列页下，产品手册、硬件设计、固件版本都在其中。

处理步骤：

  1. 打开 Air8201 资料中心，先看产品与管脚定义，确认接口资源满足需求。
  2. 需要联网/外设开发资料时，按页内的 LuatOS 与硬件设计分支继续深入。
  3. 若需要具体型号（如 8201G）的资料，按页内链接进入对应子页。

参考文档：Air8201 资料中心 https://docs.openluat.com/air8201/ 。

64. Air8203 资料在哪里？

解答： 结论：Air8203 的资料在产品页，注意根路径没有索引，要进到 product/ 页面。

说明：Air8203 的文档目录只有产品子页（含产品手册与附件），直接访问根路径会返回 403，所以链接必须指到 /air8203/product/。

处理步骤：

  1. 打开 Air8203 产品页，先看产品手册与硬件资料。
  2. 需要原理图、封装等附件时，在页内的文件下载区获取。
  3. 与自己的底板设计对照时，重点核对电源、低功耗相关 IO 与 485 部分的接法。

参考文档：Air8203 产品页 https://docs.openluat.com/air8203/product/ 。

65. Air780EPM 有规格书吗？资料在哪里？

解答： 结论：有，资料全部公开。Air780EPM/Air780EHM 的产品手册可直接查看，也可用 ai.luatos.com 提问定位。

说明：Air780EPM 与 Air780EHM 共用一份产品手册；手册之外，硬件设计、固件版本、应用示例都按目录分支发布，便于逐层深入。

处理步骤：

  1. 先看产品手册，确认频段、封装与电气参数是否满足需求。
  2. 再做硬件设计核对（电源、天线、SIM、串口等分册）与应用层资料查阅。
  3. 手册没覆盖的参数，用 ai.luatos.com 提问或找 FAE 索取正式规格书。

参考文档：Air780EPM/Air780EHM 产品手册 https://docs.openluat.com/air780epm/product/shouce/ 。

66. Air780EHM 与 Air780EHU 有什么区别，如何选型？

解答： 结论：国内项目用 Air780EHM，欧亚/海外项目用 Air780EHU。两者的差别是频段（硬件），不是软件。

说明：Air780EHM/Air780EPM 支持国内全网通频段（FDD B1/B3/B5/B8 + TDD B34/B38/B39/B40/B41）；Air780EHU 是欧亚版，支持 FDD B1/B3/B5/B7/B8/B20/B28 + TDD B38/B40/B41。文档明确写了这类型号间的区别是硬件区别，不能通过刷不同固件来切换支持的国家或地区。

处理步骤：

  1. 先确定产品的销售区域：国内 → EHM；欧亚/海外 → EHU（或按国家选对应型号）。
  2. 海外场景记得在软件里留出 APN 设置入口，海外卡通常必须手配 APN。
  3. 型号变更时同步核对管脚与外围电路差异，出货前做实地场测。

参考文档：Air780EHU 支持频段及对应国家 https://docs.openluat.com/air780ehnehu/product/air780ehufreq/ 。

67. Air820UG 能回落到 GSM 打电话吗？手册没写。

解答： 结论：不能。Air820UG 不带 GSM，无法回落到 GSM 打电话；带 GSM 的是 Air720UH。手册没写是因为该型号本身就不支持这一制式。

说明：支持的通信制式属于模组硬件能力，不在软件可配置范围内；在 VoLTE 覆盖不到或运营商不支持 VoLTE 紧急呼叫的区域，820UG 无法用 GSM 兜底。

处理步骤：

  1. 产品必须保留 GSM 语音兜底能力时，选型改用 Air720UH。
  2. 确认目标地区的 GSM 覆盖是否还在（部分地区已在退网），出货前做场测。
  3. 只用 4G 数据业务的场景不受影响，按原方案继续即可。

参考文档：合宙产品选型手册 https://docs.openluat.com/SelectionGuide/SelectionGuide/ 。

68. Air720UH 联通卡无法拨通 110 什么原因？

解答： 结论：联通卡在该区域走 VoLTE，紧急号码能否接通由网络侧策略决定；移动卡正常，需要 GSM 兜底时可用移动卡并强制降 GSM 拨通。模组已过维护期无法改固件，只能靠基站侧配合。

说明：Air720UH 支持 LTE + GSM，具备回落条件，但实际是否回落由网络与运营商策略决定，设备侧无法强制让运营商侧接受该呼叫；因此现象只在联通卡上出现。

处理步骤：

  1. 用移动卡在同一位置复测，确认是运营商差异而非设备个体差异。
  2. 需要打通时，用移动卡并强制降 GSM 后拨号验证。
  3. 把位置、时间、卡类型与复现记录整理后反馈给运营商/基站侧处理。

参考文档：合宙产品选型手册 https://docs.openluat.com/SelectionGuide/SelectionGuide/ 。

69. Air780EPM 香港能用吗？

解答： 结论：不能，香港需要用 Air780EHU；两者管脚兼容，可以直接替换。

说明：Air780EPM 是国内频段型号，不覆盖香港部分运营商频段；Air780EHU 覆盖 FDD B1/B3/B5/B7/B8/B20/B28 + TDD B38/B40/B41，能对上香港运营商（如中国移动香港 B3/B7/B40）。型号差别是硬件差别，不能靠刷固件切换地区。

处理步骤：

  1. 面向香港的项目直接选 Air780EHU，不要按 EPM 画板后再改。
  2. 软件里保留 APN 手动配置入口，海外卡通常必须配 APN 才能入网。
  3. 出货前做实地场测，并向商务确认价格与交期。

参考文档：Air780EHU 支持频段及对应国家 https://docs.openluat.com/air780ehnehu/product/air780ehufreq/ 。

70. Air780 想增加 SIM 卡槽，用现有引脚可以实现吗？

解答： 结论：可以，先查核心板的引脚定义。资料全部公开，USIM 四根信号线是否引出、是否被复用占用都能查到，也可以在文档站或 ai.luatos.com 上定位到具体页面。

说明：模组本体必然有 SIM 接口，能否后加卡槽取决于核心板把这些脚引到哪里、有没有被 UART/LCD 等功能复用占用。

处理步骤：

  1. 查核心板引脚定义表，确认 USIM_VDD/CLK/RST/DAT 是否都已引出且空闲。
  2. 评估是否需要 SIM_DET 插拔检测，不需要可以省一根 IO。
  3. 新增卡座走线尽量短，远离射频与开关电源，按 SIM 布局要求就近放置。

参考文档：Air780EPM/Air780EHM 管脚说明 https://docs.openluat.com/air780epm/luatos/hardware/pins/ 。

71. Air8101 带 OV5640 做验证，淘宝价格不对，是否散卖？

解答： 尚未解答

72. Air8000 芯片 GPIO 口无效怎么排查？

解答： 结论：先用合宙开发板做对照——同一套代码在开发板上正常却在自己的板子上读到恒定高电平，说明问题在自研板的硬件设计上。

说明：GPIO 默认读到 1、接地仍为 1，常见原因有三种：外部电路强行拉高（上拉电阻、其他驱动反灌）、该脚被复用成别的功能、或者代码里操作的 GPIO 编号与实际管脚对不上。

处理步骤：

  1. 对照开发板原理图逐项核对该脚的外围接法，确认没有多余上拉或反灌路径。
  2. 在开发板上复跑同一份代码验证软件侧没问题，再回自研板定位。
  3. 用万用表量管脚实际电压；再查该脚是否被其它外设（SD/LCD/传感器）复用占用。
  4. 确认无误仍异常时，把原理图局部与代码片段一起给 FAE 复核。

参考文档：Air8000 GPIO 说明 https://docs.openluat.com/air8000/luatos/hardware/gpio/ 。

73. Air780EGH 脱机下载失败怎么办？

解答： 结论：从 soc 包和传输环节入手——重新生成 .soc 并重新压缩，不要用微信直传 .soc，同时确认进 boot 方式、boot 端口号与工具版本。

说明：脱机下载工具读完整包体，包体在生成或传输中被改动就会失败；进 boot 操作与端口选择错误也会表现为同样的失败现象。

处理步骤：

  1. 重新生成 .soc 并重新压缩成包后重试，不复用旧包。
  2. 用压缩包或网盘传输，收到后核对文件大小。
  3. 按工具说明确认进 boot 方式与 boot 端口号，必要时换线换口换电脑交叉验证。

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

74. Air780EPM 香港使用选型

解答： 结论：不能用 Air780EPM，要用 Air780EHU；两者管脚兼容，可以替换。

说明：EPM 是国内频段型号，不覆盖香港运营商使用的部分频段；EHU 是欧亚版（FDD B1/B3/B5/B7/B8/B20/B28 + TDD B38/B40/B41），能满足香港的网络需求。型号差别属硬件差别，刷固件换不了地区。

处理步骤：

  1. 选型直接定 Air780EHU，并按它的管脚与频段要求做设计。
  2. 软件里保留 APN 手动配置能力，海外卡一般需要设置 APN。
  3. 批量前做实地场测，并向商务确认价格与交期。

参考文档：Air780EHU 支持频段及对应国家 https://docs.openluat.com/air780ehnehu/product/air780ehufreq/ 。

搜索