常见问题 - 2026-10-13

数据日期：2026-10-13

1. Air780E USB连接Luatools无法显示日志，不断重启，ap log port输出乱码怎么办？

解答： 结论：99.9% 是供电不足，换稳压电源或改用带独立供电的 USB Hub 复测即可；同时确认 Luatools 里勾选了 USB 打印。说明：模组在搜网与射频发射时会出现瞬时大电流（可冲到 1A 以上），USB 口或劣质线缆供电能力不足时，模组会因欠压反复掉电重启，串口输出也就跟着变成乱码。日志窗口一直空白则通常是没勾选“4G 模块 USB 打印”，这两件事经常同时出现，容易被误判成模组损坏。处理步骤： 1. 换稳压电源或带独立供电的 USB Hub，确认电压稳定在标称值。 2. 打开 Luatools 日志打印窗口，勾选“4G 模块 USB 打印”（USB 物理连接必须勾选）。 3. 换一根确认能传数据的 USB 线复测。 4. 仍异常时用 Luatools 的“保存日志”导出完整日志，交给对接 FAE。参考文档：https://docs.openluat.com/common/Luatools/

2. AirTalk设备入库失败，8001返回customer为空，8002返回“系统中没有该设备”怎么处理？

解答： 结论：这两条报错都指向“设备尚未正确归属或登记到目标 IoT 项目”，先把设备归属与 Product_key 对齐再重试。说明：AirTalk 属于 LuatOS 核心库，设备入库依赖合宙 IoT 云平台的项目与设备归属关系：8001 返回 customer 为空，说明请求里没带上有效的客户/项目信息；8002 返回“系统中没有该设备”，则是平台库里查不到这条设备记录。最常见的原因是设备还挂在“合宙标准模块”等默认项目下，或 Product_key 与其所属项目不一致。处理步骤： 1. 登录 iot.openluat.com，在“我的设备”里按 IMEI 查询设备当前归属。 2. 确认设备的 Product_key 与其所在 IoT 项目保持一致。 3. 按设备归属教程把设备转移到目标项目后重试入库。 4. 仍未解决时提供 IMEI、Product_key 与操作时间，由对接同事在后台核查。参考文档：https://docs.openluat.com/air780epm/product/attributioniot/

3. Air780EHV接入SIP后接到公安反诈电话，需要怎么备案？

解答： 尚未解答

4. Air780EHU与Air780EPM是否引脚兼容？

解答： 结论：两者管脚布局兼容、脚本基本通用，但 Air780EHU 必须换成它自己的底层固件。说明：Air780EHU 与 Air780EPM 同属 Air780Exx 系列，官方提供系列管脚兼容性说明与逐脚对比表，硬件上可以对照替换。差别主要在频段（Air780EHU 为欧亚版、Air780EPM 为国内版）与底层固件；频段属硬件差异，靠刷固件改不了，所以替换后要重新验证驻网。处理步骤： 1. 先按模组丝印确认完整型号，不要只看系列名。 2. 用系列管脚兼容说明与管脚对比表逐脚核对。 3. 换用 Air780EHU 的底层固件后重新烧录。 4. 复测网络注册与频段覆盖是否满足目标国家要求。参考文档：https://docs.openluat.com/air780ehnehu/product/air780exx/

5. Air780EHN模组可以在美国直接用当地卡入网吗？

解答： 结论：可以。Air780EHN 本身就是面向北美的型号，插入当地运营商的卡并设置好 APN 即可入网。说明：Air780EHN 支持 B2/B4/B5/B7/B12/B13/B17/B18/B19/B25/B26/B38/B41/B66/B71，覆盖美国 AT&T、T-Mobile 等主流运营商使用的主力频段。频段由硬件决定、刷固件改不了，所以北美场景要选 EHN 这类北美版型号；Air780EHU 属欧亚版，频段不含北美主力频段，不能替代。处理步骤： 1. 确认手上是 Air780EHN，而不是欧亚版型号。 2. 插入当地运营商的 SIM 卡。 3. 按运营商要求配置 APN。 4. 仍注不上网时，核对所在地的频段覆盖与运营商准入要求。参考文档：https://docs.openluat.com/air780ehnehu/product/air780ehnfreq/

6. Air780EPM只用4G功能，LCD、CAM、485等不用的接口焊盘悬空就可以吗？

解答： 结论：只使用 4G 功能时，未使用的信号焊盘一般可以悬空，但电源、地、使能类引脚不能悬空，必须按硬件手册处理。说明：数字 IO 在不使用时对外呈高阻态，一般悬空不影响 4G 功能；但供电、地、PWRKEY、RESET_N、USB_BOOT 等引脚有明确的接法要求，处理不当会导致不开机或反复重启。485、LCD、摄像头这类接口的控制脚若留悬空，后续启用时还可能因为电平不定而误触发。处理步骤： 1. 打开对应型号的硬件手册，逐脚确认未用引脚的建议接法。 2. 电源、地、使能类引脚按手册接，不要留空。 3. 未使用的 IO 建议引出测试点而不是彻底悬空，便于后续调试。 4. 接法不确定时，到 docs.openluat.com 右下角 AI 提问确认后再定板。参考文档：https://docs.openluat.com/air780epm/luatos/hardware/design/

7. Air780EPM的AGPIO能否用作软件I2C的SDA和SCL？

解答： 结论：可以用作软 I2C 的 SDA/SCL，但必须外接上拉电阻，并先用逻辑分析仪确认波形。说明：软 I2C 是用 GPIO 模拟时序，而 I2C 总线是开漏结构，SDA/SCL 的高电平靠外部上拉建立；AGPIO 本身不提供足以驱动总线的上拉能力，没加上拉时总线会一直被拉低，表现为完全没有波形或一直为低。另外 AGPIO 在低功耗保持等特性上与普通 GPIO 不同，选脚时一并考虑。处理步骤： 1. 在 SDA/SCL 上各加一只上拉电阻（常见 4.7K），上拉到 IO 电平。 2. 确认这两只 AGPIO 已配置为普通 GPIO 功能。 3. 用逻辑分析仪抓起始位、地址与 ACK。 4. 仍不通时检查从机 7 位地址与器件供电。参考文档：https://docs.openluat.com/air780epm/luatos/app/driver/gpio/

8. Air8784如何测试SIP，能否定制自己的SIP？

解答： 结论：可以定制。出厂固件的完整源码已开放，改完自行烧录即可；手上的设备可以先用官方 SIP 体验平台与官方测试账号跑通全链路，再切到自建服务器。说明：Air8784 基于合宙 4G 模组 Air780EHM 与合宙自研的语音芯片 Air1103 设计，Air1103 内置 Audio Codec 与回声抑制算法，免提通话时对端基本听不到自己的声音。当前出厂版本的服务器地址与账号在软件里写死，用的是官方测试账号；要接自己的 SIP 服务器，需要按源码修改服务器、账号与传输方式后重新打包烧录。处理步骤： 1. 先到 sip.luatos.com 用合宙 IoT 账号登录，建好 8784_SIP 项目并把设备归属进去。 2. 用官方测试账号验证注册与通话（日志应出现 exsip init completed、SIP 注册成功）。 3. 拉取 Gitee 上 module/Air8784/project/factory 源码，按自有服务器参数修改。 4. 用 Luatools 选择 Air780EHM 内核重新烧录并复测。参考文档：https://docs.openluat.com/air8784/product/

