跳转至

常见问题 - 2026-09-09

数据日期：2026-09-09

1. 阿里云iot的域名要换吗？阿里云GlobalSign Root R1根证书即将到期，对合宙模块使用有影响吗？

解答： 结论：只有做服务端证书校验（mqtts/HTTPS 强制验证）的设备才会受影响，代码里没做证书校验的一般不受影响。

原理：TLS 握手时客户端要用内置的根证书去验证服务器证书链，当阿里云使用的 GlobalSign Root R1 根证书到期、而设备端仍以旧根证书校验时，就会出现证书校验失败、连接不上。是否真正受影响，要看阿里云官方通知以及你的接入方式。

处理办法：

  1. 更新 CA 证书与客户端证书，替换 io.readFile("/luadb/ca.crt") 读取的文件内容后重新烧录进模组文件系统。
  2. 建立连接时把根证书与校验开关一起配上，例如：mqttc = mqtt.create(nil, "120.55.137.106", 8883, {server_cert = io.readFile("/luadb/ca.crt"), verify = 1})。
  3. verify = 1 表示开启校验；使用域名接入时证书要与域名匹配，IP 直连场景通常需要额外处理。
  4. 生产环境不建议关闭校验，属于临时降级手段仅用于过渡验证。

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

2. 合宙量产烧录工具(脱机版)链接是空的，下载不了文件

解答： 结论：该链接已修复，刷新页面等几分钟即可；也可以走 Luatools 内的资源入口或 CDN 直链下载。

说明：合宙量产烧录工具（脱机版）属于公共资源，发布后 CDN 同步存在延迟，短时间内出现空链接、点不动属正常现象。下载正式版本时请核对版本号，不要使用群内转发的来历不明压缩包。

操作路径：

  1. 等 5 分钟后刷新原链接重试。
  2. 打开 Luatools，依次进入“合宙各种资源入口 → 软件资源下载 → 公共资源 → 合宙量产烧录工具(脱机版) → 对应正式版本”。
  3. 或直接访问 https://cdn18.luatos.com/files/public/LuatOS_Factory_offline/ 下载。

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

3. luatools选择soc提示名字大于23字节

解答： 结论：资源文件不能超过 23 字节，这里不要选 .soc 文件，应选择对应的固件文件。

说明：LuatOS 的下载内容分为底层内核（固件/core）与脚本资源两类，资源文件名（含路径）受底层文件名表限制，超过 23 字节就会直接报错。.soc 属于固件范畴，放错位置也会触发这个提示。

做法：

  1. 核对资源文件名与目录名，控制在 23 字节以内，尽量使用短英文名。
  2. 在 Luatools 项目管理中把 .soc 选到内核固件位置，脚本目录作为资源添加。
  3. 去掉中文名与过深的目录层级，重新下载。

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

4. 用Luatools烧录Air780EGG时，bootloader下载完后下载ap.bin失败，之后USB识别不到，是什么原因？

解答： 结论：这类“bootloader 下载完成后写 ap.bin 失败、随后 USB 识别不到”的现象，基本可判定为模组 bootloader 受损，需走商务/下单群返修处理，不建议继续反复尝试烧录。

说明：bootloader 是模组启动与下载的第一段程序，一旦损坏，Luatools 能识别到下载口却无法完成后续分区写入，失败后模组可能停在异常状态、USB 不再枚举。该批约 200 个中有 5、6 个出现，属于可统计的小比例不良。

处理办法：

  1. 记录模组丝印、IMEI、Luatools 完整日志与复现步骤。
  2. 通过下单群/商务反馈，按返修流程处理。
  3. 同批次先做小批抽检，避免直接大批量投产造成损失。

参考文档：LuatOS 文档 https://docs.openluat.com/

5. Air780EGG支持自定义OTA url吗？

解答： 结论：支持，Air780EGG 的自定义 OTA 服务端升级用 fota2 实现，可以指定自己的升级地址和版本策略。

说明：fota2 是 LuatOS 提供的开放 FOTA 库，不依赖合宙 IoT 平台的推送通道，由设备端主动向自定义 URL 查询升级包、下载并按需重启升级，适合自建升级服务器的场景。使用时需保证模组联网正常，且升级包格式与固件版本配套。

做法：

  1. 在脚本中 require fota2，配置升级查询地址、项目/产品标识与当前版本号。
  2. 服务器按约定返回版本信息与下载地址，设备端完成下载后重启生效。
  3. 升级包的 core/脚本要与设备型号、固件版本配套，避免跨版本乱刷。
  4. 首次联调先用小包验证，再推向量产。

参考文档：LuatOS 文档 https://docs.openluat.com/

6. Luatools使用需要登录吗？注册时获取验证码提示参数错误

解答： 结论：Luatools 不登录也能正常使用；注册时提示“参数错误”通常与验证码（短信通道）服务临时异常有关，不是账号本身的问题。

说明：验证码依赖第三方短信通道，通道波动或触发频控时会返回参数错误；登录只影响云端项目、资源同步类功能，本地烧录下载不受影响。

做法：

  1. 稍后重试，或更换网络环境（如手机热点）再获取验证码。
  2. 核对手机号格式，确认短信未被系统拦截。
  3. 持续报错时联系技术人员，提供报错截图与时间。

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

7. Air780EPM是否可以直接采集AD放大板数据，同时用GPIO控制开关电源，替代ESP32S3，并4G外发？

解答： 结论：可以。Air780EPM 具备 MCU 控制能力，可直接采集 AD 放大板数据、用 GPIO 控制开关电源，并把数据通过 4G 外发，用一颗模组替代“MCU + 外挂 4G 模组”的组合。

说明：这类需求本质是“采集 + 控制 + 联网”三合一。Air780EPM 在 LuatOS 下提供 ADC 采集、GPIO 输出与 4G 联网能力，业务逻辑用 Lua 编写，可省掉一颗 ESP32S3 以及额外的串口通信设计。

做法：

  1. 用 ADC 接口采集放大板输出，注意量程与分压，必要时在软件里按分压比还原。
  2. 用 GPIO 控制开关电源时注意驱动能力，功率较大的负载用三极管/MOS 或负载开关扩流。
  3. 通过 socket/mqtt/http 把数据经 4G 上报，做好断线重连与离线缓存。
  4. 供电与天线按硬件手册设计，先小批验证 ADC 精度与控制时序。

参考文档：https://docs.openluat.com/air780epm/

8. 低功耗模式下，Air780EPM哪款型号功耗最低？

解答： 结论：同系列各型号的休眠功耗没有本质差别，选型时不能只看“哪款功耗最低”，实际功耗取决于使用条件——网络制式、休眠深度、外设配置与业务节奏。

说明：低功耗是整机指标，同样的模组在不同休眠策略（普通休眠/PSM+）、不同外设配置、不同心跳周期下，实测电流可能差很多，脱离条件比较没有意义。

建议：

  1. 明确业务模型：多久上报一次、是否需要保持长连接、外设是否常供电。
  2. 到对应型号的低功耗文档查看休眠/PSM+ 用法，按自己的业务实测基线值与平均值。
  3. 不确定时可咨询官方 AI 助手 https://ai.luatos.com/，或把测试条件发给技术支持协助分析。

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

9. Air8000U核心板+AirCAMERA_1050拍出的照片有许多黑点是怎么回事？

解答： 结论：照片出现大量黑点，优先怀疑摄像头供电异常——请用万用表实测摄像头供电是否为 2.8V 或更低，建议换用 3.3V 的 LDO 供电后复测。

说明：摄像头感光与输出对供电电压、纹波、瞬态电流很敏感，供电跌落或噪声会直接表现为画面黑点、噪点、条纹。Air8000U 核心板 + AirCAMERA_1050 出现黑点，多数问题在供电而非摄像头本身。

排查步骤：

  1. 用万用表测量摄像头 VDD 实际电压，确认是否掉到 2.8V 及以下。
  2. 检查 LDO 型号与带载能力，换用 3.3V LDO 单独给摄像头供电再拍。
  3. 用示波器观察供电纹波与拍照瞬间的跌落，必要时加大去耦电容、优化走线。
  4. 换供电后仍复现，换一只摄像头交叉验证，并保留照片与硬件版本反馈技术支持。

参考文档：https://docs.openluat.com/air8000/product/

10. Luatools下载一直失败/下载成功后屏不亮/无法识别USB，可能是什么问题？

