跳转至

常见问题 - 2026-08-02

数据日期：2026-08-02

1. 合宙云平台升级能不能增加定时升级功能？

解答： 结论：合宙IoT平台本身不提供"服务器端按时间点统一定时推送升级"的功能；FOTA升级由终端主动发起请求，需要"定时升级"时在终端侧实现即可。

原理：LuatOS的FOTA流程是设备端调用 libfota2.request() 主动向服务器查询并下载升级包，服务器只负责版本管理与升级包下发，不主动连接终端。因此"定时"逻辑应放在设备代码中：用定时器（如 sys.timerLoopStart）在指定时间点或每天固定时刻调用一次升级请求即可，libfota2本身也支持定时自动检查更新。注意AT指令固件无法编写自定义脚本逻辑，不能在终端侧实现定时升级。

参考文档：https://docs.openluat.com/air780epm/luatos/app/ota/fota/

2. 官方main.lua从哪里下载？

解答： 结论：官方main.lua不在单独的下载页，而是随各产品的LuatOS demo工程一起发布在Gitee代码仓库的 module/对应型号/demo/ 目录下。

获取方法（以Air780EPM为例）： 1. 打开Gitee仓库 https://gitee.com/openLuat/LuatOS/tree/master/module/Air780EPM ，进入 demo 目录，每个功能例程（如gpio、socket、http、ntp等）文件夹内都包含可直接运行的 main.lua； 2. 其他型号同理，将路径中的型号替换为对应产品即可，例如Air8000为 https://gitee.com/openLuat/LuatOS/tree/master/module/Air8000/demo ； 3. 也可访问文档站 https://docs.openluat.com/ 对应产品页，各功能教程中均附有该demo的直达链接，点击即可跳转仓库下载。

3. AIR780EPM核心板原理图在哪里找？

解答： 结论：Air780EPM核心板原理图、PCB及硬件手册统一发布在官方资料汇总页，可直接下载。

获取方法： 1. 打开资料页 https://docs.openluat.com/air780epm/product/shouce/ ，其中"Air780EPM/Air780EHM核心板，开发板及配件板资料"栏目提供核心板原理图与PCB压缩包（新版为 Air780Exx_核心板_原理图&PCB，旧版为 Air780EPM&Air780EHM核心板原理图&PCB_V2.0）； 2. 同一页面的"Air780EPM/Air780EHM产品手册"栏目还提供《Air780EPM&Air780EHM硬件手册》PDF和硬件设计指导在线文档，硬件设计时建议同时参考：https://docs.openluat.com/air780epm/product/shouce/

4. 780E的规格书还有吗/在哪里？

解答： 结论：Air780E的规格书/硬件手册仍可在官方资料页下载，但该版本内容相对较早，设计时如有冲突请以硬件设计指导文档为准。

获取方法： 1. 打开Air780E资料汇总页 https://docs.openluat.com/air780e/product/ ，在"模块硬件资料"表格中可下载《Air780E硬件手册V1.0.pdf》，并提供全系列4G模组管脚图及管脚说明一览； 2. 官方明确提示：硬件手册和规格书内容相对较老，若与最新产品定义冲突，应以"AT指令开发硬件指南"（https://docs.openluat.com/air780e/at/hardware/design ）和"LuatOS二次开发硬件指南"（https://docs.openluat.com/air780e/luatos/hardware/design ）中的内容为准。

5. SIP demo找不到用户/配置好了但连不上是为什么？

解答： 结论：SIP/VoIP功能基于 exsip 扩展库实现，"找不到用户/配置好连不上"绝大多数是固件版本不支持exsip、账号参数未在SIP服务器上开通或网络未就绪三类原因，按以下步骤排查：

  1. 固件前提：exsip为较新固件才集成的扩展库（SIP通话还需要音频硬件支持），请将模组升级到当前最新LuatOS固件后再测，最新固件在文档站对应产品的"固件和demo→固件版本"栏目下载；
  2. 账号前提：demo中的 sip_username/sip_password 必须是SIP服务器上已创建并开通的分机账号，用户名与服务器配置完全一致（不含@、空格等特殊字符），服务器端不存在该用户时注册会被拒；
  3. 参数核对：检查 sip_server_addr、sip_server_port（默认5060）、sip_domain、sip_transport（UDP/TCP）是否与服务器一致；
  4. 网络前提：代码需等待默认网卡就绪（IP_READY）后再启动注册；
  5. 日志定位：注册结果通过 exsip.on() 的 register 事件回调返回（ok/注册成功，challenge/认证挑战，其余为失败），请截取从开机到注册失败的完整日志（含sip_callback打印）对照定位。

参考文档与demo： - exsip API说明：https://docs.openluat.com/osapi/ext/exsip/ - 官方demo：https://gitee.com/openLuat/LuatOS/tree/master/module/Air8000/demo/sip （Air8201、Air780EHM_Air780EHV_Air780EGH等带音频型号的demo目录下同样提供sip例程）

解答： 结论：合宙DAPLink调试器已停止维护，官方不再提供其固件下载，无法通过公开渠道获取该固件，请勿再依赖该方案。

替代建议： 1. LuatOS模组（4G Cat.1等）的固件烧录与脚本下载统一使用官方LuaTools工具完成，无需DAPLink，工具下载与教程见 https://docs.openluat.com/common/Luatools/ ； 2. 如需调试排错，可通过LuaTools抓取运行日志，并配合errDump异常日志上报功能定位问题，参考 https://docs.openluat.com/air780epm/luatos/app/errdump/ ； 3. Air32等MCU产品如需SWD/JTAG调试，请使用当前主推的官方调试套件及对应产品页说明。

