常见问题 - 2026-11-04

数据日期：2026-11-04

1. 批量工具/新的批量烧录工具什么时候更新支持？

解答： 结论：本周内更新，测好后通知，11 月 5 日可以拿到支持新版固件的批量烧录工具。说明：批量烧录（多路下载）工具的型号支持跟固件包的分区结构强相关，V2054 这类新固件出来后，工具要同步更新才能识别芯片、分区与校验方式；工具没更新时在夹具上通常表现为部分工位失败或下载后不启动，而不是全线报错，很容易被误判成夹具接触不良。处理步骤：① 先用单路 Luatools 烧一片样机，确认固件包本身没问题；② 11 月 5 日之后向对接 FAE 索取最新版批量工具，先看版本更新记录里有没有写新增型号；③ 用 2~3 片样机在夹具上小批量试烧并回读校验，稳定后再上整盘。参考文档：https://docs.openluat.com/common/Luatools/

2. Air8301工控板RJ45网口无法驱动，CH390的spi/cs/复位脚如何配置？

解答： 结论：Air8301 两路网口各一颗 CH390H，都挂在 SPI1 上，与板上 SPI NAND Flash 共用 SPI1_CLK/MOSI/MISO，靠三个片选区分；供电使能分别是 GPIO32（网口 1）与 GPIO33（网口 2）。说明：这块板最容易踩的坑是照抄官方以太网示例里的 pwrpin = 140。那是官方核心板的点位，Air8301 上 GPIO140 是 SPI NAND Flash 的电源使能，照抄会让 Flash 掉电、板子直接起不来。两路网口的片选写 SPI1_CS 与 SPI1_CS1，第三个片选 SPI1_CS2 归 Flash，任一时刻只能选中一个从设备。WAN/LAN 由代码配置，板上既没有跳线也没有拨码开关。处理步骤：① 按 netdrv 示例建两个 netdrv，pwrpin 改成 32/33，片选改成 SPI1_CS 与 SPI1_CS1；② 用 netdrv.ipv4 配静态地址，或 netdrv.dhcp 走上级分配；③ 要把网供出去，再叠 exnetif.setproxy 与 netdrv.napt；④ 若原理图上 CH390H 有独立复位网络，按 shouce 页原理图核对接到哪个 GPIO，没有独立复位则以供电上电复位为准；⑤ LINK/ACT 灯不亮先查链路层，两端设备都要上电。参考文档：https://docs.openluat.com/air8301/hardware/circuit/

3. Air8000W/8783H做SIP-CC桥接时，接通前几秒有杂音和断续、rx_lost增长如何定位？

解答： 尚未解答

4. 8605/Air1103播放MP4没有声音，能否通过Air1103 UART播放MP4音频？

解答： 结论：不能。Air1103 走的是 UART 语音通路，audio_v2 的 PCM 输出没法直接重定向到串口；经 UART 转一手会导致音画不同步，而且 DAC 路径在原理图上是空贴，底层需要改造。说明：8605 这类板子是 Air1602 加 Air1103 的组合，音频有两条独立通路：一条是 SoC 侧的 audio 库（走 codec/DAC 与 PA），一条是 Air1103 自己的语音通路。MP4 的音频轨由播放器在 SoC 上解码，只能经 audio 通路出声，跟 Air1103 没有关系，所以换 Air1103 出声这个思路本身走不通。处理步骤：① 播放视频前先确认 audio 通路能出声，播一段提示音验证；② 检查功放供电与使能脚是否正常；③ 只有通话与提示音才走 Air1103；④ 确实需要改音频路由，属于定制固件范畴，找 FAE 评估工作量与周期。参考文档：https://docs.openluat.com/air8784/product/air1103/

5. Air8783H除了支持SIP-CC桥接，还能否转发短信（如报警短信）？

解答： 尚未解答

6. 合宙4G模块（如Air780EX2）用在自己产品上做上网，是否需要重新做SRRC认证和入网认证？费用多少？

解答： 尚未解答

7. Air8607播放SD卡视频无法播放，视频格式怎么转换？分辨率/帧率有何要求？

