跳转至

常见问题 - 2026-09-22

数据日期：2026-09-22

1. Air1601是否支持adc.open(adc.CH_CPU)获取CPU温度和使用lbsloc2 LBS定位？

解答： 结论：两个都不支持。Air1601 上既没有可用的 adc.CH_CPU 内部温度通道，也不能直接用 lbsloc2 做 LBS 定位。

说明：Air1601 是面向多媒体（屏 / 摄像头 / 音频）应用的 SoC 模组，本身不集成 4G 基带。adc.CH_CPU 是 4G SoC（Air780E 系列、Air8000 系列等）才有的内部温度通道；lbsloc2 的原理是拿蜂窝网络的基站信息（CELL / 邻区）去换算位置，必须由 4G 侧上报这份数据，Air1601 单独运行时没有数据来源。

处理步骤：

  1. 需要在 Air1601 方案上取位置时，让外挂的 4G 模组（如 Air8300 / Air780EGH 一类）跑 lbsloc2，Air1601 通过 AirLink 或串口取结果。
  2. 需要监测温度时，改用外置温度传感器（I2C / 单总线），或向 FAE 确认该型号是否有未公开的内部温度接口。
  3. 选型阶段先对照该型号的支持库列表，不要按 4G 模组的经验直接套用。

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

2. Air8101使用Air1034摄像头模组（人脸识别）是否需要保留摄像头控制电路，能否常开？

解答： 结论：控制电路必须保留，但摄像头不能常开。GPIO 编号可以按自己的板子调整，供电 / 控制这一路不能省。

说明：AirCAMERA_1034 是双目人脸识别配件板，视频走 USB（UVC），控制指令走 UART，另外还有供电控制管脚（见 Air8101 摄像头硬件设计与电源设计说明）。这一路供电控制的作用是让软件能在摄像头卡死、花屏、枚举失败时把它断电重启——一旦做成常开，就失去了唯一的软复位手段，只能整机断电。常开还会白白增加功耗和整板温升。

处理步骤：

  1. 按 Air8101 摄像头硬件设计章节核对 UVC 相关管脚与供电控制管脚，控制脚不要省。
  2. 软件上初始化摄像头前先做一次断电 → 延时 → 上电的复位时序。
  3. 识别完成或长时间不用时关掉这一路供电，需要时再打开，不要常开。

参考文档：AirCAMERA_1034 使用说明 https://docs.openluat.com/accessory/AirCAMERA_1034/ ，Air8101 摄像头硬件设计 https://docs.openluat.com/air8101/luatos/hardware/design/camera/ 。

解答： 结论：先查 DNS 预配置，4G 并没有掉线。实测此时 4G 仍在线，报错的实质是域名解析失败导致后续通信中断。

说明：airlink.rpc 走的是主控与 AirLink 模组之间的 RPC 通道，调用是同步等待返回的。模组侧 DNS 没配好时，域名会解析出 0.0.0.0 这类无效地址，连接建不起来，RPC 就一直等不到结果，最后抛出 rpc yield timeout。实测现场就是 DNS 没有正确预配置，请求走了 114.114.114.114 和 0.0.0.0。

处理步骤：

  1. 检查 DNS 预配置项，把主 / 备 DNS 明确配成可用地址（如 223.5.5.5、114.114.114.114）。
  2. 抓 RPC 与网络日志，确认失败点卡在域名解析还是 TCP 建连，必要时用 IP 直连做对照。
  3. 复测时同步看注网状态与 CSQ，先确认 4G 链路正常，再排 DNS，避免误判成 4G 掉线。

参考文档：airlink 扩展库 https://docs.openluat.com/osapi/core/airlink/ 。

4. Air8000和Air8000W是否共用固件？

解答： 结论：共用，直接用同一个固件。Air8000A / W / D / T / AB / DB / U / N 八个型号共用软件，固件后缀都是 _Air8000。

说明：这几款是同一芯片平台上的不同硬件配置型号，差异在天线形式、是否带 GNSS、外设配置等，LuatOS 固件不按型号区分。文档里明确写了“八个型号共用软件”，因此 Air8000 与 Air8000W 之间不存在固件互通问题。

处理步骤：

  1. 到固件页按需选 32 位或 64 位的 _Air8000 固件（两者差异见 32 位 / 64 位固件对比说明）。
  2. 直接烧到 Air8000 或 Air8000W 上即可，不用另找型号专属包。
  3. 注意差分升级只能在同类固件之间进行（1 号只能升 1 号），换号固件必须全量烧录。

参考文档：Air8000 LuatOS 固件版本 https://docs.openluat.com/air8000/luatos/firmware/ 。

5. Air8000W蓝牙连接第三方从设备后频繁断开（错误码62）是什么原因？