解答： 结论：下载失败、下载成功后屏幕不亮、USB 不识别，绝大多数是供电、USB 链路或本地环境问题，少数是硬件异常，按“供电→USB→BOOT→环境”的顺序排查即可覆盖大部分情况。

常见原因：

  1. 供电不足：4G 发射是毫秒级大电流，电源带载能力或线材压降不足会导致下载中断。
  2. USB 布线/线材问题：数据线不含 D+/D-、线材过长、走线差或经过扩展坞。
  3. BOOT 供电问题：如 VDD-EXT 需与 BOOT 短接才能稳定进入下载模式。
  4. 安全软件拦截：360 等杀软阻断 Luatools 进程或串口。

排查步骤：

  1. 换短数据线直插主机 USB 口，并用稳压电源给板子独立供电。
  2. 按硬件手册确认 BOOT 进入方式与跳线/短接要求。
  3. 关闭杀毒软件，删除 Luatools 目录下 log 后重开工具再试。
  4. 情况复杂时加企业微信，由技术支持协助定位。

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

11. 离线烧录器1.1.5批量无法烧录Air8000的板子，但Luatools可以烧录，是什么问题？

解答： 结论：离线烧录器批量烧不了 Air8000 但 Luatools 能烧，问题多出在离线烧录器的配置上，重点检查 ini 文件中的串口端口是否配对正确。

说明：离线烧录器靠 ini 配置串口、波特率、文件路径等参数，串口端口填错或与实际 USB 转串口枚举不符，就会一直“无法打开串口”。另外，模组出厂可能是 AT 版本，未必会自动进入烧录模式，需要靠 BOOT+RESET 组合键进入。

排查步骤：

  1. 核对 ini 中的串口端口（COM 号）与实际设备枚举一致，换 USB 口后要同步修改。
  2. 沿用在 Luatools 上已成功的烧录方法与文件，说明文件与接线本身没问题。
  3. 若一直无法打开串口，检查驱动、线材与端口占用情况。
  4. 确认模组进入烧录模式：按 BOOT+RESET 组合键，观察下载口是否出现。

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

12. 合宙iot平台登录不了/注册平台账号提示参数错误是什么原因？

解答： 结论：登录不了或注册提示参数错误，多为验证码/服务临时异常，也可能与注册流程填写不当有关，先重试再核对流程。

排查步骤：

  1. 稍后重试，或换网络（如手机热点）避免短信通道频控。
  2. 核对手机号格式、验证码是否过期、注册信息是否填写完整。
  3. 清除浏览器缓存或用无痕窗口重新打开 https://iot.openluat.com/ 。
  4. 持续异常时提供报错截图与时间，联系技术人员排查。

参考文档：https://iot.openluat.com/

13. 合宙iot平台/aircloud平台后续会收费吗？

解答： 结论：合宙 IoT 平台目前已收费，具体标准以官方页面公示为准；其他平台的收费政策也以官方最新说明为准。

说明：平台收费通常按设备数、消息量或套餐档位计费，测试阶段一般有免费额度供联调；正式量产前应先确认资费，避免上线后产生预期外成本。自建服务器方案不经过合宙平台，不产生平台费用。

做法：

  1. 访问收费标准页 https://docs.openluat.com/value/iot/ 查看现行资费与套餐。
  2. 按设备规模与上行频率估算月消息量与费用。
  3. 有私有化部署或批量采购需求，可通过官方企业微信群联系商务。

参考文档：https://docs.openluat.com/value/iot/

14. Air780EP和Air780EPT模组焊盘有没有做包边/阻隔？会不会贴片受热不均？

解答： 结论：没有这个问题，Air780EP 与 Air780EPT 的焊盘不存在“包边/阻隔导致贴片受热不均”的情况，正常 SMT 过炉即可。

说明：Air780 系列累计出货数千万级，焊盘结构与回流焊工艺经过大规模量产验证，没有因焊盘结构导致受热不均的已知问题。生产中若出现焊接缺陷，应从钢网开孔、锡膏量、回流曲线、PCB 焊盘设计等方面排查，而不是怀疑模组本身。

做法：

  1. 按硬件手册推荐的焊盘尺寸与钢网开孔设计 PCB。
  2. 使用推荐回流曲线，避免超温或升温过快。
  3. 出现虚焊/连锡时先做首件与炉温曲线验证。

参考文档：LuatOS 文档 https://docs.openluat.com/

15. Air780EPM天线加10M延长线后信号从25降到12，是带不动吗？

解答： 结论：加 10 米延长线后信号从 25 降到 12，主要是延长线带来的插损与阻抗不匹配，不一定是模组“带不动”。

说明：射频链路对阻抗与损耗非常敏感，10 米延长线要做到 50 欧阻抗匹配、损耗可控，成本会明显上升；普通线材损耗大，信号强度下降属正常现象，还会影响收发性能与驻波比。

处理办法：

  1. 优先缩短天线到模组射频口的距离，尽量不使用长延长线。
  2. 必须延长时选用低损耗、阻抗匹配的正规射频线。
  3. 也可在天线端加合适的放大器或更高增益天线来补偿。
  4. 用驻波表/网分确认阻抗匹配，避免反射损伤射频口。

参考文档：LuatOS 文档 https://docs.openluat.com/

16. 休眠时部分Air780EPM低功耗电流7µA，正常3µA，是模块个体差异吗？

解答： 结论：休眠电流 7µA 与 3µA 的差异属正常个体差异，约有 3% 左右的芯片功耗会偏高一点，不影响功能与使用。

说明：芯片制造存在正常工艺离散性，静态漏电在微安级有小幅波动是普遍现象，3µA 是典型值，7µA 仍在可接受范围。判断是否异常要结合休眠策略与整机电流来看，而不是只看单点数值。

建议：

  1. 在相同休眠策略、相同外围条件下横向比较多台设备，看分布而非单点。
  2. 若整机底电流远超预期，按低功耗排查清单检查外设漏电（LED、看门狗、上拉电阻等）。
  3. 有疑虑时提供测试条件与电流波形，由技术支持协助确认。

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

17. Air8000W的4G+WIFI+以太网做路由代理是否是成熟方案？

解答： 结论：Air8000W 用 4G + WiFi + 以太网做多网路由代理目前不算成熟方案，建议先用 Air8300 测试；多网自动切换可以先做，代理网络部分可暂不做。

说明：Air8300 定位多网工控路由类应用，销量不错，相关方案相对成熟；Air8000W 更偏模组形态，直接做复杂路由代理还需评估。功能上可先实现“多网自动切换/优先级切换”，这部分的库支持相对完善。

建议步骤：

  1. 用 Air8300 搭建原型，验证多网切换、链路保活、外网出口等关键功能。
  2. 先落地多网自动切换（有线/WiFi/4G 的优先级与故障倒换）。
  3. 代理网络（NAT、转发、内网穿透等）按最终产品需求，与官方评估是否需要定制。

参考文档：https://docs.openluat.com/air8000/product/

解答： 结论：Air8000W 做 4G 转 WiFi AP，手机连不上网、电脑正常且 airlink 超时，需从 RNDIS 状态、WiFi 芯片状态与日志三方面排查。

说明：手机与电脑连接 AP 时走的网络模式、DHCP 与路由行为可能不同，手机侧还会触发 IPv6、代理自动探测等额外行为；airlink 超时说明主机与 WiFi 侧通信异常，需要用日志来定位。

排查步骤：

  1. 确认 RNDIS 是否已开启（USB 网络模式影响主机与模组的数据通道）。
  2. 抓 UART10 日志（波特率 2M）分析 airlink 通信过程。
  3. 换不同品牌手机、断电重启后复现，排除单一终端问题。
  4. 检查 WiFi 芯片固件版本是否与当前软件匹配。
  5. 保留日志与复现步骤，提交研发定位。

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

19. Air780EGP是否支持VBAT直连电池？

解答： 结论：支持，Air780EGP 的 VBAT 可以直接连接电池，按电池规格与模组供电要求设计即可。

说明：VBAT 是模组的主供电输入，可由锂电池直接供电，但要注意电压范围、发射瞬时大电流以及走线与储能电容。锂电供电场景建议带过放保护，避免电池过放损坏。

设计要点：

  1. VBAT 就近并联大容量低 ESR 电容，满足发射瞬时电流需求。
  2. 走线要短而粗，减少压降。
  3. 电池需带保护板或外部过放保护电路。
  4. 按硬件手册确认充电/电源管理部分的连接方式。

