常见问题 - 2026-10-26

数据日期：2026-10-26

1. CodeBuddy/LuatOS教程中找不到gitee文件夹或生成的代码在哪？

解答： 结论：不是教程缺文件，而是 AI 助手在多数情况下只生成了「预览」，代码并没有真正落到工作区；LuatOS 的全部示例工程都在 gitee 的 openLuat/LuatOS 仓库 module/<型号>/ 目录下。说明：教程里出现的 module\Air8607 这类路径是仓库内的相对路径，不是你电脑上的绝对路径——本机没有克隆过仓库，自然找不到这个文件夹。CodeBuddy、豆包这类助手在 IDE 里通常先给一段代码预览，需要你再明确发一句「把代码写到 module\Air8607 目录」才会落盘。处理步骤：① 从 gitee 克隆或下载 openLuat/LuatOS 仓库到本地；② 在 IDE 里「添加文件夹到工作区」，选中 module\Air8607；③ 再让 AI 把生成的代码写入该目录；④ 仍找不到就问 ai.luatos.com 或让 AI 直接给出完整文件内容，手动另存。参考文档：https://docs.openluat.com/air8607/product/、https://docs.openluat.com/common/Luatools/

2. Air8603是否支持SIP功能？

解答： 结论：不支持。Air8603 主控是 Air1603，定位是大屏联网控制板，不带双向通话的音频通路；能跑 SIP 的是 Air1602 + Air1103 这条线（Air8605W/M），以及 Air8784（Air780EHM + Air1103）。说明：SIP 双向语音需要三件东西同时具备——麦克风上行采集、下行播放、免提场景的回声消除（AEC）。Air1603 文档明确不包含 I2S 编解码器/录音接口方案，也没有内置语音芯片，所以只听提示音可以，做对讲不行。后续也只有带 32MB RAM 的型号才会把 SIP 做进来。处理步骤：① 先确认项目是「只放提示音」还是「要双向对讲」；② 要双向对讲就选 Air8605W/M（大屏 SIP 板）或 Air8784（SIP 整机）；③ 只要本地播放继续用 Air8603，按 RS485/TTL 型号选型即可。参考文档：https://docs.openluat.com/air8603/、https://docs.openluat.com/air8605/、https://docs.openluat.com/air8784/product/air1103/

3. Air8603的USB接口选择B串口后不能打印日志、烧录后无反应怎么办？

解答： 结论：能识别串口但选了 B 口没日志，多半是「串口没真正打开 / 选错了那一路」或烧错版本固件，其次才是 BOOT 与复位时序；不一定是硬件问题。说明：Air8603 有 4G 版（M 系列，板载 Air780EX2）和 WiFi 版（W 系列，板载 Air6205），两套固件的日志口和业务不同——把 6205 的固件烧进 M 版（或反之）就会出现「端口在、但一直不打印」。下载时主控必须先进下载模式：按住 BOOT 再复位；如果板子还没上电，则是先按开机键、再松开 BOOT。处理步骤：① 用最新版 Luatools；② 选中串口 B 并勾「通用串口打印」，先「打开串口」再点下载；③ 确认烧的是与该型号匹配的固件（W 系列 6205 / M 系列 780EX2）；④ 按住 BOOT 复位重试；⑤ 换能传数据的短线、USB 直连电脑，必要时外部稳压供电。参考文档：https://docs.openluat.com/air8603/、https://docs.openluat.com/common/Luatools/、https://docs.openluat.com/air1603/luatos/common/download/

4. Air8101能否接以太网？价格多少？

解答： 结论：可以接以太网。Air8101 本身不带 MAC/PHY，需要外挂 AirETH_1000（SPI 转以太网）配件板；参考价 Air8101 与 Air8101A 均为 39 元。说明：选型手册里 Air8101（18×24mm，板载天线）和 Air8101A（18×18mm，IPEX 一代座子）标价都是 39 元；Air8101B 是 16MB+16MB 的加大内存版本，选型页价格栏目前仍写「暂无」，实际报价以对接销售为准，原答里的 49 元属商务报价、文档站未列。以太网走 SPI 外挂方案，插 RJ45 之前要先接配件板。处理步骤：① 备 Air8101 开发板 + AirETH_1000；② 按配件板文档接 SPI 信号与中断脚；③ 用 netdrv 建立以太网通道并测通；④ 需要 PoE 或工业级隔离，另配 AirPHY_1000 类方案。参考文档：https://docs.openluat.com/air8101/、https://docs.openluat.com/accessory/AirETH_1000/、https://docs.openluat.com/SelectionGuide/SelectionGuide/

5. 8603/带485的4G通信模块什么时候上架？

解答： 结论：上架与发货时间属于商务事项，文档站不给承诺；原文「明后天」是当时对话里的口径，具体排期请以对接销售的最新答复为准。说明：Air8603 的资料已经上线，10 个型号（W1～W5 为 WiFi、M1～M5 为 4G）按 RS485 隔离/非隔离与 TTL 串口组合划分，可以先按文档做硬件与接口规划，不必等货到再动手。需要「带 485 的 4G 通信模块」时，M3/M4 是双路 RS485、M5 是 TTL + 一路隔离 RS485。处理步骤：① 按场景先定型（几路 485、要不要人脸识别 UVC）；② 找对接销售确认批次与交期；③ 资料先行，按 air8603 页核对封装与接口定义。参考文档：https://docs.openluat.com/air8603/

6. 8607B是否同时支持网口和485？

解答： 结论：文档站目前没有 Air8607B 这个型号的任何页面——规格、接口、上市时间都没有官方资料可查，所以「是否同时支持网口和 485」现在无法给出确定答复；原答「客户正在推进该需求」说明它是按客户需求在评估的型号，不是已发布产品。说明：现有的是 Air8607（主控 Air1603 + Micro-SD + 屏幕 + 4Ω/3W 音频，本身不带网络功能）和 Air8607A（取消 SD 卡座与 USB 转串口，增加 UVC/UART3/SPI1/PWM1）。要「网口 + 485」的现成方案，看 Air8603 的 M/W 系列（按 485 组合选型）或 Air8300（双以太网 + 隔离 485 工控板）更稳。处理步骤：① 先确认项目要的到底是 8607 + 外挂、还是 8603/8300 这类一体化板；② 若坚持等 8607B，向对接销售确认是否已立项、大致规格；③ 拿到样品后核对丝印完整型号，再按对应文档开发。参考文档：https://docs.openluat.com/air8607/product/、https://docs.openluat.com/air8607a/、https://docs.openluat.com/air8603/

7. 1603系列产品是否为车规级？

解答： 结论：Air1603 系列不是车规级器件。文档与选型资料里没有 AEC-Q100 或车规温度等级的标注，有车规要求时不能直接用它。说明：Air1603 是面向大屏交互整机的工业级主控（-40~85℃ 量级），车规除温度外还要看 AEC-Q100 认证、PPAP、长期供货承诺与批次一致性，这些在当前的公开资料里都没有。即便温度范围够，认证链条也补不齐。处理步骤：① 先确认客户是否强制要求 AEC-Q100/PPAP；② 强制要求就换车规供应商与型号，不要用工业级顶替；③ 非强制则按工业级设计，并做高低温与振动验证，在合同里写清使用环境。参考文档：https://docs.openluat.com/air1603/luatos/hardware/

8. Air8202配套的贴片SIM卡能否改成支持短信功能的SIM卡？

解答： 尚未解答

9. 开发板的开发资料在哪里找？

解答： 结论：开发板资料统一在 docs.openluat.com 对应型号的「产品 / 硬件 / 软件」三块里，按「型号 → product（规格书、原理图、封装）→ luatos（教程、固件、硬件设计）」的顺序找；临时问题可以直接问 ai.luatos.com。说明：文档站是目录式 URL，根路径不一定有首页——像 air8607/、air8300/、air8301/、air8380/ 这类目录没有 index.md，直接访问会 403，要往下指一层。硬件环境清单（要哪些配件、怎么接）在 luatos/common/hwenv/。处理步骤：① 打开 docs.openluat.com，进对应型号；② 规格书与封装在 product/shouce；③ 例程与固件在 luatos/；④ 找不到就用站内搜索或 ai.luatos.com 提问，附上完整型号丝印。参考文档：https://docs.openluat.com/air780epm/luatos/common/hwenv/、https://docs.openluat.com/common/Luatools/