解答： 结论：错误码 62 多为环境干扰或多设备并发引起，先升级到最新固件再复测。

说明：Air8000 系列已内置蓝牙，可作为主机去连第三方从设备。62 号错误是蓝牙链路层上报的连接异常，典型诱因是周边 2.4G 设备密集（WiFi、蓝牙耳机、键鼠）造成频道拥塞，或从设备实现不规范导致连接参数协商不拢。目前连接参数还不开放给用户设置，能调整的空间主要在固件版本和测试环境上。

处理步骤：

  1. 先升级到 Air8000 最新正式固件复测，排除旧版本的已知问题。
  2. 把从设备移远、换到干扰小的环境，减少同时在线的蓝牙设备，观察是否仍断开。
  3. 抓蓝牙日志判断断开的时机（配对后立即断 / 运行一段时间后断），连同从设备型号一起给 FAE 定位。

参考文档：Air8000 蓝牙功能说明 https://docs.openluat.com/air8000/luatos/app/BLE/peripheral/ 。

6. Air8000A是否支持eSIM芯片（贴片卡）？

解答： 结论：支持。贴片卡（eSIM）与普通插拔 SIM 卡在模组侧没有本质区别，走同一套 SIM 接口。

说明：Air8000 系列是双卡单待设计（SIM1 / SIM2），两路都可以接普通卡座，也都可以接贴片 SIM。官方 SIM 硬件说明里已经给出 eSIM 方案，并附了中移物联网 eSIM 芯片（C2X2）的规格书作为参考；双卡设计且其中一路是贴片卡时，推荐 SIM2 接贴片卡、SIM1 接卡座，便于用插拔卡做测试。

处理步骤：

  1. 硬件按 SIM 硬件说明处理供电、时钟、数据、复位脚走线，贴片卡重点核对封装与供电。
  2. 贴片卡放 SIM2、卡座放 SIM1，留出测试通道。
  3. 软件按普通卡槽配置即可，不需要 eSIM 专用指令。

参考文档：Air8000 双卡单待与 SIM 硬件说明 https://docs.openluat.com/air8000/luatos/hardware/sim/ 。

7. Air8000A能否同时接2个SIM卡？

解答： 结论：能，是双卡单待。可以同时接两路 SIM，但同一时刻只有一张卡工作。

说明：Air8000 系列的 SIM1 / SIM2 支持双卡设计，只是“单待”——不能两张卡同时注册网络。卡槽切换由软件控制，切换后需要重新注网。除了两个独立卡槽，也支持“SIM1 + 模拟开关”的方式实现双卡单待，官方验证调试过的 SIM 卡模拟开关型号是 BCT4567。

处理步骤：

  1. 双卡设计时推荐 SIM1 带插入检测（USIM_DET），并按卡座规格保证插卡后 USIM_DET 悬空而不是接地，可降低功耗。
  2. 一路贴片卡时放 SIM2、卡座放 SIM1。
  3. 换卡用软件切换卡槽，注意切换过程会有短暂断网，业务上要做容错。

参考文档：Air8000 双卡单待与 SIM 硬件说明 https://docs.openluat.com/air8000/luatos/hardware/sim/ 。

8. Air780EHM如何存放多个MP3文件（总大小可能到500K）？

解答： 结论：放在模组自身的文件系统里（如 /luadb/ 目录），脚本按路径播放，不需要外挂存储。

说明：LuatOS 的音频接口支持直接播放文件系统中的音频文件，用法形如 audio.play(0, "/luadb/hello.mp3")，也可以传一个文件列表实现连续播放。多个 MP3 就是多几个文件，500K 这个量级在 Air780EHM 的可用文件空间内是可以放下的。要注意两点：文件要随脚本一起烧录进文件系统（不是打进脚本代码里），另外固件本身也占空间，需要留出余量。

处理步骤：

  1. 把 MP3 放进工程的资源目录，随脚本一起下载 / 烧录进模组文件系统。
  2. 脚本里用文件路径播放（如 audio.play(0, "/luadb/1.mp3")），不要整段读进内存缓冲。
  3. 容量不够时，优先降低音频码率；确实需要大容量再考虑外挂 SPI Flash / SPI NAND（合宙有对应配件），或改用 TF 卡配件板方案。
  4. 上线前用文件管理接口确认实际可用空间，避免烧录空间不足。

参考文档：LuatOS 音频接口（audio）https://docs.openluat.com/osapi/core/audio/ 。

9. Air780EPM是否有必要使用外部硬件看门狗芯片？

解答： 尚未解答

10. Air724UG下载的证书过期怎么办？