9. Air8784产测模式如何退出？

解答： 结论：通过 USB 虚拟串口 VUART_0 发送 TEST_DONE#，写入 test_done 标志并重启，即从产测模式进入业务模式。说明：固件开机读取 fskv 中的 test_done 标志决定走哪条分支：没有标志进产测模式（factory.lua），有标志进业务模式（task_main.lua）。已出厂的设备在出厂前已经烧好该标志，上电即进业务模式；只有自己重新烧录且勾选了“清除 KV 分区”时才会丢掉标志、退回产测模式。处理步骤： 1. 用串口软件（或 Luatools 的串口工具）连接 USB 虚拟串口 VUART_0。 2. 发送 TEST_DONE#。 3. 重启设备，日志出现“进入业务模式”即表示切换成功。 4. 日志仍显示 factory.lua 时，检查是否重复执行了清 KV 分区的烧录。参考文档：https://docs.openluat.com/air8784/software/default_factory_firmware/

10. Air8784 SIP→CC通话一段时间后内存溢出自动重启怎么办？

解答： 结论：该链路目前跑的是临时固件、不具备量产条件，建议等正式版本发布后再做长时间通话验证。说明：SIP 与蜂窝电话桥接这条链路相对复杂——设备要同时处理 SIP 侧媒体流、VoLTE 通话、录音与回声抑制，长时间通话下的内存占用与资源释放需要在固件侧专门优化。临时固件在这块尚未收敛，出现内存溢出并自动重启属于已知现象。处理步骤： 1. 记录重启前的通话时长、固件版本号与完整日志（含 ramdump）。 2. 暂不要将该链路用于量产或现场交付。 3. 关注 Air8784 出厂固件页的版本更新，正式版本发布后用同一场景复测。 4. 有明确项目节点时，与对接 FAE 沟通定制节奏。参考文档：https://docs.openluat.com/air8784/software/default_factory_firmware/

11. Air1603模组什么时候上架？

解答： 结论：Air1603 的上架时间属商务节奏，需以官方渠道公布的时间为准；当时对接同事给的口径是“顺利的话次日下午上架”。说明：模组上架时间受备货、认证与产线排期影响，技术文档不承担交期承诺。需要确切的现货时间、批量价格或样品安排，请通过合宙官方购买渠道或对接销售确认；文档侧可以先看 Air1603 的硬件规格、固件页与烧录说明，为后续开发做准备。处理步骤： 1. 到 Air1603 资料页确认规格与硬件参数。 2. 上架时间与价格直接问对接销售。 3. 需要提前验证时同步申请样片。参考文档：https://docs.openluat.com/air1603/luatos/hardware/

12. Air1603支持USB扫码枪吗？

解答： 结论：支持。扫码枪在 USB 下通常表现为 HID 键盘设备，而 Air1603 支持 USB HID 键盘与鼠标，因此可以直接接入。说明：多数 USB 扫码枪出厂默认为“USB 键盘”模式，扫到的内容通过 HID 键盘报文上报，等同人工敲键盘；只要 Air1603 的 USB 工作在 Host 模式并成功枚举设备，脚本侧按键盘输入处理即可。若扫码枪被配置成虚拟串口（CDC）模式，接法与解析方式都不同，需要按串口方案处理。处理步骤： 1. 把扫码枪设为 USB 键盘（HID Keyboard）模式。 2. Air1603 的 USB 以 Host 方式连接扫码枪。 3. 脚本侧按 HID 键盘输入解析扫码结果。 4. 不通时先把同一把枪插到电脑上，确认其默认工作模式。参考文档：https://docs.openluat.com/air1603/luatos/hardware/

13. Air1603后续会使用1601的固件吗？引脚位置不一样，pins设置按1601还是1603？

解答： 结论：优先用 Air1603 自己的固件与 pins 配置；Air1601 固件虽然也能跑，但那只是型号名不同的写法，管脚定义必须按实际型号来选。说明：Air1603 已有独立的固件版本页，官方也为 1603/1604 提供单独固件。Air1603 与 Air1601 的封装、管脚位置并不相同，pins 配置若照抄另一个型号，会出现引脚对不上、外设不工作的问题。处理步骤： 1. 到 Air1603 固件版本页取对应固件。 2. 在 Luatools 中选择 Air1603 的 pins 配置。 3. 确实要换 Air1601 固件测试时，同步切换到 1601 的管脚定义。 4. 功能验证一律以实际使用的型号为准。参考文档：https://docs.openluat.com/air1603/luatos/firmware/1603_version/

14. Air8601/8602的4G/WiFi原理图和位号图哪里获取？

解答： 结论：到 Air8601、Air8602 的产品页获取，4G 部分与 WiFi 部分的原理图、位号图都在各自的硬件资料中给出。说明：Air8601、Air8602 是大屏整机方案，资料按整机划分，4G 侧与 WiFi 侧是相互独立的模块，图纸分别提供。下载前先确认手上的型号与硬件版本号，位号图要与同版本原理图配套使用，否则对不上丝印。处理步骤： 1. 打开 Air8601 或 Air8602 产品页。 2. 在硬件资料中下载对应版本的原理图与位号图。 3. 核对图纸版本与实物丝印一致后再用于改板或维修。参考文档：Air8601 见 https://docs.openluat.com/air8601/product/ ，Air8602 见 https://docs.openluat.com/air8602/product/ 。

15. Air780EGP/EG2支持付费基站定位吗？

解答： 尚未解答

16. 合宙有5G模组吗？

解答： 结论：暂时没有。合宙当前的产品线集中在 4G Cat.1/Cat.4 以及 WiFi、蓝牙等方向，尚未推出 5G 模组。说明：绝大多数物联网场景用 Cat.1 就能覆盖，成本和功耗也更友好；确实需要高带宽的场景，可以先评估是否能拆成“4G 回传 + 本地高速链路”的方案。后续是否有 5G 产品，以官方发布信息为准。处理步骤： 1. 到官方选型页确认现有型号。 2. 明确实际带宽与延迟需求，判断能否用 4G 方案满足。 3. 有明确的 5G 需求时，直接对接销售了解产品规划。参考文档：https://docs.openluat.com/SelectionGuide/SelectionGuide/

17. 合宙IoT平台有公司账户吗？私人账户使用不方便。

解答： 结论：有的。合宙 IoT 云平台支持公司/企业账户形态，可联系对接销售申请开通。说明：平台账号本身用手机号登录，个人账户与公司账户的差别主要体现在设备归属、多项目协作与后台管理能力上。企业场景建议直接用公司账户，便于多人协作与设备统一管理，后续对接 API 也更顺。处理步骤： 1. 先到 iot.openluat.com 用手机号登录，确认现有账号与项目结构。 2. 需要公司账户时，向对接销售提供企业信息申请开通。 3. 开通前先梳理项目划分与设备归属规则，便于一次配置到位。参考文档：https://iot.openluat.com/cloud/main

18. 合宙支持的屏幕有哪些？