7. Air724ug不支持广电吗？信号不稳定，有时候有信号有时候没有。

解答： 结论：Air724UG支持使用中国广电SIM卡，请将固件升级到最新版本后使用；信号时有时无属于射频/驻网问题，需按天线、SIM卡、固件三项逐一排查。

排查步骤： 1. 升级固件：先刷到该型号最新固件，早期固件存在掉网后不重新驻网等问题； 2. 查SIM卡：确认广电卡未欠费、已激活且数据业务正常，可换一张其他运营商卡交叉对比（中国大陆环境下移动、联通、电信、广电卡均支持）； 3. 查天线：确认天线已可靠连接、天线频段匹配，天线远离无刷电机、电池和金属屏蔽件，弹簧天线未做阻抗匹配时建议改用IPX座子外接天线； 4. 不要锁频：人为锁定频段可能导致无法驻留广电可用频段，保持默认全频段； 5. 查信号质量：用 mobile.rsrp() 读取信号强度、mobile.getBand() 确认模组支持的频段，用默认出厂固件对比，若默认固件信号仍差则偏向硬件天线问题，若默认固件正常则为软件配置问题。

8. 780EVT socket断开，怎么确认是平台断开的还是设备这边的问题？

解答： 结论：socket断开是平台侧主动断开还是设备侧异常，可通过TCP链路日志和异常日志两方面定位，关键看断开方向与错误码。

排查步骤： 1. 读设备端日志：在Luatools完整应用日志中搜索 net_lwip_tcp_err_cb，错误码可区分原因——-14（ERR_RST）表示收到对端RST报文，是服务器/平台侧主动重置连接；-13（ERR_ABRT）多为本地或对端异常中止、握手超时被固件主动断开； 2. 抓网络侧报文：在服务器端或链路中抓TCP包，看FIN/RST由哪一侧先发出：平台先发FIN/RST则为平台断开（检查平台心跳超时、踢下线策略），设备侧先发则排查模组网络掉线、信号差、心跳未及时发送等； 3. 抓异常日志：使用errDump（异常日志上报）功能，可将运行异常日志自动上报或手动通过TCP/串口导出db日志文件，确认断开时刻是否伴随网络掉线、重启或内存异常，参考 https://docs.openluat.com/air780epm/luatos/app/errdump/ ； 4. 保活建议：在应用层增加心跳包和断线自动重连逻辑，NAT映射超时或长时间无数据也会导致链路被中间网关或平台回收。 socket错误码详解可参考LuatOS socket教程：https://docs.openluat.com/luatos_lesson/002_luatos_socket/

9. AIR780EPM只有输入3.9V和IO27接10K电阻再到LED灯，上电灯闪了，为什么放着过段时间电流越来越大直到有糊味？

解答： 结论：3.9V供电电压本身合法（Air780EPM的VBAT供电范围为3.3V~4.35V），IO27串10K电阻驱动LED也几乎不耗电（AGPIO单管脚驱动上限仅5mA，10K电阻下电流仅零点几毫安），这两处都不是烧机原因；"电流随时间越来越大并出现糊味"是模组或供电回路存在短路/器件已被击穿损伤的典型特征，必须立即断电检查，故障件不可再上电。

原理与排查： 1. 供电能力：VBAT（PIN42/43）在4G发射时需要1A以上瞬时电流，电源必须能稳定提供≥1A，且要求就近并联220uF电解电容（或22uF钽电容）。若电源电流余量不足、线材细或无储能电容，发射瞬间电压跌落会反复重启，但此类问题只会重启、不会产生糊味；糊味说明已有功率器件损坏或电源轨短路。 2. 回路短路：断电后用万用表测VBAT对GND的电阻，若阻值极低即已短路。重点检查VBAT与GND是否焊连、引脚间是否有锡桥/助焊剂残留、电源极性是否接反（反接会直接烧毁模组）。 3. 接线与过压：核对电源是否误接到非电源管脚、历史上是否有过5V/12V误灌入；单个IO口灌入超过其电压域电流上限也会损坏内部LDO（IO27属LDO_AON电压域的AGPIO，总输出能力仅10mA）。 4. LED电路本身：正确接法为 IO27→10K电阻→LED→GND（注意LED极性方向）；上电瞬间LED闪一下属正常现象——文档明确GPIO上电/复位时会有约1ms异常高电平，可加下拉电阻消除，该闪灯与烧损无关。 5. 损坏判定：模组烧毁的典型现象是开不了机、模块明显发烫，或个别引脚打坏后虽能开机但持续发烫。满足这些现象即为硬件损坏，需更换模组/核心板。

整改建议： - 立即停止使用已发热、有糊味的模组，更换新模组验证；新模组按硬件设计指导布线：VBAT走线加宽加短、就近放置220uF电解+0.1uF陶瓷电容、电源限流能力≥1A； - 上电前先空载测量电源电压稳定在3.3V~4.35V，再串电流表确认无短路后接模组； - 参考文档：供电设计 https://docs.openluat.com/air780epm/luatos/hardware/vbat/ ，GPIO/AGPIO参数 https://docs.openluat.com/air780epm/luatos/hardware/gpio/ ； - 损坏件若需判定是否人为损坏，可联系官方售后处理。

搜索