Skip to content

Commit

Permalink
Add KNX integration removal instructions (#36800)
Browse files Browse the repository at this point in the history
* Add KNX integration removal instructions

* Use more terms

* add missing logger information

* tiny tweaks

---------

Co-authored-by: c0ffeeca7 <[email protected]>
  • Loading branch information
farmio and c0ffeeca7 authored Jan 8, 2025
1 parent 79aa1da commit 5c052e6
Showing 1 changed file with 24 additions and 9 deletions.
33 changes: 24 additions & 9 deletions source/_integrations/knx.markdown
Original file line number Diff line number Diff line change
Expand Up @@ -416,7 +416,7 @@ automation:

### Register event

The `knx.event_register` action can be used to register (or unregister) group addresses to fire `knx_event` Events. Events for group addresses configured in the `event` key in `configuration.yaml` cannot be unregistered. See [knx_event](#events)
The `knx.event_register` action can be used to register (or unregister) group addresses to fire `knx_event` Events. Events for group addresses configured in the `event` key in {% term "`configuration.yaml`" %} cannot be unregistered. See [knx_event](#events)

{% configuration %}
address:
Expand All @@ -436,7 +436,7 @@ type:

### Register exposure

The `knx.exposure_register` action can be used to register (or unregister) exposures to the KNX bus. Exposures defined in `configuration.yaml` can not be unregistered. Per address only one exposure can be registered. See [expose](#exposing-entity-states-entity-attributes-or-time-to-knx-bus)
The `knx.exposure_register` action can be used to register (or unregister) exposures to the KNX bus. Exposures defined in {% term "`configuration.yaml`" %} can not be unregistered. Per address only one exposure can be registered. See [expose](#exposing-entity-states-entity-attributes-or-time-to-knx-bus)

{% configuration %}
remove:
Expand Down Expand Up @@ -740,7 +740,7 @@ entity_category:

The KNX climate platform is used as an interface to KNX thermostats and room controllers.

To use your KNX thermostats in your installation, add the following lines to your top level [KNX Integration](/integrations/knx) configuration key in `configuration.yaml`:
To use your KNX thermostats in your installation, add the following lines to your top level [KNX Integration](/integrations/knx) configuration key in {% term "`configuration.yaml`" %}:

```yaml
# Example configuration.yaml entry
Expand Down Expand Up @@ -1017,7 +1017,7 @@ Unlike most KNX devices, Home Assistant defines 0% as closed and 100% as fully o
Home Assistant will, by default, `close` a cover by moving it in the `DOWN` direction in the KNX nomenclature, and `open` a cover by moving it in the `UP` direction.
{% endnote %}

To use your KNX covers in your installation, add the following lines to your top level [KNX Integration](/integrations/knx) configuration key in `configuration.yaml`:
To use your KNX covers in your installation, add the following lines to your top level [KNX Integration](/integrations/knx) configuration key in your {% term "`configuration.yaml`" %}:

```yaml
# Example configuration.yaml entry
Expand Down Expand Up @@ -1243,7 +1243,7 @@ The KNX fan integration is used to control KNX fans. Following control types are
- Percentage controlled: Fans that set the percentage directly from 0-100%.
- Step controlled: Fans which have a fixed amount of steps to set. The integration will convert percentage to step automatically. The `max_step` attribute is set to the number of steps of the fan, not counting the `off`-step. Example: A fan supports the steps 0 to 3. To use this fan the `max_step` attribute has to be set to `3`. The integration will convert the percentage `66 %` to the step `2` when sending data to KNX.

To use your KNX fan in your installation, add the following lines to your top level [KNX Integration](/integrations/knx) configuration key in `configuration.yaml`:
To use your KNX fan in your installation, add the following lines to your top-level [KNX Integration](/integrations/knx) configuration key in your {% term "`configuration.yaml`" %}:

```yaml
# Example configuration.yaml entry
Expand Down Expand Up @@ -1788,7 +1788,7 @@ knx:
type: percent
```

In order to actively read the sensor data from the bus every 30 minutes you can add the following lines to your `configuration.yaml`:
In order to actively read the sensor data from the bus every 30 minutes you can add the following lines to your {% term "`configuration.yaml`" %}:

```yaml
# Example configuration.yaml entry
Expand Down Expand Up @@ -2225,7 +2225,7 @@ entity_category:

The KNX weather platform is used as an interface to KNX weather stations.

To use your KNX weather station in your installation, add the following lines to your top level [KNX Integration](/integrations/knx) configuration key in `configuration.yaml`:
To use your KNX weather station in your installation, add the following lines to your top-level [KNX Integration](/integrations/knx) configuration key in your {% term "`configuration.yaml`" %}:

```yaml
# Example configuration.yaml entry
Expand Down Expand Up @@ -2334,8 +2334,8 @@ entity_category:

### Logs for the KNX integration

`xknx`, the library used for KNX communication, provides various logging handlers for monitoring and debug purposes.
Add the following lines to your Home Assistant `configuration.yaml` to activate them:
The [`xknx` library](https://github.com/XKNX/xknx) is used for KNX communication. It provides various logging handlers for monitoring and debug purposes.
Add the following lines to your Home Assistant {% term "`configuration.yaml`" %} to activate them:

```yaml
logger:
Expand All @@ -2352,6 +2352,7 @@ logger:
xknx.knx: debug # logs incoming and outgoing KNX/IP frames
xknx.raw_socket: warning # logs incoming UDP/TCP frames in raw hex format at socket level
# Loggers for xknx internals
xknx.ga_dpt: warning # logs when payloads can't be decoded with given project file information
xknx.state_updater: warning # provides information about the state updater
```
Expand Down Expand Up @@ -2403,3 +2404,17 @@ The `unique_id` for KNX entities is generated based on required configuration va
- weather: `address_temperature`

There can not be multiple entities on the same platform sharing these exact group addresses, even if they differ in other configuration.

## Remove integration

This integration can be removed by following these steps:

{% include integrations/remove_device_service.md %}

In addition, remove `knx:` from your {% term "`configuration.yaml`" %}.

{% warning %}

Removing the integration will delete an uploaded keyring file, ETS project information, telegram history, and all entity configuration done via the UI panel.

{% endwarning %}

0 comments on commit 5c052e6

Please sign in to comment.