常见问题 - 2026-10-20

数据日期：2026-10-20

1. Air780EPM模块低功耗模式是否需要运营商eDRX支持？

解答： 结论：不需要。合宙模组的低功耗模式由 pm.WORK_MODE 决定，跟运营商是否开通 eDRX 无关，PSM+ 这类模式可以照常用。说明：eDRX 是 3GPP 的“扩展不连续接收”，属于网络侧能力，要在附着时协商周期；PSM 是设备向网络申请休眠、由 TAU 定时器唤醒。两者都不是“签个业务”才能用的东西，模组的省电模式也不是靠它们实现的。真正需要关心运营商能力的是另一种需求：休眠期间还要能被下行唤醒（被叫可达），这时才涉及 eDRX 周期能不能协商。PSM+ 下模组基本关射频、只留唤醒源，代价是休眠期不可联网，只能靠定时器或外部中断唤醒。处理步骤：① 用 pm.WORK_MODE 设定目标模式，不要去找“eDRX 开关”；② 能接受休眠期离线就用 PSM+，功耗最低；③ 要求随时可被下行唤醒，再向运营商确认核心网是否支持 eDRX 及其周期；④ 用电流表实测休眠电流，不要只看参数表。参考文档：https://docs.openluat.com/osapi/core/pm/

2. 1603是否支持RGB888？

解答： 结论：不支持真正的 24 位 RGB888 显示。Air1603 的 LCD 接口就是 RGB565（65K 色），RGB888 屏只能按兼容模式接入。说明：Air1603 的 LCD 数据线只有 16 根，按 R[7:3]/G[7:2]/B[7:3] 排布，最大驱动 1280×800，带 2D 图形加速与 JPG/PNG 硬解。RGB888 屏接上去只会用到高 16 位，屏低位要按屏规格书固定电平，显示效果等同 RGB565，不是 16.7M 色。Air1601 虽然按 RGB888 布局引出管脚，实际使用同样是 RGB565。处理步骤：① 选屏优先挑 RGB565 接口、driver IC 在 lcd 库支持列表里的型号；② 手上有 RGB888 屏就按高 16 位接，剩余低位按规格书处理，不要无条件悬空；③ 对色彩要求高的项目提前评估平台上限，别等到打样后才发现。参考文档：https://docs.openluat.com/air1603/、https://docs.openluat.com/osapi/core/lcd/

3. MP4转HZV有没有转换工具？

解答： 结论：有。目前用 AirMaster 工具做 MP4→HZV 转换，还没有集成到 Luatools 里。说明：HZV 是 1601/1603 这一代智能 MCU 模组本地播放用的视频格式，配合 mplayer 播放，解码走 SoC 内置硬解，所以必须先把 MP4 转成 HZV 才能流畅播放。AirMaster 是合宙面向 LuatOS / AirUI 的本地嵌入式设计工作台，把文档检索、产品资料、PC 仿真、Lua 烧录和设备日志收进一套能力里，转换这类素材是它的附带功能；Luatools 只负责烧录与日志，没有转换入口。处理步骤：① 装 AirMaster（Windows x64 内测版），用合宙 IoT 账号登录；② 按目标屏分辨率把 MP4 裁好再转 HZV，控制码率；③ 转好的文件放进文件系统或 SD 卡，用 mplayer 播放；④ 卡顿先降分辨率与帧率，再查存储读取速度。参考文档：https://docs.openluat.com/ai/airmaster/

4. 视频播放分辨率是多少？

解答： 结论：HZV 格式按 1024×600、30 帧最稳；MP4 是 320×480、10 帧。说明：差别在解码路径——HZV 走 SoC 硬件解码，能吃下大分辨率、高帧率，适合全屏播放；MP4 是小画面、低帧率的受限解码，用来做开机动画、短提示片更合适。往上加分辨率不是绝对不行，但要看实际有没有掉帧，瓶颈通常在解码能力、存储读取速度和码率，而不是接口本身。处理步骤：① 全屏视频用 HZV + 1024×600@30；② 小窗或短动画用 MP4 320×480@10；③ 转码别把码率拉太高，SD 卡与 Flash 的读速是真瓶颈；④ 用 mplayer 实测帧率，确认不掉帧再定稿。参考文档：https://docs.openluat.com/air1603/、https://docs.openluat.com/air1603/luatos/firmware/1603_version/

5. RGB888的屏直接插排线就可以还是需要飞线？

解答： 结论：可以直接插，不需要飞线——但要接受“只接高 16 位、效果等同 RGB565”这个前提。说明：这里要更正一个常见说法：Air1603 并不是“RGB888 屏完全不能用”。官方产品页写的是 RGB888 屏可按兼容模式接入，只接高 16 位 R[7:3]/G[7:2]/B[7:3]，屏剩余低位按屏规格书固定电平，不要无条件悬空。真正决定能不能点亮的是 driver IC 有没有被 lcd 库适配，以及 50PIN 线序是否对得上，而不是 888/565 这个色彩深度。处理步骤：① 先查屏的 driver IC 是否在支持列表；② 在列表里就按 50PIN 定义直插，逐脚核对线序；③ 不在列表可把屏寄给合宙协助适配；④ 点亮后做灰阶与色块测试，确认低位处理没有引入偏色。参考文档：https://docs.openluat.com/air1603/、https://docs.openluat.com/accessory/mulu/lcd/

6. Air8784是否可以外呼固话或400热线？

解答： 结论：理论上可以，但能不能真拨通取决于 SIP 平台有没有 PSTN 落地能力，终端本身只负责发起 SIP 呼叫。说明：Air8784 是 SIP 通话终端，呼出时它把被叫号码作为 SIP 请求发给已注册的 SIP 服务器，由服务器决定怎么落地。要打到固话或 400，需要 SIP 服务商提供 PSTN 中继/网关并按号码规则放行；合宙的 sip.luatos.com 是设备与软终端互通的体验平台，落地到公网电话要单独确认。另外 400 号码通常只做被叫，呼出方向本身就有限制。处理步骤：① 先确认 SIP 服务商是否提供 PSTN 落地与外呼权限；② 把被叫号码写成带区号的完整号码；③ 先用软终端验证 SIP 侧能呼通，再换设备呼；④ 失败时抓信令看返回码：403 多为权限、404 号码不存在、486 被叫忙。参考文档：https://docs.openluat.com/air8784/product/、https://docs.openluat.com/air8784/software/default_factory_firmware/

7. Air780EGG核心板每次上电都需要按开机键才能运行，如何一上电就自动运行？

解答： 尚未解答

8. 4G物联网卡怎么购买？