解答： 结论：RGB 接口的屏基本都可以用，触摸以电容触摸为主；电阻触摸已经在调试，理论上也能支持。说明：屏幕能否使用，关键看模组的显示接口是否匹配——RGB 接口要按模组支持的色深与时序接屏，触摸则走 I2C 电容触摸控制器。电阻屏是另一套触摸采样方式，适配仍在完善中。选屏时除分辨率与刷新率外，还要确认背光控制引脚是否有富余 IO。处理步骤： 1. 确认所选模组的显示接口类型、支持的分辨率与色深。 2. 优先选 RGB 接口加电容触摸的整屏方案。 3. 要在具体型号上使用电阻屏，先与 FAE 确认适配进度。参考文档：https://docs.openluat.com/air780epm/luatos/app/multimedia/ui/airui/

19. Air8202G是否支持二次开发？提示缺少lua文件和不能大于128k，固件如何选择？

解答： 结论：Air8202G 支持二次开发。提示缺少 .lua 是 lib 没有被一起打包；iRTU 的 lib 是专用库，需要在 Luatools 的资源文件中找到并随工程一起烧录。说明：iRTU 方案把 lib 放在 Luatools 的资源目录里，创建工程时若没有勾选“添加默认 lib”（或没有手动把 lib 拷入工程），运行阶段就会报缺少 xxx.lua。至于“不能大于 128k”，通常指向脚本空间或文件系统的容量限制，需要精简工程或调整分区方案。处理步骤： 1. 在 Luatools 主界面的资源文件中找到该型号对应的 lib。 2. 建工程时勾选“添加默认 lib”，或把 lib 脚本拷入工程目录。 3. 固件按该型号固件页选择，iRTU 场景要烧 iRTU 对应固件。 4. 受脚本体积限制时拆分模块、精简资源文件。参考文档：https://docs.openluat.com/value/irtu/

20. MQTTS的证书密钥文件一般怎么存在设备里？

解答： 结论：常规做法是用 Luatools 的项目管理界面把证书、密钥文件随脚本一起烧进文件系统；也可以参考 MQTT 官方 demo 里的 MQTTS 示例。说明：模组文件系统（fs 分区）在烧录后是持久保存的，证书写入后应用按路径读取即可。MQTTS 需要的是带 CA 校验的 SSL 连接，端口与认证方式要和服务器匹配；合宙测试服务器的 ssl 端口（8888 为无证书校验、单向认证）与证书下载见参考文档。处理步骤： 1. 在 Luatools 项目管理中添加证书与密钥文件。 2. 脚本中按文件系统路径读取，作为 MQTT 连接的 ssl 参数。 3. 参考 MQTT demo 的 MQTTS 示例先跑通链路。 4. 可直接用官方 mqttcerts.zip 内的测试证书做联调。参考文档：https://docs.openluat.com/common/tools/mqtt-server/

21. 设备能否在本地烧写证书私钥文件？

解答： 结论：可以。用自有脚本配合串口工具把证书文件发送到模组，或让设备通过 HTTP 直接下载到文件系统，两条路都可行。说明：模组的文件系统可写，只要应用侧实现了接收逻辑（串口分包接收后落盘），就能在产线或现场把证书与私钥写进去；走网络的话，用 HTTP 下载到本地文件系统同样可以。写入后要校验文件完整性，并注意私钥不要长期留在对外可读的目录。处理步骤： 1. 在脚本里实现串口接收并落盘，注意分包、超时与校验。 2. 或者让设备通过 HTTP 把证书下载到文件系统。 3. 写入后重启应用，确认 MQTTS/SSL 连接成功。 4. 私钥文件建议单独存放并限制读取范围。参考文档：https://docs.openluat.com/common/tools/mqtt-server/

22. Air780EHT低功耗模式下能否支持MQTT长连接，功耗能做到标称的1.5-2mA吗？

解答： 结论：能。Air780EHT 在保持网络连接（心跳保活）的常规低功耗状态下，实测电流可落在 1.5~2mA 量级。说明：这个口径对应的是“保持连接、可随时收发”的常在线状态。想再往下压必须用 PSM+/PSM 这一类深度休眠：模组大部分时间不驻网，典型电流可降到 μA 级到十几 μA，代价是休眠期间无法即时下发数据，要靠唤醒周期或短信/振铃之类的外部事件叫醒。能否进入深休眠，还取决于运营商网络是否下发对应的定时器参数。处理步骤： 1. 先明确业务是“要求随时可下发”还是“允许分钟级延迟”，前者用 MQTT 长连接，后者才考虑 PSM+。 2. 长连接场景按心跳周期与网络参数调优。 3. 用稳压电源测平均电流，注意排除外设漏电与稳压器自身损耗。参考文档：https://docs.openluat.com/value/irtu/docs/psm/

23. Air780EHT和780EHM有什么区别？

解答： 结论：区别在开发方式——Air780EHT 是 AT 指令模组，Air780EHM 走 LuatOS 二次开发。说明：两者硬件同族但定位不同：Air780EHM 只支持 LuatOS 二次开发，不支持 AT 指令开发方式；需要 AT 指令的场合，官方推荐使用 Air780EHT。反过来说，项目若已确定用 Lua 写业务逻辑，就选 EHM 这一侧；只是做主控 + AT 透传，选 EHT 成本更低。处理步骤： 1. 先确定开发方式：AT 指令还是 LuatOS。 2. 选 AT 时到 AT 模组页查看 Air780EHT 规格。 3. 选 LuatOS 时到 Air780EHM 的硬件页与固件页查看。 4. 两者管脚有差异，换型号必须重新核对管脚表。参考文档：https://docs.openluat.com/atmozu/product/shouce/

24. 用新固件对已出货的模组有影响吗？升级包怎么处理？

解答： 结论：给已出货模组刷新固件本身没有问题，但跨多个大版本升级需要制作中间版本的差分升级包，并且每一级都要实测。说明：内核固件只支持差分升级，脚本支持全量升级，所以内核从旧版本跳到新版本时往往要按顺序逐级升级（例如 18 号升到 36 号之间可能需要几个中间版本），每一级差分包都要单独生成与验证。升级链路做错（脚本与内核版本组合不匹配）会出现反复升级甚至被平台禁止升级的情况，需要在平台上手工解除。处理步骤： 1. 列出设备当前版本与目标版本，规划中间版本序列。 2. 逐级制作差分升级包并实测。 3. 现场批量升级前先用少量设备验证。 4. 出现反复升级时，在 IoT 平台“我的设备 → 项目 → 解除禁止升级”中处理。参考文档：https://docs.openluat.com/air780epm/luatos/app/ota/fota/

25. Air8202G是否支持二次开发，为什么提示缺少各种.lua和不能大于128k？

解答： 结论：支持二次开发。提示缺少各种 .lua 是 lib 没放进去；iRTU 的 lib 属专用库，要到 Luatools 主界面的资源文件里取。说明：iRTU 工程依赖一批专用 lib，Luatools 把它们放在资源目录中，建工程时不勾选“添加默认 lib”（或没有把 lib 拷进工程）就会在运行时集中报缺少多个 .lua。至于 128k 的限制，指向的是脚本空间或文件系统的容量约束，需要按实际分区来规划工程体积。处理步骤： 1. 打开 Luatools 主界面，在资源文件中找到对应型号的 lib。 2. 建工程时勾选“添加默认 lib”，或手动把 lib 脚本拷入工程。 3. 固件选 iRTU 对应的版本。 4. 体积受限时按功能拆分脚本、精简资源文件。参考文档：https://docs.openluat.com/value/irtu/

