常见问题 - 2026-10-19

数据日期：2026-10-19

1. Air8000A 4G找网/连接时频繁断电重启，5V/1A DC-DC经Type-C供电是否不足？

解答： 结论：官方硬件设计页给的峰值口径是「传输数据时峰值电流可达 1A」，5V/1A 的适配器加一根普通 Type-C 线基本没有余量，搜索网络、发射的瞬间电压跌落就会触发欠压复位，表现出来就是找网时反复重启。说明：Cat.1 模组是脉冲负载，平均电流只有几十毫安，但发射时瞬时可达安培级；适配器标的 1A 是持续输出能力，线材、Type-C 座、PCB 走线上的压降会再吃掉一截，模组端可能已经低于 3.4V 的工作下限。文档里也明确建议电源要能提供足够的瞬态电流，并就近加 220μF 级储能电容。这类问题的典型特征是「插电脑 USB 能跑、用 1A 充电头就重启」，或「刚上电正常、一搜网就掉」。处理步骤：① 换成 5V/2A 及以上的适配器，配短而粗的线（≥20AWG），不要用细长的充电线；② 在 VBAT 入口就近加 220μF 电解 + 0.1μF 陶瓷，压缩瞬态跌落；③ 用示波器抓 VBAT 波形，看发射瞬间最低点有没有掉到 3.4V 以下；④ 供电确认没问题还重启，再查天线驻波、SIM 卡接触与固件版本。参考文档：https://docs.openluat.com/air8000/luatos/hardware/design/power/、https://docs.openluat.com/air8000/product/

2. Air780EPM进入超低功耗模式后唤醒，联网不稳定、登录服务器时间时快时慢，原因是什么？

解答： 尚未解答

3. 8607是否支持连接WiFi模块？

解答： 结论：Air8607 本身不带网络功能——官方产品页写得很明确：「Air8607 本身不带网络功能（无 WiFi / 4G）」，要 4G / WiFi / 以太网联网应选同样基于 Air1603 设计的 Air8603。用 UART 外挂一个 WiFi 模组在硬件上可行，但那是你自己集成，既不是 8607 的官方能力，也没有现成固件适配。说明：8607 的定位是「Air1603 大屏音视频最小系统板」，对外只做 LCD（50PIN）+ 触摸（I2C/FPC）+ 喇叭 + Micro-SD + Type-C，联网交给板上另一颗模组。所以原答里「等后续带 WiFi 的 8607 型号」这个说法需要更正：官方的路线是换 Air8603，而不是 8607 出 WiFi 版本。处理步骤：① 项目要联网就直接选 8603，功能更全还省一块板；② 坚持用 8607 就在 UART 上挂 WiFi 模组，自己在 Lua 里写 AT 驱动与 socket 适配层；③ 外挂方案要单独评估供电与天线，别让 WiFi 天线贴着 LCD 排线；④ 量产前做长时间联网压力测试。参考文档：https://docs.openluat.com/air8607/product/、https://docs.openluat.com/air8603/

4. Air1603能否驱动24寸显示器？如何实现HDMI输出？

解答： 结论：可以驱动，但走的是「RGB 转 HDMI」转接板，而且输出分辨率受 Air1603 显示接口上限约束——最大 1280×800，接 24 寸显示器只能按 1280×800 或更低时序点亮，做不到显示器原生的 1080p/4K。说明：Air1603 只有 RGB565 并行接口（65K 色），市面上有 50PIN RGB 转 HDMI 的成品转接板，一般要两颗芯片完成 RGB→HDMI 编码，淘宝能买到。接 24 寸屏时要确认显示器支持 1280×800 输入并允许缩放，否则会黑屏或提示「不支持的分辨率」。屏幕越大，同样的分辨率越糊，视觉上要提前接受这个前提。处理步骤：① 选 RGB565 时序、分辨率覆盖 1280×800 的转接板；② 逐脚核对转接板与 8607/1603 的 50PIN 定义，别硬插；③ 屏参按转接板手册填，先降频点亮再往上调；④ 长排线注意时钟信号完整性与 EMI，必要时加地线屏蔽。参考文档：https://docs.openluat.com/air1603/

5. Air8607开发板推荐搭配哪些7寸/10寸触摸屏？网上7寸50PIN屏接口与8607不一致怎么办？

解答： 结论：只要屏是 50PIN、RGB565 接口、分辨率在 1280×800 以内就能接，典型规格是 7 / 9 / 10.1 寸 1024×600。网上 7 寸 50PIN 屏「接口不一致」多数是线序与定义不同（有的把触摸 FPC 并进同一排、有的正反接不同），不是不能接，按引脚定义逐脚核对或做一块转接板即可。说明：8607 的 LCD 是常规通用 50PIN 连接器，触摸走 I2C、用 FPC 单独引出。能不能直接点亮还取决于两颗 IC：屏的 driver IC 要在 lcd 库已适配列表里（st7701sn、hx8282、nv3052c、h050iwv 等），触摸 IC 要在 tp 库支持列表里（gt911/gt1158/gt927/cst820/cst816d 等）。驱动不在列表里，接对了也不会出图。处理步骤：① 拿到屏的规格书，对照 8607 硬件文档里的 50PIN 定义逐脚核对；② 确认 driver IC 与 TP IC 是否在库支持列表；③ 不在列表可把屏寄给合宙协助适配；④ 线序不符就做转接板，不要自己改 FPC 硬折。参考文档：https://docs.openluat.com/air8607/product/、https://docs.openluat.com/air1603/

6. Air1602/Air8607开发板4G版如何切换成WiFi版本？

解答： 结论：这是硬件选配加固件配置的组合改动，官方没有公开「改哪两个电阻」的图文说明，必须由 FAE 按你手上这块板子的版本指认位置，不要自行试错。说明：4G 版与 WiFi 版的差别不只是模组，还有供电选通、天线走线与串口路由，部分版本用 0Ω 电阻做二选一（贴 A 位或贴 B 位），改完还必须烧对应版本的固件，否则起不来或者外设全丢。板子版本不同位号会变，凭别人的图改很容易改错。处理步骤：① 拍板子正反面高清照片，报丝印型号与批次给 FAE；② 按 FAE 指认的位号调换电阻，改完用万用表确认选通状态；③ 烧 WiFi 版对应固件；④ 天线与射频匹配按 WiFi 版重新确认，不要沿用 4G 版的天线位置。参考文档：https://docs.openluat.com/air8603/、https://docs.openluat.com/air8607/product/

7. Air1601是否可以用C语言开发？

解答： 结论：不行。Air1601 只提供 LuatOS（Lua 5.3）脚本开发方式，官方不提供 C 语言 SDK，也没有开放裸机开发包。说明：Air1601/1602/1603 这一代是「智能 MCU 模组」，把显示、触摸、音频、UI 框架都做进了固件，应用层用 Lua 调库（airui / lcd / tp / audio 等）。好处是不用搭交叉编译环境、上手快；代价是不能用 C 直接写底层，也没法把已有 C 代码搬过来。如果项目必须用 C，应换到提供 CSDK 的平台（例如 EC7xx 系列模组）。处理步骤：① 先把功能清单过一遍，确认 UI、摄像头、音频、联网都能被现有 Lua 库覆盖；② 性能敏感的部分优先用已有 C 库接口，而不是自己写 C；③ 确实需要 C 开发就改选 CSDK 平台型号；④ 选型前用 ai.luatos.com 或 FAE 复核一遍。参考文档：https://docs.openluat.com/air1601/product/、https://docs.openluat.com/air1603/

8. Air1601/Air1603 AirUI自动刷新能否解决整屏flush阻塞AirLink UART接收导致丢帧的问题？

解答： 结论：不能。AirUI 的自动刷新只跟踪 LVGL 的脏区，你这种「用 display.fill 直接写 draw buffer」的瀑布图不在脏区管理范围内；而强制整体刷新会把一次 flush 拉长到整屏，反而更容易把 AirLink 的 UART 接收饿死，所以它既替代不了局部刷新，也解决不了丢帧。说明：flush 是同步阻塞动作，整屏 RGB565 在 RGB/SPI 时钟下传输的时间远超 UART 一帧的间隔，这段时间里接收中断或协程拿不到 CPU，字节就丢了。正确的方向是「减小单次 flush 的面积 + 让刷新节奏可控」，而不是靠自动刷新兜底；把瀑布图纳入 LVGL 对象（canvas / image）让脏区机制生效，才是根本解法。处理步骤：① 瀑布图改用 LVGL 的 canvas 或 image 对象，让它参与脏区计算；② 分条带 flush，每次只刷若干行而不是整屏；③ 降色深、降分辨率或降刷新率，给 UART 留时间片；④ AirLink 侧加环形缓冲与流控，接收走中断 + DMA，不要在回调里做耗时处理。参考文档：https://docs.openluat.com/air1603/

9. Air780EHV是否有带TTS资源的固件？

解答： 尚未解答

10. 780量采能否配套流量卡？

解答： 结论：可以。量采配套流量卡属于商务事项，直接对接销售（原答给的对接人是杨凤珍）即可，按预计用量谈套餐、结算方式与服务期。说明：流量卡与模组是两条独立供应链，量采通常能拿到比零售更好的资费，但要提前确认几件事：网络制式是否满足（Cat.1 场景普通 4G 卡即可）、是否需要定向白名单（FOTA、LBS 要用）、卡的归属地与实名要求，以及续费与停卡规则。这些都会影响后续运维成本。处理步骤：① 报预计出货量与单台月均流量；② 确认是否需要定向白名单与固定 IP；③ 确认续费方式、停机规则与发票；④ 先小批量验证信号与速率，再放量。参考文档：无（属商务/工艺事项，请通过购买渠道或对接 FAE 确认）。

11. 有没有集成SIP协议的模块？

解答： 结论：现成可用的 SIP 方案是 Air8784 —— Air780EHM + 合宙自研 Air1103 语音芯片，1103 自带 Codec，做 SIP 通话不需要再外挂 ES8311；如果是「SIP 与手机号互通」的纯桥接场景，用专用硬件 Air8783H 更合适。说明：Air8784 的出厂固件里就有 SIP 参数配置（服务器地址、端口、账号、密码、目标号码），改配置即可对接自己的 SIP 服务器。Air8783H 走的是 SIP ↔ 蜂窝通话（CC）双向桥接，语音在模组内部走 PCM，不接 Codec、也不用麦克风和喇叭。原答提到的 8701 属 Air8700 工业模组序列，文档站上未标注其 SIP 能力，选型前请向 FAE 确认。处理步骤：① 要「能听能说」的 SIP 终端选 8784；② 要 SIP 与手机号互通选 8783H，并准备支持语音业务的 SIM 卡；③ 服务器参数按固件页配置后重新注册；④ 自建服务器注意编解码协商（PCMA / PCMU / G729 / G722）与 NAT 穿透。参考文档：https://docs.openluat.com/air8784/product/、https://docs.openluat.com/air8783h/、https://docs.openluat.com/air8784/software/default_factory_firmware/

12. Air780ER/ER2/ER3是否都是单卡？有没有双卡双待型号？

解答： 结论：Air780ER / ER2 / ER3 都是单卡方案，没有双卡双待型号；要双卡只能拿 Air780EPM 这类通用模组自己设计双卡切换电路。说明：ER 系列定位是「USB 上网 / 透传」的成品化模组，封装与接口都按单一 SIM 设计，对外主要是 USB（RNDIS）能力。Cat.1 平台上没有现成的双卡双待方案，双卡要靠外部 SIM 切换开关（双卡座 + 电平切换）实现，还要自己写切换逻辑并处理重新注网、APN 切换这些流程。处理步骤：① 单卡够用就直接选 ER2 / ER3；② 双卡用 EPM 加模拟开关做 SIM 切换，注意 SIM_VDD 与信号线的电平匹配；③ 切换后必须重新注网，不要在通话或数据业务进行中切；④ 两个运营商的卡分别验证驻网、APN 与短信。参考文档：https://docs.openluat.com/air780epm/product/

13. Air780EPM是否有AT命令版本？

解答： 结论：有 AT 版本，但 AT 版本不叫 Air780EPM，而是另一套 AT 模组型号命名；做 AT 开发要按 AT 模组那条线的型号表来对，不能拿 LuatOS 的型号名去找。说明：合宙把「LuatOS 模组」和「AT 模组」分成两条产品线，同一颗芯片平台在两条线上的型号名不同，AT 线的资料（指令手册、AT 固件、认证固件）集中放在 AT 模组目录下。直接把 LuatOS 固件当 AT 固件用是不行的——两者的固件与交互方式完全不同。处理步骤：① 在 AT 模组目录里核对与 Air780EPM 同平台的 AT 型号；② 下载对应型号的 AT 固件与指令手册；③ 认证项目注意 AT 线还有按平台分组的专用认证固件；④ 最终型号以商务与 FAE 的口径为准。参考文档：https://docs.openluat.com/atmozu/product/shouce/、https://docs.openluat.com/atmozu/product/firmware/

14. Air8783和Air8783H有什么区别？

