常见问题 - 2026-08-24

数据日期：2026-08-24

1. 3V水表电池供电、按键触发上报、4G cat1模组(air780epm)、心跳包等需求有没有成熟的批量案例？

解答： 水表这类电池供电场景的成熟做法是采用"PSM+深度休眠+按键/休眠定时器唤醒上报"的方案，合宙官方低功耗demo已被大量批量项目采用，可直接在其基础上按业务修改。实现要点：①用 pm.power(pm.WORK_MODE, 3) 进入PSM+模式，该模式下CPU停止、RAM掉电，待机功耗为微安级，支持唤醒管脚和休眠定时器（pm.dtimerStart）唤醒，唤醒后脚本从头执行；②按键唤醒用 pm.wakeupPin(gpio, level) 配置唤醒管脚，按下触发开机上报，上报完成后再次进入PSM+；③心跳周期用休眠定时器定时唤醒联网上报，注意PSM+下定时器唤醒后会重启脚本，需在开机时通过 pm.lastReson() 判断唤醒原因再决定是否联网；④3V电池供电要注意电压域配置和峰值电流，电源选型、天线、静态功耗实测数据可参考《4G低功耗指南》https://docs.openluat.com/common/airpower/ ，完整低功耗demo见LuatOS仓库各产品目录下的 demo/lowpower：https://gitee.com/openLuat/LuatOS/tree/master/module 。

2. Air780E的17和18号引脚用来做IO输出上电会有一段高电平，这个如何消除？

解答： 该高电平是模组上电启动阶段UART1（主串口）固定输出开机日志导致的，软件无法关闭这段启动打印。处理方法：①若这两个引脚在您的产品上只做普通GPIO用，建议在硬件上对该引脚加下拉电阻把启动期间的高电平钳位到无效电平，下拉阻值一般取10KΩ，若后级负载较重或高电平仍有影响可加强到4.7KΩ；②新项目建议直接选用Air780EPM，其引脚资源和启动行为更合理，可规避该问题。加下拉后请实测确认启动打印不会影响后级电路逻辑。

3. Air8000的TTS音色只有现在这5种吗？女声没之前的Air724好听

解答： Air8000当前固件内置的TTS引擎只提供固定的几种音色，音色数量和效果由固件集成的TTS算法库决定，脚本侧无法自行添加或替换音色。Air724与Air8000采用的是不同代的TTS方案，音色风格存在差异属于正常现象。若对音色/音质有更高要求，可关注后续固件版本更新，或改用预录制语音文件（audio/audio_v2库播放）替代TTS合成，真人录音的音质和自然度会明显优于TTS。TTS与音频播放相关说明见 https://docs.openluat.com/osapi/core/audio/ 。

4. 语音文件烧录到脚本可以正常用，但烧录到文件系统一直不成功是怎么回事？

解答： 烧录到"脚本区"和烧录到"文件系统区"是两个不同的存储分区，文件系统烧录失败通常是以下原因，请按顺序排查：①文件总大小超过了该固件文件系统分区的剩余空间——不同型号固件的文件系统分区容量不同（精简固件尤其小），请先确认语音文件总字节数是否超限，超限需换用文件系统分区更大的固件或精简文件；②LuaTools下载选项中文件系统资源未正确勾选/路径有误，资源文件要放在"脚本和资源"管理中并确认烧录时勾选了"下载到文件系统"；③工程路径或文件名含中文、空格、特殊字符会导致烧录异常，请把整个工程放到纯英文路径下，文件名用英文；④个别固件版本对文件系统支持有差异，请升级到最新正式版固件后重试；⑤烧录后在代码里用 io.exists("/xxx.amr") 或列目录方式确认文件是否真正写入。文件系统操作说明见 https://docs.openluat.com/osapi/core/io/ ，烧录工具使用见 https://docs.openluat.com/common/Luatools/ 。若以上都正常仍失败，请提供LuaTools完整烧录日志和固件型号进一步定位。

5. 780EPM升级固件后（V2048）提示SIM卡被拒绝，换回V2008就正常，是什么问题？

解答： 这类"升级固件后SIM注册被拒、降回旧固件正常"的现象，需要先区分是业务脚本问题还是固件/卡兼容性问题。排查步骤：①先烧录最小工程（脚本里只保留 sys.run()，或用官方网络demo）测试能否正常注网，目的是排除您自己的业务逻辑（如开机时序、SIM/网络相关操作）在新固件上引发的异常；②若最小工程仍被拒，说明与业务无关，重点排查卡与固件的兼容性——确认用的是普通卡还是贴片卡/物联卡，贴片卡请检查卡座焊接和SIM引脚（SIM_VDD/SIM_DATA/SIM_CLK）走线，物联卡请确认已开通短信/数据及对应运营商；③对比两个固件版本的更新说明确认是否有SIM/协议栈相关改动；④抓取开机到注网全过程的串口日志（关注SIM卡识别、+CME ERROR、注册状态）。固件版本更新记录见 https://gitee.com/openLuat/LuatOS/releases 。若最小工程+换普通手机卡仍复现，请带日志反馈官方技术支持。

6. Air780EPM贴片卡同一个板子V2008固件正常，V2048固件出现注册被拒绝/无法联网，怎么解决？

解答： 同一块板子、同一张贴片卡，仅固件版本不同就表现不同，说明问题集中在固件与贴片卡/协议栈的适配上。排查步骤：①烧录最小工程（仅 sys.run() 或官方网络demo）在V2048上测试，先排除业务脚本影响；②贴片卡请重点检查SIM相关引脚的焊接与走线（SIM_VDD供电、SIM_DATA数据、SIM_CLK时钟、SIM_RST复位），新固件对SIM时序/供电更敏感时，虚焊或走线阻抗问题容易暴露，可在同板换一张普通插拔卡对比验证；③确认贴片卡（eSIM/物联卡）已在运营商侧开通且未机卡绑定限制；④抓取V2048下开机注网完整日志，对比V2008下SIM识别和注册流程的差异。固件更新记录见 https://gitee.com/openLuat/LuatOS/releases 。若最小工程、换普通卡仍复现，请带两版对比日志联系官方技术支持定位。

7. 780EPM的106固件用电信卡发送短信失败，移动卡正常，是否支持电信短信？

解答： 移动/联通卡的短信功能在全网通4G模组上默认支持，但电信卡的SMS短信与CC（VoLTE通话）核心库是伴生关系——只有固件中包含CC（VoLTE通话）库时才支持电信卡短信。因此106号固件移动卡正常、电信卡失败，基本可以确定是该固件未包含CC库。解决办法：更换为同时支持CC（VoLTE）的固件版本，再用 sms.send 发送；发送前建议等待 SMS_READY 消息确认短信模块就绪。短信库说明（含电信卡需VoLTE固件、编码与收发接口）见 https://docs.openluat.com/osapi/core/sms/ 。

8. 8783设备给不同卡发短信长度有限制吗？电信卡A收到短信后转给电信卡B正常，发给移动卡C短内容能收到，长内容失败

解答： 短信单条长度有限制：单条短信最大140字节，纯英文/数字按1字节、中文按2字节计算；超出长度即为"长短信"，需要拆成多条分段发送并在接收端合并。您遇到的"短内容移动卡能收、长内容失败"，原因就是长短信依赖多条分段的拼接（UDH头），而转发链路中某一环节没有正确处理分段：①发送长短信应使用 sms.sendLong(phone, msg) 接口（或开启 sms.autoLong 自动长短信模式），而不是用 sms.send 直接发超长内容；②接收端长短信必须等所有片段收齐才会回调一次（SMS_INC），若您是"收到A的短信再转发给C"，要确认转发前拿到的是合并后的完整内容，而非单段；③不同运营商/卡对长短信分段数和拼接头的支持存在差异，跨运营商转发（电信→移动）时尤其容易出现部分片段丢失导致合并失败。建议统一改用 sms.sendLong 发送，并订阅 SMS_SENT 查看每段提交结果（error_code非0即网络/SIM故障）。短信收发与长短信接口见 https://docs.openluat.com/osapi/core/sms/ 。

9. Air724 AT固件最小支持多大的SD卡？

解答： 驱动代码对SD卡容量没有设置最低限制，理论上标准SD/MMC协议支持的卡都能识别，小容量卡（如1G）本身在支持范围内。实际能否识别还取决于卡本身是否为标准规格、卡座接触是否良好以及供电是否稳定。建议用实际卡插上验证：若不识别，优先更换卡、清洁/重新插拔卡座、检查供电，并通过AT交互日志确认SD初始化结果。

10. Air724UG HOST串口打印波特率要改成2M吗？

解答： 调试和抓日志阶段建议优先使用USB口查看打印输出，不建议使用HOST串口，这样最稳定、无需额外配置波特率。若确需使用HOST串口，再按该串口支持的波特率配置即可；当前阶段用USB是最省事可靠的方式。

11. Air780EHM在使用RNDIS共享网络给PC的时候，怎么才能在LuatOS里访问PC的HTTP服务？

解答： 可以访问。RNDIS模式下模组相当于一个USB虚拟网卡/网关，模组自身地址通常为192.168.10.1，PC通过DHCP获得一个同网段地址（如192.168.10.x），两者在同一局域网，模组可主动访问PC。操作要点：①先在PC端确认RNDIS网卡被分到的IP地址（Windows下在"网络连接"里查看该USB网卡的IPv4地址，例如192.168.10.100）；②PC上的HTTP服务必须监听在0.0.0.0或该RNDIS网卡IP上（不能只监听127.0.0.1，否则外部访问不到），并放行Windows防火墙对应端口；③在模组Lua代码里把socket/http请求的目标地址填PC的RNDIS网卡IP和端口，例如 http.request("GET", "http://192.168.10.100:8080/...")；④发起请求时确认使用的是RNDIS这块网卡适配器（socket.USB），必要时用 socket.adapter()/netdrv相关接口指定。网卡适配器常量（含 socket.USB RNDIS网卡）见 https://docs.openluat.com/osapi/core/netdrv/ ，多网卡路由可参考 https://docs.openluat.com/osapi/ext/exnetif/ 。

12. 如何关闭+CGEV主动上报？

解答： +CGEV是3GPP协议规定的网络状态事件主动上报（如注网、去附着、PDP激活等），属于底层协议栈行为，LuatOS脚本侧不提供关闭开关，也不建议关闭——它本身不影响业务，还能帮助判断网络状态。若您是在做AT透传/不希望这些URC干扰主控解析，可在单片机侧对串口接收数据做过滤，忽略以 +CGEV 开头的URC行即可；在LuatOS二次开发模式下这些信息走日志/消息机制，不会进入您的业务数据。

13. 模组上电开机后Luatools显示+CGEV：NW DETACH，是什么故障？

解答： +CGEV: NW DETACH 是3GPP协议栈上报的"网络侧去附着"事件，表示模组曾被网络注册后又被网络侧分离（或注网过程中短暂出现去附着再重新附着）。开机瞬间出现一次后又自动重新注册成功、能正常上网，属于网络交互过程中的正常现象，不是硬件故障；若反复出现DETACH且一直无法注网，则需排查：①SIM卡是否欠费/未开通数据/被运营商限制；②当地信号是否过弱、天线是否接好；③APN配置是否正确（专网/物联卡尤其要注意）；④固件版本协议栈问题，可升级到最新正式版固件对比。建议结合完整开机注网日志看后续是否出现 IP READY / 注册成功，以此判断是否真的异常。

14. 为什么GNSS电源的查询命令AT+CGNSPWR?和电源开启命令AT+CGNSPWR=1都返回+CME ERROR: 3？

解答： +CME ERROR: 3 表示"operation not allowed/该操作不被允许"，通常说明当前固件/产品不支持这条AT指令，或GNSS功能在当前状态下不可用。排查要点：①确认您所用型号固件是否支持GNSS及对应AT指令集——LuatOS二次开发固件主要用Lua API（如GNSS相关库）控制定位，AT指令集可能与标准文档不同，部分GNSS AT指令在LuatOS固件下并不开放；②确认指令拼写与格式正确（查询应为 AT+CGNSPWR? ，注意问号前无空格）；③若产品本身不带GNSS硬件（或GNSS电源脚未使能），该指令也会报错；④直接用串口工具手动发送指令，抓取完整AT交互日志确认模组返回。建议在LuatOS开发中改用对应的GNSS库接口控制，而非AT指令；具体型号支持的GNSS用法见官方文档对应产品页 https://docs.openluat.com/ 。

15. Air780E的uart2可以消除上电高电平吗？

解答： UART引脚在上电启动阶段可能出现短暂的电平跳变（高电平），这是引脚初始化前的默认状态，软件无法在开机前干预。若该跳变会影响后级电路，可在硬件上对相关引脚加下拉电阻，把启动期间的电平钳位到无效状态：下拉阻值一般取10KΩ，若后级输入阻抗较高、高电平仍有影响，可加强到4.7KΩ。加完下拉后请用示波器实测上电瞬间波形，确认后级电路不会误触发。

16. 780EHU有透传的AT固件吗？用另一个单片机和780EHU模块通讯需要用哪个固件？

解答： Air780EHU不提供传统AT指令固件，不支持AT指令方式开发。用外接MCU与780EHU通讯有两种方式可选：①使用iRTU透传固件——模组做成串口透传，MCU通过串口即可收发数据，无需写模组侧代码，适合只想做数据透传的场景；②使用LuatOS固件做二次开发——在模组上用Lua实现业务逻辑，通过串口与MCU自定义协议通信。如果您的主控是单片机且希望简单透传，选iRTU固件；如果需要模组侧承担更多逻辑，选LuatOS二次开发。各固件在LuaTools资源下载中按型号获取。

17. 网上买的780EHU模组更换到780EPM的EVK上，接入PC后会自动识别到串口吗？

解答： Air780EHU与Air780EPM并非完全pin to pin兼容，不能直接把780EHU贴到780EPM的EVK上就保证正常工作：部分引脚定义、USB/串口引脚位置和外设分配存在差异，可能导致USB枚举不到串口或功能异常。建议：①先对照两款模组的硬件手册（引脚定义表）逐一核对USB（USB_D+/D-）、电源、开机脚等关键引脚是否一致；②确认EVK上USB走线连接的引脚在780EHU上确实是USB功能脚；③以官方硬件资料为准，不要假设引脚完全对应。两款模组的硬件手册可在 https://docs.openluat.com/ 对应产品页下载。

