常见问题 - 2026-09-15
数据日期：2026-09-15
1. Air700ETC 是什么型号？和 Air700E 有什么区别？
解答： 结论：合宙没有“Air700ETC”这个型号，提问里的写法应是“Air700ECT”；Air700E 是较早的老型号，Air700ECT 是较新的型号。
说明：两者型号名只差字母顺序，但对应的资料目录、固件列表是分开的，所以按错误型号去检索会找不到资料，选型前必须先确认丝印上的准确型号。
建议步骤：① 查看模组或核心板丝印上印的完整型号，特别注意 E/C/T 的排列顺序；② 到 https://docs.openluat.com/ 用准确型号进入对应产品页，分别下载两份规格书/数据手册；③ 逐项对比封装尺寸、可用 IO 数量、是否支持 AT 指令、支持的频段与供电要求；④ 仍有疑问时把模组丝印照片发到合宙官方企业微信群，由技术支持确认。
参考文档：产品资料总入口 https://docs.openluat.com/ 。
2. 有没有比 Air700E 更具性价比、支持 AT 指令的小封装模组？
解答： 结论：推荐 Air700ECT——小封装、支持 AT 指令、价格更低，是 Air700E 之后更具性价比的选择。
说明：Air700E 属于较早的型号，Air700ECT 是合宙后续推出的同定位产品，在保持小封装（适合空间受限的终端）和 AT 指令开发方式不变的前提下，价格更有优势。对已经用 AT 指令开发的产品，切换过去通常不需要改变上位机的指令流程。
落地建议：① 到 https://docs.openluat.com/ 打开 Air700ECT 产品页，核对封装、管脚定义、支持的频段与 AT 指令集，与 Air700E 逐项对比；② 在 Luatools 的固件列表中确认该型号可下载的正式固件；③ 用核心板/开发板做一轮实机验证，确认供电、SIM、天线等外围电路与老型号兼容；④ 批量价格与交期请通过官方淘宝店 https://luat.taobao.com/ 或官方企业微信群咨询，以官方回复为准。
参考文档：https://docs.openluat.com/ 。
3. 能不能根据流量上传数据地来定位？
解答： 尚未解答
4. 合宙有没有可以直接插上去即用的模组/开发板？
解答： 结论：合宙有可“拿到就用”的核心板、开发板以及免开发整机方案，具体选哪一个需要先明确用途，可以用官方 AI 问答机器人快速筛查。
说明：核心板和开发板已引出常用管脚、做好供电与下载电路，适合直接做功能验证；面向整机场景还有上电即可工作的方案。“直接插上即用”对应的产品形态差别很大（看定位、透传数据、接大屏等等），因此没有单一答案。
建议步骤：① 到 https://docs.openluat.com/ 或 https://ai.luatos.com/ 使用 AI 问答机器人，直接描述用途（例如“插上就能看定位”“串口透传数据”），获取对应产品推荐；② 在产品页核对接口、供电、是否需要自行开发等信息；③ 无法确定时把需求发给合宙技术支持或官方企业微信群，由 FAE 给出选型建议。
参考文档：https://docs.openluat.com/ 。
5. AI 问答机器人登录不了/登不上怎么办？
解答： 结论：先重试并确认账号状态，多数情况重新登录或先注册账号即可恢复；若仍登录不上，把报错截图反馈给合宙。
说明：AI 问答机器人（ai.luatos.com 等入口）的登录依赖账号状态与网络连通性，常见的临时故障包括服务端波动、浏览器缓存或会话过期、企业网络/代理拦截、账号尚未注册或未激活。
排查步骤：① 刷新页面后重试，必要时清除浏览器缓存，或换 Chrome/Edge 的无痕窗口再试；② 切换网络环境验证（例如改用手机热点），排除公司防火墙或代理拦截；③ 确认使用的是已注册账号，未注册的先完成注册再登录；④ 多种网络、多次尝试均失败时，截图完整报错页面（含时间与网址），通过官方企业微信群反馈给合宙排查。
参考文档：https://ai.luatos.com/ 。
6. Air780EPM 进入烧写模式后无法识别 USB（未知设备）是什么问题？
解答： 结论：优先排查 USB 线材与外围负载——换短线、换数据线并减少外接外设后多数可恢复；同时合宙硬件侧已在对相关烧录失败问题做排查。
说明：进入烧写模式后电脑把设备枚举成“未知设备”，一般不是模组本身损坏，而是 USB 链路或供电条件不满足：线材只有充电线芯（缺 D+/D-）、线太长、接触不良，或者外设接得太多把 VBAT 供电拉低，都会导致枚举失败。
处理步骤：① 换一根确定含数据线的短线（长度小于 1 米），换电脑 USB 口，不要经 USB HUB；② 断开屏、摄像头、大功率外设等负载，让模组在最小系统下进入烧写模式；③ 确认供电充足、与电脑共地良好，必要时按 BOOT 重新进入下载模式；④ 换线换机仍复现时，记录模组型号、固件版本与完整现象，通过官方企业微信群反馈——合宙硬件团队已在排查该烧录失败问题。
参考文档：https://docs.openluat.com/common/howtodown/ 。
7. Airmaster 开发工具额度不够用，怎么增加？/ Codex 什么时候开放？
解答： 结论：Airmaster 目前处于内测阶段，额度暂时无法增加，可先使用 workbuddy；后续会陆续把 Airmaster 的能力开放给其它 agent 工具使用。
说明：内测阶段的额度是固定发放的，用于控制资源并收集反馈，因此不提供临时加量。需要继续推进开发时，可以先切换到已开放的 workbuddy 完成同类工作。Codex 等其它工具的开放时间官方尚未给出。
建议步骤：① 当前先改用 workbuddy 继续开发；② 关注合宙官方渠道（企业微信群、docs 站点公告）获取 Airmaster 功能开放与 Codex 上线的通知；③ 确有迫切且明确的额度需求时，通过官方企业微信群说明使用场景与用量，由合宙评估是否另行安排。
参考文档：https://docs.openluat.com/ 。
8. Air8000A 核心板需要配什么接口的天线，SMA 还是 IPEX？
解答： 结论：官方开发板配的是 SMA 接口天线；而 Air8000A 模组本身只引出了天线管脚，IPEX、SMA 等任何天线接口形式都可以用，取决于你板上的天线座设计。
说明：要区分“开发板标配”和“模组可用接口”两件事——开发板为了便于插拔调试标配 SMA 座；模组侧只是把射频管脚引出，用户在自己板上用 IPEX 座、SMA 座或直接焊接天线都可行。另外该方案 4G 部分为板载，GPS 部分为 IPEX 接口且开发板上已配好。
要点：① 自研板按结构与成本选天线接口，IPEX 适合紧凑结构，SMA 适合外置天线；② 射频走线注意 50Ω 匹配、天线周围净空与地平面完整；③ 使用有源 GNSS 天线时注意供电；④ 座子型号与位置以对应硬件手册为准。
参考文档：https://docs.openluat.com/air8000/product/ 。
9. 合宙 SIP 通话功能哪些模组支持？
解答： 结论：Air780EHM、Air780EHV 等模组可以支持 SIP 通话功能，通常需要配合语音芯片和 AEC 回声消除算法一起使用。
说明：SIP 通话是跑在模组上的应用层功能，模组负责联网与语音通路，回声消除则依赖专门的语音/AEC 芯片。因此选型时要同时看两点：模组是否具备音频能力，以及是否有配套且验证过的语音芯片方案。
建议步骤：① 确认所选模组带音频接口（例如 Air780EHM、Air780EHV 这类带语音能力的型号）；② 搭配官方验证过的语音芯片与 AEC 算法，避免自行搭配导致回声抑制不达标；③ 到 https://docs.openluat.com/ 对应产品页查看 SIP/VoIP 相关章节与 demo；④ 具体型号是否在支持列表中，以文档页公示或官方企业微信群回复为准。
参考文档：https://docs.openluat.com/ 。
10. 合宙 SIP 无回声方案是怎么实现的？用的哪款芯片？
解答： 结论：合宙的 SIP 无回声方案是软硬结合实现的——主控使用 Air780EHM，配一颗语音芯片（华镇 AEC 芯片）做回声消除，并在整机上配合声学结构设计。
说明：回声问题的根源是喇叭外放的声音被麦克风重新拾取，单靠软件端静音或延时无法彻底解决。该方案分三层：① 硬件层用带 AEC 能力的语音芯片完成实时回声消除；② 应用层由主控模组运行脚本，负责 SIP 信令与语音通路；③ 结构层通过麦克风与喇叭的摆位、隔振和音腔设计，从声学上进一步降低回声耦合。
落地建议：① 按官方推荐的芯片组合选型，不要把语音芯片换成未经验证的其他型号；② 复用官方 SIP demo 与语音通道配置，避免随意改动采样率、增益等参数破坏 AEC 效果；③ 结构设计阶段就把麦克风/喇叭摆位纳入考虑，并做实际通话测试；④ 需要对接资料时通过 ai.luatos.com 或官方企业微信群获取。
参考文档：https://ai.luatos.com/ 。
11. 合宙 SIP 方案是否开源？
解答： 结论：SIP 的交互逻辑是 Lua 脚本实现，底层代码位于 component/voip 目录，方案的一部分可以开放。
说明：合宙 SIP 方案在软件上分两层——应用层的 SIP 交互用 Lua 编写，便于客户按业务二次修改；底层实现放在 component/voip 目录下。因此客户可以拿到并使用应用层逻辑，底层按开放范围提供，并非全部开源。
获取方式：① 向合宙技术支持或官方企业微信群说明具体需求（要改哪部分、用在什么产品上），确认可开放的范围；② 通过 ai.luatos.com 获取 SIP 语音对接资料链接；③ 拿到脚本后按官方 demo 的运行环境（对应 core 固件版本）验证，不要只替换单个 lua 文件，容易造成库与固件版本不匹配。
参考文档：https://docs.openluat.com/ 。
12. Air8601 是人脸识别模组还是开发板？支持多大屏幕、什么接口？
解答： 结论：Air8601 属于模组/大屏方案（整机形态），支持 10 寸、9 寸、7 寸屏幕，分辨率为 1024×600，屏幕接口为 RGB；人脸识别算法不额外收费。
说明：Air8601 面向人脸识别门禁、智能柜这类带大屏的整机应用，所以既不是单纯的模组，也不是一块通用开发板，而是围绕大屏加人脸识别组合出的方案形态；屏幕通过 RGB 接口驱动，常用尺寸集中在 7/9/10 寸、1024×600 这一档。
落地建议：① 先按整机结构确定屏幕尺寸以及是否需要触摸，再对照该档位的 RGB 屏规格；② 到 https://docs.openluat.com/air8601/product/ 核对官方支持列表与标配配置；③ 若使用非官方型号的屏幕或摄像头，按“批量可协助适配”的流程提前沟通；④ 人脸识别算法不需要单独付费，成本主要看硬件配置。
参考文档：https://docs.openluat.com/air8601/product/ 。
13. Air8601 人脸算法是否收费？能支付到多少人脸？
解答： 结论：Air8601 的人脸识别算法不收费。
说明：该方案的人脸算法随方案提供，不需要按套或按授权额外付费。提问中的“能支付到多少人脸”应理解为“能支持多少人脸底库”，这属于算法容量/性能指标，本条问答中未给出具体数字，需要按下述方式确认。
确认方式：① 到 https://docs.openluat.com/air8601/product/ 查看人脸识别相关章节，核对算法支持的底库容量；② 文档未列明时，通过 ai.luatos.com 或官方企业微信群，提供项目的底库规模需求向合宙确认；③ 确认容量时同时明确识别距离、活体检测要求与响应时间等指标，避免只对比数量。
参考文档：https://docs.openluat.com/air8601/product/ 。
14. Air8601 模组上架了吗？在哪里买？
解答： 结论：Air8601 已上架，可在合宙官方淘宝店购买。
说明：合宙的模组、核心板、开发板及配件统一通过官方淘宝店销售，Air8601 同样如此，在店内搜索型号即可找到对应商品与套餐配置。
购买步骤：① 打开 https://luat.taobao.com/ ；② 在店内搜索“8601”（或 Air8601）；③ 按需求选择套餐（屏幕尺寸、是否含摄像头等）；④ 批量采购或需要方案配套时，通过官方企业微信群联系合宙商务获取报价。产品资料见 https://docs.openluat.com/air8601/product/ 。
参考文档：https://luat.taobao.com/ 。
15. Air8601 供电范围是多少？能否支持 TTS 和音乐播放？
解答： 结论：Air8601 在 5~12V 供电范围内可以满足整机工作需要，同时支持 TTS 语音合成与音乐播放。
说明：Air8601 面向带屏整机，屏幕和音频功放都会占用较大电流，因此提供 5~12V 的较宽输入范围，方便整机直接取用常见的适配器；音频方面具备 TTS 与音乐播放能力，可直接用于语音播报和提示音场景。
落地要点：① 按整机方案选择 5V 或 12V 输入，电源的持续与瞬态电流要留足余量；② 外接喇叭时匹配阻抗与功率，并注意音腔设计；③ TTS 与音乐播放的具体用法参考对应产品文档与 demo；④ 供电与音频接口的准确参数以 https://docs.openluat.com/air8601/product/ 的硬件手册为准。
参考文档：https://docs.openluat.com/air8601/product/ 。
16. Air8601 最多支持几路串口？可以扩展吗？
解答： 结论：Air8601 支持 3 路串口；如果项目需要更多串口，可以与合宙沟通做批量适配。
说明：3 路串口对门禁、智能柜这类整机通常够用，例如一路接外部控制板、一路接传感器、一路做调试或预留。超出该数量属于针对具体项目的适配工作，合宙可以按批量需求协助处理。
建议步骤：① 先盘清项目需要几路串口、各自的波特率以及是否需要流控；② 3 路以内直接按官方管脚定义设计；③ 超过 3 路时提前把需求与预计批量发给合宙（官方企业微信群），确认适配方案与周期；④ 管脚复用情况以 https://docs.openluat.com/air8601/product/ 的硬件资料为准。
参考文档：https://docs.openluat.com/air8601/product/ 。
17. 屏幕和摄像头能否自己适配，还是只能从合宙买？
解答： 结论：两条路都可以——屏幕和摄像头既可以由客户自行适配，也可以在有一定批量的前提下由合宙帮忙适配。
说明：自行适配灵活性最高，适合有屏厂/摄像头模组资源并能自行做驱动调试的客户；由合宙适配可以省去驱动与兼容性验证工作，但通常需要一定的批量作为前提。
建议步骤：① 自行适配时先确认屏的接口（例如 Air8601 为 RGB 接口）、分辨率与触摸方式，摄像头确认接口类型、分辨率与驱动支持情况；② 需要合宙适配时，提供屏/摄像头的规格书、样品和预计批量，通过官方企业微信群提交；③ 无论哪种方式，都建议先用样品打通再批量；④ 参考资料见 https://docs.openluat.com/air8601/product/ 。
参考文档：https://docs.openluat.com/air8601/product/ 。
18. Air8601 只买主板什么价格？
解答： 结论：“只买主板”没有单独的公开标价，可参考官方淘宝商品中各套餐对应的价格；批量采购可以另行商谈。
说明：合宙在淘宝上按套餐售卖（不同屏幕尺寸、是否带摄像头等组合），主板单卖的价格并未单独列出，最直接的办法是对比各套餐价格与包含内容，或直接咨询店铺客服。
建议步骤：① 打开 https://luat.taobao.com/ 搜索 8601，逐个套餐对比价格和包含配件；② 明确自己要的是哪一块主板、需要哪些配件，再向店铺客服确认单卖方案；③ 批量需求通过官方企业微信群谈价格与交期；④ 最终以官方购买页公示价格为准。
参考文档：https://luat.taobao.com/ 。
19. 批量多少数量可以帮忙适配屏幕和触摸屏？
解答： 尚未解答
20. Air1601/Air1602 的板子是否可以做统一主板？
解答： 结论：Air1601 可以统一做成一块板，Air1602 也可以统一做成一块板；如果有特殊需求，可以选择付费定制。
说明：所谓“统一主板”是把同一型号下不同配置、不同客户的需求收敛到一块板卡上，减少备料和生产的版本管理成本。合宙对 Air1601 和 Air1602 分别做了统一主板；超出标准形态的特殊需求（特殊接口、特殊结构、特殊功能组合）则走定制流程。
建议步骤：① 先明确归属型号（1601 还是 1602）以及所需的功能配置，核对是否落在统一主板覆盖范围内；② 到 https://docs.openluat.com/ 对应产品页查看现有板卡形态；③ 有特殊需求时通过官方企业微信群提出，确认能否定制以及定制条件；④ 定制通常涉及费用与批量要求，具体以合宙官方答复为准。
参考文档：https://docs.openluat.com/ 。
21. Air1602 畅玩板（nand flash）能否支持 U 盘模式拷贝文件？
解答： 结论：不支持。畅玩板只有 nand flash，不能把整机当 U 盘挂到电脑上；TF 卡当前也不能以 U 盘方式访问，需要用读卡器写入后，再通过文件系统读取。
说明：U 盘模式要求设备具备 USB 设备侧的大容量存储能力，并把存储介质映射到 USB 接口；畅玩板的板载存储是 nand flash，未提供这种映射，所以电脑上看不到盘符。TF 卡虽然有介质，但当前同样不能作为 U 盘设备被电脑识别。
替代做法：① 用读卡器在电脑上把文件写入 TF 卡，再插回板子，通过 LuatOS 文件系统接口读写；② 需要给板内下发文件时，可把资源文件随脚本一起用 Luatools 下载到板内，或由脚本通过网络（如 HTTP/MQTT）从服务器获取后写入本地存储；③ 具体可用的文件接口与示例参考 https://docs.openluat.com/ 对应产品文档与 demo。
参考文档：https://docs.openluat.com/ 。
22. Air1780P 去除了 mobile 库，如何获取 IMEI？
解答： 结论：使用 hmeta.devid() 获取。
说明：Air1780P 的固件中去掉了 mobile 库（原来常用 mobile 库的接口读取设备标识），需要改用 hmeta 扩展库读取设备标识信息，这是 mobile 库不可用时官方给出的替代路径。
使用要点：① 按所用 core 版本的库加载方式引入 hmeta；② 调用 hmeta.devid() 取得设备标识并用于业务；③ 确认返回值符合你的业务校验规则（长度、格式、是否含前缀等）；④ 具体接口签名与示例以 https://docs.openluat.com/ 对应产品的 API/示例章节为准。
参考文档：https://docs.openluat.com/ 。
23. Air510W 有没有封装图？支持二次开发吗？
解答： 结论：封装等资料在该产品的手册页可以下载；Air510W 属于单 GNSS 模块，不支持二次开发，只输出 NMEA 数据。
说明：Air510W 的定位是纯 GNSS 定位模块，对外只提供 NMEA 语句输出，没有可编程的应用层，所以不能像 LuatOS 模组那样跑二次开发脚本。资料方面官方提供了手册页，封装等信息可从中获取。
资料与使用：① 手册与封装信息见 https://docs.openluat.com/air510w/product/shouce/ ；② 使用方式是通过串口读取 NMEA 语句，在你自己的主控侧解析经纬度、速度、时间等字段；③ 如果项目需要“定位 + 可编程/可联网”一体化，应改用带 LuatOS 能力的模组方案；④ 接口电平、波特率与天线要求以手册为准。
参考文档：https://docs.openluat.com/air510w/product/shouce/ 。
24. GPS 模组怎么获取经纬度和速度？
解答： 结论：NMEA 数据中本身就包含速度和经纬度信息，通过串口获取模组输出的 NMEA 数据后解析即可。
说明：GNSS 模组（如 Air510W 这类单 GNSS 模块）通常会按固定周期从串口持续输出 NMEA 0183 语句，定位结果与速度都在其中，模组本身不做解析，解析工作放在主控侧完成。
处理步骤：① 用串口按手册规定的波特率接收 NMEA 数据，确认有 $GNRMC、$GNGGA 等语句输出；② 从 GGA 语句取经纬度与定位质量，从 RMC 语句取对地速度（单位节）与日期时间；③ 注意 NMEA 的经纬度是 ddmm.mmmm 的度分格式，需要换算成十进制度；④ 定位无效时（GGA 定位质量位为 0）不要使用该组经纬度；⑤ LuatOS 侧可参考 libgnss 的解析用法。
参考文档：https://docs.openluat.com/ 。
25. Air780EPM 跑一个函数用了 100ms，比较慢，换 Air8000A 会好点吗？
解答： 结论：群里的建议是两者差别不大，换 Air8000A 不一定能带来明显提速。
说明：Air780EPM 与 Air8000A 都属于 Cat.1 模组体系，Lua 应用的执行性能主要取决于脚本解释执行、库调用和 IO 是否阻塞，单次函数耗时 100ms 通常不是“换个模组”就能解决的，应从代码本身入手优化。
优化方向：① 先确认这 100ms 是纯计算还是包含阻塞等待（串口收发、socket、文件读写等），阻塞型耗时换芯片无法改善；② 减少循环内的字符串拼接与表操作，避免在热点路径上做大量 IO；③ 把耗时操作改成事件/回调驱动，用协程分片，避免在一个函数里串行等待；④ 关键算法可降低调用频次或做结果缓存；⑤ 确有性能瓶颈时，把最小复现代码与耗时数据发到官方企业微信群，由合宙评估。
参考文档：https://docs.openluat.com/ 。
26. 724UG 旧固件要存储键值对，看哪个例子？
解答： 结论：可以使用 NVM（非易失存储）来保存键值对，参考所用 core 版本对应的 nvm 库示例。
说明：在 Air724UG 的旧固件上，脚本侧需要断电后仍保留的小数据（配置项、累计值等）时，标准做法是使用 NVM——它把数据写入模组的非易失区域，按 key/value 形式读写。
使用要点：① 按所用 core 版本加载 nvm 库（旧固件上接口可能有限制），先做一次“写入→读出→断电重启再读”的验证；② 非易失存储的写入次数和粒度有限制，不要把高频变化的数据持续写入，必要时做合并或降频；③ 只存少量配置类数据，大数据请走文件系统；④ 示例与接口见 https://docs.openluat.com/ 对应产品的 API/示例章节。
参考文档：https://docs.openluat.com/ 。
27. 780EGP 下载的固件怎么和官网文档对不上？
解答： 尚未解答
28. 780EGP 和 780EPM 资料是相通的吗？
解答： 结论：是相通的，Air780EGP 与 Air780EPM 的资料可以互相参考。
说明：两者同属 780E 系列平台，硬件管脚定义、LuatOS 软件接口和大部分文档内容一致，因此实际使用中资料通用，780EPM 的示例一般也可以在 780EGP 上参考使用。
使用建议：① 仍以 https://docs.openluat.com/ 对应型号的产品页为准，尤其是硬件手册中的差异化参数；② 固件必须按实际型号选择，不要把不同型号的固件包混用；③ 涉及射频频段、GNSS 等差异功能时，逐项核对规格书；④ 如果发现文档内容对不上，先确认是否进错了型号目录。
参考文档：https://docs.openluat.com/ 。
29. 780 的型号差异对比能否发一下？780 能否在越南使用？
解答： 尚未解答
30. 8202 检测不到电池是什么原因？ADC0 能读电池电压吗？
解答： 结论：Air8202 不使用 ADC0 来读电池电压；检测不到电池需要先从硬件连接上确认。
说明：这里包含两件事——① 读电池电压的通道：8202 并非通过 ADC0 采集电池电压，如果照其他平台的思路把电池电压接到 ADC0，读数不会符合预期；② “检测不到电池”属于硬件连接与检测电路的问题，需要核对电池接入路径和检测相关的连接是否正常。
排查步骤：① 对照 https://docs.openluat.com/air8202/product/ 的硬件手册，确认电池接口、检测脚与电压采集通道的准确管脚；② 检查电池是否已接入、正负极与连接器接触是否可靠、线材是否断线；③ 检查检测相关管脚是否有虚焊、上拉/下拉是否正确；④ 用万用表实测电池端电压与检测脚电平，判断问题在电池侧还是板侧；⑤ 仍无法定位时，把原理图与实测数据提交合宙分析。
参考文档：https://docs.openluat.com/air8202/product/ 。
31. 上次采购的 8202 可以修改供电为 12~24V 吗？
解答： 结论：可以找合宙谈定制，需要支付预付款；也可以自行外挂一块 12~24V 转 5V 的降压板，成本更低。
说明：把已采购的 8202 改成支持 12~24V 直接供电，属于硬件层面的定制或改制，需要合宙评估方案并走定制流程；如果只是整机取电是 12~24V、板卡本身仍按原电压工作，用外部降压模块即可，不必改动板卡。
建议步骤：① 若必须让板卡本身支持宽压输入，通过官方企业微信群提出定制需求，明确批量与预付款安排；② 若只是整机电源为 12~24V，直接外挂 12~24V 转 5V 的降压板后接入原供电口，注意功率余量与纹波；③ 无论哪种方式，4G 发射时的瞬态电流都要留足余量并就近加大电容；④ 供电接口与电压范围以 https://docs.openluat.com/air8202/product/ 的硬件手册为准。
参考文档：https://docs.openluat.com/air8202/product/ 。
32. 780 量产烧录每次都需要按 BOOT 才能识别下载，和固件有关吗？
解答： 结论：没有关系——量产工具本身就需要让模组进入 boot 才能下载。
说明：下载流程要求模组处于 boot（下载）模式，量产工具在工装上是靠硬件时序自动把模组带入该模式的，这属于正常的下载机制，不是固件版本问题导致的异常。
建议步骤：① 明确这是下载机制的正常要求，不需要通过换固件去解决；② 量产夹具按模组的下载时序设计控制电路（断电→拉 BOOT→上电→放开），让工装自动完成该动作，避免依赖人工按键；③ 确认每次都能稳定进入 boot 状态（可在设备管理器确认只出现下载口）；④ 烧录异常时再按 https://docs.openluat.com/common/howtodown/ 排查线材、供电与驱动。
参考文档：https://docs.openluat.com/common/howtodown/ 。
33. Luatools 更新后 780 下载固件没有自动识别下载了？
解答： 结论：Luatools 更新后需要先按“下载”再让模组重启（重新上电）才能刷入固件；也可以先更新到最新版 Luatools 再试。
说明：新版 Luatools 的下载交互与旧版不同，不再是一连上就自动进入下载，而是先由工具进入等待下载状态，再让模组重启进入下载流程，两者配合才会开始烧录。如果工具版本较旧，也可能出现与固件不匹配的情况。
操作步骤：① 先在 Luatools 点击“下载/开始”，让工具进入等待状态；② 再按复位键或给模组重新上电（必要时配合 BOOT）；③ 确认设备管理器出现下载口后等待写入完成；④ 仍不识别时把 Luatools 更新到最新版，并按 https://docs.openluat.com/common/howtodown/ 检查线材与供电。
参考文档：https://docs.openluat.com/common/howtodown/ 。
34. Air8000W 下载脚本后模组起不来、找不到 USB 串口怎么办？
解答： 结论：使用 boot 模式烧录，先重新烧一个 demo 把设备恢复到可工作的状态。
说明：下载脚本后模组起不来，通常是新脚本在运行早期就异常（死循环、非法调用、把下载或 USB 相关配置改坏等），导致应用层起不来、USB 口也不再枚举。此时走正常模式已经进不去，必须用 boot 模式强制烧录。
处理步骤：① 断电，按住 BOOT 上电（或按所用板卡的进 boot 方式）让模组进入下载模式；② 用 Luatools 先烧一个官方 demo（或最小脚本 + 对应版本的 core），确认模组能正常起来、USB 串口能枚举；③ 恢复后再逐步加回自己的业务代码，定位是哪段脚本导致起不来；④ 检查脚本中是否有影响启动或 USB 配置的改动；⑤ 烧录流程见 https://docs.openluat.com/common/howtodown/ 。
参考文档：https://docs.openluat.com/common/howtodown/ 。
35. 新版的低功耗/780 底层固件和之前有什么区别？对二次开发升级有什么影响？
解答： 结论：按官方通知，十一之后出货的模组必须使用通知中说明的固件版本；除此之外，对二次开发的功能影响不大。
说明：新版低功耗/780 底层固件是围绕功耗表现做的调整，合宙通过通知明确了“十一之后出货的模组需使用指定版本”这一要求，属于量产一致性与兼容性要求，而不是脚本 API 的大改。
对二次开发的影响与建议：① 升级前核对官方通知中指定的固件版本号，确保与出货模组一致；② 功能层面影响不大，但仍建议在自己的业务脚本上做一轮回归，重点验证低功耗、休眠唤醒与网络保持等场景；③ 固件要与 LuatOS 库版本配套使用，不要单独替换；④ 具体版本与差异以官方企业微信群或文档通知为准，固件下载见对应产品页。
参考文档：https://docs.openluat.com/ 。
36. Air724UG 一个模组 ping 通但 TCP 报文不通，另一个正常，怎么排查？
解答： 尚未解答
37. Air8000 工程日志出现无关信息、无网络信息、重启键无效、无法下载，怎么回事？
解答： 结论：这是 Luatools 的打印通道选错导致的现象——4G 模块要选“4G 模块打印”，8101 要选通用串口。
说明：Air8000 这类方案中同时存在多个日志输出源（4G 模块侧的打印，以及 8101 侧的打印），它们走的串口通道不同。在 Luatools 里选错打印通道，就会出现日志里全是无关信息、看不到网络相关信息，同时因为看到的不是实际工作通道，现象上看起来像重启键无效、无法下载。
处理步骤：① 打开 Luatools 的日志/打印配置；② 需要看 4G 模块相关日志时选择“4G 模块打印”；③ 涉及 8101 的日志选择通用串口；④ 按需要的通道分别抓取日志，再结合现象判断问题；⑤ 仍未解决时把 Luatools 的配置截图与日志通过官方企业微信群反馈。
参考文档：https://docs.openluat.com/common/howtouselog/ 。
38. 设备进入低功耗后频繁掉线/MQTT 断连如何排查？
解答： 尚未解答
39. Luatools 抓日志必须 6M 波特率吗？
解答： 结论：是的，需要 6M 波特率，并且要用高速串口，CH340 不行。
说明：LuatOS 的日志输出量较大，低速串口会出现丢日志、时间戳错乱甚至影响运行的情况，所以需要用 6M 波特率抓取。能否用起来取决于电脑侧的串口芯片是否支持这么高的波特率——CH340 这类芯片不支持。
操作要点：① 在 Luatools 中把日志串口波特率设为 6M；② 使用支持该波特率的串口芯片方案，CH340 不行；③ 线材要短、质量要好，高速下更容易因线材劣化产生误码；④ 日志要保存完整（含开机到异常的全过程）再提交分析，抓取方法见 https://docs.openluat.com/common/howtouselog/ 。
参考文档：https://docs.openluat.com/common/howtouselog/ 。
40. Air780E 怎样才能 OTA 成功？有没有 OTA 文件？
解答： 尚未解答
41. 780EP 官网有 GPIO21，但 Luatools 管脚配置没有，导出管脚配置会有问题吗？
解答： 结论：不会有问题——GPIO21 只能做 GPIO21 使用，没有其它复用功能，因此管脚配置里不需要单独列出，正常导出使用即可。
说明：Luatools 的管脚配置主要用于配置具有复用功能的管脚（同一个物理脚可选多种功能）。GPIO21 没有复用功能，天然只有一种用途，不出现在可选配置项里属于正常现象，也不会影响导出的配置文件。
建议步骤：① 直接按 GPIO21 使用，不需要在配置里额外指定；② 导出管脚配置后正常用于工程即可；③ 使用前按硬件手册确认该脚的默认电平与驱动能力，避免与外部电路冲突；④ 其它型号的管脚配置差异可对照 https://docs.openluat.com/ 对应产品的硬件手册。
参考文档：https://docs.openluat.com/ 。
42. 新版 Luatools 导出离线编译包没有 bin 文件，云端需要 BIN 文件升级怎么办？
解答： 尚未解答
43. Air8000A 的 SIP 通话/语音对讲方案有文档吗？
解答： 结论：有相关资料，可以问 ai.luatos.com 获取 SIP 语音对接资料的链接。
说明：SIP 通话/语音对讲涉及信令交互、音频通道与回声消除的配合，合宙提供了对应的对接资料。由于资料会随方案版本更新，最直接的方式是通过官方 AI 问答入口获取当前有效的链接与说明。
获取步骤：① 打开 https://ai.luatos.com/ ，提问 Air8000A 的 SIP 语音对讲对接资料；② 按返回的链接查看方案说明、脚本与配置方法；③ 结合你的硬件情况（是否有音频芯片、是否有 AEC 回声消除）确认需要哪些配套物料；④ 资料未覆盖的部分通过官方企业微信群向合宙技术支持确认。
参考文档：https://ai.luatos.com/ 。
44. 超低功耗还是低功耗模式下会识别不到 SIM 卡，是什么原因？
解答： 尚未解答
45. Air8601 能否 Pin2Pin 兼容 Air8000W？
解答： 尚未解答
46. 1,1 指令后面要跟异或校验吗？
解答： 结论：手册上说明不加校验是允许的；加不加校验结果可能一样返回 Fail。
说明：这类指令行末尾是否附加异或校验，属于协议允许的两种写法之一，手册已明确不加校验也是合法的。如果指令本身的内容或参数有问题，那么加与不加校验都会返回 Fail，因此不能用“返回 Fail”来反推校验是否必需。
排查建议：① 先对照手册确认该指令的参数格式、取值范围与分隔符是否完全正确；② 确认串口参数（波特率、数据位、校验位、停止位）与设备要求一致；③ 需要定位时，分别用“不加校验”和“加校验”两种写法发送，对比返回结果；④ 若两种写法都返回 Fail，问题通常在指令内容或链路上，而不在校验；⑤ 最终以所用设备的手册说明为准。
参考文档：https://docs.openluat.com/ 。
47. Air780EHV 内置音频 codec，为什么 demo 还要外挂 8311？Lua 里如何配置音频驱动？
解答： 结论：内置 codec 与外挂 8311 对应两种不同的音频通路设计，demo 演示的是外挂 8311 的方案；实际使用时按自己板子的硬件配置填写相关参数即可。
说明：模组内置 codec 面向的是模组直接接麦克风/喇叭的简单音频场景；demo 中外挂 8311，是因为对应参考板采用了外置音频 codec/功放方案，或需要额外的音频通道与驱动能力。两者不是矛盾关系，而是两套可选设计。因此 Lua 里配置音频驱动的关键是：你的板子实际怎么接，就按那套参数配置。
配置要点：① 先确认板子的音频硬件结构——走模组内置 codec 还是外接 8311；② 在音频初始化接口里按实际硬件填写通道、采样率、接口类型、音量等参数，参数与原理图一一对应；③ 不确定时以官方 demo 中与你板子结构一致的那一份为基准修改，不要跨方案照搬；④ 调试阶段先用音频播放接口播一段固定音频确认通路，再接 TTS 或通话业务；⑤ 具体接口与示例见 https://docs.openluat.com/ 对应产品的音频章节。
参考文档：https://docs.openluat.com/ 。