解答： 结论：MP4 只支持 480×320、帧率不超过 10fps；大屏全屏播放用 HZV（1024×600@30 最稳）或 MJPEG，转换用 AirMaster。说明：Air8607 是 Air1603 的大屏最小系统板，LCD 是 50PIN 的 RGB565 接口，最高 1280×800。MP4 走受限解码，编码固定 H.264 Baseline、yuv420p、无 B 帧，超出参数转换工具会直接拒绝，不只是界面下拉框拦截；HZV 是 MJPEG 画面加 MP3 音频的专用容器，走硬件解码，能吃下更大的分辨率与更高帧率。处理步骤：① 用 AirMaster 的 HZV 转换器，分辨率按屏选（默认 480×320，预设最高 1024×600），帧率 10~30；② 源文件必须同时有音轨，否则转换失败；③ 转换完成先看校验是否通过，再拷到 SD 卡；④ 用 videoplayer 实测，掉帧先降帧率再降分辨率，同时确认 SD 卡读速。参考文档：https://docs.openluat.com/ai/airmaster/

8. Air8701/Air1103什么时候开卖，价格多少？1103能否单独购买？

解答： 结论：Air1103 不单独零售；Air8701 下周初开卖，价格本周末到下周初公布，目前尚未确定。说明：Air8701 是以 Air1103 为核心的 SIP 双工通话工业模组，默认都带 Air1103 与音频 PA：Air8701M 基于 Air780EHM，Air8701G 基于 Air780EGG，再按是否板载 16MB SPI Nor Flash（F）与贴片 SIM（S）分成 MF/MS/MFS、GF/GS/GFS。板载音频 PA 在 VBAT 4.2V 下可驱动 4Ω/2.5W 喇叭，回声抑制由 Air1103 完成。处理步骤：① 先拿 Air780EHM 或 Air780EGG 加 Air1103 评估 SIP 通话效果；② 量产按是否需要存 TTS/AirUI 素材选 F 版，按是否需要贴片卡选 S 版；③ 价格与交期找商务确认，不要按网页旧报价估。参考文档：https://docs.openluat.com/air8701/

9. Air780EHT用6V电池供电，DCDC降压最低多少V能正常工作，3.66V是否可行？

解答： 结论：3.66V 能稳定工作就可以用，但任何瞬间都不能低于 3.5V；4G 发射瞬间跌得太低会直接重启。说明：这类问题看平均值没有意义。4G 模组在发射突发时是脉冲式大电流，电池内阻、线材与走线电阻都会造成瞬时跌落，万用表读到的 3.66V 可能对应示波器上的 3.2V。模组在低压时会触发保护性复位，表现出来就是开机正常、一联网就重启。处理步骤：① 用示波器在模组 VBAT 引脚处抓发射瞬间的最低点，不要看万用表；② VBAT 就近并 220µF 以上电解电容加 0.1µF 陶瓷电容；③ 缩短加粗供电走线，DCDC 输出可抬到 3.8V 留余量；④ 加了余量仍重启，再查 PWRKEY 与 USB_BOOT 是否被误拉、复位脚是否受干扰。参考文档：https://docs.openluat.com/air780ehv/luatos/hardware/design/power/

10. Air780EHM的固件选型，2025年6月买的模块现在用最新固件可以吗？

解答： 结论：可以。固件与购买批次无关，2025 年 6 月前后买的 Air780EHM 一样能烧当前最新的 V2054；原答里的 38 版本以上就是这个意思的版本下限，现在直接用最新版即可。说明：同一型号的 .soc 面向的是芯片与分区，不区分生产批次。真正要留意的是脚本兼容性：新固件可能改了某些库的默认行为或资源占用，老脚本直接跑会出现功能异常，这类情况要回头看固件页的更新记录逐条比对，而不是急着换回旧固件。处理步骤：① 到固件页确认型号对应的 .soc，不要拿 Air780EPM 的包刷 EHM；② 烧录前把原固件与脚本各留一份备份；③ 用 Luatools 打开通用串口打印，看启动日志里的版本号确认真的烧进去了；④ 老脚本跑不通时对着更新记录找改动点。参考文档：https://docs.openluat.com/air780epm/luatos/firmware/780ehm_version/

11. Air8202G去掉贴片卡、焊接卡座后能否正常使用插拔流量卡？

解答： 结论：可以。贴片 SIM 与卡座是同一路 SIM 接口，二选一，改用卡座不影响功能；具体卡座方案与供货找对接人确认。说明：板上贴片卡和卡座共用 SIM_VDD/CLK/DATA/RST 四根线，不能同时插两张卡使用。改成卡座要注意两点：一是卡座脚序与贴片卡封装完全不同，属于改板而不是改焊；二是卡座一般带 SIM_DET 检测脚，脚本要处理插拔事件，否则只能开机时识别一次，热插拔后不会重新初始化。处理步骤：① 先确认目标型号是否已有带卡座的版本，能直接选型就不要改板；② 自行改板时按硬件手册的 SIM 电路接好 ESD 与上拉；③ 把 SIM_DET 接到可用 GPIO，脚本里做插拔重初始化；④ 插拔测试用不同运营商的卡各试一遍。参考文档：https://docs.openluat.com/air8202/product/

