常见问题 - 2026-11-03

数据日期：2026-11-03

1. Air8783 RNDIS + 短信转发（本地短信配置版）的完整Lua源码是否公开？文档两个路径404，能否提供仓库地址或工程ZIP？

解答： 结论：不开源。涉及合规问题，官方已明确不再放出整套可编译工程；文档里指向旧仓库地址的链接会修正到现行页面。说明：Air8783 的短信转发能力本身在出厂固件工程 module/Air8783/project/factory/user 下，也就是 sms_app / sms_bridge / sms_callback 这几个 Lua 文件，这组文件在公开仓库可见。但“RNDIS + 短信转发（本地短信配置版）”这一整套工程属于定制交付内容，牵扯运营商对短信转发的合规要求，因此不公开。所以按原链接去找必然 404，这不是没登录 gitee 导致的。处理步骤：① 只是要验证功能，直接烧 Air8783 出厂固件，按《Air8783 短信转发本地配置使用说明》填写转发目标与短信指令；② 需要二次开发，向对接的 FAE 申请对应工程或定制固件；③ 如果只用转发、不改逻辑，不需要源码，出厂固件已经包含。参考文档：https://docs.openluat.com/air8783/product/config/

2. Air8607 时间不对、WiFi连接/网络设置在哪里设置？

解答： 结论：Air8607 的时间由 4G 网络自动校时，不需要手动设置；WiFi 只在 Air8607W 上有射频，SSID/密码要写在应用脚本或设备设置里，不是在 Luatools 里配。说明：8607/8607A 是 Air1603 主控的大屏方案，本身只有 4G 联网能力；8607W 才带 WiFi 芯片与天线支路，硬件上就多了这一路。时间不对，通常是没有注网成功、或联网后没等自动对时完成。另外模组给的是 UTC 时间，本地时间（东八区）要在脚本里自己加偏移，这一点和“时间不准”很容易混。处理步骤：① 先确认 4G 已注册、数据业务可用，再等自动对时；② 仍偏差就在脚本里读时间并按东八区补偿；③ 如果是 8607W，先按 8607W 的硬件说明接好 WiFi 天线，再在脚本里配 SSID/密码；④ 不要在 Luatools 的工具选项里找 WiFi 设置项，那里没有。参考文档：https://docs.openluat.com/air8607/product/

3. Air780EPM的PWRKEY直接接地设计是否可行？上电瞬间VEXT从1.8V跳变到3.3V、USB无法识别是什么原因？

解答： 尚未解答

4. Air8605/Air8606什么时候上架？想买能接麦克风、做本地语音采集的型号

解答： 结论：按官方答复，8605 计划当晚或次日开卖，有 799 和 899 两款，支持 SIP 语音与人脸识别摄像头；当时 8605/8606 都还没上架，实际时间以官网型号页和淘宝店为准。说明：8605 是 Air1602 + 合宙自研语音芯片的大屏 SIP 方案，8606 是同代的双网口方向，两者都对得上“能接麦克风、做本地语音采集”这个需求。做本地语音采集时，关键不是有没有麦克风接口，而是固件里 audio/录音这组能力有没有编进去、以及有没有 codec 与 PA，选型前要先确认这两点。处理步骤：① 关注 docs.openluat.com 的 8605/8606 页面更新；② 要样机直接找销售确认批次与报价；③ 提前锁定屏参（尺寸、分辨率、触摸 IC）与摄像头型号；④ 打样前用最新资料核对连接器与开孔，避免上架后回头改结构。参考文档：https://docs.openluat.com/air8605/

5. Air8607A是否支持外挂flash或SD卡？

解答： 结论：按官方答复，8607A 目前不支持外挂 flash，8607 这一代只支持 SD 卡；需要扩存储就走 SD 卡，不要指望 SPI Flash。说明：外挂 SPI Flash 需要硬件和固件同时支持——硬件要有空闲 SPI 与片选、固件要带 little_flash/sfud 这类驱动并给出分区与挂载点。8607/8607A 目前的资料里没有这条通路，所以即便焊上去也挂不起来。SD 卡走 fatfs，是官方明确支持的方式，容量也更容易做大。处理步骤：① 先确认手上的板子有没有 SD 卡座；② 有卡座就按 8607 的管脚说明接 SPI 并用 fatfs 挂载；③ 需要更大容量或必须用 SPI Flash，找 FAE 确认是否有定制固件；④ 不要把 little_flash/sfud 的示例直接套到 8607A 上试。参考文档：https://docs.openluat.com/air8607a/

6. 8607W/Air8607W什么时候上淘宝销售？

解答： 结论：按官方答复是“这周末或者下周上架”；实际开卖时间以官网型号页和淘宝店为准，这两个渠道才是准信。说明：Air8607W 是 8607 系列里带 WiFi 射频的版本，硬件上比 8607/8607A 多了一路 WiFi 芯片与天线支路，所以上市节奏会比不带 WiFi 的版本晚一些。上架时间属于商务与生产排期，不在技术文档管辖范围内，文档站只负责把产品资料准备好。处理步骤：① 关注 docs.openluat.com 的 Air8607W 页面，资料齐了通常意味着临近上架；② 要样机直接找销售确认批次，比等页面更新快；③ 提前锁定屏参（尺寸、分辨率、触摸 IC），8607W 与 8607 共用 50pin 屏接口；④ WiFi 天线要预留位置与净空，别等上架后才改板。参考文档：无（属商务事项，请通过购买渠道或对接销售确认）。

7. Air780ER2用几号固件？

解答： 结论：Air780ER2 用 109 号固件。这一号固件是 Air780EPM_ER2/ER3 专用，主要多了 airlink 与 USB 虚拟网卡（RNDIS）能力。说明：109 号不是通用固件，它在固件页的分区表里单列一栏，标题写的就是 Air780EPM_ER2/ER3。所以给 ER2 刷通用号段（比如 1 号、103 号）会出现“能跑但 airlink/RNDIS 用不了”的情况，反过来把 109 号刷到普通 Air780EPM 上也不合适。ER2 与 ER3 的差别在网络侧接口：ER2 走 AirLink over UART，ER3 走 SPI。处理步骤：① 打开 Air780EPM 固件页，找到 109 号那一列；② 按型号取对应 .soc（ER2/ER3 共用 109 号）；③ 用 Luatools 烧录时在项目管理里指定该内核；④ 刷完用 rtos.version() 核对版本，并验证 airlink 能否起来。参考文档：https://docs.openluat.com/air780epm/luatos/firmware/780epm_version/

