常见问题 - 2026-08-29

数据日期：2026-08-29

1. Air780EPT 有货吗？怎么下单？

解答： Air780EPT 为常规供货型号，可直接在合宙官方渠道（淘宝店 luat.taobao.com、"降功耗找合宙"微信公众号商城及视频号小店）下单购买。若已与销售沟通好价格/数量，建议先下单但暂不付款，将订单号发给对接的工作人员改价，确认改价完成后再支付即可。选购前也可通过合宙产品选型指南确认型号是否满足需求：https://docs.openluat.com/SelectionGuide/SelectionGuide/

2. 运费怎么算？从哪里发货？

解答： 合宙官方店铺订单由四川眉山仓库发货，默认发顺丰快递；订单满 199 元包邮，不满 199 元收取运费 20 元（以实际下单时页面显示的运费政策为准，大件或特殊地区如有差异，可在下单前咨询淘宝店客服确认）。

3. DTU 怎么操作？以前的设备换IP不是要收费吗，现在DTU在哪里续费？

解答： 当前推荐使用新一代 iRTU 网页配置平台（原 DTU 模式），设备参数全部在网页端配置，设备每次开机时与后台同步一次配置，改完参数后重启设备即可生效。操作步骤： 1. 登录 iRTU 配置平台 https://iot.openluat.com/irtu/project-list （即 iot.openluat.com，先确保模组 IMEI 已归属到您的 IoT 账号的项目下，可在"我的设备"中按 IMEI 查询归属，淘宝店购买的设备可联系淘宝客服转移归属）； 2. 选择对应项目分组，点击"修改参数"配置串口透传、网络通道（TCP/UDP/MQTT/AirCloud）、APN、GPIO、GNSS 等，逐项提交后重启设备生效； 3. 功能说明文档：https://docs.openluat.com/value/irtu/state/ ，固件下载：https://docs.openluat.com/value/irtu/firmware/ 。关于续费：iRTU 配置平台本身免费使用，不按换 IP 收费；如您使用的是老平台 dtu.openluat.com（支持 Air724/Air780E/Air780EX/Air780EG，已停止更新维护），历史服务续费请在合宙官网/电商订单中查找对应订单的续费入口，或联系淘宝店客服/销售协助处理；新设备建议直接采用 iRTU 固件与新平台。

4. 下订单需要项目，这个项目在哪里添加？

解答： 这里的"项目"是指合宙 IoT 平台（iot.openluat.com）上用于管理设备归属、FOTA 远程升级和 iRTU 配置的项目分组，需要先在平台上创建。添加步骤： 1. 登录合宙 IoT 平台 https://iot.openluat.com （账号为手机号，初始密码 88888888，首次登录请修改密码）； 2. 进入"我的项目"页面，点击"新建项目"，填写项目名称后提交，即创建成功； 3. 设备归属：淘宝店购买的设备可在 https://crm.luatos.com 登录后，通过"客户服务→首次设置设备归属"，输入订单号和物流单号查询设备，勾选后批量设置到您的 IoT 项目下（详见 https://docs.openluat.com/air780epm/product/attributioniot/ ）；线下批量采购的设备会按发货时指定的账号归置，可在"我的设备"中用 IMEI 查询并"批量转移"到目标项目； 4. 项目创建并完成设备归属后，即可在 iRTU 平台（https://iot.openluat.com/irtu/project-list ）看到该项目下的设备并进行参数配置； 5. 若使用 LuatOS 二次开发做 FOTA 升级，脚本中的 PRODUCT_KEY 需与该 IoT 项目的项目 Key 保持一致。

5. 模块无法唤醒：拉低DTR再发送AT+POWERMODE="CLOSE"，休眠15秒能唤醒，休眠60秒就无法唤醒，是什么问题？

