跳转至

常见问题 - 2026-11-02

数据日期:2026-11-02

1. Air8783在gitee上没有sms forward目录?

解答: 结论:没有独立的 sms_forward 目录。短信转发是出厂固件工程里的一组 Lua 文件,在 module/Air8783/project/factory/user 下。 说明:gitee 上 module/Air8783/project 只有 factory 一个子目录,factory/user 里是 main.lua、sms_app.lua、sms_bridge.lua、sms_callback.lua、wdt_app.lua、excloud_app.lua,短信转发就是 sms_* 这几个文件实现的(分流转发目标 + 短信指令本地配置)。所以按 sms_forward 这个名字找必然 404,这不是没登录 gitee 的问题——公开仓库未登录也能浏览,部分 /tree/master/ 深层路径返回 404/405 是 gitee 侧的限制,与登录无关。配置方法看文档站的《Air8783短信转发本地配置使用说明》。 处理步骤:① 打开 gitee 的 openLuat/LuatOS,进 module/Air8783/project/factory/user;② 重点看 sms_app / sms_bridge / sms_callback 三个文件;③ 按本地配置说明填转发地址;④ 网页打不开时用 gitee API 列目录:contents/module/Air8783/project/factory/user?ref=master。 参考文档:https://docs.openluat.com/air8783/product/config/

2. 8607A什么时候上架?

解答: 结论:官方答复是本周上架;实际开卖时间以官网型号页与淘宝店为准。 说明:Air8607A 与 Air8607 同属基于 Air1603 的大屏方案,文档站已经给 8607A 建了独立页面,列了主控平台、LCD 通路与 50PIN 连接器规格。但“文档页上线”和“可以下单”是两件事,量产状态要看发布节奏与供货批次。选型时先把屏尺寸、分辨率(1024×600 起,最高 1280×800)、触摸 IC 定下来,再决定 A 版还是标准版,避免上架后回头改结构。 处理步骤:① 关注 docs.openluat.com 的 Air8607A 页面更新;② 需要样机直接找销售确认批次;③ 提前锁定屏参(分辨率、时序、触摸型号);④ 打样前用最新资料核对连接器与开孔。 参考文档:https://docs.openluat.com/air8607a/

3. 1304/1034双目摄像头淘宝上架了吗?

解答: 尚未解答

4. 8603的以太网口能否用于向本地局域网服务器上传数据,还是只能给外设供网?

解答: 结论:不行。8603 的 RJ45 是给外接设备(IPC、摄像头)供网用的,板子自身业务数据走 4G,不能把网口当成本机连局域网服务器的通道。 说明:网口由 Air780EX2 加 SPI 以太网控制器 CH390H 组成,CH390H 是 MAC+PHY 一体、挂在 4G 模组侧的 SPI 上,配合转发固件把外接设备的流量从 4G 出口转发出去——也就是说以太网链路由 4G 侧管理,本机应用不在这条链路上。另外只有 M 系列默认具备这个能力,W 系列不默认具备;RJ45 不提供 PoE,摄像头要单独供电。所以“用网口把数据传给本地局域网服务器”这个用法,硬件通路上就不成立。 处理步骤:① 目的是把本机数据送到服务器,就走 4G + socket/MQTT 直连公网,或加 VPN 回内网;② 目的是给现场摄像头供网,确认是 M 系列并刷转发固件;③ 摄像头单独供电,不要指望 PoE;④ 需要两个网口等 8606。 参考文档:https://docs.openluat.com/air8603/

5. 触摸屏显示正常但触摸不行怎么排查?

解答: 结论:先按 GT911 + I2C 这条链路查,重点看触摸 IC 型号是否匹配、FPC 排线是上接还是下接、以及复位与中断脚是否正常。 说明:Air8607 这一代触摸固定是 GT911,走 I2C1:SCL = PIN42 = GPIO39、SDA = PIN41 = GPIO38,TP_RST = GPIO14,TP_INT = WAKEUP = GPIO51,下降沿触发。显示正常说明 LCD 时序没问题,触摸是独立挂在 I2C 上的,所以故障通常出在四处:IC 型号与驱动不匹配(gt9xx 可自动匹配 gt911/gt1158/gt927)、排线正反接错导致 SDA/SCL 互换、RST 没释放、INT 缺上拉。I2C 上拉电阻没贴,表现为扫不到地址,不是“屏坏了”。 处理步骤:① 看 tp 库探测日志,确认是否识别到 IC 与地址;② 用 i2c 扫描看 0x5D/0x14 是否在线;③ 核对排线上接/下接与线序;④ 示波器看 TP_RST 上电后是否拉高、TP_INT 有无跳变;⑤ 仍不通寄样机调试。 参考文档:https://docs.openluat.com/air8607/hardware/circuit/、https://docs.openluat.com/osapi/core/tp/

6. 触摸屏规格书配置文件能否帮忙转成Lua/配置?

