From 75ee5a4ff5b1930928c2bd1ee10d42fd64b0dc6d Mon Sep 17 00:00:00 2001 From: Michael <35783820+mib1185@users.noreply.github.com> Date: Mon, 14 Jul 2025 10:10:13 +0200 Subject: [PATCH] Some improvements to the AVM FRITZ!Smarthome docs (#39997) Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- source/_integrations/fritzbox.markdown | 87 +++++++++++++------------- 1 file changed, 45 insertions(+), 42 deletions(-) diff --git a/source/_integrations/fritzbox.markdown b/source/_integrations/fritzbox.markdown index 2ffc2224fc2..d4f9bce7fca 100644 --- a/source/_integrations/fritzbox.markdown +++ b/source/_integrations/fritzbox.markdown @@ -28,30 +28,38 @@ ha_codeowners: ha_integration_type: hub --- -The AVM FRITZ!SmartHome integration for Home Assistant allows you to integrate [AVM Smart Home](https://en.avm.de/products/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_). +The AVM FRITZ!SmartHome integration for Home Assistant allows you to integrate [AVM Smart Home](https://en.fritz.com/products/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 -- [FRITZ!Box 5590 Fiber][fritzbox_5590_fiber] -- FRITZ!Box 6490 Cable -- [FRITZ!Box 6591 Cable][fritzbox_6591_cable] -- [FRITZ!Box 7590][fritzbox_7590] -- [FRITZ!Box 7590 AX][fritzbox_7590_ax] -- [FRITZ!Box 7530 AX][fritzbox_7530_ax] -- FRITZ!Box 7490 -- FRITZ!Box 7430 -- [FRITZ!DECT 200][fritzdect_200] -- [FRITZ!DECT 210][fritzdect_210] -- [FRITZ!DECT 301][fritzdect_301] -- [FRITZ!DECT 302][fritzdect_302] -- [FRITZ!DECT 500][fritzdect_500] -- [Eurotronic Comet DECT][eurotronic_comet_dect] -- [Magenta SmartHome LED E27 Color][magenta_led_e27_color] -- Magenta SmartHome LED E27 warmwhite -- [Rademacher RolloTron DECT 1213][rademacher_rollotron_dect_1213] +- FRITZ!Box routers + - [FRITZ!Box 5590 Fiber][fritzbox_5590_fiber] + - FRITZ!Box 6490 Cable + - FRITZ!Box 6591 Cable + - FRITZ!Box 7590 + - FRITZ!Box 7490 + - FRITZ!Box 7430 + - [FRITZ!Box 7590 AX][fritzbox_7590_ax] + - [FRITZ!Box 7530 AX][fritzbox_7530_ax] +- [FRITZ!Smart Gateway][fritz_smart_gateway] +- FRITZ!SmartHome devices + - [FRITZ!Smart Energy 200][fritzdect_200] (_former FRITZ!DECT 200_) + - [FRITZ!Smart Energy 210][fritzdect_210] (_former FRITZ!DECT 210_) + - FRITZ!Smart Thermo 301 (_former FRITZ!DECT 301_) + - [FRITZ!Smart Thermo 302][fritzdect_302] (_former FRITZ!DECT 302_) + - FRITZ!DECT 500 +- Smart home devices from other vendors + - Eurotronic Comet DECT + - Magenta SmartHome LED E27 Color + - Magenta SmartHome LED E27 warmwhite + - [Homepilot RolloTron DECT 1213][rademacher_rollotron_dect_1213] (_former Rademacher RolloTron DECT 1213_) ## Prerequisites +Please note that in a [mesh](https://en.fritz.com/service/knowledge-base/dok/FRITZ-Box-7590/3329_Mesh-with-FRITZ/) setup, only the FRITZ!Box with the mesh master role should be added with the AVM FRITZ!SmartHome integration. + +### Username + 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 %} @@ -64,28 +72,28 @@ If you still want to use the predefined user, please note that as of FRITZ!OS 7. Host: description: "The hostname or IP address of your FRITZ!Box router." Username: - description: "Name of the user to connect Home Assistant to your FRITZ!Box (_see [prerequisites](#prerequisites)_)" + description: "Name of the user to connect Home Assistant to your FRITZ!Box (_see [Username](#username)_)" Password: - description: "Password for the user to connect Home Assistant to your FRITZ!Box (_see [prerequisites](#prerequisites)_)" + description: "Password for the user to connect Home Assistant to your FRITZ!Box (_see [Username](#username)_)" {% endconfiguration_basic %} ## 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][fritzdect_350] door/window contact sensors or the [FRITZ!DECT 440][fritzdect_440] buttons (_see the [other devices](#other-devices) section for details_). +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!Smart Control 350][fritzdect_350] door/window contact sensors or the [FRITZ!Smart Control 440][fritzdect_440] buttons (_see the [other devices](#other-devices) section for details_). ## Devices ### Light bulbs -Light bulbs like the [FRITZ!DECT 500][fritzdect_500] or [Magenta SmartHome LED E27 Color][magenta_led_e27_color] will be integrated as {% term light %} entities. +Light bulbs like the FRITZ!DECT 500 or Magenta SmartHome LED E27 Color will be integrated as {% term light %} entities. {% note %} -The [FRITZ!DECT 500][fritzdect_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. +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. {% endnote %} ### Plugs -Plugs like the [FRITZ!DECT 200][fritzdect_200] or [FRITZ!DECT 210][fritzdect_210] will be integrated as {% term switch %} entities. +Plugs like the [FRITZ!Smart Energy 200][fritzdect_200] or [FRITZ!Smart Energy 210][fritzdect_210] will be integrated as {% term switch %} entities. Further there are additional {% term sensor %} and {% term binary_sensor "binary sensor" %} entities created for each device, based on its capabilities: @@ -99,15 +107,15 @@ Further there are additional {% term sensor %} and {% term binary_sensor "binary ### Shutter drivers -Shutter drivers like the [Rademacher RolloTron DECT 1213][rademacher_rollotron_dect_1213] will be integrated as {% term cover %} entities. +Shutter drivers like the [Homepilot RolloTron DECT 1213][rademacher_rollotron_dect_1213] will be integrated as {% term cover %} entities. ### Templates -Self defined [templates](https://en.avm.de/guide/three-smart-home-templates-that-will-make-your-life-easier) within the FRITZ!Box smart home configuration menu, will be integrated as {% term button %} entities and those can be triggered from within Home Assistant. +Self defined [templates](https://en.fritz.com/guide/three-smart-home-templates-that-will-make-your-life-easier) within the FRITZ!Box smart home configuration menu, will be integrated as {% term button %} entities and those can be triggered from within Home Assistant. ### Thermostats -Thermostats like the [FRITZ!DECT 301][fritzdect_301], [FRITZ!DECT 302][fritzdect_302] or [Eurotronic Comet DECT][eurotronic_comet_dect] will be integrated as {% term climate %} entities. +Thermostats like the FRITZ!Smart Thermo series or Eurotronic Comet DECT will be integrated as {% term climate %} entities. Further there are additional {% term sensor %} and {% term binary_sensor "binary sensor" %} entities created for each device which can be useful for {% term automations %} and {% term templates %}, based on its capabilities: @@ -127,7 +135,7 @@ Further there are additional {% term sensor %} and {% term binary_sensor "binary ### Other devices -Some devices like the [FRITZ!DECT 350][fritzdect_350] or the [FRITZ!DECT 440][fritzdect_440] can't be controlled via this integration, but its sensors can still be integrated. +Event based devices like motion detection sensors or window/door contacts or buttons (_for example, [FRITZ!Smart Control 350][fritzdect_350] or the [FRITZ!Smart Control 440][fritzdect_440]_) cannot be controlled or used via this integration, but their sensors can still be integrated. The availability of these {% term sensor %} and {% term binary_sensor "binary sensor" %} entities depends on the features and capabilities of the connected device and can be one or multiple of: @@ -139,20 +147,15 @@ The availability of these {% term sensor %} and {% term binary_sensor "binary se - Open window detected - Temperature -[fritzbox_5590_fiber]: https://en.avm.de/products/fritzbox/fritzbox-5590-fiber -[fritzbox_6591_cable]: https://en.avm.de/products/fritzbox/fritzbox-6591-cable -[fritzbox_7590]: https://en.avm.de/products/fritzbox/fritzbox-7590 -[fritzbox_7590_ax]: https://en.avm.de/products/fritzbox/fritzbox-7590-ax -[fritzbox_7530_ax]: https://en.avm.de/products/fritzbox/fritzbox-7530-ax -[fritzdect_200]: https://en.avm.de/products/smart-home/fritzdect-200 -[fritzdect_210]: https://en.avm.de/products/smart-home/fritzdect-210 -[fritzdect_301]: https://en.avm.de/products/smart-home/fritzdect-301 -[fritzdect_302]: https://en.avm.de/products/smart-home/fritzdect-302 -[fritzdect_350]: https://en.avm.de/products/smart-home/fritzdect-350 -[fritzdect_440]: https://en.avm.de/products/smart-home/fritzdect-440 -[fritzdect_500]: https://en.avm.de/products/smart-home/fritzdect-500 -[eurotronic_comet_dect]: https://eurotronic.org/produkte/dect-ule-heizkoerperthermostat/comet-dect -[magenta_led_e27_color]: https://www.smarthome.de/geraete/smarthome-led-lampe-e27-farbig-weiss +[fritzbox_5590_fiber]: https://en.fritz.com/products/fritzbox/fritzbox-5590-fiber +[fritzbox_7590_ax]: https://en.fritz.com/products/fritzbox/fritzbox-7590-ax +[fritzbox_7530_ax]: https://en.fritz.com/products/fritzbox/fritzbox-7530-ax +[fritzdect_200]: https://en.fritz.com/products/smart-home/fritzsmart-energy-200 +[fritzdect_210]: https://en.fritz.com/products/smart-home/fritzsmart-energy-210 +[fritzdect_302]: https://en.fritz.com/products/smart-home/fritzsmart-thermo-302 +[fritzdect_350]: https://en.fritz.com/products/smart-home/fritzsmart-control-350 +[fritzdect_440]: https://en.fritz.com/products/smart-home/fritzsmart-control-440 +[fritz_smart_gateway]: https://en.fritz.com/products/smart-home/fritzsmart-gateway [rademacher_rollotron_dect_1213]: https://www.rademacher.de/shop/rollladen-sonnenschutz/elektrischer-gurtwickler/rollotron-dect-1213 ## Troubleshooting