10. 是否有海外版模块，用于沙特等海外地区？

解答： 尚未解答

11. 是否有合作的物联网卡供应商？

解答： 结论：物联网卡采购属于商务对接，技术文档不涉及具体供应商清单；按原文口径，扫码添加杨凤珍微信对接即可。说明：选卡时有几个技术点要先说清楚——物联网卡默认可能关闭短信与语音，需要定向开通；是否支持短信、能否访问公网自有服务器，取决于卡套餐与 APN，不是模组能力；贴片 ESIM 与实体卡座在多数板子上是二选一。把这些提前告知供应商，能少走一轮返工。处理步骤：① 明确用量、覆盖地区、是否需要短信/语音；② 与对接人确认套餐与 APN 参数；③ 拿到卡后先用 AT+CPIN?、AT+CGATT? 验证注网，再上业务。参考文档：无（属商务事项，请通过购买渠道或对接销售确认）。

12. Air780EPM核心板如何接GC032A实现拍照功能？

解答： 结论：GC032A 对应的是 AirCAMERA_1040 配件板，官方已有 Air780EPM 开发板 + AirCAMERA_1040 的完整教程；用 780EPM 核心板就得自己飞线，比较麻烦，建议直接用开发板。说明：核心板只把常用管脚引到邮票孔，camera 的 SPI/DVP 信号与供电并没有做成排针座，飞线长度一长就影响时序与画质。AirCAMERA_1040 是 30 万像素 GC032A 方案，走的是模组专用 Camera 接口，官方教程里有拍照上传和扫码头两种应用。处理步骤：① 备 Air780EPM 开发板 + AirCAMERA_1040；② 按教程接排线、确认供电；③ 跑 camera 例程先出图；④ 再叠加拍照上传或扫码业务；⑤ 核心板飞线方案仅在结构受限时考虑，线要尽量短并做好屏蔽。参考文档：https://docs.openluat.com/accessory/AirCAMERA_1040/、https://docs.openluat.com/air780epm/luatos/app/accessory/AirCAMERA_1040/

13. Air8607 9寸屏外壳3D文件有吗？

解答： 尚未解答

14. Air780E/780EGP等模块的完整原理图和PCB图能否提供？

解答： 结论：可以提供 PDF 原理图、BOM（含电容电感的具体值）、PCB 正反丝印图和走线图，以及参考封装；模组内部的完整 PCB 设计文件不对外开放。说明：模组是封装级成品，内部基板布局属于合宙与芯片厂的知识产权，行业内都不会给。能给的是「承载板怎么画」——参考设计原理图、PADS/AD/LCEDA 三种格式的参考封装、以及用于核对的丝印与走线图，足够完成自己的底板设计。处理步骤：① 到对应型号的 product/shouce 页下载规格书、原理图与参考封装；② 按硬件设计手册核对 PWRKEY/USB_BOOT/RESET 与天线净空；③ 需要额外资料（如某块参考设计的 BOM）找对接 FAE 申请。参考文档：https://docs.openluat.com/air780epm/product/shouce/、https://docs.openluat.com/air780epm/luatos/hardware/

15. Air780EPM官方只有参考设计原理图，没有可投产PCB，封装缺失怎么办？

解答： 结论：官方只提供参考设计原理图和参考封装，不提供可直接投产的 PCB；底板 PCB 需要你基于参考设计自己完成。这不是「资料缺失」，而是模组类产品的常规交付方式。说明：模组是成品器件，客户要做的是承载板——电源与 LDO、SIM 卡座与 ESD、天线净空、USB 与下载电路都得按自己的结构重新布局。参考设计给的是「能跑通」的最小验证电路，直接照抄到量产板还要做电源余量、EMC 与热设计。处理步骤：① 下载参考封装（PADS/AD/LCEDA）与参考设计原理图；② 按硬件设计手册逐项核对 PWRKEY、RESET、USB_BOOT、VBAT 纹波与天线净空；③ 自己完成 PCB 并做首件验证；④ 需要评审可把原理图发 FAE 预检。参考文档：https://docs.openluat.com/air780epm/luatos/hardware/、https://docs.openluat.com/air780epm/product/shouce/

16. Air8780/Air8605等开发板是否有货、何时上架？

解答： 结论：到货与上架时间属商务事项，文档站给不了库存与排期；能确定的是 Air8605 与 Air8780 的资料都已上线，可以先按文档做选型与设计。原文里的「8605 数量不多、已在准备上架」「部分型号尚未提供开发板」是当时的沟通口径。说明：Air8605W/M 是基于 Air1602 + Air1103 的大屏 SIP 板（WiFi 版 / 4G 版），Air8780 是工业模组，产品、硬件、软件三套资料齐全，P/H/V/G/S/U/N 七个系列分别板载 Air780EPM/EHM/EHV/EGP/EGG/EHU/EHN。处理步骤：① 先按场景定型（要不要 SIP、要几路 485）；② 样品与交期找对接销售确认；③ 拿到实物后核对丝印完整型号再按对应文档开发。参考文档：https://docs.openluat.com/air8605/、https://docs.openluat.com/air8780/product/

17. Air8101+Air_camera_1034没有画面、无法设置320×240分辨率怎么办？

解答： 结论：两个问题要分开看——AirCAMERA_1034 的 UVC 输出规格是固定的 MJPG、最高 960×480@15fps，本来就没有 320×240 这一档；而 Air8101 目前在运行期改不了 UVC 分辨率，camera.get_usb_config/set_usb_config 在 8101 上是弱实现，要等固件支持。说明：1034 是 USB 双目 3D 活体人脸识别摄像头，除了 USB 图像通路，还需要一路 UART2 传控制命令与识别结果——只接 USB 是拿不到识别结果的，这也是「没有画面」的常见原因之一。要小图不要改 UVC 档位，用 camera.capture() 出图后自己裁切。处理步骤：① USB 与 UART2 都接好；② 用官方人脸识别 demo 先确认能出流；③ 需要小尺寸就 capture 后裁切/缩放；④ 分辨率切换等 8101 固件补齐后再用。参考文档：https://docs.openluat.com/accessory/AirCAMERA_1034/、https://docs.openluat.com/air8101/、https://docs.openluat.com/osapi/core/camera/

18. 最新V2022版本修复wlan.hostname无效，但实测仍显示wlan0怎么办？

解答： 尚未解答

19. Air780EGP开发板基站定位失败，提示ID/KEY错误或服务器拒绝怎么办？

解答： 结论：提示 ID/KEY 错误或服务器拒绝，先按 DEMO 原样跑一遍，核对 key_id 与项目 key 是否一一对应、设备归属项目是否与 key 所属项目一致；多数情况是 key 抄错、项目没开通或卡不能正常联网。说明：合宙 LBS 走的是云端接口，key 与项目绑定；换项目、换账号后旧 key 就失效。定位失败和「读不到模块标识」经常一起出现，可以用 hmeta.muid() 打印模块唯一标识，确认设备身份读取正常，再排查网络侧。处理步骤：① DEMO 不改代码直接跑；② 逐字核对 key_id 与项目 key；③ 确认卡已注网、能访问外网；④ hmeta.muid() 打印标识；⑤ 把 Luatools 完整界面和异常日志截图给 FAE。参考文档：https://docs.openluat.com/osapi/ext/lbsLoc2/、https://docs.openluat.com/osapi/core/hmeta/

20. Air780E的TTS不支持英文拼读、多音字读错，能否改用其他TTS库？

解答： 尚未解答

21. Air780EHV运行TTS提示未包含TTS资源、需要外挂SPI Flash怎么办？