解答： 结论：Air8783 是 USB 上网卡（板载 Air780ER2，走 RNDIS 上网加短信转发），Air8783H 是 SIP-CC 纯 PCM 语音桥接专用硬件，两者是两条完全独立的产品，不是同一块板的两个版本。说明：8783H 干的是「SIP 网络通话 ↔ 蜂窝语音通话」双向桥接，两侧语音在模组内部通过 PCM 数据流传递，不接音频 Codec、也不接麦克风喇叭，通话双方分别是 SIP 客户端和手机。它需要支持语音业务的 SIM 卡，也需要固件提供 cc / voip 的桥接接口；8783 只做上网与短信，没有语音通路。处理步骤：① 上网 / 短信转发选 8783；② 要做 SIP 与手机号互通选 8783H；③ 8783H 用官方 sip_cc_bridge_pcm demo 整体替换脚本再改参数；④ 注意两者固件不可互刷。参考文档：https://docs.openluat.com/air8783/product/、https://docs.openluat.com/air8783h/

15. Air8783H的固件在Luatools里找不到怎么办？

解答： 结论：8783H 的固件不在 Luatools 的通用固件列表里，属于专用固件，需要按官方渠道获取；不要拿 8784 的固件去刷 8783H，两者硬件不同。说明：8783H 依赖固件提供 cc.AUDIO_MODE_BRIDGE_PCM、cc.bridgePcmStats()、voip.AUDIO_MODE_BRIDGE、voip.pcmIn / pcmOut 这一组桥接接口，光有 Lua 脚本补不齐——固件里没有这套能力，脚本调用会直接失败。8784 是 Air780EHM 加 Air1103 的组合，有 Codec 与音频通路，与 8783H 的纯 PCM 桥接不是一套东西。处理步骤：① 先看文档站 8783H 页面的 demo 与依赖说明；② 按 demo 整体替换脚本，不要只改某一处；③ 固件向 FAE 索取最新版本并记录版本号；④ 确认 SIM 卡支持语音业务后再测通话。参考文档：https://docs.openluat.com/air8783h/

16. Air8202成品设备后台如何进入？小程序可以进入吗？

解答： 结论：Air8202 成品设备的后台用微信小程序：搜「合宙IOT」，在「自建应用」里进入；Web 后台也由同一套物联网平台提供，设备完成绑定后就能在后台看到列表与数据。说明：成品设备（8201 工牌、8202 等）交付的是整套方案：硬件 + 固件 + 运维后台 + 小程序，所以后台入口不在 docs 文档站上，而在物联网平台上。设备要先按 SN / IMEI 绑定，后台才会有数据；没绑定的话登录进去也是空的。处理步骤：① 微信小程序搜「合宙IOT」；② 进「自建应用」；③ 按设备 SN / IMEI 完成绑定；④ 找不到入口或没有权限，找 FAE 要对应批次的账号开通方式。参考文档：https://docs.openluat.com/air8201/

17. Air8782P能否用USB通讯、通过USB发AT指令？

解答： 尚未解答

18. 流量卡到期如何续费？是否有API接口可查询/自动续费？

解答： 结论：流量卡有开放 API，采购后会提供后台账号与接口文档；续费既可以在平台自助操作，也可以找销售代办，到期前平台会发短信提醒。说明：API 一般覆盖卡状态、用量查询、续费下单等能力，具体接口清单与鉴权方式以开通时给的文档为准，不同批次（运营商、套餐类型）能力可能有差异。做产品时建议不要只依赖短信提醒，自己做一个「到期前 N 天查状态 → 触发续费 → 失败告警」的闭环更可靠。处理步骤：① 向销售索取后台账号与 API 文档；② 用测试卡先跑通查询接口；③ 实现到期提醒与自动续费任务；④ 加失败告警和人工兜底，避免批量停机。参考文档：https://iot.openluat.com/

19. 淘宝买的开发板赠送的流量卡有多少流量？

解答： 结论：淘宝开发板赠送的流量卡一般是 30M/月、有效期一年，属于试用性质，够跑通联网与少量数据上报，不适合做长期业务验证。说明：30M/月对于「定时上报几十字节」的场景够用，但 FOTA 升级、图片或音频上传很快就会超，超了通常限速或停机。调试期间被停卡，很容易误判成模组或代码问题，所以做产品验证时建议尽早换成正式套餐。处理步骤：① 先用赠送卡验证注网、APN 与协议；② 统计单次业务的实际流量（含心跳与重连）；③ 按真实用量选套餐，留 2~3 倍余量；④ 量产统一走商务渠道的卡，便于集中管理。参考文档：无（属商务/工艺事项，请通过购买渠道或对接 FAE 确认）。

20. Air8780G2通过4G传输GPS到服务器，需要接几个天线？塑料外壳能否把网络天线放盒内？

解答： 结论：需要两根天线——4G 一根、GNSS 一根，两者频段与极化完全不同，不能共用；塑料外壳可以把天线放进盒内，但必须用装壳后的实测数据确认，金属外壳不行。说明：GNSS 是 1.5GHz 附近的圆极化接收，4G 是 700M~2.6G 的线性收发，天线形态与匹配网络都不一样。塑料壳（ABS / PC）对射频基本透明，可以把 FPC 或陶瓷天线贴在壳内壁，但要注意与主板地平面、电池、屏蔽罩的距离，还要考虑手握与人体遮挡。8780 / 8700 的硬件文档里有天线布置与净空建议。处理步骤：① 按硬件文档预留两个天线位与净空，GNSS 天线尽量远离 4G 天线；② 先在外置天线状态下调通链路；③ 换壳内天线后实测 RSRP / SINR 与定位 C/N0 对比；④ 量产让天线厂做匹配与 TRP / TIS 测试。参考文档：https://docs.openluat.com/air8780/product/

21. Air780EPM上电后不运行脚本、输出AT指令、无法重新烧录脚本，是什么问题？

解答： 结论：这不是坏了，是出厂时烧的厂测 AT 固件还在跑——它上电不执行用户脚本、串口输出 AT 交互，所以看起来「不运行脚本、也烧不进脚本」。用 Luatools 重新下载 LuatOS 固件（含 core）即可。说明：产线在出厂前会烧厂测固件做硬件自检，用户拿到后需要自己刷 LuatOS 内核加脚本。下载时务必勾选「包含 core」，否则只更新脚本区、内核还是 AT 固件；如果工具连不上，就手动让模组进 boot 模式再下载。处理步骤：① 把 Luatools 升级到最新版；② 选对应型号的 .soc，勾选含 core 下载；③ 连不上就按住 BOOT 再上电（或复位）进下载模式；④ 刷完仍输出 AT，检查是不是又选了 AT 固件而不是 LuatOS 固件。参考文档：https://docs.openluat.com/common/howtodown/、https://docs.openluat.com/common/Luatools/

22. Luatools下载失败提示“内部错误，详情请查看日志”但没有日志，怎么办？

解答： 结论：「内部错误，详情请查看日志」但日志目录里什么都没有，多半是工具写日志的权限被拦或环境异常导致的；重启电脑后恢复是最常见的解法。说明：Luatools 的日志依赖本地写权限，被杀毒软件拦截、日志目录被占用、或工具版本过旧时，就会出现「提示看日志却没有日志」。这类提示本身信息量为零，所以要靠排除法：换工具版本、换 USB 口、换电脑，逐步缩小到具体环节。处理步骤：① 重启电脑与 Luatools；② 换 USB 口与数据线，直连不用 Hub；③ 关闭杀软或把 Luatools 目录加白；④ 升级到最新版（V3）；⑤ 仍失败换一台电脑交叉验证，判断是环境还是模组问题。参考文档：https://docs.openluat.com/common/Luatools/

23. Luatools识别不到设备/下载失败是否与杀毒软件有关？

解答： 结论：有关系。已有客户卸载 360 并重启后恢复正常，杀毒软件拦截 USB 驱动安装、抢占串口是这类问题的常见原因。说明：Luatools 需要安装 USB 驱动并独占串口设备，安全软件的「驱动防护」「U 盘管控」「端口保护」会拦掉驱动加载或反复占用端口，表现就是识别不到设备、下载到一半失败、或日志里出现打开串口失败。处理步骤：① 完全退出或卸载安全软件后重启；② 或把 Luatools 与驱动目录加入白名单；③ 在设备管理器确认端口没有黄色感叹号、没有被别的程序占用；④ 仍不行换一台电脑验证，确认是环境问题还是模组问题。参考文档：https://docs.openluat.com/common/usb_drv/

24. Air780EHM执行libnet.tx返回false，但服务器能收到数据，为什么？

解答： 尚未解答

25. FOTA的域名是多少？物联网卡需要设定向白名单。

解答： 结论：FOTA 域名是 iot.openluat.com。物联网卡如果开了定向白名单，必须把这个域名连同升级包实际下载的 CDN 域名一起加白，只加主域名会出现「能查到版本、下载失败」。说明：合宙的 libfota / libfota2 默认从 iot.openluat.com 取版本信息，升级包本体通常放在 CDN 上，所以白名单要按抓包结果补全。另外 libfota3 只对接合宙 IoT 平台，如果是自建升级服务器，要用 libfota2 并自己配 URL。处理步骤：① 把 iot.openluat.com 加入定向白名单；② 抓包确认包体下载域名并一并加白；③ 用测试卡跑一次完整升级（查版本 → 下载 → 校验 → 重启）；④ 自建服务器方案改用 libfota2。参考文档：https://iot.openluat.com/

26. Air780EPM用物联网卡注册被拒绝、提示检查SIM是否欠费或机卡分离，但运营商后台显示正常，如何排查？

解答： 结论：这类「注册被拒、提示检查欠费或机卡分离，但运营商后台显示正常」的情况，多半不是欠费，而是三种原因之一：机卡绑定策略不允许当前 IMEI 接入、频段或制式不匹配、或固件版本旧导致注网异常。说明：物联网卡常开「机卡绑定」，换设备就会被拒；Air780EPM 是 Cat.1 且不支持 2G，如果当地只有 2G / 3G 覆盖就注不上；而运营商后台的「正常」只代表账户状态，不代表允许这台设备接入。此外弱覆盖下反复重注册也会被网络侧拒绝。处理步骤：① 换一张普通手机卡做对比，区分是卡的问题还是环境问题；② 用 cellular-Z 看当前驻留频段与信号强度；③ 找运营商确认是否开了机卡绑定，需要解绑或改绑 IMEI；④ 升级到最新固件再试；⑤ 换位置排除弱覆盖与基站拥塞。参考文档：https://docs.openluat.com/air780epm/product/

27. Air780EPM的ICCID读出来是21位，正常吗？

解答： 结论：不正常。ICCID 的标准长度是 19 位或 20 位，读出 21 位通常是取值或解析的问题（多读了一位、末尾混入了别的字符），也可能卡本身是非标卡。说明：ICCID 是 20 位十进制数字（部分运营商 19 位），模组侧可以通过 AT+ICCID 或 sim.getIccid() 读取。出现 21 位要先怀疑程序里读的是拼接后的字符串，或者把填充字符、校验位一起读进来了，而不是卡真的多了一位。处理步骤：① 用 AT+ICCID 的原始返回对比 Lua 读到的值；② 打印字符串长度与首尾字符，检查有没有空白或不可见字符；③ 换一张标准卡对比；④ 仍异常把原始返回与卡面号一起发给 FAE 确认。参考文档：https://docs.openluat.com/air780epm/product/

28. Air780EPM通过4G连接TCP，libnet.wait返回false并提示connection exception，如何查看更详细的断连原因？

解答： 结论：可以看 Luatools 日志目录下 4gdiag 里的 bin 日志，用配套工具解析，能看到 PDP 激活、RRC 释放、网络侧断连原因这类底层信息，比 socket 层的 connection exception 有用得多。说明：libnet.wait 返回 false 只说明连接没建立或已断开，具体是 DNS 失败、PDP 掉了、服务器 RST 还是网络侧主动释放，都要看底层信令。4gdiag 日志就是模组侧的诊断记录，配合解析工具能看到原因码与时间点，便于和服务器日志对齐。处理步骤：① 复现问题时保持 Luatools 连接并开启日志；② 到 log/4gdiag 目录取 bin 文件；③ 用对应工具解析，重点看断连原因码与 PDP 状态；④ 把时间点与服务器日志、mobile.status() / csq() 三方对齐。参考文档：https://docs.openluat.com/air780epm/luatos/app/base/errdump/errdump_780epm/

29. Air780EPM/780E系列选型表在哪里？后缀太多如何选择？

解答： 结论：选型表在 https://docs.openluat.com/common/product/ ，也可以直接用 ai.luatos.com 按功能反查。后缀（EHM / EHV / EGG / EPM / EX2 等）代表频段、语音、GNSS、封装等差异，先按「是否要语音、是否要定位、是否出海」三项筛，再看引脚与封装。说明：同一颗 EC7xx 平台会派生很多型号，核心库大多通用，差异集中在射频段、有没有内置 Codec、带不带 GNSS、Flash / RAM 容量和封装。选型最容易踩的坑是「某个频段刚好重合就以为能用」——实际要看目标运营商的所有频段是否都被覆盖，缺一个就可能在某些区域无法驻网。处理步骤：① 先列出语音、定位、出海、带屏四项需求；② 在选型表里按列筛选；③ 核对频段表与封装尺寸；④ 用 ai.luatos.com 或 FAE 复核，再下单打样。参考文档：https://docs.openluat.com/common/product/