18. 下载代码时提示按boot键，没找到boot键在哪？

解答： 部分核心板/模组没有独立引出BOOT按键，需要用镊子等工具短接板上标注为BOOT的两个焊盘（或BOOT测试点）来进入下载模式。操作方法：用镊子短住BOOT焊盘不放，再按一下RESET键（或长按开机键/PWRKEY）让模组复位，维持短接片刻直到LuaTools识别到下载口后再松开镊子。具体BOOT焊盘位置请参照对应开发板/核心板的硬件手册丝印说明，烧录排查指引见 https://docs.openluat.com/common/howtodown/ 。

19. 天线装不上去，官网买的天线是ipex1但座子好像不匹配

解答： 天线座子要与模组/开发板上实际焊接的射频座代次匹配。合宙部分产品使用的是体积更小的IPEX 4代（U.FL兼容的第4代）座子，若您买的是IPEX 1代天线接头，会因接头尺寸不同而扣不上去。处理建议：①先查看所购模组/开发板硬件手册中"天线"章节，确认射频座具体型号（不同产品可能采用IPEX 1代或4代，以对应产品手册为准）；②按手册标注的代次购买匹配的天线或转接线，必要时用IPEX转接线转接。请以您手头具体产品的硬件手册为准核对，天线相关说明见对应产品文档 https://docs.openluat.com/ 。

20. 如何在VSCode中安装luatos-docs与luatos-code MCP服务？

解答： luatos-docs与luatos-code是合宙提供的两个MCP服务，推荐通过LuatOS官方开发插件接入：请将LuatOS开发插件更新到3.4.7及以上版本，插件会自动配置这两个MCP服务（luatos-docs对接合宙文档库、luatos-code对接合宙代码仓库）。若插件识别不到MCP，请检查：①登录账户——企业版账户可能无法正常识别，切换为个人账户登录后即可；②插件版本是否为最新；③MCP开关是否已在设置中开启。官方推荐的完整使用方式（Trae中的luatos-docs-code智能体安装与配置）见 https://docs.openluat.com/ai/trae%2Bluatos-docs-code/manage/ 。

21. 使用RNDIS+NAT情况下主机能够通过192.168.10.1的RNDIS网关IP访问模块提供的服务吗？

解答： 可以。RNDIS+NAT场景下，模组作为网关，其RNDIS网卡地址为192.168.10.1，主机（PC）通过DHCP获得同网段地址并以192.168.10.1作为网关。此时主机访问模组自身提供的服务，直接访问192.168.10.1上的对应端口即可，例如模组用httpsrv起了HTTP服务，主机浏览器访问 http://192.168.10.1:端口/ 就能打开。要点：①模组侧服务要监听在0.0.0.0（或RNDIS网卡）上，不能只绑定到4G网卡地址；②主机请求目标填192.168.10.1而非127.0.0.1；③模组防火墙/端口未做限制。NAT（netdrv.napt）主要负责把主机流量转发到4G出口，不影响主机访问网关自身。HTTP服务器用法见 https://docs.openluat.com/osapi/core/httpsrv/ ，网卡与NAT见 https://docs.openluat.com/osapi/core/netdrv/ 。

22. Air8000的模块没有办法通过RNDIS提供HTTP服务吗？

解答： 可以通过USB RNDIS虚拟网卡对外提供HTTP服务，思路与其他模组一致：RNDIS枚举后模组作为USB网关拥有固定网关地址，主机获得同网段IP，模组在该网卡上用httpsrv（或socket监听）起HTTP服务，主机即可访问模组IP上的HTTP端口。需要注意：①Air8000为多芯片架构（4G主芯片+WiFi协处理芯片），USB/RNDIS与网络出口涉及多网融合，需确认RNDIS网卡适配器（socket.USB）与默认网卡的路由关系；②服务监听地址要绑到RNDIS网卡/0.0.0.0；③多网卡场景建议用exnetif/netdrv管理适配器与路由。请以Air8000对应固件下的官方RNDIS/netdrv demo实测为准，netdrv网卡管理见 https://docs.openluat.com/osapi/core/netdrv/ ，多网融合见 https://docs.openluat.com/osapi/ext/exnetif/ ，HTTP服务器见 https://docs.openluat.com/osapi/core/httpsrv/ 。若实测不通，请提供固件版本号和网络拓扑，官方可协助确认该固件的RNDIS支持情况。

23. 想找一款价格更低的合宙官方成品板替代Air780EGG全功能开发板，要求支持LuatOS、4G Cat.1、GNSS定位、MQTT/MQTTS、带SIM卡座、USB下载调试接口、4G和GNSS外接天线座、I²C接口、支持5V VIN和通电自动开机

解答： 这属于"4G+定位二合一"选型需求，应在合宙官方选型指南的"2.4 需要4G+定位二合一的模组"章节中筛选满足条件的型号（来源：https://docs.openluat.com/SelectionGuide/SelectionGuide/ ）。选型方法：①您列出的功能（LuatOS、4G Cat.1、GNSS、MQTT/MQTTS、SIM卡座、USB下载、4G+GNSS天线座、I²C、5V VIN、通电自启动）中，LuatOS/MQTT/I²C/USB等为软件通用能力，只要选支持LuatOS的4G+GNSS模组即可满足，关键是硬件形态（成品板/核心板）是否引出所需接口与天线座、是否支持5V VIN供电和上电自动开机；②建议在该章节列出的4G+定位模组（如Air780EPM带GNSS的定位版本系列）中，选择官方核心板/成品板，再对照其硬件手册确认是否带SIM卡座、双天线座、5V VIN和自动开机电路；③具体在售板卡的价格与接口配置以合宙淘宝店（https://luat.taobao.com/ ）和对应产品硬件手册为准。建议把上述需求清单提供给合宙官方销售/技术支持，由其按选型指南推荐一款成本更低且接口齐备的成品板，避免仅凭开发板型号推断。

24. 为什么我的板子插卡就反复重启，不插卡就没问题？

解答： 原因是您的板子上接了外部硬件看门狗芯片Air153C，它默认开启、需要主控定时喂狗，超时未喂狗就会强制复位模组。插卡后模组会去注网、联网，这一段耗时较长（可能数秒到十几秒），如果您的业务逻辑在注网/联网阻塞期间没有定时喂狗，看门狗超时就会复位，表现为"插卡反复重启"；不插卡时模组很快进入无网状态、程序按您的逻辑循环喂狗，所以不重启。解决办法：参考 air153C_wtd 扩展库，用GPIO脉冲定时喂狗（Air153C超时默认240秒且不可改），把喂狗放在独立的定时器循环任务中，确保注网、socket阻塞等任何流程下都不会停止喂狗。看门狗统一说明见 https://docs.openluat.com/common/watchdog/ ，Air153C扩展库见 https://docs.openluat.com/osapi/ext/air153C_wtd/ 。

25. 看门狗是默认开启的吗？不需要用户操作就自动开启了吗？

解答： 要区分两类看门狗：①模组内部硬件看门狗——位于芯片Always-On电源域，开机后由LuatOS内核固件自动开启、自动定时喂狗，用户脚本可以不干预，无需手动开启；②外部硬件看门狗芯片（如您板上的Air153C）——它是独立芯片，上电后即开始工作，需要主控通过GPIO定时输出脉冲喂狗，Air153C超时固定为240秒且不可修改，超时未喂狗就会复位模组。因此如果您板子上焊了Air153C，就必须在脚本里按 air153C_wtd 扩展库的方式定时喂狗，与内部看门狗是否自动开启无关。看门狗分类与各系列差异见 https://docs.openluat.com/common/watchdog/ 。

26. 同样的程序uart1可以但uart3无法发送接收数据，如何检查？另外重新下载固件时无法删除之前下载的lua脚本怎么办？

解答： 两个问题分别说明：

（1）UART3不通而UART1正常：UART1是主串口（默认下载/日志口），UART3需要正确配置引脚复用才能收发。请检查：①调用 uart.setup(UART_ID, baud, data_bits, stop_bits, parity) 时传入的串口号是否为UART3对应的ID，TX/RX引脚是否通过 uart.setup 或pins复用配置到了正确的物理引脚；②确认这两个引脚没有被其他功能（GPIO/I2C等）占用，引脚电压域是否与外设匹配；③TX/RX是否接反、共地是否良好、波特率是否一致；④用示波器/逻辑分析仪看UART3的TX脚有无波形输出。串口库用法见 https://docs.openluat.com/osapi/core/uart/ ，引脚复用见 https://docs.openluat.com/osapi/core/pins/ 。

（2）旧脚本删不掉：LuatOS重新下载脚本时会整体覆盖脚本区，正常情况下烧录新脚本后旧脚本即被替换，不会残留冲突。若发现旧逻辑仍在运行，通常是新脚本实际没有烧写成功（下载报错、未勾选脚本、路径含中文等）。请在LuaTools里确认下载日志提示成功、勾选了正确的脚本文件，必要时在下载选项里选择"清除脚本区/格式化"后再重新烧录；工程路径务必用纯英文。烧录排查见 https://docs.openluat.com/common/howtodown/ 。

27. 如何清除Air780EPM上的所有程序？重新下载固件无法删除之前下载的lua脚本

解答： LuatOS的脚本区在重新烧录时会被整体覆盖，正常下载新脚本后旧脚本不会残留。若您感觉旧脚本还在运行，基本可以确定是新脚本没有真正烧写成功。请按以下方式彻底清空并重烧：①在LuaTools中勾选/选择"清除脚本区"（或格式化文件系统）选项后再下载；②确认下载日志明确提示成功，且下载前正确选择了模组型号和固件；③确认要烧的脚本文件已加入下载列表并勾选，工程路径为纯英文、无特殊字符；④如仍异常，可先重新烧录一次底层固件（.soc固件包）再下载脚本。完成后可用一个简单点灯/打印工程验证旧逻辑已不存在。烧录故障排查见 https://docs.openluat.com/common/howtodown/ 。

28. 开发板外部供电需要两个地方都接电吗？

解答： 外部供电时只需从开发板指定的外部供电接口（通常标注为4V/VIN输入处）接入一路电源即可，不需要USB和外部电源同时接。接上外部电源后，请将板上的供电切换开关拨到"外部供电"档位（打开外部供电开关），开发板才会由外部电源供电。具体供电接口位置、电压范围和开关操作请以对应开发板使用手册为准，手册可在 https://docs.openluat.com/ 对应产品页下载。

29. 插USB时485通信正常，外部供电就发不出去了，是什么问题？

解答： "USB正常、外部供电时485发不出去"通常是供电方式/电源域问题，而非485程序问题（同一套程序USB下已正常）。排查要点：①确认外部供电只从指定供电接口（4V/VIN处）接入了一路，且已把板上供电切换开关拨到"外部供电"档位，避免USB与外部电源冲突或供电未真正切到外部；②测量外部供电电压是否在手册要求范围内、电流是否足够（485发送时瞬时电流较大，电源带载能力不足会导致发送失败）；③确认485收发器的供电和方向控制脚在外部供电模式下电平正常；④检查共地是否良好。开发板供电与485电路说明见对应开发板使用手册 https://docs.openluat.com/ 。

30. 使用LuatOS-SoC_V2016_Air780EPM_103固件，同程序uart1可以uart3不行，是否和固件有关？

解答： 同一套程序UART1正常、UART3不通，绝大多数情况是UART3的引脚复用/配置问题，而非固件问题（UART外设功能在各固件间是通用的）。排查要点：①确认 uart.setup 使用的串口ID与物理引脚对应正确，并通过pins/uart配置把TX、RX复用到了UART3的实际引脚；②确认这两个引脚没有被GPIO、I2C等其他功能占用，也没有被下载/日志口占用；③核对波特率、数据位、停止位、校验位与外设一致，TX/RX接线是否交叉、是否共地；④用示波器看UART3的TX引脚发送时有无波形；⑤工程路径不要含中文/特殊字符，避免资源加载异常。若确认引脚配置无误仍不通，可升级到更新的正式版固件对比验证。串口用法见 https://docs.openluat.com/osapi/core/uart/ ，引脚复用见 https://docs.openluat.com/osapi/core/pins/ 。

31. 固件升级已指定IMEI+允许升级状态，为啥设备请求还会报错：设备不在升级列表中？

解答： 出现"设备不在升级列表中"，最常见原因是同一个设备（IMEI）被两个不同的升级固件同时指定，并且这两个固件的"允许升级"开关都处于打开状态。设备请求升级时无法判断该升级到哪一个固件，平台就会判定不在有效升级列表中。处理方法：同一个设备即使被多个固件指定，也只能有一个固件打开"允许升级"开关——请保留目标固件的升级开关为开启，把另一个固件的升级开关关闭（或将该设备从另一个固件的升级列表中移除），再让设备重新请求升级即可。配置设备归属与升级可参考合宙IoT平台相关说明。

32. 怎么把一个设备从一个项目转移到另一个项目？在代码里把PRODUCT_KEY改成新项目但设备没有变到新项目里

解答： 仅在代码里修改PRODUCT_KEY并不会把设备在IoT平台上的归属自动转移过去，设备的项目归属是平台侧按IMEI维护的。正确的转移方法是在IoT平台上手动操作：①在目标（新）项目下添加该设备的IMEI；②在原（老）项目下把该IMEI删除；③设备端PRODUCT_KEY配置为新项目的key并重启上线。设备归属到自己账号/项目的操作说明见 https://docs.openluat.com/air780epm/product/attributioniot/ 。若操作后仍未生效，请确认新旧项目都在同一账号名下、IMEI输入无误，并参考平台的设备转移文档。

33. 固件升级已指定IMEI并允许升级，为什么有的设备报设备不在升级列表中？

解答： 该设备大概率被两个不同的升级固件同时指定，且两个固件的"允许升级"开关都打开了，导致设备请求升级时无法确定目标固件，平台返回"设备不在升级列表中"。请检查所有固件版本的升级配置，确保同一IMEI在同一时刻只有一个固件打开"允许升级"开关，其余固件将该设备移出升级列表或关闭升级开关，然后让设备重新请求即可。

34. 795模块二次开发用新的luatool工具加载默认库提示没有log.lua库，怎么办？

解答： Air795属于较早的平台，使用的是老的LuaTask库体系，新版LuaTools默认加载的是LuatOS（SoC）库，里面没有老平台所需的log.lua等文件，因此会提示缺少库。解决方法：在LuaTools的"资源下载"中选择724对应的资源分类，其中包含老的LuaTask库，下载后解压，把其中的库文件（含log.lua）添加到您的工程目录中一起烧录即可。注意老平台与LuatOS的API体系不同，请使用与795配套的LuaTask例程作为工程模板。

