常见问题 - 2026-08-10
数据日期：2026-08-10
1. Air8201G的SPK是否转出了？
解答： Air8201G（型号标识BLMQ）硬件支持音频功能，模组已将I2S/I2C音频总线及功放控制脚通过板载焊盘/BTB座引出，但模组本身不带功放和喇叭，SPK信号不能直接接扬声器。需要外接ES8311音频编解码芯片（或使用内置DAC模式）+音频功放（PA）+喇叭才能发声；软件侧用exaudio扩展库，在exaudio.setup(audio_configs)中配置codec类型、I2C端口、pa_ctrl功放控制脚等参数，官方VoLTE通话demo中已包含完整的ES8311上电时序与PA控制示例。参考文档：https://docs.openluat.com/air8201/software/8201G/volte/call/ ，音频库说明：https://docs.openluat.com/osapi/ext/exaudio/
2. Air8201G固件通过平台升级有没有教程？
解答： 有。Air8201G支持FOTA远程固件升级，官方提供完整教程：使用libfota2扩展库配合合宙IoT升级服务器（iot.openluat.com），脚本中调用libfota2.request(fota_cb, opts)即可完成版本检查、下载、校验全流程，回调ret==0表示升级包下载成功，随后rtos.reboot()重启生效；也支持libfota2+自建服务器、fota核心库+文件/串口升级等方式。教程入口（远程固件升级汇总页）：https://docs.openluat.com/air8201/software/8201G/base1/fota/ ，其中合宙平台方案见 https://docs.openluat.com/air8201/software/8201G/ota/fota/
3. Air8201G怎么进入boot模式？
解答： 方法一：模组断电状态下，用镊子（或杜邦线）将BOOT引脚与VDD_EXT引脚短接，保持短接状态给模组上电，即进入BOOT下载模式，随后用Luatools烧录即可，Air8201核心板无独立BOOT按键，需手动短接焊盘。方法二（更简便）：不强制进BOOT模式，先在Luatools中选好固件点击下载，再给模组插USB上电（或按复位键），Luatools检测到开机握手会自动切换下载流程。烧录工具下载：https://docs.openluat.com/common/Luatools/
4. Air8201G这两个点可以接5V充电么？
解答： 这两个焊点是电池充电输入点（充电管理芯片输入），不能简单短接。Air8201G板载充电管理电路，充电输入电压标称5V，最大充电电流约1A，输入电压不得超过5.5V，且充电焊点与USB口不可以同时接入电源；焊接前请以板子丝印和硬件资料中标注的正负极为准，先确认焊点定义再接线，接反或过压会损坏充电芯片。焊盘功能与控制管脚汇总见Air8201G硬件资料：https://docs.openluat.com/air8201/hardware/
5. 这个输入走充电模块么？
解答： 电池/充电焊点的输入是经过板载充电管理芯片的：外部5V电源经充电芯片转换后给锂电池充电，同时（或电池直接）给模组系统供电，LuatOS中可通过yhm27xx充电管理库（如exs_yhm2712a）读取充电状态、控制充电开关；USB口供电则走另一条供电路径直接供系统，不经充电芯片。具体某个焊点/测试点走哪条路径，请对照硬件资料中该焊盘的网络名称判断（接VBUS/CHG_IN为充电输入，接SYS/VOUT为系统输出）。参考：https://docs.openluat.com/air8201/hardware/
6. 这个开发板的原理图有吗？官网上找不到。
解答： Air8201G官方未提供完整开发板原理图PDF，官网"硬件资料"页以焊盘功能表和全功能控制管脚汇总的形式公开硬件设计信息，用于软件开发和功能异常分析：https://docs.openluat.com/air8201/hardware/ 。更详细的硬件设计（电源、SIM、天线、音频等外围电路）可直接参考同硬件平台的Air780EGH硬件资料：https://docs.openluat.com/air780egh/luatos/hardware/ 。如需要原理图级别的设计支持或定制，可联系合宙销售人员或产品经理。
7. Air5010s实际供电2.4v蓝牙正常工作，和文档中的3.3-5.5v不符合？
解答： 供电电压必须以Air5101S产品手册标称的工作电压范围（3.3V~5.5V典型供电）为设计依据，2.4V属于欠压状态，不在规格保证范围内。欠压下蓝牙能广播/连接，多是因为该环境温度较好、发射功率低、距离近、对端接收灵敏度高，芯片"能跑"不等于"合格"：低压下射频PA增益和频偏会劣化，表现为距离缩短、丢包、连接不稳、低温/高温下直接不工作等问题，量产存在批次性风险。建议：①将供电改回3.3V（LDO/DCDC输出），电源走线加粗、就近加100nF+10uF去耦电容；②用万用表/示波器实测模组VCC脚电压而非电源出口电压，排除线损；③电池供电场景按电池放电截止电压核算低压裕量。资料入口：https://docs.openluat.com/air5101/product/
8. 天线放在板子中间可以吗？
解答： 天线不建议放在板子中间。PCB板载天线要求天线区域下方所有层完整挖空（禁止铺铜、走线），天线尽量布置在板边、远离金属件和电池等遮挡物，并与电源、DC-DC等强干扰源保持距离；天线馈线需做50Ω特性阻抗管控（由PCB板厂按叠层结构计算线宽并做阻抗板），射频走线尽量短、少打过孔。若结构上只能放板中，建议改用IPEX座外接天线（弹簧天线/FPC/棒状天线）。天线设计与调试参考：https://docs.openluat.com/air780epm/luatos/hardware/ant/
9. 8201G是不是要外接扬声器？
解答： 是。8201G模组本体不集成功放和喇叭，音频链路为：模组I2S/I2C → 音频Codec（ES8311/TM8211或内置DAC）→ 音频功放PA → 喇叭，必须外接功放与扬声器才能出声。建议直接使用合宙音频配件板快速验证：AirAUDIO_1000板载ES8311+D类功放PAM8302，可直接驱动2.5W/4Ω喇叭，支持2路Mic+1路Speaker；AirAUDIO_1010板载ES8311+功放、支持3W输出（1路Mic+1路Speaker）。配件板说明：https://docs.openluat.com/accessory/airaudio_1000/ ；接线与demo参考 https://docs.openluat.com/air8201/software/8201G/volte/call/
10. 板子出厂没有刷固件？怎么算已经开机了？
解答： 核心板/开发板出厂已预置固件，正常上电后模组会自动运行。判断是否开机：①用Luatools连接，能看到串口打印Trace日志即为已开机运行；②板上NET网络灯按规律闪烁（如搜网/驻网状态闪烁）也说明模组已启动。若连接电脑无任何反应，排查：①USB线是否为数据线（部分线只有VCC/GND无D+/D-，只能充电不能通信），换一根短的、带数据芯的USB线；②电脑设备管理器中是否识别到Luat USB串口，必要时重装Luatools自带驱动；③供电是否充足。Luatools下载：https://docs.openluat.com/common/Luatools/
11. Luatools升级后打不开、报错怎么办？
解答： 升级后打不开/报错多为旧版本残留进程或文件占用导致：①关闭Luatools，在任务管理器中结束残留的del.exe及Luatools相关进程（或直接删除Luatools目录下的del.exe）；②解压最新版Luatools到一个新的目录运行（不要覆盖旧目录），建议路径不含中文和空格；③仍异常可更换解压软件重新解压、以管理员身份运行，并确认杀毒软件未拦截。最新版下载与使用说明：https://docs.openluat.com/common/Luatools/
12. 开发板出厂有写入固定SN号吗？
解答： 每片模组出厂都带有唯一的硬件元数据（相当于设备身份证），但不是传统意义上用户可自定义的"SN标签"。LuatOS通过hmeta库读取：hmeta.model()取模组型号、hmeta.hwver()取硬件版本号、hmeta.chip()取原始芯片型号；V2048及以后版本固件新增hmeta获取muid（设备唯一标识，用于平台鉴权）和devid的接口。4G模组的muid也可用mobile.muid()获取、IMEI用mobile.imei()获取，这些ID全球唯一，可直接作为设备SN使用。说明文档：https://docs.openluat.com/osapi/core/hmeta/
13. AIR8000的开关机命令是多少？windows环境
解答： Air8000的开关机由POWER_ON管脚硬件控制，与操作系统环境无关：关机状态下将POWER_ON管脚拉低约1.5秒即可开机；但开机状态下无法用同样的拉低方式关机，需在脚本中用GPIO监听POWER_ON按键、检测到长按时执行关机逻辑（软件关机可调用pm.shutdown()，注意该接口关机后只能再拉低开机键开机，无法软件唤醒）。官方提供"power_on按键控制"文档和gpio/power_on demo，含完整的长按关机实现。参考文档：https://docs.openluat.com/air8000/luatos/common/poweron/ ；pm.shutdown()说明：https://docs.openluat.com/osapi/core/pm/
14. 8201G核心板连不上、供不上电，是不是FPC线坏了？
解答： 核心板通过FPC排线与底板连接，连不上/供不上电时按以下顺序排查：①FPC排线是否为适配的二代线、有无插反或未插到位，支架（锁扣）是否压紧，接触不良会导致供电或USB中断；②更换一根FPC线验证，排除排线断线；③检查底板焊盘有无虚焊、连锡；④单独用USB给核心板供电，区分是核心板问题还是底板问题。若确认排线/支架来料不良，可联系购买渠道（淘宝店客服或销售）更换配件。硬件资料：https://docs.openluat.com/air8201/hardware/
15. 引用exril_5101库会导致主控Air780EPM被唤醒、功耗升高吗？
解答： exril_5101是运行在主控（Air780EPM）上的LuatOS扩展库，通过UART以AT指令/透传方式管理外挂的Air5101蓝牙模组，库本身已包含Air5101的P0/P1低功耗模式管理、操作队列和看门狗子模块。是否会唤醒主控、抬高功耗，不取决于库本身，而取决于硬件接线和用法：①若Air5101的上报数据持续通过UART发给主控，且UART RX脚配置为唤醒源，则会唤醒主控；②低功耗设计中应让Air5101工作在低功耗模式，主控休眠时不要周期发AT查询，需要数据时再由Air5101通过指定唤醒脚（wakeup脚）拉电平唤醒主控。官方demo为示例代码，实际项目必须按上述思路改造休眠/唤醒策略。库文档：https://docs.openluat.com/osapi/ext/exril_5101/
16. Air780EPM升级到2026版本后功耗增大，电流曲线异常？
解答： 升级固件后功耗异常增大，按低功耗排查流程定位：①先升级到最新正式版core固件，排除已知版本问题；②用Luatools trace日志对照低功耗文档，检查是否真正进入低功耗/PSM+（pm.power(pm.WORK_MODE, x)配置是否生效）；③排查驻网行为：驻留频段、运营商网络是否支持PSM、RAU/TAU周期、是否频繁被网络寻呼唤醒；④检查外设：GPIO上下拉、串口是否空闲、传感器/LED是否常亮、有无定时器周期唤醒任务。低功耗设计与排查文档：https://docs.openluat.com/air780epm/luatos/app/lowpower/sleep/
17. Air780EPM的PSM+模式下功耗3-12uA准么？
解答： 准确。3~12uA是Air780EPM在PSM+（节能模式最深度休眠）下、合宙官方核心板上实测的待机电流区间。需要满足测试条件：①模组已成功驻网并与网络协商进入PSM（运营商网络支持PSM，APN开通并分配了T3412/T3324定时器）；②所有外设进入休眠或断电、GPIO无漏电、无周期任务唤醒；③用高精度电流表（uA级，如电源分析仪）串在供电回路测量，普通万用表无法准确捕捉。普通低功耗模式（非PSM+）电流会明显高于此值。低功耗说明：https://docs.openluat.com/air780epm/luatos/app/lowpower/sleep/
18. 能推荐个零基础的开发板吗？
解答： 零基础推荐从Cat.1 4G模组的官方开发板入手（如Air780EPM开发板），资料最全、demo最多、LuatOS脚本开发门槛低，配合Luatools烧录和Trace日志即可快速上手。具体型号请按通信制式（4G/WiFi/蓝牙/定位）、外设需求（屏幕/摄像头/音频）和封装偏好，在合宙官方选型指南中对比选择，指南中含各型号功能、价格和淘宝购买链接：https://docs.openluat.com/SelectionGuide/SelectionGuide/ 。开发板可在合宙官方淘宝店选购：https://luat.taobao.com/
19. 用PC模拟器连接提示没有进项目及白名单怎么办？
解答： 该提示是因为PC模拟器使用云平台服务（如AirCloud/合宙IoT平台）时，设备ID未归属到你的账号、未进入项目白名单。处理步骤：①在合宙官方淘宝店购买开发板（https://luat.taobao.com/ ）；②在合宙CRM/IoT平台将购买的模组设备ID（IMEI/MUID）归属到自己账号下，并在项目中添加该设备；③模拟器配置中把设备ID填为已归属开发板的设备ID，即可通过白名单校验。若仍无法连接，可通过合宙官方企业微信群（https://docs.openluat.com/ 网站底部二维码扫码加入）联系技术支持。
20. exftp这个库为什么资料中心/wiki里没有介绍？
解答： exftp是LuatOS的FTP客户端扩展库（Lua脚本库），提供exftp.create(adapter, host, port)创建连接、exftp:auth(user, password)登录、exftp:upload()上传、exftp:download()下载、exftp:chdir()/pwd()/cdup()目录操作等接口。资料中心暂未收录该扩展库的独立说明页，属于文档覆盖滞后于代码的情况；权威用法以官方源码和测试例程为准，可在Gitee LuatOS仓库查看：https://gitee.com/openLuat/LuatOS/tree/master/module （脚本库及testcase/func/network/exftp用例）。基础FTP能力也可参考核心库ftp的文档。技术问题可通过合宙官方企业微信群咨询（https://docs.openluat.com/ 网站底部二维码）。
21. Air780EPM/EHM的PSM+模式功耗是怎么测出来的？
解答： PSM+功耗值在合宙官方核心板上实测：模组驻网后通过pm.power(pm.WORK_MODE, x)进入PSM+深度休眠，待网络协商进入PSM（T3324激活定时器超时后模组在T3412周期内不再监听寻呼），用高精度电源分析仪（uA/mA量程可自动切换）串接在核心板供电回路，抓取稳定阶段的平均电流，测得约3~12uA区间。测试要求外设全部休眠/断电、电池供电、无周期唤醒任务，且运营商网络支持PSM。详细测试条件、接线和电流曲线见低功耗文档：https://docs.openluat.com/air780epm/luatos/app/lowpower/sleep/
22. Air1601外接Air780ER2实现4G上网，https请求耗时5秒正常吗？
解答： 首次HTTPS请求耗时数秒多数情况下是正常的，需对比区分。Air1601通过Airlink over UART分时复用4G通道，HTTPS相比HTTP多出TLS握手（证书校验、密钥协商，通常2~4个RTT），再叠加DNS解析、TCP建连、4G链路首次激活，冷启动一次请求到5秒左右属合理范围；链路建立后的后续请求应明显加快。定位建议：①用同一URL分别测HTTP与HTTPS、首次与连续多次请求的耗时，确认开销集中在哪一步；②确认服务器地址用IP还是域名（排除DNS慢）、服务器部署区域及响应速度；③对比Air780EPM模组直连同一服务器的耗时作为基线；④确认串口波特率足够高、无重传。若每次请求都稳定5秒以上，再排查信号质量（CSQ）和TLS证书校验配置。
23. 8202G的1.25电池端子接触不良，很难接触到正负极？
解答： 该现象与1.25电池座子本身的接触无关，根因是板载充电管理芯片进入了船运/低电保护状态，电池端子上残留的微弱电压使充电芯片状态机卡住，导致重新接电池时无法正常开机，需把板子彻底放电（让充电芯片完全断电复位）后才能开机。工程上的解决办法是在充电芯片相应引脚/电源回路加放电电阻，保证断开电池后残余电荷快速泄放；用户临时处理可将电池正负极短接放电数秒（注意仅在断电、无外接电源时操作）后再接电池。如批量出现，建议联系合宙技术支持确认硬件改版方案。
24. 8202G户外测试GNSS定位成功后USB会断开？
解答： GNSS定位成功后USB断开，通常是模组发生了重启，最常见原因是脚本阻塞导致看门狗复位：定位成功后若在回调/任务中执行了耗时操作（如阻塞式网络发送、死循环、大量数据处理未让出CPU），系统喂狗不及时就会重启，USB重新枚举表现为"断开"。排查步骤：①用Luatools查看Trace日志，定位成功时间点附近是否有重启/看门狗复位记录；②检查GNSS数据处理、socket发送逻辑是否阻塞，改为异步/分包发送，长任务中用sys.wait让出；③确认供电能力，定位+发射瞬间电流增大，供电不足也会导致掉线重启；④排除USB线接触和休眠关闭USB的可能。GNSS调试方法可参考对应模组的GNSS文档。
25. excloud扩展库API文档是不是好久没更新了？
解答： excloud扩展库及其文档均在持续维护更新中（文档源码osapi/ext/excloud.md近期仍有更新记录），并非停止维护。excloud用于对接合宙IoT平台（AirCloud协议），封装了设备连接、数据上报、指令下发、OTA等能力。建议直接以线上最新文档为准：https://docs.openluat.com/osapi/ext/excloud/ ；库源码见Gitee仓库 script/libs/excloud.lua ：https://gitee.com/openLuat/LuatOS/tree/master/module 。若发现某个接口与文档不一致，以随固件发布的库源码和demo为准，或通过官方企业微信群反馈。
26. LuatOS-SoC_V2048_Air8000_119固件串口11没法用？
解答： 这是LuatOS-SoC_V2048_Air8000固件的官方已知问题：该版本固件中uart11/uart12向外发数据发不出去（已在固件发布页"已知问题"中明确标注，见 https://docs.openluat.com/air8000/luatos/firmware/ 历史版本说明）。临时规避方案：改用同系列19/119号固件（在14号固件功能基础上将脚本区改为1MB、文件系统168KB），或暂用其他可用串口；后续固件版本会修复该问题，建议关注固件页更新记录。
27. 下载的认证固件不对怎么办？
解答： 认证固件下载与普通固件入口不同，若下载到的文件不对，按以下步骤处理：①确认在Luatools/固件下载页选择的是"认证固件"分类，且模组型号、硬件版本完全对应（认证固件与型号强绑定，选错型号会拿到不匹配的文件）；②清除浏览器缓存或更换浏览器后重新点击下载（下载链接偶发返回旧文件/缓存文件）；③核对下载文件名中的型号、版本号与目标模组是否一致。若重新下载仍不正确，请提供模组型号、硬件丝印版本和下载页面截图，通过合宙官方企业微信群（https://docs.openluat.com/ 网站底部二维码）联系技术支持核对。
28. 8783发送短信给飞行模式的手机，模组收不到状态上报怎么办？
解答： 这不是功能缺失，而是短信状态报告的网络机制问题。LuatOS中发送短信用sms.send(phone, msg, auto_phone_fix, need_report, vp)，第4个参数need_report置1才会请求运营商返回状态报告（SMS-STATUS-REPORT），发送结果通过"SMS_SENT"消息返回。但状态报告能否收到、何时收到，取决于运营商短信中心和对端状态：对方处于飞行模式（关机/不在服务区）时，短信中心会暂存并延迟投递，状态报告通常在对方实际收到后才返回，超时则可能不返回或返回"未送达"，这属于正常的网络行为。若need_report已开启仍收不到，可换卡（换运营商）交叉验证，并在日志中确认SMS_SENT消息参数。sms库文档：https://docs.openluat.com/osapi/core/sms/
29. Air724UG能在越南使用吗？
解答： 不建议。Air724UG为面向中国大陆市场的Cat.1模组，支持的是国内运营商频段，越南主流运营商的LTE频段（如B1/B3/B7等）与其射频覆盖和认证均不匹配，且模组未取得越南当地入网认证，在越南无法保证驻网和合法使用。海外项目请按目标国家运营商频段和认证要求，在合宙选型指南中重新选型（优先考虑支持对应频段的海外版型号），并向合宙销售确认目标区域的认证情况：https://docs.openluat.com/SelectionGuide/SelectionGuide/
30. Air8000能驱动WS2812B吗？
解答： 可以驱动，但要选对驱动方式。LuatOS在sensor库中提供了三种WS2812B驱动接口：sensor.ws2812b(pin,data,T0H,T0L,T1H,T1L)为GPIO模拟时序方式；sensor.ws2812b_pwm(pin,data)为PWM硬件驱动方式（要求PWM能输出800kHz）；sensor.ws2812b_spi(pin,data)为SPI硬件驱动方式（要求SPI能输出约5MHz）。WS2812B是800kHz单线归零码协议，时序要求极严，在Air8000这类带4G协议栈的模组上，GPIO模拟方式容易被4G协议栈中断打断导致花屏，推荐优先使用SPI或PWM硬件方式驱动。接口源码见 luat/modules/luat_lib_sensor.c ：https://gitee.com/openLuat/LuatOS/tree/master/module
31. Air8000不能驱动WS2812B是IO频率跟不上还是IO电平拉不动？
解答： 两者都不是根本原因。GPIO翻转频率（IO速度）和IO电平驱动能力都足够，问题在于WS2812B要求严格的微秒级800kHz时序，而4G协议栈运行时会产生高优先级中断，GPIO模拟方式（sensor.ws2812b）在发送比特流过程中一旦被中断插入，就会打乱T0H/T1H时序，导致灯珠颜色错乱/花屏。正确做法是改用硬件外设驱动：sensor.ws2812b_spi（约5MHz SPI硬件发送，不受中断影响）或sensor.ws2812b_pwm（800kHz PWM），由硬件自动产生时序；这也是无4G协议栈的Air1780等MCU类产品用GPIO方式也能稳定驱动的原因。
32. 模组为啥没有获取定位权限？
解答： LBS基站定位属于合宙云服务，调用前必须先在LBS平台创建项目并配置参数，否则模组请求会因无项目授权而拿不到定位结果。操作步骤：①登录LBS项目列表页 https://iot.openluat.com/lbs/project-list 创建项目，获取项目KEY等参数；②脚本中（airlbs库或对应AT指令）填入项目参数后再发起定位请求；③免费版为单基站LBS定位，多基站/WiFi高精度定位为收费服务，需联系销售开通。注意定位依赖模组已驻网并能获取到基站信息（mobile.reqCellInfo）。
33. EGT用新的LBS指令为啥参数错误？
解答： 返回参数错误，是因为新版LBS指令必须携带在平台申请的项目参数（项目KEY等），参数缺失或填写错误都会报错。操作步骤：①登录 https://iot.openluat.com/lbs/project-list 创建/进入项目，获取该项目对应的定位参数；②严格按AT手册中新版LBS指令的参数顺序和格式填写（注意区分付费多基站定位与免费单基站定位的指令/参数差异，付费服务需先开通）；③确认固件版本支持新指令（收费定位对780EHT/EGT等型号有版本要求）。参数配置正确后再发送定位请求。
34. 780E能在泰国使用吗？
解答： Air780E产品手册明确标注适用区域为"中国"，频段为FDD：B1/B3/B5/B8、TDD：B34/B38/B39/B40/B41，是面向国内三大运营商的全网通型号。泰国主流运营商除上述部分频段外还使用B7等频段，且该型号未取得泰国当地认证，在泰国无法保证全频段驻网和合规使用，不建议直接用于泰国项目。海外应用请按目标国家运营商频段在选型指南中选择对应型号并确认认证：https://docs.openluat.com/SelectionGuide/SelectionGuide/ ；产品手册见 https://docs.openluat.com/air780e/product/
35. 4G中断后显示SIM卡未插入，重启不能复原，只有断电才可以？
解答： 这是因为软件重启（rtos.reboot）时模组供电未断开，SIM卡电源没有完整掉电复位，SIM卡状态机或卡座检测停留在异常状态，重启后协议栈仍判定为无卡；只有彻底断电才能让SIM卡重新上电初始化。规避方案：①业务中检测到"无卡/SIM异常"时，先切换一次飞行模式（mobile.flymode进出飞行模式）触发协议栈重新搜网和读卡；②硬件设计上用一个GPIO控制SIM卡电源（VDD_SIM使能或MOSF管），异常时通过GPIO断电再上电做硬复位；③在异常分支里对SIM电源做一次硬件复位再重驻网。同时检查卡座是否虚焊、SIM卡是否接触良好。相关API见mobile库文档：https://docs.openluat.com/air780epm/luatos/app/common/mobile/
36. 7寸屏幕多少钱？
解答： 屏幕价格与具体型号、分辨率、接口（SPI/RGB/MIPI）、是否带触摸及采购数量相关，无统一报价，需以合宙官方淘宝店实际上架价格为准（店铺内搜索对应屏幕配件板，如AirLCD系列）：https://luat.taobao.com/ 。若7寸屏未在淘宝店上架或有批量采购需求，可通过店铺客服或合宙销售获取选型和报价。屏幕配件资料可在配件文档目录查询：https://docs.openluat.com/accessory/mulu/lcd/
37. 信号差时一旦TCP数据流传输就断网，MQTT没问题？
解答： CSQ约16属于偏弱信号，弱信号下上行链路余量不足，TCP持续传输大数据时上行发射容易丢包、重传超时导致链路断开；而MQTT心跳包数据量小、对带宽要求低，所以表现为"MQTT正常、TCP大流就断"。这属于弱信号环境的正常现象。处理建议：①优先改善射频：检查天线匹配/驻波、天线远离金属遮挡、必要时更换高增益天线或外接天线，参考天线调试文档；②软件上对TCP做容错：socket断线后自动重连、数据分包发送并做应用层应答/超时重传，不要假设连接长期不断；③关注CSQ和注册状态，信号低于阈值时主动降速/缓存数据。链路断开后模组会自动重新驻网恢复，但与服务器的应用层连接需自行重连。
38. AT+HTTPSSL=1返回+CME ERROR: 3，780E V1175能连HTTPS吗？
解答： 可以连HTTPS，返回+CME ERROR: 3（操作不允许）通常是HTTPS/SSL相关指令的配置顺序或前置状态不对。AT固件中SSL与HTTP初始化有依赖关系，需按顺序配置：先执行AT+HTTPSSL设置SSL开关，再用AT+SSLCFG配置SSL参数（如认证等级seclevel等），最后执行AT+HTTPINIT初始化HTTP实例；若HTTPINIT已先执行过，需先AT+HTTPTERM退出后再按上述顺序重新配置，否则中间设置会报CME ERROR: 3。另外确认固件版本支持SSL、SIM卡已驻网且PDP激活。完整HTTP/HTTPS指令流程见AT手册HTTP章节：https://docs.openluat.com/atmozu/product/command/http/
39. LBS创建订单时提示“不属于你的组织”怎么办？
解答： 该提示是因为你要开通LBS服务的模组（设备）当前归属在卖家/其他账号的组织下，你的账号没有该设备的操作权限。处理方法：联系购买该模组的卖家（淘宝店客服或销售），请对方在合宙CRM/平台中把对应设备ID（IMEI/MUID）划拨/归属到你的账号组织名下，归属完成后再创建LBS订单即可。若设备是自行从官方渠道购买，可提供订单号和设备ID，通过合宙官方企业微信群（https://docs.openluat.com/ 网站底部二维码）协助处理归属。
40. Air8000W案例的封装引脚不全？
解答： 案例/教程中列出的引脚不全，是因为文档通常只标注功能演示用到的管脚，并非封装全部引脚。Air8000W系列的完整管脚定义、封装尺寸和引脚编号，请以官网对应模组的硬件资料（管脚图/硬件设计手册）中的完整管脚表为准逐一核对，不要依据案例截图数引脚。若你手上案例标注的引脚号与官方管脚表不一致，请提供具体型号和案例链接，通过官方企业微信群核对。Air8000系列资料入口：https://docs.openluat.com/air8000/ （硬件手册含完整管脚定义）。
41. 合宙有物联网平台吗？买模组几百台可以用吗？会额外收费吗？
解答： 有。合宙IoT设备管理平台遵循AirCloud协议，支持设备接入、数据上报存储、指令下发、OTA等，几百台规模可以直接使用。平台为收费服务，按版本年费计：测试版59元/年，VIP版按等级VIP1~VIP5对应约3000/10000/30000/60000/100000元/年，测试版即可满足中小规模验证和小批量使用。平台入口iot.openluat.com，收费标准和说明见：https://docs.openluat.com/value/iot/ ；AirCloud协议见 https://docs.openluat.com/protocols/aircloud/ 。设备端可直接用excloud扩展库或AirCloud协议对接。
42. OTA升级时是不是所有设备都升级就要选是，IMEI不用指定？
解答： 是的。在合宙IoT平台创建升级（FOTA）配置时，升级范围可选"全部设备"或"指定设备"：选择全部设备升级时，项目下所有在线设备检测到新版本后都会自动升级，不需要逐个填写IMEI；若只想灰度/定向升级部分设备，则填写目标设备的IMEI列表，只有列表内设备会升级。设备端使用libfota2扩展库（libfota2.request）配合合宙平台即可，无需自建服务器。配置方法见FOTA文档：https://docs.openluat.com/air780epm/luatos/app/ota/fota/
43. 淘宝和官网的Camera线序资料完全相反，该以哪份为准？
解答： 一律以合宙官方文档站（docs.openluat.com）对应配件板的规格书/使用说明中的线序定义为准，淘宝详情页可能存在未同步更新的旧线序，不作为接线依据。接线时以配件板丝印和官方文档的管脚对应表交叉核对，例如AirCAMERA_1040资料页：https://docs.openluat.com/accessory/AirCAMERA_1040/ 。若发现官方文档与实际收到的板子丝印不一致，请以板子丝印为准并拍照通过官方企业微信群反馈，由技术支持确认后再接线，避免接反损坏摄像头。
44. Air780EG做MQTT低功耗，keepalive30秒自动喂狗？
解答： 需要区分"看门狗"和"MQTT保活"两件事。①看门狗：模组内部硬件看门狗（AON WDT）由内核固件自动喂狗，无需脚本干预，MQTT keepalive并不会、也不需要去喂狗，不会因为30秒不喂狗而复位。②低功耗：MQTT keepalive=30s意味着模组每30秒要醒来发一次心跳包，这会频繁唤醒模组，无法进入深度休眠，待机电流远高于PSM+的uA级——keepalive越短功耗越高。低功耗MQTT方案建议：允许断线的采集类业务，拉长心跳间隔或改用"数据采集完即断开连接、休眠、定时唤醒重连上报"的模式（官方lowpower demo中的mqtt_long即此思路），并配合pm.power(pm.WORK_MODE,x)进入低功耗/PSM+。低功耗示例：https://docs.openluat.com/air780epm/luatos/app/lowpower/sleep/ ；看门狗说明：https://docs.openluat.com/osapi/core/wdt/
45. Luatools以后是否可以做MCP接口？
解答： Luatools本身定位为图形化烧录调试工具；通过接口/命令行方式集成开发流程的能力，已在VS Code的LuatOS插件中实现（支持工程管理、烧录、日志查看等操作，可在编辑器内完成开发闭环，便于扩展调用）。建议在VS Code中安装"LuatOS"插件使用。若你的场景需要MCP/自动化接口对接，可通过合宙官方企业微信群（https://docs.openluat.com/ 网站底部二维码）提出具体需求。烧录工具下载：https://docs.openluat.com/common/Luatools/
46. Air724UG现在还生产吗？还有几年停产淘汰？
解答： Air724UG目前仍在供货、可正常采购使用。关于停产时间无法给出确切年限承诺，但合宙对量产模组通常会保证较长的供货周期。对新项目，更推荐选用当前主推的新型号（如Air780EPM/EHM等Cat.1系列），新型号在低功耗、外设资源、固件功能持续更新和文档支持上更优，长期供货和技术支持更有保障。选型请参考官方选型指南：https://docs.openluat.com/SelectionGuide/SelectionGuide/ ，购买：https://luat.taobao.com/
47. 需要本地1080P/30fps稳定录像、4G和WiFi均可独立图传的模组有推荐吗？
解答： 目前LuatOS主推的带摄像头模组（如Air8101/Air1601）在官方支持下可实现200万像素拍照和100万像素录像（DVP/UVC摄像头），录像稳定规格约1280×720（720P），实测AirCAMERA_1032可达1280×720@20fps、稳定推荐720P@15fps，暂不支持1080P@30fps的稳定本地录像。4G与WiFi独立图传可考虑多网融合模组（Air8000系列支持4G/WiFi/以太网切换）或Air1601（支持RTMP推流/图传）。若业务必须1080P30，建议用更高规格视觉模组或外挂摄像头方案，具体型号按分辨率、接口（DVP/UVC）和图传制式在选型指南确认：https://docs.openluat.com/SelectionGuide/SelectionGuide/ ；摄像头能力见 https://docs.openluat.com/air8101/luatos/hardware/dvp/
48. 最近产品有没有涨价？
解答： 产品价格以合宙官方淘宝店（https://luat.taobao.com/ ）实时标价为准，价格可能随芯片成本、型号迭代调整，历史调价节点不代表当前价格。批量采购或长期供货协议价，请直接联系合宙销售获取正式报价。选型与功能对比可参考选型指南：https://docs.openluat.com/SelectionGuide/SelectionGuide/
49. 支持audio的15-16号固件不支持矢量汉字库，和airui字号能力冲突怎么解决？
解答： 这不是冲突，而是两类固件字体资源不同：Air8000的15/115、16/116号固件（带audio能力）内置的是16号灰度点阵字体，不内置ttf矢量字库数据，因此直接使用时无需调用airui.font_load()/hzfont即可显示16号中文；若需要其他字号，需用hzfont加载ttf矢量字体文件（固件内置MiSans-Demibold ttf或自行烧录ttf到文件系统），通过airui.font_load(config)绑定字体后渲染。由于这两个固件脚本区/文件系统空间较小，ttf字库需按需裁剪制作（仅保留用到的字符）后烧录。字体机制详见：https://docs.openluat.com/common/luatos_font_guide/ 和 https://docs.openluat.com/osapi/core/airui/ （4.1.4 font_load）。
50. Air8781P支持IRTU的Luat固件吗？发过来是AT版本。
解答： 支持。Air8781P系列工业模组搭配LuatOS-iRTU，面向串口透传场景，出厂默认AT版本不影响使用，可自行烧录iRTU固件。iRTU是一个配置平台/固件形态，通过irtu.openluat.com后台配置串口透传、GPIO控制、定位、音频等动作和逻辑，无需写代码。烧录方法：用Luatools下载对应型号的iRTU固件烧录即可，烧录与调试步骤见 https://docs.openluat.com/air8781p/luatos/hardware/debug/ ，iRTU功能介绍与配置说明见 https://docs.openluat.com/air8781p/luatos/hardware/irtu/
51. Air8101能支持语音输出吗？
解答： 语音播放/TTS/录音功能需要Air8101B才支持。Air8101/Air8101A不具备音频播放和TTS能力（官方音频文档明确：录音、AMR/PCM录制播放等功能"仅8101B支持"，TTS无声问题也要求先确认型号为Air8101B且固件≥V1018）。因此需要语音输出（播报、TTS、放音）的项目，请直接选用Air8101B，并使用配套音频demo（exaudio库，配置DAC/外接codec与pa_ctrl功放控制脚）。功能说明与demo见：https://docs.openluat.com/air8101/luatos/app/multimedia/audio/
52. 8201G的APP在哪里下载，后台入口在哪？
解答： APP下载、后台入口和源码链接都在Air8201G快速入门指南页面中，页面演示视频下方附有平台连接地址和源码下载链接：https://docs.openluat.com/air8201/hardware/8201G_guide/ 。按页面指引进入对应平台注册/登录后即可绑定设备、下载APP；源码可从页面链接或Gitee LuatOS仓库获取（https://gitee.com/openLuat/LuatOS/tree/master/module ）。若页面链接失效，可在合宙官方企业微信群获取最新入口。
53. 电池输入和5V输入的正负极是怎么分的？
解答： 电池输入与5V输入的正负极必须以板上丝印标注和硬件资料中的焊盘定义为准，不同批次/座子排布可能不同，不能仅凭位置判断。一般端子座中间脚多为GND（如2Pin/4Pin座中相邻的地脚连在一起），但接线前务必：①用万用表通断档确认GND脚（与板子大面积地、屏蔽罩连通的为地）；②对照硬件资料焊盘功能表确认VBAT/5VIN脚。5V充电输入电压不得超过5.5V，且充电焊点与USB口不可同时上电。参考Air8201G硬件资料：https://docs.openluat.com/air8201/hardware/
54. 新模块拨号正常，但另一个模块一直不能拨号上线，是什么问题？
解答： 同样固件/卡、一个模组正常另一个不能拨号上线，基本可排除脚本和运营商侧问题，应重点排查该模组个体的硬件和射频：①天线馈点焊盘/IPEX座是否虚焊、漏焊或连锡，天线是否接触良好（这是最常见原因）；②SIM卡座是否虚焊、SIM卡是否接触良好，日志中确认能否读到ICCID、是否驻网；③用Luatools看Trace，对比正常模组，确认卡在哪一步（注网→附着→PDP激活→拨号）；④检查该模组供电是否充足、射频匹配器件是否错料。硬件焊接/天线参考：https://docs.openluat.com/air780epm/luatos/hardware/ant/
55. 天线信号差，怎样才能解决？
解答： 天线信号差需结合整机结构和PCB针对性调试，通用排查：①天线匹配：射频走线50Ω阻抗、π型匹配网络预留并按实测调匹配，板载天线下方挖空；②安装环境：天线远离金属外壳、电池、DC-DC，伸出屏蔽区，必要时改用IPEX外接高增益天线；③确认天线频段覆盖目标制式、驻波比合格。最终建议将整机提供给专业天线厂（或合宙推荐的天线供应商），在实际结构和PCB上做无源/有源调试。设计要点和调试方法见：https://docs.openluat.com/air780epm/luatos/hardware/ant/
56. Lua的SPI0直接读取寄存器的函数是哪个？
解答： SPI有直接收发原始数据的接口，不需要依赖回调。LuatOS的spi核心库提供：spi.transfer(id, send_data, send_len, recv_len)在一次传输中发送并接收数据（全双工），spi.send(id,data)发送、spi.recv(id,size,buff)接收；用对象方式时可用spi.deviceSetup()创建spi_device后调用spi_device:transfer()/spi_device:recv()（CS自动管理）。读SPI外设寄存器的典型做法：先spi.setup()初始化，再发"寄存器地址（含读标志位）"并在同一传输中读回数据，如 local recv = spi.transfer(spi.SPI_0, addr, 1, 1)。注意合宙模组硬件SPI总线ID为0/1。接口说明：https://docs.openluat.com/osapi/core/spi/ ，原始收发可参考官方spi demo。
57. Lora运行中模块死掉，系统还正常返回接收超时事件，怎么确认芯片处于接收模式？
解答： lora2核心库（支持LLCC68/SX1268）没有开放直接读芯片寄存器的接口，工作状态只能通过事件回调判断：发送完成触发"tx_done"、接收成功触发"rx_done"、接收超时触发"rx_timeout"、接收出错触发"rx_error"。如果芯片实际已异常（如SPI通信受干扰、芯片挂死），软件回调可能不可靠，最稳妥的工程做法是做超时看门狗：在应用层设定一个时间窗，若长时间（超过多次rx_timeout周期）无任何有效事件或收发失败，主动用GPIO拉LoRa芯片的复位脚（RESET）硬复位，再重新lora2.init()初始化、lora_device:mode(lora2.STANDBY/RX)和lora_device:recv(timeout)（timeout=0为持续接收）恢复链路。lora2接口与事件说明：https://docs.openluat.com/osapi/core/lora2/
58. 贴片卡用的usim2，usim1用的MicroSIM卡，想用插卡检测功能，推荐电路中的AGPIO3能用吗？
解答： LuatOS支持SIM卡热插拔（mobile库的SIM热插拔功能，拔卡/插卡会有日志提示并自动进出飞行模式重新搜网），插卡检测通过一个专用GPIO检测卡座上的卡检测脚（插拔时电平翻转）实现。关于AGPIO3：双卡单待方案中SIM1为原生SIM接口、SIM2为GPIO模拟（电源共用SIM1），检测脚需按硬件设计选择一个可用的中断GPIO，并在软件热插拔配置中传入对应引脚；只要该AGPIO在你的硬件上未被其他功能（如SIM2复用脚、摄像头）占用、电平设计符合检测逻辑（上拉/下拉与卡座常闭/常开触点匹配），即可用作检测脚。建议参照官方SIM硬件设计文档的推荐检测电路选脚：https://docs.openluat.com/air780epm/luatos/hardware/sim/ ；热插拔用法见 https://docs.openluat.com/air780epm/luatos/app/common/mobile/ （4.7节SIM卡热插拔）。
59. 8201G有外界扬声器推荐吗？
解答： 模组不能直接接喇叭，需经音频Codec+功放（PA）驱动，建议优先用合宙音频配件板验证：AirAUDIO_1000板载ES8311+D类功放PAM8302，可直接驱动2.5W/4Ω喇叭；AirAUDIO_1010板载ES8311+功放支持3W输出。喇叭选型按腔体和音量需求选4Ω/2~3W的小喇叭即可（普通纸盆/腔体喇叭音量和音质优于薄膜喇叭，薄膜喇叭体积薄但声压偏小）。配件板说明：https://docs.openluat.com/accessory/airaudio_1000/ ；8201G音频demo见 https://docs.openluat.com/air8201/software/8201G/volte/call/
60. TTS播报前有咔嚓声怎么解决？
解答： TTS播报前的"咔嚓"声是功放（PA）和Codec上电瞬间的pop音，根因是音频芯片/功放的电源没有受控、在上电或开始播放瞬间冲击喇叭。正确解决办法：①硬件上让Codec和功放的电源由模组GPIO控制，并在exaudio.setup(audio_configs)中正确配置pa_ctrl（功放控制脚）、codec电源脚及有效电平，由库按"先下电→播放前恢复→播放后下电"的时序管理，官方强烈建议这样做以消除pop音；②新音频框架下播放前会自动exaudio.pm(audio.RESUME)恢复ES8311、停止时exaudio.pm(audio.SHUTDOWN)下电省电，配合受控电源即可消除爆音。注意exaudio.setup只需初始化一次（不是每次播报都调）。参考官方TTS demo（module/Air8201/demo/audio/play_tts.lua）和文档：https://docs.openluat.com/osapi/ext/exaudio/
61. 回铃声比TTS音量大，能分别调整吗？
解答： 回铃声（CC铃声）和TTS都走同一套exaudio音频通道，统一用exaudio.vol(play_volume)设置播放音量（0~100，须在exaudio.setup初始化成功后调用），录音音量用exaudio.mic_vol()。旧版exaudio存在CC铃声无法单独设置音量的问题，2026-08-06更新的版本中exaudio.vol()已同步更新内部voice_vol变量、修复了CC铃声无法设置的问题，升级到新版库/固件后，回铃与TTS播放均按exaudio.vol()设定值出声。若两者听感仍不一致，多为音源本身电平差异，可统一用同一音量值并升级库版本验证。接口说明与版本更新见：https://docs.openluat.com/osapi/ext/exaudio/
62. 合宙有没有双卡4G模块，能在Linux下工作？
解答： 有双卡方案：Air780EPM/EHM等系列支持双卡单待（SIM1为原生接口、SIM2为GPIO模拟，电源共用SIM1），可插两张卡但同一时刻只驻留一张，配合软件实现双卡切换/热插拔。在Linux下可通过USB网卡方式（RNDIS/ECM）上网，Linux内核自带RNDIS/ECM驱动，免驱枚举出网卡（/dev/ttyACM*串口+usb0网络设备），拨号联网后即可作为Linux主机的4G网卡使用；AT指令通过ttyACM串口下发。目前双卡4G模组以邮票孔/核心板形态为主。具体型号和双卡能力见选型指南 https://docs.openluat.com/SelectionGuide/SelectionGuide/ ，双卡硬件设计见 https://docs.openluat.com/air780epm/luatos/hardware/sim/