30. Air780EHU烧录不进程序（部分模块），贴片X-Ray正常，故障率约1%，如何处理？

解答： 结论：先按「重焊能好就是贴片问题」的思路定位：重焊后可以正常烧录，基本可判定是大板贴片（焊盘设计、锡量、共面度、受潮）问题，而不是模组本身坏。说明：1% 的故障率符合工艺波动特征，常见是局部虚焊、连锡或 PCB 变形。X-Ray 能看出内部空洞与偏移，但看不出焊点润湿不良、引脚氧化、回流不足这些；Air780EHU 是 LCC 邮票孔封装，对焊盘平整度和锡膏量比想象中敏感。处理步骤：① 取几颗故障件重焊验证，确认是否可复现修复；② 检查焊盘设计与钢网开孔是否匹配模组推荐值；③ 确认模组与 PCB 的烘烤、防潮、车间湿度；④ 做测温板调回流曲线，首件加 X-Ray 与推力抽检；⑤ 仍有异常把故障件与批次号交 FAE 分析。参考文档：https://docs.openluat.com/common/howtodown/

31. Air8783H待机几分钟重启一次、电话打不通，怎么办？

解答： 结论：先用 V2054 的 13 号固件测试，并且 SIP-CC 场景必须插一张支持语音业务的 SIM 卡；脚本按官方 sip_cc_bridge_pcm demo 整体替换并改参数，不要只改局部。说明：8783H 的桥接依赖固件里的 cc / voip 桥接接口与内部 PCM 通路，旧固件或「新固件配旧脚本」的组合会出现待机几分钟重启、呼叫建立不起来。另外没有 SIM 卡，或卡没开通语音业务时，蜂窝侧根本建立不了通话，表现同样是打不通。处理步骤：① 刷 V2054 的 13 号固件并确认版本；② 插语音卡，先用手机验证这张卡能正常拨打接听；③ 用官方 demo 整体替换脚本，再改 SIP 服务器、账号与目标号码；④ 用 cc.bridgePcmStats() 观察 PCM 通路是否真的在跑。参考文档：https://docs.openluat.com/air8783h/、https://docs.openluat.com/air780epm/luatos/firmware/780ehm_version/

32. Air780EHV用电信卡做TTS时喇叭有一阵一阵通讯干扰声，移动卡较少，是否与基站频段有关？

解答： 尚未解答

33. Air8101+AirCamera_1034是否必须加供电控制？官方暂无demo能否补充？

解答： 尚未解答

34. Air8000模组进低功耗模式后，能否正常读取GPIO电平或使用ADC采样？

解答： 结论：进低功耗后普通 GPIO 基本不可用，能保留的是 AGPIO（always-on GPIO）；要读电平或做唤醒，就把信号接到 AGPIO 并配置成输入。ADC 不建议在低功耗下依赖，采样前先唤醒。说明：EC7xx 的低功耗是把大部分电源域关掉，只有 always-on 域保持供电，所以「休眠中还想知道某个信号是高还是低」只能走 AGPIO；普通 GPIO 断电后读到的值没有意义。ADC 属模拟外设，休眠时通常已关闭，要采样必须先唤醒。处理步骤：① 查所选型号的 AGPIO 引脚表，确认可用数量；② 把需要休眠检测的信号改接 AGPIO 输入；③ 需要 ADC 就定时唤醒采样后再睡；④ 用 pm.power / pm.dtimerStart 做周期唤醒，并实测休眠电流确认没有额外漏电。参考文档：https://docs.openluat.com/air780epm/product/

35. Air8000W的VEXT能否给TF卡供电？VEXT对地短路是什么原因？

解答： 结论：不建议。VEXT 的供电能力有限，一般只够带小电流外设，TF 卡在写入瞬间有较大的浪涌电流，容易出现掉卡、写坏甚至把 VEXT 拉到保护；TF 卡应单独用 LDO（或负载开关）供电，并由 GPIO 控制上下电。说明：VEXT 多由模组内部 LDO 派生，输出能力只有几十毫安量级。所谓「VEXT 对地短路」，很多时候其实是过流保护动作后的低阻表现——先断开负载量一下静态对地阻抗，就能区分是板子真短路还是负载过流。处理步骤：① 断开 TF 卡测 VEXT 对地阻抗，判断是否真短路；② TF 卡改独立 LDO（如 3.3V/300mA）加 MOS 控制；③ 卡座附近加 100nF + 10μF 去耦与 TVS；④ 软件上先供电再初始化，卸载前先 unmount。参考文档：https://docs.openluat.com/air8000/product/

36. Air8000W以太网冷启动后约5秒内TX帧不出物理口，热插拔网线正常，如何解决？

解答： 结论：这是 Air8000W 上 CH390 以太网在冷启动时的「初始化后 TX 使能 / PHY 自协商完成」时序问题，已反馈研发关注；临时规避可以周期发 ARP，或主动触发一次链路重协商。说明：冷启动时 CH390 初始化完成、MAC 侧 TX 已使能，但 PHY 自协商可能还没结束或 TX 时钟未稳定，前几秒发出的帧出不了物理口；热插拔网线会重新触发协商，所以看起来「插一下就好」。典型现象是上电 ping 不通、插拔网线立刻恢复。处理步骤：① 上电后延时 3~5 秒再启用业务；② 或定时发 ARP / 广播保活触发链路；③ 软件里读 link 状态，确认 up 之后再发业务数据；④ 关注后续固件版本是否修复。参考文档：https://docs.openluat.com/air8000/product/

37. Air8000W V30版本WiFi固件uart11/uart12修改不了波特率，怎么办？

解答： 结论：uart11 / uart12 改波特率前必须先 close 再重新 open 并带新参数，运行中直接改参数不会生效；该问题研发已在复测。说明：这两个口在 WiFi 固件里与 WiFi 侧通信共用，参数被上层缓存，不 close 就改会被忽略，甚至把通道状态搞乱。正确姿势是关掉、按新波特率重开、再开始收发；对端设备也要同步改成同一波特率，否则收到的全是乱码。处理步骤：① 先 uart.close(11) 或 uart.close(12)；② 用新波特率重新 open 并配置数据位、校验、停止位；③ 确认对端设备已同步；④ 仍失败记录固件版本与复现步骤反馈复测。参考文档：https://docs.openluat.com/air8000/product/

38. Air780EHM工作温度范围是多少？

解答： 结论：文档站的型号页没有直接列工作温度范围，准确值请用 docs.openluat.com 右下角的 AI 查询，或查该型号硬件手册 / 规格书；不要按「工业级 -40~85℃」想当然。说明：模组的工作温度受芯片结温、射频功率、供电与板级散热共同影响，手册给的通常是环境温度范围并附带降额说明。实际能不能长期跑在高温环境，还要看你的外壳、散热与发射占空比，光看一个数字没有意义。处理步骤：① 用站点 AI 或硬件手册确认该型号的额定范围；② 实测板级温升（屏蔽罩、PA、电源部分）；③ 高温场景做降额与散热设计；④ 需要宽温长期运行就选工业级型号。参考文档：https://docs.openluat.com/air780epm/product/、https://docs.openluat.com/air780epm/luatos/firmware/780ehm_version/

39. Air724UG-NFC在沙特能否正常使用（接打电话、收发短信）？

解答： 结论：不行。沙特主要使用 B1 / B3 / B8 / B20 / B28 这类频段，Air724UG-NFC 的频段覆盖不全，接打电话与收发短信都可能起不来；出海项目应选 Air780EHU（亚欧版）或 Air8000U。说明：频段是硬件定死的，刷固件改不了。而且海外 VoLTE 还要运营商侧配合，合宙只做 CE / FCC 认证，没有当地运营商认证，也不组织实地场测——所以「频段对上了」也只是能注网，能不能打电话必须拿当地卡实测。处理步骤：① 查目标运营商的频段清单；② 与 Air780EHU 的频段表逐项比对；③ 用当地卡实测注册、主被叫、短信与 APN；④ 产品里保留 APN 手填入口。参考文档：https://docs.openluat.com/air780ehnehu/product/air780ehufreq/

40. Air724UG-NFC能否借助云服务器实现网页采集音频并接听电话？

解答： 尚未解答

41. Air1603是否支持驱动HUB75接口LED点阵屏？

解答： 结论：Air1603 目前不支持直接驱动 HUB75 接口的 LED 点阵屏，官方没有现成的 HUB75 驱动；建议外挂一颗专门的 LED 屏控制芯片（或外部 MCU），由 1603 通过 SPI / UART 下发画面数据。说明：HUB75 是「并行数据 + 行选 + 多路锁存与时钟」的接口，一块屏动辄要十几个高速 IO 和很高的刷新带宽，还要做扫描与伽马校正；1603 的 RGB 接口是给 LCD 时序用的，两者电气与时序都不兼容，不能靠改软件凑。后续是否支持要看产品规划。处理步骤：① 选带 SPI / UART 接口的 LED 屏控制卡；② 1603 侧按图片或文字生成帧数据下发；③ 大屏注意刷新率与总线带宽；④ 有量可以找合宙评估定制方案。参考文档：https://docs.openluat.com/air1603/

42. Air1603最大支持多大分辨率的屏幕？

解答： 结论：Air1603 最大支持 1280×800 的 RGB565 屏，典型规格是 1024×600（7 / 9 / 10.1 寸）。说明：1603 的显示接口是 RGB565（65K 色），不支持 24 位全彩；RGB888 的屏可以按兼容模式接，但只接高 16 位（R[7:3] / G[7:2] / B[7:3]），色彩会明显降一档。分辨率越高像素时钟越高，长排线要评估信号完整性，必要时降频。处理步骤：① 按 1280×800 上限选屏，不要超过；② 确认屏的 driver IC 在 lcd 库支持列表；③ 高分辨率下缩短 FPC、加地线屏蔽；④ 实测帧率与撕裂情况。参考文档：https://docs.openluat.com/air1603/

43. 购买的1280×800屏实际收到1024×600，如何解释？

解答： 结论：这是产品图标注错误——相关套件实际配的是 1024×600 的屏，官方已确认并修正了说明。1280×800 是 Air1603 的「最大支持分辨率」，不是这块屏的规格。说明：这里容易混淆两个概念：「模组能驱动到 1280×800」和「随货这块屏是 1024×600」。发货以实物屏的型号与规格书为准，产品图属于宣传物料笔误。类似情况在配件类商品上并不少见，收到货先看屏背面的型号丝印。处理步骤：① 以实物屏的型号与规格书为准；② 确实需要 1280×800 就单独选屏，别指望套件；③ 与销售核对订单型号；④ 已发货的可协商换货或补差价。参考文档：https://docs.openluat.com/air1603/

44. Air8201G工牌100个价格多少？

解答： 结论：Air8201G 工牌单价 59 元是原答给的口径，但含税、含运、批量优惠都要和销售（原答指杨凤珍）确认，不能直接拿 59 元当正式报价。说明：工牌属于成品方案，交付物包含硬件、运维后台、小程序与 App，报价通常按数量分档，还涉及是否含流量卡、平台服务期多长。100 个属于小批量，单价往往高于大批量口径，做成本核算时要把这些一起算进去。处理步骤：① 明确数量、是否含流量卡与平台服务期；② 向销售索取正式报价单（含税、含运、交期）；③ 确认售后与备件政策；④ 先拿样机验证功能再定批。参考文档：https://docs.openluat.com/air8201/

45. Air8301是否支持摄像头？

解答： 结论：Air8301 不支持接摄像头。它是基于 Air8000W 的 4G 大屏工控板，接口是 4G / WiFi / 蓝牙 / 双以太网 / 双 RS485 / 双 RS232 / DI / DO 加 4.3 寸触摸屏，没有摄像头接口。说明：要带摄像头（UVC 人脸识别）应该选 Air8601 / Air8603 这类基于 Air1603 的方案，它们有 USB Host，也能配 AirCamera_1034 双目摄像头。8301 的定位是工控数据采集与本地显示，不是视觉方案。处理步骤：① 需要摄像头改选 8601 / 8603；② 只要画面显示可以用 8301 的屏加外部设备；③ 选型前逐项核对接口清单，别按「大屏板应该有 USB」想当然；④ 有特殊组合需求找 FAE 评估。参考文档：https://docs.openluat.com/air8301/product/、https://docs.openluat.com/air8601/product/

46. Air8603是否带CAN通讯接口？

解答： 结论：Air8603 没有 CAN 接口。它提供的是隔离与非隔离 RS485、RS232、UART、以太网 RJ45、USB（可接 UVC 摄像头）等，官方接口清单里没有 CAN。说明：需要 CAN 的场景应选带 CAN 控制器的型号，例如 Air1603（规格标注 CAN FD 2 路）、Air780EHM / EHV（can 库已给出 GPIO 映射），再外接 CAN 收发器（如 CA-IF1051S）。注意 CAN 必须有收发器与 120Ω 终端电阻，不是把两根线接到引脚就能上总线。处理步骤：① 先确认要经典 CAN 还是 CAN FD；② 选带 CAN 控制器的型号；③ 外接收发器并在一对末端各加 120Ω 终端；④ 用 can 库配置波特率与过滤器后联调。参考文档：https://docs.openluat.com/air8603/、https://docs.openluat.com/osapi/core/can/