参考文档：LuatOS 文档 https://docs.openluat.com/

20. AIR724UG-NFC是否支持中东频段B1/B3/B7/B8/B20？

解答： 结论：AIR724UG-NFC 不支持 B7 和 B20 频段，中东地区使用前需按目标国家实际频段确认选型。

说明：不同国家和地区的运营商使用频段不同，模组射频方案在出厂时就已确定支持的频段组合，不能通过刷固件“新增”频段。B7（2600MHz）、B20（800MHz）在该型号上不支持，若目标网络依赖这两个频段，需另选支持的型号。

建议：

  1. 先查清目标国家运营商的主用频段清单。
  2. 对照该型号的频段支持表（产品文档/规格书）确认是否覆盖。
  3. 有缺口时向商务确认是否有频段更全的型号，并在目标国家实地场测。

参考文档：https://docs.openluat.com/air724ug/

21. AIR724UG-NFC/AIR724UG-Air780EUV是否支持TTS？

解答： 结论：Air724UG 系列（含 AIR724UG-NFC）不支持 TTS 语音合成，型号本身不支持 TTS 时也没有对应的替代推荐；若有 NFC 采购需求，AIR724UG-NFC 无蓝牙版本仍可购买，价格为 42 元（NFC 含税）。

说明：TTS 需要固件与硬件音频链路共同支持，不是叠加一个库就能实现，凡硬件/固件未提供 TTS 能力的型号，无法通过脚本补齐。选型时应先确认语音能力，再定型号。

建议：

  1. 明确是本地语音合成（TTS）还是仅需音频播放/通话，两者要求不同。
  2. 需要 TTS 时选带语音能力的型号，不要指望在 Air724UG 上实现。
  3. 仅需 13.56MHz NFC 读写功能时可继续选用 AIR724UG-NFC，型号与价格以官方渠道为准。

参考文档：https://docs.openluat.com/air724ug/

22. Air8000的GPS只能获取到秒级时间吗？是否有PPS输出脚？

解答： 结论：GNSS 可获取的时间精度为秒级；Air8000 系列除没有 GNSS 的型号外，都有 1PPS 输出脚，1PPS 精度为 20ns，内部 GNSS 芯片与 510W/530W 同款，性能可参考 510W/530W。NTP 时间误差在 5 秒内属正常。

说明：GNSS 通过卫星授时可得到秒级的绝对时间，PPS（脉冲每秒）是硬件级秒脉冲信号，用于更高精度的时间同步与对齐；NTP 走网络路径，受网络往返延迟影响，误差在数秒内属正常范围。

使用要点：

  1. 需要秒级时间，用 GNSS 解析结果即可；需要更高精度对齐，用 1PPS 脚做硬件同步。
  2. NTP 定时校时，误差 5 秒内可不处理；对精度敏感可缩短校时周期并优化网络。
  3. 天线摆放与净空会影响首次定位时间与稳定性。

参考文档：https://docs.openluat.com/air8000/

23. Air8000T通电越久，获取到的ntp时间误差越大是为什么？

解答： 结论：Air8000T 通电越久 NTP 时间误差越大，主要是网络波动造成的累积延迟；经验值误差在 5 秒内都算正常，可定时重新授时。

说明：NTP 校时依赖网络往返时间，网络抖动、基站切换、上行拥塞都会让单次校时结果产生偏移，若长期只靠本地时钟自走，误差会缓慢累积。AGPS/基站授时按 3GPP 协议流程，如不需要可以关闭，减少干扰。

处理办法：

  1. 定时（如每天或每隔数小时）重新发起 NTP 校时，而不是只校一次。
  2. 选择稳定的 NTP 服务器，并结合网络状况重试。
  3. 不需要 AGPS/基站授时可关闭对应功能。
  4. 对时间敏感的业务，配合 GNSS 授时精度更高。

参考文档：LuatOS 文档 https://docs.openluat.com/

24. AIR700ECQ的WIFI定位不准，能升级到百度/高德等其他服务商的数据库吗？

解答： 结论：合宙定位服务使用的就是高德数据库，不能“升级”到百度/高德等服务商的其它数据库；WiFi/基站定位本身是相对位置，存在偏差属正常。若需要更准，需结合实际场景与型号进一步确认（注意 AIR700EC 和 AIR700ECQ 不是同一款）。

说明：WiFi 定位的原理是扫描周边 WiFi 的 MAC，去数据库反查已知热点位置再推算坐标；数据库覆盖、热点移动、信号漂移都会带来误差，所以结果本身就是“大概位置”，不是 GPS 级的绝对定位。

建议：

  1. 明确业务可接受的误差范围，要求较准时考虑加装 GNSS。
  2. 定位偏差稳定且较大时，提供实测坐标、时间与信号环境，协助核对。
  3. 提需求时写清完整型号，AIR700EC 与 AIR700ECQ 不是同一款，避免选错。

参考文档：LuatOS 文档 https://docs.openluat.com/

25. AIR780EGP低功耗/长连接场景功耗比竞品高，如何优化？

解答： 结论：AIR780EGP 在低功耗/长连接场景功耗偏高，可从业务策略与功能配置两方面优化，具体参考官方低功耗文档 https://docs.openluat.com/air780epm/luatos/app/lowpower/sleep/#93 。

说明：发完数据后电流保持约 10 秒、休眠时电流有波动，都是正常的网络行为（模组与基站之间需要保持一定时间的连接状态与接收窗口）；有的竞品发完数据立刻降到极低电流，可能是主动放弃与基站的保活，容易被基站踢掉，稳定性反而更差。这是策略取舍，不是单纯的功耗高低。

优化建议：

  1. 不需要定位时关闭 GNSS 测试，GNSS 常开是常见耗电点。
  2. 按低功耗文档配置休眠策略，合理设置心跳与上报周期。
  3. 减少不必要的外设常供电。
  4. 仍不理想时，可把板子寄回，由官方协助定位与调试。

参考文档：https://docs.openluat.com/air780epm/luatos/app/lowpower/sleep/#93

26. Air780EHV的SIP通话新固件下有杂音/死机/呼入问题，如何解决？

解答： 结论：Air780EHV 的 SIP 通话在新固件下出现杂音/死机/呼入异常，先按官方提交的脚本修改并同步更新固件与 Lua 库；若固件 V2050 通话声音不正常，可换回 V2047；另外端口号填 0 会导致呼入问题。

说明：SIP 通话涉及底层 core 与 exsipclient 等库的配合，固件与库版本不一致、或配置项（如端口号）取值不当，都会引发呼入呼出异常；声音异常多与音频链路/固件版本相关。

处理步骤：

  1. 参考提交 https://gitee.com/openLuat/LuatOS/commit/06c4622ae8883745f73f7e6a858877c91aa0700c 修改脚本并测试。
  2. 固件与 Lua 库同步更新到配套版本，不要只换其一。
  3. 若 V2050 通话声音不正常，换回 V2047 验证。
  4. 检查 SIP 配置中的端口号，不要填 0。
  5. 仍异常时抓取完整 SIP 日志，附型号与固件版本提交研发。

参考文档：https://gitee.com/openLuat/LuatOS/commit/06c4622ae8883745f73f7e6a858877c91aa0700c

27. DTMF码在Air780EHV-SIP上的功能进展如何？

解答： 结论：Air780EHV-SIP 上的 DTMF 功能还在处理中，处理完成后会第一时间通知。

说明：DTMF（双音多频）用于通话中按键交互（如拨分机、输入密码），需要底层音频与 SIP 信令共同支持，属于在研功能。当前版本暂未提供，无法给出确定时间点。

建议：

  1. 项目若强依赖 DTMF，先按当前可用能力设计流程，或与技术支持确认替代方式。
  2. 持续关注官方固件更新与公告，功能上线后及时升级验证。
  3. 有明确节点诉求时通过商务渠道反馈，便于排期。

参考文档：LuatOS 文档 https://docs.openluat.com/

28. 780EHT/724UG所用的设备USB充电线传导干扰导致I2C通讯异常，有什么方案？

解答： 结论：780EHT/724UG 设备因 USB 充电线传导干扰导致 I2C 通讯异常，共模电感 + 隔离电源试过无效时，可以尝试用屏蔽材料包裹 USB 线并加套磁环测试。

