常见问题 - 2026-10-31

数据日期：2026-10-31

1. AIR780EX2T的PWRKEY和RESET_N时序图/数据手册在哪里获取？

解答： 结论：Air780EX2T 没有单独的数据手册，它的 PWRKEY / RESET_N 时序直接看 Air780EX2 产品页给出的资料入口，再对照 Air780EPM 硬件文档里的时序章节；PDF 手册对时序只有简短描述，真正能用的图都在 docs 站上。说明：Air780EX2 与 Air780EX2T 是同一套硬件，前者对应 LuatOS 二次开发、后者对应 AT 指令；官方明确说明 Air780EX2 与 Air780EPM 管脚重合部分的功能和用法完全一致，所以不再单独整理一份二次开发资料。上电、下载、复位这几张关键时序图（PWRKEY 接地与不接地两种上电方式、上电下载、复位）在 Air780EPM 的「上电/下载/复位/WAKEUP 时序」页，PWRKEY 和 RESET 的电平、持续时间另有专门页面。处理步骤：① 先到 Air780EX2 产品页确认管脚图和参考设计；② 打开时序页，按自己的 PWRKEY 接法（接地或不接地）选对应的上电图；③ 再核对 PWRKEY / RESET 单页的电平与拉低时间要求；④ 下载一律按 USB 下载设计，不要依赖 UART 下载。参考文档：https://docs.openluat.com/air780ex2/product/、https://docs.openluat.com/air780epm/luatos/hardware/boottime/、https://docs.openluat.com/air780epm/luatos/hardware/pwrkey/

2. Air8000A模组GNSS无输出、PIN64(GNSS_VCC)一直为0V是什么原因？

解答： 尚未解答

3. Air8000的W系列（如Air8000W）是否支持GNSS？8380主控是否带GNSS？

解答： 尚未解答

4. 8603/8603M1的以太网口能否作为上联口接入交换机、做内网UDP收发并静态配置IP走MQTT？

解答： 结论：8603 / 8603M1 现有的 RJ45 只能当「下联口」用，给摄像头这类外设供网，不能当上联口去接交换机；要上下联两个网口，得等带双网口的 8606。说明：8603 的以太网不是主控直出的 MAC，而是 4G 模组侧（Air780EX2）+ SPI 以太网芯片 CH390H + RJ45 的组合，整条链路和电源都由 4G 侧管理，必须配合网络转发固件，才能把 RJ45 上挂的 IPC 数据经 4G 送出去。RJ45 不提供 PoE，摄像头要单独供电；W 系列（WiFi 版）不默认继承这套能力。至于「静态配 IP + 走 MQTT」，那是业务层的事，配好网卡与 mqtt 参数即可，和这个网口能不能上联是两件事。处理步骤：① 先确认手里的固件是带转发能力的版本，否则 RJ45 不通；② 摄像头接 RJ45，业务数据仍走 4G 出口；③ 需要真正把设备接到现场交换机、由交换机分配地址，请评估 8606 或外加路由器。参考文档：https://docs.openluat.com/air8603/

5. 接摄像头的串口能否当普通串口使用？

解答： 尚未解答

6. 8603是否支持HDMI直接输出？

解答： 结论：不支持直接输出 HDMI，必须外接 HDMI 转换板。说明：8603 的主控（Air1603）输出的是 RGB 并口，板上给的是 50PIN 的 RGB 屏接口；HDMI 是 TMDS 差分信号，两者电平与协议都不一样，中间必须有转换芯片或成品转换板，没有「一根线直连」的方案。走转换板时还要注意两点：转换板只认它支持的分辨率与刷新率，选屏时就按转换板的规格定；转换板要单独供电，且和主控共地。处理步骤：① 确定目标分辨率与刷新率，别超过 1280×800 这个量级；② 选带 RGB 输入的 HDMI 转换板，核对线序与供电；③ 先点亮 RGB 屏确认主控侧正常，再接转换板；④ 出现花屏/闪屏优先查时钟与地线，而不是改主控配置。参考文档：https://docs.openluat.com/air8603/