47. Air1603没有自带CAN控制器，外挂复杂，能否用1603做主模块外挂780EGH等实现4G/CAN？

解答： 结论：可以组合，但先纠正一点——Air1603 的官方规格表里写的是「CAN FD 2 路」，也就是模组侧已有 CAN 控制器，外层只需加 CAN 收发器；不过 LuatOS 的 can 库目前只标注了 Air780 / Air8000 / Air8101 的 GPIO 映射，1603 上 CAN 是否已开放需要向 FAE 确认。说明：如果目的只是补 4G，用 1603 做主控加 Air780EGH（或 780ER2）联网是对的，两者走 UART / SPI 对接。如果目的是 CAN，更稳妥的做法是让 780EHM / EHV / EGH 侧做 CAN，1603 只当显示与业务主控。合宙也提供定制服务，可以把这套组合做成一块板。处理步骤：① 先明确要解决的到底是 4G 还是 CAN；② CAN 优先用 can 库已支持的型号实现；③ 1603 与 4G 模组走 UART，先定好帧格式与流控；④ 有量再谈定制整合。参考文档：https://docs.openluat.com/air1603/、https://docs.openluat.com/osapi/core/can/

48. Air780E系列是否支持RTMP视频推流？批量应用如何授权收费？

解答： 结论：有 RTMP 推流方案，但官方现成的 demo 在 Air8101 平台（视频能力更强）；Air780E 系列也能在 Lua 层实现 RTMP 协议，只是摄像头只有 30 万像素 MJPG，推不了高清。批量授权收费属商务事项，需与销售确认。说明：RTMP 本质是跑在 TCP 之上的协议封装，Lua 层完全能做；真正的瓶颈在视频源与上行带宽——780 系列的 USB 不支持 UVC，只能接并口 / DVP 摄像头，30 万像素 MJPG 压缩率低、码流反而不小。8101 带硬件视频能力，做 IPCAM 更合适。处理步骤：① 评估是否必须用 780 平台；② 参考 8101 的 RTMP demo 改造；③ 先算清上行带宽与流量成本；④ 授权与商务报价找销售确认后再放量。参考文档：https://docs.openluat.com/air8101/luatos/app/multimedia/rtmp/

49. Air780系列只支持30万像素摄像头且为MJPG，能否当USB摄像头/UVC使用？

解答： 结论：不能。780 系列的 USB 只有从设备（device）能力，跑不了 UVC Host 协议，所以「接 USB 摄像头」和「让模块变成 USB 摄像头」这两条路都走不通；要接 USB 摄像头请选 Air1601 / 1603 或 Air8100 系列（有 USB 2.0 Host）。说明：UVC 需要主机侧发起枚举与等时传输，780 的 USB 控制器不支持 Host 模式。它能接的是并口 / DVP 摄像头（30 万像素 MJPG），采集后自己编码上传，没法变成标准 USB 摄像头给电脑用。处理步骤：① 要接 UVC 摄像头就换 1603 / 8100；② 要「模块当 USB 摄像头」目前没有型号支持；③ 780 只做采集与上传；④ 选型时把「USB 是否支持 Host」列进核对表。参考文档：https://docs.openluat.com/air1603/、https://docs.openluat.com/air780epm/product/

50. Air780E模块做相机应用能否使用RTMP推流？

解答： 结论：可以推，但不划算。780 系列的摄像头是 30 万像素 MJPG，压缩率低、码流反而偏大，画质与带宽都不理想；做 IPCAM 建议直接用 Air8101。说明：MJPG 是逐帧 JPEG，30 万像素一帧几十 KB，按 10~15fps 就是几 Mbps，而 Cat.1 的上行带宽本来就紧张，还要和业务数据抢。RTMP 协议本身在 Lua 层能实现，瓶颈始终是视频源与上行链路。处理步骤：① 先按目标帧率与分辨率算所需带宽；② 超过 Cat.1 上行就降帧、降分辨率或改成定时抓拍；③ 视频类项目优先选 8101；④ 灰度阶段做长时间推流稳定性验证。参考文档：https://docs.openluat.com/air8101/luatos/app/multimedia/rtmp/

51. Air780低功耗场景下定时采集温湿度，每次采集电流几十毫安，能否关闭4G模块、需要时再打开？

解答： 结论：可以，但要分清「软件降耗」和「硬件断电」：软件侧能做的是飞行模式、断开 PDP、请求 PSM+ 睡眠；真正把 4G 部分断电，需要板上有负载开关或 MOS 控制 VBAT。说明：飞行模式只关射频，基带仍在运行，电流从几十毫安降到毫安级；PSM+ 能到几十微安，代价是不可联网，要发数据得先唤醒并重新注册。定时采集场景更实用的是「采集时醒 → 联网上报 → 进 PSM+ 睡」这个循环，而不是长时间断电。处理步骤：① 先测出单次采集与上报的耗时；② 用 mobile.flymode 或 pm 相关接口控制射频与睡眠；③ 硬件预留 4G 供电的 MOS 或负载开关；④ 实测各状态电流与唤醒时延，算清平均功耗。参考文档：https://docs.openluat.com/air780epm/product/

52. Air780E大概价格是多少？CAT.1传视频能到多少帧？

解答： 尚未解答

53. Air105/1号固件休眠无法真正休眠，是否固件问题？

解答： 尚未解答

54. Air780EPM拍照出来是JPEG，显示到屏幕是否需要转RGB？

解答： 结论：需要。摄像头输出的是 JPEG 码流，lcd 只能画 RGB 数据，所以必须先解码成 RGB565 才能显示；Air1603 带 JPG 硬解码，可以直接解，比软解快得多。说明：JPEG 是压缩格式，屏的 GRAM 里存的是每个像素的 RGB 值，中间必须有解码这一环。软解吃 CPU、帧率上不去；硬解受分辨率与内存带宽限制，通常要配合降采样或分区刷新。处理步骤：① 用 1603 的 JPG 硬解接口；② 解码结果按 RGB565 送 lcd；③ 分辨率大就降采样或分区刷；④ 复用解码缓冲，别每帧 malloc / free，避免内存碎片。参考文档：https://docs.openluat.com/air1603/

55. 合宙AI回答与官方PDF参考设计冲突（SIM1 CLK上拉10k到SIM_VDD），该听谁的？

解答： 结论：以官方 PDF 参考设计为准。AI 回答是生成式的，可能把别的型号或别家的做法混进来；SIM1 CLK 是否需要 10k 上拉到 SIM_VDD，按对应型号 PDF 原理图执行。说明：SIM 接口的 CLK 上拉在不同平台要求不同——有的内部已带上拉、有的要求外部加，加错会增大功耗或影响时序余量。遇到 AI 与 PDF 冲突，正确做法是记下冲突点反馈给合宙修正，而不是按 AI 改板。处理步骤：① 以该型号的 PDF 参考设计为唯一依据；② 逐脚核对 SIM_VDD / CLK / DATA / RST；③ 有疑问把 PDF 页码给 FAE 确认；④ 把 AI 的错误答复印出来反馈给官方。参考文档：https://docs.openluat.com/air780epm/product/

56. Air780EPM模块VIRT/供电设计问题，VEXT给TF卡供电导致短路如何处理？

解答： 结论：VEXT 带不动 TF 卡，不要直接供；TF 卡用独立 LDO 供电，并加 MOS 或负载开关做上下电控制，避免热插拔与休眠时的漏电。说明：TF 卡写入瞬间电流可达上百毫安，VEXT 输出能力有限，会被拉到保护点，表现为卡识别不到、写入失败甚至模组复位。「VEXT 对地短路」很多时候是过流保护动作后的低阻表现，先断开负载测静态阻抗再下结论。处理步骤：① 断开 TF 卡测 VEXT 对地阻抗；② 加独立 LDO（3.3V/300mA 以上）加 MOS 控制；③ 卡座加去耦与 TVS；④ 软件按时序先供电再初始化，卸载前先 unmount。参考文档：https://docs.openluat.com/air8000/product/

57. Air8000A/U/N/W/AB参考设计中SIM1 CLK是否需要10k上拉到SIM_VDD？

解答： 结论：按官方 PDF 参考设计执行，不要按「别人说要不要上拉」来改。SIM1 CLK 的上拉在对应型号的参考设计里是明确画出来的，照图做即可；8000A / U / N / W / AB 之间也可能不同，别互相套用。说明：SIM 时钟是 3.25MHz 左右的方波，上拉主要用来确定空闲电平、抑制浮空干扰；有的平台内部已有上拉，外部再加反而增加功耗。以各自型号的 PDF 为准最稳妥，也最经得起量产验证。处理步骤：① 找到对应型号的 PDF 参考设计；② 核对 SIM1 CLK 网络上的元件与阻值；③ 有疑问把页码给 FAE 确认；④ 打样后实测 SIM 识别率与休眠电流。参考文档：https://docs.openluat.com/air8000/product/

58. Air780EHM等模块USB驱动在哪里下载？

解答： 结论：USB 驱动在 https://docs.openluat.com/common/usb_drv/ ，页面里「MCU / 模组」那一节就是各系列模组的驱动下载；装完在设备管理器能看到对应的串口与网卡设备。说明：EC7xx / EC618 系列用的是同一套 USB 驱动包（含 CDC 串口与 RNDIS 网卡），Win10 / 11 一般能自动识别，认不出时需要手动指定 INF。装不上多半是数字签名校验或安全软件拦截。处理步骤：① 下载对应驱动包并解压；② 设备管理器里「更新驱动」指向解压目录；③ 必要时临时关闭驱动签名强制；④ 换线换口重试，确认不是线材问题。参考文档：https://docs.openluat.com/common/usb_drv/

59. Air820UG连接电脑需要装什么驱动？用拓展坞是否会导致Luatools识别不到？

解答： 结论：需要安装 USB 驱动（CDC 串口加 RNDIS 网卡），装好 Luatools 才能识别设备；拓展坞本身不是问题，但不带独立供电的拓展坞很容易导致识别不到或下载失败。说明：模组在下载与联网瞬间电流较大，拓展坞从主机取电能力有限，电压跌落会让 USB 掉线；劣质 Hub 的 USB 信号完整性也差，会出现枚举失败、时好时坏。这类问题的特征是「直连正常、插 Hub 就不行」。处理步骤：① 先装官方驱动；② 优先直连主板 USB 口；③ 必须用 Hub 就选带外部供电的；④ 换短一点的优质数据线再测。参考文档：https://docs.openluat.com/common/usb_drv/

60. Air780EPM用USB连接时报“下载失败/内部错误”，怎么办？

解答： 结论：先按环境问题排查：重启电脑与 Luatools、换 USB 口与数据线、关闭杀毒软件拦截、确认模组已正常开机（而不是还停在厂测 AT 固件或死机状态）。说明：「下载失败 / 内部错误」多数不是模组坏，而是 USB 枚举异常、驱动被拦或模组没进下载模式。厂测固件状态下工具可能连得上但不能正常下载用户脚本，这一点很容易误判成硬件故障。处理步骤：① 重启电脑与工具；② 换线换口并直连；③ 手动进 boot（按住 BOOT 再上电）后重试；④ 关杀软或加白；⑤ 换一台电脑交叉验证。参考文档：https://docs.openluat.com/common/howtodown/、https://docs.openluat.com/common/Luatools/

61. Luatools历史版本在哪里下载？

解答： 结论：Luatools 历史版本在 https://cdn18.luatos.com/files/exe/ ，按文件名里的版本号挑；不要从第三方网盘下来历不明的包。说明：新版本有时会改下载流程或引入回归问题，回退到已知可用版本是最快的止损手段。回退后建议记录版本号，反馈问题时一并给出，方便官方复现。处理步骤：① 打开历史版本目录；② 按版本号下载对应的 exe；③ 安装前先完全退出旧版；④ 记录版本号与回退原因。参考文档：https://cdn18.luatos.com/files/exe/

62. 脚本加密和固件签名功能在哪里？能否一起使用？

解答： 结论：脚本加密是 LuatOS 自带能力（下载时可以选择加密，脚本在模组内以密文形式存放）；「固件签名」目前官方还没有做，不要指望用它来防抄板。两者是不同层面的东西，可以分别使用。说明：脚本加密解决的是「别人读出 flash 也拿不到明文 Lua」；固件签名解决的是「防止刷入非官方固件」，这需要 bootloader 配合验签，目前没有开放。真正的防护还要结合芯片读保护（如果平台支持）与业务侧授权策略。处理步骤：① 下载时勾选加密选项；② 加密后完整回归功能，确认库加载正常；③ 不要依赖签名做安全边界；④ 需要更强的保护，找 FAE 谈定制方案。参考文档：https://docs.openluat.com/common/Luatools/

63. Luatools 2.2.30的脚本加密/固件签名功能能用吗？