解答: 结论:可以协助,但必须先把屏与触摸的规格书发过来,合宙按规格书确认参数,不凭型号猜。 说明:屏参不只是分辨率,还有 porch(hbp/hfp/vbp/vfp)、像素时钟、极性、RGB 数据位序、背光升压要求;触摸侧还有 IC 型号、I2C 地址、复位时序、坐标方向与镜像。缺任何一项都可能点亮但花屏、偏移或触摸反向。另外触摸 IC 若不在 tp 库支持列表里(gt911/gt1158/gt927/gt9157/jd9261t/cst820/cst816d/cst9220/ft3x68 等),要先补驱动才能谈配置。 处理步骤:① 提供完整规格书(含时序表与引脚定义);② 说明屏尺寸、接口类型(如 RGB565 50PIN);③ 由 FAE 给出板级工程里 lcd/tp 段的参数;④ 上板后做四角与中心五点校准。 参考文档:https://docs.openluat.com/air8607/product/

7. 8607显示亮度低怎么调?

解答: 结论:官方给的做法是把两个电阻都改成 5.1Ω,改完亮度会明显提升;具体位号以本板原理图为准。 说明:这类调整改的是背光恒流回路的取样电阻,阻值变小,反馈电压更早达到阈值,背光电流变大,亮度随之上升。副作用是背光功耗与发热同步上升,长期高温会加速屏老化,也会抬高整机温升。所以不要一路往下改,改之前先量原阻值和实际背光电流,按屏规格书的额定电流留 20% 左右余量。 处理步骤:① 找 FAE 确认这两颗电阻的位号;② 按规格书额定电流反算阻值;③ 换成 5.1Ω 后测背光电流与屏体温升;④ 整机高温老化 24 小时复核有无亮度衰减。 参考文档:https://docs.openluat.com/air8607/hardware/circuit/

8. 8603模块是4G Cat1吗?

解答: 尚未解答

9. AT+CNETLIGHT=0后灯是常亮而不是灭,为什么?

解答: 尚未解答

10. Air8783H支持短信吗?

解答: 结论:支持。同平台的 Air8783 出厂固件就带短信转发(sms_app / sms_bridge / sms_callback),说明该系列具备短信收发能力;但 8783H 的出厂固件定位是 SIP_CC 桥接,短信功能要以实机固件版本为准。 说明:8783 与 8783H 不是同一块硬件:Air8783 是 Air780ER2 的 USB Dongle 上网卡,量产固件有 RNDIS 与 RNDIS+短信转发两个分支;Air8783H 是基于 Air780EH2 的 SIP-CC 语音桥接板,主打 SIP↔蜂窝语音桥接。两者固件不能互刷,别拿 8783 的 .soc 往 8783H 上灌。8783H 上要确认短信,最稳的办法是用 sms 库或 AT 命令实测。 处理步骤:① 先看实机固件版本、确认是否含 sms 库;② 用 sms 库收发一条自测短信;③ 固件不含 sms 就向 FAE 索取带 sms 的版本;④ 严禁跨型号刷 8783 的固件。 参考文档:https://docs.openluat.com/air8783h/software/default_factory_firmware/、https://docs.openluat.com/air8783/product/

11. Air780EHV有没有开发板?

解答: 结论:有。Air780EHV 有官方开发板,购买入口在合宙淘宝店,原答复里给出的就是对应链接。 说明:EHV 与 EHM/EGH/EGG 同属 8MB 那一档,开发板解决的是供电、USB 下载、SIM 卡座、天线座与调试串口这些共性需求;但 EHV 带 GNSS,板载天线与走线和纯 4G 型号不同,买的时候要按型号选,别以为插上 EHV 模组就自动有定位。量产的板子还是要自己画,开发板只用于验证。 处理步骤:① 在淘宝店按型号搜索开发板;② 核对板上模组型号、有无 GNSS 天线;③ 到手先跑出厂固件确认模组与天线正常;④ 再开始改自己的工程。 参考文档:https://docs.openluat.com/SelectionGuide/SelectionGuide/

12. Air8607板子支持RGB888接口吗?

解答: 结论:不支持。Air8607 的 LCD 数据通路固定是 RGB565,接 RGB888 的屏也只能按 565 用。 说明:RGB565 是 16 位(红 5 / 绿 6 / 蓝 5,共 65536 色),Air1603 的显示通路就是这个位宽。板上 50PIN 连接器会把屏的低位数据通过电阻接到已有数据位,看着“接上了”,其实是把低位固定成某个电平,并不会把 RGB565 变成真正的 24 位显示。所谓“支持 RGB888 屏”指的是屏的物理接口能插上,不是数据位宽支持。 处理步骤:① 选屏直接按 RGB565 规格选;② 分辨率 1024×600 起、最高 1280×800;③ 不要试图改板上电阻去凑 888,改了也拿不到真彩色;④ 需要更高色深就换平台方案。 参考文档:https://docs.openluat.com/air8607/hardware/circuit/、https://docs.openluat.com/air8607/product/

13. 有支持RGB888的型号吗?

解答: 尚未解答

14. Air700与Air8000是只有参数上的区别吗?

解答: 尚未解答

15. 8602 7寸屏的固件源码在哪里?

