常见问题 - 2026-11-07

数据日期：2026-11-07

1. 云平台设备号被删除后无法重新添加，怎么处理？

解答： 尚未解答

2. RNDIS模式下能否使用低功耗模式？

解答： 结论：不能。RNDIS 依赖 USB，USB 一打开就没有低功耗，模组进不了睡眠，更进不了 PSM+。说明：RNDIS 的实质是把模组当网卡给主机用，USB 控制器、时钟和 4G 数据通路必须一直开着，功耗在几十 mA 量级；常规「保持连接」模式约 1.5~2mA，PSM+ 深睡能到 3~12µA 但期间不能联网，三种状态是互斥的。处理步骤：① 需要长待机的项目不要用 RNDIS，改用 4G 数据链路（socket/mqtt）加定时唤醒上报；② 只在调试、回捞日志时临时开 RNDIS，用完 pm.power(pm.USB, false) 关掉再进低功耗；③ 既要长期在线又要省电，就按「保持连接」与「PSM+ 周期唤醒」两档二选一，不要期待 USB 网卡和低功耗共存。参考文档：https://docs.openluat.com/air780egh/luatos/app/common/rndis/

3. RNDIS必须飞行模式下开启会导致断网，能否避免？

解答： 尚未解答

4. RNDIS模式下还能运行自己的脚本吗？

解答： 尚未解答

5. 8301支持PLCUI吗？

解答： 结论：计划支持，但当前还不能直接用——要先打通 Air1603 的显示能力，PC 模拟器也还在优化。说明：PLCUI 依赖 1603 的屏与触摸基础能力，所以排期在 1603 之后；官方答复的节奏是「下下周左右」，属于研发排期，最终以正式发布为准，不宜当作交期承诺。处理步骤：① 现在就要在大屏上做界面，先用 AirUI（airui 库）搭配 1603/8603/8607 这套已支持的组合；② 跟踪 Air8301 的固件与文档更新，PLCUI 正式可用后再迁移；③ 项目排期紧的话，让商务或 FAE 出一份书面排期再定方案。参考文档：https://docs.openluat.com/air8301/product/

6. 8607W固件播放MP4卡顿导致触摸延迟、WiFi扫描热点数量少怎么办？

解答： 结论：这两类现象要软硬件一起查。先刷官方指定固件做对比，WiFi 的射频问题需要原厂用仪器调。说明：8607 系列是 Air1603 大屏方案，音视频走软件解码，MP4 码率高、分辨率大时 CPU 会被占满，触摸和界面刷新自然被拖慢；8607W 再叠一层 WiFi（W800 方案），CPU 与总线争用更明显。扫到的热点数量少，多半是天线匹配、馈线净空或射频默认参数的问题，属硬件加原厂参数范畴，改代码解决不了。处理步骤：① 按官方给的方式刷指定 SOC 固件复测，先排除固件版本因素；② 换低码率、低分辨率素材对比，看卡顿是否随码率线性变化，是则降规格或改 MJPG；③ 播放时把 WiFi 关掉再测一遍，确认是不是 WiFi 共存导致；④ WiFi 灵敏度问题寄板给原厂做匹配与射频参数核对。参考文档：https://docs.openluat.com/air8607/product/

7. 860x系列板子在官网没有各接口接线图/线序说明？

解答： 结论：已经在补。8603、8605 各型号的接口说明已重新整理，外壳视角的接线与标签纸说明还在补。说明：860x 同一块板按型号（W1~W5、M1~M5）配不同串口电气，同名端子在隔离 485、非隔离 485、TTL 之间切换，只按连接器针数看很容易接错，所以文档改成了「按型号列接口 + 端子定义表」的形式，先确认型号再对端子。处理步骤：① 打开 Air8603 全接口功能说明，先在型号表里找到自己手上的型号；② 屏按 P1（40PIN）与 J2（50PIN）核对，两者共用显示信号，不是两路独立输出；③ 供电分清 J1（12V 主电源输入）与 J18/J17/J19（12V/5V/9V 对外供电）。参考文档：https://docs.openluat.com/air8603/Air8603_%E5%85%A8%E6%8E%A5%E5%8F%A3%E5%8A%9F%E8%83%BD%E8%AF%B4%E6%98%8E/

