跳转至

常见问题 - 2026-08-16

数据日期：2026-08-16

1. LuaTools上的AI问答功能在哪个版本可用？

解答： LuaTools 自 3.4.3 版本起内置 AI 问答功能，请将 LuaTools 升级到 3.4.3 或更高版本后使用。若当前版本较老导致在线升级失败，可直接到官方文档站下载最新安装包重新安装（LuaTools 工具教程：https://docs.openluat.com/common/Luatools/ ）。升级后若菜单中看不到 AI 问答入口，请确认已登录合宙账号，该功能需登录后才可使用。

2. LuaTools的AI问答功能在哪里打开？

解答： AI 问答入口位于 LuaTools 顶部菜单栏，使用前必须先登录合宙账号（未登录时入口不可用或点击无响应）。请先将 LuaTools 升级到 3.4.3 及以上版本，在软件中完成账号登录后，即可从菜单栏打开 AI 问答窗口。若登录后仍看不到入口，请重启 LuaTools 或重新安装最新版本。

3. LuaTools AI问答一直转圈圈怎么办？

解答： 一直转圈通常是账号未登录或网络访问异常所致，请按以下顺序排查：1）确认已在 LuaTools 中登录合宙账号，AI 问答必须登录后才能使用；2）检查电脑网络是否正常、能否正常访问外网，公司网络如有防火墙/代理请放开或切换网络重试；3）关闭 LuaTools 后重新打开，或稍等几分钟再试（服务器高峰期可能响应较慢）；4）确认 LuaTools 已升级到 3.4.3 及以上版本。若以上均正常仍长时间无响应，建议更换网络环境或重启电脑后再试。

4. Air780EPM信号不稳定、容易断网怎么办？

解答： 信号不稳定、频繁断网多为天线/射频硬件问题，建议按以下步骤定位：

  1. 不要锁定频段（Band）：锁频会导致模块在不同基站覆盖环境下无法切到信号更好的频段，应保持全频段自动选网；如曾用 mobile.setBand() 锁过频段，可烧录默认固件或恢复全频段。
  2. 排查天线与结构：天线必须保证净空区，远离无刷电机、电池、金属屏蔽罩及主板高频器件；检查 IPEX/射频座是否扣紧、射频走线是否做 50Ω 阻抗匹配。天线性能需结合实际 PCB 和结构由天线厂调试（4G 天线设计指南：https://docs.openluat.com/air780epm/luatos/hardware/ant/ ）。
  3. 用信号指标量化判断：通过 mobile.rsrp() 查看 RSRP、mobile.scell() 查看服务小区信息；CSQ 仅作参考，弱信号（RSRP 偏低）时射频需加大发射功率，容易掉线。
  4. 默认固件对比法：烧录官方默认固件在同一位置对比信号：默认固件正常 → 多为用户软件配置问题（如锁频、飞行模式逻辑、低功耗配置）；默认固件仍差 → 基本可定位为硬件/天线问题，请找天线厂针对整机场景调试。

5. SIM卡检测只能上电检测一次吗？有没有办法定时检测是否插入SIM卡？

解答： 不是只能上电检测一次，LuatOS 提供三种 SIM 在位检测/热插拔机制，可按硬件方案选择：

  1. 底层周期检测（无需额外硬件）：常规模式下底层约每 30 秒自动做一次 SIM 在位检测；订阅 sys.subscribe("SIM_IND", ...) 消息即可收到状态变化，RDY 表示卡正常，NORDY 表示无卡。注意进入低功耗模式（pm.power(pm.WORK_MODE, 1)）后该周期检测会关闭。
  2. 自动恢复检测：调用 mobile.setAuto(check_sim_period, ...) 配置周期（毫秒），系统会周期性检查 SIM 状态，卡不在位时自动进出飞行模式尝试恢复，适用于震动接触不良、运行中拔卡后重新插入等场景（该函数只需配置一次，不要放在循环中）。
  3. 卡座检测脚 + GPIO 中断（推荐用于真正热插拔）：SIM 卡座的 CD（Card Detect）引脚接一个带外部上拉的 GPIO，参考官方 demo module/Air780EPM/demo/mobile/mobile_test.lua：用 gpio.debounce() 做 500ms 防抖，gpio.setup() 注册中断，插卡时调用 mobile.flymode(0,true) 再 mobile.flymode(0,false) 触发重新读卡，拔卡时进入飞行模式。若只需"定时查询是否插卡"，也可在定时器中读取该 GPIO 电平（卡在位时 CD 脚接地为低电平）或调用 mobile.status() 判断。

参考文档：https://docs.openluat.com/osapi/core/mobile/ （mobile.status / mobile.setAuto / SIM_IND 说明）。

6. AIR780EHU海外版的LBS定位在国外是不是失效？

解答： 是的，合宙官方的基站定位（LBS）和 WiFi 定位在国外无法使用——官方定位服务器只维护国内基站/WiFi 数据库，没有国外基站数据，海外使用时无法返回有效经纬度（参考基站/WiFi 定位文档：https://docs.openluat.com/air780epm/luatos/app/common/lbswifi/ ，其中明确说明"合宙官方的基站定位不能在国外使用，没有国外的基站数据库"）。

GNSS（GPS/北斗）卫星定位不受此限制，在全球任何能收到卫星信号的开阔地带均可使用。因此海外定位场景请选用带 GNSS 的型号，如 Air780EG（内置 GNSS），或外挂 Air530W/Air510W 定位芯片；注意 GNSS 需在室外开阔环境测试，室内无法定位。

7. 模块APN设置没有user password可以吗？可以设置多个APN吗？