解答: 结论:源码在 gitee 的 LuatOS 仓库 module/Air8602/project 下,按项目分了 DEPOSIT_CABINET、central_hotwater_system、vocs_monitor、factory 等工程;7 寸屏配的是通用固件,屏分辨率与触摸对得上就能用。 说明:整机方案不是“一个型号一个固件”,而是“一套板级工程 + 一套屏参”。屏参写在工程的 lcd/tp 配置里,换同规格的屏只改配置、不用改固件;分辨率变了就要重算时序(porch、时钟),硬套会花屏或者不亮。触摸 IC 也要在 tp 库支持列表里,否则坐标出不来。 处理步骤:① 进 module/Air8602/project 选业务最接近的工程;② 核对分辨率、时序、RGB 位序与触摸 IC;③ 改 lcd/tp 段后烧录点屏;④ 花屏先查时序,不亮查背光使能与复位。 参考文档:https://docs.openluat.com/air8602/hardware/shouce/

16. 合宙是否给客户匹配天线?

解答: 结论:合宙不直接配天线,但群内有天线厂家提供免费送样与调试对接,可以按项目谈。 说明:天线不是通用件。4G 要按频段和板上净空设计,GNSS 要考虑有源天线馈电,WiFi/BLE 还要避开金属件和屏排线;板载贴片天线在整机里受外壳、电池、屏影响很大,同一个天线换个结构就可能失谐。所以官方给的是“对接厂家做匹配调试”,而不是“发一根天线给你”。 处理步骤:① 提供结构信息(外壳材质、净空、天线计划位置);② 找群内厂家申请送样;③ 用综测仪或暗室看 VSWR 与效率;④ 定型后锁定天线批次和装配方式,别中途换料。 参考文档:https://docs.openluat.com/SelectionGuide/SelectionGuide/

17. 付费定位订单重复购买,能否退款或转移到其他设备?

解答: 尚未解答

18. 1603和780E的PCB封装有没有?

解答: 结论:1603 与 780E 的 PCB 封装都能拿到,主要在 gitee 的 module 目录和对应型号的硬件资料里;原提问者是自己找到的。 说明:模组封装一般是 PADS/AD 格式的库文件,随硬件资料包发布,不在文档正文里逐条列。要分清两种:模组本体封装(贴模组用,焊盘与钢网按它做)和整机板级封装(整板外形、连接器与开孔定位)。拿错了轻则封装对不上,重则按错误焊盘打样报废。 处理步骤:① 先进对应型号的 gitee module 目录找 hardware/封装;② 文档站硬件页通常也给下载入口;③ 拿到后核对焊盘尺寸与推荐钢网厚度;④ 打样前 1:1 打印比对实物。 参考文档:https://docs.openluat.com/air1603/

19. 8000W底部SPI管脚短路导致异常,如何处理?

解答: 结论:先确认是底部 SPI 的 NC 焊盘/管脚与相邻焊盘桥连;未使用的 SPI 脚可以割断止损,同时把内部 WiFi 固件升到最新,售后重烧后问题消失。 说明:8000W 是 4G+WiFi 二合一,底部那组 SPI 在主板上常常是“预留不接”,NC 焊盘与地、与相邻信号的间距很小,回流焊或手工补焊时容易连锡。短路后的表现不一定是死机,可能是 WiFi 侧异常、扫描不到热点,或者整机偶发复位。割脚属于止损手段,前提是确认这组 SPI 在本设计里确实没用,割之前必须对照原理图。 处理步骤:① 目视加万用表二极管档查底部焊盘对地是否短路;② 对照原理图确认该组 SPI 未使用后再割;③ 升级内部 WiFi 固件到最新;④ 仍异常走售后重烧与失效分析。 参考文档:https://docs.openluat.com/air8000/

20. 8000W WiFi固件升级后仍异常/如何查看WiFi版本?

解答: 结论:硬件本体没问题时,重烧固件并用校准日志里的 WiFi 版本号判断;版本对不上就让售后重烧。 说明:8000W 的 WiFi 是模组内部独立的一颗,它的固件版本不在 4G 侧 LuatOS 的版本号里,所以只看 LuatOS 版本判断不了 WiFi。校准日志会打印 WiFi 固件版本和校准结果,这是现场唯一可靠的判据。这类内部固件通常不开放给用户自己刷,只能走售后。 处理步骤:① 用 Luatools 重烧对应出厂固件;② 开日志抓校准段,记下 WiFi 版本;③ 与官方给出的目标版本比对;④ 不符就让售后重烧,别自己找 bin 乱刷。 参考文档:https://docs.openluat.com/air8000/

21. 现在有5G模组吗?

解答: 结论:没有。合宙当前公开在售的是 4G Cat.1 系列,没有 5G 模组。 说明:从 Air780E/EPM/EHM 到 Air8000、Air8600 系列都是 Cat.1 / Cat.1 bis 平台,定位是低功耗、低成本、够用的数据与语音场景。5G 的功耗、成本与射频设计与这一类产品不是一个量级,短期不会覆盖。多数“以为需要 5G”的场景,实际瓶颈在服务器侧或本地组网,不在空口。 处理步骤:① 先算实际需要的带宽,Cat.1 下行通常在 10Mbps 量级;② 视频类需求走本地缓存或降码率;③ 确实要 5G,只能选第三方模组用串口/USB 外挂;④ 选型参考 SelectionGuide。 参考文档:https://docs.openluat.com/SelectionGuide/SelectionGuide/

