常见问题 - 2026-11-08

数据日期：2026-11-08

1. Air1603 不支持 pm.lastReson() 接口吗？

解答： 结论：Air1603 上调用 pm.lastReson() 目前拿不到有效的重启原因，已提 issue 跟踪（单号 IKTQJO）。说明：pm.lastReson 在 pm 核心库中确实注册过，但它本身只做转发，真正的复位原因由底层 SoC 适配层提供。Air1603 上实测调用会打印 luat_pm_last_state 66:not support yet，即 Air1101 平台的适配层尚未实现这部分——接口在、数据没有，和“文档里没这个接口”是两回事。问题已登记在 IKTQJO，测试固件为 V1030。处理步骤：① 先确认用的是最新 Air1603 固件，接口能否返回数据与固件版本相关；② 临时需要判断重启来源时，看启动日志与看门狗打印，或读外部看门狗状态；③ 需要精确区分上电、软件重启、看门狗复位，关注 issue IKTQJO 进展，等底层适配补齐后再依赖它。参考文档：https://docs.openluat.com/air1603/luatos/app/common/wdt/ · https://docs.openluat.com/osapi/core/pm/

2. 8603 的开发流程是怎样的，需要安装哪些软件？

解答： 结论：Air8603 主控是 Air1603，用 LuatOS + AirUI 写 Lua 脚本开发，不需要搭 C 编译环境；电脑侧只装 Luatools 和板载 USB 转串口芯片的驱动就够了。说明：屏、触摸、声音、RS485 和联网都已在板上，应用层只写业务逻辑与界面，改完直接烧录、看日志迭代，不用编译。要注意 4G 型号（M1～M5）板载的 Air780EX2 是整机定制配置，只能烧 Air8603/Air8605 专用 4G 固件，烧 Air780EX2 公版固件会连不上网。处理步骤：① 安装 Luatools；② 安装板载 USB 转 UART 芯片驱动，Type-C 的 USB2 口接的就是它，设备管理器里应出现串口；③ 用能传数据的 Type-C 线连 USB2，选端口、勾“通用串口打印”、内核按 Air1603 选 .soc；④ 参照出厂工程 module/Air8603/factory 改界面与业务；⑤ M 系列另外烧专用 4G 固件。参考文档：https://docs.openluat.com/air8603/ · https://gitee.com/openLuat/LuatOS/tree/master/module/Air8603/factory

3. Air8603/Air8605 4G 版网口能否用于局域网？

解答： 结论：不能。Air8603/Air8605 的 4G 版网口是“对外供网”的出口，用来给现场 IPC 这类设备提供 4G 上网通道，不是让主板自己接入局域网的口。说明：这个网口经 CH390H 挂在 Air780EX2 的 SPI 下，由 4G 侧的转发固件管理，主控 Air1603 不直接管它；W 版默认没有这套电路。要让主板自身通过网线联网，应选 Air8606：它在主控侧新增了 WAN（J24），同时保留 4G 侧 LAN（J15），一个 LAN 一个 WAN，用途分开。处理步骤：① 现有 8603/8605 只按“4G 出口”规划，别接交换机当 LAN 用；② 主板自身要有线接入，直接选 Air8606；③ 不要因为“板上两套电路都有”就认为能自动桥接或在 WLAN/有线之间无缝切换，出口优先级、可达性判断都要自己做。参考文档：https://docs.openluat.com/air8606/

4. 8603 网口默认 IP 是多少，能否修改？

解答： 结论：默认 IP 是 192.168.4.1（网关同址），要改必须改 4G 侧的源码重新烧录，没有现成配置项或 AT 指令能改。说明：这个网口不在 Air1603 主控上，而是 Air780EX2 加 CH390H 组成的 LAN；IP、网关、掩码写在 780EX2 工程 lan_ch390.lua 里，以常量形式定义后由 netdrv.ipv4() 下发，所以改 IP 等于改代码再打包。处理步骤：① 打开 module/Air780EX2/project/Air8603_Air8605_4G_Air780EX2/lan_ch390.lua；② 改 LAN_IP / LAN_GW，掩码一并核对，避开现场已有网段；③ 重新打包烧到 4G 模组；④ 改完同步确认接入设备的 DHCP 分配范围与静态 IP，避免上下位机不在同一网段。参考文档：https://gitee.com/openLuat/LuatOS/blob/master/module/Air780EX2/project/Air8603_Air8605_4G_Air780EX2/lan_ch390.lua

5. Air8607A 下载烧录时 Reset 一定要接吗？没有 RST 口的 USB 串口能否使用？