7. 8606什么时候发布，是否带SIP功能、能否满足需求？

解答： 结论：官方当时的答复是 8606 预计两周内发布，并且带 SIP 功能，可以满足需求；具体发布时间以新品公告为准。说明：8606 相比 8603 的关键变化是双网口，支持上联和下联，正好补上 8603M1「RJ45 只能下联」的短板。SIP 能不能用，除了硬件通路，还要看固件里有没有打包 SIP 库与对应音频通道，所以样片到手后第一件事是确认固件版本，而不是先写业务代码。处理步骤：① 向商务确认样片与发布节奏；② 拿到样片先跑官方 SIP demo，验证注册、呼叫、挂断、按键；③ 双网口场景同时验证上联取地址、下联给外设供网；④ 量产前把 SIP 账号与网络参数固化到配置里。参考文档：https://docs.openluat.com/air8603/

8. 8607的最大允许供电电压是多少？是否支持24V？

解答： 尚未解答

9. 8607上的触摸屏（自行搭配的911芯片屏）无法使用、没有坐标，如何处理？

解答： 尚未解答

10. 是否有和780EPM P2P、带WiFi的型号？

解答： 结论：没有和 Air780EPM 完全 P2P（管脚、尺寸都能对上）又带 WiFi 的型号；要 WiFi 只能选 Air8000W，参考价 33 元，尺寸不一样。说明：Air780EPM 是 17.7×15.8×2.3mm 的 Cat.1 模组，Air8000W 是 22×22×2.3mm 的 WiFi+4G+蓝牙三合一 SoC，两者封装尺寸、管脚定义都不同，换型等于重画板子。原答复里说的「32 元」是早期口径，选型页现在标的是 33 元，以选型页为准。处理步骤：① 先确认结构空间能否放下 22×22mm；② 天线要重新评估：4G、WiFi、蓝牙三套天线，间距和净空都要留；③ 网络优先级用 exnetif 配（WiFi 优先还是 4G 优先）；④ 软件层把 socket/mqtt 的网卡名按 netdrv 方式适配，不要写死。参考文档：https://docs.openluat.com/SelectionGuide/SelectionGuide/、https://docs.openluat.com/air8000/

11. AIR780EPM软件模拟I2C的IO是推挽还是开漏，外部是否必须加上拉电阻？

解答： 结论：必须外部加上拉电阻，不要依赖模组内部上拉。说明：软件模拟 I2C 本质是用两个普通 GPIO 按 I2C 时序翻转电平，模组这一侧只负责把线拉低、靠外部上拉把线拉高，所以「有没有上拉」直接决定能不能通信。文档对 Air780Exx 系列的要求写得很明确：I2C 总线需要外部上拉、不要使用内部上拉。另外两个坑：上拉电源必须和外设供电是同一路，否则外设掉电时会把总线电平拽死；AGPIO 驱动能力弱，软件 I2C 尽量挑普通 GPIO。处理步骤：① 选两个普通 GPIO，避开已被占用的管脚；② SCL/SDA 各自上拉到与外设同一路电源（典型 4.7kΩ，线长或多外设时再下调）；③ 一个总线上挂多个外设时，每路各自上拉到各自的电源，别串联；④ 联网业务满载时用逻辑分析仪看波形，软件 I2C 受业务调度影响会抖。参考文档：https://docs.openluat.com/air780epm/luatos/hardware/i2c/、https://docs.openluat.com/osapi/core/i2c/

12. Air8781P的PIN12(GPIO26/AGPIO)能否用于控制外部模块使能？

