跳转至

常见问题 - 2026-11-13

数据日期:2026-11-13

1. 新版本固件(如V23)收不到10086上行短信,旧版本能收到,如何处理?

解答: 结论:这是固件侧的已知问题,合宙已定位并在修复;修复版发布前先回退到能正常收短信的旧版本,回退或升级后设备都要重新上电启动。 说明:10086 上行短信(例如发送 301 查询余额后的回复)属于网络下发给设备的 MT 短信,链路是「运营商短信中心下发 → 模组收到 → 固件分发给 sms 回调或 AT 上报」。能发不能收说明问题出在接收与分发环节,与 SIM 卡、归属地、信号无关;同一个卡、同一块板,只换固件版本就恢复正常,这是判定固件问题最直接的证据。新版本在改动短信存储与分发逻辑时容易引入这类回归。 处理步骤:① 记录出问题的固件版本号(如 V23)和能正常接收的旧版本号;② 回退旧固件,用 sms.send("10086", "301") 复测,确认能收到回执;③ 两种情况各抓一份完整 log,重点保留短信上报相关行,作为修复验证的对照基线;④ 拿到修复版后用同一套步骤复测;⑤ 每次换固件后都断电重启,不要只软重启。 参考文档:https://docs.openluat.com/osapi/core/sms/ · https://docs.openluat.com/air780epm/luatos/firmware/780ehm_version/

2. 探针超时后的无主回执/上行短信是否都要拦截?不拦截是否会死机?

解答: 尚未解答

3. 全量升级前需要做哪些验证?

解答: 结论:先挑一台设备升级,做多场景挂测,重点盯上报链路和死机情况,确认稳定后再分批灰度到全量。 说明:OTA 的风险集中在四段:下载(弱网中断、断点续传)、校验(包不完整或版本号不匹配)、写分区(掉电、空间不足)、重启后自恢复。任何一段出问题都会表现为「升级后不联网、不上报、反复重启」,而这些问题只有挂测才暴露得出来。全量一次推完,一旦出问题就是成片设备失联,现场回收成本远高于分批灰度。 处理步骤:① 选一台有代表性的设备(同一硬件版本、同一固件基线)先升;② 挂测至少覆盖:正常网络、弱网/断网重连、升级过程中断电、长连接保活、低功耗唤醒后上报;③ 观察升级后版本号、脚本是否正常运行、有无死机重启记录;④ 稳定运行一段时间后再扩到 10% 灰度,最后全量;⑤ 全程保留升级日志与失败率统计,异常立即暂停推送。 参考文档:https://docs.openluat.com/osapi/ext/libfota3/ · https://docs.openluat.com/common/fota_lesson/

4. 能否在平台日志中增加自定义request id?

解答: 尚未解答

5. 106固件脚本空间太小,调试信息看不全,excloud.lua该用哪一份?

解答: 结论:用合宙按业务逻辑删减过的那份 excloud.lua,不要直接拿 gitee 上完整版,106 号固件脚本区容量不够,装不下完整版就会导致调试信息看不全甚至跑不起来。 说明:excloud 是设备侧对接云平台的库,完整版包含注册、上下行、事件上报、OTA、参数配置等多套逻辑,代码体积较大。固件的脚本区(存放用户 lua 的区域)是按固件号固定的:106 号固件为了给别的功能腾空间把脚本区做小了,加载完整版后剩余空间极少,运行期一旦申请内存失败或脚本被截断,日志就会缺段,看起来像「调试信息打不全」。这不是打印等级的问题,改 log.level 也没用。 处理步骤:① 先确认固件号与脚本区大小,对照固件版本页核对该号固件的脚本区、文件系统区各是多少;② 换成合宙提供的精简版 excloud.lua;③ 精简业务:只保留实际用到的上报字段与命令,删掉用不到的模块;④ 观察脚本占用的曲线,留出余量;⑤ 如果业务确实需要完整功能,改用脚本区更大的固件号,别硬塞。 参考文档:https://docs.openluat.com/air780epm/luatos/firmware/780ehm_version/ · https://docs.openluat.com/common/LuatOS/

6. 如何让AI协助下载和配置合宙知识库的MCP?

解答: 结论:把合宙知识库 MCP 的说明页地址直接发给 AI,让它自己读页面、按页面里的命令和配置片段完成安装与配置即可,不需要你手动抄参数。 说明:该页已经把 MCP server 的启动方式、依赖环境、以及在 Claude、Cursor、Trae 等客户端里的 JSON 配置结构写全了;各家客户端虽然入口不同,但 mcpServers 这一段结构是通用的。让 AI 读页面比人工复制更可靠:它会自己确认 Node.js 等前置依赖,把配置写进对应客户端的配置文件,再验证 MCP 是否连通。 处理步骤:① 把 https://docs.openluat.com/ai/mcp_cli/ 发给 AI;② 说明你用的客户端(Claude / Cursor / Trae / 其他);③ 让 AI 装好依赖并写入配置;④ 重启客户端,确认 MCP server 状态为已连接;⑤ 用一句「查一下 Air780EPM 的固件版本页」验证能否取到文档内容。 参考文档:https://docs.openluat.com/ai/mcp_cli/

7. Air780系列用AT指令TCP连接服务器,Linux服务器返回 OK...ERROR...CONNECT OK,Windows服务器只返回 OK...CONNECT OK,为什么?

