跳转至

常见问题 - 2026-09-11

数据日期：2026-09-11

1. 合宙下载工具只能下载LuatOS固件，AT固件无法下载/找不到AT固件

解答： 结论：先确认你要的型号到底有没有发布 AT 固件——不是所有型号都提供 AT 版本；确实有 AT 固件的型号，可在文档站对应型号的“固件和 demo”页面找到下载入口。

排查与获取路径：

  1. 到 https://docs.openluat.com/ 打开该型号的产品页，进入“固件和 demo → 固件版本”，页面会区分 LuatOS 固件 与 AT 固件；AT 固件通常单独列出。
  2. 该型号页面上没有 AT 固件条目，说明这个型号本身不提供 AT 固件（LuatOS 二次开发型号常见），换型号才能解决。
  3. 工具侧下载失败：先升级 Luatools 到最新版，再在“资源下载”里按型号找；仍找不到就把型号、固件版本号和工具版本发到官方企业微信群或问 https://ai.luatos.com/ 。
  4. 注意 AT 固件与 LuatOS 固件不能混刷：固件与型号不匹配会刷写失败，甚至无法启动。

参考：固件下载说明 https://docs.openluat.com/air780epm/luatos/firmware/780epm_version/ ，工具教程 https://docs.openluat.com/common/Luatools/ 。

2. 从哪里能找回旧密码/账号密码修改

解答： 尚未解答

3. 小程序无法登录/验证不了

解答： 结论：小程序近期确实还有问题，先用 PCBA 方式绑定设备这个绕行方案；登录层面的卡顿可先按下面的顺序自救。

处理步骤：

  1. 登录不进去时，杀掉小程序进程重新打开（后台划掉再进），多数是登录态没刷新。
  2. 仍然不行，长按小程序删除后重新进入，让小程序重新拉取初始化数据。
  3. 绑定设备这一步不依赖小程序：改走 PCBA 方式绑定（在 IoT 平台侧完成设备归属与项目绑定），先把设备用起来。
  4. 问题持续存在的，把小程序名称、手机型号、系统版本、操作时间点和报错截图发到官方企业微信群，便于定位是小程序版本问题还是账号问题。

参考：设备归属与绑定 https://docs.openluat.com/air780epm/product/attributioniot/ ，平台入口 https://iot.openluat.com/ 。

4. 合宙有哪些天线？AirANT05、AirANT06、ANT1564、ANT4073 等有什么区别？在哪购买？

解答： 结论：这些型号的差别主要在支持的频段、封装形态和增益三方面，按你要连的网络选对应频段即可。

选型对照：

应用 频段 说明
4G 低频 698–960MHz 覆盖移动/联通/电信的低频段，穿透与覆盖更好
4G 中高频 1710–2690MHz 容量层频段，城区速率更优
WiFi / 蓝牙 2.4GHz 2.4G 天线不能与 4G 天线混用

选购与使用要点：

  1. 先确认模组要用的频段，再按频段选天线；频段不对会导致搜不到网或信号极差。
  2. 注意接口形态（SMA / IPEX / 板载焊盘）与整机结构是否匹配，IPEX 座有公母之分，接错插不上或者接触不良。
  3. 天线安装要保证净空区，远离电池、金属外壳、电机与高频器件；射频走线做 50Ω 匹配。
  4. 购买渠道：合宙淘宝店 https://luat.taobao.com/ 搜索对应型号；也可以按频段在淘宝自行选购第三方天线。
  5. 天线效果与整机结构强相关，正式产品建议送天线厂按实际结构调试（天线设计指南：https://docs.openluat.com/air780epm/luatos/hardware/ant/ ）。

5. Air780EPM 配套的贴片天线在哪里买？淘宝店没有

解答： 结论：官方店里不一定单卖该型号的贴片天线，按频段自行选购即可，或直接问 AI 拿推荐。

做法：

  1. 先确认要的频段（4G 低频 698–960MHz / 中高频 1710–2690MHz），按频段买贴片天线，不必指定合宙型号——天线是通用器件。
  2. 贴片天线的关键参数是尺寸、频段、增益、阻抗（50Ω），以及是否需要净空区；购买时把这几项和商家确认清楚。
  3. 选型拿不准时，在 https://ai.luatos.com/ 提问（说明模组型号 + 频段 + 安装方式），AI 会给具体建议。
  4. 贴片天线对 PCB 净空非常敏感：天线下方与周边不能铺铜、不能放器件和走线，否则实测增益会远低于标称值。

参考：天线设计指南 https://docs.openluat.com/air780epm/luatos/hardware/ant/ 。

6. 8783 获取不到手机号 mobile.number()，能否主动发送手机号绑定设备？

解答： 结论：手机号读不到是卡的问题，不是脚本能解决的——固件里已经有读取发送方卡号的能力，但很多运营商并没有把本机号码写进 SIM 卡，这种情况下任何方式都读不出来。