解答： 结论：报「未包含 TTS 资源、需要外挂 SPI Flash」是固件选择问题——换成带 TTS 资源的固件即可；外挂 SPI Flash 是在固件已带引擎、但语音库要单独存放时的兜底方案。说明：TTS 属 exaudio 库，官方文档明确「仅支持中文语音合成」。中文音色库占空间不小，所以不是每个版本的固件都带；另外音频通路还需要编解码芯片（如 ES8311）与 PA，光有固件没有 codec 也出不了声。Air780EHV 相对 EHM 增加了 VoLTE/TTS 音频能力，是这条线上更合适的选择。处理步骤：① 到固件页确认所选版本是否注明支持 TTS；② 换成最新带 TTS 的固件重烧；③ 接 AirAUDIO_1010 这类带 ES8311 与 PA 的配件板（PA 开关拨 OFF 交由软件控制，避免 pop 音）；④ 仍缺资源就找 FAE 索取带资源的固件版本。参考文档：https://docs.openluat.com/air780epm/luatos/app/common/audio/、https://docs.openluat.com/air780ehv/luatos/firmware/version/

22. Air8783H量产包为EHM结尾，OTA升级提示硬件型号不匹配、设备拒绝升级怎么办？

解答： 结论：8783H 的出厂固件内核型号是 Air780EH2，不是 EHM；把量产包里的型号字段改成 EH2 后再上传，OTA 的硬件型号校验就能通过。说明：文档里 8783H 的出厂固件文件名就是 Air8783H_Factory_001.000.001_LuatOS-SoC_V2054_Air780EH2_13.soc，可见其内核按 EH2 编译。OTA 会把包内声明的硬件型号与设备上报的型号比对，不一致直接拒绝升级——所以「包名写 EHM」这种手误会被拦下来，属于保护机制而不是故障。处理步骤：① 核对量产包内的硬件型号字段；② 用官方给出的 8783H 固件为基础重新生成量产包；③ 改名或改字段为 EH2 后再上传；④ 失败时看 OTA 返回码与设备端日志，确认是型号还是版本号问题。参考文档：https://docs.openluat.com/air8783h/software/default_factory_firmware/

23. Air724UG设备归属不在自己项目中，能否通过烧录带归属固件自动归属？

解答： 结论：「烧一版带归属信息的固件让设备自动归属」这条路已经废弃，不建议再试；设备归属要联系原供应商（如银尔达）做转移。说明：设备归属是账号维度的权限，一旦落到某个用户名下，合宙侧就不再拥有单方面转移的权限——这一点在设备归属的官方说明里写得很明确。所以正确路径是「找到当前归属方 → 由归属方发起转移」，而不是在设备端想办法。处理步骤：① 在平台查设备当前归属的项目与账号；② 联系原供应商（整机/模组出货方）发起归属转移；③ 走 crm.luatos.com 的自助归属或用订单号+快递单号提交；④ 转移完成后重新在平台确认设备已出现在自己项目下。参考文档：https://docs.openluat.com/air780epm/product/attributioniot/

24. Air724UG阿里云OTA是否支持全量升级？

解答： 结论：内核固件不支持全量升级，只能差分；脚本支持全量升级，可以一次性完成。合宙 IoT 后台会自动做差分，用户侧无感。说明：差分包是 Luatools 用新旧两版固件做出来的增量包，体积小、适合 4G 流量受限的场景，但要求「升级前版本 < 升级后版本」，且新旧固件必须同型号。阿里云 IoT 的 FOTA 同样走这套差分包，所以平台侧也只能下发差分。处理步骤：① 只升级脚本：脚本版本号递增后生成差分包；② 要升内核：先出新版量产固件，再用新旧固件生成差分包；③ 在阿里云平台上传差分包并下发；④ 文件名过长会导致上传失败，注意缩短。参考文档：https://docs.openluat.com/air780epm/luatos/app/iotcloud/aliiot/

25. Air724UG U盘功能授权问题，购买模块能否配套授权？

解答： 结论：U 盘（USB MSC）功能自 4028 版本以后的固件默认已带授权，不需要单独购买或定制；原答提到「已反馈内部进一步处理」，是对特定批次的跟进，不改变通用口径。说明：U 盘功能本质是让模组把自身文件系统以 USB 大容量存储设备的形式暴露给主机，属于固件能力而不是需要联网校验的授权项。用很早以前的老固件才可能需要单独申请，新固件直接用即可。处理步骤：① 确认固件版本是否 4028 之后（新固件都满足）；② 用 USB 线接电脑，看是否枚举出 U 盘；③ 不识别先换数据线、换 USB 口；④ 老固件确需授权，把型号与固件版本发对接 FAE 确认。参考文档：https://docs.openluat.com/osapi/core/fatfs/、https://docs.openluat.com/common/usb_drv/

26. Air8201H的USB口接5V能否给锂电池充电？

解答： 结论：Air8201H 的硬件资料里明确标注了「充电管理」，但 USB 口 5V 到底会不会给锂电池充电，要看该子型号原理图里 VBUS 是否接入了充电 IC；电池的主供电路径仍然是 VBAT，不是 USB。说明：这类整机板常见两种设计——VBUS 只做枚举与下载、充电走独立充电电路；或者 VBUS 直接进充电管理。两者外观一样、行为完全不同，只能按原理图判断，不能凭「插上 USB 能亮」推断在充电。另外若电池电压过低会触发低电保护，需要先充一会儿再长按开机。处理步骤：① 查 Air8201H 该子型号（BM / 基础版）的原理图，确认 VBUS 与充电 IC 的连接；② 电池接 VBAT，按极性核对；③ 长按按键开机；④ 电量长期上不去，用万用表量 VBAT 与充电电流判断是否真的在充。参考文档：https://docs.openluat.com/air8201/hardware/、https://docs.openluat.com/air8201/hardware/8201H/

27. Air8201H淘宝购买默认有固件吗？如何枚举USB？

解答： 结论：淘宝购买的 Air8201H 默认带出厂固件，上电即可正常工作；如果电脑枚举不出串口，先查数据线、端口和供电，而不是怀疑没固件。说明：Air780/700/8000/8201 这一代 4G 模组在 Windows 上是免驱的——需要装 USB 驱动的只有 Air724、Air795、Air720、Air722 这几款老平台。所以「设备管理器里什么都没有」通常是线是纯充电线、USB 口供电不足、或者板子没真正开机。处理步骤：① 换一根能传数据的短线；② 关掉电脑蓝牙（部分蓝牙虚拟串口会抢占）；③ 设备管理器看是否有未知设备/端口；④ 电池走 VBAT 供电并长按按键开机；⑤ 换电脑或换 USB 口交叉验证。参考文档：https://docs.openluat.com/common/usb_drv/、https://docs.openluat.com/air8201/hardware/

28. Air8202G板载SIM卡是否支持访问外网自有服务器？

解答： 结论：可以。Air8202G 板载的是标准 2mm×2mm 贴片 SIM（默认卡），只要你的服务器在公网可达（有公网 IP 或域名），模组就能直接连上去。说明：受限的通常不是模组，而是卡——物联网卡可能绑定专用 APN、关闭公网入向、或只允许访问备案域名；海外服务器还要看链路是否被限。模组侧只提供 TCP/UDP/HTTP/MQTT 这些标准能力，没有「只能连指定平台」的限制。处理步骤：① 用 socket 或 http 直连你的服务器 IP+端口测通；② 失败先查卡 APN 与套餐是否允许公网访问；③ 用域名的话先确认 DNS 解析正常；④ 需要加密就用 TCP+SSL 并带对 CA。参考文档：https://docs.openluat.com/air8202/hardware/circuit/、https://docs.openluat.com/osapi/core/socket/

29. Air8000系列淘宝为何50片起卖，能否单卖几个打样？