解答： 1）没有用户名/密码可以：国内公网卡基本不需要设置 APN，模块会自动获取；专网卡才需要设置。通过 mobile.apn(index, cid, apn_name, user_name, password, ip_type, protocol) 设置时，若卡商未提供用户名和密码，user_name、password 传空字符串 ""，鉴权协议 protocol 传 0（不需要鉴权）即可，例如 mobile.apn(0,1,"cmiot","","",nil,0)；专网卡的 name/user/password 需向卡商索取。APN 必须在入网前（SIM 卡识别完成前）设置，设置后不会立即返回，需等网络注册成功。

2）一张卡同时只有一个激活的 APN：一个 PDP 上下文对应一个 APN，正常上网使用默认 APN（cid=0）即可；mobile.apn() 的 cid 参数支持 >0 的连接 ID，可配置多组 APN 参数用于不同上下文，但同一时刻一张卡只有一个 APN 激活联网，不能用一张卡同时走两个 APN 通道。海外卡可通过 mobile.apnTableAdd(mcc, mnc, ...) 往自定义 APN 列表添加对应运营商的 APN。

参考文档：https://docs.openluat.com/osapi/core/mobile/ （mobile.apn / mobile.apnTableAdd）。

8. AIR780EX2有封装吗？

解答： 有封装。Air780EX2 为邮票孔封装的 4G Cat.1 数传 SoC 模组，模块尺寸 16mm × 18mm × 2.3mm，定位是替代老型号 Air780EX，特色同样是邮票孔封装、方便贴片焊接；除封装不同外，其管脚与 Air780EPM 基本一致。封装尺寸、管脚定义及推荐 PCB 封装可在 Air780EX2 产品手册中查阅下载：https://docs.openluat.com/air780ex2/product/ （手册内含 Air780EX2 与 Air780EX 的管脚区别说明，老客户升级时请注意核对管脚差异）。

9. 8000W的焊接工艺要求文件有吗？第一次小批量焊接不良比例高。

解答： 有官方工艺文件。合宙提供《合宙模组 SMT 炉温曲线说明》，适用于 Air8000 等邮票孔/贴片模组的回流焊工艺：https://docs.openluat.com/common/smt/ 。首次小批量焊接不良率高，建议对照文件重点检查以下环节：

  1. 钢网与锡膏印刷：模块焊盘对应钢网厚度建议 0.2mm，印刷刮板力度调整合适，保证锡膏漏印量均匀、无连锡少锡。
  2. 焊接顺序：双面贴装的 PCB，先贴没有模组的一面，第一面完成回流焊后再贴模组这一面，避免模组反复受热损伤。
  3. 炉温曲线：严格按推荐回流焊炉温曲线设置温升、恒温、回流峰值温度和冷却速率；无铅/有铅工艺区分设置，建议先用炉温测试仪实测板上温度。
  4. 来料与防潮：模组按 MSD 要求防潮存储，拆封后超时需烘烤；锡膏冷藏回温后搅拌使用。
  5. 小批量试产建议与贴片厂一起做首件确认（X-Ray 或显微镜检查焊点），工艺参数稳定后再批量投产。

10. 设备未注册、没有搜索到网络可能是什么原因？

解答： 设备未注册、搜不到网络，建议按"先区分软硬件、再逐项排查"的思路定位：

  1. 默认固件对比（快速界定软硬件）：烧录官方默认固件在同一位置测试：默认固件也搜不到网 → 多为硬件/SIM 卡问题；默认固件正常 → 为用户软件配置问题。
  2. SIM 卡排查：确认卡已插好、未欠费停机（物联卡欠费常表现为可注册 2G 但无法注册 4G）、卡未损坏，可换一张正常使用的卡交叉验证；通过 SIM_IND 消息或 mobile.status() 确认卡已就绪（RDY）。
  3. 天线与信号：检查 4G 天线是否扣紧、天线是否匹配支持的频段；用 mobile.rsrp() 查看 RSRP 信号强度，CSQ 仅作参考；不要锁定频段，保持全频段自动搜网。
  4. 软件配置：专网卡需在入网前用 mobile.apn() 正确设置 APN；定向卡需把 iot.openluat.com、bs.openluat.com 等服务器域名/IP 加入白名单；确认程序没有误进入飞行模式、低功耗配置是否关闭了协议栈搜网。
  5. 环境与运营商：确认所在位置有对应运营商的 4G 覆盖，海外使用需确认模块频段支持当地运营商。

参考文档：https://docs.openluat.com/air780epm/luatos/app/common/mobile/ （网络信息、SIM 状态与常见问题章节）。

11. LuaTools更新到3.43后提示异常，怎么处理？

解答： 更新后提示异常多为更新包下载不完整或文件被占用/杀毒软件拦截所致，建议按以下步骤处理：

  1. 完全关闭 LuaTools 后重新打开，按软件弹出的更新提示走自动更新流程，不要手动复制、替换安装目录内的文件。
  2. 若仍异常，将 LuaTools 换一个目录（最好是纯英文路径、不含中文和特殊字符的文件夹或另一块磁盘）重新下载安装；安装/更新前可暂时关闭杀毒软件或将安装目录加入白名单，避免更新文件被拦截。
  3. 清理安装目录下的 _temp、log 文件夹后再重启更新；过旧版本跨版本自动更新容易失败，可直接下载最新完整安装包全新安装。
  4. 若更新后出现识别不到设备的情况，可按住 BOOT 键上电进入下载模式，重新烧录固件。

LuaTools 工具教程：https://docs.openluat.com/common/Luatools/ 。

搜索