解答： 该现象基本可以判定为：休眠时间较长后模组进入了更深一级的功耗模式（PSM+），而 DTR 唤醒只在浅休眠（低功耗模式）下有效，所以出现"短休眠可唤醒、长休眠唤不醒"。原理说明（合宙 4G Cat.1 模组有三种功耗模式）： - 常规模式：CPU 满频、网络长连接在线，任意中断/串口均可唤醒； - 低功耗模式：网络保持长连接在线，可由串口数据、定时器、WAKEUP/PWRKEY 引脚唤醒，DTR 拉低配合 AT 指令唤醒属于此类场景； - PSM+ 模式：网络离线（类似飞行模式）、RAM 掉电，只能通过 WAKEUP 引脚、PWRKEY 引脚或深度休眠定时器 dtimer 唤醒，唤醒后程序从头运行；且进入 PSM+ 后普通 GPIO/外设驱动掉电，DTR 信号不再起作用。 15 秒时模组尚处于低功耗模式，DTR 可以唤醒；60 秒后模组按配置/网络协商进入 PSM+，DTR 即无法唤醒。排查与处理建议： 1. 确认当前休眠模式：若希望随时可被串口/DTR 唤醒，应使用低功耗模式（LuatOS 中 pm.power(pm.WORK_MODE, 1)；AT 固件用对应 POWERMODE 配置），不要进入 PSM+（pm.WORK_MODE, 3）； 2. 若业务允许长时间断网休眠、追求极低功耗（微安级），则改用 WAKEUP 引脚（下降沿/低电平中断）或 PWRKEY 唤醒，LuatOS 下可用 pm.dtimerStart(id, timeout) 设置深度休眠定时器定时唤醒，唤醒原因用 pm.lastReson() 判断； 3. 检查唤醒引脚是否接到了模组的 WAKEUP/PWRKEY 专用脚，普通 GPIO 在休眠态为高阻，不能唤醒； 4. AT 固件请以对应型号 AT 手册中 POWERMODE、DTR 唤醒相关章节的参数说明为准。低功耗模式详解与各型号教程：https://docs.openluat.com/common/airpower/ ；Air780EPM/EHM 低功耗教程：https://docs.openluat.com/air780epm/luatos/app/lowpower/sleep/

6. 今天AT+AIRLBS="query"获取不到定位信息，是否是服务器原因？一直超时408

解答： 超时 408 表示模组向定位服务器发起请求后在规定时间内未收到响应。经核实，该时段合宙基站/WiFi 定位服务（airlbs）所在机房确实出现过网络故障，导致定位请求无响应，目前服务已恢复。建议按以下步骤复测确认： 1. 先确认模组网络正常：AT 固件可通过查信号、注网状态、PING/HTTP 访问公网等方式确认数据链路通畅；LuatOS 下可用 socket/http 访问任意公网地址验证； 2. 专网卡/物联网卡若开通了定向 APN 白名单，需确认定位服务域名未被拦截，可换一张普通手机卡对比测试； 3. 重新执行 AT+AIRLBS="query"（LuatOS 下调用 airlbs 库请求），并确保室外/窗边等基站信号良好的环境测试，基站信息过少也会导致定位失败； 4. 若再次持续返回 408 或无结果，记录模组 IMEI、时间点和抓包日志，通过官方企业微信群或淘宝客服反馈给合宙技术支持核查。 airlbs 库说明：https://docs.openluat.com/osapi/ext/airlbs/ （免费单基站定位可使用 lbsLoc2 库：https://docs.openluat.com/osapi/ext/lbsLoc2/ ）。

7. docs.openluat.com 网站打不开/文档进不去，什么时候恢复？

解答： 该问题为合宙文档服务器所在电信机房的网络故障所致，故障期间 HTTP 方式可临时访问、HTTPS 受影响，经抢修后已全面恢复。如后续再次遇到文档站打不开的情况，建议按以下方式处理： 1. 先确认本地网络正常，可尝试切换网络（如手机热点）、更换浏览器或清除 DNS 缓存后重试； 2. 合宙资料与工具分布在多个站点，可临时使用：IoT 平台 https://iot.openluat.com 、LuatOS 源码仓库 https://gitee.com/openLuat/LuatOS （各型号 demo 在仓库 module 目录下）； 3. LuaTools 等工具下载如受影响，可稍后重试或在合宙官方企业微信群获取最新下载地址； 4. 若长时间无法访问，可通过合宙官方企业微信群（https://docs.openluat.com/ 网站底部二维码扫码加入）或淘宝店客服确认是否为站点维护/故障。

8. Air780EPM支持网线和4G吗？能不能二次开发时选择上网方式？

