SUPLA

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

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

目前仅支持 cover（在 SUPLA 中称为 shutters）、大门、车库门和开关，但由于其 REST API 完整且通用，扩展更多设备相对容易。

目前无法手动添加设备，所有设备都将从 SUPLA-CLOUD 的服务器或您自己的服务器中发现。

如果您想获得基于 MQTT 自动发现的更完整 Home Assistant 支持，可考虑通过设置界面将 Supla 设备切换到 MQTT，或使用 Supla Cloud 提供的 MQTT broker。

:::important Supla Cloud MQTT broker 需要将默认 MQTT 协议设置更改为 3.1 版本。

:::

配置

要在您的安装中使用 SUPLA 设备，请将以下内容添加到您的 "configuration.yaml" 中：

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

servers:
  description: 服务器配置列表。
  requires: true
  type: list
  keys:
    server:
      description: SUPLA-CLOUD 服务器地址（IP 地址或 DNS 名称）；可以是[官方云托管](https://cloud.supla.org)实例，也可以是[自托管](https://github.com/SUPLA/supla-cloud)实例。
      required: true
      type: string
    access_token:
      description: 用于 REST API 配置的访问令牌。在 **Scopes** > **Channels** 下，至少需要启用 **Read** 和 **Action execution** 权限。令牌可在 SUPLA-CLOUD 的安全设置中 [Personal Access Token](https://cloud.supla.org/security/personal-access-tokens) 页面获取，也可以从您自己的自托管实例中获取。
      required: true
      type: string

#SUPLA

#配置

SUPLA

配置