12. Air8000W进入BOOT下载模式USB无法识别怎么办？

解答： 结论：先排线材与 USB 口，再按「按住 BOOT 后上电」的顺序强制进下载模式；仍识别不到就按硬件查 USB 差分链路。说明：判断有没有真进下载模式，看设备管理器只出现 1 个下载口；出现 3~4 个口说明还在正常开机，此时点下载当然没反应。另外 USB_BOOT 在上电前不能被上拉到 VDD_EXT，否则模组会停在下载等待，表现同样是插上没反应。处理步骤：① 换一根确定能传数据的线，换主机后置 USB 口，关掉电脑蓝牙等 2.4G 干扰源；② 按住 BOOT 不放，再给 VBAT 上电，然后插 USB，看设备管理器枚举情况；③ 仍不枚举就查 D+/D- 是否接反、TVS 管结电容是否过大吃掉高速信号、焊点是否虚接；④ 把原理图与 PCB 提交图纸评审。参考文档：https://docs.openluat.com/value/drawcheck/

13. 8603M1模块一直重启，接独立电源也没用，是什么原因？

解答： 结论：先确认烧的是 Air8603 自己的出厂固件，别烧 Air1603 的脚本或固件；误烧是最常见的反复重启原因。说明：8603 的主控是 Air1603，但板级分区、引脚分配与外设配置都不一样。把 1603 的工程直接烧到 8603 上，脚本跑起来会反复复位，看起来像硬件故障，实际是固件与板型不匹配。原答里提到的脚本防呆，就是让工具在烧录前拦住这种错配。处理步骤：① 用 Luatools 看启动日志里的复位原因，区分是看门狗、掉电还是脚本报错；② 先烧 8603 出厂固件，能稳定跑说明硬件没问题；③ 再烧自己的脚本，确认用的是 8603 的板级配置；④ 出厂固件也重启，再查供电与看门狗。参考文档：https://docs.openluat.com/air8603/

14. Air724UG用v3 tools下载后无法再次下载，启动原因显示未知，如何解救？

解答： 结论：换最新版 Luatools（当前 3.4.15），按「按住 BOOT、再开机、然后点下载」的顺序强制进下载模式，同时把 USB 驱动重装一遍。说明：v3 tools 是老一代下载工具，新固件的下载协议与分区描述它未必认，表现就是第一次能下、之后再也进不去。启动原因未知通常是没拿到有效的启动日志，或者根本没进下载模式，不是模组坏了。处理步骤：① 装 Luatools 3.4.15；② 设备管理器确认识别到下载口，只出现 1 个口才算进对模式；③ 按住 BOOT 再上电，随后点下载；④ 重装 USB 驱动、换线换口；⑤ 仍不行再做强制下载清一次 Flash 后重烧。参考文档：https://docs.openluat.com/common/Luatools/

15. Air724UG插手机可正常通话的SIM卡却提示无网络/不驻网，对卡有什么要求？

解答： 结论：先确认这张卡开通了 VoLTE，再查天线与驻网状态；Air724UG 是 4G 全网通，移动、联通、电信的 4G 卡都支持。说明：Air724UG 是 Cat.1 的 4G-only 模组，没有 2G/3G 可退。现在很多地区 2G/3G 已经退网，语音必须靠 VoLTE 承载，卡没开 VoLTE 时能注册上网络但打不了电话，看起来就像手机能用、模组不能用。不驻网则要看频段、天线和卡状态。处理步骤：① 依次看 AT+CPIN?、AT+CSQ、AT+CGATT?、AT+COPS? 的返回；② 找运营商确认 VoLTE 已开通、卡未欠费未停机；③ 换一根确定正常的天线再试；④ 刷最新 AT 固件复测。参考文档：https://docs.openluat.com/air724ug/product/

16. Air780EHV启用GNSS应用后串口1收不到数据，是什么原因？