8. Air780EG2不用SIM卡可以发送信息吗？

解答： 尚未解答

9. Air8783H支持WiFi吗？

解答： 结论：按官方答复，8783H 硬件不支持 WiFi。说明：8783H 是 SIP-CC 纯 PCM 桥接通话方案，默认用 4G 承载 SIP。需要提醒的是，8783H 的 SIP-CC demo 文档里写了“目录中也提供 Wi-Fi STA 驱动，切换前需确认目标硬件和固件支持”——也就是说驱动代码在，但硬件上有没有布 WiFi 芯片、天线与匹配，要按具体板型看，不能只凭代码里能 require 就认定能用。用 WiFi 只改变 SIP 的联网方式，蜂窝通话仍然要 SIM 卡和 VoLTE。处理步骤：① 查手上 8783H 板的原理图，看有没有 WiFi 芯片与天线支路；② 只用 SIP 通话就保持 4G 承载，不必折腾 WiFi；③ 确实需要 WiFi 联网，选带射频的型号（如 Air8000W、8607W）。参考文档：https://docs.openluat.com/air8783h/

10. 8783H软终端能打进但拨不出去，如何注册SIP服务器/设置？

解答： 结论：8783H 只支持 SIP_CC 模式，必须选 SIP-CC 工程并插入已开通语音的 SIM 卡；能打进不能拨出，一般不是 SIP 侧的问题，而是蜂窝侧没有可用的呼出能力。说明：SIP-CC 是“SIP 网络侧 ↔ SIM 卡蜂窝语音”在模组内部用 PCM 做桥接，两条腿都要通：SIP 侧要注册成功，蜂窝侧要能拨号。来电正常说明 SIP 注册和呼入路径是好的，问题集中在 SIM 卡的语音业务、目标号码配置，以及 4G 数据是否可用（走 4G 承载 SIP 时还需要数据业务）。处理步骤：① 确认卡已开通语音与 VoLTE，用手机插这张卡能正常呼出；② 核对 config.lua 里的 SIP 账号、target_phone_number、remote_sip_uri；③ 看日志里 SIP 注册是否为 Y、呼叫失败返回的是 4xx 还是 5xx；④ 换一张手机卡交叉验证，能快速区分是卡的问题还是模组侧的问题。参考文档：https://docs.openluat.com/air8783h/

11. 780EHM是否支持语音对讲？8701和780EHM能否pin对pin？

解答： 结论：Air780EHM 单模组做不出可用的语音对讲——它能播报、能采集，但 VoLTE/SIP 双工通话的回声抑制很弱，只能靠结构上把麦克风和喇叭隔开；要做对讲选 Air8701（Air780EHM + 合宙自研语音芯片）或 Air8784 整机。另外原答里的“8710”在文档站没有这个型号，应为 8701。说明：Air8701 本身就是“Air780EHM + 合宙自研语音芯片”的组合模组，自研语音芯片承担 Audio Codec 与 AEC 回声抑制，文档里也拿 Air8784 举例说明这套组合在 SIP 通话下的回声抑制表现。8701 是模组形态、8784 是整机，两者不是同一类产品；能不能 pin 对 pin 取决于封装与管脚引出，官方没有直接结论，必须按各自管脚资料逐脚比对。处理步骤：① 先确认应用是单向播报还是双向对讲，单向播报用 780EHM 就够；② 双向对讲按 Air8701 或 Air8784 选型；③ 要替换现有 780EHM 设计，先下载 8701 的封装与管脚表逐脚核对；④ 结构上仍要做麦克风与喇叭隔离，AEC 不能替代结构设计。参考文档：https://docs.openluat.com/air8701/

12. Air780EPM/Air780ER2如何作为USB RNDIS网卡给ESP32等主控使用？

解答： 结论：可以。Air780ER2 出厂就是 RNDIS 网卡模式，插上枚举成网卡就能给 ESP32 这类主控转发数据；Air780EPM 需要脚本里把 USB 配成 RNDIS、再打开网卡（需要给下游分 IP 时还要开 NAPT）。说明：RNDIS 是把 4G 模组当 USB 网卡用，主控侧要跑 RNDIS 主机驱动，ESP32 有现成例程可用。模组侧要做三件事：USB 模式选 RNDIS、netdrv 打开对应通道、下游要上网时把 NAPT 绑到这条通道上。主机侧拿到的网关是模组分配的私网地址，具体值用接口查，不要按经验写死。处理步骤：① 用 ER2 直接烧出厂固件试，省掉改脚本这一步；② 用 EPM 就按 RNDIS 页面改 USB 模式与网卡初始化；③ ESP32 侧挂 RNDIS host 驱动并启用 DHCP；④ 需要 ESP32 自己上网再开 NAPT，只做点对点数据传输可以不开。参考文档：https://docs.openluat.com/air780epm/luatos/app/common/rndis/

13. Air8000D下挂T31获取不到IP、WiFi连接AP后无法上网（4G拨号正常），NAPT如何设置？

解答： 结论：按官方建议，先把 4G 摘出去——只用 RNDIS 连接 WiFi，把 napt 设成 wifista 验证通路，再回头查 T31 拿不到 IP 的原因；同时检查“打开网卡”的那段代码是否真的执行到了。说明：Air8000D 这类“4G + WiFi”方案里，T31 挂的是 RNDIS 网卡，实际出网可能是 4G 也可能是 WiFi STA，NAPT 必须绑到真正出网的那条通道上。WiFi 连上 AP 却上不了网，常见原因是 STA 侧没拿到 IP，或者 NAPT 仍绑在 4G 上，包从 WiFi 进来却从 4G 出去（或干脆没转发）。处理步骤：① 先只连 STA，确认 sta 口拿到 IP 和 DNS；② 把 napt 指到 wifista，从 T31 ping 网关再 ping 公网，定位是二层不通还是三层没转发；③ 通了再叠加 4G，确认路由优先级；④ 查网卡初始化与 napt 配置是否写在联网成功回调里，很多问题是回调没触发。参考文档：https://docs.openluat.com/air8000/luatos/app/socket/netdrv/