8. 8605支持SIP通话的代码有了吗？

解答： 尚未解答

9. 1601如何接入USB HID设备？

解答： 结论：1601 支持 USB HOST，可以接键鼠这类 HID 设备；验证阶段建议先用 Air8603 板子，它把 USB HOST 引到了 J8 和 J14。说明：USB HOST 不只要 D+/D-，还要给外设供 VBUS，核心板常常只引出信号、没引供电，直接插外设会枚举失败。8603 的 J8（Type-A）与 J14（5PIN 线束）共用同一组 USB 信号，不能当两个独立主机口用。处理步骤：① 硬件上确认 VBUS 由板子提供（8603 为 +5.5V，受 UVC_EN 控制），外设功耗大时外部补电；② 软件侧先烧官方 demo 验证枚举，确认所用固件版本确实带 USB HOST 支持，再写业务；③ 接 UVC 摄像头时注意它和 HID 抢同一个 HOST 口，人脸摄像头还要占 UART2。参考文档：https://docs.openluat.com/air8603/Air8603_%E5%85%A8%E6%8E%A5%E5%8F%A3%E5%8A%9F%E8%83%BD%E8%AF%B4%E6%98%8E/

10. 8603是否支持对外输出12V/5V电源？屏幕选择有什么要求（如分辨率）？

解答： 结论：支持对外输出 12V/5V。12V 走 J18、5V 走 J17、9V 走 J19（J19 受 9V_EN 控制）。屏幕要选 RGB 接口的屏。说明：J18 的 12V 是「主电源有效时常开」的对外供电，与 J1 的 12V 主电源输入是两回事；J17 的 5V 与屏幕/音频那条受 5V_EN 控制的支路也不是同一路。隔离 485 端子的 VISO 只能选 3.3V 或 5V。显示方面 1603 是 RGB565 接口，最大 1280×800、典型 1024×600，官方配套是 9 寸 1024×600 的 AirLCD_1090。处理步骤：① 按外设额定电压选 J18/J17/J19，9V 需要软件拉高 9V_EN 才有输出；② 屏线按 40PIN（P1）或 50PIN（J2）匹配，触摸单独走 TP2 的 I2C；③ RGB888 屏只能按兼容模式接高 16 位，不要按 24 位全彩设计。参考文档：https://docs.openluat.com/air8603/Air8603_%E5%85%A8%E6%8E%A5%E5%8F%A3%E5%8A%9F%E8%83%BD%E8%AF%B4%E6%98%8E/

11. 两个485能否做成Modbus协议主站读取从站设备并轮询？

解答： 尚未解答

12. 8783H要刷自己的程序应该用哪个底层核心？板子上是780EH2，下载列表没有该型号。

解答： 尚未解答

13. 有没有支持屏幕、TTS、TTL和DO的板子？

解答： 结论：现成整板里 Air8301 最接近，但它没有独立 TTL 口，也没有喇叭接口。说明：Air8301 基于 Air8000W，板载 4.3 寸触摸屏、2 路 RS232、2 路 RS485、2 路以太网、2 路 DI/DO，串口资源被 232/485 占满，TTL 只能从收发器前级自己引；产品页的接口表里也没有音频/喇叭输出项，要播报得自己外接功放。处理步骤：① 只要屏 + TTS + 喇叭：选 Air8607（1603 大屏方案，4Ω/3W 喇叭、SD 卡），但它不带 4G/网络；② 要 4G + DO + 屏：选 8301，音频自行加功放并核对引脚；③ 缺 TTL 就用 Air8603 的 J7（UART2 TTL）补一路。参考文档：https://docs.openluat.com/air8301/product/ 和 https://docs.openluat.com/air8607/product/

14. 8607板子读不了卡、播放不了音乐怎么办？