解答： 结论：可以，GPIO26 在 Air8781P 上是 PIN12 的 AGPIO，3.3V 高电平有效，能用来控制外部模块的使能脚。说明：这个脚是 AGPIO，低功耗模式下可以保持状态，做外设使能很合适；但 AGPIO 驱动能力弱，只适合驱动使能脚、高阻输入这类轻负载，不要直接带继电器线圈或大电容。要特别注意：在 8781P 的出厂固件里，PIN12（GPIO26）默认被 I2C 复用成 SCL，如果板上还留着 I2C 外设，先确认这一路没被占用再改成 GPIO 输出。处理步骤：① 查 GPIO 复用表，确认 PIN12 当前复用状态；② gpio.setup(26, 1) 设为输出，再 gpio.set(26, 1) 拉高；③ 用万用表或示波器量实际电平与上电时序；④ 低功耗场景确认休眠后状态是否保持，必要时在唤醒流程里重新置位。参考文档：https://docs.openluat.com/air8781p/hardware/circuit/

13. Air8780V1/V2的PIN34、PIN35能否复用为GPIO18/GPIO19？

解答： 尚未解答

14. 固件烧录后能否锁定BL，仅允许OTA升级，禁止外部烧录和导出固件？

解答： 尚未解答

15. 接收不到485数据/串口报错如何处理？

解答： 尚未解答

16. 8607的视频转换工具/hzv编码播放问题，电脑模拟器能否播放hzv？

解答： 结论：视频转换工具看 HZV 协议文档页；AirMaster 能播放 hzv，PC 模拟器目前还没做 hzv 播放，8607 真机上可以正常播放。说明：HZV 是合宙自有的视频封装/编码格式，为 MCU 侧解码播放做的优化，和常见 MP4 不是一回事，所以「电脑上能播」和「模组上能播」不能互推。PC 模拟器没有内置 hzv 解码，用它验证播放只会得到「打不开」；真机走的是硬件解码通路，正常。处理步骤：① 按协议文档用转换工具把素材转成 hzv；② 文件放进 SD 卡或文件系统，注意目录与命名；③ 用 AirMaster 先在电脑上确认文件本身没转坏；④ 再上 8607 真机播放，分辨率与帧率别超过屏和解码能力。参考文档：https://docs.openluat.com/protocols/hzv/

17. CC库如何发送和接收DTMF？是否支持一次连续发送多个字符？

解答： 结论：发送用 cc.sendDtmf(sim_id, digit, duration_ms)，接收先 cc.dtmfRx(true) 再订阅 "CC_DTMF_RX" 事件；一次只能发一个按键，要连发多位就循环调用。说明：digit 只接受单个字符（0-9、*、#、A-D），duration 取 100~1000ms，不能传整串号码，也不认逗号分隔。发送是异步的，真正结果通过 "CC_DTMF_TX" 上报 (id, ok, code)，ok 只代表本端受理，不代表对端 IVR 已经响应。接收侧必须在 cc.init 之后、拨号或接听之前就打开，通话中再开会失败；事件回调拿到的是 table，里面有 e.event（dtmf / dtmf_end）、e.digit、e.session。两个接口都是 cc 核心库自带的，不需要额外引入其它库。处理步骤：① cc.init(0)，等 CC_READY；② 拨号并等到 CONNECTED；③ 逐键发送，相邻按键间隔不小于 duration，别一口气连发；④ 接收侧提前 cc.dtmfRx(true) 并订阅事件；⑤ 用 cc.DTMF_RX_VERSION 先探测固件是否带接收能力。参考文档：https://docs.openluat.com/osapi/core/cc/

18. 8783H是否支持SIP桥接模式及DTMF识别？

