常见问题 - 2026-10-30

数据日期：2026-10-30

1. Air8783H/8783H 是否支持直接通过4G(VoLTE)呼出电话，不经过SIP？现有代码是否支持？

解答： 结论：支持 4G 原生语音（VoLTE）呼出，插实名认证的卡即可拨打；但「不经 SIP、由 Lua 直接把通话接到本地音频」这条路，现成 demo 没有，需要基于源码二次开发。说明：Air8783H 的主控是 EC7xx 系列 Cat.1 平台，语音能力分两层——射频侧本身支持 VoLTE 原生通话，协议栈侧的演示工程（sip_cc_bridge_pcm）走的是 SIP 信令 + CC/PCI 音频桥接，因此它验证的是「SIP 呼叫落地到 SIM 卡」这一条链路，而不是「Lua 直接起一路 VoLTE 呼叫」。这两条路的差别在于呼叫控制由谁发起，不能直接互换。处理步骤：① 先用实名卡验证基础通话能力（模组能否注册 IMS、能否拨通被叫）；② 拿 sip_cc_bridge_pcm 的源码，看清呼叫发起点和音频通道开关的位置；③ 在源码基础上改动呼叫控制部分，把 SIP 信令替换成本地触发；④ 改完用 cc/voip 相关接口逐段验证，配合完整底层日志看信令交互；⑤ 量产前把改动点固化成自己的板级工程，避免每次升级固件重做。参考文档：https://docs.openluat.com/air8783/、https://docs.openluat.com/air8783h/

2. 合宙图形化编程/UI设计用什么软件？Codebuddy是什么？

解答： 结论：合宙官方给的是 ai.luatos.com 网页版 AI 助手和 AirMaster 桌面工具；社群提到的 Codebuddy 属于第三方 AI 编程工具，不是合宙产品。说明：做图形化 UI 时，合宙这一侧的定位是「AI 生成 AirUI 代码」，而不是传统拖拽式组态软件。AirMaster 提供设备侧文件与工程管理、视频转 HZV 等实用功能，AI 助手负责把需求翻译成 Lua + AirUI 代码；第三方 AI 编程工具能用，但要靠项目里的规则文件与文档索引把接口约束喂进去，否则容易写出不存在的 API。处理步骤：① 先用 ai.luatos.com 把界面需求描述清楚，拿到可运行的第一版代码；② 用 AirMaster 管理工程文件、转换素材；③ 需要接入 AI 编程工具时，按 MCP 方式挂上合宙文档服务；④ 代码落板前逐条对照 AirUI 文档核对接口名，避免用到未实现的方法。参考文档：https://docs.openluat.com/ai/、https://docs.openluat.com/ai/airmaster/、https://docs.openluat.com/ai/mcp_cli/

3. 合宙能做电子相册吗？有demo样例吗？

解答： 结论：能做，但文档里没有单独的「电子相册」示例工程；现成能复用的是 Air8607 出厂固件的文件管理与图片显示能力，相册逻辑要自己组织。说明：Air8607 是 Air1603 的大屏最小系统板，带 Micro-SD 卡座和 RGB565 大屏，硬件上完全跑得动本地相册。软件上官方交付的是出厂固件（UI、文件管理、音频、FOTA），图片显示则由 AirUI 的图片组件负责；把「扫描 SD 卡图片目录 → 生成缩略图列表 → 点击进大图」这套流程写出来，就是一个可用的相册。处理步骤：① 先刷出厂固件，确认屏、触摸、SD 卡都正常；② 在 SD 卡建一个图片目录，放进几张 JPEG/PNG 验证解码显示；③ 用 AirUI 的图片组件搭列表页与大图页，页面切换建议用 exwin 管理；④ 大图预解码会占内存，翻页时注意及时释放引用；⑤ 需要相册作为正式产品时，再把出厂固件工程克隆出来改成自己的板级工程。参考文档：https://docs.openluat.com/air8607/product/、https://docs.openluat.com/air8607/software/overview/、https://docs.openluat.com/air1603/luatos/demo/

4. AIR8607板子能否控制显示某屏幕？GT911触摸屏能用吗？

解答： 结论：50PIN 接口的 RGB 屏通常可以直接插上试；GT911 触摸在 8607 上是标配，插上一般就能用，前提是屏本身带触摸且 I2C 走线一致。说明：Air8607 的 LCD 是常规 50PIN 连接器，支持 RGB565，分辨率 1024×600 起、最高 1280×800；触摸走 I2C1：SCL = PIN42（GPIO39）、SDA = PIN41（GPIO38），TP_RST = GPIO14，TP_INT = WAKEUP（GPIO51）。官方的 tp 库支持 gt9xx 自动匹配 gt911/gt1158/gt927，也支持 gt911、cst820、ft3x68 等常见型号，所以「能识别」通常不是驱动问题，而是复位时序、中断脚或屏的触摸 FPC 没接好。处理步骤：① 对照屏的规格书确认是 RGB565 接口、50PIN 线序一致；② 插上后先只跑显示，确认画面正常再调触摸；③ 触摸无反应时逐项量 TP_RST、TP_INT 电平和 I2C 上拉；④ 用 tp 库的探测接口看能否读到触摸 IC 地址；⑤ 自己适配不了的屏，把型号和规格书发给合宙协助适配。参考文档：https://docs.openluat.com/air8607/product/、https://docs.openluat.com/air8607/hardware/circuit/、https://docs.openluat.com/osapi/core/tp/

5. 电路图资料用AD软件打开报错，合宙要求用哪个软件？有AD版吗？

解答： 结论：合宙不提供 Altium Designer（AD）工程；设计文件导出的是通用交换格式——原理图导 .txt、PCB 导 .asc，用 PADS 打开。说明：合宙的硬件资料统一用 PADS 出图，.asc 就是 PADS 的 ASCII 格式，.txt 是网表/原理图交换文件。AD 直接双击打开这类文件必然报错，因为不是同一个工程数据库格式。要转到 AD，正确做法是在 PADS 里先导出，再用 AD 的导入向导转换，转换后元件库、网络标签、封装尺寸都需要人工核对，不能直接投产。处理步骤：① 到对应型号的「原理图及 PCB 封装」页下载设计文件压缩包；② 用 PADS 打开 .asc；③ 若必须用 AD，先在 PADS 里执行导出，再用 AD 的 Import Wizard 导入；④ 转换后逐个核对封装、焊盘尺寸与网络；⑤ 投产前务必以官方 PDF 原理图和尺寸标注图复核一遍。参考文档：https://docs.openluat.com/air8607/product/、https://docs.openluat.com/air8607/hardware/circuit/

6. 设备开发完套壳后能否拿到入网许可？一般按什么设备报认证？

解答： 结论：可以拿到入网许可，但认证必须由你自己的整机去申请，合宙只能提供已通过的模组级报告。说明：模组过的是 CE/FCC 这类电磁兼容与射频合规，进网许可（SRRC、CTA/入网许可、CCC 等）是按最终设备形态判定的，套壳之后增加了外壳、天线位置、供电与接口，整机的辐射和抗扰表现都会变，所以不能沿用模组的证书。按什么设备报，取决于你产品的实际功能归类（数据终端、网关、显示终端等），需要和认证机构先确认品类。处理步骤：① 先明确整机功能清单（是否有屏、是否有 485/以太网、是否带电池）；② 带着清单找认证机构确认测试项与品类；③ 用合宙已有的模组报告作为技术资料附件，减少重复测试；④ 认证前先自测天线与外壳对灵敏度的影响；⑤ 需要代理资源时联系对接的 FAE 获取推荐机构。参考文档：https://docs.openluat.com/air780egh/product/renzheng/、https://docs.openluat.com/air780ehnehu/product/air780ehnfreq/

7. Air8000AB/Air8000DB的单北斗是硬件单北斗还是固件单北斗？

