常见问题 - 2026-09-07
数据日期：2026-09-07
1. Air8000W可以实现蓝牙、wifi、4g三种模式自由切换传输吗？
解答： 结论：Air8000W 集成 4G、Wi-Fi、蓝牙三种通信能力，可以在同一台设备上分别使用并按业务切换，但三者不能在同一时刻以同一链路绑定同一套 socket，需按"选择网卡→建立连接→传输"的方式在应用层调度。原理：LuatOS 中每种通信方式是独立网卡（4G、wlan、ble），通过 socket adapter / 多网融合库 exnetif 选择当前走哪条链路，切换前应关闭旧连接、在目标网卡就绪（IP_READY）后再建新连接；蓝牙 BLE 通常用于配网、短距透传，不适合大流量。实现要点：用 mobile/wlan 事件判断链路状态，用 exnetif.set_priority_order 或 socket.adapter 指定网卡，并在断线时重连。详见多网选择文档 https://docs.openluat.com/air8101/luatos/app/network_routing/ 与产品页 https://docs.openluat.com/air8000/ 。
2. 合宙官网docs的文档怎么本地保存下来？
解答： 结论：docs.openluat.com 暂无整站一键离线包，建议按"单页另存 / 浏览器打印为 PDF"的方式保存所需页面。操作步骤：① 在浏览器打开目标文档，按 Ctrl+P，目标打印机选择"另存为 PDF"，可完整保留排版与链接；② 需要图片一并保存时，用浏览器"另存为 网页，全部"；③ 批量需求可用支持递归下载的工具按目录抓取，但文档会持续更新，离线版本可能过时，开发时请以官网最新页为准。固件、demo 等工程文件可直接从对应产品的"固件版本/Demo"页或 Gitee 仓库 https://gitee.com/openLuat/LuatOS 下载。
3. 这个上位机使用不了，连接提示升级一直升级不成功？
解答： 结论：这是上位机软件与硬件版本不匹配导致的升级失败，需使用与板子版本对应的软件/固件。排查步骤：① 先确认板子丝印型号和硬件版本，在对应产品文档页下载与该版本匹配的上位机与固件，不要使用群内转发的来历不明压缩包；② 升级前确认 USB 数据线含 D+/D- 信号线、长度小于 1 米、关闭电脑蓝牙；③ 若设备处于异常状态，按 BOOT 上电强制进入下载模式后重新升级；④ 仍失败时保留 Luatools/上位机的完整日志截图，到合宙官方企业微信群或 docs.openluat.com 右下角入口反馈。烧录通用排查见 https://docs.openluat.com/common/howtodown/ 。
4. 780ehv + 1601加9寸屏幕这个组合可以吗？
解答： 结论：9 寸屏组合不强制使用 Air780EHV，应以整机功能需求来选型。说明：Air8601/Air8602 大屏智能柜一体机当前标配的通信模组为 Air780ER2，可直接满足常规联网需求；Air780EHV 是带语音（V 系列）能力的型号，只有在需要 VoLTE 通话、音频相关功能时才有必要。建议步骤：① 明确屏幕分辨率/接口、是否需要语音、是否需要定位等需求；② 对照 Air8601（人脸识别柜）https://docs.openluat.com/air8601/product/ 与 Air8602（大屏智能柜）https://docs.openluat.com/air8602/product/ 的规格确认标配配置；③ 有定制需求时通过官方企业微信群沟通。
5. 8601淘宝有买吗？
解答： 结论：Air8601 可在合宙官方淘宝店选购。商品链接：https://item.taobao.com/item.htm?id=1044223956828 。也可进入合宙官方店铺首页 https://luat.taobao.com/ 搜索"Air8601"查看最新在售配置与库存，产品资料见 https://docs.openluat.com/air8601/product/ 。
6. 最新固件在哪可以下载？
解答： 结论：固件按具体型号在 docs.openluat.com 对应产品页的"固件版本"栏目下载。示例（Air780EPM）：https://docs.openluat.com/air780epm/luatos/firmware/780epm_version/ 。其他型号同理，将网址中的型号替换为对应型号即可，例如 Air1601 为 https://docs.openluat.com/air1601/luatos/firmware/1601_version/ 。建议下载正式发布（release）版本并核对版本号，量产前在自己的业务脚本上做回归；烧录工具统一使用 Luatools，教程见 https://docs.openluat.com/common/Luatools/ 。
7. 模块死机是什么原因？需要把分析文件导出来吗？
解答： 结论：先升级到最新正式固件并用最小系统复现，确认是固件/脚本问题还是硬件问题，再决定是否需要导出 crash dump。处理步骤：① 到型号对应"固件版本"页下载最新正式固件重新烧录；② 说明当前使用的是合宙核心板/开发板还是自研板，自研板需重点检查 VBAT 供电能力与走线（4G 发射瞬时电流大，供电不足会触发异常复位）；③ 只保留最小复现脚本（main.lua + 必需 lib），确认在官方开发板上是否同样死机；④ 若最新固件仍复现，保留完整串口日志（含开机到死机全过程）、最小复现脚本、固件版本号，通过官方企业微信群提交研发分析；crash dump 文件可一并导出，能帮助定位死机调用栈。日志抓取方法见 https://docs.openluat.com/common/howtouselog/ 。
8. 量产后，如果每多用一年，要增加多少流量费？
解答： 结论：流量费只与所选 SIM 卡套餐和续费年限有关，与是否量产、用了第几年无关，不会逐年上涨。说明：常见套餐为 100MB/月，提供插拔卡（Micro/Nano SIM）与贴片卡（MFF2）两种形态，支持按年或多年购买，到期后按当时店铺公示价格续费。操作建议：在合宙官方淘宝店 https://luat.taobao.com/ 搜索"流量卡"查看现行套餐与续费价格，或联系店铺客服/官方企业微信群获取批量采购报价，最终以购买页公示资费为准。
9. 这个怎么购买？
解答： 结论：合宙核心板、开发板、模组及配件统一通过官方淘宝店购买。入口：https://luat.taobao.com/ ，在店内搜索具体型号（如 Air780EPM、Air8202、Air1601）即可下单。若需批量、定制或方案合作，可通过官方企业微信群（docs.openluat.com 网站底部二维码）联系商务。产品资料统一在 https://docs.openluat.com/ 查询。
10. 有没有硬件规格书，想问一下峰值电流？出货批量测试发现很多峰值电流3.6a的模块正常吗？
解答： 结论：规格书可在对应型号产品页"硬件设计手册/数据手册"下载；模组供电设计应满足手册电气参数，量产线测到 3.6A 尖峰通常是测量方式或电源环路问题，不能直接判定模组异常。说明：4G Cat.1 在发射时隙会出现毫秒级脉冲电流，若用普通万用表、电源限流环路或在长走线后测量，容易因电源动态响应和环路电感产生过冲/振铃，显示值偏大。排查步骤：① 下载该型号硬件手册，按 VBAT 推荐电压、最大电流和推荐电容（通常需在 VBAT 就近并联大容量低 ESR 电容）设计供电，电源峰值供电能力留足裕量；② 用示波器电流探头（或小阻值采样电阻）在 VBAT 近端、20MHz 带宽限制下抓真实脉冲；③ 用合宙核心板做对比，排除产线夹具接触电阻和线材压降；④ 若同样条件下核心板也复现，记录波形、固件版本与 IMEI 提交官方分析。手册入口示例：https://docs.openluat.com/air780epm/ 。
11. AIR724的手册哪儿下载？
解答： 结论：Air724（Air724UG 系列，基于 UIS8910DM 的 Cat.1 模组）手册可在官方文档站 Air724UG 产品页下载。入口：① 产品与资料总览 https://docs.openluat.com/air724ug/product/ ；② 《Air724UG 硬件设计手册》PDF（V3.7，含管脚、电源、SIM、音频、射频、电气特性）https://docs.openluat.com/air724ug/product/file/Air724UG_%E7%A1%AC%E4%BB%B6%E8%AE%BE%E8%AE%A1%E6%89%8B%E5%86%8C_V3.7.pdf ；③ 软件资料（LuatOS/Luat 脚本 demo、固件）在 https://docs.openluat.com/air724ug/luatos/ 。注意 Air724UG 属于需要安装 USB 驱动的系列，驱动与烧录排查见 https://docs.openluat.com/common/usb_drv/ 和 https://docs.openluat.com/common/howtodown/ 。
12. iRTU的固件下载链接发我下？
解答： 结论：iRTU（LuatOS-iRTU 免开发透传固件）按模组型号分别提供，需先确认具体型号，再到对应产品文档页的"LuatOS-iRTU 介绍/固件"栏目下载，或直接用 Luatools 在线获取。获取方式：① 告知模组丝印型号（如 Air8781P、Air8700、Air8202 等）；② 示例入口——Air8781P 的 iRTU 说明 https://docs.openluat.com/air8781p/luatos/hardware/irtu/ ，Air8700 的 iRTU 说明 https://docs.openluat.com/air8700/luatos/hardware/irtu/ ；③ 也可打开 Luatools，在"下载固件"中按型号选择 iRTU 量产固件直接烧录。iRTU 配置通过网页/上位机完成，文档与工具汇总见 https://docs.openluat.com/common/Luatools/ 。
13. AIR1601能支持USB摄像头转以太网推流吗？
解答： 结论：Air1601 可接入 USB 摄像头（最高 100 万像素）做拍照/采集，但其定位是高性能 Cortex-M7 MCU，自身不带以太网和 Wi-Fi/4G，不能独立完成"USB 摄像头→以太网推流"；该需求应选多媒体联网 SoC Air8101（Wi-Fi6+以太网，支持 USB/DVP 摄像头和 RTMP 推流）。说明：官方已在 Air8101 上提供 UVC 摄像头（AirCAMERA_1030/1031）H.264 编码 RTMP 推流方案，可走 Wi-Fi 或以太网，也可通过 AirLink over SPI 外挂 4G 模组上行。方案要点：① 选 Air8101 + 官方验证摄像头；② 参考 UVC 接口文档 https://docs.openluat.com/air8101/luatos/hardware/uvc/ 与 excamera 库（work_mode=3 为 RTMP 推流模式，接口 excamera.open/excamera.rtmp）https://docs.openluat.com/osapi/ext/excamera/ ；③ 可用官方测试平台 https://video.luatos.com/ 验证。Air1601 规格见 https://docs.openluat.com/air1601/ 。
14. 第一次使用Luatools下载时不识别，按钮按了没反应，是什么原因？
解答： 结论：首次烧录必须同时添加"内核固件（core）+ 脚本（script）"，只添加脚本时设备中没有可运行的 LuatOS 内核，Luatools 无法正常走下载流程，表现为无反应/不识别。操作步骤：① 打开 Luatools，进入项目管理，新建项目时同时选择对应型号的正式固件（.soc）和你的脚本目录（含 main.lua）；② 断电后让 Luatools 进入下载等待，再按住 BOOT 上电，必要时长按开机键；③ 确认数据线含 D+/D-、长度小于 1 米、关闭电脑蓝牙，780/8000/8201 系列免驱，Air724 等老型号需先装 USB 驱动。完整烧录步骤与排查见 https://docs.openluat.com/common/howtodown/ 。
15. 请问Air780EPM 1.2版本外部供电用什么电源？适配这种引脚的电源找不到呢
解答： 结论：Air780EPM 核心板/开发板外部供电不用找专用插头，直接用可调直流稳压电源接到板上的"4V"插针（正极）和 GND 插针（负极）即可，供电电压 3.3V~4.3V，典型设 3.8V，并把供电切换开关拨到外部供电一侧。要点：① 模组 VBAT（PIN42/43）电压范围 3.3V~4.35V，持续供电能力需 ≥1A、瞬间 ≥2A，电源就近并联大容量低 ESR 电容（参考设计 1000μF）应对发射脉冲；② 不要使用 5V 直接接 4V 插针，5V 仅从板载 USB 口经板上 DCDC 降压；③ 若整机为 12V 供电，需先经降压 DCDC（官方参考 JW5357/JW5103）输出 3.8V 再进 VBAT，并选配合适 TVS。详见开发板使用说明与供电章节 https://docs.openluat.com/air780epm/luatos/hardware/vbat/ 。
16. crm.luatos.com的AI问答服务提问报Failed to fetch，是什么问题？
解答： 结论："Failed to fetch" 表示网页到 AI 服务的请求未成功返回，优先按网络与服务端两类原因排查。处理步骤：① 刷新页面、退出重新登录，清除浏览器缓存或换 Chrome/Edge 无痕窗口重试；② 检查本机网络、公司防火墙/代理是否拦截了该站点的接口请求，可切换网络（如手机热点）验证；③ 确认输入未超长、附件未超限；④ 若多个用户、多个网络均持续报错，属于该站点服务侧异常，可临时改用官方 AI 问答入口 https://ai.luatos.com/ ，并通过官方企业微信群反馈故障现象与时间。技术文档仍以 https://docs.openluat.com/ 为准。
17. 这个板子支不支持充电即开机，不需要按开机键来完成开机动作？
解答： 结论：能否"插电/插 USB 自动开机"取决于具体型号的电源与充电管理设计，不能一概而论，需按所用板子确认。已知差异：Air8202 板卡的充电管理芯片支持通过指令进入船运（ship）模式关机，之后插入 USB 上电会自动开机；Air8201 系列中 Air8201G 不支持该方式，Air8201H 支持。实现思路：① 明确产品是否要求"上电即开机"以及是否带电池；② 在对应型号硬件文档中确认 PWRKEY/CHRG_DET 与充电 IC 的上电时序；③ 也可在外部用电源检测电路在供电时拉低 PWRKEY（>1 秒）实现等效自动开机。请以型号文档为准：Air8201 https://docs.openluat.com/air8201/ ，Air8202 https://docs.openluat.com/air8202/product/ 。
18. 麦克风和喇叭是可以选配的吗？
解答： 结论：麦克风、喇叭属于可选配件/外设，需结合具体整机型号确认标配情况；受外壳音腔结构限制，部分整机不内置标准喇叭，而是在板上预留喇叭焊盘由客户外接。说明：① 是否预留 MIC/SPK 焊盘、推荐阻抗功率（如 8Ω/1W 规格）以该型号硬件手册为准；② 外接喇叭要匹配音腔与功放输出，麦克风要注意差分走线和 TDD 降噪；③ 无音频需求的版本可不上料以降低成本。请提供具体板子型号以便给出准确接口定义，资料入口 https://docs.openluat.com/ ，配件可在 https://luat.taobao.com/ 选购。
19. GNSS定位精度太低，只到小数点后2位，LBS定位精度到小数点后4位，通常定位精度是多少？
解答： 结论：不能用经纬度小数位数判断精度。GNSS 输出的是标准 NMEA 经纬度（度分格式 ddmm.mmmm），小数位少通常是解析/格式化时截断造成的，与真实定位精度无关；而 LBS 是单基站定位，坐标给得再"精确"，其实际误差也有几十到几百米甚至更大。原理：GNSS 室外开阔环境典型精度约 2.5~5 米（CEP），LBS/Wi-Fi 定位本身是粗定位。处理步骤：① 用 libgnss 正确解析 NMEA，保留足够小数位，不要在中间环节 round 截断；② 在室外开阔天空、天线朝上条件下测试，室内 GNSS 无法定位；③ 注意 WGS-84 与 GCJ-02 坐标系差异，国内地图叠加时需做坐标转换，可用官方 GPS 纠偏工具 https://docs.openluat.com/file/GPS-Offset.html 核对位置。GNSS 调试见 https://docs.openluat.com/air8201/software/8201G/gnss/gnss_test/ 。
20. 为什么断电后通过普通GPIO驱动LED会出脉冲导致闪烁，哪些IO休眠不掉电？
解答： 结论：低功耗/PSM+ 模式下只有 AGPIO（AON 域）能保持休眠前电平，普通 GPIO 所在的 VDD_EXT 电压域间歇或完全掉电，引脚进入高阻态，外接 LED 就会出现脉冲闪烁。原理（官方低功耗说明）：低功耗模式下普通 GPIO 随 VDD_EXT 按 0.64/1.28/2.56 秒节奏间歇供电，PSM+ 下完全掉电；AGPIO 在低功耗模式可保持电平并受控、PSM+ 下仅保持不可控，WAKEUP/AGPIOWU 可做唤醒输入。设计要点：① 需要休眠时常亮/常灭的指示，选用 AGPIO，并按数据手册确认具体 AGPIO 编号；② AGPIO 驱动能力弱，不要直接带 LED，应加三极管/MOS 管扩流，或用 V_REF 配合上拉固定电平；③ 普通 GPIO 想固定电平可用上拉/下拉到 Vref。详见 https://docs.openluat.com/common/airpower/ 。
21. 发送PUBLISH上行业务包，没有重置keepalive计时器，推迟PINGREQ，当前的mqtt库是这样的吗？
解答： 结论：按 MQTT 3.1.1 协议，客户端在 keepalive 周期内只要发送了任意控制报文（含 PUBLISH），就应重置保活计时、推迟 PINGREQ；LuatOS mqtt 核心库只支持 3.1.1，其保活由库内部管理，正常情况下业务报文会刷新保活计时。实现说明：① 通过 mqttc:keepalive(time) 设置保活时间（秒），未设置默认 240 秒，库内部按约 0.75 倍时间提前发送心跳，并通过 "pong" 事件回报心跳应答；② 无需也不建议自己再发 PINGREQ；③ 抓包若发现发了 PUBLISH 仍按固定节奏发 PINGREQ，请记录固件版本并抓包（含报文时间戳），先升级到最新正式固件验证，再将抓包与最小脚本通过官方企业微信群反馈底层确认。注意该库上行数据不缓存、不重发，发送失败即断开重连。文档：https://docs.openluat.com/osapi/core/mqtt/ 。
22. VBAT和VBUS都接3.8V电源可以吗？需要用12V供电，USB下载口是有个5V转4V到VBUS的。
解答： 结论：不可以把 VBAT 和 VBUS 都接 3.8V，模组必须由 VBAT 供电，VBUS 不能作为电源输入。原理：① VBAT（PIN42/43）才是模组主电源，要求 3.3~4.35V、典型 3.8V，持续供电能力不低于 1A、瞬态不低于 2A，并就近放置大容量储能电容；② VBUS（PIN61）内部接到 WAKEUP1，仅用于 USB 插入检测和 PSM+ 唤醒，5V 在模组内部分压后做电平判断，官方明确"VBUS 不参与任何系统供电，更无法替代 VBAT"，给 VBUS 灌 3.8V 既不能给模组供电，还会造成插入检测/唤醒异常。正确做法：① 12V 输入经 DCDC 降压到 3.8V 后只接 VBAT（开发板参考设计使用 JW5357/JW5103 等 DCDC）；② VBUS 保持原 USB 5V 检测路径，不要与 VBAT 短接；③ 板载 USB 口的 5V→4V 路径仅供下载/调试时供电使用，量产外接电源不要复用该支路。文档：https://docs.openluat.com/air780epm/luatos/hardware/usb/ 与 https://docs.openluat.com/air780epm/luatos/hardware/vbat/ 。
23. 我们做了一个板子，插上USB，按住BOOT开机，Luatools怎么都无法识别。可以帮忙检查一下原理图吗？
解答： 结论：按住 BOOT 上电仍识别不到，先按下载链路自查，再把原理图 PCB 提交合宙免费评审（drawcheck）。自查步骤：① 确认已真正进入 BOOT 模式——设备管理器只出现 1 个下载口才算成功，出现 3~4 个口说明仍在正常开机；② 检查 USB：数据线必须是数据线不是纯充电线，D+/D- 等长走线、靠近模组，Air724UG/Air724/Air720/Air795/Air820 等老平台需安装 USB 驱动，780/8000/8201 免驱；③ 检查供电：VBAT 3.3~4.35V，发射瞬间电流要够（持续≥1A、瞬态≥2A），VBAT 就近加大电容，供电不足时 USB 枚举会失败；④ BOOT 脚拉到 1.8V（或与 VDD_EXT 短接）再上电，必要时直接短接 1.8V 与 BOOT 两个测试点。仍无法定位时，把原理图和 PCB 提交 https://docs.openluat.com/value/drawcheck/ 排队评审。下载操作可参考 https://docs.openluat.com/common/howtodown/ 。
24. 这个板到货了，怎么用？
解答： 结论：由于提问未附带型号和板卡照片，无法给出针对性步骤，标准上手流程如下。操作步骤：① 先确认板卡丝印/订单型号（如 Air780EPM 开发板、Air8202 定位器、Air8300 工控板等），型号决定接线与固件；② 到 https://docs.openluat.com/ 对应产品页，按"硬件环境清单→软件环境清单→烧录（download）→HelloWorld→示例 demo"顺序操作；③ 4G 类板卡装好天线、插入开通流量且未欠费的 SIM 卡（定向卡需把业务域名加入白名单），用数据线连接电脑，在 Luatools 中确认端口、下载最新内核 core 与脚本（首次必须底层 core 和脚本一起烧）；④ 免开发整机（如 Air8202）插电池/上电即可在 move.luatos.com 查看定位，无需烧录。请把板卡正面照片和购买订单截图发到合宙官方企业微信群，可获取该型号的精确资料链接。支持渠道见 https://docs.openluat.com/ 。
25. Air8201支持自己layout吗？提供原理图和bom吗？
解答： 结论：Air8201 系列支持自主 Layout，官方提供原理图、PCB 封装和 BOM 等硬件参考资料，可直接下载。获取方式：① 打开 https://docs.openluat.com/air8201/ 对应子型号（8201G/8201H）资料中心，在"硬件"栏目下载《硬件设计手册》、原理图、PCB 封装和参考设计；② 自主 Layout 时重点关注 VBAT 供电与储能电容、SIM 走线、4G/GNSS 天线匹配与净空、USB/BOOT 下载电路，并在投板前把原理图、PCB 提交 https://docs.openluat.com/value/drawcheck/ 免费评审；③ 若不想做硬件设计，可直接采用 Air8201 工业模组/板卡或 Air878x 系列免硬件方案快速量产。资料入口：https://docs.openluat.com/air8201/ 。
26. 升级状态显示禁止时咋回事？
解答： 结论：这是升级平台的"循环升级保护"被触发，属于防呆机制，不是模组损坏。原因：当设备在 1 小时内连续请求升级达到 6 次仍未成功（常见于升级后版本号没变、脚本异常立即重启又请求、下载包错误等），平台会把该 IMEI 标记为"已禁止升级"，避免反复下载耗光流量。处理步骤：① 先修正升级包本身——确认设备端 VERSION 为 x.y.z 数值格式且升级后确实大于旧版本（用合宙 IoT 平台时版本号中间位 y 会被忽略，建议写 0），PROJECT/PRODUCT_KEY 与平台一致；② 登录 https://iot.openluat.com/ ，在"设备列表"中找到该 IMEI，确认异常已处理后点击解除升级限制；③ 设备重启后会重新检测升级（非推送，最长约 24 小时内或重启时请求）。自建 libfota2 服务器时应在服务端加 IMEI、版本号、循环请求校验。参考：https://docs.openluat.com/air8201/software/8201H/ota/fota3rd/ 。
27. 这个设备不知道什么原因一直没有升级成功？
解答： 结论：持续升级失败，多数是设备已被"循环升级保护"禁止，或升级包/网络不满足条件，按顺序排查。排查步骤：① 登录 https://iot.openluat.com/ 进入该项目"设备列表"，查看该 IMEI 状态，若显示"已禁止升级"，先确认升级异常已修复再手动解除限制（截图时请截全设备列表，便于定位 IMEI 和解禁按钮）；② 检查升级包：VERSION 为 x.y.z 且新版本号大于旧版本、PROJECT/PRODUCT_KEY 与平台一致、core 只能向上差分、不同后缀固件不可互升；③ 检查网络：SIM 未欠费、定向卡需把 iot.openluat.com（自建服务器则是自己的域名）加入白名单、信号正常；④ 设备端 fota 回调码：1 连接失败、2 url 错误、3 服务器断开、4 报文错误、5 版本号格式错误，按回调码定位；⑤ FOTA 非推送，重启后或最长 24 小时内才检测。参考：https://docs.openluat.com/air8201/software/8201H/ota/fota3rd/ 。
28. 换了这个新的exsipclient.lua库后，就呼不进来了，呼出也一样呼不出去？
解答： 结论：该现象是 exsipclient 库与底层 core 版本不匹配导致 SIP 通话状态机异常（重启后能呼出，呼入一次后呼入呼出都失败），需要"库 + 内核固件"配套升级。处理步骤：① 不要只替换 exsipclient.lua，必须同时把 Luatools 资源中的底层 core 和 exsipclient 库都更新到同一最新正式版本（二者分开更新是此类问题的主要诱因）；② 用官方 SIP demo 不改动业务代码先回归呼入/呼出，确认是否为库与固件的兼容问题；③ 若最新正式版本仍可稳定复现，记录模组型号、core 版本号，抓取 SIP 注册/呼叫全过程 trace 日志和最小复现脚本，通过官方企业微信群反馈以获取验证固件。SIP 相关资料见 https://docs.openluat.com/ 对应产品页。
29. Air780EHV新音频框架，本地TTS外放+立即拨号，对方接通瞬间必死机，如何解决？
解答： 结论：TTS 外放通道未完全释放就发起 VoLTE 呼叫，接通瞬间音频资源与通话链路并发会触发异常重启；先做软件规避，仍复现再抓底层日志。规避与定位：① 调整时序——TTS 播放结束后等待播放完成回调、调用音频释放接口停止并释放播放通道，再延时数百毫秒后执行拨号，不要在播放中立即呼叫；② 升级到最新正式 core 固件和对应音频库，确认新音频框架下的音频通道互斥用法与官方 demo 一致；③ 用最小脚本（只保留 TTS 外放→拨号）验证，排除其他音频任务并发；④ 若在最新固件、严格按官方规避方式后仍必现，用 Luatools 开启并抓取 AP/CP 日志及 ramdump（log 目录下 4gdiag、ramdump），附型号、固件版本、最小脚本和复现时间，通过官方企业微信群提交分析。音频资料见 https://docs.openluat.com/ 对应产品多媒体章节。
30. 780EPM不支持AT，那对应的AT型号是什么？
解答： 结论：Air780EPM 是 LuatOS 二次开发型号，硬件上不支持 AT 指令开发；对应同封装、同硬件平台的 AT 型号是 Air780EPT（北美频段版对应 Air780EVT/Air780EHN 系列，按目标地区选择）。说明：EPM 与 EPT/EVT 是不同出厂固件、不同定位的型号，不能通过给 EPM 刷固件变成 AT 版本，选型时应在 https://docs.openluat.com/SelectionGuide/SelectionGuide/ 按开发方式确认型号；若需要 AT 开发请直接采购 Air780EPT 型号。
31. 780epm出厂固件是AT的吗？能否提供出厂固件？
解答： 结论：Air780EPM 定位为 LuatOS 二次开发型号，官方提供并维护的是 LuatOS 固件，应直接在 LuatOS 下用 Lua 开发，不应按 AT 型号使用。说明：① 若需要完整 AT 指令集，请改用对应 AT 型号 Air780EPT；② EPM 的最新固件（core）和默认 lib 可由 Luatools 自动下载，也可从 https://docs.openluat.com/air780epm/luatos/firmware/780epm_version/ 获取，烧录时底层 core 与脚本首次必须一起下载；③ 不存在"给 EPM 刷成完整 AT"的官方固件。如手头模块表现与型号不符，请核对模块丝印型号或联系销售确认发货型号。
32. 780epm烧写时为何不用boot+reset按钮了？出厂固件也是这样吗？
解答： 结论：在正常运行的 LuatOS 固件下可以"免按 BOOT"下载，这是软件引导方式，不是取消了 BOOT 功能，出厂固件同样支持。原理与条件：① 强制 BOOT 模式是 BOOT 脚上电时为高（拉到 1.8V，或 BOOT 与 VDD_EXT 短接）的时长大于 A 阈值即进下载口，属于硬件兜底，任何情况下都可用；② 免 BOOT 是模组已开机且固件正常时，Luatools 通过串口/USB 下发软件重启指令，让模组自行重启进入下载模式（即 A<B 的常规重启路径），所以无需按键；③ 免 BOOT 只在固件未死机、USB 能正常枚举出 3~4 个端口时有效；一旦固件跑飞、首次烧录或 USB 已识别不到，就必须按 BOOT+POW（或 BOOT+复位）强制进入，设备管理器只出现 1 个下载口才表示进入成功。详见 https://docs.openluat.com/common/howtodown/ 与 https://docs.openluat.com/air780epm/luatos/common/download/ 。
33. Air780EGT核心板接主机联网后，能否用苹果或安卓手机远程查看定位、接收数据和发送指令？有没有现成的App或手机网页？如果有配套平台是否另外收费？
解答： 结论：可以实现手机远程查看定位、收发数据和指令，但没有强制配套的专属 App，手机端访问由你接入的云平台决定。方案选择：① 自建平台：Air780EGT 通过 TCP/MQTT/HTTP 把定位与数据发到你自己的服务器，你用自适应网页、微信小程序或自建 App 访问，数据不经合宙平台，无平台费用；② 合宙平台：接入 iot.openluat.com（设备管理/数据上云）或定位类的 move.luatos.com，用浏览器/移动端页面查看，合宙 IoT 平台测试版有每日上行消息免费额度（测试版每日 1000 条），超出后按 VIP 套餐或消息量扩容收费，具体标准见 https://docs.openluat.com/value/iot/ ；③ 若希望"到手即用、插电池就上报、自带手机网页"，可直接选免开发定位器 Air8202（主控为 Air780EGG），演示见 move.luatos.com。平台收费与私有部署可咨询官方企业微信群。
34. 780EX2给1602供网，lcd_drv与airlink（uart3)有冲突吗？我的现象是启用ui后airlink会马上false。
解答： 结论：这是典型的外设资源/引脚复用冲突——UI（lcd_drv）初始化时占用了 airlink 所用的 UART3 引脚，导致 airlink 立即变 false，并非网络功能本身故障。排查步骤：① 查阅所用固件的引脚复用表（pins），确认 LCD 驱动用到的引脚（如 SPI/I2C/数据/控制脚）与 UART3 的 TX/RX 是否重叠；② 物理上把 airlink 改接到其他空闲串口，或把 LCD 改到不冲突的引脚，避免二者复用同一组 IO；③ 用开发板做对照：先只跑 airlink（不初始化 UI）确认为 true，再初始化 UI 复现 false，即可锁定为引脚冲突；④ 同步升级到最新 core 固件与 lcd/airlink 库，并在初始化顺序上先初始化显示、再初始化网络。仍无法定位时，把模组型号、固件版本、两组引脚分配表和最小复现脚本发到官方企业微信群。API 资料：https://docs.openluat.com/osapi/ 。
35. AI给出的答案不对，把pin37理解成GPIO(37)，这个37脚是内部使用的吗？
解答： 结论：AI 的说法有误——pin（管脚/焊盘序号）与 GPIO（端口编号）是两套编号，不能把 PIN37 当作 GPIO37 使用；该产品手册中 PIN37 对应的是 GPIO14。原理：LuatOS 的 gpio.setup/gpio.set 等 API 的第一个参数要填 GPIO 端口号，不是邮票孔/PIN 序号，二者只有查对应型号的管脚映射表（pins）才能换算。操作要点：① 到 https://docs.openluat.com/ 对应产品页的管脚表，按板上实际焊盘 PIN 序号查到 GPIO 编号，再写入代码（本例应使用 gpio.setup(14, ...)）；② 若该管脚被标注为特殊功能/内部保留，则不要当普通 GPIO 使用。此类 pin↔GPIO 换算以官方管脚表为准。
36. 需要从Air8000A换成Air8000U进行SIP通话测试，它的底层固件需要修改吗？
解答： 结论：Air8000A（国内版）与 Air8000U（欧亚版）的核心区别是硬件射频频段不同，不能通过给 A 刷 U 的固件来改变频段；但二者 LuatOS 软件框架、SIP 通话库用法一致，业务 Lua 脚本一般可直接复用，SIP 功能本身不需要为换型号改底层。注意事项：① Air8000U 必须使用 Air8000U 对应的最新 core 固件和配套 lib，不要与 A 的底层混用；② 建议把 Luatools 升级到最新，并下载 U 型号对应的最新 core、exsipclient 及相关音频库后整体烧录验证；③ 海外卡通常需要正确配置 APN，请确保产品可手动设置 APN；④ 频段与国家对应关系见 https://docs.openluat.com/air8000/product/pinduan/ ，上市前需在目标国家实地场测。
37. 网页AI总是报错(Failed to fetch)，是什么原因？
解答： 结论：Failed to fetch 是前端未能成功连接到 AI 问答后端的网络/服务类报错，不是你账号或问题本身的错误。原因与处理：① 多为服务端瞬时繁忙或网络链路问题，请稍后重试或刷新页面、更换浏览器/网络后再提问；② 检查本机是否有代理、防火墙拦截了对问答接口的请求；③ 若网页端持续不可用，可改用官方智能问答助手 https://ai.luatos.com/ （登录后使用，提示"对话服务错误"时多问几遍即可）；④ 仍无法恢复时，把报错截图、时间、账号通过合宙官方企业微信群反馈。查资料的第一手入口始终是 https://docs.openluat.com/ 。
38. ADC量程开了分压最高3.3V，实际需要量程4.2V，外围也加了分压1:1，8000W和8000T表现不一样，能解决吗？
解答： 结论：ADC 满量程由芯片决定，超量程必须靠外部分压把电压降到通道可测范围内，再在软件里乘回分压比；8000W 与 8000T 表现不一致，通常是分压后落点和内部量程/分压配置不一致所致。要点：① 先查对应型号 ADC 文档确认内部量程（部分通道内置分压），外部目标 4.2V 时按分压后峰值落在线性区间（1.6V 以下更稳）选取电阻比，例如约 2.2:1；② 外部分压与模组内部分压是两级，不能重复算错，代码中 adc.open 的量程参数要与实际硬件一致，并把读数按总分压比还原；③ 分压电阻选高精度（1%）、阻值不要过大以免输入阻抗带来误差，必要时加跟随/滤波；④ 两型号结果不一致时统一升级最新固件、用同一标定电压分别校准，并确认是否用了对应型号推荐通道。文档：https://docs.openluat.com/osapi/core/adc/ 及各产品 ADC 章节。
39. 电池充满电后跟电源IC通信不上，是什么原因？
解答： 结论：满充后与电源/充电管理 IC 通信不上，多为充电参数设置过激导致满充瞬间系统电压/总线异常，或 I2C 总线被外设挂死，并非一定是芯片损坏。排查与配置：① 充电电压按电池规格设置（高压锂电满充 4.35V，普通 4.2V，以电芯规格书为准），充电电流不要长期顶满，建议按 0.2C~0.5C 设置并配置合理的截止电流与 NTC 温度保护；② 先把已过充的电池用负载放电到正常区间再测试，避免在异常高电压下反复上电；③ 检查 I2C：SCL/SDA 上拉、走线、地址是否正确，总线上其他器件是否在满充时把 SDA 拉低导致通信挂死，可加超时复位/总线恢复逻辑；④ 用逻辑分析仪抓满充瞬间波形，确认是无应答还是总线卡死。合理充电有利于电芯寿命与安全。具体充电 IC 用法见对应产品充电电路/电源文档（https://docs.openluat.com/ ）。
40. LBS订单列表添加设备总是报错提示设备不是我的，如何处理？
解答： 结论：提示"设备不是我的"，是因为该 IMEI 已被其他账号/订单绑定（LBS/WiFi 定位是收费服务，按订单和 IMEI 授权），当前账号没有这台设备的归属权。处理步骤：① 在 https://iot.openluat.com/ "订单管理/设备列表"中用完整 IMEI 核对它是否已在你自己的其他项目或同事账号下，若绑错项目，先在原账号删除/解绑再重新添加；② 确认购买 LBS 服务的订单账号与当前登录账号一致，订单内 IMEI 清单要包含该设备；③ 若 IMEI 被陌生账号占用或系统自动生成列表有误，记录完整 IMEI、订单号、报错截图，通过官方企业微信群或销售提交，由后台核对生产/订单归属后处理；④ 测试阶段也可先用免费基站定位（lbsLoc2）验证流程。LBS 免费/收费区别见 https://docs.openluat.com/air780ex/luatos/app/common/lbswifi/ 。
41. 设备连不上自己服务器的地址和端口，可能是什么原因？
解答： 结论：连不上自建服务器，按"网络→卡→域名→服务器"四层顺序排查，可用合宙测试服务器做对照。排查步骤：① 确认已注网并拿到 IP（等待/检查 IP_READY、mobile 状态与 CSQ 信号）；② SIM 卡能上网、未欠费、APN 正确；若是定向流量卡，必须把服务器域名/IP 和端口加入运营商白名单（这是连自建服务器失败最常见原因）；③ 域名先换成 IP 直连测试，排除 DNS 解析失败，必要时 socket.setDNS 指定 114.114.114.114；④ 服务器侧确认端口已监听、防火墙/安全组放行、云主机公网 IP 正确、有 TLS 时证书有效；⑤ 用官方 TCP 长连接 demo 先连合宙测试服务器 https://netlab.luatos.com/ ，能通则说明模组侧正常、问题在自建服务器或卡的白名单。连接失败可结合 socket 错误码（-3 超时、-11 链接未建立、-13 模块断开、-14 服务器断开）定位。参考：https://docs.openluat.com/osapi/core/socket/ 。
42. 780Epm和EHV的实际网速是多少？录音产生32K/秒不能实时发出去，积压严重。
解答： 结论：32KB/s（约 256kbps）在 Cat.1 理论能力之内（Air8000/780E 系列上行理论最大约 5Mbps、下行约 10Mbps），但实网速率受运营商限速、信号、小区负载影响很大，持续上行积压通常是发送背压没处理好，而不是模组带宽不够。原因：socket 是异步的，socket.tx 返回 full=true 表示底层发送缓冲已满，若业务仍连续塞数据就会积压。处理：① 升级到最新 core 固件；② 录音侧做流控分包，每包不宜过大，收到 socket.TX_OK 或 full=false 后再发下一包，发不出去时暂停/丢弃非关键音频帧而不是无限缓存；③ 合理使用接收/发送缓存接口（如 socket.rx_cache，参数单位按所用固件文档，48 即 48KB），并检查 libnet.tx 的发送超时是否过短；④ 在信号好的环境用 TCP 直传公网服务器实测上行带宽，确认 SIM 卡未被运营商限速（物联网卡常被限速到远低于峰值）。参考：https://docs.openluat.com/osapi/core/socket/ 。
43. libnet.tx如何设置buffer大小？TCP发送第一条成功后续都返回缓冲区满。
解答： 结论：libnet.tx 本身没有"buffer 大小"参数，"第一条成功、后续一直缓冲满"是因为底层 socket 发送队列已满而业务没有等待发送完成事件，正确做法是做发送背压而不是调大一个并不存在的参数。原理：socket.tx 第二返回值 full=true 即表示缓冲区满，需等到 socket.TX_OK 事件/消息后再继续发；libnet.tx 是基于异步 socket 的同步封装，必须在 sys.taskInitEx 创建的任务里调用，靠它阻塞等待发送结果。处理要点：① 每次发送都判断 libnet.tx 返回值，失败则重连，配合发送队列逐条出队，不要在队列满时继续堆积；② 发送超时 timeout 给足（官方建议 10~20 秒）；③ 服务端及时收数据，否则 TCP 窗口关闭也会导致模组侧一直满；④ 确需更大底层缓冲可结合 socket 缓存配置接口（如 socket.rx_cache）评估，但关键仍是按 TX_OK 节流。API 见 https://docs.openluat.com/osapi/ext/libnet/ 与 https://docs.openluat.com/osapi/core/socket/ 。
44. AIR8000T的4G STATUS状态灯在原理图上没看到对应的引脚，是怎么回事？
解答： 结论：4G STATUS（网络状态指示灯）通常不是固定功能脚，而是由一个普通 GPIO 经软件读取注网状态后驱动，所以在"功能引脚"表上看不到专用脚；具体用哪个 GPIO 必须以你所用板卡原理图/网络灯网络名为准，不能脱离硬件直接套用某个编号。做法：① 打开 Air8000T 对应板卡原理图，搜索 NET_STATUS/NETLIGHT/STATUS_LED 之类网络名，确认其接到的 GPIO 编号（部分 Air878x 参考板的网络灯在 GPIO27，工程验证中也有使用 GPIO21 的，均以你自己的板卡为准）；② 软件上在注网成功（IP_READY/注册网络）后翻转该 GPIO 做心跳，或复用模组网络状态指示逻辑；③ 若该脚被复用为其他功能，可任选一个空闲普通 GPIO 外接指示灯自行控制。管脚定义以 https://docs.openluat.com/air8000/ 对应硬件手册为准。
45. AIR724烧录失败后USB一直识别不到，短接boot、换线换电脑都无效，怎么解决？
解答： 结论：这是 Air724UG（8910 平台）烧录失败后未进入下载模式的典型现象，普通按 BOOT 无效时，可用"强制拉高 BOOT"法恢复。操作步骤：① 断电，打开核心板/模组外壳，找到板上 1.8V（VDD_EXT）测试点和 BOOT 测试点；② 用金属镊子或杜邦线短接这两个点并保持，然后给模组上电，使 BOOT 在开机瞬间被强制拉到 1.8V，进入强制下载模式；③ 在电脑设备管理器确认出现下载端口（Air724 需先装好 USB 驱动），Luatools 选择正确底层和脚本，底层 core 与脚本首次必须一起烧；④ 开始下载后再松开短接，烧录完成后断电取消短接、重新正常上电；⑤ 全程使用确认可传数据的 USB 数据线、VBAT 供电充足。原理与完整步骤见 https://docs.openluat.com/common/howtodown/ 。
46. 请问有TAC码的证明文件吗？如果TAC码是你们的，对应的模组只会是你们的吗？
解答： 结论：TAC（IMEI 前 8 位，Type Allocation Code）标识的是型号核准主体，若某 TAC 为合宙注册，则使用该 TAC 的设备型号对应合宙，但具体到单片模组是否为合宙生产、是否正品，仍需用完整 15 位 IMEI 核对生产记录，不能仅凭 TAC 断言。说明与处理：① 同一 TAC 通常对应用同一型号核准的一类产品，合宙不同型号会使用各自注册的 TAC；② 需要 TAC 归属/型号证明（用于入网、认证、招标等）时，把完整型号、用途和所需文件说明通过销售或官方企业微信群申请，合宙可提供对应的认证/型号核准类资料；③ 对无法确认来源的模组，请提供完整 IMEI（不要只给 TAC）和丝印照片，由销售/售后在生产系统中核验是否为合宙出货产品。认证资料可在 https://docs.openluat.com/ 对应产品"认证"栏目下载。
47. 8782P2只引出了一个485口，产品需要2-3个485口怎么办？
解答： 结论：需要 2~3 路 RS485，优先直接选双 485 的工控板 Air8300；若必须留在 Air8782P2/8781 平台，则用空闲 UART 外扩 RS485 收发芯片自行增加。两种方案：① 选 Air8300 双网口双 485 工控板（板载 2 路 RS485、2 路网口，主控使用 Air8000 系列模组），免硬件设计、可定制开发，适合 2 路需求，资料见 https://docs.openluat.com/exb/EXB_8000_CH390_1/ ；② 需要 3 路时，在 Air878x 工业模组上利用其多路 UART，每路 UART 接一片 RS485 收发器（如 MAX3485/SP3485），注意 UART 引脚不与其他功能复用、做好方向控制和隔离/防护；③ 选型请以 https://docs.openluat.com/SelectionGuide/SelectionGuide/ 为准，先整理 485 路数、网口、定位、功耗等需求再匹配。
48. Air780E有没有哪个版本解决了被基站禁止连接的问题，且AT指令兼容现有固件？
解答： 结论：不存在"刷某个版本固件就能彻底解决、且 AT 指令又完全兼容"的版本；被基站拒绝/禁止连接主要发生在追求超低功耗的 LPAT（低功耗）方案与部分运营商网络的兼容性上，属于网络侧与低功耗协议组合的兼容性风险，模组端固件已做的优化无法保证所有运营商、所有基站都不出现。原因与应对：① LPAT 为压低休眠电流在网络行为上做了取舍，个别地区运营商会将其判定异常而拒绝接入甚至临时禁止；② 对可用性要求高、已稳定使用普通 AT 固件的产品，建议继续使用与现网验证一致的标准 AT 固件，不要为降功耗贸然切到 LPAT；③ 若确实要低功耗，建议在目标运营商、目标区域做批量实地场测后再定固件，并保留远程升级（FOTA）回退手段；④ 升级到最新正式固件可获得已合入的兼容性改进，但不能承诺 100% 消除。低功耗模式说明可参考 https://docs.openluat.com/air780er/at/app/command/lowpower/ ，选型以 https://docs.openluat.com/SelectionGuide/SelectionGuide/ 为准。
49. LPAT固件具体有哪些不稳定？如果出现不稳定好做应对措施。
解答： 结论：LPAT 固件的风险集中在网络连接稳定性，而非功能指令本身；可能出现被基站踢下线、重连变慢，个别运营商/基站下被拒绝接入甚至临时禁止连接等现象。原因：LPAT 为实现超低功耗在驻网、寻呼、保活行为上做了取舍，与不同运营商网络的兼容性存在差异，不能保证所有地区都稳定。应对措施：① 在目标运营商、目标城市做批量、跨基站的实地长测后再决定是否量产采用；② 固件分区设计上保留 FOTA 能力，一旦现场出现大面积异常可远程回退到标准 AT/LuatOS 固件；③ 应用层做好掉线检测与分级重连（退避重试、必要时重启协议栈/模组），并上报掉线原因和基站信息便于统计；④ 对连接可用性优先于极致低功耗的项目，直接选用标准固件或 Air8201/Air8202 等成熟超低功耗方案。参考 https://docs.openluat.com/air780er/at/app/command/lowpower/ 与选型指南 https://docs.openluat.com/SelectionGuide/SelectionGuide/ 。
50. 8202C的底电流（开启gsensor，PSM+）是多少？
解答： 结论：PSM+ 底电流是"实网、具体配置、板级电路"强相关的实测值，不能给一个脱离条件的固定数字，应以官方实网功耗数据和你自己板子的实测为准。说明：① Air780EP/8201 同类超低功耗平台在 PSM+ 下整机电流可做到微安级（典型数微安到十几微安量级，仅供量级参考，不是 Air8202C 的承诺值）；② 开启 G-sensor 后，传感器自身工作电流及其供电/中断电路是否在休眠时保持，会直接叠加到底电流上，不同工作模式（运动唤醒/轮询/静止休眠）数值不同；③ 板上 ESD、外设漏电、检测电阻也会抬高底电流。建议做法：用合宙 Air9000P 功耗分析仪（分辨率 0.1μA，可看电流波形）在目标运营商实网下，按"静止休眠+G-sensor 待唤醒"的真实状态测量，并对照官方实网功耗页（Air8202 产品页 https://docs.openluat.com/air8202/product/ 与低功耗文档），以你固件版本的实测数据写入规格书。
51. 8202C有充电管理吗？
解答： 结论：Air8202C 是免开发定位器整机，板载锂电池充电管理电路，可直接接锂电池使用。说明：整机内置 4G+GNSS 天线、G-sensor 和充放电管理，插电池即可定位上报；充电截止电压、充电电流等参数以整机/电芯规格书为准，外接电源时请使用符合规格的 5V 输入。整机说明、配置和默认固件见 https://docs.openluat.com/air8202/product/config/ 与产品页 https://docs.openluat.com/air8202/product/ 。
52. Air780EGG内置gsensor吗？
解答： 结论：Air780EGG 内置 G-sensor（三轴加速度传感器）。说明：该传感器在模组内部已连接，LuatOS 下通过 exvib 扩展库操作，可用于震动/运动检测、姿态判断、静止休眠与运动唤醒，无需外挂；exvib 同样适用于 Air780EGP/EGH 及 Air8000A/U/N/D 等带 G-sensor 的型号。用法见 https://docs.openluat.com/osapi/ext/exgnss/ 及 GNSS/低功耗相关 demo，选型特性见 https://docs.openluat.com/air8000/product/ 。
53. 如果换其他低功耗带定位模组，哪种是解决了被基站禁止问题，AT指令又差不多？
解答： 结论：没有任何型号可以承诺"彻底解决被基站禁止"，因为该现象主要来自超低功耗 LPAT 方案与部分运营商网络的兼容性，而非某一颗芯片的孤立缺陷；但可以通过换"成熟超低功耗方案 + 标准/经过现网验证固件"显著规避。选型建议（以选型指南为准）：① 优先选 Air8201 超低功耗定位工业模组（主控 Air780ER 系列）或免开发的 Air8202 定位器，其低功耗为体系化设计、现网验证更充分，资料见 https://docs.openluat.com/air8201/ 与 https://docs.openluat.com/air8202/product/ ；② 不要指望靠同型号换固件版本彻底消除 LPAT 风险，AT 指令跨同平台型号大体相近但需对照手册；③ 无论选哪款，都要在目标运营商、目标区域做实地场测，并保留 FOTA 回退能力。最终选型请基于 https://docs.openluat.com/SelectionGuide/SelectionGuide/ 并结合实测确认。
54. 这个项目下载前面正常，出现一次下载失败后USB就识别不到了，是什么原因？
解答： 结论：下载中途失败后模组可能停在异常/未完成烧录状态，正常固件的 USB 枚举失效，所以电脑识别不到，本质是"没进下载模式/固件不完整"，不是模组报废。处理步骤：① 强制进 BOOT：断电后按住 BOOT 再上电（已开机则 BOOT+复位），老平台必要时短接 1.8V 与 BOOT 两测试点再上电，设备管理器只出现 1 个下载口即为成功；② 确认数据线是数据线、VBAT 供电充足（供电不足会在写入大文件时掉电失败），780/8000/8201 免驱，Air724 等平台重装 USB 驱动，可换 USB 口/电脑交叉验证；③ 进 BOOT 后用 Luatools 把底层 core 与脚本重新一起完整烧录，不要只烧脚本；④ 若反复在同一点失败，检查升级包/脚本大小是否超脚本区、Luatools 是否最新。流程见 https://docs.openluat.com/common/howtodown/ 。
55. 1200x800开发板接上网线后，为何网口的网络不通？
解答： 结论：问题通常出在网卡初始化/默认网卡选择，而不是网口硬件——未插网线时以太网 IP 为 0.0.0.0，若 socket/服务直接绑定到了这张未就绪网卡或默认网卡选择错误，插上线后业务仍不通。处理要点：① 插好网线后用 socket.adapter(socket.LWIP_ETH)（或对应以太网适配器常量）轮询确认网卡 IP_READY、读到有效 IP 后再初始化网络业务；② 多网卡场景（4G+以太网）用 socket.dft() 显式指定默认网卡，不要在 IP 为 0.0.0.0 时就 connect/绑定；③ 确认 RMII 接线、PHY 地址/复位脚与固件配置一致、网口灯有 Link；④ 先在只启用以太网的最小 demo 下 ping 网关验证物理链路，再叠加多网逻辑。网卡适配器常量与状态接口见 https://docs.openluat.com/osapi/core/socket/ 。
56. 4G和以太网同时存在，网线没插入时用以太网ping IP也有数据返回，无法区分哪个网卡是好的，如何解决？
解答： 结论：在多网卡（4G+以太网）共存、网线未插时，若直接 ping 以太网 IP 仍有返回，是因为报文实际走了默认/其他就绪网卡（如 4G），不能据此判断以太网链路正常；脚本必须先按网卡分别判断链路就绪再做业务。处理要点：① 分别用 socket.adapter(socket.LWIP_ETH)、socket.adapter(socket.LWIP_GP) 检查每张网卡是否 IP_READY，只有目标网卡有有效 IP（非 0.0.0.0）才对该网卡初始化和 ping；② 用 socket.dft() 显式设置默认网卡，避免系统自动选到 4G；③ 链路检测以"该网卡是否拿到 IP + 从该适配器 ping 网关"双重判断，而不是只看 ping 有无返回；④ 监听网卡上下线事件，网线热插拔时动态切换。适配器常量见 https://docs.openluat.com/osapi/core/socket/ ；若怀疑特定固件下 ping 路由选择有异常，请升级最新固件并把最小复现脚本反馈官方企业微信群。
57. SIM卡插在这台设备不能用了，插到别的同型号设备上就可以使用，是什么原因？
解答： 结论：同一张卡换设备能用、在这台不能用，问题在这台设备的 SIM 卡座/走线或该卡与这台设备的匹配，而非卡被运营商停用。排查步骤：① 先换一张确定正常的 SIM 卡到这台设备，若也不认，基本定位为硬件：检查卡座弹片接触、SIM_VDD/SIM_DATA/SIM_CLK/SIM_RST 焊接与走线、ESD/滤波器件是否虚焊或漏电、卡座旁电容是否离脚过远导致信号边沿变差；② 若别的卡在这台能用、只有这张卡不行，确认卡商是否做了机卡绑定（IMEI 绑定），物联网卡常见首次激活后绑定设备 IMEI，换机即拒，需联系卡商解绑；③ 用这台设备抓 mobile/SIM 初始化日志（SIM 卡检测、鉴权、注册返回码），看是未检测到卡还是鉴权被拒；④ 对比同型号开发板的 SIM 外围参数。硬件排查可结合对应产品硬件设计手册，并在投板前走 https://docs.openluat.com/value/drawcheck/ 评审。
58. 有没有卖780模组测试座的，可以把780单模组装上去下载？
解答： 结论：有，可使用合宙 780 系列烧录夹具/测试座，把单模组放入夹具即可引出 VBAT、USB、BOOT、POWERKEY 等脚进行下载和测试。购买与使用：① 到合宙官方淘宝店 https://luat.taobao.com/ 搜索"780 烧录夹具/测试座"，或直接访问对应商品页 https://item.taobao.com/item.htm?id=549441249696 ；② 夹具一般通过顶针接触模组焊盘，烧录时先按 BOOT+POWERKEY 再上电进入 BOOT 模式，配合 Luatools 或合宙量产烧录工具批量下载；③ 量产批量烧录建议使用"合宙量产烧录工具（在线版/脱机版）"，可多端口循环烧录，说明见 https://docs.openluat.com/common/Luat_productiontool/ 。
59. 烧了LuatOS固件的模组能不能用综测仪测试定频？
解答： 结论：非信令定频（发射/接收固定频点、固定功率）测试需要 AT 测试固件配合综测仪指令，标准 LuatOS 固件不提供该测试模式，不能直接定频。做法：① 需要做定频/射频产线测试时，烧录对应型号的 AT 测试固件，按合宙提供的产测/定频指令在 CMW500 等综测仪下测试，测完按需烧回业务固件；② 如果整机测试只需要验证信号质量 CSQ，则不必定频：把模组接上综测仪（信令小区），在 LuatOS 脚本里调用信号查询接口周期性打印 CSQ/RSRP 即可；③ 定频指令、测试固件以对应型号认证/产测文档为准，可在 https://docs.openluat.com/ 对应产品页或通过官方企业微信群获取。
60. 整机用CMW500测试只需要测CSQ，有没有相关文档？
解答： 结论：只测 CSQ 属于信令方式，不需要非信令定频；让 CMW500 模拟基站建链，模组在脚本或 AT 下读出 CSQ/RSRP 即可，可参考对应型号的认证测试说明和信号查询接口文档。操作要点：① CMW500 配置对应制式与频段的信令小区并发射，模组装好天线（或经射频线/耦合板）开机注网；② LuatOS 固件在脚本中用 mobile 相关接口周期读取并 log 打印 CSQ/RSRP/SINR；AT 固件用标准信号查询指令读取；③ 记录综测仪侧小区功率与模组读数做对应关系验证；④ 若还要做发射指标（功率/频谱）等非信令项，则必须改用 AT 测试固件和定频指令。相关接口见 https://docs.openluat.com/osapi/ 及对应产品认证文档，产测工具/测试固件可通过官方企业微信群获取。
61. iRTU只能设置吗？能连云吗？能在手机上看数据吗？
解答： 结论：iRTU 不只是本地参数配置入口，也可以配置终端连云和数据上报；但手机端、电脑端的数据展示由所接入的云平台或自建业务服务提供，iRTU 本身不等同于完整的数据展示网页。
使用时先在合宙 IoT 平台将设备归属到自己的账号，再登录 iRTU 后台配置串口数据、GPIO、定位及上报参数，保存并重启设备，设备开机会同步配置。接入合宙云时，在对应的 IoT/位置服务页面查看数据；接入第三方服务器时，由第三方平台或自研前端提供网页和手机端展示。平台费用、私有部署及移动端功能以官方平台当前页面和销售确认为准。
参考：https://docs.openluat.com/value/irtu/state/ ，https://docs.openluat.com/value/iot/
62. 8202现在有现成的手机端吗？你们云端和手机端有什么现成方案？
解答： 结论：Air8202 有可体验的定位管理平台和公开测试入口，但手机端/后台的正式使用、账号开通及定制范围以官方当前产品资料为准，不能按“免费定制手机端和后台”作商务承诺。
Air8202 属于免开发定位器方案，设备完成绑定和定位上报后，可在官方位置定位服务中查看设备位置、轨迹和告警；公开体验入口为 move.luatos.com，配置说明见 Air8202 产品文档。若要做自有品牌手机端、客户后台或与业务系统对接，应通过平台开放接口、第三方云或自研服务实现。项目立项前请先验证演示账号、目标功能、设备接入量及商务开通条件。
参考：https://docs.openluat.com/air8202/product/config/ ，https://move.luatos.com/
63. 这个8202C定位不准，是什么原因？
解答： 结论：定位偏差大时，先区分当前结果来自 GNSS 卫星定位还是基站/Wi‑Fi 等辅助定位；GNSS 必须在室外开阔环境验证，室内、高楼遮挡或车内屏蔽位置只能得到粗定位。
排查顺序：第一，把设备放到户外开阔处冷启动 3–10 分钟，确认 GNSS 天线朝向天空、供电稳定且无金属遮挡；第二，查看定位回调中的定位类型、卫星数和经纬度，不要只看地图结果；第三，若室内或弱信号场景有业务需求，应同时评估 LBS 辅助定位，但 LBS 本身精度有限，不能按 GNSS 精度验收；第四，检查天线型号、馈线、匹配电路及设备安装方式，地图坐标系还需按所用地图确认 GCJ‑02/WGS‑84 转换。
参考：https://docs.openluat.com/osapi/core/libgnss/
64. 我买了8202C，设备上报时DNS解析iot.openluat.com失败是什么情况？
解答： 结论：DNS 解析失败通常说明设备的蜂窝数据链路、APN、运营商网络或专网卡访问策略未准备好，并不等于 iot.openluat.com 域名本身异常。
按以下顺序排查：先确认 SIM 卡已激活、未欠费、数据业务可用，并观察驻网和信号；普通卡检查 APN 是否匹配运营商，物联网专网卡必须让卡商确认已放通 iot.openluat.com 所需域名、IP 及端口，不能只放通升级地址；再检查设备是否成功激活 PDP、拿到 IP，必要时更换普通可上网 SIM 卡做交叉验证。若普通卡正常、专网卡失败，应由卡商提供 DNS 解析和白名单记录；若所有卡均失败，再抓取模组日志中的注网、PDP、DNS 和 socket 错误码，结合现场信号质量定位。
平台入口：https://iot.openluat.com/
65. 请问780EHN有开发板吗？哪个链接是给780EHN的？
解答： 结论：Air780EHN 与 Air780EHM/EPM 系列在硬件封装和参考设计上具备 PIN‑to‑PIN 设计基础，但 EHN 是北美频段版本，射频频段和认证不同，不能把 EHM 开发板商品直接宣称为 EHN 专用开发板。
选型和采购时，请先在官方淘宝按“Air780EHN”核对当前在售链接；若只看到 EHM/EHU Turnkey 开发板，应向官方销售确认该底板是否可焊接或更换 EHN 核心模块、天线匹配是否适用、是否提供 EHN 样品及对应固件。软件可参考同封装 EHM/EHU 的 LuatOS 工程，但频段、运营商准入和实网表现必须使用 EHN 模组、目标地区 SIM 卡做现场验证。
频段参考：https://docs.openluat.com/air780ehnehu/product/air780ehnfreq/ ，购买入口：https://luat.taobao.com/
66. 780的AT命令和建立PPP链接的方法/指令和600一样吗？
解答： 结论：Air780 与 Air600 的 AT 拨号和 PPP 建立思路相近，但不能认定每条 AT 指令、参数、USB 枚举行为和固件返回完全相同，量产前必须按各自 AT 手册和固件版本逐项验证。
通用流程通常是确认 SIM 卡和驻网状态，配置 APN/认证方式，建立数据拨号，再由主控通过 USB 或 UART 建立 PPP 链路。差异点集中在数据拨号指令、错误码、RNDIS/ECM/PPP 模式切换、流控、串口波特率、自动拨号参数及断线重连返回。移植时不要直接复制另一型号脚本，应分别保存两套命令和异常处理分支，并覆盖弱网、欠费、APN 错误和基站拒绝等场景。
AT 资料入口（AT 指令手册、硬件手册、参考设计）：https://docs.openluat.com/atmozu/product/shouce/
67. 780有支持美国频段的型号吗？
解答： 结论：在美国使用应选择北美版 Air780EHN，而不是亚欧版 Air780EHU。Air780EHN 官方列出的频段包括 B2/B4/B5/B7/B12/B13/B17/B18/B19/B25/B26/B38/B41/B66/B71，可覆盖美国部分主流运营商频段。
硬件频段只是选型条件之一，还必须核对目标运营商正在运营的频段、2G/3G 退网计划、VoLTE 支持、SIM 卡类型、APN、设备认证和运营商准入策略。频段支持无法通过刷写其他地区固件获得，也不能仅凭 BOM 兼容直接上市。项目导入时请使用美国本地运营商 SIM 卡完成驻网、通话/数据、切换、弱网和长时间在线场测，并向销售确认认证状态。
参考：https://docs.openluat.com/air780ehnehu/product/air780ehnfreq/
68. Air8000W会不会出现不可控的流量？50M流量几天就没了？
解答： 结论：模组本身不会无原因产生大量未知流量，50MB 在几天内耗尽通常由业务心跳、云连接重连、FOTA、日志上报、DNS/Socket 重试或服务器交互造成，需要同时从运营商清单和设备端日志两边对账。
先向运营商获取按时间、目的 IP/域名、上下行字节统计的流量详单，确认流量集中时段和服务器地址。设备端同步检查心跳周期、上报包大小、断线重连间隔、FOTA 是否循环下载、errDump/日志级别、DNS 失败重试和多任务重复连接。弱网时若程序无退避策略，可能高频建立连接并产生额外信令和数据流量。建议在固件中增加流量统计、重连指数退避、日志开关和升级包校验，再复现实测。
平台连接排查入口：https://iot.openluat.com/
69. 在位置定位设备管理中查询不到设备，不知道哪一步做的不对？
解答： 结论：位置定位设备管理中查不到设备，通常是平台入口、设备归属、IMEI、首次上报或配置项不一致造成，应先确认设备接入的确实是 Air8202 对应的位置服务。
排查步骤：第一，确认设备使用的 IMEI 与平台查询、绑定或导入的 IMEI 完全一致；第二，先在合宙 IoT 账号中确认设备已归属到当前账号，公开测试与正式账号的数据视图可能不同；第三，按 Air8202 配置文档确认接入地址、项目/产品参数和 move.luatos.com 演示入口；第四，确认设备已成功驻网并完成至少一次定位上报，可在设备日志中查看平台连接和上报返回；第五，退出并重新登录正确账号，避免查到其他企业或项目空间。
参考：https://docs.openluat.com/air8202/product/config/ ，https://move.luatos.com/
70. Luatools工具日志占用磁盘200多G，是不是写得太频繁了？
解答： 结论：200GB 日志已经明显超出正常调试保留范围，应先升级 Luatools、检查日志容量和自动清理设置，并清理历史日志目录；在未核对当前版本设置前，不建议把某个固定容量上限作为通用结论。
处理步骤：第一，从官方资料获取并安装新版 Luatools，备份必要日志后，在设置中检查日志级别、保存天数、容量限制和自动清理选项；第二，定位 Luatools 的日志输出目录，按项目和日期删除历史 trace、串口抓取及临时升级文件；第三，量产或长时间拷机时关闭不必要的底层 trace，只保留错误和升级结果日志；第四，工厂批量烧录应使用官方量产烧录工具或官方提供的自动化方案，避免把调试工具长期当日志采集系统使用。
量产工具参考：https://docs.openluat.com/common/Luat_productiontool/
71. 项目下载失败后USB识别不到，短接boot也没用，air724出这种问题怎么办？
解答： 结论：下载失败后 USB 枚举消失，应先让模组重新进入强制下载模式，再分别排查供电、BOOT 时序、USB 和电脑驱动，不能只反复点击下载。
Air724 系列可在完全断电状态下按对应硬件设计手册短接强制下载相关引脚（常见方法为短接 1.8V 与 BOOT 测试点），保持短接后接入 USB 和 VBAT，待 Luatools 出现下载端口再释放；若仍无端口，更换优质 USB 线和可提供峰值电流的供电，确认 USB D+/D‑ 未接反、共地正常，并在设备管理器查看是否出现未知设备或端口。软件侧重装官方驱动和新版 Luatools，换电脑验证；若强制下载模式下始终无 USB 枚举，应检查 BOOT 焊点、1.8V 电平、电源跌落和模组焊接。
工具入口：https://docs.openluat.com/
72. 请问有没有芯片可以支持英文TTS的？
解答： 结论：不能简单回答“没有”。是否支持英文 TTS 取决于具体模组型号、固件包含的 TTS 核心库及语音引擎能力，尤其要区分“英文字母逐字母朗读、数字/符号朗读”和“英文单词、短语自然合成”。
需要英文语音的项目，请先提供目标型号、固件编号和实际英文文本，在官方固件库中确认是否包含 TTS/音频库，再用耳机或喇叭播放验证。历史资料中不同平台对中英文和数字的支持差异较大，个别接口出现过英语语种参数，但不能跨型号类推。对英文发音一致性要求高的产品，更稳妥的方式是由服务器或离线工具预生成英文 MP3/PCM，再用音频接口播放；若需要评估带语音能力的型号，可重点核实 Air780EHV 及其当前 LuatOS 固件。
参考：https://docs.openluat.com/osapi/core/audio/ ，https://docs.openluat.com/air780ehv/
73. AIR780EHU/AIR780EHN是否可以平替air780ehm？为什么这两个没TTS？
解答： 结论：Air780EHU/EHN 与 Air780EHM 不能仅按“同封装”直接平替。EHU 面向亚欧频段，EHN 面向北美频段，除了频段差异，功能还受具体固件包含的核心库、硬件语音通道和外设资源影响。
TTS 不应只看模组名称判断，而要核对所选固件发布页中的固件组成和 TTS/音频库支持。若 EHU/EHN 当前固件未提供满足需求的 TTS 能力，不能通过改写脚本凭空启用；可更换官方带语音能力的型号与固件，或把语音内容预制成音频文件播放。移植前请用目标固件验证驻网、TTS、音频通道、外设和低功耗，并确认目标国家频段。
频段参考：https://docs.openluat.com/air780ehnehu/product/air780ehnfreq/ ，音频接口：https://docs.openluat.com/osapi/core/audio/
74. 请问AIR780EHV有没有能直接烧录的AT固件？定频的固件有AIR780EHV专用的吗？
解答： 结论：Air780EHV 定位为支持 LuatOS 二次开发的语音型号，不应把其他 AT 型号固件烧录到 EHV；需要标准 AT 指令或非信令定频测试时，应选择对应的 AT 产品和官方测试固件。
Air780EHV 与 Air780EVT 等型号即使封装或应用场景相近，固件、基带配置和认证边界也不同，混刷可能导致无法下载、无语音或射频参数错误。定频、综测、传导测试必须使用实验室仪表和官方提供的测试模式/测试固件，不能把普通 LuatOS 业务固件当作非信令固件。请向官方销售或技术支持提供具体型号、生产用途、测试频段、仪表型号和固件来源，获取对应测试文件及操作说明。
参考：https://docs.openluat.com/air780ehv/ ，AT 手册入口（Air780EVT 等 AT 型号指令/硬件手册）：https://docs.openluat.com/atmozu/product/shouce/
75. 有没有测设备实时功耗的小产品？有资料吗？
解答： 结论：可使用合宙 Air9000P 功耗分析仪做实时供电、电流曲线采集和低功耗问题定位，适合 PSM、休眠、周期性上报等场景。
官方资料列出的关键参数包括：电流量程 0–2A，最小电流分辨率 0.1μA；电压量程 0–5V，最小电压分辨率 1mV；硬件采样率 100kHz，PC 端软件采样率 10kHz。仪器可给被测设备供电、设置限流，并在 PC 端查看和保存电流曲线。测试时应按电池标称电压供电，在日志中同步标记注网、上报、GNSS、唤醒等动作，再结合平均电流和峰值得出续航。
参考：https://docs.openluat.com/air780er/at/common/hwenv/ ，购买入口：https://luat.taobao.com/
76. AirMaster工具提示每日积分不够用，有其他办法吗？
解答： 结论：遇到“每日积分不足”提示时，应以 AirMaster 当前账号和客户端展示的额度规则为准；目前未在公开文档中核实到可对外承诺的固定每日额度、刷新时间或绕过限制的方法，不能通过非官方手段规避计费限制。
先执行以下检查：确认登录的是本人常用企业账号，退出后重新登录以同步权限；查看客户端中的会员/积分/用量页面，确认当日调用量、刷新时间和是否存在多个成员共用额度；降低无效提问频次，精简上下文并复用有效会话。若团队有稳定或批量使用需求，请通过官方企业微信、销售或客户端反馈入口提供账号 ID、提示截图和使用场景，由官方确认是否存在企业版、增购或其他正式方案。
官方支持入口：https://docs.openluat.com/ ，企业微信群入口见官网页面底部二维码。
77. 合并失败：文件总数据量(1028kb)超过了固件脚本区空间(512kb)，请减少代码，怎么解决？
解答： 结论：报错已经明确指出脚本区容量不足，打包后的脚本和资源总量 1028KB，而当前固件脚本分区为 512KB；取消或勾选“忽略脚本依赖性”不能扩大物理脚本分区，只能改变依赖打包结果。
处理方式：第一，删除无用 Lua 模块、示例工程、日志、临时文件和重复资源；第二，图片、字库、音频、证书等大文件不要全部放入脚本区，应按产品支持的文件系统或外部 Flash 方案存放；第三，按需 require，避免把整套 SDK demo 和未使用驱动打进项目；第四，核对当前固件编号，确认是否有更大脚本区或支持外部存储的固件/硬件版本；第五，压缩和裁剪资源后重新查看 Luatools 的体积统计，再进行下载。若资源本身接近或超过 1MB，应从硬件文件系统方案和资源分包层面解决。
78. 之前设备用同一套代码，现在下载固件报错，是什么原因？
解答： 结论：同一套代码在新下载流程中报错，优先检查固件版本、脚本区大小、依赖库打包和资源文件是否发生变化，不能只归因于某个勾选项。
先记录 Luatools 的完整报错、模组型号、固件编号和工具版本，再与之前可正常下载的固件包对比。重点核对：当前 core 固件是否更换、脚本分区是否变小、是否新增图片/字库/音频等资源、依赖库是否被重复打入、Luatools 是否自动勾选了不匹配的库、项目路径中是否混入旧版本文件。处理时先使用官方最新稳定 Luatools 和对应型号固件，清理项目后重新生成下载包；若报错提示空间不足，按精简资源和分包处理；若提示库或模块不匹配，则按固件依赖说明调整。
79. 这个定位DEMO不触发gnss_state，lbsLoc2.request有数据，是什么原因？
解答： 结论：lbsLoc2.request 有数据只能说明基站辅助定位链路可用，不能证明 GNSS 已上电、收到卫星数据或进入有效定位状态；gnss_state 不触发应单独排查 GNSS 模块。
先在室外开阔环境冷启动测试，室内、金属外壳和有源天线供电异常都会导致没有卫星状态。随后按链路检查：确认 demo 使用的固件包含 GNSS/定位库，GNSS 电源使能脚和天线供电正确，串口通道与 demo 配置一致，NMEA 数据有实际输出，回调注册时机早于定位启动，且没有在其他任务中重复占用同一串口。抓取 GNSS 原始 NMEA 和系统日志，查看是否有 GGA/RMC 数据、定位状态及卫星数。若 LBS 正常但始终无 NMEA，优先定位在硬件供电、天线、串口复用和固件库配置。
参考：https://docs.openluat.com/osapi/core/libgnss/
80. Luatools界面的下载等按钮没有键盘快捷键操作，导致豆包只能模拟点击经常会失败，可以增加快捷键吗？
解答： 结论：生产自动化不应依赖模拟点击 Luatools 图形按钮。当前公开资料未核到可承诺的下载按钮快捷键，建议直接改用官方量产烧录工具或官方提供的自动化烧录方案。
量产流程应将固件包、脚本包、IMEI/ SN 等产测数据、烧录结果和失败重试交给专用产线工具管理，避免窗口焦点、分辨率、驱动枚举时间和弹窗导致 RPA 点击失败。实施时先固定 USB Hub、数据线、驱动、Luatools/量产工具版本和固件文件，再按官方工具文档配置批量下载与日志输出；若确有接口需求，可通过官方企业微信群提交“产线自动化控制/命令行接口”需求，说明节拍、工位数量和需要的返回状态。
量产工具参考：https://docs.openluat.com/common/Luat_productiontool/
81. 请问合宙有没有支持USB拍照的芯片吗？
解答： 结论：需要 USB 摄像头拍照时，优先评估 Air8101 系列。官方 camera 文档明确 Air8101 支持多路 USB 摄像头，产品资料还列出可支持 USB/DVP 摄像头能力，适合拍照、视频采集等应用。
若项目只需要较低分辨率 UVC 拍照，也可按具体手册核对 Air1601/Air1602；其管脚详细资料中列出最高约 100 万像素 UVC 摄像头能力，不能与 Air8101 的能力直接等同。配件方面，官方 AirCAMERA_1032 为 UVC 免驱摄像头，支持 MJPG/H.264，标称 1280×720@20fps，拍照分辨率包含 1920×1080、1280×720。选型时请同时确认分辨率、帧率、格式、供电、USB 枚举和实际摄像头兼容性。
参考：https://docs.openluat.com/osapi/core/camera/ ，https://docs.openluat.com/accessory/AirCAMERA_1032/
82. 我有一个780EPM的小板，现在提示SIM卡未插入，怎么判断是焊接问题还是SIM卡座旁电容放太远？
解答： 结论：提示 SIM 未插入时，不能只凭卡座旁电容位置判断，应按卡座焊接、SIM 引脚时序、信号质量和供电逐级交叉验证。
先用同一张 SIM 卡在官方开发板上确认卡正常，再换回小板测试；检查 SIM 卡座是否虚焊、冷压触点是否接触到位、USIM_VDD/CLK/DATA/RST 是否与模组管脚连通且无短路。示波器重点看插卡开机后的 VDD 电平、RST 复位波形、CLK 时钟和 DATA 应答，DATA 线的上拉、ESD 器件、滤波电容位置和容值应按官方参考设计放置，线路过长或电容过大可能影响时序。若没有波形，优先查供电、管脚复用和焊接；有时钟无应答，再查卡座接触、DATA/RST、ESD 漏电和电容布局。最终请以 Air780EPM 硬件设计手册的 SIM 参考电路和 PCB 走线为准。
硬件资料入口：https://docs.openluat.com/air780epm/
83. LuatOS-SoC V2050 Air780EPM103固件用在Air8781P2上，是否会自动适配看门狗无需额外考虑？
解答： 结论：不能认为烧录 Air780EPM 固件后会自动适配 Air8781P2 板载外部看门狗。LuatOS 固件自动管理的是模组芯片内部硬件看门狗；Air8781P2 板级的 Air153C 外部看门狗需要按板级硬件设计单独喂狗。
Air8781P2 官方资料说明，外部看门狗芯片为 Air153C，喂狗引脚为 GPIO24，Air153C 固定超时 4 分钟，实测约 209–283 秒；其中 P1/P2 型号带看门狗，P3/P4 不带看门狗。若在 P2 上只运行业务脚本而不初始化外部看门狗，内部 WDT 即使正常，也不能替代外部 Air153C，外部看门狗超时后可能拉复位。项目应使用官方 exair153x_wdt 扩展库（Air153C 初始化 wdt_pin=24 后自动周期喂狗），或严格按硬件时序自行翻转 GPIO24，并确认 FOTA、休眠和任务阻塞时仍能按时喂狗。
参考：https://docs.openluat.com/osapi/ext/exair153x_wdt/ ，https://docs.openluat.com/air8781p/luatos/hardware/module/circuit/wdt/
84. 问一个问题，AI给出的答案不对！这个37脚是内部使用的吗？
解答： 结论：这里需要区分硬件管脚编号（PIN）和脚本中使用的 GPIO 编号，不能把“第 37 脚”直接写成 GPIO37。
在该型号管脚定义中，硬件 PIN37 对应的可用 GPIO 是 GPIO14，因此 LuatOS 脚本配置输入、输出或中断时应使用 GPIO14 这个逻辑编号；只有在查原理图和硬件连线时才使用 PIN37。移植代码前请再以当前模组版本的管脚表核对一次，因为不同封装、型号或保留脚定义可能不同。若该脚被标注为保留、供电或专用功能，即使编号相近也不能作为普通 GPIO 使用。
管脚资料入口：https://docs.openluat.com/
85. 我们做了一个板子，插上USB按住BOOT开机，Luatools怎么都无法识别，是什么原因？
解答： 结论：按住 BOOT 仍无法识别，先判断模组是否真正进入强制下载模式，再排查 BOOT 电平、上电时序、USB 硬件和驱动；原理图检查可以作为并行步骤，但不能替代实测波形。
确认断电后再拉高/短接 BOOT，然后给 VBAT 上电并接入 USB，注意 BOOT 保持时间、释放时机和按键串阻是否正确。测量 VBAT 是否在开机瞬间跌落、1.8V 是否正常、BOOT 引脚电平是否达到手册阈值、USB 5V 和 D+/D‑ 是否连通且差分线未接反。设备管理器若完全无端口变化，重点查 USB、供电和焊接；若出现未知设备，则查 Luatools/USB 驱动和线材。官方开发板能识别而自研板不能识别时，请将原理图、PCB、BOOT 周边电路和供电波形提交 drawcheck 复核。
资料入口：https://docs.openluat.com/
86. 为什么一个模块拆了看门狗，一个没拆，功耗区别这么大？芯片手册数据有没有问题？
解答： 结论：芯片手册中的低功耗电流通常是模组本体在指定电压、网络状态、休眠模式和外围条件下的数据，不包含客户板上的外部看门狗、LED、DCDC、传感器、上拉电阻及漏电；两块板子差异大，不能先归因于手册数据错误。
带 Air153C 外部看门狗的板子应重点检查其供电电流、WDI（GPIO24）静态电平、喂狗波形、复位动作、分压电阻和周边器件。若 WDI 在休眠时持续处于不确定电平、频繁翻转或与看门狗输入结构不匹配，可能产生额外电流；看门狗反复复位还会让模组不断醒网，平均电流显著增大。排查时用同一固件、SIM、信号、电压和上报周期，分别测量模组供电与板级总供电，用 Air9000P 抓取完整电流曲线，再结合原理图核对外围漏电和焊接短路。
参考：https://docs.openluat.com/common/watchdog/ ，https://docs.openluat.com/air8781p/luatos/hardware/module/circuit/wdt/
87. 服务器的加字段后，设备日志还是传到你们平台对吧？
解答： 结论：业务服务器增加自定义字段，不会改变设备连接合宙 IoT 平台和日志通道；但“设备日志是否仍在合宙平台展示、保存多久、如何拉取”取决于项目开通的日志/运维能力和固件中的日志上报配置。
业务数据字段属于上行 payload 或客户服务器协议，和 errDump/运维日志不是同一个概念。新增字段后应分别验证：设备是否仍在线、业务 payload 是否能被新服务器解析、平台日志接口是否收到错误日志。需要现场设备立即回传时，可通过平台下发指令触发一次日志上报，但前提是设备在线且固件已实现相应处理。不要在业务数据中夹带大量调试日志，避免增加流量和影响解析。
平台入口：https://iot.openluat.com/
88. 设备掉线了，离线期间的上报日志能自动补传吗？
解答： 结论：设备离线期间的业务数据或日志能否自动补传，取决于产品固件是否做本地持久化、平台接口是否支持历史数据上报以及项目使用的日志服务策略，不能默认所有日志都会在恢复连接后完整补传。
如果业务要求断点续传，应在设备端将关键事件写入 Flash/文件系统，并为每条记录增加序列号、时间戳和上报确认；网络恢复后按顺序补传，服务器端按序列号去重并拒绝超出保留窗口的数据。普通调试日志通常容量有限且可能循环覆盖，不能承担计费、告警或合规记录用途。平台侧也需要确认是否接受带历史时间戳的数据、保存多久以及是否提供查询接口。项目设计阶段应明确“断网多久、每条记录多大、补传多久、失败如何处理”。
平台入口：https://iot.openluat.com/
89. 设备有网络但没心跳过来，跟掉线有关系吗？上行短信能收到但不上报日志，怎么查？
解答： 结论：短信能收到只说明 CS 域或短信通道可用，不代表设备的 PS 数据网络、TCP/MQTT 连接或业务心跳正常；平台显示无心跳时，应按“数据链路 → 云连接 → 业务进程”顺序排查。
先查看模组注网、信号、APN、PDP 是否激活及能否访问外网，再确认平台连接状态、远端 IP/端口、TLS、设备鉴权和心跳周期。若设备偶尔在线，可立即下发日志回传指令，抓取云连接断开原因、socket/MQTT 错误码、DNS 结果和重连记录；若数据被服务器接收但平台无心跳，检查设备 ID、项目归属、协议字段、心跳间隔和服务器解析日志。专网卡还需让卡商核对短信、数据、域名白名单和端口策略是否分别开通。
平台入口：https://iot.openluat.com/
90. AIR780E的LPAT固件是否会导致设备掉线且无法重连？
解答： 结论：LPAT 相关固件通常面向特定低功耗或网络优化场景，和不同运营商基站、SIM 策略、弱网环境可能存在兼容性差异；它不是可脱离现场日志直接认定的唯一掉线原因。
若设备出现掉线后长时间不恢复，应先抓取掉线前后的注网、小区切换、PDP、socket/MQTT 和重连日志，记录运营商、SIM 卡类型、信号强度、地点与固件编号。用同一地点、同一 SIM 卡和同一业务程序，在 LPAT 固件与官方标准固件之间做 A/B 对比：若标准固件恢复正常，可按项目场景停止使用 LPAT 固件，并通过 FOTA 回退到验证过的稳定版本；业务程序仍需实现指数退避重连、PDP 重建和必要时重启模组的容错策略。量产固件必须在目标运营商网络完成长稳和弱网测试后再锁定版本。
91. 有没有南美支持的模块？秘鲁、巴西这两个地区。
解答： 结论：不能直接回答“没有”。Air8000N 官方适用北美，Air8000U 官方适用欧亚；秘鲁、巴西不在官方区域型号的简单适用列表中，应按目标国家、运营商和实际频段逐项比对，不能只按洲名选型。
请先确认设备销售国家、运营商名称、SIM 卡类型、2G/3G 退网情况、目标 LTE 频段和是否需要语音。然后把运营商当前 B1/B2/B3/B4/B5/B7/B8/B28/B66 等频段与 Air8000N/Air8000U 的官方频段表逐项匹配；即使频段重合，也还要确认当地认证、APN、VoLTE 和运营商准入。最终判断必须基于官方当前频段表、运营商网络资料及当地 SIM 实网测试，并由销售确认区域供货和认证状态。
参考：https://docs.openluat.com/air8000/product/pinduan/ ，https://docs.openluat.com/air8000/product/
92. 合宙有1688的店铺吗？
解答： 结论：当前未核到合宙官方可公开确认的 1688 直营店链接，因此不要把 1688 上的第三方分销商或同名商品直接认定为合宙官方店。
采购前可优先使用官方淘宝店 luat.taobao.com、合宙官网购买入口或官方销售渠道，并让供应商提供营业执照、合宙授权证明、开票主体、售后政策及模组批次来源。若在 1688 看到 Air 系列商品，应核对店铺经营主体是否为上海合宙通信系统有限公司或其书面授权渠道；价格明显异常、无法提供授权或批次追溯的商品，不建议用于量产。
官方购买入口：https://luat.taobao.com/ ，官网：https://www.openluat.com/
93. 这个天线作为4G天线，能否帮我看下电路和封装有无问题？主控用8000W。
解答： 结论：仅凭一张局部照片或口头描述不能判定 4G 天线封装和电路是否可用。蜂窝天线性能受净空、地平面、π 型匹配、射频走线、IPEX/弹片接触、结构件和整机握持方式共同影响，必须结合设计资料和实测驻波/传导辐射结果评审。
请一次性提交：完整原理图、天线所在层 PCB 截图、相邻层铺地和过孔、结构尺寸图、天线规格书（频段、效率、驻波比、推荐净空）、π 型匹配预留、IPEX/弹片或焊接连接方式、外壳材质及同轴线长度。检查重点包括：射频线 50Ω 阻抗连续、走线短直且远离干扰、地孔围栏完整、匹配网络按规格书预留、天线净空不被电池/金属件占用、测试点不破坏匹配。设计阶段可走 drawcheck，并结合官方天线调试服务或天线供应商做匹配调试；最终以目标频段驻波、总辐射功率和实网场测为准。
参考：https://docs.openluat.com/air8000/luatos/hardware/design/antenna/
94. Air8101固件能否让tp/ft3x68驱动支持FT5446触摸屏？
解答： 结论：不能仅凭名称相近就承诺 ft3x68 驱动支持 FT5446。官方 extp 扩展库当前列出的触摸芯片包含 gt911、cst820、gt9157、jd9261t、ft3x68、cst9220，且明确 extp 扩展库仅 Air780EPM 支持；Air8101 应查看其自身 tp 触摸库、demo 和固件，不应直接套用 extp 的支持结论。
即使 FT5446 与 FT3x68 同属 FocalTech 电容触摸方案，也必须核对 I2C 地址、设备 ID 寄存器、中断时序、上电时序和坐标寄存器格式。适配时先用 I2C 扫描并读取触摸芯片 ID，再用逻辑分析仪确认 INT/RST 时序；ID 可读且寄存器格式兼容后，再在 Air8101 的 tp 驱动基础上增加芯片型号和坐标解析。读不到 ID 或坐标格式不一致时，应按 FT5446 规格书单独移植，不能通过改个文件名宣称支持。
参考：https://docs.openluat.com/osapi/ext/extp/ ，https://docs.openluat.com/osapi/core/tp/
95. FocalTech FT5x06系列驱动是不是都可以用了？
解答： 结论：不能把 FocalTech FT5x06 全系列都视为免调试兼容。即使系列名相同，不同后缀芯片的 I2C 地址、ID、中断模式、手势/多点触控寄存器和休眠时序也可能不同。
验收至少包含四步：硬件上确认 VDD、I2C、RST、INT 与驱动配置一致；驱动启动后读取芯片 ID，确认不是地址冲突或误应答；在触摸、释放、滑动、多点和休眠唤醒场景下抓取中断与坐标数据；连续做高低温或长时间背光开关测试，确认不会丢中断。只有设备 ID、寄存器协议、坐标范围和中断行为全部验证通过，才能在该具体型号上使用；未实测的 FT5x06 后缀型号应按新器件适配。
参考：https://docs.openluat.com/osapi/core/tp/
96. air780egh的OTA升级，自建服务器的话，对平台有啥要求吗？
解答： 结论：Air780EGH 使用 LuatOS 自建 OTA 时，新项目优先使用 libfota2 扩展库。自建平台本质上是一个设备可访问的 HTTP/HTTPS 服务，需要根据设备标识、当前版本、固件名称等信息判断是否升级，并严格返回规定的 HTTP 状态码和文件内容。
官方文档要求：需要升级时，服务器返回 HTTP 200，响应 body 为升级文件内容；不需要升级时，返回 300 或以上状态码。libfota2.request(cbFnc, opts) 的 opts.url 可填写自建服务器地址；若使用普通 URL，库会自动附带版本、IMEI、固件名称等参数；若 URL 已包含全部参数，应在 URL 前加 ###。服务器还要支持弱网重试、断点/大文件下载策略、HTTPS 证书校验、按 IMEI 灰度、版本回滚保护和升级包完整性校验。脚本升级为全量覆盖，core 为差分升级，发布前必须验证差分包路径和版本链。
参考：https://docs.openluat.com/osapi/ext/libfota2/
97. 你们有没有芯片可以支持英文TTS的？
解答： 结论：英文 TTS 需要按“型号 + 固件 + 文本内容”验证，不能用一句“没有”覆盖所有产品，也不能把中文 TTS 或字母朗读直接等同于英文单词合成。
选型时先明确要播报的是数字、缩写字母、固定英文短语还是开放式英文句子。数字和简单提示可在多个带 TTS/音频能力的固件上实测；开放式英文单词和自然语调应要求供应商提供目标固件的英文播报样音，或在服务器侧预生成 MP3/PCM，再由模组播放，项目一致性更可控。若倾向使用带语音定位的型号，可核对 Air780EHV 当前 LuatOS 固件和音频外设设计；其他型号则以固件库列表和实测结果为准。
参考：https://docs.openluat.com/air780ehv/ ，https://docs.openluat.com/osapi/core/audio/
98. 这个上位机连接提示升级，一直升级不成功，之前能用，是哪里问题？
解答： 结论：上位机反复提示升级但升级不成功，优先检查安装包来源、版本兼容、设备固件版本和更新通道，不能在未核对版本前直接归结为“硬件太老”或“旧软件丢失”。
先记录上位机名称、当前版本、提示截图、设备型号和固件版本，再从该产品的官方资料页或固件发布页下载对应版本，确认压缩包是否完整、是否区分新旧硬件或不同型号。安装前关闭旧程序、杀毒软件和占用串口的其他工具，必要时卸载后重新安装，并确认 USB 转串口驱动正常、设备端口可打开。若升级程序能连接设备但更新失败，应查看升级日志和返回码，核对 bootloader、固件编号、硬件版本和电量/供电；仍失败时将完整截图、设备标签和日志提交官方支持。
官方资料入口：https://docs.openluat.com/
99. 为什么780EGG的GNSS不触发gnss_state？
解答： 结论：Air780EGG 的 gnss_state 不触发，首先要在室外开阔环境完成冷启动验证，但仅换到室外还不够，还需确认 GNSS 供电、天线、串口配置、回调注册和固件库均正确。
室内没有足够卫星可见性时，GNSS 可能长时间无定位状态；户外测试应保持天线朝上、无金属遮挡，冷启动预留数分钟并记录原始 NMEA。软件侧确认定位库已正确 require，回调在启动 GNSS 前注册，GNSS 串口没有被其他任务占用，电源使能和天线匹配符合 Air780EGG 设计。若能收到 NMEA 但无定位，重点查天线、卫星信号和星历；若完全无 NMEA，重点查电源、管脚复用、串口配置和固件。不要把基站定位成功当作 GNSS 工作正常。
参考：https://docs.openluat.com/osapi/core/libgnss/
100. Air780EPM如何免BOOT烧录？
解答： 结论：Air780EPM 的免 BOOT 烧录依赖模组当前固件正常运行、USB 数据口可枚举、Luatools 能与模组通信。工具在下载前通过软件通道通知模组重启进入下载模式，因此不需要人工按住 BOOT。
使用时先让模组正常上电开机，用可传输数据的 USB 线连接电脑，确认设备管理器中能看到 Luatools 使用的端口，驱动正常且端口未被其他软件占用；在 Luatools 中选择正确固件和项目后直接下载，模组会自动重启进入 boot 流程。若程序死机、进入低功耗后 USB 不可用、固件异常、驱动异常或自研板 USB 设计有问题，免 BOOT 就会失败，此时应使用强制 BOOT 下载。量产板仍建议预留 BOOT 测试点，作为故障恢复和产线兜底手段。
工具教程：https://docs.openluat.com/common/Luatools/
101. 请问这是死机了吗？是什么原因？需要导出分析文件吗？
解答： 结论：是否死机要结合现象和日志判定。若设备无串口输出、AT/脚本无响应、网络心跳停止、看门狗反复重启或出现异常复位日志，可按死机/异常重启处理，但不能只凭现象截图直接定因。
先升级到官方最新稳定 core 固件，并运行最小官方 demo 做 A/B 对比，排除外设、电源、SIM、云平台和业务脚本影响。复现时保留完整串口 trace、异常前后日志、固件编号、脚本版本、供电波形和最小复现工程；若系统生成崩溃转储或 ramdump/异常记录，应一并导出。业务侧重点排查死循环、阻塞任务、内存不足、野指针/越界、I2C/UART 阻塞、低功耗唤醒冲突和供电跌落。最小 demo 正常而业务异常时，再逐段加入外设和业务逻辑缩小范围。
日志排查参考：https://docs.openluat.com/common/howtouselog/
102. 这个iRTU固件节能模式电流降不下来，一直是30ma，怎么办？
解答： 结论：三种模式测出来都约 30mA，通常说明设备没有真正进入目标低功耗状态，或者板级外围持续耗电；不能只凭网页配置判断节能模式已生效。
先用 Air9000P 等仪器抓取完整电流曲线，区分开机注网、数据传输、空闲保持、PSM/休眠和周期性唤醒，不要用万用表平均值或单个峰值判断。检查项包括：iRTU 固件和配置是否已保存并重启生效；SIM 卡运营商是否支持目标低功耗模式；信号是否弱到导致频繁搜网；串口、USB、LED、GPIO、传感器、GNSS、屏幕、外部看门狗和 DCDC 是否保持工作；上报周期过短或服务器长连接也会阻止进入深睡。将外设全部断开后只测模组本体，再逐项接入，对比官方开发板和最新 iRTU 固件，才能确定是配置、网络还是板级漏电。
参考：https://docs.openluat.com/value/irtu/firmware/ ，https://docs.openluat.com/common/airpower/
103. 8202C的BOM超标，甲方要求续航5年，方案能做到吗？
解答： 结论：5 年续航不能只看 BOM 或“每天两次、振动推送”的口头估算，必须按电池可用容量、平均电流、振动唤醒次数、定位方式、网络重传、温度、电池自放电和保护板损耗建立电量预算，并用实测曲线验收。
计算时应把每次注网、GNSS/LBS 定位、数据上报、告警推送、扬声器/马达/LED、弱网重试和休眠电流分别折算成毫安时，再乘以每天次数和 5 年天数；同时扣除低温容量衰减、电池截止电压、自放电和安全余量。若振动次数不可控、车辆长期处于弱信号区域、使用实时追踪或频繁 GNSS，5 年目标通常需要增大电池容量、延长上报周期、改用事件触发和分级定位。建议用 Air8202C 目标固件和真实 SIM 卡做至少数天 Air9000P 曲线测试，再让电池厂提供可追溯容量数据。
低功耗参考：https://docs.openluat.com/common/airpower/
104. 这个上位机软件连接提示升级失败，是什么原因？
解答： 结论：升级失败可能与版本匹配有关，但不能直接把原因归结为老版本硬件。应先确认上位机软件、设备固件、硬件版本和更新服务器是否在同一兼容矩阵内，再根据错误码定位。
处理步骤：记录升级界面的完整错误提示、软件版本、设备型号/硬件版本、固件版本和端口日志；从该产品官方资料页重新下载对应上位机和固件，避免使用群文件、网盘转存或来源不明的压缩包。安装时关闭占用串口的软件，检查数据线、驱动、供电和防火墙/网络代理，再执行升级。若官方版本矩阵确实区分新旧硬件，应下载与硬件版本对应的固件；若同一软件提示无法识别硬件，则提交设备标签、升级日志和截图给官方支持核对。
官方资料入口：https://docs.openluat.com/