常见问题 - 2026-09-25
数据日期：2026-09-25
1. 非官方渠道（如淘宝第三方店铺）购买的合宙模组是否有技术支持？
解答： 结论：没有技术支持，合宙的技术支持只面向官方店铺 luat.taobao.com 购买的产品。
说明：非官方渠道（淘宝第三方店铺、个人转卖等）购买时，合宙侧查不到该设备的购买记录与售后归属，因此不提供技术支持；模组是同一硬件，差别只在渠道归属。辨别与核验方式：① 官方店铺入口是 https://luat.taobao.com/ ，请从合宙官网或文档站公布的地址进入，不要经第三方链接跳转，以免误入同名店铺；② 收到货后核对模组正面丝印型号（如 Air780EPM、Air8000、Air795UG 等），到 https://docs.openluat.com/ 对应产品页比对规格与外观。
处理步骤：① 先确认购买渠道，非官方渠道建议退货，改到官方店铺重新购买；② 官方渠道购买的技术问题，按型号查阅文档站对应页面，或加入合宙官方企业微信群（文档站底部二维码扫码）提问，提问时附模组丝印照片、订单截图与固件版本号。
参考文档：合宙官方店铺 https://luat.taobao.com/ ，官方文档站 https://docs.openluat.com/ 。
2. AIR724UG 的 USB 连接是否需要安装 USB 驱动，在哪里下载？
解答： 尚未解答
3. 795UG 模块预设 APN 后在南非换卡仍无法使用，是否有出货到南非的案例？
解答： 结论：有客户出货到南非的案例，Air795UG 支持 4G/2G 双模与全球通频段，具备在南非使用的基础条件；预设 APN 后换卡仍无法使用，通常不是型号支持问题，而是 APN 配置或卡、运营商侧状态的问题。
说明：APN 与 SIM 卡绑定，国内公网卡基本不需要手工设置 APN，专网卡、定向卡和海外卡才需要按当地运营商配置；换卡后原来的 APN 记录不一定对新卡有效，且 APN 必须在 SIM 卡识别完成、入网之前就设置好，否则不生效。
处理步骤：① 海外卡建议用 mobile.apnTableInit() 与 mobile.apnTableAdd(mcc, mnc, ip_type, protocol, apn_name, user_name, password) 按当地运营商的 MCC/MNC 预置 APN，代码写在脚本开头、SIM 卡识别完成前执行，再用 mobile.apnTablePrint(mcc, mnc) 核对写入内容是否与运营商提供的参数一致；② 确认卡状态：是否已激活、是否欠费、是否支持国际漫游、是否被当地运营商限制，定向卡还要把业务域名加入白名单；③ 换一张当地运营商的卡做对比，排除卡接触不良与信号、频段问题；④ 若 APN 与卡状态都正常仍无法使用，保留模组型号、固件版本、SIM 卡 MCC/MNC 与完整串口日志，通过合宙官方企业微信群反馈。
参考文档：APN 相关接口 https://docs.openluat.com/osapi/core/mobile/ ，Air795UG 产品手册 https://docs.openluat.com/air795ug/product/shouce/ 。
4. AIR8781 模块串口1能收到 ^boot.rom 数据，但发 AT\r\n 没有返回，是什么原因？
解答： 结论：属于需要更新固件的现象，同时要确认固件类型与串口参数是否匹配。
说明：^boot.rom 是模组上电时 bootrom 打出的启动信息，Air780Exx 系列（Air8781P 板载的 Air780EPM 即属此类）的 UART1 在开机之初会固定输出一段系统 log，无法关闭；能收到这段数据说明芯片已正常启动、串口接收链路基本正常。这种情况下发 AT\r\n 无返回，通常是当前运行的固件不是 AT 指令固件，或固件版本异常需要重新烧录——例如模组跑的是 LuatOS 二次开发或 iRTU 串口透传固件，串口按业务数据透传处理，本来就不按 AT 指令解析。
处理步骤：① 先核对丝印完整型号（Air8781P 系列细分 Air8781P1/P2/P3/P4），确认该型号的应用形态；② 用 Luatools 核对并重新烧录固件：把工具切到下载等待界面，将 BOOT 与 VDD_EXT 短接后重新上电进入下载模式，首次烧录要同时选择底层 core 固件与脚本；③ 核对串口参数，包括波特率、数据位/停止位/校验位以及 TX/RX 是否交叉，UART1 的 IO 电平由 pm.ioVol() 控制，经典值为 1.8V/2.8V/3.3V，可承受上限 3.6V，对端为 5V 时必须加电平转换；④ 若刷入匹配固件并按正确串口参数仍无返回，保存固件版本号与完整串口日志，通过合宙官方企业微信群反馈。
参考文档：烧录与下载排查 https://docs.openluat.com/common/howtodown/ ，Luatools 教程 https://docs.openluat.com/common/Luatools/ ，Air8781P 资料 https://docs.openluat.com/air8781p/hardware/ 。
5. 有没有支持 IPv6 的 Cat.1 模组？
解答： 结论：合宙 Cat.1 模组（Air780 系列等）支持 IPv6，不需要定制固件，但 LuatOS 侧默认关闭，需要在脚本里主动开启；具体型号与固件的支持情况，以到 https://ai.luatos.com/ 咨询确认为准。
说明：IPv6 开关必须在 LTE 联网之前设置好，开启后开机联网会慢 2~3 秒；地址由运营商网络分配，能否真正用上 IPv6 首先取决于当地运营商是否下发 IPv6 前缀，可用 AT+CGPADDR? 查看 PDP 地址确认。
处理步骤：① 在 main.lua 的初始化阶段、LTE 联网之前调用 mobile.ipv6(true) 开启，可用 mobile.ipv6() 读取当前状态；② 联网就绪后用 socket.localIP(adapter) 的第 4 个返回值读取 IPv6 地址，能读到地址即说明网络侧已分配；③ 需要域名解析走 IPv6 时，socket.connect 的 need_ipv6_dns 传 true；④ 建议使用较新的正式版固件，并在目标运营商网络上实测；⑤ 需要确认某一具体型号或固件是否支持，到 ai.luatos.com 咨询，不要仅凭型号名推断。
参考文档：mobile 核心库 https://docs.openluat.com/osapi/core/mobile/ ，socket 核心库 https://docs.openluat.com/osapi/core/socket/ 。