22. Air8000T淘宝不零售,想买两片测试怎么买?

解答: 尚未解答

23. 设备在合宙IoT平台归属被转到其他公司,能否转回?

解答: 结论:设备一旦有归属,平台侧没有权限直接改,必须由当前归属方发起转移。 说明:归属是防串货、防误操作的设计,平台管理员也不能越过归属方直接改。所以“能不能转回”的前提是原归属方配合。另外要区分“归属”和“分组”:分组只是同一账号内的分类移动,改了分组不等于换了归属,两者不是一回事。 处理步骤:① 先确认设备当前归属在哪个账号;② 由归属方在平台发起转移或释放;③ 转移完成后在新账号里重新分组;④ 找不到归属方就走商务或售后,凭购买凭证处理。 参考文档:https://docs.openluat.com/air8783h/software/default_factory_firmware/

24. 两个Air780E使用串口如何互相传较大文件或数据?

解答: 结论:串口直连传大文件可行但不推荐;正经做法是 airlink(一主一从、带包序号与重传),或者自己做分段 + 校验协议。 说明:UART 本身没有流控和重传,跑大数据全靠自己加帧头、长度、CRC 和重发;波特率再高也受模组串口 FIFO 与调度影响。xmodem/ymodem 在 LuatOS 里实现不完整(ymodem 只有部分固件带),拿来传大文件容易卡死。airlink 是官方为“模组之间、模组与 MCU 之间”设计的总线式协议,带序号和重传,比裸串口稳得多。 处理步骤:① 优先用 airlink,速率与可靠性都有保证;② 必须走串口就做分片(如 1KB 一片)+ CRC16 + 应答重传;③ 先小包压测丢包率,再放大包;④ 落 flash 时注意分片写入与掉电保护。 参考文档:https://docs.openluat.com/air780epm/luatos/app/mulu/fs/

25. 量产刷机烧到一半停顿、之后识别不到USB端口怎么办?

解答: 结论:多数是模块没停在下载模式,或 USB 枚举中途失败;先进 boot 重启,再核对端口号与波特率。 说明:量产刷机停顿常见三种原因:一是模块没进下载模式(上电时序不对、PWRKEY 没拉够时间);二是 USB 线或口供电不足,枚举到一半掉线;三是工具选的波特率与当前固件不匹配。识别不到端口时先看设备管理器有没有新设备(哪怕显示未知设备),完全没反应就是 USB 链路或供电问题。 处理步骤:① 断电重上电,必要时拉 PWRKEY 进 boot;② 选“4G 模块 USB 打印”看有没有串口出来;③ 设备管理器确认端口号,换线换口再试;④ 仍无端口就单独 VBAT 供电测电流,判断是否根本没启动。 参考文档:https://docs.openluat.com/common/Luatools/

26. Air780EPT支持2张SIM卡吗?

解答: 尚未解答

27. Air8301是否有3D打印外壳/3D文件?

解答: 结论:3D 文件随板子提供,买了板子再找销售或 FAE 要;没有单独对外发布的 3D 库。 说明:整机外壳类文件通常跟着硬件资料包走,因为结构件必须和 PCB 版本、连接器高度、屏与按键位置对齐,不同批次可能有微调。公开下载容易拿到过期版本,反而坑了结构设计。所以官方口径是“购买后提供”。 处理步骤:① 确认板子型号与 PCB 版本;② 向销售索取对应版本的 3D/结构文件;③ 拿到后核对连接器与开孔位置;④ 结构打样前做一次干涉检查。 参考文档:https://docs.openluat.com/air8301/product/

28. 两片780EHM贴片后USB无法连接烧录且发热,什么原因?

解答: 结论:先按电源短路查。发热加 USB 不通,基本是 VDD_EXT/IO 电源对地短路或焊接连锡,不是固件问题。 说明:模组贴片后不启动,最常见三件事:VBAT 与地短路、VDD_EXT 被外部拉死、PWRKEY 一直被拉低导致反复重启。发热说明存在大电流通路,优先怀疑电源域短路或 IO 灌流。把模组吹下来单独加 VBAT、PWRKEY 接地观察是否还发烫,可以快速区分“模组本体坏”还是“板上短路”。 处理步骤:① 万用表二极管档测 VBAT、VDD_EXT 对地;② 吹下模组单独供电测试;③ 检查钢网开孔与锡膏量,看有无连锡;④ 仍异常走售后失效分析,别再上电硬撑。 参考文档:https://docs.openluat.com/air780epm/luatos/hardware/

29. Air780EPM从2016版本升级到2050会有什么问题?