说明与做法：

  1. mobile.number() 读的是 SIM 卡里存储的本机号码（MSISDN）；运营商未写入时返回空，这与固件版本无关。
  2. 只有运营商写入过号码的卡才能读到；换卡测试即可区分：换一张能读到的卡 → 说明是原卡未写入。
  3. 不能用“主动发送手机号”来绕过：设备自己也不知道号码，没法发。要绑定设备请改用设备侧唯一标识 IMEI 作为绑定依据（在 IoT 平台按 IMEI 归属/绑定），这是可靠且不依赖卡的做法。
  4. 如果业务强依赖手机号，建议向卡商确认该卡是否预置 MSISDN，或改用有号码写入的卡。

参考：mobile 库 https://docs.openluat.com/osapi/core/mobile/ 。

7. Air780EPM 用 IIC 接口接 SI522/RC522 读卡（PIN66、67）不通过，求可用例程

解答： 尚未解答

8. 想找宠物/人员定位器解决方案（4G+GPS+MIC+喇叭），体积要小，有资料和报价吗？

解答： 结论：可走 Air8201 整机方案，合宙可提供 PCBA；但要注意天线调试不容易，是这类小体积产品的主要难点。

评估要点：

  1. 形态与成本：8201 整机/PCBA 整体约几十元量级，具体要按规格核算（含天线、麦克风、喇叭、电池方案的差异），需要进一步评估后才能报准。
  2. 天线是最大风险：体积小意味着 4G 天线与 GNSS 天线净空很小，还要兼顾喇叭/麦克风开孔，实测性能常比开发板差很多；建议先拿官方开发板验证，再定结构。
  3. 功能确认：宠物/人员定位器一般需要 4G 上报 + GNSS 定位 + 语音对讲（MIC + 喇叭），确认是否需要双向通话（要选带音频通路与 SIP/cc 能力的方案）。
  4. 推进方式：把目标尺寸、续航、是否需要语音、预计用量整理成需求，找合宙商务评估 PCBA 与报价；选型参考 https://docs.openluat.com/SelectionGuide/SelectionGuide/ 。

9. 780EHV-SIP 连续拨打约 300 通后通话无声（CC 异常），什么时候能修复？

解答： 结论：合宙已按新固件方向排查中，需要你按原测试步骤复测并回传日志，重点是“挂断后立即重拨”这个场景。

请这样配合复测：

  1. 保持原来的拨打节奏（连续拨打、挂断后立即重拨），复现出无声现象。
  2. 抓取该时段完整日志，重点查找两类打印：
  3. “等待上一通清理 / 上一通清理完成”
  4. “already running” 这两类打印能判断上一通通话资源是否已经释放、是否出现重复占用。
  5. 记录复现时的固件版本号、通话次数、卡运营商，连同日志一起发到官方企业微信群。
  6. 在修复版本发布前，业务侧可先用主动通话超时兜底：到时间主动挂断并重拨下一个号码（参考“对方挂断如何及时判断”的相关问答），降低单次通话资源未释放的概率。

参考：SIP 通话资料 https://docs.openluat.com/air780ehv/luatos/app/volte/call/ ，exsip 扩展库 https://docs.openluat.com/osapi/ext/exsip/ 。

10. Air780E 发短信失败、打电话无法接通是什么原因？

解答： 结论：这属于需要按具体现场信息定位的问题（卡、信号、运营商、脚本、硬件都可能），先用官方 AI 问答按你的实际情况逐步缩小范围最有效率。

操作步骤：

  1. 打开 https://ai.luatos.com/ ，点击右下角 AI 问答，登录后提问。
  2. 提问时一次性把关键信息给全：模组型号、固件版本、运营商与卡类型（物联卡/手机卡）、脚本或 AT 指令、完整报错。
  3. AI 回复异常时可重试；仍无法解决，把对话截图 + 串口日志发到官方企业微信群由人工跟进。
  4. 自查可以顺手做两件事：①换一张手机卡测试（物联卡常被限制短信/语音，短信需单独开通）；②用 mobile.status() / SIM_IND 确认卡已就绪（RDY），再排查信号（mobile.rsrp()）。

参考文档：mobile 库 https://docs.openluat.com/osapi/core/mobile/ ，cc（语音通话）库 https://docs.openluat.com/osapi/core/cc/ 。

11. Air8000 的 SIP 账号密码在哪里修改？如何开通测试账号？

解答： 结论：在 demo 里修改 SIP 的账号密码；测试账号绑定 IMEI 申请（找对接的合宙同事开通）；固件建议用最新的 v2050_13 号。

