首页 ▸ Integrations ▸

EnOcean

EnOcean 标准得到了许多不同厂商的支持。有许多不同种类的开关和传感器，通常它们采用能量收集技术获取电源，因此不需要电池。

EnOcean 集成添加了对一些这些设备的支持。您需要一个控制器，如 USB300，才能使其正常工作。

目前 Home Assistant 支持以下设备类型：

二进制传感器 - 墙壁开关
传感器 - 电力表、温度传感器、湿度传感器和窗户把手
灯光 - 调光器
开关

但是，由于消息类型的广泛性，并非所有设备在没有代码更改的情况下都能正常工作。以下设备已经确认可以直接使用：

Eltako FUD61 调光器
Eltako FT55 无电池墙壁开关
Jung ENOA590WW 无电池墙壁开关
Omnio WS-CH-102-L-rw 无电池墙壁开关
Permundo PSC234（开关和电力监测器）
EnOcean STM-330 温度传感器
Hoppe SecuSignal 窗口把手（来自 Somfy）

如果您拥有未列出的设备，请检查您的设备是否可以使用列出的 EnOcean 设备配置（EEP）中的一种。如果可以，它可能会正常工作。可用的配置通常会在设备手册的某处列出。

尚未实现对技术信息消息的支持。

配置

要将 EnOcean integration 添加到您的 Home Assistant 实例中，请使用此 My 按钮：

手动配置步骤

如果上述 My 按钮不起作用，您也可以手动执行以下步骤：

浏览到您的 Home Assistant 实例。
转到 设置 > 设备与服务。
在右下角，选择 Add Integration 按钮。
从列表中选择 EnOcean。
按照屏幕上的说明完成设置。

尽管集线器的配置基于用户界面，但实体仍使用 YAML 配置（见下一个章节）。

二进制传感器

这通常可以是那些无电池的墙壁开关。经过测试的有：

Eltako FT55，使用了 EnOcean PTM 215 模块
TRIO2SYS 墙壁开关，使用了 EnOcean PTM210 DB 模块
Omnio WS-CH-102

支持以下 EnOcean 设备配置：

F6-02-01（灯光和百叶窗控制 - 应用样式 1）
F6-02-02（灯光和百叶窗控制 - 应用样式 2）

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

# 示例 configuration.yaml 条目
binary_sensor:
  - platform: enocean
    id: [0x01,0x90,0x84,0x3C]

Configuration Variables

Looking for your configuration file?

id list Required

设备的 ID。这是调光器上写的 4 字节长的数字。

name string (Optional, default: EnOcean 二进制传感器)

前端中开关的标识符。

device_class device_class (Optional)

设置设备类，更改设备的状态和在前端显示的图标。

EnOcean 二进制传感器没有状态，它们只生成“button_pressed”事件。事件数据包含以下字段：

id: 设备的 ID（见配置）。
pushed: 1 表示按钮按下，0 表示按钮释放。
which: 使用单个火箭时始终为 0；使用双火箭开关时为 0 或 1。
onoff: 火箭的任一侧为 0 或 1。

自动化示例

切换灯光开关的示例自动化：

# 在按钮释放时开启/关闭灯光的示例自动化
automation:
  - alias: "走廊灯开关"
    triggers:
      - trigger: event
        event_type: button_pressed
        event_data:
          id: [0xYY, 0xYY, 0xYY, 0xYY]
          pushed: 0
    actions:
      - action: "{% if trigger.event.data.onoff %} light.turn_on {% else %} light.turn_off {%endif %}"
        target:
          entity_id: "{% if trigger.event.data.which == 1 %} light.hall_left {% else %} light.hall_right {%endif %}"

您可以通过转到开发者工具 -> 事件来找到 event_data id，并监听“button_pressed”事件。然后点击设备上的一个按钮，您应该会看到一个事件。

灯光

EnOcean 灯光可以有多种形式。当前只测试了一种类型：Eltako FUD61 调光器。

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

# 示例 configuration.yaml 条目
light:
  - platform: enocean
    id: [0x01,0x90,0x84,0x3C]
    sender_id: [0xFF,0xC6,0xEA,0x04]

Configuration Variables

Looking for your configuration file?

id list Required

设备的 ID。这是调光器上写的 4 字节长的数字。

sender_id list Required

设备的发送 ID。这是一个 4 字节长的数字。

name string (Optional, default: EnOcean 灯光)

前端中灯光的标识符。

传感器

EnOcean 传感器平台目前支持以下设备类型：

电力传感器
湿度传感器
温度传感器
窗户把手

# 示例 configuration.yaml 条目
sensor:
  - name: 电视
    platform: enocean
    id: [0x01,0x90,0x84,0x3C]

Configuration Variables

Looking for your configuration file?

id list Required

设备的 ID。这是您设备的 4 字节长标识符。

name string (Optional, default: EnOcean 传感器)

前端中传感器的标识符。

device_class device_class (Optional, default: powersensor)

设置设备类，更改设备的状态和在前端显示的图标。

电力传感器

这已在 Permundo PSC234 开关上进行了测试，但任何发送 EEP A5-12-01 消息的设备都能正常工作。

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

# 示例 configuration.yaml 条目
sensor:
  - name: 电视
    platform: enocean
    id: [0x01,0x90,0x84,0x3C]
    device_class: powersensor