解答： 结论：Air724UG 已进入停更阶段，证书类文件不再更新，过期后无法由合宙换发新版本。

说明：Air724UG 属于早期型号，产品页上提供的证书都是当年取证固定的版本（入网许可证为 2023 年、型号核准与 CCC 为 2025 年、Rohs 2.0 为 2022 年）。这类认证文件随发证时间固定，厂商不会为已停产型号重新送检更新，因此“证书过期”不是软件问题，换固件、重新下载都解决不了。

处理步骤：

  1. 先到 Air724UG 产品页把现有证书原件下载下来，确认是哪一份证书、有效期到什么时候。
  2. 若项目只是留存历史资料，直接用原文件即可；若招标或合规要求证书在有效期内，需要评估切换到在产型号（如 Air780E 系列）。
  3. 替换选型和证书清单请与合宙销售 / FAE 确认，以官方最新口径为准。

参考文档：Air724UG 产品资料（含相关证书）https://docs.openluat.com/air724ug/product/ 。

11. Air8783如何配置APN（专网卡）？

解答： 结论：Air8783 不支持直接配置 APN，AT 命令里也没有对应的设置项，这类需求需要单独定制固件。

说明：Air8783 是 USB dongle 形态的方案，公开资料只有 USB RNDIS 上网相关说明，没有 APN 配置入口。专网卡必须指定 APN 才能激活 PDP，用标准固件拉不起来，属于功能缺失而不是配置问题。合宙对这类需求走的是定制流程：单独定制固件需预付 5000 元定金，出货 1K 后返还。

处理步骤：

  1. 先向运营商确认专网卡的 APN 名称与鉴权方式（是否需要用户名 / 密码）。
  2. 确定要走定制时，按上面的商务流程与销售对接，并把 APN 与鉴权参数一并提供。
  3. 不想定制的话，改选在产型号——LuatOS 侧可用 mobile.apn 接口配置 APN（如 mobile.apn(0, 1, "apn名称", "用户名", "密码", nil, 0)）。

参考文档：Air8783 资料中心 https://docs.openluat.com/air8783/ ，APN 配置接口 https://docs.openluat.com/osapi/core/mobile/ 。

12. Air795模块是否支持锁定到某个频段？

解答： 结论：支持，AT 版本可以用 AT+ECBAND 锁频段。

说明：AT+ECBAND 用于把模组限制在指定频段上工作。锁单个频段写 AT+ECBAND=3（即 BAND3），锁多个频段用逗号分隔，AT+ECBAND=3,34 表示同时锁 BAND3 与 BAND34。锁频一般用在功耗测试、现场基站排查，或规避某个已知受干扰的频段。

处理步骤：

  1. 先查清目标频段号——示例里的 3 / 34 只是举例，实际要按运营商和现场情况填写，不能直接照抄。
  2. 在 AT 指令的最开头就下发锁频段语句，之后再执行注册等后续流程。
  3. 测试完成后记得恢复默认（重启或按手册恢复），避免出货设备被锁死在单一频段。

参考文档：AT 指令说明（含锁频段章节）https://docs.openluat.com/air780e/at/app/command/lowpower/ 。

13. Air780EPM的UART2接毫米波雷达收不到数据且死机是什么原因？

解答： 结论：先升级到最新 2052 固件，再用测试点飞线区分“UART2 没收到”还是“雷达没发出来”。

说明：UART2 收不到数据并死机这类现象，先要排掉固件版本因素——Air780EPM 最新正式版本是 V2052（2026.09.16 发布），本身包含 socket、airlink、net_lwip2 等多处修复。硬件侧，UART2 在板上有测试点，可以把模组与外设“同步飞线”到同一个逻辑分析仪 / 示波器上，一眼就能看出 RX 上到底有没有波形。

处理步骤：

  1. 升级到 V2052 后复测，排除旧固件的已知问题。
  2. 用测试点抓 UART2 波形，核对波特率、数据位、校验、停止位与雷达一致，电平为 3.3V TTL。
  3. 模组 RX 无波形 → 查雷达供电与雷达自身输出；有波形但解析异常 → 查帧格式与脚本收包逻辑（缓冲区、超时、分包）。
  4. 把波形和串口日志一起给 FAE，便于快速定位。

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

14. Air780EPM在PSM+模式下唤醒后拨号不成功怎么处理？

解答： 结论：唤醒后主动退出飞行模式，并把休眠与唤醒的间隔拉到 35 秒以上（理论值约 75 秒）。

说明：PSM+ 是极低功耗模式，RAM 掉电、程序从头运行，链路层实际处于飞行模式，基站侧也把设备当作不可达。唤醒后如果立刻就想上网，极易被“上一次的网络状态”和基站侧的寻呼状态挡住；休眠与唤醒间隔太小更会放大这个问题。mobile.flymode(0, false) 的作用是主动退出飞行模式，强制重新走一遍注网流程。