26. Air780E/Air780EHM烧录时无法识别USB、不断重启，怎么排查？

解答： 结论：按“供电 → 线缆 → 焊接 → 硬件故障”的顺序排查，根因多数还是供电不足。说明：模组发射瞬时电流可到 1A 以上，USB 口或长线供电能力不足时会不断掉电重启，看起来就像“识别不到 USB”。其次是数据线只有充电线芯、没有数据线；再其次是焊接问题，例如引脚虚焊、连锡或底部焊盘连锡。处理步骤： 1. 换稳压电源或带供电的 USB Hub，确认电压稳定。 2. 换一根确认能传数据的 USB 线。 3. 用显微镜检查焊点，排除虚焊与连锡后重新焊接。 4. 以上都排除仍异常，寄回检测。参考文档：https://docs.openluat.com/common/Luatools/

27. Air780E模组做回流焊后再过波峰焊会不会影响焊接？

解答： 结论：没有影响，但要严格按官方炉温曲线来做，避免模块反复受热。说明：模块的耐热能力以官方 SMT 炉温曲线为准。双面都有器件时，官方建议先贴没有模组的那一面，第一面完成回流焊后再贴模组这一面，以减少模块的受热次数；真空密封袋开封后若存放条件（湿度、时间）满足要求，可以直接进行回流焊或其它高温流程，超期或受潮则要先按规范烘烤。处理步骤： 1. 按合宙模组 SMT 炉温曲线说明设定温度曲线。 2. 双面板先做没有模组的一面，再贴模组。 3. 开封超期或受潮时先烘烤再上炉。参考文档：https://docs.openluat.com/common/smt/

28. Air8000W模组USB插上电脑设备管理器无反应，测量电压异常怎么回事？

解答： 结论：优先怀疑焊接问题——引脚没焊上或底部连锡，建议重新焊接检查，仍不行寄回检测。说明：USB 插上电脑完全无枚举、同时测量电压又不正常，说明供电通路或数据触点没有真正连通，典型原因是焊点不良。Air8000 系列模组本身免驱（只有早期 Air724/Air795/Air720/Air722 需要装驱动），所以不必先往驱动方向找原因。处理步骤： 1. 用显微镜检查 USB 相关焊点与底部焊盘，排除虚焊与连锡。 2. 重新回流焊接后复测。 3. 确认供电电压确实到达模组引脚。 4. 仍无反应则寄回检测。参考文档：https://docs.openluat.com/common/usb_drv/

29. Air8380板子录音放音有杂音、录制数据量只有8000A的1/10是什么原因？

解答： 结论：先按对接同事给的方向验证——把 8000W 到 8380 的这一段 I2S 走线割断，直接飞线焊到 8000W 模块 PAD 上再测，用来排除这段走线带来的信号完整性问题。说明：录音数据量只有正常值的十分之一、同时伴随杂音，说明 I2S 上实际的位时钟或数据是断续的，常见原因是走线过长、过孔寄生参数导致时钟或数据边沿劣化。现场这段走线虽然只有一个过孔加 1.5mm，仍要按这个方式先做一次对照实验，才能确定问题出在走线还是别处。处理步骤： 1. 按建议割断走线，把信号直接飞到 8000W 模块 PAD 上。 2. 重新测量录音数据量与听感。 3. 若恢复正常，按最短走线、等长、包地的原则重新设计这一路 I2S。 4. 仍不正常时抓 I2S 波形与录音文件交给 FAE 分析。参考文档：https://docs.openluat.com/air8000/luatos/hardware/audio/

30. Air8602 WiFi版能否正常连接WiFi上网？

解答： 结论：可以。现场换另一台 Air8602 WiFi 版后连接恢复正常，说明方案本身没问题；单台连不上应按个体硬件排查。说明：单台连不上时优先怀疑天线连接、模块焊接或供电，而不是方案不支持。Air8602 的 4G 与 WiFi 是两套独立通道，WiFi 侧还要确认 SSID、加密方式、信道与信号强度是否匹配。处理步骤： 1. 用同型号另一台复测，先区分“方案问题”和“个体问题”。 2. 检查 WiFi 天线连接与模块焊接。 3. 核对 SSID、密码、加密方式与信道设置。 4. 确认是个体异常后寄回检测。参考文档：https://docs.openluat.com/air8602/product/

31. 合宙的IOT平台是APP这些吗？

解答： 结论：合宙 IoT 平台的主体是网页端云平台（iot.openluat.com）；各种 APP 客户端与整机方案是另外的产品线，不是平台本身。说明：云端负责设备归属、项目管理、数据上报与远程升级等能力，二次开发时通过 HTTP/MQTT 与平台交互。手机上看到的“APP”更多是具体整机产品配套的客户端或第三方客户端。具体要用到哪部分能力，先看平台页面上的功能划分最准。处理步骤： 1. 打开 iot.openluat.com，看平台的功能结构。 2. 明确自己需要的是“设备管理/数据对接”还是某个整机产品的客户端。 3. 需要 API 对接时向对接 FAE 索取接口说明。 4. 仍不确定时，到 docs.openluat.com 右下角 AI 提问。参考文档：https://iot.openluat.com/cloud/main

32. Air8784的SIP_cc如何实现设备与手机互打？

解答： 结论：SIP_CC 不是“设备直接拨手机”，而是设备作为桥把 SIP 侧音频与蜂窝电话侧接起来；前提是任务已下发成功、设备内插的是已实名且开通语音的 SIM 卡、对端软终端已用设备对端账号登录。说明：这条链路里设备相当于网关，把 SIP 通话与 SIM 卡的 VoLTE 电话互相接续。物联网卡只能上网、不能打普通电话，所以必须用实名并开通语音功能的手机卡。任务要在 SIP 控制台的“设备与手机（phone）”场景里配置，目标号码最多三个、11 位。处理步骤： 1. 在控制台“设备与手机”里建好 phone 任务并“检查并下发”。 2. 设备内插入已实名且开通 VoLTE 的手机卡。 3. 对端软终端用 IMEI+1 的账号完成注册登录。 4. 按设备 SOS 键触发呼叫，按配置顺序逐个拨打。 5. 不通时用日志里的信令定位（180 Ringing、200 OK、486 Busy Here）。参考文档：https://docs.openluat.com/air8784/software/default_factory_firmware/

33. Air724UG烧录有什么不同吗？

解答： 结论：没有变化，按 Air724UG 原有的烧录流程与文档操作即可。说明：Air724UG 属较早的平台，工具链与固件结构没有新变化；但它是 RDA8910 平台，内核与 AT 命令集和 Air780 系列不通用，固件包不能混用。抓日志时建议先禁用电脑的 RNDIS，再打开 Luatools 并勾选 4G USB 打印，否则容易看不到日志。处理步骤： 1. 按 Air724UG 的烧录文档准备对应固件与工具。 2. 禁用电脑 RNDIS，勾选“4G 模块 USB 打印”查看日志。 3. 不要混用其它平台（如 Air780 系列）的固件包。参考文档：https://docs.openluat.com/air724ug/