解答： 支持。Air780EPM 是国内全网通 4G Cat.1 模组（支持移动/电信/联通），硬件管脚上同时支持以太网（RJ45）接口，此外还支持 485、USB、CAN、UART、SPI、I2C 等接口。需要注意： 1. Air780EPM 只支持 LuatOS（Lua 脚本）二次开发，不支持 AT 指令、不支持 C-SDK；上网方式在 LuatOS 脚本中通过网络接口配置选择，4G 与以太网可按业务需求选用； 2. 以太网为模组外部接口，需在您的底板上设计网口电路（或使用合宙带网口的评估板/扩展板）配合使用，具体管脚定义参考 Air780Exx 系列管脚说明：https://docs.openluat.com/air780epm/luatos/hardware/design/air780exxpins/ ； 3. 若您需要"4G+WiFi+以太网"多网融合自动切换，建议关注 Air8000 系列（支持多网融合，4G/WiFi/以太网任一有网即可运行），Air8101 外挂 Air780EPM 也可实现以太网/WiFi 场景，参考 https://docs.openluat.com/air8101/luatos/app/network_routing/ 。产品介绍：https://docs.openluat.com/air780epm/product/

9. 780EPM可以烧录780EX2的固件，反之不行，有什么影响吗？

解答： 结论：不同型号必须烧录与自身型号严格对应的固件，不建议交叉烧录；即使个别方向能烧进去，也属于不被支持的用法，存在功能异常和稳定性风险。原因说明：合宙不同型号模组虽然部分硬件管脚兼容，但底层 core 固件与型号是一一对应的——固件中包含与具体硬件匹配的射频参数、外设驱动、资源配置（Flash/RAM 容量）和 BSP 标识。LuatOS 固件命名中即带型号信息（例如固件名由 PROJECT 与 rtos.bsp() 返回的模组型号拼接），型号不匹配会导致： 1. 外设驱动对不上（引脚复用、电压域、外设数量差异），出现 GPIO/串口/屏幕等工作异常； 2. 射频/协议栈参数不匹配，可能引起注网失败、功耗异常、掉线； 3. 资源越界，小容量型号烧大容量固件可能运行异常或无法启动； 4. FOTA 远程升级按型号与固件名校验，错配后将无法正常升级。建议： 1. 烧录时在 LuaTools 中选择与模组实际型号一致的固件包（固件发布页按型号分类）； 2. 已错烧的设备，请重新烧录回正确型号的官方固件恢复； 3. 若您在选型替代（如 Air780EX 系列升级到 Air780EPM/EHM），LuatOS 脚本层 API 基本兼容，可直接移植脚本，但 core 固件必须使用新型号对应版本。固件与型号对照可在各型号产品文档页查询，如 https://docs.openluat.com/air780epm/product/ 。

10. 想做只有定位和打电话、带屏幕、不要智能系统的产品，合宙哪款合适？

解答： 推荐使用 Air8000 系列（如 Air8000A）。它是合宙主推的 4G Cat.1 工业引擎，单颗模组即可同时满足您的三项需求，无需外挂智能操作系统（运行 LuatOS，Lua 脚本开发，非安卓/Linux 类智能系统）： 1. 打电话：支持 VoLTE 语音通话； 2. 定位：内置低功耗 GNSS，支持 GPS/北斗双模，也支持单北斗； 3. 屏幕：支持 SPI LCD（320×480 分辨率）、QSPI LCD（480×480），配合 AirUI/lcd 库可直接驱动； 4. 外设资源丰富：最多 60 个可编程 IO、最多 6 路串口，并支持以太网、485、232、USB、CAN 等工业接口；开发方式为 LuatOS 二次开发（不支持 C-SDK），demo 与文档齐全，可先购买 Air8000 开发板/核心板验证。产品介绍：https://docs.openluat.com/air8000/product/ ；完整选型可参考合宙产品选型指南 https://docs.openluat.com/SelectionGuide/SelectionGuide/ （其中"4G+语音二合一""4G+定位二合一"章节有各型号对比）。

11. 8000A的代码demo能发一个吗？

