2025.3.4
首页 ▸ Integrations ▸

SUPLA

SUPLA 集成允许您在 Home Assistant 中使用 SUPLA 设备。

SUPLA-DEV 是一个开源的家庭自动化系统，适用于 Raspberry Pi、Arduino 或基于 ESP8266 的设备。它拥有自己的协议、固件和商业可用设备，例如 Zamel 生产的设备。

目前，仅支持遮盖（在 SUPLA 的术语中为百叶窗）、门、车库门和开关，但由于全面且通用的 REST API，添加更多设备相对容易。

现在，无法添加设备——所有设备都从 SUPLA-CLOUD 的服务器或您自己的服务器上发现。

对于基于 MQTT 自动发现的更完整的 Home Assistant 支持，请考虑将您的 Supla 设备切换到 MQTT（通过设置界面）。或者使用 Supla Cloud 提供的 MQTT 代理。

Important

Supla Cloud MQTT 代理需要 更改默认的 MQTT 协议设置 至版本 3.1。

配置

要在您的安装中使用 SUPLA 设备，请将以下内容添加到您的 configuration.yamlconfiguration.yaml 文件是 Home Assistant 的主要配置文件。它列出了要加载的集成及其特定配置。在某些情况下，需要直接在 configuration.yaml 文件中手动编辑配置。大多数集成可以在 UI 中配置。 [Learn more] 文件中：

supla:
  servers:
    - server: "svr1.supla.org"
      access_token: "YOUR_ACCESS_TOKEN"

Configuration Variables

Looking for your configuration file?
servers list

服务器配置列表。

server string Required

SUPLA-CLOUD 服务器的地址（IP 地址或 DNS 名称）；可以是 云托管 实例或 自托管 实例。

access_token string Required

用于 REST API 配置的访问令牌。在 权限 > 通道 下，至少需要启用 读取 和 操作执行 权限。可以从 SUPLA-CLOUD 的安全部分获取用于 个人访问令牌 页面，或从您自己的自托管实例获取。