34. eSIM/SIM卡座接线图及设计注意事项？

解答： 尚未解答

35. Air1601/1602的485功能如何使用？

解答： 结论：用已更新的 485-uart demo 在开发板上跑通即可；注意拨码开关要拨到 ON 侧（其中 2、4 要拨到右边），485 与串口在板上是同一个串口的三选一用法。说明：开发板把同一路 UART 通过拨码开关切换到不同物理接口，同一时刻只能选中一种用途，选错就会出现“发了收不到”。485 是半双工总线，A/B 不要接反，终端电阻是否需要按总线长度与速率决定。处理步骤： 1. 把对应拨码开关拨到 ON 侧（2、4 拨到右边）。 2. 烧录 485-uart demo。 3. 用 USB 转 485 工具做收发对照测试。 4. 收发不通时先确认拨码位置与 A/B 极性，再检查终端电阻。参考文档：https://docs.openluat.com/air1601/luatos/app/mulu/modbus/

36. Air780EPM的ADC读取电池电压与万用表测量值差70mV是什么原因？

解答： 结论：属正常误差范围，不必专门处理；官方口径是 50mV 以内算正常，万用表本身也有误差。说明：ADC 读数误差来自参考电压偏差、分压电阻精度（常见 1%）、走线压降以及 ADC 自身的分辨率。电池电压一般经外部电阻分压后进 ADC，分压比的标称值与实际值差异会体现为固定偏置。要求更高精度时，可用实测值反推分压系数做软件校准。处理步骤： 1. 确认分压电阻精度与焊接质量，必要时用实测电压反推系数并在脚本中校正。 2. 用另一只万用表交叉验证，排除万用表自身误差。 3. 按被测电压范围选择 adc.setRange（0~1.5V 或 0~3.3V），注意与外部分压的搭配关系。 4. 需要更高精度时改用外部专用电量计。参考文档：https://docs.openluat.com/air780epm/luatos/app/driver/adc/

37. Air780EGP/EG2支持付费基站定位吗？

解答： 尚未解答

38. Air8201H的PWRKEY防抖配置后需要长按2秒以上才能开机，没配置则秒开，是什么原因？

解答： 结论：脚本里加了防抖后需要长按才能开机是设计上的正常行为；对短按就能开机的板子，可以先放电，排除电容残电导致的误判。说明：防抖的本质是把按键按下时间（或多次采样）作为有效条件，所以会比“一按下就开机”慢。Air8201G 这类整机固件里，短按 PWRKEY（<7 秒）触发一次立即上报，长按（≥7 秒）才是关机，按键语义本身就带时长区分。若个别板子短按即可开机，通常是电源轨上还有残电让开机判断提前成立。处理步骤： 1. 明确需要的按键语义（短按还是长按开机），据此保留或去掉防抖。 2. 断电后等电容放净再上电，或用假负载放电后复测。 3. 对比多块板子的表现，判断是否为个体硬件差异。 4. 必要时把原理图电源部分给 FAE 一起看。参考文档：https://docs.openluat.com/air8201/hardware/

39. 合宙有没有带蓝牙和六轴、板边和8201一样的开发板？

解答： 结论：没有现成的板子。六轴传感器的封装与板边布局对不上，需要扩板；有新产品需求可以和合宙电话沟通定制。说明：Air8201 系列本身带 BLE 5.2 蓝牙，Air8201G 整机里集成了三轴加速度计用于震动检测，但把“蓝牙加六轴”塞进与 8201 相同的板边尺寸，需要重新布局并更换封装，目前没有这个形态的开发板。处理步骤： 1. 明确需要的蓝牙版本、六轴型号与板边尺寸。 2. 现有开发板可先用于功能验证。 3. 需要定制板型时，联系合宙商务电话沟通需求。参考文档：https://docs.openluat.com/air8201/hardware/

40. Air780E最大功耗是多少？

解答： 结论：搜网、发射瞬间的峰值电流会冲到 1A 以上，供电必须留足余量，否则会因瞬时欠压重启。说明：峰值功耗出现在射频发射与搜网阶段，属短时脉冲；电源与走线应按峰值而不是平均值设计，否则现场会表现成“莫名其妙重启”。实际平均电流随驻网状态、业务类型与低功耗配置变化很大，不能只看单一数字。处理步骤： 1. 电源按 1A 以上的峰值电流留余量，并加大输入端电容。 2. 用稳压电源实测瞬时电流波形，确认电源不塌陷。 3. 出现重启先按供电方向排查，再看软件。参考文档：https://docs.openluat.com/air780epm/luatos/hardware/design/

41. 带WiFi的版本是哪个型号？

解答： 结论：带 WiFi 的是 Air8201 系列，具体型号从 Air8201 资料页入手确认。说明：Air8201 系列中不同子型号的无线能力并不相同（是否带蓝牙、气压计等），WiFi 与 4G 是独立通道。选型时要按目标场景确认型号后缀；只需要 4G 联网的场合，不带 WiFi 的型号成本更低、方案也更简单。处理步骤： 1. 打开 Air8201 资料页。 2. 按所需的无线能力（WiFi/蓝牙/定位）筛选子型号。 3. 型号确定后核对硬件手册与固件页。参考文档：https://docs.openluat.com/air8201/hardware/

42. 合宙有没有4G模块+GNSS二合一模块？

解答： 结论：有。要 AT 指令的选 Air780EGT，要 LuatOS 二次开发的选 Air780EGH/EGG/EGP 这类 EG 系列型号。说明：Air780EG 系列本身就是“4G + GNSS”二合一。新型号把 AT 与 LuatOS 做了型号区分：Air780EG2/Air780EGT 走 AT，其中 Air780EGT 为 8MB Flash + 8MB RAM、支持 1MB 以内的文件下载，EG2 为 4MB+4MB、支持 128KB 以内，除文件下载大小外两者一致；Air780EGP/EGG/EGH 面向 LuatOS。使用有源 GNSS 天线时注意 EGT/EG2 的 GNSS_VDD 是 PIN98（原 Air780EG 为 PIN8），需要改 PCB。处理步骤： 1. 按开发方式选择 AT（Air780EGT）或 LuatOS（Air780EGH 等）。 2. 用有源天线时核对 GNSS_VDD 脚位。 3. 按管脚对比表确认能否直接替换。参考文档：https://docs.openluat.com/atmozu/product/air780eg2egtvsair780eg/

43. 业务要卖到亚太（新马泰、印尼），需要换什么模组？SIM卡应如何处理？

解答： 结论：选支持亚太频段的型号（如 Air780EHU 这类欧亚版），SIM 卡使用当地运营商的卡并配置好 APN。说明：海外业务先看频段覆盖：频段由硬件决定、刷固件改不了，型号选错现场就是注不上网。选定型号后按当地运营商要求配置 APN，并核对实名与漫游政策；落地国家与运营商不同，覆盖情况也各不相同，要逐个核对。处理步骤： 1. 列出目标国家与运营商，对着频段页逐家核对。 2. 选定型号后确认管脚与认证要求。 3. 用当地 SIM 卡设置 APN 并实测驻网。 4. 覆盖有疑问时把清单发给对接 FAE 复核。参考文档：https://docs.openluat.com/air780ehnehu/product/air780ehufreq/