解答： Air8000 系列（含 Air8000A）的 demo 与源码全部开源在合宙官方 LuatOS 仓库的 module/Air8000 目录下，按功能分文件夹提供（如 gpio、uart、socket、mqtt、lcd、gnss、fota 等），可直接下载参考： https://gitee.com/openLuat/LuatOS/tree/master/module/Air8000 使用方法： 1. 按上述链接进入对应功能目录，下载 demo 脚本； 2. 用 LuaTools 烧录与 Air8000 对应的底层 core 固件（固件从各型号文档页或 LuaTools 在线获取），再下载 demo 脚本运行； 3. 配套 API 说明见 LuatOS 库函数手册 https://docs.openluat.com/osapi/ ，产品资料见 https://docs.openluat.com/air8000/product/ ； 4. 若希望免开发使用，Air8000 系列还有 iRTU_UI 固件（4G 数传+外设采集控制+UI 交互），源码在 https://gitee.com/openLuat/LuatOS/tree/master/module/iRTU/irtu_ui 。如打不开 Gitee，可在合宙官方企业微信群（https://docs.openluat.com/ 网站底部二维码扫码加入）获取帮助。

12. vscode的扩展老超时是不是和文档中心一个故障？

解答： 是的，属于同一原因。LuatOS 的 VSCode 开发插件（LuatOS 开发插件）需要联网访问合宙后台服务获取固件、文档和设备信息，当其后台服务与文档中心（docs.openluat.com）部署在同一电信机房时，机房网络故障会同时导致插件请求超时、文档站打不开，故障修复后两者均已恢复。后续如再遇到插件频繁超时，可按以下顺序排查： 1. 先确认 https://docs.openluat.com 与 https://iot.openluat.com 是否能正常打开——若均打不开，为服务端故障，等待恢复即可，可关注合宙官方企业微信群的故障通知； 2. 若网页正常而插件超时，检查本机网络/防火墙/代理是否拦截了插件请求，尝试关闭代理或切换网络后重启 VSCode； 3. 将插件更新到最新版本（插件市场搜索 LuatOS）后重试。插件介绍文档：https://docs.openluat.com/ai/luatos-dev-plugin/

13. 模组怎么测试海外环境？用国外卡需要配置APN吗？

解答： 结论：海外测试必须选用支持目标地区频段的模组型号，并使用当地运营商 SIM 卡；国外卡通常需要正确配置 APN 才能注网，国内三大运营商的普通物联网卡一般自动适配无需手动配 APN，专网卡/定向卡除外。具体说明与操作步骤： 1. 选对型号：合宙模组分国内版、欧亚版、北美版，频段不同。例如 Air8000 系列：国内型（Air8000A/W/D/T 等）支持 B1/B3/B5/B8/B34/B38/B39/B40/B41；欧亚型 Air8000U 支持 B1/B3/B5/B7/B8/B20/B28 等；北美型 Air8000N 支持 B2/B4/B5/B7/B12/B13/B17 等。海外销售前务必对照目标运营商频段选型，频段对照见 https://docs.openluat.com/air8000/product/pinduan/ ； 2. APN 配置： - 国外运营商 SIM 卡：一般需要手动设置 APN（向当地运营商索取 APN 名称、用户名、密码）。LuatOS 二次开发可用 mobile 库的 APN 配置接口设置；AT 固件用对应 APN 设置指令；iRTU 固件在网页配置平台"预置信息→APN 设置"中填写； - 国内普通物联网卡：模组开机自动获取运营商下发的 APN，无需配置； - 专网卡/定向 APN 卡：必须按卡商提供的专用 APN 配置，且要确认卡的白名单放行您要访问的服务器域名，否则会出现注网成功但连不上业务服务器的情况； 3. 测试方法：在目标地区实地插入当地卡测试注网、信号强度（RSRP）、数据收发；国内无法直接模拟海外运营商网络，可先做频段/射频一致性核对，再安排海外实测或寄样给当地客户验证； 4. 排查顺序：注网失败先查卡是否开通、APN 是否正确、频段是否支持、天线是否接好、信号强度是否足够。更多型号频段可查阅各产品介绍页及合宙产品选型指南 https://docs.openluat.com/SelectionGuide/SelectionGuide/ （"海外需求"章节）。

14. 固件 AirM2M_780EPM_V2005_LTE_AT 支持MQTT协议吗？