35. wsc:send(data, fin, opt) 这个API文档只有2个参数，代码实例把opt直接写到了fin参数上，是文档错了还是什么？

解答： 文档没有错，wsc:send(data, fin, opt) 就是三个参数，请以官方文档的函数签名为准。三个参数含义：①data为要发送的数据（字符串）；②fin是WebSocket协议规定的FIN标志位（number类型），1表示本次发送是最后一个数据包（一帧完整消息），0表示消息分片发送、后续还有数据包；③opt是可选参数表（一般传nil即可）。需要分片发送较长消息时，中间帧fin传0、最后一帧fin传1；普通整包发送时fin固定传1。若demo中出现把opt写在fin位置的写法，属于示例代码问题，开发时按文档签名 wsc:send(data, 1, nil)（整包发送）调用即可。官方接口说明见 https://docs.openluat.com/osapi/core/websocket/ 的4.6节。

36. Air153D芯片是否兼容老的Air153C用法？

解答： Air153D与Air153C本质上是同一颗硬件芯片（SOT23-6封装），喂狗/复位接线方式一致，软件侧请统一使用官方 exair153x_wdt 扩展库（同时兼容C/D，初始化 exair153x_wdt.init({wdt_pin=引脚号}) 后库内自动周期喂狗，也可用 feed() 手动补喂狗）。两者的关键差异在硬件配置脚：Air153C的PIN1/PIN6为NC（固定悬空）、超时固定约4分钟不可改；Air153D的PIN1（STRAP1）、PIN6（STRAP6）是超时档位配置脚，必须在硬件上给出确定的上拉或下拉，不能随意悬空，共4档：①两脚均高/悬空=4分钟；②STRAP1低、STRAP6高=90分钟；③STRAP1高、STRAP6低=13小时；④两脚均低=26小时（对应喂狗周期分别为200秒、1小时、12小时、24小时）。因此老板卡若把这两个脚悬空使用，Air153D会工作在4分钟默认档，且悬空电平不确定时存在档位漂移风险，设计上必须按所需超时档位做明确上拉/下拉。详细差异表与示例见 https://docs.openluat.com/osapi/ext/exair153x_wdt/ 。

37. 795UG没有自适应时区功能，780E系列是不是也会有这个问题？

解答： 780E系列（Air780EPM等）的RTC底层存的是UTC（0时区）时间，rtc.set()/rtc.get() 读写的都是UTC时间，不会自动换算成北京时间，时区需要业务代码显式设置，这一点和795UG的情况一致。正确做法：①网络对时优先用NTP（socket.sntp()，也可使用基站同步 mobile.syncTime()），NTP成功后不要再调用 rtc.set，直接用 os.date() 即可获取按当前时区换算后的本地时间；②时区用 rtc.timezone(tz) 设置，注意参数单位是"1/4时区"，东八区传32（不是8），例如 rtc.timezone(32)，且必须先设置好时间再设置时区，否则可能读到错误时间；③无网络场景可用 rtc.set({year=...,mon=...,day=...,hour=...,min=...,sec=...}) 手动设置UTC时间后再设时区。RTC与时区接口说明见 https://docs.openluat.com/osapi/core/rtc/ 的1.3节及 rtc.timezone 函数说明。

38. Air780EX2的PWRKEY(pin 7)经1kΩ下拉到GND（上电开机）可以吧？AI说不可以

解答： 不建议用1kΩ电阻把PWRKEY直接、持续地短路到GND。原因：PWRKEY是开机触发脚，模组上电检测到PWRKEY被拉低一段时间会开机，这一思路本身可行；但PWRKEY保持长时间低电平还对应"长按关机/复位"等行为，若上电后该脚一直被强下拉（1kΩ属强下拉），可能导致模组开机后无法释放开机信号、反复关机复位或开机异常，而且1kΩ直连也会使外接的开机按键失去作用。推荐做法是按官方硬件设计手册中"上电自动开机"章节的参考电路，用RC延时电路实现：上电瞬间由电容把PWRKEY拉低产生开机脉冲，电容充满后PWRKEY经电阻释放回高电平，既保证通电自动开机，又不会长期占用PWRKEY。具体阻容参数和引脚电平请以Air780EX2硬件设计手册为准（手册在 https://docs.openluat.com/ 对应产品页下载）。

39. 图纸评审只有AI建议了吗？

解答： 除AI图纸评审外，合宙也提供人工硬件评审服务：您可以把原理图、PCB设计文件提交给对接的官方技术支持或销售，安排硬件工程师进行人工评审，重点检查电源、SIM、天线、开机、引脚复用、低功耗等关键电路。建议先用AI评审做一轮自检、修改明显问题后，再提交人工评审，效率更高。提交渠道可通过合宙官方企业微信群（https://docs.openluat.com/ 网站底部二维码扫码加入）或联系您的对接销售/FAE。

40. 724模块在合宙官网上无法获取状态也没有办法升级，是什么原因？

解答： 合宙IoT平台（iot.openluat.com）上设备的状态查询、远程升级（FOTA）都是按"设备归属"管理的：只有设备IMEI被添加在您当前登录的账号/项目名下，才能看到在线状态并为其配置升级。查不到设备、无法升级，通常是以下原因：①该批模组是从渠道/采购商处购买，设备IMEI被归属在了采购商或上游客户的IoT账号下，不在您名下；②设备归属在您公司的另一个账号/项目中。解决方法：联系供货给您的采购/渠道，确认设备当前归属的账号，请对方在IoT平台上把对应IMEI转移（在目标账号下添加IMEI、原账号下删除IMEI），或直接向合宙官方提供采购凭证申请归属核实。设备归属与转移操作说明见 https://docs.openluat.com/air780epm/product/attributioniot/ 。

41. 合宙720D模块在乡镇基站升级后4G模块没有网络了，移动让问模块支持哪些频段

解答： 这类"基站升级后模组无网"问题，核心是确认模组支持的频段与当地基站升级后保留的频段是否还有交集。处理步骤：①模组支持的具体4G频段以该型号硬件手册中的"射频频段"参数为准，请在 https://docs.openluat.com/ 对应Air720D产品页下载硬件手册核对（Cat.1模组国内通常覆盖移动/联通/电信主力的B1/B3/B5/B8等频段，具体以手册为准）；②请移动公司提供该乡镇基站升级后实际保留/关闭了哪些频段和制式（是否保留了4G FDD-LTE的B1/B3/B5/B8，是否只保留了模组不支持的频段或TDD频段）；③两者对比，若基站关闭后当地已无模组支持的频段覆盖，只能更换为支持现网频段的新型号模组（合宙在售Cat.1新型号见 https://luat.taobao.com/ 及选型指南 https://docs.openluat.com/SelectionGuide/SelectionGuide/ ）；④若频段仍有交集但无法注网，换一张正常4G卡、换一个信号良好的位置交叉验证，并抓取开机注网日志确认是否注册被拒。

42. Air780EGG有加速度芯片么？

解答： Air780EGG全功能开发板板载有三轴加速度传感器（开发板集成的加速度计通过I²C接口与Air780EPM通信），可直接用于震动检测、姿态唤醒等实验。板载外设的具体型号、连接的I²C总线地址和中断引脚，请以Air780EGG开发板硬件资料/原理图为准，资料可在 https://docs.openluat.com/ 对应Air780EGG产品页下载，或在合宙AI助手（ai.luatos.com）中直接查询"Air780EGG板载外设清单"获取完整列表。使用加速度计时可参考LuatOS传感器扩展库中的对应驱动（如exs_lis2dh12、exs_sc7a20h等）：https://docs.openluat.com/osapi/ext/sensor/ 。

43. 3000片的话还能定制激光镌刻logo么？

解答： 批量采购时支持在模组/核心板表面激光镌刻定制Logo等丝印内容，3000片已属于可商务洽谈的批量范围。激光镌刻属于定制业务，具体是否免费、起订量、镌刻位置与内容要求、交期等需由销售确认，请通过以下渠道直接联系合宙官方商务：①合宙官方淘宝店 https://luat.taobao.com/ 联系客服说明定制需求；②加入合宙官方企业微信群（https://docs.openluat.com/ 网站底部二维码扫码加入）联系销售；③如已有对接的合宙销售/FAE，直接提供您的公司信息、型号、数量（3000片）和镌刻内容（Logo矢量图）即可询价并评估排产。技术文档渠道不处理定制业务，以上述商务回复的报价和交期为准。

44. EHM和EHV只是内部差一个ES8311吗？可以EHM外接ES8311然后烧EHV的固件和SIP例程吗？

解答： Air780EHV是在EHM硬件基础上增加了音频编解码通路（ES8311 codec及麦克风/喇叭外围）的版本，但两款型号的固件是分别按硬件配置发布的，固件对音频通道、GPIO复用的初始化与具体硬件绑定。不建议在EHM上外接ES8311后直接烧EHV固件跑SIP例程，原因：①EHV固件默认操作的是EHV板载音频通路的固定引脚和配置，您自行外接的ES8311接线（I²C控制、I²S/PCM数据、时钟、上电时序）未必与之一致，强行烧录可能音频无声甚至引脚冲突；②即使硬件接通，ES8311的外围电路（MIC偏置、功放、电源去耦）和声学调试也需要自行完成，合宙不对自搭音频硬件提供调试支持；③跨型号刷固件本身存在变砖风险。如项目确有SIP网络通话/音频需求，请直接选用Air780EHV，使用EHV对应的固件和官方 demo/sip 例程开发；SIP通话库（exsip）说明见 https://docs.openluat.com/osapi/ext/exsip/ ，音频播放见 https://docs.openluat.com/osapi/core/audio/ 。

45. ES8311驱动是在你们固件里面吗？SIP的API用EPM可以调用吗？EHM的SIP有例程吗？

解答： 分三点说明：①ES8311的音频驱动已集成在支持audio功能的官方固件中（音频编解码随固件发布，脚本侧直接用audio/exaudio相关接口即可，无需自行移植驱动），但要注意它必须配合板载ES8311硬件通路使用；②SIP通话使用 exsip 扩展库（exsip.init(config) 配置SIP服务器地址、端口、域名、用户名、密码等参数，exsip.start/dial/accept/hangUp 完成通话），该库目前仅支持PCMU/PCMA编码，且通话需要真实的音频采集/播放通路——Air780EPM本身不带音频codec硬件，没有麦克风/喇叭通道，无法实际完成语音通话，SIP通话请选用带音频硬件的Air780EHV；③Air780EHM官方不提供SIP现成例程（EHM无板载音频通路），官方SIP例程在LuatOS仓库各音频型号产品目录下的 demo/sip 中。exsip库说明见 https://docs.openluat.com/osapi/ext/exsip/ ，demo见 https://gitee.com/openLuat/LuatOS/tree/master/module 。

46. 780EHV-SIP通话中SIP和4G之间声音不对，无法将4G侧声音交换到SIP端，有什么方法？

解答： 您描述的是"SIP网络通话与4G电话（VoLTE）两路语音互通/转接"的语音网关场景，需要把4G通话链路的音频流和SIP（RTP）链路的音频流做双向桥接。排查/处理建议：①先升级到Air780EHV最新正式版固件（如V2050及以后版本）并使用最新exsip库和 demo/sip 例程验证，早期版本对SIP↔4G音频桥接的支持不完善；②确认exsip媒体协商正常（当前仅支持PCMU/PCMA编码），并确认SIP侧和4G侧均能单独正常通话，先排除单路音频/麦克风/喇叭通路问题；③SIP↔4G两路音频的桥接属于特定功能，请以官方exsip文档和demo中提供的桥接/转接接口为准（若文档未提供该能力，说明当前版本未开放），不要尝试自行在脚本层混音。若升级最新固件+官方例程后仍复现，请提供：固件版本号、SIP服务器类型、完整通话日志（含SIP注册/INVITE/200OK及4G通话状态）、音频异常的具体现象（单向无声/串音/杂音），联系官方技术支持定位。exsip文档见 https://docs.openluat.com/osapi/ext/exsip/ ，固件版本见 https://gitee.com/openLuat/LuatOS/releases 。

47. 固件只支持ES8311吗？用FP803能弄吗？

解答： LuatOS固件中的音频通路是围绕官方已适配调试的音频codec（Air780EHV等音频型号板载的ES8311）做的集成与验证，脚本侧的audio/exaudio接口默认对接的是这套已适配硬件。FP803这颗codec合宙官方没有做过驱动适配和联调，固件中不包含其驱动，因此不能保证可用。若您坚持使用FP803：①需要自行完成codec的I²C初始化、I²S/PCM数据接口对接和驱动移植调试；②请先在官方开发板/核心板上把音频通路验证通过再设计产品，避免量产风险；③自搭codec方案官方不提供驱动调试支持。为降低项目风险，建议直接选用官方已适配ES8311音频通路的型号（如Air780EHV）。音频接口说明见 https://docs.openluat.com/osapi/core/audio/ 。

48. SIP回声问题有影响吗？AEC回声抑制方案验证好了吗？

解答： 回声是免提通话场景的常见问题：对端声音经本端喇叭播放后又被麦克风拾取回传，会形成回声，影响通话体验；AEC（声学回声消除）方案的效果与固件算法、硬件声学结构（喇叭与麦克风的间距/隔离、腔体漏音、MIC偏置与增益）都相关。建议：①始终使用最新正式版固件和最新exsip库，AEC相关优化会随固件持续更新，历史版本的回声问题在新版中通常已改进；②硬件上按官方音频设计规范布局麦克风和喇叭，控制喇叭音量与MIC增益，避免结构漏音；③以官方 demo/sip 例程为基础开发。若在最新固件+官方开发板上仍有明显回声，请提供设备声学结构说明和通话录音，联系官方技术支持（企业微信群/对接FAE）确认当前AEC版本状态并获取支持。SIP库见 https://docs.openluat.com/osapi/ext/exsip/ 。

49. USB传输音频可以吗？