解答： 结论：Air8000 系列目前 50 片起售，暂不单卖几片打样。这是销售政策，不是技术限制。说明：官方给出的原因是散客小批量焊接与调试问题多、排查困难、技术支持成本高；对正常企业打样来说 50 片通常可以接受。如果只是想先验证功能，可以先买开发板或核心板把方案跑通，再按 50 片走正式采购。处理步骤：① 功能验证阶段用开发板/核心板；② 立项后按 50 片批量采购；③ 需要少于 50 片的特殊情况，直接找对接销售沟通，能否破例由销售判断。参考文档：https://docs.openluat.com/air8000/product/、https://docs.openluat.com/SelectionGuide/SelectionGuide/

30. Air8780P4电池供电时如何实现开关机控制？

解答： 结论：Air8780P4 没有板载 DCDC，只能用 VBAT（3.3~4.2V）供电，支持锂电池充电；开关机靠 PIN4 PWRKEY——上电自动开机，可软件配置为下降沿关机；要彻底断电得在 VBAT 通路上加开关或 MOS 管。说明：官方在硬件手册里对 P3/P4/V3/V4/G3/G4 这批无 DCDC 型号有黄色警示：插上 USB 线看起来能开机，实际是充电芯片漏电所致，不是稳定电源、不可当供电用；充电芯片只能给锂电池充电。所以「电池供电 + 开关机控制」要按「电池 → 开关/MOS → VBAT」来设计，PWRKEY 只负责开机与软件关机。处理步骤：① 电池接 VBAT，正负极不要接反；② 用按键或 MOS 控制 VBAT 通断做硬关机；③ 软件里把 PWRKEY 下降沿配置为关机动作；④ USB 只用于下载与调试，不要靠它供电；⑤ 调试前先确认 VBAT 稳定。参考文档：https://docs.openluat.com/air8780/hardware/circuit/、https://docs.openluat.com/air8780/product/

31. Air780EPM的mobile.rssi()返回-999是怎么回事？

解答： 结论：-999 表示取不到有效值（未驻网或信号极差）。官方对同类参数的说明是「RSRP = -999，一般是卡的问题，需要联系运营商确认卡状态」。说明：正常 RSSI/RSRP 是有符号的负值（RSRP 取值 -44 ~ -140，越大越好，失败返回 0）。返回 -999 属于「异常占位值」，说明模组还没拿到有效的测量结果——卡未激活、欠费停机、卡座接触不良，或者天线没接、处在完全无覆盖的环境，都会这样。处理步骤：① 查卡是否欠费、停机、未激活；② 确认天线接好、处在有覆盖的位置；③ 用 AT+CSQ、mobile.rsrp() 交叉看；④ 换一张已知正常的卡验证，排除卡本身问题；⑤ 仍 -999 就把日志给 FAE。参考文档：https://docs.openluat.com/osapi/core/mobile/

32. Air8101的TTS/音频demo播放不了怎么办？

解答： 结论：先确认固件是否带音频/TTS 资源。Air8101 早期固件（如 v2002）明确「暂时未支持音频相关功能」，完整音频能力规划在 Air8101B（16MB+16MB）上实现。说明：Air8101 是 WiFi SoC，片上空间小，音频要占额外的音色库与解码资源；硬件上还需要编解码芯片（如 ES8311）和 PA。所以「demo 播不了」常见三种原因：固件不带音频、没接 codec/PA、资源文件没放对路径。处理步骤：① 到固件页查该版本是否注明支持音频；② 换成注明支持的固件，或改用 Air8101B；③ 接带 ES8311 的音频配件板并确认 PA 使能；④ 按 demo 原样跑，先放内置提示音再放 TTS。参考文档：https://docs.openluat.com/air8101/luatos/firmware/、https://docs.openluat.com/air8101/

33. Air1601/Air780ER2的airlink库没有销毁接口，与BLE复用UART3冲突怎么办？

解答： 结论：目前 airlink 库确实没有「销毁/停止」接口，与 BLE 复用同一路 UART3 会互相抢数据；已提 issue，需要研发评估增加销毁或暂停心跳帧的接口，不是一两天能完成的改动。说明：airlink 是主从之间的透传协议，会周期性发心跳帧占住串口；BLE 也在同一路 UART 上收发时，两者的帧会交错，表现为「数据乱、连接掉」。在接口补齐之前，只能靠业务层严格分时——同一时刻只让一套协议占着 UART3。处理步骤：① 设计上避免让 BLE 与 airlink 同时工作；② 切换前先停掉对端心跳（或断开对端设备），等串口空闲再初始化另一套；③ 关注 airlink 库更新，接口发布后改用显式销毁；④ 有具体时序问题把日志发 FAE 一起看。参考文档：https://docs.openluat.com/osapi/core/airlink/、https://docs.openluat.com/osapi/core/ble/

34. Air780EGP与Air780EGG是否可以共用核心板？

解答： 结论：可以共用。官方就有 Air780EGP / Air780EGG / Air780EGH 共用的核心板资料，三款管脚定义一致。说明：三款同属 Air780Exx 系列、都只支持 LuatOS 二次开发（不支持 AT，要 AT 选 Air780EGT），都是面向国内的全网通模组。差别在资源：Air780EGG 是 8MB+8MB 且内置 G-Sensor；Air780EGP 是 4MB+4MB，同样内置 G-Sensor，但空间小一半，不支持 Audio 与 AirUI；Air780EGH 是 8MB+8MB。换型号必须烧对应型号的固件，不能拿 EGG 的固件刷 EGP。处理步骤：① 按是否需要 Audio/AirUI 定型号（要音频就别选 EGP）；② 共用同一块核心板即可，注意换型号后重烧固件；③ 用 G-Sensor 的方案（如 exgnss、exvib）在 EGH 上要另配。参考文档：https://docs.openluat.com/air780egh/product/air780egp_egg_egh_coreboard/、https://docs.openluat.com/air780egh/product/

35. Air780E和Air780EX2T软件是否通用？

解答： 结论：不能通用。Air780E 是 ec618 平台，LuatOS 与 AT 用同一个型号；Air780EX2 是 LuatOS 型号、Air780EX2T 是对应的 AT 专用型号（ec718 平台）——固件不互通，只是 AT 指令层面大差不差。说明：文档特别提醒过这一点：Air780EX 是 LuatOS 和 AT 同一个型号，Air780EX2 与 Air780EX2T 则把型号区分开了。跨平台（ec618 与 ec718）刷固件会直接变砖，所以「软件通用」这个说法只在「AT 指令的用法相似」这一层成立。处理步骤：① 先看丝印确认是 E 还是 EX2/EX2T；② 按型号到对应固件页下载；③ AT 命令脚本在两者间迁移时逐条回归测试；④ 需要 LuatOS 二次开发就必须选 EX2，不能用 EX2T。参考文档：https://docs.openluat.com/air780ex2/product/

36. Air780EHV接入认证固件上电后串口输出异常log、AT无回复怎么办？

解答： 结论：认证固件为了满足认证要求会改动部分默认行为，上电那段「异常 log」可以先不管，先发 AT / ATI 确认串口通不通，再按注网状态往下查。说明：认证固件与通用固件不是同一份二进制，日志格式、默认波特率、默认串口行为都可能不同。判断标准只有一个：能不能正常应答 AT。如果 AT 有 OK 而 ATI 也正常返回型号版本，说明模组是活的，剩下的只是业务配置问题。处理步骤：① 发 AT 看是否回 OK；② 发 ATI 看型号与版本；③ 检查串口工具的「回车换行」是否为 CRLF、波特率是否匹配；④ 发 AT+CGATT? 看是否注网；⑤ 换 USB 端口再试，最后把完整日志发 FAE。参考文档：https://docs.openluat.com/air780ehv/luatos/firmware/version/、https://docs.openluat.com/common/howtouselog/

37. Air8202G板载SIM卡能否用于外网自有服务器？