解答： 结论：把 exgnss 扩展库更新到最新版就恢复了，这是老版本库的问题。说明：Air780EHV 的 GNSS 走 exgnss 库，老版本在串口占用与波特率切换的时序上有缺陷，表现就是启用 GNSS 应用后串口 1 收不到 NMEA 语句。换库就能好，说明不是天线或硬件损坏。处理步骤：① 从 lib 仓库取最新 exgnss 替换工程里的旧库；② 确认 GNSS 天线是带馈电的有源天线且供电正常；③ 单独占一路串口跑 GNSS，不要和调试打印混用；④ 用库自带的调试输出确认是否收到语句。参考文档：https://docs.openluat.com/osapi/ext/exgnss/

17. Air780EPM/780EHM串口收不到485传感器数据（其他传感器正常），如何排查？

解答： 结论：本例根因在收发切换时序——传感器最后一个字节还没发完，DE 就被切回接收状态，尾字节被截断；把切换时机往后推就解决了。说明：RS485 是半双工，方向由 DE 控制。DE 拉低的时机如果按发完就切来写，实际会因移位寄存器还没吐完最后一个字节而丢数据。这类问题的典型特征是换别的传感器正常、只有某个型号丢包，因为不同传感器的帧长与帧间隔不一样。处理步骤：① 先用示波器同时看 A/B 差分信号与 DE，确认最后一字节是否完整；② 发送后等串口发送完成（或按字节时间加余量）再切回接收；③ 优先用 uart 自带的 485 方向控制接口，不要用 gpio 手动翻转；④ 接收侧开启错误数据丢弃，避免脏帧进入业务。参考文档：https://docs.openluat.com/osapi/core/uart/

18. Air8000双卡单待，SIM2插入物联卡报sim state error，无法联网怎么办？

解答： 尚未解答

19. Air8000（2020版本）用联通卡几天后断网，显示已注册但无法联网，重启后恢复，是什么原因？

解答： 结论：先升级到最新固件再看信号，脚本里补上断网重连与协议栈重启的兜底；旧版本上的网络问题无法确认是否已经优化。说明：已注册但上不了网，一般是 PDP 激活失败或链路假活——注册状态还挂着，实际数据通道已经不通。这类现象在弱信号、跨基站切换频繁的场景更容易出现，重启能恢复说明是协议栈状态卡住，而不是卡或基站的问题。处理步骤：① 升级到当前最新固件；② 记录 CSQ/RSRP 与 AT+CGACT? 的返回，判断是没激活还是激活后断流；③ 脚本里加心跳，连续失败就重新激活 PDP，仍失败再重启协议栈或整机；④ 复现时把时间点与日志一起交给 FAE。参考文档：https://docs.openluat.com/air8000/luatos/firmware/

20. Air780EPM固件是否有锁区限制？设备在武汉能连4G，到虹桥就连不上。

解答： 结论：固件没有锁区限制，Air780EPM 在任何地区都能正常驻网；这类现象一般是物联网卡的地域使用限制，或者当地频段与覆盖问题。说明：模组固件里没有按地理位置限制驻网的逻辑，射频能力由芯片与天线决定。物联网卡很多是按开卡地或指定使用区域销售的，跨省使用会被运营商侧限制，表现出来就是换个城市就连不上。处理步骤：① 在同一设备、同一地点换一张普通手机卡测试，能连就基本锁定是卡的限制；② 查这张卡的开卡地和使用地策略；③ 对比两地的 CSQ 与注册状态；④ 联系卡商变更使用区域或换卡。参考文档：https://docs.openluat.com/air780epm/luatos/firmware/780epm_version/

21. 设备频繁重启，升级平台有10分钟内只能升级一次的限制，导致设备无法升级怎么办？

解答： 结论：先解决重启，再谈升级；升级频率限制可以用 FOTA 按十分钟一次的节奏走，不要频繁重试。说明：平台的升级限制按设备维度计算，设备一重启就可能重新计时或被判成同一窗口内的二次请求，于是永远卡在已被限制。而重启本身往往不是升级导致的，是供电跌落、看门狗或脚本死机，不查清楚会一直循环。处理步骤：① 看启动日志的复位原因，确认是掉电、看门狗还是脚本异常；② 用 libfota3 做定时检查升级任务，间隔不小于十分钟；③ 升级失败要有退避重试，不要立刻重发；④ 平台侧核对设备当前的升级状态再决定是否重推。参考文档：https://docs.openluat.com/osapi/ext/libfota3/

22. 4002底层设备能否OTA推送到4035固件？一直推送不过去。

