常见问题 - 2026-09-19

数据日期：2026-09-19

1. AIR8000W 是否支持/做过 VPN？能否用来搭建远程虚拟网络把远端设备模拟成本地局域网设备？

解答： 尚未解答

2. AIR2021 做 AP 时 HTTP 网页打不开是什么原因？

解答： 尚未解答

3. Air8101 视频录制时，H264 编码与 SPI 写 SD 卡冲突（start flush buffer 262144 bytes 后第二次 H264 后丢数据/丢帧、摄像头明暗变化丢帧），能否异步写入、边编码边写入？

解答： 尚未解答

4. Air8101_20260918.luatos 里用的 core 是哪个？

解答： 尚未解答

5. Air8101 支持 RGB666 的 LCD 屏吗？（文档多处不一致）

解答： 结论：目前已调试好的是 RGB565，RGB666 不在已验证范围内。

说明与建议：

选屏时优先按 RGB565 选型，这是当前固件与文档实测确认过的通路，风险最低。
确有 RGB666 需求时，不要仅凭文档描述决定——先把屏幕的接口定义、时序与分辨率提供给合宙确认支持情况，再做适配评估；RGB666 相比 RGB565 数据线多、对刷新率与内存带宽要求更高，4G/WiFi 多媒体型号上容易吃紧。
文档里 RGB565/RGB666 描述不一致的地方已知悉，以实测结论为准；遇到与文档冲突的情况，可在官方企业微信群确认后再投板。

参考文档：Air8101 资料 https://docs.openluat.com/air8101/ ，选型对照 https://docs.openluat.com/SelectionGuide/SelectionGuide/ 。

6. Air8101 新版本 Luatools 不能下载 8101，怎么办？

解答： 尚未解答

7. 合宙有没有提供 MQTT 测试服务器平台，可以看到收发数据？

解答： 结论：有。登录合宙 IoT 平台 iot.luatos.com 就能看到设备的 MQTT 上报数据与相关记录，不需要自己搭服务器。

使用要点：

打开 https://iot.luatos.com/ ，用手机号登录（忘记密码可重置）。
设备必须先归属到你自己的账号项目下，否则平台上看不到这台设备；归属方法见 https://docs.openluat.com/air780epm/product/attributioniot/ 。
设备侧用官方 mqtt demo 连上平台后，在平台的设备详情/上报记录里即可看到上行数据。
如果只是想验证 TCP/socket 收发而不涉及 MQTT，可用合宙的联调测试服务器 https://netlab.luatos.com/ 做对照，判断是模组侧还是服务器侧的问题。

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

8. MQTT 程序刷进去后没有数据上传是什么原因？

解答： 结论：先刷 iRTU 固件做一次对照——iRTU 是官方现成的 DTU 固件，能立刻把“模组/网络/卡的问题”和“自己脚本的问题”分开。

排查步骤：

用 Luatools 刷 iRTU 固件，在平台上配置好连接参数，设备上电后在 iot.luatos.com 看有没有报文上来。
有报文：说明卡、网络、平台链路都正常，问题在你的 MQTT 脚本里。改用官方 mqtt demo 在同一块板上跑一遍做对照，再逐步把你的业务逻辑加回去（https://docs.openluat.com/osapi/core/mqtt/ ）。
没有报文：按网络侧顺序排查——①是否注网并拿到 IP（日志里出现 IP_READY）；②SIM 卡是否欠费/是否需要专用 APN；③定向流量卡是否把服务器域名加入白名单；④设备是否已归属到当前账号项目下。
抓一份 Luatools 完整日志（含 IP_READY 与 MQTT 事件回调），能直接看出卡在哪一步。

参考文档：iRTU 说明 https://docs.openluat.com/value/irtu/web/ ，烧录排查 https://docs.openluat.com/common/howtodown/ 。

9. 开发板设备看不到/需要和手机号绑定，在“我的设备”菜单看不到自己设备怎么办？

解答： 结论：设备还没归属到你的账号。平台默认按采购/发货渠道把设备挂在原账号名下，没做归属转移之前，“我的设备”里自然看不到。

处理步骤：

按购买渠道处理：淘宝/官方电商购买的，按店铺说明联系客服，提供 IMEI 与目标账号完成归属；也可在 crm.luatos.com 用下单手机号自助设置归属（初始密码 88888888，限 2025 年 10 月后的订单）。
线下/批量采购：由对接销售把 IMEI 清单归属到你提供的 IoT 账号项目下。
第三方渠道购买：联系卖家，由其从原账号移除后你才能添加，合宙无权限跨账号强制转移。
归属后验证：设备上电联网后，在 https://iot.openluat.com/ “我的设备”里按 IMEI 查询，能看到即成功；此时再创建项目、配置升级或 MQTT 参数。
未归属设备还有个副作用：平台不会给它下发项目参数与升级任务。

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

10. 短信转发怎么识别插的卡的手机号？

解答： 尚未解答