解答： 支持 MQTT 协议，但需要区分固件形态说明： 1. 合宙 4G 模组的 AT 指令固件内置了完善的协议栈，AT 指令集支持 TCP/UDP、HTTP、SSL、FTP、MQTT 等协议，因此 _LTE_AT 这类 AT 固件可通过串口发送 MQTT 相关 AT 指令直接实现 MQTT 连接、订阅与发布，无需外挂主控实现协议栈； 2. 但需特别注意：Air780EPM 目前官方主推 LuatOS 二次开发，产品资料明确说明 Air780EPM/EHM "只支持 LuatOS 二次开发，不支持 C-SDK，不支持 AT 指令"（见 https://docs.openluat.com/air780epm/product/ ）。固件名中带 _LTE_AT 后缀的属于早期 AT 固件形态，若您手上确有该版本固件，MQTT 指令的具体用法请以该版本固件对应的 AT 指令手册为准； 3. 官方推荐做法：使用 LuatOS 固件，直接调用 LuatOS 的 mqtt 库实现 MQTT 客户端（库文档 https://docs.openluat.com/osapi/core/mqtt/ ），demo 见 Gitee 仓库对应型号目录（https://gitee.com/openLuat/LuatOS/tree/master/module ），相比 AT 方式开发效率和稳定性更好。若您需要在既有主控 MCU 上以 AT 方式使用 MQTT，也可评估合宙仍提供 AT 固件的型号，具体以选型指南 https://docs.openluat.com/SelectionGuide/SelectionGuide/ 和各型号产品页说明为准。

15. RHU支持vSIM么？

解答： 先请与销售/技术确认一下型号全称：您说的"RHU"应为 Air780EHU（合宙 Air780E 系列中带 vSIM 特性的型号命名为 EHN/EHU 后缀）。合宙 Air780EHN/EHU 系列即为内置 vSIM（虚拟 SIM/eSIM，空中写卡、无需外置实体 SIM 卡）版本，支持 vSIM 业务。使用与核查要点： 1. vSIM 属于运营商资费业务，需在购买时向合宙销售明确开通 vSIM 版本及对应流量套餐（含国内/海外资费），模组出厂带 vSIM 配置后即可免插卡直接注网； 2. 硬件上该系列通常仍保留实体 SIM 卡座，vSIM 与实体卡按配置选用； 3. 具体型号的 vSIM 支持情况、开通流程和资费，请以合宙官方销售答复及该型号产品文档页为准（在 https://docs.openluat.com/ 对应型号目录查看，或通过官网底部企业微信群/淘宝店客服核实）； 4. 若您手里的是其他后缀型号（如 EPM/EHM/EHV），这些为标准实体卡版本，不带 vSIM，需要 vSIM 请在选型/下单时指定 EHN/EHU 等 vSIM 型号。型号选型可参考合宙产品选型指南 https://docs.openluat.com/SelectionGuide/SelectionGuide/ 。

16. AIR724UG不产了吗？还有类似或更好的产品吗？

解答： Air724 系列属于较早的 4G 型号，因其性价比和性能已不如当前主推型号，合宙对 Air724/Air780E 等老型号已不再做技术支持和固件更新，建议替换到当前主推的 Air780E 系列。官方替代建议如下： 1. 未用到音频功能的 Air724 应用：可用 Air780EPM 或 Air780EHM 替代（管脚兼容、LuatOS 脚本兼容，性价比更高）； 2. 用到音频（语音/TTS）功能：用 Air780EHV 替代（内置 Audio Codec，支持 VoLTE/TTS）； 3. 若您的产品是透传/工业控制类，希望免开发快速替换：可使用合宙工业模组 Air8782P（支持 UART/RS485/RS232 透传和 GPIO 控制，内置最小系统即插即用），或 Air8781P（UART 串口透传）；这类工业模组定位为透传与 IO 控制，不含摄像头、音频、蓝牙等多媒体功能。说明： - 新平台 iRTU（https://iot.openluat.com/irtu/project-list ）支持 Air780EHM/EPM/EGG/EGH/EGP/EHV、Air700ECP/ECH 及 Air8000 系列；老 dtu.openluat.com 平台（支持 Air724/Air780E 等）已停止维护，替代型号可在新平台使用； - 具体替代型号请结合您用到的功能（音频/摄像头/接口数量）对照合宙产品选型指南 https://docs.openluat.com/SelectionGuide/SelectionGuide/ 确认，或联系销售/官方企业微信群协助选型。

17. PROJECT加空格升级没问题，去掉空格后反而无法升级原设备，为什么？