解答： 结论：支持，官方仓库里已经有现成工程：module/Air8783H/project/sip_cc_bridge_pcm（SIP 与蜂窝语音的 PCM 桥接）和 sip_cc_bridge_dtmf（在此基础上加双向 DTMF）；量产固件是否需要单独定制，要和 FAE 确认对应版本。说明：这两个 demo 的做法是在模组内部用 PCM 把 SIP 侧和 CC（蜂窝）侧的通话桥起来，再在桥上转发两个方向的网络按键；dtmf_bridge.lua 负责按键队列（逐键发送、间隔、完成确认、超时取消）。用到的接口就是 cc.sendDtmf / cc.dtmfRx 与 voip.sendDtmf / voip.on("dtmf")，另外依赖 script/libs 下的 exsipclient.lua、exsipproto.lua 两个公共库，下载时要一起带进工程。处理步骤：① 取完整工程目录与两个公共库，保持 Lua 文件名不变；② 改 config.lua（SIP 账号、呼叫目标、DTMF 参数、网卡与看门狗）；③ 先验证 SIP 注册与单向呼叫，再验证双侧按键透传；④ 桥接类接口只在对应的桥接固件里存在，用 cc.AUDIO_MODE_BRIDGE_PCM 一类常量探测，别在普通 VoLTE 固件上试。参考文档：https://gitee.com/openLuat/LuatOS/tree/master/module/Air8783H/project/sip_cc_bridge_dtmf、https://docs.openluat.com/osapi/core/cc/

19. 8603测试USB Host读U盘报“test unit ready too much times”后设备断开，是否有补丁？

解答： 尚未解答

20. 8603以太网口是否可以只接以太网、不做4G，是否支持以太网上传下载？

解答： 结论：不行。8603 的 RJ45 是挂在 4G 侧的下联网口，数据出口仍然是 4G；只接以太网、不开 4G 就没有出口，而且下载回来的数据 8603 这一侧也处理不了。说明：硬件路径是 Air780EX2（4G）+ CH390H（SPI 以太网）+ RJ45，整条以太网链路和 LAN 电源都由 4G 模组管理，并且需要网络转发固件配合，作用是把 RJ45 上挂的 IPC 数据经 4G 送出去。所以「以太网上传」本质上还是 4G 上传；「以太网下载」这条反向通路，当前固件不具备。处理步骤：① 确认固件是带转发能力的版本；② 摄像头接 RJ45 并单独供电（RJ45 不带 PoE）；③ 业务数据走 4G 上行；④ 需要真正的以太网上行/下行，评估 8606 双网口方案。参考文档：https://docs.openluat.com/air8603/

21. 8607/8603是否提供大屏UI应用示例代码？

解答： 结论：示例代码在 gitee 的 LuatOS 仓库 module/Air8607/project 目录下，里面有几十个大屏 UI 工程可以直接参考；8603 与 8607 同属 Air1603 大屏系列，UI 代码可以复用。说明：这个目录按场景组织，既有 factory 出厂工程，也有家电面板、储能监控、仪表盘、点餐、电梯屏这类完整案例，还有 jf_airui_showcase、widget_gallery 这种专门演示 AirUI 组件的工程。第一次上手建议先跑组件演示工程，把屏、触摸、字体确认没问题，再往自己的界面里搬。处理步骤：① 克隆仓库后进入 module/Air8607/project，按需求挑最接近的工程；② 用 Luatools 建工程，把选中的目录下 Lua 文件连同依赖库一起加进去；③ 先刷出厂固件确认硬件正常，再跑示例；④ 改界面时只动业务层，底层驱动与分区别乱改。参考文档：https://gitee.com/openLuat/LuatOS/tree/master/module/Air8607/project

22. 十路电瓶车充电桩用哪个型号性价比最高？

解答： 尚未解答

23. 给初高中孩子选带继电器、可蓝牙控制、带屏的USB开发板推荐哪款？

