常见问题 - 2026-10-24

数据日期：2026-10-24

1. Air8607/Air8601串口下载一直超时或无日志，怎么解决？

解答： 结论：先分清是 8601 还是 8607——8601 板上 Air1601 与 Air6205 共用一路 Type-C 串口，要靠拨码开关切换，波特率也不一样（1601 用 6M、6205 用 2M）；8607 只有一颗 1603，直接按 6M。说明：这两块的「Type-C 下载口」本质都是板载 USB 转串口芯片（CH343）引出的一路 UART，不是 USB 设备口，所以设备管理器里看到的端口名是 USB-SERIAL CH343。8601 是两颗模组二选一，拨码开关拨错就会连到另一颗上，表现出来就是「口能选到，但一点日志都没有、下载也超时」。供电不足同样会超时，用电脑 Type-C 口直接供电、换一根能传数据的短线最稳。处理步骤：① 装 CH343 驱动，设备管理器确认出现 USB-SERIAL CH343；② 8601 把拨码开关拨到目标模组，波特率随之改 6M 或 2M；③ Luatools 勾「通用串口打印」再打开串口；④ 下载期间断开除 DBG_UART 之外的其它串口信号，避免外部信号干扰；⑤ 仍超时改用外部稳压电源供电。参考文档：https://docs.openluat.com/air8607/software/debug/、https://docs.openluat.com/air8601/software/debug/

2. Air8602 WiFi版搜不到任何SSID、返回0，是什么原因？

解答： 结论：先接天线。整机默认按 IPEX 座那一版出货，不接天线扫不到任何 SSID 是正常现象，返回 0 不是软件故障。说明：8602 系列的 WiFi 由 Air6205 提供，模块有两个封装版本、硬件完全兼容，只有天线方案不同：Air6205 在底部焊盘预留 2.4G 天线位置，可自己布板载天线（要按天线设计指导留净空、不覆铜）；Air6205A 是邮票孔封装，通过一代座子接外置天线，给云动生产时默认贴的就是这一版。天线不插就没有辐射单元，扫描自然是空列表。另外 WiFi 扫描只和 6205 有关，跟 4G、SIM 卡没关系，别去查卡。处理步骤：① 先把 2.4G 的 FPC 或棒状天线接到 IPEX 座；② 再扫描，用 exnetif 库初始化 STA；③ 要改板载天线，按《Air6205 板载天线封装说明文档》留净空并贴对应匹配件；④ 换 8602B 时同样先确认板上贴的是哪一版。参考文档：https://docs.openluat.com/air6205/product/、https://docs.openluat.com/air8602/software/debug/

3. Air1603/Air8607如何驱动24寸大屏？

解答： 结论：可以，但走「RGB 转 HDMI」转接板，而且分辨率上限是 1280×800，接 24 寸屏做不到显示器原生的 1080p。说明：Air1603 只有 RGB565 并行接口（65K 色），没有原生 HDMI 输出，要上 24 寸显示器必须外加 RGB→HDMI 转换模块，里面含 TMDS 编码、一般两颗芯片，淘宝有成品。合宙这一侧是 50PIN 排线，转接板常见 30PIN 或 40PIN，买之前要逐脚核对定义，别只看针数。还要先确认显示器肯接受 1280×800 输入并允许缩放，否则会黑屏或提示不支持的分辨率。处理步骤：① 确认屏的分辨率与时序，按不超过 1280×800 配置；② 选 50PIN 输入的 RGB→HDMI 板；③ 核对排线针脚（R/G/B、DE、HS、VS、PCLK、背光与地）；④ 先点亮再谈帧率，帧率随界面和带宽变化；⑤ 只想接 VGA 就找 RGB→VGA 方案。参考文档：https://docs.openluat.com/air1603/、https://docs.openluat.com/air8607/hardware/circuit/

4. 8601的默认快递柜UI源码在哪里？