解答： 结论：是硬件单北斗——Air8000AB / Air8000DB 本身就是真单北斗芯片方案，不是靠 gnssmode 把多星系芯片「切成」单北斗。说明：合宙大多数模组用的是单频（L1）多星系 GNSS 芯片，把 gnssmode 设成 2 只是关闭其它星系，而单频芯片在 L1 上只能收到 B1I/B1C 的北斗卫星，卫星数本来就少，定位慢、精度也一般。文档明确提示：单北斗应用往往要过实验室认证，多星系芯片极大概率过不去，所以真需求要选真单北斗硬件。处理步骤：① 先确认项目是否真的只允许北斗（很多需求其实是「精度够就行」）；② 若必须单北斗，直接选 Air8000AB / Air8000DB；③ 软件上不要再把多星系模组切成单星系，避免定位时间被拖到分钟级；④ 认证前用实验室预测试验证卫星数；⑤ 天线选型按单北斗频点重新匹配，别沿用多星系天线。参考文档：https://docs.openluat.com/air780egh/luatos/app/gnss/gnss_test/、https://docs.openluat.com/air8000/luatos/firmware/

8. GNSS和4G有板载或FPC天线推荐吗？项目用不了外置天线，开发板板载天线性能不满意。

解答： 尚未解答

9. Air8603有蓝牙功能吗？

解答： 尚未解答

10. Air8783H是否可以直接刷官方V2054固件，运行sip_cc_bridge_pcm示例，接入自己的FreeSWITCH，实现SIM卡双向语音通话？

解答： 结论：源码有，但直接刷 V2054 就跑通 sip_cc_bridge_pcm 做不到——这个工程需要板级适配和参数改动，属于二次开发范围。说明：sip_cc_bridge_pcm 演示的是 SIP 信令与 CC（通话音频）之间的 PCM 双向桥接，它依赖固件里 CC-PCM 桥接通道被真正编进去，还需要按你的硬件配置采样率、通道和增益。公开固件是通用配置，桥接相关能力在部分固件里默认不开，所以现象往往是脚本能跑、但音频不通。处理步骤：① 先确认手上的 8783H 固件是否带 CC 桥接能力（脚本里读桥接相关常量探测）；② 把 FreeSWITCH 的注册参数、编解码、NAT 配置改成和 demo 一致先跑通信令；③ 信令通了再调音频，按 demo 的采样率与通道设置逐项对齐；④ 用完整底层日志看 PCM 启动、缺帧与重采样环节；⑤ 需要官方桥接固件或源码支持时，联系对接的 FAE 按 SIP 硬件方案获取。参考文档：https://docs.openluat.com/air8783/、https://docs.openluat.com/air8783h/、https://docs.openluat.com/air8000/luatos/app/mulu/mobile/

11. Air8783H是否提供与sip_cc_bridge_pcm匹配、支持CC PCM和VoIP PCM双向桥接的底层.soc固件？

解答： 结论：不单独公开发布「配对某个 demo 的桥接 .soc」；随 SIP 方案硬件一起提供的是固件与可二次开发的源码。说明：CC-PCM 与 VoIP-PCM 的双向桥接属于方案级能力，官方按硬件项目交付，而不是挂在公开固件页给所有人下载。原因是桥接的采样率、通道映射、回声处理都和具体硬件（codec、PA、麦克风布局）绑定，通用固件下发出去反而是「能跑但音质不对」的坑。处理步骤：① 明确你的音频硬件配置（codec 型号、采样率、单/双声道）；② 向 FAE 说明要做 SIP↔CC 桥接，申请对应的固件与源码；③ 拿到工程后按自己板子的管脚与增益改配置；④ 用 cc.setBridge 一类接口建立桥接并观察 bridgePcmStats 之类统计；⑤ 联调阶段固定用同一版固件，避免升级把桥接行为改掉。参考文档：https://docs.openluat.com/air8783/、https://docs.openluat.com/air8783h/

12. 设备是否支持连接自建FreeSWITCH SIP服务器、不依赖合宙云平台？是否提供SIP-CC双向语音桥接固件、Lua示例及烧录工具并可修改？能否由SIP软电话输入不同被叫号码，由设备用实体SIM卡拨出并传回双向音频？

解答： 结论：可以完全不依赖合宙云平台，直接接自建 FreeSWITCH；SIP-CC 桥接的固件、Lua 示例和下载工具都能提供，并且允许改。说明：合宙在这个方案里只做「功能展示」，官方推荐客户用自己的 SIP 服务器——因为账号、路由、计费、录音都在客户侧，接第三方云反而增加链路不确定性。设备侧的能力是：SIP 注册到你的服务器，把 SIP 侧的语音与 SIM 卡的 VoLTE 通话做双向桥接，因此「软电话拨某个号码 → 设备用实体卡拨出 → 双向音频回传」这个链路在架构上是成立的。处理步骤：① 先在 FreeSWITCH 上建好分机与出局路由，用软电话互拨验证服务器本身正常；② 设备侧按 demo 配置服务器地址、账号、密码与编解码；③ 注册成功后先测单向音频，再测双向；④ 被叫号码由软电话侧下发，注意号码格式要带区号或按你的出局规则补全；⑤ 联调期开完整日志，按信令时序定位卡点。参考文档：https://docs.openluat.com/air8783/、https://docs.openluat.com/air8783h/、https://docs.openluat.com/air8000/luatos/app/mulu/mobile/

13. Air8300/Air8000 是否支持SIP？需求对应的demo在哪里？

解答： 结论：Air8300 不支持 SIP，也没有加音频通路；SIP 通话的 demo 在 Air8000 的 mobile 应用目录下。说明：Air8300 是双网口双 485 工控板，主控是 Air8000W，设计目标是 4G + WiFi/BLE + 双以太网 + 隔离 485，板上没有 codec 与音频接口，所以既做不了 SIP 通话也做不了本地放音。它的强项在网络与工业接口，不在语音。要 SIP 通话得换带音频通路的型号，比如 Air8783H、Air8000 的语音方案，或 8603/8601 系列的 SIP 整机。处理步骤：① 先确认项目是否真的需要语音（很多工控场景只是要联网上报）；② 需要语音就按音频能力重新选型；③ 选型后在对应型号的应用目录里找 mobile/SIP 相关 demo 作为起点；④ 音频硬件（codec、PA、麦克风）按参考设计走；⑤ 工控接口的需求仍可以由 8300 承担，必要时做成「8300 做网关 + 语音板做通话」的双板结构。参考文档：https://docs.openluat.com/air8300/product/、https://docs.openluat.com/air8000/luatos/app/mulu/mobile/

14. Air8300要满足VoLTE通话、SIP PCM桥接、短信、WiFi STA+SoftAP和以太网，应该刷哪个固件版本？LuatOS-SoC_V2054_Air8000_113.soc或122.soc对吗？下载地址有吗？

解答： 尚未解答

15. 用Air8607的UART外挂WiFi模组可行吗？

解答： 结论：可以用 UART 外挂 WiFi 模组，但要说清一点——Air8607 本身不带 WiFi，也没有 4G；想开箱就联网应选 Air8603。说明：Air8607 的定位是「大屏音视频最小系统板」，官方明确写了不带网络功能（无 WiFi / 4G），板上的外设只有 LCD、触摸、喇叭、SD 卡和 Type-C。如果坚持用 8607，就只能在 UART 上挂一个 AT 指令的 WiFi 模组，自己写 AT 收发与联网状态机，工作量不小；而 Air8603 与 8607 同主控（Air1603），把 WiFi/4G、以太网、485 都做在板上，型号按 W1~W5（WiFi）和 M1~M5（4G）区分。处理步骤：① 明确是否需要联网、需要 WiFi 还是 4G；② 需要联网直接选 Air8603 对应型号，省掉外挂与自写 AT 逻辑；③ 若必须用 8607 外挂，选支持 AT 的 WiFi 模组并确认供电与电平；④ 在 Lua 里用 uart 库做 AT 交互，注意超时与重连；⑤ 外挂方案要额外做射频布局与天线净空，别贴着屏走线。参考文档：https://docs.openluat.com/air8607/product/、https://docs.openluat.com/air8603/

16. 插上手机卡能否出来SIP线路，用设备插手机卡对接SIP线路，应该选哪个型号？Air780EHV/8783H还是其他？