说明：充电线的传导干扰会沿电缆耦合进设备，干扰 I2C 这类对时序敏感的慢速总线，表现为偶发通信失败或数据异常。屏蔽 + 磁环属于从线缆侧抑制干扰的常规手段，成本低、见效相对快。

处理办法：

  1. 用屏蔽布（导电屏蔽材料）包住 USB 充电线，两端做好接地处理。
  2. 在 USB 线靠近设备/电源的两端加套合适的磁环。
  3. 对比测试加装前后的 I2C 异常率，确认效果。
  4. 若仍不理想，从 PCB 侧继续优化：缩短 I2C 走线、远离干扰源、加上拉与滤波。

参考文档：LuatOS 文档 https://docs.openluat.com/

29. Air8000W上有两个串口（wifi芯片串口和4G侧串口），接外设有什么区别？

解答： 结论：Air8000W 上 WiFi 芯片串口与 4G 侧串口接外设，优先接到 4G 那一侧；即便要用 WiFi 功能，也建议把外设接到 4G 侧，除非确实没有多余串口，才使用 WiFi 那边的串口。

说明：4G 侧串口由主控直接管理，资源与调试支持更完善、稳定性更好；WiFi 侧串口受 WiFi 芯片/airlink 通道影响，可用性和问题定位都更受限制。串口数量有限时，先评估业务对串口的实际需求再分配。

建议：

  1. 外设优先接 4G 侧串口。
  2. 需要 WiFi 时仍把外设挂在 4G 侧，把 WiFi 串口留给 airlink 通信。
  3. 分配前确认两路串口的引脚与电平，避免与外设冲突。
  4. 分配后做长时间挂机测试，确认通信稳定。

参考文档：https://docs.openluat.com/air8000/product/

30. Air8000开发板/核心板为什么下载不了固件或无法进入烧录模式？

解答： 结论：Air8000 开发板/核心板下载不了固件或进不了烧录模式，先确认拨码开关是否拨到对应芯片位置，并使用对应的下载调试板。

说明：多芯片形态的开发板（如 Air1601、Air780ER2 等）通过拨码开关切换下载/调试对象，拨错位置时电脑识别到的不是目标芯片的下载口，自然无法烧录；另外，部分芯片（如 Air1601）没有独立 BOOT 键，需要按其板卡说明进入下载模式。

排查步骤：

  1. 检查拨码开关位置：Air1601 拨到 1601，Air780ER2 拨到 6205 等，以板卡丝印/说明为准。
  2. 使用该型号配套的下载调试板，不要混用。
  3. 注意 Air1601 没有 BOOT 键，按手册方式进入下载模式。
  4. 确认 USB 线含数据线、供电正常，必要时重装驱动。

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

31. Air8783短信转发，电信133号段的卡出现指令解析bug，收到的短信和发出的不一致

解答： 结论：Air8783 短信转发中，电信部分号段出现“收到的短信和发出的不一致”，是因为个别运营商网关强制把短信转码为 UCS-2（dcs 8），LuatOS 底层解码时字符串中含空字节被提前截断；可提供专用固件解决，或更换卡片测试。

说明：正常短信按运营商编码（如 GSM 7bit）下发，底层按对应编码解析；当网关强制使用 UCS-2 时，双字节编码中可能出现空字节，若解析按字符串方式处理，遇到空字节就会被当作结束符，导致内容被截断或错乱。这是特定运营商网关行为，不是模组硬件故障。

处理办法：

  1. 提供问题卡号、短信原文与设备日志给技术支持，申请专用固件。
  2. 用其他运营商/其他号段卡片交叉测试，确认是否为网关转码所致。
  3. 固件升级后复测同一张卡与同一类短信。

参考文档：LuatOS 文档 https://docs.openluat.com/

32. 企业微信/自定义webhook配置8783短信转发不生效，应该怎么配置？

解答： 结论：企业微信/自定义 webhook 配置 8783 短信转发不生效，多数是指令格式或 webhook 地址不对，需要用指令生成工具生成正确的配置指令，再以短信下发到 8783。

说明：8783 通过短信通道下发配置指令，指令本身是带 # 分隔加上 JSON 的文本，格式要求严格；短信内容里的引号、花括号、分隔符写错，或 webhook 地址不可达，都会导致配置不生效。

配置步骤：

  1. 用官方指令生成工具生成配置指令，不要手工改动模板。
  2. 检查 webhook 地址是否完整、可访问（企业微信机器人地址需与实际一致）。
  3. 把指令以短信形式发送到 8783 的卡号，等待设备回执确认。
  4. 示例指令：886886#GENERAL#{"webhook":"https://log.max-to.cn/webhook/wecom","custom_headers":{}}。
  5. 不生效时保留下发记录与设备回复，提交技术支持核对。

参考文档：LuatOS 文档 https://docs.openluat.com/

33. Air8783收到的短信和发出的短信不一致是什么原因？

解答： 结论：Air8783 收到的短信与发出的短信不一致，是运营商编码问题——个别卡会被运营商网关强制转码为 UCS-2，已定位为网关侧行为，可通过更换固件解决。

说明：模组侧按标准解析短信，问题出在上游网关的转码；当双字节编码中出现空字节时，旧固件的解析会被提前截断，导致内容缺失或错乱。更换固件是对这类网关行为的适配，而不是掩盖问题。

处理办法：

  1. 记录问题卡号、短信样例与固件版本，联系技术支持获取专用固件。
  2. 换卡交叉验证，确认是否为特定卡/号段触发。
  3. 固件升级后回归测试转发链路（短信→webhook/企业微信）。

参考文档：LuatOS 文档 https://docs.openluat.com/

34. Air8780P开发板出厂能否提供所有IMEI信息？如何做一板一外壳对应的IMEI标签？

解答： 结论：Air8780P 开发板出厂可以提供所有 IMEI 信息，但“一板一外壳对应 IMEI 标签”需要自己开发上位机，连板读取 IMEI 后驱动打印机打标；如果外壳需要厂家激光打印，只能等板子生产出来、IMEI 确定后再制作。

说明：IMEI 逐台唯一，出厂记录可用于追溯，但把 IMEI 与具体外壳绑定，需要在生产环节读码、打标、贴标，属于产线流程设计，官方不提供现成的打印软件。

实施步骤：

  1. 向商务索取该批次的 IMEI 清单/获取方式。
  2. 自研上位机：通过串口/USB 连接板子读取 IMEI，控制标签打印机打印。
  3. 需要外壳激光打印的，先完成板子生产拿到确定 IMEI，再做外壳打标。
  4. 建立“板机-外壳-IMEI”的对应记录，便于售后与设备管理。

参考文档：LuatOS 文档 https://docs.openluat.com/

35. 使用合宙iot平台提示没有权限/设备未绑定，绑定设备到合宙iot平台找谁处理？

解答： 结论：使用合宙 IoT 平台提示没有权限/设备未绑定，需要把 IMEI 和 IOT 账号提供给商务人员，由后台把设备划转到对应账号名下。

说明：IoT 平台的设备归属按 IMEI 与账号绑定，产品出厂或代工生产时设备默认挂在原账号/项目下，客户账号自然“没有权限”；划转属后台操作，客户侧无法自行完成。

处理步骤：

  1. 整理需要绑定的设备 IMEI 清单。
  2. 把自己的 IOT 账号（登录手机号/账号名）提供给对接商务人员。
  3. 由后台完成划转，划转后在设备列表中确认设备可见。
  4. 划转前用完整 IMEI 核对，避免漏机或错划。

参考文档：https://iot.openluat.com/

36. 合宙8780P样品IMEI如何绑定到自己的IoT账号？

解答： 结论：合宙 8780P 样品的 IMEI 要绑定到自己的 IoT 账号，需把样品 IMEI 列表和需要归属的 IOT 账号发给商务人员，由商务在后台划转到该账号名下（例如可划到“合宙标准模块”项目）。

说明：划转本质是后台修改设备的账号归属，属商务/后台操作，客户自行在平台上无法直接改归属；可指定划入某个具体项目。

步骤：

  1. 整理样品 IMEI 清单，建议用表格（序号、IMEI、备注）。
  2. 写清楚要归属的 IOT 账号与项目名称。
  3. 发给对接商务，请其后台划转。
  4. 划转完成后登录平台核对该账号下的设备列表。

参考文档：https://iot.openluat.com/

37. Air8601是否支持4G转热点给别的监控供网？