操作要点：

  1. 改账号密码：在官方 SIP demo 的初始化配置里改（服务器地址、端口、用户名、密码等），不要改底层库。demo 位于仓库对应产品目录的 demo/sip（https://gitee.com/openLuat/LuatOS/tree/master/module ）。
  2. 开通测试账号：把模组 IMEI 提供给合宙对接人（原 12345670/12345671 这类公共账号已作废）；一个 IMEI 给两个账号（一个给设备端，一个给另一台设备或软终端）。
  3. 固件版本：建议使用最新的 v2050_13 号固件，老版本存在通话相关已知问题。
  4. 硬件前提：SIP 通话必须有真实的音频通路（麦克风 + 喇叭，部分方案需要外挂 PA），代码跑通不等于能听见声音，硬件要同步确认。

参考：SIP 资料 https://docs.openluat.com/air8000/luatos/app/multimedia/sip/ ，exsip 库 https://docs.openluat.com/osapi/ext/exsip/ 。

12. LuTools 项目管理/升级界面找不到，为什么和以前不一样？

解答： 结论：新版界面改版后要登录才能看到完整功能，而且项目管理在全屏状态下的右侧。

处理步骤：

  1. 先登录合宙账号——新版把部分功能（含项目管理、资源下载）放到了登录后。
  2. 把 Luatools 全屏（最大化窗口），项目管理/升级相关入口会在窗口右侧出现。
  3. 界面找不到某个功能时，优先怀疑“窗口太小被折叠”或“未登录”，而不是工具损坏。
  4. 若确实没有你需要的能力，升级到最新版本；新版界面调整后会持续迭代，工具教程见 https://docs.openluat.com/common/Luatools/ 。

13. Air8000 固件太多，哪个支持 SIP？开发板有音频输入吗？

解答： 结论：按固件版本页的“支持核心库列表”选——要 SIP 就选包含 exsip（或 SIP 相关音频组件）的固件编号；开发板有音频输入（麦克风通路）。

做法：

  1. 打开 Air8000 固件页 https://docs.openluat.com/air8000/luatos/firmware/ ，逐个编号看“支持的核心库/组件”，选中包含音频与 SIP 能力的版本。
  2. 注意固件编号不是越大越新，编号代表功能裁剪组合（脚本区/文件系统大小、内置库不同），以库支持矩阵为准。
  3. 开发板本身带音频输入，但喇叭/PA 通路与麦克风要按开发板硬件说明接好；需要更大音量时再考虑外挂 PA。
  4. 拿不准哪个编号合适，把需求发到 https://ai.luatos.com/ 或官方企业微信群确认。

参考：SIP 资料 https://docs.openluat.com/air8000/luatos/app/multimedia/sip/ ，exsip 扩展库 https://docs.openluat.com/osapi/ext/exsip/ 。

14. 日志文件写入失败怎么解决？

解答： 结论：最常见的原因是磁盘（通常是 D 盘）空间已满，先查剩余空间。

处理步骤：

  1. 打开“此电脑”看各盘剩余空间，尤其是 Luatools 安装盘和工程所在盘；剩余空间不足会导致日志/打包文件写不进去。
  2. 清理空间：删掉 Luatools 目录下的 _temp 和过期 log、旧的固件包与备份；日志默认只留最近几天（可参考工程里的日志保留配置）。
  3. 确认安装/工程路径不要放在只读目录或系统保护目录（Program Files 下可能因权限被拒写），建议放到 D:\Luatools 这类浅路径。
  4. 检查杀毒软件是否拦截写入，必要时把 Luatools 目录加入白名单。
  5. 清理后重启 Luatools 再试；仍失败时记录具体报错路径与提示，发到官方企业微信群。

参考：工具教程 https://docs.openluat.com/common/Luatools/

15. Air8202 整机没有二维码，如何开通/绑定设备？

解答： 结论：目前发货的 8202 整机确实还没贴二维码，扫码绑定功能也还没做，先按 PCBA 方式绑定设备。

处理步骤：

  1. 不用等二维码：改走 PCBA 方式绑定——在 IoT 平台按设备 IMEI 做归属与项目绑定（https://iot.openluat.com/ ），或把 IMEI 清单提供给合宙同事批量归属。
  2. 绑定后设备上电联网即可上报，可在官方位置服务里查看在线与轨迹。
  3. 需要扫码即用的场景，先向对接的销售/技术支持确认二维码功能的上线时间，不要按“有二维码”做产品说明书。
  4. 相关归属规则：https://docs.openluat.com/air780epm/product/attributioniot/ ，8202 资料 https://docs.openluat.com/air8202/product/ 。

16. Air8601 用 4G 卡连不上，需要烧录新固件吗？怎么测试 4G？

解答： 结论：不是固件问题，是硬件跳线——现在发货的是 4G/WiFi 共用版本，要用 4G 必须吹掉 R1、R2 电阻，断开 8601 与 Air6205 的连接（后续发货会区分 4G 版与 WiFi 版）。

处理步骤：

  1. 确认手上的板子是“共用版本”（当前发货批次）：找到 R1、R2 两颗电阻。
  2. 吹掉 R1、R2，即断开 1601 与 Air6205 之间的连接（自己处理不便的可以找修手机店代吹）。
  3. 接上 4G 天线与 SIM 卡，上电确认注网与 IP_READY，再测数据链路。
  4. 后续批次会按 4G 版 / WiFi 版分开供货，采购时说明需求，避免又拿到共用版。
  5. 相关资料见 https://docs.openluat.com/air8601/product/ 。