处理步骤：

  1. 唤醒后先执行 mobile.flymode(0, false)，再等网络注册完成才发数据。
  2. 把休眠 / 唤醒间隔调到 35 秒以上，理论值约 75 秒，避免连续快速唤醒。
  3. 每次唤醒都按完整开机流程写脚本（读数据 → 发数据 → 重新进入 PSM+），不要假设上次的运行时数据还在。
  4. 需要跨掉电保留的关键数据用 fskv 存到 Flash。

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

15. Air780EPM是否支持外挂TF卡？

解答： 结论：模组本身没有独立的 SD / TF 卡接口，但可以通过 SPI 外挂合宙 AirMICROSD_1010 这类配件板来挂 TF 卡。

说明：这里容易混淆两件事。Air780EPM 不像 Air1601 / Air8101 那样带 SD 卡控制器，所以不存在“模组直接插卡”的用法，原答案是“不能”就是从这个角度说的；但 LuatOS 侧有完整的 TF 卡挂载与文件操作 demo，走 SPI（含片选脚）挂载，合宙标准配件列表里 AirMICROSD_1010 就是做这件事的。核心板上 TF 卡的片选为 GPIO8、SPI 通道 0，具体以实际硬件为准。

处理步骤：

  1. 硬件上接 AirMICROSD_1010 之类的 SPI TF 卡配件板，核对 CS / CLK / MOSI / MISO 与供电。
  2. 脚本按 demo 流程走：初始化 SPI → 拉高片选 → 挂载文件系统 → 文件读写。
  3. 若只是存少量音频 / 配置文件，优先用模组内部文件系统，省掉外部器件。

参考文档：Air780EPM 标准配件列表 https://docs.openluat.com/air780epm/luatos/app/accessory/ ，TF 卡示例 https://docs.openluat.com/air780epm/luatos/app/accessory/AirMICROSD_1010/ 。

16. Air780EPT和Air780E有什么区别？

解答： 结论：Air780EPT 长期供货、价格更低；Air780E 明年会停产，目前价格偏高。新项目优先按 Air780EPT 设计。

说明：两者属于同一代 4G Cat.1 模组，功能定位接近，差异主要在供货周期与价格策略上。Air780E 已进入生命周期后段，价格反而高于仍在产的 Air780EPT。选用临近停产的型号，后期会遇到供货收紧与证书维护的问题，新项目不建议再用。

处理步骤：

  1. 新项目直接按 Air780EPT 做设计，避免临停产切换带来的重新评估与改板。
  2. 已量产的老项目如果锁定 Air780E，提前评估替代方案（可参考 Air780EA 换 Air780EHU 的思路），预留软件与硬件兼容余地。
  3. 具体供货节奏与报价以合宙销售的最新口径为准。

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

17. Air780EPT新模块连接服务器（附着）速度慢是什么原因？

解答： 结论：先查天线匹配与信号质量（CSQ），其次考虑基站侧的历史连接记录。

说明：附着（Attach）慢在硬件侧最常见的原因是天线的匹配没做好——驻波比差、馈线过长、地平面不足，都会让模组在多个频段反复尝试，表现为入网时间长。另一方面，底层会优先连接之前连接过的基站，所以换位置 / 换卡后的首次入网本来就偏慢，属于正常现象。

处理步骤：

  1. 读取 CSQ / RSSI、RSRP、SINR 等指标，用同位置的成熟样机做对照，先判断是射频问题还是模块问题。
  2. 检查天线匹配网络（π 型匹配）、馈线长度与走线，必要时用网络分析仪复测。
  3. 换一个位置、换一张已在本网注册过的卡复测，区分“板子问题”还是“基站 / 卡的历史因素”。
  4. 若只是首次入网偏慢、后续正常，可在软件侧做附着超时重试，不必改硬件。

参考文档：Air780EPM/Air780EHM 硬件设计（天线）https://docs.openluat.com/air780epm/luatos/hardware/design/ant/ 。

18. Air780EA的pin to pin替代款是什么？是否快停产？

解答： 结论：替代型号是 Air780EHU，尺寸兼容可 pin-to-pin；Air780EA 的上游芯片确实快停产，Air780EHU 会持续供货。

说明：pin-to-pin 兼容意味着 PCB 不用改板、只换料号，但有两处容易踩坑要提前确认：一是固件与烧录的型号对应关系（换型号后固件要跟着换），二是频段与运营商适配（EHU 与 EA 的频段覆盖不一定完全一致）。上游停产是供应链的既定事实，不是短期波动，需要提前做替换验证。

