常见问题 - 2026-11-05

数据日期：2026-11-05

1. Air780EHV 的 SIP 有底噪/回声，能通过改固件或代码解决吗？

解答： 结论：不行，Air780EHV 这类通用 4G 模组搞不定回声和底噪，这不是改代码能解决的。说明：回声消除（AEC）要靠“硬件采集通路 + 声学结构 + 算法整定”三者配合，EC7xx 平台的 AEC 依赖 codec 侧的硬件单元加专门的参数标定，还要结合麦克风与喇叭的间距、音腔容积、增益曲线一起调。Air780EHV 是通用模组，只保证 SIP 协议栈和语音通路可用，没有为免提对讲做过整机声学标定；底噪多来自电源纹波与地回路，回声则是喇叭声音被麦克风重新拾取，两者都属整机问题。处理步骤：① 先明确用途：点对点、贴近说话的耳机式通话，780EHV 够用；② 要做免提对讲、门禁对讲，直接换做过音频处理的方案，如 Air8784、Air8783H、Air8605、Air8701；③ 若必须自研，先改结构（麦克风远离喇叭、加音腔与减振、屏蔽功放走线）、把音频地与数字地单点连接，再在软件侧加 AGC/降噪试。参考文档：https://docs.openluat.com/air780ehv/product/

2. 8603 的 USB 烧录口需要接什么线？两个口都要数据线吗？

解答： 结论：两个 USB 口都要用支持数据传输的数据线，只供电的充电线不行；线越长越容易识别不到。说明：Air8603 是 PCBA，板上两组 USB 各有分工：一组给主控（Air1603）做下载与日志，一组给板载 4G 模组做下载/AT。纯充电线内部只有 VBUS 与 GND，D+/D− 没连通，电脑端既看不到串口也进不了下载口，表现就是“插上没反应”。另外线太长、线材屏蔽差会导致枚举失败或下载中途掉线，1 米以上尤其明显。处理步骤：① 先只接主控口，确认设备管理器出现串口（CH343 驱动）；② 再接 4G 口，确认出现对应的下载/AT 口；③ 识别不到时换 0.5 米以内的短数据线、插主板后置 USB 口、避开 USB HUB 与延长线。参考文档：https://docs.openluat.com/air8603/

3. Luatools 里的日志打印在哪里看？

解答： 结论：在 Luatools 里点“打开串口”之后，持续滚动的英文输出窗口就是日志。说明：LuatOS 的 print 默认走调试串口，Luatools 打开该串口即能收到；日志行首的 D/ I/ W/ E 分别是 debug/info/warn/error 等级，启动时会先打印 loadlib、内存占用等信息，可以据此判断固件是否正常跑起来。收不到日志常见三个原因：波特率与固件不一致、串口被别的工具占用、接的是 AT 口而不是日志口。处理步骤：① Luatools 打开串口，选对 COM 号与波特率（多数固件为 921600，部分为 115200）；② 复位板子，看有没有 loadlib 与内存打印；③ 没有任何输出就逐个排查波特率、占用、端口；④ 需要长期留存日志时打开“保存日志”把输出落文件。参考文档：https://docs.openluat.com/common/Luatools/

4. 烧录完成后没有画面/卡在下载 bootloader，怎么排查？

解答： 结论：先确认固件包与板子是否匹配，再查驱动和线材，最后用 BOOT + RESET 强制进下载模式重烧。说明：LuatOS 的 .soc 包按“平台 + 固件号”区分，平台选错（例如把别的型号的包烧到本板）会在校验阶段失败并停在 bootloader；驱动方面合宙下载口多用 CH343（部分老板是 CH340），驱动没装好设备管理器里是未知设备或带感叹号，工具就连不上。还有一类是固件号对应的分区与板子 Flash 不符，同样会卡在下载阶段。处理步骤：① 核对包名里的平台与固件号；② 装好 CH343 驱动，确认设备管理器有 COM 口；③ 按住 BOOT 再点一下 RESET 进入下载模式后重新烧录；④ 换短数据线、换 USB 口、重启电脑；⑤ 仍不行把工具报错截图与日志发给技术支持远程协助。参考文档：https://docs.openluat.com/common/Luatools/

5. 合宙的 7 寸屏是否单卖？价格多少？

解答： 结论：合宙的屏不单卖，随整机/PCBA 配套出货；单独买屏可以在淘宝等渠道自选，只要接口与分辨率匹配。说明：合宙的屏主要作为带屏 PCBA 方案的配套件，按整机 BOM 供货，不单独零售。第三方屏要能接，关键看三点：分辨率不超过平台上限（Air1601/1602/1603 最高 1280×800，Air8101 最高 1280×720）、接口与时序匹配（RGB 屏要注意数据位对齐）、触摸控制器型号与驱动对得上。处理步骤：① 先确认主控型号与平台分辨率上限；② 在淘宝选屏时把规格书（接口、时序、触摸 IC）发给技术支持确认可适配性；③ 价格与批量事宜直接找对接销售确认（原答复对接人为杨凤珍）。参考文档：https://docs.openluat.com/air1603/