解答： 结论：可以联系合宙销售人员购买，或加微信对接；量采通常把流量卡和模组一起谈。说明：物联网卡与模组是两条独立供应链。采购前要先明确网络制式（Cat.1 场景普通 4G 卡即可）、是否要定向白名单（FOTA、LBS 一般需要）、归属地与实名要求、续费与停机规则——这几项直接影响后续运维成本和能不能长期稳定在线。处理步骤：① 报预计出货量与单台月均流量；② 说明是否需要定向白名单、固定 IP；③ 确认续费方式、停机规则与发票；④ 先小批量验证信号与速率，再放量。参考文档：无（属商务事项，请通过购买渠道或对接销售确认）。

9. 有没有纽扣电池供电的板子？

解答： 尚未解答

10. 购买Air8202C定位器主板可以接入自己的小程序吗？

解答： 尚未解答

11. Air780EGT自行画的板子烧录程序后AT指令无响应、开机无读码，如何解决？

解答： 结论：优先查三件事——串口接线与波特率、有没有进 boot、以及 IO 电平是否匹配。Air780EGT 默认 IO 电平是 1.8V，这一条最容易被漏掉。说明：Air780EGT 属于 AT 专用型号，只有 AT 固件，不能烧 LuatOS 脚本，串口默认 115200。更关键的是电平规则：Air780EPT/EHT/EGT/EG2、Air700ECT 这批默认 IO 电平为 1.8V，靠 PIN100 下拉到地才变 3.3V；而 Air780EPM/EHM 的规则正好相反（PIN100 悬空 3.3V、接地 1.8V），不要混用。主控是 3.3V 而 PIN100 悬空时，模组输出 1.8V，双方都可能读不到对方的高电平，表现就是“能烧进去但 AT 不应答、开机没有读码”。处理步骤：① 用万用表量模组 IO 电平与主控是否一致，3.3V 主控把 PIN100 接地；② TX/RX 反接试一次，确认 115200、8N1；③ 看开机瞬间有无 boot 打印，判断是否进了 boot 模式；④ 用官方核心板做对照：能复现是固件/操作问题，不能复现就是自画板的硬件问题。参考文档：https://docs.openluat.com/atmozu/product/shouce/

12. Air8607出厂Demo视频播放后按钮操作回桌面卡死、触摸无反应怎么办？

解答： 结论：这类“播完视频回桌面就卡死、触摸无反应”多半是 UI 线程或刷新被占住、触摸状态没回收。建议直接对照 gitee 上的 Air8607 factory demo，并把日志和最小复现源码给技术支持。说明：Air8607 是 Air1603 大屏最小系统板（不带网络），出厂 Demo 用 airui + lcd + tp。mplayer 播完、页面切换时如果没把播放回调、定时器、flush 任务停干净，回主界面后刷新队列会被堵住，触摸事件就得不到处理；也可能是触摸 IC 在视频期间被独占、没释放。判断“完全无响应”还是“有坐标但界面不刷新”，能少走一半弯路。处理步骤：① 用对应版本的 factory demo 对照，确认自己改过哪些地方；② 抓完整日志（USB 转串口 + 通用串口打印），看卡死前最后几行在做什么；③ 把复现步骤最小化：单页 + 单视频 + 一次返回；④ 仍卡就带日志和源码找技术支持。参考文档：https://docs.openluat.com/air8607/product/、https://docs.openluat.com/air8607/software/debug/

13. Air8607串口打印乱码，应该用哪个波特率？

解答： 结论：用 6M（6000000）。Air8607 主控是 Air1603，V1012 及以后版本的串口默认就是这个速率，选错必然乱码。说明：Air8607 板上带 USB 转串口芯片 CH343，Type-C 直接出串口，Luatools 里要选 CH343 对应端口、勾“通用串口打印”、波特率选 6000000；更早的版本可能是较低速率，如果 6M 乱码可以回退试。烧录时内核要按 Air1603 选，不要选 Air1601——两者同属一代智能 MCU，但固件是按型号各自发布的 .soc，选错内核同样会异常。处理步骤：① 设备管理器确认端口是 USB-SERIAL CH343；② Luatools 选该端口、勾通用串口打印、波特率 6000000；③ 仍乱码就换低波特率并确认驱动已装；④ 烧录用 Air1603 的内核与对应固件。参考文档：https://docs.openluat.com/air8607/software/debug/、https://docs.openluat.com/air1603/luatos/firmware/1603_version/

14. Air8607当前版本不能联网，app怎么装进去？

解答： 结论：当前 Air8607 不带网络（无 WiFi / 4G），应用只能通过 TF 卡（Micro-SD）或串口下载拷进去，没有 OTA；要联网的版本官方路线是选 Air8603。说明：Air8607 是本地大屏应用的最小系统板，对外只有 LCD、触摸、喇叭、Micro-SD 和 Type-C，网络能力要由另一颗模组提供，所以它天生没有远程下发脚本的通道。LuatOS 脚本放在文件系统里，通过 SD 卡把脚本和资源复制进去、重启即可运行；用 Luatools 走串口下载脚本也可以，不一定非要 SD 卡。处理步骤：① 按项目结构把脚本放到 SD 卡；② 开机后在脚本里挂载 SD 卡并把文件拷进内置文件系统；③ 图片、字体、视频等资源一并拷；④ 项目需要联网就评估换 Air8603。参考文档：https://docs.openluat.com/air8607/product/、https://docs.openluat.com/air8603/

15. Air8783H出厂固件中SIP账号/服务器如何配置？

解答： 结论：Air8783H 没有网页配置界面，SIP 账号、服务器、目标号码都写在 sip_cc_bridge_pcm 工程的 sip_cc/config.lua 里，改完重新烧录。说明：Air8783H 是 SIP 与蜂窝通话（CC/VoLTE）双向桥接的专用硬件，两侧语音在模组内部走 PCM，不接 Codec、麦克风和喇叭，所以“配在哪”这件事只能落到脚本上。demo 里 config.lua 管 SIP 账号、目标号码、codec 与检测参数，pcm_sip.lua 管信令与 PCM 媒体适配，sip_cc_app.lua 负责等网络、依次初始化 CC 与 SIP。具体参数对接待可由技术支持跟进。处理步骤：① 从 gitee 拉 module/Air8783H/project/sip_cc_bridge_pcm；② 改 sip_cc/config.lua 里的服务器、账号、密码、被叫号码；③ 确认固件含 CC 纯 PCM 后端与 VoIP PCM 桥接；④ 烧录后先看日志里 SIP 注册是否成功，再发一次呼叫验证双向语音。参考文档：https://docs.openluat.com/air8783h/

16. Air1780P有IMEI和MUID，归属设备ID用哪个？