解答： 这是 FOTA 升级的"固件名称匹配"问题：升级包与设备上报的固件名必须完全一致，而固件名中包含了脚本里的 PROJECT 变量，改了 PROJECT（去掉空格）就等于改了固件名，导致旧设备匹配不到升级包。原理说明：LuatOS 的 libfota2 远程升级中，上报给服务器的固件名称 firmware_name 默认由 _G.PROJECT .. "_LuatOS-SoC_" .. rtos.bsp() 拼接生成（即"PROJECT值_芯片/型号"）。使用合宙 IoT 平台升级时，平台按"项目 Key（PRODUCT_KEY）+ 固件名称 + 版本号"来匹配要下发的升级包： 1. 原来 PROJECT 带空格（如 "ABC DEF"）时，历史设备固件名就是带空格的字符串，平台上创建/上传的升级包固件名也是带空格的，二者一致，所以能正常升级； 2. 去掉空格后（如 "ABCDEF"），新烧录/新升级的设备上报的固件名变成不带空格的新名字；但您现场"原设备"里运行的仍是旧固件，它们上报的还是带空格的旧固件名。如果 IoT 平台上的升级任务/固件包是按新名字（无空格）配置的，旧设备按旧名字去查询时就找不到对应升级包，表现为无法升级。处理方法： 1. 保持升级标识一致：给存量旧设备升级时，PROJECT 不要改，继续使用与旧固件完全一致（带空格）的 PROJECT 与版本号，在 IoT 平台按原固件名上传升级包； 2. 若确实要改成无空格的新命名，需要做一次"过渡升级"：先用旧固件名发布一版固件（内部把 PROJECT 改为新值），让存量设备先升到该过渡版本，之后所有设备均为新固件名，再按新名字发布后续升级包； 3. 自查：在脚本中打印 _G.PROJECT、rtos.bsp()、_G.PRODUCT_KEY，与 IoT 平台"我的项目→固件升级"里配置的项目 Key、固件名称逐字符比对（注意首尾空格、大小写）；版本号需为 xxx.yyy.zzz 形式； 4. 自建 OTA 服务器则由您自行约定固件名/版本匹配规则，同样需保证设备上报参数与服务器升级包一致。参考文档：libfota2 库 https://docs.openluat.com/osapi/ext/libfota2/ ；Air780EPM FOTA 教程 https://docs.openluat.com/air780epm/luatos/app/ota/fota/ 。

18. 工具和文档都登录不了，LuaTools下载不了，什么时候恢复？

解答： 该问题为合宙服务器机房网络故障导致的工具登录、文档访问和 LuaTools 下载异常，故障已修复恢复。说明与临时处理建议： 1. LuaTools 烧录工具本身为本地软件，已下载安装的版本在离线状态下仍可进行固件烧录、脚本下载等本地操作，仅"在线获取固件/登录账号"等联网功能受影响，应急开发可先用本地已缓存的固件继续烧录； 2. 需要重新下载 LuaTools 时，可稍后重试官方下载，或在合宙官方企业微信群（https://docs.openluat.com/ 网站底部二维码扫码加入）获取最新安装包； 3. 账号登录（iot.openluat.com、crm.luatos.com）如遇异常，同样为服务端故障时等待恢复即可，故障恢复后用原账号（手机号）登录，密码遗忘可点"找回密码"重置； 4. 后续遇到类似情况，先确认是否多个站点（docs/iot/Gitee）同时无法访问——若是则为服务端问题，关注官方企业微信群通知，无需反复重装软件。 LuaTools 工具教程：https://docs.openluat.com/common/Luatools/

19. AIR5101S的资料能发一下吗？主要是引脚定义与硬件设计资料，网站打不开看不到。

解答： Air5101/Air5101S 是合宙 BLE 蓝牙模块（常作为 Air780E 系列等 Cat.1 模组的蓝牙外挂扩展，也可用于蓝牙 FOTA 升级），其规格书、引脚定义、硬件设计参考等资料在官方资料中心提供，网站恢复后可直接访问以下链接获取： 1. 硬件资料中心（规格书/原理图/PCB 封装/参考设计/引脚定义）：https://docs.openluat.com/air5101/product/shouce/ （若 Air5101S 专属页面未收录，该链接即为 Air5101 系列资料入口）； 2. 软件开发说明：Air5101 通过 LuatOS 的 exril_5101 扩展库驱动（封装了底层 AT 指令集），库文档 https://docs.openluat.com/osapi/ext/exril_5101/ ，其中含上电、UART 连接、AT/透传模式切换、低功耗与看门狗等说明； 3. demo 源码：LuatOS 仓库各型号目录下 demo/ble/ 内的 xxx_Air5101S 例程，仓库入口 https://gitee.com/openLuat/LuatOS/tree/master/module ； 4. 硬件设计要点：Air5101 通过 UART 与主控模组通信，硬件上需接好供电、UART 收发、天线并按规格书参考设计处理复位/上电时序。当前若文档站暂时打不开（机房故障已恢复，如再遇到可稍后重试），也可在合宙官方企业微信群（https://docs.openluat.com/ 网站底部二维码扫码加入）直接向技术支持索取规格书和引脚定义文件，或淘宝店客服获取。