解答： 结论：不能一次性从 4002 跳到 4035，跨度太大推送会一直被拒；要么多次 OTA 逐级升，要么直接线刷最新固件。说明：OTA 包按目标版本校验分区与签名，版本跨度过大时前置校验就过不去，表现出来是一直推送不过去而不是明确报错。远程升级的前提是设备能稳定联网并完整跑完一次升级流程。处理步骤：① 能到现场就线刷最新固件，最省事；② 只能远程就按中间版本逐级升，每升一版确认版本号真的变了再推下一版；③ 记录每次 OTA 的返回码与耗时，定位卡在哪一步；④ 升级期间保证供电稳定。参考文档：https://docs.openluat.com/osapi/ext/libfota3/

23. 合宙物联网卡出现机卡分离停机，是否是模块上报错误IMEI导致？

解答： 结论：不是模块上报错误 IMEI，机卡分离是卡与 IMEI 绑定策略触发的，属卡侧或卡商侧的问题。说明：物联网卡首次激活时会把 IMEI 与卡绑定，之后换设备、换卡槽、换模块都可能被判成机卡分离而停机。模块读 IMEI 读的是芯片内置值，AT+CGSN 返回的就是真实值，不存在上报错误这种机制。处理步骤：① 用 AT+CGSN 读出真实 IMEI；② 与卡商登记的 IMEI 比对，确认是否换过设备；③ 让卡商解绑或换绑后复机；④ 不建议用改 IMEI 的方式绕过，属违规且会被再次判定。参考文档：https://docs.openluat.com/value/iot/

24. Air780E模块开机正常、AT+CGSN返回IMEI正常，但SIM卡无电压读不到卡？

解答： 结论：先按 SIM 电路设计逐项核对，再用示波器抓 SIM_VDD/CLK/DATA/RST 的上电波形；完全没有波形就返厂检测，同时让贴片厂复查焊接。说明：能开机、AT+CGSN 正常，说明主控与串口都没问题，故障集中在 SIM 接口这一段。卡电压起不来说明卡接口没被使能，通常是卡座接触、走线断、ESD 器件击穿或供电异常。处理步骤：① 对照官方 SIM 电路检查上拉、ESD 与卡座脚序；② 示波器抓四根线的上电时序，重点看 VDD 有没有起来；③ 换一张确定正常的卡、换一个卡座对比；④ VDD 完全无输出就返厂，焊点问题交贴片厂复检。参考文档：https://docs.openluat.com/air780epm/luatos/hardware/sim/

25. 合宙IOT云平台有没有API接口，方便程序自动查询设备信息？

解答： 结论：平台没有对外开放的设备信息查询 API，程序目前无法通过接口自动读取平台上的设备状态。说明：平台遵循 AirCloud 协议，设备侧可以按该协议主动上报数据；但平台侧的设备管理信息（在线状态、归属、升级记录）目前只在页面里看，没有对外查询接口。真要做自动化，方向是让设备自己上报到你的服务器，而不是反过来去平台拉。处理步骤：① 建自己的服务端，设备用 socket/mqtt 或 AirCloud 协议定时上报；② 需要平台侧能力就先按 AirCloud 协议接入；③ 确实要查询接口，走商务确认是否有企业版开放计划。参考文档：https://docs.openluat.com/value/iot/

26. Air8607/Air8603能否使用40pin屏幕？

解答： 结论：Air8607 只有 50PIN 的 LCD 接口，接不了 40PIN 屏；要用 40PIN 就选 Air8603（40PIN 与 50PIN 都支持），或者自己做 50 转 40 的转接板。说明：8607 是大屏音视频最小系统板，LCD 用常规 50PIN 连接器，触摸走 I2C 的 FPC。8603 才是同时提供 40PIN 与 50PIN 两种屏幕连接方案的整机板。要注意两种接口共用显示信号，不是双屏独立输出，转接时引脚定义必须一一对上，否则可能烧屏。处理步骤：① 先确认屏的针数与引脚定义；② 接口不匹配优先换板型，不要硬转；③ 必须转接时逐脚核对供电、地、RGB 数据与时钟，先断电用万用表量通断；④ 点亮前把背光电流限制在屏的规格内。参考文档：https://docs.openluat.com/air8607/product/

27. 8607/8603的7寸屏什么时候适配好？

解答： 结论：Air8603 支持 7 寸 40PIN，但 7 寸屏目前没上架；Air8607 是 50PIN 接口。7 寸屏可以自己找供应商，硬件参数与驱动 IC 匹配就能适配。说明：Air1603 输出 RGB565，屏幕适配的核心是接口类型、分辨率与时序，以及驱动 IC 是否在 lcd 库的支持列表内。分辨率 1280×800 以内都能适配，典型是 1024×600。自己适配不了的屏，可以把屏或规格书寄给合宙协助。处理步骤：① 确认屏是 RGB565 接口、分辨率在上限内；② 查驱动 IC 是否在 lcd 库支持列表（st7701sn、hx8282、nv3052c 等）；③ 不在列表就按规格书写初始化序列与时序参数；④ 时序调不通就把屏寄过来适配。参考文档：https://docs.openluat.com/air8603/

