From f0782d9aa4a0c799fb3d1dfa2753a70e83d9f5d5 Mon Sep 17 00:00:00 2001 From: Anatosun Date: Thu, 4 Jun 2026 21:21:17 +0200 Subject: [PATCH 1/6] Swisscom: updated documentation --- source/_integrations/swisscom.markdown | 79 ++++++++++++++++++-------- 1 file changed, 55 insertions(+), 24 deletions(-) diff --git a/source/_integrations/swisscom.markdown b/source/_integrations/swisscom.markdown index 267078798f18..d20ae8e65579 100644 --- a/source/_integrations/swisscom.markdown +++ b/source/_integrations/swisscom.markdown @@ -1,41 +1,72 @@ --- title: Swisscom Internet-Box -description: Instructions on how to integrate Swisscom Internet-Box into Home Assistant. +description: Instructions on how to integrate the Swisscom Internet-Box into Home Assistant. ha_category: - Presence detection ha_release: 0.32 ha_domain: swisscom ha_iot_class: Local Polling +ha_config_flow: true ha_platforms: - device_tracker -ha_integration_type: integration -related: - - docs: /docs/configuration/ - title: Configuration file +ha_integration_type: hub ha_quality_scale: legacy +related: + - docs: /integrations/device_tracker/ + title: Device tracker --- -The **Swisscom Internet-Box** {% term integration %} offers presence detection by looking at connected devices to an [Internet-Box](https://www.swisscom.ch/en/residential/help/device/internet-router.html) router from [Swisscom](https://www.swisscom.ch) which is an Internet provider in Switzerland. +The **Swisscom Internet-Box** {% term integration %} offers presence detection by looking at the devices connected to your [Internet-Box](https://www.swisscom.ch/en/residential/help/device/internet-router.html) router. The Internet-Box is the router provided by [Swisscom](https://www.swisscom.ch), an Internet provider in Switzerland. + +With this integration, you can use the presence of phones, tablets, and other devices on your home network to trigger automations. For example, you can turn the lights off when everyone leaves home, or send a notification when someone arrives. + +## Supported devices + +The following Internet-Box models are supported: + +- Internet-Box light +- Internet-Box standard +- Internet-Box plus + +All models share the same web interface, so they work the same way with this integration. + +## Prerequisites + +To set up the integration, you need the following: + +- The IP address of your Internet-Box. By default, this is `192.168.1.1`. +- The administrator password for your Internet-Box. This is the password you use to sign in to the router's web interface. + +{% include integrations/config_flow.md %} + +{% configuration_basic %} +Host: +description: "The IP address of your Internet-Box. By default, this is `192.168.1.1`." +Username: +description: "The administrator username for your Internet-Box. By default, this is `admin`." +Password: +description: "The administrator password for your Internet-Box. This is the password you use to sign in to the router's web interface." +{% endconfiguration_basic %} + +## Supported functionality + +The integration creates a {% term "device tracker" %} entity for each device known to your Internet-Box. Each entity reports whether the device is currently connected to your network, along with the following attributes: + +- Hostname +- IP address +- MAC address + +You can use these entities to track the presence of people in your home. For more information on how to assign tracked devices to people, see the [device tracker integration page](/integrations/device_tracker/). + +## Data updates -{% note %} -There are three models of Internet-Box (light, standard and plus). The platform has only been tested on the Internet-Box plus but the others should work as well because they have the same web interface. -{% endnote %} +Home Assistant {% term polling polls %} your Internet-Box every 30 seconds to retrieve the list of connected devices and update their connection status. -To use an Internet-Box router in your installation, add the following to your {% term "`configuration.yaml`" %} file. -{% include integrations/restart_ha_after_config_inclusion.md %} +## Troubleshooting -```yaml -# Example configuration.yaml entry -device_tracker: - - platform: swisscom -``` +If the setup fails or the integration stops working, check the following: -{% configuration %} -host: - description: The IP address of your router. - required: false - default: 192.168.1.1 - type: string -{% endconfiguration %} +- Make sure the IP address of your Internet-Box is correct and reachable from Home Assistant. +- Make sure the administrator password is correct. The integration signs in to your Internet-Box to read the list of connected devices, so it needs valid administrator credentials. -See the [device tracker integration page](/integrations/device_tracker/) for instructions how to configure the people to be tracked. +{% include integrations/remove_device_service.md %} From f8eea6fc9c21b29bc6753882dd23be4f401e8113 Mon Sep 17 00:00:00 2001 From: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> Date: Fri, 5 Jun 2026 07:30:24 +0200 Subject: [PATCH 2/6] fix indentation to fix build --- source/_integrations/swisscom.markdown | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/source/_integrations/swisscom.markdown b/source/_integrations/swisscom.markdown index d20ae8e65579..239dc0b710ce 100644 --- a/source/_integrations/swisscom.markdown +++ b/source/_integrations/swisscom.markdown @@ -41,11 +41,11 @@ To set up the integration, you need the following: {% configuration_basic %} Host: -description: "The IP address of your Internet-Box. By default, this is `192.168.1.1`." + description: "The IP address of your Internet-Box. By default, this is `192.168.1.1`." Username: -description: "The administrator username for your Internet-Box. By default, this is `admin`." + description: "The administrator username for your Internet-Box. By default, this is `admin`." Password: -description: "The administrator password for your Internet-Box. This is the password you use to sign in to the router's web interface." + description: "The administrator password for your Internet-Box. This is the password you use to sign in to the router's web interface." {% endconfiguration_basic %} ## Supported functionality From 12ded043239590ff6ad347bea49b8aa094aad315 Mon Sep 17 00:00:00 2001 From: Anatosun <33899455+anatosun@users.noreply.github.com> Date: Fri, 5 Jun 2026 12:39:30 +0200 Subject: [PATCH 3/6] Update source/_integrations/swisscom.markdown Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> --- source/_integrations/swisscom.markdown | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/source/_integrations/swisscom.markdown b/source/_integrations/swisscom.markdown index 239dc0b710ce..ae3206b52d9d 100644 --- a/source/_integrations/swisscom.markdown +++ b/source/_integrations/swisscom.markdown @@ -48,6 +48,16 @@ Password: description: "The administrator password for your Internet-Box. This is the password you use to sign in to the router's web interface." {% endconfiguration_basic %} +## Migrating from YAML configuration + +If you previously configured the Swisscom Internet-Box through `configuration.yaml`: + +1. Set up the integration through the UI to provide your administrator credentials. +2. Remove the `device_tracker` Swisscom entry from your `configuration.yaml` file. +3. Restart Home Assistant. + +A repair issue in {% my integrations title="**Settings** > **Devices & services**" %} will guide you through the same steps. + ## Supported functionality The integration creates a {% term "device tracker" %} entity for each device known to your Internet-Box. Each entity reports whether the device is currently connected to your network, along with the following attributes: From 984889c182281bfe5816c7b0e6caf887278c24b9 Mon Sep 17 00:00:00 2001 From: Anatosun <33899455+anatosun@users.noreply.github.com> Date: Fri, 5 Jun 2026 12:41:04 +0200 Subject: [PATCH 4/6] Update source/_integrations/swisscom.markdown Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> --- source/_integrations/swisscom.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_integrations/swisscom.markdown b/source/_integrations/swisscom.markdown index ae3206b52d9d..a6692171ce06 100644 --- a/source/_integrations/swisscom.markdown +++ b/source/_integrations/swisscom.markdown @@ -10,7 +10,7 @@ ha_config_flow: true ha_platforms: - device_tracker ha_integration_type: hub -ha_quality_scale: legacy +ha_quality_scale: bronze related: - docs: /integrations/device_tracker/ title: Device tracker From 747942f4879049ae559191bf80208d95843bf0d4 Mon Sep 17 00:00:00 2001 From: Anatosun <33899455+anatosun@users.noreply.github.com> Date: Fri, 5 Jun 2026 12:41:19 +0200 Subject: [PATCH 5/6] Update source/_integrations/swisscom.markdown Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> --- source/_integrations/swisscom.markdown | 1 + 1 file changed, 1 insertion(+) diff --git a/source/_integrations/swisscom.markdown b/source/_integrations/swisscom.markdown index a6692171ce06..652485f2c7a7 100644 --- a/source/_integrations/swisscom.markdown +++ b/source/_integrations/swisscom.markdown @@ -35,6 +35,7 @@ All models share the same web interface, so they work the same way with this int To set up the integration, you need the following: - The IP address of your Internet-Box. By default, this is `192.168.1.1`. +- The administrator username. By default, this is `admin`. - The administrator password for your Internet-Box. This is the password you use to sign in to the router's web interface. {% include integrations/config_flow.md %} From bd0f34d88e60a3bf22cd96a1cc901b5355f2c11d Mon Sep 17 00:00:00 2001 From: Anatosun <33899455+anatosun@users.noreply.github.com> Date: Fri, 5 Jun 2026 12:41:32 +0200 Subject: [PATCH 6/6] Update source/_integrations/swisscom.markdown Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> --- source/_integrations/swisscom.markdown | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/source/_integrations/swisscom.markdown b/source/_integrations/swisscom.markdown index 652485f2c7a7..c1b59daacf5a 100644 --- a/source/_integrations/swisscom.markdown +++ b/source/_integrations/swisscom.markdown @@ -80,4 +80,9 @@ If the setup fails or the integration stops working, check the following: - Make sure the IP address of your Internet-Box is correct and reachable from Home Assistant. - Make sure the administrator password is correct. The integration signs in to your Internet-Box to read the list of connected devices, so it needs valid administrator credentials. + +## Removing the integration + +This integration follows standard integration removal. + {% include integrations/remove_device_service.md %}