17. 8601 官网 demo 不能联网，打包项目 soc 放哪？有命令行打包工具吗？

解答： 结论：先看 main.lua 里的网络模块是不是还写着 WIFI 没改成 4G；打包则用官方 tools 创建项目生成量产文件，命令行场景可用 luatos-cli。

处理步骤：

  1. 改网络配置：官网 demo 默认按 WiFi 编写的，直接拿来跑 4G 当然连不上；把 main.lua 里的网络初始化/网卡选择改成 4G（或用多网融合方式按可用链路选择）。
  2. 打包：用 Luatools 的“项目管理/固件工具”新建项目 → 选好对应型号的固件（soc）+ 添加脚本与资源 → 生成量产文件；soc 是跟着项目选的，不需要自己找位置放。
  3. 命令行打包：可参考官方 luatos-cli（https://gitee.com/openLuat/luatos-cli/tree/main ）实现 CI/脚本化打包。
  4. 硬件侧别忘了：共用版本要用 4G 必须先按上一条处理 R1/R2 跳线。

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

18. 8202 整机不上报，Move 网站看不到在线，怎么解决？

解答： 结论：定位到的原因是并发数达到门限、排队超时后连接被断开而设备没有重连。设备端要先加上重连逻辑。

处理步骤：

  1. 设备端加重连（必做）：长连接断开后不要只等，用状态轮询/回调触发重连；参考官方 demo 的“while 循环 + mqttc:state() 状态判断 + 断开后 close 再 create”结构，或 mqttc:autoreconn(true, 3000)（多网卡场景不要用 autoreconn，改由外层 task 重建）。详见 https://docs.openluat.com/osapi/core/mqtt/ 。
  2. 服务端侧调整：合宙会根据实测情况调整并发数与超时配置，这部分服务端改即可，设备端不用改。
  3. 验证方法：改完重连逻辑后，人为断网/断开服务器再恢复，确认设备能自动重新上线并继续上报。
  4. 顺带确认设备已归属到当前账号项目，否则平台上不会显示在线。

19. Air780EGP/GEG 是否都带定位？价格差多少？

解答： 结论：两者都带卫星定位（GNSS）；批量含税价参考：Air780EGP 28.8 元/片，Air780EGG 37.8 元/片。

差异说明（选型参考）：

  1. 两者都带 GNSS，主要差别在于内置传感器等附加能力：Air780EGG 在带 GNSS 的基础上还内置 G-Sensor（三轴加速度传感器，走 exvib 扩展库），适合需要震动/运动检测、静止漂移抑制、运动唤醒的场景。
  2. Air780EGP 没有内置 G-Sensor，成本更低，适合只做定位上报的产品。
  3. 价格以当期销售报价为准；具体功能与封装差异见选型指南 https://docs.openluat.com/SelectionGuide/SelectionGuide/ 与各型号产品页。

20. Air6205 的 WiFi/蓝牙天线应该选什么样的？频率多少？能外接棒状天线吗？

解答： 结论：Air6205 只支持 2.4GHz，买 2.4G 天线即可（与 4G 天线完全不同，不能混用）；6205A 是外置天线但原配不是棒状，可以用棒状天线外接。

选型与设计要点：

  1. 频率：只支持 2.4GHz（WiFi/BT 共用），不要买 5GHz 或双频天线指望提升 WiFi 性能。
  2. 接口：确认模组/模块用的是 IPEX 还是焊盘；IPEX 座有公母之分，接错会接触不良。
  3. 6205A 外接：6205A 为外置天线版本，可用棒状天线外接以获得更好增益；棒状天线注意垂直放置、远离金属与 4G 天线。
  4. 板载天线：要做板载天线时按官方参考设计走，注意净空区与 50Ω 走线：https://docs.openluat.com/air6205/product/shouce/ 。
  5. 2.4G 与 4G 天线不要挤在一起，会互相干扰（尤其 4G 发射时的谐波），布局上尽量拉开距离或正交放置。

21. 8700 PSM 功耗偏高（约 7uA），SIM 电路 ESD 型号是什么？设置 2V 电压唤醒后变回 3.3V 是否正常？网站 AI 不见了？

解答： 结论：①PSM+ 底电流 3~12µA 都属正常，7µA 不用特别处理；②自定义电压无法保持，只能保持高低电平，设置 2V 后变回 3.3V 是已确认的正常行为；③网页 AI 消失的问题正在修复。