6. VSCode 插件已安装但代码补全不生效怎么办？

解答： 尚未解答

7. 合宙模块能否用于远程升级（FOTA）？有方案吗？

解答： 结论：可以，合宙有完整的 FOTA 方案，但升级前必须核对版本跨度与固件号，跨大版本要找中间版本过渡。说明：LuatOS 的 OTA 按库分三代：libfota 为早期版本，libfota2 通用、可对接自建服务器，libfota3 只对接合宙 IoT 平台（自建服务器必须用 libfota2）。差分升级只能在“同号固件”之间做，1 号只能升 1 号、2 号只能升 2 号；版本跨度大时差分包对不上，模块会退回整包升级，所以跨度大建议逐级升或找中间版本。另外升级前要确认文件系统区剩余空间足够，差分包本身也要占空间。处理步骤：① 在固件页确认目标版本号与固件号，并核对与现网固件号一致；② 选用对应 fota 库、配好服务器地址与项目 key；③ 先在样机上跑通“下发—下载—校验—重启—版本号变化”的闭环；④ 再开灰度、最后全量。参考文档：https://docs.openluat.com/osapi/core/fota/

8. 1603 只有一路硬件 I2C，接了触摸屏后还能接其他 I2C 设备吗？

解答： 结论：Air1603 硬件 I2C 只有一路且与 UART5 复用，接了触摸屏后其余 I2C 器件可以走 GPIO 模拟 I2C 或加 I2C 多路复用器，但要评估 CPU 开销。说明：硬件 I2C 的引脚与 UART5 是同一组复用脚，二选一，触摸屏占用后就没了硬件 I2C。替代方案有两条：软件模拟 I2C（GPIO 翻转 + 延时），速率通常只有几十到一两百 kHz，且占用 CPU，播放 MP4、刷大图这类高负载场景下容易被拖慢、触摸响应变迟钝；或者用 I2C 多路复用器（如 TCA9548A）把一条总线扩成多路，各从设备分时访问，代价是多一颗器件和一点切换开销。Air1602 有两路 I2C，第二路与 UART6 复用，双 I2C 需求优先选 1602。处理步骤：① 先统计总线上有几个从设备、地址是否冲突；② 触摸走硬件 I2C，其余走软件 I2C 或经多路复用器；③ 在高负载场景下实测触摸响应与帧率；④ 器件多、实时性要求高就换 Air1602。参考文档：https://docs.openluat.com/air1603/

9. Air8603/Air8607 的 PSRAM/图片缓存有多大？显示大图会爆内存吗？

解答： 结论：Air1603（含 8603/8607）是 Flash 18MB + RAM 16MB，图片缓存上限受固件配置限制（约 4MB），超出的旧图会被淘汰重解码，不会直接崩。说明：LuatOS 的图片缓存是一块固定大小的池子（display.loadImage 或 airui 的图片池），大小由固件编译期决定，满了按最久未用淘汰，所以大图场景的表现是“切回上一屏时闪一下/卡一下”，而不是内存耗尽。要放更多图有三条路：降分辨率或用 JPEG 硬件解码、选 32MB RAM 的高配版（图片缓存能开到 12MB 量级）、改用 Air1601/1602 平台。处理步骤：① 用 rtos.meminfo("sys") 看系统内存余量，再结合图片池配置估算；② 把超大图切成多张小图分屏加载；③ 需要同时缓存多张全屏图时换高配内存版本。参考文档：https://docs.openluat.com/air1603/

10. Air780EPM 如何改成 AT 模式？对应固件在哪里下载？

解答： 结论：Air780EPM 不支持 AT 指令，硬件上跑不了 AT 固件；要 AT 请选 Air780EPT 这类 AT 型号。说明：AT 固件是独立的固件形态（AT 命令解析 + 协议栈），只有合宙指定型号发布。EC718 平台（780EPM/EHM/EHV/EGH 等）的官方资料站只提供 LuatOS 二次开发，没有 AT 分支；把 780EPT 的 AT 包烧进 780EPM，会因型号与分区不匹配而校验失败或功能异常，不能等效替代。反过来说，780EPM 的 LuatOS 在 socket、mqtt、http 等库上能力更全，做业务逻辑更合适。处理步骤：① 需求是“用 AT 指令做透传数传”→ 直接选 Air780EPT（参考价 16.8 元）；② 需求是自己写业务逻辑 → 用 780EPM 的 LuatOS；③ AT 固件按型号在 AT 模组文档页下载，下载前核对型号与版本。参考文档：https://docs.openluat.com/air780epm/luatos/firmware/780epm_version/

11. Air8000W 用开机按钮开机有时开不出来，和固件有关吗？

解答： 尚未解答