湿度传感器

支持以下 EnOcean 设备配置：

任何在位置 DB2.7 到 DB2.0 处包含湿度值的配置
A5-04-01 - 温度和湿度传感器，范围 0°C 到 +40°C 和 0% 到 100%
A5-04-02 - 温度和湿度传感器，范围 -20°C 到 +60°C 和 0% 到 100%
A5-10-10 到 A5-10-14 - 房间操作面板

# 示例 configuration.yaml 条目
sensor:
  - name: 浴室
    platform: enocean
    id: [0x01,0x90,0x84,0x3C]
    device_class: humidity

温度传感器

此传感器已在通用 STM-330 传感器上进行了测试，该传感器用于大多数室内温度传感器设备。

支持以下 EnOcean 设备配置：

任何在位置 DB1.7 到 DB1.0 处包含 8 位温度的配置。不支持 10 位。
A5-02-01 到 A5-02-1B - 温度传感器，具有不同的温度范围
A5-10-01 到 A5-10-14 - 房间操作面板
A5-04-01 - 温度和湿度传感器，范围 0°C 到 +40°C 和 0% 到 100%
A5-04-02 - 温度和湿度传感器，范围 -20°C 到 +60°C 和 0% 到 100%
A5-10-03 - 温度传感器，设定点控制
A5-10-10 - 温度和湿度传感器与设定点
A5-10-12 - 温度和湿度传感器，设定点与占用控制

检查您温度传感器的手册以找出使用了哪个 EEP。如果您不知道，请进行合理的猜测并检查报告的值。验证温度时在范围边界值查看是最简单的，因此可以将传感器放入冰箱一段时间。

# 示例 configuration.yaml 条目
sensor:
  - name: 客厅
    platform: enocean
    id: [0x01,0x90,0x84,0x3C]
    device_class: temperature

温度传感器支持以下额外配置属性。

Configuration Variables

Looking for your configuration file?

min_temp integer (Optional, default: 0)

传感器支持的最小温度（°C）。

max_temp integer (Optional, default: 40)

传感器支持的最大温度（°C）。

range_from integer (Optional, default: 255)

传感器报告的 min_temp 范围值。

range_to integer (Optional, default: 0)

传感器报告的 max_temp 范围值。

请注意，range_from 和 range_to 的默认配置值并不是错字，对于大多数传感器来说，范围是反向的。但是，一些 EEP 有不同的、反向的范围，从 0 到 250。这包括以下 EEP：

A5-04-01
A5-04-02
A5-10-10 到 A5-10-14
A5-20-01 - 电池供电的执行器（双向）

为这些传感器调整 configuration.yamlconfiguration.yaml 文件是 Home Assistant 的主要配置文件。它列出了要加载的集成及其特定配置。在某些情况下，需要直接在 configuration.yaml 文件中手动编辑配置。大多数集成可以在 UI 中配置。 [Learn more]：

# 针对 EEP A5-10-10 的示例 configuration.yaml 条目
sensor:
  - name: 客厅
    platform: enocean
    id: [0x01,0x90,0x84,0x3C]
    device_class: temperature
    range_from: 0
    range_to: 250

窗口把手

截至目前，Somfy 的 Hoppe SecuSignal 窗口把手已经成功测试。但是，任何遵循 EnOcean RPS 传送规范 F6 10 00（Hoppe AG）的机械窗户把手也受支持。

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

# 针对窗口把手 EEP F6-10-00 的示例 configuration.yaml 条目
sensor:
  - name: 客厅窗户把手
    platform: enocean
    id: [0xDE,0xAD,0xBE,0xEF]
    device_class: windowhandle

该配置没有任何可选参数。

窗口把手传感器可以有以下状态：

closed: 窗口把手处于关闭位置（通常向下或 6 点钟位置）
open: 窗口把手处于打开位置（通常向左或向右，或 3 点钟或 9 点钟位置）
tilt: 窗口把手处于倾斜位置（通常向上或 12 点钟位置）

开关

EnOcean 开关可以有多种形式。目前，仅测试了几种类型：Permundo PSC234 和 Nod On SIN-2-1-01。

# 示例 configuration.yaml 条目
switch:
  - platform: enocean
    id: [0x01,0x90,0x84,0x3C]

Configuration Variables

Looking for your configuration file?

id list Required

设备的 ID。这是一个 4 字节长的数字。

name string (Optional, default: EnOcean 开关)

开关的标识符。

channel integer (Optional, default: 0)

切换输出通道的通道号（通常为 0 或 1）。

# 具有两个输出（通道）的开关示例条目，例如 Nod On SIN-2-1-01
switch nodon01_0:
  - platform: enocean
    id: [0x05,0x04,0x03,0x02]
    name: enocean_nodon01_0
    channel: 0

switch nodon01_1:
  - platform: enocean
    id: [0x05,0x04,0x03,0x02]
    name: enocean_nodon01_1
    channel: 1

帮助我们改进翻译

建议编辑此页面，或提供/查看此页面的反馈。

编辑提供反馈查看待处理的反馈

配置

二进制传感器

Configuration Variables

自动化示例

灯光

Configuration Variables

传感器

Configuration Variables

电力传感器

湿度传感器

温度传感器

Configuration Variables

窗口把手

开关

Configuration Variables

相关主题

帮助我们改进翻译