处理步骤：

  1. 先确认自己在用哪一款 Air780EA（含频段需求），再对照 Air780EHU 的频段与型号说明。
  2. 打样后做一轮完整功能回归：注网、TCP / MQTT、音频、低功耗、外设复用都要复测。
  3. 新项目不要再选 Air780EA，直接按 Air780EHU 设计。

参考文档：Air780EHU / EHN 频段与型号对照 https://docs.openluat.com/air780ehnehu/product/air780ehufreq/ 。

19. Air8781P2供电12.05V大于12V会不会烧坏模块？

解答： 结论：12.05V 已超出规格上限，属于超压，不建议长期使用。Air8781P 的 VIN 规格是 5V–12V。

说明：板上用的是杰华特 JW5357 降压 DCDC，芯片本身最高输入可达 18V，官方把输入限制在 12V 是为了保留余量。12.05V 只超了一点点，短期通常不会立刻损坏，但设计余量已经被吃掉：叠加输入纹波、上电浪涌、高温环境后风险会被放大，长期量产更不适合踩线使用。

处理步骤：

  1. 先核对这个 12.05V 是电源标称值还是实测值。若是实测偏高，说明电源精度或负载调整率有问题，要先修电源。
  2. 优先把输入调到 12V 以内，建议再留 10% 左右余量更稳妥。
  3. 实在无法改供电时，改用输入范围更宽的电源板，或在前级加一级稳压，并做长时间高温老化验证。

参考文档：Air8781P VIN 电源说明 https://docs.openluat.com/air8781p/hardware/circuit/ 。

20. Air8781P2的IMEI如何绑定到合宙IoT账户？

解答： 尚未解答

21. Air8201G-BLMQ比Air8201H-BM功能更全但价格更低，两者有什么区别？

解答： 尚未解答

22. Air8781P2使用DTU固件如何喂狗（看门狗）？

解答： 结论：当前版本要在自己的任务里喂狗，用 GPIO 输出低脉冲；下个版本会支持在配置平台直接配置。

说明：Air8781P 板载合宙自研看门狗芯片 Air153C，喂狗信号为 GPIO24，喂狗超时时长 200~280 秒（与 VBAT 电压有关）。DTU 固件是配置化上网的方案，目前没有把喂狗做成平台参数，所以要么在自定义脚本里周期性产生喂狗脉冲，要么等新版本支持平台配置。

处理步骤：

  1. 先确认自己板型上的喂狗信号脚（Air8781P 为 GPIO24）。
  2. 在脚本里用定时任务周期性输出低脉冲，喂狗周期要明显小于 200 秒，建议留 2~3 倍余量。
  3. 不要把喂狗和耗时任务放在同一流程里阻塞，避免程序卡住时来不及喂狗被复位。
  4. 需要平台化配置喂狗的，等下个版本发布；发布节奏可向 FAE 确认。

参考文档：Air8781P 看门狗电路 https://docs.openluat.com/air8781p/hardware/circuit/ ，Air153C 配件说明 https://docs.openluat.com/accessory/Air153C/ 。

23. Air8780P3和8780P4引脚是否完全兼容、有什么区别？

解答： 结论：引脚完全兼容，区别在于是否支持板载 DCDC 供电与锂电池充电（以及天线形式）。

说明：文档口径很清楚——Air8780P1 / P2 支持 DCDC 供电（VIN 5V–12V），但不支持锂电池供电与充电；Air8780P3 / P4 没有板载 DCDC（只能 VBAT 供电），但支持 PIN19 VBAT 接锂电池并带充电管理。同组内再按板载天线 / IPEX 外接天线区分，所以 P1 / P2 / P3 / P4 的差异集中在“电源与充电电路 + 天线”，不是管脚定义。

处理步骤：

  1. 按项目形态选型：要内置锂电池就选 P3 / P4；只用 DCDC 供电选 P1 / P2。
  2. 换型号时重点核对电源与充电部分的 BOM 差异（文档里有 P1 / P2 与 P3 / P4 的 BOM 对照）。
  3. 天线形式按整机结构定，外接天线选带 IPEX 的型号。

参考文档：Air8780 型号与充电说明 https://docs.openluat.com/air8780/hardware/circuit/ 。

24. Air8203 V1/V2在PSM+模式下功耗偏高（约1.0~1.2mA）是什么原因？

解答： 尚未解答

25. Air8204/8783整机（录音工牌）价格及基站定位（airlbs）收费标准？

解答： 结论：Air8204 整机淘宝价 999 元 / 台；基站定位用的是收费的 airlbs 方案，资费公开，详见下方说明。