解答： 结论：优先考虑 Air8783H——内置标准 SIP 协议栈，支持 SIP 与 VoLTE 桥接，正适合「设备插卡、对外提供 SIP 线路」这类外呼方案。说明：这个需求的关键不是「能不能插卡」，而是「插卡之后能不能把语音转成 SIP 线路」。Air8783H 的方案就是把 SIM 卡的 VoLTE 通话与 SIP 侧语音做桥接，SIP 服务器可以是自建的，不依赖合宙云平台。Air780EHV 也有音频能力，但它定位是通用 Cat.1 语音模组，SIP 桥接这类方案级能力要看具体固件与工程，不能只看「有 audio 库」就认为能做 SIP 落地。处理步骤：① 先确认并发路数、是否需要录音、是否要接自建服务器；② 按这些条件向 FAE 索取 8783H 的方案资料与报价；③ 拿样品先把「软电话拨号 → 设备用卡拨出 → 双向音频」跑通；④ 再评估长时间通话的稳定性与功耗；⑤ 确定型号后再定天线、结构与散热。参考文档：https://docs.openluat.com/air8783/、https://docs.openluat.com/air8783h/

17. Air1603和原来的Air1101评估板兼容吗？

解答： 尚未解答

18. ¥199开发板是否含摄像头模组或人脸识别模组？

解答： 结论：不含。¥199 的开发板是主板 + 基础配件，摄像头模组和人脸识别模组需要单独购买。说明：开发板的定价通常只覆盖「能开机、能跑 demo」的最小集合，摄像头这类可选外设按型号单独售卖，因为不同项目要的摄像头规格差别很大（接口、分辨率、是否带 ISP）。人脸识别更依赖算法与算力，属于软件能力而非板载器件，买板子不会附赠识别模型或授权。处理步骤：① 先看该开发板的「资源一览」确认随机配件清单；② 需要摄像头时按板上的接口（USB / DVP / MIPI）选对应模组；③ 人脸识别先在目标型号上验证算力与算法可行性，再决定是否上整机方案；④ 采购前和销售确认配件是否同捆，避免重复下单。参考文档：https://docs.openluat.com/SelectionGuide/SelectionGuide/

19. Air700E的固件在哪里下载？网页已经没有Air700E了。

解答： 尚未解答

20. 开发板背光亮度低，如何提高亮度？

解答： 结论：背光偏暗是背光限流电阻按小电流设计的必然结果，要提高亮度就得改限流电阻，但要连同封装一起换，不能只改阻值。说明：开发板的背光回路按小尺寸屏的电流设计，7 寸屏在这个电流下偏暗是正常表现。10 寸屏一般需要 180~240mA，靠原有的限流电阻根本到不了，必须减小阻值。问题在于原电阻多是 0201 封装，额定功率很小，直接改小阻值会明显发热甚至烧断，所以要么换大封装，要么交给合宙改。处理步骤：① 对着原理图确认背光升压回路的限流电阻位号；② 按目标电流重算阻值，并把封装换成 0603/0805；③ 换完实测背光电流与亮度，确认肉眼可见改善；④ 连续点亮半小时观察电阻与升压 IC 温升；⑤ 不想自己动板子可以寄回合宙修改，省掉返工风险。参考文档：https://docs.openluat.com/air8607/hardware/circuit/、https://docs.openluat.com/air8607/product/

21. Air1603开发板额外买WiFi模块贴上去能否直接用？是否支持WiFi和4G同时使用？

解答： 结论：能贴，但要先改几个电阻；而且这块板不支持 WiFi 与 4G 同时使用，只能二选一。说明：Air1603 平台的联网是「外挂式」的，WiFi 与 4G 共用有限的接口与供电资源，官方按 W1~W5（WiFi）与 M1~M5（4G）划分组合，每种组合对应一组电阻配置。所以「贴个模块上去」并不等于能用，必须把外围电路改成对应组合，否则要么不识别，要么抢同一路接口。处理步骤：① 先确定项目要 WiFi 还是 4G，不要指望双通；② 对照 Air8603 的型号表选最接近的组合，照它的电阻配置改板；③ 改完先只测联网（扫描、注册、注网），确认链路通；④ 再跑业务 demo，注意 WiFi 与 4G 的初始化顺序；⑤ 若两种都要，做成两块板或在型号上直接选 8603 的对应版本。参考文档：https://docs.openluat.com/air1603/、https://docs.openluat.com/air8603/

22. 8607可以播放视频文件吗？较大的MP4（如11MB）能正常播放吗？

解答： 结论：能播视频，但建议先转成合宙私有的 HZV 格式再播；11MB 的 MP4 直接播既吃内存也不保证流畅。说明：设备侧的视频播放器是按 HZV 设计的——HZV 内部是 MJPEG 画面 + MP3 音频，解码开销可控，适合 MCU 级平台边解边播。而 MP4 的封装与编码（H.264 等）需要额外的解码资源，1080P 或高码率文件很容易直接把内存吃穿。AirMaster 自带转换器，能把普通视频转成 .hzv，产物与源文件同名、只改扩展名。处理步骤：① 用 AirMaster 的转换器把源视频转成 .hzv（源文件必须同时有音轨，否则转换失败）；② 把文件放进 SD 卡，用 videoplayer 打开验证画面与声音；③ 文件大就先降分辨率、降帧率再转；④ 播放时注意画质与帧率的取舍，默认 15fps，可按需调整；⑤ 反复播同一段做压力测试，观察内存是否持续下降。参考文档：https://docs.openluat.com/air1603/luatos/app/multimedia/ui/videoplayer/、https://docs.openluat.com/ai/airmaster/

23. 8607是否支持手写输入？能否通过以太网连接服务器实现手写输入？

解答： 结论：不支持手写输入，屏幕键盘只提供拼音/英文/数字/符号输入；接服务器做手写识别理论上可行，但工程量与收益不匹配。说明：AirUI 的 textarea + keyboard 组合实现的是软键盘文本输入，中文走拼音，没有手写笔迹采集与识别通道。如果一定要手写，需要自己采集触摸轨迹点、做笔迹压缩上传，再由服务器端的模型识别成文字回填——这套链路涉及轨迹采样率、坐标系归一化、识别模型与网络延迟，成本远高于直接用拼音。处理步骤：① 先确认业务是否真需要手写（签名场景往往只需要存笔迹图片）；② 只用输入文字就直接用 textarea + keyboard；③ 需要存签名，就把轨迹点序列化成坐标数组存 SD 卡或上传；④ 需要识别文字，明确服务器侧模型与接口格式再评估；⑤ 若只是输入效率问题，优先优化候选词与键盘布局。参考文档：https://docs.openluat.com/osapi/core/airui/

24. 8607是否支持语音输入？本地或接入云端可以吗？

解答： 结论：本地语音输入做不到（没有本地 ASR），接云端理论上可以，但要自己写服务器，不是小程序能解决的事。说明：语音输入 = 录音 + 语音识别。设备侧能做的只有录音（采 PCM 或压缩后上传），识别必须放到云端。AirUI 的输入组件本身不提供语音转文字；airui 生态里的语音能力是 TTS（文本转语音），方向正好相反。所以这件事的瓶颈在服务端：要处理音频格式、分片上传、识别接口调用与结果回填，小程序做不了这套链路。处理步骤：① 先确认是「要识别文字」还是「只要录音回传」；② 只要录音，用 audio 相关接口录完直接上传；③ 要识别就在服务器侧对接第三方 ASR，设备端只负责采集与上传；④ 注意上行带宽与流量成本，长语音要分片；⑤ 交互上给用户明确的「录音中/识别中」反馈，避免以为没反应。参考文档：https://docs.openluat.com/osapi/core/airui/、https://docs.openluat.com/ai/airmaster/

25. 模拟器和真机运行效果不一样怎么办？

解答： 结论：模拟器与真机不一致，绝大多数情况是模拟器版本旧了——它跑的是 PC 平台的 LuatOS，库的支持范围落后于模组固件。说明：PC 模拟器是为了让你在电脑上快速调逻辑，不是真机行为的等价物。新加的接口、硬件相关的接口在模拟器上要么不存在，要么是空实现，于是同一个脚本在模拟器上正常、在真机上报错，或者反过来。官方大约一两周更新一次模拟器，遇到「新接口模拟器里没有」基本只能等更新或自己编译。处理步骤：① 先看模拟器版本，升级到最新；② 涉及外设（GPIO、UART、LCD、音频）的代码一律在真机验证，不要以模拟器为准；③ 需要最新库能力时，可以按官方方式克隆 LuatOS 仓库自行编译模拟器；④ 报错时先分辨是「接口不存在」还是「参数不对」，前者多半是版本问题；⑤ 团队协作时固定模拟器版本，避免各人环境不同互相甩锅。参考文档：https://docs.openluat.com/common/Luatools/