14. Air780E/Air780EPM是否支持WireGuard/OpenVPN？

解答： 结论：按官方答复是不支持。更准确地说，LuatOS 的 netdrv 库里确实定义了 WG 与 OPENVPN 两种虚拟网卡通道，但公开固件有没有编进对应驱动没有承诺，能不能用要在脚本里探测常量。说明：netdrv 把 VPN 当成一种虚拟网卡，用 netdrv.setup 传通道类型与参数。这两个通道在源码里是按编译开关裁剪的，固件没打开对应开关时，常量根本不会注册出来。所以“库里有这个常量”和“你的固件里有这个能力”是两件事，不要按文档写了就认为一定能用。处理步骤：① 在脚本里判断 netdrv.WG / netdrv.OPENVPN 是否为 nil；② 为 nil 说明当前固件没编，换固件或找 FAE 定制；③ 只是要把数据送到内网，也可以在网关侧做 VPN、模组只跑业务，工程上更省事。参考文档：https://docs.openluat.com/osapi/core/netdrv/

15. Air780EPM是否支持L2TP？

解答： 结论：可以试。netdrv 里有 L2TP 通道（L2TPv2，LAC 角色，需要另一条已联网的网卡提供承载），能否用同样取决于固件有没有编进 L2TP 驱动。说明：L2TP 在 netdrv 里是独立通道，参数包括服务器地址、用户名密码、隧道密钥等，认证支持 PAP 与 CHAP(MD5)。它是“叠加在已有网络之上”的隧道，所以必须先有一条通网的网卡（4G 或以太网），再 setup 一条 L2TP 虚拟网卡。处理步骤：① 先判断 netdrv.L2TP 是否为 nil，为 nil 说明固件不含该驱动；② 常量存在就按示例 setup 一条 LWIP_USER 通道，填服务器与账号；③ 起来后用该通道发一次 socket 请求验证；④ 失败时先看是不是承载网卡没起来，再看认证方式是否匹配。参考文档：https://docs.openluat.com/osapi/core/netdrv/

16. Air780EX2T/Air780EX 无法联网怎么办？

解答： 结论：按“卡 → 信号 → 注网 → 固件”四步排查，最常见的是卡欠费或未实名，其次是天线与供电。说明：Air780EX2T 是 AT 版模组，排查可以直接用 AT 指令，不用先写脚本。无法联网本质上是“没注册上”或“注册上了但数据业务不通”两类，前者看卡与信号，后者看 APN 与欠费状态。另外注意天线没接或接错频段，表现为信号值极低但能搜到网。处理步骤：① 换一张已知可用的手机卡实测，先排除卡的问题；② 用 AT+CPIN? 看卡是否识别、AT+CSQ 看信号强度；③ 用 AT+CGATT? 看是否附着成功，再核对 APN；④ 以上都正常仍不通，再查供电能力与固件版本，必要时换板交叉验证。参考文档：https://docs.openluat.com/air780epm/product/

17. Air780EHU接原理图总有一条幽灵帧在报，如何排查？

解答： 结论：按官方建议，先把固件版本提供出来；硬件上把 R58、R59 两颗电阻去掉再测，同时把原理图交给 AI 或 FAE 一起看。说明：“幽灵帧”通常指线路上有规律地出现错误字节，成因多是上下拉电阻与外部器件形成电平竞争、或电源纹波耦合到信号线上。R58/R59 挂在 Air780EHU 的信号线上，去掉它们可以验证错误帧是不是由这两颗电阻的分压/上拉引起。这类问题软件侧只能看到“收到错数据”，定位必须回到硬件。处理步骤：① 记录固件版本、错误帧的出现周期与波特率；② 去掉 R58/R59 后复测，看错误帧是否消失；③ 用示波器看对应信号线的空闲电平与上升沿是否过缓；④ 把波形、原理图与日志一起给 FAE。参考文档：https://docs.openluat.com/air780ehnehu/product/

18. Air780EPM的GPIO26(PIN25)在休眠状态不能保持高电平，哪个引脚可以？

解答： 结论：按官方答复先升级到最新固件再测；普通 GPIO 在深睡下会掉电，休眠期间要保持电平应优先选 AON/AGPIO 域的引脚。说明：模组进入深睡或 PSM+ 时，大部分 IO 的供电域会掉电，配置也随之丢失，所以“休眠后保持高电平”不是靠软件一直写 1 就能做到，得看这个脚属于哪个电源域。AGPIO（AON GPIO）是常电域，专门用于这种场景。具体哪些脚是 AGPIO，以官方 GPIO 复用表为准，不同型号编号不一样。处理步骤：① 升级最新固件，先排除旧固件的已知问题；② 查 GPIO 复用表，确认引脚是否属 AON/AGPIO 域；③ 不属于就换到 AGPIO 脚上；④ 需要睡眠期间维持输出，进入睡眠前显式配置该脚的输出电平与保持属性，唤醒后重新初始化。参考文档：https://docs.openluat.com/air780epm/luatos/hardware/gpio/

19. Air780EPM的GPIO3配置PWRKEY长按开机后如何实现关机？