解答： 结论：推荐 Air8000 系列（4G+WiFi+蓝牙三合一，能带 RGB 屏、能用 AirUI 做界面）；继电器一般不在官方板上，需要外接继电器模块用 GPIO 驱动。说明：Air8000 系列有核心板和整机开发板两种形态，USB 供电调试，屏幕走 RGB 接口，界面用 AirUI 写，对孩子来说「拖控件 + 写几行 Lua」比啃驱动友好得多。蓝牙是模组自带能力，功率固定不可调（约 6dBm），室内十来米的控制距离够用。要注意继电器是感性负载，开发板上要用带光耦隔离的继电器模块，GPIO 只出控制信号。处理步骤：① 选 Air8000 系列核心板或开发板；② 外接带隔离的继电器模块，GPIO 输出高/低电平控制；③ 用 AirUI 做一个开关页面；④ 蓝牙侧参考 ble 库 demo 做配网与控制；⑤ 让孩子先从「点灯 → 点继电器 → 手机控制」三步走。参考文档：https://docs.openluat.com/air8000/product/、https://docs.openluat.com/osapi/core/ble/

24. 字库优化版本何时发布？驱动已安装但下载固件失败怎么办？

解答： 结论：官方答复字库优化版本下周初发布；至于「驱动装好了但下载固件失败」，绝大多数不是驱动问题，而是串口没打开/没勾选，或者线材与供电不达标。说明：Luatools 下载全程独占串口，只要串口被别的工具占着（串口助手、另一个 Luatools 窗口、IDE 的串口监视器），握手就会失败；设备管理器里能看到口，不代表能打开。另一类常见原因是 USB 线只有充电线芯、或者 USB 口供电不足，表现为刚连上就掉、反复重试。处理步骤：① 关掉所有占用串口的软件；② Luatools 里重新扫描端口，确认勾选的是模组那一路；③ 换一根确定能传数据的 USB 线、换主板直出的 USB 口；④ 用外部电源供电，确认电流够（下载峰值电流不小）；⑤ 仍然失败再查 BOOT 键操作与驱动签名。参考文档：https://docs.openluat.com/common/Luatools/

25. 780EPM供电后没有COM口出现，如何处理？

解答： 尚未解答

26. 510W模组焊接后发烫，是否与天线端口对地短路有关？

解答： 结论：有关。当天线 PAD 对地短路时，模组外部必须加隔直电容，否则供电会顺着天线管脚灌进模块，表现就是焊接后发烫。说明：隔直电容串在天线通路上，作用是「射频过得去、直流过不来」，把直流挡在模块天线管脚之外。一旦天线 PAD 因为馈线选型、焊接搭锡等原因对地短路，又没有隔直电容，模块的射频管脚就被直接短到地，通路上形成直流通路，电流大、发热明显，时间长了会伤器件。处理步骤：① 断电后用万用表量天线 PAD 对地电阻，正常应为高阻，接近 0Ω 就是短路；② 检查焊盘有没有搭锡、屏蔽罩有没有压到；③ 加上隔直电容后复测电阻与温升；④ 同时排查 VBAT 反接、稳压输出与整体焊接，排除发烫的其它来源。参考文档：https://docs.openluat.com/air510w/product/

27. 已经烧录到模块里的程序能否上传反编译到别的项目使用？

解答： 尚未解答

28. 用trae或CodeBuddy等工具开发合宙项目是否可行？需要安装哪个Lua插件？

解答： 结论：可行，合宙内部近期更多在用 CodeBuddy；不装 Lua 插件也能正常开发。说明：这类 AI 编程工具本身不带合宙的接口知识，最容易犯的错是「写出一个文档里根本没有的 API」，或者把对象式方法写成 mod.xxx。解决办法不是换工具，而是把合宙文档索引挂上去（MCP 或项目规则文件），让它先查再写；生成完的代码一定要在真机上跑一遍，别只信静态检查。处理步骤：① Lua 语法高亮插件可选，装了读代码更舒服；② 按官方说明挂上文档 MCP 或把 osapi 页面放进项目规则；③ 让它先读对应库的文档页，再动手写；④ 每个接口在真机上验证，尤其注意返回值和失败分支。参考文档：https://docs.openluat.com/ai/mcp_cli/

29. 8607的触摸屏驱动初始化时报错/触摸事件无响应，如何配置？

解答： 尚未解答