26. 退出界面后解码图片如何清空内存？图片解码缓存释放不干净导致内存不足、硬解码崩溃怎么办？

解答： 结论：硬解码有一块约 4MB 的固定缓存池，退出界面不会销毁，缓存满了才淘汰；Lua 侧没有可靠的「立即清空」接口，只能从页面管理上规避。说明：图片硬解走的是预分配的缓存池，控件 destroy 只是减少引用计数，并不会把解码缓冲还给系统。所以反复进出图片页，池子会逐步被占满，一旦没有可淘汰的块就会分配失败，表现出来就是内存不足或硬解崩溃。正确的优化方向不是「清缓存」，而是「少产生新的大图解码」——用 exwin 统一管理页面生命周期，底图用 .bin 流式数据。处理步骤：① 页面统一交给 exwin 管理，保证退出时控件真正销毁；② 大图改成 .bin 流式读取，避免整图解码；③ 图片尺寸按屏幕实际分辨率预缩放，不要解出远超屏幕的大图；④ 反复进出页面做压力测试，记录可用内存曲线；⑤ 仍崩溃就把完整日志（含内存打印）交给 FAE，按具体分配点定位。参考文档：https://docs.openluat.com/osapi/ext/exwin/、https://docs.openluat.com/osapi/core/airui/

27. 用Codebuddy打开工程显示波浪线，是因为内核函数，有什么办法？

解答： 尚未解答

28. Air8000W用lbsloc2做基站定位会报模组死机；打开WiFi最新固件是否还需要打开GPIO23电源开关？电信卡不能联网、WiFi扫描没反应、airlibs demo报错等问题如何排查？

解答： 结论：这堆现象要拆成三件事分别看——lbsloc2 死机先查串口/485 干扰，定位不准是选错了库，电信卡不联网先换卡验证。说明：lbsloc2 是免费的单基站定位接口，只有基站定位、没有 WiFi 定位，所以「定位偏差大」不是故障而是能力边界；需要基站 + WiFi 混合定位要用付费的 airlbs，并且必须换成自己的 key 与 id。死机这类问题常见诱因是外围 485 收发器把 UART 拉在中间态，或 RX 被外部拉住；WiFi 使能脚在部分型号上是 GPIO23，换固件后要先确认这个开关是否需要手动打开。处理步骤：① 让 UART1 悬空、RX 不接地，先排除 485 干扰再复现；② 核对用的是哪个库：免费 lbsloc2 还是付费 airlbs（后者要填自己的 key/id）；③ 确认 WiFi 使能脚（GPIO23 一类）状态是否正确；④ 电信卡问题先换移动/联通卡对比，能联网说明是卡侧限制；⑤ 复现前清空 Luatools 日志，抓一份从开机到异常的完整日志提交。参考文档：https://docs.openluat.com/osapi/ext/lbsLoc2/、https://docs.openluat.com/osapi/ext/airlbs/

29. 1780HV模块没有AirLink？能否用780EHV固件？

解答： 结论：可以用 Air780EHV 的固件——Air1780HV 与 Air780EHV 除 SIM 卡和天线管脚变成 NC 外，其余完全一样，文档也直接参考 780EHV。说明：Air1780 系列是「MCU 化」的版本，砍掉了与 4G 联网相关的管脚（SIM1/SIM2、天线），只保留主控与音频等能力，所以它跑不了 4G 联网，但内核与 780EHV 是同一套，固件可以通用。AirLink 属于固件里的通信能力，随 780EHV 固件一起提供，不需要额外「有没有 AirLink」的选项——真正要确认的是你的板子把 AirLink 用的 SPI/UART 管脚引出来了没有。处理步骤：① 确认手上的 1780HV 是「仅 MCU + 音频」用法，不要指望联网；② 直接用 1780HV 的固件页下载，或按 780EHV 同版本固件刷；③ 用 AirLink 前先核对你板上的 SPI/UART 管脚是否已引出并做电平匹配；④ 主从两侧固件版本尽量对齐，避免协议差异；⑤ 若遇到链路超时，优先查走线与地回流，再看是否需要升级固件。参考文档：https://docs.openluat.com/air1780/product/

30. eSIM贴片卡查询CPIN返回+CME ERROR: 10，稳定复现，是否SIM接触不良？

解答： 尚未解答

31. 直接买780模组把硬件音频接口引出来，能否实现把SIP桥接到VoLTE或本地音频接口？

解答： 尚未解答

32. 8783H板子上的按键和LED对应的引脚标号是多少？

解答： 结论：文档给出的状态灯控制信号是 GPIO24；按键的具体引脚标号文档没有列表，以原理图和丝印为准。说明：Air8783 的电路说明里明确写了「LED 状态灯控制信号是 GPIO24」，插 USB 后红灯点亮表示供电正常。按键（BOOT/复位一类）在文档里没有单独列引脚号，这类信息随硬件版本变化，直接照抄某个 GPIO 编号风险很大，正确做法是对着原理图或板上的丝印确认。处理步骤：① 打开 Air8783 的电路与使用说明页，先拿 LED 的 GPIO24；② 按键引脚查原理图对应网络名（KEY/BOOT/RESET）；③ 用万用表或短接法确认按下时电平变化，再写代码；④ 写完后用 gpio 读取实测，不要凭推测；⑤ 拿不准就把板子丝印拍照问 ai.luatos.com 或 FAE 确认。参考文档：https://docs.openluat.com/air8783/hardware/circuit/、https://docs.openluat.com/air8783/

33. 接通手机来电、SIP未接通时，voip.playTTS(text,{target="cc"})直接返回not_running，能否改成SIP不通话也能向手机播报TTS？

解答： 尚未解答

34. 有8201G套装底板的PCB资料或Gerber可以参考吗？底板BTB没通。

解答： 尚未解答

35. Air780EPM在部分SIM卡上鉴权失败、无法注网，2055临时固件可用但能否量产？

解答： 结论：这是 SDK 在读「本机号码」时切换 DF_TELECOM 目录引发的时序问题，临时固件能绕过但不能量产，要等正式 patch。说明：部分 SIM 卡在鉴权消息到达的同一时刻，卡内部还在做目录切换，此时返回 6985（条件不满足），主叫侧看到的就是鉴权失败、无法注网。临时固件把「读本机号码」这一步屏蔽掉，所以能正常注网，但这只是绕过触发点，没有修掉目录切换的时序竞争，因此官方明确说不能用于量产。处理步骤：① 用临时固件（如 2055 版本）复现验证，确认注网恢复正常，证明判断方向正确；② 记录出问题的卡商、卡类型与失败比例，作为 patch 的输入；③ 量产固件等官方正式修复版本，不要用临时版出货；④ 过渡期可以在应用层做「注网失败自动重试 + 复位」兜底；⑤ 每批卡来料抽样做注网验证，及早发现异常卡。参考文档：https://docs.openluat.com/air780epm/luatos/firmware/780epm_version/、https://docs.openluat.com/air780epm/luatos/app/base/errdump/errdump_780epm/

36. 合宙云盘pan.air32.cn怎么登录？

解答： 结论：用给定的公共账号登录 pan.air32.cn，上传后把文件名贴在已提交的 issue 下面，方便工程师按名字取文件。说明：这是合宙给客户传日志、抓包、工程文件用的临时云盘，不走邮件也不走聊天工具，好处是文件不会过期丢失，工程师能直接按 issue 里的文件名定位。关键动作是「先有 issue，再传文件」——没有 issue 编号，工程师不知道该把文件对应到哪个问题，等于白传。处理步骤：① 先在对应仓库提 issue，写清现象、型号、固件版本；② 用给定账号登录云盘；③ 新建目录（建议用 issue 编号命名）并上传；④ 回到 issue，把文件名（含目录）写在回复里；⑤ 文件较大时先压缩，日志尽量保留完整原始文件不要截断。参考文档：https://pan.air32.cn、https://docs.openluat.com/common/howtouselog/

37. Air8000最新固件还有问题，10月13日之后还有更新吗？