解答： 结论：在 LuatOS 仓库 module/Air8601/project/factory 下，那是 Air8601 默认出厂固件的脚本源码；仓库里另有 module/Air8601/project/DEPOSIT_CABINET 是快递柜整机工程。说明：Air8601 的出厂固件是「内核 .soc + 脚本工程」两部分，主界面、设置、WiFi/4G 配置、IoT 登录这些 UI 全在脚本侧，改界面只改脚本即可，不用动内核。内核要按 Air1601 选，出厂用的是 V1028 的 102 号。烧录时记得勾「添加默认 lib」，否则会提示缺少 xxx.lua。处理步骤：① 到 gitee 对应目录取脚本；② Luatools 新建项目，内核选 Air1601 的 .soc；③ 导入脚本与资源并勾「添加默认 lib」；④ 要改快递柜业务就再看 DEPOSIT_CABINET 工程；⑤ 下载底层和脚本，首次上电看 UI 是否正常起。参考文档：https://docs.openluat.com/air8601/software/debug/、https://docs.openluat.com/air8601/software/default_factory_firmware/

5. AirUI的image控件支持直接显示远程URL图片吗？

解答： 结论：不支持。airui.image 只吃本地资源路径，远程图片要先下载落地再显示。说明：AirUI 是本地渲染框架，image 组件按路径从脚本区或文件系统读图（支持 JPG/PNG，1603 还有硬解），本身没有 HTTP 拉流能力。要做「云端图标」，常规做法是先用 http 库把图下到 /luadb 或 SD 卡，校验完整后把路径喂给组件，并做本地缓存避免每次开机都重下——应用商店那类界面就是这么处理的。处理步骤：① 用 http.request 把图拉到临时文件；② 校验长度与文件头，确认是完整图片再改名到正式路径；③ 缓存命中直接复用，不重复下载；④ 失败要有占位图，别让界面空一块；⑤ 图片按屏分辨率预先裁好，不要把大图丢给组件缩放。参考文档：https://docs.openluat.com/air1603/luatos/app/multimedia/ui/airui/、https://docs.openluat.com/osapi/core/airui/

6. Air780EPM/Air780EP的ANT天线引脚对地短路是否正常？

解答： 结论：正常。模组内部的天线匹配电路里有一颗电感接地，电感对直流就是短路，万用表量出来必然接近 0Ω。说明：天线工作频率是 700MHz~2700MHz 的超高频，电感对直流短路、对交流是高阻，所以这颗电感既不影响射频信号进出，又能给天线口提供直流通路（泄放静电、支持有源天线馈电）。因此量到短路只能说明直流通路正常，不能据此判断天线好坏。真要判断天线是否正常，看的是驻波/回波损耗或者实际信号强度。处理步骤：① 不要因为量到短路就去拆匹配电路；② 要验证就上矢网看 S11；③ 现场可用 AT 指令查 CSQ、RSRP 做前后对比；④ 天线不匹配先查净空、馈线长度和匹配件是否按规格书贴。参考文档：https://docs.openluat.com/air780epm/luatos/hardware/ant/

7. 设备运行中突然重启是怎么回事？

解答： 结论：最常见是脚本长时间不让出 CPU，导致内部硬件看门狗超时复位；其次是供电跌落，或外部看门狗动作。说明：Air700/Air780/Air8000 系列的内部硬件看门狗由内核固件自动开启，超时时长用户改不了、也关不掉：开机或普通重启后 28 秒，PSM+ 唤醒后首次 8 秒、8 秒内成功喂狗后转 28 秒。所以脚本里 while true do end 这种忙等、或者一个大循环长时间不 sys.wait，28 秒一到就复位。Air1601/Air1602 默认 20 秒、最大可设 60 秒，PSM+ 模式下看门狗停止工作。处理步骤：① 先看复位原因和重启前的日志，确认有没有看门狗相关字样；② 把长任务拆段，循环里加 sys.wait 主动让出 CPU；③ 检查 VBAT 供电——780EPM 射频瞬间要 1.5~2A、持续要大于 1A，供电弱会周期性重启；④ 用外部看门狗（Air153C）时确认喂狗周期小于超时时间。参考文档：https://docs.openluat.com/common/watchdog/、https://docs.openluat.com/osapi/core/wdt/

8. Air780EHM固件（如LuatOS-SoC_V2050_Air780EHM_13.soc）能否配合官方Air8783H案例脚本使用？