逐项说明：

  1. 功耗：PSM+ 的底电流与实网、板级电路、外设状态强相关，3~12µA 都在正常区间；要压到更低需从外围漏电（ESD、上拉、外设供电）下手，并用功耗分析仪实测。设计与实测方法见 https://docs.openluat.com/common/airpower/ 。
  2. 电压设置：GPIO/电源配置只能保持高低电平状态，不能维持一个自定义的模拟电压值，所以设置 2V 后回到 3.3V 属于预期行为，不是 bug。
  3. SIM 电路 ESD 型号：这类选型问题建议直接把板级电路（SIM 部分原理图）发到官方企业微信群，由硬件工程师按你的走线与卡座方案推荐具体型号，避免选错参数。
  4. 网页 AI：入口异常已反馈，修复期间可先用 https://ai.luatos.com/ 。

22. Air8000D 53 号引脚悬空，外接 LED 会闪烁/外接 10K 下拉也闪烁，为什么？

解答： 结论：该引脚悬空时不用管它，不要外接 LED——这个现象很可能是射频干扰耦合导致的，接了 LED 反而会带你进入误判。

说明与做法：

  1. 引脚悬空时检测到电平跳动/闪烁，属于高阻态下受射频与邻近走线干扰的常见现象，不代表功能异常。
  2. 不要在这个脚上接 LED 做指示：LED 作为负载会让电流断续流动，既可能影响射频性能，也会让指示毫无意义（本来就受干扰）。
  3. 真的需要控制这个脚时，在代码里初始化为 GPIO 并明确设定方向与电平，让它变成受控输出，而不是依赖默认的高阻状态。
  4. 确有“某个脚必须固定电平”的需求（如使能/选通），用上拉/下拉电阻硬件定死，并通过固件手册确认该脚是否允许外部驱动。

参考：Air8000 硬件文档 https://docs.openluat.com/air8000/luatos/hardware/ 。

23. 设备 4G 掉线后不重启就恢复不了，如何解决？

解答： 结论：原因是4G 链路卡死且旧的 MQTT 重连逻辑有缺陷——旧逻辑只重连 MQTT 而不检查网络本身，链路已经死了它就永远连不上。新代码改为每 60 秒检查一次 MQTT，连续 5 分钟未连接就执行 rtos.reboot() 自动软重启整机。

处理步骤：

  1. 用新代码：确认工程里用的是修好后的脚本版本，不要沿用旧 demo 的重连逻辑。
  2. 先小批量验证：拿几个测试设备挂测，确认断网后能自动恢复（可以人为拔天线/断网复现）。
  3. 设计取舍：软重启是最后一道兜底——重启期间业务中断且耗电较高，所以 60 秒检查 / 5 分钟阈值的参数要按业务容忍度调整；同时业务侧应先把数据落盘，重启后补传，避免丢数据。
  4. 更细的分层建议：先尝试 MQTT 重连 → 不行再退出飞行模式重新注网 → 仍不行再 rtos.reboot()，逐级升级比直接重启温和。

参考：mqtt 库重连 https://docs.openluat.com/osapi/core/mqtt/ ，mobile 库（飞行模式/复位）https://docs.openluat.com/osapi/core/mobile/ 。

24. 780EPM 如何释放 Debug_RXD 串口？之前 780EP 可用，替换后串口 0 无法接收数据

解答： 结论：不能释放。Debug UART 被用来当普通串口做业务会导致死机，这是底层限制；Air780EPM 上另有 3 个普通 UART 可用。

替代方案：

  1. 换用其他普通 UART 接业务串口，把 Debug 串口留给打印/烧录。
  2. UART 数量仍不够时，用其他 IO 口软件模拟串口（软串口），但要评估波特率与 CPU 占用，高波特率下不稳。
  3. 若确实必须在多个串口上做业务，请在选型阶段就按串口数量选型号，不要指望把 Debug 口挪作业务口。
  4. 复用关系与可用串口清单见该型号硬件手册的引脚复用表：https://docs.openluat.com/air780epm/luatos/hardware/ 。

参考：uart 库 https://docs.openluat.com/osapi/core/uart/ 。

25. 合宙量产烧录工具（脱机版）能否放多个固件选择烧录？继续用旧工具是否有风险？

解答： 结论：不能放进多个固件做选择烧录；而且必须升级工具——新版本才支持最新模组，旧版本对新模组的支持不全会直接导致烧录失败。

说明与替代：

  1. 脱机版量产工具的定位是“一台设备灌同一个固件”，多固件切换要靠换配置文件/换 U 盘目录实现，工具本身不提供选择界面。
  2. 不要长期停留在旧版本：新模组（Air8000 系列、Air8781 等）在旧工具上可能识别不到或烧写异常。
  3. 有多固件/多型号批量生产的自动化需求，可基于 luatos-cli 自行开发（https://gitee.com/openLuat/luatos-cli/tree/main ），把工具能力接到自己的产测流程里。
  4. 量产工具与固件版本都要纳入产线版本管理，出厂前用一台样机验证。

参考：工具下载与说明 https://cdn18.luatos.com/files/public/LuatOS_Factory_offline/ ，工具教程 https://docs.openluat.com/common/Luatools/ 。