解答： 结论：V2054（2026-10-13）是当前公开的最新正式版本；之后确实有临时固件，但明确不可量产，要等新版正式上线。说明：固件页上列的版本是「可对外发布」的，临时版本用来验证具体问题，通常只针对某个固件号修一个点，没有经过完整回归，所以官方口径是不能拿去量产。遇到问题正确姿势是「提 issue + 上传完整日志」，让工程师判断是已知问题还是新问题，而不是自己到处找临时包刷。处理步骤：① 在固件页确认当前公开最新版本号；② 手上设备刷到 V2054 复测问题是否还在；③ 仍在就提 issue，附型号、固件号、复现步骤与完整 Luatools 日志；④ 需要临时固件时由 FAE 按 issue 提供，不要用来源不明的包；⑤ 量产排期以正式版发布为准，不要把临时版写进 BOM。参考文档：https://docs.openluat.com/air8000/luatos/firmware/、https://docs.openluat.com/common/howtouselog/

38. 香港是否支持？换了几张运营商卡都不行。

解答： 尚未解答

39. 开发板突然识别不出来、长按开机键也不行，卡过期有影响吗？

解答： 结论：先查供电选择开关的位置，再长按开机键；卡过期一般不影响烧录，不要把两件事混在一起。说明：开发板上通常有「USB 供电 / 电池供电 / 外部供电」的选择开关，位置不对时模组根本没上电，电脑自然识别不到设备。另外部分板子的 PWRKEY 需要拉低保持 1 秒以上才算有效开机，只点一下会停在上电半途。SIM 卡过期影响的是注网与流量，不影响 USB 下载与烧录。处理步骤：① 确认供电选择开关在正确档位；② 用 Type-C 口直连电脑，换一根确认能传数据的线；③ 长按开机键 1 秒以上，观察指示灯；④ 打开设备管理器看是否出现串口/下载端口；⑤ 仍无反应就上强制 BOOT（拉高 USB_BOOT 或按住 BOOT 再复位）进下载模式。参考文档：https://docs.openluat.com/common/Luatools/、https://docs.openluat.com/air780epm/luatos/hardware/design/poweron/

40. MQTT一直连接不上是什么原因？芯片是Air780EGT。

解答： 尚未解答

41. 8603插入U盘，Host正常但没有MSC，GPIO12软件上拉不低、Host零枚举，怎么解决？

解答： 尚未解答

42. AI做的UI数据如何映射？数据格式是AI定义还是可以自己定义？

解答： 结论：可以通过串口用 Modbus 协议把 AI 界面上的数据映射到设备；数据格式由你自己定义，不是 AI 强制规定的。说明：AI 生成的是界面（AirUI）与交互逻辑，界面上的「数据」本质是变量。这些变量怎么和设备侧对应，取决于你和设备之间的通信约定——用 Modbus 就把界面控件绑定到寄存器地址，用自定义协议就定义帧格式。官方 demo 里有 Modbus TCP 主站的完整示例，可以直接作为对接模板。处理步骤：① 先把界面上的数据点列成表（名称、类型、读写、取值范围）；② 定通信方式（Modbus RTU/TCP 或自定义）与地址映射；③ 把需求连同这张表一起交给 AI 生成界面代码；④ 设备侧按同一张表实现寄存器，双方对齐后再联调；⑤ 联调时先单点读写验证，再批量刷界面，避免一次全错难定位。参考文档：https://docs.openluat.com/air8000/luatos/app/modbus/modbus_TCP_master/、https://docs.openluat.com/osapi/core/airui/

43. USB HOST模式下读取U盘内容的demo有吗？

解答： 结论：有现成 demo，在 LuatOS 仓库的 olddemo/demo/usb/main.lua，演示 USB Host 下枚举与读写 U 盘。说明：这个 demo 覆盖的是 USB Host 的基本流程：初始化 Host、等待设备插入、枚举、挂载文件系统、列目录与读写文件。实际用起来最常见的坑不是代码，而是硬件——供电不足、D+/D- 走线、VBUS 使能脚没打开，都会表现为「零枚举」。另外不同型号的 USB 只支持 Host 或只支持 Device，选型时要先确认。处理步骤：① 先确认目标型号的 USB 口支持 Host 模式；② 把 demo 拷进工程跑通枚举；③ 确认 VBUS 供电使能（部分板子需要 GPIO 控制）；④ 插 U 盘后看是否挂载成功，再测文件读写；⑤ 枚举失败时先量 D+/D- 电平与 VBUS，再怀疑代码。参考文档：https://gitee.com/openLuat/LuatOS/blob/master/olddemo/demo/usb/main.lua

44. 出厂固件播放视频两轮就出现界面无法操作，需要重新上电，是否要刷新固件？

解答： 尚未解答

45. Air780EGP日志提示NAS Event 6 Reject 19，注册被拒绝，但运营商说卡没欠费没锁卡，是什么原因？

解答： 结论：NAS Event 6 Reject 19 是网络侧拒绝注册，不是模组故障——优先按「卡/套餐/机卡绑定」方向查，而不是天线。说明：这个日志表示附着请求被网络拒绝，常见原因包括卡状态异常（欠费、停机、未实名）、机卡绑定不匹配、该卡所在运营商在你的位置没有可用频段，或是卡本身是定向卡/物联网专用卡被限制。运营商口头说「没欠费没锁卡」并不等于后台没有策略限制，最有效的验证是换一张自己手机上的卡。处理步骤：① 换一张确认能正常上网的手机卡插同一台设备，能注网说明问题在原来的卡；② 用原卡插手机试，手机也不能上网就找卡商核卡状态；③ 核对 APN 是否与卡匹配；④ 检查设备的 IMEI 是否被机卡绑定策略拒绝；⑤ 都正常仍被拒，把完整日志提交给 FAE 分析拒绝原因码。参考文档：https://docs.openluat.com/air780epm/luatos/firmware/780epm_version/、https://docs.openluat.com/common/howtouselog/

46. Air780EHU是否支持哈萨克斯坦？

解答： 结论：Air780EHU 是欧亚版，覆盖中亚地区常用频段，理论上可用于哈萨克斯坦；但合宙只过 CE/FCC，没有当地运营商认证，必须自行场测。说明：海外能不能用，不能只看「某个频段相同」，要看目标运营商支持的全部频段是否都被模组覆盖——因为同一运营商不同基站开放的频段不一样，只覆盖其中一部分就会出现「有的地方能连、有的地方连不上」。文档也明确写了：海外型号只过了 CE 和 FCC，没有当地运营商认证，也没有实地场测，批量发货前必须自己测。处理步骤：① 查清目标运营商的完整频段清单；② 对照 Air780EHU 的频段表逐条核对是否全覆盖；③ 不能全覆盖就换型号或换运营商；④ 批量前做实地场测（不同城区、室内外）；⑤ APN 与卡侧开通由卡商确认，模组侧只能保证频段匹配。参考文档：https://docs.openluat.com/air780ehnehu/product/air780ehnfreq/、https://docs.openluat.com/air780ehnehu/product/air780ehufreq/

47. 780EX2T-3.3V和780EX-3.3V基带芯片型号是什么？原理图用什么软件打开？

解答： 结论：Air780EX2T-3.3V 的基带是 EC718，Air780EX-3.3V 的基带是 EC618；原理图用 PADS 打开。说明：这两个型号外观和封装接近，但主控平台不同代——718 平台性能与接口能力更强，618 是老平台，固件与开发方式也分属两套，选型时不能混。原理图是 PADS 出图，用 AD 直接打开会报错，需要按 PADS 的格式打开或先导出再转换。处理步骤：① 按型号到对应产品的硬件资料页下载原理图；② 用 PADS 打开，不要用 AD 硬开；③ 选型时确认主控平台，因为 718 与 618 的固件不通用；④ 需要转 AD 时先在 PADS 导出再导入，并核对封装；⑤ 投产前用官方 PDF 原理图复核。参考文档：https://docs.openluat.com/air780ehnehu/product/air780exx/、https://docs.openluat.com/SelectionGuide/SelectionGuide/

48. 1603 AirLink可以同时支持外挂WiFi和4G吗（一个SPI一个UART）？