解答： 结论：实际 Air8601 并不支持用 4G 转热点给别的监控供网；但有方案是用 4G 转有线 PoE/RJ45 或 WiFi 热点给海康录像机供网，可按需定制。

说明：8601 的定位并非“4G 路由器”，其 4G 通道主要供自身与摄像头业务使用；给第三方设备（如海康录像机）供网，需要在方案层另做设计，输出侧可以是网口（PoE/RJ45）或 WiFi 热点。

方案建议：

  1. 明确下游设备的接入方式（网口还是 WiFi）与供电需求（是否需要 PoE）。
  2. 走定制方案：4G 转有线 PoE/RJ45 或 4G 转 WiFi 热点。
  3. 由方案评估确认带宽、并发与稳定性，再做样机验证。

参考文档：https://docs.openluat.com/air8601/product/

38. Air8601同时接两个摄像头（1032+1034）能否实现人脸识别+监控录像？

解答： 结论：Air8601 同时接两个摄像头（1032+1034）无法按常规方式同时工作——1034 只接串口时仅能做人脸识别，不能预览拍照；1032 接 USB 可预览、拍照、录像、RTMP 推流；同时接两个时 USB 只能支持一个摄像头，且帧率较低、尚未开放。

说明：摄像头能力取决于接口与编码能力。1032 走 USB，具备完整的预览/拍照/录像/推流能力；1034 走串口时仅做识别类计算，没有图像输出通路；而 8601 的 USB 通道同时只支持一个摄像头。

建议：

  1. 需要“人脸识别 + 监控录像”并行时，用 1032 走 USB 做录像与推流，识别交给 1034 或其他通道。
  2. 双路同时接入属非标需求，需定制，由官方评估帧率与资源占用。
  3. 先做单路联调跑通，再评估双路方案。

参考文档：https://docs.openluat.com/air8601/product/

39. AirCAMERA_1034为什么不能录像？

解答： 结论：AirCAMERA_1034 不能录像，是因为它只支持 MJPG，不支持 H264 编码；但支持预览和拍照（最大 960×480 分辨率）。

说明：录像通常依赖 H264/H265 这类帧间压缩编码来降低码率与存储量；仅支持 MJPG（逐帧 JPEG）时，做视频存储与推流代价高，因此不提供录像能力。预览与拍照是单帧输出，MJPG 可以满足。

使用建议：

  1. 需要录像/RTMP 推流，选支持 H264 的型号（如 1032 走 USB）。
  2. 只用预览、抓拍与人脸识别类功能，1034 即可胜任。
  3. 注意分辨率上限为 960×480，按实际需求确认是否够用。

参考文档：LuatOS 文档 https://docs.openluat.com/

40. Air8101核心板+AirLCD_1020播放视频放不出来/循环播放卡死怎么解决？

解答： 结论：Air8101 核心板 + AirLCD_1020 播放视频放不出来或循环播放卡死，可先把解码方式从硬件解码（hw）改为软件解码（sw），通常就能正常显示；循环播放卡死问题仍在优化中。

说明：视频解码对时序与缓冲要求高，硬件解码路径在部分码流/屏参组合下会出现出画异常；软件解码兼容性更好，代价是 CPU 占用更高，作为规避手段可行。

处理步骤：

  1. 把解码方式配置为软件解码（hw 改 sw）后重测播放。
  2. 确认视频文件的编码格式、分辨率、帧率是否在平台可解范围内。
  3. 循环播放仍卡死时，记录视频文件、固件版本与复现步骤反馈，等待优化版本。
  4. 资源受限场景可降低分辨率/码率，或改用图片轮播等替代方案。

参考文档：https://docs.openluat.com/air8101/

41. Air780EHM播放TF卡的MP3文件部分播放不了是什么原因？

解答： 结论：Air780EHM 播放 TF 卡里的 MP3 部分播不了，是因为新版音频框架增加了文件头损坏预检，不规范的 MP3 会被判为不可播放；请用专业工具或格式工厂重新转码，且判断能否解析要看采样率、位宽、声道数，而不是比特率。

说明：音频框架在播放前会解析音频头信息，若文件头损坏、格式不规范或被裁剪过，会直接拒绝播放。比特率只描述压缩率，真正决定能否解析的是采样率、位宽、声道数等关键字段。

处理办法：

  1. 用专业音频工具/格式工厂把问题文件重新转码为标准 MP3。
  2. 统一采样率、位宽、声道数等参数，避免混合格式。
  3. 重新拷贝到 TF 卡后再测，确认文件完整。
  4. 批量文件可先统一规范转码再上线。

参考文档：LuatOS 文档 https://docs.openluat.com/

解答： 结论：Air1602 V1.2 上可跑通的 UI + airlink_4g demo，可参考官方仓库目录 https://gitee.com/openLuat/LuatOS/tree/master/app_engine/factory 。

说明：该目录下提供了厂家/整机类工程的示例，包含 UI 与 airlink 联网的配合用法，可作为 V1.2 平台的参考实现。使用时注意固件与库版本要配套，UI 与联网的初始化顺序不要互相抢占资源。

做法：

  1. 拉取上述工程，先按原样编译运行验证。
  2. 确认所用固件版本与 demo 要求一致，库同步更新。
  3. 参考其初始化顺序（先显示后联网/先联网后显示）与引脚分配，再移植到自己的工程。
  4. 运行异常时记录日志并与官方 demo 对比。

参考文档：https://gitee.com/openLuat/LuatOS/tree/master/app_engine/factory

43. videoplayer/airui.video是否支持直接从TF卡/SD路径播放大视频？8MB RAM的Air780EHV能播放多大视频？

解答： 结论：videoplayer/airui.video 是否支持直接从 TF 卡/SD 路径播放大视频，请先问 AI 或查看文档确认；Air780EHV 是低功耗 4G Cat.1 模组，不支持播放几百 MB、十几分钟的长视频。

说明：大视频播放需要较大的内存缓冲、较高的解码算力与稳定的存储读取带宽；低功耗型模组的定位是联网与轻量业务，不适合做长视频播放，8MB RAM 能承载的视频时长/体积都很有限。

建议：

  1. 播放能力与支持格式以官方文档/API 说明为准，先在小视频上验证。
  2. 缩短视频时长、降低分辨率与码率，控制在资源可承受范围内。
  3. 有长视频播放需求的，改用定位为多媒体、带硬件解码能力的平台。
  4. 选型前用官方 AI 助手或技术支持确认具体参数。

参考文档：LuatOS 文档 https://docs.openluat.com/

44. Luatools下载本地量产文件到模组时下载失败且识别不到USB，如何解决？

解答： 结论：Luatools 下载本地量产文件到模组时下载失败、识别不到 USB，先关闭 360 安全卫士等杀毒软件；若 bootloader 已损坏，需要重新进入下载模式；同一批次出现多台时联系商务返修。

说明：杀软常会拦截 Luatools 的进程、串口或写入操作，造成“认不到设备/下载中断”；另有小比例设备是 bootloader 受损，表现为下载口能识别但无法完成写入，之后 USB 不再枚举。

排查步骤：

  1. 完全关闭 360 等杀软（或加入白名单），删除 Luatools 目录下 log 后重开再烧。
  2. 换短数据线、直插主机 USB 口，必要时用稳压电源独立供电。
  3. 无法进入正常下载流程时，按 BOOT+RESET 重新进入下载模式。
  4. 约 200 个中出现 5、6 个这类问题的，记录 IMEI 与日志，联系商务按返修处理。

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

45. luatools工具只要下载脚本就闪退如何处理？

解答： 结论：Luatools 一执行下载脚本就闪退，关闭 360 安全卫士后即可解决。

说明：闪退多由安全软件在 Luatools 写文件/访问串口时拦截进程导致，并非工具本身缺陷；同类现象还包括下载到一半中断、串口被占用等，处理方式一致。

处理步骤：

  1. 退出 360 安全卫士（或把 Luatools 安装目录与工作目录加入信任白名单）。
  2. 确认没有残留的 Luatools 进程，必要时重启电脑再试。
  3. 再次下载脚本，确认不再闪退。
  4. 若其他杀软仍拦截，按同样方式加白名单。

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

46. 合宙老版本下载调试工具V3.1有吗？

解答： 结论：合宙老版本下载调试工具 V3.1 可能已不再提供；请先提供 Luatools 所在目录的日志（如 f 开头的日志文件）以便排查，确认是工具问题还是使用/环境问题。