解答: 结论:不能一次差分包跳过去,要逐级升;官方给的路子是 16→26→36→38→42→48→50。 说明:两个约束叠加。第一,差分升级只能在同类固件之间做——固件 1 只能差分到固件 1,固件 2 只能差分到固件 2,换了固件号就不行。第二,差分包是按相邻两个版本的二进制差异生成的,跨度太大没有现成差分包,工具校验也过不去。所以跨多个大版本只能一级一级往上,每级都要确认启动和业务正常再升下一级。 处理步骤:① 先确认当前底层版本号;② 按 16→26→36→38→42→48→50 逐级准备对应整机固件;③ 每升一级跑一次自检(开机、注网、业务);④ 量产设备建议直接整包烧录,不要逐级差分。 参考文档:https://docs.openluat.com/air780epm/luatos/firmware/780epm_version/

30. 设备上报信号强度偶尔出现-999是什么原因?

解答: 结论:-999 是“读不到有效值”的占位,不是真实信号强度;原因多在网络侧波动、固件太老或天线接触不良。 说明:CSQ 的合法范围是 0~31,99 表示未知,换算 dBm 约 -113+2×CSQ,所以 CSQ 14 大约 -85dBm,这个值其实不算差。偶发 -999 更可能是取数那一刻正好在重注册或小区切换,也可能脚本把“未就绪”直接当信号值上报了。库文档也明确写了 4G 的 CSQ 不能完全代表强度,判断链路质量要看 RSRP/RSRQ/SINR。 处理步骤:① 记录 -999 出现的时间点与日志上下文,看是否伴随注网事件;② 改用 RSRP、SINR 做判据;③ 固件较老就用指定 IMEI 远程 FOTA 升级;④ 检查天线弹片、馈线与地平面。 参考文档:https://docs.openluat.com/air780epm/luatos/app/common/mobile/

31. Air780EPM新批次底层固件需≥V2036,能否直接替换旧批次?

解答: 结论:可以替换,除固件要升到 V2036 及以上外,硬件直接换;大批量前先小批验证。 说明:新批次改了底层,旧固件跑在新批次上会出现兼容问题,所以规则是“新硬件必须配 ≥V2036 的固件”。反过来老硬件也能跑新固件,通常不需要回退。真正要注意的是分区变化:跨大版本升级可能改变脚本区与文件系统大小,原有 fskv 和文件要重新评估容量。 处理步骤:① 新批次统一烧 ≥V2036 固件;② 老批次升级前备份 fskv 与关键文件;③ 小批 20~50 台跑一周观察;④ 台账里记录混合批次的固件版本,避免售后混淆。 参考文档:https://docs.openluat.com/air780epm/luatos/firmware/780epm_version/

32. 780EG模块支持libfota3升级吗?

解答: 结论:不支持。libfota3 是面向合宙整机、对接合宙 IoT 平台的方案,Air780EG 这一代用 libfota2。 说明:两代 OTA 库的服务器协议与升级包格式不同:libfota3 只对接合宙 IoT 云平台,自建服务器要走 libfota2 那套自定义接口。混用时的表现是“能连上但升级包校验失败”或者根本不下发。选库先看服务器是谁的,再看型号在不在支持列表。 处理步骤:① 用合宙平台且型号在列,选 libfota3;② 自建服务器选 libfota2,自己实现差分接口;③ 升级前确认固件号一致(差分包只能同类固件之间升);④ 升级失败先看返回码,不要反复重试刷机。 参考文档:https://docs.openluat.com/air780epm/luatos/app/ota/

33. 下载不了固件可能是什么原因?

解答: 结论:先升 Luatools。新版 exe 直接覆盖到旧版 Luatools 根目录即可,不用重装。 说明:下载失败大多是工具版本与固件包格式、下载服务器地址不匹配,尤其是新出的固件号,旧工具不认。其次是网络问题(公司代理、防火墙拦 CDN)和下载路径含中文或空格。Luatools 本身是绿色版,覆盖 exe 就完成升级,配置和下载记录都还在。 处理步骤:① 到 Luatools 页面下最新版;② 关掉旧程序,用新 exe 覆盖;③ 再试下载,仍失败就换网络(手机热点)验证是否被拦;④ 下载与解压目录都不要放中文路径。 参考文档:https://docs.openluat.com/common/Luatools/

34. Air780EGH的Luatools烧录失败而Luatools可以烧录,为什么?

解答: 结论:本质是要让模块先进 boot(下载模式)。Luatools 能给单个模块发进 boot 指令,批量治具做不到这一点。 说明:模块正常跑应用时串口/USB 被业务占着,烧录工具握手进不去;进 boot 后固件停在一个只做下载的最小环境,才能稳定握手。批量烧录一般靠拉 PWRKEY/BOOT 脚或专用治具控制上电时序,所以“单个能烧、批量不能烧”,问题多半在治具的进 boot 时序,而不是模块坏。 处理步骤:① 单个模块先用 Luatools 发进 boot,确认能烧;② 批量治具补上 BOOT/PWRKEY 的时序控制;③ 检查治具供电能力与 USB HUB 稳定性;④ 记录失败率与失败时的端口状态,便于定位是治具还是模块。 参考文档:https://docs.openluat.com/common/Luatools/

35. Air8202如何获取连续GNSS经纬度并上传到自己的服务器?