解答： 结论：可以，前提是该版本内核已经把 cc 库的 PCM 桥接模式编进去了。脚本层能直接跑，但 SIP-CC 桥接能力来自固件，补脚本是补不齐的。说明：要分开两件事——内核固件（.soc）决定有哪些核心库、有没有那条硬件通路，脚本工程只是调用方。Air8783H 的 SIP-CC 桥接 demo 走的是模组内部 PCM 直连，依赖 cc.AUDIO_MODE_BRIDGE_PCM 这类固件侧能力；13 号是 Air780EHM 的一个分区组合，能不能跑要看它有没有把这条通路编进去，不能只看版本号高低。处理步骤：① 先烧 13 号内核加官方脚本，看日志里能否进到 PCM 桥接模式；② 取不到就换带该能力的固件（以 Air8783H 页面提供的固件为准）；③ 不要拿别的型号的 .soc 硬套；④ 通话或音频异常时把完整日志给 FAE。参考文档：https://docs.openluat.com/air780epm/luatos/firmware/780ehm_version/、https://docs.openluat.com/air8783h/

9. 能否提供不带Web功能的纯内核固件？

解答： 尚未解答

10. 1602+6205连接后约20秒因看门狗超时掉线，喂狗是airlink底层做的吗？

解答： 结论：airlink 链路本身由底层维持，脚本不用给 6205 喂狗；但 20 秒这个数字正好是 Air1601/Air1602 内部硬件看门狗的默认超时，掉线要先分清是主机复位还是从机掉线。说明：6205 跑的是 airlink 从机固件，它自己维持心跳，主机脚本只要保证 airlink 链路在跑就不用额外喂狗。如果要做「互为看门狗」——主机挂了让 6205 复位主机、或者反过来——那要显式用 exairlinkwdt 扩展库，通过 WDT:FEED、WDT:RESET 命令配合 TO_RESET 管脚实现，这个不是自动的。处理步骤：① 先抓复位前后的日志，确认是 1602 重启还是 6205 掉线；② 若 1602 在 20 秒左右复位，重点查脚本有没有长时间阻塞；③ 需要互看门狗就接 exairlinkwdt，注意空闲电平（三极管电路默认低电平，直连要改成对应电平）；④ 1601/1602 的超时可调，最大 60 秒。参考文档：https://docs.openluat.com/osapi/ext/exairlinkwdt/、https://docs.openluat.com/common/watchdog/

11. 官网没有1602+6205 WiFi扫描SSID的应用DEMO，能否提供？

解答： 结论：官方 WiFi 联网 demo 在 module/Air1601_Air1602_Air1603_Air1604_Air1605/demo/airlink；扫不到 AP 多半是天线没接，或者 exnetif 没 require 对。说明：1602 加 6205 的 WiFi 不是 1602 自己的射频，是主控通过 airlink 把 6205 当网卡用，所以必须走 exnetif/airlink 这一套，直接调 wlan 库是拿不到 6205 的。扫描之前要确认 airlink 已经握手成功，否则接口会返回空列表，看起来就像「不支持扫描」。处理步骤：① 先接好 2.4G 天线；② require exnetif 与 airlink，确认链路起来了再往下走；③ 调扫描并打印返回的 SSID 数量；④ 仍为 0 就抓 airlink 日志，看从机固件有没有正常应答；⑤ 顺带确认板上贴的是 6205 还是 6205A，天线方案不一样。参考文档：https://docs.openluat.com/osapi/ext/exnetif/、https://docs.openluat.com/osapi/core/airlink/

12. Air780EHU/Air780EGH是否支持阿联酋运营商，是否有测试过？

解答： 尚未解答

13. Air6205+Air780EHM组合能否直接使用Air8000W固件？

解答： 结论：不行。Air8000W 是 Air8000 平台的整机，780EHM 是 ec718 平台的模组，两者不是同一颗芯片，固件不能互刷。说明：固件是按「SoC 平台 + 分区 + 外设组合」编译出来的，跨平台连启动都不成立，不是改脚本能绕过的事。6205 加 780EHM 属于「主控 + WiFi 从机」的组合，WiFi 侧由 airlink 提供；Air8000W 则是自带 WiFi6 的单芯片形态，网络配置、引脚定义、驱动全都不一样。处理步骤：① 用 Air780EHM 自己的内核；② WiFi 走 exnetif/airlink 配 6205；③ 真想省事就直接上 Air8000W 整机，但那是换硬件、不是换固件；④ 不要拿别的型号的 .soc 试烧，容易变砖。参考文档：https://docs.openluat.com/air8000/product/、https://docs.openluat.com/air780epm/luatos/firmware/780ehm_version/