解答： 结论：归属设备 ID 用 MUID；代码里统一调 hmeta.devid()，4G 模组上这个接口返回的其实就是 IMEI，和机身贴上印的值一致。说明：hmeta.devid() 是“一个接口适配多类模组”的统一入口——4G 模组返回 IMEI、WiFi 模组返回 MAC、MCU 模组返回 unique_id 的 hex 值，业务代码不用自己按型号分支。但后台建档时要注意键的选择：归属关系用 MUID 做索引，IMEI 更适合做上报标识与对账，两个都存、各管一摊。处理步骤：① 代码里统一用 hmeta.devid() 取值；② 需要区分类型时按“15 位纯数字即 IMEI”判断；③ 后台建档时 MUID 作归属键、IMEI 作上报标识；④ 换型号后回归一遍取到的值格式。参考文档：https://docs.openluat.com/osapi/core/hmeta/

17. Air8380原理图上的flash型号与板子上实际丝印不一致，是否换料了？

解答： 结论：以实物丝印为准。原理图上的型号常是设计初稿或可替代料标注，量产换料未必同步改图。说明：Flash 这类物料最容易出现“图上写 A、板上贴 B”——同容量、同接口的兼容料在不同批次会互换，只要容量、封装、时序满足要求，功能上通常不受影响。真正要确认的是容量与接口能否满足应用（文件系统大小、放不放得下视频资源），而不是型号字面一致。处理步骤：① 读 flash ID（代码里读 JEDEC ID 或看启动日志）确认实际容量；② 与项目分区/文件系统需求核对；③ 需要追料就把板子批次与丝印照片给 FAE 确认 BOM 变更；④ 不要按原理图上不存在的型号去下采购单。参考文档：无（需按实物与批次核对，建议把丝印照片交 FAE 确认）。

18. Air8701文档在哪里？

解答： 结论：已上线，地址是 https://docs.openluat.com/air8701/ ，导航里在“Air8701 SIP专用模组”条目下。说明：Air8701 是 SIP 双工通话专用模组，主打内置回声抑制（AEC）芯片——这正是 ES8311 方案在 VoLTE/SIP 双工通话时的短板。页面把合宙支持音频的 4G 模组分成三类（内置 ES8311、可外挂 ES8311、可外挂 TM8211），并列出 Air8701 系列型号与板载资源（音频 PA、16MB SPI Nor Flash 等），选型时看这一页就够。处理步骤：① 打开 /air8701/ 看系列型号表；② 按是否需要贴片 SIM（S 后缀）、底层模组（EHM / EGG）选具体型号；③ SIP+CC+TTS+AirUI 同时用的项目选带 16MB Flash 的版本；④ 具体 SIP 对接按页面文末的 gitee 仓库走。参考文档：https://docs.openluat.com/air8701/

19. Air1780H和Air1780HV是两个独立的底层固件吗？

解答： 结论：不是。Air1780H 与 Air1780HV 是同一个底层固件，不分开出包。说明：同一芯片平台下，合宙常把多个型号归到一份 .soc 上，固件页按“芯片组”发布，型号差异体现在管脚、电平、频段或封装上，而不是另起一套固件。判断方法很直接：看固件页的 target 列表里有没有单独为 HV 出的版本。这类差异属于硬件层面，固件不解决电平匹配问题。处理步骤：① 打开 1780 固件页确认 target 列表；② 按芯片组选同一个版本号；③ 若两者 IO 电平不同，按外围电路匹配，别指望软件切换；④ 烧录后核对设备信息里的型号标识。参考文档：https://docs.openluat.com/air1780/luatos/firmware/1780h_version/

20. 1603接WiFi通讯模块加四口USB集线器，能否接两个摄像头并手机投屏到显示器？

解答： 结论：两个 UVC 摄像头可以接（经 USB 集线器），投屏到显示器也能做；但“双摄 + 投屏 + WiFi 上传”同时跑，Air1603 跑不动。说明：Air1603 的 USB 是 Host，可带 UVC 摄像头，官方规格是 200 万像素拍照、100 万像素录像（1280×720）。两路同时出流，USB 带宽和内存很快见底（用户可用 RAM 约 2MB Lua + 9.8MB 系统）；再加 H.264 编码投屏与 WiFi 上传，CPU 与内存都不够。四口 hub 还要注意供电：摄像头和 WiFi 模组都是耗电大户，靠板子单口供不稳。处理步骤：① 先只接一个摄像头跑通采集+显示；② 再试双摄，看帧率与 USB 是否报错；③ 投屏单独验证；④ 需要三者并行的场景，换更高规格平台或把联网拆到另一颗模组。参考文档：https://docs.openluat.com/air1603/

21. Air8783H的模组型号780EH2与780EHM是什么关系？固件如何选择？

解答： 结论：780EH2 就是 780EHM，只是封装不同。固件按功能选，当前最新是 V2054；拿不准可以问 docs AI。说明：同一颗芯片在不同封装/板级形态下会换丝印，Air8783H 上用的 780EH2 与 Air780EHM 内核一致，固件页看 EHM 那一套即可。V2054 一个底层下按功能分出多个编号的 .soc（脚本区/文件系统大小、是否带 SIP/AIRUI、是否带中文字库等不同），选错编号的典型现象是“某个库不支持”或“空间不够”，不是版本号填错。处理步骤：① 先列清功能清单（带屏？SIP？大文件系统？）；② 到 EHM 固件页按编号对照差异表选；③ 不确定就报功能清单给 docs AI 或 FAE；④ 烧录后用 rtos.meminfo 与固件页信息核对。参考文档：https://docs.openluat.com/air780epm/luatos/firmware/780ehm_version/

22. Air8783H待机时反复重启是什么原因？

解答： 结论：优先怀疑看门狗——8783H 板上有看门狗芯片；先把代码拉到最新再试。待机重启与供电关系不大，但可以用带外部供电的 hub 排除供电因素。说明：外部硬件看门狗靠 GPIO/UART 定时喂狗，如果待机流程里协程被挂起、喂狗任务没跑，超时就会复位；而供电不足一般表现为电压跌落、射频发射瞬间复位，和“待机时周期性重启”的形态不同。8783H 待机时会关掉部分外设，喂狗时序最容易在这里断掉。处理步骤：① 拉最新代码，确认喂狗逻辑在待机分支里仍然执行；② 用示波器看喂狗脚有没有周期脉冲；③ 换带外部供电的 hub 排除供电；④ 看启动日志里的复位源，区分看门狗复位还是欠压复位。参考文档：https://docs.openluat.com/air8783h/、https://docs.openluat.com/common/watchdog/

23. Air8783H做了SIP桥接后其他功能（如MQTT）是否被裁剪？