解答: 结论:要二次开发。拿 gitee 上 Air8202 的开源工程改源码后自己烧,或者对接合宙云平台的后台接口(付费)。 说明:出厂固件是“定位上报到合宙平台”的成品逻辑,没有开放“填一个自己的服务器地址就上报”的配置项。要改上报目标就得改 Lua 源码:用 libgnss 取经纬度,自己组 JSON 或透传报文,走 socket/MQTT 发出去。Air8202 支持 4G+GNSS,空旷环境定位精度 2~3 米,板载 GNSS 陶瓷天线,室内是定不出来的。 处理步骤:① 取 module 下 8202 对应工程;② 用 libgnss 的 parse/locStr 拿定位;③ 改成自己的 socket/MQTT 上报;④ 断网场景加本地缓存与补传。 参考文档:https://docs.openluat.com/air8202/product/

36. Air8301实际存储容量是多少?

解答: 结论:128MB。板载是 1Gbit 的 SPI NAND,1Gbit = 128MByte,淘宝描述写错了。 说明:这颗是 3V 1G-bit SLC QspiNAND,按页(2048 Byte)读写、按块(128KB)擦除,不能字节级随机改写、不支持 XIP,所以“当 U 盘随便改文件”这类用法不成立,要走 fatfs 才安全。还有个坑:GPIO140 是这颗 Flash 的电源使能,官方以太网示例里的 pwrpin=140 是核心板点位,本板照抄会让 Flash 掉电,现象是上电毫无反应。 处理步骤:① 用 fatfs 挂载使用,不要裸写;② 大文件按块对齐写;③ 严禁把 GPIO140 挪作他用;④ 掉电保护自己做,NAND 写一半掉电会坏块。 参考文档:https://docs.openluat.com/air8301/hardware/circuit/

37. Air8603W1支持多国语言语音播报和显示吗?

解答: 结论:还不支持。当前 TTS 只做中文,多国语言语音播报和界面多语言都没有现成方案。 说明:TTS 走的是中文音库,音库本身占空间,多语言要换音库并加语种切换逻辑,固件里没有这一层。界面文字如果用的是图片或固定点阵字库,同样没有多语言能力。要做只能自己做:预录多语言音频按语种播放,界面上多套图片或字库切换,属于应用层方案而不是开个开关。 处理步骤:① 先明确需求是“语音播报”还是“界面文字”;② 播报用预录音频 + audio 播放,按语种选文件;③ 界面用多套图片/字库切换;④ 别指望 TTS 直接合成外语。 参考文档:https://docs.openluat.com/air8603/

38. TTS固件提示未包含TTS资源、需外挂SPI Flash,怎么办?

解答: 结论:这类提示说明固件里 TTS 引擎在、但音库/资源没打进去。换带 TTS 资源的固件版本,或临时回退到 2052。 说明:以 22/122 号固件为例,固件定义里确实列了 tts,但 V2054 正式版评估脚本区空间不足,实际没把 TTS 资源放进去,于是运行时报“未包含 TTS 资源、需外挂 SPI Flash”。官方规划是后续新增一个数字固件,把 TTS 与 HZFONT 字体放到外置 NAND Flash 加载,从而同时支持 SIP+AirUI+TTS。在那个版本出来之前,要么换明确带 TTS 资源的固件号,要么回退 2052 先把业务跑通。 处理步骤:① 查该固件号在版本页的说明,确认是否声明含 TTS;② 换一个明确带 TTS 资源的固件号;③ 临时回退 2052 验证业务逻辑;④ 需要外挂就按 NAND 方案预留 SPI 与供电。 参考文档:https://docs.openluat.com/air780epm/luatos/firmware/780ehm_version/

39. Air780EPM模组价格多少?量大能否优惠?

解答: 结论:Air780EPM 参考价 16.8 元;量大优惠联系销售(杨凤珍)。 说明:选型页公示的是含税参考价,实际成交按批量、卡座形式(插拔卡/贴片卡)、是否带 GNSS 等配置走商务报价。原答复里的 15.8 元已过期,以文档站选型页为准。同档位对比:Air780EHM 19.8 元、Air8000W 33 元、Air8780P 类整机另计。 处理步骤:① 以选型页价格为基准;② 报预计年用量给销售拿批量价;③ 不要把参考价直接写进对客户的正式报价单;④ 需要含税/不含税口径先问清楚。 参考文档:https://docs.openluat.com/SelectionGuide/SelectionGuide/

40. 板子自带的贴片SIM卡有查询剩余流量的接口吗?

解答: 结论:设备上没有查询流量的接口,只能通过公众号查;提供 ICCID 可以让 FAE 协助查。 说明:流量是运营商侧的业务数据,模组只能读到 ICCID、IMSI 这类标识,读不到套餐余量。物联网卡一般走专门的流量卡管理平台,公众号或后台是运营方给的入口;贴片卡没有实体卡面,必须靠 ICCID 反查。所以“设备自己报剩余流量”这条路走不通,除非你自己在服务器侧做统计。 处理步骤:① 从设备日志读 ICCID(mobile.iccid());② 到公众号或管理后台按 ICCID 查;③ 批量设备让 FAE 导出余量报表;④ 在服务器侧做用量阈值告警,别等停机。 参考文档:https://docs.openluat.com/air780epm/luatos/app/common/mobile/