28. Air780EPM(780E系列)用LuatOS开发，用哪个AI比较好？codebuddy是否需要配置MCP？

解答： 结论：用哪个 AI 都可以，关键是先把官方文档喂给 AI；MCP 不是必须的，但配好之后 AI 能直接查文档、编译下载，效率高很多。说明：合宙文档站本身就是按核心库、扩展库组织的，AI 读过之后基本能按接口写对参数。配 MCP 是为了让 AI 不用手工贴文档就能检索，属于提效，不是前置条件。UI 开发另有专门的大屏 UI 文档与视频教程。处理步骤：① 打开 MCP 配置文档，按里面的方式接上；② 把核心库、扩展库的页面地址给 AI 作为知识来源；③ UI 开发看 air8607-ui 文档与配套视频；④ 让 AI 用 luatos-cli 完成编译与下载，形成闭环。参考文档：https://docs.openluat.com/ai/mcp_cli/

29. 使用AI工具新增代码文件后无法自动烧录验证，怎么处理？

解答： 结论：这是工具链缺一环，已经提了 issue；临时办法是把 luatos-cli 交给 AI，让它自己完成编译、下载、读日志。说明：现在 AI 能改源码、能写脚本，但缺一个能自动烧录并回读串口的命令行通道，所以改动没法自验证。luatos-cli 正好补这一环，Luatools 的资源目录里也带了一份。处理步骤：① 从 gitee 取 luatos-cli，或直接用 Luatools 资源目录里的那份；② 把 CLI 的用法写进项目的说明文件，让 AI 每次都读；③ 让 AI 按改源码、编译、下载、回读日志的顺序跑；④ 日志里报错就回到第一步继续改。参考文档：https://gitee.com/openLuat/luatos-cli

30. Air1603加触摸驱动后刷机死机，1603网页最新V1029固件死机如何解决？

解答： 结论：换用原厂当天新生成的那一版固件重测；触摸驱动此前确实有过死机问题，已经修复。说明：文档站上 Air1603 的固件页目前公开到 V1028，V1029 属于按问题临时出的包，不在公开列表里，需要向对接人要当天最新的一版。加触摸驱动后死机，也要排除触摸 IC 型号与 I2C 地址不匹配、初始化时序不对这两种情况。处理步骤：① 索取当天最新的固件包并记录版本；② 只保留触摸初始化做最小复现，确认是驱动问题还是业务代码；③ 看死机前串口打印的最后一行；④ 仍死机就把工程与日志一起交给 FAE。参考文档：https://docs.openluat.com/air1603/luatos/firmware/1603_version/

31. 1601开发板是否下架？现在卖的是V1.1还是V1.2？

解答： 结论：Air1601 开发板没有下架，在售的是 V1.1；V1.2 只做了 10 片用于研发调试，没有上架。新项目建议直接选 Air1603。说明：1601 与 1603 是同代产品，但 1603 的资源与外设配置更贴合现在的需求，官方也在往 1603 上收敛。买开发板按在售型号下单即可，V1.2 属于内部样片，不存在对外供货。处理步骤：① 采购走 V1.1；② 新设计评估时优先对比 1603 的接口与存储；③ 已有 V1.1 的板子继续用，资料与固件都在文档站上。参考文档：https://docs.openluat.com/air1601/product/

32. 合宙云平台找不到本设备IMEI，如何把设备归属到自己账号下？

解答： 结论：按设备归属的操作说明提交资料即可，归属完成后设备才会出现在你自己的账号下；自己操作不通就找对接人协助。说明：平台按 IMEI 认设备，出厂时设备可能挂在别的账号名下，所以直接搜不到属于正常。归属需要能证明购买关系的凭证，这也是为什么会要订单号或物流单号。处理步骤：① 用 AT+CGSN 读出真实 IMEI，注意别把条码号当 IMEI；② 进归属页面按流程提交订单信息；③ 提交后等审核，通过后设备列表里就能看到；④ 卡住就把 IMEI 与订单号发给对接人。参考文档：https://docs.openluat.com/air780epm/product/attributioniot/