解答： 结论：2.2.30 的脚本加密可以用，但「固件签名」这个功能实际不可用（官方还没做）；建议直接升级到 Luatools V3 最新版，功能与兼容性都更好。说明：旧版本工具在新固件、新系统上容易出现下载失败与功能缺失，V3 是当前主推版本。加密后的脚本仍可被工具正常下载与运行，注意保留好源脚本，别只留加密产物。处理步骤：① 升级到 V3；② 用加密选项重新下载一次并验证运行；③ 记录工具版本与固件版本；④ 遇到异常先换版本对比，快速定位是不是工具问题。参考文档：https://docs.openluat.com/common/Luatools/、https://cdn18.luatos.com/files/exe/

64. Air795UG在南非能否正常使用？是否会锁频段？

解答： 结论：Air795UG 支持哪些频段就支持哪些，官方没有做频段锁定；但「理论支持」不等于「当地可用」，南非各运营商的频段组合要逐个核对，合宙也没有做实地场测。说明：海外使用要看三件事：频段覆盖、运营商的 VoLTE 与 APN 策略、以及认证（CE / FCC 之外没有当地认证）。795UG 属较老平台，文档与固件支持都在收缩，新项目建议直接用 Air780EHU 或 Air8000U 这类在售型号。处理步骤：① 查目标运营商的频段清单；② 与 795UG 的频段表逐项比对；③ 用当地卡实测注册与数据；④ 新项目直接换在售型号，省掉后续维护风险。参考文档：https://docs.openluat.com/common/product/

65. Air780EHU使用DTU固件，如何开启B41频段？

解答： 结论：DTU 固件默认不锁频段，B41 只要模组硬件支持、当地有覆盖就会自动驻留，一般不需要手动开；确实要锁频需要定制固件或用 AT 侧锁频指令。说明：锁频是调试手段，量产不建议锁死——一旦当地基站调整或需要漫游，锁频会导致完全无法驻网。原答说的「按运营商 APN 配置」也对：先把 APN 配对，再谈频段问题，否则看到的现象会混在一起。处理步骤：① 先确认 APN 配置正确；② 用 cellular-Z 看实际驻留的频段与小区；③ 确认模组硬件支持该频段；④ 必须锁频时用 AT 指令，并预留恢复默认的退路。参考文档：https://docs.openluat.com/air780ehnehu/product/air780ehufreq/

66. Air780EHU等模组是否支持远程关机和充电自动开机？

解答： 尚未解答

67. Air8101的OTA升级包提示找不到main.lua，怎么办？

解答： 结论：OTA 升级包提示找不到 main.lua，通常是打包时脚本目录结构不对，或者用了旧版工具：用最新版 Luatools 重新生成升级包，确保包内根目录就有 main.lua。说明：OTA 包本质是一个压缩包，模组下载后解压并按固定路径找脚本；如果打包时多套了一层目录、只打进去部分文件，或者改了入口文件名，就会报找不到。工具版本不一致也可能生成结构不同的包。处理步骤：① 用 V3 最新版重新生成升级包；② 手动解压包，确认根目录有 main.lua 与所需库；③ 确认脚本目录没有多余层级；④ 重新升级并看串口日志确认执行到哪一步。参考文档：https://docs.openluat.com/common/Luatools/

68. Air780EX2 L2TP VPN只有鉴权阶段加密、其余不加密，是否正常？拨VPN后能否同时走公网？

解答： 结论：这是 L2TP 本身的协议特性，不是故障：L2TP 只做隧道封装，加密要靠 IPsec 叠加，所以很多部署就是「隧道建立阶段有认证与加密、承载数据不加密」；VPN 与普通公网数据不冲突，可以在 Lua 里指定走哪一路。说明：要全链路加密必须用 L2TP over IPsec，或改用 OpenVPN / WireGuard 这类自带加密的方案。走哪条路由可以由 socket 绑定网卡或 adapter 决定，业务侧按目标地址分流即可。处理步骤：① 与服务器侧确认是否启用了 IPsec；② 需要加密就上 IPsec；③ 业务分流用 socket 绑定或 adapter 指定链路；④ 抓包验证实际走的是哪条路。参考文档：https://docs.openluat.com/air780ex2/luatos/firmware/version/

69. Air780EX2做项目推荐哪款开发板？需要两个串口、成本低。

解答： 结论：Air780EX2 的开发板可以在 luat.taobao.com 上选购，但「两个串口加低成本」这种具体需求最好让 FAE 按功能推荐——EX2 属 EC718PM 平台，串口资源要按引脚复用表核对，不能只看型号名。说明：合宙的方案板很多，同一颗模组会有核心板、开发板、行业板几种形态。两个串口要确认是两路独立 UART，还是复用出来的；成本还与是否带屏、带以太网、带 RS485 强相关。处理步骤：① 列出必需接口（2 路 UART、供电方式、尺寸）；② 在淘宝店按模组筛选方案板；③ 让 FAE 出一张对比表；④ 先买一块验证引脚复用与长时间稳定性。参考文档：https://docs.openluat.com/common/product/

70. 模块回流焊虚焊比例较大，如何调整炉温曲线和放板间隔？

解答： 结论：用测温板实测炉温曲线，不要只看回流焊机的设定值：焊接区域峰值先按 260℃ 设定验证，实测与设定常差 10~15℃，再按实测曲线调温区与链速。说明：虚焊比例大通常是「实际峰值不足、回流时间不够、升温过快导致助焊剂提前挥发」这几类原因。放板间隔过密会让板边与板中的实际温差拉大，出现同一批一半好一半虚。模组是 LCC 邮票孔，对共面度与锡膏量比普通器件敏感。处理步骤：① 做测温板，热电偶贴在模组焊盘附近；② 测三个关键点：预热末温度、峰值温度、液相以上时间；③ 按实测结果调温区与链速；④ 加大板间距、避免拼板过密；⑤ 首件做 X-Ray 加推力抽检。参考文档：无（属商务/工艺事项，请通过购买渠道或对接 FAE 确认）。

71. Air780EHM在62℃高温下多次重启、LuatOS无法识别，是什么原因？

解答： 尚未解答

72. Air780EHM用TCP收发会丢帧吗？UDP/HTTP呢？

解答： 结论：TCP 有重传机制，应用层不会凭空丢数据，但会出现延迟增大与吞吐下降；UDP 本身不保证可靠，丢包由网络与缓冲决定；HTTP 基于 TCP，同样不会丢。说明：所谓「TCP 丢帧」多数是应用层没有处理粘包 / 半包，或者接收缓冲太小、读得不够快。socket 是字节流，没有消息边界，必须自己按长度字段或分隔符组包，否则看起来就像丢了一段。处理步骤：① 按协议做粘包与半包处理，别假设一次 recv 就是一帧；② 加大接收缓冲并及时 recv；③ UDP 场景自己做序号与重传；④ 结合 mobile.csq() 与 4gdiag 日志判断链路质量。参考文档：https://docs.openluat.com/air780epm/product/

73. Air8784用源码替换代码后提示文件总数量超标，怎么办？

解答： 结论：「文件总数量超标」不是单个文件太大，而是脚本区里的文件个数超过了固件限制；去掉调试信息能减小体积，但更直接的是减少文件数量——合并零散 lua、删掉不用的库与资源。说明：LuatOS 的脚本区有容量与文件数双重限制，8784 的出厂工程文件本来就多，用源码替换时很容易越界。strip 调试信息对体积有帮助，但对文件数没有任何作用，两个限制要分别看。处理步骤：① 统计当前文件数与占用空间；② 合并零碎 lua，删无用资源与示例；③ 关闭调试信息、压缩冗余；④ 确认固件分区是否支持更大的脚本区，必要时换版本。参考文档：https://docs.openluat.com/air8784/software/default_factory_firmware/

74. Air8784如何改成自定义SIP服务器？

解答： 结论：改 SIP 服务器地址、端口、账号、密码都在 8784 出厂固件的 SIP 参数章节里，改配置文件后重新下载脚本即可，不需要改固件。说明：8784 是 Air780EHM 加合宙自研 Air1103 语音芯片的组合，1103 自带 Codec，SIP 由 voip 库实现。参数一般写在 config 类文件里，包含服务器地址、端口、账号、密码与目标号码；改完要重新注册，注册成功才能收发呼叫。处理步骤：① 打开固件页找到 SIP 参数说明；② 修改 config 里的服务器与账号；③ 重新下载脚本并看注册日志；④ 用 SIP 客户端呼入呼出，验证双向语音是否正常。参考文档：https://docs.openluat.com/air8784/software/default_factory_firmware/、https://docs.openluat.com/air8784/product/

75. Air8784模组能否降低功耗，用电池供电做报警对讲产品？

解答： 尚未解答

76. Air780EPM/8607的WiFi距离只有20~25米、隔墙10米丢包，是天线原因吗？

解答： 结论：主要是天线与结构的原因，不是模组本身「WiFi 差」：核心板受体积限制只能用小板载天线或 IPEX 外接，净空不足、地平面小，旁边还有 4G 天线与屏蔽罩，20~25 米、隔墙 10 米丢包属于正常水平。说明：2.4G WiFi 穿墙损耗很大，一堵承重墙就有 10~15dB，板载天线效率通常只有外置天线的几分之一。开发板为了成本与体积不会做天线调试，所以拿开发板的数据去评估量产性能是不准的。处理步骤：① 开发阶段先用外置天线确认链路余量；② 量产让天线厂按你的外壳做匹配并测 TRP / TIS；③ 结构上给天线留净空、远离电池与金属；④ 必要时降带宽或降速率换距离。参考文档：https://docs.openluat.com/air8000/product/、https://docs.openluat.com/air780epm/luatos/hardware/design/antenna/

77. Air1603/8607的1603屏蔽罩烫手、温度40℃+正常吗？屏幕亮度不够是否供电不足？

解答： 结论：40℃+ 在 8607 这种小板加两层板的结构上属于正常范围，屏蔽罩烫手不等于超标；屏幕亮度不够更可能是背光供电或限流的问题，而不是 VBAT 不够，这两件事要分开测。说明：1603 主频 500MHz 还带 2D 加速，跑 UI 时功耗集中，屏蔽罩贴着芯片自然烫；两层板散热面积小、铜厚有限，手感温度会明显高于环境。屏亮度取决于背光升压电路、限流电阻与 PWM 占空比，把 VBAT 降下来只会更暗，不是解决办法。处理步骤：① 用热电偶测屏蔽罩与芯片附近温度，别用手感判断；② 测背光供电电压与电流，确认是否达到屏规格；③ 需要提亮就改背光升压或限流电阻；④ 高温场景加导热垫、必要时降频。参考文档：https://docs.openluat.com/air8607/product/、https://docs.openluat.com/air1603/

78. Air8000W模块VEXT给TF卡供电导致短路，VEXT内部给哪些模块供电？

解答： 结论：VEXT 是给「小电流外设」用的辅助电源，不建议给 TF 卡这类有浪涌负载供电；TF 卡单独用 LDO 加 MOS 控制。说明：VEXT 一般由模组内部 LDO 派生，输出能力只有几十毫安量级，带 TF 卡写入瞬间的浪涌会触发过流保护。「对地短路」很多时候是保护动作后的低阻表现，先断开负载测静态阻抗，就能区分板子真短路与负载过流。处理步骤：① 断开 TF 卡测 VEXT 对地阻抗；② TF 卡改独立 LDO 供电；③ 卡座附近加 100nF + 10μF 去耦与 TVS；④ 软件控制上下电时序，卸载前先 unmount。参考文档：https://docs.openluat.com/air8000/product/

79. Air780E的GPS反馈没有定位成功（+CGNSINF返回0），如何解决？

解答： 结论：+CGNSINF 返回定位状态 0 表示「还没定位成功」，常见原因是没接 GPS 天线、天线被遮挡或在室内、以及 GPS 功能未开启；先到室外空旷处冷启动等几分钟。说明：GNSS 冷启动的首次定位时间在开阔天空下也要 30 秒到几分钟，室内基本定不上。还要确认模组型号本身带 GNSS（部分 Air780E 型号不带，需要外挂），以及 GPS 电源与有源天线供电是否正常。处理步骤：① 到室外空旷处，天线朝上、远离金属与人体遮挡；② 确认天线与馈线正常、有源天线供电正确；③ 打开 GPS 电源并等待冷启动；④ 看卫星的 C/N0 判断信号质量；⑤ 仍不行就按 GNSS 应用文档与硬件设计逐项排查。参考文档：https://docs.openluat.com/osapi/core/libgnss/

80. Air780EG获取GPS无定位，如何解决？

解答： 结论：同样是先确认三件事：天线（含馈线与供电）、室外开阔环境、GPS 功能是否已开启。Air780EG 带 GNSS，但也要外接天线并等待冷启动。说明：EG 系列的 GNSS 与 4G 共用电源域，射频发射时会抬高噪声底，弱信号下定位更慢。是否给 GNSS 做备电常开，会影响热启动速度，但也直接影响待机功耗，要按业务权衡。处理步骤：① 接好 GNSS 天线并放到室外；② 确认 libgnss 已启动、GPS 电源已开；③ 等待冷启动首次定位；④ 对比开 / 关 4G 发射时的 C/N0；⑤ 需要快定位再做备电常开，同时核算功耗。参考文档：https://docs.openluat.com/osapi/core/libgnss/