解答: 结论:这个差异与服务器用 Linux 还是 Windows 无关,是服务器端 TCP 实现或日志打印顺序造成的,建议用合宙的 TCP 测试服务器做对照验证。 说明:AT 回显的 OK、ERROR、CONNECT OK 是模组本地打印的:OK 表示命令已受理,CONNECT OK 表示 TCP 三次握手完成,ERROR 表示命令参数不合法或当前状态不允许。同一份 AT 流程在不同服务器上出现不同序列,通常是服务器 accept 后的行为差异(有的先发欢迎语、有的立即 RST、有的延迟 accept),也可能是服务器把连接异常当成业务错误返回。模组侧只按 socket 状态打印,不会因为对方操作系统而改变。 处理步骤:① 用同一个模组、同一张卡,分别连合宙测试服务器(https://iot.luatos.com/#/p8000/netlab)和你的两台服务器,比对回显;② 抓服务器侧 tcpdump 看握手是否完整、有无 RST;③ 检查服务器防火墙、SELinux、连接数上限是否拦了新连接;④ 确认 AT 参数(APN、IP 类型、连接模式)完全一致;⑤ 定位到服务器侧后按正常 TCP 服务端行为修配置。 参考文档:https://docs.openluat.com/air780epm/luatos/app/socket/ · https://iot.luatos.com/#/p8000/netlab

8. Air780一直下载/烧录失败,换多块板子都一样,怎么解决?

解答: 结论:先强制进下载模式(按住 BOOT 再按开机键、再上电),仍失败就查 USB 走线与供电,最后提交原理图给合宙审核。 说明:Air780 系列下载靠 USB 的 DP/DM 两根线,模组内部没有 USB 收发器,走线一旦过长、串了电阻、或者没有和地成对布线,握手阶段就会失败,表现是 Luatools 一直「等待设备」或反复重试。换多块板子都一样,说明不是模组个体问题,而是这一批板的共性设计或供电问题。BOOT 拉低的时机也很关键,必须在复位释放前后保持住,拉晚一点就进不去下载模式。 处理步骤:① 按住 BOOT 键不放,再按开机键,然后上电,等工具识别到设备再松手;② 换一根短的、带屏蔽的 USB 线,直连电脑后置 USB 口,不经过 HUB;③ 检查 DP/DM 是否等长、是否串了电阻、是否与地成对走线,必要时用飞线把 DP/DM 与地直接引到模组焊盘上验证;④ 核对模组的 BOOT 引脚定义,按规格书确认强制下载时的电平(部分型号可用短接 BOOT 与对应引脚的方式),不要照搬别的型号的脚号;⑤ 以上都排除后,把原理图与 PCB 走线提交合宙审核。 参考文档:https://docs.openluat.com/air780epm/product/ · https://docs.openluat.com/common/Luatools/

9. 程序下载到Air780EP后无法进入boot、识别不到USB,是否还能救?

解答: 尚未解答

10. Air8781P模组什么价格?

解答: 结论:Air8781P1 与 Air8781P2 价格不同,差别在于板载 DCDC 等配置,按型号分别报价,参考价 P1 为 19.9 元、P2 为 22.9 元,实际以下单时店铺价格为准。 说明:Air8781P 是带看门狗、SIM 卡座、IPEX 天线座子的二次开发小板,P1 与 P2 的差异主要是供电方案:P2 板载 DCDC,可以直接吃较宽的输入电压,适合工业现场直接取电;P1 没有板载 DCDC,需要外部提供稳定电压。配置不同,BOM 成本就不同,所以报价必须按具体型号报,不能笼统说「8781P 多少钱」。 处理步骤:① 先确认项目要 P1 还是 P2(是否需要板载 DCDC 宽压输入);② 按型号查对应价格与购买链接;③ 批量采购联系店铺客服或商务询价;④ 报价含税与运费口径要和商务确认清楚。 参考文档:https://docs.openluat.com/air1601/product/air860x/module/

11. Air780ER2(不带定位)100多片的价格和交期?

解答: 结论:Air780ER2 批量价 15.9 元/片(含税),款到后 1~2 个工作日可以发出。 说明:Air780ER2 是给主控做 4G 上网用的模组,出厂默认就开了 RNDIS 网卡功能,插到 ARM Linux 或 Windows 主控上不用再发 AT 指令配置,这是它和普通 Air780E 系列最大的区别。100 多片属于小批量,价格按含税批量单价走,交期受现货影响,以付款当时的库存为准。 处理步骤:① 确认用量与是否需要配套天线、SIM 卡座;② 与商务确认 15.9 元/片(含税)的口径与运费;③ 付款后按 1~2 个工作日备货;④ 收到后先用主控确认能自动识别网卡,再验证联网。 参考文档:https://docs.openluat.com/air780ehnehu/product/air780exxpins/

12. Air780EGT批量价格能否再优惠?

解答: 结论:Air780EGT 零售价 37.8 元,含税批量单价 36.8 元,批量是统一价,没有进一步的阶梯优惠。 说明:Air780EGT 是 4G+GNSS 定位二合一 AT 模组,内置定位芯片,报价里已经包含定位部分的硬件成本,所以比纯 4G 的 Air780E 系列高。合宙对小批量客户给的是统一的批量价,采购量再大也不额外让价,这是为了保持报价透明。建议先按批量价买 10 片做测试,验证频段、定位精度和上报链路都符合预期后,再按项目量下单。 处理步骤:① 先按 36.8 元/片的批量价下 10 片测试;② 测试项包括注网、GNSS 首次定位时间、定位精度、低功耗表现;③ 确认无问题后按整批下单;④ 需要合同、发票或账期走商务流程。 参考文档:https://docs.openluat.com/SelectionGuide/SelectionGuide/

13. Air8000A批量价格是多少?

解答: 结论:Air8000A 含税批量单价 45 元/片,是统一价,1000 片同样按 45 元/片执行,不随批量再降;产品选型页当前标价 46 元,下单时以店铺实时成交价为准。 说明:Air8000A 是 4G+Wi-Fi+蓝牙+GNSS+G-sensor 的五合一 SoC 引擎,8MB Flash+8MB RAM,功能密度高,单价自然高于纯 4G 模组。合宙对 Air8000A 采用统一批量价策略,避免同型号不同客户拿到差别很大的价格。选型页的标价与商务给出的批量价之间会有小幅差异,属于页面更新节奏问题,谈价时以商务口径为准。 处理步骤:① 明确项目需要的功能组合(是否需要 Wi-Fi、定位、G-sensor);② 按 45 元/片的批量价做成本核算;③ 下单前和商务确认当时的实际成交价与含税、运费口径;④ 量大的项目走商务报价,别直接按页面标价做预算。 参考文档:https://docs.openluat.com/SelectionGuide/SelectionGuide/ · https://docs.openluat.com/air8000/product/

14. Air780EPM、Air8000W的工作温度范围是多少?

解答: 结论:Air780EPM、Air8000W 的环境工作温度范围都是 -40℃ ~ +80℃,高低温箱验证的设定上下限就是 -40℃ 与 +80℃。 说明:这个范围是环境温度(Ta),指模组周围空气的温度,不是芯片结温。工业现场常见的坑是把「环境温度」当成「机壳温度」来算余量:设备装在密闭金属柜里、或者旁边有发热的电源模块时,柜内温度会比环境高十几度,模组实际承受的温度已经超出规格。另外 4G 发射瞬间电流可达安培级,长时高温加发射会叠加温升。 处理步骤:① 按 -40℃ ~ +80℃ 做设计余量,不要卡在边界上用;② 整机做高低温试验时在模组附近贴热电偶,测实际环境温度而不是箱体设定温度;③ 密闭机柜要留散热或降额使用;④ 高温下重点复测注网、发射功率与重启行为;⑤ 低温下重点复测晶振起振与首次注网时间。 参考文档:https://docs.openluat.com/air780epm/product/ · https://docs.openluat.com/air8000/product/

15. Air8000W带4G+WIFI,不开WIFI时休眠待机功耗与AIR780E差异大吗?只用4G能否替代AIR780E?

解答: 结论:不开 Wi-Fi 时 Air8000W 的休眠待机功耗和 Air780EPM 差不多,差异可以忽略;开了 Wi-Fi 待机会多耗约 1mA 左右。只用 4G 功能替代 Air780E 是可行的,但要接受更高的单价。 说明:Wi-Fi 部分的射频与协议栈即使不联网,只要处于开启状态就要周期性跑 beacon 监听或维持连接状态,这部分是额外的固定开销,所以差在「Wi-Fi 开不开」而不是「4G 有没有用」。两者的低功耗底子是同一套 EC7xx 平台和同一套 sleep/PSM 机制,关掉 Wi-Fi 后待机电流自然回到同一水平。 处理步骤:① 用 wlan 相关接口彻底关闭 Wi-Fi(不是只断开连接),再测待机电流;② 对比测试时保持同一电压(建议 3.8V)、同一固件基线;③ 确认低功耗模式(常规 / 低功耗 / PSM+)设置一致,否则数字没有可比性;④ 若要长期电池供电,优先按 PSM+ 设计,注意 PSM+ 下 GPIO 电平不能保持。⑤ 若只需 4G,Air780EPM/EHM 成本更低,没必要为 4G 付 Wi-Fi 的钱。 参考文档:https://docs.openluat.com/air8000/product/ · https://docs.openluat.com/air780epm/product/

16. 有没有可以pin to pin替换Air780EP、用于印尼的4G模块?

解答: 结论:Air780EHU 可以 pin to pin 替换 Air780EP 使用,它是面向欧亚地区的 8MB+8MB 版本,与国内 Air780EHM 是同一套 PCB 布局;先确认你的项目走 AT 还是 LuatOS 二次开发,两种料号在选型表里都有。 说明:Air780Exx 系列(EPM / EHM / EHU / EHN)在硬件管脚上是完全兼容的,换型号不用改板,差异在 flash/ram 容量与射频频段。Air780EHU 支持 B1/B3/B5/B7/B8/B20/B28/B38/B40/B41,覆盖欧亚与东南亚主流运营商频段;印尼运营商常用的 B1/B3/B8/B40 都在列表内。要注意频段是硬件区别,刷软件改不了:拿国内型号刷成海外固件也不等于能用。 处理步骤:① 到覆盖国家页确认印尼当地运营商的频段是否被 EHU 全覆盖,部分覆盖不等于可用;② 确认项目形态,AT 固件与 LuatOS 二次开发是不同料号体系;③ 按 EHU 重新做射频与天线匹配验证;④ 小批量先打样验证注网与速率;⑤ 量产前锁定型号,别在国内版与海外版之间来回换。 参考文档:https://docs.openluat.com/air780ehnehu/product/air780ehufreq/ · https://docs.openluat.com/air780epm/product/

17. Air780EPM默认是4+4MB吗?需要存约4M设备日志,有没有单蓝牙、不上网的方案?

解答: 结论:Air780EPM 是 4MB Flash + 4MB RAM,Air780EHM 是 8MB + 8MB;如果只要蓝牙、不想上 4G,可以选 Air8101B(Wi-Fi+蓝牙 SoC),或者用带蓝牙的 Air8000 系列(8+8)。 说明:Flash 与 RAM 是硬指标,决定了能跑多大的脚本、能开多大的缓存、能不能跑图形界面。4MB 版本要存 4MB 左右的设备日志基本不现实——日志和数据要抢同一个文件系统区,还要留出脚本与 OTA 备份的空间。真要本地存日志,要么选 8+8 的型号,要么外挂 Flash/SD 卡。单蓝牙场景不必背 4G 的功耗与成本,SoC 类方案更合适。 处理步骤:① 先算清日志的实际占用:单条大小 × 每天条数 × 保留天数,再乘安全系数;② 按容量选型号,Air780EHM 或 Air8000 系列(8+8);③ 只要蓝牙就选 Air8101B / Air8000,注意 Air8101 是 Wi-Fi+蓝牙 SoC,不带 4G;④ 日志策略上做滚动覆盖(写满删最旧),别让它无限增长;⑤ 确认固件号对应的文件系统区大小,不同固件号差别很大。 参考文档:https://docs.openluat.com/air780epm/product/ · https://docs.openluat.com/air8101/product/

18. AIR8607的视频播放会停止,1030版固件仍未改进?

解答: 结论:这是库(解码/播放)侧的问题,合宙在确认并修改中;当前 1030 版固件还没改进,需要等更新后的固件或库再复测。 说明:Air8607 的视频播放走 MJPG/HZV 解码加帧缓冲显示,长时间播放停止通常与缓冲区回收、内存碎片或解码线程状态有关,属于库层面的问题而不是屏或接线的问题。这类问题在播放大分辨率、高码率素材时更容易出现,换成小分辨率或短片段往往会延后发生,看起来像「偶发」。 处理步骤:① 先用短视频、低分辨率素材复现,确认是必然停止还是长时累积;② 记录停止时的 log 与已播放时长,提交给合宙作为定位依据;③ 拿到新固件/库后按同样素材与时长复测;④ 量产前必须做长时播放挂测(至少覆盖实际使用时长的数倍);⑤ 临时规避可降低分辨率或帧率、缩短单片时长。 参考文档:https://docs.openluat.com/osapi/core/videoplayer/ · https://docs.openluat.com/air8607/product/

19. 8607的UART接口资料与板子丝印不一致,以哪个为准?

解答: 结论:以板子丝印为准,丝印是这一版硬件实际连线的权威标识;文档用于理解接口能力,具体脚号以你的板子为准。 说明:大屏类产品在改版过程中经常调整 UART 的复用脚位,而文档跟的是量产版本,手上有早期样板时就会对不上。丝印直接对应这块 PCB 的网络名,是最可靠的依据。真正要小心的是:丝印标的是板上的网络名,不等于模组的 GPIO 编号,中间可能还有电平转换或复用开关。 处理步骤:① 先按丝印查线,用万用表确认丝印脚位与模组实际引脚的连通关系;② 对照产品的引脚定义页确认该脚支持的功能与复用;③ 确认电平(3.3V TTL 还是经过 485/232 收发器);④ 有疑问直接把丝印照片与走线发到 ai.luatos.com 或技术支持群核对;⑤ 改版后同步更新自己的接线表,别沿用旧版。 参考文档:https://docs.openluat.com/air8607/product/ · https://ai.luatos.com/

20. 8607主板端口不够,能否单独买8603M5主板接10寸屏做产品?

解答: 结论:可以,Air8603M5 主板本身就能接 10 寸屏做产品,而且功能比 8607 更全:能联网、带 RS485/232,接口数量也更多。 说明:8607 是基于 Air1603 的最小系统板,只做「屏+触摸+喇叭+SD 卡」这一件事,不带网络与工业接口;8603 是同一颗主控的完整形态,把 4G、Wi-Fi、以太网、485/232、SIP 通话都做进去了。所以端口不够时用 8603 主板扩展是标准做法,屏幕接上即可,但要按屏的针数与分辨率重新核对接口与时序。 处理步骤:① 先确认屏的针数:8603 板上同时有 40PIN 与 50PIN 连接器,但两者共用同一组显示信号,只能二选一;② 核对分辨率与时序参数是否在支持列表内;③ 触摸单独走 FPC(I2C),不要和显示排线混接;④ 按整机结构确认主板尺寸与安装孔位;⑤ 上电前先量背光与逻辑供电,避免屏与主板电压不匹配。 参考文档:https://docs.openluat.com/air8603/product/ · https://docs.openluat.com/air8607/product/

21. 8808/8608系列进展如何?8608DE是否考虑?

解答: 结论:8608U 已经投板,在推进中;8608DE 暂不考虑,原因是 DVP 摄像头、屏、网口这几路资源在同一个主控上分配不开。 说明:带屏产品的主控资源是硬约束:LCD 要占一路高速显示接口和大量带宽,DVP 摄像头要占并口与时序资源,网口再占一路 MAC/PHY,三者叠在一起,剩下的引脚和带宽就不够了。这不是软件优化能绕过去的,所以 DE 形态被否掉,优先做资源冲突更小的 8608U 形态。 处理步骤:① 项目选型时先明确「屏+DVP+网口」是否要同时存在,三者同存基本不可行;② 需要网口+屏,优先看 8606/8603 这类把网口做到主控侧或 4G 侧的方案;③ 需要摄像头+屏,确认摄像头走 DVP 还是 SPI/USB;④ 关注官方发布节奏,具体上市时间以公告为准;⑤ 别按未发布的型号做量产 BOM 冻结。 参考文档:https://docs.openluat.com/air8606/ · https://docs.openluat.com/air8603/product/

22. 8607W、8607B什么时候可以买/上架?

解答: 结论:按当时的进度口径,8607W 与 8607B 都安排在下周开卖;上架时间以合宙淘宝店和官方公告为准,别把「下周」当成合同交期。 说明:新品上架要经过小批量试产、出厂固件打包、包装与商品页准备几个环节,任何一个环节延后都会顺延上架时间。8607 系列已经量产在售的型号可以直接买,W/B 属于新增配置,硬件平台相同、差别在无线与接口配置上。 处理步骤:① 关注合宙淘宝店的上架状态与官方公众号通知;② 项目排期按「已上架型号」做,新增型号留缓冲;③ 上架后先买样机验证配置差异是否满足需求;④ 需要提前锁货的走商务沟通。 参考文档:https://docs.openluat.com/air8607/product/

23. 8701什么时候上架?

解答: 尚未解答

24. 8606带RJ45网口直连的板子进展如何?是否支持网口远程升级和与PLC做TCP通讯?

解答: 尚未解答

25. Air724UG使用LuatOS-Air_V4033_RDA8910.pac报 attempt to index global 'math' (a nil value),如何解决?

解答: 结论:换成带 FLOAT 的固件包 LuatOS-Air_V4033_RDA8910_BT_FLOAT.pac 就有 math 库了,不带 FLOAT 的包里没有编入浮点与 math 相关支持。 说明:RDA8910(Air724UG)平台的固件分包时,浮点运算支持是可选编译项:不带 FLOAT 的固件为了省空间去掉了浮点库与 math 模块,脚本里只要出现 math.xxx 就会报 attempt to index global 'math' (a nil value)。这不是脚本写错,也不是库缺失,换包即可。要注意换包后其他库的版本也跟着变了,需要整体回归。 处理步骤:① 确认当前烧的是哪个 pac(看文件名里有没有 FLOAT);② 换烧 LuatOS-Air_V4033_RDA8910_BT_FLOAT.pac;③ 换包后先跑一段最小脚本确认 math、string.format 的浮点格式化都正常;④ 回归其他业务功能,确认没有因换包丢失别的库;⑤ 量产时把固件包名写进 BOM 与烧录作业指导书,避免产线混用。 参考文档:https://docs.openluat.com/common/LuatOS_Air/ · https://docs.openluat.com/air724ug/product/

26. 合宙IoT平台如何添加设备/转移设备归属?

解答: 结论:加设备与转移归属都在合宙 IoT 平台操作,具体步骤见设备归属转移教程。 说明:设备归属决定这台设备的数据进哪个账号、由谁做 OTA 与远程配置。默认情况下设备首次联网会归属到它配对的平台项目下;需要把设备交还给客户或转到另一个项目时,必须走归属转移流程,不能只把 IMEI 从列表里删掉——删掉只是从视图里移除,归属关系不变。 处理步骤:① 登录合宙 IoT 平台,进入对应项目;② 添加设备时按 IMEI 录入,确认设备在线后归属即生效;③ 转移归属按教程在平台侧发起,需要提供 IMEI 与目标账号信息;④ 转移完成后在目标账号确认设备已出现且能正常上报;⑤ 批量转移走商务或技术支持协助,别逐台点。 参考文档:https://docs.openluat.com/air780epm/product/attributioniot/ · https://docs.openluat.com/value/iot/

27. 一批新开的流量卡在780EP上CREG一直为0、识别不到卡,其他运营商卡正常,怎么办?

解答: 尚未解答

28. Air780E_A19 LuatOS V1124调试RS485 Modbus RTU,GPIO16方向切换时机如何保证发送完成?

解答: 尚未解答

29. 用普通串口能收到数据,用exmodbus一直超时收不到数据,是什么原因?

解答: 结论:这个问题客户自己排查后已经定位到原因,不是 exmodbus 库的缺陷;同类现象按下面的顺序逐项排除即可。 说明:exmodbus 一直超时但普通串口能收到数据,说明物理链路与波特率基本是对的,问题集中在「帧能不能被判定为一帧完整报文」上:485 收发方向切换太慢会把帧头吃掉,校验方式或从站地址不匹配会被静默丢弃,超时参数小于实际响应时间也会判超时。普通串口只是把字节打出来,不做帧边界与校验判断,所以看起来「能收到」。 处理步骤:① 核对波特率、数据位、停止位、校验位与从站完全一致;② 检查 485 方向控制脚(DE/RE)的切换时机,发送完成后要等最后一个字节移出再切回接收;③ 确认从站地址与功能码在该从站上确实支持;④ 把超时时间放大到从站实际响应时间的 2~3 倍复测;⑤ 用逻辑分析仪抓总线波形,确认请求帧完整发出、从站有回帧。 参考文档:https://docs.openluat.com/osapi/ext/exmodbus/

30. 串口模块方案中,回环收发测试时USB虚拟串口收发时延会超过10ms吗?

解答: 结论:会超过 10ms,USB 虚拟串口本质上不是实时通道,时延受主机轮询与缓冲影响,一定要用回环实测确认后再定超时参数。 说明:USB CDC 的收发走主机 1ms 帧调度,数据先进缓冲区再被驱动取走,方向切换还要等上行/下行事务排到;再叠加脚本层的事件回调与 sys.wait 调度,单次往返很容易到十几毫秒,负载重时会更大。相比之下,硬件 UART 是字节级中断,时延稳定在微秒到毫秒级。所以凡是要求「发出去多久内必须回」的协议,都不该建立在 USB 虚拟串口上。 处理步骤:① 做回环测试:短接模组的 TX/RX,脚本里发带时间戳或序号的数据,统计往返时延分布;② 记录最小值、平均值与最大值,按最大值设计超时,而不是按平均值;③ 减少同时运行的任务与日志打印,避免调度抖动;④ 对时延敏感的业务改用硬件 UART;⑤ 主机侧不要用会做行缓冲的终端软件测试,会引入额外延迟。 参考文档:https://docs.openluat.com/osapi/core/uart/ · https://docs.openluat.com/osapi/core/usb/

31. Luatools更新固件经常失败怎么办?

解答: 结论:先让模组强制进 boot 模式(BOOT 拉高/拉低后重新上电)再烧录;仍失败就换线换口、关掉占用串口的软件,必要时用 Flashtools 擦除后再烧。 说明:Luatools 更新固件分两步:先让模组进入 boot 下载模式,再通过 USB 全量写入。常见的「更新失败」多数卡在第一步——模组已经在跑用户脚本,USB 口被别的程序占用,或者 BOOT 电平时机不对,工具就一直等不到下载模式。另外长期反复烧录后 flash 里的旧参数也可能干扰。 处理步骤:① 关闭串口助手、其他 Luatools 实例、虚拟串口工具,确保 USB 口独占;② 按型号的强制下载方式操作(BOOT 拉高或拉低后重新上电),保持到工具识别到设备;③ 换一根短的屏蔽 USB 线,直连电脑后置 USB 口;④ 仍失败时用 Flashtools 擦除整片再烧;⑤ 记录失败时的完整报错文本,提交技术支持。 参考文档:https://docs.openluat.com/common/Luatools/

32. 认证固件用Luatools烧录不成功,换Flashtools可以,为什么?

解答: 结论:认证固件用 Luatools 烧录时可能无法把原来的配置参数完全擦除覆盖,改用 Flashtools 先擦除模组原有参数再烧录即可。 说明:认证固件对 NV/配置分区的内容敏感,Luatools 的烧录流程是按「保留部分参数」设计的,遇到认证固件要求整片干净时就会残留旧配置,表现为烧录「成功」但开机异常、注网失败或认证不过。Flashtools 提供整片擦除能力,先把参数区清干净再烧认证包,行为才可预期。另外 Luatools 遇到 binpkg 不支持的提示时,连点两次 OK 让它继续,并在选项里勾选「清除 kv 分区」「清除文件系统分区」。 处理步骤:① 用 Flashtools 做整片擦除;② 再用 Luatools 或 Flashtools 烧认证固件;③ 烧完断电重启,确认能正常开机与注网;④ 认证前不要回烧普通固件,避免参数被改回去;⑤ 产线把「先擦除再烧」写进作业指导书。 参考文档:https://docs.openluat.com/air780epm/product/renzheng/ · https://docs.openluat.com/common/Luatools/

33. Air8000A的蓝牙能否扫描信标蓝牙信号,还是只能广播?

解答: 结论:可以,Air8000A 的蓝牙支持主动扫描,能扫到信标(beacon)广播并解析其广播数据,不只是被动广播。 说明:Air8000A 内置 BLE 5.4,协议栈支持扫描与广播两个方向:扫描时可以按 MAC、按广播内容过滤,拿到 RSSI 与 manufacturer data,这正是识别信标需要的字段;广播方向则是把自己做成信标。要注意扫描要开窗、占空比高时功耗上升明显,电池供电设备要做占空比控制。 处理步骤:① 按扫描例程初始化 BLE 并开启扫描;② 用过滤条件只保留目标信标的广播,避免刷屏;③ 解析广播里的 manufacturer data 拿到信标 ID 与电量等字段;④ 用 RSSI 做距离粗判时注意环境衰减,别当测距用;⑤ 电池场景控制扫描占空比,或改成定周期短暂扫描。 参考文档:https://docs.openluat.com/air8000/luatos/app/BLE/scan/ · https://ai.luatos.com/

34. 合宙屏幕是否支持竖屏、40Pin高分辨率屏?

解答: 结论:支持竖屏,也支持 40PIN 的高分辨率屏,具体取决于所选型号的屏接口与分辨率上限。 说明:竖屏不是换屏,而是把屏按旋转后的方向配置:改宽高参数与扫描方向,触摸坐标也要跟着做一次坐标变换,两步都做对才不会出现「显示竖了、触摸错位」。40PIN 是常见小屏的连接器规格,能否用高分辨率要看主控的显示接口带宽与屏自身的时序,接口够但分辨率超出上限时会出现花屏或刷新极慢。 处理步骤:① 先确认型号支持的屏接口(SPI / QSPI / RGB)与最大分辨率;② 竖屏时同步修改宽高、扫描方向与触摸坐标映射;③ 40PIN 屏要核对针序与背光、复位、触摸的独立走线;④ 高分辨率先做刷新率与内存占用实测,别只看点亮;⑤ 换屏后重做时序与背光电流验证。 参考文档:https://docs.openluat.com/osapi/core/lcd/ · https://docs.openluat.com/air8603/product/

35. airui容器组件边框会占用容器可用空间导致出现滑块,能否改为不占用内部空间?

解答: 尚未解答

36. air160x/air8101是否支持VNC远程控制屏幕?

解答: 结论:Air160x 没有硬件视频编码器,不支持 VNC 这类远端屏幕推流;Air8101 还在评估中,能否支持要看后续固件与库的进展。 说明:VNC 需要把整屏画面实时编码后通过网络发出去,编码是持续的高负载任务。没有硬件编码器就只能靠软件编码,帧率与分辨率会被压得很低,还会挤占显示与业务线程,实际体验达不到可用水平。Air8101 是带多媒体能力的 Wi-Fi SoC,理论上具备评估基础,但目前还没有可交付的方案。 处理步骤:① 远端看屏需求先明确是「看画面」还是「远程操作」;② 只需要看状态就上报关键数据或截图,不要做整屏推流;③ 需要远程操作可做成设备端指令接口,由服务端下发动作;④ 关注 Air8101 的多媒体能力更新;⑤ 别按未发布的能力做产品定义。 参考文档:https://docs.openluat.com/air8101/product/ · https://docs.openluat.com/osapi/core/lcd/

37. 固件内字体发虚问题什么时候能更新?

解答: 结论:字体的粗细度调整当天就能改,渲染算法的重写要等到下周,而且重写后验证周期较长。 说明:字发虚分两类原因:一类是字重(笔画粗细)与 hinting 参数不合适,调参数即可,改动小、风险低;另一类是点阵取模与渲染路径本身的问题(缩放插值、亚像素对齐、字号非整数倍),必须改渲染算法,改完要在多种字号、多种背景色、多块屏上逐一看效果,验证工作量远大于改代码。 处理步骤:① 先确认发虚是「整体偏细/偏粗」还是「边缘模糊、笔画断裂」;② 整体字重问题等粗细度版本更新即可;③ 边缘模糊属渲染问题,需要等算法重写版本;④ 拿到新版本后按实际字号与背景色逐一验证;⑤ 量产前锁定字体与固件版本,别中途换。 参考文档:https://docs.openluat.com/osapi/core/hzfont/

38. Luatools下载地址在哪里?

解答: 结论:Luatools 的下载地址就是文档里的 Luatools 页面,里面按版本列出了安装包与更新说明。 说明:Luatools 是合宙的图形化工具,负责固件烧录、脚本下载、日志查看和项目管理,不同版本对固件与芯片的支持范围不同。下载时注意两点:一是选与你的模组平台匹配的版本,二是安装路径不要带中文和空格,否则容易出现烧录工具找不到临时文件的怪问题。 处理步骤:① 打开 Luatools 页面;② 下载最新版安装包;③ 安装到纯英文路径;④ 首次打开后先更新固件列表,再连接设备;⑤ 保留一份历史版本,遇到新版兼容问题时可以回退。 参考文档:https://docs.openluat.com/common/Luatools/

39. docs代码库一直拉取失败,如何处理?

解答: 结论:先用浅拷贝把仓库拉下来(git fetch --depth=10,不成再加大到 50、100),再 git pull 补齐;合宙这边本周末会切换到新库,届时所有人重新 clone 一次。 说明:docs 仓库历史提交多、二进制资源大,全量 clone 在弱网下极易中断,而且中断后重试还是从头来。浅拷贝只取最近若干次提交,先让工作区可用,之后按需再加深历史,是这类大仓库的常规做法。仓库迁移属于结构性变更,迁移后旧的 remote 地址失效,必须重新 clone 而不是继续 pull。 处理步骤:① 先 git fetch --depth=10;② 失败就改 --depth=50、--depth=100 逐步加大;③ fetch 成功后 git pull 完成工作区;④ 单独需要某个历史版本时再 git fetch --depth 加深或按需 fetch 具体提交;⑤ 本周末仓库切换后,删掉旧目录重新 clone,不要原地改 remote。 参考文档:https://docs.openluat.com/common/docs_guide/

40. libfota3升级能下载成功但日志一直打印数据长度错误,如何处理?

解答: 结论:改过 libfota3.lua 之后升级已经能正常完成,日志里的数据长度错误不再出现;但还要多挂测观察,跨版本差异大的场景也可以参考 libfota2 的逐级升级方案。 说明:「数据长度错误」是设备端拿到的数据长度与包头声明的长度对不上,常见于下载被截断、服务器返回的内容与实际包不一致、或差分包的中间状态被当成整包处理。改脚本修的是设备端的长度校验与重试逻辑,能绕开偶发的截断,但如果平台侧包本身有问题,还是会复现,所以要挂测。 处理步骤:① 先用修好的 libfota3.lua 连续跑多轮升级,记录每轮日志;② 故意制造弱网、断电,验证能否自动重试到成功;③ 跨大版本升级时改用多段升级,缩短单次差分量;④ 统计失败率与失败阶段,异常时保留 log 定位;⑤ 量产前把固件基线、脚本版本、平台包版本三者对齐。 参考文档:https://docs.openluat.com/osapi/ext/libfota3/ · https://docs.openluat.com/osapi/ext/libfota2/

41. libfota3跨版本差异过大(如2022升到2056)需要多次差分,如何处理?

解答: 结论:在平台侧配置多段升级(例如先 24→29、再 29→36),一次只开一段,升到中间版本后再开下一段;也可以参考 iRTU 的默认文件加备份文件机制做兜底。 说明:差分升级的包是按「源版本→目标版本」生成的,跨版本跨度越大,差异数据越多、越容易超出下载与存储的承受范围,失败后设备可能停在中间态。分段升级把一次大跳变成几次小跳,每段都是可控的差分量,还能在中途失败时停在已知可用的中间版本上。默认文件加备份文件的做法,是在升级写坏时能退回上一份可用脚本,属于兜底而不是替代方案。 处理步骤:① 梳理现网设备的版本分布,确定分段点;② 在平台按版本区间配置多段升级任务;③ 先开第一段,确认达标率后再开下一段;④ 每段都保留回滚路径(备份文件/上一版固件);⑤ 全程监控升级结果上报,失败设备单独处理。 参考文档:https://docs.openluat.com/osapi/ext/libfota3/ · https://docs.openluat.com/air780epm/luatos/firmware/780ehm_version/

42. Air8607的底层CORE是哪个,如何烧录自己写的脚本?

解答: 结论:Air8607 的底层核心是 Air1603,自己写脚本时 core 要烧 Air1603 的 V1030 102 号内核固件;量产出货的整机则用 8607 的量产文件(.soc)刷机。 说明:8607 是「Air1603 主控 + 大屏 + 触摸 + 喇叭 + SD 卡」的最小系统板,LuatOS 脚本跑在 Air1603 上,所以 core 与 Air1603 同源:同一个 V1030 102 号内核。量产文件和内核固件不是一回事:量产 .soc 里已经把出厂工程、屏参、资源与内核打包在一起,直接烧整包;自己开发时只烧内核再下脚本,方便迭代。 处理步骤:① 开发阶段:core 选 Air1603 的 V1030(102 号),用 Luatools 烧入;② 再下载自己写的脚本与资源;③ 屏参(分辨率、时序)要与实物屏一致,10 寸是 1024×600;④ 量产阶段:换成 8607 对应的量产 .soc 整包烧录;⑤ 烧前确认型号(8607 / 8607A / 8607W)与整包匹配。 参考文档:https://docs.openluat.com/air8607/software/default_factory_firmware/ · https://docs.openluat.com/air8607/product/

43. Air780EGH做SIP通话,A呼B后A挂断,B仍保持通话不会挂断,如何解决?

解答: 结论:合宙的分析结论是 BYE 重传与服务器响应处理的问题;扩展库已经加上 BYE 事务重传,配合最新的 exsip.lua、exsipclient.lua、exsipproto.lua 与 V2056 固件做验证。 说明:SIP 挂断靠 BYE 事务,UDP 上丢包不会自动重发,设备发出 BYE 后如果没收到 200 OK,事务会停在「等待响应」;对端(B 侧)收不到 BYE 就会一直保持在通话状态,表现就是 A 挂了 B 还在讲。修法是在事务层加重传与超时处理:规定时间内没收到响应就重发 BYE,多次失败后主动释放本地会话并上报。 处理步骤:① 三个库文件全部更新到最新版本,不要只换其中一个;② 固件基线统一到 V2056;③ 复测 A 呼 B、A 挂断,确认 B 侧状态与话单都结束;④ 制造丢包(弱网)环境再测一遍,看重传是否生效;⑤ 抓 SIP 报文确认 BYE 与 200 OK 的完整交互。 参考文档:https://docs.openluat.com/osapi/core/voip/ · https://docs.openluat.com/air780epm/luatos/firmware/780ehm_version/

44. 换了新版本exsip库后挂断问题依旧存在?

解答: 尚未解答

45. 780EGH刷认证固件后不开机怎么办?

解答: 尚未解答

46. 设备归属默认在哪里?第一次刷自己的程序会自动归属吗?

解答: 结论:设备归属由平台侧决定,第一次刷自己的程序不会自动改归属;要查这台设备现在归谁,需要提供 IMEI 由合宙协助查询,转移归属按教程操作。 说明:归属关系记录在平台数据库里,以 IMEI 为键,与设备上跑的固件、脚本无关。刷自己的程序只是换了设备端逻辑,设备上报时仍然用同一个 IMEI 上报到同一个项目。所以「刷完程序归属变了」这种判断通常是把「设备不在我的设备列表里」误当成归属变了——更多是设备还没上报、或者项目配对参数不对。 处理步骤:① 先确认设备已经联网并成功上报(平台能看到最后一次上线时间);② 确认设备端连接的平台项目参数正确;③ 查归属时提供 IMEI 给合宙协助查询;④ 需要转移的按教程在平台发起,转移后在目标账号确认设备出现;⑤ 批量设备走商务或技术支持统一处理。 参考文档:https://docs.openluat.com/air780epm/product/attributioniot/ · https://docs.openluat.com/value/iot/

47. Air780EHU插卡后注网失败,手机插同卡可连联通,模组显示失败,如何排查?

解答: 结论:先确认天线接了没有,再核对现场频段与运营商是否匹配:现场 4G 只有 B1/B5 且信号差,而中国移动不使用 B1/B5,这种情况本来就连不上。 说明:模组能不能注网,取决于「模组支持的频段 ∩ 当地运营商在用的频段」是否为空。Air780EHU 是欧亚版,支持 B1/B3/B5/B7/B8/B20/B28/B38/B40/B41;如果现场只有 B1/B5 覆盖,那只能靠这两个频段,而这两个频段上并没有中国移动的网。手机能连是因为手机支持的频段更多、还能回落 3G/2G,模组没有这些退路。 处理步骤:① 先确认天线已接、天线与频段匹配;② 用手机装 cellular-Z 之类工具看现场各运营商的频段与信号强度,与手机做同位置对比;③ 确认模组型号的频段覆盖是否包含现场在用频段;④ 抓完整注网 log,并循环调用 mobile.getCellInfo 打印周边小区与频段;⑤ 频段确实不匹配时只能换型号或换安装位置,不要指望改软件解决。 参考文档:https://docs.openluat.com/osapi/core/mobile/ · https://docs.openluat.com/air780ehnehu/product/air780ehufreq/

48. Air780EHU等模组如何获取周围小区/频段信息用于排查注网?

解答: 结论:用 mobile.getCellInfo() 就能拿到周围小区与频段信息,返回结果里包含当前服务小区与邻区的频点、频段、信号强度。 说明:注网类问题最怕「只看到注不上,不知道周围有什么」。getCellInfo 提供的是模组当前扫到的小区列表,可以用来判断现场到底有哪些频段、信号多强、是不是只覆盖了模组不支持的频段。要注意它是即时查询,不会持续刷新,排查时要放在定时器里循环打印,才能看出小区切换与信号起伏。 处理步骤:① 用 sys.timerLoopStart 定周期(如 10 秒)调用 mobile.getCellInfo();② 用 json.encode 打印完整结果,便于保存与比对;③ 记录频段、频点、RSRP/RSRQ 与小区 ID;④ 与手机侧的 cellular-Z 数据对比,确认是否漏扫或频段不匹配;⑤ 把日志与结论一起提交技术支持,比只发一句「注不上网」有效得多。 参考文档:https://docs.openluat.com/osapi/core/mobile/#mobilegetcellinfo

49. Air780EHT要把模块当网卡用在ARM Linux板子上,电脑没有自动联网怎么办?

解答: 结论:RNDIS 默认是关闭的,需要通过 AT 指令打开;如果项目只要「插上就当网卡」,也可以直接选默认开启网卡功能的 Air780ER2 / Air780ER3。 说明:Air780EHT 定位是可二次开发/AT 控制的 4G 模组,USB 默认工作在 AT 串口模式,主控看到的是一串 AT 口,自然不会有网卡。RNDIS 要在 USB 配置里显式打开,有的型号还提供 NAT 模式选项(由基站分配 IP)。Air780ER2/ER3 出厂就把 RNDIS 打开,插到 ARM Linux 主控上直接识别成网卡,省掉配置这一步。 处理步骤:① 用 AT 指令查询当前 USB 配置;② 按型号手册设置 RNDIS 相关参数(部分型号可选 NAT 模式),注意该配置有的只能在开启前修改;③ 重新插拔 USB 或重启模组让配置生效;④ 在 ARM Linux 侧确认出现网卡设备并拿到 IP;⑤ 只要网卡功能就换 Air780ER2/ER3,省去现场配置。 参考文档:https://docs.openluat.com/air780ehnehu/product/air780exxpins/ · https://docs.openluat.com/common/Air_AT/

50. 合宙淘宝店搜不到了?

解答: 结论:因为店铺客服发送联系方式被平台处罚,暂时搜不到店铺;按当时的答复下周一恢复可被搜索,这段时间可以直接输入店铺地址进店。 说明:淘宝对站内引导站外联系方式有明确处罚规则,触发后会影响店铺在搜索结果里的曝光,但店铺本身与商品链接仍然可用,所以老客户用直链下单不受影响,新客户搜不到而已。这类处罚有固定周期,恢复后搜索排名会逐步回来。 处理步骤:① 直接用店铺直链进店(https://luat.taobao.com/);② 收藏店铺与商品,避免下次再找不到;③ 需要选型或批量采购直接找客服或商务;④ 关注合宙公众号获取最新购买入口。 参考文档:https://luat.taobao.com/ · https://docs.openluat.com/SelectionGuide/SelectionGuide/

51. 合宙产品能否出厂直接帮忙烧录?烧录速度能提高吗?

解答: 结论:批量订单可以让合宙出厂时直接烧录好,省掉产线自己烧的工时;自己烧之所以慢,是因为每次都要重新烧 core(内核),这一步是全量写入再校验。 说明:一条产线的烧录时间主要由 core 决定:内核固件几 MB,走 USB 全量写入并逐块校验,单片就要几十秒;脚本和资源只占很小一部分。出厂烧录是在产线批量环境里做的,可以并行,所以摊到单台的工时远低于自己一片一片烧。另外出厂烧录还能顺便做一次完整功能自检。 处理步骤:① 按批量订单与商务确认出厂烧录需求;② 提供固件版本、脚本、屏参与型号信息;③ 确认烧录后的自检项与不良判定标准;④ 自己烧的场景下固定一条产线工位、用稳定 USB 口,减少失败重试;⑤ 量产固件版本冻结后再安排烧录,避免返工。 参考文档:https://docs.openluat.com/common/Luatools/ · https://docs.openluat.com/air8607/software/default_factory_firmware/

52. 盖子价格是多少?

解答: 结论:盖子 1 元/个,含税含运费。 说明:盖子属于配件,按个计价,价格里已经把税与运费算进去了,不需要另外加运费或凑单。批量采购时按实际数量乘单价即可,具体库存与发货时间问客服确认。 处理步骤:① 按需要的数量下单;② 与客服确认当前库存与发货时间;③ 大批量一起下单,避免多次发货;④ 收到后核对型号是否与你的模组/开发板匹配。 参考文档:https://luat.taobao.com/

53. 是否支持WIFI转以太网(网口)功能?进度如何?

解答: 尚未解答

搜索