41. 8603的USB不能复用,能否通过界面选择设备类后重启切换?

解答: 结论:不能靠“界面选一下、重启切换”。USB 角色与设备类属固件级配置;8603/8607 这一代 USB 是 HOST 口,接 UVC/HID 外设,本身不当从设备。 说明:USB 是 HOST 还是 DEVICE,由硬件(ID 脚、供电方向)和固件里的 USB 描述符共同决定,运行期没有“切设备类”的开关。8603 的 USB 用于人脸识别摄像头的图像通路,配 UART2 做控制命令与结果回传,Type-A 与端子共用一路信号,可接 UVC 摄像头和 HID 键鼠,但不会给 PC 当设备用。真要验证某种设备类,只能改底层配置重新编译,或用 luatos-cli 烧调试固件。 处理步骤:① 先明确需求是“接外设”还是“当设备”;② 接外设按 UVC/HID 走,注意与第二路 RS485 的供电复用;③ 当设备就换具备 device 能力的方案;④ 调试阶段可以让 AI 生成脚本 + luatos-cli 烧录验证。 参考文档:https://docs.openluat.com/air8603/

42. Air780EPM设备频繁掉线又上线,CSQ 14是什么原因?

解答: 结论:CSQ 14 折算约 -85dBm,不算弱;频繁掉线又上线更像网络侧(小区切换、拥塞)或天线、供电问题,不是单纯信号差。 说明:CSQ 合法范围 0~31,99 表示未知,dBm 约等于 -113+2×CSQ,所以 14 大约是 -85dBm。真正判链路质量要看 RSRP(一般 -80 以上好、-100 以下差)、RSRQ 与 SINR。掉线重注册在多运营商边界、电梯地库、基站拥塞时很常见;另外发射瞬间供电跌落也会导致“掉线式”复位,这种从 CSQ 上是看不出来的。 处理步骤:① 抓日志看掉线前后的注网事件与 RSRP/SINR;② 换位置、换天线做对比;③ 测发射瞬间 VBAT 跌落;④ 用 mobile.csq() 与 RSRP 长期采样做曲线,别只看单点。 参考文档:https://docs.openluat.com/air780epm/luatos/app/common/mobile/

43. Air780EHM通话结束后USB ECM与UART同时失去响应怎么办?

解答: 结论:这种“双通道同时卡死”要看底层日志才能定性,先把 4gdiag 目录下的 .bin 抓全给 FAE。 说明:通话结束时要同时释放 VoLTE 承载与 USB 数据通道,如果驱动层存在竞态,表现就是 ECM 与 UART 一起不响应;也可能是 USB 侧挂死,整条链路假死(UART 其实还活着,只是业务线程卡住)。判断依据是日志里“通话释放”的时间点与“USB 断开/重枚举”的时间点是否吻合。 处理步骤:① 复现后立刻取 4gdiag 下的 .bin,别重启覆盖;② 记录通话时长、运营商、USB 口类型与主机系统;③ 换 USB 口、换线、换主机排除主机侧;④ 日志交 FAE 做协议栈分析。 参考文档:https://docs.openluat.com/air780epm/luatos/app/common/mobile/

44. Air780EGH文件系统大小、脚本区上限、外挂存储、大文件分片下载等如何配置?

解答: 结论:8MB 这一档(EHM/EHV/EGH/EGG)按固件号分:12 号固件脚本区 1024KB、文件系统 2304KB;要大文件系统选 23/123 号;要 SIP+UI 选 22/122 号(脚本区与文件系统各 512KB)。 说明:Flash 只有 8MB,核心库和文件系统抢同一块空间,所以“脚本区多大、文件系统多大”取决于选哪个固件号,不是一个固定值。23/123 号在 12 号基础上加了 fatfs 与 u8g2 中文点阵字库,文件系统缩到 1920KB;22/122 号主打 SIP+AirUI,脚本区和文件系统各 512KB,且 V2054 正式版因脚本区不足实际未含 TTS。大文件分片下载用 http 的 Range 分段取,写 fatfs 时按块落盘并做 CRC 校验。 处理步骤:① 按业务需要的库反查固件号(版本页有逐号说明);② 确认脚本区放得下自己的 Lua 工程;③ 大文件用分段 + 校验 + 断点续传;④ 频繁写 NAND 注意擦写寿命。 参考文档:https://docs.openluat.com/air780epm/luatos/firmware/780ehm_version/、https://docs.openluat.com/air780epm/luatos/app/mulu/fs/

45. Air780EPT支持2张SIM卡吗?

解答: 尚未解答

46. Air8783H能否通过USB注册到局域网SIP服务器,还是只能走4G公网?

