常见问题 - 2026-09-16
数据日期：2026-09-16
1. Air1103是什么芯片/模组？离线语音唤醒支持几个唤醒词？能否自定义？
解答： 结论：Air1103 是合宙收购的华镇 7014F 芯片，合宙内部型号定为 Air1103；其离线语音唤醒能力当前固件支持约 14~20 个指令词/唤醒词，暂不支持自定义配置。
说明：Air1103 是一颗语音处理芯片，除了离线语音识别与唤醒，也可以用于 SIP 回声消除（AEC），该用法可单独购买芯片，合宙可提供参考设计。当前版本固件内置的唤醒词/指令词数量固定在约 14~20 个，属于出厂固化词表，不开放用户自行训练或导入自定义词条，因此词表以外的唤醒语无法直接使用。
使用建议：① 选型阶段先对照官方给出的词表，确认你的应用场景所需唤醒语是否在支持范围内；② 若必须使用自定义唤醒词，应提前与合宙商务/技术支持沟通，确认是否有定制方案或替代型号；③ 用于 SIP 回声消除时，按官方参考设计做硬件连接与音频调试。
参考文档：https://docs.openluat.com/
2. Air8784是什么？是AIR780EHM+Air1103吗？有购买链接吗？
解答： 结论：Air8784 是「SIP 零回声通话 + 离线语音唤醒」方案，硬件结构为 Air780EHM + Air1103，计划下周上架，目前暂无购买链接，资料后续发布。
说明：该方案把 4G 通信能力（Air780EHM）与语音处理能力（Air1103）组合在一起，一方面由 Air1103 承担回声消除/语音处理，使通话达到零回声效果，另一方面提供离线语音唤醒能力，适合对通话质量与语音交互都有要求的整机产品。由于产品尚在发布流程中，规格、原理图、固件与 demo 会在上架后陆续发布。
获取方式：① 关注合宙官方淘宝店 https://luat.taobao.com/ 的上架信息，店内搜索「Air8784」即可；② 通过官方企业微信群或销售咨询上架时间、样品与批量供货；③ 上架后到 https://docs.openluat.com/ 对应产品页下载最新资料。
参考文档：https://docs.openluat.com/
3. Air780E系列引脚定义是否一致？Air780E是否停产了？
解答： 结论：Air780E 系列的引脚定义基本一致，但个别型号之间存在差异，最终必须以各型号自己的规格书/硬件设计手册为准；官网找不到某个 780E 型号并不代表该系列全部停产，780E 已不再主推，新项目建议直接选用 Air780EPM、Air780EHM 等较新型号。
说明：同一系列模组通常保持封装与大部分引脚兼容，便于平滑替换，但不同型号在外设复用、音频通道、SPI/USB 资源与天线脚分配上仍可能有差别，直接照抄旧型号原理图存在风险。
处理方式：① 在 https://docs.openluat.com/ 打开目标型号的产品页，下载该型号的硬件设计手册与管脚定义表，逐脚核对；② 做兼容设计时，把可能变化的引脚预留跳线或 0 欧电阻，便于后续调整；③ 页面找不到某型号时，先向销售或官方企业微信群确认是否已停产、有无替代型号，不要在没有确认的情况下继续投板。
参考文档：https://docs.openluat.com/
4. Air780EHV是否支持AT指令？
解答： 结论：Air780EHV 支持 AT 指令。
说明：AT 指令是模组通用的一种控制方式，主控通过串口发送 AT 命令即可完成驻网、拨号、通话、短信等基本控制。使用 AT 方式时，模组需烧录与该型号匹配的 AT 固件；LuatOS 二次开发固件下并不提供完整的 AT 指令集，两者不能混用。
使用要点：① 确认手上模组烧录的是 Air780EHV 对应的 AT 固件，不要与同封装其他型号的固件混刷；② 具体支持的指令、参数与返回码，以该型号的 AT 指令手册为准，移植代码前逐条核对；③ 若模组原本用于 LuatOS 二次开发，请勿直接当 AT 型号使用，必要时先向官方确认固件归属与版本。
参考文档：https://docs.openluat.com/
5. SIP测试账号如何申请？账号规则是什么？
解答： 结论：SIP 测试账号现已改为绑定 IMEI 申请，一个 IMEI 可申请两个测试账号——一个用于设备端登录，另一个用于第二台设备或软终端登录；旧的 12345671 / 12345670 账号已作废，不能再使用。
说明：一设备一账号不利于双端联调，因此新规则按 IMEI 发放两个账号，方便「设备 ↔ 设备」或「设备 ↔ 软终端（电脑/手机 SIP 客户端）」互拨验证。由于账号与 IMEI 绑定，更换模组后需要重新申请，旧账号不能继续复用。
申请步骤：① 记录所用模组的完整 15 位 IMEI；② 通过官方企业微信群或销售提交 IMEI 与用途，申请 SIP 测试账号；③ 在设备端 SIP 库与软终端上分别填入对应的两个账号；④ 首次注册后确认在线状态，再开始互拨测试。
参考文档：https://docs.openluat.com/
6. SIP+4G桥接打电话是否走运营商电话/需要手机卡？
解答： 结论：SIP 通话走的是数据流量，不是运营商语音电话；如果业务要求「SIP 打给普通手机」，则必须插入可打电话的手机卡（不能用物联网卡），SIP+4G 场景要按手机卡方案准备。
说明：SIP 属于 IP 语音（VoIP），语音包通过数据网络传输，因此链路必须能上网。若只是设备之间互拨，只要数据链路可用即可；若需要呼出到公网手机号，链路中必须有运营商语音通道，而物联网卡通常不具备语音能力，所以需换成手机 SIM 卡。
落地要点：① 先明确业务是「设备↔设备」还是「设备↔手机」，前者可用纯流量卡，后者需手机卡；② 确认卡片已开通语音、未欠费且有足够话费；③ 用一组可用账号先做设备↔软终端互拨验证，再验证呼出到手机号；④ 注意手机卡的 APN 与实名要求。
参考文档：https://docs.openluat.com/
7. SIP通话回音/回声消除问题如何解决？
解答： 结论：合宙 LuatOS 已在软件侧解决 SIP 通话的 AEC 回声抑制问题，实测效果较好；在结构上，喇叭与 Mic 至少要有一个被「包住」，回声才能进一步压到最好。
说明：回声（回音）通常是扬声器的声音被麦克风再次拾取并送回对端造成的。软件 AEC 只能处理一部分线性回声，若声学隔离太差（Mic 近距离直接拾取喇叭直达声），仅靠算法很难彻底消除，因此结构隔离与软件算法同样重要。
优化步骤：① 结构上做隔离——把喇叭包住（独立音腔），或者不包喇叭就包 Mic，二者至少满足一个；② 使用与该 core 固件匹配的音频库，避免库与固件版本不匹配；③ 调整喇叭音量与 Mic 增益，避免增益过大把回声一并放大；④ 若仍不满意，录制实际通话音频并提供硬件/结构信息，通过官方企业微信群提交分析。
参考文档：https://docs.openluat.com/
8. Air8601/Air8602是否支持录音/SIP语音？
解答： 结论：Air8601 / Air8602 不支持录音，只能播放音频；若要做 SIP 录音或 SIP 通话类项目，建议改用 Air1602 开发板或 Air780EHV 等支持录音的型号。
说明：录音能力取决于硬件是否具备音频采集通道（麦克风通路/PCM）以及固件是否提供对应音频库，整机方案并不一定都包含录音通路。8601/8602 作为大屏一体机方案，音频通路设计以播放为主，因此无法采集本地麦克风数据。
选型建议：① 先确认项目是否需要录音（本地录音、语音留言、通话录音或语音识别），有需求则直接选择支持录音的型号；② SIP 录音/通话评估可使用 Air1602 开发板或 Air780EHV；③ 按 https://docs.openluat.com/ 对应产品页的规格书核对音频通道与支持的音频库，再确定硬件方案。
参考文档：https://docs.openluat.com/
9. Air8601上的6205蓝牙功能是否测试过？
解答： 结论：Air8601 板载 6205 的蓝牙功能当时只测了硬件连接（可以当 Wi-Fi 网卡使用），并未实测蓝牙，需要补测；该测试已安排补做 6205 的蓝牙验证。
说明：硬件「能识别、能当 Wi-Fi 网卡」只能说明供电、接口、时钟等基础链路正常，并不等于蓝牙射频与协议栈可用——蓝牙涉及独立的射频通路、天线匹配与固件驱动，必须单独验证才能下结论。
后续安排：① 补做 6205 蓝牙的扫描、连接与数据传输测试；② 若整机方案需要同时使用 4G 与 Wi-Fi/蓝牙，请注意本文件第 10 条的资源互斥问题；③ 蓝牙测试结论以合宙官方发布说明为准，作为选型与量产依据；④ 若在自研板上复现异常，提供板卡照片与测试日志便于定位。
参考文档：https://docs.openluat.com/
10. 8601的4G和WiFi/蓝牙能否同时使用？
解答： 结论：现有 Air8601 方案中 4G 与 Wi-Fi（蓝牙）无法同时使用，二者通过一个电阻选择分开，用 4G 就不能用 Wi-Fi（蓝牙），反之亦然。
说明：这是硬件设计上的二选一取舍——4G 与 Wi-Fi/蓝牙共用部分射频/天线资源，通过电阻跳接切换通路，因此不存在软件层面「同时开启」的办法。整机设计时必须先确定这台设备以 4G 为主还是以 Wi-Fi 为主。
设计要点：① 依据产品形态决定主用链路，户外/移动场景以 4G 为主，室内固定部署可考虑 Wi-Fi；② 原理图上明确该选择电阻的位置与默认贴装方向，并写入生产装配说明，避免批量生产时贴错；③ 若项目必须「4G + Wi-Fi 同时使用」，应改用其他型号方案，或通过官方企业微信群与合宙确认可行做法。
参考文档：https://docs.openluat.com/
11. 780EPM的鉴权字段只能填3或0吗？1、2是什么？
解答： 结论：1 和 2 已废弃，正常只填 0 或 3；其中 1 表示单 PAP，2 表示单 CHAP。如果确定所用运营商不会更改鉴权方式，可以先填 1 试试，但推荐直接使用 3。
说明：PAP 与 CHAP 是 PPP 拨号的两种鉴权方式，CHAP 更安全但并非所有网络都支持。固件在 3（自动）模式下会按「先尝试一种、失败再尝试另一种」的顺序协商，因此对运营商侧调整的兼容性最好，不容易出现换卡、换地区后必须人工改参数的情况。
使用要点：① 新项目直接填 3，让模组自动协商；② 若确知运营商只用 PAP，可填 1 减少协商时间，但换卡或换地区时需要重新确认；③ 0 表示不做鉴权，仅适用于无鉴权要求的专网/测试环境；④ 填 1、2 后出现拨号失败时，先改回 3 复测再做判断。
参考文档：https://docs.openluat.com/
12. LUATOOLS有没有纯下载版（不显示调试信息）？
解答： 结论：官方没有单独发布「纯下载版」的 Luatools，但可以用 luatos-cli 自己做一个，实现只做下载、不显示调试信息的效果。
说明：Luatools 是图形化调试工具，默认会打开串口日志窗口，适合开发调试，但不适合产线或交付给客户使用。luatos-cli 是官方提供的命令行工具，可完成固件与脚本下载等动作，便于封装成脚本或小工具，做到「只下载、不看日志」。
实现步骤：① 从官方资料渠道获取 luatos-cli 并阅读其参数说明；② 按目标型号准备 core 固件与脚本目录，用命令行参数指定后执行下载；③ 把命令封装成 bat/脚本或简单的外壳程序，交付产线或客户使用；④ 先用一台设备验证下载结果与版本号，确认无误后再批量使用。
参考文档：https://docs.openluat.com/
13. 780EPM使用iRTU批量生产时如何简化烧录和参数配置？
解答： 结论：Air780EPM 使用 iRTU 批量生产时，先统一烧录 iRTU 固件，再通过 iRTU 网页统一配置参数即可；设备上电后会自动下载配置，获取到信息后自动重启生效，无需逐台配置。
说明：iRTU 的参数存放在平台上、按设备（IMEI）下发，设备联网后主动拉取，因此「一次网页配置 → 多台设备自动同步」可以显著简化产线流程，避免逐台接线改参数，也能减少人为配置错误。
实施步骤：① 产线只做一件事——烧录对应型号的 iRTU 固件；② 在 iRTU 后台把设备归属到账号，按批次配置串口、GPIO、上报地址等公共参数；③ 设备上电联网后自动下载配置并重启生效；④ 批量前先用 1~2 台设备验证配置项是否全部正确下发；⑤ 个别设备参数不同的，再在后台单独调整该 IMEI。
参考文档：https://docs.openluat.com/value/irtu/state/
14. 差分工具为什么用不了？
解答： 结论：差分工具用不了，最常见的原因是选到了量产包；改用 3.0.0 版本的差分工具再试。
说明：量产包与差分升级包的结构与校验方式不同，若在差分工具里加载了量产包，工具通常无法正确解析，表现为报错或直接不可用。因此应先确认手上的包类型，再确认工具版本。
处理步骤：① 确认所用固件包确实为差分升级包，而不是量产包；② 把差分工具切换到 3.0.0 版本重新操作；③ 检查升级前后版本号是否满足「只能向上差分」的要求，以及新旧固件是否为同一型号、同一后缀；④ 若仍失败，记录工具版本、固件包名称与完整报错，通过官方企业微信群反馈。
参考文档：https://docs.openluat.com/
15. 780EPM是否支持AirUI/AIRUI？
解答： 结论：Air780EPM 支持 AirUI。
说明：AirUI 是 LuatOS 的图形界面方案，能否使用取决于模组是否具备显示驱动能力以及所用固件是否包含对应库。Air780EPM 属于支持该能力的型号，在配套固件与显示硬件（屏幕、驱动、接线）就绪后即可用 AirUI 开发界面。
使用要点：① 使用最新正式 core 固件与配套的 AirUI/lcd 相关库，避免库与固件版本不匹配；② 按所用屏幕的分辨率、接口（SPI/RGB 等）与驱动 IC 选择正确的初始化参数；③ 先用官方 UI demo 在开发板上跑通，再接入自己的业务逻辑；④ 注意显示外设与其他外设的引脚复用关系，避免冲突。
参考文档：https://docs.openluat.com/osapi/
16. Air780EPM是否有插针式封装（排针）的模组？
解答： 结论：Air780EPM 有插针（排针）封装形式的可选型号，推荐选用 Air8781P 或 Air8782P，资料见 docs.openluat.com 对应产品页面。
说明：Air8781P / Air8782P 属于带排针/连接器形式的工业模组，便于直接插接底板或做快速验证，接口形态与贴片模组不同；具体针脚定义、供电要求与外围设计仍需按各自型号的硬件设计手册执行。
操作步骤：① 在 https://docs.openluat.com/ 打开 Air8781P / Air8782P 产品页，下载硬件设计手册与管脚表；② 按手册确认排针定义、VBAT 供电能力（持续与瞬态电流）、USB/BOOT 下载脚是否引出；③ 用核心板/开发板先验证功能，确认无误后再进入自研底板设计；④ 投板前可将原理图、PCB 提交合宙免费评审。
参考文档：https://docs.openluat.com/
17. 合宙是否有NB-IoT模组？
解答： 结论：合宙目前没有 NB-IoT 模组，也不建议新项目再使用 NB 模组，国内 NB 网络的覆盖越来越差。
说明：合宙的产品线聚焦 Cat.1、Cat.4 等蜂窝物联网制式。NB-IoT 虽然具备低功耗、广覆盖的特点，但国内运营商在 NB 上的网络投入与维护力度持续下降，实务中出现覆盖变差、部分地区退网、运维困难等问题，因此官方不建议在新项目上继续选型。
替代建议：① 需要低功耗定位/周期上报，优先考虑 Cat.1 超低功耗方案（如 Air8201/Air8202 一类）；② 需要更大带宽或语音能力，选择对应的 Cat.1/Cat.4 型号；③ 选型前在 https://docs.openluat.com/SelectionGuide/SelectionGuide/ 按开发方式、频段、功耗、外设需求确认型号，并向销售确认供货状态。
参考文档：https://docs.openluat.com/SelectionGuide/SelectionGuide/
18. Air780EHU是否支持南美？
解答： 结论：Air780EHU 不支持南美；Air780EHN 是北美版本，Air780EHU 是欧亚版本，选型时必须按最终销售地区对应。
说明：不同版本的核心差异在射频频段与认证，频段由硬件决定，不能通过刷其他地区固件改变。若产品要销往南美，EHU（欧亚版）与 EHN（北美版）都无法直接覆盖当地需求。
处理步骤：① 先确认目标国家/地区与当地运营商在网频段；② 到 https://docs.openluat.com/air780ehnehu/product/air780ehnfreq/ 核对各版本的频段清单；③ 用目标地区本地 SIM 卡做驻网、数据/通话、弱网与长时间在线场测；④ 向销售确认该地区的认证与准入要求，必要时改选其他型号。
参考文档：https://docs.openluat.com/air780ehnehu/product/air780ehnfreq/
19. 合宙有测试白卡出售吗？Air780E能否读白卡信息（基站信息、插卡测试、信号强度）？
解答： 结论：合宙没有测试白卡出售；Air780E 能否读取白卡信息（基站信息、插卡测试、信号强度等）目前暂不清楚，需进一步确认。
说明：测试白卡一般由运营商或测试设备厂商提供，用于在无真实用户卡的情况下完成驻网、信号强度等验证，合宙不销售该类卡片。至于特定模组能否读取白卡信息，取决于模组固件与卡侧实现，属于需要实测才能确认的能力。
处理建议：① 若产线需要做插卡/信号测试，先明确测试目的——是只测信号强度还是需要完整驻网，再选择对应的测试固件或测试手段；② 需要白卡渠道时，可由销售协助向运营商或测试仪器厂商咨询；③ 关于 Air780E 读白卡的具体能力，建议提供测试场景与需求，通过官方企业微信群确认后再投入开发。
参考文档：https://docs.openluat.com/
20. Air510W/Air530W GPS模块如何接入？
解答： 结论：Air510W / Air530W 是外挂式 GPS 模块，通过串口与主控连接；但在当前的 Air8601 方案上并没有多余串口可用，直接接入存在困难。
说明：外挂 GNSS 模块需要一路 UART 接收 NMEA 数据，另外还需要供电，部分型号还需电源使能控制。Air8601 整机方案的串口资源已被其他功能占用，因此「能不能接」的关键不是模块本身，而是主控还有没有空闲串口。
解决思路：① 先梳理 Air8601 上现有外设占用的串口清单，确认是否真的没有可用 UART；② 参考本文件第 36 条，若业务中不使用人脸识别，可腾出一路串口用于接 GPS；③ 若串口确实不够，可在方案层面考虑串口扩展或改用其他具备定位能力的整机/模组方案；④ 具体接线、供电与天线布置以对应产品硬件手册为准。
参考文档：https://docs.openluat.com/
21. 合宙有无带内置AT服务的WiFi模组？
解答： 结论：合宙目前没有带内置 AT 服务的独立 Wi-Fi 模组；如需 Wi-Fi 方案可选用 Air8101，但它需要自行二次开发/烧录固件，之后可通过串口 AT 指令进行控制。
说明：Air8101 是可二次开发的 Wi-Fi/联网 SoC 方案，出厂并非「AT 服务模组」形态，需要开发者烧录固件、编写业务逻辑。若希望以 AT 方式使用，需要在固件中自行实现 AT 服务，或按既有方案对接。
使用步骤：① 明确所需的 Wi-Fi 形态（Station/AP、是否需要以太网、是否需要摄像头等）；② 到 https://docs.openluat.com/ 的 Air8101 产品页获取固件、demo 与硬件资料；③ 用开发板先跑通联网 demo，再按业务编写串口 AT 或私有协议；④ 若只需要「串口 AT 联网」的成品模组形态，建议先向官方确认是否有更合适的型号。
参考文档：https://docs.openluat.com/
22. Air8101的SPI能否接SPI摄像头？Air8101+USB摄像头支持扫码吗？
解答： 结论：Air8101 的 SPI 不能接 SPI 摄像头；Air8101 + USB 摄像头的扫码方案目前还没有做，但技术上是可以做的。
说明：Air8101 的摄像头接入走 USB（UVC）或 DVP 接口，SPI 通道不支持摄像头数据。扫码功能依赖摄像头采集图像加解码处理，属于应用层实现，官方当前没有现成的扫码 demo。
实现思路：① 用 Air8101 支持的摄像头接口（USB UVC 或 DVP）接入摄像头，先用官方摄像头 demo 确认能正常出图；② 在应用层加入二维码/条码解码逻辑，也可结合联网能力把图像上传到服务端解码；③ 评估实时性与算力是否满足业务要求（帧率、分辨率、解码耗时）；④ 若项目临近量产，建议通过官方企业微信群确认是否需要官方定制支持。
参考文档：https://docs.openluat.com/
23. 同一声明固件为何烧到不同8101上MAC不一样？106固件只能烧到8101B吗？
解答： 结论：106 固件只有 Air8101B 才能使用，烧到其他版本上会出现异常；同一声明固件烧到不同板子上 MAC 不一样即与此相关。合宙已提 issue 给 LuaTools 增加烧录识别，限制 106 固件只能烧录到 8101B 上。
说明：同一固件声明下若硬件版本不同，内部参数（例如 MAC、射频校准数据）的来源不同，因此会出现「看着是同一个固件，烧到不同板子上 MAC 却不一样」的现象。这属于固件与硬件版本不匹配，而不是固件本身随机变化。
处理步骤：① 先核对板子丝印，确认是 Air8101B 还是其他版本；② 106 固件只用于 Air8101B，其他版本请使用与之匹配的固件；③ 把 Luatools 更新到带烧录识别的新版本，遇到不匹配时工具会直接拦截，避免误烧；④ 若已误烧，按对应型号重新烧录正确固件即可恢复。
参考文档：https://docs.openluat.com/
24. Air780EGG开发板和CH390通讯失败是什么原因？
解答： 结论：Air780EGG 开发板与 CH390 通信失败，建议先单独给 VBAT 接稳压电源测试，判断是否为供电或电源环路问题；同时把完整日志和 demo 发给合宙技术确认。另外，CH390 的晶振应为 25MHz。
说明：以太网收发器 CH390 对供电质量与时钟较为敏感。若开发板由 USB 或电流能力不足的电源供电，4G 发射瞬间的电流冲击可能拉低 VBAT，导致网卡复位或通信异常；晶振频率若贴错（应为 25MHz），也会直接导致无法通信。
排查步骤：① 单独用可调稳压电源给 VBAT 供电（3.3~4.35V，典型 3.8V，电流能力留足），复测 CH390 通信；② 用示波器确认 VBAT 在 4G 发射期间是否有明显跌落；③ 核对 CH390 晶振是否为 25MHz，检查焊接、匹配电容与走线；④ 保留完整串口日志、最小复现 demo 与硬件版本信息，通过官方企业微信群提交技术分析。
参考文档：https://docs.openluat.com/
25. Air153C在低功耗时怎么关闭（AI回复无法关闭）？
解答： 结论：理论上不需要额外做「关闭」动作，只需正常喂狗即可；请使用 LuatOS 仓库中最新的 lib，库内部已经做好了低功耗处理，内部喂狗也已一并处理。
说明：看门狗与低功耗的冲突在于——进入低功耗后主程序不再频繁运行，若喂狗逻辑完全放在应用层，就可能因为停止喂狗而被复位。因此这类外设/库的低功耗适配应由库内部完成，应用层只需保留按周期的喂狗调用。
使用要点：① 从 LuatOS 仓库拉取最新的 lib，不要混用旧版本库文件，确保包含低功耗处理逻辑；② 应用层按官方示例的周期调用喂狗接口，不要在任务里自行「关闭」看门狗；③ 用 Air9000P 等功耗分析仪实测休眠电流，确认已进入低功耗状态；④ 若使用最新 lib 后仍异常，提供型号、固件版本与最小脚本反馈官方。
参考文档：https://docs.openluat.com/osapi/
26. 新音频框架相比旧框架对一些非标MP3兼容性差，能否加参数忽略非标检查？
解答： 结论：新音频框架对非标音频的过滤比旧框架更严格，因此出现「旧框架能放、新框架放不了」的情况；目前已建议把该问题作为 issue 提交处理，也可以多提供几个实际 mp3 文件给合宙测试定位。
说明：非标 MP3 通常指采样率、帧结构、比特率或标签不符合标准规范的音频文件。新框架为兼容性与稳定性收紧了校验，遇到不合规数据会直接拒绝播放，这属于框架行为差异，并非文件被损坏。
处理方式：① 把手头同类的非标文件整理出来并标注来源，样本多一些便于定位共性；② 把「音频文件 + 复现脚本 + 固件版本」一并提交，作为 issue 反馈；③ 项目有交付压力时，可先用工具把音频转成标准 MP3/PCM 再播放作为临时方案；④ 关注 issue 处理结论，确认后续版本是否会增加兼容参数。
参考文档：https://docs.openluat.com/osapi/core/audio/
27. Air8000W喇叭有杂音怎么办？
解答： 结论：Air8000W 按理说不应出现喇叭杂音，建议先录制一段实际效果音频给技术分析；分析时需要提供喇叭规格（例如 8 欧 2W）。
说明：音频杂音可能来自喇叭本身、功放供电、音腔结构、走线干扰或音频文件与增益设置。仅凭文字描述无法判断，因此需要可复现的音频证据与硬件信息。
操作步骤：① 用手机或录音设备录下杂音现象，尽量包含静音段与播放段；② 记录喇叭的阻抗与功率规格（如 8Ω/2W）、是否外接 PA、音腔结构；③ 说明复现条件——固件版本、播放的音频文件、音量设置；④ 用官方音频 demo 在同一块板子上复测，判断是否与业务代码相关；⑤ 把音频、硬件信息与日志提交官方企业微信群分析。
参考文档：https://docs.openluat.com/osapi/core/audio/
28. luat_mobile_rf_test_mode/luat_mobile_rf_test_input在新SDK中丢失怎么办？
解答： 结论：先用新版本编译；luat_mobile_rf_test_mode / luat_mobile_rf_test_input 这两个接口会想办法补上。新 SDK 与移芯保持一致，只是去掉了简易 RF 代码。
说明：新 SDK 的基线来自移芯，接口集合与官方保持一致，变化点是移除了简易的 RF 测试相关代码，因此从旧工程直接移植时会提示找不到这两个接口符号。
处理步骤：① 先用新版 SDK 建立编译环境，把工程在新 SDK 下完整编译一遍，确认其余功能正常；② 不要自行把旧版 RF 代码复制进工程「补齐」，避免与移芯基线冲突；③ 通过官方渠道提交「需要 luat_mobile_rf_test_mode / luat_mobile_rf_test_input」的需求，等待补齐后再做射频测试相关开发；④ 若近期就必须做 RF 测试，可与官方确认可用的替代测试方案。
参考文档：https://docs.openluat.com/
29. Lua什么时候可以实现PLC协议读写？工业引擎能否替代工业HMI和网关？
解答： 尚未解答
30. Air5101S单独做蓝牙信标时SleepMode断电后无法保存（变回0）怎么解决？量产该怎么做？
解答： 结论：Air5101S 的 LP1 与 LP3 在断电后都不会保存配置，掉电后都需要重新发指令进入（此前「LP1 会保存」的说法以本次最新说明为准）；未断电时，LP1 唤醒后约 80ms 会重新进入 LP1，LP3 唤醒后则立即退出进入 LP0。另外 Air5101 是 AT 透传模组，一般需要主控外挂使用。
说明：LP1/LP3 属于低功耗工作状态，配置保存在易失状态中，一旦断电即复位回默认 SleepMode（0），因此量产设备每次上电都要由主控重新下发指令进入目标模式。
量产做法：① 在主控上电流程中固定加入「发送 AT 指令进入 LP1 或 LP3」的步骤，并校验返回值；② 区分唤醒路径——使用 LP1 时注意唤醒后约 80ms 的窗口，避免在该窗口内发起会造成状态冲突的操作；使用 LP3 时唤醒后立即进入 LP0，需要重新进入 LP1/LP3；③ 把「掉电/复位后重发指令」写入产线与测试用例，避免误以为配置会保留；④ 具体指令与参数以 Air5101S 的 AT 指令手册为准。
参考文档：https://docs.openluat.com/
31. Air8000U是否有现货？
解答： 结论：Air8000U 目前有 10 片现货可供。
说明：现货数量有限，通常用于样品验证、小批量试产或紧急测试；如果需要持续供货数量，需要另行与销售确认排产与交期。
办理步骤：① 通过销售或官方企业微信群说明所需数量与用途，确认 10 片现货是否仍可分配；② 提供收件信息以便安排发货（可参考本文件第 52 条的发货处理方式）；③ 用现货完成 SIP、频段等功能验证后，若确认量产，尽早提交后续批量需求以免影响排期；④ 收到货后先核对型号与数量，再用目标地区 SIM 卡实测。
参考文档：https://docs.openluat.com/
32. Air780ER是否有货？价格多少？
解答： 结论：Air780ER 目前有 10 片现货，批量价为 22 元/片（含税）。
说明：以上为小批量现货的报价口径；批量采购的实际价格通常随数量、税率与市场行情浮动，正式下单前应再次确认。
办理步骤：① 通过官方淘宝店 https://luat.taobao.com/ 或销售/官方企业微信群确认当前现货数量与 22 元/片（含税）报价是否仍然有效；② 明确所需数量、是否需要开发板/核心板配套、是否需要技术支持；③ 数量较大时提交正式询价，以当时确认的报价与合同条款为准；④ 到货后先在开发板上验证驻网与业务功能，再进入量产。
参考文档：https://docs.openluat.com/
33. 开启外音时有回音，2034固件正常但2048/2050固件录音+播放无声音怎么办？
解答： 尚未解答
34. 烧录系统教程在哪里？想找各型号烧录、写代码的视频资料。
解答： 结论：烧录与入门教程以 docs.openluat.com 的文档为主，目前没有统一的视频资料；官方已经注意到型号多、新手不易上手的问题。
说明：合宙型号较多，各型号的烧录方式、驱动要求与引脚大同小异但存在细节差异，因此入门最容易卡在「该看哪一篇」。目前的做法是按型号在文档站提供对应章节，先确认型号再看文档是最快的路径。
入门步骤：① 打开 https://docs.openluat.com/ ，找到你手上型号的产品页；② 按「硬件环境清单 → 软件环境清单 → 烧录（下载）→ HelloWorld → 示例 demo」的顺序逐篇操作，不要跳步；③ 首次下载必须同时选择底层 core 固件与脚本，只烧脚本不会有反应；④ 通用工具与排查教程见 https://docs.openluat.com/common/Luatools/ 与 https://docs.openluat.com/common/howtodown/ 。
参考文档：https://docs.openluat.com/
35. Air780E作为透传使用的功耗怎么样？
解答： 尚未解答
36. GPS只能接串口还是485也可以用？
解答： 结论：GPS 一般接串口；在 Air8601 上 485 可以用于接锁控板，如果业务中不使用人脸识别，就可以腾出一路串口来外接 GPS。
说明：GNSS 模块通常通过 UART 输出 NMEA 数据，因此「接串口」是标准做法；RS485 是差分总线，主要面向锁控板等工业外设，不适合直接连接 GNSS 模块。Air8601 的串口资源有限，所以能否接 GPS 取决于能否释放出空闲串口。
实施步骤：① 梳理 Air8601 当前外设占用的串口，确认人脸识别等模块所占用的通道；② 若业务不需要人脸识别，按官方硬件资料将该路串口释放出来接 GNSS 模块；③ 注意 GNSS 模块的供电、电源使能脚与天线布置（天线尽可能朝向天空、远离干扰源）；④ 接好后先在室外开阔环境冷启动验证定位，再做整机联调。
参考文档：https://docs.openluat.com/
37. 8601屏幕只能用7寸吗？能否用9寸/10寸/8寸？
解答： 结论：Air8601 板子是 40pin 排线，只支持 7 寸屏；9 寸、10 寸是 50pin 排线，不能直接插。要使用 8 寸屏需要做适配，可付费由合宙适配（1 万元订金，后续出货满 1k 可抵扣货款），也可以由客户按官方提供的方法自行适配。
说明：能否直接使用一块屏，取决于排线针数、接口时序与驱动 IC 是否匹配。针数不同就不能直插；8 寸屏即便针数相符，也需要针对该屏的时序与驱动重新适配。
处理步骤：① 先在 https://docs.openluat.com/ 的 Air8601 产品页确认支持的屏幕规格与排线定义；② 明确目标屏的尺寸、分辨率、接口与驱动 IC；③ 若需要官方适配，通过销售或官方企业微信群提交需求，确认订金与后续抵扣方式；④ 若自行适配，按官方提供的适配方法修改显示参数与驱动，并在整机上完整验证。
参考文档：https://docs.openluat.com/
38. 用我们的屏适配要收费吗？单买模组是否也要支持屏幕适配？
解答： 结论：屏幕适配需要收取 1 万元订金，后续出货达到 1k 时可用该订金抵扣货款；也可以由合宙提供适配方法、客户自行适配。单买模组同样不包含免费适配，需要客户自行完成或付费委托适配。
说明：屏幕适配属于定制工作量，需要针对具体屏幕做时序、驱动与显示调试，因此不包含在模组或板卡的默认交付里，上述收费与抵扣规则是对这类定制工作的统一口径。
办理步骤：① 明确目标屏的型号、尺寸、接口与驱动 IC；② 通过销售或官方企业微信群确认适配报价、订金金额与「出货 1k 抵扣」的具体执行方式；③ 若选择自行适配，申领官方适配方法文档并按要求修改显示参数；④ 无论采用哪种方式，适配完成后都应在整机与目标固件版本下做完整回归测试。
参考文档：https://docs.openluat.com/
39. 780ehv 同时带AirUI和SIP audio_v2的版本吗？
解答： 结论：有 SPI 就有 audio_v2；是否同时带 AirUI 与 SIP audio_v2，需要按具体固件版本确认。已知 2034 固件可正常录音+播放，2048/2050 版本存在「录音+播放无声音」的问题。
说明：AirUI 属于显示/界面能力，audio_v2 属于音频框架能力，二者能否共存取决于该版本固件里打包了哪些库；同一型号不同版本的固件包含的库组合可能不同，因此必须以固件发布说明为准。
确认步骤：① 到 https://docs.openluat.com/ 该型号的「固件版本」页查看各版本的固件组成与更新说明；② 直接向官方确认是否存在同时包含 AirUI 与 SIP audio_v2 的版本；③ 因 2048/2050 版本存在录音+播放无声的现象（可参考本文件第 33 条），评估阶段优先用 2034 固件验证功能；④ 确定版本后，在整机上跑通「UI + SIP 通话 + 录音播放」的组合场景再量产。
参考文档：https://docs.openluat.com/
40. Air8000s/Air6205新版本固件发布了吗？
解答： 结论：Air8000s 与 Air6205 的新版本固件已发布正式版本，分别为 Air6205 v1030、Air8000s v30。
说明：正式版本意味着可用于产品开发与量产，相比测试版/预览版在稳定性上更有保障；换版本时应同时更新底层 core 与配套 lib，避免库与固件不匹配导致功能异常。
升级步骤：① 到 https://docs.openluat.com/ 对应产品页的「固件版本」栏目下载 Air6205 v1030 / Air8000s v30；② 用 Luatools 同时烧录底层 core 与业务脚本（首次必须一起烧）；③ 若工程使用了音频、网络、UI 等外设库，同步更新到与该固件匹配的版本；④ 升级后先跑最小 demo 与关键业务回归，确认无误再批量烧录。
参考文档：https://docs.openluat.com/
41. Air8101烧录不同固件MAC不一样是正常的吗？
解答： 结论：Air8101 烧录不同固件后 MAC 不一样，属于固件与硬件版本不匹配导致的现象；合宙已提 issue 给 LuaTools 增加烧录识别，106 固件只能烧录在 8101B 上。
说明：MAC 地址等出厂参数与硬件版本、固件配套关系相关，当固件版本与板子型号（如 8101B 与非 B 版本）不匹配时，读到的 MAC 等信息就会不同，因此不能只看「同一声明固件」就认为结果应该一致。
处理步骤：① 核对板子丝印，确认是否为 Air8101B；② 106 固件只用于 Air8101B，其他版本请烧录与其匹配的固件；③ 把 Luatools 升级到带烧录识别的新版本，遇到不匹配时工具会直接拦截；④ 若需确认 MAC 的生成规则本身，提供板子型号、固件版本与读到的 MAC，通过官方企业微信群确认。
参考文档：https://docs.openluat.com/
42. Air1601没有合成的固件文件下载地址吗？
解答： 尚未解答
43. 用780EPM模块时工厂长时间挂测偶发频繁离线怎么解决？
解答： 结论：Air780EPM 在工厂长时间挂测中偶发频繁离线，可以先采用「离线后进入飞行模式再退出重连」的方式缓解；同时建议使用最新 core 固件并持续挂测跟踪。
说明：长时间挂测下的偶发离线通常与网络侧（小区切换、寻呼、临时网络异常）或模组侧状态机有关，难以一次定位。飞行模式相当于让模组强制与网络断开并重新注册，可以清掉异常的协议栈状态，因此在重连策略中常被用来「复位」链路。
处理步骤：① 在掉线检测逻辑中加入「先进入飞行模式、再退出」的重连路径，替代单纯重发拨号；② 把 core 固件升级到最新正式版本，确认已包含相关修复；③ 重连失败时做退避重试，避免高频重连放大问题；④ 记录每次离线的时间、信号强度（CSQ/RSRP）与重连结果，持续挂测统计；⑤ 若在最新 core 下仍稳定复现，把日志与统计通过官方企业微信群提交分析。
参考文档：https://docs.openluat.com/
44. 780EHM同一SPI挂2颗CH390H的netdrv驱动实际可用吗？
解答： 尚未解答
45. Air8780G3工业模组是否支持锂电池充电？
解答： 结论：Air8780G3 支持锂电池充电；另外要注意 V3 是 PCB 版本号，不要与型号后缀混淆，后续合宙会对命名做改进。
说明：型号命名中出现 V3、G3 一类字符时，容易把「PCB 版本」误当成「功能版本」，从而在选型或查资料时找错对象。充电能力本身由板子的充电管理电路决定，与 PCB 版本号无关。
处理步骤：① 确认板子丝印上的完整型号与 PCB 版本号，明确自己指的是哪一个；② 到 https://docs.openluat.com/ 对应产品页核对充电电路与电池规格要求；③ 按电芯规格设置充电电压/电流（例如高压锂电满充 4.35V、普通 4.2V，以电芯规格书为准），不要长期满流充电；④ 命名容易混淆时，提问时附上板卡照片便于官方快速确认。
参考文档：https://docs.openluat.com/
46. Air8780模组从板子上如何确定型号/系列？资料在哪？
解答： 结论：合宙板卡上都有丝印，可以直接按丝印确定型号与所属系列；Air8780 相关资料见 https://docs.openluat.com/air8780/luatos/hardware/。
说明：丝印是区分型号/系列最直接、最可靠的依据——同系列的不同型号在外观上可能非常接近，但丝印会体现完整型号与版本信息，比靠外观或引脚数量猜测更准确。
操作步骤：① 在板卡上找到丝印（一般在正面或背面，格式为型号加批次/版本号）；② 按丝印中的型号到 https://docs.openluat.com/ 打开对应产品页；③ 若丝印模糊或缺字，拍照后通过官方企业微信群或销售确认；④ 确认型号后再下载对应的固件、硬件手册与 demo，避免用错资料。
参考文档：https://docs.openluat.com/air8780/luatos/hardware/
47. 如何知道Air700ECQ是否是无线核准固件？
解答： 结论：判断 Air700ECQ 是否为无线核准固件，可以发送 ATI 和 AT*I 两条指令，通过返回信息来确认。
说明：ATI 返回模组的基础信息（厂商、型号、版本等），AT*I 通常返回更详细的固件/编译信息，两者结合可以看出固件版本与相关标识，因此是判断固件类型的常用手段。
操作步骤：① 用串口工具或 AT 测试工具连接模组的 AT 口，确认串口参数正确；② 依次发送 ATI 与 AT*I，记录完整返回内容；③ 把返回信息与官方发布的该型号固件版本说明对照，确认是否为无线核准固件；④ 若返回内容无法判断，提供返回截图与模组丝印型号，通过官方企业微信群确认。
参考文档：https://docs.openluat.com/
48. Air1780P是否支持AirUI？Air1780开发板资料在哪？
解答： 结论：Air1780P 支持 AirUI；Air1780 系列 MCU 资料见 https://docs.openluat.com/air1780/product/ ，其开发板与 Air780EPM 共用，原理图见 https://docs.openluat.com/air780epm/product/shouce/ 。
说明：Air1780 属于 MCU 形态的产品，开发板与 Air780EPM 系列共用底板，因此硬件与界面相关的验证可以参考 780EPM 的资料，但固件与型号必须使用 Air1780 对应的版本，不能直接套用。
使用步骤：① 到 Air1780 产品页确认规格、固件与 demo；② 需要原理图时使用 780EPM 的手册页下载共用开发板原理图；③ 使用 AirUI 时确保固件与 AirUI/lcd 相关库版本匹配，并注意引脚复用；④ 先用官方 UI demo 跑通显示，再接入业务逻辑。
参考文档：https://docs.openluat.com/air1780/product/
49. Air780EHV 5-6口能否直接接喇叭？需要接什么？
解答： 结论：Air780EHV 的 5-6 口不能直接接喇叭，中间需要接功放（PA），例如 PAM8302。
说明：模组音频输出是小功率、非直接驱动扬声器的信号，要让喇叭发声必须经过功放放大；同时喇叭的阻抗与功率要和 PA 匹配，供电也要满足 PA 的电流需求，否则会出现声音小、失真或杂音。
操作步骤：① 按参考设计在音频输出与喇叭之间加入 PA（如 PAM8302）；② 选择与 PA 匹配的喇叭（阻抗、功率、音腔结构）；③ 注意 PA 的供电与滤波，走线远离射频与敏感信号，避免引入噪声；④ 焊接完成后先用官方音频 demo 播放测试音，确认音量、失真与底噪是否正常。
参考文档：https://docs.openluat.com/osapi/core/audio/
50. Air8202G的整机活动规则能否提供原理图和PCB图？
解答： 结论：Air8202G 整机活动规则相关的资料（含原理图、PCB）可在 https://docs.openluat.com/air8202/product/ 查询与下载。
说明：整机方案的资料通常按「产品页 → 硬件/整机资料」组织，原理图、PCB 等文件属于随产品发布的资料，直接在产品页对应栏目获取即可；不建议使用群内转发的来源不明文件包，以免版本不符或引入错误。
操作步骤：① 打开 https://docs.openluat.com/air8202/product/ ；② 在硬件/整机资料栏目中查找与该活动规则对应的版本（注意区分整机型号与 PCB 版本）；③ 若页面上没有找到所需文件，向销售或官方企业微信群说明具体型号与需求，获取对应版本资料；④ 拿到文件后与手上的板子版本核对，避免版本不符。
参考文档：https://docs.openluat.com/air8202/product/
51. Air724UG的AT命令手册在哪里？
解答： 结论：Air724UG 的 AT 命令手册等资料，可以通过 docs.openluat.com 查询，也可以直接问 ai.luatos.com 的 AI 问答机器人。
说明：AI 问答机器人已接入官方资料，适合快速定位「某个功能对应哪条 AT 指令、在哪篇文档里」，比手动翻手册更快；但具体指令的参数与返回码仍应以手册原文为准。
使用步骤：① 打开 https://ai.luatos.com/ ，用自然语言描述你要做的事（例如「Air724UG 如何查询信号强度」），获取对应指令与文档指引；② 也可以在 https://docs.openluat.com/ 按型号浏览 AT 指令手册；③ 把 AI 给出的指令在实机上验证一遍，确认与所用固件版本一致后再写入产品代码；④ 若问答结果与实际不符，回到手册核对并以手册为准。
参考文档：https://docs.openluat.com/
52. Air8000U邮寄地址/发货如何安排？
解答： 结论：该事项已处理完毕——收件信息已经提供，10 片 Air8000U 已安排发货。
说明：Air8000U 现货数量有限（目前为 10 片，可参考本文件第 31 条），发货需要先确认收件信息与数量，再统一安排物流。
后续步骤：① 收到设备后先核对型号与数量，检查外观与包装；② 按 Air8000U 对应的固件版本烧录，并用目标地区 SIM 卡做功能验证（如 SIP 通话、驻网）；③ 若验证后需要批量采购，尽早通过销售提交需求，避免影响排期；④ 开发过程中遇到问题，可通过官方企业微信群反馈。