14. Air1603模块能否播放视频？

解答： 结论：支持。Air1603 用 AirUI 的 airui.video 组件播 MJPG 视频，既能播烧进固件的本地文件，也能从 HTTP 服务器拉流。说明：所谓「合宙自定义的编码格式」实际就是 MJPG（逐帧 JPEG），靠 1603 的 JPG 硬解来撑帧率，所以不是任意 mp4 都能直接丢进去播，要先转成 MJPG。另外固件里还有 mplayer 多媒体库（mp3/mp4/flac/wav/aac），那一条是音频与封装层的播放能力，和 airui.video 的分工不同，别混用。处理步骤：① 先把视频转成 MJPG；② 本地播放就烧进固件资源，网络播放给 HTTP 地址；③ 用支持 AirUI 的新版本内核；④ 出厂固件播放几次后停住是已知问题，先升级内核再复现；⑤ 分辨率别超过屏的上限，否则会掉帧。参考文档：https://docs.openluat.com/air1603/luatos/app/multimedia/ui/videoplayer/、https://docs.openluat.com/air1603/luatos/firmware/1603_version/

15. Air780E R3的RNDIS是复合口吗？

解答： 尚未解答

16. 想用蓝牙模组做主机时可同时连接多少外设？主机+从机模式比从机模式功耗多多少？

解答： 尚未解答

17. 合宙模组是否都支持三大运营商SIM卡？

解答： 结论：不是所有型号都三网通吃。Air700 系列是按运营商分型号做的，一个型号只对应一家；Air780、Air8000、Air8101 这些支持国内三大运营商。说明：Air700 因为尺寸做到极小，硬件上没法同时覆盖移动、电信、联通的射频频段，所以拆成移动版、电信版、联通版三个型号，其余软硬件完全兼容，选型按项目实际要用的卡来定。具体到 ec718 平台的 Air700ECP/ECH/ECT，做的是中国移动版本。频段属于硬件差异，刷固件改不了。处理步骤：① 先定用哪家运营商的卡；② 按运营商选对应型号；③ 拿不准就查该型号的频段表；④ 海外项目另按当地频段选 Air780EHU、Air780EHN 这类版本；⑤ 同一批产品不要混用不同运营商版本。参考文档：https://docs.openluat.com/air700eaq/、https://docs.openluat.com/air780epm/product/

18. Air8603主板能否直接拨打电话？

解答： 尚未解答

19. 赠送的物联网卡需要实名激活吗，直接插设备能用吗？

解答： 尚未解答

20. 物联网卡换设备后被锁卡，怎么办？

解答： 结论：物联网卡普遍做「机卡绑定」，换设备会触发锁卡，只能找卡商解绑，换回原设备也不一定能解。说明：这类卡在卡商或运营商侧记录了首次激活的 IMEI，一旦检测到 IMEI 变化就判定异常并锁定，属于风控手段，不是模组的问题。所以调试阶段频繁换板子最容易把卡锁掉，量产阶段换料返修也要提前跟卡商报备。处理步骤：① 一张卡固定一台设备调试；② 已被锁就联系卡商，提供卡号与 IMEI 申请解锁；③ 批量项目在卡商侧登记 IMEI 白名单；④ 不要把「换回原设备」当成解绑手段。参考文档：无（属卡商与运营商侧业务规则，请咨询购卡渠道）。

21. 7寸小盒子内放置Air780等器件，频繁定位（如10秒一次）会不会散热不好、电池发热？