11. 有没有不用插卡、支持 GPS 的物联网模块？用于防丢器/定位信息回传，体积受限。

解答： 结论：卫星定位本身不需要插卡（GNSS 只接收卫星信号），但“把定位信息回传”必须有联网通道，所以“不插卡 + 能回传”只能靠出厂预置流量的整机方案。

可选方案：

Air8202 / Air8202C（推荐先看）：整机/免开发形态，自带 GNSS 与预置流量（贴片卡形态，用户无需插卡），接电池即可上报位置，可在官方位置服务里看轨迹。型号/是否带外壳、流量套餐以产品页与实际报价为准：https://docs.openluat.com/air8202/product/ 。
Air510W / Air530W：纯 GNSS 模组，只输出 NMEA 数据，不具备联网回传能力，需要主控或另一颗通信模组来转发（体积上不一定划算）。
体积评估：防丢器类产品对厚度敏感，8202 的体积可能偏大，建议先拿到实物尺寸与天线净空要求再定方案；若空间实在不够，可考虑 Air8201 系列自己画板 + 外挂 GNSS 天线。
选型前明确三件事：要不要语音、上报周期多长、电池容量与续航目标。选型指南 https://docs.openluat.com/SelectionGuide/SelectionGuide/ 。

12. Air8202 原理图公开吗？想加 Type-C 锂电池充电。

解答： 结论：可先看官方产品页发布的资料（https://docs.openluat.com/air8202/product/ ）；具体开放到原理图还是同时含 PCB，以页面实际发布的文件为准，改硬件前建议先与合宙确认资料范围与是否允许改制。

说明与建议：

Air8202 属于整机/免开发方案，本身就是按“接电池即用”设计的，已带电池与充电管理；先确认你想加的 Type-C 是“只想换个接口形态”还是“要改充电电路”。
只是想把充电口改成 Type-C：属于结构/接口改动，需要拿到对应的原理图与 PCB 文件，最好由合宙或原厂配合评估，避免破坏原有充电链路（充电 IC 配置、限流、电池保护）。
如果只是要一个 Type-C 供电/充电的定位终端，也可以评估其他带 Type-C 的开发板 + 模组方案，改自己的板比改整机更可控。
资料与定制入口：产品页 https://docs.openluat.com/air8202/product/ ，或通过官方企业微信群对接商务/技术。

13. 合宙 iRTU 支持连接阿里云吗？

解答： 尚未解答

14. DTU 平台 https://dtu.openluat.com/login 找回密码点击获取验证码报错。

解答： 尚未解答

15. http://wiki.luatos.com/ 网址打不开了吗？

解答： 结论：wiki 早就废弃了，打不开是正常的，不要再使用这条链接。

改用：

文档站：https://docs.openluat.com/ ——按型号组织的产品手册、硬件设计、固件与 demo、应用教程都在这里，是唯一权威来源。
API 文档：https://docs.openluat.com/osapi/ ——核心库与扩展库接口。
AI 问答：https://ai.luatos.com/ ——文档里查不到的具体问题直接问。
源码与 demo：https://gitee.com/openLuat/LuatOS 。

建议把浏览器里收藏的旧 wiki 链接替换成文档站，避免下次又点到过期页面（旧 wiki 内容不全且不再更新）。

16. 喂狗（看门狗）完成会造成 SIP 心跳发送不出去、导致重启，是什么原因？

解答： 结论：已确认是前段时间改动过看门狗逻辑引入的问题，换用新版本的库即可解决——把新的 exair153x_wdt.lua 替换到 luatools\resource\soc_script\v2026.09.17.15\lib 路径下就不会再出现。

处理步骤：

确认当前工程里 exair153x_wdt 的版本（来自哪个 lib 包）。
取官方仓库里最新的 exair153x_wdt.lua。
两种放置方式任选：①直接放进你的项目目录（与 main.lua 同目录）随项目打包；②放到 Luatools 本地目录 luatools\resource\soc_script\v2026.09.17.15\lib 下，替换默认文件（对全部项目生效）。
重新打包烧录，复测 SIP 通话与心跳：确认长时间通话/空闲时不再出现心跳发不出导致重启。

背景：旧逻辑里喂狗与业务存在时序冲突，喂狗动作会影响到 SIP 心跳的发送时机，新版已修掉。库说明见 https://docs.openluat.com/osapi/ext/exair153x_wdt/ 。

17. 153x 的 lib 是否包含在 Luatools 下载的 lib 里？会和烧录时勾选的默认 lib 冲突吗？

解答： 结论：不会冲突，而且两种放法都可行，按你的使用场景选：

放进项目目录（推荐）：像 main.lua 那样把 exair153x_wdt.lua 直接添加到资源区/脚本列表，随项目一起打包。好处是版本跟项目走，Luatools 更新默认 lib 时不会把你的改动覆盖掉。
替换 Luatools 本地默认 lib：放到 luatools\resource\soc_script\v2026.09.17.15\lib 下替换默认的 exair153x_wdt.lua。好处是“一次替换、所有项目生效”；副作用是会影响所有引用默认 lib 的工程，且下次工具更新资源时可能被重新覆盖，需要留意版本。
冲突的实质是“同名文件谁优先”。同一份工程里不要同时存在两份不同版本的 exair153x_wdt.lua，避免打包到不是你想用的那一版。
升级 lib 后建议复测看门狗喂狗与低功耗行为，确认功能正常。