说明：老版本工具官网通常不再维护下载入口，且新模组/新固件对工具版本有要求，用旧工具可能识别不了设备。先看日志能最快区分是工具兼容问题还是线材/驱动/供电问题。

处理步骤：

  1. 提供 Luatools 安装目录下的日志文件（f 开头的日志）与操作步骤。
  2. 优先使用最新版 Luatools 重试，看问题是否仍然存在。
  3. 确有特殊原因需要老版本的，通过官方渠道咨询是否还能获取。
  4. 下载/识别异常时同步排查线材、驱动、供电与杀软拦截。

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

47. Air8000A差分包生成只输出sota文件不输出bin，且执行会卡顿/未响应，为什么？

解答： 结论：Air8000A 差分包生成只输出 sota 文件不输出 bin、且执行卡顿/未响应，可能是核心版本升级或生成文件名被改动导致；建议更新 Luatools 后重新生成，并且不要修改生成的文件名。该问题已复现并反馈研发处理。

说明：差分包工具依赖特定版本的核心文件与固定命名规则，核心版本不匹配或生成物被改名，都会让流程走不完整；工具长时间无响应也可能是资源/环境问题。

处理步骤：

  1. 把 Luatools 更新到最新版本。
  2. 恢复默认的生成文件名，不要自行重命名。
  3. 确认 core/固件版本与工具要求一致，重新生成差分包。
  4. 仍异常时保留工具日志与复现步骤，等待研发修复版本。

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

48. 合宙iot平台账号注册后如何绑定设备？iot归属权怎么转？

解答： 结论：合宙 IoT 平台账号注册后绑定设备分两种情况——旧账号下的设备可自行登录账号转移，新账号下的设备可在下次下单时提供新 IOT 账号，由商务绑定。

说明：设备归属权与出货批次相关，量产设备在下单环节即可指定归属账号，比自己事后逐台转移更省事；存量设备则可通过账号转移功能处理。

做法：

  1. 存量设备：登录 https://iot.openluat.com/ ，按平台提供的转移流程把设备转到目标账号。
  2. 新下单设备：下单时把新的 IOT 账号提供给商务/销售，由后台直接绑定。
  3. 转移/绑定后到设备列表核对 IMEI 是否齐全。
  4. 有归属争议的设备，提供 IMEI 与订单号由商务协助处理。

参考文档：https://iot.openluat.com/

49. 合宙Air780EPM的价格和交期是多少？

解答： 结论：合宙 Air780EPM 含税 15.8 元，一般有现货。

说明：实际价格与交期会随批次、订购数量与当时政策变化，以上为当前答复口径；大批量采购或长期供货需求，建议以下单时的报价为准，并与商务确认。

建议：

  1. 采购前在官方渠道（淘宝店/对接商务）确认最新价格与库存。
  2. 批量项目提前沟通备货，避免临时缺料。
  3. 交期以订单确认为准，不以此处口径作为交期承诺。

参考文档：https://luat.taobao.com/

50. EC20CEHDLG-MINIPCIE-C（Cat.4，全国产）有没有对应替代型号？

解答： 结论：合宙没有 Cat.4 产品，无法提供 EC20CEHDLG-MINIPCIE-C（Cat.4）的对应替代型号。

说明：合宙当前的蜂窝通信产品以 Cat.1 及其他形态为主，没有 Cat.4 类目，因此不存在“同类别替代”的型号可选。若项目必须使用 Cat.4，需另找 Cat.4 供应商；若只是需要联网能力，可评估用 Cat.1 型号能否满足业务速率。

建议：

  1. 明确项目对速率、时延的真实要求。
  2. 若速率够用，可评估改用合宙 Cat.1 型号，注意重新做硬件与软件适配。
  3. 确需 Cat.4 时，把需求向商务说明，看是否有其他合作方案。

参考文档：LuatOS 文档 https://docs.openluat.com/

51. Air724还有卖吗？价格多少？

解答： 结论：Air724 系列还有在售，可线下采购；724 NFC 含税 42 元，724 NFM 含税 49 元。

说明：Air724 属于较早期的 Cat.1 产品线，目前以线下采购渠道为主；具体价格与库存随批次变化，下单前请与商务或官方店铺确认。若要长期供货或做新项目选型，建议同时评估在产的新型号。

建议：

  1. 采购时通过对接商务/官方店铺确认型号（NFC/NFM）与价格。
  2. 新项目选型可对比在产型号的能力与供货稳定性。
  3. 以订单确认的价格与交期为准。

参考文档：https://luat.taobao.com/

52. Air720U基站定位/WIFI定位报601错误，是什么问题？

解答： 结论：Air720U 基站定位/WiFi 定位报 601 错误，可能是基站/WiFi 未被数据库收录，或定位服务器繁忙；客户自上月起一次都获取不到、之前正常，需结合实际环境进一步排查。

说明：基站/WiFi 定位依赖数据库反查与服务器响应，若所在区域的基站/WiFi 热点未被收录，或服务端拥塞，就会返回错误码；“一直取不到”的情况也可能与网络环境变化、服务侧调整有关。

排查步骤：

  1. 换到其他地点、其他时段测试，判断是否与所在区域/网络有关。
  2. 确认设备注网、联网正常，定位接口调用参数正确。
  3. 记录错误码、时间点、IMEI、位置与网络环境，提交技术支持与服务器侧核对。
  4. 若业务对定位稳定性要求高，评估补充 GNSS 或改用其他定位方式。

参考文档：LuatOS 文档 https://docs.openluat.com/

53. Air780EHT能否用于弱光发电温湿度计，需4G或NB低功耗+墨水屏显示？

解答： 结论：弱光发电温湿度计这个场景，Air8780P3 更满足弱光发电的低功耗需求；具体选型建议联系合宙技术支持进一步确认。

说明：弱光发电对整机静态功耗极其敏感，需要模组在休眠、采集、上报各环节都尽量省电，并配合墨水屏这类低功耗显示（墨水屏只在刷新时耗电，保持画面几乎不耗电）。

建议：

  1. 明确采集/上报周期与弱光发电能提供的平均功率，倒推允许的平均电流。
  2. 优先评估 Air8780P3 这类低功耗型号，配合墨水屏做显示。
  3. 用实际光强条件做长时间实测，确认可长期免维护运行。
  4. 选型细节与技术支持确认，避免只按型号名判断。

参考文档：LuatOS 文档 https://docs.openluat.com/

54. 数字模组Air720U支持哪些定位方式？我用的模组是AIR720U

解答： 结论：Air720U/Air720UH 支持基站定位和 WiFi 定位；其中基站定位免费，但有调用频率限制。

说明：基站定位通过基站信息反查位置，属粗定位；WiFi 定位扫描周边热点反查坐标。因为基站定位免费，平台会做频率限制以避免滥用，高频调用会被拒绝或限流。

使用建议：

  1. 按业务需要降低定位频率，避开限流。
  2. 先注网联网成功再发起定位，失败时做重试与退避。
  3. 对精度有要求的场景评估补充 GNSS。
  4. 调用参数与错误码以官方文档为准。

参考文档：LuatOS 文档 https://docs.openluat.com/

55. 用合宙IoT平台做FOTA升级提示没有权限，怎么办？

解答： 结论：用合宙 IoT 平台做 FOTA 升级提示没有权限，是因为设备还没绑定到自己的 IoT 账号；需要先把设备绑定（提供 IMEI 和账号给商务）后才可使用 FOTA 升级。

说明：FOTA 的升级授权跟着设备归属走，设备挂在别人账号下时，你的账号自然没有升级权限；绑定完成后再创建升级任务、下发版本即可。

处理步骤：

  1. 整理需要升级的设备 IMEI 清单，连同自己的 IOT 账号发给商务。
  2. 由后台把设备划转到该账号，登录平台确认设备可见。
  3. 在平台上创建 FOTA 任务，注意版本号格式与升级包配套。
  4. 设备重启后检测升级（非实时推送）。

参考文档：https://iot.openluat.com/

56. 客户那边需要4G转有线网络（PoE/RJ45）给海康录像机供网，合宙有方案吗？

解答： 结论：4G 转有线网络（PoE/RJ45）给海康录像机供网可以实现，但属于定制方案；可用 4G 转有线 PoE/RJ45 或 WiFi 热点，建议用 Air8000 系列或 Air1601 + 4G 模块方案，具体需评估。