解答： 结论：底层接口没有被裁剪。SIP 桥接是在常规底层上新增能力，MQTT 等库照常可用；SIP 客户端之间还能互发文本消息，demo 里有。说明：8783H 的固件是在 EC7xx 常规底层上加了 CC 纯 PCM 后端与 VoIP PCM 桥接，属于“新增”而非“替换固件”，socket / mqtt / http 这些库仍在。要注意的是资源占用：桥接期间 PCM 流持续运行，CPU 与内存更紧张，业务逻辑不要放在音频回调里做重活，否则会顶掉通话。处理步骤：① 在同一工程里 require mqtt 跑一遍连通性测试；② 桥接通话期间观察内存与任务是否正常；③ 需要“通话中上报状态”就在独立协程里做，避免阻塞音频；④ 具体可用库清单以固件页支持表为准。参考文档：https://docs.openluat.com/air8783h/、https://docs.openluat.com/air780epm/luatos/firmware/780ehm_version/

24. Air8783H的SIP通话没有声音、音乐播放30秒后才正常怎么办？

解答： 结论：这是 demo 的开场音源还没播完就发起通话导致的。等这段音乐播完再通话就正常；不想等，把播放那段代码注释掉即可。说明：sip_cc_bridge_pcm 工程里带了一段开场音频（Time_travel_8k.mp3），启动时先播放。播放占着音频通路，此时发起 SIP 呼叫，PCM 桥接拿不到通路，听感就是“接通了但没声音”；等播放结束、通路释放，通话就恢复。想确认不是网络或编解码问题，可以先用 MicroSIP 配同样的服务器与账号验证对端。处理步骤：① 找到开场音频播放那段代码并注释；② 或改成先等播放结束再允许呼叫；③ 用 MicroSIP 验证对端可通；④ 核对双方 codec 一致（PCMA / PCMU / G729 / G722）。参考文档：https://docs.openluat.com/air8783h/

25. Air8784/8783H能否注册到客户自己的SIP服务器？端口如何使用？

解答： 结论：可以，改脚本里的服务器地址、账号、密码即可；但合宙的 SIP 体验平台目前不支持把其他 SIP 服务器接进来，别指望在控制台里填第三方地址。说明：设备的 SIP 参数都在固件/脚本的配置里，端口按原代码格式填写（注意区分 UDP 与 TCP/TLS）。8784 出厂固件默认连 cc.luatos.com:8910、UDP，账号用 IMEI、对端用 IMEI+1、密码 123456；换成自建服务器时，这套规则要整体替换成你自己的规划，包括注册有效期、心跳周期与 codec 列表。处理步骤：① 从脚本里找到 SIP 配置项，逐项替换服务器、端口、传输方式、账号、密码；② 确认服务器允许该 codec 与 UDP 承载；③ 抓信令确认 REGISTER 返回 200；④ 再验证双向呼叫与语音，最后才接业务。参考文档：https://docs.openluat.com/air8784/software/default_factory_firmware/、https://docs.openluat.com/air8783h/

26. Air8784按SOS键直接外呼手机号如何实现？

解答： 结论：可以实现。方式是在 sip.luatos.com 控制台建好呼叫任务并“检查并下发”；用自己服务器则在代码里写死被叫号码，或直接改 sip_cc demo。说明：这里有个容易漏的前提——8784 第一次上电默认是 CC（phone）模式，但此时还没有任务，按 SOS 拨不出去。SIP 注册成功只说明设备在线，不等于它有呼叫目标；必须在控制台建好任务并下发之后，SOS 键才有意义。SOS 对应 GPIO20，短按发起任务、来电时按 SOS 接听。处理步骤：① 登录 sip.luatos.com（项目名固定为 8784_SIP，设备先归属到该项目）；② 建“呼叫指定号码”的任务并下发；③ 设备重启后短按 SOS 发起呼叫；④ 用自建服务器时把被叫号码写进脚本配置。参考文档：https://docs.openluat.com/air8784/software/default_factory_firmware/、https://docs.openluat.com/air8784/product/

27. Air8784烧成砖了，拆机按BOOT/POWER钮能否恢复？

解答： 结论：可以恢复。顺序是按住 BOOT → 按一下开机键 → 再上电（插 USB），顺序不能乱；VBAT 供 3.3V，把 BOOT 与 VBAT 短接就等效于按住 BOOT。说明：这是“USB + BOOT”的强制下载模式，也是唯一能救砖的通道——串口烧录要求模组本身还能正常启动，所以串口救不了砖。BOOT 脚的作用是让芯片在上电那一刻进 bootloader，因此必须是“上电时 BOOT 已拉高”，先上电再按是无效的。处理步骤：① 断电，按住 BOOT 不放（或保持 BOOT 短接 VBAT）；② 按一下 POWER，再插 USB 上电；③ Luatools 能识别到下载端口后松开；④ 选 .soc 做全量烧录，不要用差分包或脚本包；⑤ 断电重上电确认恢复。参考文档：https://docs.openluat.com/air8784/software/default_factory_firmware/、https://docs.openluat.com/common/Luatools/

28. SIP网络能否走本地ETH/WiFi，不连公网只连本地FreeSWITCH？

解答： 结论：可以。前提是模组这一侧能拿到本地网络——88xx/8783 系列有 USB 本地联网能力（USB RNDIS），接进本地网后把 SIP 注册到局域网内的 FreeSWITCH 即可，不需要访问公网。说明：SIP 只是应用层协议，链路层能到服务器就行。RNDIS 让模组在主机侧出现一块网卡、走本地路由，FreeSWITCH 在同一局域网内完全够用。要确认三件事：模组侧拿到 IP、能访问 FreeSWITCH 的 IP:端口、UDP 5060 与 RTP 端口段没被防火墙拦。注意 8783H 走蜂窝 SIP 时仍需 SIM 卡与 VoLTE，那是另一条路。处理步骤：① 确认固件支持 USB RNDIS 且已启动；② 设备侧确认 IP 与路由；③ FreeSWITCH 侧放行 SIP 与 RTP 端口段；④ 先用软终端验证局域网注册与通话。参考文档：https://docs.openluat.com/air8783/product/、https://docs.openluat.com/air8783h/

29. 合宙芯片有看门狗功能吗？是硬件还是软件，需要外置看门狗吗？

解答： 结论：有看门狗，而且分三层——内部硬件看门狗（AON 域，内核固件自动喂）、内部软件看门狗（任务调度层）、外部硬件看门狗芯片（GPIO/UART 喂，如 Air153C/Air5101S）。多数应用不用外置。说明：内部硬件看门狗位于 Always-On 电源域，开机即计数，独立于软件运行，能复位绝大多数异常，但极端硬件故障（如 PSRAM 死锁）时不一定有效；内部软件看门狗能抓任务阻塞，但依赖 OS 本身活着。两者都用 wdt 核心库操作。特别要注意：PSM+ 模式下内部硬件看门狗会停止工作——要“休眠期也有人看着”，就必须外置。处理步骤：① 普通应用用 wdt 库开内部看门狗即可；② 工业/无人值守场景加外部看门狗芯片；③ 用 PSM+ 且要求休眠期可恢复的，必须外置；④ 外置喂狗脚要在待机分支里也有周期脉冲，别只在主循环喂。参考文档：https://docs.openluat.com/common/watchdog/、https://docs.openluat.com/osapi/core/wdt/