81. Air780EPM无法识别SIM卡、信号强度一直为0，一般是哪里问题？

解答： 结论：SIM 卡识别不到、信号强度一直为 0，大概率是硬件问题（SIM 座虚焊或弹片接触不良、SIM_VDD 无输出、CLK / DATA 上拉或走线异常、卡没插到位），少数是固件或卡本身的问题。说明：软件能看到的只有「卡在不在」和「有没有驻网」，两者同时为 0 说明连卡都没读到，先排除卡与卡座。运营商后台显示正常只能说明账户没欠费停机，不代表卡与卡座接触良好。处理步骤：① 换一张已知好卡与标准卡托交叉验证；② 万用表测 SIM_VDD（1.8V 或 3.0V）是否有输出；③ 检查 SIM_CLK / DATA / RST 与上拉电阻、走线；④ 补焊或更换卡座；⑤ 仍不行用站点 AI 或 FAE 拿排查清单逐项过。参考文档：https://docs.openluat.com/air780epm/product/

82. Air724UG/Air780E系列USB驱动在哪里下载？

解答： 结论：驱动用的是同一个地址：https://docs.openluat.com/common/usb_drv/ ，但 Air724UG 与 Air780E 系列不是同一代平台，页面里要按系列分别下载，驱动不能混装。说明：724 是老的 RDA8910 平台，780E 是 EC618，两者的 USB 复合设备描述不同。装错驱动会显示未知设备，或者只能识别出部分接口（有串口没网卡，反之亦然）。处理步骤：① 按型号选对应驱动包；② 先在设备管理器卸载旧驱动再安装；③ 确认没有黄色感叹号；④ 换线换口验证，排除线材问题。参考文档：https://docs.openluat.com/common/usb_drv/

83. Air780EHM/Air780EPM等模块能否使用RTMP推流做IPCAM？

解答： 结论：能跑 RTMP，但不建议用 780 系列做高清 IPCAM：摄像头只有 30 万像素 MJPG，USB 又不支持 UVC，画质与带宽都不占优；做 IPCAM 请选 Air8101。说明：RTMP 协议本身不挑平台，挑的是视频源与上行带宽。Cat.1 上行通常只有几 Mbps，MJPG 30 万像素按 10fps 就接近上限，还会挤占业务数据。8101 是带硬件视频能力的平台，更适合这类场景。处理步骤：① 明确分辨率与帧率需求；② 估算码率与流量成本；③ 视频类项目换 8101；④ 780 只做低帧率抓拍上传，别当视频方案用。参考文档：https://docs.openluat.com/air8101/luatos/app/multimedia/rtmp/

84. Air8000A开发板WiFi距离弱，量产如何快速确定天线匹配参数？

解答： 结论：开发板天线性能有限是设计取舍，量产不能拿开发板的数据做结论；正确做法是让天线厂按你的外壳与主板做匹配，在模组已确定的匹配网络基础上微调，并实测 TRP / TIS。说明：天线匹配与外壳、地平面、电池位置、手握姿势强相关，同一副天线换个结构就要重调。官方天线设计文档给的是布局与净空原则，不是可以直接抄的匹配参数。处理步骤：① 按文档预留净空与地平面；② 找天线厂做仿真加实测；③ 用综测仪测 TRP / TIS；④ 小批量试产验证一致性，避免批次差异。参考文档：https://docs.openluat.com/air780epm/luatos/hardware/design/antenna/

85. Air780EHM/Air780EPM等模组的FOTA升级域名是什么？

解答： 结论：FOTA 域名是 iot.openluat.com；用物联网卡并开了定向白名单时，要把该域名与升级包实际下载的 CDN 域名一起加白。说明：libfota / libfota2 默认从这个域名取版本信息，包体多放在 CDN 上，只加主域名会出现「能查版本、下载失败」。另外 libfota3 只对接合宙 IoT 平台，自建升级服务器要用 libfota2。处理步骤：① 白名单加 iot.openluat.com；② 抓包补全包体下载域名；③ 用测试卡跑一次完整升级；④ 自建方案改用 libfota2 并自己配 URL。参考文档：https://iot.openluat.com/

86. Air780E系列模组在沙特/海外使用需要注意什么？

解答： 结论：出海先看频段：确认模组支持的频段与当地运营商完全匹配，缺一个都可能在部分区域无法驻网；724UG 频段不全，中东与非洲场景建议用 Air780EHU（亚欧版）或 Air8000U。说明：频段是硬件定的，刷固件改不了。海外还要考虑 VoLTE 支持、APN 手填、以及没有当地运营商认证（只有 CE / FCC）这几点，合宙也不做实地场测，能不能打电话必须自己拿当地卡验证。处理步骤：① 查当地运营商的频段清单；② 逐项比对模组频段表；③ 用当地卡实测注册、通话与短信；④ 产品里保留 APN 手填入口。参考文档：https://docs.openluat.com/air780ehnehu/product/air780ehufreq/

87. Air780EPM的WiFi/4G天线测试数据有吗？

解答： 结论：有天线设计文档（布局、净空、匹配原则都有），但没有「某个具体外壳下的实测数据」；量产必须让天线厂按你的结构做匹配与实测。说明：天线性能与结构强相关，官方给的开发板数据只能当参考基线。文档里强调的净空、地平面面积、远离金属与电池这几条是硬要求，违反了后面怎么调都调不回来。处理步骤：① 按天线设计文档做布局与净空；② 打样后测 RSRP / SINR 与吞吐；③ 让天线厂做匹配；④ 量产抽检一致性与驻波。参考文档：https://docs.openluat.com/air780epm/luatos/hardware/design/antenna/

88. Air780EPM的GPS轨迹在web端显示偏移，是什么原因？

解答： 结论：这是平台侧对 float 经纬度做 ×1000 / ÷1000 处理导致的精度损失（只剩 3 位小数，纬度上约 100 米量级），不是 GPS 定位漂移；改用 ASCII 字符串上报经纬度就能保留 6 位小数。说明：3 位小数在纬度上约 111 米，看起来就是「整条轨迹平移了一段」。GPS 原始输出的精度远高于这个，问题出在数据链路的数值类型与缩放环节，不在定位本身。处理步骤：① 上报改成字符串，例如 31.230416,121.473701；② 平台侧按字符串存储与展示；③ 与原始 NMEA 数据对比验证；④ 统一坐标系（WGS84 与 GCJ02 别混用）。参考文档：https://docs.openluat.com/air780epm/product/

89. Air780EPM/Air1603等产品的默认出厂固件放在docs仓库太大，如何管理？

解答： 结论：默认出厂固件（.soc / .bin）不适合直接放 docs 仓库：仓库会被撑大、克隆与构建变慢，二进制也没法 diff；应该放 CDN 或对象存储，文档里只放链接。说明：docs 仓库是源站，每次构建都要全量拉取，几百 MB 的固件会拖慢每一次构建；git 对大二进制也不友好，历史里的旧版本无法真正压缩掉。处理步骤：① 固件上传到 CDN；② 文档里放直链并标注版本与日期；③ 更新时只改链接，不往仓库塞二进制；④ 旧版本按版本号命名归档。参考文档：https://docs.openluat.com/air8784/software/default_factory_firmware/

90. Air780EPM开发板/核心板是否需要做产测？产测代码由谁负责？

解答： 结论：产测功能的开发由研发统一负责（原答指向孟伟），其他团队把产测集成进默认出厂固件；开发板与核心板是否需要产测，取决于你是否要出货自检。说明：产测一般覆盖射频校准与发射功率、SIM 与注网、外设（屏 / 触摸 / 音频 / SD / USB）、关键电压与电流。没有产测，不良品会直接流到客户手里，后续返修成本远高于工位成本。处理步骤：① 明确要测的项目与判定阈值；② 对接研发拿产测固件与上位机；③ 做夹具与工位流程；④ 小批量统计误判率与节拍后再量产。参考文档：无（属商务/工艺事项，请通过购买渠道或对接 FAE 确认）。

91. Air8607是否支持RS485隔离接口和PWM差分输出（伺服控制）？

解答： 结论：Air8607 最小系统不带隔离 RS485，也没有伺服用的 PWM 差分输出，这些要自己扩展；需要 RS485 可以直接选 Air8603（带隔离与非隔离 485），PWM 差分要外加差分驱动芯片。说明：8607 的定位是「大屏音视频最小系统板」，对外是 LCD、触摸、音频、SD、USB 与串口；8603 才是把 485、以太网、摄像头做齐的型号。伺服控制的差分脉冲（PUL / DIR）需要 MCU 侧 PWM 加差分收发器（如 AM26LS31）来实现。处理步骤：① RS485 优先选 8603，或外加隔离收发器；② PWM 差分加差分驱动芯片，注意共模与终端匹配；③ 确认 PWM 路数与最高频率；④ 有量可以谈定制整合。参考文档：https://docs.openluat.com/air8607/product/、https://docs.openluat.com/air8603/

92. Air780EHM/Air780EPM的脚本在Luatools模拟器运行没反应，怎么办？

解答： 结论：模拟器没反应，先更新「资源下载器」里的模拟器版本，或者删掉 resource 目录下的 luatos_pc 文件后重开 Luatools，让它重新下载一份与当前固件匹配的模拟器。说明：模拟器与固件、工具版本是配套关系，版本不匹配会直接没有任何输出，或者提示固件异常；luatos_pc 缓存损坏也会表现成一样。这类问题基本都能靠「清缓存 + 更新」解决。处理步骤：① 升级 Luatools 与资源下载器；② 完全关闭工具，删除 resource 目录下的 luatos_pc；③ 重新打开，等它自动下载完成；④ 仍不行就换一个旧版本工具做对比。参考文档：https://docs.openluat.com/common/Luatools/

93. Air8202G运行模拟器没反应/提示固件异常，怎么办？

解答： 结论：同样是更新模拟器、删除 resource 目录下的 luatos_pc 后重开 Luatools，并确认固件包完整（下载没中断、校验通过）。说明：Air8202G 用的是另一套固件，模拟器必须是与之匹配的版本；固件不完整时模拟器会直接报「固件异常」，看起来像模拟器坏了，其实是包不完整。处理步骤：① 重新下载完整固件并核对文件大小；② 删除 luatos_pc 后重开工具；③ 升级工具版本；④ 换一台电脑排除环境问题。参考文档：https://docs.openluat.com/common/Luatools/

94. Air8201G工牌/Air8202成品设备的后台如何进入？

解答： 结论：Air8201G 工牌与 Air8202 成品设备用同一套后台：微信小程序搜「合宙IOT」，在「自建应用」里进入；进不去就找 FAE 要对应批次的账号开通方式。说明：成品方案的后台不在 docs 文档站上，而在物联网平台；设备需要先按 SN 或 IMEI 绑定，后台才会出现对应设备与数据。没有账号权限时登录进去也是空的，容易误判成「后台没做好」。处理步骤：① 小程序搜「合宙IOT」；② 进「自建应用」；③ 按 SN / IMEI 绑定设备；④ 无权限或找不到入口找 FAE 开通。参考文档：https://docs.openluat.com/air8201/

95. 合宙开发板/模组如何用AI快速开发UI？

解答： 结论：可以，典型流程是「AI 出效果图 → AI 生成代码 → 模拟器验证 → 烧录」：先用 DeepSeek / 豆包这类工具生成 HTML 界面效果图确认视觉，再用 CodeBuddy / Trae 结合合宙 UI 库生成 Lua 代码，在 Luatools 模拟器里跑通，最后烧到板子上。说明：合宙的 AirUI 有自己的设计器与控件，让 AI 生成代码时必须把库的真实接口喂给它（airui / lcd / tp），否则很容易编出不存在的 API。模拟器能省掉大量烧录时间，适合反复调 UI。处理步骤：① 先出效果图确认视觉；② 把 AirUI 接口文档一起给 AI，让它按真实 API 生成；③ 模拟器里跑通交互；④ 烧到板子调触摸与刷新；⑤ 真机做回归。参考文档：https://docs.openluat.com/air1603/

96. Air1603的触摸IC需要支持哪些型号？自己屏幕触摸无反应怎么办？

解答： 结论：触摸 IC 必须是 tp 库已支持的型号才有现成驱动，例如 gt9xx（自动匹配 gt911 / gt1158 / gt927）、gt911、gt1158、gt927、gt9157、jd9261t、cst820、cst816d、cst9220、ft3x68 等；不在列表里的自购屏触摸无反应是正常现象。说明：触摸是 I2C 设备，驱动要匹配寄存器定义与坐标映射，还要按屏的物理尺寸做校准；I2C 地址不对、INT / RST 没接对，也会表现为完全无响应。换屏时先查 TP IC，比先改代码有效。处理步骤：① 查屏的 TP IC 型号；② 对照 tp 库支持列表；③ 确认 I2C 地址与 INT / RST 引脚；④ 不在列表里可以把屏寄给合宙协助适配。参考文档：https://docs.openluat.com/air1603/