解答： 结论：有可能，尤其频繁定位加持续上报时。密闭小盒里 4G 发射的热量会累积，必须实测；按经验 Air8202 整机发热很不明显，可以买一块做对比。说明：Cat.1 模组射频发射瞬间脉冲电流能到 1.5~2A（百微秒级），持续供电也要大于 1A，这些能量最终都变成热。10 秒一次定位意味着模组几乎一直在收发，占空比比一分钟一次高一个数量级，温升自然明显。电池发热还要看充放电倍率，不只是模组本身。处理步骤：① 先做 30 分钟连续定位的温升实测；② 盒内留对流孔，或改用金属壳导热；③ 降低上报频率，能批处理就批处理；④ 电池选放电倍率有余量的型号，别让小容量电池长期大电流；⑤ 低功耗场景可评估 PSM+ 模式。参考文档：https://docs.openluat.com/air780epm/luatos/hardware/design/power/、https://docs.openluat.com/air8202/hardware/circuit/

22. 7603/8607是否支持电阻触摸屏（如XPT2046 SPI电阻触摸、T8624触摸）驱动？

解答： 结论：目前不支持。官方工程只做 I2C 电容触摸，8607 用的是 GT911、走 I2C1；XPT2046 这类 SPI 电阻屏要单独适配，需提供规格书并寄样品。说明：电容触摸在 tp 库里是「芯片型号 + I2C 地址」的模型，XPT2046 是 SPI 接口的电阻屏控制器，靠 SPI 读坐标、靠 PENIRQ 判断按下，寄存器模型和坐标换算方式完全不同，库内没有对应驱动，tp.init 传不进去。所以这不是改个参数能解决的，得补驱动。另外本站文档未检索到 Air7603 的独立资料，请按实际丝印核对型号。处理步骤：① 先确认屏是电容还是电阻（看排线是 I2C 四线还是 SPI 加 PENIRQ）；② 电容屏按 GT911 走 tp 库；③ 电阻屏把型号、规格书、时序寄给 FAE 评估适配；④ 自己适配就用 spi 库读坐标再做映射。参考文档：https://docs.openluat.com/osapi/core/tp/、https://docs.openluat.com/air8607/hardware/circuit/

23. RGB转HDMI模块是买合宙的还是自己买？合宙是565接口，网上多为888接口，是否兼容？

解答： 结论：兼容。合宙输出的是 RGB565，接 RGB888 的转接板只需接高 16 位（R[7:3]、G[7:2]、B[7:3]），低位按板子规格书固定电平即可。说明：RGB888 是 24 位并行、RGB565 是 16 位，两者在数据线上是高位对齐的关系，少掉的低位不影响图像信息，只是色彩精度低一些——这也是 1603 天生只有 65K 色的原因。转接板本身是通用件，合宙自己也是直接买淘宝的板子，不存在必须买合宙的。处理步骤：① 按转接板丝印把 R/G/B 高 16 位逐脚对好，别错位；② 低位接地或按规格书处理；③ DE、HS、VS、PCLK 与背光、地一并核对；④ 点亮后用测试图看有无色偏；⑤ 分辨率不超过 1280×800。参考文档：https://docs.openluat.com/air1603/、https://docs.openluat.com/air8607/hardware/circuit/

24. 合宙DTU平台远程配置模块现在收费吗？

解答： 结论：远程配置目前不收费，直接用合宙 DTU 管理平台即可。说明：DTU 平台是给透传、数传类应用做参数下发和远程配置的配套服务，和 IoT 平台的设备归属、FOTA 是两套东西，配置功能本身现在不收费。需要提醒的是资费口径会调整，真要做商务预算，以平台公告和对接销售当期的报价为准，本文不锁定价格。处理步骤：① 打开 https://dtu.openluat.com 注册或登录；② 按提示把设备归属到自己账号下；③ 在平台上下发串口参数、心跳等配置；④ 涉及流量卡与流量资费的另算，别和平台功能费混在一起。参考文档：https://dtu.openluat.com、https://docs.openluat.com/common/Luatools/

25. Air1602的烧录说明文档在哪？CH343驱动在Win11安装后设备管理器无提示？