30. Air8000A做250Hz连续SPI采集时GPIO中断回调延迟、任务调度间断达600ms，如何优化？

解答： 结论：600ms 级别的间断不是“中断慢”，而是有长任务占住了 Lua 协程或阻塞了调度——先定位谁在阻塞，再谈优化。可以把脚本交给 AI（参考 MCP CLI 页），或把源码与日志给技术支持。说明：Lua 协程不可抢占，一个长循环、一次大块 flash 写、一次整屏 flush，都会让其他协程排不上队。250Hz 意味着 4ms 一个周期，任何超过 4ms 的同步操作都会丢点；SPI 采集如果在 Lua 层逐字节拼，本身也会吃掉大量 CPU。方向是“采集下沉到驱动层 + 批量读写 + 环形缓冲 + 让出 CPU”。处理步骤：① 用日志打点定位 600ms 具体发生在哪个函数；② SPI 改批量读写 + 环形缓冲；③ 大块 flash/SD 写拆批，中间 sys.wait 让出；④ 中断回调里只置标志，不做处理；⑤ 仍不达标就把关键路径下沉到 C。参考文档：https://docs.openluat.com/ai/mcp_cli/、https://docs.openluat.com/air8000/product/

31. Air780EPM的LCD休眠时功耗异常，如何解决？

解答： 结论：休眠时要主动调 lcd.sleep() 让屏进睡眠，并且把背光关掉；只停刷新不休眠，屏和驱动仍在耗电。说明：lcd.sleep() 会按驱动 IC 的 sleepcmd（默认 0x10）发睡眠命令，屏进低功耗态；但 LCD 驱动本身占着显存与总线，背光才是耗电大头（几 mA 到几十 mA），所以低功耗场景要“屏睡眠 + 背光关 + 背光脚拉低”。进 PSM+ 之前还要把 airui 一起 sleep，唤醒按“拉高背光/GPIO → lcd.wakeup() → airui.wakeup() → lcd.init → airui.init”的顺序恢复，注意 airui.init 不要重复调用。处理步骤：① 休眠前 lcd.sleep()、airui.sleep()、关背光并拉低背光脚；② 唤醒按上面顺序恢复；③ 用电流表对比“只 sleep”与“sleep+断背光”的差值；④ 检查休眠期间是否还有定时器/协程在跑。参考文档：https://docs.openluat.com/osapi/core/lcd/、https://docs.openluat.com/osapi/core/pm/

32. FOTA多次升级后固件不能正常运行，能否远程清除KV和FS？

解答： 结论：远程“清 KV / 清 FS”没有现成接口，正确做法是出包时就把“检测到异常配置则恢复默认”的处理做进去，而不是事后远程擦除。说明：FOTA 只换固件与脚本，不会清你的 KV 和文件系统——这正是问题所在：旧配置、旧资源、旧分区布局残留在新版本里，读到不兼容的数据就起不来。另外底层固件换了，差分包也必须配套，用错差分包会升级失败甚至变砖。处理步骤：① 出包时加“版本变更 → 校验/迁移 KV”的逻辑；② 关键配置带版本号，读到旧版本自动重置；③ 差分包与底层严格配套，不要混用；④ 现场救砖只能 USB + BOOT 全量重烧。参考文档：https://docs.openluat.com/air780epm/luatos/firmware/780epm_version/、https://docs.openluat.com/common/Luatools/

33. airmaster内没有AIR1603这款产品，安装也报错怎么办？

解答： 结论：AirMaster 还在内测，产品馆没收录的型号属正常，装不上也不必死磕——直接用通用 Agent（如 WorkBuddy）配合官方文档同样能干活。说明：AirMaster 的价值是把文档检索、PC 仿真、烧录、日志收进一个桌面工作台，并通过 MCP 把能力开放给其他 Agent；产品馆是逐步补的，Air1603 这类较新的平台没进列表时，走“查文档 → 自己写脚本 → Luatools 烧录”的老路子最稳。安装报错多见于系统缺少运行库、安装包不完整或被杀软拦截。处理步骤：① 确认下载的是最新内测版、文件完整；② 以管理员运行，临时关掉杀软再装；③ 装不上就换通用 Agent + 官方文档；④ 需要哪个型号进产品馆，直接反馈给 FAE。参考文档：https://docs.openluat.com/ai/airmaster/

34. 旧版Luatools项目管理界面在英文系统下找不到，怎么办？

解答： 结论：把 Luatools 窗口拉大一点，鼠标移到对应位置拖动就能找回来——这是窗口尺寸/DPI 导致控件被裁掉，不是功能丢了。说明：旧版项目管理界面在大字体或高 DPI 的英文系统下，面板最小宽度超过默认窗口，右侧、底部控件会被挤到可视区外，看起来像“没有这个按钮”。Windows 上还可以试“属性 → 兼容性 → 更改高 DPI 设置”，或把系统缩放调回 100%。处理步骤：① 先最大化窗口或手动拉大；② 系统缩放调回 100% 再看；③ 仍不行就换新版 Luatools；④ 拖好后记住窗口尺寸，重启确认是否复现。参考文档：https://docs.openluat.com/common/Luatools/

35. Air8101B批量价格是多少？

解答： 结论：批量价还没定。成本约 16.9 元含税，内部建议淘宝 29.9、批量 28.9；正式批量价以商务报价为准。说明：这是内部测算口径，不是对外承诺价。价格会随 Flash/RAM 配置、封装、订购量和认证要求（WiFi 认证、模组级测试）变化，做 BOM 成本核算时建议留余量，并向销售确认阶梯价与最小起订量。处理步骤：① 报预计年用量与单批数量给销售；② 确认配置（RAM 大小、是否贴片 SIM）；③ 拿到正式报价单再进 BOM；④ 小批试产先用样品/零售价验证。参考文档：https://docs.openluat.com/air8101/

36. Air8101/8101B核心板批量价格是多少？

解答： 尚未解答

37. 液晶屏选好后如何调试驱动？可以用推荐型号吗？

