常见问题 - 2026-08-01
数据日期：2026-08-01
1. AIR780EPM USB下载过程中突然断电/断掉，下载失败，重新连接USB识别不了，有什么办法恢复？
解答： 可以恢复。下载中途断电会导致 Flash 中固件不完整、模组无法正常开机枚举 USB，此时需要强制进入 USB 下载模式（Boot from USB）重新烧录。
操作步骤： 1. 将模组的 USB_BOOT 管脚（Air780EPM 为 PIN82，开机初始化前默认为输入下拉）上拉至 VDD_EXT（3.3V 域，勿直接接高于 3.6V 的电源）后再上电/复位，模组即进入 Boot from USB 下载模式； 2. 在电脑设备管理器中确认出现 USB 下载端口，打开 Luatools，选择正确的 SOC（Air780EPM）和固件，重新下载； 3. 烧录完成后断电，去掉 USB_BOOT 管脚上的上拉（悬空或外部下拉即为 Boot from Flash），再重新上电即可正常启动。
若上拉后电脑仍提示 USB 设备无法识别，可更换数据线/USB 端口、重装 Luatools 驱动后重试。
2. Airtalk平台鉴权超时/无法登录是什么原因？
解答： 鉴权超时/无法登录本质是设备与平台之间的 MQTT 链路未建立或被断开。平台侧鉴权流程为：设备联网后先通过 HTTPS 调度接口获取 MQTT 接入地址与鉴权凭据（用户名为 IMEI、密码为 MUID），再建立 MQTT 长连接并向鉴权主题上报；若短时间内频繁请求、重复登录或网络抖动导致连接异常断开，可能触发平台侧限流，表现为鉴权超时。
排查建议： 1. 先确认设备 4G 网络正常（信号、网络注册、PDP 激活），可用 MQTT 客户端工具（如 MQTTX）测试平台地址和端口是否可达，排除服务器侧故障； 2. 检查设备 IMEI/MUID 是否正确、设备是否已在平台绑定归属，凭据错误时调度接口不会分配接入资源； 3. 降低登录/重连频率，增加断线重连退避间隔，避免大量并发操作触发限流； 4. 若确认是平台侧限流导致，稍等数分钟后重试即可恢复；反复出现时请保留 Luatools 完整日志联系合宙技术支持核查。
3. AIR8000手工焊接有门槛，推荐哪款好焊接的型号？
解答： AIR8000 为 22mm×22mm 的 LCC 封装，管脚密集，手工焊接确实有门槛。若希望手工焊接更容易，可选用合宙 Air878X 工业模组系列（如 Air8780/Air8781）或 Air8700 系列，其管脚间距与封装更适合手工焊接，且属于成熟硬件方案、可直接搭配核心板评估。
建议： 1. 手工焊接优先选邮票孔/半孔引出的核心板或工业模组，配合热风枪与助焊剂操作； 2. 批量产品建议直接走 SMT 贴片，合宙提供 SMT 炉温曲线参考（https://docs.openluat.com/common/smt/）； 3. 具体型号以合宙产品选型指南（https://docs.openluat.com/SelectionGuide/SelectionGuide/）及选型手册中的封装尺寸为准，可在 https://luat.taobao.com/ 选购核心板先做焊接验证。
4. 780EPG使用Luatools打印日志正常，但烧写Lua代码总是提示下载失败，怎么排查？
解答： 1、检查USB线供电是否充足；2、检查选择的SOC是否匹配；3、查看Luatools日志里面显示的原因；也可以关闭电脑蓝牙试试，或更换Luatools版本。
5. 780EHV的音频输出直接供功放，启动时有很重的POP声，有什么优化建议？
解答： 启动 POP 声主要来自音频通路在上电/初始化瞬间的直流跳变：功放使能时编解码芯片尚未稳定、或功放电源不受控，突变信号被功放放大输出。
优化建议： 1. 硬件上（最有效）：将编解码芯片和音频功放的电源（使能脚）交由模组 GPIO 控制，模组初始化音频通路后再打开功放使能，关机/静音时先关功放； 2. 软件上：音频初始化完成后再将音量由小到大渐变（audio.vol 必须在 audio.config/exaudio.setup 初始化成功后调用才生效），避免开机即满幅输出； 3. 先烧录官方音频 demo 验证：若 demo 下无 POP 声，说明是应用初始化时序问题；若 demo 下同样存在，基本可确定为硬件上电时序问题，需调整功放使能时序或加 RC 吸收/隔直电容； 4. 参考音频库文档说明：https://docs.openluat.com/osapi/ext/exaudio/ （exaudio.setup 注意事项明确建议编解码器与功放电源由模组控制以降低 pop 音）。
6. AIR8781P使用IRTU固件时支持RNDIS吗？
解答： IRTU固件不支持，但8781P本身支持RNDIS，需要自己手动打开，可用mobile库配置；如果只需RNDIS功能，也可以选780ER2。
7. 网络连接失败是什么原因？是否一定要加锂离子电池才行？
解答： 联网失败与是否加锂离子电池没有必然关系，电池只用于供电保持/低功耗场景，正常外部供电即可联网。联网失败应按网络注册流程排查： 1. 查看 Luatools 日志中的信号质量（CSQ）与网络注册状态，确认信号良好、已完成注网和 PDP 激活； 2. 确认 SIM 卡正常（未欠费、已开通数据业务，物联网卡注意机卡绑定/APN 设置），必要时换手机卡对比测试； 3. 检查天线连接与驻留情况，弱信号/天线不匹配会导致附着失败； 4. 若设备处于低功耗（PSM+）模式，需通过唤醒脚（如 WAKEUP 按键）唤醒模组后再发起联网，唤醒后联网发数据成功即说明此前是模组休眠未联网，而非供电问题； 5. 仍无法联网时，抓取完整开机注网日志，对照 socket/mqtt 教程中的错误码（如 ERR_ABRT、ERR_RST）定位。
8. air780e和air780evt能不能互换？只用到AT通讯上传数据功能。
解答： 仅使用 AT 指令做数据上传时，可以互换替代。Air780EV/Air780EVT 与 Air780EPT 同属 Air780Exx AT 系列，封装尺寸一致（16×18×2.3mm）、频段相同（全网通 B1/B3/B5/B8、B34/B38/B39/B40/B41），AT 指令集兼容；差异主要在功能配置（如音频等外设资源）上。
选型建议： 1. 不使用音频功能时，可选用更具成本优势的 Air780EPT； 2. 替代前需核对管脚复用、外设占用（如 UART、SIM 卡、电源）是否与现板一致； 3. 替换后务必用实际业务做联网、数据上传与长时间稳定性测试验证。
产品手册与封装参考：https://docs.openluat.com/atmozu/product/shouce/
9. 老的air724模块二次开发时，模组内部收到了短信但不触发sms.setNewSmsCb回调，是什么原因？
解答： 模组已收到短信但不触发新短信回调，说明短信链路正常、问题出在回调注册或回调前置条件上。按以下方向排查： 1. 回调注册时机：必须在短信功能就绪后再收发短信。LuatOS 中应等待 SMS_READY 消息（SIM 卡注册网络后底层发出）后再注册/使用，未注网前设置可能不生效； 2. 运营商与固件匹配：电信卡的短信功能与 CC（VoLTE 通话）核心库为伴生关系，只有支持 CC 的固件才支持电信卡短信；移动/联通卡全网通模组默认支持；若使用电信卡，请确认固件包含 CC 功能； 3. SIM 卡业务：部分流量卡未开通短信业务，可换普通手机卡发短信对比验证； 4. 长短信机制：长短信需所有片段接收完成后才触发一次回调，不会每条片段都触发，确认测试发送的是普通短信； 5. 回调写法：确认回调函数已正确设置（LuatOS 为 sms.setNewSmsCb(func)，回调参数为 num, txt, metas），且脚本中没有语法错误导致注册代码未执行； 6. Air724 为老款 2G/GSM 模组，使用的是 LuatOS-Air（老脚本体系），其短信回调 API 与新版 LuatOS 不同，请以该模组对应的老版本文档/demo 为准核对函数名与用法。
短信库文档参考：https://docs.openluat.com/osapi/core/sms/
10. 8101模块部分烧录后调试报错、MCU没反应是什么原因？
解答： “烧录后调试报错、MCU 没反应”多数是程序未真正运行或型号/固件不匹配导致。按以下步骤定位： 1. 先用最简 demo（如点灯/hello 打印）烧录测试：若最简 demo 也不运行，说明是固件/烧录/硬件问题而非业务代码问题； 2. 确认模组具体型号是 Air8101 还是 Air8101B（Air8101B 核心板未对外销售），二者固件不能混用，Luatools 中 SOC 必须选择一致； 3. 烧录时勾选“清除 FS（文件系统）”和“清除 KV（掉电保存参数区）”，旧分区数据/参数残留会导致新程序启动异常；Air8101 可直接进入烧录，必要时进 BOOT 模式重烧； 4. 更新最新版 Luatools，删除 _temp 缓存后重试； 5. 若以上软件排查均无效，可能是模组硬件个体问题，更换模组验证——本次案例最终更换模组芯片后恢复正常。
11. 有没有AIR8300两个网口的Lua脚本例程？
解答： 有，例程在https://gitee.com/openLuat/LuatOS/tree/master/module/Air8000/project/Air8300；一个网口做WAN一个做LAN，在exnetif里面改配置。
12. AIR8000W基于串口10的RS485通讯不正常，而串口12正常，为什么？
解答： 串口10是debug口，只能用来抓日志，不能用于RS485通讯；11和12可以通信。
13. 需要选一款含定位的4G模组，定位精度5m以内、支持MQTT、低功耗电池供电，哪个型号合适？
解答： 需求为“4G + 定位 + MQTT + 低功耗电池供电”，属于 4G+定位二合一场景，合宙选型指南中对应 LuatOS 二次开发的 Air780EGP/EGG/EGH 系列与超低功耗定位的 Air8201 系列。
选型建议： 1. 嵌入自有系统做二次开发：可选 Air780EGP（4G+GNSS 定位），支持 MQTT 等 LuatOS 全功能，配合 PSM+/低功耗模式可实现电池长期供电； 2. 追求超低功耗、独立成品快速落地：可选 Air8201 系列（超低功耗定位工业模组），GNSS 空旷环境定位精度 2~3 米；免开发场景可选 Air8202G 定位器（插电池即用，搭 iRTU/AirCloud）； 3. 精度说明：GNSS 在空旷室外环境可达 2~5 米，室内/遮挡场景需配合 LBS 基站/WiFi 定位（精度约 50~1500 米），5 米以内指标需保证室外开阔天空条件； 4. 低功耗电池供电需结合 PSM+ 模式与定位上报策略设计。
完整型号对比见合宙产品选型指南：https://docs.openluat.com/SelectionGuide/SelectionGuide/
14. Air780进入PRO/PSM+模式后，UART每秒输出的脉冲可以关掉吗？
解答： 关不了，进入PSM+模式不受控制，可以外接弱上拉或下拉抵消。
15. AIR8000A配3.5寸屏和911触摸，触摸和显示调转180度怎么调整？
解答： 显示和触摸方向都可以软件调整，旋转 180° 用 LCD/触摸库的方向设置接口即可，无需改硬件。
调整要点： 1. 显示方向：初始化 LCD 后调用 lcd.set_direction(lcd.direction_180)，参数可选 lcd.direction_0/90/180/270； 2. 触摸方向：触摸驱动（tp/extp）需与显示方向保持一致，按所用触摸 IC（如 GT911/GT9271、cst816d 等）在触摸初始化配置中设置对应的旋转/坐标翻转参数，使触摸坐标与显示坐标同步旋转 180°； 3. 使用 exeasyui/airui 等图形框架时，在 ui.hw_init 的硬件初始化配置中统一设置显示与触摸方向。
LCD 核心库接口文档：https://docs.openluat.com/osapi/core/lcd/ ；Air8000 LCD 应用例程：https://docs.openluat.com/air8000/luatos/app/accessory/AirLCD_1010/lcd/
16. 780EPM的固件版本哪个是最新发布的？怎样选择固件版本？
解答： V2046是固件版本，后面的1号、2号是固件类型，不同类型功能不同，可通过https://docs.openluat.com/air780epm/luatos/firmware/780epm_version/ 查看。
17. 启动Luatools总弹出提示是什么意思？
解答： 启动时弹窗提示一般是当前 Luatools 版本过低、需要更新（过旧版本在线更新可能失败）。处理方法：到官方工具页面下载最新版 Luatools 重新安装即可，新版同时会更新内置固件列表、驱动和下载逻辑。
下载与教程地址：https://docs.openluat.com/common/Luatools/ 。若在线更新失败，直接下载最新安装包全新安装；安装后仍异常可删除 Luatools 目录下 _temp、log 文件夹后重启工具。
18. 使用自定义字库运行4个多小时模组死机，是怎么回事？
解答： 自定义字库本身只是字体数据文件，运行数小时后才死机，通常不是字库内容直接导致，而是长时间运行中内存泄漏/内存越界累积、或字库加载方式占用资源所致。排查方向： 1. 内存监控：在脚本中周期打印 rtos.meminfo()（总内存/已用内存/历史最高已用内存），观察死机前内存是否持续单调增长直至耗尽； 2. 字库加载方式：自定义字体文件（.bin）应随脚本烧录放在 /luadb/ 目录按需加载，避免重复加载/重复申请缓冲区不释放；显示刷新用缓冲区大小为 宽×高×2 字节，确认字库与显示缓冲区合计未超出 RAM； 3. 代码泄漏：检查绘图/文本刷新任务中是否有字符串拼接、定时器/回调重复注册、zbuff/文件句柄未关闭等累积问题； 4. 先烧录官方自定义字体 demo（AirLCD 例程中的 customer_font_page）做长时间老化测试：若 demo 不死机，问题在业务代码；若 demo 也死机，抓取死机时 Luatools 日志/errDump 异常上报联系技术支持； 5. 字库生成与使用参考《LuatOS 字体使用说明》：https://docs.openluat.com/common/luatos_font_guide/
19. Air780E发布数据时出现+CME ERROR: 767错误，数据大小4020字节，可能是什么原因？
解答： +CME ERROR: 767 通常出现在通过 AT 指令（如 socket/MQTT 发送）一次性发送较大数据、或发送过快时，底层协议栈缓冲区/流控未就绪导致发送失败。4020 字节已接近单次发送缓冲上限，容易触发该错误。
处理建议： 1. 分包发送：把 4020 字节拆成小包（建议每包 1KB 左右，UDP 单包不要超过 1460 字节）逐包发送，不要一条指令发整包； 2. 加流控延时：每发完一包等待发送成功返回（OK/+CME 正常响应）后再发下一包，包与包之间留出间隔，避免连续灌入； 3. 确认链路状态：发送前确认 PDP 已激活、socket 连接正常、信号良好，弱网下应加重发与退避机制； 4. LuatOS 二次开发建议直接用 socket/mqtt/libnet 库发送（TCP 模式下 RAM 足够时单包长度无严格限制，底层自动分片），比 AT 指令手工拼包更稳定； 5. 若在 LuatOS 环境出现类似发送失败，对照 socket 教程错误码（如 ERR_ABRT=-13、ERR_RST=-14）判断是超时中止还是被对端重置。参考：https://docs.openluat.com/luatos_lesson/002_luatos_socket/
20. 不勾选脚本调试信息，就不会打印调试信息吧？量产时是否可以不勾选？
解答： 勾选会占用脚本空间，报错/打印日志时会打印具体行号；不勾选就不打印行号。测试没问题后正式量产不是必须勾选。
21. 模组串口电平与另一端不一致时如何处理？
解答： 串口电平不一致时，先看压差大小再决定是否加电平转换： 1. 压差较小可直接互连：合宙模组 IO 电平可通过 pm.ioVol() 配置（范围 1.65~2.0V、2.65~3.4V，步进 50mV，常用 1.8V/2.8V/3.3V）。模组设为 2.8V、对端为 3.3V 这类接近的电平通常可以直接通信（高电平阈值一般能满足）； 2. 压差较大必须加电平转换：例如模组 1.8V 对端 3.3V/5V，需加电平转换芯片或转换电路，IO 口输入电压不能超过 3.6V，否则有损坏风险； 3. 注意例外：Air8000 系列 IO 固定 3.3V 不支持改电平；Air780EHV 固定 3.3V（Air780EHV-1.8V 固定 1.8V）；Air722UG/Air724UG/Air795UG 不支持 pm.ioVol，需用其专用 IOVOL 接口； 4. 串口交叉接线（TX 接 RX、RX 接 TX）并共地。
电平设置接口见 pm 库文档：https://docs.openluat.com/osapi/core/pm/ ；管脚与电平转换参考设计：https://e3zt58hesn.feishu.cn/wiki/My8LwltRxiBiIPkfoSRcEclknye
22. 有没有哪款模块可以读取NFC标签内容？
解答： 模组有I2C、SPI接口，需要自己外接NFC传感器并写代码，可参考RC522接法：https://docs.openluat.com/air780epm/luatos/app/accessory/AirRC522_1000/
23. 哪个型号自带两路模拟量输入、两路DO、电池供电且能工作一年？
解答： 同时自带两路 DI/DO 且支持电池长期供电可关注 Air8301 工控板（支持 2 路 DI 与 2 路 DO）；但“两路模拟量输入（ADC）”属于另有配置的型号。截至问题记录时，集成两路模拟量输入的型号尚在调试、未正式推出。
建议： 1. 若模拟量输入是必需项，可先用模组自身 ADC 接口 + 外部调理电路，或外挂 ADC 芯片（如 ADS1115，I2C 接口，合宙有对应驱动库 exs_ads1115）实现两路及以上模拟量采集； 2. DI/DO 可用模组 GPIO 直接做开关量输入/输出（DO 需按负载加驱动）； 3. 电池供电一年需结合低功耗（PSM+）模式与上报间隔设计； 4. 具体在售工控板型号与接口配置以合宙产品选型指南（https://docs.openluat.com/SelectionGuide/SelectionGuide/）最新内容为准，选型阶段建议向合宙确认模拟量型号的发布状态。
24. air780EGP烧录报错是什么原因？
解答： 选错SOC了，选的是780E的；应选择对应780EGP的固件，参考https://docs.openluat.com/air780egh/luatos/firmware/780egp_version/
25. 老DTU平台拉取配置失败、平台上线更新但客户服务器延迟收到心跳，是什么原因？
解答： 老 DTU 平台拉取配置失败，与 iRTU 配置服务当时的收费/免费切换有关。iRTU 配置服务自 2026 年 7 月 7 日起已永久免费，新老平台同步生效（新平台 iRTU.openLuat.com，老平台 DTU.openLuat.com）；在 2026 年 7 月 7 日—7 月 31 日过渡期内需在 iot.openluat.com 订单管理中新建 0 元 DTU 订单完成“付费”动作，未做该动作的设备无法拉取配置，7 月 31 日之后已恢复为可直接免费获取配置。
处理建议： 1. 将设备 IMEI 在 iot.openluat.com 完成账号归属绑定，并按免费说明完成配置获取；当前已可直接免费拉取，无需再付费； 2. “平台上线更新但客户服务器延迟收到心跳”属于设备到客户服务器之间的数据链路时延：确认设备心跳周期、网络信号与服务器处理情况，可用抓包/Luatools 日志确认心跳实际发出时间，区分是设备端未及时发送还是服务器端接收延迟； 3. 免费政策与操作步骤说明：https://docs.openluat.com/value/irtu/free/