12. Air8000W 只用 WiFi 联网、不插 SIM 卡时，能否用合宙平台远程升级？

解答： 尚未解答

13. Air8000W 的脚本区太小，能否定制固件裁掉不用的功能来扩大脚本区？

解答： 结论：脚本区不能靠“随手删库”临时扩容，先在现成固件号里挑；确实都不满足再走固件定制评估。说明：LuatOS 固件的脚本区与文件系统区是编译期按分区表切死的（典型 512KB、1024KB 等），运行期不可调。合宙已经按“功能 + 空间”的组合做了多个固件号，先看有没有“脚本区更大、但你用不到的功能已被裁掉”的现成号，比自己裁库稳妥得多。定制固件涉及分区表、库裁剪、TTS/字库资源放哪儿等一连串改动，需要研发评估空间与时程，不是改个配置就能出包。处理步骤：① 打开 Air8000 固件页，按“脚本区大小 + 需要哪些库”在固件支持表里对照选号；② 统计自己 Lua 代码与资源文件体积，留 20% 余量；③ 仍不够，把“必须的库清单 + 目标脚本区大小 + 用途”整理好给固件定制对接人评估。参考文档：https://docs.openluat.com/air8000/luatos/firmware/

14. Air8000W 做 SIP 对讲时拨号接通/挂断有明显电流声、杂音，如何定位？

解答： 结论：拨号接通/挂断瞬间的电流声优先查功放使能时序、电源瞬态与地回路，先出最小复现和日志再定方案。说明：这类“嘟”声或杂音通常来自三处：功放使能瞬间的 POP 音（PA 上电与静音脚时序不对）、4G 发射突发拉低 VBAT 造成音频地跟着抖、SIP 通路建立或拆除时的采样率与 codec 切换。定位方法很直接：日志看 codec 打开/关闭的时刻，示波器同时看 PA 使能脚与 VBAT 波形，两者的先后关系基本就能指认原因。处理步骤：① 录最小复现脚本 + 完整日志（含 codec、voip 打印）；② PA 使能加软启动延时，静音脚先拉低再上电；③ VBAT 加大电容并缩短走线，音频地与数字地单点连接；④ 声学与电源都优化后仍不能接受，选 Air8784、Air8783H、Air8605、Air8701 这类做过音频处理的型号。参考文档：https://docs.openluat.com/air8784/product/

15. 合宙 SIP 测试账号是否只有官方 SIP 系列型号才能使用？

解答： 结论：合宙的 SIP 测试账号只提供给合宙自家 SIP 系列整机/PCBA，自研板子即使同款模组也注册不上。说明：测试账号挂在合宙的 SIP 服务器上，按整机型号开通，用途是帮你验证通话链路，不是通用公网 SIP 服务。自研板子在服务器侧没有型号与授权记录，注册会被拒（常见表现为 401/403 或注册超时），换账号参数也不解决——这是策略限制，不是配置问题。自研项目请自建 Asterisk/FreeSWITCH，或采购商用 SIP 服务。处理步骤：① 先确认设备是否合宙在售 SIP 型号（Air8784、Air8783H、Air8605、Air8701 等）；② 自研板用自建服务器联调，域名、端口、账号、传输方式（UDP/TCP/TLS）按服务器配置填；③ 只想验证协议栈可用性时，可先用公网免费 SIP 测试服务过渡。参考文档：https://docs.openluat.com/air8701/

16. Air8784/8783H 的 SIP 应该怎么设置？一直连接失败。

解答： 尚未解答

17. 8607 的扩展串口能否外接 485 电路，是否支持 MODBUS RTU？

解答： 结论：可以外接 485 收发电路跑 MODBUS RTU；Air8607 本身不带板载 485，要板载 485 选 Air8603 系列（M 型）。说明：MODBUS RTU 是纯软件协议（串口 + 帧间隔 + CRC16），LuatOS 有 modbus 相关库和示例可直接用，物理层只要把 UART 接到 485 收发器上。半双工的关键是方向控制：用自动流控芯片可以省掉方向脚，用 MAX485/SP3485 这类普通芯片就要用 GPIO 控制 DE/RE，而且必须在“最后一个字节真正发完”之后再切回接收，写进 FIFO 就翻转会把末尾字节截断。处理步骤：① 硬件：UART 的 TX/RX 接 DI/RO，方向脚接一个 GPIO；② 软件：modbus 库配好从机地址、波特率、校验方式；③ 方向脚在发送完成后延时 1~2 个字符时间再翻转；④ 总线两端加 120Ω 终端电阻，A/B 加偏置电阻提高抗扰。参考文档：https://docs.openluat.com/air8607/product/

18. Air8603 上边的以太网口能直接上网吗？