解答： 结论：可以优先用推荐型号。选 RGB 接口、driver IC 在支持列表里的屏，插上基本就能点亮；不在列表的可以把屏寄给合宙调试。说明：能不能出图取决于三件事——接口时序（RGB565、分辨率 ≤1280×800）、driver IC 是否已适配（lcd 库内置列表）、触摸 IC 是否在 tp 库列表。推荐型号之所以省事，就是这几项都被验证过。自己找屏时，datasheet 里的初始化序列、porch 参数、时钟极性都要能对上，否则就是黑屏或花屏。处理步骤：① 拿屏规格书核对接口与 driver IC；② 在支持列表里选型号；③ 不在列表就寄屏适配（附规格书与样品）；④ 点亮后调 porch 与时钟，再校触摸坐标。参考文档：https://docs.openluat.com/accessory/mulu/lcd/、https://docs.openluat.com/osapi/core/lcd/

38. Air780EPM用认证AT固件，是否有支持FOTA的全量升级文件（.sota）？模块已封在设备内只有串口可用

解答： 结论：认证 AT 固件只提供认证所需的那套功能，不承诺带 FOTA 能力，也就没有对应的 .sota 全量包；要远程升级应改用通用固件方案。模块只有串口引出时，用 CH343 这类工具照样能烧。说明：认证固件是为过型号核准、运营商入库做的裁剪版，功能面很窄，FOTA 相关能力不在其中。模块封在设备里只有串口可用时，走的就是串口烧录通道——只要串口能通、能进 boot，用 CH343 这类 USB 转串口工具就能烧，不必拆机走 USB。Luatools 里选“通用串口打印”即可。处理步骤：① 先确认项目到底要“认证”还是“远程升级”，这两者往往不能兼得；② 要 FOTA 就用通用固件 + 平台方案；③ 现场只有串口时用 CH343 + Luatools 串口烧录；④ 认证版本变更要与认证报告同步。参考文档：https://docs.openluat.com/air780epm/luatos/firmware/780epm_version/、https://docs.openluat.com/common/Luatools/

39. Air8000W使用量产文件刷机时选择哪个文件？

解答： 结论：都可以，选 .soc 文件即可；量产工具里按目标型号挑对应的版本与编号。说明：Air8000 系列的固件发布是“一个底层、多个编号”——同一版本号下按功能与分区给出不同 .soc，量产时选与研发验证过的那个编号一致；其他打包形式最终落到芯片上的内容仍是 .soc。关键是版本号与编号别混用别的型号的包，否则会出现“能烧但不工作”。处理步骤：① 确认量产固件的版本号与编号；② 在量产工具里选 .soc；③ 先小批验证功能与电流；④ 记录批次与固件指纹，便于追溯。参考文档：https://docs.openluat.com/air8000/product/、https://docs.openluat.com/air8000/luatos/firmware/

40. iot.openluat.com管理平台是否有类似旧DTU平台的二级用户/用户列表功能？

解答： 结论：目前没有这个功能，统一用 IoT 平台的设备归属来管理；如果旧 dtu.openluat.com 满足需求，可以让 AI 按老平台改代码继续用。说明：新平台的模型是“账号 → 项目 → 设备归属”，没有“二级用户下挂一批设备”的层级。多客户场景一般用“一客户一项目 + 设备归属到对应项目”来隔离，账号分权则放到自己的业务后台做。老 DTU 平台是独立系统，功能不会平移到新平台。处理步骤：① 先确认业务要的是“数据隔离”还是“账号分权”；② 隔离用多项目；③ 分权在自有后台实现；④ 依赖老平台功能的先评估迁移成本。参考文档：无（该功能以 iot.openluat.com 实际界面为准，建议向 FAE 确认产品路线）。

41. Air724UG是否已停产/不再提供售后支持？有没有可平替的芯片？

解答： 尚未解答

42. Air780EGG是否有现货和价格？

解答： 结论：有现货，零售价 38.8 元；Air780EGG 不在代理范围内，没有代理价。说明：这是零售口径，量采价格属商务事项，需要单独对接销售。“不在代理范围”意味着通过代理商渠道拿不到更低价，直接找合宙更合适。下单前建议确认封装与频段是否匹配项目——EGG 是带 GNSS 的型号，别和 EGH、EHM 混用。处理步骤：① 零售渠道直接下单；② 量采报用量给销售谈阶梯价；③ 确认频段与 GNSS 需求是否匹配；④ 长期供货的谈备货协议。参考文档：https://docs.openluat.com/air780egh/product/

43. Air780EVT使用AT+CTTSPARAM指令是否只能用内置音频模式？原I2S接口和外部解码芯片还需要吗？

解答： 结论：Audio Codec 已内置，外挂解码芯片不再需要；但喇叭前面要加音频功放。AT 模式下这是固定用法，只有 Open（LuatOS）模式才能自由使用 I2S 等音频接口。说明：Air780EVT 是内置 ES8311 的 AT 型号，TTS 和 VoLTE 播报都走内部 Codec 出声，所以 AT+CTTSPARAM 配的就是内部通路；它不像 Open 型号那样把 I2S 暴露给你外接 DAC。若项目要接自己的 codec，或要做双工通话，应换 Open 型号（如 Air780EHV）或另选方案。处理步骤：① AT 型号就用内置 Codec + 功放 + 喇叭；② 确认功放输入电平与 Codec 输出匹配；③ 要自定义音频通路换 Open 型号；④ TTS 参数按 AT 手册的 CTTSPARAM 说明配。参考文档：https://docs.openluat.com/atmozu/product/shouce/、https://docs.openluat.com/air8701/

44. Air780EHU的IO电平设置（PIN100拉低/浮空）与Air780EPM相反，是否写反了？

解答： 尚未解答

45. Air780EPM/Air780EHU如何设置IO电平？

解答： 结论：Open（LuatOS）模式下用 pm.ioVol() 设置，例如 pm.ioVol(pm.IOVOL_ALL_GPIO, 1800) 把所有 GPIO 高电平设成 1.8V。AT 固件没有这条指令，只能靠 PIN100 硬件切换。说明：型号规则不同，这点最容易踩坑——Air780EPM/Air780EHM 的 PIN100 悬空为 3.3V、接地为 1.8V；而 Air780EPT/EHT/EGT/EG2、Air700ECT 这批默认 1.8V，PIN100 接地反而是 3.3V。另外模块本身有 1.8V 与 3.3V 两种默认版本，软件调整要以外围电路要求为准，别和硬件跳线冲突。处理步骤：① 确认型号与默认电平版本；② Open 模式用 pm.ioVol 设定；③ AT 模式用 PIN100 在硬件上定死；④ 改完用万用表量几路 GPIO 确认。参考文档：https://docs.openluat.com/osapi/core/pm/、https://docs.openluat.com/atmozu/product/shouce/

46. Air724在巴西用vivo卡连不上网，是否服务器不支持IPv6导致？