解答: 结论:USB 只是供电,SIP 通过 4G 注册;插 USB 不代表走局域网。 说明:8783H 默认用 4G 承载 SIP,蜂窝通话那侧还要 SIM 卡和 VoLTE 支持。工程目录里也带了 WiFi STA 驱动,但切换只改变 SIP 的联网方式,蜂窝通话照旧走 SIM 与 VoLTE。所以“插上 USB 就想注册到内网 SIP 服务器”不成立,除非你把 SIP 侧改到 WiFi 或以太网上。 处理步骤:① 确认 SIP 服务器是公网可达的;② 用 4G 注册,核对账号与对端号码(IMEI+1);③ 需要走内网就先切 WiFi STA 再验证;④ 抓 SIP 信令日志(REGISTER / 401 / 200)定位注册失败。 参考文档:https://docs.openluat.com/air8783h/、https://docs.openluat.com/air8783h/software/default_factory_firmware/

47. Air8783H支持哪些运营商卡?

解答: 结论:电信、移动的实名手机卡都能用;物联网卡不行。必须是已实名并开通语音与 VoLTE 的手机卡,且 8783H 只支持 SIP_CC 模式。 说明:SIP_CC 是“网络 SIP ↔ 蜂窝 CC/VoLTE”的桥接,蜂窝侧要能真正打通电话,所以卡的语音与 VoLTE 必须开通。物联网卡普遍不开语音,表现就是提示卡无效或拨号失败。8783H 的 SOS 设置里四个通道(SIP / SIP_CC / CC / 分组管理)互斥,且 8783H 只支持 SIP_CC 这一种,提交某个通道会清空其余通道的号码。 处理步骤:① 用实名手机卡并确认已开通 VoLTE;② 先插手机验证该卡能正常呼入呼出;③ 在平台“设备设置 → SOS 设置”选 SIP_CC,填对端号码与 SOS 手机号;④ 打不通先查卡能力,再看信令日志。 参考文档:https://docs.openluat.com/air8783h/software/default_factory_firmware/

48. SIP服务器端有开源软件吗?

解答: 结论:可以用 FreeSWITCH。开源、能跑在普通服务器上,做 SIP 注册与呼叫转接够用。 说明:FreeSWITCH 支持 SIP 注册、呼叫路由、录音、IVR,配 8783H 这类 SIP 终端没问题。要注意编解码协商:8783H 侧走 PCMA/PCMU/G729/G722,服务器要开启对应 codec,否则能注册但接通没声音。NAT 场景还要配外部 IP 与 RTP 端口范围,这是“注册成功但单通”的头号原因。 处理步骤:① 装 FreeSWITCH 并建分机;② 打开 PCMA/PCMU;③ 配 external IP 与 RTP 端口段;④ 先用软终端互通,再接设备联调。 参考文档:https://docs.openluat.com/air8783h/

49. Air8784 SIP对讲是端到端通信吗?

解答: 结论:不是端到端,两端都通过服务器中转;端到端直连协议还在调,没上线。 说明:SIP 本身是“终端↔服务器↔终端”的架构,媒体流经服务器(或服务器协商后直连,但需要 NAT 穿透支持)。当前方案明确走服务器中转,所以服务器挂了通话就断,反过来说服务器侧能做录音、转接、分组。端到端要解决地址发现、NAT 穿透与加密,目前没调通,不要按“点对点”设计产品。 处理步骤:① 按“必须有服务器”设计系统;② 服务器做高可用与带宽评估(每路通话码率不高但要留余量);③ 需要录音/转接就在服务器做;④ 端到端等官方方案再评估。 参考文档:https://docs.openluat.com/air8784/product/

50. Air8783H/8783系列如何把设备归属到自己的IoT账号?

解答: 结论:先把设备归属到自己账号下的 8783H_SIP 项目,再在平台里做 SOS 与分组配置。 说明:8783H 的整机固件是配合合宙 AirCloud 用的:设备上线后先归属到项目,才能在“设备管理”里下发 SOS 配置、看定位、做分组。SOS 四个通道互斥,提交某一个会清空其余通道的号码,所以配置要一次定好。切换分支后设备会保存配置、空闲时重启再上线,必须等它重新注册上来再验证。 处理步骤:① 在平台建好或进入 8783H_SIP 项目;② 把设备 IMEI 归属进来;③ 设备设置 → SOS 设置选 SIP_CC,填 IMEI+1 与手机号并提交;④ 等设备重启上线后拨号验证。 参考文档:https://docs.openluat.com/air8783h/software/default_factory_firmware/

51. 780EHM使用TTS提示需要外挂SPI Flash,为什么?

解答: 结论:这个提示的意思是固件带 TTS 引擎但没带音库资源;要么换带 TTS 资源的固件版本,要么外挂 SPI Flash 放资源。 说明:TTS 的中文音库体积不小,8MB 的 Flash 里固件本身已经吃满,所以有些固件号只保留引擎、不带资源,运行时就会报“需要外挂 SPI Flash”。判断方法看固件版本页对该号的说明:明确写了含 TTS 的才真有音库。官方也在规划把 TTS 与字库放到外置 NAND 上加载的固件,在那之前外挂是可行路线。 处理步骤:① 查版本页确认该固件号是否含 TTS 资源;② 换带资源的固件号;③ 需要外挂就在 SPI 上预留 NAND/Flash,用 little_flash 或 sfud 挂载;④ 资源路径按 tts 库要求放,别自己改目录结构。 参考文档:https://docs.openluat.com/air780epm/luatos/firmware/780ehm_version/

搜索