2025.3.4
首页 ▸ Integrations ▸

AVM FRITZ!SmartHome

The AVM FRITZ!SmartHome integration for Home Assistant allows you to integrate AVM Smart Home (former AVM FRITZ!DECT) devices like plugs, thermostats or shutter drivers as also trigger so called smart home templates (contains settings for Smart Home devices of the same type).

Tested devices

Prerequisites

It is recommended to create a separate user to connect Home Assistant to your FRITZ!Box. To create a user, in the FRITZ!Box go to System > FRITZ!Box Users > Users > Add User. Make sure the user has the Smart Home permission.

Note

If you still want to use the predefined user, please note that as of FRITZ!OS 7.24, the FRITZ!Box creates a random username for the admin user if you didn’t set one yourself. This can be found after logging into the FRITZ!Box and visit System > FRITZ!Box Users > Users. The username starts with fritz followed by four random numbers. Under properties on the right it says created automatically. Prior to FRITZ!OS 7.24, the default username was admin.

配置

要将 AVM FRITZ!SmartHome hub 添加到您的 Home Assistant 实例中，请使用此 My 按钮：

AVM FRITZ!SmartHome 可以被 Home Assistant 自动发现。如果发现了实例， 它将显示为 已发现。您可以立即进行设置。

手动配置步骤

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

  • 浏览到您的 Home Assistant 实例。

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

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

  • 从列表中选择 AVM FRITZ!SmartHome。

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

Host

The hostname or IP address of your FRITZ!Box router.

Username

Name of the user to connect Home Assistant to your FRITZ!Box (see prerequisites)

Password

Password for the user to connect Home Assistant to your FRITZ!Box (see prerequisites)

Data fetching and limitations

Since the API of the FRITZ!Box does not provide a push mechanism, this integration polls the data every 30 seconds from the FRITZ!Box. Because of this, the integration can’t support the main features of event-based devices like the FRITZ!DECT 350 door/window contact sensors or the FRITZ!DECT 440 buttons (see the other devices section for details).

Devices

Light bulbs

Light bulbs like the FRITZ!DECT 500 or Magenta SmartHome LED E27 Color will be integrated as light灯具有您可以控制的亮度，并且可以选择控制色温或 RGB 颜色。 [Learn more] entities.

Note

The FRITZ!DECT 500 light bulb supports only 36 colors. When a color is picked in Home Assistant that is not supported by the device, a color that comes close will be activated.

Plugs

Plugs like the FRITZ!DECT 200 or FRITZ!DECT 210 will be integrated as switch开关是具有两种状态的东西，您可以在这两种状态之间进行选择，例如打开或关闭插座。 [Learn more] entities.

Further there are additional sensor传感器返回有关事物的信息，例如水箱中的水位。 [Learn more] and “binary sensor”二进制传感器返回只有两种状态的信息 - 例如开或关。 [Learn more] entities created for each device, based on its capabilities:

  • Button lock via UI
  • Button lock on device
  • Electric Current
  • Power Consumption
  • Temperature
  • Total Energy
  • Voltage

Shutter drivers

Shutter drivers like the Rademacher RolloTron DECT 1213 will be integrated as cover盖子是可以打开和关闭的设备，例如百叶窗、车库门等，并且可以选择设置为特定位置。 [Learn more] entities.

Templates

Self defined templates within the FRITZ!Box smart home configuration menu, will be integrated as button按钮实体可以触发事件或触发对设备或服务的动作。它可以与物理按钮进行比较。按钮实体没有像“开”或“关”这样的状态，但在 Home Assistant UI 或通过动作按下时会保留最后按下的时间戳。 [Learn more] entities and those can be triggered from within Home Assistant.

Thermostats

Thermostats like the FRITZ!DECT 301, FRITZ!DECT 302 or Eurotronic Comet DECT will be integrated as climate气候实体允许您控制和监控 HVAC（供暖、通风和空调）设备和恒温器。 [Learn more] entities.

These entities can have several attributes that can be useful for automationsHome Assistant 中的自动化允许您自动响应在家中和周围发生的事情。 [Learn more] and templates模板是一种自动化定义，可以包括动作或触发值数据的变量。这允许自动化生成动态动作。 [Learn more]:

Attribute Description
battery_low The low battery state indication.
battery_level The battery level (only available since Fritz!OS 7).
holiday_mode The state of the holiday mode (only available since Fritz!OS 7).
summer_mode The state of the summer mode (only available since Fritz!OS 7).
window_open The state of the window open detection (only available since Fritz!OS 7).

Further there are additional sensor传感器返回有关事物的信息，例如水箱中的水位。 [Learn more] and “binary sensor”二进制传感器返回只有两种状态的信息 - 例如开或关。 [Learn more] entities created for each device, based on its capabilities:

  • Battery
  • Button lock via UI
  • Button lock on device
  • Comfort Temperature
  • Current Scheduled Preset
  • Eco Temperature
  • Next Scheduled Change Time
  • Next Scheduled Preset
  • Next Scheduled Temperature

Other devices

Some devices like the FRITZ!DECT 350 or the FRITZ!DECT 440 can’t be controlled via this integration, but its sensors can still be integrated.

The availability of these sensor传感器返回有关事物的信息，例如水箱中的水位。 [Learn more] and “binary sensor”二进制传感器返回只有两种状态的信息 - 例如开或关。 [Learn more] entities depends on the features and capabilities of the connected device and can be one or multiple of:

  • Battery
  • Button lock via UI
  • Button lock on device
  • Humidity
  • Temperature

Troubleshooting

In any case, when reporting an issue, please enable debug logging, restart the integration, and as soon as the issue re-occurs stop the debug logging again (download of debug log file will start automatically). Further if still possible, please also download the diagnostics data. If you have collected the debug log and the diagnostics data, provide them with the issue report.

Remove the integration

从Home Assistant中移除集成实例

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

If you don’t use the separate created FRITZ!Box user anymore, than remove it from the FRITZ!Box under to System > FRITZ!Box Users > Users.