解答： 结论：从现象看是“服务器只有 IPv4、模组这侧没拿到可用地址”的组合问题。Air724 是 IPv4 时代的平台；Air8000 才支持 IPv6，而且要在 APN 参数里显式开启。说明：IPv6 需要在 PDP 激活时用 AT+CGDCONT 把 PDP type 设成 IPV6 或 IPV4V6，网络才会下发 v6 地址；只申请 IPv4 而服务器只监听 v6，就永远连不上，反之亦然。海外运营商对 APN、漫游与 PDP 类型的要求各不相同，虚拟运营商还常见“数据业务需特定 APN”的情况。处理步骤：① 用 AT+CGDCONT? 核对 APN 与 PDP 类型；② 用 AT+CGPADDR 看实际拿到的地址族；③ 让服务器侧同时监听 v4/v6，或用域名解析；④ 仍不通就换本地实体卡对比，排除卡侧限制。参考文档：https://docs.openluat.com/air8000/product/、https://docs.openluat.com/air724ug/

47. 1603接WiFi模块时如何使用CH347/CH343下载？

解答： 结论：1603 用 debug_TX/RX 下载，CH343 可以；CH347 的价值是它有两个串口——一路给 1603，一路再接 6205 WiFi 烧录，省一个 USB 口。说明：Air1603 的下载口是调试串口（波特率 6M），USB 转串口芯片只要把 TX/RX/GND 对上、驱动装好就能烧。CH343 是单串口；CH347 是双串口（还带 I2C/SPI/JTAG），做“主控 + WiFi 模组”双烧录台架时更方便。注意 WiFi 模组有自己的烧录口与工具，别串在一起。处理步骤：① 接线：CH343/347 的 TX→1603 RX、RX→1603 TX、GND 共地；② Luatools 选端口、波特率 6000000；③ 双串口时另一路接 6205 烧录口；④ 烧 WiFi 用对应工具与固件包。参考文档：https://docs.openluat.com/air1603/luatos/firmware/1603_version/、https://docs.openluat.com/air6205/product/

48. Air8603开发板的SCH和PCB文件在哪里下载？

解答： 结论：在资料中心的“原理图及PCB封装”页里，Air8603 属于 air160x 这棵树，从 https://docs.openluat.com/air1601/product/shouce/ 往下找对应板型即可。说明：合宙的硬件资料统一放在各产品的 product/shouce（原理图与封装）与 hardware 目录下，出厂固件、尺寸图、3D 文件也在同一棵树。Air8603 与 Air1601/1602 共用一部分板级资料，找的时候按“板型 + 版本”定位，别只按模组名找。处理步骤：① 打开产品硬件页看目录；② 按板型与版本下载 SCH/PCB 压缩包；③ 核对封装与丝印版本；④ 打不开就在同目录找 PDF 版原理图。参考文档：https://docs.openluat.com/air1601/product/shouce/、https://docs.openluat.com/air8603/

49. 1602开发板拨码开关如何设置？与1601教程不一样怎么办？

解答： 结论：看 Air1602 开发板自己的使用说明，把教程要求的那几个开关拨到 ON 即可，其余拨片可以忽略。1602 与 1601 的拨码位号、用途不完全一样，照抄 1601 教程会错。说明：这两代开发板都用拨码开关做电源与外设通道选择（V_LAN、V_4G、V_Air1601、SPI/SD 通道、串口复用等），不同板型位号与默认状态不同。拨错最典型的后果是“屏不亮、串口没输出、SD 卡认不到”，因为通道被切到别的外设上了。注意 SPI 通道是互斥的，用 SD 卡和用以太网要按各自章节设置。处理步骤：① 找到 1602 开发板使用说明里的拨码表；② 按当前实验需要的通道逐一拨到 ON；③ 每次只改一项，改完复位验证；④ 跑 SD/以太网/WiFi 前先确认通道没有冲突。参考文档：https://docs.openluat.com/air1601/product/air1602_turnkey_devboard/

50. Air780EPM的SPI采集与WiFi airlink同时运行时出现丢包、帧率异常，如何解决？

解答： 结论：已定位为 airlink 侧的问题——不走 WiFi 时正常。原因是画图表把主控占住，Air6205 通过 UART3 上传的数据来不及读，帧被冲乱导致丢包；合宙在持续优化 airlink。说明：airlink 支持 SPI 与 UART 两种方式，主控既要跑 SPI 采集又要收 UART 上传，两个都有时序要求。一旦某段代码长时间占着 CPU（整屏刷新、画图），UART 接收缓冲就溢出。这不是链路本身坏，而是调度问题——先减负，再谈链路优化。处理步骤：① 画图/刷新拆成分片，中间 sys.wait 让出；② UART 接收用中断 + 环形缓冲，回调里只搬数据；③ 降低图表刷新率或缩小刷新区域；④ 升级到最新固件与 airlink 版本；⑤ 把复现脚本与日志给合宙定位。参考文档：https://docs.openluat.com/osapi/core/airlink/、https://docs.openluat.com/air780epm/luatos/firmware/780epm_version/

51. Air8000A以太网下载到SD卡速度很慢（约7KB/s），正常吗？

解答： 结论：不正常。以太网与 SD 卡共用 SPI 总线，速度约 200KB/s 上下；7KB/s 说明写法或链路有问题。说明：共用 SPI 意味着两件事互相排队，但即便排队也不该掉到 7KB/s——这个量级更像“每读一小块就写一次文件”，或 TCP 窗口太小、丢包重传。SD 卡的速度等级、文件系统块大小也会放大开销。可换文件系统方式测试，把“先收完再落盘”和“边收边写”对比一下就能看出瓶颈。处理步骤：① 用 4~8KB 以上缓冲成块读写；② 一次打开文件连续写完再关；③ 确认 SPI 时钟跑到可用上限；④ 分别单测以太网吞吐与 SD 写入，定位瓶颈在哪一段；⑤ 换文件系统方式复测。参考文档：https://docs.openluat.com/air8000/product/、https://docs.openluat.com/air8000/luatos/app/driver/sd/

52. Air8000A GPS定位速度/精度如何？

解答： 结论：官方实测口径是“定位卫星的 C/N0 前四颗都超过 45”，属于良好水平；具体精度要看天线、安装环境与是否开阔，文档不给绝对值。说明：C/N0（载噪比）反映信号质量，45dBHz 以上说明天线与射频链路正常。冷启动时间取决于星历是否新鲜、有没有做星历辅助；室内、金属外壳内、天线贴地或被遮挡都会让 C/N0 掉到 30 多，定位就慢甚至定不上。处理步骤：① 户外开阔处冷启动一次，记录首次定位时间；② 看 gnss 库打印的 C/N0 与卫星数；③ 天线做匹配与地平面，远离电源与 USB；④ 需要快速首定位就开星历辅助。参考文档：https://docs.openluat.com/air8000/product/、https://docs.openluat.com/osapi/core/libgnss/