33. 模块归属设置需要订单物流单号，但淘宝半年以上订单查不到物流信息怎么办？

解答： 结论：淘宝的订单可以翻到全部记录（包括较早的历史订单），物流信息查不到就用订单号作购买凭证；以后拿到货就尽快做归属，别拖。说明：归属审核要的是能证明购买关系的凭据，订单号本身就够，物流单号只是其中一种。时间久了下架商品或物流信息过期都正常，不影响归属。处理步骤：① 在淘宝订单列表里按时间翻，或从订单回收站里找；② 截取带订单号与商品名的页面作为凭证；③ 提交归属时优先填订单号；④ 以后采购后尽快归属，避免再次卡在凭证上。参考文档：https://docs.openluat.com/air780epm/product/attributioniot/

34. Air8603 Host读U盘有什么解决方案？

解答： 结论：可以，U 盘挂载与读写已经验证没问题，按 usb demo 改成本板 GPIO 就能跑。说明：Air8603 做主控时 USB 工作在 Host 模式，U 盘要枚举成功，前提是 VBUS 5V 供电与插拔检测都对，这两处因板而异，官方 demo 的引脚不能直接照抄。挂载之后走 fatfs 读写。处理步骤：① 确认 USB Host 的 5V 供电与 VBUS 检测脚接法；② 用 usb 库枚举设备，看是否识别到 U 盘；③ 挂载 fatfs，分区用 FAT32、单分区；④ 用大文件做读写压测，观察掉盘。参考文档：https://gitee.com/openLuat/LuatOS/blob/master/olddemo/demo/usb/main.lua

35. Air780EPM用新模组+2054固件拍照图片始终不对，是什么问题？

解答： 结论：这是已知问题，等固件修复；先用上一版固件确认硬件与接线是好的。说明：V2054 上相机通路有已确认的缺陷，拍出来的图像数据不对，跟摄像头型号、排线、供电都无关。判断方法很简单：同一套硬件换回上一版固件就正常，那就是固件侧的问题。处理步骤：① 记录相机型号与固件版本；② 换上一版固件对比出图；③ 结果反馈给 FAE，跟踪修复包发布；④ 量产排期紧的话先锁在可用版本上。参考文档：https://docs.openluat.com/air780epm/luatos/firmware/780epm_version/

36. Air8000W模组固件能否定制？脚本区太小，能否去掉无用功能扩大脚本区？

解答： 尚未解答

37. Air8101能否外接USB摄像头拍照并通过Air8000A上传服务器？图片如何从8101传给8000A？

解答： 结论：能。Air8101 支持 UVC 摄像头，官方已调好 AirCAMERA_1030/1031（200 万拍照、100 万录像）；图片先存本地，再传给 4G 模组上传。说明：Air8101 既能接 UVC 也能接 DVP。UVC 需要 5V 供电，并在初始化过程中用 GPIO 控制供电通断，这段电路必须保留；需要多路可以加 USB HUB 扩到 4 路，但同时只能有一路工作。与 4G 模组之间官方已有 AirLink over SPI 通路，比自己定分包协议省事；8101 本身也能联网直传。CAN 一般模组不带控制器，不建议走 CAN 转。处理步骤：① 按 UVC 页的电路接好 5V 与供电控制脚；② 拍照后写入文件系统或 SD 卡；③ 走 AirLink over SPI 把文件交给 Air8000A 上传，或 8101 自己连 WiFi 上传；④ 摄像头优先选官方验证过的型号，其他型号先沟通。参考文档：https://docs.openluat.com/air8101/luatos/hardware/uvc/

38. 平台升级限制10分钟一次，能否用AI读取地址后自动逐个升级？

解答： 结论：可以，用 FOTA 按每十分钟一次的节奏逐个推；把 IMEI 给原厂也能协助查设备当前的升级状态。说明：平台的十分钟限制按设备计算，批量推的时候如果不控节奏，会出现大部分设备被拒。用 libfota3 让设备自己定时检查任务，比从后台硬推更稳，也不受重启影响。处理步骤：① 设备侧接 libfota3，检查间隔设成不小于十分钟；② 批量推送按批次排开，不要同时下发；③ 每批回收结果，失败的单独重试；④ 卡住的设备把 IMEI 给原厂查状态。参考文档：https://docs.openluat.com/osapi/ext/libfota3/

39. 合宙屏幕模块播放视频用什么格式最清晰？10寸屏如何转成hzv格式？