解答： 结论：目前不能，Air8603 的网口是给外接摄像头供网用的（LAN 角色），不是给自己的 WAN；要“网口直接上网”选 Air8606 或 Air8300 这类方案。说明：Air8603 的 RJ45 挂在 4G 侧的 SPI 以太网芯片（CH390H）上，角色是“4G 转以太网，给外接 IPC 提供网络”，所以把网线插到路由器上并不会让 8603 变成有线联网。需要主控侧以太网 WAN 的，看 Air8606（主控侧 WAN + CAN + RS232）或 Air8300 系列（4G 转以太网/路由方案）。处理步骤：① 先分清方向：给摄像头供网 → 8603 可以；自己要上有线 → 换型号；② 确认具体子型号是否带网口（仅 M 系列具备）；③ 需要“4G 进、网口出”或“有线进、WiFi 出”的完整路由，选 Air8300 系列并核对固件是否带路由功能。参考文档：https://docs.openluat.com/air8603/

19. 8603 的尺寸图/接口定义有吗？

解答： 尚未解答

20. 8606 什么时候发布？最大支持多大屏幕？

解答： 结论：Air8606 的资料已经上线（V1.2，2026-11-01），最大配 10.1 寸 RGB565 屏、1024×600；平台能力上限 1280×800。说明：Air8606 有 W1~W5、M1~M5 共 10 个型号，平台沿用 Air1602（32MB RAM），主控侧增加了以太网 WAN、CAN、RS232，4G 侧可选 GNSS。屏幕方面 10.1 寸 1024×600 是当前配套规格；Air1602 平台本身最高支持 1280×800，但具体屏要匹配电气连接、时序与固件，平台支持不等于随便一块屏都能点亮。处理步骤：① 按部署网络先定 W（WiFi）还是 M（4G）；② 再按业务接口在 1~5 里选具体型号；③ 选屏时把规格书发技术支持确认时序与背光；④ 量产前用实板验证视频播放与触摸并发。参考文档：https://docs.openluat.com/air8606/

21. Air780EGH 的 SIP 能否支持 Opus 实时双向通话？

解答： 尚未解答

22. Air780EHV 101 号固件 V2054 播放 TTS 提示不支持 TTS 库，是什么原因？

解答： 结论：这是 V2054 的已知问题，V2056（2026.11.05 发布）已修复，升级固件即可。说明：V2056 更新记录里有一条直接对应：“fix: tts, 修复部分固件开启了 TTS，却未开启 ONCHIP，因此误走了外置资源路径，导致 TTS 无法播放”。原答复里说的“56 版本”就是 V2056。需要注意的是，TTS 能不能播还取决于该固件号本身是否带 TTS 资源——如果脚本区或文件系统区放不下资源，路径修好了也仍然播不出来，要先确认固件定义。处理步骤：① 到 Air780EHV 固件页下载 V2056 的 101 号固件；② 烧录后跑最小 TTS 例程确认能出声；③ 仍报“不支持 TTS 库”就贴完整日志给技术支持，重点看 loadlib 列表里有没有 tts。参考文档：https://docs.openluat.com/air780ehv/luatos/firmware/version/

23. Air1602 能否同时挂载 TF 卡和 U 盘互相传数据？

解答： 结论：当前版本不行，fatfs 绑定层把 pdrv 硬编码为 0，等于全系统只认一个卷，TF 卡与 U 盘只能二选一。说明：pdrv 是 fatfs 的物理驱动号，挂载时用它区分“这块盘是哪一路块设备”。当前实现里固定为 0，所以第二次挂载（无论 TF 还是 U 盘）都会落到同一个卷上，表现为挂载失败或两卷互相覆盖。要实现双卷互拷，需要把 pdrv 改成按挂载点分配，并处理两套块设备驱动（SDIO/SPI 与 USB 主机栈）的并发访问，属底层改动，所以答复是“已反馈研发实测评估，需要几天”。处理步骤：① 现阶段先做单卷方案：文件放 TF，需要给 U 盘时再切换；② 或者用网络/串口把文件转出去，绕开双卷需求；③ 等研发给出支持双卷的测试固件后，用带不同 pdrv 的挂载参数验证互拷。参考文档：https://docs.openluat.com/osapi/core/fatfs/

24. Air780E 双卡方案中只插 SIM2 上线几秒就掉线，是什么原因？

解答： 结论：先量 SIM2 的供电与信号波形；另外带 GNSS 的 Air8000 封装会占用 SIM2 相关引脚，同时用 GPS 时 SIM2 就用不了。说明：双卡方案里 SIM2 的 VDD_SIM2、RST、CLK、DATA 是独立一组。只插 SIM2 时如果 VDD_SIM2 没起来（或 DATA 缺上拉、走线过长、ESD 器件漏电），模块会在注册后几秒因 SIM 通信超时掉网，现象正是“上线几秒就掉线”。另一类原因是脚位冲突：部分封装把 GNSS 的备用电源与信号复用到 SIM2 脚位，同时启用 GNSS 就会互相干扰。处理步骤：① 万用表量 VDD_SIM2 是否有 1.8V 或 3.0V；② 示波器看 CLK/DATA 上有没有完整的复位应答（ATR）；③ 检查 DATA 上拉电阻与 ESD 器件；④ 若必须同时用 GNSS，改用 Air780EXX + Air510W/530W + Air5101S/6205 的组合。参考文档：https://docs.openluat.com/air780epm/product/