解答： 结论：建议直接用合宙的烧录小板（带复位控制）。只接 TX/RX/GND 的通用 USB 转串口小板，多数情况下只能看日志，进不了可靠下载。说明：Air8607A 取消了板载 USB 转串口，下载和日志都走 J2 这个 5PIN 口：1 VBAT、2 GND、3 DBGUART_RXD、4 DBGUART_TXD、5 1603_RESET。第 5 脚是给下载器执行复位时序用的，Luatools 靠它把模组拉进下载模式；不接就只能靠手动断电卡时机，成功率很低。处理步骤：① 用合宙下载调试小板加简易夹具接 J2；② 逐脚核对针序、TX/RX 交叉和共地；③ 确认小板电源脚不与主板其他电源并接；④ 设备管理器确认串口后按 Air1603 选内核烧录；⑤ 量产阶段改成带定位和压接的夹具，把复位控制做进去。参考文档：https://docs.openluat.com/air8607a/

6. 8780/8783H 能否定制 Type-C 母口平焊、外接 IPEX 天线、去掉板载天线与塑料座子？

解答： 结论：可以在 8783H 基础上改：Type-C 改母口平焊，或去掉板载天线改用 IPEX 外接；建议先打样测试，确认没问题再下单付款，合宙不收定制费。说明：这属于定制与商务事项，技术上有两点要盯住：一是把板载天线改成 IPEX 会动射频通路（匹配网络和 BOM 都要调），必须实测驻波、灵敏度和实际吞吐；二是 Type-C 改平焊要改焊盘与结构，插拔强度和装配公差都得在样机上验证。处理步骤：① 把改动点列成清单（接口形态、天线路径、需删除的器件）交对接销售；② 先做样品，测射频、充电与数据、结构装配；③ 样品通过后再批量下单；④ 定型后同步更新 BOM，避免后续批次混料。参考文档：https://docs.openluat.com/air8783h/

7. AIR700ECH 是否支持 PCM/I2S/DAC 输出？

解答： 结论：支持 I2S，但没有内置 DAC。Air700ECH 主芯片不集成 Audio Codec、也没有音频 DAC，要出声音必须外挂 ES8311 这类 Codec，走 I2S 传数据、I2C 配寄存器。说明：EC7xx 这一代 4G 模组（Air780Exx、Air8000 系、Air700ECH）主芯片都不带 Audio，只有 Air780EHV 内置了 ES8311。Air700ECH 属于“支持 Audio 但未内置 Codec”这一档，Flash/RAM 配置够，可以正常做播放和录音；外置 Codec 时 I2S 与 I2C0（PIN25/54）都要接。处理步骤：① 硬件按官方 700ECH 音频参考设计接 ES8311；② 先用 LuatIO 生成 pins 配置，把 I2S 与 I2C0 的 pinmux 配好；③ 软件侧用 audio（或 audio_v2）库做播放与录音；④ 喇叭必须外加 PA，Codec 输出驱动不了喇叭，PA 使能脚要参与 pop 音控制。参考文档：https://docs.openluat.com/air700ech/luatos/hardware/audio/

8. 8607/8603 摄像头如何接线，是否有接线图片？

解答： 尚未解答

9. 8607 屏幕狂闪、疑似烧板，是什么原因？

解答： 尚未解答

10. 8605 待机时偶发重启（复位原因 0，几小时一次），如何排查？

解答： 尚未解答

11. 8605 的 192.168.4.1 能否改为 192.168.1.1？

解答： 结论：能改，但要改 4G 侧（Air780EX2）的源码重新烧录，没有配置项或 AT 指令可以直接改。说明：Air8605M 的 RJ45 经 CH390H 挂在 Air780EX2 的 SPI 下，LAN 的 IP、网关、掩码写在 780EX2 工程的 lan_ch390.lua 里，主控 Air1603 一侧改不了；Air8605W 默认没有这套电路，不涉及该问题。处理步骤：① 取 module/Air780EX2/project/Air8603_Air8605_4G_Air780EX2/lan_ch390.lua；② 把 LAN_IP / LAN_GW 改成 192.168.1.1，掩码按现场规划；③ 重新打包烧到 4G 模组；④ 改完核对接入设备的静态 IP 与上位机访问地址，避免与原网段冲突；⑤ 现场已有设备时，改 IP 前先确认没有依赖 192.168.4.x 的固定配置。参考文档：https://gitee.com/openLuat/LuatOS/blob/master/module/Air780EX2/project/Air8603_Air8605_4G_Air780EX2/lan_ch390.lua

12. 8603 扩展屏上菜单和按键字体太小，V3.0.8 无升级版本可正常显示，如何解决？

解答： 尚未解答

13. 8607 上常见中文字不显示，有什么解决办法？