参考文档：https://docs.openluat.com/osapi/ext/exair153x_wdt/ 。

18. MCP 失败有没有关系？

解答： 结论：基本没关系，这类失败多为网络抖动或服务端临时波动，多试两次通常就恢复。

说明与排查：

MCP（模型上下文协议）是给 AI 助手挂载外部工具/数据源用的，偶发失败不影响设备与固件本身，重试即可。
仍持续失败时，按官方说明核对配置（服务地址、鉴权、客户端版本）：https://docs.openluat.com/ai/mcp_cli/ 。
若同一环境下反复失败，记录失败时间点、报错信息与所用客户端版本，通过官方企业微信群反馈，便于定位是客户端还是服务端问题。

19. 主板 A 的 TTL 接合宙 4G 模组 TTL，个别情况主板 A 高耗电，是什么问题？

解答： 尚未解答

20. 屏的壳子用什么材料做的？

解答： 结论：目前还是 3D 打印件，强度一般，适合打样验证，不适合当量产外壳。

说明与建议：

3D 打印（多为光敏树脂/PLA）在螺柱强度、耐温、耐摔和外观一致性上都不满足量产要求，客户反馈“不怎么结实”是符合预期的。
量产出外壳需要开模（注塑或钣金），要按结构设计 → 手板 → 模具 → 试模的流程走，成本和周期都要提前排。
想拿量产壳/整机方案，联系合宙商务评估；打样阶段用 3D 打印先验证结构与开孔（屏幕、喇叭、Type-C、天线净空）是最省钱的顺序。

21. 蓝牙锁异常（产线生产出现、未使用过）如何处理？

解答： 尚未解答

22. Air1602_v1.2 开发板的固件都有吗？可以直接测试吗？

解答： 尚未解答

23. 方案必须用 4 个模组合在一起应用吗？

解答： 结论：不是必须 4 个。按功能需求组合，够用就行；用 Air1602_v1.2 开发板即可完成测试。

两种常见组合：

3 模组：Air8101 + Air780ER2 + Air510W——WiFi/多媒体主控 + 4G 上网 + GNSS 定位，没有蓝牙/WiFi AP 需求时这样最省。
4 模组：Air1602 + Air780ER2 + Air510W + Air6205——在主控、4G、GNSS 之外再加 WiFi/蓝牙能力（6205）。

选型建议：

先明确三件事：要不要 WiFi/蓝牙（决定是否加 6205）、要不要 4G（决定是否加 780ER2）、要不要卫星定位（决定是否加 510W），再定模组数量。
模组之间通过 AirLink / 串口协同，链路越多对引脚与软件调度要求越高，能省则省。
测试直接在 Air1602_v1.2 开发板上搭起来验证，确认方案可行后再做自己的板。

参考文档：多网与 AirLink 说明 https://docs.openluat.com/air8101/luatos/app/network_routing/ ，Air1601/Air1602 资料 https://docs.openluat.com/air1601/ 。

24. 电池座子是什么型号？哪里买？

解答： 尚未解答

25. 提货的软件版本要用 V3011，FOTA 升级如何操作？

解答： 结论：流程就是常规的 上传升级包到云平台 → 创建升级任务 → 设备联网后拉取升级 → 验证；这批设备已按此流程升级成功（从当前版本升到 V3011）。

操作步骤：

确认版本对应关系：目标版本 V3011 必须是三段式 x.y.z 且大于设备当前版本；含 core 的升级必须用与设备现网固件同编号制作的差分包，脚本升级用全量包，两者不能混用。
上传升级包：登录 https://iot.openluat.com/ ，在项目的固件升级/升级任务里上传 V3011 的升级包。
配置升级范围：把目标设备的 IMEI 加入升级名单（非全项目升级时务必加，否则不会下发）；同时确认设备已归属在当前账号项目下，否则平台不会给它下发任务。
设备侧：设备联网后按策略去查询升级（FOTA 不是推送，重启后或最长 24 小时内检测到），下载 → 校验 → 重启完成切换。FOTA 有频率限制，同一设备 20 分钟内只允许请求一次，调试时不要反复重启催。
验证：升级后确认版本号已是 V3011，并回归核心业务功能；失败时按回调码定位（1 连接失败 / 2 url 错误 / 3 服务器断开 / 4 报文错误 / 5 版本号格式错误），并检查定向流量卡是否把 iot.openluat.com 加入了白名单。

参考文档：FOTA 教程 https://docs.openluat.com/air780epm/luatos/app/ota/fota3rd/ ，libfota2 与回调码 https://docs.openluat.com/osapi/ext/libfota2/ 。