解答： 结论：先刷官方指定 SOC 固件复测，刷了能读卡能出声就是固件问题；刷完还是不行就按硬件排查，必要时走售后换板。说明：8607 是「1603 + 屏 + 触摸 + 喇叭 + Micro-SD」的最小系统板，出厂固件是板级工程（V1028_Air1603_102），不是通用固件；喇叭要出声还依赖 AUDIOPA_EN（GPIO73）在起播时被拉高，这条没动作就只是「读卡正常但没声音」。处理步骤：① 用 Luatools 烧官方出厂固件，看串口日志里 SD 卡挂载与音频加载那几行；② SD 卡用 FAT32、容量不要过大，重插排线确认卡座接触；③ 无声先量 AUDIOPA_EN 电平和喇叭阻抗；④ 仍读不到卡，按售后流程换板。参考文档：https://docs.openluat.com/air8607/software/default_factory_firmware/

15. 8603屏幕闪一下黑屏、几分钟自动重启是什么原因？

解答： 结论：多数是供电能力不足。改用 12V 主电源接 J1，不要用 USB 口给整机供电。说明：8603 是整板方案，屏背光加 4G 发射瞬间的峰值电流很大，USB2/USB3 那两路供电只是给调试用的，带不动整机；适配器功率不够或线材压降大，表现就是开机闪屏、跑几分钟重启。处理步骤：① 用配套 12V 适配器接 J1，按整机峰值电流留足余量；② 确认屏幕/音频那条 5V 支路的 5V_EN 已打开；③ 用示波器看 12V/VBAT 在 4G 发射瞬间有没有几百 mV 级跌落，有明显跌落就是供电问题；④ 换粗短线、去掉劣质 USB 线和 HUB。参考文档：https://docs.openluat.com/air8603/Air8603_%E5%85%A8%E6%8E%A5%E5%8F%A3%E5%8A%9F%E8%83%BD%E8%AF%B4%E6%98%8E/

16. 8607B带网口的版本出来了吗？

解答： 结论：还没有。官方答复是近期（下周末到下下周初）推出，具体以正式发布为准。说明：8607 系列本身不带网络（1603 是主控，没有 4G/WiFi），带网口的版本要在板级加以太网接口，属于新板型，不是刷个固件就能变出来的。处理步骤：① 现在就要网口，用 Air8301（双以太网 + 4G）或 Air8603M 外接 CH390H 做网口；② 想等 8607B，关注官网产品页与公告，不要按口头时间排产；③ 选型先确认现场是「只要网口」还是「网口 + 4G 都要」，两者方案不同。参考文档：https://docs.openluat.com/air8607/product/

17. 人脸特征数据能否上传自建后台再下发到其他设备，实现一次采集多台设备识别？

解答： 结论：不支持。人脸特征既不能读出也不能写入，只能在设备上离线现场录入。说明：人脸比对在人脸摄像头模组内部完成，特征库存在模组里，主控（1601/1603）通过 USB HOST 加 UART2 拿到的是识别结果，没有导出/导入特征的接口，所以做不到「一次采集、多台共享」。处理步骤：① 每台设备现场录入，或用模组厂商的配套工具批量录入；② 业务侧只用人脸 ID 做关联，把人员名单放后台，设备端负责比对与上报；③ 一定要集中式人脸库，就得换带网络侧比对的方案，不是改脚本能实现的。参考文档：https://docs.openluat.com/air1603/

18. 8603双目摄像头没有电、初始化不成功怎么办？

解答： 结论：先按线序把线接全（USB 和串口都要接），再单独给 VBAT 供 5V 复测。说明：8603 的人脸/双目摄像头同时占 USB HOST（J8 或 J14）和 UART2（J7 的 TTL）两路，只接 USB 不接串口时初始化必然失败；USB 口的 +5.5V 由 UVC_EN 控制，摄像头功耗大时板上供电还不够。处理步骤：① 按原理图核对 J8/J14 的 DN/DP/GND 与 J7 的 TX2/RX2/GND，线序不能反；② 确认 UVC_EN 已使能、摄像头 5V 有电；③ 用外部 5V 直供 VBAT 复测，排除供电不足；④ 串口波特率与摄像头模组默认值保持一致。参考文档：https://docs.openluat.com/air8603/Air8603_%E5%85%A8%E6%8E%A5%E5%8F%A3%E5%8A%9F%E8%83%BD%E8%AF%B4%E6%98%8E/