解答： 取决于您要实现的具体形态：①模组USB口目前支持枚举为虚拟串口（下载/日志/AT）和USB虚拟网卡（RNDIS/ECM，适配器常量 socket.USB），并不支持枚举为标准USB Audio Class设备（即不能被电脑识别成USB声卡/麦克风，直接走USB传输实时音频流）；②如果您的需求是"通过USB把录音文件传到电脑"或"电脑把音频文件下发给模组播放"，可以走RNDIS虚拟网卡：USB连上后模组与电脑处于同一局域网（模组网关地址通常为192.168.10.1），用HTTP/socket在模组与电脑之间传输音频文件，模组侧用audio/exaudio库播放或录音即可，这是官方支持的可行路径；③如果要做实时语音通话，建议直接用4G网络走SIP（exsip库）或自有RTP/VoIP协议传输，而不是依赖USB音频。网卡与RNDIS说明见 https://docs.openluat.com/osapi/core/netdrv/ ，音频播放录音见 https://docs.openluat.com/osapi/core/audio/ 与 https://docs.openluat.com/osapi/ext/exaudio/ 。

50. Air8000+st7796 SPI接口，airui全屏刷新闪屏，是因为缓冲区太小了吗？

解答： 全屏刷新时出现的"画面上下错位/闪屏"现象是显示撕裂（tearing effect），不是缓冲区太小导致的。原因：SPI屏在主控持续刷屏的同时，屏幕内部也在按固定节奏扫描刷新，当主控写入显存的时机与屏幕扫描时序不同步时，一帧画面里新旧两帧数据各占一部分，就会看到水平方向的撕裂带；全屏刷新数据量大、耗时长，撕裂更明显。解决方向：①根本办法是利用屏幕的TE（Tearing Effect）同步信号脚——屏幕在每次垂直消隐（即将开始新一帧扫描）时通过TE脚输出脉冲，主控检测到TE脉冲后再开始刷屏，即可避开扫描过程写入；ST7796本身支持TE输出，需在屏幕初始化时开启TE输出命令，并把TE脚接到模组一个可用GPIO（或支持vsync的接口）；②软件上可降低全屏刷新频率、只刷新变化区域、使用局部刷新，减少同时写入的数据量来减轻现象；③使用LuatOS lcd库提供的TE/vsync同步能力（如 lcd.qspi 的vsync相关参数、硬件加速 lcd.setAcchw）配合显示。显示屏接口说明见 https://docs.openluat.com/osapi/core/lcd/ ，AirUI见 https://docs.openluat.com/osapi/core/airui/ 。

51. SPI屏刷新撕裂感可以通过软件解决吗？

解答： 撕裂无法靠纯软件彻底消除，必须借助屏幕的TE（Tearing Effect）硬件同步信号。原理：屏幕以固定频率逐行扫描刷新，主控只有在屏幕扫描到"垂直消隐区"（两帧之间的间隙）时写入显存，才不会被扫描过程读到半新半旧的数据；如果没有TE脚反馈，主控无法知道当前扫描到哪一行、垂直同步何时到来，软件延时对齐也会随帧率漂移而失效。可行做法：①硬件上把屏幕的TE脚（多数SPI/QSPI屏控制器如ST7796都有TE输出脚）接到模组一个GPIO，并在屏幕初始化命令里使能TE输出；②主控用GPIO中断/电平检测TE信号，在TE有效（垂直消隐）期间执行 lcd.flush() 刷屏；③若使用QSPI屏，可直接用lcd库的 lcd.qspi(...) vsync同步参数由硬件处理同步；④在无TE的前提下，软件只能通过降低刷新帧率、减少全屏刷新、分块刷新来"减轻"撕裂感，但无法根除。因此建议选用引出TE脚的屏幕并在硬件设计时预留TE走线。lcd库接口见 https://docs.openluat.com/osapi/core/lcd/ 。

52. 当前合宙卖的SPI屏支持TE信号吗？

解答： 目前合宙在售的SPI接口屏幕模组/转接板上默认没有把TE（Tearing Effect）信号脚单独引出到排针上，因此开箱即用的SPI屏无法直接拿到TE同步信号。TE信号本身是屏幕控制器（驱动IC）输出的一根普通电平信号，对模组侧没有特殊引脚要求——只要把屏幕驱动IC的TE脚飞线/引出到模组任意一个可用GPIO，并在屏幕初始化命令中使能TE输出，主控即可通过该GPIO检测垂直同步时序。若您的项目对全屏刷新流畅度（无撕裂）要求高，建议：①优先选用合宙已适配、引出TE脚或采用QSPI/RGB接口并支持硬件vsync同步的屏幕方案；②或自行在屏幕模块上把TE脚飞线接到模组GPIO后按TE时序刷屏。具体在售屏幕的引脚定义请以对应屏幕产品资料为准，可在 https://luat.taobao.com/ 咨询或查阅 https://docs.openluat.com/ 对应屏幕文档。

53. Air780EPM有TCP直连的样例吧？

解答： 有官方TCP/UDP通信示例。Air780EPM在LuatOS下做TCP通信有两种方式：①使用socket核心库直接创建TCP客户端，等待 IP_READY 网络就绪消息后连接服务器收发数据；②使用封装好的 libnet 扩展库（libnet/client），接口更简洁。完整可运行的demo在LuatOS仓库对应产品目录的 demo/socket（TCP/UDP基础收发）和 demo/libnet 下，可直接复制修改服务器地址/端口使用：https://gitee.com/openLuat/LuatOS/tree/master/module 。socket核心库说明见 https://docs.openluat.com/osapi/core/socket/ ，libnet见 https://docs.openluat.com/osapi/ext/libnet/ 。开发时注意先等网络就绪（socket.adapter(socket.dft()) 有效或收到IP_READY）再发起连接，并做好断线重连。

54. Air8000开发板以太网热插拔后就连不上网了，按照AI建议也不行，有技术支持吗？

解答： 以太网热插拔后断网，通常是网线重新插入后网口链路状态、DHCP租约或默认路由没有重新恢复导致的。排查步骤：①先烧录官方 netdrv/exnetif 以太网demo（LuatOS仓库对应产品目录 demo/netdrv）在官方开发板上验证热插拔是否正常，以排除自研代码的链路重连逻辑问题——demo中应包含对 netdrv.link(id) 链路状态的检测，断线后要重新等待链路up、重新DHCP获取IP并恢复路由/NAPT；②确认拔插后是否重新执行了DHCP（netdrv.dhcp）和默认网卡/出口配置（多网卡时用 exnetif.set_priority_order 管理），Air8000为多芯片架构（4G+WiFi），以太网与4G/WiFi的路由切换要靠exnetif管理；③抓取从拔网到插网全过程的LuaTools日志，重点看link状态变化、DHCP是否成功、socket.adapter是否恢复。网卡管理见 https://docs.openluat.com/osapi/core/netdrv/ ，多网融合见 https://docs.openluat.com/osapi/ext/exnetif/ 。若官方demo在开发板上同样复现热插拔断网，请提供固件版本号+完整日志联系官方技术支持定位。

55. vscode中的AI插件反应时间很长，怎么优化能快些？

解答： AI响应慢通常是模型侧排队或网络问题，可按以下方式优化：①Trae内置的免费大模型使用人数多、经常排队且性能不可控，这是响应慢的最主要原因——官方推荐订阅收费大模型（文档中提及约每月40元），可显著提升响应速度和稳定性；②模型选择上，代码开发任务优先选GLM，若GLM处理慢再切换MiniMax，其他任务可优先选ark-code-latest、其次MiniMax；③检查网络，关闭代理/VPN后重试，企业版账户可能受限，切换为个人账户登录；④确认luatos-docs-code智能体为最新版本（更新智能体即更新其提示词，版本列表见 https://docs.openluat.com/ai/trae%2Bluatos-docs-code/version/ ）；⑤避开使用高峰时段。智能体安装与模型配置说明见 https://docs.openluat.com/ai/trae%2Bluatos-docs-code/manage/ 。

56. AI打不开/响应慢/504怎么办？

解答： 合宙AI助手（ai.luatos.com）出现打不开、响应慢或504网关错误，多为服务高峰期负载或网络链路问题，请按顺序处理：①刷新网页或稍后重试，高峰时段（工作日白天）排队/超时较多，可错峰使用；②关闭浏览器代理、VPN及公司网络限制后再访问；③不要使用企业版账户登录，切换为个人账户；④清理浏览器缓存或换浏览器/网络环境测试；⑤若长时间（数小时）持续不可用，可在合宙官方企业微信群（https://docs.openluat.com/ 网站底部二维码扫码加入）反馈。此外，Trae中的luatos-docs-code智能体若因内置免费模型排队变慢，可按官方文档订阅收费模型提升稳定性：https://docs.openluat.com/ai/trae%2Bluatos-docs-code/manage/ 。

57. Luatools制作量产固件报错是什么原因？

解答： 制作量产固件（合并固件/量产包）报错，最常见原因是工程路径或文件名不规范，请按以下步骤排查：①把工程放到纯英文、无空格、无特殊字符的路径下（路径中不要含中文、括号"(2)"、空格、&等符号），脚本和资源文件名也用英文；②确认使用的是最新版LuaTools（旧版本量产打包功能可能有缺陷），建议删除旧版本后从官网重新下载最新版；③确认选择的模组型号、底层固件（.soc）与脚本匹配，固件文件完整未损坏；④量产打包涉及的脚本/资源文件不要缺失，工程目录不要被杀毒软件占用或锁定；⑤按提示记录完整报错信息。LuaTools下载与烧录排查见 https://docs.openluat.com/common/Luatools/ 和 https://docs.openluat.com/common/howtodown/ 。若以上均正常仍报错，请提供LuaTools版本号、完整报错截图和日志联系官方技术支持。

58. 2050版本修复了串口问题吗？

解答： 具体修复内容请以V2050版本的官方更新记录（Release Notes）为准，不要参考V2048的更新记录——两者是不同版本，修复项不同。V2050（ec7xx平台）的完整更新日志发布在Gitee官方仓库的Release页面，其中会逐条列出修复的问题（含串口相关）和新增功能，请直接查看：https://gitee.com/openLuat/LuatOS/releases/tag/v2050.ec7xx.release 。若您遇到的是某个特定串口异常（如特定UART口不通、透传丢数），建议升级到V2050正式版后用官方串口demo实测验证；若仍存在，请记录固件版本号、串口号、波特率、现象和完整日志反馈官方技术支持。

59. Air780EGP定位功能的库libgnss内部会调用合宙的服务器下载星历等，这些服务器会保持稳定运行和长期服务吗？

解答： 合宙的AGNSS星历/辅助定位服务器面向合宙正品模组提供长期、稳定的免费服务，使用Air780EGP等合宙模组+官方libgnss库的项目可放心量产使用。需要注意：该服务会校验设备身份，仅对合宙合规模组开放；官方曾发现有非合宙模组/第三方产品盗用该星历服务接口的情况，对此类滥用会关闭其访问权限。因此请确保：①使用正品合宙模组和官方libgnss库；②不要将星历下载接口转提供给非合宙设备使用。GNSS定位库说明见 https://docs.openluat.com/osapi/core/libgnss/ 。

60. 新增109固件支持USB虚拟网卡，Air780EGG是否支持呢？

解答： 支持。USB虚拟网卡（RNDIS）能力是由固件和Air780EPM模组硬件决定的，Air780EGG是基于Air780EPM的全功能开发板，模组与EPM完全相同，因此只要烧录支持USB虚拟网卡的109号固件（V2050及以后的109固件），在EGG上同样具备该功能，与使用独立EPM核心板没有区别。使用要点：①烧录对应109号固件；②代码中通过netdrv初始化USB网卡适配器（socket.USB）并启用RNDIS（必要时配合 netdrv.napt/exnetif 做多网卡路由）；③用USB线连接EGG的USB口与电脑，电脑端会枚举出一块RNDIS虚拟网卡并获取IP（模组网关地址通常为192.168.10.1）。网卡/RNDIS说明见 https://docs.openluat.com/osapi/core/netdrv/ ，多网融合见 https://docs.openluat.com/osapi/ext/exnetif/ 。具体固件功能清单以该版本发布说明为准：https://gitee.com/openLuat/LuatOS/releases 。

61. USB网卡是不是设备通过type-c接在电脑上，电脑出现一个网卡可以和设备通讯？

解答： 是的。模组通过USB（Type-C）连接电脑后，可枚举为一块USB虚拟网卡（RNDIS，Windows免驱；部分平台也支持ECM），电脑的"网络连接"中会出现一块新网卡并通过DHCP获取到与模组同网段的IP（模组网关地址通常为192.168.10.1，电脑获取如192.168.10.x）。此时电脑与模组之间相当于通过网线直连在同一局域网：①电脑可直接访问模组上提供的HTTP/socket服务（访问192.168.10.1对应端口）；②模组也可主动访问电脑上的服务；③配合NAPT还可让电脑通过模组的4G网络上网。该网卡在脚本中对应适配器常量 socket.USB，用netdrv/exnetif管理。网卡适配器说明见 https://docs.openluat.com/osapi/core/netdrv/ 。

62. 如何测试16个780EGH的工装？

解答： 16台并行的量产测试工装需要您根据产线测试项自行设计，合宙不直接提供成套工装，但可提供设计方向：①硬件上用多口USB Hub（建议外接供电的工业级Hub）同时连接16台模组的USB口，每路保证供电能力（4G注网/发射时峰值电流较大，注意每路独立供电与总电源余量，避免压降导致重启），测试点引出SIM、天线（可用耦合天线/屏蔽箱）、必要外设；②软件上LuaTools支持多设备批量烧录，可先用LuaTools批量烧录同一固件；③自动化测试可让每台模组烧录测试脚本，通过串口/USB虚拟网卡上报测试结果（如IMEI、SIM注网状态、信号质量、外设自检）到一台PC工装软件统一判定PASS/FAIL；④SIM卡可用可插拔测试卡或工装专用贴片卡。若需要定制测试治具/工装硬件，可联系测试设备供应商提出需求。烧录工具见 https://docs.openluat.com/common/Luatools/ ，设备烧录排查见 https://docs.openluat.com/common/howtodown/ 。

63. 哪一款模组可以在硬件上与780EPM兼容，可以支持短信与电话？