25. Air780EP 在现场只有 800MHz 频段时能否正常联网，能否锁频段？

解答： 结论：先用 mobile.getBand 看实际驻留频段；频段可以锁但不建议，先排除 SIM 卡与链路层问题。说明：国内 800MHz 主要是 B5（电信），Air780EP 支持 B1/B3/B5/B8 加 TDD 频段，正常能驻网。如果连 IP 都没拿到，问题多半不在频段，而在驻网/链路层：APN 配错、物联网卡未激活或绑定了别的 IMEI、天线与射频匹配不良。锁频只适合“多频段反复重选导致不稳”的排障场景，锁死会牺牲漫游与容错能力，定位完要恢复。处理步骤：① mobile.getBand() 看当前 band，确认是否驻在 B5；② 换一张自己的手机卡试，排除物联网卡问题；③ 核对 APN、卡状态（是否欠费/未激活）；④ 确需锁频用 mobile.setBand 指定，问题解决后取消锁定。参考文档：https://docs.openluat.com/osapi/core/mobile/

26. Air780EPM（国内版）能用于以色列项目吗？哪个版本支持？

解答： 结论：Air780EPM 是国内版，不能用于以色列项目；海外选亚欧版 Air780EHU（B1/B3/B5/B7/B8/B20/B28/B38/B40/B41）。说明：型号差异是硬件差异（射频滤波器、双工器不同），刷固件不能把国内版变成海外版。判断“能不能在某国用”的原则是“要覆盖该运营商全部频段”，只覆盖一部分就可能在某些基站上驻不上网——官方文档专门用“780EPM 支持 B3，但运营商还需要 B7/B20”的反例说明过这点。以色列主要运营商用 B3+B7，EPM 缺 B7 所以不行；EHU 覆盖 B1/B3/B5/B7/B8/B20，可以匹配。Air780EHU 与 Air780E 系列 PIN2PIN，硬件改动小。处理步骤：① 查目标运营商支持的频段（文档里有各国运营商频段清单）；② 对照 EHU 频段列表确认全覆盖；③ 换料号时核对封装与管脚定义；④ 送样在当地实测。参考文档：https://docs.openluat.com/air780ehnehu/product/air780ehufreq/

27. V1113 EC618 FULL 固件脚本区只有 128K 不够用，精简版又报 TLS 缺失，有折中方案吗？

解答： 结论：V1113 EC618 FULL 固件的脚本区就是 128KB，Lua 源码超过就只能换模块，但可以先用“资源外置 + 代码压缩”顶一阵。说明：EC618 平台（Air780E/EG/EX 等）的 FULL 固件把大部分 Flash 让给了协议栈与核心库，脚本区只剩 128KB；精简版再砍库就会缺 TLS/mbedtls，所以两条路都不宽。可行的压缩手段是把静态数据从 Lua 源码里挪出去：字库、图片、长 JSON 配置放进文件系统，运行时用 io 读；再删掉用不到的库与调试代码。处理步骤：① 统计各 Lua 文件体积，找出最大的几个；② 把静态资源移到 fs（文件系统区通常比脚本区大），运行时按需加载；③ 代码压缩（去注释、短变量名、合并文件）一般能省 20%~30%；④ 仍不够就换 EC718 平台，如 Air780EPM（脚本区 512KB 起）。参考文档：https://docs.openluat.com/air780e/

28. Air8603 是什么？是模组还是 PCBA？价格和内存多大？

解答： 结论：Air8603 是 PCBA 不是模组，参考价 19.9 元，Flash 18MB + RAM 16MB；8603M 这块 PCBA 里含 4G 模组。说明：Air8603 属“联网控制板”，主控是 Air1603，4G 由板载模组提供（M 系列带 4G，W 系列走 WiFi）。它面向“大屏 UI + 联网控制”场景，带 LCD 接口、触摸、USB，部分型号带网口（给外接摄像头供网）。所以买 8603 拿到的是整块板，不是可贴片的模组；要模组形态请选 Air780E 系列或 Air1603 主控方案。处理步骤：① 按“是否需要 4G”选 M 或 W；② 按接口需求（网口、CAN、485）选具体子型号；③ 结构设计按 PCBA 实际尺寸留位与开孔。参考文档：https://docs.openluat.com/air8603/

29. Air780EX-3.3V 的最新 LuatOS core 是否是 V1113？