19. 8607是否支持1920*1080P MIPI屏幕？

解答： 结论：1603 原生是 RGB565 接口，官方口径最大 1280×800；1080P 的 MIPI 屏要经转换芯片转成双线 LVDS/RGB 才能接，还在研发验证阶段。说明：分辨率对得上不代表接口能直连。MIPI、LVDS 屏不能凭针数或分辨率直接插到 RGB 排线上，中间要加桥接芯片做协议转换，还要额外供电与时钟，帧率和稳定性都得实测。处理步骤：① 优先按 1280×800 以内的 RGB565 屏选型，官方 10 寸 1024×600 已有量产验证；② 一定要 1080P，找带 MIPI→LVDS/RGB 桥接的整板方案，让 FAE 确认固件时序支持；③ 桥接方案单独评估带宽与内存，别只看能不能点亮。参考文档：https://docs.openluat.com/air1603/

20. 刷固件后出现黑屏怎么办？

解答： 结论：官方已更新代码，拉最新代码重新编译烧录即可。说明：黑屏一般是固件里的显示初始化（屏参、时序、背光使能）与新板型或新屏不匹配，属固件侧问题，屏本身通常没坏。处理步骤：① 拉最新代码重新编译烧录，再上电观察；② 确认烧的是对应板型、对应屏参的固件（例如 8607 用 V1028_Air1603_102 板级工程）；③ 看串口日志里 LCD 初始化与背光使能那几行，定位卡在哪一步；④ 想快速区分软硬件，先烧一版确认能正常显示的固件。参考文档：https://docs.openluat.com/air8607/software/

21. 485接口在程序上如何调用，有没有参考代码？

解答： 结论：硬件上 485 直接接 A、B 两根线；程序侧走 Modbus 用 exmodbus 扩展库，普通串口收发用 uart 库。说明：485 只是物理层，收发器把 TTL 转成差分信号，软件看到的仍然是串口；板载收发器会自动做方向控制（隔离型号也一样），不需要自己拉 DE/RE。处理步骤：① 先确认自己型号的 485 端子（8603 为 J20 非隔离、J21/J22 隔离），A/B 不要接反；② 用 uart 库按 9600/8N1 打开对应串口，先自发自收验证通路；③ 走 Modbus 就引 exmodbus，按从站地址与功能码组帧；④ 长总线加 120Ω 终端电阻，并把地共好。参考文档：https://docs.openluat.com/osapi/ext/exmodbus/

22. irtu项目设置参数页面点击无反应怎么办？

解答： 结论：先强刷浏览器缓存或换 Edge，再确认是不是老项目版本不兼容——老项目需要重建。说明：iRTU 的配置页是前端页面加后台配置，浏览器缓存了旧版 JS 时按钮就会点了没反应；后台升级后，老项目的配置结构也可能对不上。处理步骤：① Ctrl+F5 强刷，或开无痕窗口、换 Edge 试；② 新建一个项目对照，新建正常就说明是老项目数据的问题，按提示重建；③ 改完参数记得重启设备，iRTU 是开机时同步一次配置，不重启不生效；④ 仍不行就把浏览器控制台的报错信息发给 FAE。参考文档：https://docs.openluat.com/value/irtu/docs/

23. 780连不上网，重新刷固件时识别不到端口怎么办？

解答： 结论：先换一根短的、能传数据的 USB 线。多数「识别不到端口」是线材或接触问题。说明：不少 USB 线只有充电线芯、没有 D+/D-，或者线太长压降大，表现就是电脑识别不到串口、下载到一半失败；模组很少因为「连不上网」这一件事就坏掉。处理步骤：① 换 1m 以内的数据线，直插主机后面板 USB 口，不要经 HUB；② 在设备管理器里看有没有新串口出现，没有就换口、换电脑再试；③ 仍识别不到，用 BOOT 方式进入下载模式（按住 BOOT 再复位或上电）；④ 端口正常但连不上网，再查 SIM 卡、APN、天线与信号强度。参考文档：https://docs.openluat.com/common/howtodown/