解答： 结论：不行，同一时间只能有一路 AirLink 联网；要切换只能硬切换，而且需要重启，实际意义不大。说明：Air1603 的联网资源是外挂式的，WiFi 与 4G 共用有限的接口与电源，官方按 W1~W5（WiFi）与 M1~M5（4G）划分组合，每种组合对应一套硬件配置。所以「一个 SPI 一个 UART」看起来能并行，实际受限于平台的资源分配与软件配置，同一块板只能选一种联网方式；即使硬切换，也要重新初始化链路并重启，切换成本高于收益。处理步骤：① 先确定产品主要联网方式（固定场所用 WiFi、移动作业用 4G）；② 按主力方式选 8603 的对应型号；③ 确实需要两种场景，做两块板或做可插拔的联网子板；④ 不要试图在运行时热切换，稳定性与调试成本都不划算；⑤ 若业务要求「双通道冗余」，应换成同时具备两种链路的型号或加一路独立网关。参考文档：https://docs.openluat.com/air1603/、https://docs.openluat.com/air8603/

49. Air1603W预计什么时候上架，有资料吗？

解答： 结论：暂时不会上架 Air1603W 模组，官方的优先级是先做 Air8607W 整机板，模组形态暂不推出。说明：产品节奏上，合宙这一代先以「整机/最小系统板」交付，屏幕、触摸、音频这些配套一起给，客户拿到就能跑；模组形态要解决裸片供货、参考设计与客户自己适配屏的问题，节奏会慢一些。所以短期内要 1603 平台 + WiFi，应该看 Air8603 的 W 系列，而不是等 1603W 模组。处理步骤：① 明确要的是模组还是整机板；② 要整机板就等/选 Air8607W；③ 要 WiFi 联网能力就看 Air8603 的 W1~W5；④ 项目排期不要挂在未发布型号上，按现有型号做设计；⑤ 有新进展以官网选型页和公告为准。参考文档：https://docs.openluat.com/air8603/、https://docs.openluat.com/air8607/product/、https://docs.openluat.com/SelectionGuide/SelectionGuide/

50. AirBurnUSB下载/打印无反应，正常主板接上AirBurnUSB就无法识别，11个都一样，怎么解决？

解答： 结论：按固定顺序操作基本能解决——先把开机键拨到 ON、关掉电脑蓝牙、AirBurnUSB 拨到下载、Luatools 点下载、最后插 AirBurnUSB。说明：AirBurnUSB 是 USB 转串口的下载小板，识别不出来的原因多数是「插得太早」或「电脑上有干扰」。先开软件再插板，可以让 Luatools 在枚举瞬间就抓到端口；电脑蓝牙在某些机器上会和 2.4G/USB 抢资源，导致串口枚举失败。11 块板全一样，基本可以排除单板硬件问题，重点在操作顺序与电脑环境。处理步骤：① 开机键拨到 ON；② 关闭电脑蓝牙；③ AirBurnUSB 上的开关拨到下载档；④ 打开 Luatools 选好固件并点击「下载」；⑤ 此时再插入 AirBurnUSB，观察是否出现端口并开始下载；⑥ 仍失败就换一根能传数据的 USB 线、换一个 USB 口（优先主板后置口）、换一台电脑验证。参考文档：https://docs.openluat.com/common/Luatools/、https://docs.openluat.com/air8607/software/debug/

51. 8607播放视频每秒几帧？音量在哪里调？

解答： 结论：视频播放默认 15fps，可以通过 VIDEO_FPS 调整；音量在程序里改，满格通常偏大。说明：设备侧播放器是按 HZV（MJPEG + MP3）设计的，帧率是解码与刷屏的综合结果，提高帧率会同时增加解码开销和 LCD 刷屏带宽，超过屏与总线的能力就会掉帧甚至卡死。音量则由音频通路的增益决定，软件音量与硬件功放增益叠加，满格很容易削顶失真。处理步骤：① 先确认当前 VIDEO_FPS 设置；② 按屏的刷新能力逐步上调（如 15 → 20 → 25），每档实测是否掉帧；③ 提高帧率同时降分辨率或降码率，保持总带宽可控；④ 音量在代码里设到 70%~80% 起步，再按实测微调；⑤ 长时间循环播放做压力测试，观察内存与温度。参考文档：https://docs.openluat.com/air1603/luatos/app/multimedia/ui/videoplayer/

52. 用量产烧录工具给国外客户烧录是否有限制？客户在沙特。

解答： 结论：没有限制。用量产工具给国外客户烧录和给国内客户烧录是一回事，工具本身不带地域或数量限制。说明：量产烧录工具做的是「按固件包写 flash + 写序列号/参数」，不联网校验地域，也不限制烧录台数。真正需要注意的是合规层面：产品出口到哪个国家，要按当地要求做认证（CE/FCC 等），这是整机认证问题，和烧录工具无关。处理步骤：① 确认固件与量产工程是给该客户定制的正确版本；② 用官方量产工具生成烧录包，核对校验值；③ 出口前按目标国要求完成认证；④ 交付时把固件版本、校验值写进交付清单，便于追溯；⑤ 客户自行烧录时提供操作文档与工具版本号，避免版本不一致。参考文档：https://docs.openluat.com/common/Luat_productiontool/、https://docs.openluat.com/air780egh/product/renzheng/

53. 780EPM设备MQTT连接正常但接收不到下行消息，联通卡频繁出现，阴雨天气更明显，是否与低功耗模式有关？

解答： 结论：长连接低功耗下模组是能正常收到下行数据的；这个现象更像环境信号波动，联通卡在弱信号下更敏感。说明：MQTT 是长连接，下行消息到达时模组需要被唤醒或在下行窗口内收到，如果信号本身在临界点，就会出现「有时通、有时不通」，阴雨天、金属结构内、地下室这类场景尤其明显。低功耗模式本身不会吞掉已经建立连接上的下行数据，但如果信号差到重连，消息就会丢在重连窗口里。处理步骤：① 用 AT+CSQ 长期记录信号，确认是否长期低于 22；② 信号差就先解决天线位置与外置天线；③ 应用层加心跳与重连，重连后重新订阅并主动拉一次状态；④ 关键指令走「下发 + 设备回执」确认，不要只靠单向下发；⑤ 联通卡与其所在地基站覆盖有关，换移动卡做对比可以快速判断是环境还是卡侧。参考文档：https://docs.openluat.com/air780epm/luatos/hardware/lowpower/、https://docs.openluat.com/common/howtouselog/

54. Air780EPM是否支持网络下发MP3并广播？3万个播放端能否实时播放云端语音输入？

解答： 结论：能不能播 MP3 要先看固件——Air780EPM 的差异表里 audio / tts / codec / i2s 四行都是空的，播音频要走 Air780EHM/EHV 这类带音频的型号；3 万个端实时同步广播不现实。说明：audio 库没编进 780EPM 的固件，所以「网络下发 MP3 然后本地播」这条路在 EPM 上走不通，这不是脚本写法问题，是固件能力边界。至于 3 万个播放端实时播放云端语音，瓶颈在带宽、并发与端侧缓冲，任何「广播」本质上都是各自拉流，做不到严格同步，延迟与卡顿会随并发线性恶化。处理步骤：① 先确认型号是否带 audio 库（查固件页核心库差异表）；② 要播音频就换 EHM/EHV 等带音频的型号，并配 codec + PA；③ 播报类需求优先考虑 TTS 而非整段 MP3，省流量；④ 大规模场景改成「定时拉取 + 本地缓存」，避免同时拉流；⑤ 语音内容提前转码成设备能解的格式，减少端侧解码压力。参考文档：https://docs.openluat.com/air780epm/luatos/firmware/780epm_version/、https://docs.openluat.com/air700ech/luatos/hardware/audio/

55. 1603的TP中断脚是哪个IO？能识别GT911但触摸没反应，7寸1024*600屏触摸不起作用。

解答： 尚未解答

56. AirUI没有滑动条控件吗？以前有LVGL库，现在不支持了吗？780EHM支持吗？

解答： 尚未解答

57. 8607能否换8603M5并补差价？