说明：Air8204 是可直接量产的录音定位工牌 PCBA——通信定位基于 Air780EGH 模组，录音基于顺芯 ES7243，运动检测基于明皜 DA221，同时支持锂电池充电管理，官方淘宝店有售，价格会随活动浮动。airlbs / lbsloc2 这类基站定位走的是合宙的定位服务，不是免费接口：免费版 lbsloc2 仅支持单基站定位（约 2 分钟最多 1 次），收费版 airlbs 支持多基站+WiFi 定位、请求频率更高，按频率分档公开计价。

处理步骤：

  1. 整机价格以官方淘宝店当前标价为准，批量价找销售谈。
  2. 选型时先明确精度与频率需求：纯基站定位精度有限但省电；需要更准请走 GNSS 方案。
  3. airlbs 资费按请求频率公开分档：合宙基站/WIFI 数据库单台设备年费为 1 元（12 次/小时）、2 元（24 次/小时）、5 元（60 次/小时）、10 元（240 次/小时），高德数据库为 10/20/50 元/年；开通可在 iot 平台“订单管理”自助缴费，或联系合宙销售协助办理。

参考文档：Air8204 产品手册 https://docs.openluat.com/air8204/product/ ；基站定位资费说明 https://docs.openluat.com/value/basestation/fee/ 。

26. Air8602的RS485接口接线及无法接收报文如何排查？

解答： 结论：先核对线序，再检查两个串口的转向脚设置。485 四根线黄白红黑依次对应 B、A、+12V、GND；1 路转向脚是 GPIO65，2 路是 GPIO57。

说明：RS485 是半双工总线，收发靠转向脚（DE / RE）切换。脚本里转向脚配错或根本没切换，就会出现“能发不能收”或完全收不到报文。Air8602 板载两路隔离 RS485（带隔离电源、TVS、120Ω 终端电阻），A / B 接反不会损坏器件，但通信一定不正常。

处理步骤：

  1. 按黄白红黑 = B / A / +12V / GND 核对线序，A / B 反了就对调。
  2. 检查代码里的转向脚：一路 GPIO65、二路 GPIO57，确认发送前拉高、发送完成后拉低切回接收。
  3. 核对两端波特率 / 数据位 / 校验一致，注意总线终端电阻匹配（板载已有 120Ω，长线时留意总阻抗）。
  4. 用示波器或抓包确认总线上是否有数据，把“总线无数据”和“本地收发切换错误”分开排查。

参考文档：Air8602 RS485 电路 https://docs.openluat.com/air1601/product/air860x/air8602/module/circuit/485/ 。

27. Air1601通过Air8300上网、摄像头整板发烫是否正常？

解答： 结论：预览 / 识别过程中整板发烫是正常现象，但识别完成后应该把摄像头关掉。

说明：Air1601 是面向多媒体应用的 SoC（屏 / 摄像头 / 音频），UVC 摄像头持续出流时本身发热明显，叠加模组功耗，整板温度上升属于预期。真正需要警惕的是“空闲时也一直烫”——那说明摄像头这一路没有按需关闭，既浪费功耗也影响器件寿命和整机可靠性。

处理步骤：

  1. 正常做法：进入人脸预览 / 识别时才给摄像头上电，识别完成立即关断这一路供电。
  2. 检查软件是否存在摄像头常开、或识别后没有断电的情况。
  3. 核对结构与散热条件（是否紧贴电池、外壳有无导热路径），长时间满负荷工作要单独做温升测试。
  4. 若空闲状态仍发烫，按功耗排查思路逐路断电定位耗电支路。

参考文档：AirCAMERA_1034 使用说明 https://docs.openluat.com/accessory/AirCAMERA_1034/ ，Air8300 双网口双 485 工控板 https://docs.openluat.com/exb/EXB_8000_CH390_1/2/ 。

28. 合宙模块的回流焊钢网开多厚合适？散料是否需要烘烤？

解答： 结论：钢网开 0.2mm；散料建议先烘烤再上线贴片。

说明：钢网厚度决定锡膏量，0.2mm 是合宙文档与资料里给出的口径，配合常规焊盘设计能保证焊点饱满又不连锡。散料（拆封过、散装或长期暴露在潮湿环境中的器件）直接过回流焊容易“爆米花”——内部吸附的水汽在高温下汽化，导致模组分层、虚焊甚至失效，所以必须先烘烤除湿。

处理步骤：

  1. 钢网按 0.2mm 制作，开孔比例与焊盘匹配。
  2. 散料按烘烤要求做除湿处理，烘烤参数与回流焊炉温曲线参考合宙 SMT 相关文档。
  3. 回流焊采用无铅工艺曲线，峰值温度与时间按文档执行。
  4. 上料前确认真空包装完好、湿度指示卡未变色；能整卷用就不要用散料。

