常见问题 - 2026-09-30
数据日期:2026-09-30
1. SIP通话是否必须至少一端使用合宙设备?手机与手机之间能否通话?
解答: 结论:可以,SIP 通话不要求两端都是合宙设备;手机安装 Linphone 等 SIP 客户端,登录同一个服务器就能和设备互通。 说明:SIP 是标准 VoIP 协议,通话能否建立只取决于两端是否在同一台 SIP 服务器上注册成功、号码能否被服务器解析到对应账号,跟设备是不是合宙的没有关系。设备端用 LuatOS 的 exsip 扩展库,手机端用第三方的软电话 App 即可。 处理步骤:
- 在手机上安装 Linphone(或 MicroSIP)。
- 用服务器分配的账号登录;合宙测试服务器上,带 IMEI 的模组用 15 位 IMEI 末位加 0 或 1 作为两个账号。
- 设备端拨手机账号、手机拨设备账号,双向各呼叫一次验证。
参考文档:SIP 通话演示 https://docs.openluat.com/air8000/luatos/app/multimedia/sip/ 。
2. 780EPV固件在哪里下载?
解答: 尚未解答
3. Air780EPM/Air8784支持2.6.2物联网VPDN规范吗?
解答: 尚未解答
4. ESP32-S3连接Air530W GPS收不到信号、经纬度没有数据怎么办?
解答: 结论:优先排查天线与使用环境,最常见的原因是天线不匹配或无源天线在室内根本收不到星。 说明:GNSS 定位的硬条件只有一个——能接收到足够多的卫星信号,因此室内、地下车库、高楼夹缝、金属或封闭外壳内基本无法定位。有源棒状天线在弱信号环境下的表现明显优于 PCB 无源天线。另外要注意 Air530W 的资料与参考设计挂在 Air510W 产品页下,不在 air530w 目录。 处理步骤:
- 到室外开阔处,天线朝上,冷启动后等待 35 秒到 2 分钟再判断。
- 换用有源棒状天线,确认馈线供电正常。
- 检查与 ESP32-S3 之间的串口波特率、共地,以及 GNSS 模块的供电能力(峰值电流不足会一直搜不到星)。
- 用 GNSS 调试工具看原始 NMEA 是否已有卫星信息。
参考文档:Air510W/Air530W 产品资料 https://docs.openluat.com/air510w/product/ 。
5. Air8000的SIP demo哪里可以下载?固件和硬件有限制吗?
解答: 结论:目前 SIP demo 以 Air8784 整机的形式发布,Air8000 暂时没有独立的 SIP demo 发布计划。 说明:Air8784 是「Air780EHM + Air1103 回声抑制芯片」的 SIP 对讲整机方案,声学环境出厂即调好。Air8000 系列(含带屏型号)的 SIP 通话质量已经在整机方案上完成测试适配,但面向公开的 demo 还没有发布。 处理步骤:
- 需要马上验证 SIP 效果,直接用 Air8784 整机。
- 关注合宙 SIP 方案页面的更新。
- 确实要在 Air8000 上做 SIP,联系 FAE 确认适配排期。
参考文档:Air8784 SIP 对讲方案 https://docs.openluat.com/air8784/product/ 。
6. 用官方测试服务器做SIP demo拨号,是否必须IoT注册和绑定硬件?8780V2没有权限吗?
解答: 结论:官方 SIP 测试服务器的账号权限与整机购买绑定——购买 Air8784 整机才会给到测试权限;Air8780V2 不要用来评估 SIP,建议用 8784 测试。 说明:Air8780V 系列不配 Air1103,没有 AEC 回声抑制,免提/对讲场景下回声压不住,测出来的效果不能代表正式方案;Air8780V2 也没有公开的 SIP demo 资源。 处理步骤:
- 用 Air8784 整机申请测试权限并完成注册。
- 不要用 Air8780V2 评估 SIP 通话效果。
- 确实需要 8780 系列的 SIP 能力,联系 FAE 确认是否有对应方案。
参考文档:Air8784 SIP 对讲方案 https://docs.openluat.com/air8784/product/ 。
7. 8780V2哪里有SIP资源?是否共用Air780EHM?
解答: 结论:官方 SIP 测试服务器的账号权限与整机购买绑定——购买 Air8784 整机才会给到测试权限;Air8780V2 不要用来评估 SIP,建议用 8784 测试。 说明:Air8780V 系列不配 Air1103,没有 AEC 回声抑制,免提/对讲场景下回声压不住,测出来的效果不能代表正式方案;Air8780V2 也没有公开的 SIP demo 资源。 处理步骤:
- 用 Air8784 整机申请测试权限并完成注册。
- 不要用 Air8780V2 评估 SIP 通话效果。
- 确实需要 8780 系列的 SIP 能力,联系 FAE 确认是否有对应方案。
参考文档:Air8784 SIP 对讲方案 https://docs.openluat.com/air8784/product/ 。
8. Air1602是否建议使用软件I2C,最好用硬件I2C吗?
解答: 尚未解答
9. Air1602的GPIO52是否属于USB_DET类,不能当普通GPIO使用?
解答: 结论:引脚功能一律以官方管脚复用表为准:USB_DET 这类专用脚一般不能当普通 GPIO 用,而 GPIO52 属于可复用 IO。
说明:Air1601/Air1602 每个 IO 的默认功能、可复用功能都在 air1601/luatos/hardware/ 的管脚说明里有明确标注。被 USB 检测、Boot/Strap 等硬性用途占用的脚,硬件上已有固定接法,软件里随意改成 GPIO 会破坏原有功能。
处理步骤:
- 查 Air1601/Air1602 管脚复用表,确认 PIN52 的功能标注。
- 若标注为可复用 GPIO/外设,按需要配置;若标注为专用功能,就不要改作普通 IO。
- 需要在代码里改功能的 IO,统一用 pins.setup 显式指定。
参考文档:Air1601/Air1602 硬件管脚说明 https://docs.openluat.com/air1601/luatos/hardware/ 。
10. Air8784是否支持注册到国标协议GB28181-2016平台?
解答: 结论:可以。Air8784 SIP 整机正在开发对 GB28181-2016 平台的适配,预计 10 月推出。 说明:GB28181 是国标视频监控联网协议,整机接入需要在平台侧完成信令与媒体流的适配,属于软件侧开发工作;合宙已经在推进。 处理步骤:
- 先用标准 SIP 服务器验证整机通话链路是否正常。
- 需要接入 GB28181 平台,关注版本发布或联系 FAE 确认时间点。
参考文档:Air8784 SIP 对讲方案 https://docs.openluat.com/air8784/product/ 。
11. Air1103芯片什么时候可以购买?
解答: 结论:不单独对外出售 Air1103,必须搭配 Air780EHM(或合宙其它主控模组)一起购买;可以单独买 Air780EHM。 说明:Air1103 是一颗串口 AI 语音芯片,把麦克风采集、喇叭播放与 3A 语音算法(ANS 降噪 + AEC 回声消除 + ASR 识别)集成在一起,主控只要一路 UART(2Mbps)即可。它的回声抑制效果依赖与主控的联合标定,因此合宙要求搭配自家模组使用,不建议搭配其它主控。 处理步骤:
- 选型时按「Air780EHM + Air1103」成套采购。
- 不要在第三方主控上单独使用 Air1103。
参考文档:Air1103 AI 语音芯片手册 https://docs.openluat.com/air8784/product/air1103/ 。
12. 客户想购买780EHM+1103自己设计板子,是否需要定制?大致费用是多少?
解答: 结论:Air780EHM + Air1103 的自研板定制只支持少量客户,付 3 万元定金即可支持开发,后续批量出货 5k 套后可以抵扣货款。 说明:合宙推荐的做法是:客户负责产品定义,第一版软硬件由合宙定制开发,交付原理图/PCB 设计文件以及软件源码。后续会推出把 780 与 1103 做在一起的 8701,届时可减少定制需求。 处理步骤:
- 明确产品定义、数量与节奏。
- 联系合宙任意一位同事确认定制范围与定金事宜。
- 若可以等待,关注 8701 集成型号的发布。
参考文档:Air8784 SIP 对讲方案 https://docs.openluat.com/air8784/product/ 。
13. Air780EPM远程升级提示无权限、项目里找不到设备是什么原因?
解答: 结论:这是「设备没有归属」导致的——把设备添加到自己账号的项目下即可恢复远程升级权限。 说明:合宙远程升级(IOT 平台)按设备归属做权限校验:设备没有归属时,在项目里看不到它,自然也就提示无权限。归属绑定完成后即可在项目下管理并升级。 处理步骤:
- 登录 IOT 平台并进入目标项目。
- 按《设备归属》文档把设备(IMEI)添加进项目。
- 重新发起远程升级,确认项目里已经能看到该设备。
参考文档:设备归属说明 https://docs.openluat.com/air780epm/product/attributioniot/ 。
14. Air780EPM卡1移动卡2联通联网切换,联通卡入网慢/联网失败是什么原因?
解答: 尚未解答
15. Air780EHV出厂的固件版本支持RNDIS拨号联网吗?
解答: 结论:出厂固件支持 RNDIS,但需要手动打开;参考 mobile 库的用法并对照官方 rndis_ecm demo。 说明:RNDIS/ECM 是把模组当作 USB 网卡使用的联网方式,需要脚本里显式使能网络模式,默认不会自动开启。不同型号的入口略有差异,但都通过 mobile 库的网络模式配置项控制。 处理步骤:
- 参考 mobile 库说明配置 RNDIS/ECM 网络模式。
- 烧录官方 rndis_ecm demo 做对照验证。
- 在电脑端确认出现 RNDIS 网卡并成功获取 IP。
参考文档:RNDIS/ECM 说明 https://docs.openluat.com/air780egh/luatos/app/common/rndis/ 。
16. Air780EGG低功耗模式下定位没有数据,正常模式下正常,是什么原因?
解答: 尚未解答
17. Air8781P1可以接入OneNET平台吗?
解答: 尚未解答
18. MQTT订阅中IMEI通配符应该怎么写才能解析?
解答: 结论:写 xxx/IMEI/xxx 即可,不需要加两条竖线。
说明:MQTT 的通配符只有两种:+ 匹配单层、# 匹配多层,| 并不是 MQTT 的通配符,写上去只会被当成普通字符,订阅自然匹配不到。合宙 IOT 平台的物模型 topic 把 IMEI 作为固定的层级字段,按平台给出的格式填实际值或 + 即可。
处理步骤:
- 按平台文档给出的 topic 格式订阅,IMEI 段填实际值或用
+占位。 - 不要用
||拼接分隔。 - 先用 MQTT 调试工具验证订阅能收到消息,再落到代码里。
参考文档:IOT 平台与物模型接入 https://docs.openluat.com/air780epm/luatos/app/iotcloud/ 。
19. Air8202G整机出厂固件004.000.038,想通过iRTU修改参数/重启时间,刷哪个固件?
解答: 结论:Air8202G 出厂固件是「iRTU-8202G-smart-nocfg」,是在 iRTU 基础上做的免配置版本,默认直报合宙 AirCloud,不经过 iRTU 配置平台,所以无法用 iRTU 平台改参数。 说明:文档明确写的是「在合宙 iRTU 固件的基础上修改,无需通过 iRTU 配置平台,默认上报合宙 AirCloud 云平台」,设备只有 GPS 开/关两种模式(开机 5 分钟内,或 180 秒内有震动 → GPS 开)。如果需要能自行配置参数的 iRTU 固件,要改刷通用 iRTU 固件;Air8202 的专用 iRTU 固件仍在开发中(相比 Air780EGG 版本增加了基于 YH2712 的充电管理),过渡期可先用 Air780EGG 的 iRTU 固件。 处理步骤:
- 先确认需求是「AirCloud 直报」还是「自行配置参数」。
- 前者沿用出厂 smart-nocfg 固件;后者刷 iRTU 固件并走 iRTU 配置平台。
- 注意 Air8202 专用 iRTU 固件尚未发布,先用 Air780EGG 版本过渡。
参考文档:Air8202 产品说明 https://docs.openluat.com/air8202/product/ 。
20. Air780EPM共5个模组远程升级提示失败无权限是什么原因?
解答: 结论:这是「设备没有归属」导致的——把设备添加到自己账号的项目下即可恢复远程升级权限。 说明:合宙远程升级(IOT 平台)按设备归属做权限校验:设备没有归属时,在项目里看不到它,自然也就提示无权限。归属绑定完成后即可在项目下管理并升级。 处理步骤:
- 登录 IOT 平台并进入目标项目。
- 按《设备归属》文档把设备(IMEI)添加进项目。
- 重新发起远程升级,确认项目里已经能看到该设备。
参考文档:设备归属说明 https://docs.openluat.com/air780epm/product/attributioniot/ 。
21. Air780EPM 64位固件迁移后出现fskv function/userdata/nil/thread isn't allow警告是什么原因?
解答: 结论:fskv.set 的值只允许 boolean / number / string / table;删除键必须用 fskv.del(key)(table 的子键用 fskv.sett(t, k, nil)),不能靠写入特殊值来删。64 位固件上旧数据出现的垃圾值,是 32 位时期按 4 字节存数、64 位固件按 8 字节读取造成的。
说明:fskv 是 KV 存储,底层按数据类型打标记:允许 boolean、number、string、table,遇到 function / userdata / nil / thread 就会报 isn't allow。另外 32 位与 64 位固件的 number 存储宽度不同(4 字节 vs 8 字节),32 位固件写下的整数在 64 位固件里按 8 字节读,就会被解析成垃圾数据,于是告警和脏数据会一起出现。
处理步骤:
- 在切到 64 位固件前先清空 fskv,或把已有键逐个重写一遍。
- 删除键统一用
fskv.del(key);删除 table 子键用fskv.sett(t, k, nil)。 - 不要在 fskv 里存放 function / userdata / thread 等类型。
参考文档:fskv 扩展库说明 https://docs.openluat.com/air780epm/luatos/app/common/fskv/ 。
22. Luatools在模拟运行时闪退是什么原因?
解答: 尚未解答
23. Air780EX批量烧录工具multidownloader修改ini后仍被还原、下载报错怎么办?
解答: 结论:这是工具对非英文路径/非 ANSI 编码支持不好导致的——先关掉工具,把固件包放到纯英文目录、文件名也改成纯英文,把 ini 里的路径改成纯英文并「另存为 ANSI」编码,再重新打开工具;也可以改用合宙量产烧录工具。 说明:老版批量烧录工具在读取 ini 时对中文路径和 UTF-8 编码的处理不完善,重启工具时会回落到默认配置,把之前的修改覆盖掉,于是表现为「改完又还原」「下载报错」。 处理步骤:
- 关闭烧录工具。
- 把固件包复制到纯英文目录,文件名也改成纯英文。
- 把 ini 里的路径全部改为纯英文,另存为时编码选 ANSI。
- 重新打开工具确认配置已生效;仍不行就换合宙量产烧录工具。
参考文档:Luatools 工具说明 https://docs.openluat.com/common/Luatools/ 。
24. Air8784多少钱一片?这个方案成本多少钱?
解答: 结论:Air8784 整机单个 299 元、一对 399 元,购买链接见下方;可以先买一对体验测试,有信心后再谈方案合作,方案/整机成本需要先明确合作方式。 说明:整机包含 Air780EHM + Air1103 的回声抑制方案;购买整机后可以联系合宙任意一位同事,协调提供 Air8784 整套原理图/PCB 硬件设计文件与软件源码。 处理步骤:
- 通过淘宝链接 https://e.tb.cn/h.8wEyOKEMXYWLHXC?tk=XNv5TM7A6Jv 购买整机(一个 299 元、两个 399 元)先做体验测试。
- 验证零回声通话效果后,再与合宙同事谈定制或批量合作。
- 方案成本按实际合作方式另行确认。
参考文档:Air8784 SIP 对讲方案 https://docs.openluat.com/air8784/product/ 。
25. Air8202开发板宽度较大,能否把电池改成软包电池与板子上下叠加?
解答: 结论:可以。外壳结构可以自行设计,电池容量 1000mAh 左右基本够用,注意不要把电池放到 4G 天线底下。 说明:Air8202C/G 原厂采用 2000mAh 的 18500 电池、充电电流默认 500mA。换成软包电池主要是结构适配问题,容量可以按实际功耗和续航需求调整,1000mAh 量级对常见场景已经够用。 处理步骤:
- 按软包电池尺寸重新做外壳叠层。
- 电池远离 4G 天线区域,避免遮挡和干扰。
- 按电池实际容量调整充电电流配置。
参考文档:Air8202 产品说明 https://docs.openluat.com/air8202/product/ 。
26. 你们有北斗的贴片陶瓷天线吗?
解答: 结论:Air8202 上用的是 18×18 的北斗/GNSS 贴片陶瓷天线(有标品,立创等渠道可以买到);合宙官网出售的是 25×25 版本。 说明:贴片陶瓷天线的实际性能与主板尺寸、外壳材质、天线周边空间密切相关,即便是标品也需要针对具体结构做匹配调试;无源陶瓷天线的匹配通常是通过调整天线顶部的银粉,结合整机结构来完成的。 处理步骤:
- 按模块设计要求选择 18×18 或 25×25 规格。
- PCB 上预留 π 型匹配电路。
- 整机结构定稿后,找专业天线厂针对主板和外壳做匹配调试。
参考文档:Air8202 产品说明 https://docs.openluat.com/air8202/product/ 。
27. Air780EPM PIN84引脚上电默认是高电平吗?是GPIO10/SPI0_MISO/UART2_RXD复用引脚吗?
解答: 结论:Air780EPM 的 PIN84 上电默认是「非高非低」的高阻悬空状态,实际电平由外部上拉或下拉决定;该脚复用为 SPI0_MISO / GPIO10。 说明:文档管脚表里 PIN84 的默认状态写的就是「悬空」,所以既不是高电平也不是低电平。要让它有确定电平,必须在外部加上拉或下拉电阻。它同时是 SPI0 的数据输入脚(MISO)与 GPIO10。 处理步骤:
- 需要固定电平时,在外部加合适的上下拉电阻。
- 用作普通 IO 时,按复用表配置为 GPIO10。
- 用作 SPI0 时,不要再把它当普通 GPIO 使用。
参考文档:Air780Exx 管脚说明 https://docs.openluat.com/air780epm/product/air780exx/ 。
28. Air780EPM双卡切换联通4分钟才入网是协议栈问题吗?
解答: 尚未解答
29. Air724UG想接入LAN有线网线连接,能定制吗?
解答: 结论:可以定制。把具体需求(网口速率、芯片/接口选型、数量、周期)整理好发给合宙同事评估即可。 说明:Air724UG 本身不带以太网接口,要接有线网口需要外挂以太网方案,属于硬件定制范畴,需要结合整机结构、供电与软件适配一起评估。 处理步骤:
- 整理需求:百兆还是千兆、RJ45 还是排针、供电方式、预计数量与周期。
- 联系合宙同事确认可行性与定制方案。
参考文档:Air724UG 产品资料 https://docs.openluat.com/air724ug/product/ 。
30. Air8784的SIP方案是否可以和其他家的VOIP电话连通?
解答: 结论:可以。只要对端设备或平台支持标准 SIP 协议,就能和 Air8784 的 SIP 方案互通。 说明:SIP 是开放标准协议,互通性取决于双方对信令与语音编码的协商结果。合宙 SIP 方案使用标准 SIP 与 G.711 窄带编码(PCMA/PCMU),因此只要对端同样支持标准 SIP 与这两种编码,互通就没有障碍。 处理步骤:
- 确认对端支持标准 SIP,并支持 PCMA 或 PCMU。
- 双方注册到可互通的服务器,或使用 IP 直呼。
- 先用 MicroSIP/Linphone 之类的软电话做一次对照测试。
参考文档:SIP 通话演示 https://docs.openluat.com/air8000/luatos/app/multimedia/sip/ 。
31. Air780EGH的固件在哪里下载?
解答: 结论:Air780EGH 的固件下载页就是 Air780EGG 与 Air780EGH 的共用版本页,链接见下方;Air780EGP 另有独立版本页。
说明:合宙把这几个同系列型号的固件放在同一个版本页上发布,下载时按页面里标注的型号选对应的 .soc 文件即可。
处理步骤:
- 打开下方版本页,确认型号与版本号。
- 下载对应
.soc固件。 - 用 Luatools 按固件页的烧录说明写入。
参考文档:Air780EGG/Air780EGH 固件版本页 https://docs.openluat.com/air780egh/luatos/firmware/780egg%26780egh_version/ 。
32. Air8780s1烧录不进去程序、串口一直跳、设备重启是什么原因?
解答: 结论:优先排查供电与复位:检查 USB 供电部分的焊接是否可靠,换一根短一点的手机充电线供电,并确认看门狗是否在反复复位。 说明:烧录过程中设备不断重启、串口一直跳,最常见的原因是供电电压跌落或接触不良(线材太长太细、USB 座虚焊);另外板载看门狗超时也会造成周期性复位,让下载过程始终无法完成。 处理步骤:
- 换一根短而可靠的 USB 数据线,确认供电电压稳定。
- 检查 USB 座与供电通路的焊接。
- 确认看门狗没有持续复位,必要时先禁用再烧录。
- 用 Luatools 观察能否正常进入下载模式。
参考文档:Air8780 硬件资料 https://docs.openluat.com/air8780/hardware/ 。
33. Air780EHM+1103需要定制吗?大致定制费用是多少?
解答: 结论:Air780EHM + Air1103 的自研板定制只支持少量客户,付 3 万元定金即可支持开发,后续批量出货 5k 套后可以抵扣货款。 说明:合宙推荐的做法是:客户负责产品定义,第一版软硬件由合宙定制开发,交付原理图/PCB 设计文件以及软件源码。后续会推出把 780 与 1103 做在一起的 8701,届时可减少定制需求。 处理步骤:
- 明确产品定义、数量与节奏。
- 联系合宙任意一位同事确认定制范围与定金事宜。
- 若可以等待,关注 8701 集成型号的发布。
参考文档:Air8784 SIP 对讲方案 https://docs.openluat.com/air8784/product/ 。
34. Air1103的价格是多少?
解答: 结论:Air1103 单价 10 元、Air780EHM 单价 18.8 元,两者合计 28.8 元,含税。 说明:这套组合是 SIP/VoLTE 通话方案的核心:Air780EHM 提供 4G 通信,Air1103 提供回声抑制与 Audio Codec。相比 Air780EHV + ES8311 的方案,它可以省掉外挂的 codec 芯片,Air1103 与主控之间走 UART 而不是 I2S。 处理步骤:
- 按「Air780EHM + Air1103」成套估算 BOM 成本。
- 批量价格与交期联系合宙同事确认。
参考文档:Air1103 AI 语音芯片手册 https://docs.openluat.com/air8784/product/air1103/ 。
35. Air8000开发板RTU设备开启以太网、4G和触摸屏后不停重启,外部供电应该怎么接?
解答: 结论:把开发板上的供电拨动开关拨到「外部供电」一端,再从 4V 与 GND 两个针脚外部供一个稳定的 DC 4V 即可。 说明:同时开启以太网、4G 和触摸屏后,板子整体电流需求明显上升,仅靠 USB 口供电会出现电压跌落,于是不停重启。改用外部稳压 4V 供电可以解决供电能力不足的问题。 处理步骤:
- 把供电拨动开关切到「外部供电」一端。
- 从 4V 与 GND 两个针脚接入稳定的 DC 4V 电源,注意极性与电流余量。
- 重新上电,确认不再反复重启。
参考文档:Air8000 相关资料 https://docs.openluat.com/air8000/ 。
36. Air8000开发板后期有没有改版?板子上缺3.3V和5V供电插针,有没有外壳?
解答: 结论:目前还没有改版计划,板上也不会再增加 3.3V 和 5V 供电插针;官方暂时没有配套外壳。 说明:现有开发板的额外供电需求可以通过拨动开关切换 + 外部 4V 针脚来解决;如果确实需要 3.3V/5V 电压域,可用外部电源模块自行引出。外壳属于结构件,需要时自行设计或 3D 打印。 处理步骤:
- 需要额外电压时自行引出或用外部电源模块。
- 外壳可自行设计,合宙后续会陆续发布一些 3D 打印外壳资源。
参考文档:Air8000 相关资料 https://docs.openluat.com/air8000/ 。
37. Air780EHM快递柜模块,有显示屏使用的情况下这些脚还可以用作GPIO吗?互斥吗?
解答: 结论:屏幕没有用到这几个脚,因此它们仍可以当普通 GPIO 使用,与显示屏不互斥。 说明:Air780EHM 快递柜方案(turnkey 开发板)的屏幕占用的是固定的一组 LCD/RGB 接口脚,与提问的这几个脚并不重叠。不过配置前仍建议对照该开发板的管脚定义表逐脚确认一遍,避免与其它外设冲突。 处理步骤:
- 对照 Air780EHM turnkey 开发板管脚定义表,确认目标脚未被屏幕或其它外设占用。
- 按 pins 配置使用这些脚作为普通 GPIO。
参考文档:Air780EHM 快递柜开发板 https://docs.openluat.com/air780epm/product/air780ehm_turnkey_devboard/ 。
38. Air1601和1602摄像头识别二维码功能完善了吗?
解答: 结论:已经支持。Air1601/Air1602 以及 Air8000/780EPM 的网络摄像头二维码识别功能都已支持。 说明:Air1601/Air1602 属于多媒体 SoC,摄像头相关的多媒体应用里包含二维码识别能力;Air8000/780EPM 侧则是通过网络摄像头做识别。识别效果与摄像头模组规格、光照条件和安装距离有关,建议先用官方 demo 验证。 处理步骤:
- 把固件升级到最新版本。
- 参考对应型号的多媒体/摄像头应用文档做配置。
- 用官方 demo 先验证识别效果,再按现场光照与距离调优。
参考文档:Air1601 多媒体应用 https://docs.openluat.com/air1601/luatos/app/multimedia/ 。
39. Air780EPM 2.6.2物联网VPDN规范支持吗?
解答: 尚未解答
40. Air8783/780EPM用专网卡非NAT模式RNDIS失败,NAT模式正常是什么原因?
解答: 尚未解答
41. AirCAMERA_1034模组究竟是3.3V还是5V接入?
解答: 结论:不是「3.3V 还是 5V」二选一的问题——USB 和 UART 两路电源要同时接,而且要接的是同一个电源。 说明:AirCAMERA_1034 需要 USB(供电+数据)和 UART(控制)两路同时工作。如果两路来自不同的电源,两个接口之间会形成电位差,轻则通信异常,重则损坏器件,所以务必共电源、共地。 处理步骤:
- 确认 USB 与 UART 两路都由同一个电源供电、可靠共地。
- 核对信号电平与模组电压域是否匹配。
- 检查上电顺序,避免先上其中一路。
参考文档:AirCAMERA_1034 配件说明 https://docs.openluat.com/accessory/AirCAMERA_1034/ 。
42. Air780EHM+1103想做成低功耗可以吗?离线语音怎么用有API吗?
解答: 结论:可以做成低功耗方案,原理图里带电源控制逻辑,具体做法参考 Air8784 原理图;离线语音有对应 API,参考 Air1103 的 LuatOS 扩展库文档。 说明:Air1103 把离线语音识别/唤醒、AEC 回声消除、Audio Codec 都集成在芯片里,主控只通过一路 UART 收发。做低功耗要在硬件侧对 Air1103 及外围做电源控制——不用语音时把它整体断电。 处理步骤:
- 按 Air8784 原理图(含 PMOS 电源控制)设计低功耗通路。
- 空闲时切断 Air1103 供电。
- 离线语音的初始化、上行录音、下行播放 API 参考 Air1103 文档的 LuatOS 扩展库用法。
参考文档:Air1103 AI 语音芯片手册 https://docs.openluat.com/air8784/product/air1103/ 。
43. SIP服务器收费标准大概什么时候出来?
解答: 尚未解答
44. Air1601/Air1602除了Pin43配置为GPIO13需要调用pins.setup外,其余IO无需配置吗?
解答: 结论:是的。Air1601/Air1602 除了把 Pin43 配置为 GPIO13 需要调用 pins.setup(43, "GPIO13") 之外,其余 IO 都不需要执行 pins.setup 配置。
说明:Pin43 默认复用为 AirLink_WAKEUP(输出),要当 GPIO13 使用必须显式配置。该脚同时也可复用为 PWM,例如用于 LCD 背光亮度控制,此时 AirLink_WAKEUP 需要改用其它 GPIO 代替。
处理步骤:
- 需要 GPIO13 时调用
pins.setup(43, "GPIO13")。 - 其余 IO 直接使用,不需要 pins.setup。
- 若 Pin43 用作 PWM 背光,把 AirLink_WAKEUP 换到别的 GPIO。
参考文档:Air1601/Air1602 硬件管脚说明 https://docs.openluat.com/air1601/luatos/hardware/ 。
45. Air8202开发板想接TF卡,有接口吗?
解答: 尚未解答
46. Air780EPM接软件I2C时,SDA置低电平电压不是0V是什么原因?
解答: 结论:因为 GPIO52 引脚内部本身带有约 10K 的电阻,用软件模拟 I2C 时 SDA 无法被真正拉到 0V;这类场景建议改用硬件 I2C。 说明:I2C 是开漏总线,靠外部上拉产生高电平。软件模拟时如果引脚内部存在约 10K 的等效电阻,输出低电平时会与内部电阻形成分压,低电平被抬高到明显高于 0V,从机就可能识别不到。Air780EPM 推荐使用硬件 I2C1(SCL = GPIO67、SDA = GPIO66),默认需外接 4.7kΩ~10kΩ 上拉电阻。 处理步骤:
- 改用硬件 I2C1(GPIO66/GPIO67)。
- 外接 4.7kΩ~10kΩ 上拉电阻;外设已内置上拉时不要重复配置。
- 注意 I2C 电压域(1.8V 或 3.3V)与外设电平匹配。
参考文档:Air780EPM I2C 硬件电路说明 https://docs.openluat.com/air780epm/luatos/hardware/design/i2c/ 。
47. Air780EPM的VPDN专网卡非NAT RNDIS失败,是否与2.6.1/2.6.2规范有关?
解答: 尚未解答
48. Air8000/780EPM要开发网络摄像头识别二维码功能吗?
解答: 结论:已经支持。Air1601/Air1602 以及 Air8000/780EPM 的网络摄像头二维码识别功能都已支持。 说明:Air1601/Air1602 属于多媒体 SoC,摄像头相关的多媒体应用里包含二维码识别能力;Air8000/780EPM 侧则是通过网络摄像头做识别。识别效果与摄像头模组规格、光照条件和安装距离有关,建议先用官方 demo 验证。 处理步骤:
- 把固件升级到最新版本。
- 参考对应型号的多媒体/摄像头应用文档做配置。
- 用官方 demo 先验证识别效果,再按现场光照与距离调优。
参考文档:Air1601 多媒体应用 https://docs.openluat.com/air1601/luatos/app/multimedia/ 。
49. 使用AI工具(如Trae/CodeBuddy)配置LuatOS MCP连接失败怎么办?
解答: 结论:先把 AI 智能体升级到最新版,基本就没问题;也可以把官网 docs.openluat.com 直接丢给 AI 去读。 说明:LuatOS 的 MCP 接入依赖智能体客户端自身的版本与配置格式,旧版本容易出现连接失败。合宙另外提供了 MCP 命令行工具与使用说明,可以作为对照。 处理步骤:
- 把 AI 客户端(Trae / CodeBuddy 等)升级到最新版。
- 按官方 MCP 文档填写 server 配置后重试。
- 仍失败时改为让 AI 直接读 docs.openluat.com 检索资料。
参考文档:LuatOS MCP 使用说明 https://docs.openluat.com/ai/mcp_cli/ 。
50. Air780EPM模组两个卡座都用移动卡是否就不会出现4分钟入网情况?
解答: 尚未解答
51. Air8784整机买一对多少钱?可以先测试再合作吗?
解答: 结论:Air8784 整机单个 299 元、一对 399 元,购买链接见下方;可以先买一对体验测试,有信心后再谈方案合作,方案/整机成本需要先明确合作方式。 说明:整机包含 Air780EHM + Air1103 的回声抑制方案;购买整机后可以联系合宙任意一位同事,协调提供 Air8784 整套原理图/PCB 硬件设计文件与软件源码。 处理步骤:
- 通过淘宝链接 https://e.tb.cn/h.8wEyOKEMXYWLHXC?tk=XNv5TM7A6Jv 购买整机(一个 299 元、两个 399 元)先做体验测试。
- 验证零回声通话效果后,再与合宙同事谈定制或批量合作。
- 方案成本按实际合作方式另行确认。
参考文档:Air8784 SIP 对讲方案 https://docs.openluat.com/air8784/product/ 。
52. Air1103是否可以不搭配4G模组单独购买?
解答: 结论:不单独对外出售 Air1103,必须搭配 Air780EHM(或合宙其它主控模组)一起购买;可以单独买 Air780EHM。 说明:Air1103 是一颗串口 AI 语音芯片,把麦克风采集、喇叭播放与 3A 语音算法(ANS 降噪 + AEC 回声消除 + ASR 识别)集成在一起,主控只要一路 UART(2Mbps)即可。它的回声抑制效果依赖与主控的联合标定,因此合宙要求搭配自家模组使用,不建议搭配其它主控。 处理步骤:
- 选型时按「Air780EHM + Air1103」成套采购。
- 不要在第三方主控上单独使用 Air1103。
参考文档:Air1103 AI 语音芯片手册 https://docs.openluat.com/air8784/product/air1103/ 。
53. Air780EPT的资料在哪里下载?
解答: 结论:Air780EPT 目前没有独立的公开资料页,可以问 ai.luatos.com,让它给出对应链接。 说明:部分新发布的衍生型号资料还在整理归档中,官方建议通过 AI 问答入口获取最新的资料位置,比自己在站点里翻找更准。 处理步骤:
- 打开 ai.luatos.com,直接提问型号与需要的资料类型。
- 拿到链接后核对型号是否一致,再下载。
参考文档:合宙 AI 问答入口 https://docs.openluat.com/ 。
54. Air780EPT的34脚和35脚购买样品是短路的,是什么情况?
解答: 结论:不要用「测天线引脚是否短路」来判断好坏——天线馈电脚上并着匹配/馈电元件,直流上量起来近似短路是正常现象,模块可以正常使用。 说明:天线脚通常串有匹配元件,或者是有源天线的馈电通路,直流电阻很低甚至接近短路并不代表故障。判断天线通路是否正常,应该看实际接收到的信号强度或能否定位,而不是万用表的直流电阻。 处理步骤:
- 不要用万用表直流档去测天线脚是否短路。
- 装机后直接验证 4G 信号强度或 GNSS 收星情况。
参考文档:Air780Exx 管脚说明 https://docs.openluat.com/air780epm/product/air780exx/ 。
55. Air780EPM PIN84引脚上电默认是高电平,是GPIO10/SPI0_MISO/UART2_RXD复用引脚吗?
解答: 结论:Air780EPM 的 PIN84 上电默认是「非高非低」的高阻悬空状态,实际电平由外部上拉或下拉决定;该脚复用为 SPI0_MISO / GPIO10。 说明:文档管脚表里 PIN84 的默认状态写的就是「悬空」,所以既不是高电平也不是低电平。要让它有确定电平,必须在外部加上拉或下拉电阻。它同时是 SPI0 的数据输入脚(MISO)与 GPIO10。 处理步骤:
- 需要固定电平时,在外部加合适的上下拉电阻。
- 用作普通 IO 时,按复用表配置为 GPIO10。
- 用作 SPI0 时,不要再把它当普通 GPIO 使用。
参考文档:Air780Exx 管脚说明 https://docs.openluat.com/air780epm/product/air780exx/ 。
56. Air780EHM快递柜模块,SIM卡89860492192070711013恢复一下
解答: 尚未解答
57. Air1602是否不建议用软件I2C,最好用硬件I2C?
解答: 尚未解答
58. Air8784的回声抑制效果如何?
解答: 结论:Air8784 的回声抑制效果很好,属于「免提接近零回声」的级别,收到货后可以直接通话验证。 说明:Air8784 由 Air780EHM 与 Air1103 组成,Air1103 内置 AEC 回声消除与 ANS 降噪算法,而且声学环境在出厂阶段就已经调好,不是「理论上可行」。判断方法很简单:让对方听免提通话里能不能听到他自己的声音。 处理步骤:
- 收到整机后拨一通免提电话,问对端能否听到自己的声音。
- 若仍有回声,检查喇叭/麦克风的安装结构与增益设置,必要时联系 FAE。
参考文档:Air8784 SIP 对讲方案 https://docs.openluat.com/air8784/product/ 。
59. Air780EPM共5个模组远程升级提示失败无权限是什么原因?
解答: 结论:这是「设备没有归属」导致的——把设备添加到自己账号的项目下即可恢复远程升级权限。 说明:合宙远程升级(IOT 平台)按设备归属做权限校验:设备没有归属时,在项目里看不到它,自然也就提示无权限。归属绑定完成后即可在项目下管理并升级。 处理步骤:
- 登录 IOT 平台并进入目标项目。
- 按《设备归属》文档把设备(IMEI)添加进项目。
- 重新发起远程升级,确认项目里已经能看到该设备。
参考文档:设备归属说明 https://docs.openluat.com/air780epm/product/attributioniot/ 。
60. Air780EPM模组想接TF卡,有接口吗?
解答: 尚未解答
61. Air780EHV/Air780EGH模组RNDIS拨号联网需要烧录特殊固件吗?
解答: 结论:出厂固件支持 RNDIS,但需要手动打开;参考 mobile 库的用法并对照官方 rndis_ecm demo。 说明:RNDIS/ECM 是把模组当作 USB 网卡使用的联网方式,需要脚本里显式使能网络模式,默认不会自动开启。不同型号的入口略有差异,但都通过 mobile 库的网络模式配置项控制。 处理步骤:
- 参考 mobile 库说明配置 RNDIS/ECM 网络模式。
- 烧录官方 rndis_ecm demo 做对照验证。
- 在电脑端确认出现 RNDIS 网卡并成功获取 IP。
参考文档:RNDIS/ECM 说明 https://docs.openluat.com/air780egh/luatos/app/common/rndis/ 。
62. Air780EPM 2.6.2物联网VPDN规范支持吗?
解答: 尚未解答
63. Air8780V2是否有SIP demo?
解答: 结论:官方 SIP 测试服务器的账号权限与整机购买绑定——购买 Air8784 整机才会给到测试权限;Air8780V2 不要用来评估 SIP,建议用 8784 测试。 说明:Air8780V 系列不配 Air1103,没有 AEC 回声抑制,免提/对讲场景下回声压不住,测出来的效果不能代表正式方案;Air8780V2 也没有公开的 SIP demo 资源。 处理步骤:
- 用 Air8784 整机申请测试权限并完成注册。
- 不要用 Air8780V2 评估 SIP 通话效果。
- 确实需要 8780 系列的 SIP 能力,联系 FAE 确认是否有对应方案。
参考文档:Air8784 SIP 对讲方案 https://docs.openluat.com/air8784/product/ 。
64. Air780EPM/SIP服务器收费标准大概什么时候出来?
解答: 尚未解答
65. Air1602是否建议使用硬件I2C?
解答: 尚未解答
66. Air8784 SIP整机是否可以注册到GB28181-2016平台?
解答: 结论:可以。Air8784 SIP 整机正在开发对 GB28181-2016 平台的适配,预计 10 月推出。 说明:GB28181 是国标视频监控联网协议,整机接入需要在平台侧完成信令与媒体流的适配,属于软件侧开发工作;合宙已经在推进。 处理步骤:
- 先用标准 SIP 服务器验证整机通话链路是否正常。
- 需要接入 GB28181 平台,关注版本发布或联系 FAE 确认时间点。
参考文档:Air8784 SIP 对讲方案 https://docs.openluat.com/air8784/product/ 。
67. Air1103是否必须搭配合宙4G模组Air780EHM使用?
解答: 结论:不单独对外出售 Air1103,必须搭配 Air780EHM(或合宙其它主控模组)一起购买;可以单独买 Air780EHM。 说明:Air1103 是一颗串口 AI 语音芯片,把麦克风采集、喇叭播放与 3A 语音算法(ANS 降噪 + AEC 回声消除 + ASR 识别)集成在一起,主控只要一路 UART(2Mbps)即可。它的回声抑制效果依赖与主控的联合标定,因此合宙要求搭配自家模组使用,不建议搭配其它主控。 处理步骤:
- 选型时按「Air780EHM + Air1103」成套采购。
- 不要在第三方主控上单独使用 Air1103。
参考文档:Air1103 AI 语音芯片手册 https://docs.openluat.com/air8784/product/air1103/ 。
68. Air780EHM+1103想自己设计板子,是否需要交3万元定金?
解答: 结论:Air780EHM + Air1103 的自研板定制只支持少量客户,付 3 万元定金即可支持开发,后续批量出货 5k 套后可以抵扣货款。 说明:合宙推荐的做法是:客户负责产品定义,第一版软硬件由合宙定制开发,交付原理图/PCB 设计文件以及软件源码。后续会推出把 780 与 1103 做在一起的 8701,届时可减少定制需求。 处理步骤:
- 明确产品定义、数量与节奏。
- 联系合宙任意一位同事确认定制范围与定金事宜。
- 若可以等待,关注 8701 集成型号的发布。
参考文档:Air8784 SIP 对讲方案 https://docs.openluat.com/air8784/product/ 。
69. Air780EPM远程升级无权限、设备找不到怎么办?
解答: 结论:这是「设备没有归属」导致的——把设备添加到自己账号的项目下即可恢复远程升级权限。 说明:合宙远程升级(IOT 平台)按设备归属做权限校验:设备没有归属时,在项目里看不到它,自然也就提示无权限。归属绑定完成后即可在项目下管理并升级。 处理步骤:
- 登录 IOT 平台并进入目标项目。
- 按《设备归属》文档把设备(IMEI)添加进项目。
- 重新发起远程升级,确认项目里已经能看到该设备。
参考文档:设备归属说明 https://docs.openluat.com/air780epm/product/attributioniot/ 。
70. Air780EPM 64位固件fskv.set报错怎么办?
解答: 结论:fskv.set 的值只允许 boolean / number / string / table;删除键必须用 fskv.del(key)(table 的子键用 fskv.sett(t, k, nil)),不能靠写入特殊值来删。64 位固件上旧数据出现的垃圾值,是 32 位时期按 4 字节存数、64 位固件按 8 字节读取造成的。
说明:fskv 是 KV 存储,底层按数据类型打标记:允许 boolean、number、string、table,遇到 function / userdata / nil / thread 就会报 isn't allow。另外 32 位与 64 位固件的 number 存储宽度不同(4 字节 vs 8 字节),32 位固件写下的整数在 64 位固件里按 8 字节读,就会被解析成垃圾数据,于是告警和脏数据会一起出现。
处理步骤:
- 在切到 64 位固件前先清空 fskv,或把已有键逐个重写一遍。
- 删除键统一用
fskv.del(key);删除 table 子键用fskv.sett(t, k, nil)。 - 不要在 fskv 里存放 function / userdata / thread 等类型。
参考文档:fskv 扩展库说明 https://docs.openluat.com/air780epm/luatos/app/common/fskv/ 。
71. Luatools模拟运行闪退怎么办?
解答: 尚未解答
72. Air780EX量产烧录工具ini修改后还原怎么办?
解答: 结论:这是工具对非英文路径/非 ANSI 编码支持不好导致的——先关掉工具,把固件包放到纯英文目录、文件名也改成纯英文,把 ini 里的路径改成纯英文并「另存为 ANSI」编码,再重新打开工具;也可以改用合宙量产烧录工具。 说明:老版批量烧录工具在读取 ini 时对中文路径和 UTF-8 编码的处理不完善,重启工具时会回落到默认配置,把之前的修改覆盖掉,于是表现为「改完又还原」「下载报错」。 处理步骤:
- 关闭烧录工具。
- 把固件包复制到纯英文目录,文件名也改成纯英文。
- 把 ini 里的路径全部改为纯英文,另存为时编码选 ANSI。
- 重新打开工具确认配置已生效;仍不行就换合宙量产烧录工具。
参考文档:Luatools 工具说明 https://docs.openluat.com/common/Luatools/ 。
73. Air8784整机购买链接是什么?多少钱?
解答: 结论:Air8784 整机单个 299 元、一对 399 元,购买链接见下方;可以先买一对体验测试,有信心后再谈方案合作,方案/整机成本需要先明确合作方式。 说明:整机包含 Air780EHM + Air1103 的回声抑制方案;购买整机后可以联系合宙任意一位同事,协调提供 Air8784 整套原理图/PCB 硬件设计文件与软件源码。 处理步骤:
- 通过淘宝链接 https://e.tb.cn/h.8wEyOKEMXYWLHXC?tk=XNv5TM7A6Jv 购买整机(一个 299 元、两个 399 元)先做体验测试。
- 验证零回声通话效果后,再与合宙同事谈定制或批量合作。
- 方案成本按实际合作方式另行确认。
参考文档:Air8784 SIP 对讲方案 https://docs.openluat.com/air8784/product/ 。
74. Air8202开发板能否把电池改成软包电池上下叠加?
解答: 结论:可以。外壳结构可以自行设计,电池容量 1000mAh 左右基本够用,注意不要把电池放到 4G 天线底下。 说明:Air8202C/G 原厂采用 2000mAh 的 18500 电池、充电电流默认 500mA。换成软包电池主要是结构适配问题,容量可以按实际功耗和续航需求调整,1000mAh 量级对常见场景已经够用。 处理步骤:
- 按软包电池尺寸重新做外壳叠层。
- 电池远离 4G 天线区域,避免遮挡和干扰。
- 按电池实际容量调整充电电流配置。
参考文档:Air8202 产品说明 https://docs.openluat.com/air8202/product/ 。
75. 你们有北斗的贴片陶瓷天线吗?
解答: 结论:Air8202 上用的是 18×18 的北斗/GNSS 贴片陶瓷天线(有标品,立创等渠道可以买到);合宙官网出售的是 25×25 版本。 说明:贴片陶瓷天线的实际性能与主板尺寸、外壳材质、天线周边空间密切相关,即便是标品也需要针对具体结构做匹配调试;无源陶瓷天线的匹配通常是通过调整天线顶部的银粉,结合整机结构来完成的。 处理步骤:
- 按模块设计要求选择 18×18 或 25×25 规格。
- PCB 上预留 π 型匹配电路。
- 整机结构定稿后,找专业天线厂针对主板和外壳做匹配调试。
参考文档:Air8202 产品说明 https://docs.openluat.com/air8202/product/ 。
76. Air780EPM PIN84引脚上电默认是高电平吗?
解答: 结论:Air780EPM 的 PIN84 上电默认是「非高非低」的高阻悬空状态,实际电平由外部上拉或下拉决定;该脚复用为 SPI0_MISO / GPIO10。 说明:文档管脚表里 PIN84 的默认状态写的就是「悬空」,所以既不是高电平也不是低电平。要让它有确定电平,必须在外部加上拉或下拉电阻。它同时是 SPI0 的数据输入脚(MISO)与 GPIO10。 处理步骤:
- 需要固定电平时,在外部加合适的上下拉电阻。
- 用作普通 IO 时,按复用表配置为 GPIO10。
- 用作 SPI0 时,不要再把它当普通 GPIO 使用。
参考文档:Air780Exx 管脚说明 https://docs.openluat.com/air780epm/product/air780exx/ 。
77. Air780EPM双卡切换联通4分钟才入网是什么原因?
解答: 尚未解答
78. Air8784 SIP方案能否和其他家的VOIP电话连通?
解答: 结论:可以。只要对端设备或平台支持标准 SIP 协议,就能和 Air8784 的 SIP 方案互通。 说明:SIP 是开放标准协议,互通性取决于双方对信令与语音编码的协商结果。合宙 SIP 方案使用标准 SIP 与 G.711 窄带编码(PCMA/PCMU),因此只要对端同样支持标准 SIP 与这两种编码,互通就没有障碍。 处理步骤:
- 确认对端支持标准 SIP,并支持 PCMA 或 PCMU。
- 双方注册到可互通的服务器,或使用 IP 直呼。
- 先用 MicroSIP/Linphone 之类的软电话做一次对照测试。
参考文档:SIP 通话演示 https://docs.openluat.com/air8000/luatos/app/multimedia/sip/ 。
79. Air780EGH的固件在哪里下载?
解答: 结论:Air780EGH 的固件下载页就是 Air780EGG 与 Air780EGH 的共用版本页,链接见下方;Air780EGP 另有独立版本页。
说明:合宙把这几个同系列型号的固件放在同一个版本页上发布,下载时按页面里标注的型号选对应的 .soc 文件即可。
处理步骤:
- 打开下方版本页,确认型号与版本号。
- 下载对应
.soc固件。 - 用 Luatools 按固件页的烧录说明写入。
参考文档:Air780EGG/Air780EGH 固件版本页 https://docs.openluat.com/air780egh/luatos/firmware/780egg%26780egh_version/ 。
80. Air8780s1烧录不进去程序、串口一直跳是什么原因?
解答: 结论:优先排查供电与复位:检查 USB 供电部分的焊接是否可靠,换一根短一点的手机充电线供电,并确认看门狗是否在反复复位。 说明:烧录过程中设备不断重启、串口一直跳,最常见的原因是供电电压跌落或接触不良(线材太长太细、USB 座虚焊);另外板载看门狗超时也会造成周期性复位,让下载过程始终无法完成。 处理步骤:
- 换一根短而可靠的 USB 数据线,确认供电电压稳定。
- 检查 USB 座与供电通路的焊接。
- 确认看门狗没有持续复位,必要时先禁用再烧录。
- 用 Luatools 观察能否正常进入下载模式。
参考文档:Air8780 硬件资料 https://docs.openluat.com/air8780/hardware/ 。
81. Air780EHM+1103定制费用大概多少?
解答: 结论:Air780EHM + Air1103 的自研板定制只支持少量客户,付 3 万元定金即可支持开发,后续批量出货 5k 套后可以抵扣货款。 说明:合宙推荐的做法是:客户负责产品定义,第一版软硬件由合宙定制开发,交付原理图/PCB 设计文件以及软件源码。后续会推出把 780 与 1103 做在一起的 8701,届时可减少定制需求。 处理步骤:
- 明确产品定义、数量与节奏。
- 联系合宙任意一位同事确认定制范围与定金事宜。
- 若可以等待,关注 8701 集成型号的发布。
参考文档:Air8784 SIP 对讲方案 https://docs.openluat.com/air8784/product/ 。
82. Air1103的价格是多少?
解答: 结论:Air1103 单价 10 元、Air780EHM 单价 18.8 元,两者合计 28.8 元,含税。 说明:这套组合是 SIP/VoLTE 通话方案的核心:Air780EHM 提供 4G 通信,Air1103 提供回声抑制与 Audio Codec。相比 Air780EHV + ES8311 的方案,它可以省掉外挂的 codec 芯片,Air1103 与主控之间走 UART 而不是 I2S。 处理步骤:
- 按「Air780EHM + Air1103」成套估算 BOM 成本。
- 批量价格与交期联系合宙同事确认。
参考文档:Air1103 AI 语音芯片手册 https://docs.openluat.com/air8784/product/air1103/ 。
83. Air8000开发板RTU设备开启以太网、4G和触摸屏后不停重启怎么办?
解答: 结论:把开发板上的供电拨动开关拨到「外部供电」一端,再从 4V 与 GND 两个针脚外部供一个稳定的 DC 4V 即可。 说明:同时开启以太网、4G 和触摸屏后,板子整体电流需求明显上升,仅靠 USB 口供电会出现电压跌落,于是不停重启。改用外部稳压 4V 供电可以解决供电能力不足的问题。 处理步骤:
- 把供电拨动开关切到「外部供电」一端。
- 从 4V 与 GND 两个针脚接入稳定的 DC 4V 电源,注意极性与电流余量。
- 重新上电,确认不再反复重启。
参考文档:Air8000 相关资料 https://docs.openluat.com/air8000/ 。
84. Air8000开发板后期有没有改版?有没有外壳?
解答: 结论:目前还没有改版计划,板上也不会再增加 3.3V 和 5V 供电插针;官方暂时没有配套外壳。 说明:现有开发板的额外供电需求可以通过拨动开关切换 + 外部 4V 针脚来解决;如果确实需要 3.3V/5V 电压域,可用外部电源模块自行引出。外壳属于结构件,需要时自行设计或 3D 打印。 处理步骤:
- 需要额外电压时自行引出或用外部电源模块。
- 外壳可自行设计,合宙后续会陆续发布一些 3D 打印外壳资源。
参考文档:Air8000 相关资料 https://docs.openluat.com/air8000/ 。
85. Air780EHM快递柜模块,有显示屏使用时这些脚还可以用作GPIO吗?
解答: 结论:屏幕没有用到这几个脚,因此它们仍可以当普通 GPIO 使用,与显示屏不互斥。 说明:Air780EHM 快递柜方案(turnkey 开发板)的屏幕占用的是固定的一组 LCD/RGB 接口脚,与提问的这几个脚并不重叠。不过配置前仍建议对照该开发板的管脚定义表逐脚确认一遍,避免与其它外设冲突。 处理步骤:
- 对照 Air780EHM turnkey 开发板管脚定义表,确认目标脚未被屏幕或其它外设占用。
- 按 pins 配置使用这些脚作为普通 GPIO。
参考文档:Air780EHM 快递柜开发板 https://docs.openluat.com/air780epm/product/air780ehm_turnkey_devboard/ 。
86. Air1601和1602摄像头识别二维码功能完善了吗?
解答: 结论:已经支持。Air1601/Air1602 以及 Air8000/780EPM 的网络摄像头二维码识别功能都已支持。 说明:Air1601/Air1602 属于多媒体 SoC,摄像头相关的多媒体应用里包含二维码识别能力;Air8000/780EPM 侧则是通过网络摄像头做识别。识别效果与摄像头模组规格、光照条件和安装距离有关,建议先用官方 demo 验证。 处理步骤:
- 把固件升级到最新版本。
- 参考对应型号的多媒体/摄像头应用文档做配置。
- 用官方 demo 先验证识别效果,再按现场光照与距离调优。
参考文档:Air1601 多媒体应用 https://docs.openluat.com/air1601/luatos/app/multimedia/ 。
87. Air780EPM支持2.6.2物联网VPDN规范吗?
解答: 尚未解答
88. Air8783/780EPM用专网卡非NAT模式RNDIS失败是什么原因?
解答: 尚未解答
89. AirCAMERA_1034模组用3.3V还是5V接入?
解答: 结论:不是「3.3V 还是 5V」二选一的问题——USB 和 UART 两路电源要同时接,而且要接的是同一个电源。 说明:AirCAMERA_1034 需要 USB(供电+数据)和 UART(控制)两路同时工作。如果两路来自不同的电源,两个接口之间会形成电位差,轻则通信异常,重则损坏器件,所以务必共电源、共地。 处理步骤:
- 确认 USB 与 UART 两路都由同一个电源供电、可靠共地。
- 核对信号电平与模组电压域是否匹配。
- 检查上电顺序,避免先上其中一路。
参考文档:AirCAMERA_1034 配件说明 https://docs.openluat.com/accessory/AirCAMERA_1034/ 。
90. Air780EHM+1103能做成低功耗吗?离线语音怎么用?
解答: 结论:可以做成低功耗方案,原理图里带电源控制逻辑,具体做法参考 Air8784 原理图;离线语音有对应 API,参考 Air1103 的 LuatOS 扩展库文档。 说明:Air1103 把离线语音识别/唤醒、AEC 回声消除、Audio Codec 都集成在芯片里,主控只通过一路 UART 收发。做低功耗要在硬件侧对 Air1103 及外围做电源控制——不用语音时把它整体断电。 处理步骤:
- 按 Air8784 原理图(含 PMOS 电源控制)设计低功耗通路。
- 空闲时切断 Air1103 供电。
- 离线语音的初始化、上行录音、下行播放 API 参考 Air1103 文档的 LuatOS 扩展库用法。
参考文档:Air1103 AI 语音芯片手册 https://docs.openluat.com/air8784/product/air1103/ 。
91. SIP服务器收费标准大概什么时候出来?
解答: 尚未解答
92. Air1601/Air1602除Pin43需调用pins.setup外其余IO无需配置吗?
解答: 结论:是的。Air1601/Air1602 除了把 Pin43 配置为 GPIO13 需要调用 pins.setup(43, "GPIO13") 之外,其余 IO 都不需要执行 pins.setup 配置。
说明:Pin43 默认复用为 AirLink_WAKEUP(输出),要当 GPIO13 使用必须显式配置。该脚同时也可复用为 PWM,例如用于 LCD 背光亮度控制,此时 AirLink_WAKEUP 需要改用其它 GPIO 代替。
处理步骤:
- 需要 GPIO13 时调用
pins.setup(43, "GPIO13")。 - 其余 IO 直接使用,不需要 pins.setup。
- 若 Pin43 用作 PWM 背光,把 AirLink_WAKEUP 换到别的 GPIO。
参考文档:Air1601/Air1602 硬件管脚说明 https://docs.openluat.com/air1601/luatos/hardware/ 。
93. Air8202开发板想接TF卡有接口吗?
解答: 尚未解答
94. Air780EPM接软件I2C时SDA置低电平电压不是0V是什么原因?
解答: 结论:因为 GPIO52 引脚内部本身带有约 10K 的电阻,用软件模拟 I2C 时 SDA 无法被真正拉到 0V;这类场景建议改用硬件 I2C。 说明:I2C 是开漏总线,靠外部上拉产生高电平。软件模拟时如果引脚内部存在约 10K 的等效电阻,输出低电平时会与内部电阻形成分压,低电平被抬高到明显高于 0V,从机就可能识别不到。Air780EPM 推荐使用硬件 I2C1(SCL = GPIO67、SDA = GPIO66),默认需外接 4.7kΩ~10kΩ 上拉电阻。 处理步骤:
- 改用硬件 I2C1(GPIO66/GPIO67)。
- 外接 4.7kΩ~10kΩ 上拉电阻;外设已内置上拉时不要重复配置。
- 注意 I2C 电压域(1.8V 或 3.3V)与外设电平匹配。
参考文档:Air780EPM I2C 硬件电路说明 https://docs.openluat.com/air780epm/luatos/hardware/design/i2c/ 。
95. Air780EPM的VPDN专网卡非NAT RNDIS失败与2.6.1/2.6.2规范有关吗?
解答: 尚未解答
96. Air8000/780EPM要开发网络摄像头识别二维码功能吗?
解答: 结论:已经支持。Air1601/Air1602 以及 Air8000/780EPM 的网络摄像头二维码识别功能都已支持。 说明:Air1601/Air1602 属于多媒体 SoC,摄像头相关的多媒体应用里包含二维码识别能力;Air8000/780EPM 侧则是通过网络摄像头做识别。识别效果与摄像头模组规格、光照条件和安装距离有关,建议先用官方 demo 验证。 处理步骤:
- 把固件升级到最新版本。
- 参考对应型号的多媒体/摄像头应用文档做配置。
- 用官方 demo 先验证识别效果,再按现场光照与距离调优。
参考文档:Air1601 多媒体应用 https://docs.openluat.com/air1601/luatos/app/multimedia/ 。
97. 使用AI工具配置LuatOS MCP连接失败怎么办?
解答: 结论:先把 AI 智能体升级到最新版,基本就没问题;也可以把官网 docs.openluat.com 直接丢给 AI 去读。 说明:LuatOS 的 MCP 接入依赖智能体客户端自身的版本与配置格式,旧版本容易出现连接失败。合宙另外提供了 MCP 命令行工具与使用说明,可以作为对照。 处理步骤:
- 把 AI 客户端(Trae / CodeBuddy 等)升级到最新版。
- 按官方 MCP 文档填写 server 配置后重试。
- 仍失败时改为让 AI 直接读 docs.openluat.com 检索资料。
参考文档:LuatOS MCP 使用说明 https://docs.openluat.com/ai/mcp_cli/ 。
98. Air780EPM模组两个卡座都用移动卡是否就不会出现4分钟入网?
解答: 尚未解答
99. Air8784整机买一对多少钱?可以先测试再合作吗?
解答: 结论:Air8784 整机单个 299 元、一对 399 元,购买链接见下方;可以先买一对体验测试,有信心后再谈方案合作,方案/整机成本需要先明确合作方式。 说明:整机包含 Air780EHM + Air1103 的回声抑制方案;购买整机后可以联系合宙任意一位同事,协调提供 Air8784 整套原理图/PCB 硬件设计文件与软件源码。 处理步骤:
- 通过淘宝链接 https://e.tb.cn/h.8wEyOKEMXYWLHXC?tk=XNv5TM7A6Jv 购买整机(一个 299 元、两个 399 元)先做体验测试。
- 验证零回声通话效果后,再与合宙同事谈定制或批量合作。
- 方案成本按实际合作方式另行确认。
参考文档:Air8784 SIP 对讲方案 https://docs.openluat.com/air8784/product/ 。
100. Air1103是否可以不搭配4G模组单独购买?
解答: 结论:不单独对外出售 Air1103,必须搭配 Air780EHM(或合宙其它主控模组)一起购买;可以单独买 Air780EHM。 说明:Air1103 是一颗串口 AI 语音芯片,把麦克风采集、喇叭播放与 3A 语音算法(ANS 降噪 + AEC 回声消除 + ASR 识别)集成在一起,主控只要一路 UART(2Mbps)即可。它的回声抑制效果依赖与主控的联合标定,因此合宙要求搭配自家模组使用,不建议搭配其它主控。 处理步骤:
- 选型时按「Air780EHM + Air1103」成套采购。
- 不要在第三方主控上单独使用 Air1103。
参考文档:Air1103 AI 语音芯片手册 https://docs.openluat.com/air8784/product/air1103/ 。
101. Air780EPT的资料在哪里下载?
解答: 结论:Air780EPT 目前没有独立的公开资料页,可以问 ai.luatos.com,让它给出对应链接。 说明:部分新发布的衍生型号资料还在整理归档中,官方建议通过 AI 问答入口获取最新的资料位置,比自己在站点里翻找更准。 处理步骤:
- 打开 ai.luatos.com,直接提问型号与需要的资料类型。
- 拿到链接后核对型号是否一致,再下载。
参考文档:合宙 AI 问答入口 https://docs.openluat.com/ 。
102. Air780EPT的34脚和35脚购买样品是短路的,是什么情况?
解答: 结论:不要用「测天线引脚是否短路」来判断好坏——天线馈电脚上并着匹配/馈电元件,直流上量起来近似短路是正常现象,模块可以正常使用。 说明:天线脚通常串有匹配元件,或者是有源天线的馈电通路,直流电阻很低甚至接近短路并不代表故障。判断天线通路是否正常,应该看实际接收到的信号强度或能否定位,而不是万用表的直流电阻。 处理步骤:
- 不要用万用表直流档去测天线脚是否短路。
- 装机后直接验证 4G 信号强度或 GNSS 收星情况。
参考文档:Air780Exx 管脚说明 https://docs.openluat.com/air780epm/product/air780exx/ 。
103. Air780EPM PIN84引脚上电默认是高电平吗?
解答: 结论:Air780EPM 的 PIN84 上电默认是「非高非低」的高阻悬空状态,实际电平由外部上拉或下拉决定;该脚复用为 SPI0_MISO / GPIO10。 说明:文档管脚表里 PIN84 的默认状态写的就是「悬空」,所以既不是高电平也不是低电平。要让它有确定电平,必须在外部加上拉或下拉电阻。它同时是 SPI0 的数据输入脚(MISO)与 GPIO10。 处理步骤:
- 需要固定电平时,在外部加合适的上下拉电阻。
- 用作普通 IO 时,按复用表配置为 GPIO10。
- 用作 SPI0 时,不要再把它当普通 GPIO 使用。
参考文档:Air780Exx 管脚说明 https://docs.openluat.com/air780epm/product/air780exx/ 。