解答： 结论：短信是合宙4G Cat1模组的通用能力（sms核心库支持移动/联通），所有780系列均具备；而"打电话"（VoLTE语音通话）必须选用带音频codec硬件的语音型号，普通数传型号（如Air780EPM）无音频硬件、不能通话。选型请以官方选型指南"2.3 需要4G+语音二合一的模组"章节为准（https://docs.openluat.com/SelectionGuide/SelectionGuide/ ），语音通话方向可选带音频硬件的型号（如Air780EHV系列，SIP/VoLTE方案均基于该类型号）。 原理：能否通话取决于模组是否集成音频codec及音频外围电路，与是否支持短信无关；同一系列不同后缀型号（数传版/语音版）引脚定义可能存在差异。 操作建议：1）在选型指南2.3节筛选同时满足4G+语音的型号；2）硬件能否pin-to-pin替换，必须把候选型号与Air780EPM的硬件手册引脚定义逐一对照（电源、SIM、天线、音频、复用脚），不能仅凭系列名推断兼容；3）确定型号前建议联系合宙销售/FAE确认封装与引脚兼容性，并可在 https://luat.taobao.com/ 采购核心板先做验证。

64. Air8000DB内置的北斗模块是哪一款，具体型号有吗？

解答： 结论：内置GNSS芯片的具体型号未在公开文档中标注，开发时无需关心芯片型号，直接使用LuatOS提供的统一GNSS库即可。 原理：LuatOS把GNSS芯片的差异封装在固件底层，上层通过统一的库接口操作（Air8000/Air8201等带定位的系列使用exgnss扩展库，Air780EGP等使用libgnss核心库），定位、NMEA解析、星历加速等接口与具体芯片型号无关，芯片更换不影响应用脚本。 操作建议：1）按demo/exgnss（或libgnss）示例初始化并读取定位数据即可；2）如项目认证、采购等场景确需芯片原厂型号，请以该型号产品页/硬件手册标注为准，或联系合宙销售/FAE确认。exgnss文档：https://docs.openluat.com/osapi/ext/exgnss/ ，libgnss文档：https://docs.openluat.com/osapi/core/libgnss/

65. Air8000DB的GNSS是否做过单北斗认证？相关认证证书有吗？

解答： 结论：Air8000DB内置GNSS支持北斗（含单北斗工作模式），但"单北斗认证"属于行业准入/合规类认证，相关认证证书不在公开技术文档中提供，需要走商务渠道索取。 原理：GNSS认证证书（如入网、无线电发射设备型号核准、单北斗专项认证等）由模组/芯片厂持有，通常用于客户项目投标、行业准入报备，不会随开发文档发布；能否提供、提供哪一档证书，取决于该型号实际完成的认证项。 操作建议：1）如项目强制要求单北斗认证，先查阅官方选型指南中的"单北斗需求"章节确认推荐型号（https://docs.openluat.com/SelectionGuide/SelectionGuide/ ）；2）通过合宙官方企业微信群（https://docs.openluat.com/ 网站底部二维码）、淘宝客服（https://luat.taobao.com/ ）或对接销售/FAE，提供具体型号与证书用途（投标/报备），由商务侧核实认证项并提供对应证书复印件；3）如当前型号认证项不满足，可由销售推荐已完成对应认证的型号。

66. SIP模块如何设置账号密码？没有键盘屏幕的设备怎么配置？

解答： 结论：无屏无键设备不需要人工输入账号密码。使用合宙SIP通话服务时，SIP账号与设备IMEI绑定、由系统自动生成，只要设备IMEI已归属到您或您公司的IOT账号名下即可直接启用；若对接客户自建SIP服务器，则在脚本中通过 exsip.init() 的配置表写入服务器地址、账号、密码等参数，量产脚本统一烧录即可。 原理：合宙SIP方案以IMEI作为设备唯一身份，账号密码无需人机交互配置；自建SIP场景下，参数是固件脚本的一部分，上电自动注册，不依赖键盘屏幕。 操作建议：1）确认设备IMEI已在自己IOT账号名下（设备归属见 https://docs.openluat.com/air780epm/product/attributioniot/ ）；2）参考demo/sip示例与exsip文档配置，exsip.init(config)前5个参数为sip_server_addr、sip_server_port、sip_domain、sip_username、sip_password，自建服务器时按实际填写；3）SIP通话需选用带音频硬件的型号（如Air780EHV）。exsip文档：https://docs.openluat.com/osapi/ext/exsip/

67. 两人同时登录12345671账号，两人会同时被呼叫吗？

解答： 结论：同一SIP账号在多台设备上登录（注册）时的来电路由策略由SIP服务器决定，不是固定"全部同振"也不是固定"只振一台"；实际表现取决于服务器是否支持同账号多注册（parallel fork同振/仅最后注册端振铃等）。 原理：SIP协议中，账号是注册到服务器的逻辑身份，一台设备对应一个注册contact；服务器收到来电后按其策略向已注册contact发起呼叫。若出现"来电打到陌生设备"，通常不是同振机制，而是账号密码泄露被他人注册，或账号/IMEI归属配置错误。 操作建议：1）正式产品务必一机一号，不要多设备共用同一账号；2）确认账号密码未外泄、设备IMEI归属在自己账号名下（https://docs.openluat.com/air780epm/product/attributioniot/ ）；3）需要同振/顺振等特定群组策略，应在自建SIP服务器上配置，并参考exsip文档验证：https://docs.openluat.com/osapi/ext/exsip/

68. Air8000的LCD SPI驱动是固定的吗？网上买的四线SPI屏幕无法点亮，用软件模拟SPI能点亮但官方点屏驱动不行

解答： 结论：LCD库的SPI不是写死的，引脚、SPI速率、初始化命令序列都可以通过 lcd.init() 的配置参数传入；软件模拟SPI能点亮、硬件SPI点不亮，说明屏幕本身和初始化序列基本正确，问题集中在硬件SPI的引脚映射、SPI参数或命令/数据线上。 原理：lcd库底层按配置表初始化硬件SPI控制器并执行屏幕初始化序列。模拟SPI时序宽松、不受引脚复用限制，所以能点亮；硬件SPI要求：1）所用引脚支持硬件SPI复用（pins配置正确）；2）SPI速率不超过屏幕规格（先降到低速验证）；3）命令/数据选择脚（DC/RS）、片选、复位脚接线与配置一致；4）初始化命令序列与屏幕驱动IC匹配。 操作建议：1）优先选用合宙已适配的屏幕型号，直接套用demo/lcd对应配置，最省时间；2）自购屏幕请先确认驱动IC型号，在lcd.init配置表中填写正确的IC命令集与引脚；3）用逻辑分析仪对比模拟SPI与硬件SPI的CLK/数据/DC波形，排查速率和时序；4）确需自定义驱动IC初始化序列可使用custom方式，但需要自行完成与屏幕IC的联调。lcd文档：https://docs.openluat.com/osapi/core/lcd/

69. axs15231b现在我们的驱动IC是这个型号，custom自定义驱动这个需要怎么弄？

解答： 结论：未适配的屏幕驱动IC可以通过custom方式自行移植：本质是在 lcd.init() 的配置表中传入该IC完整的初始化命令序列（寄存器地址+参数表），并按屏幕规格配置分辨率、SPI/QSPI接口、引脚、刷新方向等参数；但这属于客户自行适配工作，官方无法与第三方IC厂商做联调支持。 原理：lcd库对屏幕的差异点主要是"上电复位后的初始化命令序列"和"显存刷新窗口/像素格式命令"，这些都以配置表形式开放；只要IC是标准SPI/QSPI接口、命令格式与常规TFT屏一致，即可通过custom填入。难点在于初始化序列需要向屏幕IC原厂索取完整的寄存器初始化代码（含伽马、电源、帧率等参数），任何一处寄存器不对都可能花屏或不亮。 操作建议：1）向屏幕供应商索取axs15231b的完整初始化代码（通常以C/8080或SPI命令表形式提供）；2）参考demo/lcd中custom屏的配置示例，把命令序列翻译成lcd库的命令表格式；3）先用最低SPI速率、模拟SPI验证初始化序列能点亮，再切硬件SPI提速；4）项目周期紧时，强烈建议直接改用合宙已适配的屏幕型号（淘宝可购），避免IC联调风险。lcd文档：https://docs.openluat.com/osapi/core/lcd/

70. 除了已适配的屏幕驱动IC，其他的都不行吗？可以自己往里面加吗？

解答： 结论：可以自行添加。lcd库通过 lcd.init() 配置表支持custom自定义屏幕驱动，未适配IC只要是标准SPI/QSPI接口，都可以传入自定义初始化命令序列接入，不需要修改库源码。 原理：屏幕驱动差异主要体现在初始化寄存器序列和刷新命令上，库已把这些参数开放给脚本层；自定义驱动的工作量和风险点在于拿到IC原厂完整、正确的初始化代码并做点亮/刷新联调。 操作建议：1）向屏幕厂索取驱动IC的完整初始化序列与刷新率/分辨率规格；2）参照demo/lcd中custom示例配置命令表、引脚、接口速率；3）先低速模拟SPI验证点亮，再切硬件SPI；4）量产项目优先选合宙已适配屏幕以降低风险。lcd文档：https://docs.openluat.com/osapi/core/lcd/

71. 7寸屏可以在淘宝购买吗？单IC和双IC触摸屏有什么区别？

解答： 结论：7寸屏可以在合宙淘宝店（https://luat.taobao.com/ ）购买，具体在售型号与价格以商品页为准（参考价：单IC约139元、双IC约169元）。单IC与双IC指屏幕栅极驱动电路的方案差异。 原理与区别： 1）双IC方案：两颗驱动IC分担行驱动负载，驱动能力更强、输出波形更陡、大尺寸屏充电更充分，散热分散在两颗IC上，低温环境下显示更稳定，适合7寸及以上大屏、工业宽温场景； 2）单IC方案：单颗IC驱动全部行，成本更低、边框可做更窄（部分配合GIP——Gate In Panel，栅极电路集成在玻璃上——方案），但驱动能力受玻璃走线限制、发热集中，大屏高刷新率下余量较小； 3）GIP方案把栅极驱动做进面板玻璃，省去外置驱动IC，成本低、边框窄，但驱动能力和一致性受玻璃工艺影响。 操作建议：工业/低温/长供电场景选双IC；成本敏感、消费类常温场景可选单IC/GIP；选购时确认屏幕分辨率、接口（SPI/QSPI/RGB）与所用模组的lcd驱动支持情况（https://docs.openluat.com/osapi/core/lcd/ ）。

72. 8101 v2020 104固件休眠唤醒的时候每当时间到912秒左右就要重启，自己的板子和开发板测试都会出现

解答： 结论：自己的板子和官方开发板都能稳定复现、且重启时间点固定（约912秒），说明与您的外围硬件无关，大概率是固件休眠/唤醒流程与内部看门狗或唤醒定时器的配合问题，请按复位原因定位并升级最新固件验证。 原理：Air8101内部硬件看门狗默认8秒超时、由内核每1秒自动喂狗（不支持用户喂狗），PSM+模式下内部看门狗停止工作、唤醒后重新计时；休眠唤醒使用 pm.dtimerStart()，Air8101仅支持id 0。若唤醒后脚本初始化阶段阻塞过久、或固件在特定唤醒周期处理异常，就会表现为固定时间点复位。912秒与您设置的休眠/唤醒周期是否吻合，是判断线索之一。 排查步骤：1）开机第一时间调用 pm.lastReson() 读取并打印复位原因，确认是否为看门狗复位（对照 https://docs.openluat.com/osapi/core/pm/ 复位原因表）；2）全程保留串口日志，重点看912秒前最后一条日志停在哪个流程（休眠进入、唤醒、dtimer回调还是网络重连）；3）检查唤醒周期设置，临时把休眠时间改短/改长，观察重启间隔是否随之变化；4）升级到Air8101最新正式固件复测（v2020_104为较早版本，此类休眠问题可能已在后续版本修复）；5）若最新固件仍复现，保存完整串口日志+复位原因+最小复现脚本，通过合宙企业微信群反馈给官方分析。看门狗统一说明：https://docs.openluat.com/common/watchdog/

73. 4G模块接移动ONENET产品，今天比较多设备TOKEN过期，重启设备也一样，是NTP服务不可用了吗？

解答： 结论：大批量设备同时报TOKEN过期，最常见原因是设备本地时间不准——OneNET鉴权TOKEN的生成和有效期校验依赖时间戳，设备时钟停在默认值（2000-01-01）或漂移过大时，生成的TOKEN会被判为过期/无效。重启不能解决是因为重启后若未成功同步时间，时钟仍回到默认值。不一定是NTP服务器不可用。 原理：模组上电默认时间为2000-01-01；LuatOS默认开启基站授时（移动/电信卡支持，部分联通卡不支持），需主动调用 socket.sntp() 才走NTP；低功耗/PSM+唤醒后时钟也可能有偏差，需要重新同步。时间未同步时算出的TOKEN签名时间与OneNET服务器时间偏差过大即鉴权失败。 排查步骤：1）在脚本里打印 rtc.get() / os.date()，确认设备实际时间是否为当前北京时间；2）等IP_READY后确认时间同步：监听 NTP_UPDATE 消息（回调tp=1为基站授时、tp=0为NTP），主动调用 socket.sntp()，必要时用 mobile.syncTime(false) 关掉基站授时单独验证NTP；3）时间同步成功后再连接OneNET并生成TOKEN；4）若时间正确仍报TOKEN过期，检查设备密钥/产品ID配置、TOKEN有效期设置（OneNET侧动态TOKEN的exp参数）是否过短；5）对时间准确性要求高的项目，建议业务服务器建链后首先下发时间（rtc.set()）做兜底。参考时间同步文档：https://docs.openluat.com/common/time_sync/ ，rtc文档：https://docs.openluat.com/osapi/core/rtc/

74. 8201H定位时发烫严重，部分板子无法定位成功是什么原因？

解答： 结论：Air8201H是1.8V IO电压平台，脚本最开始（所有GPIO操作之前）必须调用 pm.ioVol(pm.IOVOL_ALL_GPIO, 1800) 把IO电平配置为1.8V；未配置或按3.3V使用会导致IO漏电、器件异常发热，GNSS相关控制脚电平不匹配还会导致GNSS无法上电或通信失败。 原理：GPIO电平域与外部外设（GNSS芯片使能脚、I2C/UATH等）电压必须一致；电压域配置错误轻则通信失败，重则持续灌电流发热。部分板子能定位、部分不能，还要排查个体焊接/天线差异。 排查步骤：1）确认脚本入口第一行已配置 pm.ioVol(pm.IOVOL_ALL_GPIO, 1800)；2）用官方demo/exgnss示例，把配置表中的GNSS供电使能脚、复位脚、串口/I2C脚按实际原理图修改后单独测试GNSS；3）发烫板子测量GNSS供电电流是否异常偏大，检查电源域、焊接连锡；4）无法定位的板子检查GNSS天线（IPEX是否扣好、无源/有源天线匹配、天线供电）及开阔环境搜星；5）对比"好板/坏板"日志中GNSS上电与NMEA输出差异。pm文档：https://docs.openluat.com/osapi/core/pm/ ，exgnss：https://docs.openluat.com/osapi/ext/exgnss/