44. 升级服务器在国内，出口设备进行固件升级有问题吗？

解答： 结论：只要设备在目标国家能连上这台服务器就可以，服务器部署在哪里不影响升级本身。说明：FOTA 升级是设备主动发起的网络请求，关键在“可达性与稳定性”：跨境链路延迟高、丢包多，会拉长升级时间甚至中断；相比全量包，差分升级在小带宽下更稳。若当地访问确实慢，可考虑就近部署或分区域下发。处理步骤： 1. 在目标国家实测设备到升级服务器的连通性与下载速率。 2. 适当放大超时与重试策略。 3. 有条件时按区域就近部署升级服务。 4. 升级流程要支持失败回滚并保留日志。参考文档：https://docs.openluat.com/air780epm/luatos/app/ota/fota/

45. Air780EHU和Air780EPM是引脚兼容的吗？

解答： 结论：管脚兼容，脚本基本通用，但 Air780EHU 需要换成对应的底层固件。说明：两者同属 Air780Exx 系列，管脚定义按系列兼容性说明对齐，差别主要在频段与底层固件。频段属硬件差异，不能靠刷固件把国内频段改成欧亚频段，反之亦然。替换前务必按完整丝印型号逐脚核对再说。处理步骤： 1. 按模组丝印确认完整型号。 2. 用系列管脚兼容说明与对比表核对管脚。 3. 换成 Air780EHU 的底层固件再烧录。 4. 复测驻网与频段是否满足目标市场。参考文档：https://docs.openluat.com/air780ehnehu/product/air780exx/

46. 合宙的IOT平台有公司账户吗？

解答： 结论：有的。合宙 IoT 云平台支持公司账户，可联系对接销售申请开通。说明：公司账户与个人账户的差别主要在设备归属、多人协作与后台管理权限上。企业项目建议一开始就用公司账户，避免后期再迁移设备；账号即手机号，登录入口见参考文档。处理步骤： 1. 登录 iot.openluat.com 确认现有账号情况。 2. 向对接销售提交企业信息申请公司账户。 3. 开通后先梳理项目划分与设备归属规则，再批量入库。参考文档：https://iot.openluat.com/cloud/main

47. 5G模组有哪些？

解答： 结论：合宙目前没有 5G 模组，产品线集中在 4G Cat.1/Cat.4 以及 WiFi、蓝牙等方向。说明：绝大多数物联网场景用 Cat.1 就能满足，成本与功耗也更合适；确实需要高带宽的场合，可以先评估“4G 回传 + 本地高速链路”是否可行。后续产品规划以官方发布为准。处理步骤： 1. 到官方选型页确认现有型号。 2. 评估带宽与延迟需求能否用 4G 方案满足。 3. 有明确 5G 需求时对接销售了解规划。参考文档：https://docs.openluat.com/SelectionGuide/SelectionGuide/

48. 780EHT固件升级后老模组使用新固件开发的程序能下载到老模组吗？

解答： 结论：能。用新固件开发的程序可以下载到老模组上运行，前提是脚本依赖的核心库在老固件里都有。说明：脚本与内核是两层结构：脚本调用的是 Lua 层接口，只要老固件的核心库里包含程序用到的模块，程序就能跑；如果脚本用了新固件才新增的核心库或接口，老固件上就会报缺少对应文件或接口。所以真正要核对的是“程序依赖了哪些核心库”。处理步骤： 1. 列出程序依赖的核心库与接口清单。 2. 对照老模组固件版本页确认这些库是否都在。 3. 缺库时改用兼容的老接口，或升级老模组的内核固件。参考文档：https://docs.openluat.com/atmozu/product/shouce/

49. Air780EHM的irtu固件在哪里下载？

解答： 结论：到 iRTU 的固件下载页获取，按型号选择对应的 iRTU 固件包。说明：iRTU 是合宙的免二次开发方案，固件在 iRTU 固件页统一发布，页面按模组型号列出对应固件与版本；Air780EHM 这类模组选自己型号的那一项即可，不要混用其它型号的包。处理步骤： 1. 打开 iRTU 固件下载页。 2. 按模组型号找到对应条目。 3. 按页面说明用 Luatools 烧录。 4. 型号不在列表中时找对接 FAE 确认。参考文档：https://docs.openluat.com/value/irtu/firmware/

50. Air780EX的VSCode插件报client_agent_failed，LuatOS任务无法对话怎么办？

解答： 结论：该问题是服务端缺陷导致的，已经修复；把插件升级到最新版本，或重新发起一次即可恢复。说明：client_agent_failed 属插件与服务端通信阶段的错误，与本地代码、模组都没关系。插件与服务端都会持续迭代，遇到同类报错优先升级插件版本再复测。处理步骤： 1. 把 LuatOS 相关 VSCode 插件升级到最新版。 2. 重新登录或重启插件后重试。 3. 仍报错时把插件版本与完整报错日志发给对接 FAE。参考文档：https://docs.openluat.com/osapi/markdown/vscode/

51. Air780EPM固件DTU配置在哪里配置？

解答： 结论：DTU（iRTU）的参数配置在 iRTU 的状态与配置说明页；配置过程中卡住也可以先到 docs.openluat.com 右下角 AI 提问。说明：iRTU 走的是“网页端配置 + 参数下发”的方式，配置项与页面操作在 iRTU 文档的配置章节里。配置前先把设备归属到自己的 IoT 项目，否则参数下发不到设备。处理步骤： 1. 打开 iRTU 配置说明页。 2. 按页面在云端建立配置并下发。 3. 确认设备已归属到自己的项目。 4. 配置未生效时查看设备日志里的配置请求记录。参考文档：https://docs.openluat.com/value/irtu/state/

52. Air724UG设备在其它账号下，如何转移到自己账号？

解答： 结论：需要由设备当前所属方发起归属变更，并且要原所属公司盖章确认，个人无法单方面转移。说明：设备归属是平台侧的强绑定关系，转移属于账号与商务层面的事，技术手段改不了。若设备来自官方电商渠道，可以凭订单号与快递单号走自助归属流程；非官方渠道购买的要联系原渠道处理。处理步骤： 1. 先确认设备当前的归属账号。 2. 联系原所属方出具盖章的归属变更确认。 3. 按平台流程执行批量转移。 4. 电商渠道订单可先试 crm.luatos.com 的自助归属。参考文档：https://docs.openluat.com/air780epm/product/attributioniot/

53. Air780E远程升级后设备每天0点自动重启是什么原因？

解答： 结论：升级不是根因——关掉升级后现象依然存在，说明重启另有来源；建议在代码里搜索 reboot 相关调用，并把脚本发出来进一步定位。说明：定时重启通常来自脚本里的定时任务（例如定时到点执行重启）、看门狗超时，或电源在固定时段波动。“每天 0 点”这个时间点提示可能与时间同步后的定时逻辑相关，所以先查脚本里是否有按时间触发的重启动作。处理步骤： 1. 全局搜索脚本中的 reboot、reset 等调用。 2. 检查是否存在按绝对时间触发的定时任务。 3. 抓取重启前后的完整日志，确认重启原因码。 4. 把脚本与日志一并交给对接 FAE 分析。参考文档：https://docs.openluat.com/air780e/luatos/app/base/fota/