解答： 结论：软件上用 pm.shutdown() 关机。但你现在是 GPIO 拉 PWRKEY 长按开机，如果这个 GPIO 一直保持拉低（等价于 PWRKEY 接地），关机后就无法再用按键或 GPIO 开机，只能断电。说明：pm 文档写得很明确：POWERKEY 接地自动开机时调用 pm.shutdown()，将无法通过软硬件再开机，需要断电重新上电才能触发开机。所以正确做法是“拉低触发开机 → 释放 PWRKEY → 需要关机时 pm.shutdown()”。另外 PWRKEY 外部不能有任何上拉电路，否则会出现启动不稳定的风险。处理步骤：① 开机成功后立刻把 GPIO 置高或改浮空，释放 PWRKEY；② 关机调用 pm.shutdown()；③ 必须能远程彻底断电的场合，用 MOS 管控 VBAT，而不是靠 PWRKEY；④ 复查电路：PWRKEY 无外部上拉、RESET_N 无外部拉高。参考文档：https://docs.openluat.com/osapi/core/pm/

20. Air8607/8607A支持HDMI输出吗？

解答： 结论：不支持。8607/8607A 只有 RGB 类屏接口，要接 HDMI 显示必须外加 RGB 转 HDMI 桥片。说明：Air1603 主控的显示通路是 RGB（以及 MIPI 类屏），没有 HDMI 控制器。所以“原生 HDMI 输出”在硬件上不成立，只能做转换：主控出 RGB，桥片转 HDMI。官方表示转换模块有空会做，现阶段要 HDMI 就自己选一颗成熟的 RGB→HDMI 桥片。处理步骤：① 先确认屏或显示器是 HDMI 输入还是 RGB 输入；② 是 HDMI 就在 RGB 输出后加桥片，注意桥片要支持目标分辨率；③ 核对 RGB 位宽与时序（1603 系屏上限 1280×800）；④ 桥片方案要预留时钟与供电，别只画数据线。参考文档：https://docs.openluat.com/air8607/product/

21. Air8603/8607是否支持RGB888？

解答： 尚未解答

22. Air8607数字有其它字体吗？如何修改字体让显示更好看？

解答： 结论：目前用的是默认字库；要换字体有两种做法——替换字库文件后重新生成/烧录 SOC，或直接用带中文字库能力的 hzfont/gtfont 方案做自定义显示。说明：大屏方案的字体观感取决于两件事：字库本身（点阵还是矢量、含哪些字号）和渲染方式。默认配置下用的是内置点阵字库，所以笔画会偏“粗糙”。要好看就得走矢量字体或更高字号点阵，但这两者都吃 Flash 与 RAM，22/122 号这类小脚本区的固件放不下大套字库。处理步骤：① 先确认当前固件是几号、脚本区与文件系统区各多大；② 想换字体就准备对应字库文件，按固件页的说明替换并重新生成 SOC；③ 只是局部界面可以只做用到的字符子集，省空间；④ 让 AI 协助定位字体配置代码是可行的，但改完必须实机看效果。参考文档：https://docs.openluat.com/air8607/product/

23. Air8607新固件可用内存变小（约8.5M，之前约12M），启动两个界面就内存溢出

解答： 尚未解答

24. Air8607图片多次解码后失败的问题

解答： 结论：这个问题已经修复，烧最新固件验证即可。说明：图片反复解码后失败，典型表现是前几张正常、后面陆续解码不出来，根因一般不在图片本身，而在解码缓冲没有释放干净、或连续解码时堆内存被碎片化。属于固件侧问题，所以处理方式是升级固件而不是改应用代码。升级后建议用之前必现的那组图片、按原来的顺序循环解码复测。处理步骤：① 到 8607 固件页取最新版本，用 Luatools 烧录；② 烧完核对版本号；③ 用原来必现的图片序列循环解码，至少跑几十轮；④ 仍复现就把图片规格（尺寸、格式、数量）与日志一起给 FAE。参考文档：https://docs.openluat.com/air8607/product/

25. Air8603用Luatools如何判断PC与板子连接成功？底层固件如何指定？

解答： 结论：判断“连上了没有”看 Luatools 的状态栏与日志窗口是否出现设备与端口信息；底层固件在 Luatools 的项目管理里手动指定 8603 对应的内核 .soc。说明：8603 属于 Air1603 主控的大屏方案，Luatools 不会自动认出该烧哪颗内核，所以新建/打开项目时要自己去选底层固件，否则会出现“烧录成功但起不来”。连接层面，8603 走 USB 下载口，枚举成功后 Luatools 会列出串口并开始打印，日志有输出就说明链路通了。处理步骤：① 用 USB 线连板子的下载口，看设备管理器是否出现新串口；② Luatools 里选中该串口，点打开，看日志窗口有没有打印；③ 项目管理里指定 8603 的内核固件文件；④ 烧录后核对 rtos.version() 与固件页版本是否一致。参考文档：https://docs.openluat.com/air8603/

26. Air8603/Air8607 鼠标键盘插USB口没反应是什么原因？

解答： 结论：按官方答复，可以参考 Air8601 的 USB 键鼠示例来写。说明：USB 主机键鼠属于 USB Host 能力，需要固件编进 USB Host 驱动、并在硬件上给 USB 口供 5V。插上没反应，先确认三件事：这个口是 Host 还是 Device、固件是否带 Host 支持、以及供电是否够（很多板子 USB 口只做下载，不供电给外设）。8601 与 8603/8607 同属 1601/1603 这一代主控，示例可直接借鉴。处理步骤：① 确认板子的 USB 口是否为 Host 口；② 对照 8601 的键鼠示例初始化 USB Host 并枚举设备；③ 用带指示灯的键鼠，先看有没有供电；④ 枚举成功后再读报文，区分“没枚举”和“枚举了但解析错”。参考文档：https://docs.openluat.com/air1601/product/air860x/air8601/luatos/

27. 不同分辨率视频能否自适应全屏？1024*600视频有时能播有时打不开？

解答： 结论：目前不支持不同分辨率视频自适应全屏；1024×600 的 mp4 时好时坏属于已知的播放问题，新版本固件会解决。说明：自适应全屏需要播放器按屏参做缩放与时序匹配，当前实现是按视频原始分辨率直出，所以分辨率与屏不一致时会出现不满屏或显示异常。mp4 容器里编码参数差异较大（profile、B 帧、分辨率对齐），兼容性问题也是“同一批文件有的能播有的不能”的典型原因。处理步骤：① 先按屏的原生分辨率转码视频，不要靠播放器缩放；② mp4 统一用主流编码参数（H.264 baseline、固定分辨率、关闭 B 帧）转一遍再测；③ 升级到最新固件复测；④ 仍有个别文件打不开，把文件规格与日志给 FAE。参考文档：https://docs.openluat.com/air8607/product/