75. 8201H板子定位失败，跑LBS脚本一直连接，是不是脚本问题？

解答： 结论：先明确测的是哪种定位——GNSS（卫星定位，用exgnss库）与LBS（基站/WiFi定位，用lbsLoc/airlbs库）是两套完全不同的方案，测GNSS不能用LBS脚本，反之亦然。 原理：GNSS靠内置GNSS芯片接收卫星信号、输出NMEA数据，室外开阔处使用，走exgnss库；LBS靠蜂窝基站/WiFi指纹在服务器侧查询经纬度，需要联网请求定位服务器（免费版lbsLoc为单基站定位、精度较低，airlbs为收费高精度方案）。"跑LBS一直连接"通常是设备未联网成功、定位服务器请求无响应，或库参数（适配器、加密key）配置问题，而非GNSS硬件问题。 排查步骤：1）确认需求：要卫星定位就跑demo/exgnss，要基站定位就跑demo/lbsLoc（或airlbs）；2）测LBS先确认设备已IP_READY联网、socket正常；3）确认8201H已配置 pm.ioVol(pm.IOVOL_ALL_GPIO, 1800)；4）LBS一直连接时打印socket/adapter状态和服务器返回码；5）测GNSS则到室外开阔处，检查GNSS天线与上电脚配置。lbsLoc文档：https://docs.openluat.com/osapi/ext/lbsLoc/ ，exgnss：https://docs.openluat.com/osapi/ext/exgnss/

76. 项目时间紧需要成熟批量案例，包括低功耗处理、DCDC选型、天线处理等，有没有10K以上量产的案例？

解答： 结论：建议直接采用合宙"工业模组"方案——Air878X/Air8201等工业模组已经把SIM卡、电源DCDC、USB下载、天线、音频、看门狗等最小系统电路板载集成并经海量出货验证（官方定位"成熟硬件方案、快速量产"，优先推荐），您只需在外围接自己的业务外设，可最大程度规避DCDC选型、天线匹配、电源纹波等硬件坑。 原理：每个项目的外设和结构不同，不存在可完全照抄的整机案例，但电源、射频、低功耗这三块共性难点在工业模组上已由官方设计验证；软件侧官方低功耗demo（PM/PSM+流程）已被大量量产项目使用，在此基础上改业务逻辑即可。 操作建议：1）按需求在选型指南选工业模组（https://docs.openluat.com/SelectionGuide/SelectionGuide/ ），数据透传选Air8781P/Air8780、定位选Air8201；2）参考《4G低功耗指南》 https://docs.openluat.com/common/airpower/ 和看门狗说明 https://docs.openluat.com/common/watchdog/ ；3）拿官方核心板/工业模组先验证软件，再画板；4）硬件设计可把原理图/PCB发合宙FAE做人工评审。淘宝选购：https://luat.taobao.com/

77. AI响应太慢/ai.luatos.com无法访问，怎么解决？

解答： 结论：响应慢多为高峰期免费模型排队/服务器负载高所致；打不开则多与本地网络、代理设置有关，可按以下顺序排查。 排查步骤：1）错峰重试，稍等几分钟后再提问；2）关闭代理/VPN/公司上网行为管理，直连网络后刷新；3）清除浏览器缓存或换浏览器/网络（如手机热点）测试；4）确认使用个人账号登录；5）若使用Trae中的luatos-docs-code智能体，内置免费模型高峰期排队明显，可订阅收费模型（约40元/月）显著提速，代码任务优先选GLM模型（慢则换MiniMax），其他任务优先ark-code-latest；6）以上均无效，通过合宙官方企业微信群反馈（https://docs.openluat.com/ 网站底部二维码扫码加入）。智能体管理说明：https://docs.openluat.com/ai/trae%2Bluatos-docs-code/manage/

78. 合宙AI提示504/打不开/失败怎么办？

解答： 结论：504是网关超时错误，多为AI服务高峰期负载过高或模型排队超时；打不开/失败还可能与本地代理网络有关，均可通过以下步骤处理。 排查步骤：1）刷新页面、稍后重试（避开工作日高峰）；2）关闭代理/VPN后重试；3）清除浏览器缓存、更换浏览器或切换网络（手机热点）验证；4）确认登录账号状态正常；5）Trae智能体用户建议订阅收费模型（约40元/月）规避免费模型排队；6）持续异常时截图保存错误信息，到合宙官方企业微信群反馈（https://docs.openluat.com/ 网站底部二维码）。智能体配置参考：https://docs.openluat.com/ai/trae%2Bluatos-docs-code/manage/

79. LuatOS插件经常失败，模型速度太慢，luatos-docs与luatos-code MCP服务的参数能发下吗？

解答： 结论：不需要MCP服务参数。Trae中的luatos-docs-code智能体已默认内置 luatos-docs 与 luatos-code 两个MCP Server（文档库与代码库检索），安装/更新智能体后自动生效，工具配置一般无需手动修改，也不需要您自行填写服务地址或密钥。 原理：MCP Server随智能体工程一起分发，由智能体规则自动调用；"经常失败、速度慢"的主要瓶颈是内置免费模型在高峰期排队，而不是MCP参数配置问题。 操作建议：1）按官方文档安装/更新到最新版luatos-docs-code智能体及规则、技能（https://docs.openluat.com/ai/trae%2Bluatos-docs-code/manage/ ）；2）速度慢建议订阅收费模型（约40元/月），代码开发任务优先选GLM模型（仍慢可换MiniMax），咨询/文档类任务优先ark-code-latest；3）关闭代理/VPN，确认Trae登录与网络正常；4）若更新后MCP工具仍持续调用失败，把报错截图发合宙企业微信群反馈。

80. Air8781P1有单独的核心soc吗？

解答： 结论：Air8781P1不是独立SoC芯片，它是合宙Air8781P系列工业模组的一个型号（板载硬件电路说明中第1部分即为"Air780EPM模组部分"）——核心通信功能由板载的Air780EPM 4G Cat1模组提供，外围集成了SIM卡座（Micro-SIM+预留贴片SIM）、4G天线IPEX座、硬件看门狗（喂狗脚GPIO24）、网络状态灯（GPIO27）、烧录调试插针等。 型号差异（官方定价）：Air8781P1无板载DCDC、有看门狗和LED状态灯（19.9元）；Air8781P2有DCDC+看门狗+LED（22.9元）；Air8781P3无DCDC无看门狗无LED（18.9元）；Air8781P4有DCDC无看门狗无LED（21.9元）。该系列搭配LuatOS-iRTU，面向串口透传场景。 说明：选型/采购时不需要关心内部SoC，按Air8781P工业模组整体使用即可，资料与原理图见官方文档（https://docs.openluat.com/air8781p/luatos/hardware/ ），购买 https://luat.taobao.com/

81. Air780EX2T这个的硬件资料有吗？

解答： 结论：硬件资料统一在合宙文档中心对应型号的产品页下，包括硬件手册、原理图、PCB封装、AT手册、LuatOS开发资料等。 操作步骤：1）打开文档中心 https://docs.openluat.com/ ，在产品列表/搜索中找到Air780EX2对应产品页（T后缀型号归属Air780EX2系列）；2）页面中"硬件资料/资料中心"栏目下按需要点开硬件手册、原理图、封装等；3）如该型号硬件手册暂未挂出或在页面中未找到，可在合宙官方企业微信群（https://docs.openluat.com/ 网站底部二维码）联系对接FAE/销售索取，或让在线AI助手（ai.luatos.com）帮您定位最新链接。

82. 基于780EPM做的开发板刷完固件后模块上自带的灯不亮了，想还原成官方代码怎么操作？

解答： 结论：灯不亮通常不是硬件损坏，而是您烧录的自定义脚本中没有点灯逻辑（官方开发板的网络灯/状态灯由出厂demo或LuatOS-iRTU固件驱动）。用LuaTools重新烧录对应开发板的官方固件+官方demo即可还原。 原理：模组上的指示灯（如网络状态灯，工业模组上常见为GPIO27等）由脚本/固件控制；您刷入只含业务逻辑的脚本后没有对应GPIO翻转代码，灯自然不亮。烧录官方demo后点灯逻辑恢复，即可判断硬件正常。 操作步骤：1）下载安装最新版LuaTools（https://docs.openluat.com/common/Luatools/ ，烧录故障排查见 https://docs.openluat.com/common/howtodown/ ）；2）在LuaTools中选择与您板子对应的官方固件（Air780EPM最新正式版），并勾选/添加官方demo脚本（或LuatOS-iRTU，工业模组默认固件）；3）进入下载模式烧录，等待完成后复位；4）灯恢复闪烁说明模组硬件正常，再在官方demo基础上加入自己的业务代码；5）若烧官方固件后灯仍不亮，检查该灯对应的GPIO与原理图是否一致、LED焊接是否正常，并保留串口日志反馈FAE。

83. 这个板子的原理图可以提供吗？

解答： 结论：合宙官方开发板/核心板/工业模组的原理图均公开，可在文档中心对应型号产品页免费下载（PDF格式，部分还提供PCB封装）。 操作步骤：1）打开 https://docs.openluat.com/ ，进入该板子对应型号的产品页（如Air8781P在 https://docs.openluat.com/air8781p/luatos/hardware/pcb/ ）；2）在"原理图及PCB封装/硬件资料"栏目下载原理图；3）若您指的板子型号未在对话中说明，请告知具体型号，或直接在文档中心搜索，也可让 ai.luatos.com 的AI助手帮您定位下载链接；4）工业模组如Air8781P的板载电路说明见 https://docs.openluat.com/air8781p/luatos/hardware/module/circuit/ 。

84. 最下面四个焊点是不是+ - + -还是+--+？

解答： 结论：该板四个焊点的电源极性顺序为 + -- +（即正、负、负、正），不是+- +-。 提示：焊点极性务必以板子丝印标识和官方原理图为准——不同批次/型号布局可能不同，接线前请对照该型号产品页原理图（https://docs.openluat.com/ 对应型号硬件资料）核对，确认正负极后再通电，避免反接损坏模组。

85. 单独串口通讯可以吗？

解答： 结论：可以。LuatOS模组支持把UART作为通用串口与外部MCU/传感器通信，使用uart核心库（uart.setup配置波特率/数据位/停止位/校验，uart.on注册接收回调，uart.write发送）即可，不需要联网也能收发数据。 说明：1）注意所用引脚支持对应的UART复用（参考pins/硬件手册），波特率电平要与对端一致（4G Cat1模组多为1.8V/3.3V电平域，注意电平匹配）；2）做透传类产品也可直接选用搭配LuatOS-iRTU的工业模组（如Air8781P），无需自己写串口转网络逻辑。uart文档：https://docs.openluat.com/osapi/core/uart/

86. 项目固件指定设备但IOT平台找不到设备/转移不成功怎么办？

解答： 结论：找不到设备/转移失败，绝大多数原因是该IMEI不在您当前登录的IOT账号名下（可能在采购商账号或您的另一个账号下）。设备必须先归属到自己账号才能在项目中添加/转移。 操作步骤：1）登录IOT平台（iot.openluat.com）确认当前账号，在设备管理中搜索该IMEI是否存在；2）设备转移流程：在目标新项目下添加该IMEI，并在原项目/原账号中把该IMEI删除（一台设备同一时间只能归属于一个项目）；3）若提示IMEI被占用、不属于本账号，需联系原归属方在其账号中移除，或按"设备归属"流程提供采购凭证申请归属转移（https://docs.openluat.com/air780epm/product/attributioniot/ ）；4）操作后等待几分钟同步，仍异常可截图IMEI和报错，在合宙企业微信群反馈。

87. IOT平台上关于SIP账号创建与查询在哪？

解答： 结论：SIP账号的创建与查询在合宙IOT平台上操作，操作指引见内部知识库文档：https://e3zt58hesn.feishu.cn/wiki/Eoobwd7jHiTpURkHSwNcEzf1n3c 说明：SIP账号与设备IMEI绑定，需先确保设备IMEI已归属到您的IOT账号名下（归属流程见 https://docs.openluat.com/air780epm/product/attributioniot/ ）；SIP通话功能需使用带音频硬件的型号（如Air780EHV），接口见exsip文档 https://docs.openluat.com/osapi/ext/exsip/ 。若链接无访问权限，请在合宙官方企业微信群联系工作人员开通。

88. 关于sip账号，朱老师帮忙看一下

解答： 结论：SIP账号问题请先自助确认两点：1）设备IMEI是否已归属到您或贵公司的IOT账号名下（归属流程见 https://docs.openluat.com/air780epm/product/attributioniot/ ）；2）SIP账号创建/查询是否已按平台指引完成（https://e3zt58hesn.feishu.cn/wiki/Eoobwd7jHiTpURkHSwNcEzf1n3c ）。 操作建议：确认以上两点后仍无法注册/呼叫的，请提供设备IMEI、IOT账号、SIP账号及串口日志（exsip注册与呼叫日志），在合宙官方企业微信群（https://docs.openluat.com/ 网站底部二维码）提交，工作人员会协助核查账号状态与服务器侧注册信息。SIP接口文档：https://docs.openluat.com/osapi/ext/exsip/

89. docs上关于2050版本固件的更新记录需要更新

解答： 结论：V2050正式版固件的完整更新记录（Release Notes）以Gitee官方发布页为准，发布地址：https://gitee.com/openLuat/LuatOS/releases/tag/v2050.ec7xx.release ，文档站的固件说明页也会同步补充。 说明：若您发现文档站某页面的版本更新记录与Release Notes不一致，以Gitee Release为准；文档持续更新中，您也可以把具体不一致的页面链接发到合宙官方企业微信群（https://docs.openluat.com/ 网站底部二维码），我们会及时订正。

90. 如何在WorkBuddy上写一个skill让agent操作本地的git提交？

