2025.3.4
首页 ▸ Integrations ▸

EZcontrol XS1

EZcontrol XS1 integration集成将 Home Assistant 与您的设备、服务等连接和集成。 [Learn more] 允许您观察和控制在 XS1 网关上配置的设备。请查看官方文档以使用此网关 Bedienungsanleitung v3.0.0.0。

配置

将以下条目添加到 configuration.yamlconfiguration.yaml 文件是 Home Assistant 的主要配置文件。它列出了要加载的集成及其特定配置。在某些情况下，需要直接在 configuration.yaml 文件中手动编辑配置。大多数集成可以在 UI 中配置。 [Learn more] 文件。 在更改了configuration.yamlconfiguration.yaml 文件是 Home Assistant 的主要配置文件。它列出了要加载的集成及其特定配置。在某些情况下，需要直接在 configuration.yaml 文件中手动编辑配置。大多数集成可以在 UI 中配置。 [Learn more] 文件后，重启 Home Assistant 以应用更改。 该集成现在显示在集成页面的 设置 > 设备与服务 下。其实体在集成卡片上以及实体标签上列出。

# 示例 configuration.yaml 条目
xs1:
  host: "192.168.2.100"

integration集成将 Home Assistant 与您的设备、服务等连接和集成。 [Learn more] 将仅在 初始化时 自动检测 XS1 网关的配置，这目前意味着当 Home Assistant 启动时。当您更改 XS1 的配置时，您（目前）必须重启 Home Assistant 才能看到效果。

Configuration Variables

Looking for your configuration file?
host string Required

XS1 网关的主机。

port integer (Optional, default: 80)

如果您在某种代理后面运行网关，则自定义端口。

ssl boolean (Optional, default: false)

定义是否应使用 https 进行 API 请求（仅通过您自己的代理可能）。

username string (Optional)

访问 XS1 网络 API 的用户。

password string (Optional)

访问 XS1 网络 API 的密码。

支持的设备类型

Note

此 integration集成将 Home Assistant 与您的设备、服务等连接和集成。 [Learn more] 当前仅涵盖 XS1 网关所支持的部分设备类型，未支持的类型将被简单忽略。

传感器

支持任何类型的传感器。

Note

如果您使用气候设备，则“当前温度”传感器将由执行器自动使用（如果命名正确）。要使其正常工作，请查看下面的执行器描述。

执行器

类型 支持 备注
开关 是
调光器 部分支持 调光器目前被处理为开关，因此实际调光不被支持 :(
温度 是

气候执行器/传感器

Home Assistant 可以将温度传感器和气候执行器组合成一个设备。XS1 网关不允许这样做，但可以分别配置传感器和执行器。要使 Home Assistant 在同一气候设备中注册它们，只需在 XS1 网关配置中将 传感器 名称前缀为执行器名称，例如：

  • 执行器设备名称: “Bedroom_Temp”
  • 传感器设备名称: “Bedroom_Temp_Sensor”

示例

在本节中，您将找到使用此 integration集成将 Home Assistant 与您的设备、服务等连接和集成。 [Learn more] 的一些实际示例。

完整配置

此示例显示了如何使用可选配置选项。

# 示例 configuration.yaml 条目
xs1:
  host: "192.168.2.100"
  port: 80
  ssl: false
  username: myuser
  password: 123totallySecure

相关主题