26. 使用合宙 IoT 后台进行 OTA 操作需要预留白名单，download.openluat.com 对应的 IP 是多少？

解答： 尚未解答

27. 8500/5000 片以下合宙工厂是否提供代烧录服务？费用怎么算？

解答： 结论：提供，任意型号、由客户提供固件即可代烧录，价格按批量分档：

数量（片） 单价
100–499 1 元/片
500–4999 0.5 元/片
一次订单不低于 5000 片 免费烧录

说明：

  1. 100 片起才接单，低于 100 片需要自行烧录。
  2. 需要客户提供固件（脚本/量产文件）与明确的型号、固件版本；固件与型号不匹配无法烧录。
  3. 涉及项目参数（KEY）、设备归属等量产配置的，建议在代烧前把参数模板与归属账号确认清楚，避免出厂后还要逐台改。
  4. 下单与排产请直接联系合宙销售/商务，价格以当期报价为准。

28. 8201G 没有接口只有焊盘，怎么烧录固件？有配套治具吗？

解答： 结论：没有 BTB 接口时可用焊盘飞 USB 直接烧录；量产建议让合宙代烧录或采购专用治具（一拖一治具费用一般 800–1200 元）。

处理方案：

  1. 打样/小批量：从焊盘引出 USB（DP/DM/VBUS/GND）飞线烧录；注意飞线要短、差分线尽量等长，否则容易下载失败。
  2. 量产：走合宙代烧录（100 片起，见代烧录价格档），或采购一拖一/一拖多治具（参考价一拖一 800–1200 元），治具配合量产工具使用可显著提升效率。
  3. 设计建议：新板子预留测试点或 BTB 下载接口，别等投板后才发现只能焊盘飞线；下载调试板可按官方推荐采购。
  4. 资料与管脚说明：https://docs.openluat.com/air8201/ 、https://docs.openluat.com/common/howtodown/ 。

29. 合宙是否有经典蓝牙的模组？

解答： 结论：没有。合宙模组的蓝牙能力以 BLE（低功耗蓝牙） 为主，不做经典蓝牙（BR/EDR）。

说明与建议：

  1. 需要经典蓝牙（如蓝牙音频 A2DP、SPP 传统串口）的场景，建议另选一款经典蓝牙芯片/模块，通过串口与合宙模组配合，不要在 Air724UG 这类型号上折腾——硬件与协议栈都不支持。
  2. 只要做 BLE 连接/透传/配网，用合宙的 BLE 能力即可（ble 库，可能受限的还有从模式/主模式差异）：https://docs.openluat.com/osapi/core/ble/ 。
  3. 选型前先明确是 BLE 还是经典蓝牙，别按“有蓝牙”就选型。

30. Air780EHM 有没有带 GPS 的版本，或有兼容代码和封装且带 GPS 的型号？

解答： 结论：看同封装带定位的型号（如 Air780EGH），并与合宙工程师确认推荐型号后再投板。

对照思路：

  1. Air780Exx 系列里带卫星定位的是 “EG” 开头的型号（如 Air780EGH 在 EHM 基础上增加 GNSS；Air780EGG 还额外内置 G-Sensor）。
  2. 选型时同时核对三件事：封装/引脚是否 pin-to-pin 兼容、是否内置 GNSS、固件与代码是否需要改（同系列应用代码大体通用，但烧录要选对应型号，管脚复用要重新核对）。
  3. 确认路径：把现用型号、需要的封装、成本目标发到官方企业微信群，由合宙确认 pin 兼容的带定位型号。选型指南 https://docs.openluat.com/SelectionGuide/SelectionGuide/ 。
  4. 只是要基站/WiFi 粗定位的话，用 lbsLoc/lbsLoc2 扩展库即可，不一定要换硬件。

31. LuTools 是否支持 1602 的 1026.soc？

解答： 尚未解答

32. Air8000 有线网模组 CH390 是否支持本地配置 IPv6 地址？

解答： 结论：目前不支持本地配置静态 IPv6，需要由路由器/上游分配（即通过 SLAAC/DHCPv6 获取）；后续有计划支持，正在评估开发。

说明与做法：

  1. 当前版本下，要把 CH390 有线网口接入 IPv6 网络，请让路由器开启 IPv6 并下发地址，设备侧按自动获取工作。
  2. 需要“设备固定 IPv6”的架构，现阶段可在路由器侧做地址绑定/静态分配来近似实现，或先用 IPv4 方案落地。
  3. 关注后续固件版本更新与 CH390 相关文档说明，有明确支持后再改为设备侧配置。
  4. 参考：Air8000 有线网相关说明见 https://docs.openluat.com/air8000/luatos/hardware/ 。

33. LuTools 烧录时日志上传定时任务不启动/设备假死，短信回执如何处理？

解答： 结论：同样走“软重启兜底”的修复——新代码每 60 秒检查一次 MQTT，连续 5 分钟未连接就执行 rtos.reboot()；假死期间未提交到网关的数据，重启后直接按失败回执处理，不要重发，避免影响新下发的短信。

