常见问题 - 2026-08-22
数据日期：2026-08-22
1. 运行irtu-pet-tracker示例，把运动检测关了，是否就无法使用GPS定位？
解答： 不会。iRTU免开发固件的GNSS定位支持两种触发方式：定时开启GNSS定位和震动触发开启GNSS定位。运动（震动）检测只是GNSS的唤醒触发条件之一，关闭后仅是不再由震动事件触发定位，定时定位任务和手动定位仍然正常工作。请在iRTU配置后台确认GNSS配置项中的“定时开启定位”已启用并设置合理的上报间隔，配置修改提交后设备重启生效。GNSS配置说明见iRTU免开发固件文档 https://docs.openluat.com/value/irtu/firmware/
2. 购买合宙产品后没有说明文档，如何获取？
解答： 合宙所有产品资料均在文档站公开免费提供，按以下两种方式获取：1. 访问合宙文档中心 https://docs.openluat.com/ ，按产品系列进入对应型号页面，即可查看产品简介、硬件手册、固件下载、LuatOS软件开发文档和Demo；2. 在文档站右下角或通过 https://ai.luatos.com/ 向合宙AI助手描述需求（如“Air780EPM硬件手册”），AI会直接返回对应资料链接。选型问题可参考合宙产品选型指南 https://docs.openluat.com/SelectionGuide/SelectionGuide/
3. Air530定位模块收不到定位，放窗户边也不行，如何解决？
解答： 该现象说明GNSS还未完成首次定位（冷启动），室内、窗边、电脑键盘旁都会遮挡/干扰卫星信号，电脑本身也是强干扰源。排查步骤：1. 将模块和天线移到室外空旷环境（天线朝天无遮挡），冷启动首次定位通常需30秒至数分钟，期间保持上电不要频繁断电；2. 确认GNSS天线类型与供电正确——有源天线需保证供电脚供电，无源天线无需供电，IPEX/焊盘点连接可靠；3. 确认串口接线（TX/RX交叉、波特率一致）并用串口工具查看NMEA语句，若有$GP/$GN语句输出但长时间无有效经纬度，说明仍在搜星；若完全无NMEA输出，需检查串口配置与模块供电；4. 用合宙官方开发板烧录相同固件做对比测试，可快速区分是硬件还是配置问题。GNSS基础与AGPS辅助定位原理见 https://docs.openluat.com/luatos_lesson/010_luatos_GNSS1/
4. Air530的使用测试文档在哪？
解答： Air530为早期GNSS定位模组，当前主推的定位配件为Air510W/Air530W，选型指南见 https://docs.openluat.com/SelectionGuide/SelectionGuide/ （2.8节“需要扩展定位功能”）。Air530这类GNSS模组上电后通过串口输出标准NMEA 0183语句（$GGA/$RMC/$GSV等），测试方法通用：接好GNSS天线和串口，室外上电后用串口工具查看NMEA输出并解析经纬度。LuatOS侧GNSS用法可参考GNSS教程 https://docs.openluat.com/luatos_lesson/010_luatos_GNSS1/ ，代码示例见 https://gitee.com/openLuat/LuatOS/tree/master/module 下对应模组demo目录。老型号资料建议直接在文档站右下角咨询合宙AI助手获取对应链接。
5. 8201G蓝牙模块能从从模式改成主模式吗？
解答： 不能。8201G内置的蓝牙芯片为Air5101S（BLE 5.2透传模组），与外挂Air5101S一样仅支持从模式（peripheral，可被手机/主机扫描连接），无法切换为主模式（central）去主动扫描、连接其他蓝牙设备；Air5101主模式型号Air5101M目前尚未发布。替代方案：1. 蓝牙主端（扫描/连接）由手机App或其他支持BLE主机的设备承担；2. 若需要模组侧做蓝牙主机扫描连接，可选用内置BLE且支持中心设备模式（central）的主控，如Air8000系列，其LuatOS ble库支持中心设备模式开发（https://docs.openluat.com/osapi/core/ble/ ）。Air5101产品说明见 https://docs.openluat.com/air5101/product/
6. Air5101还没发布，主模式固件能刷入8201G蓝牙模块吗？
解答： 不能，也不建议尝试。Air5101主模式型号Air5101M目前未发布，没有可获取的主模式固件；且8201G内置的Air5101S芯片出厂即为从模式固件，产品资料中未提供对外刷写/切换固件的入口，强刷不支持的固件会导致蓝牙功能失效甚至无法恢复。确需蓝牙主机（主动扫描/连接）能力，请直接选用支持BLE中心设备模式（central）的主控方案（如Air8000系列，LuatOS ble库已提供central模式接口，见 https://docs.openluat.com/osapi/core/ble/ ），或由手机App承担主端。Air5101系列状态以官方文档 https://docs.openluat.com/air5101/product/ 为准。
7. air780EHV使用的是ec718p方案吗？
解答： Air780EHV属于合宙Air780Exx系列4G Cat.1模组，该系列与Air8000系列同属移芯平台（EC718/EC618/716等），固件为binpkg格式。具体到EHV所用的芯片子型号（如EC718P），以Luatools烧录时的实际识别信息为准：烧录日志会打印检测到的固件/芯片型号（例如8201G烧录时提示“发现ec718hm固件”）。Air780EHV是面向国内全网通、内置Audio Codec、支持TTS/VoLTE语音的型号，仅支持LuatOS二次开发（AT指令请选Air780EHT）。平台说明见FOTA教程 https://docs.openluat.com/luatos_lesson/009_luatos_fota/ ，产品介绍见 https://docs.openluat.com/air780ehv/product/
8. Air8000A核心板除了通过typec供电，有提供针脚单独供电么？
解答： 有。Air8000系列核心板上引出了VBAT和GND排针，可直接用外部电源接到这两个针脚给核心板供电；低功耗测试（如PSM+模式）官方即推荐使用外部供电，并将USB母座旁的拨码开关拨到OFF断开USB供电。排针具体位置核心板丝印未全部标注，需对照《Air8000系列模组核心板使用说明》PDF确认针脚位置。硬件接线说明见低功耗文档 https://docs.openluat.com/air8000/luatos/app/lowpower/sleep/
9. 定制固件权限怎么开？需要IPv6固件，官网下载的不支持。
解答： IPv6不需要定制固件，现有官方固件已支持，正确开启即可。LuatOS二次开发：在main.lua初始化阶段、LTE联网前调用mobile.ipv6(true)开启（默认关闭，开启后开机联网会慢2~3秒），IPv6地址通过socket.localIP(adapter)的第四个返回值获取，接口说明见 https://docs.openluat.com/osapi/core/mobile/ 。使用iRTU免开发固件：在iRTU配置后台“基础参数”中直接开启IPv6选项，提交后设备重启生效，配置说明见 https://docs.openluat.com/value/irtu/docs/basic/ 。请确认使用的是V2013及以上较新版本固件。
10. 刚买的板子供电后没反应，是什么原因？
解答： 新板上电无反应一般是供电或启动方式问题，按以下步骤排查：1. 供电检查：用支持数据传输的USB线（部分线仅充电）接到可靠的USB口或5V电源，核心板/开发板注意拨码开关位置（如Air8000需背面开关拨到USB ON、正面开关拨到供电）；用万用表确认VBAT/GND有电；2. 观察指示灯和电脑设备管理器：插上后是否出现新的串口/设备，完全无设备识别优先检查线材、接口和驱动（USB驱动说明 https://docs.openluat.com/common/usb_drv/ ）；3. 进入烧录模式：部分板子需按住BOOT键再上电/复位，或短接BOOT焊点后再用Luatools烧录；4. 若为出厂固件问题，直接用Luatools烧录对应型号最新固件验证。完整烧录故障排查见 https://docs.openluat.com/common/howtodown/
11. 原来厂家的设备V4035 Air724UG可以重新烧录吗？
解答： 可以重新烧录。Air724UG基于展锐8910平台，编译产物为PAC后缀固件，可使用展锐upgrade烧录工具烧录，也可使用Luatools烧录（平台说明见 https://docs.openluat.com/luatos_lesson/009_luatos_fota/ ）。注意两点：1. 该设备是第三方厂家产品，模组内可能包含厂家应用层固件，重新烧录会清除原厂家程序和配置，请先确认有合法固件来源并评估设备失去原功能的风险；2. 烧录时若设备无法进入下载模式，需按设备实际硬件处理BOOT/下载引脚，或联系原厂家协助。Luatools工具教程见 https://docs.openluat.com/common/Luatools/
12. irtu_pet_tracker想恢复未激活状态，是不是用网页下发命令？
解答： 恢复未激活/重新配置状态不是通过网页下发命令，而是通过蓝牙连接设备进行本地配置：设备内置的Air5101S蓝牙工作在从模式，手机连接设备蓝牙后，使用测试配置平台 https://iot_test.openluat.com/ 修改配置并提交，设备重启后生效；若烧录后平台仍显示旧程序日期，请重新设置项目参数并选择定位版固件。Air5101S的连接、AT指令/透传用法见产品手册 https://docs.openluat.com/air5101/product/ ，LuatOS侧蓝牙库（exril_5101）例程可在 https://gitee.com/openLuat/LuatOS/tree/master/module 对应模组demo中获取。
13. 调用rndis网卡功能这样写可以吗？
解答： RNDIS需在飞行模式下开启，官方标准流程为：1. 调用mobile.flymode(0, true)进入飞行模式；2. 进入成功后调用mobile.config(mobile.CONF_USB_ETHERNET, 3)启用RNDIS（ECM模式对应参数7，bit0为开关、bit1为NAT模式）；3. 开启完成后mobile.flymode(0, false)退出飞行模式，此时PC通过USB即可识别为网卡上网。示例代码（官方rndis_ecm demo）：
sys.taskInit(function()
local fly_sign = mobile.flymode(0, true)
-- 注意：V2026以下固件flymode返回值取反，判断需改为 if fly_sign then
if not fly_sign then
log.info("RNDIS启动结果：", mobile.config(mobile.CONF_USB_ETHERNET, 3))
mobile.flymode(0, false)
end
end)
mobile.config返回值恒为false（判断有无bug），V2026以下飞行模式返回值相反，建议升级到较新固件验证。完整demo见 module/Air780EPM/demo/rndis_ecm/（Air8000、Air780EHM/EHV/EGH同目录均有），代码仓库 https://gitee.com/openLuat/LuatOS
14. 合宙4G cat.1有支持摄像头实时视频传输加上sip语音通话的模块吗？air780ehv可以吗？
解答： 需区分“语音通话”和“视频通话”：1. SIP语音通话——Air780EHV支持，它内置Audio Codec、支持TTS/VoLTE，LuatOS提供exsip（SIP通话）扩展库，可经SIP服务器拨打VoIP语音电话，用法见 https://docs.openluat.com/air780ehv/luatos/app/multimedia/sip/ ；2. 摄像头实时视频——Air780EHV仅支持SPI接口30万像素摄像头拍照（官方AirCAMERA_1040/1050配件，仅拍照，不支持短视频/实时视频通话）。Cat.1上行速率有限（理论5Mbps），目前合宙Cat.1模组没有“实时双向视频通话”方案，仅能实现拍照或视频推流（RTMP）。若必须实时视频，建议选高性能多媒体平台（Air8101/Air8000系列，USB摄像头最高200W拍照、100W录像、支持RTMP推流），语音仍可叠加SIP。摄像头配件见 https://docs.openluat.com/air780ehv/luatos/app/accessory/AirCAMERA_1050/
15. Luatools报错提示需要减少代码，但程序和之前一样，只改了几个变量默认值，为什么？
解答： 这是脚本区空间超限提示，多由调试信息占空间引起。Luatools下载选项中的“脚本调试信息”会在脚本中插入调试符号，显著增大脚本体积，即使只改几个变量，勾选后也可能超出固件脚本区上限。解决方法：下载时取消勾选“脚本调试信息”（量产/普通运行无需调试信息），重新下载即可；若仍超限，可精简脚本中未使用的库和资源，或在Luatools中选择脚本区更大的固件版本号（如19/119号固件脚本区为1M字节）。Luatools使用说明见 https://docs.openluat.com/common/Luatools/
16. air780eg的DTU固件用哪个？
解答： Air780EG没有配套的iRTU（免开发DTU）固件。当前iRTU免开发配置平台支持的型号为Air780EHM、Air780EPM、Air780EGG、Air780EGH、Air780EGP、Air780EHV、Air700ECP、Air700ECH及Air8000系列等（支持列表见 https://docs.openluat.com/value/irtu/web/ ），其中定位类请选用Air780EGG/EGH/EGP。建议两种途径：1. 直接在合宙官方店 https://luat.taobao.com/ 选购预烧iRTU固件的成品模组/开发板，到手即用，避免非官方渠道货不对板；2. 如坚持用Air780EG，可自行用LuatOS二次开发实现透传（参考socket库例程），或直接用AT指令做透传。iRTU固件下载见 https://docs.openluat.com/value/irtu/firmware/
17. 有没有带接插件的模块板？
解答： 有，推荐合宙Air878X系列工业模组（成品板、免开发），已板载供电、看门狗、SIM卡座、电平转换、TVS防护等外围电路，并带有2.54mm双排插针接插件，无需自行贴片即可量产使用。例如：Air8782P（基于Air780EPM，带RS485/RS232/UART接口，2.54mm双排插针左右各10Pin，支持5-12V宽压）；Air8780/8781系列按P/H/V/G等后缀区分4G天线方式、供电、充电、音频等版本。选型与各版本差异见选型指南 https://docs.openluat.com/SelectionGuide/SelectionGuide/ ，可在 https://luat.taobao.com/ 购买。
18. Air780EGP用iRTU配置，有经纬度坐标，能在iot.luatos.com中用地图显示出来吗？
解答： 设备上报的经纬度数据可以在平台中正常查看到，说明GNSS定位和数据上报链路正常。地图页面未能渲染位置属于平台地图展示问题，不影响定位数据本身，后续版本修复后即可正常显示。查看GNSS定位还可以使用合宙专用GPS定位展示工具 https://iot.openluat.com/iot/device-gnss ；若经纬度在地图上整体偏移，属于坐标系差异（WGS84/GCJ02），可用GPS定位纠偏工具 https://docs.openluat.com/common/tools/gps/ 校验。
19. DTU订单怎么下？
解答： iRTU配置服务自2026年7月7日起永久免费，无需下单付费即可获取配置。平台地址：新平台 iRTU 配置中心 https://irtu.openluat.com/ （也可从 https://iot.openluat.com/irtu/project-list 进入），老平台DTU配置中心 https://dtu.openluat.com/ 。历史过渡说明：2026年7月7日至7月31日期间可在 https://iot.openluat.com/ 平台的订单管理中以0元下单完成配置获取，过渡期结束后直接免费配置即可。新平台支持Air780EHM/EPM/EGG/EGH/EGP/EHV、Air700ECP/ECH、Air8000系列等型号。
20. Air8000板子烧录后不显示3个串口，看不了日志，是什么问题？
解答： 该现象在核心板焊接场景下多为底部焊盘连锡/虚焊导致USB枚举异常，模组未能枚举出全部3个虚拟串口。处理与排查：1. 检查核心板底部焊盘是否有连锡、虚焊，重新补焊/拖焊后再上电识别；2. 确认使用的是数据线而非纯充电线，更换USB口和线材测试；3. 确认已安装合宙USB驱动（https://docs.openluat.com/common/usb_drv/ ），可打开电脑设备管理器查看实际枚举出的串口数量；4. 若设备能进入烧录模式，可用Luatools重新烧录对应Air8000固件排除固件因素。焊接工艺注意事项可参考合宙模组SMT炉温曲线说明 https://docs.openluat.com/common/smt/
21. airlbs充值和dtu分组是什么关系？
解答： 两者没有关系，属于相互独立的服务与功能：airlbs是合宙收费版基站/WiFi定位服务，充值是为定位次数/配额付费，按设备调用定位服务计费（见 https://docs.openluat.com/osapi/ext/airlbs/ ）；DTU/iRTU的“分组”只是配置后台对设备进行分类管理、批量下发配置的组织方式，不涉及定位服务的计费或开通。是否充值airlbs不影响DTU分组配置，反之亦然。
22. DTU平台上切换分组后配置不生效，是什么原因？
解答： 分组切换只是管理归属变化，新分组中的配置需要下发到设备并重启后才会生效。排查要点：1. 确认设备当前在线且已联网（配置通过网络下发，离线设备需等上线后才会拉取）；2. 切换分组后在平台执行“保存/提交配置”，必要时手动触发设备重启，让设备重新拉取新分组配置；3. 确认设备的IMEI/识别码归属到了目标分组，避免分组里选错设备或配置了错误型号的参数；4. 配置提交后观察设备串口/平台日志是否有配置更新记录。新平台地址 https://irtu.openluat.com/ ，配置逻辑说明见iRTU概述文档 https://docs.openluat.com/value/irtu/state/ 。若仍不生效，请在合宙企业微信群反馈设备IMEI和分组信息处理。
23. DTU充值默认项目选不上，不能充值，什么情况？
解答： 这是正常现象——iRTU配置服务自2026年7月7日起已永久免费，无需再充值下单，因此“默认项目/充值”选项不可选或无法提交。请直接使用免费配置：新平台 iRTU 配置中心 https://irtu.openluat.com/ （或 https://iot.openluat.com/irtu/project-list ），创建项目、绑定设备后即可配置参数并下发。需要付费的仅为airlbs收费版基站/WiFi定位等增值服务，与DTU配置费无关（见 https://docs.openluat.com/osapi/ext/airlbs/ ）。若页面功能异常，可清理浏览器缓存、更换浏览器或在合宙企业微信群反馈。
24. 780EG模组停产，推荐的EG2买来直接替换没有获取到定位，手册也找不到，怎么回事？
解答： Air780EG2/Air780EGT可以兼容替代Air780EG，但有两点必须注意：1. 开发方式——Air780EG同时支持AT和LuatOS，而EG2/EGT是AT指令型号（Flash/RAM：EG2为4MB+4MB支持128K以内文件下载，EGT为8MB+8MB支持1M以内），若原设备跑LuatOS脚本，请改用LuatOS型号Air780EGP/EGG/EGH；2. 有源GNSS天线供电脚不同——Air780EG的GNSS_VDD在PIN8，而EG2/EGT改到了PIN98，直接沿用原PCB会导致有源天线不上电、收不到定位，需按新管脚改板/改接线（无源天线不受此影响）。管脚差异表与说明见官方对比文档 https://docs.openluat.com/atmozu/product/air780eg2egtvsair780eg/ （含管脚对比Excel）。改好后在室外空旷处上电冷启动测试即可。
25. 8201H烧录GLS固件后没有NMEA打印，双清也不行，是什么原因？
解答： 8201H出厂为工厂产测软件，开机后会自动进入低功耗并断开USB，若烧录方式不对或固件类型选错，就会出现无NMEA输出、串口看不到信息的现象。按以下步骤处理：1. 烧录时BOOT脚要拉高（不是接地），使模块正常进入下载/启动流程；2. 固件选型：8201H的CORE使用Air780EHM固件，先用GPIO等不进入低功耗的demo烧录，确认模块可正常运行、串口有打印，再烧录定位版（GNSS/GLS）固件；3. 确认烧录的是与硬件匹配的定位固件，并在Luatools中正确选择固件版本（定位版）；4. 有NMEA需在室外开阔环境、接好GNSS天线（注意有源天线供电脚），GNSS串口ID配置正确（参考GNSS配置为串口2）；5. 若为iRTU场景，确认项目参数重新设置并选择定位版后提交、设备重启。相关说明可参考8201软件资料 https://docs.openluat.com/air8201/ ，仍异常请携Luatools烧录日志至合宙企业微信群反馈。