解答： 结论：可以。Air8202G 板载 2mm×2mm 贴片 SIM（默认卡），是标准的 4G 数据卡，只要你的服务器在公网可达（有公网 IP 或域名），模组就能连上去。说明：模组侧只提供 TCP/UDP/HTTP/MQTT 这些标准网络能力，不存在「只能连合宙平台」的限制。真正可能挡住你的是卡：物联网卡可能绑定专用 APN、关闭公网入向、或只放行备案域名；海外服务器还要看链路。处理步骤：① 用 socket 直连服务器 IP+端口做最小验证；② 不通先查卡 APN 与套餐；③ 用域名的话先确认 DNS 解析；④ 需要加密就用 TCP+SSL 并带上正确的 CA。参考文档：https://docs.openluat.com/air8202/hardware/circuit/、https://docs.openluat.com/osapi/core/socket/

38. Air720UH/Air720H是否有相关电路参考资料？

解答： 结论：文档站没有 Air720 系列的独立资料树（Air720 属早期平台），电路参考可以直接用立创商城上的 Air720H 数据手册。说明：Air720/Air722/Air724/Air795 是合宙早期的 4G 平台，在文档站里只有零散的 AT/应用资料，没有像 780/8000 这样完整的产品-硬件-软件三件套。这几个平台还有一个共同点：都需要在 Windows 上安装 USB 驱动，跟 780 之后的免驱型号不一样。处理步骤：① 在立创商城检索「Air720H」下载数据手册与封装；② 按手册核对电源、SIM、USB 与天线设计；③ 装对应的 USB 驱动再做下载调试；④ 新项目建议直接评估 Air780EPM 等现役型号，资料与供货都更完整。参考文档：https://docs.openluat.com/common/usb_drv/

39. Air8000W的57、58脚能否用作DO输出？

解答： 尚未解答

40. Air8780V1/V2工业模组出厂是否已烧录固件？实际开发用哪个固件？

解答： 结论：Air8780 出厂已烧录默认固件（当前版本 001.001.002），可以直接上电验证；P/G/H/N/S/U 内核为 LuatOS-SoC_V2054，V 系列内核为 V2052_Air780EHV_13。实际开发建议换成对应型号的最新 LuatOS 固件。说明：出厂固件是「整机可用」的默认版本，可能带了出厂业务逻辑；量产包（.soc + 量产文件）用于批量生产，普通固件用于开发调试，两者用途不同，不要混用。V1/V2 只是天线与供电形式的差别（V1 板载天线 + 板载 DCDC，V2 IPEX 外接 + 板载 DCDC），内核都是 Air780EHV。处理步骤：① 先上电确认能跑，记下固件版本；② 到 air8780/software/default_factory_firmware 下载对应型号最新固件；③ 开发用普通固件，量产再生成量产包；④ 换固件后核对版本号与功能是否正常。参考文档：https://docs.openluat.com/air8780/software/default_factory_firmware/、https://docs.openluat.com/air8780/product/

41. Air780E的TTS demo提示未包含TTS资源、需要外挂SPI Flash怎么办？

解答： 结论：这是固件没带 TTS 资源导致的，换带 TTS 的固件即可；固件已带引擎而语音库要单独存放时，才按硬件设计外挂 SPI Flash。说明：TTS 属 exaudio 库，官方口径是「仅支持中文语音合成」，音色库占空间，所以部分固件不带。另外 Air780EPM 明确不支持 audio 库，要音频能力得选 Air780EHM / Air780EHV 这类型号，并且需要外挂编解码（如 ES8311）与 PA。处理步骤：① 确认型号是否支持 audio 库（EPM 不支持）；② 到固件页确认版本是否注明支持 TTS；③ 换带 TTS 的固件；④ 接 AirAUDIO_1010 类配件板验证出声；⑤ 资源仍缺就找 FAE 要版本。参考文档：https://docs.openluat.com/air780epm/luatos/app/common/audio/、https://docs.openluat.com/air780epm/luatos/firmware/780ehm_version/

42. Air780E系列支持MQTT5.0吗？

解答： 结论：不支持。LuatOS 的 mqtt 库文档明确写着「只支持 mqtt 3.1.1，其他版本例如 3.1 或者 5.0 均不支持」，也不支持 mqtt over websocket。说明：MQTT 5.0 的特性（用户属性、共享订阅、原因码、主题别名等）在这个库里都没有实现。另外要特别注意：模块端没有上行重发机制，也没有缓存，上行失败只能靠重连——这一点比版本号更容易踩坑。处理步骤：① 服务端按 3.1.1 对接；② 必须用 5.0 就在平台侧加协议转换网关；③ 业务层自己做重发与去重；④ 长连接加心跳与自动重连，断线后重新订阅。参考文档：https://docs.openluat.com/osapi/core/mqtt/

43. Air724UG的U盘功能授权如何免费获取？

解答： 结论：不需要额外申请，4028 版本以后的 LuatOS 固件默认已带 U 盘（USB MSC）功能授权，这个功能本身是免费的。说明：U 盘功能是把模组文件系统以 USB 大容量存储的形式暴露给主机，属于固件内置能力，不是要联网校验的授权项。用很早以前的老固件才可能需要单独申请；新固件直接用。处理步骤：① 确认固件版本在 4028 之后；② USB 接电脑看是否枚举出盘符；③ 不识别先换数据线、换 USB 口、关掉占用串口的软件；④ 老固件确需申请，把型号与固件版本发 FAE。参考文档：https://docs.openluat.com/osapi/core/fatfs/、https://docs.openluat.com/common/usb_drv/

44. Air780E的ADC读取电池电压比万用表低，充不满100%怎么办？

解答： 结论：ADC 读数比万用表低、电量显示充不满 100%，先分清是「测量误差」还是「分压/算法问题」——官方口径 ADC 插值误差最大约 70~80mV 量级，先用稳压电源确认是否在这个范围内。说明：锂电「充满」的判定在充电 IC 一侧（通常 4.2V 截止），模组的 ADC 只是把 VBAT 分压后读回来；分压电阻的实际阻值偏差、ADC 参考误差、以及电量百分比算法的曲线，都会让显示值偏离真实电压。另外电池必须带保护板，否则低压段读数会飘。处理步骤：① 用稳压电源给几个固定电压（3.6/3.8/4.0/4.2V），对比 ADC 读数算偏差；② 偏差超 70~80mV 就核对分压电阻实际阻值与焊接；③ 确认电池有保护板、接触良好；④ 电量百分比按实测曲线做两点或多点校准。参考文档：https://docs.openluat.com/air780epm/luatos/app/driver/adc/、https://docs.openluat.com/osapi/core/adc/

45. Air780EGP能否配置电池？

解答： 尚未解答

46. Air8000系列核心板蓝牙/WiFi空旷环境距离多远？

解答： 结论：官方标称 Air8000 的蓝牙发射功率为 6dBm（不可调整）、最远通讯距离在 10 米左右；这是理想空旷条件下的上限，实际通常只有几米，隔墙或金属外壳内更短。核心板天线性能一般，而且蓝牙与 WiFi 共用同一根天线。说明：6dBm 属低功率档，是为共存与功耗做的取舍。BLE 与 WiFi 同时工作时会分时占用同一路射频，距离与吞吐都会进一步下降；金属外壳、电池仓、屏幕背板紧贴天线，衰减非常明显。处理步骤：① 现场用 RSSI 实测不同距离的衰减曲线，别只看标称值；② 天线区域留净空，远离金属件与电池；③ 降低连接间隔/速率换取距离；④ 要远距离就选外置天线方案或换用 WiFi 长距方案。参考文档：https://docs.openluat.com/air8000/luatos/app/BLE/central/、https://docs.openluat.com/air8000/luatos/app/BLE/

47. Air780E模块插上Luatools无日志、板子发烫怎么办？

解答： 结论：插上 Luatools 完全没日志、板子还明显发烫，优先怀疑硬件已损坏（短路、浪涌击穿），不要继续反复上电，直接走售后维修。说明：正常待机时模组不该有明显温升。发烫 + USB 不枚举，典型原因是电源域被击穿（例如 USB 5V 灌进了 3.3V 域）或 USB 保护器件损坏；这种情况下继续供电可能扩大损坏范围。软件层面的「没日志」不会伴随发烫。处理步骤：① 立即断电、拔掉 USB；② 有条件先量 VBAT/VDD_EXT 对地阻抗，明显偏低就是短路；③ 寄回售后维修，包裹里附纸条写清故障现象、型号、数量与回寄地址；④ 维修期间排查供电与浪涌来源，避免换新再坏。参考文档：无（属售后事项，请通过购买渠道或对接销售确认）。

