常见问题 - 2026-09-17
数据日期：2026-09-17
1. Air780EHV模块能做SIP中继吗？
解答： 结论：可以做。Air780EHV 的 SIP 中继方案（USB Dongle 形式）已经批量出货，配合 SIP 转 VoLTE 桥接功能，可以直接通过 SIP 侧拨打电话。
说明：Air780EHV 属于带语音能力的型号，SIP 中继的本质是把 SIP 侧的注册与呼叫信令、媒体流，桥接到模组的 VoLTE 语音通道上，使原本只能由运营商语音承载的通话被 SIP 平台调度，平台侧看到的就是一个标准 SIP 终端。
落地要点：① 先明确话务模型——并发路数、是否需要录音、是否需要回声抑制，再确定具体形态；② 不想做二次开发时，可直接采用已出货的 USB Dongle 形态方案；③ 需要自定义业务逻辑时，用 LuatOS 的 SIP 相关扩展库自行开发，注意库与底层 core 固件要配套升级。
参考文档：https://docs.openluat.com/
2. Air8781出厂默认有程序吗？上电获取不了参数是什么原因？
解答： 尚未解答
3. Air8781P2模块是否只能通过iRTU配置？如何用MQTT连到自己的服务器？
解答： 结论：不是只能通过 iRTU 配置。如果不想做二次开发，可以用 iRTU 配置后以透传方式连接自己的服务器。
说明：iRTU 是免开发的透传固件，通过网页/上位机把串口参数、服务器地址端口、协议类型等配置好，模组上电后会自动连服务器并把串口数据透传上去，适合“MCU + 模组”这种不改模组程序的用法；配置为 MQTT 模式时，业务数据即可通过 MQTT 发到自建服务器。
操作要点：① 到 iRTU 说明页按型号下载对应固件并用 Luatools 烧录；② 在 iRTU 配置页面填写自建服务器的地址、端口、MQTT 客户端 ID 与主题等信息；③ 若需要自定义报文格式或复杂业务逻辑，则应改用 LuatOS 二次开发自己写脚本。
参考文档：https://docs.openluat.com/value/irtu/state/
4. Air8202整机充电如何判断是否充满？电量显示跳变（-26%、-14%、99%）是怎么回事？
解答： 结论：这两个现象同源，都是当前充电 IC 配置不当引起的：放电电流偏大导致发热而提前断充，同时电池电压识别有误，因此电量显示会出现负值、乱跳等异常。
说明：充电是否充满，本质是由充电 IC 按设定的充电电压与截止电流判断并给出状态，而不是靠软件猜；当放电电流过大、板子发热时，会触发温度/电流相关的保护而停止充电，表现为“没充满就断”。电量百分比则是根据 VBAT 电压查表估算出来的，电压识别不准，百分比自然跳变。
处理要点：① 升级到官方已提供的新固件，其中包含针对该问题的修正；② 核实整机实际放电电流是否偏大，必要时优化外设功耗与供电走线；③ 升级后仍在特定条件下复现时，保留日志与复现步骤反馈给合宙，便于继续定位。
参考文档：https://docs.openluat.com/
5. exaudio.lua模块哪里有下载？
解答： 尚未解答
6. 780EHV-SIP通话对方挂断后，如何判断/及时知道对方已挂断以便拨打下一个号码？
解答： 结论：可以通过 “DISCONNECTED” 状态判断对方已挂断，但该状态存在一定延迟；更稳妥的做法是主动设置通话超时时间，到点主动挂断再拨下一个号码。
说明：SIP 通话的挂断最终以 BYE 信令与本地状态机流转到 DISCONNECTED 为准，链路抖动或对端信令异常时，状态上报可能滞后，只依赖被动判断会让呼叫流水线停顿。
操作要点：① 在通话状态回调里监听 DISCONNECTED，作为正常挂断的处理入口；② 每次呼叫前用定时器设置一个合理的通话超时（如无人接听、对方未挂断等情况），超时后主动挂断；③ 挂断后增加短暂延时并复位音频/呼叫状态，再拨下一个号码，避免上一条通话的音频资源未释放就发起新呼叫；④ 批量拨打场景建议记录每条呼叫的结果与耗时，便于优化超时参数。
参考文档：https://docs.openluat.com/
7. 780EHV板子什么时候出/什么时候能通过SIP平台商用？
解答： 结论：产品目前还在做参考设计，尚未定价，也还没有正式商用，具体时间以官方发布为准。
说明：参考设计阶段主要是把原理图、PCB、外围器件（音频、回声抑制、电源等）定型并验证，之后才会进入定价与上架环节，因此现阶段无法给出确切时间。
操作要点：① 有明确项目需求时，通过合宙官方企业微信群或销售登记，产品定档后可优先获得通知；② 需要提前验证功能时，可先用已验证的模块自行搭板做原型；③ 关注 docs.openluat.com 对应产品页与官方店铺的上架状态。
参考文档：https://docs.openluat.com/
8. 780EHV的TTS无语音输出，同批次其它模块正常，是什么问题？
解答： 结论：同批次其它模块正常，说明问题大概率出在这一块板子或这颗模块的个体上，建议用合宙板子加原厂 demo 做对比测试，或把板子上的模块与合宙板子对调，来判定是焊接问题还是模块问题。
说明：TTS 不出声的常见原因包括音频通道未正确初始化、功放/喇叭通路异常、以及模块焊接不良导致的音频引脚虚焊。逐项替换法是最高效的判定手段：固定软件，只换板子/模块，谁跟随变动，问题就在谁身上。
操作要点：① 先在合宙官方板子上烧原厂 demo，确认 demo 本身能正常 TTS 外放；② 把有问题板上的模块换到合宙板子上，再把合宙板子的模块换到你的板子上，分别观察结果；③ TTS 播放可使用 LuatOS 仓库中的 exaudio 扩展库；④ 若确认是焊接问题，重新过炉/补焊音频相关引脚后再测。
参考文档：https://docs.openluat.com/
9. 8000的管脚映射表中pin69可复用为can_rxd，但IO配置工具只有pwm2和gpio25选项，是工具未开放还是文档写错？
解答： 结论：文档没有写错，是工具侧屏蔽了该配置项——pin69 的 can_rxd 复用仅限内部使用，外部不可用，因此 IO 配置工具不会放开这个选项。
说明：管脚复用表列出的是一颗芯片“全部可复用功能”，属于芯片能力清单；而实际工具里能选到的，是经过产品定义、确认可对外引出的功能子集。两者出现差异，通常就代表该复用在当前封装/产品形态下不对外提供。
操作要点：① 以 IO 配置工具里可选的复用项为准来写业务代码，不要直接照抄管脚表中的全部复用；② 若确实需要 CAN 功能，改用工具中已开放 CAN 复用组合的引脚；③ 选型或设计前可把具体需求发到官方渠道确认，避免投板后才发现不可用。
参考文档：https://docs.openluat.com/
10. 1602管脚复用表为什么有两个gpio13（管脚号43、77）？
解答： 结论：这是正常现象，可以这么用，最终取决于你在软件里复用哪一组；默认的 gpio13 是管脚号 77 那一组。
说明：芯片内部同一个 GPIO 编号可能接到多个焊盘，形成“一对多”的复用关系。管脚表如实列出每个焊盘可映射到的 GPIO，所以会出现同一个 gpio13 对应两个管脚号的情况。软件上按 GPIO 编号操作时，实际生效的是当前被复用/被配置到的那一个焊盘。
操作要点：① 代码里使用 gpio13 前，先确认硬件上这个 GPIO 是接到 43 还是 77，避免控制到错误的焊盘；② 两块板子若用了不同焊盘，代码不能直接照搬；③ 若两个焊盘都被外部电路占用，需重新规划引脚分配，避免互相干扰。
参考文档：https://docs.openluat.com/
11. 8101的errDump为什么总是失败、发不出去？
解答： 结论：errDump 发送失败主要与 adapter 参数配置有关，必须使用 netdrv 注册的网卡 id（例如 socket.LWIP_USER0）来指定发送通道；研发已定位到该问题并完成修复，会提供临时固件。
说明：errDump 在崩溃/异常时把日志上报到服务器，上报走的是底层网络。如果 adapter 填的不是当前已就绪、已被 netdrv 注册的网卡 id，底层拿不到可用链路，就会出现“总是失败、发不出去”。
操作要点：① 按文档把 adapter 配置为 netdrv 注册后的网卡 id，例如 socket.LWIP_USER0；② 确认上报前网络已就绪（已注网、已获取 IP）；③ 使用研发提供的临时固件验证，问题解决后回归到正式发布版本；④ 仍失败时保留 errDump 返回值与串口日志反馈。
参考文档：https://docs.openluat.com/
12. AIR780EHV的28、29脚UART2无法收发数据是怎么回事？
解答： 结论：28、29 脚本身就是默认的 uart2，无需额外做复用配置；建议先检查焊接，可用 TX 与 RX 短接做自收自发测试，并用最新固件加官方 demo 验证。
说明：既然是默认串口，正常情况下初始化 uart2 即可收发，出现完全无数据，多数不是软件配置问题，而是焊接虚焊、引脚接触不良，或者固件/demo 版本不匹配。
操作要点：① 用最新底层固件 + 官方 demo 在合宙板子上先跑通 uart2，确认基线正常；② 把你板子上的 28、29 脚 TX 与 RX 短接，自发自收，能收到说明串口硬件与驱动正常，问题在外部对端；③ 检查这两个引脚及周边焊点是否有虚焊、连锡；④ 确认与对端设备波特率、电平一致后再接实际外设。
参考文档：https://docs.openluat.com/
13. 8780V3的供电方式，淘宝介绍为USB或VIN供电，飞书文档写VBAT供电，以哪个为准？
解答： 结论：以淘宝介绍为准，是飞书文档里的表格写错了——其中 1 和 2 路有 DCDC，3 和 4 路没有，该处已经更正，为此给大家带来的困扰表示抱歉。
说明：USB/VIN 供电与 VBAT 供电描述的是同一块板子的不同供电入口或不同通道。表格串行时容易把具备 DCDC 的通道与直供 VBAT 的通道写混，从而出现资料互相矛盾。
操作要点：① 请以合宙官方淘宝店商品页的最新描述为准；② 对照板上丝印与实物确认供电入口与对应通道；③ 使用在线文档时留意页面更新时间，如遇前后不一致可将截图反馈给官方渠道，我们会及时更正。
参考文档：https://docs.openluat.com/
14. Air8784淘宝上能买吗？什么时候上架？
解答： 结论：Air8784 目前在淘宝暂时还不能购买，预计下周上架。
说明：产品上架前需要完成相关资料整理与库存准备，因此会有一小段空档期。
操作要点：① 可先到合宙官方淘宝店搜索该型号，关注上架状态；② 产品资料与技术文档可在 docs.openluat.com 对应产品页提前查阅；③ 有批量或项目紧急需求时，通过合宙官方企业微信群联系销售协调。
参考文档：https://docs.openluat.com/
15. Air780EX-3.3V可以直接用Air780EX2T-3.3V平替吗？
解答： 尚未解答
16. Air780EPM/Air780EPT与Air780ET兼容吗？Air780E换成Air780EPT需要改东西吗？
解答： 结论：兼容性要按“硬件封装/引脚”和“出厂固件与开发方式”两部分分别核对，不能一概而论；可以直接把具体型号组合发给 docs.openluat.com 右下角的 AI 提问，获得针对性的对照说明。
说明：同一产品家族里，后缀不同的型号往往封装相近但定位不同（例如二次开发版与 AT 版），因此能否直接替换，取决于引脚定义、外设复用的可用子集、以及上层是 Lua 脚本还是 AT 指令这几项是否一致。
操作要点：① 导出两个型号的管脚表，逐脚核对供电、下载、SIM、串口、天线等关键引脚；② 核对开发方式——原来是 LuatOS 脚本还是 AT 指令，替换后对应的是否同名型号；③ 确认固件必须使用目标型号自己的正式版本，不要跨型号混刷；④ 差异点列清单后一并发给官方 AI 或企业微信群确认。
参考文档：https://docs.openluat.com/
17. Air8000的eSIM是必须用的吗？插实体卡还需要吗？
解答： 结论：不是必须用的。硬件上做的是兼容设计，既可以按 eSIM 使用，也可以插入实体 SIM 卡使用。
说明：兼容设计意味着两种卡形态共用同一套 SIM 接口与切换逻辑，用户可按项目需要选择：量产想免去插卡工序可选 eSIM，需要灵活换卡或现场换运营商则用实体卡。
操作要点：① 按整机需求确定使用 eSIM 还是实体卡；② 实体卡请使用开通流量、未欠费的卡，注意卡座方向与规格；③ 两种形态都需保证 SIM 天线/走线与 4G 天线的设计符合硬件手册要求。
参考文档：https://docs.openluat.com/
18. 5101S蓝牙模块的wakeup可以直接接主控GPIO吗？有无上下拉要求？
解答： 尚未解答
19. Air6101/6205 WiFi模组能否像780EPM那样二次开发实现串口转WiFi？
解答： 结论：不能。
说明：能否“像 Air780EPM 那样二次开发”，取决于该型号是否公开发布并提供 LuatOS/开源 SDK 的二次开发支持。Air6101/6205 作为 Wi-Fi 模组，不提供这类二次开发能力，因此无法把业务脚本直接跑在模组里实现串口转 Wi-Fi。
替代思路：① 若只是需要串口转 Wi-Fi 的透传功能，可选用官方明确支持二次开发的联网型号，在其上写 Lua 脚本完成；② 也可以在模组前面挂一颗 MCU，由 MCU 通过 AT 指令驱动 Wi-Fi 模组，业务逻辑放在 MCU 侧；③ 选型前先到选型指南按“开发方式”筛选型号，确认支持二次开发再投板。
参考文档：https://docs.openluat.com/
20. Air8202G新固件工作模式2是否太耗电，能否改成模式1？
解答： 结论：当前版本是强制使用工作模式 2，暂时不能自行切到模式 1；相关问题正在优化，下一版本可以通过 web 直接下发指令调整。
说明：工作模式关系到供电与功耗策略，模式 2 的功耗表现与整机使用场景有关。官方已经识别到需要更灵活的模式选择，方案是在后续版本开放 web 指令入口，让用户按场景自行切换。
操作要点：① 现阶段按强制模式 2 使用，先评估实际续航是否满足项目要求；② 需要降功耗时，可先优化外围电路与外设功耗（如指示、传感器、供电支路）；③ 关注后续版本发布，升级后再通过 web 指令切换工作模式。
参考文档：https://docs.openluat.com/
21. Air8202G怎么看固件版本？为什么没上报新固件版本号？
解答： 结论：固件版本号需要设备静止一段时间后才会上报，也可以在 LUATOOLS 中搜索相关版本信息；此外主板上带有拨码，把 USB 拔掉后将拨码拨到右边，再插上 USB，即可通过打印查看版本。
说明：版本上报逻辑是在设备进入稳定静止状态后才触发，刚上电或设备处于运动中时，可能还没到上报时机，因此在平台上暂时看不到新的版本号。
操作要点：① 让设备静止放一段时间，再回平台查看版本上报情况；② 用 LUATOOLS 搜索、确认当前固件版本信息；③ 需要看串口打印时，先拔掉 USB，将主板拨码拨到右边，再插 USB 观察打印内容。
参考文档：https://docs.openluat.com/
22. V2036版本780EPM SDK开发，外挂flash是否不支持全量升级、只支持差分升级？
解答： 结论：该问题已经反馈研发复测，目前掌握的情况是 Air780EP 已关闭全量更新，Air780EPM 未做改动。
说明：全量升级与差分升级的可用性，与型号、固件版本以及外挂 flash 的布局有关。同一时间不同型号的策略可能不一致，因此不能用 EP 的结论直接套到 EPM 上。
操作要点：① 先确认实际使用的型号到底是 Air780EP 还是 Air780EPM，并记录 SDK/固件版本号；② 在对应型号的固件版本页核对升级说明；③ 若在 EPM 上仍出现与说明不符的现象，整理型号、版本号、外挂 flash 型号、升级日志，通过官方渠道提交研发复测。
参考文档：https://docs.openluat.com/
23. 780EPM的2044版本DNS解析失败（换成IP正常，换DNS服务器也不行），2050版本正常，是什么原因？
解答： 结论：原因是所使用的域名里含有大写字母，导致解析失败；把域名改成全小写即可解决，2050 版本正常也与此相关。
说明：域名解析对大小写是敏感的（严格来说域名本身不区分大小写，但解析环节的实现如果不做归一化处理就可能匹配失败）。替换成 IP 直连能通、换 DNS 服务器也没用，正好说明链路和服务器都没问题，卡在域名解析这一步。
操作要点：① 检查代码与配置中的域名，统一改为全小写；② 不要混用大小写形式（同一域名有的地方大写、有的地方小写）；③ 修改后重新测试解析，若仍失败，升级到表现正常的 2050 及更新版本；④ 有需要时也可在代码中指定 DNS 服务器辅助排查。
参考文档：https://docs.openluat.com/
24. Air780EHM的V20固件不支持电信卡，有没有V30xx的AT固件？
解答： 尚未解答
25. Air8000A能定位成功而Air8000D（自己画的板）不行，可能是什么问题？
解答： 尚未解答
26. 8700/8300烧录demo后4G转有线连不上网，是否需要检测？
解答： 结论：可以先按官方 demo 自行核对配置，官方提供的 4G 转有线参考工程可以直接对照排查；如果仍定位不到，也可以联系合宙寄送调试好的板子做对比。
说明：4G 转有线本质是把 4G 拿到的网络通过以太网口共享出去，涉及的环节包括 4G 侧是否能正常注网与上网、以太网口是否 link up、以及路由/转发是否正确配置。任何一环不成立，终端都上不了网。
操作要点：① 先确认 4G 侧本身能上网（注网、拿到 IP、能 ping 通外网）；② 再确认网口物理链路正常，终端能拿到地址；③ 对照官方参考工程逐项核对配置差异，不要只跑 demo 不改参数；④ 仍无法解决时联系合宙，可寄送一块调试好的板子做对照。
27. 有能完全替代780E的国外定位+4G模块吗（蒙古、东南亚）？
解答： 结论：国外没有“通信 + 定位二合一”的模块，可以采用 Air780EHU 加 Air510W 两颗模块组合的方式来实现，docs 上提供了对应参考设计。
说明：把 4G 通信与 GNSS 定位做成两颗独立器件再组合，是海外项目里常见的做法——通信模组负责蜂窝链路，定位模块负责卫星定位，二者通过串口交互，整体功能与二合一模块等效。
操作要点：① 按目标国家确认频段与认证要求，选择对应的海外版本；② 按官方参考设计完成两颗模块的接口、供电与天线布局；③ 定位部分注意天线净空与走线；④ 上市前在目标国家实地场测。
参考文档：https://docs.openluat.com/
28. 合宙是否有封装与Air780EHT兼容、支持MQTT、可通过IIC/PCM外接ES8311实现TTS播放的模组？
解答： 结论：有的。走 AT 开发可用 Air780EVT（IO 3.3V）或 Air780EVT-1.8V；走二次开发则用 Air780EHV。
说明：AT 版本把功能封装成标准指令，适合不改模组程序、由 MCU 驱动的方案；二次开发版本可以直接在模组上跑 Lua 脚本，方便自行控制音频通路与外设，适合需要更灵活业务逻辑的场景。
操作要点：① 先确定开发方式（AT 还是 LuatOS 二次开发），再对应选型；② 外接 ES8311 时按硬件手册确认 IIC/PCM 可用引脚与电平（注意 3.3V 与 1.8V 版本的区别）；③ TTS 播放可使用 LuatOS 仓库中的 exaudio 扩展库。
参考文档：https://docs.openluat.com/
29. Air780EVT-1.8V已内置ES8311，有没有外接款？
解答： 结论：需要外接 ES8311 的场景，要用二次开发的型号。
说明：内置音频编解码的型号把 ES8311 做在模组内部，省去外部器件与走线，适合紧凑设计；而当你有自己的音频电路、想外接 ES8311 时，就需要选支持外接、可自行控制音频外设的二次开发型号。
操作要点：① 按是否需要自行外接音频器件来区分选型；② 选用二次开发型号后，参考官方音频接口说明连接 ES8311 的 IIC 控制与 PCM 数据通路；③ 注意模组 IO 电平与 ES8311 供电匹配。
参考文档：https://docs.openluat.com/
30. Air1103的回声抑制芯片有卖吗？什么时候有货？
解答： 结论：后续会以统一模组的形式对外销售，SIP 模组暂时没有这么快量产；短期内可以先做 SIP 对讲的 PCBA 定制。
说明：把回声抑制等音频处理能力做成标准模组，需要经过方案定型与量产准备，周期相对较长；而针对具体项目做 PCBA 定制，则可以先满足当前产品落地需求。
操作要点：① 有 SIP 对讲产品需求的，可先走 PCBA 定制路线；② 关注模组化产品的正式发布节奏与上架信息；③ 具体项目需求通过合宙官方企业微信群或销售沟通确认。
参考文档：https://docs.openluat.com/
31. 合宙Air8601大屏方案播放音视频效果如何？
解答： 尚未解答
32. AirUI的image src什么时候支持https远程地址？视频能播放远程的吗？
解答： 结论：当前只能先把资源下载到本地再播放，暂不支持直接使用 https 远程地址；支持远程地址属于远期计划。
说明：直接拉取远程资源对网络、内存与解码缓冲的要求都更高，需要先在底层把网络加载与渲染链路打通，因此排在后续规划中。
操作要点：① 现阶段的做法是先把图片/视频资源下载到模组本地存储，再用 AirUI 的 image 组件加载本地路径；② 视频同理，先下载后播放；③ 资源较大时注意存储空间与下载耗时，必要时做分片与缓存管理；④ 关注后续版本发布说明，确认远程地址支持情况。
参考文档：https://docs.openluat.com/
33. 780EHM频繁播放语音偶尔出现抢音现象，有什么好的解决方法？
解答： 结论：当前可用的规避手段是调用 exaudio.play_stop 后再 play_start，并在中间加入 sys.wait 延时；按此处理后仍会偶发，可参考文档中的音频逻辑继续调试。
说明：抢音通常发生在上一段音频的播放通道还未完全释放，下一段音频就启动了，两路播放相互干扰。先停止再启动、并留出释放时间，是最直接的规避方式；之所以仍偶发，说明音频任务的并发与释放时序还需要进一步梳理。
操作要点：① 播放前先 stop 再 start，并在两步之间加入 sys.wait 延时；② 检查是否有多处任务在同时调用播放接口，避免并发播放；③ 音频完成后按文档建议释放播放通道；④ 把偶发场景（频率、脚本、固件版本）整理后反馈，便于底层进一步优化。
参考文档：https://docs.openluat.com/
34. Air780EHV的uart2有什么注意事项？uart1正常但uart2没有数据发送。
解答： 结论：建议先用最新底层固件加官方 demo 做对比测试——在合宙板子和原始 demo 上先验证 uart2 是否正常，再排查自己的板子与代码。
说明：uart1 正常而 uart2 无数据，说明整体固件与串口机制本身没问题，差异集中在 uart2 这一路的初始化、引脚或外部连接上。先用官方基线隔离变量，可以快速判断问题在模组侧还是在你的板子/对端。
操作要点：① 在合宙板子上烧最新固件跑官方 demo，确认 uart2 基线正常；② 把同样的代码和固件放到你的板子上对比，若无数据则重点检查 uart2 引脚焊接与走线；③ 用 TX-RX 短接自收自发验证串口硬件；④ 确认与对端的波特率、电平一致后再接实际设备。
参考文档：https://docs.openluat.com/
35. 合宙平台需要做电池校准吗？充电IC到4.35V停充但读到4.28/4.29V是否正常？
解答： 结论：合宙平台没有电池校准这一说；充电 IC 到 4.35V 停充、而读数落到 4.28/4.29V，基本就在正常误差范围内。
说明：VBAT 的电压读数受采样精度、走线压降与充电状态影响，与充电 IC 的设定停充点之间存在小幅偏差是正常的，不能简单理解为电池没充满或读数错误。
操作要点：① 不必做所谓“电池校准”，按硬件手册设计供电与采样即可；② 关心电量显示时，以整机的电量算法与实际使用表现综合判断，而不是只看某一次的电压读数；③ 若偏差明显超出合理范围（例如读数与实测相差很大），再检查采样走线与分压电阻精度，并反馈排查。
参考文档：https://docs.openluat.com/
36. 合宙有没有接入星闪模块的案例？
解答： 结论：没有。
说明：目前合宙没有提供星闪（NearLink）模块，也没有对应的接入案例。
操作要点：① 若整机项目确有星闪需求，可以通过合宙官方企业微信群反馈，我们会评估是否纳入后续规划；② 短期内的做法是在整机侧自行选用第三方星闪模块，通过串口等接口与合宙模组对接，业务逻辑由自己的主控负责；③ 选型与评估请以官方正式发布的产品资料为准。
参考文档：https://docs.openluat.com/
37. 现在有能让agent调用的烧录工具吗？
解答： 结论：有的，LuatOS 插件和 AirMaster 已经集成了对 agent 调用烧录工具的支持，具体用法可以问 AI。
说明：把烧录能力封装成可供 agent 调用的接口后，自动化流程可以自己完成“选固件→烧录→验证”，减少人工点击环节，适合批量或 CI 场景。
操作要点：① 先确认使用 LuatOS 插件还是 AirMaster，两者对应的调用方式不同；② 按文档准备好固件与脚本（首次烧录需底层 core 与脚本一起下载）；③ 具体参数与示例可以咨询合宙 AI 获取当前最新说明。
参考文档：https://docs.openluat.com/
38. mcp服务器挂了，可以下载离线版参考文档吗？
解答： 结论：地址已经更换，可向合宙 AI 咨询获取最新的 MCP 服务器地址。
说明：MCP 服务器是给 AI 查询参考资料用的，地址变更后，旧配置自然连不上。拿到新地址后更新本地配置即可恢复。
操作要点：① 向合宙 AI 询问当前有效的 MCP 服务器地址；② 更新你自己的 MCP 配置并重启工具；③ 若仍连不上，把报错信息反馈到官方渠道；④ 查资料的第一手入口始终是 docs.openluat.com，不会因为 MCP 地址变动而受影响。
参考文档：https://docs.openluat.com/
39. AIR780EHU的CE证书和报告有吗？
解答： 结论：CE 证书可以通过合宙 AI 获取；如果需要测试报告，需要向商务提出需求。
说明：证书类资料涉及具体型号、目标市场与项目用途，因此会按申请用途提供；报告则通常与商务对接后按需出具。
操作要点：① 需要 CE 证书时，先通过合宙 AI 获取；② 需要测试报告或用于认证、招标等正式用途时，联系商务并说明型号、用途与所需文件清单；③ 拿到资料后请核对型号与版本是否与你的采购型号一致。
参考文档：https://docs.openluat.com/
40. Air8780哪些引脚是AGPIO、休眠时可保持高电平？对应手册在哪里？
解答： 结论：可直接查看模组引脚资料，其中列明了各引脚定义；该手册为在线 web 版，没有提供 PDF。
说明：能“休眠时保持高电平”的是 AGPIO（常电域 IO），与普通 GPIO 所在的电压域不同，普通 GPIO 在低功耗/休眠状态下可能掉电而进入高阻态，因此做休眠常亮指示一类的设计要用 AGPIO。
操作要点：① 在模组引脚资料页按引脚定义确认哪些是 AGPIO；② 注意 AGPIO 驱动能力一般较弱，直接带 LED 需评估，必要时加三极管/MOS 扩流；③ 手册为在线 web 版，使用时请以页面最新内容为准。
参考文档：https://docs.openluat.com/air8780/luatos/hardware/module/circuit/pins/
41. 淘宝购买的1601 10.1寸屏触摸无反应，可以维修吗？
解答： 结论：属于合宙责任的，免费维修并提供一年质保；属于客户责任的，收费维修，具体联系淘宝客服。需要说明的是该屏无法维修，未超过 7 天可以换货。
说明：判定责任归属需要看到实物并确认使用情况，因此请先通过淘宝客服沟通，由客服按质保与售后流程处理。
操作要点：① 通过淘宝客服提交问题，说明购买时间、现象与使用环境；② 未超过 7 天的按换货处理；③ 已超过 7 天的，客服会根据责任判定给出免费或收费维修方案；④ 寄回前建议先拍视频/照片留存现象，便于判定。
参考文档：https://docs.openluat.com/
42. WiFi上传速度比4G慢很多是什么原因？
解答： 结论：这与固件版本有关——使用 2005 固件时 4G 与 WiFi 的速度相差不大，而 2021 固件下 WiFi 速度较慢；测试中 2005 版本明显更快。
说明：Wi-Fi 吞吐受驱动与协议栈实现影响较大，不同固件版本在这方面的优化程度不同，因此会出现同一块板升级前后速度差异明显的情况。
操作要点：① 把固件升级到 2005 或更新版本后再复测；② 测试时保持条件一致——同一服务器、同一文件、同一距离与信道，避免环境干扰导致误判；③ 若升级后仍明显偏慢，记录固件版本、测速方式与结果，反馈给官方排查。
参考文档：https://docs.openluat.com/
43. Air6205 WiFi模组能二次开发实现串口转WiFi功能吗？
解答： 结论：不能。
说明：Air6205 作为 Wi-Fi 模组，不提供像 Air780EPM 那样的二次开发能力，因此无法把业务脚本直接跑在模组内实现串口转 Wi-Fi。
替代思路：① 需要串口转 Wi-Fi 透传时，选用官方明确支持二次开发的联网型号，在其上编写 Lua 脚本；② 也可以在主控 MCU 侧通过 AT 指令驱动 Wi-Fi 模组，把业务逻辑放在 MCU 中；③ 选型前先按“开发方式”确认型号能力，再决定方案。
参考文档：https://docs.openluat.com/
44. Air8781 G4核心板的电路图/PCB文件在哪里？
解答： 结论：可在官方的资料文件中下载查看，也可以直接问 ai.luatos.com 获取准确的资料入口。
说明：核心板的电路图与 PCB 文件按版本发布，文件名中带有版本与日期信息，下载时请核对是否与你手上的板子版本一致。
操作要点：① 打开对应资料文件页面，确认版本号与板卡丝印版本匹配；② 若在站内找不到入口，把具体型号与板卡丝印发给 ai.luatos.com 咨询；③ 使用参考设计时，仍建议按硬件手册核对供电、天线与下载电路。
参考文档：https://docs.openluat.com/air8780/luatos/hardware/module/circuit/file/Air8780_V4_20260712_1530.pdf
45. Air8602大屏方案能支持多少分辨率、什么视频格式？能否驱动1366*768的LVGL屏？
解答： 尚未解答
46. mqttc:publish发送数据后DTU卡死（数据为JSON格式，想做MQTT透传）是什么原因？
解答： 结论：建议先在官方 mqtt 原始 demo 的基础上，用 AI 修改少量代码来测试，逐步逼近你自己的业务逻辑，从而定位是哪一步改动引起卡死。
说明：在原始 demo 上能跑、改完就卡死，说明问题出在改动的那部分（例如 JSON 组包、发送时机、是否在回调里做耗时操作等）。用“最小改动”的方式复现，是最容易锁定可疑代码的做法。
操作要点：① 先跑通官方 mqtt demo，确认 MQTT 链路本身正常；② 一次只改一处（先换成你的 JSON 内容、再换主题、再改发送节奏），每改一步测一次；③ 注意不要在回调里做阻塞操作，发送要配合长连接状态判断；④ 卡死时保留串口日志与最小复现脚本，便于进一步定位。
参考文档：https://docs.openluat.com/
47. 在模组上采集40个蓝牙设备、数据无损采集回来，有开源项目推荐吗？
解答： 结论：可以用 BLE Mesh。
说明：传统 GATT 连接模式下，单一主机同时维持 40 个连接会非常吃力，连接数、时序与稳定性都难以保证；BLE Mesh 采用广播式组网，天然适合多节点、弱实时、追求数据完整性的采集场景，节点数量扩展性也更好。
操作要点：① 设备侧统一采用 BLE Mesh 方案并完成入网配置；② 采集侧作为 Mesh 节点/网关接收上报，按需做去重与序号校验以保证“无损”；③ 40 个节点建议分批上报、控制单包长度，避免空口拥塞；④ 若设备不支持 Mesh，需要在项目前期就确认，避免后期改方案。
参考文档：https://docs.openluat.com/
48. Air8202的充电如何判断充满、电量显示跳变怎样解决？
解答： 结论：根因是充电 IC 的配置问题，导致放电电流偏大时发热断充、电池电量识别有误；官方已提供新固件，升级后可以改善，后续还会继续优化。
说明：充电是否充满由充电 IC 按设定的充电电压与截止电流判定；电量百分比则由 VBAT 电压估算。配置不当会同时影响这两件事，表现为“没充满就断”和“百分比乱跳”。
操作要点：① 升级到官方提供的新固件；② 检查整机放电电流是否偏大，必要时优化外设功耗与散热；③ 升级后仍复现时记录现象与复现条件，反馈给官方继续优化。
参考文档：https://docs.openluat.com/
49. Air8202G刷固件需要AirBurnUSB吗？需要关掉Luatools吗？
解答： 结论：不需要 AirBurnUSB，用 USB 数据线加 Win10 以上系统即可；也不需要关闭 Luatools。
说明：在支持的 Windows 版本下，通过 USB 即可完成烧录，无需额外的专用烧录工具；Luatools 本身就是烧录工具，保持打开即可，不用先关闭再操作。
操作要点：① 准备确认能传数据的 USB 线，系统使用 Win10 及以上；② 保持 Luatools 打开，按正常流程选择固件与脚本下载；③ 首次烧录记得底层 core 与脚本一起下载；④ 若无法识别，再按下载排查流程检查线材、供电与 BOOT 进入方式。