说明：这类需求的核心是“上行 4G、下行网口/热点”的网关能力，涉及网口（含 PoE 供电）、转发与稳定性设计，标准品未必完全覆盖，需要按项目定制。

方案建议：

  1. 明确下游设备（海康录像机）的接入方式：RJ45 是否需要 PoE 供电、带宽与并发需求。
  2. 方案候选：Air8000 系列，或 Air1601 + 4G 模块组合。
  3. 由官方评估硬件形态、转发性能与散热，再出样机验证。
  4. 走商务/技术支持渠道提交定制需求。

参考文档：https://docs.openluat.com/air8000/product/

57. Air8000W的WIFI AP给手机提供网络就无网络，给电脑却正常，是什么原因？

解答： 结论：Air8000W 的 WiFi AP 给电脑供网正常、给手机供网无网络，可能是手机与电脑连接时的网络模式/协议差异导致，需检查 RNDIS、WiFi 芯片状态与内存占用。

说明：不同操作系统在连接 AP 后会做不同的网络探测（如 DNS 探测、IPv6、代理自动发现），手机侧更容易因探测失败而判定“无网络”；也可能是 AP 侧地址分配、内存不足或 WiFi 芯片状态异常。

排查步骤：

  1. 确认 RNDIS 是否开启，4G 侧是否已正常注网并拿到 IP。
  2. 检查 WiFi 芯片状态与固件版本，确认 AP 模式工作正常。
  3. 关注内存占用，内存不足会影响 AP 与转发服务。
  4. 换手机、换系统版本复现并记录现象；必要时挂机长时间测试，保留日志提交研发定位。

参考文档：https://docs.openluat.com/air8000/product/

58. Air780EPM的OTA报与服务器断开连接，是什么原因？

解答： 结论：Air780EPM 的 OTA 报与服务器断开连接，已确认是物联网卡限制导致，不是平台或配置问题；换卡测试即可恢复。

说明：部分物联网卡有定向流量或访问白名单限制，升级服务器地址不在允许范围内时，连接会被运营商侧中断，表现为“与服务器断开连接”；换一张可自由访问的卡即可验证。

处理办法：

  1. 换一张普通可上网卡测试 OTA，若正常即确认是卡的限制。
  2. 若必须使用定向卡，把升级服务器域名/IP 加入白名单。
  3. 确认卡未欠费、已注网，APN 配置正确。
  4. 保留错误码与日志，便于区分是卡限制还是服务端问题。

参考文档：LuatOS 文档 https://docs.openluat.com/

59. Air8201G内置G-sensor 小程序里有体现姿态变化的功能吗？有没有二次开发接口？

解答： 结论：Air8201G 内置 G-sensor，小程序里有体现姿态变化的功能，也提供二次开发接口；具体用法可加技术同事协助确认。

说明：G-sensor（加速度计）可检测设备姿态、倾斜、震动等，既可通过官方小程序演示查看效果，也可在二次开发中直接读取数据、实现自己的姿态算法与业务逻辑。

使用建议：

  1. 先用官方小程序/示例确认传感器工作正常与数据方向定义。
  2. 二次开发时按官方库接口读取加速度数据，注意单位、轴向与采样频率。
  3. 姿态判断建议做滤波与阈值处理，避免抖动误触发。
  4. 具体接口与接线加技术同事协助确认。

参考文档：https://docs.openluat.com/air8201/

60. Air8202平台如何修改IP和端口？

解答： 结论：Air8202 平台修改 IP 和端口，直接在脚本里改即可；可以让 AI 协助修改，测试通过后再转移到公司服务器。

说明：Air8202 属免开发整机形态，默认指向合宙演示服务器；把上报地址改成自有服务器，需要在脚本中修改目标 IP/端口（或域名），并确认卡的白名单允许访问该地址。借助 AI 助手改脚本可以快速完成，但上线前必须在实机上验证。

步骤：

  1. 明确自有服务器的 IP/域名、端口与协议（TCP/MQTT/HTTP）。
  2. 在脚本里替换上报目标地址，保持其他逻辑不变。
  3. 用可自由访问的卡联调，确认数据能到达自建服务器。
  4. 测试稳定后再量产/转移，注意保留可回退的版本。

参考文档：https://docs.openluat.com/air8202/product/

61. Air780EHV核心板是否支持打电话？为什么无法拨号？

解答： 结论：Air780EHV 核心板 10 平固定 3.3V，无法用于打电话；电信等需要 VoLTE 的语音场景，要使用支持 VoLTE 的版本。

说明：语音通话对供电电压与语音链路有要求，核心板若固定 3.3V 供电无法满足通话所需的硬件条件；另外，电信网络语音依赖 VoLTE，模组与固件必须支持 VoLTE 才能拨号成功。

建议：

  1. 确认所选核心板/模组的供电与语音能力是否满足通话需求。
  2. 使用支持 VoLTE 的版本，并在电信网络下实测拨号。
  3. 拨号失败时记录日志与错误码，提交技术支持定位。
  4. 选型阶段就让商务/技术支持确认语音能力，避免后期返工。

参考文档：LuatOS 文档 https://docs.openluat.com/

62. Air780EHU和Air780EPM引脚兼容吗？和Air724UG兼容吗？

解答： 结论：Air780EHU 与 Air780EPM 软硬件完全兼容；与 Air724UG 不兼容。

说明：780EHU 与 780EPM 属同平台同封装的型号，引脚与软件框架一致，可以在同一块 PCB 上替换使用；Air724UG 属更早的平台，封装、引脚与固件体系都不同，无法直接互换。

使用建议：

  1. EHU 与 EPM 互换时，确认所用固件/核心库与目标型号匹配。
  2. 与 724UG 迁移时需重新做硬件设计和软件适配。
  3. 正式替换前用同一套业务脚本分别回归验证。

参考文档：LuatOS 文档 https://docs.openluat.com/

63. Air780EQ支持哪些种类的SIM卡？另外是否支持eSIM？

解答： 结论：Air780EQ 支持标准 SIM 卡、Micro SIM 卡、Nano SIM 卡；是否支持 eSIM 需进一步确认。

说明：SIM 卡座/贴片卡的形态取决于硬件设计，标准、Micro、Nano 三种插拔卡通常通过卡座适配；eSIM 涉及芯片/协议与运营商开通流程，不能一概而论，需按具体方案确认。

建议：

  1. 按产品结构选择卡座形态（标准/Micro/Nano）。
  2. 需要 eSIM 时，把目标运营商、开通方式与批量需求一并说明，请官方确认是否支持。
  3. 确认卡座走线、SIM 检测脚与硬件手册一致，避免识别异常。

参考文档：LuatOS 文档 https://docs.openluat.com/

64. Air8780V可以免硬件设计吗？

解答： 结论：可以，用 Air8780V 开发的好处就是免硬件设计、免画外围电路，直接基于现成模组形态做业务。

说明：免硬件设计意味着省去射频、电源与外围电路的设计调试环节，把精力放在业务软件上，适合产品快速验证与中小批量落地，相比自研板卡，开发周期与硬件风险都更低。

建议：

  1. 先用 8780V 做业务功能验证，确认接口与外设满足需求。
  2. 用 LuatOS + 官方库完成脚本开发，注意与模组固件版本配套。
  3. 量产前的结构、接口与认证需求提前与商务确认。
  4. 确有特殊接口/形态需求时，再评估定制或自研板卡。

参考文档：LuatOS 文档 https://docs.openluat.com/

65. Air8000的wifi/4g/蓝牙功能能否通过外部通信来实现？

解答： 结论：可以，Air8000 系列支持通过外部串口/AT 指令等方式控制 WiFi、4G、蓝牙等通信功能，即由外部主控通过通信接口驱动这些能力。

说明：这种模式是把 Air8000 当作“通信外设”，外部 MCU 通过串口发指令完成联网、配网、蓝牙等操作，业务逻辑放在外部主控上，适合已有成熟 MCU 平台、只想增加联网能力的项目。

使用建议：

  1. 明确外部主控与模组的接口（串口/电平）与通信协议。
  2. 确认所需功能（WiFi 配网、4G 联网、蓝牙透传等）在对应固件/指令集中已支持。
  3. 做好串口超时、重连与异常处理。
  4. 具体指令集与固件版本与技术支持确认。

参考文档：https://docs.openluat.com/air8000/product/

66. Air780EPM的串口电平如何调整成3.3V？