28. Air780EPM/Air780E 模拟器运行闪退或提示内存不足

解答： 结论：模拟器闪退、提示内存不足，多数是脚本自身的问题导致死机，不是模拟器坏了；把日志给 AI 或 FAE 定位最快。说明：模拟器跑的是同一套 Lua 逻辑，脚本里出现死循环、无限递归、超大 table 或频繁创建字符串，都会把内存吃光然后退出。require 加载 device 模块时报异常也属于同类——PC 模拟器没有真实设备对象，这段代码在模拟器上本来就不该执行，需要按平台做条件分支。处理步骤：① 先在实机上复现，确认是脚本问题还是模拟器限制；② 用 rtos.meminfo() 打印内存变化，定位是哪一段在涨；③ 把加载 device 模块这类设备相关调用放到平台判断里；④ 缩小到最小可复现脚本，连同日志一起给 FAE。参考文档：https://docs.openluat.com/osapi/core/rtos/

29. Air780EGP/Air780EPM 脱机烧录用的量产文件SOC能否加密？会不会被反编译出Lua源码？

解答： 结论：量产文件里的 SOC 默认已经加密、脚本强制走 luac 编译，拿不到可读的 Lua 源码；需要更强保护时，生成量产文件时还可以勾选固件签名与脚本加密相关选项。说明：luac 编译是把脚本变成字节码，字节码不含源码文本，反编译也只能得到近似逻辑、拿不回原始注释与命名。SOC 本身有加密处理，直接读 Flash 拿到的不是可直接运行的明文工程。但要清楚边界：这类保护防的是“拷走文件直接用/读源码”，不能防有设备、有工具的人做行为分析。处理步骤：① 用 Luatools 的正常流程生成量产文件，不要手工拼 .soc；② 需要更强保护时在生成选项里启用固件签名与脚本加密，注意密码长度有校验要求；③ 生成后在样机上验证能正常启动；④ 敏感逻辑（密钥、算法）仍建议放服务端或做二次校验，不要只依赖固件加密。参考文档：https://docs.openluat.com/common/Luatools/

30. Air780EVT（AT模组）SMT前是否需要批量烧录固件？焊盘间丝印对焊接有无影响？

解答： 结论：不需要。Air780EVT 是 AT 模组，出厂固件已经配好，SMT 前不用再批量烧录；焊盘之间的丝印对贴片焊接没有影响。说明：AT 模组和 OpenCPU 模组的量产流程不同——AT 模组出厂即带完整 AT 固件，客户板子上只需要给电、给卡、接串口就能用。丝印是印在阻焊层上的油墨，不导电也不占焊盘，正常钢网开孔与贴片工艺不会因为丝印出问题；真正要注意的是焊盘共面性与阻焊桥宽度。处理步骤：① 直接按 AT 模组的硬件设计做 SMT，不用排烧录工序；② 下载/测试夹具按官方渠道获取；③ 封装库从文档站下载，不要自己按尺寸重画；④ 首件建议做一次串口通信与注网验证，确认焊接没问题。参考文档：https://docs.openluat.com/common/4Gmodulepin/

31. Air780EHM/Air780EGP等模组定制固件如何增加文件系统空间？

解答： 结论：要改文件系统空间必须重新定义固件（重新划脚本区与文件系统区），不是改脚本能解决的；官方可以按需提供临时固件做验证。说明：脚本区与文件系统区是固件分区表里定死的，改一个就要动另一个，总容量受 Flash 大小限制。现成的固件里已经有不同配比的例子：20/120 号是脚本区 512KB、文件系统区 1536KB（偏存储音频）；23/123 号是脚本区 1024KB、文件系统区 1920KB；22/122 号是 512KB 对 512KB。可以按自己的实际用量找最接近的一号先用。处理步骤：① 统计脚本实际占用与要存的文件体积；② 到固件页比对各号固件的脚本区/文件系统区，选最接近的先用；③ 都不合适就把需求（型号、脚本区、文件系统区、必须保留的库）提给 FAE 定制；④ 定制固件到手后先在样机上验证挂载与读写。参考文档：https://docs.openluat.com/air780epm/luatos/firmware/780epm_version/

32. Air780E/Air780EPM 是否有支持全球频段的CAT1推荐？

解答： 尚未解答

33. Air724UG/Air780E 模组蜂窝频段是多少？

解答： 结论：国内版 Air780E/Air780EPM 的频段是 FDD B1/B3/B5/B8，TDD B34/B38/B39/B40/B41。说明：这是国内版 4G Cat.1 的标准配置，Air780E（ec618 平台）与 Air780EPM（ec7xx 平台）在这一项上一致。要注意频段是硬件特性，换固件改不了；出海项目必须按目的地选对应型号（如 Air780EHU 欧亚版、Air780EHN 北美版），不能拿国内版刷固件凑。处理步骤：① 国内项目按上述频段设计天线与认证；② 海外项目先确认当地运营商频段，再对 Air780Exx 各版本频段表；③ 天线匹配要覆盖 824~2655MHz 整个区间；④ 进网测试时重点看目标频段能否驻留。参考文档：https://docs.openluat.com/air780epm/product/

34. Air780EPM数据手册、原理图和封装资料在哪里下载？

解答： 结论：数据手册、原理图与封装资料都在 Air780EPM 的产品手册页，一个页面里按“资料下载”分类列出。说明：Air780EPM 与 Air780EHM 硬件完全一致，两者共用同一套资料，所以找 EHM 的资料看这一页也可以。封装库建议直接用官方提供的，自己按尺寸重画容易在焊盘共面性与阻焊上出问题。处理步骤：① 打开产品手册页，按分类下载数据手册、原理图、PCB 封装；② 原理图以最新版本号为准，注意核对版本日期；③ 封装库导入后与数据手册的推荐焊盘图对照一遍；④ 天线与电源部分另看硬件设计页的对应章节。参考文档：https://docs.openluat.com/air780epm/product/shouce/

