常见问题 - 2026-08-04
数据日期：2026-08-04
1. 780EHV/780EPM 等模组 TTS 播放未完成时挂断电话，再次拨打提示 busy 且无声音
解答： 该现象多为 TTS 播放任务未在通话结束时正确释放音频通道所致：挂断后播放器仍占用音频设备，再次来电时通话通道无法建立，表现为 busy 且无声音。处理要点：1）收到来电（INCOMINGCALL）或挂断（DISCONNECTED/HANGUP_CALL_DONE）事件时，先调用 exaudio.finish() 关闭 PA，再调用 exaudio.play_stop({type=1}) 停止 TTS 播放，通话结束状态机中再执行 exaudio.pm(audio.SHUTDOWN) 释放音频；2）播放任务中增加通话状态标志（如 is_calling），通话期间不发起新的播放；3）参考官方通话+TTS demo（cc_tts_app.lua）的事件处理流程核对代码逻辑。参考文档：https://docs.openluat.com/osapi/ext/exaudio/
2. 云编译下线后，固件可以自己编译吗？
解答： 目前不支持。LuatOS 底层固件（core）由合宙统一编译发布，云编译服务下线后既不提供本地编译环境，也不开放底层源码自行编译。绝大多数功能需求通过 Lua 脚本和扩展库即可实现；如需定制固件功能，可联系官方技术支持反馈需求。官方固件下载地址见各模组资料中心的固件版本页，参考：https://docs.openluat.com/
3. 合宙 780E MCU 控制有没有案例？
解答： 有两种成熟用法：1）OpenCPU 方案：Air780E 系列模组本身运行 LuatOS，可直接作为主控用 Lua 开发，官方提供 GPIO、UART、I2C、SPI、ADC 等全套外设 demo，模组引脚复用见 Air780EPM/EHM 引脚说明文档（https://docs.openluat.com/air780epm/product/air780exxpins/ ）；2）MCU+通信模组方案：外部 MCU 通过 UART 连接模组，可选用 AT 固件发 AT 指令控制，或烧录 LuatOS 固件后用串口透传/iRTU 免开发固件。架构选型对比见 https://docs.openluat.com/mcu%2BatVSopencpu/mcu%2BatVSopencpu/ ，demo 代码见 https://gitee.com/openLuat/LuatOS/tree/master/module
4. Air8601 人脸识别寄存柜工业模组多少钱？能存多少相片？响应时间多长？支持多少组人脸比对？是否支持活体？
解答： Air8601 为人脸识别寄存柜工业模组（Air1601 主控，4G/WiFi 按需选配，标配 7 寸触控屏与双目人脸识别摄像头 AirCAMERA_1034），支持人脸注册、活体人脸核验开门，预置刷脸存/取、超时二次开箱等完整业务固件，支持 FOTA 远程升级。价格、人脸库容量（照片组数）、比对响应时间等具体规格参数以产品页面和销售报价为准，可在合宙淘宝店（https://luat.taobao.com/ ）咨询客服获取，或参考产品资料：https://docs.openluat.com/air8601/product/
5. Air8601 支持 USB 摄像头远程视频查看吗？
解答： Air8601 基于 Air1601 主控，支持 USB 摄像头（UVC）拍照、预览与 RTMP 推流，可通过 RTMP 协议将视频推送到流媒体服务器实现远程查看，官方 excamera 扩展库已支持 work_mode=3 的 RTMP 推流模式，并提供 rtmp_app 示例；GB/T 28181 国标协议暂不支持。参考文档：https://docs.openluat.com/osapi/ext/excamera/
6. Air8601 怎么获取？
解答： Air8601 人脸识别寄存柜工业模组于 2026 年 8 月上架，可在合宙官方淘宝店选购：https://luat.taobao.com/ 。产品资料与开源固件见 https://docs.openluat.com/air8601/product/
7. 是否有支持一维码、二维码解码的相关库？
解答： 有。合宙摄像头扩展库 excamera 内置扫码能力，excamera.open() 配置扫描模式后调用 excamera.scan(ms) 即可完成二维码/条形码解码，成功返回 (true, 解码字符串)，超时返回 false；核心库 camera 也支持扫描模式（work_mode=1）。搭配 AirCAMERA_1040/1050（SPI 摄像头）或 AirCAMERA_1030（USB 摄像头）配件板即可使用，官方 demo 见 module/Air8201/demo/camera 下的 scan_code.lua。参考文档：https://docs.openluat.com/osapi/ext/excamera/
8. 780Ex2 的 ADC 是多少位的？
解答： Air780E 系列（含 Air780EX2 平台及 Air780EPM/EHV 等）内部 ADC 精度为 12 bits，Air780EPM 提供 ADC0~ADC3 共 4 个外部通道，另有 adc.CH_CPU（CPU 内部温度）和 adc.CH_VBAT（主供电电压）两个特殊通道。注意 adc.setRange() 设置分压必须在 adc.open() 之前调用，否则无效。参考文档：https://docs.openluat.com/air780epm/luatos/app/driver/adc/
9. 如何用 Air8202G 设计一款定位器整机？
解答： Air8202G 是免开发 4G 定位器主板（基于 Air780EGG/EGP，板载 GNSS 陶瓷天线与 4G 贴片天线，支持 4.2V/4.35V 电池充电管理、船运模式、防拆光敏），原理图与源码开源、搭配合宙 iRTU 固件和 AirCloud 云平台，插上电池即可使用，无需从零设计整机。若要二次开发，可参考 Air8201 超低功耗定位模组系列资料与开源工程。选型与资料见 https://docs.openluat.com/SelectionGuide/SelectionGuide/ ，购买见 https://luat.taobao.com/
10. Air8202 大约什么价？
解答： Air8202G 定位器主板官方售价 59.9 元，可在合宙淘宝店下单：https://luat.taobao.com/ 。批量价格请联系淘宝客服或合宙销售咨询。参考：https://docs.openluat.com/SelectionGuide/SelectionGuide/
11. 8202G 能不能换个好一点的六轴 IMU？
解答： Air8202G 板载 G-sensor 用于静态漂移抑制等固定功能，不支持自行更换 IMU；如需更高规格六轴姿态传感器（如 MPU6050、BMI270），可选用 Air8201 系列超低功耗定位模组进行 LuatOS 二次开发，通过 I2C 外接六轴 IMU，官方提供 exs_mpu6050、exs_bmi270 等传感器驱动库。参考：https://docs.openluat.com/osapi/ext/sensor/
12. 8202 没有 WiFi，GNSS 差的时候定位精度是否不如 Air8000A 这种带 WiFi 的好？
解答： Air8202G 定位方式为 GNSS 卫星定位 + LBS 基站定位，不带 WiFi 硬件，因此不具备 WiFi 扫描定位能力；GNSS 信号良好时定位精度约 2~3 米（空旷环境），室内/遮挡场景只能依赖基站定位，精度为百米级，确实不如带 WiFi 定位的方案。WiFi 定位与基站定位均为辅助定位，精度和可靠性都低于 GNSS。对室内精度有要求的场景建议选用带 WiFi 的方案。参考：https://docs.openluat.com/SelectionGuide/SelectionGuide/
13. Air8000 的 AT 命令手册？
解答： Air8000 系列为 LuatOS 二次开发 SoC，不提供 AT 指令固件，也没有 AT 命令手册，所有功能通过 Lua 脚本调用 LuatOS API 实现，API 手册见 https://docs.openluat.com/osapi/ 。如项目必须使用 AT 指令架构，请选用合宙 AT 固件模组（如 Air780E 系列 AT 版本），AT 手册见 https://docs.openluat.com/atmozu/product/shouce/
14. Air8000 如何控制开关机以及 RNDIS 数传？
解答： 开关机：POWER_ON 为 Air8000 开关机控制管脚，关机状态下拉低 1.5 秒可开机；开机状态下同样拉低不能关机，需在脚本中检测 POWER_ON 按键长按后执行关机逻辑（官方有 power_on 按键控制示例文档），也可调用 pm.power(pm.PWK_MODE, true) 开启开机键防抖。RNDIS 数传：Air8000 支持 USB RNDIS/ECM 虚拟网卡，开启后在电脑（Win10 及以上）即插即用枚举为以太网网卡，Linux 下使用 CDC-ACM 驱动免驱，通过该网卡即可走模组 4G 网络数传。参考文档：https://docs.openluat.com/air8000/luatos/common/poweron/ 、https://docs.openluat.com/air8000/luatos/app/common/rndis/
15. 780EPM 从 2005 固件差分升级到 2046 导致芯片无法看到日志/成砖头，如何处理？
解答： 跨度过大的差分（FOTA）升级可能因分区/参数不兼容导致升级后异常。处理方法：1）禁止大版本跨度直接差分升级，应选取中间版本固件分多次逐级升级，并在每级升级后验证；2）已出现无日志/无法启动的设备，可进入 USB 强制下载模式（按住 BOOT 键再上电/插 USB）用 LuaTools 线刷完整官方固件恢复，线刷会重写底层，一般均可救回；3）量产前先取中间固件做完整升级链路测试。固件下载见 https://docs.openluat.com/air780epm/luatos/firmware/780epm_version/
16. 780EHV I2C 初始化返回 1 是什么问题？
解答： i2c 初始化/通信返回失败通常是总线硬件问题，按以下顺序排查：1）SCL/SDA 必须外接 4.7kΩ~10kΩ 上拉电阻到 VCC（Air780EHV 的 IO 电平固定 3.3V，注意 Air780EHV-1.8V 版本固定 1.8V）；2）核对引脚号与接线，Air780E 系列核心板常用 I2C1 对应 PIN66=SDA、PIN67=SCL；3）从设备地址、供电电平与模组 IO 电平一致；4）总线曾被异常拉死时，可改用软件 I2C（传 scl/sda 引脚号）以便驱动发时钟脉冲恢复总线；5）升级到最新固件（如 V2048）验证。参考文档：https://docs.openluat.com/osapi/core/i2c/
17. Air8000 的休眠问题，780EHM 上能复现吗？
解答： 同类低功耗问题在不同型号上可能表现一致（已有客户反馈 Air780EGH 上现象相同）。排查时请准备：可稳定复现的最小脚本、复现步骤、以及模组底层 log（含休眠/唤醒日志），一并提交到官方 issue 渠道或企业微信群，由固件工程师分析。低功耗开发注意：进入低功耗前必须配置好所有 IO，普通 GPIO 休眠后不可控，需要保持电平的引脚应使用 AGPIO。参考文档：https://docs.openluat.com/air780epm/luatos/app/lowpower/sleep/
18. TRAE IDE 里 Lua 语法插件红色波浪线警告怎么解决？
解答： 建议停用默认 Lua 语法插件，改用 Tencent 出品的 Lua 插件（Lua by Tencent），合宙官方示例工程基本按该插件的注解格式（---@module、---@api 等）编写，安装后误报波浪线会大幅减少。LuatOS 开发插件配置说明见 https://docs.openluat.com/ai/luatos-dev-plugin/
19. AIR780EG2 的 VIN 供电 4.8V 不会烧坏模组是否正常？
解答： Air780E 系列模组的 VBAT 供电范围为 3.3V~4.35V（建议 3.6V~3.8V，电流需求 1A 以上并并联储能电容）。4.8V 已超出额定上限，即使短期未损坏也属于超范围使用，存在击穿风险，不能作为正常设计依据，请立即将供电调整到规格范围内。若电路板上 VIN 经过 DCDC 降压后再供给模组 VBAT，则以 DCDC 输出电压为准核对。具体引脚与电源设计以对应型号产品手册为准，参考：https://docs.openluat.com/air780epm/luatos/hardware/vbat/
20. 基站定位免费版的联网地址是 bs.openluat.com 还是 free.bs.air32.cn？
解答： 两个都是免费基站定位服务地址：lbsLoc 库默认服务器为 "bs.openluat.com"，备用为 "bs.air32.cn"（不保证可用）；lbsLoc2 库内置地址列表为 {"free.bs.air32.cn", "bs.openluat.com"}，端口默认 12411，一般无需手动填写。直接使用官方 lbsLoc/lbsLoc2 库即可，免费服务为测试性质，量产高可靠场景建议使用收费 airlbs 服务。参考文档：https://docs.openluat.com/osapi/ext/lbsLoc/ 、https://docs.openluat.com/osapi/ext/lbsLoc2/
21. 模块已经绑定 IOT 账户，联系不上账户使用人，能否烧录专属固件变更账户？
解答： 不能。设备归属以 IOT 平台（iot.openluat.com）账号绑定关系为准，烧录固件不会改变归属。只能通过以下途径转移：1）合宙淘宝店购买的设备，联系淘宝客服提供 IMEI 和目标账号协助转移；2）合宙销售购买的设备，由原收货账号在平台操作 IMEI 转移；3）第三方购买的模块，联系购买方操作转移。转移操作需有采购记录/单号核验权限。参考文档：https://docs.openluat.com/air780epm/product/attributioniot/
22. 合宙 API 手册在哪个网址？
解答： LuatOS API 手册官方地址：https://docs.openluat.com/osapi/ （核心库 core 与扩展库 ext 分类索引）；各模组硬件文档、demo 教程在 https://docs.openluat.com/ 对应模组资料中心；源码与 demo 在 https://gitee.com/openLuat/LuatOS/tree/master/module 。也可使用合宙 AI（ai.luatos.com）提问，回答会附带资料来源链接。
23. 设备从账号下删除后找不到了，能找回来吗？
解答： 设备本身不会因账号删除而丢失，重新绑定即可：在 iot.openluat.com 登录目标账号，通过“我的设备”按 IMEI 查询设备当前归属；若设备已不属于任何账号，直接在项目中添加该 IMEI 即可找回；若归属在其他账号下，需按设备归属转移流程处理（淘宝购买联系客服、销售购买由原账号转移）。参考文档：https://docs.openluat.com/air780epm/product/attributioniot/
24. 780EHV 的 66/67 脚 I2C 电平只有 1.3V 而不是 3.3V 吗？
解答： Air780EHV 的 IO 电平固定为 3.3V（Air780EHV-1.8V 版本固定 1.8V），引脚电平不可配。I2C 总线电平只有 1.3V 通常说明总线被拉低或上拉不足：1）SCL/SDA 必须外接 4.7kΩ~10kΩ 上拉电阻到 VDD_EXT（3.3V）；2）检查从设备是否拉死总线、地址是否正确、是否与其他复用功能冲突；3）用最新固件（V2048）测试验证。参考文档：https://docs.openluat.com/osapi/core/pm/ （pm.ioVol 电平说明）
25. AI 提问后一直加载中怎么办？
解答： 请先登录合宙 AI 平台账号（ai.luatos.com），登录后刷新页面重新提问；若仍持续加载，清除浏览器缓存或更换浏览器重试。技术问题也可直接查阅官方文档站 https://docs.openluat.com/ 或加入合宙官方企业微信群咨询。
26. AIR780EPM 内部 RTC 长期没有 NTP 同步误差大是否正常？
解答： 正常。模组内部 RTC 为普通晶振计时，受温度、电压波动影响会产生漂移，出厂默认时间为 2000-01-01，且低功耗/PSM+ 模式下误差会更明显，不能替代高精度时钟源。建议：1）每次联网成功后通过 NTP 同步时间；2）休眠唤醒后再次同步；3）NTP 成功后直接用 os.date() 读取本地时间即可，无需再调用 rtc.set/rtc.get。参考文档：https://docs.openluat.com/common/time_sync/
27. 合宙 780直连模块 485 通讯连接哪几个引脚？
解答： RS485 接线取决于具体 780 子型号：模组侧使用一路 UART 的 TXD/RXD（如 UART1）外接 485 收发芯片（A/B 差分线），若收发芯片方向控制脚接了模组 GPIO，还需在 uart.setup 时配置 rs485_dir_gpio 和 rs485_dir_rx_level；使用硬件自动换向的 485 模块则无需方向脚。官方 demo 见 module/Air780EPM/demo/uart/485_uart.lua。请提供具体子型号（EPM/EHM/EHV/EG2 等）以便核对引脚号，引脚定义参考 https://docs.openluat.com/air780epm/luatos/hardware/uart/
28. 780EPM 的脚本大小最大是不是 256K？
解答： 不是固定 256K。脚本区大小在固件编译时确定，随固件编号不同而不同：例如 V2048 新增的 19/119 号固件将脚本区扩大到 1M 字节（文件系统 168K），常规固件脚本区较小。LuaTools 下载成功后会显示已使用的脚本区大小。请以所用固件编号的版本说明为准，参考：https://docs.openluat.com/air780epm/luatos/firmware/780epm_version/
29. 宏短 780EPM/8000 模组如何通过 USB 口导出数据？
解答： 模组 USB 连接电脑后会枚举多个 USB 虚拟串口，其中通讯用途的虚拟串口可直接用 uart 核心库收发数据：串口 ID 使用 uart.VUART_0（固定 ID），按普通 uart.setup/uart.on/uart.tx 方式使用即可导出数据。官方 demo 见 module/Air780EPM/demo/uart/usb_uart.lua，端口识别说明见 https://docs.openluat.com/air780epm/luatos/app/driver/uart/
30. 780EPM 外挂蓝牙模块用于固件升级，蓝牙芯片接 UART 还是 USB 口？
解答： 建议直接选用合宙 Air5101S 蓝牙模组作为外挂蓝牙方案，官方已提供基于 Air5101 的 FOTA 升级方案文档与 demo（Air8000/Air8201 等平台均有 ble_5101_fota 例程），按官方接线和示例开发即可。参考文档：https://docs.openluat.com/air8000/luatos/app/ota/ble_5101_fota/
31. Air8000W 有内置 SIM 芯片吗？
解答： 没有。Air8000W 为 WiFi 版本，不带蜂窝通信功能；Air8000 系列 4G 版本需自行插入 SIM 卡（SIM1 引脚为 PIN10~13：VDD_SIM/SIM_RST/SIM_DAT/SIM_CLK），SIM2 由 GPIO 模拟、需特殊电路设计。参考文档：https://docs.openluat.com/air8000/luatos/hardware/sim/
32. macOS 下 LuaTools 虚拟机兼容性不好，无法下载代码，有其他方式吗？
解答： 可使用 luatos-cli 命令行烧录工具，支持 macOS/Linux，在 Gitee 搜索 openLuat/luatos-cli 获取，按 README 安装后即可命令行下载固件和脚本。参考：https://gitee.com/openLuat/luatos-cli
33. Air8000 上 TF 卡识别不稳定/挂载失败怎么办？
解答： 排查与处理建议：1）优先更换大牌正品 TF 卡（如闪迪），杂牌卡挂载成功率明显偏低；2）核对 SPI 接线与片选（Air8000 整机开发板 TF 卡为 spi1、pin_cs=gpio20，与 CH390 共用总线，初始化前先拉高 CS）；3）降低 SPI 时钟、保证供电稳定；4）不要在程序中自动格式化卡，挂载失败应报错记录而非格式化。挂载调用 fatfs.mount(fatfs.SPI, "/sd", spi_id, pin_cs, 2410001000, nil, 1, false)（最后参数 false 即关闭自动格式化）。参考 demo：module/Air8000/demo/tf_card/tfcard_app.lua
34. 能否取消 Air8000 脚本里 TF 卡挂载失败后自动格式化的代码？
解答： 可以。fatfs.mount 默认挂载失败会格式化，将调用改为 fatfs.mount(fatfs.SPI, "/sd", spi_id, pin_cs, 2410001000, nil, 1, false)，最后一个参数传 false 即关闭自动格式化（官方 demo 注释中有明确说明）。建议业务逻辑改为：读写失败时先 fatfs.unmount 卸载，再重新挂载并重试读写，避免误格式化导致数据丢失。参考 demo：module/Air8000/demo/tf_card/tfcard_app.lua
35. OTA 平台有什么改动吗？OTA 升级没有反应怎么办？
解答： OTA 平台无改动。排查方法：登录 iot.openluat.com 查看设备升级日志——只要设备发起了升级请求，平台就会有日志记录；没有日志说明设备的升级请求未到达平台，请按序检查：1）设备是否联网成功（IP_READY）；2）PRODUCT_KEY 与平台项目是否一致、PROJECT/VERSION 格式是否符合三段式版本号要求；3）升级包是否已正确上传并发布到对应版本；4）libfota/fota 库回调中的错误码日志。参考文档：https://docs.openluat.com/osapi/core/fota/
36. 有没有支持微信支付的物联网模组？
解答： 微信支付属于服务端/云端业务，没有“内置微信支付”的模组。典型实现方式：设备（如带屏模组 Air1601/Air1602/Air8000）通过 HTTP/MQTT 向自有服务器请求订单，屏幕展示微信支付二维码（airui.qrcode 组件可生成二维码），用户扫码支付后由微信支付服务器回调业务服务器，服务器再通知设备发货/开通。合宙提供微信小程序对接指导文档：https://docs.openluat.com/protocols/aircloud_api/wx_support/
37. 公司购买模块找哪位？
解答： 公司批量采购可通过以下官方渠道：1）合宙官方淘宝店 https://luat.taobao.com/ 联系客服询价；2）加入合宙官方企业微信群（https://docs.openluat.com/ 网站底部二维码扫码加入）联系销售。采购时请说明型号、数量及发票需求。
38. 产品在非洲使用需要专门非洲的模组吗？
解答： 需要选择支持当地频段的海外版本模组。推荐使用海外频段版本 Air780EHU 或 Air8000U，具体频段覆盖请对照目标国家运营商的 LTE 频段与模组产品手册核对。选型参考 https://docs.openluat.com/SelectionGuide/SelectionGuide/ 中的海外需求章节。
39. 支持 Open 的 4G 模块且支持连接摄像头，推荐低功耗低成本的型号？
解答： 摄像头（拍照/扫码/推流）需要较强多媒体能力，低功耗 4G Cat.1 定位模组不适合视频类应用。按官方选型指南：摄像头视觉类应用推荐 Air1601/Air1602（Cortex-M7，支持 USB 摄像头、RTMP 推流，内置 Air780ER2 4G 模组）或 Air8101（多媒体 WiFi SoC）；纯 4G 透传/低成本场景选 Air780E 系列。请以选型指南为准：https://docs.openluat.com/SelectionGuide/SelectionGuide/
40. 9 寸屏做上位机用哪个模块？
解答： 推荐 Air1601/Air1602（Cortex-M7 高性能 MCU），支持 40P/50P RGB 屏幕接口，适配 7/9/10.1 寸电容触控屏，可替代安卓屏方案，并内置 4G（Air780ER2）、WiFi（Air6205）、蓝牙（Air5101S）、GNSS（Air510W）等模组。参考公告与选型指南：https://docs.openluat.com/SelectionGuide/SelectionGuide/
41. Air8000 可以用 9 寸屏吗？
解答： Air8000 系列屏幕驱动能力面向小尺寸屏（如 3.5 寸及以下配套 LCD 配件板），不适合驱动 9 寸 RGB 大屏。9 寸上位机屏请选用 Air1601/Air1602，其支持 40P/50P RGB 接口适配 7/9/10.1 寸电容触控屏。参考：https://docs.openluat.com/SelectionGuide/SelectionGuide/
42. 自己有电路板但烧录不成功，是什么问题？
解答： 建议按合宙官方硬件审核清单逐项核对原理图与最小系统：重点检查 VBAT 供电（3.3V~4.35V、1A 以上、并联 220uF 电解电容）、PWRKEY 开机电路、USB_BOOT（PIN82，上电前不得被上拉到 VDD_EXT，否则模组停留在 USB 下载等待）、USB_DP/DM/USB_VBUS 走线及 SIM 卡等。审核步骤见 https://docs.openluat.com/value/drawcheck/
43. 是否有带蓝牙、4G、北斗的模组？
解答： 有。Air8000A 为 4G+WiFi+蓝牙+GNSS 定位四合一模组（GNSS 支持北斗等多星座）；Air8201 系列（如 Air8201G-BLMQ，基于 Air780EGH）为 4G+BLE5.2+GNSS 二合一/三合一超低功耗定位模组。具体型号频段与功能以选型指南为准：https://docs.openluat.com/SelectionGuide/SelectionGuide/
44. GNSS 静止定位漂移怎么解决？
解答： 静态漂移可通过算法抑制：exgnss 扩展库的 exgnss.setup(opts) 提供 static 静态抑制参数（需在 exgnss.open 之前调用），开启后静止状态下坐标不再跳动；带 G-sensor 的模组（如 Air8201）还可结合加速度传感器进一步抑制静态漂移。参考文档：https://docs.openluat.com/osapi/ext/exgnss/#exgnsssetupopts
45. 模组/开发板插上 Typec 线看不到串口是什么原因？
解答： 按以下顺序排查：1）确认使用的是数据线而非仅充电线，更换 USB 线和电脑 USB 口（优先 USB3.0 口）；2）确认设备已正常上电开机（电源/网络指示灯状态）；3）打开电脑设备管理器查看“端口（COM 和 LPT）”，正常开机应出现 3 个 USB 虚拟串口，若显示未知设备/黄色感叹号需安装驱动；4）开发板带 CH343/CH347 USB 转串口芯片的，安装对应驱动；5）若设备完全无枚举，按强制下载方式（按住 BOOT 再上电）测试能否出现下载端口，以区分硬件故障。参考文档：https://docs.openluat.com/common/usb_drv/
46. 780E 系列进入低功耗模式后 GPIO 间歇性输出高低电平怎么解决？
解答： 原因是进入低功耗后普通 GPIO 状态不可控，外围上下拉配置不当时引脚电平会漂移。处理：1）将该引脚外接下拉电阻加大到 10kΩ 量级，保证休眠时电平确定；2）需要在休眠期间保持确定电平/中断功能的引脚，必须选用 AGPIO（AGPIO 配置为输出可在 PSM+/深度休眠下保持电平，WAKEUP 引脚可保持输入和中断）；3）所有 IO 在进入低功耗前配置好。参考文档：https://docs.openluat.com/air780epm/luatos/app/driver/gpio/ （AGPIO 低功耗模式章节）
47. PWRKEY 接地、上电按 BOOT 没反应，下载程序不成功？
解答： 正确进入 USB 下载模式的操作为：电脑端 LuaTools 先点击“下载底层和脚本”，板子按住 BOOT 键（BOOT 键即 USB_BOOT 与 VDD_EXT 短接）后再上电/插 USB，提示检测到设备后松开 BOOT；注意顺序是按住 BOOT 再上电。若仍无反应：1）核对 PWRKEY 开机电路与 VBAT 供电（3.3V~4.35V、储能电容）；2）检查 USB_BOOT（PIN82）上电前是否被外加上拉，正常应为悬空/下拉（Boot from Flash），按住 BOOT 才上拉进下载模式；3）换数据线/USB 口，用合宙核心板对比测试。参考文档：https://docs.openluat.com/common/howtodown/
48. 780EPM ADC 异常(偏高)如何解决？
解答： 该问题在新版固件中已修复，请升级到最新官方固件（如 V2048）后验证。升级注意：不要跨大版本直接差分升级，应选中间版本固件分多次 FOTA 升级；若设备已异常，可按住 BOOT 进强制下载模式用 LuaTools 线刷完整固件。固件下载见 https://docs.openluat.com/air780epm/luatos/firmware/780epm_version/
49. Air780EU 模组 AT 指令循环后复位，什么原因？
解答： 排查步骤：1）先确认固件版本，升级到最新 AT 固件版本测试；2）海外使用场景需确认 SIM 卡兼容性（如 1NCE 等海外卡的注网行为）与当地频段；3）若仍复现复位，抓取 ramdump（异常转储）日志提交官方分析，定位是否为协议栈异常。AT 固件版本见 https://docs.openluat.com/atmozu/product/firmware/
50. 模组 airtalk/认证超时怎么排查？
解答： 该类异常多与短时间内消息洪泛导致协议任务阻塞有关：检查应用是否在 1 秒内触发了大量 MQTT 消息收发，导致线程异常进而认证超时。处理：1）控制消息发送频率、增加队列和限流，避免突发大流量；2）升级到最新固件（已增加相关异常保护）；3）复现时抓取底层 log 提交官方配合分析。MQTT 开发参考 https://docs.openluat.com/luatos_lesson/003_luatos_mqtt/
51. DTU 固件串口发数据回复 ERROR 是什么原因？
解答： DTU/iRTU 固件串口回复 ERROR 通常表示配置或数据帧不被接受，按序排查：1）登录 iRTU 网页配置后台，核对串口参数（波特率/数据位/停止位/校验位）与实际设备一致；2）核对网络通道（TCP/MQTT）是否已连接成功，未联网时发送数据会报错；3）检查数据格式是否符合配置的打包规则（如多主题下发需要主题标识、注册包/心跳包配置）；4）对照 iRTU 文档确认指令格式。配置说明见 https://docs.openluat.com/value/irtu/state/
52. 780EHV 拨打电话回铃声很大且调不了，怎么办？
解答： 通话回铃声本质也是通过 exaudio 音频通道播放，与 TTS 共用同一音量控制（exaudio.vol，0~100，需在 exaudio.setup 初始化成功后调用才生效），无法分别调节回铃声与 TTS 音量。处理建议：1）统一调低 exaudio.vol() 音量值；2）TTS 文本中可使用 [v0]~[v10] 音量标记调节单段播放音量；3）检查喇叭功率与功放匹配，避免音量过大爆音。参考文档：https://docs.openluat.com/osapi/ext/exaudio/
53. 780EHV 通话没有声音，但用 CC 代码测试正常？
解答： CC 官方 demo 正常说明硬件音频链路（ES8311 codec、PA、喇叭/麦克风）正常，问题在应用代码：1）确认音频设备初始化 audio_drv.initAudioDevice() 与 cc.init(audio_drv.getMultimediaId()) 流程与 demo 一致；2）来电时需先 exaudio.finish() 关 PA 再 stop 播放，避免音频通道被 TTS/音乐占用导致通话无声；3）通话音量通过 exaudio.vol/exaudio.mic_vol 设置（初始化后调用）；4）对照官方 cc_tts_app.lua、play_audio_during_cc.lua demo 核对事件处理。参考文档：https://docs.openluat.com/air780ehv/luatos/app/volte/call/
54. 用腾讯云 IoT 升级 780EPM 固件不成功，重启后才能成功？
解答： 该类问题在新版固件中有相关修复，建议升级到 V2048（或更新）固件后重新验证第三方云（腾讯云）FOTA 流程。同时确认升级包传输完整、版本号符合三段式格式、升级后重启逻辑与云平台期望一致。固件下载见 https://docs.openluat.com/air780epm/luatos/firmware/780epm_version/
55. 模组 OTA 升级后无法注网，线刷正常是什么问题？
解答： 多为跨大版本 OTA 后旧参数区（KV/文件系统中保存的射频/注网参数）与新固件不兼容导致，线刷会重写分区所以正常。处理与预防：1）出现该问题时清除 KV 分区/文件系统分区（或线刷时全擦）后即恢复；2）避免从很旧版本跨大版本直接 OTA，应分多次逐级升级；3）量产固件升级链路需提前跨版本测试。参考文档：https://docs.openluat.com/osapi/core/fota/
56. 设备 MQTT 串口透传不定时失效，串口不再接收数据？
解答： 该现象多为串口接收任务被阻塞或 MQTT 异常重连影响透传链路，按以下方向排查：1）串口接收回调中不要做耗时操作，数据处理放到独立任务，避免回调阻塞导致后续数据不再上报；2）检查 MQTT 连接状态与自动重连逻辑，断线重连期间数据应有缓存或重发机制，参考 socket/mqtt 错误码日志（如 -13 ERR_ABRT）定位网络异常；3）大数据量场景确认串口缓冲区和 uart 配置满足吞吐；4）升级到最新固件验证协议栈稳定性；5）参考官方透传 demo（TCP&UDP 教程中“串口和服务器之间透传数据”章节）核对架构。参考文档：https://docs.openluat.com/air780epm/luatos/app/socket/TCP&UDP%20%E6%95%99%E7%A8%8B/