97. Air1601/1602/8601开发板能否接USB键盘鼠标操作屏幕？

解答： 结论：可以，但要求板子把 USB Host 引出来：Air1601 / 1602 开发板与 Air8601 上有这个接口，接 USB 键盘鼠标就能操作屏幕（标准 HID）。说明：键鼠是标准 HID 设备，需要 USB 2.0 Host 与供电能力；用 Hub 时要注意供电，否则会出现识别不到或频繁掉线。只有 Type-C 从口（例如 8607 上那颗 CH343 转串口）的板子接不了。处理步骤：① 确认板上有 USB Host 口；② 接键鼠验证枚举；③ 用 Hub 时选带外供电的；④ 软件侧按 HID 事件处理输入。参考文档：https://docs.openluat.com/air1601/product/、https://docs.openluat.com/air8601/product/

98. Air780EHM/Air780EPM的AT固件/产测固件如何获取？

解答： 结论：AT 固件与产测固件都不在 LuatOS 固件页，AT 固件在 AT 模组那条线的固件页，产测固件属产线专用、通常随产测方案给出；拿不到就找 FAE。说明：产测固件是产线自检用的专用固件，不对外公开发布；AT 固件是正式产品固件，按 AT 型号下载。注意别把 LuatOS 固件当 AT 固件用，两者交互方式完全不同，刷错会表现为「一上电就吐 AT 指令」。处理步骤：① AT 固件去 AT 模组固件页下载；② 产测固件找 FAE 或研发；③ 确认型号与版本号；④ 记录固件版本，便于追溯与复现。参考文档：https://docs.openluat.com/atmozu/product/firmware/

99. Air780EPM 4G连接TCP正常但服务器收不到/连接异常，如何排查？

解答： 结论：TCP 连接正常但服务器收不到，先分清是「没发出去」还是「发了但服务器没处理」：打印发送返回值、抓 4gdiag 日志，同时看服务器侧的连接与收包记录。说明：常见原因包括数据没按协议封包（少了长度或换行）、服务器读缓冲没及时读、心跳超时被服务端踢掉、NAT 超时后连接其实已断而本地还以为在。信号质量差也会导致重传与时延，看起来像丢数据。处理步骤：① 打印 libnet.tx 的返回值与发送长度；② 服务端抓包确认是否到达；③ 加心跳并处理断开重连；④ 看 4gdiag 日志定位断连原因；⑤ 用 mobile.status() 与 csq() 排除链路问题。参考文档：https://docs.openluat.com/air780epm/luatos/app/base/errdump/errdump_780epm/

100. Air780EPM/Air8000W等模组是否支持WiFi定位？收费吗？

解答： 结论：支持 WiFi 定位，但属于收费服务：免费版只有单基站 LBS（2 分钟最多 1 次），要 WiFi 与多基站定位得买收费包，按请求频率分档、按年计费——合宙库 1 / 2 / 5 / 10 元每年，高德库 10 / 20 / 50 元每年。说明：收费服务分「合宙数据库」与「高德数据库」两种，前者每天自动更新、后者位置信息更全，选哪个看你对精度与成本的取舍。开通在物联网平台的订单管理里自助缴费即可。处理步骤：① 按业务算需要多高的定位频率；② 在平台选对应档位开通；③ 代码里用配套的 lib 库接口；④ 注意免费版超频会直接返回失败，不是「慢一点」而已。参考文档：https://docs.openluat.com/value/basestation/fee/

101. Air780EPM的PWM/GPIO在低功耗模式下还能用吗？

解答： 结论：低功耗下普通 GPIO 与 PWM 基本不可用（相关电源域已关闭），能保留的是 AGPIO 输入；要做休眠中的电平检测就用 AGPIO，PWM 输出必须先唤醒。说明：EC7xx 休眠时只维持 always-on 域，PWM 依赖的时钟与外设都停了，所以「休眠里还想驱动 MOS 或舵机」在硬件上就不成立。ADC 也一样，要采样必须先唤醒。处理步骤：① 查所选型号的 AGPIO 引脚表；② 需要保持输出的信号改用外部锁存或低功耗器件；③ 用定时唤醒处理周期性任务；④ 实测休眠电流，确认没有因为外部上拉或漏电跑掉。参考文档：https://docs.openluat.com/air780epm/product/

102. Air780EPM/Air8000W的USB识别问题，用拓展坞连接会导致Luatools识别不到吗？

解答： 结论：会有影响，建议用带独立供电的拓展坞：模组在下载与联网瞬间电流较大，无源 Hub 从主机取电不足会导致枚举失败或下载中断。说明：除了供电，Hub 的 USB 信号质量与线长也会影响稳定性；能直连主板 USB 口就直连，这是最省事的排错方式。处理步骤：① 先直连主板口验证是否正常；② 必须用 Hub 就选带外部供电的；③ 换短一点的优质数据线；④ 关闭杀软排除拦截。参考文档：https://docs.openluat.com/common/usb_drv/

103. Air780EPM/Air1603等模组是否有选型表？

解答： 结论：有选型表：https://docs.openluat.com/common/product/ ，按「是否要语音、是否要 GNSS、是否出海、是否带屏」四项筛最快；也可以让 ai.luatos.com 反查。说明：同一颗平台会派生很多后缀型号，差异集中在频段、是否内置 Codec、是否带 GNSS、Flash / RAM 与封装；核心库大多通用，所以先定功能再定型号，比先看型号再找功能省时间。处理步骤：① 列出需求；② 在选型表按列筛选；③ 核对频段与封装；④ 用 FAE 复核后再打样。参考文档：https://docs.openluat.com/common/product/

104. Air780EPM/Air780E系列模组的AT指令自定义上报如何实现？

解答： 结论：官方没有「自定义 AT 上报」的现成指令：要么用现有 URC 机制，要么定制固件。纯 Lua 侧可以做到「按自定义格式从串口输出」，但那不属于 AT 指令体系内的上报。说明：AT 固件里的 URC 是固件写死的，要新增必须改 AT 固件源码。如果目的只是让设备主动往外送数据，用 LuatOS 脚本直接走串口或网络更简单，也更可控。处理步骤：① 先明确是给外部 MCU 用还是给平台用；② 给外部 MCU 就用 Lua 自定义帧格式，配好帧头与校验；③ 必须是标准 AT 就提定制需求；④ 定制要先评估周期与费用。参考文档：https://docs.openluat.com/atmozu/product/shouce/

105. Air780EPM的配置指令（短信）回复延迟很久，是什么原因？

解答： 结论：配置类短信回复慢是运营商短信通道的时延，不是模组的问题：短信是存储转发，跨网、跨省延迟几十秒到几分钟都算正常。换一张不同运营商的卡对比一下就能确认。说明：短信下发还受短信中心排队、节假日拥塞、物联网卡短信权限影响，有些物联网卡默认关闭短信或做了限速。把关键配置只挂在短信通道上是有风险的。处理步骤：① 换卡对比，定位是通道问题还是模组问题；② 确认卡的短信功能已开通；③ 重要配置不要只依赖短信；④ 记录收发时间戳，区分上行慢还是下行慢。参考文档：https://docs.openluat.com/air780epm/product/

106. Air780EPM的AIR780E系列如何把GPS经纬度精度提高到6位小数？

解答： 结论：float 只有 3 位小数是数据链路的精度问题，不是 GPS 精度问题；把经纬度按 ASCII 字符串（保留 6 位小数）上报就能保住精度。说明：3 位小数在纬度上约 111 米，看起来整条轨迹都在偏。GPS 原始 NMEA 的精度远高于此，问题出在「用 float 传 + 平台做 ×1000 / ÷1000」这个环节。处理步骤：① 上报改成字符串，例如 lat,lon 各保留 6 位；② 平台按字符串存储；③ 与原始 NMEA 对比验证；④ 统一坐标系，避免 WGS84 与 GCJ02 混用。参考文档：https://docs.openluat.com/air780epm/product/

107. Air780EPM/Air1603等模组的固件升级FOTA白名单/域名如何配置？

解答： 结论：FOTA 白名单至少要放 iot.openluat.com，还要把升级包实际下载的 CDN 域名一起加白；只加主域名会出现「能查版本、下载失败」。说明：版本查询与包体下载往往不是同一个域名，物联网卡的定向白名单是按域名或 IP 生效的。最可靠的做法是用测试卡跑一次完整升级，把过程中访问的域名全部记下来。处理步骤：① 加 iot.openluat.com；② 抓包补全 CDN 域名；③ 用测试卡完成一次全流程升级；④ 把所需域名清单整理好交付客户或运维。参考文档：https://iot.openluat.com/

108. Air780EHM/Air780EPM等模组的Luatools版本更新后下载失败，是否有历史版本？

解答： 结论：有历史版本，在 https://cdn18.luatos.com/files/exe/ ；新版本下载失败时可以回退到已知可用版本，并把版本号与失败现象反馈给官方。说明：新版工具可能引入驱动、下载流程或加密选项上的回归，回退是最快的止损手段。回退后建议不要再用新版生成的工程文件，避免版本不兼容带来的二次问题。处理步骤：① 打开历史版本目录；② 下载已知可用的版本；③ 完全退出旧版后安装；④ 记录版本号与失败现象，反馈给官方复现。参考文档：https://cdn18.luatos.com/files/exe/

109. Air780EPM/Air8000W等模组的UART11/12修改波特率失败，怎么办？

解答： 结论：改 UART11 / 12 的波特率必须先 close 再重新 open，运行中直接改不会生效；close / open 之后仍失败就要升级固件并反馈复测。说明：这两个口在部分固件里与 WiFi 侧共用，参数被上层缓存，不 close 就改会被忽略，甚至把通道状态弄乱。另外对端设备的波特率也要同步改，否则收到的全是乱码，看起来像「改了没用」。处理步骤：① 先 close 再按新波特率 open；② 对端同步修改；③ 升级到最新固件再试；④ 抓串口日志反馈复测。参考文档：https://docs.openluat.com/air8000/product/

110. Air780EPM/Air1603等模组是否支持H.264/H.265视频？

解答： 结论：文档里能确认的是 Air1603 具备 2D 图形加速与 JPG / PNG 硬解码；H.264 / H.265 的硬件编解码在 1601 / 1603 的产品页上没有标注，原答「Air1601 已支持 H.264」需要按固件页或 FAE 再确认，别按「有硬解」来设计。说明：视频编解码能力取决于固件里带没带对应库与硬件单元，产品页只写了图形加速与图片解码。如果项目依赖 H.264 录像或推流，必须先拿到「哪个型号 + 哪个固件版本」的明确答复。处理步骤：① 明确要编码还是解码、分辨率与帧率；② 找 FAE 确认型号加固件版本；③ 用最小 demo 实测；④ 不满足就换带视频能力的平台。参考文档：https://docs.openluat.com/air1603/、https://docs.openluat.com/air1601/product/

111. Air780EPM/Air1603等模组的LCD座子PIN脚方向如何确认？

解答： 结论：LCD 座子的 PIN 脚方向以硬件文档里的连接器定义为准（第 1 脚位置、正反接、上下接），不同批次的座子可能有防呆差异；拿不准就拍实物照片让 FAE 确认。说明：50PIN RGB 座子最常见的问题就是「第 1 脚认错」，轻则整屏不亮或花屏，重则反接烧屏。FPC 的同向与反向（上接 / 下接）也必须匹配，不是插得进去就对。处理步骤：① 查硬件文档的连接器定义与 PCB 丝印；② 用万用表确认第 1 脚与 GND 的位置；③ 对着实物照片核对正反；④ 首次上电串一个限流电阻，降低烧屏风险。参考文档：https://docs.openluat.com/air8607/product/、https://docs.openluat.com/air1603/

112. Air780EPM/Air1603等模组能否用AI生成代码？

解答： 结论：可以，合宙 AI（ai.luatos.com）与 CodeBuddy 这类工具都能辅助生成代码，但生成的代码必须按合宙的实际库接口校对，不能拿来直接用。说明：通用大模型不熟悉 airui / lcd / tp 这些私有 API，容易编出不存在的函数或参数。把对应的库文档或示例喂给它，命中率会高很多；生成后先在模拟器里跑，再上板。处理步骤：① 提供目标库的接口文档或示例；② 先生成小模块并验证；③ 模拟器跑通后再上板；④ 关键逻辑人工复核，尤其是内存与刷新相关部分。参考文档：https://docs.openluat.com/air1603/

113. Air780EPM/Air780E系列模组在高温62℃下重启、无法识别，如何排查？

解答： 尚未解答

114. Air780EPM/Air8000W的VEXT给TF卡供电导致短路，如何处理？

解答： 结论：VEXT 带不动 TF 卡，TF 卡用独立 LDO 供电；所谓「对地短路」多数是负载过流保护被误判，先断开负载测阻抗再下结论。说明：VEXT 输出能力只有几十毫安量级，TF 卡写入瞬间的浪涌会把它拉到保护点。「短路」的判定要看静态阻抗，而不是保护动作之后的低阻表现，否则很容易把「过流」误诊成「短路」。处理步骤：① 断开 TF 卡测 VEXT 对地阻抗；② TF 卡改独立 LDO 加 MOS 控制；③ 卡座加去耦与 TVS；④ 软件做好上下电时序与 unmount。参考文档：https://docs.openluat.com/air8000/product/、https://docs.openluat.com/air780epm/product/

