Skip to content

fix: documentation to use 'features' flag #812

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 3 commits into from
May 30, 2025
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions docs/devices/smartswitches.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -97,12 +97,12 @@ Dies ist natürlich auch automatisiert via API möglich (bspw. jede Nacht).
Standardmäßig bieten Ladepunkte die Möglichkeit einer Fahrzeugzuordnung.
In vielen Szenarien ist das jedoch nicht erwünscht.
Es ergibt wenig Sinn den Tesla mit dem SG-Ready-Kontakt einer Wärmepumpe zu verbinden.
Über den Parameter `integrateddevice: true` deaktivierst du die manuelle Zuordnung von Fahrzeugen in der UI.
Über das `features`-Flag `integrateddevice` deaktivierst du die manuelle Zuordnung von Fahrzeugen in der UI.
Zusätzlich wird die automatische Fahrzeugerkennung für diesen Ladepunkt deaktiviert.

### Wärmeerzeugung

Nutzt du den Schalter zur Steuerung eines Wärmeerzeugers solltest du den Parameter `heating: true` setzen.
Nutzt du den Schalter zur Steuerung eines Wärmeerzeugers solltest du das `features`-Flag `heating` setzen.
Dadurch verändert sich die Darstellung in der UI.
Es werden die Begriffe "heizen" anstatt "laden" verwendet.
Zudem wird der `soc` des Chargers (sofern verfügbar) nicht mehr in % sondern als Temperatur in °C angezeigt.
Expand Down
6 changes: 4 additions & 2 deletions docs/reference/configuration/chargers.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -60,7 +60,8 @@ In Zusammenhang mit diesem Parameter kann auch ein Icon vergeben werden (siehe [
**Beispiel**:

```yaml
integrateddevice: true
features:
- integrateddevice
icon: bike
```

Expand All @@ -73,7 +74,8 @@ Dieser Parameter bewirkt, dass bei Ladegeräten der Gruppe "schaltbare Steckdose
**Beispiel**:

```yaml
heating: true
features:
- heating
```

---
2 changes: 1 addition & 1 deletion docs/reference/configuration/loadpoints.md
Original file line number Diff line number Diff line change
Expand Up @@ -129,7 +129,7 @@ soc:

Definiert, wie die Fahrzeug APIs benutzt werden um aktuelle Informationen des Fahrzeugs abzurufen.

Ist beim Charger `integrateddevice: true` konfiguriert, werden die Daten fortlaufend abgerufen. Dann sind keine `poll` Einstellungen notwendig, bzw. diese werden ignoriert.
Ist beim Charger das `features`-Flag `integrateddevice` konfiguriert, werden die Daten fortlaufend abgerufen. Dann sind keine `poll` Einstellungen notwendig, bzw. diese werden ignoriert.

:::warning
Es wird **NICHT** empfohlen, die Standardeinstellungen zu ändern, denn dies könnte dazu führen, dass die Fahrzeugbatterie entleert wird
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -99,12 +99,12 @@ You could automate this via API (e.g. every night).
By default, charging points offer the possibility of vehicle assignment.
In many switch scenarios this is not desired.
It makes little sense to connect the Tesla to the SG-Ready contact of a heat pump.
By setting the parameter `integrateddevice: true` you disable the manual vehicle assignment in the UI.
By setting the `features`-flag `integrateddevice` you disable the manual vehicle assignment in the UI.
Additionally, the automatic vehicle detection is disabled for this charging point.

### Heating

If you use the switch to control a heat pump, you should set the parameter `heating: true`.
If you use the switch to control a heat pump, you should set the `features`-Flag `heating`.
This changes the display in the UI.
Now the status uses the word "heating" instead of "charging".
Additionally, the `soc` of the charger (if available) is no longer displayed in % but as a temperature in °C.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -60,12 +60,22 @@ In connection with this parameter, an icon can also be assigned (see [`vehicle.i
**For example**:

```yaml
integrateddevice: true
features:
- integrateddevice
icon: bike
```

---

```
### `heating`

This parameter causes the state of charge for chargers in the "switchable sockets (switchsockets)" group to be displayed in degrees instead of percent.

**Example**:

```yaml
features:
- heating
```

---