48. Air8603模块与电脑无法连接、USB驱动重装、TOOLS升级后仍无反应怎么办？

解答： 结论：驱动重装、工具升级都没反应，先别急着认定硬件坏——先等调试信息输出、确认 USB 转串口那一路上号，再按 BOOT 复位或重烧固件。说明：Air8603 主控是 Air1603，板上的 USB 口经 USB 转串口芯片（CH343 一类）接到主控，Windows 里应该出现 USB-SERIAL CH343 这类端口；「完全没有新设备」通常是线是纯充电线、USB 口供电不足或板子没进下载模式。「有端口但连不上」则是端口被占或固件与型号不匹配。处理步骤：① 设备管理器确认是否出现串口，没有就先装 CH343 驱动；② 用最新版 Luatools，勾「通用串口打印」并先打开串口；③ 按住 BOOT 再复位进下载模式；④ 重烧与该型号匹配的固件；⑤ 换短线直连、换 USB 口、必要时外部稳压供电。参考文档：https://docs.openluat.com/air8603/、https://docs.openluat.com/air1603/luatos/common/download/、https://docs.openluat.com/common/Luatools/

49. Air780E的TTS如何设置才能播报英文单词？

解答： 尚未解答

50. Air780EPM/780EGP的GPIO在任务中操作不好用、看门狗如何喂狗？

解答： 结论：任务里操作 GPIO 不好用，通常是初始化方式不对——不要在业务代码里反复 pins.setup()，按 demo 在启动阶段配置一次，之后用 gpio.set/gpio.get 读写；看门狗用 wdt.feed() 周期喂。说明：pins.setup() 会重新配置引脚复用，重复调用会把已经配好的功能（串口、SPI、PWM）打回去，表现就是「刚才还能用，一调用就失效」。IRTU 这类框架已经在启动时初始化过引脚，业务里再 setup 就会冲突。处理步骤：① 引脚只在初始化阶段配置一次；② 运行时只用 gpio.set/gpio.get；③ 看门狗在单独任务里定时 wdt.feed()，别放在可能长时间阻塞的循环里；④ 长任务拆成分片，中间让出 CPU。参考文档：https://docs.openluat.com/osapi/core/wdt/、https://docs.openluat.com/common/watchdog/

51. Air780EHV的TTS能否外挂IIS DAC实现？

解答： 结论：可以外挂 I2S DAC 把声音放出来，但解决不了「英文拼读」——官方 TTS 引擎只做中文合成，换 DAC 换不了语种。说明：DAC 只负责把数字音频变成模拟波形，合成什么语言是 TTS 引擎的事。文档里明确「仅支持中文语音合成」，所以英文单词、多音字读错这一类属于引擎能力边界。可行的替代是把英文提示音预先录成音频文件（MP3/WAV）播放。处理步骤：① 确认固件带 TTS 资源；② I2S 接 DAC 与 PA，先验证中文 TTS 能出声；③ 英文内容改成预录音频文件，按场景播放；④ 需要动态英文播报就得上位机/云端合成后下发音频。参考文档：https://docs.openluat.com/air780epm/luatos/app/common/audio/、https://docs.openluat.com/osapi/core/i2s/

52. Air780E的TTS为何不支持英文，能否换成其他TTS库？

解答： 尚未解答

53. Air780EPM的ADC读取电压与万用表差多少？

解答： 结论：官方口径是 ADC 插值误差最大约 70~80mV，和万用表差在这个量级内属正常；超过就查分压电阻与电池保护，不要先怀疑模组坏了。说明：模组 ADC 是「分压后采样 + 插值换算」，误差来自三处——分压电阻的实际阻值偏差（1% 精度也会有偏差）、ADC 自身的参考与线性度、以及采样时刻的负载波动。用万用表量的是静态电压，两者本来就不是同一口径。处理步骤：① 用稳压电源给固定电压逐点比对；② 换算偏差是否在 70~80mV 内；③ 超差先量分压电阻实际值、检查焊点；④ 电池必须带保护板，接触电阻也会拉低读数。参考文档：https://docs.openluat.com/air780epm/luatos/app/driver/adc/、https://docs.openluat.com/osapi/core/adc/

54. Air780E/780EPM的U盘功能如何授权？

解答： 结论：不需要授权也不需要定制——4028 版本以后的 LuatOS 固件默认已带 U 盘（USB MSC）功能，直接就能用。说明：U 盘功能是固件内置能力，把模组文件系统以 USB 大容量存储设备的形式暴露给主机；不是联网校验的授权项，因此不存在「买授权」这一步。Air780E / Air780EPM 这一代固件都在 4028 之后。处理步骤：① 用现役固件即可；② USB 接电脑看是否枚举出盘符；③ 不识别先查数据线与 USB 口；④ 需要定制容量或分区，另找 FAE 评估。参考文档：https://docs.openluat.com/osapi/core/fatfs/、https://docs.openluat.com/common/usb_drv/

55. Air780E/780EPM的SIM卡VREF引脚在哪里？

解答： 结论：SIM 卡的 VREF（SIM_VDD）脚位不同型号不一样，必须查对应型号的硬件手册或管脚图，不能跨型号套用。说明：SIM 接口一般有 CLK/DATA/RST/VDD 四根线加地，其中 VDD 由模组内部 LDO 输出（1.8V 或 3.0V 自适应），对外只需按参考设计接去耦电容与 ESD 器件，不要外接电源去顶。Air780Exx 各型号虽然同系列，但管脚编号在 SiP 内部映射不同。处理步骤：① 打开该型号 product/shouce 的管脚表；② 搜 SIM_VDD/VREF 的管脚编号；③ 按参考设计接 4.7uF + 100nF 去耦与 ESD；④ 卡不识别时先量 VDD 是否正常输出。参考文档：https://docs.openluat.com/air780epm/product/shouce/

56. Air780E/780EPM的基站定位失败、lbsLoc2正常但hmeta.muid为空怎么办？

解答： 结论：hmeta.muid() 返回空说明读不到模块唯一标识，通常是调用时机太早或固件版本不支持；基站定位失败则先核对 key_id 与项目 key 是否匹配、设备是否已归属到同一个项目。说明：muid 是模组侧的硬件唯一标识，一般要等系统初始化完成、联网之后再取才稳定；在上电最开始就调用容易拿到空值。LBS 走的是云端接口，key 与项目绑定，换账号或换项目后旧 key 直接失效，表现就是「参数对但被服务器拒绝」。处理步骤：① DEMO 原样跑，muid 放到联网成功后取；② 逐字核对 key_id 与项目 key；③ 确认设备归属项目与 key 所属项目一致；④ 用 AT+CGATT? 确认已注网；⑤ 把 Luatools 完整界面与异常日志截图发 FAE。参考文档：https://docs.openluat.com/osapi/core/hmeta/、https://docs.openluat.com/osapi/ext/lbsLoc2/

57. Air780E/780EPM的WiFi hostname设置无效怎么办？

解答： 尚未解答

58. Air780EPM/780EHM的GB28181功能只有特定固件才支持吗？

解答： 结论：是，GB28181 不是通用固件默认带的功能，必须烧带该能力的固件。按原答口径，目前测试可用的版本是 LuatOS-SoC_V2055_Air780EHM；这个版本不在公开固件页列表内（公开最新为 V2054），需要向 FAE 索取。EHV 固件会提示不支持。说明：GB28181 是国标视频监控联网协议，主要面向 Air8784 SIP 整机这条线做适配，需要在平台侧同步完成信令与媒体流的对接。所以「换固件」只是第一步，平台侧不配合也接不进去。处理步骤：① 确认主控型号是 Air780EHM 还是 EHV；② 向 FAE 索取带 GB28181 的固件版本；③ 平台侧完成国标接入配置；④ 用抓包确认注册与心跳是否正常。参考文档：https://docs.openluat.com/air8784/product/、https://docs.openluat.com/air780epm/luatos/firmware/780ehm_version/