解答： 结论：Air780EPM 的串口电平要变成 3.3V，需要配置对应 GPIO 的电平，或外接电平转换电路；具体操作可咨询 AI 助手或技术支持。

说明：模组 IO 电压域由内部电源域决定，部分引脚电平可配置，部分需要外部转换（如电平转换芯片或分压）；用 3.3V 器件对接前，必须先确认该串口引脚的实际电平能力，避免电平不匹配损坏器件或通信异常。

处理办法：

  1. 查阅该型号的引脚/电平说明，确认目标串口引脚支持的电平范围。
  2. 若引脚电平可配置，按对应 API 设置 GPIO 电平。
  3. 不可配置时使用电平转换电路（专用转换芯片或电阻分压，注意速率）。
  4. 不确定时咨询 AI 助手 https://ai.luatos.com/ 或技术支持。

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

67. Air8000U核心板+AirCAMERA_1050拍出的照片有黑点，换了3.3V LDO后还有，怎么回事？

解答： 结论：Air8000U 核心板 + AirCAMERA_1050 拍照有黑点、换了 3.3V LDO 后仍有，需要确认摄像头供电是否确实为 3.3V，以及电源时序与布线是否满足要求；建议再测试不同摄像头或供电方案。

说明：黑点可能来自供电电压/纹波、上电时序、摄像头本体或排线接触。万用表量到 3.3V 只说明静态电压满足，瞬时跌落、纹波与上电顺序同样会影响成像，需要综合排查。

排查步骤：

  1. 用示波器确认拍照瞬间供电是否跌落、纹波是否过大。
  2. 核对摄像头与 LDO 的上电时序，必要时调整。
  3. 检查排线与连接器接触是否良好。
  4. 换一只同型号摄像头交叉验证；仍复现时，换其他供电方案（如独立 LDO 就近供电）测试。
  5. 保留照片、硬件版本与测试记录，提交技术支持。

参考文档：https://docs.openluat.com/air8000/product/

68. Air8202模块BOOT键没引出来吗？需要怎么烧录？

解答： 结论：Air8202 模块本身未引出 BOOT 键，需要搭配对应的下载调试板来烧录。

说明：部分模组形态为了尺寸与成本，会把 BOOT/下载相关信号引到专用调试板或测试点，而非在模组上保留按键；烧录时必须用配套的下载调试板，按其引导方式进入下载模式。

步骤：

  1. 准备该型号配套的下载调试板与连接线。
  2. 按调试板说明进入下载模式（通常是按键/跳线组合）。
  3. 在 Luatools 中确认下载口出现后再点下载。
  4. 首次烧录记得底层 core 与脚本一起下载。

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

69. Air1601/Air1602能否实现双路摄像头同时做人脸识别和RTMP推流？

解答： 结论：Air1601/Air1602 硬件上 USB 只能支持一个摄像头，同时接两个摄像头帧率太低、尚未开放；可以尝试用 USB HUB 同时接 1032 和 1034，但 1034 只接串口时不能预览拍照。双路需求需要按实际情况定制。

说明：USB 带宽与平台解码/编码算力是双路摄像头的瓶颈，两个摄像头同时取流会显著降低帧率，当前版本没有开放该用法；串口侧的 1034 只做识别，没有图像输出能力。

建议：

  1. 常规做法：1032 走 USB，负责预览/拍照/录像/推流。
  2. 需要双路时用 USB HUB 接入，但先接受低帧率，或把 1034 放到串口侧只做识别（不能预览拍照）。
  3. 双路同时做人脸识别 + RTMP 推流属非标需求，提交官方按需求定制评估。
  4. 先做单路跑通，再验证双路可行性。

参考文档：https://docs.openluat.com/air1601/

70. Air780EPM BGA封装模组如何焊接/是否有LGA版本？

解答： 结论：Air780EPM 是 LGA 封装，不是 BGA，可直接贴片焊接，无需担心 BGA 焊接问题。

说明：LGA（焊盘在底面）相比 BGA 更易返修与检测，常规 SMT 即可完成；焊接时按推荐钢网、锡膏与回流曲线执行即可。

焊接要点：

  1. 按硬件手册的焊盘尺寸与钢网开孔设计 PCB。
  2. 使用推荐回流曲线，避免升温过快或超温。
  3. 焊盘与引脚保证平整、无氧化，锡膏量适中。
  4. 首件做 X-Ray/外观检查，确认无虚焊连锡。

参考文档：https://docs.openluat.com/air780epm/

71. Air8000系列能同时支持WiFi AP和4G上网吗？

解答： 结论：Air8000W 支持 4G + WiFi AP 同时工作；有客户反馈手机连 AP 偶尔无网络，该问题正在排查。

说明：4G 负责上行，WiFi AP 负责给终端下发网络，两者在物理上可以并行；偶发无网络更可能出在地址分配、终端探测或内存/转发环节，而不是“不能同时支持”。

使用建议：

  1. 确认 RNDIS、AP 参数与 4G 注网状态正常后，再让终端连接。
  2. 出现无网络时换终端复现并记录日志（含时间点）。
  3. 关注内存占用与长时间稳定性，必要时挂机测试。
  4. 保留复现数据提交研发，等待排查结论。

参考文档：https://docs.openluat.com/air8000/product/

72. 合宙AI文档助手是否免费？怎么使用？

解答： 结论：合宙 AI 文档助手是免费的，访问 https://crm.luatos.com/#/p11000/luat_aichat 即可使用；遇到错误可重试，仍无法解决可截图反馈。

说明：该助手面向合宙产品/文档问答，能快速定位资料、解释 API 用法，适合日常查文档与梳理排查思路；但它不是万能的，遇到不确定的答案应以官方文档与技术支持为准。

用法：

  1. 打开上述地址进入 AI 助手直接提问。
  2. 提问尽量带上具体型号与现象，回答会更准确。
  3. 报错时先刷新/重试，仍不行可截图反馈。
  4. 关键结论请回查官方文档 https://docs.openluat.com/ 确认。

参考文档：https://crm.luatos.com/#/p11000/luat_aichat

73. 客户要13.56MHz NFC读写功能，Air724UG有支持吗？

解答： 结论：Air724UG-NFC 支持 13.56MHz NFC 读写，含税 42 元。

说明：NFC 工作频率与协议由硬件方案决定，13.56MHz 属标准 NFC 频段，Air724UG-NFC 可满足读写需求；无蓝牙版本仍可购买。

建议：

  1. 明确读写场景（读卡、写卡、模拟卡等）与所需协议，确认功能匹配。
  2. 采购时通过对接商务/官方渠道确认型号（是否带蓝牙）与价格。
  3. 以订单确认的价格与交期为最终依据。

参考文档：https://docs.openluat.com/air724ug/

74. Air780EHV-SIP模组有杂音/断音问题，固件更新能解决吗？

解答： 结论：Air780EHV-SIP 模组出现杂音/断音，请提供完整日志；从反馈情况看，新版固件 V2050 声音不正常、V2047 正常，可先用 V2047，或测试 V2051 固件。

说明：通话声音异常与底层音频链路、固件版本强相关，属于“特定版本回归”的问题；定位这类问题必须结合完整日志（含 SIP 注册、通话建立与音频通道状态），仅凭现象很难判断。

处理步骤：

  1. 抓取完整日志（从开机到出现问题全过程），标出问题发生的时间点。
  2. 先用 V2047 验证通话是否正常，确认版本相关性。
  3. 测试 V2051 固件，看问题是否已修复。
  4. 把日志、固件版本、模组型号与网络环境提交技术支持。

参考文档：LuatOS 文档 https://docs.openluat.com/

75. 合宙8783短信转发工具在哪里下？如何看日志？

解答： 结论：合宙 8783 短信转发工具用 Luatools 即可——8783 插到电脑后打开 Luatools 就能看日志，也可以查看 Luatools 本地目录下的 log 文件。

说明：8783 类短信转发模块通过 USB 连接电脑，Luatools 可直接打印串口日志，是最方便的排查方式；工具目录下的日志文件可用于事后分析或提交技术支持。

步骤：

  1. 把 8783 插入电脑（USB 线需含数据线）。
  2. 打开 Luatools，选择对应串口查看实时日志。
  3. 需要留存时，到 Luatools 安装目录下的 log 目录取当天日志文件。
  4. 反馈问题时附带日志与操作步骤，便于快速定位。

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

搜索