常见问题 - 2026-08-31
数据日期：2026-08-31
1. 780ehv 能开启 Redis，一切换就发现不了串口
解答： 此处“Redis”应为 RNDIS（USB 虚拟网卡）。结论：开启 RNDIS/ECM 后模组 USB 枚举为网卡设备，原来的 USB 虚拟串口（USB UART）被切换，所以电脑上看不到原有调试串口，属于正常现象而非故障。原因：USB 设备角色从“串口+调试口”切换为“网卡”，设备管理器中新增的是网络适配器，部分模式下调试口不再同口枚举。处理建议：①若仍需看日志，改用模组的物理 UART 串口接 USB-TTL 工具抓日志；②Windows 下在“设备管理器—网络适配器”中确认新枚举的 RNDIS 网卡（Win10 及以上免驱，CDC 设备被禁用会导致看不到）；③需要在网卡与串口模式间切换时，用 mobile.config(mobile.CONF_USB_ETHERNET, value) 配置后进出一次飞行模式并 pm.power(pm.USB,false/true) 重新枚举 USB，参考 Air8000 RNDIS/ECM 教程：https://docs.openluat.com/air8000/luatos/app/common/rndis/ 。注意合宙全系模组不支持 Android RNDIS。
2. 全双工对讲时回声/灌音严重，软件方案效果不行，如何优化
解答： 结论：回声（灌音）本质是本地喇叭播放的远端声音被本机 Mic 再次拾取，形成声学回环；Cat.1 平台算力有限，纯软件全双工 AEC（声学回声消除）无法彻底消除非线性回声，当前官方对讲方案 AirTalk 以半双工效果最优、全双工仍在持续优化。可选方案：①优先采用官方 AirTalk 对讲库（Air8000 的 4/5/11 等号固件支持，已内置降噪与回环消除，基于 MQTT、AMR-NB 8bit/12.2kbps、延迟约 0.5s），量产业务建议先按半双工（按键说话/PTT）设计；②结构声学隔离：Mic 远离喇叭、加密封音腔与减震泡棉、喇叭与咪头避免同腔共振，降低回声源头；③电气上 Mic bias、PA 使能走线与喇叭回路分离，PA 由软件按播放时序控制，避免削波失真引入的非线性回声；④对全双工音质要求高的场景（如门禁对讲），外挂专用音频 DSP 做硬件 AEC，合宙 Air780Exx/Air8000 主芯片本身不做 Audio 处理，需配合 ES8311 Codec 与外置 PA，详见 https://docs.openluat.com/air8000/luatos/hardware/audio/ 。最新全双工固件优化进度请在合宙官方企业微信群确认。
3. AT 指令 AT+CGNSINF 返回 1,0,... 没有定位数据，无法定位
解答： 结论：AT+CGNSINF 返回首字段 1、定位状态字段为 0，表示 GNSS 已开启但尚未完成定位（无有效经纬度），需从天线、环境、供电三方面排查。处理步骤：①确认使用有源 GNSS 天线并按硬件设计手册连接、天线供电正常，无源/内置天线增益不足会导致长时间不定位；②到室外开阔环境测试，室内、楼宇遮挡、金属外壳会显著延长首定位时间甚至无法定位；③发送 AT+CGNSTST=1 打开 NMEA 原始数据流，观察有无 $GNGGA/$GNRMC 输出及卫星数，无任何输出重点查天线和 GNSS 供电，有输出但不定位则等待搜星或更换位置；④确认已正确开启 GNSS（AT+CGNSPWR=1）并核对天线匹配电路。GNSS 调试方法可参考 https://docs.openluat.com/air8201/software/8201G/gnss/gnss_test/ 。
4. 780e 带 V 支持定位不
解答： 结论：Air780EHV 不支持卫星 GNSS 定位。Air780EHV 是在 Air780EPM 基础上强化音频的型号（8MB Flash+8MB RAM，内置 ES8311 Codec，支持 TTS 与 VoLTE 通话），硬件上没有集成 GNSS 模块。选型说明：Air780E 系列中带 GNSS 卫星定位的是 Air780EGH（在 EHM 基础上增加 GNSS）、Air780EGG（增加 GNSS 并内置 DA221 G-Sensor）等“EG”开头型号；若只需要基站/WiFi 粗定位，可用 lbsLoc/lbsLoc2 扩展库实现。选型前请对照官方选型指南确认：https://docs.openluat.com/SelectionGuide/SelectionGuide/ 。
5. 定位坐标在哪里看
解答： 结论：定位坐标可通过合宙 IoT 平台查看。操作方式：①将设备归属到自己的合宙 IoT 账号下（归属方法见 https://docs.openluat.com/air780epm/product/attributioniot/ ）；②登录合宙 IoT 平台 iot.openluat.com，在设备详情中查看上报报文与位置信息，也可使用“合宙物联网”微信小程序在手机端查看设备位置；③GNSS 坐标展示工具入口：https://iot.openluat.com/iot/device-gnss 。注意：设备脚本需已完成定位数据上报，平台侧才能显示坐标。
6. 为什么没有 sim 卡/没焊接？
解答： 结论：合宙部分开发板/核心板出厂内置了贴片式 SIM 卡（eSIM 类贴片卡），板上看不到可插拔卡座的实体卡属正常现象，直接插入支持蜂窝网络的固件上电即可注网。补充说明：①具体批次是否内置贴片卡、卡的资费套餐与有效期，以对应产品购买页和硬件说明为准；②若需要使用自办卡，可使用板上的外置 SIM 卡座并在脚本中做双卡/在位切换；③贴片卡资费问题可咨询合宙官方企业微信或淘宝客服。
7. 官网/资料下载速度慢、文档打不开
解答： 结论：多为网络链路或服务器临时异常，可按以下顺序排查。处理建议：①先确认本地网络正常，更换网络环境（如手机热点）或稍后重试，排除本地运营商到服务器的链路问题；②清除浏览器缓存或更换 Chrome/Edge 浏览器重试，docs.openluat.com 为静态文档站，偶发加载超时刷新即可恢复；③固件/源码体积较大下载慢时，可到 Gitee 官方仓库 https://gitee.com/openLuat/LuatOS 直接下载对应产品目录资源，或用 Luatools 工具内“资源下载”获取固件；④若多个官方站点持续无法访问，请在合宙官方企业微信群反馈具体 URL 与报错截图，由官方核实处理。官方文档入口：https://docs.openluat.com/ 。
8. air8000a 的 g-sensor 哪里有资料，应该下哪个固件
解答： 结论：Air8000A 板载三轴加速度/震动传感器为 DA221，LuatOS 由 exvib 扩展库驱动，下载支持 exvib 的 Air8000 固件即可。资料与操作：①API 文档见 exvib 扩展库：https://docs.openluat.com/osapi/ext/exvib/ ，主要接口为 exvib.open(id)（id 取 1/2/3 对应不同工作模式）、exvib.read_xyz() 读取三轴数据、exvib.close()；DA221 硬件挂在 I2C0，中断/唤醒脚为 WAKEUP2；②示例代码见官方仓库 demo/gsensor/vibration（LuatOS 仓库 Air8000 产品目录下）；③固件在 Luatools 资源下载或 https://docs.openluat.com/air8000/luatos/firmware/ 中选择 Air8000 最新版本、支持 exvib 库的固件号，烧录时勾选“添加默认 lib”。支持 DA221 的整机型号包括 Air8000A/D/U/N/DB/AB、Air780EGG/EGP。
9. AI 工具一直让登录，如何登录/注册
解答： 结论：AI 工具（ai.luatos.com、Trae luatos-docs-code 智能体等）使用合宙 IoT 账号鉴权，需先登录或注册合宙账号。操作步骤：①打开登录页，使用手机号注册合宙 IoT 账号并完成验证；②已注册用户直接用手机号/账号密码登录，注意同一账号在浏览器多标签页的会话保持；③登录后即可使用 AI 问答与智能体功能，Trae 智能体安装与配置可参考 https://docs.openluat.com/ai/trae%2Bluatos-docs-code/install/ 。若登录状态反复失效，清除浏览器 Cookie 后重新登录，或更换浏览器重试。
10. 模块跑到烫手的程度，是否会影响性能
解答： 结论：Cat.1 模组在注网、大流量传输、长时间通话时发热属正常现象，外壳温度 50~60℃（手感发烫）通常仍在规格内，但长期超过结温规格会触发芯片过温保护，导致降频、发射功率回退，表现为网速下降、掉线或重启。判断与处理：①用热电偶/热像仪实测模组屏蔽罩与 VBAT 附近温度，以实测值而非手感为准，工作温度规格一般为 -40~+85℃（工业级）；②优化散热：PCB 加大模组下方铺铜与过孔阵列、加金属屏蔽罩导热到外壳或散热片，避免密闭塑料外壳堆叠发热；③软件降载：避免长时间满功率发射（如连续大文件上传），业务错峰、增大发送间隔，高温场景主动降低发射占空比；④保证 VBAT 供电能力（峰值电流≥2A 且纹波小），供电压差过大也会导致异常发热；⑤若常温常规业务即高温，抓取日志检查是否反复注网/重连（射频功放持续工作），定位软件逻辑问题。
11. air780ehv 用 label 控件多行文本，如何修改文本后移动到最后
解答： 结论：AirUI 的 label 组件更新文本统一用 label:set_text(text)，文本中可用 "\n" 实现多行；AirUI（基于 LVGL 9.4 封装）的 label 对外公开子方法为 set_text、set_font_size、set_color 等，未直接暴露“滚动到底部/末尾”的接口。实现思路：①创建 label 时给定固定的 w/h，超出区域的长文本需要滚动时，在最新版 AirUI（V1.1.4，配套 Air780EHV 的 AirUI 固件，如 14/114、15/115、16/116 号固件）中确认组件是否支持滚动相关配置项，以 https://docs.openluat.com/osapi/core/airui/ 文档中 label 章节实时说明为准；②若需要“追加文本并始终显示最新一行（日志窗口效果）”，推荐做法是自行维护一个行数组，set_text 时只拼接最后 N 行（按控件 h 与 font_size 计算可容纳行数），从而保证视觉始终停留在最新内容；③若 AirUI 未封装所需滚动能力，可在官方仓库 Air780EHV demo 的 airui_label 示例基础上提需求或在合宙官方企业微信群确认当前固件是否已开放长文本模式（wrap/scroll）配置。AirUI 文档：https://docs.openluat.com/osapi/core/airui/ 。
12. 贵司发的快递是什么型号的板子
解答： 结论：发货的具体开发板/核心板型号以订单和快递内包装清单（发货单/产品丝印）为准，无法仅凭快递单号判断。确认方式：①查看淘宝/商城订单中的商品名称与规格；②收到货物后核对 PCB 丝印型号或外包装标签，也可在 Luatools 烧录时工具自动识别模组型号；③若与订单不符或清单不清，提供订单号/快递单号在合宙官方企业微信群或淘宝客服处核对。合宙官方店铺：https://luat.taobao.com/ 。
13. AIR8700 模组 reset 引脚不用如何处理，是否可以悬空
解答： 结论：RESET 引脚在不使用外部复位功能时可以悬空，模组内部已有上拉，常态保持高电平不会误复位。设计建议：①为提高抗干扰能力，量产 PCB 建议在 RESET 引脚上拉到 VDD_EXT（3.3V）或就近加 0.1μF 电容，避免静电/脉冲干扰导致意外复位；②不要将 RESET 直接上拉到高于 IO 电平域的电压，也不要长期强拉低电平，否则模组会持续处于复位状态无法开机；③若需外接主控复位，用开漏/三极管方式拉低即可。具体以上拉阻值和推荐电路以 Air8700 硬件设计手册为准，资料入口：https://docs.openluat.com/ 。
14. 8781P2 板子如何使用，如何烧录 AT 固件
解答： 结论：Air8781P 基于 Air780EPM 方案，仅支持 LuatOS 二次开发，官方不提供 AT 固件，因此不能通过烧录 AT 固件用 AT 指令方式使用。使用方法：①在 https://docs.openluat.com/ 对应产品页下载最新 LuatOS 固件与 demo；②安装 Luatools（下载地址 https://docs.openluat.com/common/Luatools/ ），新建项目选择对应底层 core 与用户脚本，按住 BOOT 再上电进入下载模式后烧录；③需要被外部主控控制时，应在 LuatOS 脚本中自行实现协议（如通过 UART 接收自定义指令、或开启 RNDIS/网络接口），而不是使用 AT 指令。若项目必须使用标准 AT 指令，请改选提供 AT 固件的合宙型号，选型参考 https://docs.openluat.com/SelectionGuide/SelectionGuide/ 。
15. air780epm 和老型号 780E 区别是什么，可以同引脚替代吗
解答： 结论：Air780EPM 是 Air780E 系列的升级迭代型号，资源与性能更强，封装引脚按同系列兼容设计，多数场景可直接同板替代，但仍需按硬件设计手册逐项核对。差异与替代要点：①EPM 基础配置为 4MB Flash+4MB RAM（EHM/EHV 等为 8+8），新增型号细分（EHM 支持 AirUI、EHV 内置音频 Codec、EGH 带 GNSS 等），可按功能选型；②替代前核对电源（VBAT 峰值电流）、SIM、USB、UART、AGPIO/WAKEUP 引脚及复用功能是否与老版一致，个别引脚复用默认值可能不同；③软件需使用 Air780EPM 对应 LuatOS 固件重新烧录，老型号脚本一般可平滑迁移。完整型号差异与引脚对比见官方说明：https://docs.openluat.com/air780epm/product/air780exx/ 。
16. 云平台上的设备升级会清除 KV 分区和系统文件分区吗
解答： 结论：正常 FOTA 升级不会清除用户 KV（fskv 键值对）数据和文件系统中的用户文件。原理：LuatOS 固件分为 core（底层）与 script（脚本）两部分，FOTA 时 script 采用全量覆盖（仅更新脚本程序区域），core 采用差分升级，升级分区与 fskv 数据区、用户文件系统分区相互独立，故升级重启后 fskv 数据与 io 文件系统内容保留。注意事项：①只有在使用 fota 核心库做整盘烧写、Luatools 全量量产烧录勾选擦除、或 fota.finish 时明确指定擦除选项时才可能清除数据区；②升级前建议对关键参数做双备份或云端兜底，避免升级中断电等极端情况；③升级包本身格式错误（core 与脚本混传）会导致升级失败而非清数据。FOTA 机制说明见 https://docs.openluat.com/osapi/ext/libfota2/ 与 https://docs.openluat.com/osapi/core/fota/ 。
17. docs.openluat.com 链接无法打开/加载不出来
解答： 结论：文档站为公开静态站点，无法访问一般是网络链路问题。处理建议：①更换网络（手机热点/其他运营商）或稍后重试，区域性运营商 DNS 或链路故障恢复后即可访问；②执行 ipconfig /flushdns 刷新 DNS，或更换为公共 DNS（223.5.5.5、114.114.114.114）；③更换浏览器、关闭代理/VPN 后重试；④文档与源码也可通过 Gitee 官方仓库获取：https://gitee.com/openLuat/LuatOS ；⑤持续无法访问时在合宙官方企业微信群反馈具体链接与网络环境。文档站入口：https://docs.openluat.com/ 。
18. 项目管理文件页面不见了/添加文件夹项目页面无法显示
解答： 结论：这是 Luatools 项目管理界面的显示问题，不是项目丢失。处理方法：①在项目管理界面拖动左右分区边框，文件列表可能被边框折叠到最右侧，向右拉开即可显示；②调整 Windows 显示缩放（设置—系统—显示—缩放与分辨率，建议 100%/推荐分辨率）后重启 Luatools，高缩放比例会导致布局错位；③更新 Luatools 到最新版本（https://docs.openluat.com/common/Luatools/ ），老版本在新系统下存在界面适配问题；④项目文件实际保存在本地项目目录，界面不显示不影响磁盘数据。
19. 10.1 寸屏代码在哪里下载
解答： 结论：10.1 寸屏示例可参考官方开源的 Air8602（Air1601/Air1602 引擎）智能寄存柜工程，已包含大屏 UI 与完整业务代码。下载地址：https://gitee.com/openLuat/LuatOS/tree/master/module/Air1601_Air1602/project/Air8602_deposit_cabinet 。固件要点：该类 RGB 大屏工程需使用配套的 Air1601/Air1602 固件（历史验证版本为 V1024，建议同时对比当前最新固件），屏幕方向、分辨率（w/h）需与实际 10.1 寸屏参数一致，Air1601 RGB 接口最大支持 1280×800。AirUI 组件用法见 https://docs.openluat.com/osapi/core/airui/ 。
20. 流量卡到期/预销号充值后仍无法使用
解答： 结论：物联网卡到期进入预销号/停机状态后，充值复机与网络侧重新生效存在延迟，并非模组故障。处理步骤：①先通过运营商/购卡渠道确认卡状态确已复机、套餐与 APN 正常；②复机后模组侧重新附着网络：发送 AT+CFUN=0 后再 AT+CFUN=1，或直接重启模组，必要时拔插卡重新检测；③用 AT+CEREG?/AT+CGREG? 查询注网状态、AT+CGPADDR=1 查询是否获取 IP，确认网络已恢复；④若仍无法使用，更换已知正常的 SIM 卡交叉验证，排除卡本身问题；⑤贴片卡/合宙渠道卡复机异常，提供 ICCID 在合宙官方企业微信或购卡渠道核查。
21. 喇叭声音小，是功放的原因吗
解答： 结论：声音小通常不是“功放坏了”，而是喇叭与输出阻抗/功率不匹配、音量参数或 PA 使能配置问题。合宙官方验证使用 8Ω/5W 喇叭配合外置 PA（如 Air8000/Air780EHV 音频方案，ES8311 Codec 输出不能直接驱动喇叭，必须外置音频 PA）音量充足。排查步骤：①核对喇叭规格，优先使用 8Ω/5W 规格，阻抗过大或功率裕量不足会明显偏小声；②确认 PA 使能脚（pa_ctrl）电平与 pa_delay 时序正确，PA 未完全开启会声音小且发闷；③软件中调大播放音量（audio/exaudio 音量参数）与 TTS/音频源本身电平，音频文件本身录音电平低也会导致音量小；④检查喇叭腔体与密封性，开放式安装低频与声压损失明显；⑤用示波器确认 PA 输入端波形幅值无削波。硬件音频说明见 https://docs.openluat.com/air8000/luatos/hardware/audio/ 。
22. 485 接口供电不足，读卡器需要额外 5V 电源，下一批能否提供 5V 供电
解答： 结论：RS485 是通信总线，本身不提供负载供电，模组对外供电能力有限（如 Air1601 VDD_EXT 主要用于外部上拉，不设计为外设供电），读卡器所需 5V 应从系统电源单独取电，不建议由模组引脚供电。处理建议：①当前批次在板上增加一路 5V 电源（取自整机 5V 或增加 DCDC/LDO），共地连接后给读卡器供电，485 的 A/B 仍按原总线接线；②核对整机电源总功率裕量，将读卡器峰值电流纳入电源设计；③下一批硬件改版增加 5V 输出的需求，可提供读卡器型号、工作/峰值电流、接口定义，在合宙官方企业微信群或商务渠道提交定制评估。
23. 8601 人脸识别方案串口是否够用：485 给仓控板、1 串口给人脸摄像头、还有串口给读卡器
解答： 结论：该方案串口资源够用。资源盘点：①Air8601 基于 Air1601 主控，Air1601 用户可用 UART 为 UART1/UART2/UART3/UART5 共 4 路（UART4 为下载调试专用的 DBG_UART，不可占用），另有 1 路 I2C；②Air8601 板载 1 路非隔离 RS485 和 1 路用户 UART、1 路 I2C（对比：Air8602 为 2 路隔离 485、无用户 I2C/UART）；③关键点：人脸识别摄像头走的是 USB2.0 Host 的 UVC 标准协议（100 万像素 720P），不占用 UART，因此“485 接仓控板 + UART 接读卡器 + USB 接人脸摄像头”可同时工作。若仓控板与读卡器都只有串口设备且需要更多 485，可外加 485 收发芯片扩展，或改选 Air8602。硬件规格见 Air1601 硬件手册（https://docs.openluat.com/ 对应 Air1601 产品页）。
24. 小批量交付时间多久，有现货吗
解答： 结论：标准模组/核心板在合宙官方淘宝店（https://luat.taobao.com/ ）一般有现货，下单后按店铺发货时效交付；批量订单（如整机柜类项目）通常按排产计划，模组类交期约 2 周、整机柜类约 20 天，具体以商务确认为准。建议：①小批量先在淘宝店下单现货验证；②确定用量后在合宙官方企业微信群联系商务锁定排产与交期；③旺季或定制料建议提前备货。
25. 购买模块自己设计 PCB，烧录功能在合宙官网吗
解答： 结论：烧录使用官方免费的 Luatools 工具，量产可使用合宙量产烧录工具，均在官方文档站提供下载。资源入口：①Luatools 工具及教程：https://docs.openluat.com/common/Luatools/ ；②量产烧录工具：https://docs.openluat.com/common/Luat_productiontool/ ；③固件与脚本在各产品资料页或 Gitee 仓库 https://gitee.com/openLuat/LuatOS 获取。自研 PCB 时需按硬件设计手册预留 BOOT 下载脚、USB 或下载串口及供电，确保生产时能进入下载模式。
26. AIR8780 模组低功耗文档在哪里看
解答： 结论：Air8780 属于工业模组系列（基于 Air780 Cat.1 方案），低功耗机制与 Air780E 系列一致，可直接参考合宙通用 4G 低功耗指南与对应产品文档。资料入口：①通用《4G 低功耗指南》：https://docs.openluat.com/common/airpower/ ，介绍三种功耗模式（常规、低功耗、PSM+）、pm.power/pm.dtimerStart 配置、AGPIO/WAKEUP 唤醒分类；②Air8780 产品硬件与软件资料：https://docs.openluat.com/ 首页搜索 Air8780 进入产品页；③LuatOS 电源管理 API：https://docs.openluat.com/osapi/core/pm/ 。开发要点：外设使用完毕及时关闭、合理设置休眠唤醒源、注网间隔与心跳周期直接影响平均电流。
27. exnetif 多网融合库桥接路由模式如何维护网络稳定性，4G 断网后是否需要重新初始化桥接
解答： 结论：不需要手动重新初始化桥接。exnetif 库内部维护各网卡状态与优先级，定时进行连通性检测，4G（socket.LWIP_GP）断网后会自动将数据出口切换到可用的高优先级网卡（如以太网/WiFi），4G 恢复后自动切回，setproxy 建立的 NAPT 代理由库管理。稳定性配置要点：①在 task 中调用 exnetif.set_priority_order 按优先级配置网卡，并通过 exnetif.notify_status(cb) 注册回调感知切换；②调用 exnetif.check_network_status(interval) 启动周期性连通性检测；③配置 auto_socket_switch：默认 true，切换网卡时自动断开旧 socket 并用新网卡重建；若设为 false，则切换后需用户代码主动断开 MQTT/TCP 重连，否则仍走旧网卡；④业务层用 IP_READY 与 socket.adapter(socket.dft()) 判断当前默认网卡就绪后再发起连接。详见 https://docs.openluat.com/osapi/ext/exnetif/ 。
28. 多网融合中 ping 逻辑问题：连接中的网络才 ping，实际 ETH/WIFI 正常但一直不切换
解答： 结论：多网优先级模式下 exnetif 通过 ping 结果判断各网卡真实连通性，若“仅对当前已连接网络 ping、未对高优先级网卡探测”，会出现 ETH/WiFi 物理已就绪却不切换的现象，属于检测逻辑需关注的点。配置与规避：①在 set_priority_order 中为每一路网卡明确配置 need_ping 与探测目标，确保对各候选网卡都进行连通性检测而非仅检测当前链路；②无 ping 测试环境（纯局域网/封闭网络）时将 need_ping 设为 false，库仅依据 IP READY 判断链路，避免因 ping 不通外网误判网卡不可用；③保证高优先级网卡（ETH/WiFi）的供电脚 pwrpin、SSID/密码、以太网芯片（如 netdrv.CH390）参数正确，物理链路 UP 后才可参与切换；④用 exnetif.notify_status 回调与 exnetif.check_network_status 观察实际切换日志定位。该库持续迭代，确认逻辑异常时升级到最新版本 lib，见 https://docs.openluat.com/osapi/ext/exnetif/ 版本更新说明。
29. 多网融合中 4G 默认 ping www.baidu.com，内网卡/定向卡不能访问百度，应改成像 WIFI/ETH 一样直接 ping IP
解答： 结论：可通过配置解决，无需改库。exnetif 默认用 httpdns 获取 baidu.com 的 IP 作为连通性探测目标，内网 SIM/定向卡无法访问公网时会一直误判 4G 不可用。set_priority_order 的网卡配置表提供两个参数：①ping_ip：直接指定一个该网络环境内始终可达、地址固定的 IP（内网填内网服务器 IP，定向 APN 填白名单内 IP），库以 ping 通该 IP 作为可用判据；②local_network_mode：局域网场景设为 true，库会自动把 ping_ip 设为网卡网关，此时无需也不应再传 ping_ip（传了无效），注意该模式仅适用于不能访问外网的纯局域网环境。另可通过 ping_time 调整探测间隔（ms，默认 10 秒）。配置示例：LWIP_GP 网卡项中填写 ping_ip = "x.x.x.x"。参数说明详见 https://docs.openluat.com/osapi/ext/exnetif/ 。
30. 1780HV 的固件哪里下
解答： 结论：Air1780HV 与 Air780EHV 为同平台兼容产品，过渡期可直接使用 Air780EHV 的 LuatOS 固件与 demo。下载方式：①在 Luatools 中“资源下载/资源管理”选择 Air780EHV 获取最新固件（注意按功能选择固件号：含 AirUI、hzfont、cc 通话等库需选对应编号）；②Gitee 仓库下载固件与脚本：https://gitee.com/openLuat/LuatOS 下 Air780EHV 相关目录；③产品资料页 https://docs.openluat.com/ 搜索对应型号。烧录前确认硬件版本，后续 Air1780HV 独立固件发布后以产品页公示为准。
31. 1780 这种 MCU 的 OTA 有什么解决方案？批量出货客户不懂如何升级
解答： 结论：MCU 本身不具备蜂窝网络，需借助联网通信模组实现远程 OTA，合宙提供多种成熟组合方案：①外挂 Air6205/Air780ER2 等通信模组，通过 airlink_4g（UART/SPI，AirLink 协议，UART 速率可达 6Mbps、SPI 25Mbps）由联网模组拉取升级包并转发给 MCU 执行升级；②SPI 外挂 CH390 以太网芯片走网线 OTA；③无联网外设时，现场用 USB 接 Luatools 单台烧录，或使用合宙量产烧录工具（https://docs.openluat.com/common/Luat_productiontool/ ）批量烧录。面向“客户不懂升级”的场景，建议在产品固件中内置 FOTA 逻辑（libfota2 + 合宙 IoT 平台或自建 HTTP 服务器），设备上电自动检测版本、下载、校验、重启，客户零操作；AirLink 协议说明见 https://docs.openluat.com/protocols/airlink/ ，FOTA 接口见 https://docs.openluat.com/osapi/ext/libfota2/ 。
32. 8601 板子 libfota3 升级配置了但显示最新版本无法升级
解答： 结论：“已是最新版本”是平台/服务器比较版本号后的正常返回，表示服务端没有比设备当前版本更高的有效升级包，并非升级功能损坏（注意 LuatOS 官方扩展库名称为 libfota/libfota2，无独立“libfota3”库，请先核对代码 require 的库名）。排查步骤：①确认合宙 IoT 平台上已为该项目上传了升级包，且升级包版本号高于设备当前版本号——合宙平台版本号必须为 xxx.yyy.zzz 三段格式（如 001.000.001），格式错误回调返回 5；②确认脚本中 VERSION（及 core 版本）确实低于平台配置，设备以 _G.VERSION 与 rtos.version() 上报比对；③确认 PRODUCT_KEY 与平台项目 key 一致、设备已归属到正确项目、IMEI 匹配；④自建 HTTP 服务器时按协议返回：需升级响应 HTTP 200 且 body 为升级包内容，不需升级必须返回 300 以上状态码，body 为空（0 字节）也会报回调 4；⑤升级成功回调为 0，之后需 rtos.reboot() 才会执行安装。详见 https://docs.openluat.com/osapi/ext/libfota2/ 。
33. Luatools 导入项目报错：包含 readme.md/README.lua 时提示缺少 main.lua 或下载报错
解答： 结论：项目中只能保留一个 README 文件，且必须存在 main.lua 入口。原因：Windows 文件系统不区分大小写，readme.lua 与 README.lua 同时存在时导入阶段会被视为同名文件冲突，而 LuatOS 脚本运行时区分大小写，导致提示缺少 main.lua 或下载报错。处理：删除其中一个重复文件，保证工程根目录含唯一 main.lua，文件名大小写统一后重新导入下载。
34. 1601_v1026 固件烧录后固件版本显示 V1027，程序无法正常运行（屏幕不亮）
解答： 结论：该现象是历史固件打包时版本号标注错误（文件名 V1026、内部版本串显示 V1027），官方已重新上传修正固件；同时该版本对 GPIO13 的复用默认值做了修正。处理：①重新下载并烧录修正后的固件；②用户代码中显式调用 pins.setup 对 GPIO13 及相关复用脚做初始化适配，不要依赖旧默认值；③屏幕不亮时按 LCD 初始化流程核对背光脚供电、lcd.init 的 w/h/direction 参数与屏幕 IC 型号。固件历史版本以 https://docs.openluat.com/air8000/luatos/firmware/ 同体系 Air1601 固件页为准。
35. Air1602 V1.2 开发板上面 6205 不工作，查硬件还是软件
解答： 结论：先按“供电与硬件连接→6205 自身状态→AirLink 软件配置”的顺序分层排查，可快速定位。步骤：①硬件：确认 Air6205（4G 通信子模组）供电正常、与 Air1602 互联的 UART/SPI（AirLink，UART 最高 6Mbps）接线无虚焊、复位脚电平与开机时序正确，必要时交叉更换一片 6205；②给 6205 单独烧录官方最简 demo（如注网/网络 demo）确认其本身可注网、有 IP_READY，排除 SIM 卡与天线问题；③软件：确认 Air1602 固件支持 airlink 库、传输模式（airlink.MODE_UART/MODE_SPI_*）与实际接线一致、波特率匹配，并参考官方 network_routing/AirLink demo 初始化；④用日志确认 airlink 链路是否握手、能力协商是否成功。AirLink 协议与硬件连接见 https://docs.openluat.com/protocols/airlink/ 及该页 physical/hardware 分层文档。
36. 1601+780EPM/780ER2 组合通过 4G FOTA 升级 1602 固件失败，ER2 会自动升级
解答： 结论：780EPM/ER2 自身能升级，只说明 4G 通道与其自身 FOTA 正常；升级 Air1601/1602 必须走 AirLink 协议中的 FOTA 指令（cmd 0x04~0x07），由 4G 模组把升级包透传给 1602、1602 端调用 fota 核心库写入并重启，二者是两套独立流程，不会随 ER2 升级自动完成。排查要点：①确认 1602 固件与脚本支持 airlink 与 fota 库、AirLink 链路（UART 6M/SPI）在升级前已稳定通信（先验证普通 IP 透传/命令互通）；②升级包必须是 1602 对应型号（Air1601/Air1602 固件不通用）的合法 fota 包，4G 模组负责 HTTP 下载并分包透传，注意分片（frag）能力协商；③参考官方 airlink FOTA demo（network_routing/AirLink 工程）两端配套使用，升级完成后对端会回调 "AIRLINK_S*" 类结束消息，1602 侧收到完整包并校验通过后再 fota.finish/重启；④抓链路日志确认 0x04~0x07 指令交互与 ACK。协议见 https://docs.openluat.com/protocols/airlink/cmd_fota/ ，1602 远程升级说明见 Air1601 硬件手册“可通过外接合宙 SOC 引擎实现 FOTA”章节。
37. 780EPM CSDK 新硬件适配变化，新版本 CSDK 能否给老硬件做差分升级
解答： 结论：将 CSDK 更新到最新版本即可同时适配新旧硬件。新版 CSDK 对 10 月 1 日后生产的新硬件做了底层适配，对已出货的老硬件保持兼容，因此可用新版 CSDK 对老硬件做差分升级，升级包制作流程不变。建议升级前在小批量老硬件上先做升级回归验证，并在 CSDK 发布说明中确认目标硬件批次对应的版本要求。
38. 4G 模组出厂时是否有可以用的默认系统
解答： 结论：是。合宙 4G 模组/核心板出厂已烧录可用固件，插入有效 SIM 卡、接好天线后上电即可注网（部分型号出厂为 AT 固件，部分 LuatOS 型号为带基础演示的 LuatOS 固件，具体以产品页说明为准）。二次开发时用 Luatools 烧录自有 core 与脚本即可覆盖；开发资料与固件入口：https://docs.openluat.com/ 。
39. 模组 pwrkey 脚串电阻直接接地，电源由单片机控制，先上电再复位，是否可行
解答： 结论：该上电方式可行，但必须严格按对应型号硬件设计手册的推荐电路与时序操作，不同型号（PWRKEY 开机与 RESET 复位分离设计）接法不同。要点：①确认你使用的是 PWRKEY 开机脚还是 RESET 复位脚：PWRKEY 通常需拉低规定时长（如数百 ms 以上）再释放触发开机，直接常接地在部分型号上等效自动开机，RESET 脚则不能长期拉低，否则模组一直处于复位；②串联合适限流电阻并使用开漏/三极管驱动，避免 IO 倒灌；③由 MCU 控制 VBAT 供电时，要保证电源稳定达到工作电压后再产生开机/复位时序，并满足手册的上电爬升与保持时间；④更稳妥的量产设计是让 VBAT 常供电、用 MCU 控制 PWRKEY/RESET，减少上下电冲击。具体阻容值与时序以该型号硬件设计手册为准（https://docs.openluat.com/ 对应产品页）。
40. AIR8000A 串口卡在 boot rom try normal boot start 后无输出，USB 识别不了
解答： 结论：日志停在“boot rom try normal boot start”后无输出且 USB 不识别，通常是固件未正常启动或 USB 连接问题。处理：①按住 BOOT 键再上电/复位，强制进入下载模式，用 Luatools 重新完整烧录底层固件+脚本（参考烧录故障排查 https://docs.openluat.com/common/howtodown/ ）；②更换质量良好、数据线芯完整的 USB 线和主机 USB 口，劣质线只能供电无法枚举；③确认供电电流足够（VBAT 峰值≥500mA 且稳定），电源不足会在启动早期挂死；④Windows 下检查设备管理器是否有未知设备，必要时重装 USB 驱动（https://docs.openluat.com/common/usb_drv/ ）；⑤若始终无法进下载模式，核对 BOOT/RESET 按键与电平。
41. 休眠电流异常，问题跟着大板走，换模块正常，如何快速定位
解答： 结论：换模组正常、问题跟随大板，基本可判定是大板硬件/外设漏电或唤醒源配置问题，而非模组。快速定位方法：①烧录“上电延时后立即进入深睡（如 30μA 级 PSM/休眠）”的最小固件，去掉注网、传感器轮询等业务，排除软件残留外设耗电；②分区断电排查：逐一断开大板上传感器、电平转换、485 收发器、上拉电阻串等，观察电流变化，重点查未受控的常供电源与 485 收发器 STB/使能电平；③核对 AGPIO/WAKEUP 引脚在休眠态电平，悬空的高阻输入、外部上/下拉不匹配会导致漏电或反复唤醒；④用万用表 μA 档或电源分析仪测休眠电流，串口可配置定时唤醒间隔输出状态辅助判断。4G 低功耗设计与引脚分类见 https://docs.openluat.com/common/airpower/ 。
42. 780EPM 支持 2G 网络吗
解答： 结论：不支持。Air780EPM 是 LTE Cat.1 bis 全网通模组，仅支持 4G（LTE）网络，不支持 2G（GSM/GPRS）和 3G。在已关闭 2G 网络的地区可直接使用；若部署环境仅覆盖 2G，则需改选支持 2G 的型号，选型以官方选型指南为准：https://docs.openluat.com/SelectionGuide/SelectionGuide/ 。
43. 调用 LuatOS-SoC Air780EPM 7/8 号固件出现 bug，1/2 号没有
解答： 结论：这不是 bug，而是固件功能差异。合宙同一型号发布多个编号固件（1 号、2 号、7 号、8 号……），不同编号内置的核心库不同（如音频、AirUI、tts、cc 等库只在特定编号中包含），7/8 号固件本身不包含该工程调用的库，因此运行报错；1/2 号包含该库所以正常。处理：①查阅该型号固件发布页“固件支持核心库列表”，按工程依赖选择对应编号固件（Air8000 系列列表见 https://docs.openluat.com/air8000/luatos/firmware/ ，Air780EPM 在其产品固件页）；②缺少扩展库时可在 Luatools 烧录时勾选“添加默认 lib”或将对应 lib 脚本加入工程；③不要用固件号大小判断新旧，应以库支持矩阵为准。
44. 文件测试平台怎么用/上传什么
解答： 结论：设备上传文件测试工具用于验证设备向平台上传任意文件的功能，入口为 https://iot.openluat.com/tool/device-upload-test 。使用方式：①登录合宙 IoT 账号，选择需要上传的本地文件（升级包、图片、日志等任意测试文件均可）；②上传成功后在文件上右键即可复制下载链接，把该链接填入设备 HTTP 下载/升级逻辑中做联调；③该工具仅用于功能测试，正式业务请使用自建 OTA/文件服务器或合宙 IoT 平台的正式功能。
45. 同一套代码用不同版本 Luatools 下载效果不一样，2044 固件休眠唤醒后网络直接没有
解答： 结论：应统一使用最新正式版 Luatools 与较新固件进行对比验证；V2044 固件较旧，休眠唤醒后无网络属于已知旧版本问题范畴，优先升级固件排除，而不是在旧版本上定位。步骤：①从 https://docs.openluat.com/common/Luatools/ 下载最新 Luatools（工具会随底层协议、lib 打包规则更新，旧工具下载新固件可能出现 lib 缺失、参数不一致）；②烧录该型号当前最新正式固件，复现休眠—唤醒—注网流程，观察是否出现 IP_READY；③若最新固件仍复现，抓取唤醒前后完整日志（确认是否有 +POWERMODE 唤醒、注网 AT 交互），在合宙官方企业微信群提供固件版本号、最小复现代码反馈；④业务侧唤醒后应等待 IP_READY/socket.adapter(socket.dft()) 就绪再恢复网络业务，不要假设唤醒即在线。低功耗机制参考 https://docs.openluat.com/common/airpower/ 。
46. Air8000W 支持 HT1621，有 HT1622 测试过的吗
解答： 结论：官方目前仅提供 ht1621 段码屏库并适配 HT1621/HT1621B，未对 HT1622 做过官方适配与验证，不能保证直接可用。说明：①ht1621 库接口为 ht1621.setup(cs, data, wr)、ht1621.lcd/data/cmd 等，文档见 https://docs.openluat.com/osapi/core/ht1621/ ；②HT1622 与 HT1621 同为段码 LCD 驱动但命令字、显存映射、RAM 结构存在差异，直接套用 ht1621 库通常显示异常；③确需使用 HT1622，可参照 ht1621 库源码自行移植时序与命令（纯 GPIO 模拟，逻辑不复杂），或在合宙官方企业微信群提交适配需求评估；④Air8000 全固件支持 ht1621，而 Air8101/Air1601/Air1602 不支持该库，选型时一并确认。
47. Luatools 新建项目后返回退出新项目不见了，需重启才显示；打开关闭项目管理总是第一个项目
解答： 结论：这是 Luatools 界面刷新/列表定位的已知体验问题，项目实际已创建并保存在本地，重启后可见即证明数据未丢失。处理：①升级到最新版 Luatools（https://docs.openluat.com/common/Luatools/ ），新版本对项目列表刷新逻辑持续修复；②新建项目后可用“刷新”或重新进入项目管理查看，项目文件保存在 Luatools 工程目录，可直接用该目录确认；③打开项目管理默认定位第一个项目为工具当前行为，可通过最近打开列表或直接打开工程目录进入目标项目；④若升级后仍稳定复现，在合宙官方企业微信群反馈 Luatools 版本号与系统版本。
48. 官网打不开/巨卡，是服务问题吗
解答： 结论：区域性运营商链路故障（曾出现上海电信宽带访问异常）会导致部分用户打不开或卡顿，并非一定是服务器宕机。自查步骤：①用手机热点或其他运营商网络对比访问，若换网络正常即为本机运营商链路问题，等待恢复即可；②刷新 DNS 缓存、更换 223.5.5.5/114.114.114.114 DNS、关闭代理；③更换浏览器重试；④多个网络长时间无法访问时，在合宙官方企业微信群反馈所在地区与运营商。常用入口：文档 https://docs.openluat.com/ ，代码 https://gitee.com/openLuat/LuatOS 。
49. erp.openluat.com 网站中生成固件的权限都关掉了吗？阿里云根证书过期需要生成旧固件做 OTA
解答： 结论：固件生成等内部平台权限按账号受控管理，并非全部永久关闭；因历史根证书（如阿里云旧根证书）过期需要重新生成旧固件做 OTA 的场景，可申请开通相应权限。处理方式：①在合宙官方企业微信群提供 erp.openluat.com 登录账号、公司信息、所需固件型号与版本、用途说明（旧设备 OTA 证书修复）；②由平台管理员核实后开通对应生成权限；③同时建议评估新固件证书链更新方案，避免后续再次过期。
50. 8700H 用哪个脚对 6205 复位，任意 IO 脚都可以吗
解答： 结论：可以用任意普通 GPIO（输出模式）控制 Air6205 的复位脚，但要满足电平与休眠要求。要点：①该 GPIO 需连接到 Air6205 的 RESET 引脚，默认输出高（不复位），需要时拉低规定时长后释放完成复位；②不要选用已被复用为特殊功能（如下载调试、唤醒专用、SIM/USB）的引脚，避免冲突，并确认所选 GPIO 在休眠时电平保持，避免误复位；③若 Air6205 复位脚为 1.8V 电平域而主控为 3.3V，需做电平匹配或开漏+上拉；④更规范的方式是结合 AirLink 的 reset 指令/通知做软件复位，硬复位作为兜底。AirLink 基础指令见 https://docs.openluat.com/protocols/airlink/cmd_basic/ 。
51. 780EHV 远程升级从 bin 文件改成 soc 文件了吗？如何远程升级
解答： 结论：远程升级上传到升级服务器的仍然是 .bin 升级包，.soc 是 Luatools 量产/本地烧录使用的整机固件格式，二者用途不同，并没有把远程升级改为 .soc。机制说明：LuatOS 固件分 core（底层）与 script（脚本），FOTA 时 script 为全量升级，core 为差分升级；①仅升级脚本：上传脚本 .bin 升级包；②升级 core（或 core+脚本）：用官方差分工具基于新旧 .soc 制作 core 差分包（.bin），再上传平台。设备端用 libfota2（推荐）或 fota 核心库发起检测、下载，回调返回 0 后 rtos.reboot() 安装。参考 https://docs.openluat.com/osapi/ext/libfota2/ 与 https://docs.openluat.com/osapi/core/fota/ 。
52. Air8201G-BLMQ 是否有可直接使用的外接 FPC 或小模组，需要外接六轴、震动、充电、红外测温、扬声器等
解答： 结论：Air8201G-BLMQ 外设通过 BTB 连接器引出，目前没有现成集成六轴、震动、充电、红外测温、扬声器全部功能的标准外接小模组，量产需基于 BTB 定义自行设计外接底板/FPC。可选路径：①使用官方开发套件底板先做功能验证；②量产自行画板，按硬件手册从 BTB 引出 I2C（接六轴/传感器）、GPIO/中断、音频（外接 Codec/PA 驱动扬声器）、电源与充电管理等；③合宙可承接硬件外接板与 FPC 定制开发（需支付硬件开发费），可在官方企业微信群提供功能清单、结构尺寸、预估用量评估。Air8201 资料见 https://docs.openluat.com/air8201/ 。
53. 8201G 量产数量 5-8W 的话如何合作
解答： 结论：年用量达 5~8 万（5-8W）量级可洽谈深度合作，合宙可免费开发硬件公版（公版会上架合宙商城共享），也可按客户需求做定制版。合作方式：①在合宙官方企业微信群联系商务，提供产品功能需求、结构要求、预估月/年用量；②商务评估硬件开发费（定制方案）、模组单价梯度与交期；③公版方案开发费可减免，纯定制（独占结构/功能）的开发费用与 NRE 另议。商务入口也可通过官方淘宝店客服转接：https://luat.taobao.com/ 。
54. 开启 ECM+融合通信后热点连不上网，是不是还需要配置什么
解答： 结论：是的，仅开启 ECM（USB 虚拟网卡）并不会自动让 WiFi 热点（AP）侧设备上网，两者是不同网卡，需要用多网融合建立 AP→外网出口的 NAPT 代理。配置要点：①用 exnetif.set_priority_order 配好外网出口（4G 对应 socket.LWIP_GP，或 WIFI STA/ETH），确认外网链路已就绪；②热点侧在 WIFI 配置中通过 proxy_adapters 或调用 exnetif.setproxy(socket.LWIP_AP, socket.LWIP_GP, {ssid=..., password=...})，把 AP 网卡代理到 4G 出口，库会自动建立 NAPT；③ECM 面向的是 USB 主机（Linux/macOS 免驱），若希望 PDA 走 WiFi 上网，必须确保 AP 代理配置正确且 DHCP 正常分配地址，ECM 与 AP 不能混用同一链路；④确认 4G 已获取 IP（IP_READY）、AP 已启动且密码/加密方式正确，连不上时先用 exnetif.notify_status 回调确认当前出口网卡。完整示例见 https://docs.openluat.com/osapi/ext/exnetif/ ，ECM 配置见 https://docs.openluat.com/air8000/luatos/app/common/rndis/ 。
55. ECM+融合通信，PDA 连接 WiFi 热点可以访问到 linux 端服务端口还是只能访问 LTE 端
解答： 结论：在 ECM+融合通信（NAPT 代理）配置下，PDA 接入 WiFi 热点后流量经 AP 网卡代理到 4G（socket.LWIP_GP）出口，默认只能访问 4G/LTE 侧网络，不能直接访问 USB ECM 所连 Linux 主机端的服务端口。原因：NAPT 把 AP 侧地址转换后从指定出口网卡发出，ECM（USB 网卡）与 AP（WiFi）是相互独立的网卡域，二者之间默认不做转发。若需要 PDA 访问 Linux 端服务，应让 Linux 主机经 ECM/RNDIS 链路与模组互通并单独配置路由，或把 Linux 服务端口部署在 4G 可达侧。网卡代理机制见 https://docs.openluat.com/osapi/ext/exnetif/ 。
56. NAT 模式下 linux 端和 AP 端是否都会分配地址
解答： 结论：不会同时按同一地址池分配。NAT 模式与 WiFi 热点侧的地址分配相互独立：①接入 WiFi 热点的终端由模组内部 WiFi 芯片的 DHCP 服务分配 IP（MAC 地址为终端自身网卡地址）；②USB ECM 所连 Linux 主机由 USB 网卡侧的地址机制分配；③NAPT 只做出口地址转换，不向两个域统一下发地址。因此两个网段各自维护，互不分发对方地址，跨网段访问需额外配置路由/代理。
57. Air780EPM 二开是否来电时有通知接口事件
解答： 结论：LuatOS 语音通话由 cc 库提供，来电时系统发布 "CC_IND" 消息，状态为 "INCOMINGCALL"，订阅即可收到通知；但需注意 Air780EPM（4MB+4MB）硬件资源不支持 Audio 语音功能，实际使用来电/通话应选用支持 cc 与音频的型号（如 Air780EHV 内置 ES8311，或 Air780EHM/EGH 外置 ES8311+PA）。用法要点：①必须在 cc.init() 之前 sys.subscribe("CC_IND", cb)；②回调中判断 state == "INCOMINGCALL" 表示来电，用 cc.lastNum() 取主叫号码，cc.accept(sim_id) 接听、cc.hangUp(sim_id) 挂断；③完整状态含 READY/CONNECTED/SPEECH_START/DISCONNECTED 等。API 文档与示例：https://docs.openluat.com/osapi/core/cc/ ，demo 见各产品目录 demo/cc。
58. 4G 全网通可以二开的模组有哪些，780EPM 有没有更便宜的平替型号
解答： 结论：4G 全网通且支持 LuatOS 二次开发的主力型号包括 Air780EPM（基础款，4MB+4MB）、Air780EHM（8MB+8MB，支持 AirUI）、Air780EGH（带 GNSS）、Air780EHV（音频）、Air700ECH 以及 Air8000 多网融合系列等；在“4G 全网通可二开”这一档位，Air780EPM 是官方主推的高性价比基础型号。选型建议：①价格随 Flash/RAM 与功能（GNSS、音频、UI）递增，无音频/定位需求时 EPM 最具成本优势；②具体实时价格以合宙官方淘宝店与商务报价为准，批量可议价；③按功能而非单纯比价选型，详见官方选型指南 https://docs.openluat.com/SelectionGuide/SelectionGuide/ 。
59. 推荐可以录音、有蓝牙、体积最小、不需要 4G 的芯片
解答： 结论：当前合宙产品线中没有“同时具备音频录音+蓝牙、体积最小、且不带 4G”四者完全吻合的单芯片；最接近的是 Air8101 系列，满足蓝牙、小体积、无 4G 三项，但是否能录音需按其官方能力评估。依据（选型指南与 Air8101 产品页）：①Air8101 是 2.4G WiFi6 + BLE 5.4 的 WiFi SoC，本身不含 4G；体积最小的 Air8101A/Air8101C 为 18mm×18mm×2.3mm（Air8101/B 为 18mm×24mm），是目前合宙带蓝牙的最小模组之一；②其官方 LuatOS 多媒体能力集中在 LCD/TP 与 DVP/UVC 摄像头（拍照、H.264 录像、RTMP 推流），软件目录中未开放 MIC 音频录音章节，即官方没有现成的录音链路，需通过 I2C 外接音频 Codec 并自行评估驱动适配，存在开发风险；③若“录音”是刚性需求且可放宽“不带 4G”，官方有现成的录音定位工牌方案 Air8204（4G），录音功能为其主特性，可直接参考。建议：先在选型指南按“蓝牙/体积/无蜂窝/录音”四维核对，再向商务确认 Air8101 外挂 Codec 录音的可行性与排期。参考链接：选型指南 https://docs.openluat.com/SelectionGuide/SelectionGuide/ ，Air8101 产品页 https://docs.openluat.com/air8101/ ，Air8204 方案 https://docs.openluat.com/air8204/product/ 。
60. 通话时模拟按键输入 DTMF（拨打 10086 后输入分机号）如何实现
解答： 结论：DTMF 双音多频信号（拨打客服后输入分机号/菜单选择）需在通话已接通、状态进入 "SPEECH_START" 后，通过协议栈的 AT+VTS 指令发送；cc 语音库本身只封装了拨号/接听/挂断/录音，没有单独的 DTMF 接口。原理：3GPP 标准中 AT+VTS=
61. 官方文档界面一直打不开
解答： 结论：官方文档站（docs.openluat.com）为持续更新的在线站点，偶发打不开多为本地网络、DNS 或浏览器缓存问题，按以下步骤可快速定位恢复，不必单纯等待。排查步骤：①先确认是全网打不开还是仅个别页面：用手机切换 4G/5G 流量访问同一网址，若流量可开而公司网络不行，属本地网络/防火墙或 DNS 问题，更换 DNS（如 223.5.5.5、114.114.114.114）或挂手机热点重试；②清理浏览器缓存或改用无痕窗口/其他浏览器（Chrome、Edge），关闭代理/VPN/广告拦截插件后重试；③用命令行 ping docs.openluat.com、nslookup docs.openluat.com 判断解析与连通性，解析异常时刷新 DNS 缓存（Windows：ipconfig /flushdns）；④若仅某一篇文档 404，多为页面路径调整，从首页 https://docs.openluat.com/ 导航或站内搜索重新进入；⑤多地多设备均长时间无法访问时，可能是站点维护，可稍后重试并在合宙官方企业微信群反馈确认。资料总站：https://docs.openluat.com/ 。
62. Luatools 自动更新后提示最新但 log 不输出，新版本出问题
解答： 结论：这是 Luatools 自动更新指向的升级服务器地址已变更，旧版本仍请求旧地址，导致“提示已是最新、但日志（log）区不输出或功能异常”，彻底解决办法是手动下载最新版 Luatools 覆盖安装，而不是依赖程序内自动更新。原因：升级接口域名/路径迁移后，旧客户端无法从旧地址取到新版本与配套资源，自动更新判定逻辑失效。操作步骤：①关闭正在运行的 Luatools（含托盘进程），避免 exe 被占用无法覆盖；②到官方文档站获取最新 Luatools 安装包（从 https://docs.openluat.com/ 首页的 Luatools 入口或工具下载页下载），不要继续用本地旧包自更新；③用新下载的 exe 直接覆盖安装到原目录，工程配置不会丢失；④重新打开后连接模组，确认日志窗口正常打印 AT/系统日志；⑤若覆盖后仍无日志，检查串口是否被其他软件占用、波特率是否匹配、USB 驱动是否正常，并尝试重新插拔模组。若按上述处理仍异常，保留 Luatools 版本号与界面截图到合宙官方企业微信群反馈。
63. 设备如何解禁
解答： 结论：“解禁”指设备在合宙 IoT 平台（iot.openluat.com）被停用/锁定后恢复可用，先确认设备归属在自己账号下，多数情况可自助在平台解除，无需联系人工；只有非本账号归属或操作入口缺失时才需联系对应渠道。操作步骤：①登录 iot.openluat.com（账号为手机号，初始密码 88888888，忘记可找回），进入“我的设备”，按 IMEI 搜索到被禁用的设备；②查看设备状态与禁用原因（如欠费、异常上报、被项目停用、归属转移冻结等），在设备详情/项目管理中选择“启用/解除禁用”，保存后设备即可重新上线；③若设备是因流量卡/套餐欠费停用，需先到对应流量平台续费后再恢复；④若设备不在本账号（如线下批量订单默认在采购账号、iRTU 设备在专属账号、第三方渠道购买），合宙客服与技术均无权限跨账号操作，需由当前归属账号在平台内做“转移/启用”，或联系实际销售渠道处理；⑤2025 年 10 月前电商渠道设备的归属类问题联系官方店铺客服。设备归属与转移规则见 https://docs.openluat.com/air780epm/product/attributioniot/ 。
64. 回声抑制测试咋样了，有硬件了吗
解答： 结论：回声抑制（AEC）官方已具备软硬件两条路径，可直接验证：①硬件/固件级 AEC：Air8000 最新 V2050 固件新增 20/120 号固件，核心组合为 TTS+audio_v2+硬件 AMR/AEC（该固件 FS 区 1536K，不含 SMS、LCD/AirUI、蓝牙库），烧录后可获得硬件回声消除能力，固件列表与更新记录见 https://docs.openluat.com/air8000/luatos/firmware/ ；②软件回声抑制：audio_v2 核心库在 V2048 版本已“优化软件回声抑制”，V2046 修复了通话/录音可能死机的问题，13/113 号固件可用 audio_v2，适合先快速联调。硬件前提：主芯片不做 Audio 处理，需 ES8311 Codec 配合外置 PA（如 AirAUDIO_1010/1020 配件板），Mic 与喇叭做声学隔离，硬件设计与注意事项见 https://docs.openluat.com/air8000/luatos/hardware/audio/ 。验证建议：优先烧录 V2050 的 20/120 号固件，按 audio_v2 通话 demo（https://gitee.com/openLuat/LuatOS/tree/master/module/Air8000/demo ）做双端对讲实测；若仍达不到门禁/对讲级全双工效果，外挂专用音频 DSP 做硬件 AEC。具体固件开放进度可在合宙官方企业微信群核对。
65. Air8202 原理图/3D 模型在哪里
解答： 结论：Air8202 的原理图等硬件资料在其官方产品资料页下载；同系列的 Air780EGG 与 Air780EGP 硬件完全兼容，缺少资料时可直接参考 Air780EGP；官方暂未提供独立 3D 结构模型，需要做结构设计可参考官方给出的 3D 打印外壳设计文件。获取步骤：①打开 Air8202 产品资料页 https://docs.openluat.com/air8202/product/ ，在“原理图/PCB 封装/硬件设计”栏目下载原理图 PDF 与封装库；②若该页资料不全，到 Air780EGP 对应产品页下载同板硬件资料（两者 PinToPin、电路一致，可直接套用）；③需要 3D 建模尺寸时，以规格书中的模组外形与定位孔尺寸为准，或下载官方 3D 打印外壳设计文件（STL/STEP）反推安装尺寸，用于开模与外壳设计；④量产前建议将自绘原理图通过官方“原理图评审”通道（https://docs.openluat.com/value/ ）提交评审，避免电源、SIM、天线走线问题。若资料页未找到所需文件，在合宙官方企业微信群留言索取具体型号版本资料。
66. 模块插卡使用一段时间后报 +CME ERROR: 6 是什么情况
解答： 结论：+CME ERROR: 6 对应 3GPP 标准中的 "phone failure"/SIM 相关错误，在合宙模组上结合“插卡使用一段时间后才出现”的现象，通常表示模组在运行过程中与 SIM 卡通信中断（识别不到卡或卡无响应），属于硬件接触、供电或 SIM 信号完整性问题，而非卡被锁。原理：模组上电后通过 USIM 接口（DATA/CLK/RST，带供电与检测）周期性与卡交互，任意一根信号在振动、温漂、电压跌落时异常，协议栈读卡失败即抛出该错误。排查步骤：①先换一张确定正常的正规运营商卡交叉验证，排除卡本身氧化、老化或停机；②检查卡座：SIM 卡是否插到位、簧片是否氧化/变形失去弹性，清洁卡与卡座金手指，振动场景下更换带卡扣的卡座；③查供电：SIM VDD（通常 1.8/3.0V，模组内部 LDO 输出）走线是否过长、去耦电容（典型 0.1μF+1μF 就近放置）是否齐全，VBAT 在发射瞬间跌落也会导致读卡失败，用示波器在卡座端抓 VDD 波形；④查 USIM 信号线：DATA/CLK/RST 走线尽量短、等长、远离开关电源与天线，避免打孔与分叉，ESD 保护器件结电容要小，上拉电阻按硬件手册放置；⑤软件侧用最新固件复现，并在日志中观察 SIM 卡初始化与掉线时间点，若多张卡、多块板均稳定复现且硬件排查无异常，保留最小复现日志在合宙官方企业微信群反馈固件问题。硬件设计规范见对应型号产品页硬件设计手册（入口 https://docs.openluat.com/ ）。
67. 是否有贴片 SIM，资费怎样
解答： 结论：有。合宙多款工业模组/核心板（如 Air8780、Air8781P 系列等）在硬件上同时支持贴片 SIM（eSIM/贴片卡）与外置 MicroSIM 卡座，具体以该型号硬件手册“SIM”章节标注的型号为准；贴片卡本身及流量资费没有统一公开价，需按运营商、套餐流量、年限和采购量单独报价。采购与资费要点：①确认需求：是仅采购已贴片 eSIM 芯片的模组/板卡，还是需要“模组+卡+流量套餐”整体方案，并明确单设备月/年流量、使用地区（国内/全球）、合约年限；②资费与运营商政策、采购量强相关，批量项目可议价，小批量样品可先在合宙官方淘宝店（https://luat.taobao.com/ ）选购带卡版本验证；③正式报价请在合宙官方商务/企业微信群联系商务，提供型号、数量、流量与年限需求，由商务对接运营商出方案；④若使用自有运营商贴片卡，需在硬件设计时预留贴片卡焊盘并确认供电、USIM 走线符合手册。产品硬件支持情况见 https://docs.openluat.com/ 对应型号产品页。
68. 780EP 脚本和 MQTT 服务器断联后如何复位模组重新连接
解答： 结论：MQTT 断连一般不需要复位整机模组，mqtt 核心库已内置自动重连机制，配合外层状态机重建连接即可；只有在协议栈异常时才需要重启。原因：mqtt 库基于 TCP，任何通信失败都会断开；在事件回调中 event=="disconnect"（服务器断开，data 为错误码）或 event=="error"（本地严重异常，data 为 connect/tx/conack/other）即表示链路已断，而 mqtt 库上行数据没有缓存和重发机制，恢复唯一办法就是重连。处理步骤（按推荐顺序）：①开启自动重连：连接前调用 mqttc:autoreconn(true, 3000)，断后每 3 秒自动重连；注意使用 exnetif 多网卡时不要开 autoreconn（自动重连可能选错网卡），改由外层 task 重建；②推荐用官方 demo 的“while 循环+状态轮询”结构：task 内先等 IP_READY（while not socket.adapter(socket.dft()) do sys.waitUntil("IP_READY",1000) end），再 mqtt.create→auth→on→connect，内层每秒用 mqttc:state() 判断，返回 mqtt.STATE_DISCONNECT 即 goto 到异常分支，断开旧实例（mqttc:close()）后回到循环开头重新 create/connect；③重连成功（event=="conack"）后必须重新 subscribe 并由业务自行补发未送达数据；④若怀疑是底层协议栈挂死而非单纯 MQTT 断开（IP_READY 长时间不恢复、AT/注网异常），再用 mobile.reset() 复位协议栈或 rtos.reboot() 重启模组做兜底，并配合 wdt 防卡死。API 与完整示例见 https://docs.openluat.com/osapi/core/mqtt/ ，低功耗唤醒后同样应先等 IP_READY 再恢复 MQTT（参考 https://docs.openluat.com/common/airpower/ ）。
69. Luatools 差分包生成不了（air8000w），一直停住
解答： 结论：Air8000W 差分包在 Luatools 中生成卡住，多为工具版本旧（不支持新固件编号/分区布局）或工程路径含中文/空格/特殊字符导致打包流程挂起，按下面顺序处理即可恢复。操作步骤：①升级 Luatools 到官方最新版（旧版本对 Air8000 系列新固件差分支持不全，是“一直停住”最常见原因），从 https://docs.openluat.com/ 首页 Luatools 入口下载后关闭旧进程再覆盖安装；②把工程与输出目录整体移到纯英文、无空格、无特殊字符的短路径下（如 D:\luatos\proj\），Windows 用户名或桌面若为中文，也需改输出路径，避免压缩/差分组件读取中文路径失败；③核对差分制作前提：参与差分的“旧固件”必须是模组里实际运行的同一编号固件，新旧固件编号不同不能直接做差分（升级会失败），脚本区/FS 大小也要匹配；④关闭占用输出目录的杀毒软件实时扫描与其他 Luatools 窗口，重新“生成差分升级包”；⑤仍卡住时换一台干净电脑、以管理员身份运行 Luatools 复测，并查看 Luatools 日志目录中的报错。差分升级原理与常见错误（差分包过大、旧固件不匹配、编号不一致）见 https://docs.openluat.com/luatos_lesson/009_luatos_fota/ ；若最新版仍复现，保留工具版本与卡住截图到合宙官方企业微信群反馈。
70. AIR780EGH 可以用 AI 编程进行开发吗
解答： 结论：可以。Air780EGH 支持 LuatOS 二次开发，可使用合宙官方 AI 编程助手（ai.luatos.com）辅助生成 Lua 业务代码、外设驱动调用与 demo 框架。使用要点：①AI 生成的代码基于 LuatOS 接口知识库，适合快速搭框架、查用法、解释示例，但型号相关能力（如 EGH 的 GNSS、可用固件编号、内存与外设差异）仍要以官方文档为准，生成后务必对照 API 文档核对函数名、参数与返回值再烧录；②开发流程不变：用 Luatools 选择对应 core 与脚本烧录调试，先跑通官方 demo 再叠加 AI 生成的逻辑；③涉及硬件接线、电源、天线等内容以 Air780EGH 产品页硬件设计手册为准。参考链接：合宙 AI 助手 https://ai.luatos.com/ ，文档站 https://docs.openluat.com/ ，选型 https://docs.openluat.com/SelectionGuide/SelectionGuide/ 。
71. AIR780EGH 用合宙系统可以做降噪吗
解答： 结论：Air780EGH 在 LuatOS（合宙系统）下无法直接做音频降噪，需要外接专用音频处理 DSP（或带降噪/AEC 的 Codec 模块）。原因：EGH 是在基础数据型号上增加 GNSS 定位的版本，硬件上没有音频 Codec、MIC/喇叭通道，主芯片也不运行音频前处理算法，因此软件层面没有可调用的降噪（ANS/AEC）能力，这与带音频硬件的型号不同。可行方案：①若产品必须有语音采集+降噪，硬件上选用带降噪功能的音频 DSP/CodeC 芯片（I2S/PCM 对接，部分型号还支持 AEC 全双工），模组只需通过 UART/I2C 传输压缩后的音频或控制指令；②若希望尽量用合宙内置音频能力，应改选带音频硬件与对应固件的型号（如 Air780EHV、支持 audio_v2/硬件 AEC 的 Air8000 系列），并在对应音频固件上评估通话降噪效果；③麦克风阵列波束成形等高级降噪只能依赖外部 DSP 完成。型号能力对比见选型指南 https://docs.openluat.com/SelectionGuide/SelectionGuide/ ，Air8000 音频硬件设计见 https://docs.openluat.com/air8000/luatos/hardware/audio/ 。
72. AirM2M_780E_V1167_LTE_LSAT 版本的日志文件（db 文件）怎么获取
解答： 结论：AirM2M_780E 系列固件（含 V1167 LTE 版本）的底层 trace 日志默认开启，调试时不需要改固件开关，用 Luatools 即可导出/抓取 db 格式底层日志，同时可一并看 AT 交互层日志。获取步骤：①安装最新版 Luatools 并用 USB 连接模组，正确安装 USB 驱动后在工具中识别到对应串口（含 trace/log 口）；②打开 Luatools 的日志/trace 抓取界面，选择模组的日志端口并开始抓取，复现问题后停止，将日志“保存/导出”为 db 文件（部分版本在日志窗口右键即可另存）；③db 为底层协议栈 trace，需用配套日志分析工具/交给合宙技术解读；用户侧排查业务逻辑时可同时在脚本中用 log.info 打印，并在串口日志中查看 AT 收发交互；④抓取时确保用的是与 V1167 匹配的 Luatools 版本，复现过程完整（从开机/注网到故障点），日志里保留时间戳。日志机制与抓取方法见 https://docs.openluat.com/common/howtouselog/ ；若日志口无输出，检查驱动、波特率、是否被其他串口工具占用，并在合宙官方企业微信群确认该固件号的 db 导出方式。
73. Air8781 这一款芯片可以通过 AT 指令被其他主控控制吗
解答： 结论：Air8781（Air8781P 串口透传插针小板，基于 Air780EPM 方案）官方只提供 LuatOS 固件、不提供标准 AT 固件，因此不能像传统 AT 模组那样直接用 AT 指令被外部主控控制；但它本质是可二次开发的 OpenCPU 模组，可由主控通过自定义串口协议控制。实现路径：①标准 AT 方案不可行：该板定位是 LuatOS 二次开发/透传，出厂没有 AT 指令固件，刷入 AT 固件这条路官方不支持；②需要被主控控制时，在 LuatOS 脚本中用 uart 库监听主控下发的自定义指令（JSON/文本帧均可），在脚本内调用 socket/mqtt/gpio 等 API 执行动作并回传结果，即“自定义协议透传”，这也是该板“串口透传”定位的推荐用法；③若系统必须用标准 AT 指令集，应改选官方提供 AT 固件的合宙型号，而不是在 Air8781P 上强行适配。参考：Air8781P 产品资料 https://docs.openluat.com/air8781p/luatos/hardware/ ，选型指南 https://docs.openluat.com/SelectionGuide/SelectionGuide/ ，文档总站 https://docs.openluat.com/ 。
74. 物联网卡产品量产了是直接找合宙购买还是第三方供应商
解答： 结论：量产采购物联网卡没有强制渠道，既可以通过合宙官方对接“模组+贴片卡/流量”整体方案，也可以由有资质的第三方物联卡供应商直接供卡，两种方式都合规，按供货稳定性、资费与管理平台选型即可。选择建议：①优先官方渠道：需要卡与模组绑定（贴片 eSIM、出厂预装、统一 FOTA/设备管理）或追求一致性售后时，在合宙官方企业微信群/商务渠道联系商务出整体报价，小批量可先在官方淘宝店 https://luat.taobao.com/ 买带卡版本验证；②可选第三方：若公司已有合作运营商/卡商、或对套餐与资费有特定要求，可自行采购标准插拔式物联网卡，模组硬件对卡是通用的，插卡即可用；③量产前务必确认：卡的运营商制式与频段、机卡绑定策略、测试期/沉默期、流量续费与停机规则、是否支持定向 APN，以及海外漫游需求，避免量产后批量掉线；④无论哪条渠道，都建议先小批量做实网与长期在线测试再放量。选型与设备归属管理见 https://docs.openluat.com/SelectionGuide/SelectionGuide/ 与 IoT 平台说明 https://docs.openluat.com/air780epm/product/attributioniot/ 。
75. 780EGT 深睡眠 PSM+ 是否保存网络状态，唤醒后是否需要重新注册附着获取 IP
解答： 结论：需要重新驻网。PSM+ 是深睡眠（深度掉电 RAM 不保持）模式，进入后协议栈断电、网络侧上下文与 PDN 连接释放，唤醒相当于“重新开机运行”，因此必须重新搜网、注册附着（Attach/TAU）并重新获取 IP，不能保留原有网络状态。原理：PSM+ 下 CPU 停止运行、RAM 内容丢失、外设大部分断电，仅 WAKEUP/PWRKEY 等特定引脚可唤醒，电流可低至微安级；这与普通轻睡眠（RAM 保持、网络在线、唤醒即可收发）有本质区别，轻睡眠唤醒后无需重新注网。开发要点：①唤醒后程序从头执行，业务上要把“唤醒”按一次冷启动处理，等待注网成功与 IP_READY 事件后再恢复 socket/mqtt 连接，并重新订阅、补发数据；②唤醒源、唤醒后初始化与各功耗模式差异以 Air780EGT 低功耗文档为准，注意 PSM+ 期间服务器无法主动下发；③若业务要求随时可被下行唤醒，应改用低功耗/轻睡眠模式而非 PSM+。低功耗（PSM+/唤醒/重连）机制见 https://docs.openluat.com/common/airpower/ 。
76. 780EGT 进入 PSM+ 后无法通过 DTR 拉低方式唤醒，必须复位重启
解答： 结论：要先区分当前进入的是哪一档低功耗——DTR 拉低可唤醒的是轻睡眠/普通睡眠；在真正的 PSM+ 深睡眠下 RAM 掉电、程序从头运行，DTR 是否作为有效唤醒源取决于该型号固件配置，若 DTR 不在 PSM+ 唤醒源之列，就只能用指定的 WAKEUP/PWRKEY 引脚唤醒，靠复位重启属现象一致但不是首选做法。排查步骤：①看日志确认模式：唤醒/状态切换时串口会打印 +POWERMODE 类提示，出现 “EXIT PSM+” 才说明确实从 PSM+ 唤醒；若没有该字样，可能根本没进 PSM+ 或 DTR 接线/电平不对；②核对 DTR 电平与硬件：用示波器/万用表确认主控确实把 DTR 拉到了有效电平（注意有效沿/电平定义），线路无虚焊、无外加电平冲突，DTR 引脚复用未被脚本改成其他功能；③查唤醒源配置：以 Air780EGT 低功耗文档的“唤醒源”表为准，确认 DTR 是否支持唤醒 PSM+；不支持时改用 WAKEUP/PWRKEY 唤醒引脚，并在脚本中按文档配置唤醒；④唤醒后按冷启动处理，等待注网与 IP_READY 再恢复业务；⑤用最新固件复测，旧版本可能存在睡眠唤醒缺陷。低功耗与唤醒源说明见 https://docs.openluat.com/common/airpower/ 及 Air780EGT 产品页，确认无效可保留 +POWERMODE 日志在合宙官方企业微信群核对该固件 DTR 是否支持唤醒 PSM+。
77. 780E 上电时 4G 驻网不成功，会间隔多久再驻网一次
解答： 结论：没有固定的“每隔几秒”重试值。上电搜网/驻网失败后的重试节奏由基带协议栈按 3GPP 规范自动控制，会结合 SIM、信号强度、可用小区与拒绝原因动态调整（弱信号或被网络拒绝时退避间隔会逐步拉长），用户脚本不能也不需要设定一个固定秒数。原理：模组上电后依次完成读卡→搜小区→PLMN 选择→Attach，任一环节失败协议栈都会自行退避重试，属于 CP 侧内部状态机。开发建议：①不要在脚本里用固定延时反复重启模组去“催促”驻网，反而会打断正常退避、延长上线时间；②通过订阅网络状态/IP 事件（等待注网成功与 IP_READY）来驱动业务，而不是靠定时器猜测；③若长时间驻不上网，按信号（RSSI、天线是否接好）、SIM（是否欠费/机卡绑定/APN）、频段与运营商、固件版本逐项排查，必要时用 mobile 相关接口或抓底层日志看被拒原因码；④确实需要整机自愈时，用较长的检测阈值（数分钟级）再执行 mobile.reset()/重启，并保留 wdt。低功耗与网络恢复可参考 https://docs.openluat.com/common/airpower/ ，mobile 网络接口见 https://docs.openluat.com/osapi/core/mobile/ 。
78. Air724 可以在 VS Code 上单步调试，Air8000W 如何单步调试
解答： 结论：Air8000W 运行的是 LuatOS Lua 脚本环境，官方不提供像 Air724（AT/Luat 老平台）那样在 VS Code 里打断点、单步跟踪的调试器，Lua 层调试以“日志打印 + 分段验证”为主，这是脚本型固件的通用做法，并非缺陷。推荐调试方法：①日志法：在关键流程用 log.info/log.error 打印变量、状态与事件，用 Luatools 串口日志实时查看，配合时间戳定位；②事件/状态可视化：把网络（IP_READY）、MQTT（conack/disconnect）、中断回调等事件统一打点，先确认状态机走到哪一步；③分段隔离：用最小 demo 先单独验证外设（UART/GPIO/CAN 等），再逐段并入业务，配合 sys.wait 与 task 拆分阻塞点；④善用官方 demo 与合宙 AI 助手（ai.luatos.com）核对 API 用法，用 LuaPC/命令行 Lua 先验证纯算法逻辑；⑤稳定性问题用 errDump 异常上报和 wdt 记录现场。日志使用见 https://docs.openluat.com/common/howtouselog/ ，API 文档见 https://docs.openluat.com/osapi/ 。如确有底层断点级调试需求，需在合宙官方企业微信群确认是否提供 JTAG/仿真支持（一般不对外开放）。
79. 8000W 升级到哪个版本能解决 lib 问题
解答： 结论：一般“lib 报错/缺少 lib”不需要升级固件版本，多数是脚本工程缺少对应的 lib 库文件或 lib 与底层 core 不匹配，用 Luatools 勾选默认 lib 或自行从官方仓库下载对应 lib 放进工程即可，打包时会自动加载。原因：LuatOS 的扩展功能（如 mqtt、http、libfota2 等）以 Lua lib 形式随脚本打包，core 只提供 C 实现的核心库；工程里缺文件、require 名拼错或 lib 版本与 core 不匹配，就会报“找不到库”。操作步骤：①在 Luatools 工程设置中勾选/引入“默认 lib（通用库）”，重新打包烧录，多数缺库报错即消失；②仍缺具体库时，到官方代码仓库按目录下载同名 lib 文件加入工程脚本目录（仓库地址 https://gitee.com/openLuat/LuatOS/tree/master/module ）；③确认 require("xxx") 的名称与文件名一致，并保证 lib 版本对应当前 core；④只有当报错明确指向“底层不支持该 API/该功能需更新 core”（官方更新日志有对应修复）时，才去 Air8000 固件页升级到较新正式固件，升级 core 与 lib 需走差分并注意编号匹配。固件与库见 https://docs.openluat.com/air8000/luatos/firmware/ ；拿不准时把报错日志与 core 版本发合宙官方企业微信群确认。
80. Air8000 更换为 Air8000D 后 CAN 唤醒后收数据死机问题仍存在
解答： 结论：Air8000A/W/D/T/AB/DB/U/N 八个型号共用同一套软件与固件（固件后缀均为 _Air8000），所以由 Air8000 换成 Air8000D 不会改变 CAN 驱动行为，问题依旧属正常现象，应从“收发器硬件选型/供电—唤醒接线—固件与回调处理”三层定位。排查步骤：①核对 CAN 收发器型号：官方适配的是川土微 CA-IF1051VS（注意不是 CA-IF1051S），其供电为 4.5~5.5V、典型 5V，既不能直接用 VBAT 也不能直接用 VDD_EXT，供电错误会导致唤醒后工作异常；②引脚按官方推荐固定：CAN_TXD=PIN36/GPIO36、CAN_RXD=PIN37/GPIO37、CAN_STB=PIN35/GPIO27，且 CAN 前必须用 LuatIO 工具生成 pins 复用配置 json 初始化 IO；③需要 CAN 唤醒时，把收发器 WAKEUP 信号与 CAN_RXD 短接（参考硬件手册 CHG_DET 接法），否则总线报文无法可靠唤醒，唤醒瞬间的首帧处理也易异常；④软件上注册 can.on(id, cb) 回调，先用 can.debug(true) 打开调试，并在 can.CB_ERR/can.CB_STATE 回调中按错误码判断是否进入 bus-off——唤醒后若总线错误计数累积导致 STATE_BUSOFF，需调用 can.reset(id) 或 can.busOff(id) 恢复后再 can.tx/can.rx，避免在未恢复态收发触发死机；接收在 can.CB_MSG 中及时 can.rx(id) 取走，避免接收缓存（can.init 的 rx_message_cache_max）溢出；⑤升级到最新正式固件（当前 V2050），排除旧版本已知 CAN/休眠相关缺陷。硬件设计见 https://docs.openluat.com/air8000/luatos/hardware/can/ ，CAN API 与错误码/总线关闭恢复机制见 https://docs.openluat.com/osapi/core/can/ 。若以上均确认仍死机，保留唤醒前后 can 错误码与最小复现代码在合宙官方企业微信群反馈。
81. 固件太老，是否需要更新固件和 Luatools
解答： 结论：建议更新。固件版本过旧时，很多已知缺陷（通信稳定性、外设驱动、睡眠唤醒、lib 兼容等）已在新版本修复，配合最新版 Luatools 烧录是成本最低的排查手段；Air8000 系列当前可参考的较新正式版本为 V2050（具体以产品固件页实际发布为准）。操作步骤：①先记录当前 core 版本号与固件编号，确认问题是否已在官方更新日志中被修复；②到 Air8000 固件页 https://docs.openluat.com/air8000/luatos/firmware/ 下载最新正式固件（注意按功能选对编号，如带 audio_v2/硬件 AEC 的 20/120 号固件会裁剪部分库），并从文档站下载最新 Luatools；③量产设备远程升级 core 必须走 FOTA 差分包，且参与差分的旧固件要与设备实际固件、编号完全一致（脚本可单独全量升级），差分原理见 https://docs.openluat.com/luatos_lesson/009_luatos_fota/ ；④升级后用同一脚本回归验证，lib 同步更新到与新 core 匹配的版本；⑤若升级后问题依旧，再按外设硬件、供电、接线方向深入排查并抓日志反馈。其他型号请到对应产品页固件目录确认其最新版本号，不要跨型号套用 Air8000 的版本号。
82. 想测试 OTA 升级，怎么将核心板加入
解答： 结论：测试 OTA（FOTA）不需要特殊“接入”动作，核心板插有效 SIM、能联网，设备 IMEI 在合宙 IoT 平台（iot.openluat.com）归属到你的账号/项目，再在脚本里跑官方 FOTA demo 即可收到升级。原理：LuatOS 升级分 FOTA 分区校验写入+重启安装两步，脚本升级走全量、core 升级走差分包，由 libfota2 扩展库（对接合宙升级服务器，最省事）或 fota 核心库（自定义服务器/文件）实现。操作步骤：①注册并登录 iot.openluat.com（账号为手机号），确认设备归属在自己账号项目下，电商购买设备的归属转移方法见 https://docs.openluat.com/air780epm/product/attributioniot/ ；②新建项目并在“我的设备”中确认核心板 IMEI 已在该项目（核心板联网上电后平台可自动识别）；③下载与型号匹配的官方 fota/libfota2 demo（https://gitee.com/openLuat/LuatOS/tree/master/module ），填入项目的 product key 等参数烧录运行，先做“脚本升级”打通链路；④在平台“固件升级”中上传新版本升级包（脚本为全量包、含 core 必须用与设备现网固件同编号制作的差分包），把测试 IMEI 加入升级范围并发布，设备请求后即下载、校验、重启升级；⑤失败时按课程第九部分错误表排查（差分包过大、未配置 IMEI、旧固件不匹配、编号不一致）。完整图文与 API 见 FOTA 教程 https://docs.openluat.com/luatos_lesson/009_luatos_fota/ 。
83. 4G 全部掉线，是不是芯片用一段时间会自己锁死
解答： 结论：芯片不会“用一段时间自己锁死”。多台设备在同一时间点全部掉线（批量掉线），在工程实践中几乎都指向共性外部因素——SIM/物联卡、运营商网络或统一的服务器/供电问题，而不是模组硬件自发批量失效；芯片硬件故障通常是个别、随时间离散出现，不会整批同时发生。原因与排查方向：①卡与套餐（最常见）：物联卡批量停机、流量用尽、机卡绑定/Pool 策略变更、沉默期到期或 APN/定向 IP 规则调整，会导致同批次设备同时掉线，先在运营商/卡商平台查卡状态、流量与生效规则；②运营商网络：当地基站退服、频段调整、平台侧批量拒绝注册，可换运营商卡或换地点交叉验证，并看注册被拒原因码；③业务服务器：若是“设备在线但连不上平台”，检查你的云服务器、域名、证书有效期、防火墙与 MQTT/业务端口，服务器侧故障会表现为“全部设备同时异常”；④供电：若设备共用同一电源/批次电源老化跌落，也会批量重启掉线，测 VBAT 波形；⑤确认是否真掉线：抓底层日志看是脱网（无服务/注册失败）还是仅业务链路断开，单台换机换卡定位。排查方法参考 https://docs.openluat.com/common/howtouselog/ ；确认卡、网、服务器均正常仍批量复现时，保留多台设备掉线前后的 IMEI、时间点与日志，在合宙官方企业微信群统一反馈。