54. 合宙有没有SIM-021大卡座的接线图？

解答： 尚未解答

55. Air1601 UVC摄像头视频能否旋转？

解答： 结论：支持旋转，需要更新到最新固件；接口方法参考摄像头 demo 的配置。说明：旋转能力由固件侧的图像处理与显示接口提供，固件版本较低时可能还没有该接口，所以“先升级固件”是前提。硬件侧只是采集原始画面，旋转角度通过配置项设置。处理步骤： 1. 把 Air1601 固件升级到最新版本。 2. 在摄像头 demo 的配置里设置旋转角度。 3. 复测画面方向与帧率。 4. 配置项找不到时，对照固件版本页确认该版本是否已包含。参考文档：https://docs.openluat.com/air1601/luatos/hardware/

56. Air8201G/8202电池充不进电，电压上不去怎么办？

解答： 结论：先怀疑电池本身——容量太小或倍率限制（常见 0.5C/1C）导致充电电流超出电池允许范围、被保护 IC 反复关断；建议更换 900mAh 以上的电池。说明：锂电池的充电电流通常按容量倍数限定，电池容量偏小时，充电管理设定的电流可能超过其允许值，保护板会反复切断充电，表现就是“电压上不去、充不进电”。接插件接触不良或电池老化也会出现同样的现象。处理步骤： 1. 换 900mAh 以上的电池复测。 2. 核对充电电流设置是否超出电池允许倍率。 3. 检查电池接插件接触电阻与内阻。 4. 换电池后仍不充电，再查充电电路与电源芯片。参考文档：https://docs.openluat.com/air8201/product/8201_compare/

57. Air1601+Air780EHV带屏项目，USB插上不能烧录、电脑识别不到USB怎么办？

解答： 结论：先查原理图的 USB 部分——必须使用 CH343 的烧录线（CH340 不行），并且 RTS 引脚一定要接。说明：这类带屏方案的下载通道经过板载 USB 转串口芯片，芯片型号与握手信号都要对：CH343 支持更高的串口波特率，且 RTS 参与自动下载时序，漏接会导致工具无法让芯片进入下载模式。此外还要确认 USB 是直连还是经过 HUB、供电是否充足。处理步骤： 1. 换用 CH343 方案的烧录线。 2. 核对原理图中 RTS 已接到转串口芯片对应引脚。 3. 检查 USB 走线与供电。 4. 仍识别不到时看设备管理器是否枚举出串口，以区分硬件与驱动问题。参考文档：https://docs.openluat.com/air1601/luatos/hardware/

58. Air1601的USB转串口必须用CH343的6M USB吗？

解答： 结论：对，CH340 不行，需要用 CH343 的烧录线（支持 6M 波特率）。说明：下载与日志输出对串口速率有要求，CH343 支持更高的波特率；CH340 在高波特率下不稳定，会出现下载失败或日志乱码，因此工具链明确要求使用 CH343。接线时 RTS 必须接，否则工具无法控制芯片进入下载模式。处理步骤： 1. 换用 CH343 方案的烧录线。 2. 确认 RTS 已接。 3. 板载若是 CH340，需要改板或改用外部 CH343 转串口。 4. 换线后仍不行，检查驱动与端口枚举情况。参考文档：https://docs.openluat.com/air1601/luatos/hardware/

59. Air8602存件后点取件UI无反应、一直打印日志，是什么原因？

解答： 结论：UI 无反应现场几乎无法复现，可能与操作手法有关；触摸相关的打印日志已提交 issue 跟踪处理。说明：“一直打印日志”通常是触摸事件持续上报或触摸中断未正确清除导致的重复上报，看起来像卡在某个状态；UI 不响应也可能只是触摸位置或操作节奏的问题。既然复现概率接近零，重点应转到日志证据上。处理步骤： 1. 记录复现步骤与操作手法，尽量录屏留证。 2. 保存触摸持续打印时的完整日志。 3. 关注该 issue 的处理结论，固件更新后复测。 4. 再次出现时立即导出日志，便于定位。参考文档：https://docs.openluat.com/air8602/software/default_factory_firmware/

60. Air1601的aircloud一直重连、连上断开是什么原因？

解答： 结论：把设备归属到自己的 IoT 平台项目后就不再断开，根因是设备归属与项目不匹配。说明：aircloud 连接需要携带项目相关的身份信息，设备待在默认项目或未被正确登记时，平台侧会拒绝或中断连接，表现就是不停重连。归属正确后链路由平台正常接管。处理步骤： 1. 登录 iot.openluat.com，按 IMEI 查询设备归属。 2. 把设备转移到自己的项目。 3. 复测连接稳定性。 4. 仍重连时抓 aircloud 的连接日志与返回码，交给对接 FAE。参考文档：https://docs.openluat.com/air780epm/product/attributioniot/

61. 小程序存件后取件提示无效取件码是怎么回事？

解答： 结论：测试时取件码能正常输出、只是输入后提示无效，属功能验证尚未完成；建议按完整流程再测一轮，确认取件码的生成与校验是否一致。说明：“无效取件码”的关键是两端对不上：要么柜端生成的码与小程序提交的码在格式或时效上不同，要么提交时对应的取件记录已经失效。先做一次完整的存件到取件闭环，把柜端日志与小程序侧提示一起留证，再判断问题出在哪一端。处理步骤： 1. 重新走一遍存件到取件全流程并录像。 2. 记录柜端生成的取件码与小程序实际提交的内容。 3. 检查取件码的时效与所属柜号是否匹配。 4. 仍不一致时把日志提交给对接 FAE。参考文档：https://docs.openluat.com/air8602/software/default_factory_firmware/

62. Air780EPM的AGPIO做软I2C不工作，是驱动能力不够吗？

解答： 结论：不是驱动能力不够。I2C 需要外部上拉，先确认有没有做上拉，再用逻辑分析仪看波形。说明：I2C 总线是开漏结构，SDA/SCL 的高电平靠外部上拉电阻建立；任一端不做上拉，总线就会一直被拉低，表现为完全没有波形或一直为低。软 I2C 由 GPIO 模拟时序，本质上同样是开漏驱动，因此同样依赖上拉。处理步骤： 1. 在 SDA/SCL 上各加一只上拉电阻（常见 4.7K）。 2. 确认 AGPIO 已配置为普通 GPIO 功能。 3. 用逻辑分析仪抓起始位与 ACK。 4. 检查从机的 7 位地址与器件供电。参考文档：https://docs.openluat.com/air780epm/luatos/app/driver/gpio/

63. Air8601开发板烧录默认出厂固件后开机白屏是否正常？

解答： 结论：不正常，已经提 issue 记录跟踪。说明：正常情况上电后应很快进入界面；开机白屏说明显示初始化或背光时序存在问题。注意要区分“白屏”和“先白屏一小段再出画面”——后者是背光在 LCD 初始化之后立即点亮造成的，属正常现象。处理步骤： 1. 记录固件版本与完整开机日志。 2. 核对背光控制引脚的配置与接线。 3. 关注该 issue 的处理进展，固件更新后复测。 4. 仍白屏时把日志与屏幕型号给对接 FAE。参考文档：https://docs.openluat.com/air8601/software/default_factory_firmware/