处理要点：

  1. 先上软重启兜底：解决“假死后永远不恢复”的问题，参数按业务容忍度调整（60s 检查 / 5min 阈值）。
  2. 回执策略：设备假死期间没来得及上报的结果，重启后直接回失败而不是补发成功/失败状态——因为短信本身可能已经过期或造成重复下发。这样能保证业务状态机不被卡住，新短信能正常处理。
  3. 日志定时任务不启动：先确认软重启兜底生效、任务是否在重启后能正常拉起；若仍不启动，检查任务是否被阻塞（长时间阻塞会让定时器失效），并抓日志定位。
  4. 建议把“任务看门狗”和“链路看门狗”分开：任务层面用 sys.timer/wdt 监控关键任务，链路层面再叠加 MQTT 检查 + 重启。

参考：mqtt 库 https://docs.openluat.com/osapi/core/mqtt/ ，看门狗库 https://docs.openluat.com/osapi/ext/exair153x_wdt/ 。

34. Air724UG 用 780EHV 开发板测试通话听筒杂音大，怎么解决？

解答： 结论：先用最简环境排除干扰——把 PA 拨到 OFF、尽量用 VBAT 供电，再按官方文档一步步来测。

处理步骤：

  1. PA 拨到 OFF：开发板上用耳机/听筒直接听时要把功放关掉，否则会引入失真与底噪。
  2. 供电改用 VBAT：尽量用 VBAT 供电（而不是从 USB 取电），减少电源纹波带来的交流声。
  3. 按文档流程测：核心板通话测试按官方步骤逐项做，不要跳步骤：https://docs.openluat.com/air780ehv/luatos/app/volte/call/ 。
  4. 换线与控音量：杜邦线过长/接触不良会引入干扰，改用短线；音量不要开到最大（削顶会明显失真）。
  5. 换硬件对比：用 8780V 或 Air780EHV 核心板测试听感更好；若换板子仍有杂音，再怀疑网络侧与对方终端，把录音与日志发官方企业微信群分析。

35. 购买 8201/8202 流量还剩多少怎么看，在哪续费？

解答： 结论：直接联系合宙对接人协助查询与续费最省事（例如杨凤珍，扫码添加即可）。

说明与建议：

  1. 扫码/联系对接人，提供设备 IMEI（或批量 IMEI 清单），由其查询剩余流量与到期时间并协助续费。
  2. 批量产品建议把 IMEI 与套餐对应关系做成台账，避免续费时漏掉某批设备导致批量掉线。
  3. 续费到帐有一定延迟，生产/运营安排上预留时间；到期前提前续，避免设备停机影响业务。
  4. 若平台侧有自助查看入口，以平台当前实际页面为准（平台菜单调整较频繁）。

36. 8202 整机的源码是否提供？能否自己改固件、设置电子围栏、发短信通知？

解答： 结论：源码都提供，可以自行修改——包括改固件、设置电子围栏、发短信通知等业务逻辑。

说明与做法：

  1. 拿到源码后在 LuatOS 工程里改业务逻辑：电子围栏属于应用层逻辑（本地把当前位置与围栏中心做距离比较即可）；短信通知用 sms 相关核心库发送（需确认卡支持短信）。
  2. 改完用 Luatools 打包烧录：脚本改动可只下脚本，涉及底层 core 的改动要用同编号差分包走 FOTA。
  3. 注意硬件能力边界：短信功能依赖所插卡片是否开通短信；功耗上“实时围栏 + 短信”会明显高于纯休眠，按业务容忍度定上报周期。
  4. 资料入口：https://docs.openluat.com/air8202/product/ ；核心库文档 https://docs.openluat.com/osapi/ 。

37. Air8601 开发资料如何申请？

解答： 结论：资料在文档站上，可以直接看，需要额外的（原理图/PCB/定制资料）再走申请。

获取路径：

  1. 常规资料：https://docs.openluat.com/air8601/product/ ——产品手册、硬件设计、固件和 demo 都在这里。
  2. 需要原理图/PCB 等受控资料时，通过官方企业微信群或对接的销售提交申请，说明项目背景与用途。
  3. 上手顺序建议：先看产品页确认型号与接口 → 下载固件与 demo 跑通 → 再按自己的需求改。
  4. 与 Air8601 相关的已知硬件注意点（如 4G/WiFi 版本的跳线差异），见对应问答，避免误判成固件问题。

38. 合宙官网文档侧边 tabbar 被折叠、无法滑动，AI 框不见了

解答： 结论：已反馈修复，修复期间可先用 https://ai.luatos.com/ 提问。

临时办法：

  1. 文档站侧边栏折叠/滑不动时，先刷新页面或用无痕窗口重开；把浏览器更新到最新版本（旧版浏览器存在渲染问题）。
  2. AI 框看不到时不影响使用：直接访问 https://ai.luatos.com/ 即可，功能一致。
  3. 仍无法使用的话，把浏览器版本、操作系统版本与问题截图发到官方企业微信群，便于定位是前端兼容性问题还是临时故障。

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