参考文档：合宙 SMT 相关说明 https://docs.openluat.com/common/smt/ 。

29. Air780EHM的4G信号强度支持范围是多少？

解答： 尚未解答

30. 批量烧录Air780EPM时进入boot后COM口不固定如何解决？

解答： 结论：用量产烧录工具压缩包里的注册表文件双击导入，把 BOOT 端口固定下来。

说明：除 Air8101 外，其余模组的烧录口指的是模组进入 boot 模式时出现的那个“boot 端口”。boot 模式下模组最多保持 15 秒左右就会转入开机状态，端口会由一个变成三个，端口号因此发生漂移，port_config.ini 里配好的端口下次就对不上。导入注册表文件可以让系统固定 USB 设备的端口分配，避免这个漂移。

处理步骤：

  1. 以管理员权限双击导入量产烧录工具压缩包中的注册表文件，建议导入后重启一次机器。
  2. 在 port_config.ini 里按设备管理器实际的 COM 号使能端口：COM ≤ 24 直接改 enable；COM > 24 时任选一个空闲 Group 改 hostport。
  3. 同一端口只能有一个状态，不能在不同 Group 里同时 enable / disable 同一个 COM。
  4. 换主机或换 USB 口后重新核对一次端口映射。

参考文档：合宙量产烧录工具使用教程 https://docs.openluat.com/common/Luat_productiontool/ 。

31. 合宙TRAE/各类AI工具的MCP服务连接不上（SSE 404）怎么办？

解答： 结论：把 MCP 配置文档地址直接发给 AI 助手，让它自行下载并按文档配置。

说明：MCP 的配置项（服务地址、传输方式、参数）会随工具版本变化，手改配置文件很容易因为用了旧的 SSE 地址而返回 404。合宙把最新配置方式写在专门的 MCP 配置文档里，让 AI 助手读取该文档、按最新示例覆盖本地配置，比自己试错快得多。

处理步骤：

  1. 把 https://docs.openluat.com/ai/mcp_cli/ 发给 AI 助手，让它自行下载并按文档配置。
  2. 配置完成后重启 AI 客户端，确认 MCP 服务已连接。
  3. 若仍 404，先清理残留的旧 MCP 配置项（老地址会被优先命中），再按文档重建。
  4. 实际可用的服务地址与鉴权方式以该文档当前内容为准。

参考文档：合宙 MCP 配置说明 https://docs.openluat.com/ai/mcp_cli/ 。

32. 合宙8101串口2的问题是否修复？

解答： 结论：问题已修复，需要用带修复的固件版本验证（如 LuatOS-SoC_V2005_Air8101_111.soc）。

说明：Air8101 的串口 2 异常主要出现在“USB 摄像头启动后串口受影响”这类场景，历史上按版本逐个修复过 UART1 / UART2 的类似问题。判断是否修好要看具体固件号，而不是看型号——烧错版本就会误以为没修复。公开固件页当前最新正式版本是 V2020；如果 V2005 这类修复版不在公开列表里，需要向 FAE 索取。

处理步骤：

  1. 确认现象对应的固件版本，再烧入带修复的版本复测。
  2. 复测时保留“不接摄像头”和“接摄像头”两组对照，确认串口额外数据确实消失。
  3. 拿不到该版本固件时，先用最新正式版本（V2020）复测，并联系 FAE 确认修复是否已合并进正式版。
  4. 量产出货建议统一用最新正式版本，避免版本分散带来维护问题。

参考文档：Air8101 固件版本 https://docs.openluat.com/air8101/luatos/firmware/ 。

33. 合宙SIP方案目前只有源码资料吗？有没有硬件资料、何时出样品？

解答： 结论：目前只有源码相关资料，硬件下周出样品。

说明：合宙 SIP 方案分两类能力——单 SIP 通话（SIP 终端之间通话，语音走 RTP，只需 IP 网络）和 SIP+4G 桥接（SIP 终端 ↔ 4G 模组 ↔ 手机号，需要 13 / 113 号固件）。软件侧已经有完整文档和 demo（sip_demo、sip_cc_demo），硬件侧还在推进中。

处理步骤：

  1. 软件可以先动起来：按文档选固件（跑单 SIP 用支持 audio 的固件，桥接功能用 13 / 113 号固件），先把 demo 跑通。
  2. 硬件资料与样品的时间点以销售 / FAE 的最新答复为准，建议定期跟一次。
  3. 场景上注意合规：SIP 语音能力仅限用于合法的对讲、门禁、告警等用途。

参考文档：合宙 SIP 语音通信说明 https://docs.openluat.com/air780ehv/luatos/app/multimedia/sip/ 。