解答： 结论：这是字库覆盖不全，不是编码坏了。解决办法是做一份完整字库放到 SD 卡（或外置 Flash），基础字库仍留在固件里保证速度，缺字时再从外置字库取。说明：Air1603 平台推荐 hzfont 矢量字库：既能用固件内置字库（约占 1.7MB Flash），也能直接从 /sd/xxx.ttf、/little_flash/xxx.ttf 加载。Air8607 板载 SD 卡座（SPI1，CS=GPIO8，SD_EN=GPIO74 拉高供电），正好用来放完整字库；内置小的保证启动和常用界面，外置的补生僻字，是空间和速度折中的常见组合。处理步骤：① 先排除编码问题：脚本存 UTF-8，字符串不要用 GBK 转码；② 把完整 TTF 拷到 SD 卡根目录；③ 确认 SD 挂载成功（SD_EN 拉高、fatfs 挂上）再加载字体；④ 在缺字的界面逐页复验；⑤ 完全不能加 SD 卡时，改用外置字库芯片方案（AirFONTS_1000）。参考文档：https://docs.openluat.com/osapi/core/hzfont/ · https://docs.openluat.com/air1603/luatos/app/multimedia/ui/hzfont/

14. 9 寸屏换成 10.1 寸屏，UI 和代码是否需要修改？

解答： 结论：分辨率相同（都是 1024×600）时 UI 不用改、代码也不用动；分辨率不同的才需要改显示参数并重排界面。说明：Air8607 支持 7 寸、9 寸、10.1 寸 RGB565 屏，这几种尺寸常见规格都是 1024×600，最高可到 1280×800。AirUI 做的是自适应布局，屏幕物理尺寸变化本身不会破坏界面；真正要按新屏规格核对的是 LCD 初始化参数——分辨率、行场时序、RGB 顺序、背光极性与电流，参数不对会花屏、画面偏移或白屏。处理步骤：① 先核对新屏的分辨率、接口（50PIN、RGB565）与触摸 IC 型号；② 分辨率相同则直接换屏，重点确认背光电压电流和触摸驱动一致；③ 分辨率不同则改 lcd 初始化参数，并按新分辨率检查关键页面；④ 触摸坐标方向与横竖屏设置一起复验。参考文档：https://docs.openluat.com/air8607/product/

15. 8607 屏幕能接多少 IO，外壳是否有 86 盒/壁挂安装方案？

解答： 结论：Air8607 的屏走 50PIN RGB565 接口，占用的是固定复用脚（含背光 PWM3/GPIO13、触摸 I2C1 加 TP_RST/TP_INT），除此之外没有再引出通用扩展排针；86 盒形式后续会做，目前还在调试，壁挂形式尚未考虑。说明：如果外设接口不够，应选 Air8607A——它多引出 UART3、SPI1 和 PWM1/GPIO65（J110 16PIN 扩展口），代价是取消板载 SD 卡座和 USB 转串口。结构上 8607 是 45×52.5mm、8607A 是 45×50mm，相差 2.5mm，机壳与安装孔必须按实际板长留余量，别拿旧图套新板。处理步骤：① 按原理图列出屏接口占用的引脚，避免复用脚被重复分配；② IO 不够时换 8607A 或做 IO 扩展；③ 结构件以实物板长、安装孔位置为准；④ 86 盒与壁挂需求走商务确认时间点，别按已有方案排产。参考文档：https://docs.openluat.com/air8607/software/debug/ · https://docs.openluat.com/air8607a/

16. F402J 是否为合宙的 4G DTU？

解答： 结论：不是。合宙没有销售过这个外形和型号的产品，建议先确认来源，避免把非合宙产品按合宙口径做技术支持。说明：合宙的模组与整机型号命名有固定规则（Air 加数字），在售产品在文档中心都有对应目录和产品页；查不到基本可以判定不属于合宙在售产品，可能是集成商二次封装或贴牌。这类设备里即使用了合宙模组，整机层面的硬件、固件、售后也不由合宙负责。处理步骤：① 拍下丝印完整型号与铭牌留存；② 在文档中心按型号检索，确认是否存在对应产品页；③ 向采购或供货方索取原厂型号与出厂证明；④ 确认是第三方产品后，整机问题找原供应商，合宙侧只能提供其中所用模组的公开资料。参考文档：无（属商务与来源核实事项，请通过采购渠道或对接销售确认）。

17. 1603 要用 SPI 与 4G 模组通信，必须选 AIR780ER3 吗？有硬件资料吗？

解答： 尚未解答

18. 有可 4G 联网、带 485 接口和 GPIO 控制的模块推荐吗？

解答： 尚未解答