解答： 结论：能换，Air8603M5 正在生产，可以按补差价的方式换货。说明：M5 是 Air8603 的 4G 版本组合之一，与 8607 同主控（Air1603），区别在于把 4G 联网、以太网、485 等做在板上，所以从「只有大屏音视频」升级到「大屏 + 联网 + 工业接口」是同一个平台的横向升级，软件迁移成本低。换货涉及差价与库存，具体金额和交期要找对接的销售确认，不要按网上价格自行折算。处理步骤：① 确认需要的具体型号（M1~M5 的接口组合不同）；② 联系销售确认可换型号、差价与交期；③ 换货前把现有工程备份，确认脚本里没有依赖 8607 专属的管脚配置；④ 收到新板后按 8603 的管脚表重新配置外设；⑤ 联调通过后再安排批量。参考文档：https://docs.openluat.com/air8603/

58. 有比8603更好的型号吗？

解答： 结论：目前在售的大屏联网方案里 Air8603 是最强的；更强的型号还在研发中，没有可交付的时间点。说明：Air8603 基于 Air1603，把触屏、声音、联网（WiFi 或 4G）、摄像头与外设控制集中在一块主板上，按人脸识别、隔离/非隔离 485 与 TTL 串口需求分了 10 个型号，覆盖快递柜、寄存柜、门禁、自助终端等场景。再往上就是平台换代，属于在研阶段，不适合挂到量产排期上。处理步骤：① 先把需求拆成「屏 + 声音 + 联网 + 接口 + 摄像头」五项；② 按这五项在 8603 的型号表里选最贴近的；③ 现有型号满足不了就先做方案折中（外挂、双板），不要等未发布型号；④ 项目立项时把选型结论写进文档，避免后期反复；⑤ 关注官网选型页的更新。参考文档：https://docs.openluat.com/air8603/、https://docs.openluat.com/SelectionGuide/SelectionGuide/

59. 8607串口烧录连接不上、设备管理器没有串口、下载超时怎么办？

解答： 结论：先解决驱动与线缆——装 CH343/CH347 驱动、用能传数据的 USB 线、选对串口并勾选「通用串口打印」，波特率 6M。说明：Air8607 板载 USB 转串口芯片，电脑上必须先有对应驱动才会出现串口；没有串口时 Luatools 里自然选不到端口，点下载就是超时。另外这类板子的下载串口波特率较高（6M），劣质线缆或 USB HUB 很容易在高速下丢包。「通用串口打印」不勾选时，日志不出来也容易被误判成「没连上」。处理步骤：① 装 CH343/CH347 驱动并重启电脑；② 打开设备管理器确认出现串口且无黄色感叹号；③ 换一根确认能传数据的线，直插主板后置 USB 口；④ 在 Luatools 里选对应串口，勾选「通用串口打印」，波特率 6M；⑤ 仍超时就按住 BOOT 再复位进下载模式；⑥ 参考官方调试文档与烧录视频逐步对照。参考文档：https://docs.openluat.com/air8607/software/debug/、https://docs.openluat.com/air8607/software/overview/

60. Air780EPM驱动开发串口扩展还有后续吗？

解答： 结论：串口扩展还在推进，只是节奏慢，官方明确不会放弃。说明：Air780EPM 的 UART 资源有限，多路串口扩展要么靠软件模拟，要么靠外挂芯片，两条路都有取舍——软件模拟占用 CPU、时序精度受限；外挂芯片增加成本与布线。这类需求要兼顾稳定性与通用性，验证周期长，所以进展不快。项目上不能把排期压在这上面。处理步骤：① 先算清需要几路串口、各自波特率与实时性要求；② 路数不多优先用现有 UART 分时复用；③ 需要多路且实时性高，考虑外挂串口扩展芯片（SPI/I2C 转 UART）；④ 关注官方更新，但排期上准备替代方案；⑤ 过渡方案要写进设计文档，避免后续切换成本失控。参考文档：https://docs.openluat.com/air780epm/luatos/firmware/780epm_version/

61. 8602工厂有俩不识别SIM卡，能否抓日志？

解答： 结论：先抓日志，别先换板——工厂侧历史上出现过「卡过期」导致的同类问题，目前已加 4G 信号与 SIM 卡测试环节。说明：SIM 卡不识别分两类：卡侧（过期、氧化、未实名、卡座接触不良）与模组侧（供电、时序、卡检测脚）。卡过期在部分批次上表现为完全读不到卡，很容易被误判成硬件故障。工厂加了信号与卡测试后，新批次的来料问题会少很多，剩下两台建议先抓完整日志再判断。处理步骤：① 换一张已知正常的卡插同一台设备，能识别说明是卡的问题；② 清洁卡座与卡的金手指，重新插拔；③ 用 Luatools 抓从开机到读卡的完整日志；④ 对比正常板与异常板的日志差异，定位是供电还是命令无响应；⑤ 日志仍无法判断就按售后流程返修，不要在现场反复拆装。参考文档：https://docs.openluat.com/air8602/product/、https://docs.openluat.com/common/howtouselog/

62. IOT平台改绑手机号怎么处理？

解答： 结论：需要填写 IoT 账号变更表格，签字并盖章后发给对接人，由平台侧人工变更。说明：账号绑定的手机号是设备归属与找回凭证，属于敏感信息，平台不提供自助改绑，必须走书面申请，确保是企业真实意愿，避免账号被恶意转移。表格需要加盖公章，个人开发者按对接人要求提供等效证明。处理步骤：① 向对接人索取「IoT 账号变更表格」；② 按表格填写账号、原手机号、新手机号与变更原因；③ 签字并加盖公章，扫描成 PDF；④ 发给对接人并确认收到；⑤ 变更完成后用新手机号登录验证，同时检查该账号下设备是否仍在线、告警是否正常。参考文档：https://docs.openluat.com/SelectionGuide/SelectionGuide/

63. Air780EG2使用无源天线没有信号，切板载无源天线不行，是什么原因？

解答： 结论：无源天线没信号，先排除位置与环境，再谈天线本身——无源天线的增益和抗干扰能力天生不如有源，这是物理差距。说明：GNSS 信号到达地面时已经很弱，无源天线没有 LNA 放大，线损和干扰都会直接吃掉信噪比。室内、金属桌面、键盘旁、屏背面都会显著恶化；把天线放在键盘上更是典型的「自找干扰」。屏蔽层焊在模块屏蔽壳上一般不影响性能，反而有助于接地。处理步骤：① 拿到室外空旷处再测；② 远离屏幕、金属、键盘、电源等干扰源；③ 确认天线馈线尽量短、接头可靠；④ 需要更好性能就换有源天线（带 LNA），并确认模块的馈电是否支持；⑤ 仍不行就按天线选型文档联系天线厂做匹配。参考文档：https://docs.openluat.com/air780egh/luatos/app/gnss/gnss_test/、https://docs.openluat.com/air780epm/luatos/hardware/design/antenna/

64. 用自己的屏幕调试是否需要更换底层触控和显示驱动？

解答： 结论：取决于屏的型号与接口——用官方配套屏可以直接上手调试；自己采购的屏通常要适配触摸与显示驱动。说明：显示部分要匹配 LCD 驱动 IC（如 st7701sn、hx8282、nv3052c 等 RGB 接口 IC）与分辨率、时序；触摸部分要匹配触摸 IC（gt911、cst820、ft3x68 等）与 I2C 地址、复位/中断脚。两者只要有一项对不上，就会出现黑屏、花屏或触摸无反应。官方配套屏已经把这套参数写进出厂固件配置，所以接上就能用。处理步骤：① 拿到屏的规格书，确认驱动 IC、分辨率、接口类型、触摸 IC；② 对照 lcd 与 tp 库的已支持清单判断是否需要自己写驱动；③ 需要适配时先调显示（时序、颜色格式），再调触摸（地址、复位、中断）；④ 用最简单的测试脚本逐项验证；⑤ 自己搞不定就把型号与规格书发给合宙协助适配。参考文档：https://docs.openluat.com/osapi/core/lcd/、https://docs.openluat.com/osapi/core/tp/

65. 同一批主板用Luatools能正常下载固件，用量产工具就不行，是什么原因？