34. Web端能否通过SIP实现对讲？

解答： 结论：可以。到 docs.openluat.com 搜 sip 即可找到文档，支持基于 SIP 的通话能力，可对接 Web 侧软话机实现对讲。

说明：SIP 是标准信令协议，语音通过 RTP 传输。只要 Web 侧有符合标准的 SIP 客户端（浏览器软话机或 SIP 网关），与合宙模组注册到同一个 SIP 服务器，就能建立通话。前面提到的单 SIP 通话只需 IP 网络；若要让 Web 端直接打到手机号码，则需要 SIP+4G 桥接能力（依赖 4G VoLTE）。

处理步骤：

  1. 部署一个 SIP 服务器（Asterisk / FreeSWITCH 等），模组与 Web 端都注册到同一台服务器。
  2. Web 端按标准 SIP 协议对接，注意 4G 出口、NAT 穿透与编解码保持一致。
  3. 模组侧按文档选固件（单 SIP 用支持 audio 的固件，桥接用 13 / 113 号固件），先跑通 demo 再联调。
  4. 若 Web 端夹带私有协议扩展，先抓一次信令包确认能否互通。

参考文档：合宙 SIP 语音通信说明 https://docs.openluat.com/air780ehv/luatos/app/multimedia/sip/ 。

35. Air724UG能否与Asterisk集成？

解答： 结论：可以。Air724UG 按 SIP 协议对接，改 IP 和端口即可与 Asterisk 注册到一起。

说明：Asterisk 是最常用的开源 SIP 服务器，只要模组侧按标准 SIP 流程（REGISTER / INVITE）对接，把服务器地址与端口改成 Asterisk 的实际配置就能注册。需要提醒的是，部分 SIP 产品会夹带私有协议扩展，这种情况下标准部分即使对得上也可能调不通，必须抓包确认。

处理步骤：

  1. 在 Asterisk 上建好分机（sip.conf / pjsip.conf），拿到服务器地址、端口与账号密码。
  2. 模组侧按文档配置 SIP 参数后注册，先确认注册状态为成功。
  3. 测双向语音是否通路，不通用时核对编解码（如 PCMA / PCMU）与 RTP 端口范围。
  4. 注册不上时抓信令包，区分网络 / 鉴权问题与私有协议不兼容。

参考文档：合宙 SIP 语音通信说明 https://docs.openluat.com/air780ehv/luatos/app/multimedia/sip/ 。

36. Luatools在中文路径下下载提示失败怎么办？

解答： 结论：把 Luatools 放到非中文路径下，例如 D:\luatools\。

说明：Luatools 及其子进程（FlashToolCLI 等）在处理中文路径时存在编码问题，历史版本有明确的修复记录——“修复 exe 放中文路径下生成差分包崩溃”“修复中文安装路径下 FlashToolCLI 子进程编码崩溃”。也就是说这一类问题在持续修，但最稳妥的做法仍然是全英文路径，避免踩到尚未覆盖的分支。

处理步骤：

  1. 把 Luatools 整个目录移到纯英文路径（如 D:\luatools\），同时保证工程脚本目录也是英文路径。
  2. 升级到最新版 Luatools，已修复的中文路径问题都在新版本里。
  3. 仍失败时保留完整报错日志交给 FAE，判断是编码问题还是其他原因（如杀软拦截、USB 驱动）。

参考文档：Luatools 工具使用教程 https://docs.openluat.com/common/Luatools/ 。

37. 合宙模块有没有入网许可证？

解答： 尚未解答

38. Air8204录音工牌需求/录音存储覆盖方案如何设计？

解答： 结论：按“已传即删、弱网存储覆盖、断电写入保护”三条来设计。客户已整理成需求，按合宙标准协议开发。

说明：录音工牌的核心矛盾是本地存储有限但录音持续产生。网络正常时要尽快把录音上传并释放本地空间；网络不好时必须能就地缓存，满了按策略覆盖最旧数据，保证不丢关键片段；整机随时可能被拔电，写入过程要有断电保护，否则容易损坏文件系统。

处理步骤：

  1. 已传即删：确认上传成功后再删除本地文件，并保留一段缓冲时间以便重传。
  2. 弱网覆盖：采用循环覆盖策略（按文件时间 / 优先级淘汰），并设置本地空间水位线触发清理。
  3. 断电保护：写入采用“先写临时文件再改名”的方式，或增加掉电检测与文件校验。
  4. 具体接口与上报格式按合宙标准协议对接，需求细节与 FAE / 销售确认。

参考文档：Air8204 产品手册 https://docs.openluat.com/air8204/product/ 。

39. Air724UG/Air780E是否需要外挂看门狗？

解答： 尚未解答

搜索