24. 780出厂脚本是什么？只刷了4G专用固件。

解答： 尚未解答

25. 1603和780之间的airlink协议如何转发数据？

解答： 结论：不用自己拼帧。1603 上照常调核心库和扩展库，底层会自动走 airlink 把请求转给 780，读 780 上的数据或控制 780 的动作。说明：AirLink 是合宙主控与通信模组之间的协议，1603（主控）侧看到的是标准 LuatOS API，实际执行落在 780 上。相比 AT 指令，它封装更薄、效率更高，也更省引脚。处理步骤：① 硬件按方案把 1603 与 780 之间的 airlink 通道（UART 或 SPI）接好；② 1603 侧直接写业务代码，比如 socket、mqtt 这些库调用；③ 需要 780 侧自定义动作，就在 780 的脚本里注册对应处理函数；④ 调试时两边都开日志，先确认握手成功，再查业务数据。参考文档：https://docs.openluat.com/protocols/airlink/

26. AIR8000W支持RTC时钟吗？断网时能否保持计时？

解答： 结论：支持 RTC，断网时靠模组内部 RTC 继续走时；但没有单独引出的 RTC 备电接口，整机断电后时间会丢。说明：内部 RTC 是普通晶振计时，受温度与电压波动影响会漂移，断电或深睡断电后回到出厂时间。所以「断网」不影响走时，「断电」才会。处理步骤：① 每次联网成功后调 socket.sntp() 同步，收到 NTP_UPDATE 即表示成功；② 低功耗唤醒后再同步一次，抵消睡眠期间的漂移；③ 需要断电保时，外挂带纽扣电池的 RTC 芯片（I2C 接口）。④ 读时间统一用 os.date()，NTP 成功后不必再 rtc.get。参考文档：https://docs.openluat.com/common/time_sync/

27. 卫星定位坐标整体偏移约3米，有没有轨迹纠偏算法或误差解决方法？

解答： 结论：3 米属于 GNSS 的正常误差范围（民用单点定位通常 2~5 米），不需要「纠偏算法」；真正需要处理的是坐标系转换。说明：模组输出的是 WGS-84 原始经纬度。如果在地图上显示偏几百米，那是地图坐标系的问题——百度用 BD-09、高德/腾讯用 GCJ-02，不转换必然偏；而 3 米这种随机误差没法用算法消掉，只能靠多星、差分或滤波平滑。处理步骤：① 先判断量级：几百米是坐标系问题，几米是精度问题；② 上地图前把 WGS-84 转成目标地图的坐标系，合宙有现成的纠偏工具；③ 轨迹抖动用滑动平均或卡尔曼滤波平滑，或按速度阈值丢点；④ 要更高精度上 RTK/差分方案。参考文档：https://docs.openluat.com/common/tools/gps/ 和 https://docs.openluat.com/file/GPS-Offset.html 和 https://docs.openluat.com/osapi/core/libgnss/

28. 780EGG有没有封装，和780EGP管脚是否完全一致？

解答： 结论：有封装资料，EGG 与 EGP 的引脚定义一致，可以直接替换。说明：Air780EGG、Air780EGP、Air780EGH 属同一系列，官方在 780egh 的资料页提供了三者的参考封装（PADS/AD/LCEDA），封装尺寸也列在同一张表里。EGG 与 EGP 的差别在频段与认证方向，管脚没有变。处理步骤：① 从产品资料页下载对应封装（Air780EGP_参考封装、Air780EGG_参考封装）；② 画板前用原理图 PDF 复核管脚，不要只信封装库；③ 两个型号混用时注意固件要按实际型号选，不要互刷。参考文档：https://docs.openluat.com/air780egh/product/shouce/

29. DTU-F402与云服务器连接中断，本地串口测试指令无响应，是什么问题？