35. Air780EU出厂默认是AT固件吗？

解答： 结论：是的，Air780EU 出厂默认就是 AT 固件。说明：AT 版模组出厂即带完整 AT 指令固件，客户不需要自己烧 OpenCPU 固件就能用；要改成本地脚本开发，得另行烧 LuatOS 固件，且要确认该型号是否有对应的 LuatOS 固件（不是所有 AT 版型号都有）。处理步骤：① 到手先用串口发 AT 确认有回显；② 需要二次开发时先查该型号是否有 LuatOS 固件；③ 有就按固件页烧录，没有就保持 AT 方案、用外置 MCU 控制；④ 烧录前备份出厂固件，便于回退。参考文档：https://docs.openluat.com/atmozu/product/shouce/

36. Air780EGG的PCB封装在哪里查看？

解答： 结论：Air780EGG 的 PCB 封装在文档站可查可下，找不到时直接用站内的 AI 问答检索型号即可定位。说明：封装资料统一放在各型号的产品手册/硬件页，Air780EGG 属于 Air780Exx 系列，封装与同系列同封装型号通用。建议优先用官方封装库，自己按数据手册重画容易在焊盘尺寸与阻焊开窗上出偏差。处理步骤：① 在文档站搜 Air780EGG 或打开其产品页；② 在“资料下载”里取 PCB 封装；③ 导入后与数据手册的推荐焊盘图核对；④ 找不到就用站内 AI 问答直接问型号，会给到对应页。参考文档：https://docs.openluat.com/air780egh/product/

37. Air780EHM DTMF通话挂断后USB ECM与UART同时失去响应，需彻底断电才能恢复

解答： 尚未解答

38. Air780EHT/Air780E 检测不到SIM卡（AT+CPIN? 返回错误10）是锁卡吗？

解答： 结论：不是锁卡。锁卡一般表现为“能识别卡但不联网”，而 AT+CPIN? 返回错误 10 是根本没读到卡，方向要看卡座与卡本身。说明：错误 10 属于 SIM 未插入/未识别级别，常见原因有三类：卡座虚焊或触点氧化、卡没插到位（很多卡座是内推式，需要推到卡住为止）、以及卡本身损坏或剪卡后厚度不对。锁卡是运营商侧的机卡绑定策略，不影响卡被识别。处理步骤：① 把卡插到手机上确认卡是好的；② 检查卡座焊点，重点看是否有虚焊与连锡；③ 确认是内推式卡座并且推到位；④ 换一张卡交叉验证，仍报错 10 就查 SIM 供电与信号线（含 ESD 器件）。参考文档：https://docs.openluat.com/air780epm/product/

39. Air780EPM 4英寸电容触摸屏是否有已适配好的方案？

解答： 结论：有。合宙有已经适配好的电容触摸屏方案，可以直接选型使用；具体型号要按你的尺寸、分辨率与结构需求确认。说明：大屏方案的触摸走 I2C（如 GT911 一类），屏走 RGB/MIPI，选型时要把“屏 + 触摸 + 结构”当成一套来定，单换其中一个很容易在 FPC 定义与开孔上返工。合宙配套的屏已经做好了时序与触摸参数，能省掉大量调试。处理步骤：① 先定尺寸、分辨率、触摸点数与工作温度；② 找销售索取已适配的屏清单与规格书；③ 核对 FPC 脚位定义与主控板连接器是否一致；④ 打样后先验证触摸坐标与显示是否对齐。参考文档：https://docs.openluat.com/accessory/

40. Air780EPM iRTU自动采集任务入口在哪里？

解答： 结论：iRTU 的自动采集任务入口在 iRTU 文档的 AutoTask 页，按页面里的任务配置流程建任务即可。说明：iRTU 是跑在模组上的透传/采集固件，自动采集任务属于它的业务配置，不在 LuatOS 脚本层，所以不要到 osapi 里找接口。配置项一般包括采集周期、从站地址、寄存器地址与长度、以及上报通道。处理步骤：① 打开 AutoTask 页，按示例建一个最小任务；② 先采一个寄存器、本地打印验证解析正确；③ 再加周期与上报通道；④ 采集不到时用串口抓 Modbus 报文，区分是没发出去还是没收到回应。参考文档：https://docs.openluat.com/value/irtu/docs/AutoTask/

41. Air8784如何添加到IoT平台？信令服务器能否自建？平台是否收费？

解答： 结论：把设备挂到自己账号的步骤在 Air8784 整机使用说明里（第 3 节，含新建 8784_SIP 项目、转移 IMEI）；信令服务器可以自建，设备升级到最新软件即可；平台目前不收费，但使用合宙 SIP 服务器账号会收费。说明：Air8784 的 SIP 体系是“设备 + SIP 服务器 + 对端软终端”。用合宙的 SIP 服务器最省事，账号约定是固定项目名 8784_SIP、端口与传输方式按文档填；自建则要自己维护服务器与账号，设备侧只需把 SIP 参数指向自建地址。处理步骤：① 登录合宙 IoT 云平台，新建项目名必须为 8784_SIP；② 把设备 IMEI 转移到该项目；③ 用合宙服务器就按文档填账号密码，自建就改 SIP 域与服务器地址；④ 升级到最新固件后看日志里 SIP 注册是否为 Y。参考文档：https://docs.openluat.com/air8784/software/default_factory_firmware/

42. Air8201用的物联卡在哪里购买？

解答： 结论：按官方答复，物联卡要加商务微信购买；文档站不承载卡类销售，也不列卡的具体资费。说明：物联卡属于运营商侧的流量产品，开卡、实名、流量池与资费都由卡商与运营商确定，与模组本身无关。Air8201 用的是标准 SIM 卡座，任何符合规格的物联网卡都能用，关键是确认卡的制式与当地网络匹配（国内 Cat.1 用普通物联网卡即可）。处理步骤：① 先确认项目所在地与所需流量套餐；② 通过合宙销售渠道或对接商务购买；③ 拿到卡后在样机上验证注网与数据业务；④ 注意物联卡通常有地域与机卡绑定限制，换设备前先问清政策。参考文档：无（属商务事项，请通过购买渠道或对接销售确认）。

