jeans/home-assistant.io
jeans/home-assistant.io
1
0
Fork 0
mirror of https://github.com/home-assistant/home-assistant.io.git synced 2025-07-18 23:06:58 +00:00
Code Issues Packages Projects Releases Wiki Activity

Some improvements to the AVM FRITZ!Smarthome docs (#39997)

Browse Source 
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
This commit is contained in:
Michael 2025-07-14 10:10:13 +02:00 committed by GitHub
parent 2da6d99925
commit 75ee5a4ff5
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
1 changed files with 45 additions and 42 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

87
source/_integrations/fritzbox.markdown
View File

@ -28,30 +28,38 @@ ha_codeowners:
ha_integration_type: hub 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 #### Tested devices
- [FRITZ!Box 5590 Fiber][fritzbox_5590_fiber] - FRITZ!Box routers
- FRITZ!Box 6490 Cable - [FRITZ!Box 5590 Fiber][fritzbox_5590_fiber]
- [FRITZ!Box 6591 Cable][fritzbox_6591_cable] - FRITZ!Box 6490 Cable
- [FRITZ!Box 7590][fritzbox_7590] - FRITZ!Box 6591 Cable
- [FRITZ!Box 7590 AX][fritzbox_7590_ax] - FRITZ!Box 7590
- [FRITZ!Box 7530 AX][fritzbox_7530_ax] - FRITZ!Box 7490
- FRITZ!Box 7490 - FRITZ!Box 7430
- FRITZ!Box 7430 - [FRITZ!Box 7590 AX][fritzbox_7590_ax]
- [FRITZ!DECT 200][fritzdect_200] - [FRITZ!Box 7530 AX][fritzbox_7530_ax]
- [FRITZ!DECT 210][fritzdect_210] - [FRITZ!Smart Gateway][fritz_smart_gateway]
- [FRITZ!DECT 301][fritzdect_301] - FRITZ!SmartHome devices
- [FRITZ!DECT 302][fritzdect_302] - [FRITZ!Smart Energy 200][fritzdect_200] (_former FRITZ!DECT 200_)
- [FRITZ!DECT 500][fritzdect_500] - [FRITZ!Smart Energy 210][fritzdect_210] (_former FRITZ!DECT 210_)
- [Eurotronic Comet DECT][eurotronic_comet_dect] - FRITZ!Smart Thermo 301 (_former FRITZ!DECT 301_)
- [Magenta SmartHome LED E27 Color][magenta_led_e27_color] - [FRITZ!Smart Thermo 302][fritzdect_302] (_former FRITZ!DECT 302_)
- Magenta SmartHome LED E27 warmwhite - FRITZ!DECT 500
- [Rademacher RolloTron DECT 1213][rademacher_rollotron_dect_1213] - 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 ## 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. 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 %} {% note %}
@ -64,28 +72,28 @@ If you still want to use the predefined user, please note that as of FRITZ!OS 7.
Host: Host:
description: "The hostname or IP address of your FRITZ!Box router." description: "The hostname or IP address of your FRITZ!Box router."
Username: 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: 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 %} {% endconfiguration_basic %}
## Data fetching and limitations ## 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 ## Devices
### Light bulbs ### 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 %} {% 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 %} {% endnote %}
### Plugs ### 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: 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
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 ### 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
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: 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 ### 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: 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 - Open window detected
- Temperature - Temperature
[fritzbox_5590_fiber]: https://en.avm.de/products/fritzbox/fritzbox-5590-fiber [fritzbox_5590_fiber]: https://en.fritz.com/products/fritzbox/fritzbox-5590-fiber
[fritzbox_6591_cable]: https://en.avm.de/products/fritzbox/fritzbox-6591-cable [fritzbox_7590_ax]: https://en.fritz.com/products/fritzbox/fritzbox-7590-ax
[fritzbox_7590]: https://en.avm.de/products/fritzbox/fritzbox-7590 [fritzbox_7530_ax]: https://en.fritz.com/products/fritzbox/fritzbox-7530-ax
[fritzbox_7590_ax]: https://en.avm.de/products/fritzbox/fritzbox-7590-ax [fritzdect_200]: https://en.fritz.com/products/smart-home/fritzsmart-energy-200
[fritzbox_7530_ax]: https://en.avm.de/products/fritzbox/fritzbox-7530-ax [fritzdect_210]: https://en.fritz.com/products/smart-home/fritzsmart-energy-210
[fritzdect_200]: https://en.avm.de/products/smart-home/fritzdect-200 [fritzdect_302]: https://en.fritz.com/products/smart-home/fritzsmart-thermo-302
[fritzdect_210]: https://en.avm.de/products/smart-home/fritzdect-210 [fritzdect_350]: https://en.fritz.com/products/smart-home/fritzsmart-control-350
[fritzdect_301]: https://en.avm.de/products/smart-home/fritzdect-301 [fritzdect_440]: https://en.fritz.com/products/smart-home/fritzsmart-control-440
[fritzdect_302]: https://en.avm.de/products/smart-home/fritzdect-302 [fritz_smart_gateway]: https://en.fritz.com/products/smart-home/fritzsmart-gateway
[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
[rademacher_rollotron_dect_1213]: https://www.rademacher.de/shop/rollladen-sonnenschutz/elektrischer-gurtwickler/rollotron-dect-1213 [rademacher_rollotron_dect_1213]: https://www.rademacher.de/shop/rollladen-sonnenschutz/elektrischer-gurtwickler/rollotron-dect-1213
## Troubleshooting ## Troubleshooting