解答： 尚未解答

30. 模组死机，换了电源也一样，怎么回事？

解答： 结论：先用合宙官方 demo 复现，把「模组本身的问题」和「脚本、底板的问题」分开。说明：死机类问题里相当一部分是脚本死循环或内存耗尽、看门狗没喂、底板供电与复位电路的问题；换了电源还是一样，说明原因可能不在电源。处理步骤：① 烧官方 demo（比如 socket 长连接）跑同样时长，demo 也死机才怀疑模组；② 打开 errDump 抓异常日志，看有没有内存不足、硬件异常记录；③ 检查脚本里有没有 for 忙等不让出 CPU、日志刷太多；④ 量 VBAT 纹波与复位脚电平，排除底板干扰。参考文档：https://docs.openluat.com/osapi/core/errDump/

31. 4G设备报警是通过4G卡发还是云平台发？

解答： 结论：4G 卡只负责联网通道。报警走短信、语音还是平台消息，由设备端脚本决定。说明：同一张卡既能发短信（sms 库），也能通过 TCP/MQTT/HTTP 把数据送到平台（socket、mqtt 库）；云平台推送的路子是设备先上报平台，再由平台转发给 App 或短信网关。两条路不互斥，可以同时用。处理步骤：① 要求「必达、不依赖平台」就走短信或语音呼叫；② 要求「带数据、可追溯」就走 MQTT/HTTP 上报平台再推送；③ 重要报警建议双通道（短信 + 平台）并对上报做重试与本地缓存。参考文档：https://docs.openluat.com/osapi/core/sms/

32. 4G卡通过485与LoRa相连再读其他LoRa数据，统一由4G上传，这样可行吗？

解答： 结论：逻辑上可行，但没必要中间经 485 转一手，4G 模组可以直接接 LoRa。说明：485 只是一段总线，用来在 4G 模组与 LoRa 网关之间传数据，等于多加一层收发器和协议转换。如果 LoRa 网关对外给的是 TTL 串口，直接接模组 UART 更简单；用 SPI 接 SX126x 类 LoRa 模组还能用 lora2 库直驱。处理步骤：① 先确认 LoRa 网关的对外接口（TTL 串口、485 还是 SPI）；② 能直连就直连，省掉 485 收发器与方向控制；③ 必须走 485 时，把波特率、帧格式、超时对齐；④ 多节点轮询在 4G 侧脚本里做队列，避免同时收导致丢包。参考文档：https://docs.openluat.com/osapi/core/lora2/

33. 合宙AI接入的大模型是哪个？

解答： 尚未解答

34. 没有屏幕只有核心板，可以模拟看显示效果吗？

解答： 尚未解答

35. 有网口/RJ45的是哪个型号？

解答： 尚未解答

36. 配套流量卡是否有机卡绑定？换模组后提示被拒绝怎么办？

解答： 结论：部分物联网卡有「机卡绑定」，换设备后会拒绝入网，需要找购卡渠道解绑或换卡。说明：机卡绑定是运营商侧把卡与 IMEI 绑在一起，换了模组 IMEI 变了就会被判异常。这种限制在模组侧、APN 侧都没有开关可以绕过。处理步骤：① 先读出当前设备的 IMEI 提供给渠道客服；② 请渠道做解绑或重新绑定；③ 长期多设备项目在采购时直接写明「不绑定机卡」，避免后期批量返工。参考文档：https://docs.openluat.com/air780epm/

37. 已经锁定的流量卡怎么解开？

解答： 结论：只能联系购卡渠道（淘宝客服等）处理，模组侧解不开。说明：锁定是运营商或渠道在卡侧做的状态，设备端没有自助解锁的手段；自己反复换设备尝试，还可能触发更严格的风控限制。处理步骤：① 把卡号（ICCID）与设备 IMEI 一起提供给原购买渠道；② 说明是换机还是异常停机，按渠道要求提供凭证；③ 实在解不开就换卡，新卡上机后重新配置 APN 再测一遍。参考文档：https://docs.openluat.com/air780epm/