20. 有通过USB给其他Linux设备联网的模块吗？

解答： 有，推荐 Air8783（USB 上网卡/4G Dongle 形态，同时支持短信转发）。它通过 USB 接入 Linux 等主控设备后，将自己枚举为标准 USB 网卡（RNDIS/ECM），主控无需开发、免驱或按系统标准网卡拨号即可直接上网，即插即用，适合给运行 Linux/安卓的设备扩展 4G 联网能力。使用要点： 1. Air8783 产品与使用说明：https://docs.openluat.com/air8783/product/ ，配置说明 https://docs.openluat.com/air8783/product/config/ ； 2. 若您是在自有产品设计中集成，合宙 4G 模组也支持将 USB 枚举为 RNDIS/ECM/PPP 网卡供主控使用（此类"网卡上网界面"主控不需要做额外开发），可参考模组使用说明 https://docs.openluat.com/common/module_intro/ ； 3. 选购与样品见合宙淘宝店 https://luat.taobao.com/ ，海外使用请确认频段支持或选择对应海外版本。

21. 有没有模组是接收指令然后发数据的，不需要开发？

解答： 有，使用合宙 iRTU（免开发透传）固件即可实现"无需写代码"：设备在网页配置后台设置好串口/网络参数后，模组收到串口数据就自动转发到服务器（或把服务器下发的数据从串口发出），也支持 GPIO 控制、GNSS 定位、定时采集等行为逻辑配置。具体说明： 1. 串口透传（UART/TTL，以及 RS485、RS232）免开发：合宙提供现成的工业模组硬件，如 Air8781P（UART 串口透传）、Air8782P（UART/485/232 透传，带 GPIO），烧录 iRTU 固件后在网页后台配置即可，一行代码都不用写； 2. 支持的网络通道：TCP、UDP、MQTT、AirCloud 四种，服务器地址、串口波特率/数据位/停止位/校验、485 转向脚、APN、GPIO、GNSS 等均在网页配置（设备每次开机时与后台同步一次配置，改完重启生效）； 3. SPI/I2C 等外设不在 iRTU 免开发配置范围内，如需驱动 SPI/I2C 外设（传感器、屏幕等），需要用 LuatOS 二次开发； 4. 配置平台 https://iot.openluat.com/irtu/project-list （支持 Air780EPM/EHM/EGG/EGH/EGP/EHV、Air700ECP/ECH、Air8000 系列），功能说明 https://docs.openluat.com/value/irtu/state/ ，固件下载 https://docs.openluat.com/value/irtu/firmware/ ； 5. 项目逻辑复杂、需要频繁调用接口时，iRTU 固定逻辑可能不满足，建议改用 LuatOS 二次开发（demo 齐全、更灵活）。

22. 这个带线的鳄鱼夹还能不能买到？

解答： 带线鳄鱼夹（测试夹/电源夹，常用于开发板供电、调试接线）属于调试配件，是否在售以合宙官方淘宝店实际上架情况为准。建议按以下方式确认与购买： 1. 在合宙官方淘宝店 https://luat.taobao.com/ 搜索"鳄鱼夹/测试夹/电源测试线"，查看是否有对应商品及库存； 2. 也可在"降功耗找合宙"微信公众号商城/视频号小店检索同类配件； 3. 若店铺未找到，可直接联系淘宝店客服或您对接的销售，提供该配件照片/用途说明，确认是否可随核心板、开发板等一起下单（部分调试线为随板附赠或可单独索取）； 4. 此类通用测试夹为市售标准配件，也可在电子元器件/工具渠道按规格（线长、夹口、电流承载）自行采购，用于给模组供电时请注意线径满足 4G 发射瞬态电流需求，避免线损导致电压跌落重启。