43. Air780EPM批量价格和起订量是多少？

解答： 结论：按选型页的公开参考价，Air780EPM 是 16.8 元、Air780EHM 是 19.8 元；批量与起订量以商务报价为准（原答里的 15.8/18.8 已过期）。说明：文档站的选型页给的是单颗参考价，实际成交价随数量、是否带包装/测试、以及交期浮动，所以“批量价”必须以销售报价单为准，不要在方案里按参考价直接核算成本。100 片起可按批量价询价，这是原答给出的口径。处理步骤：① 选型阶段用 16.8/19.8 做初步成本估算；② 定稿前找销售拿正式报价与起订量；③ 同时确认是否含税、是否含包装；④ 大批量建议先小批试产验证良率再谈价。参考文档：https://docs.openluat.com/SelectionGuide/SelectionGuide/

44. Air780EU和Air530Z交期多久？

解答： 结论：按官方答复，款后 2 到 3 天可以发出；具体交期以销售确认的排期为准。说明：交期受库存、批次与物流影响，属于商务口径，技术文档里不会写也没法保证。选型阶段要把交期当成和价格同等重要的约束来评估，尤其是量产爬坡期，样机交期和批量交期经常不是一回事。处理步骤：① 下单前让销售给书面交期；② 关键项目预留安全库存，不要按“刚好够用”备料；③ 样机阶段先小批拿货验证，再谈批量排期；④ 交期变化时同步调整生产计划，避免停线。参考文档：无（属商务事项，请通过购买渠道或对接销售确认）。

45. 是否有支持NB-IoT（Cat NB2）、沙特使用的MQTT模组？

解答： 结论：没有。合宙目前没有支持 NB-IoT（Cat NB2）的模组，沙特可用的 MQTT 方案要用 4G Cat.1 模组。说明：NB-IoT 与 LTE Cat.1 是两套不同的射频与协议栈，不能靠刷固件互转。合宙现有产品线集中在 4G Cat.1（Air780 系、Air700 系）与 WiFi/多媒体方案，NB-IoT 这一块没有对应型号。沙特主流运营商 4G 覆盖完善，Cat.1 方案在功耗与成本上都可接受。处理步骤：① 先确认当地运营商是否有可用的 Cat.1 与 MQTT 通路；② 用 Air780E 系选一个当地频段匹配的版本（如欧亚版 EHU）；③ MQTT 走模组内置 mqtt 库，注意只支持 3.1.1；④ 功耗敏感场景用 PSM+ 而不是 NB-IoT。参考文档：https://docs.openluat.com/SelectionGuide/SelectionGuide/

46. 4G模块可以切换信号小区吗？

解答： 结论：不需要手动切，模组内部会自动做小区重选与切换。说明：小区选择/重选由协议栈按 3GPP 规则自动完成，依据是信号质量、邻区测量与优先级，应用层没有“切到某个小区”的标准接口。能干预的只有频段锁定（部分平台支持）与网络制式选择，这属于调试手段，不建议量产使用。处理步骤：① 网络不稳先看信号强度与 SINR，不要先想切小区；② 确认天线与安装位置，金属外壳与遮挡是常见原因；③ 需要锁定频段时用平台提供的调试指令，仅在定位问题时用；④ 长期不稳联系运营商查当地基站负载。参考文档：https://docs.openluat.com/air780epm/product/

47. Air601S上的W_GPIO通过什么方式控制，有示例吗？

解答： 结论：Air601S 就是 Air6208（定制 W800 型号），W_GPIO 的编号规则与 Air8000 一致，按“编号 +128”换算；具体控制方式要看该型号的资料。说明：W_GPIO 是 WiFi 侧芯片自己的 GPIO，与 4G 主控的 GPIO 不是一套编号。定制型号的资料不全在公开文档站上，Air6208 也没有独立的文档目录，所以不要按 4G 模组的管脚表去推。处理步骤：① 先确认手上是 Air601S 还是标准 Air6208；② 按 +128 的规则把 W_GPIO 编号换算成实际管脚；③ 控制方式（脚本接口还是 AT）以该型号的交付资料为准；④ 资料缺失就找对接的 FAE 索取。参考文档：https://docs.openluat.com/

48. Air8607 9寸屏的具体尺寸和结构资料有吗？

解答： 结论：9 寸屏的具体尺寸与结构资料在配件页 AirLCD_1090；带外壳的整机结构尺寸需要另外向销售索取。说明：屏的规格书一般给的是屏体尺寸、可视区、FPC 位置与固定孔位，外壳尺寸属于结构件资料，不在公开文档里。选型阶段要先把“屏体 + 结构件 + 主控板”三者的装配关系确认清楚，否则开模后改不了。处理步骤：① 打开 AirLCD_1090 页面下载规格书，核对屏体尺寸与可视区；② 确认 FPC 出线方向与连接器型号；③ 需要外壳尺寸就找销售要 3D 或图纸；④ 打样前做一次实物装配验证。参考文档：https://docs.openluat.com/accessory/AirLCD_1090/

49. 8607的字体很粗糙，能兼顾显示效果和反应速度吗？如何修改字体？

解答： 结论：可以兼顾。做法是换字库而不是调字号——烧新 SOC 用更高质量的字库，或改用矢量字体方案；只想局部优化就只替换用到的字符集。说明：字体粗糙的本质是点阵字库的字号小、笔画少。点阵越大越清晰，但占的 Flash 与 RAM 也越多，而大屏方案的脚本区本来就紧张，所以“清晰”和“反应快”要按实际界面取舍。矢量字体渲染更细腻，代价是首次渲染耗时与内存占用。处理步骤：① 统计界面上真正用到的字符（很多界面只有几百个汉字）；② 只做这部分子集的字库，体积能降一个量级；③ 烧入后实机看效果，重点看小字号的可读性；④ 让 AI 协助定位字体加载与渲染代码可行，但改完必须实机验证。参考文档：https://docs.openluat.com/air8607/product/