53. 128×64等屏幕驱动IC有哪些支持？如何选择？

解答： 结论：以 lcd 库的支持列表和配件屏目录为准，https://docs.openluat.com/accessory/mulu/lcd/ 列了配件屏型号与驱动 IC，先按列表选；不在列表的可以把屏寄给合宙调试。说明：128×64 这类小屏常见 SPI 接口的段码/点阵驱动 IC，也有 OLED 方案，但能不能用要看当前固件 lcd 库有没有内置该 IC 的初始化序列与时序。选屏看三件事：接口（SPI/I2C/RGB）、driver IC 是否已适配、分辨率与时序是否在支持范围。处理步骤：① 查支持列表；② 确认接口与模组可用总线；③ 不在列表就提供规格书与样品寄调；④ 点亮后按需做字体与刷新优化。参考文档：https://docs.openluat.com/accessory/mulu/lcd/、https://docs.openluat.com/osapi/core/lcd/

54. Air780EGP内网APN应用TCP握手失败如何排查？

解答： 结论：按“固件版本 → 网络可达性 → 应用层”三层排查：先确认固件不是老的，再确认能不能到服务器地址，最后加打印定位握手卡在哪一步。说明：内网 APN（专网卡）常见坑是：APN 参数不对导致 PDP 激活跑到公网、专网只放行特定端口、DNS 不可用只能填 IP。TCP 握手失败通常是 SYN 发出去没有回应（网络不通或端口未放行），或被 RST（服务器未监听）。先确认拿到的是专网地址，再看连接返回码，能省很多时间。处理步骤：① AT+CGDCONT? 核对 APN 与 PDP 类型；② AT+CGPADDR 看地址是否在专网段；③ 用 IP 代替域名试一次，排除 DNS；④ AT+CIPSTART 看错误码；⑤ 全通但应用层失败就抓服务器侧日志。参考文档：https://docs.openluat.com/air780egh/product/

55. Air8000/1603的触摸和按键双控制方案如何审核？

解答： 结论：上传到 https://docs.openluat.com/value/drawcheck/ 平台审核，按平台要求提交图纸与方案说明，审核通过后再投板。说明：带屏方案的“触摸 + 按键”双控制会做结构与电气的交叉检查——触摸 IC 与按键是否共用 GPIO、按键是否影响触摸中断、ESD 与走线是否合理，目的是避免量产才发现互斥。平台化提交比逐个问 FAE 快，也留了记录。处理步骤：① 准备原理图（触摸 IC、按键、上拉/下拉、去抖）与结构图；② 按平台模板上传；③ 逐条闭环审核意见；④ 通过后再投板打样。参考文档：https://docs.openluat.com/value/drawcheck/

56. 不同底层固件版本（新老底层混合）会影响FOTA吗？

解答： 结论：会有影响。不同底层必须用不同的差分包；相同后缀的 core 可以直接升级，后缀不同的不能混用。说明：FOTA 的内核升级是差分方式（脚本可以全量），差分包的基准就是设备当前跑的底层。底层混用会导致校验不过、升级中断，甚至反复升级触发平台保护。工程上要保证“在网设备的底层版本”是可控集合，别让同一批设备散落在多个底层上。处理步骤：① 建立设备底层版本台账；② 每个底层单独出差分包；③ 升级前比对后缀与版本；④ 出现反复升级先在平台“解除禁止升级”，修好再推。参考文档：https://docs.openluat.com/air780epm/luatos/firmware/780epm_version/

57. Air8000的WiFi固件从v14升级到v20一直失败，卡在复位指令，怎么办？

解答： 结论：直接升到最新的 WiFi 升级包（V30），并把 Luatools 更新到最新；用 USB 方式升级，升完再正常烧 4G 固件与脚本，最后在 Luatools 状态栏确认 WiFi 版本。说明：跨版本跳太多（v14→v20）容易在复位/握手环节失败，最新包里已经修过这条路径；工具版本旧也会不认新的握手协议。顺序很重要：先把 WiFi 侧固件升上去，再烧 4G 侧脚本，否则两边版本对不上会互相等。处理步骤：① 下载 Air8000 WiFi 升级包 V30；② Luatools 更新到最新；③ 走 USB 升级，过程中不要断电；④ 升完烧 4G 固件与脚本；⑤ 状态栏核对 WiFi 版本号。参考文档：https://docs.openluat.com/air8000/luatos/app/updatwifi/update/、https://docs.openluat.com/common/Luatools/

58. Air780EPT做样品时电阻用4.7K没问题，小批用4.7K却连不上网，改回47K正常，为什么？

解答： 结论：按原答口径，先把现象交给 docs AI 做一轮解释，判断不合理再找对接人协助分析。从工程角度看，这是典型的“阻值落在临界区，样品与批量的器件/走线差异把裕量吃掉了”。说明：4.7K 与 47K 差一个数量级，同一位置换阻值就恢复，说明这条网络对电流或电平很敏感（常见于 SIM 卡信号、BOOT/上电时序、复位或天线检测脚）。样品阶段手工焊接、走线短、器件一致性好，问题不显现；小批后板材、焊接、器件批次变化，边沿与电平裕量不足就暴露。也不能排除 BOM 位号贴错，实际并不是设计值。处理步骤：① 确认出问题的具体网络与设计意图（上拉还是下拉）；② 对比样品与小批的 BOM、位号、实际阻值；③ 用示波器看该网络的边沿与电平；④ 按设计规范回到推荐阻值，别拿“样品能用”当结论。参考文档：无（需结合原理图与实测，建议把该网络波形与 BOM 交 FAE 分析）。

59. Air8000用Type-C供电（最高1A）是否够用？

解答： 结论：不够。官方口径是要 2A 才保证稳定。说明：Cat.1 模组是脉冲负载，找网和发射瞬间电流会冲到安培级，1A 的适配器没有余量，电压跌落就欠压复位——典型表现是“插电脑 USB 能跑、用 1A 充电头就重启”。Air8000 系列传输时峰值可达 1A，叠加 Type-C 线与座子的压降，必须留余量。处理步骤：① 换 5V/2A 及以上适配器，配短粗线（≥20AWG）；② VBAT 入口就近加 220μF 电解 + 0.1μF 陶瓷；③ 用示波器抓发射瞬间 VBAT 最低点，别低于 3.4V；④ 仍不稳再查天线驻波与 SIM 接触。参考文档：https://docs.openluat.com/air8000/product/、https://docs.openluat.com/air8000/luatos/hardware/design/power/