解答： 结论：是，Air780EX-3.3V 属 EC618 平台，当前公开的最新 core 是 V1113。说明：Air780EX 系列按供电方式分型号（如 3.3V 版），内核都是 EC618，固件版本号走 V11xx；而 Air780EX2 是 EC718 平台，版本号走 V20xx，两者固件不通用，别混用固件包。确认实际版本最直接的办法是看固件页“最新版本”标题里的型号与版本号，或者板子上跑 rtos.version() 打印。处理步骤：① 打开对应型号的固件页核对最新版本号；② 板子运行 rtos.version() 看当前实际版本；③ 需要特定旧版本时在历史版本区下载，注意固件号要与现网一致。参考文档：https://docs.openluat.com/air780ex/product/

30. 合宙 12V 适配器接 8605 有时会自己重启，是什么原因？

解答： 结论：已确认是配套适配器的 DC 头孔径偏大、与 8605 的 DC 座之间有间隙，先换一个插合紧密的适配器；硬件同事在跟进。说明：DC 头孔径偏大时，插头与插座之间留有间隙，轻微移动或线缆受力就会瞬断，表现就是“自己重启”。另一类诱因是适配器功率与线径不足：4G 发射瞬间电流突增，把 12V 拉到欠压复位，同样表现为随机重启。两种情况用示波器看 12V 波形就能区分——瞬断是电压直接掉到 0，欠压是掉到某个值再回升。处理步骤：① 换 DC 头尺寸匹配的适配器，插上后轻晃确认不松；② 示波器量上电与发射瞬间的 12V 跌落，超过 10% 说明线材或功率不足；③ 电源线尽量短而粗；④ 已反馈硬件排查，等官方结论。参考文档：https://docs.openluat.com/air8605/

31. Air780EHU（欧亚版）有样品吗？

解答： 尚未解答

32. Air724UG 的 NFC 版本 AT 指令集固件在哪里下载？

解答： 结论：Air724UG 的 AT 固件按型号在 AT 文档页下载；NFC 版本属特殊固件，通用 AT 包里未必带，需要单独向技术支持确认。说明：Air724UG 是 8910 平台的老型号，AT 与 LuatOS 是两套独立固件，AT 文档在 /air724ug/at/app/ 下。NFC 功能一般通过外挂 NFC 控制器（I2C 接口）实现，需要固件里编入对应驱动并开放 AT 命令，所以公开的通用 AT 包往往不包含，要按你的 NFC 芯片型号确认。处理步骤：① 先下通用 AT 固件，确认基础 AT 功能与版本号；② 把 NFC 需求（芯片型号、要读写的卡类型、期望的 AT 命令形态）发给技术支持确认有无现成固件；③ 也可以改用 LuatOS 版本，用 i2c 库自行驱动 NFC 控制器。参考文档：https://docs.openluat.com/air724ug/at/app/

33. 合宙 Air780EPT 能否接收移动、联通、电信的短信？外挂单片机读取即可。

解答： 结论：Air780EPT 是 AT 型号，外挂单片机用 AT 指令收短信即可；能否收到取决于固件是否开了 SMS、卡是否开通短信、短信中心号码是否正确。说明：AT 方式收短信有两种模式：轮询（AT+CMGL 逐条读）和主动上报（AT+CNMI 配置后，新短信到达时模块主动吐 +CMTI）。做产品一般用主动上报，否则单片机得不停轮询，费电又占串口。发短信走 AT+CMGS。三个常见坑：物联网卡被限制短信功能、短信中心号码没写对、只设了 +CMGF 没配 +CNMI 导致“收到了但没通知”。处理步骤：① AT+CMGF=1 设文本模式；② AT+CNMI=2,1,0,0,0 打开新短信上报；③ 单片机收到 +CMTI 后用 AT+CMGR 读取内容；④ 发送用 AT+CMGS 并以 Ctrl+Z 结束；⑤ 走 LuatOS 而非 AT 时改用 sms 库。参考文档：https://docs.openluat.com/osapi/core/sms/

34. Air8201G 的 485 无法读取，gpio.set(65,0) 回读恒为 1，怎么办？

解答： 结论：先把 DE 的 64、65 两个脚都拉高试（原厂建议）；回读恒为 1 通常是该脚不是普通可写 GPIO（AGPIO/电源域脚）或已被别的功能复用。说明：LuatOS 的 gpio.set 只对普通 GPIO 生效。AGPIO 属于低功耗域引脚，输出能力与读写行为跟普通 IO 不同，可能出现“写了不变、读了恒 1”；另外如果该脚被 4G、USB 等功能占用，写操作会被忽略。485 半双工还有时序要求：DE 拉高后要等最后一个字节真正发完才能拉低，否则末尾字节会被截断。处理步骤：① 按原厂建议把 DE(64)、DE(65) 同时拉高试；② 先用 gpio.setup(65, 1) 明确设为输出，再 gpio.set；③ 查 8201G 原理图确认 65 号脚是否为 AGPIO 或复用脚；④ 仍不行把引脚定义与实测波形发技术支持确认。参考文档：https://docs.openluat.com/air8201/hardware/

35. Air820UG 的差分升级包现在是在这里制作吗？