50. Air780EPM的天线参数和PCB天线设计要求在哪里查？

解答： 结论：天线参数与 PCB 天线设计要求在 Air780EPM 的硬件设计页（ant 章节）；PCB 天线的最终适配需要天线厂商配合调试。说明：模组侧只给天线馈点阻抗、推荐净空区与匹配电路参考，实际 PCB 天线的效率、带宽与方向图取决于板子尺寸、地平面与周围结构，必须用网络分析仪实测并做匹配调整。这也是为什么官方只给设计准则、不给“现成参数”。处理步骤：① 先按 ant 页的净空与馈线要求布局；② 预留 π 型匹配位（三个元件位置）；③ 打样后用网析仪测 S11，按需要调匹配；④ 效率不达标就找天线厂商做定制调试。参考文档：https://docs.openluat.com/air780epm/luatos/hardware/ant/

51. Air780EPM 休眠时GPIO保持高电平/低功耗如何配置？

解答： 尚未解答

52. 如何用AI做UI的教程有吗？

解答： 结论：有。文档站的 AI 教程区给了用 AI 辅助做 UI 的完整流程，配合 AirUI 的示例可以直接跑起来。说明：这套流程的思路是“描述界面 → 让 AI 生成 AirUI 代码 → 实机预览再迭代”。AirUI 是合宙自研的轻量 UI 框架，控件与布局都是 Lua 侧配置，适合让 AI 生成初稿；但最终效果要靠实机验证，因为屏参、字体与刷新性能只有真机能看出来。处理步骤：① 先看 AI 教程里给的提示词模板与示例工程；② 用最小界面（一个容器 + 几个控件）跑通编译与预览；③ 再让 AI 按你的界面图扩写；④ 每轮改动都上实机看刷新与内存，别只在模拟器里看。参考文档：https://docs.openluat.com/ai/

53. Air8000系列是否支持8080/MIPI接口的屏？支持什么格式？

解答： 结论：不支持 8080 与 MIPI 接口的屏，Air8000 系列支持的是 RGB 接口屏。说明：8080 是并口（MCU 屏）时序，MIPI 是差分高速串行，两者与 RGB 并口在控制器和管脚上都不是一回事，不能靠改配置切换。选屏时先确认接口类型，RGB 屏要注意位宽——RGB888 的屏可以接，但主控只接高 16 位，低位按屏的规格书固定电平处理。处理步骤：① 先拿到屏的规格书，确认是 RGB 还是 8080/MIPI；② 是 RGB 就核对分辨率上限（1280×800）与位宽；③ RGB888 屏按高 16 位接线，剩余低位固定；④ 触摸单独走 I2C，别和屏的接口混在一起。参考文档：https://docs.openluat.com/air8000/luatos/app/multimedia/lcd/

54. Air8607/8607A 与客户自有50pin屏能否配合？

解答： 结论：可以。8607 的所有型号都支持 50pin 屏，屏可以由客户自行配置；只出 PCBA 也可以。说明：50pin 是这一代大屏方案的通用屏接口，脚位定义里包含 RGB 数据、时钟、同步信号、背光与触摸 I2C。客户自带屏时，关键是把屏的脚位定义与这块 50pin 的定义逐脚对上，尤其是背光使能/调光与触摸复位/中断这几根。处理步骤：① 拿到客户屏的规格书与 FPC 脚位表；② 与 8607 的 50pin 定义逐脚对照，标出不一致项；③ 不一致的用转接板或改线解决，不要直接插；④ 打样后先验证背光与触摸，再看显示。参考文档：https://docs.openluat.com/air8607/product/

55. Air780EX/Air780EPM 是否支持改SN号？

解答： 结论：可以改，但不能用 misc.setsn——那是 LuatOS-Air（8910 平台，Air724/Air720 那一代）的接口。Air780EX/Air780EPM 是 EC7xx 平台的 LuatOS，misc 库只有 gpo_setup/gpo_output/gpo_level 三个接口，没有 setSn。正确做法是：设备唯一标识用 hmeta/mobile.muid()/mobile.imei() 读取，自定义 SN 自己写进 fskv。说明：EC7xx 的 LuatOS 没有“改模组出厂 SN”的公开接口，出厂 SN/IMEI 属于产线烧录的校准数据，应用层不应改写。工程上通常不去改它，而是把“产品 SN”存到 fskv 或直接复用 IMEI/MUID 作为设备标识——这两者全球唯一、掉电不丢，省掉产线写号工序。处理步骤：① 先确认需求是“读唯一标识”还是“写自己的编号”；② 读标识用 hmeta.model()/hwver()、mobile.imei()、mobile.muid()；③ 要写自定义 SN 就用 fskv.set 存一个键值，并注意量产烧录时不要勾“清 KV”；④ 真的要改模组出厂 SN，只能走产线校准流程，找 FAE。参考文档：https://docs.openluat.com/osapi/core/fskv/

56. Air780VET焊盘之间加丝印对焊接有影响吗？有标准封装库吗？

解答： 结论：焊盘之间加丝印对贴片焊接没有实质影响；标准封装库在文档站可以直接下载。说明：丝印是阻焊层上的油墨，不导电、不占焊盘，钢网开孔与回流焊的润湿都不受它影响。真正影响焊接的是焊盘尺寸、阻焊桥宽度与共面性。不过要注意：如果丝印压在焊盘上（设计时丝印没做裁剪），会影响焊膏印刷，这属于设计问题。处理步骤：① 从文档站下载官方封装库，不要自己按尺寸重画；② 检查丝印是否与焊盘重叠，重叠就让 CAM 做丝印裁剪；③ 首件用 SPI/AOI 检查焊膏与偏移；④ 焊接异常时先怀疑焊盘与钢网，不要归因到丝印。参考文档：https://docs.openluat.com/atmozu/product/shouce/