64. Air1601固件和Air1603的pins配置问题？

解答： 结论：Air1601 固件在 Air1603 上能跑，但那只是型号名不同；Air1603 有独立固件，pins 配置要按实际型号来选。说明：Air1603 与 Air1601 的封装、管脚位置并不相同，用错 pins 会导致外设引脚对不上、功能异常。既然 1603/1604 有单独固件，建议直接用 1603 自己的固件与管脚配置，避免混用带来的隐性差异。处理步骤： 1. 到 Air1603 固件版本页取固件。 2. 在 Luatools 中选择 Air1603 的 pins 配置。 3. 确实要用 Air1601 固件时，同步切换到 1601 的管脚定义。 4. 功能验证以实际使用的型号为准。参考文档：https://docs.openluat.com/air1603/luatos/firmware/1603_version/

65. Air780EUSB连接Luatools无法显示日志，ap log port输出乱码怎么解决？

解答： 结论：99.9% 是供电不足；换稳压电源复测，并确认 Luatools 里勾选了 USB 打印。说明：模组搜网与发射的瞬时电流可到 1A 以上，供电能力不足时模组会反复掉电重启，串口随之输出乱码；日志窗口一直空白，则往往是没勾选“4G 模块 USB 打印”。这两件事经常同时出现，容易被误判成模组损坏。处理步骤： 1. 换稳压电源或带独立供电的 USB Hub。 2. 勾选“4G 模块 USB 打印”。 3. 换一根确认能传数据的 USB 线复测。 4. 仍异常时用“保存日志”导出完整日志交给 FAE。参考文档：https://docs.openluat.com/common/Luatools/

66. Air780E/Air780EHM无法识别USB、不断重启，如何排查？

解答： 结论：按“供电 → 线缆 → 焊接 → 硬件故障”的顺序排查，根因多数还是供电不足。说明：识别不到 USB、反复重启，最典型的还是供电问题——模组发射瞬时电流大，USB 口或长线供不上电就会不断掉电。其次是数据线只有充电线芯，再其次是虚焊、连锡等焊接问题。处理步骤： 1. 换稳压电源或带供电的 USB Hub，确认电压稳定。 2. 换一根确认能传数据的 USB 线。 3. 用显微镜检查焊点，排除虚焊与连锡。 4. 以上都排除仍异常，寄回检测。参考文档：https://docs.openluat.com/common/Luatools/

67. Air8000W模组USB无法通信，设备管理器无反应，怎么处理？

解答： 结论：优先怀疑焊接问题——引脚没焊上或底部连锡，建议重新焊接检查，仍不行寄回检测。说明：USB 完全无枚举、电压测量又异常，说明供电通路或数据触点没真正连通，典型原因是焊点不良。Air8000 系列模组免驱，不需要先往驱动方向找原因。处理步骤： 1. 用显微镜检查 USB 相关焊点与底部焊盘。 2. 重新回流焊接后复测。 3. 确认供电电压确实到达模组引脚。 4. 仍无反应则寄回检测。参考文档：https://docs.openluat.com/common/usb_drv/

68. Air780EHV的SIP功能是否支持TLS协议？

解答： 尚未解答

69. Air1603模组能否用于USB扫码枪？

解答： 结论：可以。扫码枪按 USB 键盘（HID）设备接入即可，Air1603 支持 USB HID 键盘与鼠标。说明：USB 扫码枪默认多工作在“键盘”模式，扫码结果通过 HID 键盘报文上报，等同人工敲键盘；把 Air1603 的 USB 置为 Host 模式并成功枚举设备后，脚本按键盘输入解析即可。若扫码枪被配置成虚拟串口模式，接法与解析方式都不同。处理步骤： 1. 把扫码枪设为 USB 键盘模式。 2. Air1603 的 USB 以 Host 方式连接扫码枪。 3. 脚本中按 HID 键盘输入解析结果。 4. 不通时先把枪插到电脑上确认其默认模式。参考文档：https://docs.openluat.com/air1603/luatos/hardware/

70. Air780EHU的irtu固件是哪个？

解答： 结论：Air780EHU 的 iRTU 固件同样到 iRTU 固件下载页获取，按型号选择对应版本。说明：iRTU 固件在固件页统一发布，页面按模组型号列出对应固件；Air780EHU 与 Air780EHM 属不同型号（频段不同），固件不能互相混用，选型时要按丝印型号严格对应。处理步骤： 1. 打开 iRTU 固件下载页。 2. 找到 Air780EHU 对应条目。 3. 用 Luatools 按页面说明烧录。 4. 型号不在列表中时找对接 FAE 确认。参考文档：https://docs.openluat.com/value/irtu/firmware/

71. Air8000T升级生成的.bin升级包，后台只让上传soc后缀的怎么办？

解答： 结论：该后台只支持 soc 格式，升级包需要按平台要求的形态处理后再上传。说明：FOTA 平台对升级包格式有校验，.bin 属于中间产物；内核升级包本身以 .soc 形式发布与烧录，脚本侧则走脚本升级通道。正确做法是：内核用官方 .soc 版本，脚本按平台支持的脚本包格式打包，不要直接把 .bin 传上去。处理步骤： 1. 先明确这次要升级的是内核还是脚本。 2. 内核升级包使用官方 .soc 版本。 3. 脚本升级按平台脚本包格式打包。 4. 包类型不确定时找对接 FAE 确认。参考文档：https://docs.openluat.com/air8000/luatos/firmware/

72. Air780EGH充电电流400多毫安，天线发热，充电时电压波动怎么办？

解答： 尚未解答

73. Air780E用6M的CH343才能烧录吗？

解答： 结论：对，CH340 不行，需要用 CH343 的烧录线（支持 6M 波特率）。说明：下载与日志输出对速率有要求，CH343 支持更高的串口波特率；CH340 在高波特率下不稳定，会导致下载失败或日志乱码。接线时 RTS 引脚必须接，否则工具无法控制芯片进入下载模式。处理步骤： 1. 换用 CH343 方案的烧录线。 2. 确认 RTS 已接。 3. 板载若是 CH340，需改板或改用外部 CH343 转串口。 4. 换线后仍不行，检查驱动与端口枚举。参考文档：https://docs.openluat.com/air1601/luatos/hardware/

74. Air780EHM快递柜项目中Air1601 UVC摄像头视频能否旋转？

解答： 结论：支持旋转，需要最新固件；接口方法看 demo 的 config.lua。说明：旋转能力由固件侧的图像处理与显示接口提供，旧固件可能还没有该接口，所以先升级固件再改配置。旋转角度在摄像头 demo 的 config.lua 里设置。处理步骤： 1. 把 Air1601 固件升级到最新版本。 2. 在摄像头 demo 的 config.lua 中设置旋转角度。 3. 复测画面方向与帧率。 4. 配置项不存在时，对照固件版本页确认该版本是否已包含。参考文档：https://docs.openluat.com/air1601/luatos/hardware/