跳转至

常见问题 - 2026-09-26

数据日期：2026-09-26

1. 合宙云平台IOT的链接是什么？

解答： 结论：合宙云平台（IoT）的入口是 https://iot.openluat.com/ 。

说明：iot.openluat.com 是合宙的设备接入与固件（FOTA）管理平台，设备注册、项目 key（PRODUCT_KEY）、固件上传、升级配置、IMEI 归属与升级记录等都在这里操作。它与技术文档站 docs.openluat.com（查硬件/软件资料）、AI 问答入口 ai.luatos.com（智能检索文档与代码）是三套独立入口，用途不同，不要混用。

处理步骤：

  1. 浏览器打开 https://iot.openluat.com/ ，用采购时预留的手机号注册或登录。
  2. 在项目列表中找到（或新建）自己的项目，复制升级所需的校验码（项目 key）。
  3. 设备端在 main.lua 中把 PROJECT / VERSION 与 PRODUCT_KEY 配成与平台一致。
  4. 上传固件、设置升级范围（全部设备或指定 IMEI），在设备列表中管理 IMEI 归属。

参考文档：https://iot.openluat.com/ 、https://docs.openluat.com/ 、https://ai.luatos.com/ 。

2. FOTA升级可以从2034.1直接升级到2052吗？

解答： 结论：不能假定“一定能直接升”。跨版本 FOTA 能否只做差分，取决于服务端是否提供以你当前版本为基线的差分包；建议先在一台样机上验证，必要时改走整包升级。

说明：LuatOS 固件分 core 与 script 两部分，core 只能差分升级。差分包的实质是“指定旧版本 → 新版本”的差异数据，必须针对具体旧版本制作，因此从 2034.1 跨到 2052 需要有以 2034.1 为基线的差分包，没有就跨不了；不同后缀（_1 / _2）固件分区不同，也不能互升，强行升级可能无法启动。

处理步骤：

  1. 先向合宙确认 2034.1 → 2052 是否已有对应差分包；没有就逐级升级或改用整包（本地线刷）。
  2. 自行制作：用 Luatools 把新旧版本各生成一次量产文件，再走“LuatOS → 固件工具 → 差分包/整包升级包制作”，选低/高版本生成 .bin 差分包（需 Luatools 3.0.9 及以上）。
  3. 上传差分包到 IoT 平台并配置升级设备。
  4. 先在一台样机上实测升级成功、重启后版本号正确，再放量。

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

3. FOTA不做差分升级会不会导致设备挂掉？

解答： 尚未解答

4. 8300可以做WiFi热点吗？

解答： 结论：可以。Air8300 基于 Air8000W 设计，而 Air8000W 内置 4G 与 WiFi/BLE 两颗芯片，支持 WiFi AP（热点）模式，可做成“4G 供网、WiFi 对外发热点”的形态。

说明：Air8000W 的 WiFi/BLE SoC 是协处理器，其固件由合宙提供、不可二次开发，需保证为最新版本。LuatOS 中通过 wlan 库操作：AP 模式下用 wlan.createAP 创建热点，配合 dhcpsrv 下发 IP、netdrv.napt 做地址转换，接入热点的手机/电脑即可经 4G 上网。

处理步骤：

  1. 确认硬件为 Air8300（Air8000W 方案），并接好 4G 天线与 WiFi 天线。
  2. 参考 Air8000 WiFi 应用示例中“开启 AP 热点”的代码，初始化 wlan 并创建热点。
  3. 用 dhcpsrv 与 netdrv.napt 把 AP 网段与 4G 出口打通。
  4. 若热点建不起来，先按文档升级 WiFi 协处理器固件再试。

参考文档：https://docs.openluat.com/air8300/hardware/circuit/ 、https://docs.openluat.com/air8000/luatos/app/mulu/wifi/ 。

5. 780EPM可以做4G WiFi热点吗？

解答： 结论：Air780EPM 单独做不了 4G WiFi 热点——它只有 4G Cat.1 射频，没有 WiFi 射频；能发 WiFi 热点的是 Air8300（基于 Air8000W）这类方案。780EPM 要给别的设备供网，需外挂 WiFi 模组或 SPI 以太网。

说明：Air780EPM 是纯 4G Cat.1 模组，WiFi 侧仅支持扫描（wifiscan），不支持 AP 模式，因此不能自己开热点。想让其他设备共享它的 4G 网络，要有 WiFi 射频的载体：一是外挂 WiFi 模组（如 Air6205 一类）发无线热点；二是外挂 SPI 以太网（如 CH390）做有线供网，上行仍是 4G。

处理步骤：

  1. 先区分需求是“无线热点”还是“给设备供网”：前者须外挂 WiFi 模组，后者可外挂 SPI 以太网。
  2. 参考多网融合文档，用 exnetif.setproxy 把外挂网卡设为 4G 的下游出口。
  3. 硬件走线与天线按对应扩展板资料设计。

参考文档：https://docs.openluat.com/air8300/hardware/circuit/ 、https://docs.openluat.com/air780epm/luatos/app/network_routing/4g_out_ethernet_in_wifi_in/ 。

6. 烧录过程中一直提示错误，重启Luatools后就正常了，是什么原因？

解答： 尚未解答

7. 天线发烫是正常的吗？

解答： 结论：天线本身不会主动发热，感觉发烫多是模组射频发射或供/充电链路的热量传导过来。如原回答所述，充电时温度略高属正常，但一般不会“特别烫”，接近 60℃ 就偏热，应当排查。

说明：4G 模组在信号差时会提高发射功率来维持链路，电流和发热随之增大（信号越差，发射功率越大，越耗电发热）；若射频链路阻抗失配、馈线/连接器短路或功率异常，也会产生额外热量。天线区域明显发烫，往往不是天线本身，而是旁边的模组、充电 IC 或电源在发热。

处理步骤：

  1. 用 adc.CH_CPU 等估算模组温度，区分是“温热”还是“烫手”。
  2. 检查馈线、射频连接器有无短路/虚焊，PCB 射频走线是否做 50Ω 阻抗控制、是否预留匹配网络。
  3. 核对信号：弱信号或特殊基站会让发射功率偏高，可换位置或锁频段对比。
  4. 检查充电与供电链路是否异常发热；持续异常发热时应断电，避免器件损伤。

参考文档：https://docs.openluat.com/air780epm/luatos/hardware/design/ant/ 。

8. LuatOS的lua MCP配置是否不能用了？

解答： 结论：可以用，配置方法以官方《合宙 MCP 服务和 CLI 工具》页面为准；按原回答，参考 https://docs.openluat.com/ai/mcp_cli/ 即可解决。

说明：该页面汇总了合宙提供给 AI 工具使用的 MCP 服务与 CLI 工具，包括 docs-ai（docs 文档检索）、code-ai（LuatOS 代码/示例检索）、luatos-cli（命令行刷机、日志查看、FOTA 包生成）、luatpower（功耗分析仪）等。配置方式是：在支持 MCP 的 AI 工具（如 Trae 等）里填入页面给出的 mcpServers JSON，url 指向对应的服务地址。

处理步骤：

  1. 打开 https://docs.openluat.com/ai/mcp_cli/ ，找到要用的服务。
  2. 把页面给出的 mcpServers JSON 片段复制进你的 AI 工具的 MCP 配置。
  3. 保存后重启/刷新 AI 工具，确认对应服务已加载。
  4. 若加载失败，检查 JSON 格式、网络能否访问该 url，以及工具版本是否支持 MCP。

参考文档：https://docs.openluat.com/ai/mcp_cli/ 。

搜索