2025.3.4
首页 ▸ Integrations ▸

devolo家庭网络

devolo家庭网络 integration集成将 Home Assistant 与您的设备、服务等连接和集成。 [Learn more] 允许您监控和控制您的devolo PLC网络。根据您添加到Home Assistant的设备，可以实现不同的用例。大致上，您可以将设备分为Wi-Fi和非Wi-Fi设备。非Wi-Fi设备在监控您的PLC网络方面或多或少受限。然而，Wi-Fi设备可以帮助进行存在检测和远程控制您的客人Wi-Fi。有关详细信息，请继续阅读关于实体的信息，并查阅支持的设备。

配置

要将 devolo家庭网络 设备 添加到您的 Home Assistant 实例中，请使用此 My 按钮：

devolo家庭网络 可以被 Home Assistant 自动发现。如果发现了实例， 它将显示为 已发现。您可以立即进行设置。

手动配置步骤

如果没有自动发现，请不要担心！您可以设置一个 手动集成条目：

  • 浏览到您的 Home Assistant 实例。

  • 转到 设置 > 设备与服务。

  • 在右下角，选择 Add Integration 按钮。

  • 从列表中选择 devolo家庭网络。

  • 按照屏幕上的说明完成设置。

IP 地址

您的devolo家庭网络设备的IP地址。可以在设备仪表板上的devolo家庭网络应用中找到。

实体

当前，Home Assistant内部支持以下实体。

二进制传感器

  • 连接到路由器的设备
    • 每5分钟更新一次
    • 默认情况下禁用，因为它通常很少变化

按钮

  • 通过使其LED闪烁2分钟来识别PLC设备
  • 在PLC设备上开始配对
  • 重启设备
  • 启动WPS

图像

  • 您的客人Wi-Fi凭证的QR码
    • 如果检测到变化，每15秒更新一次
    • 默认启用

存在检测

  • 检测连接到主Wi-Fi或客人Wi-Fi的设备
    • 每15秒更新一次
    • 自动将新设备作为禁用实体添加，除非通过系统选项禁用

传感器

  • 连接的Wi-Fi客户端数量
    • 每15秒更新一次
    • 默认启用
  • 邻近Wi-Fi网络的数量
    • 每5分钟更新一次
    • 默认情况下禁用，因为运行时间较长
  • 同一PLC网络中的PLC设备数量
    • 每5分钟更新一次
    • 默认情况下禁用，因为它通常很少变化
  • PLC PHY速率
    • 每5分钟更新一次
    • 连接到路由器的设备的PHY速率默认启用。所有其他设备之间的PHY速率默认禁用。
  • 设备的上次重启时间
    • 每15秒更新一次
    • 默认情况下禁用，因为对大多数用户的兴趣较低。

开关

  • 开/关客人Wi-Fi
    • 默认启用
  • 开/关设备LED
    • 默认启用

更新

  • 更新设备的固件。
    • 默认启用，但仅在设备上启用定期检查时才会给出结果。

支持的devolo设备

支持的devolo设备列表取决于设备固件和设备功能。以下设备在固件5.6.0下经过测试：

  • Magic 2 WiFi 6
  • Magic 2 WiFi next
  • Magic 2 WiFi 2-1
  • Magic 1 WiFi mini
  • Magic 1 WiFi 2-1
  • WiFi 6 Repeater 5400
  • WiFi 6 Repeater 3000
  • WiFi Repeater+ ac
  • dLAN 1200+ WiFi ac
  • dLAN 550+ Wifi
  • dLAN 550 WiFi

自固件7.10以来，只要相应的实体受到支持，也可以使用以下无Wi-Fi设备：

  • Magic 2 LAN triple
  • Magic 2 DinRail
  • Magic 2 LAN 1-1
  • Magic 1 LAN 1-1
  • Gigabridge

已知限制

此集成仅支持使用devolo家庭网络应用程序使用的API。设备网站通常提供附加功能。然而，这些功能无法通过API访问，因此在devolo将其添加到API之前无法得到支持。

故障排除

Gigabridge

devolo Gigabridge是唯一一个带有默认密码的设备。然而，似乎在出厂默认设置中，密码适用于设备网站，但不适用于API。如果您通过网站为设备设置新的密码，则该密码会同时应用于两者，并且集成开始工作。即使再次使用相同的密码也有效。

示例自动化

在失去配对时重启PLC设备

PLC网络有时不稳定。要恢复网络状态，如果PLC设备的数量低于预期，重启连接到路由器的PLC设备有时是个好主意。如果您应用此自动化，请记住设备可能处于待机状态。在这个示例中，预期的设备数量是3。

alias: "PLC馈电重启"
description: "如果PLC设备数量出乎意料地少，重启连接到路由器的设备"
triggers:
  - trigger: numeric_state
    entity_id:
      - sensor.devolo_001_connected_plc_devices  # 用您的设备传感器替换
    for:
      hours: 0
      minutes: 10
      seconds: 0
    below: 3
actions:
  - action: button.press
    target:
      entity_id: button.devolo_001_restart_device  # 用您的设备按钮替换

在数据速率下降时通知

电线上的噪声可能会显著干扰PLC数据速率。接近下降的通知可以帮助识别导致下降的动作。以下示例以25%作为阈值。

alias: "PLC数据速率"
description: "PLC数据速率下降超过25%"
triggers:
  - entity_id:
      - sensor.devolo_001_plc_downlink_phy_rate_devolo_002  # 用您的设备传感器替换
      - sensor.devolo_001_plc_uplink_phy_rate_devolo_002
    trigger: state
conditions:
  - condition: template
    value_template: >-
      # 检查新值是否小于之前值的75%
      {{ (trigger.to_state.state|float / trigger.from_state.state|float) < 0.75 }}
actions:
  - action: notify.mobile_app_pixel_4a
    data:
      message: >-
        {{ trigger.to_state.name }} 的PLC数据速率下降到 {{
        trigger.to_state.state }}
        {{trigger.to_state.attributes.unit_of_measurement}}
      title: PLC数据速率下降

根据时间启用客人Wi-Fi

您可能只想在白天开放客人Wi-Fi，但在晚上关闭它。

alias: "切换客人Wi-Fi"
description: "打开和关闭客人Wi-Fi"
triggers:
  - trigger: time
    at: 
    - "08:00:00"
    - "17:00:00"
actions:
  - action: switch.toggle
    target:
      entity_id: switch.devolo_001_enable_guest_wifi  # 用您的设备开关替换

移除集成

此集成遵循标准集成移除。无需额外步骤。

从Home Assistant中移除集成实例

  1. 前往 设置 > 设备与服务 并选择集成卡片。
  2. 从设备列表中，选择要删除的集成实例。
  3. 在条目旁边，选择三个点 菜单。然后，选择 删除。