解答： 结论：是，Air820UG 的差分升级包在当前对接的 OTA 渠道里制作。说明：差分包必须“基版本 → 目标版本、同号固件”配对生成，不能随意拼；模块升级时会校验基版本号与固件号，不匹配就拒绝应用差分包，退回整包升级。所以做差分包前一定要确认现网设备的实际版本，多版本并存时按版本分别建任务。处理步骤：① 统计现网设备的当前版本分布；② 在 OTA 平台创建升级任务时选择差分方式，并按基版本分别生成；③ 先小批量验证（重点看升级后能否正常启动、版本号是否变化）；④ 确认无误再全量。参考文档：https://docs.openluat.com/osapi/core/fota/

36. Air8000 的 WIFI 侧固件在哪里下载？更新也是用模块 USB 接口吗？

解答： 结论：WiFi 侧固件在 Air8000 的 WiFi 升级文档里下载，更新同样走模块的 USB 接口。说明：Air8000 是“4G 主控 + WiFi 从机”的双芯片结构，WiFi 侧是独立固件，与主控的 LuatOS 固件分开升级，两者通过 airlink 主从通信。升级时通过主控的 USB 口进入特定模式，由工具把包透传给 WiFi 芯片；升级过程中不要断电，否则可能变砖需要返修。处理步骤：① 打开 WiFi 升级文档，核对当前 WiFi 固件版本与对应包；② USB 接主控口，按文档进入升级模式；③ 升级完成重启，看日志里 WiFi 版本号是否变化、airlink 是否正常建链。参考文档：https://docs.openluat.com/air8000/luatos/app/updatwifi/update/

37. Air724UG 固件从 V2044 升级到 V2052，代码需要改吗？

解答： 结论：硬件没换就不需要改代码，直接烧 V2052 即可；但升级前建议先看更新记录里有没有行为变更，并在样机上完整跑一遍。说明：同一平台内的 V20xx 版本演进总体保持 API 兼容，风险集中在三处：① 固件号变了导致脚本区/文件系统区大小变化，装不下就启动失败；② 个别库的默认行为调整（例如关闭 mbedtls 调试日志、改 uart 接收阈值）；③ 分区变化导致 fskv 或文件系统里的旧数据需要重建。处理步骤：① 对比两版的固件号与脚本区、文件系统区大小；② 在样机上烧 V2052，跑一遍主流程与 OTA；③ 版本跨度大时先备份 fskv 里的关键数据（如设备配置、SN）；④ 批量前留可回退的旧固件。参考文档：https://docs.openluat.com/air724ug/

38. 合宙 Lite 屏是否支持 USB 摄像头 AI 推理（0.5T 小模型）？

解答： 结论：合宙现有方案对本地 AI 推理支持有限，0.5T 级别的小模型建议用带 NPU 的平台（如 RK 系列）。说明：LuatOS 侧的能力集中在显示、联网与外设控制，没有 NPU 也没有推理框架；Air8101 之类虽然有 UVC 取图与 JPEG 解码，但那是“采集与显示”，不是“跑模型”。端侧推理要么上带 NPU 的 SoC，要么把图片传云端推理再把结果下发，两条路的成本与实时性差别很大。处理步骤：① 先明确是“本地实时推理”还是“允许上云、有延迟”；② 本地实时 → 选带 NPU 的平台，合宙方案只做取图、显示与联网；③ 可上云 → 合宙方案取图 + 4G 上传，云端返回结果，整体成本更低。参考文档：https://docs.openluat.com/air8101/product/

39. SN 监测中 Air780E 等设备的串口 airlink 出现残帧、解析器失步，如何解决？

解答： 结论：这条日志说明 airlink 的大帧在 UART 上丢了字节被判残帧、解析器随后超时清空重同步，属链路层丢字节后的自愈；V2056 已针对性修复，先升级固件。说明：V2056 更新记录里有三条直接相关：“fix: airlink, 从机UART帧间间隙按帧长自适应, 修复背靠背发帧致主机RX overrun→解析器失步”“fix: airlink, uart_rx_buffs 加互斥锁，修复串口读旧数据竞态”；更早的 V2054 还有“主机UART解析器残帧吞帧失步修复，消除下载截断/链路超时”。所以先升到 V2056，两侧主从都要升。处理步骤：① 主控与从机固件都升到 V2056；② 若仍有残帧，降低波特率或缩短串口线验证是否改善（硬件层面）；③ 抓完整日志（残帧前后的字节数、间隔）给技术支持定位。参考文档：https://docs.openluat.com/osapi/core/airlink/

40. 合宙产品有没有带外壳的套餐？只买板卡是什么价格？