解答： 结论：可以实现。编写一个skill，在skill说明中要求使用者提供本地git仓库的绝对路径，agent被调用后即可在该路径下执行git add/commit/push等命令完成提交和推送。 要点：1）skill中明确约定输入参数（仓库路径、分支名、提交说明）；2）约定执行流程：进入仓库→查看git status/diff→按规范生成commit message→提交→（按需）推送；3）权限与安全：agent使用的是使用者本机的git身份和权限（本地已配置的user.name/user.email及凭据），因此只能操作使用者有权限的仓库，不会越权；4）让agent在提交前输出变更摘要供确认。WorkBuddy/AirMaster相关说明见合宙AI专区 https://docs.openluat.com/ai/

91. Airmaster能自动推送吗？WorkBuddy可以吗？

解答： 结论：AirMaster可以执行git提交/推送；WorkBuddy本身不行（飞书侧的入口也不能直接推送）。 原理与安全设计：AirMaster的自动推送使用的是服务器侧预置的git权限，而非使用者个人的git凭据，因此其自带的git MCP能力没有对外开放——如果开放，任何调用者都可能借服务器权限向仓库提交代码，存在安全风险。WorkBuddy定位为办公自动化，涉及代码提交时需通过在使用者本机执行的方式（即由本地git身份完成鉴权），不能用服务器权限代为推送。 建议：需要"agent在本地仓库提交/推送"的场景，在WorkBuddy/Trae中通过自定义skill调用本机git命令实现（以本地git凭据执行）；平台侧自动化推送能力以AirMaster官方开放范围为准。AI专区：https://docs.openluat.com/ai/

92. 是不是可以整理一个文档讲如何使用WorkBuddy自动化公司的一些工作？

解答： 结论：可以。WorkBuddy用于办公流程自动化，使用方式并不复杂——把重复性工作（数据汇总、报表生成、消息通知、跨系统数据搬运等）抽象成"触发条件+处理步骤+输出"的流程，再配合skill（技能）把固定操作封装好，agent即可自动执行；文档配合skill示例仓库一起使用效果最完整。 建议：1）先梳理公司里高频、规则明确的流程作为试点；2）参考合宙AI专区的AirMaster/WorkBuddy说明（https://docs.openluat.com/ai/ ）了解能力边界（如git推送需走本地凭据，见上一条）；3）按"一个skill对应一类任务"的方式沉淀，逐步扩展。具体教程以官方后续发布的文档为准。

93. Air724UG最小支持多大的SD卡？

解答： 结论：软件上没有最低容量限制，SD/TF卡容量大小不影响识别，小容量卡（如128MB、1G）理论上都可以用。 原理：文件系统层（FAT）按卡的实际容量挂载读写，驱动并不校验卡容量下限；实际能否识别主要取决于卡本身是否规范（SD 1.x/2.0/SDHC标准）、触点接触和供电。 说明：Air724属于较早期的4G模组，平台较老，固件已长期维护稳定、不会针对新卡做额外适配；如遇小卡不识别，请按SD识别排查（见后续SD卡相关问题），优先换卡、清洁卡座、检查供电。文件系统参考fatfs文档：https://docs.openluat.com/osapi/core/fatfs/

94. 1G SD卡在Air724上不识别，是什么问题？

解答： 结论：1G容量本身在支持范围内，不识别基本是卡本身、接触或供电问题，不是容量限制。 排查步骤：1）换一张确认正常的卡交叉测试，排除这张1G卡损坏/分区表异常（建议用FAT32格式化、删除多余分区）；2）检查卡座触点是否氧化、卡是否插到位，用官方开发板插同一张卡做对比（开发板能识别即为自己底板卡座/走线问题）；3）检查SDIO走线与上拉电阻、供电电压（3.3V）和电流能力；4）确认固件为对应型号正式版本，软件按fatfs/sd例程挂载；5）抓取启动时SD卡初始化日志看卡在哪个阶段。Air724为老平台，若个别品牌老卡协议兼容性差，建议更换主流品牌卡验证。fatfs文档：https://docs.openluat.com/osapi/core/fatfs/

95. Air724驱动是不是只支持SD 2.0的卡？1G好像是SD1.0的卡

解答： 结论：并非只支持SD 2.0的卡，标准SD 1.x（1G及以下）与SD 2.0（2G）、SDHC（4G~32G）在协议上向后兼容，1G卡在支持范围内，建议以实物实测为准。 说明：1G卡属早期SD 1.1规格，不同品牌卡的初始化时序差异较大，加上Air724是较早的4G平台、固件已进入长期维护状态、不会再针对个别老卡做新的兼容性开发，因此若实测某张1G卡识别失败，最实际的处理是换主流品牌的2G/4G/8G卡做验证，而不是等待驱动更新。排查时优先按接触、供电、FAT32格式化、交叉换卡的顺序处理。fatfs文档：https://docs.openluat.com/osapi/core/fatfs/

96. Air714最小支持多大的SD卡？

解答： 结论：软件上没有最低容量限制，小容量卡（如128MB、1G、2G）理论上都支持，容量大小不影响识别。 原理：驱动与FAT文件系统层按卡实际容量挂载，不设容量下限；能否识别取决于卡是否符合SD协议规范、卡座接触、供电和SDIO走线/上拉。 排查建议：1）小卡不识别时，换主流品牌卡并格式化为FAT32、删除多余分区后测试；2）用官方开发板交叉验证同一张卡，区分是卡的问题还是底板硬件问题；3）检查卡座触点、3.3V供电电流能力、SDIO数据线上拉；4）抓SD卡初始化日志定位失败阶段。Air714与Air724同属较早平台，固件以稳定维护为主，个别早期卡兼容性差建议直接换卡。fatfs文档：https://docs.openluat.com/osapi/core/fatfs/

97. 怎么检查SD卡识别问题？哪里的日志能查到？

解答： 结论：SD卡识别情况直接看串口日志中SD/SDIO初始化与fatfs挂载的打印，可定位是卡未插入、初始化失败还是文件系统挂载失败。 LuatOS（脚本）开发：1）参照官方sd/fatfs例程，在脚本中打印fatfs挂载/SD初始化的返回值；2）上电时串口会输出SDIO探测、卡容量识别、FAT挂载相关日志，卡初始化失败通常停在SDIO命令应答阶段（接触/供电/卡不兼容），挂载失败多为分区/文件系统格式问题；3）用 fatfs 相关接口（如fatfs.mount/getfree）确认挂载结果与容量。 AT开发：对照AT手册中文件系统/SD卡相关AT指令，抓取AT交互日志分析返回码。 通用排查：换卡（FAT32）、清洁卡座、检查3.3V供电与SDIO上拉、官方开发板交叉验证。模组日志总体介绍：https://docs.openluat.com/common/howtouselog/ ，fatfs文档：https://docs.openluat.com/osapi/core/fatfs/

98. Win11下Air724 USB驱动安装不了，有最新的驱动吗？

解答： 结论：USB驱动安装问题请按合宙《关于USB驱动问题》文档处理（https://docs.openluat.com/common/usb_drv/ ），内含驱动包与Windows（含Win11）安装步骤；安装失败多为系统强制驱动签名、旧驱动残留或USB线/口问题。 操作步骤：1）从文档下载最新官方驱动包，按文档步骤安装（Win11注意安装驱动时按提示处理驱动签名）；2）设备管理器中卸载带感叹号的旧设备及驱动后重新插拔；3）更换USB数据线（部分线仅充电无数据）和USB口；4）设备管理器确认能枚举出对应的串口/端口。 补充：烧录和抓日志也可使用高速USB转串口板（支持2M波特率）配合串口方式；先确认上电时USB侧有枚举打印，若换线换口仍不枚举，检查模组供电是否正常。Luatools下载与烧录排查：https://docs.openluat.com/common/howtodown/

99. Air780E和780EPM有什么区别？现在新项目推荐用哪个？

解答： 结论：新项目请直接选用Air780EPM。Air780EPM是Air780E的升级替代型号，资源与固件更新、新功能开发都基于EPM系列；Air780E会持续供货保障存量项目，但官方不再为其新立项项目提供支持。 建议：1）新设计按Air780EPM选型（工业场景可直接选基于EPM的Air8781P/Air8780等工业模组）；2）存量Air780E项目维护可继续使用；3）迁移设计时对照两款模组硬件手册核对引脚差异，不要直接假设完全pin兼容。选型参考 https://docs.openluat.com/SelectionGuide/SelectionGuide/ ，产品资料在文档中心对应型号页 https://docs.openluat.com/

100. 需要一款可以驱动屏和带摄像头的Cat1，有选型推荐吗？

解答： 结论：屏+摄像头这类多媒体应用，应选择带多媒体SoC引擎的平台——Air8000系列（Cat.1 + 多媒体SoC引擎）是主推方向，支持LCD彩屏显示和camera摄像头；Air8101为多媒体Wi-Fi SoC（非4G）。纯4G Cat.1数传模组（如Air780EPM）不带大屏/摄像头能力，不适合此类需求。 原理：驱动高分辨率屏和摄像头需要专门的显示/图像硬件和较大内存，多媒体SoC引擎（Air8000）集成lcd/camera硬件加速与UI框架（AirUI），能承担彩屏交互+摄像头方案。 操作建议：1）在选型指南中按"多媒体/屏+摄像头"需求筛选Air8000系列型号（https://docs.openluat.com/SelectionGuide/SelectionGuide/ ）；2）向AI助手（ai.luatos.com）或销售直接说明屏分辨率、接口（SPI/QSPI/RGB）、摄像头像素和是否需要4G，以获得精确型号；3）用官方demo（camera/lcd/airui）先验证。lcd文档 https://docs.openluat.com/osapi/core/lcd/ ，camera文档 https://docs.openluat.com/osapi/core/camera/ ，AirUI https://docs.openluat.com/osapi/core/airui/

101. 摄像头的IO之外还需要额外35个可用IO，有什么型号可以满足？

解答： 结论：摄像头+35个以上额外GPIO，属于IO资源需求较高的多媒体应用，应选用Air8000系列（Cat.1+多媒体SoC引擎）这类GPIO数量多、带摄像头/显示接口的平台；具体可用GPIO数量必须以所选型号硬件手册的引脚定义表为准，逐脚核对（注意屏、摄像头、SD卡、串口等功能会占用复用脚，实际可用数要扣除已用外设）。 操作建议：1）列出全部外设占用的引脚清单（摄像头D0-D7/PCLK/VSYNC/HSYNC/SCCB、屏、串口、I2C等），再统计剩余GPIO是否≥35；2）在选型指南筛选Air8000系列（https://docs.openluat.com/SelectionGuide/SelectionGuide/ ），并把引脚需求给ai.luatos.com或合宙销售/FAE帮忙核算推荐；3）GPIO仍不够时可用GPIO扩展芯片（合宙有pca9555/mcp23017等扩展库，经I2C扩展）。camera文档：https://docs.openluat.com/osapi/core/camera/

102. Air780EPM/EGP/EX2等V2050正式版本发布了？

解答： 结论：V2050正式版固件已发布，覆盖Air780EPM/EGP/EX2等EC7xx平台型号。完整的固件包、各型号固件号说明和更新内容（Release Notes）见Gitee官方发布页：https://gitee.com/openLuat/LuatOS/releases/tag/v2050.ec7xx.release 操作建议：1）用LuaTools下载对应型号的V2050固件（https://docs.openluat.com/common/Luatools/ ）；2）升级前阅读Release Notes确认固件号与分区变化（部分固件号分区不同，不能跨分区FOTA，需整包烧录）；3）量产升级先小批量验证。

103. Air780EPM V2050_109号固件配置RNDIS不成功，V2048_109却可以，是固件问题吗？

解答： 结论：同一109号固件在V2048可用、V2050不可用，说明RNDIS（USB虚拟网卡）配置思路本身正确，差异点在两个固件版本。请先按netdrv标准用法核对配置，再用最小demo验证以区分是脚本配置问题还是固件回归。 原理：USB RNDIS由netdrv库管理，使用 socket.USB 适配器，流程为 netdrv.setup(socket.USB, ...) → netdrv.dhcp/netdrv.ipv4 配置 → 等待netdrv.ready/链路就绪，RNDIS网关默认192.168.10.1。大版本升级后个别固件号的USB枚举/默认配置可能变化，需要以该版本demo为准。 排查步骤：1）下载V2050对应的最新netdrv/USB RNDIS官方demo（gitee LuatOS仓库 demo/netdrv），不改业务逻辑直接烧录验证，排除脚本配置差异；2）核对脚本是否按 socket.USB 适配器初始化、是否等待link/ready后再启动业务，USB线是否为数据线、PC端是否枚举出RNDIS网卡并获取到IP（Windows免驱）；3）抓取USB枚举日志和netdrv返回值，确认卡在哪一步；4）确认V2050_109是否为最新发布版，尝试同系列更新小版本复测；5）若官方demo在V2050_109上仍失败而V2048_109正常，属疑似固件回归，请保留两个版本对比日志+最小复现脚本，通过合宙企业微信群反馈官方确认。netdrv文档：https://docs.openluat.com/osapi/core/netdrv/

104. Air780EHM和Air8000系列V2050新增21/121号固件和14号固件有什么区别？

解答： 结论：21/121号是相对14号的精简定制固件，区别在于裁剪了部分不常用功能以腾出flash空间、并加入音频相关能力。以V2050发布说明为准，主要差异如下： 资源变化：脚本区约704KB、文件系统约256KB； 移除功能：中文矢量字库（hzfont）、EPD墨水屏、LORA2、CAN、IOTAUTH、YMODEM、FFT、FASTLZ、FTP、PROTOBUF； 新增功能：16号中文灰度点阵字库、TTS语音合成、Audio_v2新音频框架。 选型建议：1）做语音/TTS/音频播放录音类应用、用不到被裁剪功能时选21/121号；2）需要CAN、FTP、矢量字库等被裁剪能力的项目继续用14号或对应全功能固件；3）具体固件号与功能清单以Gitee发布页为准：https://gitee.com/openLuat/LuatOS/releases/tag/v2050.ec7xx.release

105. 109号固件和106号固件分区不一样，能FOTA升级吗？

解答： 结论：不能通过FOTA直接升级。FOTA差分包只能在flash分区布局一致的两个固件之间生成和升级；109号与106号固件分区表不同（脚本区/文件系统大小划分不同），差分升级会因分区校验失败或写入越界而失败。 操作建议：1）这类跨分区版本切换需用LuaTools整包烧录新固件（本地烧录，不做FOTA）；2）后续量产若要支持FOTA，应让设备统一到同一分区布局的固件号上，再发布同分区的FOTA差分包；3）整包烧录前注意备份脚本与文件系统中的数据（如fskv配置），因为分区变化会擦除原有内容。fota文档：https://docs.openluat.com/osapi/core/fota/ ，烧录工具 https://docs.openluat.com/common/Luatools/