解答： 结论：量产工具版本太低。新版固件/新芯片的下载协议有变化，旧版量产工具不认，所以 Luatools 能下、量产工具不行。说明：Luatools 是开发调试工具，更新频繁；量产工具是独立分支，版本迭代慢一些。当固件用了新的下载流程或新的 flash 参数时，旧版量产工具会因为协议或配置不认识而失败，表现就是「同一批板子、同一根线，Luatools 成功、量产工具失败」。处理步骤：① 记录 Luatools 与量产工具的版本号；② 到下载页取最新版量产工具覆盖安装；③ 用同一批板子重试，确认能正常烧录；④ 若仍失败，核对量产工程里选的固件号与芯片型号是否匹配；⑤ 交付客户时把工具版本号一起写进文档，避免客户用旧版。参考文档：https://docs.openluat.com/common/Luat_productiontool/

66. 模块下载不了程序，售后检测正常，主板也排查过，怎么处理？

解答： 结论：售后复测模块的烧录与校准都正常，说明模块本身没问题，重点回到主板与烧录操作上。说明：模块能烧录、能校准，就证明 flash、供电与下载通路在标准环境下是好的。现场下载不了，常见原因是底板供电不足（尤其是带屏、带功放的板子）、USB 线只供电不传数据、USB_BOOT/BOOT 按键电路有问题，或烧录时外设抢占了下载串口。处理步骤：① 把模块单独插到官方开发板或最小系统上试烧，验证模块；② 在底板上量 VBAT 在下载瞬间是否掉压；③ 检查 USB 数据线是否完好、是否有 HUB；④ 断开底板上的其它外设（屏、功放、485）再烧；⑤ 仍不行就抓烧录时的串口输出，看卡在哪一步，再交 FAE 分析。参考文档：https://docs.openluat.com/common/Luatools/、https://docs.openluat.com/common/Luat_productiontool/

67. 在TRAE导入合宙智能体后提示MCP服务器不可用，是什么情况？

解答： 结论：这是 MCP 服务器地址配错了，按文档改成本地/官方地址后即可恢复。说明：在 TRAE 里导入合宙智能体时，智能体依赖一个 MCP 服务来检索合宙文档。如果配置里写的是旧地址、示例占位地址，或者端口被占用，就会报「MCP 服务器不可用」，此时智能体能启动但查不到任何文档，回答全靠模型自己编。处理步骤：① 打开 TRAE 的 MCP 配置，找到合宙文档服务的条目；② 对照文档把启动命令与地址改成正确的；③ 保存后重启 TRAE；④ 在对话里问一个具体的接口名，验证能否返回真实文档内容；⑤ 仍不可用就检查本机是否装了对应运行时（Node/Python）与网络是否通。参考文档：https://docs.openluat.com/ai/mcp_cli/、https://docs.openluat.com/ai/

68. 认证机构反馈注册不上，是什么情况？

解答： 结论：合宙侧复测正常，问题更可能出在操作流程或注册方式上——先确认是否按认证要求手动注册过。说明：认证时「注册不上」有两种含义：一是设备没有注网（网络侧拒绝），二是设备的物联网平台注册失败（账号/设备未录入）。两种排查路径完全不同。合宙这边跑的时候正常，说明固件与硬件本身没问题，差异往往在测试环境（当地基站、卡）、认证固件的选择、或平台侧的设备录入状态。处理步骤：① 明确是「注网失败」还是「平台注册失败」；② 注网失败就抓日志看拒绝原因码，并换卡对比；③ 平台注册失败就核对设备 IMEI 是否已在平台录入、协议与地址是否正确；④ 确认用的是对应认证固件（按平台分组）；⑤ 仍无法复现就把完整日志与操作步骤提供给 FAE 一起过一遍。参考文档：https://docs.openluat.com/air780egh/product/renzheng/、https://docs.openluat.com/common/howtouselog/

69. 780EPM模组底部是否允许走线？信号线要不要避开天线？

解答： 结论：模组底部可以走线，但要避开天线区域、电源管脚和高速时钟线，否则会直接影响射频与稳定性。说明：模组底面的走线主要风险是耦合——天线正下方走线会破坏天线的净空与阻抗匹配，电源管脚附近走信号线容易引入纹波与地弹，高速时钟（SPI、USB、LCD 时钟）则会向外辐射干扰接收灵敏度。另外走线还会影响模组与主板之间的地平面连续性。处理步骤：① 先按硬件设计手册标出天线净空区，区域内一律不走线、不铺铜；② 电源管脚正下方只走地或加宽电源；③ 高速信号线尽量远离天线与电源区，必要时加地线包围；④ 打样后实测接收灵敏度与驻波，与不走线的版本对比；⑤ 有异常优先怀疑走线耦合，用飞线/割线做对照实验确认。参考文档：https://docs.openluat.com/air780epm/luatos/hardware/design/antenna/、https://docs.openluat.com/air780epm/luatos/hardware/design/poweron/

70. Air8000W做SIP↔CC纯PCM桥接，拨打SIM号码接通前几秒有杂音和断续，rx_lost增长，如何定位？

解答： 结论：这类「接通前几秒杂音 + 断续 + rx_lost 增长」必须靠完整日志定位，先按标准流程抓日志再判断，不要先改代码。说明：rx_lost 增长说明接收侧在丢帧，可能是 PCM 启动时序没对齐（通话建立瞬间缓冲区还没填满）、采样率转换不匹配、预缓存太小，或缺帧处理策略过于激进。这些都要看时间轴上的日志才能分辨——光看现象容易被误判成「网络差」。处理步骤：① 按日志规范准备材料：脱敏脚本、固件版本、同步日志、异常录音；② 复现时清空日志从开机抓；③ 标记通话建立的时间点，对照 PCM 启动、重采样、预缓存相关打印；④ 观察 rx_lost 的增长节奏是否与杂音同步；⑤ 把材料提交给工程师，按结论调整缓冲或采样参数后再验证。参考文档：https://docs.openluat.com/common/howtouselog/、https://docs.openluat.com/air8000/luatos/app/mulu/mobile/

71. 780EPM内部有没有API可以监测模块是休眠唤醒还是重启（断电重启、按键reset、看门狗超时等）？

解答： 尚未解答

72. 780EHU不支持B34和B39，成都移动物联网卡有时注册成功有时失败，是否与缺少频段有关？

解答： 尚未解答

73. 升级硬件时为什么限制10分钟只能一次？IMEI管理平台支持子账号或API查看设备在线和固件版本吗？

解答： 结论：10 分钟一次的限制是为服务器减负；子账号和 API 目前都不支持，IMEI 管理后台主要用于查设备归属和 FOTA 升级。说明：固件升级请求会触发服务器侧的打包与分发，短时间高频请求会把资源占满，所以做了频率限制。IMEI 管理后台的定位是「设备台账 + 升级」，不是完整的设备管理平台，因此没有多用户体系和开放接口；需要自动化查询设备在线状态与固件版本，现阶段只能人工在后台看，或走客户自己的业务平台上报。处理步骤：① 升级操作按 10 分钟节奏排队，批量升级分批推；② 需要多人协作就共用一个账号并约定操作规范；③ 需要自动化能力，先在业务侧让设备主动上报版本与在线状态；④ 把子账号/API 需求反馈给对接人，作为后续评估输入；⑤ 关键设备升级前先小批灰度，确认成功率再全量。参考文档：https://docs.openluat.com/SelectionGuide/SelectionGuide/

74. Air1603的Demo原理图和PCB有吗？1603开发板触摸是GT911，能否直接用？

解答： 尚未解答

75. Air780EHU的模组是否支持哈萨克斯坦等海外地区？

解答： 结论：Air780EHU 是欧亚版，覆盖中亚常用频段，理论上支持哈萨克斯坦；但合宙只过 CE/FCC，没有当地运营商认证，须自行场测。说明：判断海外能不能用，不能只看「有一个频段相同」，要确认目标运营商开放的全部频段都被模组覆盖——同一运营商不同基站开放的频段不一样，只覆盖一部分就会出现「有的地方能连、有的地方连不上」。文档也明确说明：海外型号只过 CE 和 FCC，没有所在地的运营商认证，也没有实地场测。处理步骤：① 查清目标运营商（Beeline/Kcell/Tele2 等）的完整频段清单；② 对照 Air780EHU 频段表逐条核对；③ 不能全覆盖就换型号或换运营商；④ 批量前在不同城区做实地场测；⑤ APN 与卡侧开通由卡商确认，模组侧只保证频段匹配。参考文档：https://docs.openluat.com/air780ehnehu/product/air780ehufreq/、https://docs.openluat.com/air780ehnehu/product/air780ehnfreq/