59. Air780EHM/EHV的语音对讲平台到设备无声音怎么办？

解答： 结论：平台到设备没声音，先确认「固件版本与芯片型号是否匹配」，再把底层日志给合宙分析；log/4gdial 目录里的日志是定位这个问题的关键材料。说明：语音对讲链路上有「平台 → 4G 语音通道 → codec → PA → 喇叭」好几段，任何一段断都会表现为无声。固件与型号不匹配时，音频通路参数（采样率、通道、codec 配置）会整体错位，日志里通常能看到初始化失败或 codec 无响应。处理步骤：① 核对固件版本与 Air780EHM/EHV 型号一致；② 取出 log/4gdial 目录日志；③ 提供 Luatools 完整界面截图；④ 检查 PA 使能与喇叭接线；⑤ 把材料发 FAE 一起看。参考文档：https://docs.openluat.com/common/howtouselog/、https://docs.openluat.com/air780ehv/luatos/firmware/version/

60. Air780E/780EPM的USB无法识别、设备管理器无端口怎么办？

解答： 结论：Air780E/780EPM 这一代 4G 模组在 Windows 上是免驱的——需要装 USB 驱动的只有 Air724/Air795/Air720/Air722。所以「设备管理器里没有端口」基本不是驱动问题，先查线、USB 口和供电。说明：免驱意味着插上就该出现多个 CDC 端口（AT 口、日志口、下载口）。如果什么都没有，通常是纯充电线、USB 口供电不足、或者模组没真正开机（VBAT 没电、PWRKEY 没触发）。只有经过板载 TTL 转 USB 芯片（CH343/CH347F）的方案才需要装那颗芯片的驱动。处理步骤：① 换一根确定能传数据的短线；② 关掉电脑蓝牙避免虚拟串口抢占；③ 设备管理器看「其他设备」里是否有未知设备；④ 换 USB 口、避免过 Hub；⑤ 用测试烧录针直连模组再试。参考文档：https://docs.openluat.com/common/usb_drv/、https://docs.openluat.com/common/howtodown/

61. Air780E/780EPM的SIM卡预销号后能否续费恢复？

解答： 结论：账户开通「允许预销号卡续费」之后可以直接提交续费；预销号状态没有对外接口能直接重置，需要把卡号发给对接人开权限。说明：预销号是运营商侧的卡状态，模组无法干预，也读不到「能不能续」这种信息。续费成功后网络侧重生效还有延迟，需要让模组重新附着——AT+CFUN=0 再 AT+CFUN=1，或者直接重启。处理步骤：① 确认卡状态与套餐；② 让账户开通「允许预销号卡续费」；③ 提交续费后重启模组重新附着；④ AT+CEREG?/AT+CGPADDR=1 确认注网与拿到 IP；⑤ 仍不行把卡号发群里开权限。参考文档：无（属运营商/资费事项，请联系购卡渠道或对接销售确认）；技术侧可参考 https://docs.openluat.com/osapi/core/mobile/

62. Air780E/780EPM的OTA升级到不存在的default版本、设备连不上平台怎么办？

解答： 结论：设备端不会凭空发起升级，OTA 一定是平台下发触发的；出现「升级到不存在的 default 版本」，说明平台下发的是空版本号包或不合法包，模块侧有校验，格式不对不会真正升级。说明：阿里云 IoT 的 OTA 流程是「平台推 upgrade 消息 → 设备拉包 → 校验型号/版本 → 写 flash」。default 通常是包里版本字段没填导致的占位值；再叠加「差分包要求升级前版本 < 升级后版本」，版本号填错就会被校验挡住。处理步骤：① 让平台提供设备请求的时间点与包的位置作为证据；② 核对包内型号与版本字段；③ 用 Luatools 按新旧固件重新生成差分包；④ 重新上传下发，同时抓设备日志确认校验结果。参考文档：https://docs.openluat.com/air780epm/luatos/app/iotcloud/aliiot/

63. Air780E/780EPM的OTA订阅topic是否正确？

解答： 结论：设备订阅 /ota/device/upgrade/<ProductKey>/<DeviceName> 接收升级通知，用 /ota/device/inform/<ProductKey>/<DeviceName> 上报当前版本。没有 OTA 包下发就不会真正升级。说明：这两个 topic 是阿里云 IoT 的标准约定，ProductKey 与 DeviceName 必须与设备三元组完全一致（大小写、连字符都算）。订阅成功但收不到消息，多半是 topic 拼错、或者平台侧根本没建升级任务。处理步骤：① 核对 topic 里的 ProductKey/DeviceName；② 订阅后确认返回成功；③ 平台建升级任务并确认已下发；④ 设备收到后先校验包，再写 flash；⑤ 抓日志确认请求与下载过程。参考文档：https://docs.openluat.com/air780epm/luatos/app/iotcloud/aliiot/

64. Air780E系列4G对讲/SIP方案推荐哪个模组？

解答： 结论：4G 对讲/SIP 首选 Air8701——它是 SIP 双工通话方案，内置回声抑制芯片，专门解决免提场景的回声问题；按原答口径目前尚未开始销售。已经能落地的还有 Air8784（Air780EHM + Air1103 的 SIP 整机）与 Air8605W/M（Air1602 + Air1103 的大屏 SIP 板）。说明：普通 4G 模组做 SIP 时，回声抑制非常弱，只能靠结构上把 Mic 与喇叭隔开；Air1103 是合宙自研的语音芯片，负责麦克风采集与 AEC 回声消除，这正是 8784/8605 与「裸模组 + SIP」的关键差别。处理步骤：① 确认是否需要免提双向通话与 AEC；② 需要就选 8701 / 8784 / 8605；③ 结构上仍要做好 Mic 与喇叭的隔离；④ 销售状态与样品找蒋骞或对接销售确认。参考文档：https://docs.openluat.com/air8701/、https://docs.openluat.com/air8784/product/、https://docs.openluat.com/air8605/

65. Air780EPM/780EHV的TTS资源如何外挂SPI Flash？

解答： 结论：优先换「带 TTS 资源」的固件；只有在固件已带引擎、而语音库需要单独存放时，才按硬件设计外挂 SPI Flash。说明：TTS 属 exaudio 库、官方口径仅支持中文合成，音色库体积不小，所以不是每版固件都内置。硬件上路要通还需要编解码芯片（如 ES8311）与 PA；Air780EPM 明确不支持 audio 库，要音频能力得用 Air780EHM/Air780EHV。处理步骤：① 确认型号支持 audio（EPM 不支持）；② 到固件页核对版本是否带 TTS；③ 换带 TTS 的固件；④ 接 AirAUDIO_1010 类配件板（PA 开关拨 OFF 由软件控制）；⑤ 资源确实放不下再评估外挂 SPI Flash。参考文档：https://docs.openluat.com/air780epm/luatos/app/common/audio/、https://docs.openluat.com/air780epm/luatos/firmware/780ehm_version/

66. Air780E/780EPM的U盘授权是否收费？

解答： 结论：免费。U 盘（USB MSC）授权功能很早就放开了，4028 版本以后的固件默认内置，不需要付费也不需要单独申请。说明：这是固件内置能力，不是联网校验的授权项；把模组文件系统以 USB 大容量存储形式暴露给主机即可。用很早以前的老固件才可能需要单独确认。处理步骤：① 确认固件版本在 4028 之后；② USB 接电脑看盘符；③ 不识别先换线与 USB 口；④ 老固件把型号与版本发 FAE 确认。参考文档：https://docs.openluat.com/osapi/core/fatfs/、https://docs.openluat.com/common/usb_drv/

67. Air780E/780EPM的SIM卡VREF引脚怎么接？