解答： 结论：有“屏 + 外壳”的整机套餐，也有单独 PCBA；板卡价格看合宙淘宝店铺的分类页。说明：合宙的整机方案（带屏、带外壳）主要面向门禁、快递柜、自助终端这类场景，按整机出货，外壳与结构件随整机配；开发阶段买单板或 PCBA 更灵活，外壳可以后期再配。价格随配置（屏尺寸、是否带 4G、接口多少）差异很大，文档站不作为报价来源。处理步骤：① 先定配置：屏尺寸与分辨率、联网方式（4G/WiFi）、需要的接口；② 在淘宝店铺对应分类看公开价；③ 批量采购与开票走商务流程（见采购开票那条）。参考文档：https://docs.openluat.com/air8606/

41. Air780EX2 的原理图及 PCB 封装打不开？

解答： 结论：模组内部的原理图不公开；对外提供的是硬件手册、引脚定义、PADS 封装与参考设计，打不开多半是文件格式或软件版本问题。说明：模组（尤其含射频前端与屏蔽罩的方案）不公开内部原理图是行业惯例，涉及射频匹配与 BOM 保密。二次开发真正需要的是：引脚定义与复用表、封装库（PADS/AD/立创）、参考设计原理图与 Layout 注意事项，这些都在型号的 product 目录下。常见的“打不开”是 PADS 文件需要 PADS 或转换工具、AD 需要对应版本，压缩包没解压也会报错。处理步骤：① 到型号的 product 页下载封装与参考设计；② 确认解压完整、软件版本匹配（PADS 用 PADS 或转换器）；③ 仍打不开把文件名与报错截图发给技术支持换格式。参考文档：https://docs.openluat.com/air780ex2/product/

42. Air780EGH 的定制 24/124 号固件能加到正式固件序号里吗？

解答： 结论：已经进了正式序号——V2056（2026.11.05 发布）正式新增 24/124 号固件，EC7xx 系列各型号的固件页都能下到。说明：V2056 更新记录第 3 条原文：“add: luatos, 新增24/124号固件，在13号固件的基础上，去掉LCD、TP、LVGL、U8G2、字体一些UI相关的功能，然后将文件系统区从 512KB 扩到 768KB”。也就是说这套“不要屏、文件系统更大”的组合已从定制固件变成正式固件号：脚本区 512KB、文件系统区 768KB，其余能力与 13/113 号一致。处理步骤：① 到对应型号的固件页下载 V2056 的 24/124 号固件；② 核对脚本区与文件系统区是否满足你的资源需求；③ 量产包里的固件号同步改成 24/124，并注意差分升级只能在同号之间做。参考文档：https://docs.openluat.com/air780epm/luatos/firmware/780ehm_version/

43. 合宙 Air8607 是否支持电阻屏？

解答： 结论：支持，电阻触摸可以用，触摸 IC 为 NS2009（I2C 接口）；后续可安排硬件设计。说明：电阻屏与电容屏的差别在触摸控制器。NS2009 是 I2C 接口的电阻屏控制器，四线触摸的 X+/X−/Y+/Y− 直接接它；XPT2046 则是 SPI 接口——换控制器等于换总线，软件驱动要跟着改。Air8607 平台（Air1603）的触摸一般走 I2C，与其他 I2C 器件共用总线时要先确认地址不冲突（NS2009 地址固定，容易和别的器件撞）。处理步骤：① 确认屏的触摸控制器型号（NS2009 还是 XPT2046）；② 接法：I2C 的 SDA/SCL 加中断脚，四线触摸接 X/Y 四个脚；③ 用 tp 库选对应驱动并校准；④ 需要官方出电阻屏方案时联系硬件对接排期。参考文档：https://docs.openluat.com/air8607/product/

44. 合宙模组采购/开票流程怎么走？

解答： 结论：流程是“提供开票信息 → 合宙出合同 → 盖章回传 → 付款 → 回传水单 → 安排发货与开票”。说明：开票信息需要九项：单位名称、地址、税号、开户行、账号、电话、行业类别、IOT 账号、邮箱。信息不全是合同与发票被退回的最常见原因；对公付款后要回传银行水单，财务才能对账开票。专票与普票的抬头、税率要求不同，签合同前先确认好。处理步骤：① 把上述九项信息整理成一段发对接销售；② 收到合同后核对型号、数量、单价、税率再盖章回传；③ 付款并回传水单；④ 收货后核对发票信息与实物型号。参考文档：https://docs.openluat.com/

45. Air780EHT 模组采购 50 套如何下单？

解答： 结论：50 套走正常小批量流程：提供开票信息 → 合宙发合同 → 盖章回传 → 付款 → 安排发货。说明：Air780EHT 目前没有独立的文档目录，选型与规格以选型页和销售确认为准，下单前建议先索取规格书核对频段、封装与工作温度。50 套属小批量，是否有现货、交期多久要直接问销售，文档站不承载库存与交期信息。处理步骤：① 准备开票信息（单位名称、地址、税号、开户行、账号、电话、行业类别、IOT 账号、邮箱）；② 与销售确认型号、数量、单价与交期；③ 收合同后核对盖章回传；④ 付款回传水单后等发货。参考文档：https://docs.openluat.com/