115. Air780EPM/Air780E系列模组的USB驱动下载慢，有没有现成的？

解答： 结论：驱动就在 https://docs.openluat.com/common/usb_drv/ ，压缩包不大，直接下载即可，不用等；下载慢通常是网络问题，换网络或找 FAE 拿离线包都行。说明：页面里的驱动包只有几 MB，慢多半是访问跨网 CDN 导致的。装的时候如果系统提示签名问题，需要在设备管理器里手动指定 INF，或临时关闭驱动签名强制。处理步骤：① 打开页面下载对应系列的包；② 校验解压完整；③ 手动指定 INF 安装；④ 拿不到就找 FAE 要离线包。参考文档：https://docs.openluat.com/common/usb_drv/

116. Air780EPM/Air780E系列模组在Luatools中无法识别设备，怎么办？

解答： 结论：按「驱动 → 线 → 供电 → 工具 → 杀软」的顺序排查：装对驱动、换数据线（必须含 D+ / D-）、直连不用无源 Hub、升级 Luatools、关闭安全软件拦截。说明：识别不到设备九成出在驱动与线材供电上，尤其是只充电的 USB 线——插上能亮灯，但没有数据通道。拓展坞供电不足也会导致枚举失败，表现为时好时坏。处理步骤：① 设备管理器看有没有未知设备或黄色感叹号；② 换线换口并直连；③ 重装对应驱动；④ 升级工具版本；⑤ 关闭杀软或加白后再试。参考文档：https://docs.openluat.com/common/usb_drv/、https://docs.openluat.com/common/Luatools/

117. Air780EPM/Air8000W等模组的WiFi/4G天线如何选型和调试？

解答： 结论：天线选型先按频段与形态定（FPC / 陶瓷 / 外置棒状），布局按官方天线设计文档留净空与地，最终匹配必须由天线厂按你的外壳实测。说明：2.4G WiFi 与 4G 频段差得远，不能共用一副天线（除非专门做多频合路）；两副天线要拉开距离并错开极化，否则互扰会同时拉低两者的性能。处理步骤：① 按频段选天线形态；② 预留净空、远离金属与电池；③ 打样后测 RSRP / SINR 与吞吐；④ 天线厂做匹配并测 TRP / TIS。参考文档：https://docs.openluat.com/air780epm/luatos/hardware/design/antenna/

118. Air780EPM/Air1603等模组的UI开发需要学LVGL吗？

解答： 结论：不一定非要学 LVGL：合宙有自己的 UI 设计器（AirUI），拖控件就能出界面，会 PS 这类工具就能上手；只有在做深度定制、复杂动画或性能调优时，才需要了解 LVGL 的对象与样式模型。说明：AirUI 在 LVGL 之上封装了一套接口，常用控件与事件都能直接调；但遇到自定义绘制、动画曲线、脏区刷新这类需求，懂 LVGL 会省很多时间，否则容易卡在「为什么这块没刷新」上。处理步骤：① 先用设计器做原型；② 按官方示例工程改；③ 复杂交互再查 LVGL 文档；④ 性能问题回到脏区与刷新策略上查。参考文档：https://docs.openluat.com/air1603/

119. Air780EPM/Air1603等模组的教程太少，能否出手把手教程？

解答： 结论：官方会陆续补文本与视频教程；在教程齐备之前，最有效的路径是「官方 demo 改 + ai.luatos.com 提问 + FAE 支持」，不要从零啃。说明：1601 / 1603 这一代资料更新很快，demo 往往比文档更贴近实际。遇到具体问题带上代码与日志提问，效率比泛读文档高得多。处理步骤：① 先跑通官方 demo；② 在 demo 上做增量修改；③ 卡住时带现象、代码与日志提问；④ 关注文档站的更新。参考文档：https://docs.openluat.com/air1603/

120. Air780EPM/Air1603等模组的屏幕接口是RGB还是MIPI？

解答： 结论：Air1603 是 RGB565 接口（不是 MIPI），最大 1280×800；MIPI 屏不能直连，需要转接方案或换型号。说明：RGB 是并行接口，走 FPC 排线，高分辨率长排线要评估信号完整性；MIPI 是差分串行，电气特性与时序完全不同，不能靠改软件兼容。选屏时先确认接口类型，能省掉大量返工。处理步骤：① 按 RGB565 选屏；② 确认 50PIN 连接器定义；③ 高分辨率缩短排线并加地；④ MIPI 屏要么加转接芯片，要么换平台。参考文档：https://docs.openluat.com/air1603/

121. Air780EPM/Air1603等模组能否外挂CAN控制器？

解答： 结论：更正一下——Air1603 的官方规格里写的是 CAN FD 2 路，模组侧已有 CAN 控制器，外层加收发器即可；不过 LuatOS 的 can 库目前只标注了 Air780 / Air8000 / Air8101 的引脚映射，1603 上是否开放需要向 FAE 确认。说明：如果只是要 CAN，用 can 库已支持的型号（Air780EHM / EHV 等）更稳妥；1603 更适合做大屏主控，CAN 交给外挂芯片或另一颗模组。做硬件时别忘了收发器与 120Ω 终端电阻。处理步骤：① 确认要 CAN FD 还是经典 CAN；② 优先选 can 库已支持的型号；③ 外接收发器并加终端电阻；④ 有量可以谈定制整合。参考文档：https://docs.openluat.com/air1603/、https://docs.openluat.com/osapi/core/can/

122. Air780EPM/Air1603等模组的供货和价格如何？

解答： 结论：价格以商务口径为准：Air1603 单价 19.9 元、Air8607 单价 39.9 元是原答给的口径，批量价、含税与交期都要和销售确认；Air8301 这类整机方案板不在公开价目里，需要单独询价。说明：模组价与整机 / 方案板价是两回事，带屏、带外壳、带配件的报价差别很大。做 BOM 成本核算时，要把天线、SIM 卡、结构件与加工费一起算进去，别只按模组单价估。处理步骤：① 明确型号与数量；② 向销售索取正式报价（含税、含运）；③ 确认交期与最小起订量；④ 小批试产验证真实成本。参考文档：https://docs.openluat.com/common/product/

123. Air780EPM/Air8000W等模组的VEXT供电能力如何？

解答： 结论：VEXT 是辅助电源，输出能力有限（几十毫安量级），只适合给小电流外设（传感器、小屏背光辅助）；大功耗外设（TF 卡、WiFi 模组、功放）必须单独供电。说明：VEXT 通常由模组内部 LDO 派生，过流会触发保护，表现为电压跌落或看起来像「短路」。设计时按外设的峰值电流留 2 倍以上余量，别按平均电流算。处理步骤：① 统计所有挂在 VEXT 上的外设峰值电流；② 超了就改独立 LDO；③ 加去耦电容；④ 实测上下电波形，确认没有跌落。参考文档：https://docs.openluat.com/air8000/product/

124. Air780EPM/Air780E系列模组的TCP/IP私有协议数据包解析能否实现？

解答： 结论：可以。LuatOS 的 socket 只负责收发字节流，私有协议的封包与解包完全在 Lua 层自己做；建议 UI 与业务分离，业务逻辑放独立模块，方便以后换协议。说明：TCP 是字节流，必须自己处理粘包与半包（按长度字段或分隔符），别假设一次 recv 就是一帧；UDP 则要自己做序号与重传。协议解析不建议写在 UI 回调里，否则界面卡顿时数据也跟着乱。处理步骤：① 定义帧头、长度与校验；② 写独立的 parser 模块；③ 用缓冲区循环取帧；④ 单测覆盖半包、粘包、坏包三种情况。参考文档：https://docs.openluat.com/air780epm/product/

125. Air780EPM/Air8607等模组的文字转语音（TTS）功能有吗？

解答： 结论：Air8607 板载功放（HT6873）驱动 4Ω/3W 喇叭，可以播放 TTS 语音；但 TTS 需要固件里带对应能力（8603 文档明确写「TTS 需适配固件」），不是所有固件默认开启。说明：TTS 在 LuatOS 里属于 audio / tts 库的能力，需要语音资源或在线合成。8607 本身的音频通路是完整的（DAC + 功放 + 喇叭座），能不能 TTS 取决于固件版本与资源包。处理步骤：① 确认当前固件是否含 TTS；② 用 audio 库播一段验证通路；③ 需要离线 TTS 就确认资源包；④ 按喇叭规格调音量与功放增益。参考文档：https://docs.openluat.com/air8607/product/

126. Air780EPM/Air1603等模组的UI能否显示中文和数字？

解答： 结论：可以。AirUI 的文本控件支持中文与数字显示；中文需要对应字库（点阵或矢量字体），数字用默认字体即可。说明：中文显示的关键是字库——内置字库覆盖面有限，字数多或字号大就要外挂字库文件（放文件系统或 flash）。字库本身也占空间，选固件时要确认分区够不够。处理步骤：① 确认字库来源（内置或外挂）；② 按字号选点阵或矢量字体；③ 核对字库占用的 flash；④ 长文本分段渲染，避免一次性刷新卡顿。参考文档：https://docs.openluat.com/air1603/

127. Air780EPM/Air1603等模组的SPI屏幕能否驱动？

解答： 结论：Air1603 主要支持 RGB 接口的屏，SPI 屏能不能驱动要看 lcd 库是否提供对应驱动 IC 的支持；不要默认「有 SPI 就能点屏」。说明：SPI 屏多是小尺寸（1.3~2.4 寸），驱动 IC 各不相同（st7735、ili9341 之类），需要 lcd 库里有对应型号与初始化序列。1603 的定位是大屏 RGB，SPI 屏属小众用法，资料与示例都少。处理步骤：① 查屏的驱动 IC 型号；② 对照 lcd 库支持列表；③ 不在列表里看库是否开放自定义初始化；④ 大屏还是老实走 RGB 接口。参考文档：https://docs.openluat.com/air1603/

128. Air780EPM/Air1603等模组的音频输出功率如何？

解答： 结论：Air1603 / 8607 板载 DAC 输出加功放（8607 是 HT6873 驱动 4Ω/3W 喇叭），具体输出功率与失真看硬件文档与功放规格；没有板载功放的型号要外接。说明：DAC 输出的是小信号，功率由功放决定；喇叭阻抗与供电电压决定最大不失真功率。做语音播报完全够用，做音乐播放要评估频响与失真。处理步骤：① 查板子上的功放型号与供电电压；② 按 4Ω/3W 选喇叭；③ 测最大音量下的失真与温升；④ 需要立体声或更大功率就外接功放。参考文档：https://docs.openluat.com/air8607/product/、https://docs.openluat.com/air1603/

129. Air780EPM/Air1603等模组能否用电池供电做低功耗产品？

解答： 结论：可以，但电池方案的关键不在模组而在整机：4G 发射是脉冲大电流，电池要能扛住瞬时放电；低功耗要靠 PSM+ 与定时唤醒，而屏幕与背光往往才是耗电大头。说明：带屏产品做电池供电，先算「屏背光 + 主板 + 4G 平均」的总账。1603 主频 500MHz，跑 UI 时功耗不低，需要动态降频、息屏与降低刷新率来省电。处理步骤：① 列一张功耗预算表，把各状态电流写清楚；② 按容量与放电倍率选电池；③ 做息屏、降频与 PSM+ 策略；④ 实测各状态电流并核算续航。参考文档：https://docs.openluat.com/air1603/、https://docs.openluat.com/air780epm/product/

130. Air780EPM/Air1603等模组的开发板原理图和PCB在哪里下载？

解答： 结论：开发板原理图与 PCB 在对应产品页的硬件资料里（如 8607 的 hardware 下有 shouce 与 circuit），从 docs 站首页按型号进产品页再找硬件一栏；拿不到就找 FAE。说明：不同型号的硬件资料组织方式不一样：8607 是 hardware/shouce（原理图与封装）+ hardware/circuit（电路与引脚）；1603 是单页加 luatos 子目录。直接访问产品根路径可能返回 403，因为目录下没有 index.md。处理步骤：① 进对应产品页；② 找 hardware 下的 shouce 与 circuit；③ 下载 PDF 或源文件；④ 缺失的找 FAE 补。参考文档：https://docs.openluat.com/air8607/product/、https://docs.openluat.com/air1603/

131. Air780EPM/Air1603等模组的量产产测如何做？

解答： 结论：量产产测由研发统一负责开发（原答指向孟伟），其他团队把产测集成到默认出厂固件；你要做的是定测试项、做夹具、跑通工位流程。说明：产测一般覆盖射频校准与发射功率、SIM 与注网、外设（屏 / 触摸 / 音频 / SD / USB）、关键电压与电流。没有产测，不良品会直接流到客户手里，返修成本远高于工位成本。处理步骤：① 定测试项与判定阈值；② 对接研发拿产测固件与上位机；③ 做夹具与扫码流程；④ 小批量统计误判率与节拍。参考文档：无（属商务/工艺事项，请通过购买渠道或对接 FAE 确认）。