解答： 结论：全屏播放用 HZV 最清晰，1024×600、30 帧是最稳的组合；也可以用 MJPEG。10 寸屏同样按这个规格转。说明：屏的分辨率上限与视频能播的规格是两件事。Air1603 的屏最高能到 1280×800，但视频解码与刷屏带宽有限，全屏播 1024×600@30 是实测比较稳的点，再往上要看码率与存储读速。HZV 走硬件解码，比 MP4 的受限解码能吃下更多。处理步骤：① 用 AirMaster 的 HZV 转换器，分辨率选 1024×600，帧率 30；② 源文件必须有音轨，否则转换失败；③ 转换后看校验是否通过，再拷到 SD 卡；④ 上机实测，掉帧先降帧率再降分辨率。参考文档：https://docs.openluat.com/ai/airmaster/

40. Air780EPM打印信息乱码，波特率都调整过仍乱码，是什么原因？

解答： 尚未解答

41. Air780EPM能不能用RNDIS连接ESP32S3？用RNDIS后MQTT等功能是否正常？

解答： 结论：可以，RNDIS 改动不大，用 mobile 库实现；PPP 目前还不支持。说明：RNDIS 是把模组当成 USB 网卡给主机用，这里主机是 ESP32S3，所以 ESP32S3 侧要有 USB Host 与 RNDIS 驱动栈，工作量通常在主机侧而不在模组侧。MQTT 走的是模组内部 socket，跟 USB 侧是不是 RNDIS 没有关系，只要 4G 链路正常就能用。处理步骤：① 用 mobile 库开启 USB 网卡模式；② 起 dhcpsrv 给主机分地址；③ ESP32S3 侧实现 RNDIS 主机；④ 用 MQTT 连通性测试确认 4G 侧正常；⑤ 需要 PPP 拨号的场景暂不支持，得换方案。参考文档：https://docs.openluat.com/osapi/core/mobile/

42. ms2520气压计地址是0x77读数据报错，i2c超时怎么处理？

解答： 结论：地址是 0x77；GPIO26 和 AGPIO8 都要拉高，否则器件不上电。再确认焊接方向，贴反了要转 180 度重焊。说明：I2C 超时在这种小封装传感器上大多不是总线问题，而是器件没供电或者地址没对上。气压计类器件常见 0x76/0x77 两个可选地址，具体由 SDO 脚电平决定，接错就是读不到。处理步骤：① 先把 GPIO26、AGPIO8 配置成输出并拉高；② 用 i2c 扫描确认 0x77 上有应答；③ 没有应答就量器件供电脚电压；④ 电压正常仍无应答，检查焊接方向与虚焊，必要时返厂重焊。参考文档：https://docs.openluat.com/osapi/core/i2c/

43. 8603的10寸屏是否有带金属边框的封装版本？

解答： 结论：现在这款 10 寸屏就是不带金属边框的；带金属框的版本很快开卖。说明：屏幕按整机结构配套，边框形式属于结构件选项，不影响显示与触摸的适配。要带框的版本等上架后按型号选，换料前确认屏的接口与驱动 IC 不变，避免重新适配。处理步骤：① 现阶段按无框屏做结构设计，自己加固定支架；② 需要金属框的等上架后换料号；③ 换料前对比接口、分辨率与时序参数。参考文档：https://docs.openluat.com/air8603/

44. Air780EHM做二次开发（原用单片机+4G数传）难度如何，1个月能否出样机？

解答： 结论：难度取决于需求复杂度，不能一概而论；需求收敛、外设不多的情况下一个月出样机是可行的，具体排期要按需求评估。说明：从单片机加 4G 数传转到 LuatOS 二次开发，省掉的是编译环境与协议栈移植，主要成本在业务逻辑与外设驱动适配上。外设都是官方验证过的型号会快很多，涉及特殊屏、特殊传感器就要留调试时间。处理步骤：① 把需求（外设清单、接口、上报协议、UI）整理成文档；② 交给 AI 按官方文档先出一版评估与代码框架；③ 拿开发板把关键外设逐个点亮；④ 再谈整机排期。参考文档：https://docs.openluat.com/ai/mcp_cli/

45. 合宙大屏产品是否带外壳？

解答： 结论：合宙的大屏整机产品都带外壳。说明：外壳属于整机配件，随机附件与结构形式以对应型号的供货清单为准；结构设计前先向销售确认交付形态，比按宣传图估更可靠。处理步骤：① 采购前向销售确认是否含外壳；② 结构设计按实际交付形态做；③ 需要定制外壳走商务渠道。参考文档：https://docs.openluat.com/air8603/