23. 用三颗5号电池，电压经得住么？

解答： 结论：三颗 5 号电池（AA）不建议也通常无法可靠地直接给 4G Cat.1 模组供电，主要瓶颈是供电电压范围和瞬态电流，而不是平均电流。原因说明： 1. 4G 模组的推荐供电（VBAT）一般在 3.3V~4.3V 区间，典型标称 3.8V；三颗 AA 电池：碱性新电池约 1.5V×3=4.5V（略偏高），放电过程中快速下降，单节放到约 1.0V 时总压仅约 3.0V，已低于模组最低工作电压，放电中后期会欠压； 2. 更关键的是瞬态电流：4G 发射瞬间电流可达数百毫安至 2A 量级的脉冲，AA 干电池（尤其碳性/旧电池）内阻大、带载能力弱，大电流瞬间电压会被拉垮，导致模组反复重启/注网失败。官方功耗测试均以 3.8V 稳压电源为条件； 3. 平均电流虽不大（常规模式约 7~8mA、低功耗模式 1.5~2mA、PSM+ 模式 3~12μA，见 https://docs.openluat.com/common/airpower/ ），但电池选型必须按瞬态脉冲电流设计。可行建议： 1. 电池供电的标准方案是单节锂电池（3.7V 标称，满充 4.2V）配合电源管理/充电芯片，并在 VBAT 就近并联大容量低 ESR 电容（如几百 μF~1000μF 钽电容/电解+0.1μF 陶瓷电容）提供发射瞬态电流，合宙带锂电池座的工业模组（如 Air8780 等）即为此设计； 2. 若一定要用干电池，请选能量型锂铁电池（Li-FeS2，1.5V，内阻小）并配合足够储能电容与升压/稳压电路，同时软件上使用低功耗模式/PSM+ 降低平均功耗、拉长上报间隔；即便如此，也需实测发射瞬态电压跌落，确认不低于模组最低工作电压； 3. 务必用示波器在 VBAT 端实测发射（注网/发数据）瞬间的最低电压，验证无跌落重启。低功耗与供电设计参考：https://docs.openluat.com/common/airpower/ ；各型号硬件设计指南见对应型号产品页"硬件设计"章节。

24. 780EPM的UBOOT按键测出来电压只有2.6V，可能是什么问题？

解答： BOOT 按键（对应模组下载/启动配置脚）在正常状态下应被上拉到模组 IO 电源电平（通常为高电平），按下时拉低进入下载模式。测到 2.6V 属于电平异常，说明该引脚被外部电路分压、漏电或测量方式影响，建议按以下步骤排查： 1. 对比测试：取一块合宙官方 Air780EPM 核心板/开发板，在同样的测试点、同样的万用表和供电条件下测量 BOOT 脚电压。若官方板为正常高电平（接近 IO 电源电压），则问题出在您的底板电路；若两块板读数接近，可能是测量方法问题（见第 4 点）； 2. 查底板电路：对照 Air780Exx 系列管脚说明（https://docs.openluat.com/air780epm/luatos/hardware/design/air780exxpins/ ）和官方参考设计原理图，检查 BOOT 引脚上是否多接了下拉电阻、外设、按键分压电阻或与其他信号短路；该脚通常只需一颗上拉电阻 + 按键到 GND，不应有额外负载； 3. 查供电与焊接：确认模组供电电压正常且无跌落，检查 BOOT 脚及周边是否虚焊、连锡、受潮漏电或被强外设倒灌；可断开底板上该脚的外围元件后单独测量模组侧引脚电平； 4. 排除测量误差：万用表内阻有限，若该脚外接了较大阻值的上下拉电阻，万用表本身会形成分压回路导致读数偏低；建议用示波器（高输入阻抗）测量，并在模组正常运行、按下按键、上电瞬间三种状态下分别观测波形； 5. 验证功能：直接做下载测试——按住 BOOT 键再上电/复位，看 LuaTools 能否进入下载模式。若能正常下载，说明引脚逻辑功能正常，重点排查测量点与外围；若无法进入下载，基本可确定为该脚电平被外部拉低或硬件焊接问题。若对比官方板仍异常且排除外围问题，请记录供电电压、万用表/示波器读数、原理图该脚连接，通过官方企业微信群反馈合宙技术支持。