39. 如何把设备注册到自己账号下？FOTA2 demo 修改 key 注册现在不支持 EPM 了吗？

解答： 结论：注册的具体方法请以官方 AI 问答为准——不同型号/固件版本对 PROJECT_KEY（PRODUCT_KEY）注册的支持情况不一样，用 AI 按你的型号与版本查最准确。

操作入口与要点：

  1. 打开 https://ai.luatos.com/ ，右下角 AI 问答，登录后提问（例如“Air780EPM 如何把设备注册到自己的 IoT 项目下”）。
  2. 通用逻辑仍然成立：①设备 IMEI 要先归属到你的账号（否则平台上操作不了）；②设备脚本/工具里填入你项目的 KEY，设备上线后会按 KEY 归属到对应项目。规则见 https://docs.openluat.com/air780epm/product/attributioniot/ 。
  3. 若换 KEY 后设备仍落在旧项目，先核对：KEY 是否写入了本次烧录的固件、设备是否已经重启并重新注网、平台项目是否是你期望的那个。
  4. 改 KEY 涉及量产一致性问题，正式投产前务必用一台样机验证归属结果。

40. Air780E 模组在 B3 频段发射是否非法占用/干扰基站？如何解决？

解答： 结论：先从环境与天线下手排除，再判断是否为设备真的在异常占用 B3 频段。

处理步骤：

  1. 换用 4G 吸盘天线（引出到室外或开阔处），排除环境屏蔽与天线失配导致的反复驻网、大功率重传——重传是造成“干扰”观感的最常见原因。
  2. 确认时间规律：是全天真干扰，还是只在某个时段出现；时段性更像外部干扰源或对方基站调度问题。
  3. 看模组注册情况：查当前驻网频段/小区与信号强度（mobile.scell()、mobile.rsrp()），确认是否真的锁在 B3 并持续发射。
  4. 主动避开 B3：必要时用 mobile.setBand() 锁定其他频段（如 B1/B8）测试，看干扰是否消失；注意锁频会影响其他地区使用，仅作排查手段，不要写入量产固件。
  5. 若确认是干净的合法设备正常驻网，则属于网络侧调度问题，把现象、时间和地点提供给运营商或合宙技术支持协助核查。

参考：mobile 库 https://docs.openluat.com/osapi/core/mobile/ 。

41. Air780EGP 最低工作电压是多少？3.1V 可以吗？

解答： 尚未解答

42. 8783 收到短信能否识别是哪个手机号发来的？能否自定义通知地址/全角转半角？

解答： 结论：①部分卡能识别、部分不能——固件里已加了读取发送方卡号的能力，但很多运营商没有把号码写进 SIM 卡，这种情况下读不到；②可以定制提供支持自定义转发地址的固件；③全角转半角等功能可以评估支持。

逐项说明：

  1. 识别发送方号码：读的是卡内 MSISDN，运营商未写入就为空，与固件无关；先换几张不同运营商的卡验证，能读到说明是卡的问题而不是设备问题。
  2. 自定义通知地址：可以按需提供支持自定义转发地址的固件（如企业微信/自定义 webhook 等），配置指令通过短信下发到 8783；地址与 header 格式要按你方的接口要求写，格式错误会导致不生效。
  3. 全角转半角：属于文本预处理，可作为定制需求评估；建议一并提出其他需要处理的规则（如去空格、编码转换），一次做完更省事。
  4. 定制需求请通过官方企业微信群或对接的销售提交，说明型号、固件版本与具体规则。

43. Air780EHM 用 IIC 接读卡器没读到卡，怎么排查？

解答： 结论：先确认 I2C 地址和总线本身是否正常，再谈读卡逻辑。

排查步骤：

  1. 扫描 I2C 地址：先跑 I2C 扫描，确认总线上能看到读卡器的地址（日志里扫描到 0x0D、0x55 之类），能看到地址说明总线和供电正常。
  2. 核对地址：读卡器（如 RC522/SI522 类）的 7 位地址与库里的地址参数要一致；注意 LuatOS 的 i2c 用 7-bit 地址，别把 8-bit 读/写地址填进去（会错 1 位）。
  3. 硬件三项检查：SDA/SCL 上拉电阻（I2C 必须有上拉，常见 4.7K）、供电（3.3V 是否到位、电流是否够）、复位脚/片选脚是否按读卡器要求拉对。
  4. 引脚复用：确认所选 PIN 在 pins 配置里确实能复用为 I2C，且与其它外设不冲突。
  5. 仍未解决时，带完整的硬件环境照片 + 日志去 https://ai.luatos.com/ 或官方企业微信群，照片能快速排除接线与上拉问题。

参考：i2c 库 https://docs.openluat.com/osapi/core/i2c/ 。

搜索