106. 109号固件上增加SMS功能后还有多少空间？

解答： 结论：Air780EPM系列109号固件在V2050基础上flash剩余约292KB，在加入SMS（短信）功能后，剩余空间约281KB（SMS功能占用约11KB）。 说明：该空间为脚本区可用余量，具体数值以该固件号发布说明为准；增加功能会占用脚本/固件空间，选型时请确认业务脚本+所需库（SMS、TTS、音频等）总大小不超过剩余空间。固件与Release Notes：https://gitee.com/openLuat/LuatOS/releases/tag/v2050.ec7xx.release

107. 电信SMS支持吗？

解答： 结论：当前109号固件加入的SMS（短信）功能仅支持中国移动和中国联通的短信，暂不支持中国电信SMS。 原因：电信短信协议栈实现体积较大（约需300多KB），在109号这类精简固件的空间预算内放不下；对短信有需求且使用电信卡的场景，可关注精简版VoLTE固件的能力支持。 建议：1）短信转发等应用优先使用移动/联通卡；2）必须用电信卡时，向合宙销售/技术确认当前是否有支持电信SMS或VoLTE的固件版本；3）sms库接口文档 https://docs.openluat.com/osapi/core/sms/ ，固件规划以Gitee发布说明为准 https://gitee.com/openLuat/LuatOS/releases/tag/v2050.ec7xx.release

108. 增加SMS功能之后能剩288KB，和脚本区大小有关系吗？

解答： 结论：剩余空间与脚本区大小没有直接关系。SMS功能是以库/功能模块形式编译进固件，占用的是固件flash预算；而"剩余可写脚本空间"取决于该固件号分区表中脚本区的总容量和已用空间。 说明：不同固件号（如106/109）分区布局不同，脚本区与文件系统大小划分也不同，因此能剩多少flash要按具体固件号的分区来算（109号加SMS后约剩281KB，288KB是其他口径下的数值）。评估能否容纳业务时，请以实际所选固件号的脚本区余量为准，不要跨固件号对比数字。Release Notes：https://gitee.com/openLuat/LuatOS/releases/tag/v2050.ec7xx.release

109. 短信转发的URL和手机号存在fskv中，重新烧录后需要重新配置URL，后续FOTA这些配置也需要重新配吗？

解答： 结论：不需要。用LuaTools重新烧录脚本/固件时可以选择清除fskv区域，所以烧录后配置会丢失、需要重配；但正常的FOTA远程升级只更新脚本/固件，不会擦除fskv存储区，升级后URL、手机号等fskv里的配置会保留，无需重新配置。 原理：fskv是在模组片上flash单独开辟的独立区域（总可用约64KB的小型KV数据库），与脚本区、文件系统区相互独立；FOTA流程不擦写该区域，因此数据持久保留。它与otp/imei/sn不同，fskv可被LuaTools烧录时清除，适合存放服务器URL、波特率等用户配置。 建议：1）量产设备的关键参数放fskv，FOTA后自动保留；2）脚本首次运行时判断fskv中是否有配置，无配置再进入配网/配置流程，可兼容首次烧录和被清除的情况；3）跨分区整包烧录（如106↔109）会擦除flash，需重新配置。fskv文档：https://docs.openluat.com/osapi/core/fskv/

110. 如何把设备从旧项目转到新项目？

解答： 结论：在合宙IOT平台（iot.openluat.com）操作：先在目标新项目中添加该设备IMEI，再在旧项目中删除/移出该IMEI，即完成转移。 前提：设备IMEI必须归属在您当前登录的IOT账号名下；跨账号转移时，需原账号先移除，新账号再添加，或凭采购凭证走归属转移流程（https://docs.openluat.com/air780epm/product/attributioniot/ ）。 操作步骤：1）登录IOT平台，进入新项目→添加设备→输入IMEI；2）进入旧项目→删除该IMEI设备记录；3）等待平台同步（一般几分钟）；4）转移后新固件/项目配置即可正常推送到该设备。详细图示以平台"设备转移"帮助文档为准，异常可截图IMEI与报错在合宙企业微信群反馈。

111. Air780EGP定位库libgnss调用合宙服务器会长期稳定吗？

解答： 结论：对合宙正品模组，libgnss调用合宙星历/辅助定位服务器的服务是长期稳定、免费提供的，官方对自己出货的模组持续保障该服务。 原理：服务器会校验请求设备的身份（IMEI等），仅向合宙正品模组提供星历下载/AGNSS加速服务；非合宙设备盗用该服务会被识别并关停，这是为了保障正式客户的服务质量和带宽。 建议：1）使用合宙官方正品模组和libgnss库即可放心长期使用，星历加速可显著缩短首次定位时间（TTFF）；2）核心定位能力本身依赖卫星，即使不使用星历服务器，GNSS仍可正常定位（只是冷启动慢）；3）产品设计上可把"星历获取失败"做成非致命容错（失败则等待正常搜星）。libgnss文档：https://docs.openluat.com/osapi/core/libgnss/

112. 低功耗模组如何做到微安级且能随时响应上网？

解答： 结论：要做到微安（μA/uA）级待机，需使用PSM+（深休眠）模式——该模式下CPU停止运行、RAM掉电，整机电流降到μA级；但代价是唤醒后脚本从头执行、网络需要重新建立，不能"瞬时"响应，唤醒到可上网有数秒时延。若要真正"随时秒级在线"，只能用PSM/低功耗保持模式（mA级），μA级与秒级在线不可兼得，需要在功耗和实时性间取舍。 原理：通过pm库配置功耗模式（pm.request进入对应模式），PSM+由定时器/中断唤醒（pm.dtimerStart设置唤醒时间，id 0/1最大2.5小时、id 2-6最大740小时；Air8101仅id 0）。PSM+下内部看门狗停止工作，唤醒相当于一次冷启动。 操作建议：1）电池长期待机场景用PSM+，定时唤醒采集-上报-再休眠；2）需要远程随时下发的场景，用保持在线的低功耗模式，或由服务器在唤醒窗口下发；3）参考《4G低功耗指南》https://docs.openluat.com/common/airpower/ 和pm文档 https://docs.openluat.com/osapi/core/pm/ ，并基于官方低功耗demo开发。

113. PSM+响应时间多久？

解答： 结论：PSM+（深休眠）被唤醒后不能立即上网——唤醒相当于冷启动，需要重新初始化、重新注网/建立数据连接，从唤醒到可联网通常需要数秒（秒级到十几秒，受现场信号、注网速度、服务器连接影响）。因此PSM+适合定时采集上报类业务，不适合要求毫秒/秒级实时响应的场景。 原理：PSM+下CPU停、RAM掉电，系统状态不保留，唤醒后脚本从头执行；网络会话已释放，需重新附着、获取IP、建立连接。 建议：1）对响应时延有硬要求的（如远程随时控制），用保持连接的低功耗模式（mA级），或让服务器在设备定时唤醒的上报窗口内下发指令；2）实测唤醒到数据上报成功的总时延，以自己网络环境为准；3）详见《4G低功耗指南》https://docs.openluat.com/common/airpower/ 和pm文档 https://docs.openluat.com/osapi/core/pm/ ，可让 ai.luatos.com 结合具体业务给出功耗/时延平衡方案。

114. 一个语音识别模块用的什么方案？客户想自己接I2S接口的SIP

解答： 结论：SIP语音通话建议直接用合宙已适配的方案——选带音频codec硬件的型号（如Air780EHV），用exsip扩展库实现SIP注册与通话，音频编解码目前仅支持PCMU/PCMA；客户自行外接I2S接口的音频芯片（如FP803）做SIP通话，合宙官方尚未适配，无现成驱动和联调支持，需客户自行完成移植调试。 原理：SIP通话链路为"exsip信令（UDP/TCP）+ RTP媒体（UDP，PCMU/PCMA）+ 音频采集播放"，音频部分依赖模组音频硬件；外接I2S codec需要驱动对接i2s总线、音频时钟和exsip/exaudio数据流，工作量和风险都在客户侧。 建议：1）优先用EHV核心板/开发板先把demo/sip通话完整验证通过，再设计自己的底板；2）确需外接I2S音频芯片（如ES8311等已适配型号），参考audio/exaudio文档评估，FP803未适配、无价格信息；3）语音识别如在模组外实现，可把识别模块与模组用串口/UDP对接。exsip：https://docs.openluat.com/osapi/ext/exsip/ ，audio：https://docs.openluat.com/osapi/core/audio/ ，i2s：https://docs.openluat.com/osapi/core/i2s/

115. Air780EPM用的贴片卡，V2048_1号固件有注册被拒绝，V2008正常，有遇到过这种问题吗？

解答： 结论：同一贴片卡在V2008正常、V2048_1注册被拒绝（registration denied），说明卡和硬件基本正常，差异在固件版本或最小脚本环境。请先用最小工程定位是固件问题还是脚本/卡配置问题。 排查步骤：1）烧V2048_1固件后，只保留一个空工程（仅 sys.run()，不加任何业务库），确认模组能否正常注网；2）空工程仍注册被拒绝，逐步确认：贴片卡是否接触良好、该卡运营商与频段是否在V2048支持范围、APN是否需要手动设置（部分贴片卡是专网卡，需设APN）；3）升级到V2050正式版复测，旧版本注网相关问题可能已修复（https://gitee.com/openLuat/LuatOS/releases/tag/v2050.ec7xx.release ）；4）对比同位置换普通插拔卡是否正常，区分贴片卡个体问题；5）保留两版本注网日志（mobile/网络注册的串口打印）和IMEI，在合宙企业微信群反馈官方判定是否固件回归。

116. Air780EPM固件升级后SIM卡被拒绝，如何排查？

解答： 结论：升级后SIM/网络注册被拒绝，先用最小工程排除业务脚本干扰，再区分是卡/APN/频段问题还是固件问题。注意：只保留 sys.run() 的空工程不会主动联网，需要加基础联网逻辑（或直接用官方联网demo）才能观察注网结果。 排查步骤：1）烧官方联网demo（或空工程+最基本的mobile/socket联网逻辑），观察能否正常搜网、注网、IP_READY；2）确认SIM卡：插拔重新上电、换一张普通卡交叉验证，检查卡座/贴片卡焊接接触；3）确认APN：专网卡/物联网卡常需手动设置APN，用 mobile.config 或对应接口配置正确APN；4）确认频段：核对卡运营商频段与模组支持频段一致；5）升级到最新V2050正式版复测；6）最小demo仍被拒绝时，抓取mobile注网日志（含SIM状态、注册拒绝原因码），带IMEI和固件号在合宙企业微信群反馈。mobile文档：https://docs.openluat.com/osapi/core/mobile/

117. 怎样把语音文件烧录到文件系统？

解答： 结论：把语音文件（如.mp3/.amr/.wav等音频）烧录到模组文件系统有两种常用方式：一是用LuaTools在烧录固件/脚本时把音频文件一并下载到文件系统分区；二是设备联网后通过http下载到文件系统，FOTA/远程更新也可推送音频资源。烧录后用文件路径即可被音频库播放。 操作步骤（LuaTools方式）：1）打开LuaTools，在烧录工程中除固件、脚本外，添加要下载的音频资源文件，并指定/保持其在文件系统中的目标路径；2）确认所选固件分区有足够的文件系统空间（109号固件文件系统约256KB，资源较大时选文件系统更大的固件号）；3）烧录后脚本里用 io.exists()/io.openFile 等接口确认文件存在，用 audio/exaudio 播放该路径文件。 说明：1）音频格式需与播放库支持格式一致（参考audio文档），文件总大小不超过文件系统容量；2）量产后更新语音可用http下载到文件系统或FOTA资源升级，无需重新烧录。文件操作参考 io库 https://docs.openluat.com/osapi/core/io/ 、音频播放 https://docs.openluat.com/osapi/core/audio/ 、扩展音频 https://docs.openluat.com/osapi/ext/exaudio/ ，LuaTools https://docs.openluat.com/common/Luatools/

118. 2050和2048固件有什么区别？2050修复了什么？

解答： 结论：V2050是在V2048之后发布的正式版本，包含缺陷修复和功能更新；具体修复了哪些问题、新增/调整了哪些固件号和功能，完整清单以V2050 Release Notes为准：https://gitee.com/openLuat/LuatOS/releases/tag/v2050.ec7xx.release 建议：1）升级前阅读Release Notes，确认与您业务相关的修复项和固件号变化（部分固件号分区不同，不能FOTA、需整包烧录，见105条）；2）新项目/量产建议统一升级到V2050正式版，旧版本遇到的问题先在V2050复测；3）升级后做小批量验证再全面推送。

119. 11和12串口不能发送，我是做串口透传的，2050还有这个问题吗？

解答： 结论：某串口无法发送，通常是引脚复用/串口编号配置、引脚电平域或外部接线问题，未必是固件bug。请先按uart库规范核对配置，再用V2050正式版实测，若确认是固件问题需带日志反馈，不能仅凭旧版本现象判断2050是否仍存在。 排查步骤：1）核对引脚复用：不同UART（uart 1、uart 2等）对应固定引脚，通过pins/硬件手册确认所用物理脚支持该UART功能，且没有被其他外设（如SPI/I2C/下载口）占用；2）初始化是否正确：uart.setup(id, baud, databits, parity, stopbits) 的串口号、波特率、收发引脚配置与对端一致，发送用 uart.write(id, data)；3）电平匹配：4G Cat1多为1.8V/3.3V电平域，与5V TTL/RS232/RS485对端必须加电平转换/收发器，直接连可能发送无波形；4）用示波器/逻辑分析仪量发送脚是否有波形，区分"没发出波形"还是"对端没收到"；5）用官方demo/uart最小例程回环测试（TX/RX短接）验证；6）升级V2050正式版（https://gitee.com/openLuat/LuatOS/releases/tag/v2050.ec7xx.release ）对照Release Notes查看是否有UART相关修复；7）若官方uart demo在V2050上对应串口仍无法发送，保留串口日志+最小复现脚本+引脚号，通过合宙企业微信群反馈官方确认。uart文档：https://docs.openluat.com/osapi/core/uart/