解答： 结论：SIM 卡 VREF（SIM_VDD）的脚位按型号各不相同，必须查该型号硬件手册的管脚表，不能凭同系列就照搬。说明：SIM_VDD 由模组内部 LDO 输出（1.8V/3.0V 自适应），对外只需按参考设计接去耦电容与 ESD，不要外接电源硬顶，否则会与内部 LDO 打架。Air780Exx 各型号的管脚编号在 SiP 内部映射不同，这也是「同一个脚在不同型号上功能不同」的原因。处理步骤：① 打开该型号 product/shouce 的管脚表；② 搜 SIM_VDD/VREF；③ 按参考设计接 4.7uF + 100nF 与 ESD；④ 卡不识别先量 VDD 输出是否正常。参考文档：https://docs.openluat.com/air780epm/product/shouce/

68. Air780E/780EPM的AirLink与BLE共用UART3冲突怎么办？

解答： 结论：airlink 目前没有销毁/停止接口，与 BLE 共用 UART3 会互相抢串口；已提 issue，需要研发增加 airlink 销毁或暂停心跳帧的接口。当前可通过「切换前先停止 airlink 一侧、避免并发」来规避。说明：airlink 会周期性发心跳帧占住串口，BLE 同时收发时帧会交错，表现为数据错乱、连接掉线。这不是配置问题，是协议层缺一个「优雅退出」的入口。处理步骤：① 设计上避免 BLE 与 airlink 同时工作；② 切换前先确认对端停止发送，串口空闲后再初始化另一套；③ 关注 airlink 库更新；④ 具体时序问题把日志发 FAE。参考文档：https://docs.openluat.com/osapi/core/airlink/、https://docs.openluat.com/osapi/core/ble/

69. Air780E/780EPM的功耗MQTT与MQTTS差异大正常吗？

解答： 结论：如果纯 TCP 与 TCP+SSL 测出来功耗没差别，那么 MQTT 与 MQTTS 也不该有明显差别；一旦差异很大，先怀疑测试条件不一致，而不是协议本身。说明：TLS 的开销集中在握手阶段（一次性），长连接维持阶段只是加密解密，对平均电流影响很小。真正拉开功耗差距的是心跳间隔、断线重连频率、信号强度（发射功率自适应）以及是否进入低功耗模式。处理步骤：① 用同一块官方核心板、同一张卡对比；② 固定心跳间隔与会话时长；③ 记录一段时间内的平均电流，而不是瞬时峰值；④ 同步记录信号强度，排除弱信号导致的反复重连。参考文档：https://docs.openluat.com/osapi/core/mqtt/、https://docs.openluat.com/osapi/core/socket/

70. Air780E/780EPM的看门狗如何喂狗？

解答： 结论：看门狗用 wdt.feed() 在独立任务里周期喂；不要在业务里反复 pins.setup()，它会把已配置的引脚复用打回去，导致「GPIO 突然不好用」。说明：700/780/8000 这类平台的硬件看门狗超时约 28 秒，触发就是硬复位、不可关闭不可改时长；PSM+ 唤醒后的第一次窗口是 8 秒，之后恢复正常。IRTU 等框架已在启动时初始化引脚，业务层再 setup 会冲突。处理步骤：① 引脚只在初始化阶段配置；② 运行时用 gpio.set/gpio.get；③ 看门狗单独任务定时 wdt.feed()；④ 长阻塞逻辑拆片、中间让出 CPU；⑤ 反复复位时先确认是不是漏喂。参考文档：https://docs.openluat.com/osapi/core/wdt/、https://docs.openluat.com/common/watchdog/

71. Air780E/780EPM的TTS为何读错多音字？

解答： 尚未解答

72. Air780E/780EPM的TTS能否读英文单词？

解答： 尚未解答

73. Air780E/780EPM的AirLink与BLE冲突、需要销毁接口怎么办？

解答： 结论：已报 issue，需求是给 airlink 增加「销毁」或「暂停心跳帧」的接口，需要研发评估，不是短期能完成的改动；在此之前只能靠分时使用规避。说明：问题的本质是 airlink 的心跳帧会持续占用 UART3，BLE 在同一路串口收发时两套帧互相打断。缺一个显式的「停止」入口，就无法在运行时干净地切换。处理步骤：① 业务上把 BLE 与 airlink 串行化，不同时启用；② 切换前先让对端停止发送并等待串口空闲；③ 跟进 airlink 库版本更新；④ 有明确时序需求可把场景整理后发 FAE 提优先级。参考文档：https://docs.openluat.com/osapi/core/airlink/、https://docs.openluat.com/osapi/core/ble/

74. Air780E/780EPM的USB无法识别、工厂报未知USB设备怎么办？

解答： 结论：工厂端报「未知 USB 设备」，先查线、查电脑端口——4G 模组是免驱的（需装驱动的是 Air724/Air795/Air720/Air722），「未知设备」通常意味着 USB 物理层没协商成功，而不是缺驱动。说明：模组插上后应枚举出多个 CDC 端口。如果显示「未知 USB 设备（设备描述符请求失败）」，几乎都是线材只供电不传数据、线太长、或 USB 口供电不足导致枚举中断。另外要按 PWRKEY 开机并确认在 Luatools 里选的是 4G 模组 USB 打印通道。处理步骤：① 换短线、直连电脑不过 Hub；② 关掉电脑蓝牙；③ 设备管理器卸载「未知设备」后重新插拔；④ 按 powerkey 开机，Luatools 选 4G 模块 USB 打印；⑤ 换另一台电脑交叉验证。参考文档：https://docs.openluat.com/common/usb_drv/、https://docs.openluat.com/common/howtodown/

75. Air780E/780EPM的SIM卡预销号续费失败怎么办？

解答： 结论：预销号的卡没有对外接口能直接重置状态，需要把卡号发给对接人开权限；账户开通「允许预销号卡续费」后才能提交续费。说明：预销号是运营商侧状态，模组既改不了也读不到「能否续费」。续费成功后网络侧重生效有延迟，需要让模组重新附着网络才能恢复上网。处理步骤：① 把卡号发群里/对接人开权限；② 账户开通「允许预销号卡续费」；③ 提交续费；④ 重启模组或 AT+CFUN=0/AT+CFUN=1 重新附着；⑤ AT+CEREG?、AT+CGPADDR=1 确认已注网并拿到 IP。参考文档：无（属运营商/资费事项，请联系购卡渠道或对接销售确认）；技术侧可参考 https://docs.openluat.com/osapi/core/mobile/

76. Air780E/780EPM的OTA升级到不存在版本、平台称设备自己发起OTA怎么办？

解答： 结论：让平台先提供「设备请求 default0.0.0 包的时间」与「包所在位置」作为证据；模块侧对升级包有型号与版本校验，格式不对不会真正升级，也不会自己去请求一个不存在的版本。说明：正常流程是平台下发 upgrade 通知 → 设备按通知里的 URL 拉包 → 校验 → 写 flash。如果平台说「是设备自己发起的」，那要么是通知里的版本字段被填成了 default，要么是设备端脚本里写了固定的版本号。两种情况都能从日志与包内容对上。处理步骤：① 让平台导出该设备的升级记录与包地址；② 核对包内型号/版本字段；③ 检查设备端脚本里的 OTA 逻辑是否有硬编码版本；④ 用 Luatools 重新生成合法差分包再下发；⑤ 全程抓日志。参考文档：https://docs.openluat.com/air780epm/luatos/app/iotcloud/aliiot/

77. Air780E/780EPM的U盘授权是否收费？

解答： 结论：免费。4028 版本以后的 LuatOS 固件默认已带 U 盘（USB MSC）功能，不需要付费、不需要单独定制。说明：U 盘授权本质是固件内置能力，不是联网校验的授权项；用很早以前的老固件才可能需要单独确认。现在主推的 Air780E/780EPM 固件都远在 4028 之后。处理步骤：① 用现役固件；② USB 接电脑看是否枚举出盘符；③ 不识别先换数据线与 USB 口；④ 老固件把型号与版本发 FAE 确认。参考文档：https://docs.openluat.com/osapi/core/fatfs/、https://docs.openluat.com/common/usb_drv/