解答： 结论：烧录说明在 air1601/product/air1602_turnkey_devboard/download/；Air1602 的资料整体挂在 air1601 树下，没有独立的 air1602 目录。CH343 装完没提示，多半是杀毒软件把驱动安装拦掉了。说明：Air1602 与 Air1601 共用一套文档树，找 1602 资料不要去找 air1602/ 目录，那里没有独立文档。CH343 驱动安装是静默写 INF，Windows 11 本身不会弹「发现新硬件」，正确的判据是设备管理器里出现 USB-SERIAL CH343 端口，而不是有没有弹窗。处理步骤：① 装完驱动看设备管理器「端口（COM 和 LPT）」；② 没有就临时关掉杀毒软件和安全管家再装一次；③ 或手动「更新驱动程序 → 浏览计算机」指向驱动目录；④ 换一根能传数据的 USB 线；⑤ 端口出来后 Luatools 勾「通用串口打印」，波特率按 1601/1602 的默认 6M。参考文档：https://docs.openluat.com/air1601/product/air1602_turnkey_devboard/、https://docs.openluat.com/air1603/luatos/common/swenv/

26. 在渠道商购买的模块如何转到自己的合宙账号下？周末有人值班处理吗？

解答： 结论：官方电商渠道可以自助转移（crm.luatos.com，填订单号加快递单号）；渠道商或线下采购的不适用自助，要走商务或客服，提供 IMEI 与合同信息核实后由后台处理。说明：文档写得很明确——不是合宙官方电商买的设备不适用自助转移。线下批量单通常是发货前就按客户指定的 IoT 账号放好，要改后续发货的归属得在下单时就告诉商务。另外一旦设备已经归属到用户名下，合宙侧就没有转移权限了，「先归属再反悔」这条路走不通。周末是否有人值班属商务与客服排班，文档没有口径，需直接问对接人。处理步骤：① 官方电商买的：登录 crm.luatos.com，进「客户服务 → 首次设置设备归属（限官方店铺）」；② 批量或渠道的：找采购负责人确认当前落在哪个账号；③ 要改归属就提供 IMEI 清单与合同给商务；④ 已在自己账号下的设备，合宙不再代办转移。参考文档：https://docs.openluat.com/air780epm/product/attributioniot/

27. 蓝牙模组做主机时能同时连多少外设、主从模式功耗增加多少？

解答： 尚未解答

28. Air8300能否二次开发？想用WiFi该用哪个固件？

解答： 尚未解答

29. 8603 10寸屏的开孔图纸和尺寸什么时候能提供？

解答： 结论：按官方答复，要等 10 寸样品到货确认误差后才能出 STEP 格式的开孔图纸，给的是结构件用的 3D 文件，不是 PDF 尺寸图。8603 的 50PIN 口本身覆盖 7 寸、9 寸、10~10.1 寸屏。说明：开孔图必须等实物核对公差，先出图后到货的话整机装配容易差几毫米，这是结构件流程问题，不是文档漏发。另外「合宙 10 寸」实际按 10.1 寸规格算，做结构时要按 10.1 寸的外形尺寸留位，别按标称 10 寸去扣。处理步骤：① 先按 10.1 寸外形做结构预留；② 向对接销售或 FAE 索取 STEP 文件；③ 拿到后核对可视区与固定孔位；④ 首件装配后回测间隙再改模。参考文档：https://docs.openluat.com/air8603/

30. Air8607/Air8607A是开发板还是量产主控板？

解答： 结论：Air8607 是大屏音视频最小系统板，偏开发评估；Air8607A 是量产主控板，文档明确写了可以直接作为终端产品的主板用于量产。说明：两者的主控都是 Air1603，宽度都 45mm，8607A 长度短 2.5mm（45×50 对 45×52.5）。差异在接口取舍：8607A 多出 UVC 摄像头接入、UART3、SPI1、PWM1/GPIO65，但取消了板载 SD 卡座和 USB 转串口电路（改成 5PIN 下载调试口加夹具）。所以要摄像头和更多外设选 8607A，要板载 SD 卡、想直接插电脑下载调试选 8607。处理步骤：① 先定要不要 SD 卡与 USB 直连调试；② 要摄像头就选 8607A，首选 AirCAMERA_1032；③ 量产用 8607A 时按 5PIN 夹具做产线下载；④ 从 8607 迁到 8607A 按文档第 13 节改引脚。参考文档：https://docs.openluat.com/air8607a/、https://docs.openluat.com/air8607/hardware/circuit/

31. AT指令按手册发送返回ERROR，是否有前置命令？

解答： 尚未解答