常见问题 - 2026-08-11
数据日期:2026-08-11
1. Air780EHU + Air510W 的硬件设计参考电路图在哪里?
解答: 有官方资料可直接下载。Air780EHN/Air780EHU 的硬件设计资料集中在产品手册页(https://docs.openluat.com/air780ehnehu/product/shouce/ ),包含《Air780EHN&Air780EHU硬件手册V1.2》PDF、硬件设计指导,以及《Air780EPM&EHM&EHV&EGH&EHU核心板使用说明20260114》PDF、核心板原理图PCB封装压缩包,EHU 与 EPM/EHM/EHV/EGH 核心板通用,可直接作为底板设计参考。Air510W 是单频多系统 GNSS 扩展模组(兼容无源/有源天线,定位精度小于2m),其规格见选型指南(https://docs.openluat.com/SelectionGuide/SelectionGuide/ );Air1601 V1.2 开发板内置 Air510W,可作为 Air780Exx 主控 + Air510W 的完整参考设计。
2. Air8001的蓝牙支持Beacon么?
解答: 支持。LuatOS 的 ble 库提供四种工作模式:外围设备(peripheral,可被扫描和连接)、中心设备(central,扫描并连接)、广播者(ibeacon,周期广播 beacon 数据、可被扫描但一般不连接)、观察者(scan,只扫描不连接),Beacon 场景即使用广播者模式。代码要点:bluetooth_device = bluetooth.init() 初始化蓝牙底层 → local ble_device = bluetooth_device:ble(ble_callback) 创建 BLE 对象 → 按 iBeacon 厂商数据格式填充 UUID、Major、Minor → ble_device:adv_start() 启动广播。说明与示例见 ble 库文档 https://docs.openluat.com/osapi/core/ble/ 及 LuatOS 蓝牙课程 https://docs.openluat.com/luatos_lesson/007_luatos_ble2/ 。注意:合宙不同型号蓝牙能力有差异,量产前请以所用具体型号固件实际验证为准。
3. Air780EGG支持长效星历吗?
解答: Air780EGG/EGP/EGH 均支持 exgnss 扩展库,可通过 exgnss.setup({agps_enable = true}) 开启 AGPS 星历辅助,显著缩短冷启动首次定位时间;星历数据有时效(北斗约1小时、GPS约4小时),过期后自动重新获取。此外 setup 还支持 hz(定位频率1/2/4/5Hz,默认1Hz)和 static(静态漂移抑制阈值1~100cm/s)等参数。需要说明:合宙库提供的是 AGPS 辅助星历,并非长达数日的"长效星历";若项目对长周期星历有强需求,需以 GNSS 芯片自身能力为准评估。接口说明见 https://docs.openluat.com/osapi/ext/exgnss/ 。
4. Air780EGG支持GNSS双频定位吗?
解答: 不支持。Air780EGG 及同系列 Air780EGP/EGH 内置 GNSS 为单频多系统方案(支持 BDS/GPS/Galileo/GLONASS/QZSS),合宙目前没有双频 GNSS 型号。若项目必须双频,可外挂第三方双频 GNSS 模组,通过 UART 输出 NMEA 数据接入主控,按通信协议自行开发解析即可(参考 exgnss 库的外挂 GNSS 用法:https://docs.openluat.com/osapi/ext/exgnss/ )。
5. 有没有哪款是支持双频GNSS定位的?
解答: 合宙现有 GNSS 模组(如 Air510W/Air530W 及 Air780Exx 内置 GNSS)均为单频多系统方案,暂无双频型号;需要双频定位只能外挂第三方双频 GNSS 芯片/模组,通过 UART(NMEA 协议)与主控通信。选型前建议先对照选型指南确认现有型号精度是否满足需求(Air510W 单频多系统定位精度小于2m):https://docs.openluat.com/SelectionGuide/SelectionGuide/ 。
6. 使用AIR780E外置电路跟PCBA一样就可以自己设计PCB吗?
解答: 可以,但必须以官方开放的参考设计为准。合宙在官网开放了各型号核心板/开发板的硬件手册、硬件设计指导、原理图与 PCB 封装(以 Air780EPM 为例见 https://docs.openluat.com/air780epm/product/ 及硬件设计章节),电源去耦、SIM 卡、天线匹配、VBAT 大电容(如 220uF 电解 + 22uF 钽电容)等关键电路需严格参照。自行画板时建议提交官方做原理图/PCB 评审,并在打样前确认管脚复用与电平(IO 默认 3.3V)。
7. GSENSOR辅助抑制GPS漂移的功能是否要重新校准适配参数?
解答: 一般不需要重新校准,参数通过 exgnss 库配置即可。Air780EGG/EGP 内置 G-sensor,exgnss 提供 static 参数做静态漂移抑制:设置速度阈值(1~100cm/s),当 G-sensor 判断设备处于静止状态时,软件会抑制 GNSS 静止时的坐标漂移。默认参数已适配大多数场景;只有在特定安装姿态、振动环境或对静止判定灵敏度有要求时,才需要调整阈值。GNSS 硬件接入说明见 https://docs.openluat.com/air780epm/luatos/hardware/gnss/ ,接口见 https://docs.openluat.com/osapi/ext/exgnss/ 。
8. RNSS的基站定位和星历获取服务是合宙直接提供的吗?
解答: 是。基站定位(LBS,免费版 lbsLoc2.request 单基站、收费版 airlbs.request 多基站+WiFi)和 AGPS 星历服务均由合宙 IoT 平台(iot.openluat.com)直接提供。使用前提是设备已归属到自己账号的项目下,并使用项目 productKey;LBS 配置文档见 https://docs.openluat.com/value/basestation/doc/ ,设备归属见 https://docs.openluat.com/air780epm/product/attributioniot/ 。
9. PSM模式现在基站大部分都支持了吗?
解答: 运营商 PSM(网络侧 PSM)支持仍不普遍,不建议作为依赖。合宙模组文档中的"PSM/PSM+ 模式"指模组自身的深度休眠机制:由软件控制进入极低功耗状态,可通过定时器(如 pm.dtimerStart)、WAKEUP 脚/AGPIOWU 中断等自动唤醒,与运营商网络是否支持 PSM 无关,任何网络环境下都可使用。低功耗/GPIO 行为说明见 https://docs.openluat.com/atmozu/product/command/lowpower/ 。
10. PSM和普通模式在使用上有什么区别?
解答: 区别在于连接保持与功耗:常规(普通)模式下模组全程驻网,可与服务器保持长连接(如 MQTT 实时收发),功耗最高;低功耗模式下模组间歇休眠、可维持长连接保活;PSM/PSM+ 模式下模组进入深度休眠,协议栈连接断开、服务器无法主动下发,类似关机状态,唤醒后需要重新驻网、重建连接,平均功耗可低至微安级(Air780EGG 休眠态 GNSS+Gsensor 合计仅约30uA)。选型与GPIO差异见 https://docs.openluat.com/atmozu/product/command/lowpower/ 。
11. PSM能做保活的这种应用吗?
解答: 不能直接做长连接保活。PSM/PSM+ 是深度休眠状态,期间与服务器的连接断开、服务器无法主动下发,效果类似关机;与真正关机的区别是可由定时器或中断自动唤醒、无需人工开机,唤醒后重新驻网并重建连接。若业务需要"保活"(服务器能随时找到设备),应选用低功耗模式配合 MQTT 长连接 + 定时唤醒,而非 PSM;可接受"定时上报、唤醒后收数据"的电池类设备才适合 PSM。低功耗模式说明见 https://docs.openluat.com/atmozu/product/command/lowpower/ 。
12. 待机功耗是包含发送500字节的功耗平均在整个待机周期里的功耗吗?
解答: 包含。手册/文档给出的待机平均电流,是在规定测试条件下(供电电压、插卡、典型上报周期等)对完整工作周期取平均的结果,周期内的驻网、数据收发(如一次数百字节上报)、休眠各阶段电流都计入平均。对比数据时务必确认测试条件一致;建议用 Air9000/Air9000P 功耗分析仪配合上位机(https://hezhouyibiao.com/ )实测自己的业务波形,Air780EGG 低功耗实测可参考 https://docs.openluat.com/air780egh/luatos/app/lowpower/sleep/ 。
13. 合宙设备自带的流量卡不插别的设备就不锁吧?换别的流量卡有限制吗?
解答: 锁卡与否取决于卡商(运营商/物联卡代理商)的机卡绑定策略,与模组无关。合宙随开发板附带的物联卡用于开发测试:卡在未通电激活前可放入任意设备;一旦在某台设备通电激活,卡商默认做机卡绑定(IMEI 绑定),再换到其他设备可能被停机/锁卡,需联系卡商解绑。反过来,模组本身不挑卡,换用自行采购的正规物联卡(Cat.1 全网通、与设备制式匹配)没有限制,量产建议自行采购商用流量卡并向卡商确认是否有机卡绑定、锁卡规则。
14. Air8000的蓝牙和WiFi天线是共用的吗?这个小板子能验证蓝牙功能吗?
解答: Air8000 系列中仅 Air8000A/Air8000AB/Air8000U/Air8000N/Air8000W 五款内置 WiFi/BLE 芯片(4G 主控与 WiFi/BLE 芯片经 SPI/AirLink 通信),WiFi 与 BLE 是同一芯片的伴生功能,射频前端共用同一副 2.4G 天线;Air8000D/DB/T 等型号无 WiFi/BLE。因此:带 WiFi/BLE 的核心板/开发板可以直接验证蓝牙功能,BLE 应用指导见 https://docs.openluat.com/air8000/luatos/app/BLE/ ;天线与 TVS 选型见硬件章节 https://docs.openluat.com/air8000/luatos/hardware/wifi&ble/ 。自行画板时天线走线与匹配需按硬件设计指导执行。
15. Air780EHV的音频输出口是哪个管脚?USB的VBUS管脚耐压5V吗?
解答: 音频方面:Air780EHV 内置 ES8311 音频 Codec 并外接功放(PA),喇叭输出不是直连模组 GPIO,而是走合宙标准音频配件 AirAUDIO_1000,喇叭接配件板的 SPK+/SPK- 引脚,管脚定义以 Air780EHV 产品页/硬件手册为准(https://docs.openluat.com/air780ehv/product/ )。VBUS 方面:Air780EHV 的 VBUS 为 PIN61,仅用于 USB 插入检测(内部可悬空处理),其耐压与使用方式以硬件手册标注为准;设计时建议按硬件设计指导串接电阻后接入,避免直接承受异常电压。
16. air8201g的1.06版本固件什么时候出?
解答: 固件发布时间以官方固件页更新为准,没有可预先承诺的时间表。Air8201G 基于 Air780EGH 主控设计,其固件可在合宙文档站对应产品页(https://docs.openluat.com/air8201/ )及 Air780EGH 固件页下载和查看更新记录;若现有版本存在阻塞问题,建议先使用当前最新正式固件验证,并通过官方企业微信群或销售渠道反馈所需修复点,新版本发布后固件页会第一时间更新。
17. 为什么信号强度没有显示?是不是没连上网呢?
解答: 信号格不显示不等于没联网,但需按顺序排查。LuatOS 侧可用 mobile.csq() 读取信号质量:返回值 0~31 为有效值(<10 差、10~25 中等、>25 良好),返回 99 表示无信号(多为 SIM 卡未识别/未驻网);4G 网络下建议以 mobile.rsrp()/mobile.rsrq() 为准。排查步骤:①确认 SIM 卡已插好、未欠费、已激活且无机卡绑定限制;②确认天线已接好、驻网指示灯状态;③AT 固件可用 AT+CSQ、AT+CEREG? 查注册状态;④信号格 UI 依赖应用主动读取并刷新,检查脚本是否正确调用接口。接口说明见 https://docs.openluat.com/osapi/core/mobile/ 。
18. 墨水屏使用panel:refresh(epd.PARTIAL_RECT)报错refresh or sleep mode is not supported by this panel怎么解决?
解答: 报错原因是该墨水屏面板不支持所选刷新模式。epd 库的 FAST、PARTIAL、PARTIAL_RECT 快速/局部刷新均需要屏幕硬件(控制器 IC)支持,使用前应通过面板 info().caps 能力位确认;PARTIAL_RECT 还支持 x/y/w/h 区域参数,且局部刷新为异步操作,需要调用 :wait() 等待完成。处理建议:①改用 epd.FULL 全刷(所有屏幕支持,闪烁但无残影);②查询所购屏幕型号的驱动 IC 是否支持局刷,若支持则按 demo 的初始化/刷新序列调用;③从深睡唤醒后需重新 panel:init() 再刷新。库说明见 https://docs.openluat.com/osapi/core/epd/ 。
19. 需要tiny_epd墨水屏显示中文和codec录音,是不是只能用15号固件了?
解答: 不是只能选15号固件,核心是固件内要同时包含所需功能库。墨水屏中文显示依赖 hzfont 中文字体支持(Air8000 自 V2034 版固件起 eink/u8g2 支持 hzfont 字体),录音依赖 audio/codec 相关库;合宙因 Flash 空间有限,用不同编号固件装载不同核心库组合(如15/115号含 AIRTALK+CAMERA,16/116号含 CAMERA+VOLTE+TTS)。请到对应型号固件页查看各编号固件的功能清单,选择同时包含 eink/epd、hzfont 与 audio 的编号;固件功能说明见 https://docs.openluat.com/air8000/luatos/firmware/ 。
20. 15号固件有启用HZFont吗?
解答: HZFont(中文字体)支持取决于固件是否编入字体库,而不是编号数字本身。自 V2034 版本起 eink、u8g2 已支持 hzfont 字体,同一版本内各编号固件的基础能力一致,差别在于装载的功能库组合(15号与1号固件在字体支持上相同)。请以所用型号固件页的版本更新记录与固件功能清单为准:https://docs.openluat.com/air8000/luatos/firmware/ 。
21. 从full->partial/fast模式切换时是否应该重新发送fast_init命令?
解答: 是否需要重新初始化取决于屏幕驱动 IC 的状态机要求,按 epd 库 demo 的调用序列执行即可,不要自行拼接底层命令。通用原则:FULL 全刷后控制器回到完整刷新状态,切到 FAST/PARTIAL 局刷前通常需要重新执行对应模式的初始化序列;库内部在调用相应刷新接口时会处理。务必先用面板 info().caps 确认该屏支持 FAST/PARTIAL,且异步刷新后调用 :wait();若切换后显示异常(残影/不刷新),最稳妥的做法是重新 panel:init() 后再进入局刷。具体以 epd 库文档与 demo 为准:https://docs.openluat.com/osapi/core/epd/ 。
22. Air780E启动4G蜂窝网络的方式有更新吗?运行旧程序一直报错。
解答: 4G 启动/驻网的应用接口没有破坏性变更,旧程序报错应从运行环境排查:①优先检查 SIM 卡——是否欠费、未激活、机卡绑定(换到别的设备后被锁)、卡槽接触;②确认使用的固件版本与脚本所用库匹配,库接口有更新时以最新库 demo 为准(mobile/网络初始化写法可对照官方 demo);③抓取开机日志确认驻网流程(SIM 识别 → 搜网 → CEREG 注册)卡在哪一步;④天线是否接好、信号是否正常(mobile.csq())。先排除卡和天线,再对照最新固件与库 demo 核对代码。
23. 最新的Luatools还能用780E吗?生成量产文件报错。
解答: 可以使用,Air780E 系列仍在 Luatools 支持列表内。生成量产文件报错多为工具版本或本地缓存问题,处理步骤:①将 Luatools 升级到官网最新版本;②清理 Luatools 临时目录(_temp 等缓存)后重启;③确认选择的固件型号与模组一致(型号不匹配会报错);④以管理员权限运行、换 USB 口/USB 线重试。下载与工具说明见 https://docs.openluat.com/common/howtodown/ 。
24. air724的uart1是被AT占用了吗?要释放UART1给Lua只能改固件源码吗?
解答: 不需要改固件源码。Air724UG(LuatOS-Air 平台)UART1 与底层 AT 任务存在资源抢占,历史上表现为 setup 阻塞或接收丢数据。V4017 版本起 uart.setup 新增任务优先级参数,可提升串口接收任务优先级,缓解 UART1 被底层 AT 抢占导致的卡死问题。建议升级到 V4017 及以上固件,并按新版 uart 库说明配置优先级参数;若对串口稳定性要求高,优先选用 UART2/UART3 等未被复用的串口。
25. Air724UG的1.0.4版本烧录后为什么无法OTA升级到新版本?
解答: Air724UG 属 LuatOS-Air(2G/4G 老平台),远程升级需满足 FOTA 前提:①固件分区表一致——差分包只能在同类固件之间升级(固件1只能差分升固件1,跨分区/跨大版本可能不支持差分到新版);②升级包与当前固件的底层版本匹配,过旧的 1.0.4 版本可能不在差分升级链上,需要先升级到中间过渡版本或用 Luatools 有线刷到最新正式版(如 V1008)后再走 FOTA;③检查 FOTA 分区空间、升级 URL 是否可访问、设备是否已归属到 iot 账号项目。建议先用 Luatools 有线升级到最新正式固件(https://gitee.com/openLuat/LuatOS/releases/tag/v1008.rda8910.release ),后续 FOTA 即可正常。
26. 远程升级的固件有问题,一直停留在前一个版本,有什么办法跳过有问题的版本吗?
解答: 合宙 IoT 平台(iot.openluat.com)的 FOTA 是按"设备当前版本 → 目标版本"下发差分包/全量包,设备不会强制逐级升级,因此可以通过后台配置跳过问题版本:①登录平台找到对应项目/设备,将问题版本的升级任务停用或删除;②重新上传一个可用的新版本固件,新建升级任务并把目标版本直接指向该可用版本(可配置从问题版本和更早版本都升级到新版本);③确认设备已归属到本账号项目、升级 URL 浏览器可访问(返回文件而非错误页)。FOTA 流程与回调(fota.init/wait/run/isDone/finish)见 https://docs.openluat.com/air780epm/luatos/app/ota/fota/ 。
27. Air780EPM/EHM/Air8000支持ECM吗?780ER2支持ECM吗?
解答: 均支持 USB 网卡方式联网。Air780EPM/EHM、Air8000 支持 USB RNDIS/ECM 网卡;Air780ER2 在新版固件中也已支持 USB RNDIS/ECM 网卡切换——V2050 版固件(2026-08-25 发布)新增了 USB RNDIS/ECM 网卡切换功能,升级到该版本及以上即可使用 ECM。固件更新记录见 Air780ER2 固件页 https://docs.openluat.com/air780er2/product/ 。
28. Air510U板子的详细资料在哪里?可以用USB和ARM Linux通信吗?
解答: Air510U 的产品资料(手册等)在官方产品页:https://docs.openluat.com/air510u/product/ 。通信接口以该产品手册标注为准:若板子引出 USB 口且手册声明支持 USB 虚拟串口/CDC 通信,即可与 ARM Linux 通过 USB 连接(Linux 下会枚举为 /dev/ttyUSB 或 ttyACM,按标准串口读取 NMEA/数据即可);若仅引出 UART,则用 UART-TTL 接 ARM 串口。下载手册确认引脚定义后再接线。
29. 锂电池供电需要升降压电路么?
解答: 普通单节锂电池可直接接 VBAT,不需要升降压。以 Air8000 为例,VBAT(PIN7/8)供电范围为 3.3~4.35V,需保证 1A 以上供电能力并就近放置 220uF 电解 + 22uF 钽电容;单节锂电池充满约4.2V、放电截止约3.3V,正好落在工作区间内。注意:电池电量放空到截止电压以下时模组会断电,低电量告警/关机阈值需在软件中处理。供电设计见 https://docs.openluat.com/air8000/luatos/hardware/vbat/ 。
30. Air8000开发板能验证蓝牙功能吗?没看到蓝牙天线。
解答: 可以验证。Air8000 系列中 Air8000A/AB/U/N/W 五款内置 WiFi/BLE 芯片,WiFi 与 BLE 为伴生关系、共用同一副 2.4G 天线(板上即 WiFi/BLE 天线,不是单独的"蓝牙天线");官方核心板/开发板已集成该天线,可直接跑 BLE demo 验证(从机广播、连接等),BLE 示例见 https://docs.openluat.com/air8000/luatos/app/BLE/ 。若手头是 Air8000D/DB 等不带 WiFi/BLE 的型号,则无法验证蓝牙,选型时注意区分型号。
31. Air780EX2实际上传速度可以达到多少?
解答: Air780EX2(Cat.1 bis)理论速率为上行 5Mbps、下行 10Mbps。实际上传速率受运营商网络、信号质量(rsrp/rsrq)、服务器带宽、TCP/TLS 开销影响,通常远低于理论值;良好信号下实测上行一般在数百 kbps ~ 数 Mbps 量级。建议在实网环境用 socket/http 上传大文件实测,并以 mobile.rsrp()、mobile.rsrq() 确认信号。型号规格见 https://docs.openluat.com/air780ex2/product/ 。
32. 需要一款低功耗3.6V锂电池的RTU和12VDC实时在线RTU,可自由配置下位机仪表协议及服务器上传协议,有推荐吗?
解答: 建议按供电与功耗要求分两类选型,以官方选型指南(https://docs.openluat.com/SelectionGuide/SelectionGuide/ )为准:①电池供电、低功耗 RTU:优先超低功耗定位/采集系列,如 Air8201(4G+GNSS+BLE,内置充电管理、UART/I2C/485 接口,支持 LuatOS 二开)或 Air780EPM/Air780EGH 核心板自建,VBAT 支持 3.3~4.35V 锂电池直供;②12VDC 实时在线 RTU:可选用 Air8780/Air8781P 等工业模组(支持 5~12V 宽压输入,集成看门狗、SIM 卡座、天线座)或 Air8000(4G/WiFi/以太网多网融合,适合协议网关)。仪表协议(Modbus 等)与上报协议(MQTT/HTTP)均可用 LuatOS 自由开发;确定功能清单(接口路数、是否定位、上报频率)后对照选型指南选型。
33. air8201g BLMQ调试板加芯片连接电脑后,设备管理器中短暂出现COM口然后就没了,也没有log打印,是什么原因?
解答: 多数是供电或连接不稳导致模组启动后掉电/复位。排查步骤:①更换 USB 口(优先主板直连 USB2.0/3.0 口,避免劣质 HUB)和带数据脚的优质 USB 线;②确认供电能力——模组发射瞬时电流较大,若仅靠 USB 取电或 LDO 电流不足会在驻网瞬间掉电,改用外接稳压电源供电并加足 VBAT 电容;③重新装驱动、换一台电脑验证;④按住 BOOT 键再上电强制进入下载模式,看 Luatools 能否稳定识别。烧录识别问题通用处理见 https://docs.openluat.com/common/howtodown/ 。
34. 4G模块AIR780EHM U5引脚(P35)对地短路是什么问题?
解答: 不是故障。第35脚是射频天线脚,天线管脚内部通过匹配电路/ESD 器件到地,用万用表量"对地导通/短路"是正常现象,生产测试时不应把该脚对地阻抗作为不良判据;判断天线通路好坏应看射频性能(驻波、传导/辐射测试)。该说明在硬件手册/硬件设计指导中有明确描述,天线设计见 https://docs.openluat.com/air780epm/luatos/hardware/ 相关章节。
35. Air780EGP GNSS定位天线能不能用贴片天线?有没有选型推荐?
解答: 可以用贴片(陶瓷)天线,但要按使用环境选。GNSS 天线选型原则:①陶瓷贴片天线增益适中、成本低,适合天线面朝上、上方无金属遮挡的设备,安装时陶瓷面必须朝向天空并远离金属件;②空间受限或无法朝上安装可选 FPC 天线;③车载/穿戴等遮挡严重、工况差的场景建议选有源天线(含 LNA),Air780EGP 的 PIN98(GNSS_VDD,3.3V)可为有源天线供电,注意官方开发板 LDO 仅支持 3.3V 有源天线;④外置棒状天线性能最好。GNSS 天线硬件说明见 https://docs.openluat.com/air780epm/luatos/hardware/gnss/ 。
36. Air780EHT AT+HTTPDATA指令发送HTTPS数据,发送64K数据服务器超时,是怎么回事?
解答: Air780EP 系列 AT 固件的 HTTP 缓存约 4KB,一次性用 AT+HTTPDATA 灌入 64K 会远超缓存、长时间占用连接导致服务器超时。正确做法是分段发送:使用 AT+HTTPEXACTION 分段 POST(每片控制在缓存大小量级,如 2~4KB),或用分片/断点续传方式由服务器端拼装。HTTPS 还要计入 TLS 握手与加密开销,单片越小越稳但耗时越长,需在超时时间内完成。AT HTTP 指令说明见 https://docs.openluat.com/atmozu/product/command/http/ 。
37. 如果发送7K数据服务器能正常接收,现在有800K左右数据需要发送,协议是HTTPS,如何排查问题?
解答: 7K 能过、800K 失败,说明链路正常、问题在大数据量传输方式。排查与处理:①不要一次性发送——AT 固件 HTTP 缓存仅约 4KB,必须用 AT+HTTPEXACTION 分段 POST(建议每片 2~8KB 试验,8KB 以上易超时则继续减小),服务器端按序号拼装;②调大服务器端接收/响应超时,每片收到后及时回 200;③确认模块内存与固件版本,升级到最新正式固件;④LuatOS 开发可直接用 socket/http 库流式发送,比 AT 指令更适合大文件;⑤弱网下加失败重传与断点续传。指令参考 https://docs.openluat.com/atmozu/product/command/http/ 。
38. Air780E通过AT指令发送HTTPS数据时返回+HTTPACTION: 0,606,0是什么问题?
解答: +HTTPACTION 的中间数字是 HTTP 状态/错误码,606 属于连接/响应异常类错误,常见原因:服务器在规定时间内没有返回响应(超时)、TLS/SSL 握手失败(证书、SNI、TLS 版本不匹配)、服务器主动断开连接。排查:①先用 HTTP(非 HTTPS)测试同一 URL,排除业务层问题;②HTTPS 确认服务器证书有效、端口 443、URL 路径正确,必要时关闭证书校验测试;③减小单次发送数据量(AT 缓存约 4KB,改用 AT+HTTPEXACTION 分段),确认服务器超时设置;④升级最新固件并抓模块日志。AT HTTP 说明见 https://docs.openluat.com/atmozu/product/command/http/ 。
39. Air8000 V2048版本uart11/uart12向外发数据发不出去,是什么问题?
解答: 这是 V2048 版固件的已知问题:UART11/UART12 向外发送数据发不出去,已在官方固件页"已知问题"中明确列出。处理方法:①升级到修复该问题的更新版本固件(固件页历史版本与更新记录见 https://docs.openluat.com/air8000/luatos/firmware/ );②在未升级前,业务串口临时改用其他可用 UART(如 UART1/UART2 等)规避。
40. Air1780P V2048版本低功耗模式(长连接/PSM+)均20s左右重启一次,EPAT日志显示一直在重启。
解答: 固定约20秒周期重启,属于典型的看门狗/低功耗进入失败导致的复位,而非正常休眠唤醒。排查方向:①进休眠前主动关闭 USB(USB 挂接会阻止进入低功耗,常见表现是等待超时后重启,参考 Air780EPM 同类问题处理);②检查是否有外设/任务未释放(串口、网络连接、定时器、GPIO 电平配置),对照官方低功耗 demo 逐项核对休眠前流程;③确认硬件供电与复位脚、WAKEUP 脚电平稳定,排除供电跌落;④升级到最新正式固件(V2048 已知在部分场景存在低功耗异常,新版本有修复),并用 Air9000 功耗分析仪抓波形确认是否真休眠。低功耗示例见 https://docs.openluat.com/air780egh/luatos/app/lowpower/sleep/ 。
41. excloud扩展库只能让4G模组用MQTT通信承载吗?1601、8101这些不支持吗?
解答: 是的,excloud 扩展库目前设计为仅支持 4G 模组通过 MQTT 通信承载(与合宙云平台交互)。Air1601、Air8101 等非 4G 主控(或 WiFi/以太网主控)不在 excloud 的支持范围内,这类设备如需连云请直接使用标准 mqtt/socket 库自行对接。具体支持的模组清单以 excloud 库文档说明为准。
42. Air724UG有出LuatOS版本吗?
解答: 有。Air724UG 运行 LuatOS-Air(老平台)固件,已有正式版本发布,例如 Air795UG/Air722/Air724UG 的 LuatOS_V1008 正式固件已发布,可直接下载使用:https://gitee.com/openLuat/LuatOS/releases/tag/v1008.rda8910.release 。固件历史版本与更新记录在合宙固件页/Gitee releases 中维护。
43. LuatOS创建项目时项目名称输入框能否放大一点?
解答: 项目名称输入框/提示框尺寸属于 Luatools 工具界面优化项,当前版本若显示偏小,可先调整系统显示缩放比例缓解;该优化需求已记录,将在后续工具版本中改进。如遇影响使用的界面问题,建议通过官方渠道(企业微信群/gitee issue)反馈并附截图与 Luatools 版本号,便于定位。
44. luatools烧录时提示合并失败然后卡死,重新打开后项目列表中的项目都不见了。
解答: 合并失败后项目列表丢失,多为本地工程缓存/配置文件损坏。处理步骤:①升级 Luatools 到官网最新版本;②清理 Luatools 安装/工作目录下的 _temp 临时文件夹后重启工具;③项目列表丢失不影响磁盘上的脚本文件,重新"新建项目"并指向原脚本目录即可恢复,量产文件重新生成;④合并失败时确认固件型号与所选模组一致、工程路径不含中文/特殊字符、磁盘空间充足;⑤仍异常可换电脑验证或重装 Luatools。下载工具说明见 https://docs.openluat.com/common/howtodown/ 。
45. Air8000做DVP方案,焦距多少?1033有微距的吗?
解答: 需先澄清接口:Air8000 仅支持 SPI 接口摄像头(gc032a/gc0310/bf30a2,搭配 AirCAMERA_1040/1050 等 SPI 摄像头配件);DVP 与 USB 摄像头适用于 Air8101/Air1601(DVP 配件 AirCAMERA_1020 仅适用 Air8101),Air8000 上做 DVP 方案无法直接支持。焦距方面,定焦摄像头有最佳工作距离,常规镜头最佳视距约 70~80cm、2m 内可清晰识别,微距(近距离拍摄)需要定制/更换微距镜头,标准镜头无法满足微距。摄像头接口说明见 excamera 库文档 https://docs.openluat.com/osapi/ext/excamera/ 。
46. 合宙4G模块有没有小智AI那种成品方案?想二开。
解答: 合宙提供可二次开发的语音 AI 硬件方案,但没有与"小智"完全相同的封闭成品。带音频能力的 4G 模组(如 Air780EHV,内置 ES8311 Codec + 功放,配合 AirAUDIO_1000 音频配件)可用于开发对话式语音设备,麦克风/喇叭、TTS、语音通话、网络上传均由 LuatOS 库支持,对话逻辑与大模型对接由应用层自行实现。选型与配件见 https://docs.openluat.com/air780ehv/product/ 。
47. 我想做4G版本的小智AI,有推荐的方案吗?用780就行了吧?
解答: 推荐 Air780EHV。它是带音频 Codec(ES8311)和功放的 4G 模组,配合 AirAUDIO_1000 配件可直接接麦克风和喇叭,适合语音对话类产品;普通 Air780E/EPM 无音频通道,不适合。需要注意:当前 4G Cat.1 模组算力有限,不支持 opus 等高性能语音编解码格式,语音建议使用 AMR 等模组支持的格式,opus 编解码需在服务器侧转换。方案参考 https://docs.openluat.com/air780ehv/product/ 。
48. iot power cc有mac版本的上位机吗?
解答: 没有。Air9000/Air9000P 功耗分析仪的上位机软件仅提供 Windows 版本(量产工具类软件仅支持 Win10 及以上,不支持 macOS/Linux),下载地址见 https://hezhouyibiao.com/ 。Mac 用户可通过 Windows 虚拟机或 Windows 电脑使用。
49. Air780E开发产品量产时能直接换成AIR1780P吗?
解答: 要看原设计基于哪款:Air1780P 与 Air780EPM 引脚/软件全兼容,可直接替换;但与早期 Air780E 不是全兼容(管脚定义、外围有差异),不能直接换。量产替换前务必对照两者硬件手册核对引脚、供电和天线设计,并使用对应型号固件(固件不可混刷)。
50. 用合宙的卡能实现AT指令查询出经纬度吗?
解答: 可以,但经纬度来自基站/WiFi 定位(LBS),不是 GPS。AT 固件下使用 AT+CIPGSMLOC(免费版单基站定位,有频率限制:约4小时1次)或 AT+AIRLBS(收费版多基站+WiFi,精度更高、频率更高);LuatOS 下对应 lbsLoc2.request(免费)与 airlbs.request(收费)。返回结果为经纬度字符串。注意 LBS 不保证每次必有回复,失败需重试;高精度定位请用 GNSS。LBS 指令见 https://docs.openluat.com/atmozu/product/command/lbswifi/ ,配置说明见 https://docs.openluat.com/value/basestation/doc/ 。
51. TTS播报同时拨打114电话,TTS没播报完114就接通了,然后死机,怎么解决?
解答: 问题在于业务时序与音频资源冲突:电话拨通(MAKE_CALL_OK)时音频通道应切到通话,若此时 TTS 仍在占用 audio 播放,会出现通道竞争甚至异常。正确做法是在通话事件到来后主动停止本地播放:SPEECH_START 之后、通话接通时调用 exaudio.finish() 和 exaudio.play_stop({type = 1}) 停止 TTS 播放,释放音频通道给 CC(通话);同时关注 audio 与 CC 同时工作的内存占用,必要时降低并发、增大内存余量。音频/通话库用法以官方 demo 为准。
52. 蓝牙的底层库影响780EPM进入lowpower模式吗?
解答: 会影响。蓝牙(BLE)协议栈初始化并运行后,射频和协议栈任务处于活动状态,会阻止或拉高低功耗电流;Air780EPM 本体无内置 BLE(蓝牙为外挂/特定型号才有),若工程中加载并初始化了蓝牙库但业务未用,会白白耗电并影响进入 lowpower。处理建议:①不需要蓝牙时不要 require/初始化蓝牙库;②需要蓝牙的产品,在休眠前按库说明关闭蓝牙广播/连接、必要时反初始化,唤醒后再重新初始化;③用功耗分析仪对比"加载蓝牙库"和"不加载"两种固件的休眠电流确认影响。低功耗调试参考 https://docs.openluat.com/air780egh/luatos/app/lowpower/sleep/ 。
53. Air780EPM核心板价格300元?
解答: 核心开发板价格以合宙官方淘宝店实时标价为准(https://luat.taobao.com/ )。核心板集成了模组、电源、SIM 卡座、天线座、下载调试电路并配套完整资料与 demo,主要价值在于前期软硬件验证和规避设计风险,可显著降低自研板返工成本;量产后模组单价远低于开发板,具体模组价格见淘宝或联系销售。
54. Air780EPM有核心开发板吗?
解答: 有,Air780EPM 核心开发板可在合宙官方淘宝店购买:https://item.taobao.com/item.htm?id=948385509578 。配套资料(硬件手册、原理图、demo)见文档站 https://docs.openluat.com/air780epm/ 。
55. Air780EPM远程升级失败,请求URL用浏览器打开是错误页面,是什么问题?
解答: 升级 URL 打开为错误页,最常见原因是设备未归属到当前登录的 iot.openluat.com 账号/项目下,平台无法为该 IMEI 生成有效的升级任务地址。处理步骤:①在平台确认该 IMEI 是否在自己账号项目中,不在则先做设备归属(参考 https://docs.openluat.com/air780epm/product/attributioniot/ );②归属后重新创建升级任务,再用浏览器访问返回的完整 URL 验证应能下载到固件文件;③查看 iot 平台升级后台日志,其中有每次升级请求的详细失败原因(版本不匹配、差分包缺失、设备分组错误等)。FOTA 配置见 https://docs.openluat.com/air780epm/luatos/app/ota/fota/ 。
56. Air780EPM的固件后台显示时间更新了但分组参数不起作用,是网站出问题了吗?
解答: 不是网站故障,是分组配置版本号机制导致。设备只有在"分组配置版本号"大于本地已保存版本号时才会拉取新配置;如果设备内部版本号已经大于当前分组版本号,就不会更新。处理:在 iot 平台对应分组里点"配置"→修改/确认配置并"确定",每保存一次分组版本号 +1,连续保存使分组版本号高于设备内部版本号(例如点到版本7),设备下次上线即会拉取到新配置。
57. 设备使用基站定位,位置更新慢甚至不更新怎么回事?
解答: 基站定位(LBS)本身不保证每次都有返回,且免费版单基站定位有约4小时1次的频率限制,位置精度和成功率取决于周边基站密度。优化建议:①免费版失败时重试、合理提高请求频率(但受限于频率配额);②对实时性/精度要求高的场景升级收费版多基站+WiFi 定位(airlbs.request / AT+AIRLBS),精度和成功率显著提升;③最高精度仍需 GNSS。LBS 服务说明见 https://docs.openluat.com/value/basestation/doc/ 。
58. 2-3年前买的片子一直没用,现在要添加账号归属,但只能查到淘宝单号查不到快递单号,怎么办?
解答: 设备归属不依赖快递单号。处理途径:①从哪个渠道(淘宝店/代理商/销售)购买的,就联系该渠道提供 IMEI 清单,由其在 iot 平台将设备转移/归属到你的账号名下;②若为合宙官方淘宝店购买,可联系合宙销售提供订单号(淘宝单号即可)和 IMEI 协助归属。归属操作见 https://docs.openluat.com/air780epm/product/attributioniot/ 。
59. iot添加设备是要授权吗?还是有别的方式?没看到入口。
解答: 设备不需要单独"授权码",而是通过归属机制把 IMEI 纳入自己账号的项目。登录 iot.openluat.com(账号默认采购手机号、初始密码 888888,首次登录建议改密),按归属文档操作即可;若设备不在自己名下(如经代理商采购),需由采购方在平台做转移。完整操作见 https://docs.openluat.com/air780epm/product/attributioniot/ 。
60. 设备做归属是怎么操作?我把IMEI号添加到了升级的固件那个地方就可以吗?
解答: 不是在"升级固件"处添加 IMEI。正确归属流程:①登录 iot.openluat.com,进入/新建自己的项目(产品),获取该项目的 productKey;②归属是把设备 IMEI 绑定到你的账号项目下——自己采购的设备默认在采购手机号账号下,可直接在平台项目里管理;非本账号的设备,需由原采购渠道(销售/代理)在平台做设备转移到你的账号;③归属完成后,LBS、FOTA、errDump 等云服务才能用你的 productKey 正常工作。操作文档见 https://docs.openluat.com/air780epm/product/attributioniot/ 。
61. Air8000开发板GPIO16输出只有2.898V,正常应该3.3V,是什么问题?
解答: Air8000 系列 IO 电平全系固定 3.3V(不支持 pm.ioVol 调整),GPIO 输出高电平应接近 VDD_IO。实测只有约 2.9V 通常不是模组故障,而是该引脚上挂了负载或外部电路把电平拉低(如外部上拉到更低电压、外设灌电流、走线短路/漏电、万用表内阻与板载分压)。排查步骤:①断开该脚外部接线,空载用万用表/示波器复测;②确认脚本中该脚已配置为输出并置高(gpio.setup(..., 1)),未被其他功能复用;③检查板上该网络是否有上拉到 1.8V/2.8V 的器件或损坏的 TVS;④空载仍偏低则换一个 GPIO 交叉验证,排除个体损坏。
62. Air8201G的LBS和WIFI定位误差大怎么优化?
解答: LBS(单基站)定位精度天然较低(百米到公里级,取决于基站密度),WiFi 辅助可显著改善到几十~百米级,但都无法达到 GNSS 精度。优化建议:①使用收费版多基站+WiFi 定位(airlbs/AT+AIRLBS),比免费单基站精度高;②确保设备能采集到足够多的周边 WiFi/基站信息上报;③对定位精度要求高的资产/追踪场景,启用 GNSS(Air8201 内置 GNSS),GNSS 精度小于2m,户外以 GNSS 为主、室内用 WiFi/LBS 兜底。LBS 服务见 https://docs.openluat.com/value/basestation/doc/ 。
63. 8201H开机连不上位机识别不了串口,灯亮几下就灭了,怎么烧录?
解答: Air8201H 出厂烧录的是工厂产测软件,开机后会自动进入低功耗,USB 随之断开,所以上位机识别不到串口。烧录方法:①按下载模式强制进入——断电后在 Luatools 点下载,按住 BOOT 键(BOOT 需拉高而非接地)再给模组供电,使模组停留在下载模式;②Air8201 内核使用 Air780EHM 的固件,烧录后先下载一个不进入低功耗的 GPIO 例程,让 USB 保持连接;③随后即可正常下载自己的业务脚本。通用烧录步骤见 https://docs.openluat.com/common/howtodown/ 。
64. 点击下载脚本后显示检测到设备,到开始通信,然后马上跳下载失败,是什么情况?
解答: 已能检测到设备说明驱动基本正常,"开始通信即失败"多为连接稳定性或供电问题。排查步骤:①更换带数据传输的优质 USB 线、直连电脑主板 USB 口(避开 HUB/前置面板);②保证供电充足,下载时模组耗电较大,USB 供电不足会在通信阶段掉线,必要时外接电源;③升级 Luatools 到最新版、清理 _temp 缓存、重装驱动;④确认进入了正确的下载模式(断电→点下载→按 BOOT→上电);⑤换电脑验证。烧录指引见 https://docs.openluat.com/common/howtodown/ 。
65. Air780EPM的Luat版本VBAT引脚对地短路,需要分析失效原因,怎么处理?
解答: VBAT 对地短路属硬件失效,需官方分析定位。先自行初步确认:断电用万用表测 VBAT 对地阻抗,断开外部电源/负载、排除外围电容击穿或外部电路短路后,若模组本体 VBAT 仍短路则为模组内部损坏。随后将失效样品寄回合宙做失效分析,并附失效背景(供电方式、是否有过压/反接/浪涌、不良比例、IMEI/批次)。送样地址与接收人请通过官方企业微信群或销售渠道获取最新信息(https://docs.openluat.com/ 网站底部二维码入群)。
66. Air8000的GPIO20有什么特殊的?想要拉低只能到1.3V,去掉光耦是正常到0V。
解答: GPIO20 即 AGPIOWU0,属于 AlwaysOn 唤醒脚,特点是低功耗/休眠下可保持电平或作唤醒中断,但驱动能力极弱(小于 30uA)。光耦内部发光二极管通常需要 1.5mA 以上驱动电流,远超该脚能力,导致输出被抬升到约 1.3V 而无法拉低。设计上应改用驱动能力强的普通 GPIO(GPIO1~19、GPIO29~38)或 AGPIO3~8(GPIO23~28)直接驱动光耦。低功耗 GPIO 分类说明见 https://docs.openluat.com/atmozu/product/command/lowpower/ 。
67. GPIO20驱动光耦导致电平异常,板子已经打好了,有没有什么配置可以不改版解决?
解答: 该问题是驱动能力不足,软件配置无法改变引脚物理驱动能力,不改板可通过外部加器件解决:GPIO20 只作为信号控制脚,外接一个 NPN/PMOS 三极管(或 MOSFET)做开关,光耦由外部电源经上拉/三极管供电,GPIO20 仅控制三极管基极/栅极(基极串限流电阻),所需工作电流由外部电源提供,不再从 GPIO20 取流。这样 GPIO20 微弱电流即可控制光耦通断,无需改版。
68. Air780EGG模组GNSS PPS信号只有1HZ输出,其他频率不输出是怎么回事?
解答: PPS 默认就是 1PPS(每秒一个脉冲)秒脉冲信号,用于授时/同步,不是可编程高频时钟。GNSS 芯片输出 1Hz 是正常状态;若需要其他脉冲频率/脉宽,需向 GNSS 芯片发送相应的配置指令(如 CFG-TP 类消息)修改时间脉冲输出参数,且受芯片支持范围限制。可通过模组主控与 GNSS 芯片相连的 UART(内部 UART2,exgnss 库提供指令通道)发送配置。定位与接口说明见 https://docs.openluat.com/osapi/ext/exgnss/ 、https://docs.openluat.com/air780epm/luatos/hardware/gnss/ 。
69. 4G模块有没有可以接摄像头拍照的方案?要低功耗。
解答: 有。Air780/Air8000/Air700 系列 4G 模组支持一路 SPI 摄像头(gc032a/gc0310/bf30a2,搭配 AirCAMERA_1040/1050 等 SPI 摄像头配件),功耗低、适合定时拍照场景;Air8101/Air1601 高性能平台支持 DVP 和 USB 摄像头(如 AirCAMERA_1020 DVP 仅适用 Air8101,USB 摄像头即插即用,支持更高像素/录像/推流)。低功耗拍照选 780/8000 + SPI 摄像头。接口说明见 https://docs.openluat.com/osapi/ext/excamera/ 。
70. 人脸识别模组出来的UVC视频是倒置的,怎么处理?
解答: UVC 模组输出图像方向与模组安装方向有关,倒置属于安装方向与画面坐标不一致。处理方式:①在显示/播放端将图像旋转 180°(或按实际旋转 90°/270°)后再渲染;②若上位机/APP 支持,配置采集参数中的旋转/翻转;③物理安装时调整模组方向使正向朝上。核心是在视频链路的显示端做旋转校正即可。
71. Air8000A用什么供电?3.2V能工作吗?
解答: Air8000 系列 VBAT(PIN7/8)供电范围为 3.3~4.35V,典型锂电池 3.8V 可稳定工作。3.2V 已低于规定最低工作电压 3.3V,不在保证范围内,可能出现发射掉线、重启等异常,不建议按 3.2V 设计。供电还需保证 1A 以上电流能力,并就近放置 220uF 电解电容 + 22uF 钽电容;单节锂电池放电截止约 3.3V,需在软件中处理低电关机。供电设计见 https://docs.openluat.com/air8000/luatos/hardware/vbat/ 。
72. Air8000W能验证蓝牙功能吗?需要4G和蓝牙。
解答: 可以。Air8000W 属于内置 WiFi/BLE 芯片的五款型号之一(Air8000A/AB/U/N/W),同时具备 4G 与 BLE 能力,WiFi 与 BLE 为伴生功能、共用 2.4G 天线,官方核心板即可直接验证 BLE;且 WiFi/4G/以太网可同时运行。BLE 应用示例见 https://docs.openluat.com/air8000/luatos/app/BLE/ ,型号差异见 https://docs.openluat.com/air8000/product/ 。
73. Air8000支持哪些摄像头接口?
解答: Air8000 仅支持一路 SPI 接口摄像头(驱动 gc032a/gc0310/bf30a2,搭配 AirCAMERA_1040/1050 等 SPI 摄像头配件),不支持 DVP 和 USB 摄像头。DVP(如 AirCAMERA_1020)和 USB 摄像头是 Air8101/Air1601 高性能平台支持的接口,不要混淆选型。摄像头接口说明见 https://docs.openluat.com/osapi/ext/excamera/ 。
74. Air510W和Air780EHU的硬件设计参考电路图文档打不开。
解答: 资料入口以官方产品手册页为准,可重新进入下载:Air780EHN/Air780EHU 的硬件手册(V1.2 PDF)、硬件设计指导、核心板使用说明与原理图 PCB 封装在 https://docs.openluat.com/air780ehnehu/product/shouce/ ;Air510W 规格在选型指南 https://docs.openluat.com/SelectionGuide/SelectionGuide/ ,Air1601 V1.2 开发板内置 Air510W 可作参考设计。若页面附件(file/ 链接)打不开,多为浏览器或网络问题,换浏览器/重新下载 PDF/ZIP 即可;仍异常请通过官方企业微信群反馈。
75. 一个基站同时支持多少设备在线?
解答: 单基站可承载的在线设备数没有面向终端的固定值,由运营商网络规划决定(取决于基站载波配置、信令/数据信道资源、小区负载、PSM/DRX 配置等,Cat.1 小区通常可容纳数千级连接,但会随业务模型变化)。对设备开发者而言无需也无法控制该容量;实际项目中如果出现同一区域大量设备集中上线困难、延迟升高,应:①错峰上报、采用低功耗/PSM 减少并发驻留;②与运营商沟通当地小区容量与扩容;③增加多运营商卡分流。合宙不提供基站容量参数,这属于运营商网络侧指标。
76. 老化时多台AIR780EPM无信号,能自行安装信号放大器吗?
解答: 不建议自行安装手机信号放大器(直放站),这类设备未经无线电管理审批属违规安装,且易造成网络干扰、上行噪声抬升,反而导致周边设备更难驻网。老化测试多台设备同时无信号,优先排查:①老化环境信号本身弱——改用高增益/室外天线或把天线引到窗边改善接收;②大量设备集中并发导致小区拥塞——错峰、分批上线;③天线装配/线材损耗。若确属屏蔽车间/地下室信号弱,应通过运营商建设合规室内分布系统解决,而非私装放大器。
77. 合宙目前LBS+WIFI定位费用怎么算的?
解答: 分免费版和收费版:免费版为单基站定位(lbsLoc2.request / AT+CIPGSMLOC),约4小时1次,不收费但精度低、不保证必返回;收费版为多基站+WiFi 定位(airlbs.request / AT+AIRLBS),精度更高、调用频率更高,按单台/年订阅,参考档位为 1元/年(约12次/小时)、2元/年(约24次/小时)、5元/年(约60次/小时)、10元/年(约240次/小时),在 iot.openluat.com 平台订单管理中开通。价格与开通方式以平台页面为准,服务说明见 https://docs.openluat.com/value/basestation/doc/ 及 https://docs.openluat.com/atmozu/product/command/lbswifi/ 。
78. air5101蓝牙模块一直输出开机信息是怎么回事?
解答: 合宙 Air5101 系列蓝牙模组运行 LuatOS,正常上电会从串口输出开机日志(版本、启动信息)。若持续反复输出开机信息,说明模组在不断复位重启,常见原因是供电不足/不稳(发射瞬间掉电)、串口接线异常或程序异常。另外需确认模组真实型号——市面有外观相似的安信可模组,其固件与日志格式不同,不属于合宙 Air5101。建议核对丝印型号、保证供电电流、抓启动日志定位复位原因。
79. 780EGP有没有办法再扩展几个串口出来?
解答: 可以通过外挂串口扩展类模组增加串口。搭配 Air6208(WiFi 模组)可扩展约 4 个串口,搭配 Air6205 可扩展约 2 个串口,主控与扩展模组之间通过 UART/SPI(AirLink)通信,扩展串口由对应模组透传/管理。具体扩展能力与接线以 Air6205/Air6208 产品文档为准。
80. 6205能不能跑2812幻彩灯带?
解答: WS2812(2812 幻彩灯带)对时序要求高,需主控有精确的单线波形驱动能力。目前 Air1780(MCU 平台)可驱动 WS2812 灯带;Air6205/Air6208 暂无现成的 2812 驱动支持,不建议用 6205/6208 直接驱动灯带。灯带方案建议用 Air1780 控制。
81. 1780可以挂在Air780EGP上用吗?直接通过Air780EGP去控1780的2812。
解答: 可以这样组合。Air1780(MCU)负责驱动 WS2812 灯带,Air780EGP(4G+GNSS)负责网络与定位,两者通过 UART 连接,由 Air780EGP 下发控制指令(颜色/灯效)、Air1780 收到后驱动灯带。这种架构把对时序敏感的 2812 波形交给 Air1780 生成,4G 侧只做业务逻辑,是推荐做法。需要分别为两颗芯片烧录各自型号的固件(固件不可混刷),并约定好 UART 通信协议。
82. Air780EPM是否支持LuatOS固件?固件不匹配报错model Air1780P is not match with firmware type Air780EPM。
解答: Air780EPM 支持 LuatOS,但固件与型号严格绑定,不能混刷。报错"model Air1780P is not match with firmware type Air780EPM"说明当前设备实际是 Air1780P,而烧录的是 Air780EPM 固件,型号校验不通过。必须下载与模组型号完全一致的固件(Air1780P 用 Air1780P 固件,Air780EPM 用 Air780EPM 固件)。固件页见 https://docs.openluat.com/air780epm/luatos/firmware/ 。
83. Air1780P可以使用LuatOS-SoC_V2014_Air780EPM_104.soc吗?
解答: 不可以。固件与型号一一对应,Air1780P 必须使用 Air1780P 型号的固件,不能刷 Air780EPM 的 soc 固件(烧录时会做型号校验,强行刷写会失败或无法启动)。虽然 Air1780P 与 Air780EPM 硬件兼容,但固件文件按型号区分发布,请下载对应型号固件。
84. Air780EPM和Air780EHU软件是否兼容?用780EPM固件给780EHU烧录提示失败。
解答: 软件 demo 基本通用,但固件不通用。Air780EHU 有自己的固件型号,烧录必须使用 Air780EHU 对应固件,用 Air780EPM 固件刷 Air780EHU 会因型号不匹配失败。应用层脚本/demo 可直接参考 Air780EHM_Air780EHV_Air780EGH(含 EHU)目录下的例程。固件在 Air780EHN/EHU 固件页下载,资料见 https://docs.openluat.com/air780ehnehu/product/shouce/ 。
85. Air724UG的批量采购有折扣吗?梯度大概多少?
解答: 模组价格与批量折扣以合宙官方淘宝店(https://luat.taobao.com/ )实时标价及销售报价为准,大批量采购可联系合宙销售获取梯度报价。具体折扣与起订量请直接咨询官方销售渠道。
86. Air8783批量采购有折扣吗?
解答: 模组价格与批量折扣以合宙官方淘宝店(https://luat.taobao.com/ )实时标价及销售报价为准,批量采购可联系合宙销售获取梯度报价。具体折扣与起订量请直接咨询官方销售渠道。
87. Air780EPM模组500个多少钱?
解答: 模组价格随市场与采购量浮动,历史参考价约含税 15.8 元/片,具体以合宙官方淘宝店(https://luat.taobao.com/ )实时标价或销售正式报价为准,批量采购可联系销售获取优惠。
88. LuatOS-Air_V1008版本正式固件发布了吗?
解答: 已发布。Air795UG/Air722/Air724UG 的 LuatOS_V1008 版本正式固件下载地址:https://gitee.com/openLuat/LuatOS/releases/tag/v1008.rda8910.release 。
89. Air780EPM固件版本更新日志在哪查看?
解答: LuatOS 固件的版本更新记录在各型号的固件页,例如 Air780EPM 固件见 https://docs.openluat.com/air780epm/luatos/firmware/ (AT 固件历史版本说明见 https://docs.openluat.com/air780e/at/firmware/ ),页面列出每个版本的发布日期与新增/修复内容。
90. Air8000 V2048版本test问题如何跟踪?
解答: V2048 是正式发布版本,其固件页已明确标注"已知问题"(如 uart11/uart12 无法向外发送数据),后续版本的修复情况记录在固件页更新记录中。跟踪方式:①关注固件页 https://docs.openluat.com/air8000/luatos/firmware/ 的新版本与更新日志,修复会随新版本发布并在更新记录中说明;②紧急问题通过官方企业微信群(https://docs.openluat.com/ 底部二维码)或 gitee 提交,提供 IMEI、固件版本、复现日志以便跟进;③在修复版本发布前,先用固件页列出的规避方案(如改用其他 UART)规避。
91. 合宙放弃对阿里云腾讯云等云对接服务了吗?库会出升级版本吗?
解答: 针对阿里云、腾讯云等特定云平台的专用对接库,合宙不再持续维护更新,相关应用层对接代码需用户基于标准 MQTT/HTTP 库自行维护。底层的 mqtt、socket、http 等核心库持续维护,用户可直接用标准协议对接任意云平台(阿里云物联网平台、腾讯云物联网开发平台均提供标准 MQTT 接入),不依赖专用封装库。
92. L2TP是专用客户端才能连接的吗?通用L2TP能不能连?
解答: 通用标准 L2TP 即可连接,不要求专用客户端。按标准 L2TP/IPSec 协议配置服务器地址、账号、预共享密钥等参数即可建立隧道;具体支持的网络制式与配置指令以所用型号 AT/网络文档为准。
93. 设备没有自动重连到服务器,10多分钟了还连不上,怎么办?
解答: 需分层排查:①网络层——确认 SIM 正常、已驻网(AT+CEREG? / mobile.csq()),掉线后是否能重新驻网,弱网区域先解决信号;②协议层——确认是否开启了自动重连:MQTT 用 mqttc:autoreconn(true, reconnect_time)(重连周期小于 1000ms 会被强制调整为 1s 以上;注意使用多网卡时不要用该接口,否则可能选错网卡无法上网),WebSocket 用 wsc:autoreconn;③应用层——在断连回调里加退避重连逻辑(失败后延时递增重连),并加网络看门狗,长时间无法恢复则重启模组;④升级到最新固件(如 V2050)排除已知协议栈问题。接口见 https://docs.openluat.com/osapi/core/mqtt/ 。
94. 合宙模组型号不匹配的固件能混刷吗?
解答: 不能。LuatOS 固件与模组型号严格绑定,烧录时会做型号校验,必须使用与模组型号完全一致的固件(Air780EPM 用 EPM 固件、Air780EHU 用 EHU 固件等),混刷会报错或无法启动;差分包也只能在同型号、同类固件之间升级。
95. Air780EHC固件版本V2023使用HTTPS分片上传800多KB数据,每片8KB以上就超时怎么办?
解答: 单片越大、TLS 加密与弱网传输出错重传的概率越高,8KB 即超时说明当前网络/固件下分片过大。处理:①减小单片大小至 2~4KB(AT 固件 HTTP 缓存约 4KB,AT+HTTPEXACTION 分段 POST);②每片收到服务器 ACK 后再发下一片,服务器侧及时回 200、调大接收超时;③升级到最新正式固件(V2023 较旧,新版本对 TLS/HTTP 稳定性有修复);④LuatOS 开发改用 socket/http 库流式发送并加失败重传;⑤确认信号质量(rsrp/rsrq),弱网先改善信号。指令参考 https://docs.openluat.com/atmozu/product/command/http/ 。
96. Air780EPM低功耗模式进不去,卡在等待80秒最后重启。
解答: 卡在等待后重启,说明有资源未释放导致休眠超时。常见原因是 USB 未关闭(USB 连接会阻止进入低功耗),请在进休眠前主动关闭 USB;此外逐项检查:是否还有串口/网络连接、定时器、外设句柄未释放,GPIO 电平与 WAKEUP 配置是否正确。建议对照官方低功耗 demo(https://docs.openluat.com/air780egh/luatos/app/lowpower/sleep/ )核对休眠前流程,并用功耗分析仪确认是否真正进入休眠。
97. Air8783有没有外壳?加外壳多少钱一个?
解答: 合宙提供外壳 3D 打印定制服务(含产品外壳定制),可按需打印但外观受工艺限制;具体外壳价格因尺寸、工艺、数量而异,无统一固定价。可在合宙官方淘宝店(https://luat.taobao.com/ )查看或联系合宙销售提供尺寸/数量获取报价。
98. 合宙自带的流量卡30M流量有点少,换别的流量卡有限制吗?
解答: 模组本身不限制流量卡来源,可以自行更换流量更多的物联卡。注意两点:①合宙随开发板附带的测试卡(约30M)仅用于开发测试,一旦通电激活可能被卡商做机卡绑定,换设备可能锁卡(锁卡找卡商解绑),但把"别的卡换到合宙模组上"不受限;②自行采购时选 Cat.1 全网通(与设备制式匹配)的正规物联卡,并向卡商确认机卡绑定/锁卡规则、定向专网 APN 设置(若用定向卡需把合宙云域名加入白名单)。
99. Air8000支持哪些网络?8000的蓝牙和WiFi能否同时使用?
解答: Air8000 国内型号(A/W/D/T/AB/DB)支持 4G LTE Cat.1(TDD B34/38/39/40/41、FDD B1/3/5/8),并具备以太网能力;带 WiFi/BLE 的型号(Air8000A/AB/U/N/W)内置 WiFi+BLE 芯片,WiFi 与 BLE 由同一芯片实现、为伴生关系,可同时使用;且 WiFi、4G、有线以太网可以同时运行(多网融合,见 AirETH_1000 配件)。Air8000D/DB 等不带 WiFi/BLE 芯片的型号无蓝牙/WiFi。型号与频段见 https://docs.openluat.com/air8000/product/ ,WiFi/BLE 硬件见 https://docs.openluat.com/air8000/luatos/hardware/wifi&ble/ 。
100. Air780EH和780EPM的天线硬件有区别吗?
解答: 同系列(如 Air780EHM 与 Air780EPM)的射频天线硬件设计没有区别,天线管脚、匹配电路与射频性能要求一致,天线部分电路可以通用。最终设计仍建议对照所购具体型号的硬件手册/硬件设计指导核对。
101. Air780的北美版本第35pin对地短路怎么处理?
解答: 无需处理,属正常现象。第35pin 是射频天线脚,内部经匹配/ESD 电路到地,万用表测量对地呈现导通/低阻是正常的,北美版与国内版在这一点上相同。生产测试不要把天线脚对地阻抗作为短路不良判据,应通过射频指标(驻波、传导/辐射测试)判断天线通路好坏,说明见对应型号硬件手册天线章节。
102. Air780EPM设备在IOT平台升级失败,提示设备不在账号下怎么办?
解答: 需要先完成设备归属。FOTA、LBS 等云服务要求设备 IMEI 在当前登录账号的项目下;若设备是从代理商/其他渠道采购、不在自己账号,需联系原采购渠道(从哪里买的就让谁)在 iot.openluat.com 把设备转移到你的账号,或凭采购订单/IMEI 联系合宙销售协助。归属操作见 https://docs.openluat.com/air780epm/product/attributioniot/ 。
103. Air780EPM的OTG平台升级后设备无法连接,如何解决?
解答: 升级后设备无法连接,需按"升级是否真正成功"分两步处理:①若新固件运行但连云失败——检查升级后脚本/配置是否正确(productKey、服务器地址、APN),确认设备仍归属本账号项目,抓开机日志看驻网与连接流程;②若升级导致固件异常/无法启动——重新用 Luatools 有线烧录可用固件恢复(按下载模式:断电→点下载→按 BOOT→上电),再重新升级。同时确认升级包与型号一致、FOTA 分区 MD5 校验通过(差分包需同型号同类固件)。通用烧录恢复见 https://docs.openluat.com/common/howtodown/ ,FOTA 见 https://docs.openluat.com/air780epm/luatos/app/ota/fota/ 。
104. 如何查看合宙不同编号的固件版本区别?
解答: 到对应型号的固件页查看。因 Flash 空间有限,合宙用不同编号固件(如1/2/15/16…)装载不同核心库组合,固件页(如 https://docs.openluat.com/air780epm/luatos/firmware/ 、https://docs.openluat.com/air8000/luatos/firmware/ )列出每个版本的发布日期、更新记录和各编号固件功能说明;注意差分升级只能在同编号固件之间进行(固件1只能差分升固件1),32位/64位固件差异另有说明。选型时按业务所需功能库(audio、camera、eink、BLE 等)对照功能清单选择编号。
105. Air780EGP开机启动后模块功耗在40mA左右,和手册的6.69mA不符,是什么原因?
解答: 手册的 6.69mA 是特定条件下的平均待机电流(低功耗策略、插卡、GNSS 特定工作状态、典型周期),不是开机瞬时值。开机后显示 40mA 属正常的工作态电流,原因包括:①刚开机阶段模组在搜网、注册、建链,电流本就偏高;②未进入低功耗/休眠策略前模组保持常驻网状态;③GNSS 首次定位、有源天线供电(PIN98 GNSS_VDD 3.3V)、G-sensor 等外设工作电流;④USB 连接、外设未关闭也会抬高电流。要复现手册数据,需按官方低功耗 demo 进入休眠策略、用 Air9000 功耗仪对完整周期取平均(实测低功耗平均电流可到 2mA 量级,休眠态 GNSS+Gsensor 仅约30uA),参考 https://docs.openluat.com/air780egh/luatos/app/lowpower/sleep/ 。