Skip to content

Commit c8803b4

Browse files
committed
Add watchdog defer, mqtt batterymode
1 parent ef346f6 commit c8803b4

4 files changed

Lines changed: 20 additions & 0 deletions

File tree

docs/devices/plugins.mdx

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1334,6 +1334,7 @@ Das Watchdog-Plugin überwacht Schreibvorgänge und wiederholt diese automatisch
13341334
| timeout | duration | ja | Zeitintervall für Wiederholungen (Wert wird alle timeout/2 erneut geschrieben) |
13351335
| reset | string \| [string] | nein | Wert(e), bei denen Wiederholungen gestoppt werden |
13361336
| initial | string | nein | Wert, der beim Start einmalig geschrieben wird |
1337+
| defer | bool | nein | Verzögert Updates statt sie sofort auszuführen (Standard: false) |
13371338
| set | config | ja | Verschachteltes Plugin für den eigentlichen Schreibvorgang |
13381339

13391340
**Funktionsweise**:
@@ -1355,6 +1356,14 @@ Das Watchdog-Plugin überwacht Schreibvorgänge und wiederholt diese automatisch
13551356
- Nützlich, um einen definierten Startzustand zu setzen
13561357
- Wird vor allen anderen Schreibvorgängen ausgeführt
13571358

1359+
**defer Parameter**:
1360+
1361+
- Stellt sicher, dass Timeouts zwischen Updates eingehalten werden
1362+
- Der Watchdog wird während der Verzögerung gestoppt und nach Ablauf mit dem neuen Wert neu gestartet
1363+
- Sinnvoll wenn Geräte eine Mindestwartezeit zwischen Modusänderungen benötigen
1364+
- Die Verzögerung wird basierend auf der Zeit seit dem letzten Update berechnet
1365+
- Reset-Werte werden immer sofort (ohne Verzögerung) geschrieben
1366+
13581367
**Unterstützte Datentypen**: `int64`, `float64`, `bool`
13591368

13601369
**Beispiel Schreiben**:

docs/integrations/mqtt-api.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -26,6 +26,7 @@ Alle API IDs (z. B. die Loadpoint ID) beginnen bei `1`.
2626
- `evcc/site/residualPower`: grid residual power (writable)
2727
- `evcc/site/batteryGridChargeLimit`: smart charging cost limit (previously known as "cheap" tariff) (writable)
2828
- `evcc/site/batteryDischargeControl`: enable/disable battery discharge control (true/false) (writable)
29+
- `evcc/site/batteryMode`: external battery mode (writable: `normal`, `hold`, `charge`) - directly controls all controllable batteries, overrules other evcc modes, resets after 60s
2930

3031
## Vehicles
3132

i18n/en/docusaurus-plugin-content-docs/current/devices/plugins.mdx

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1334,6 +1334,7 @@ The watchdog plugin monitors write operations and automatically repeats them at
13341334
| timeout | duration | yes | Time interval for repetitions (value is rewritten every timeout/2) |
13351335
| reset | string \| [string] | no | Value(s) at which repetitions are stopped |
13361336
| initial | string | no | Value that is written once at startup |
1337+
| defer | bool | no | Defers updates instead of executing them immediately (default: false) |
13371338
| set | config | yes | Nested plugin for the actual write operation |
13381339

13391340
**How it works**:
@@ -1355,6 +1356,14 @@ The watchdog plugin monitors write operations and automatically repeats them at
13551356
- Useful for setting a defined initial state
13561357
- Executed before all other write operations
13571358

1359+
**defer parameter**:
1360+
1361+
- Ensures that timeouts between updates are respected
1362+
- The watchdog is stopped during the delay and restarted with the new value after expiry
1363+
- Useful when devices require a minimum wait time between mode changes
1364+
- The delay is calculated based on the time since the last update
1365+
- Reset values are always written immediately (without delay)
1366+
13581367
**Supported data types**: `int64`, `float64`, `bool`
13591368

13601369
**Example Write**:

i18n/en/docusaurus-plugin-content-docs/current/integrations/mqtt-api.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -26,6 +26,7 @@ All API IDs (e.g. the loadpoint ID) begin at `1`.
2626
- `evcc/site/residualPower`: grid residual power (writable)
2727
- `evcc/site/batteryGridChargeLimit`: smart charging cost limit (previously known as "cheap" tariff) (writable)
2828
- `evcc/site/batteryDischargeControl`: enable/disable battery discharge control (true/false) (writable)
29+
- `evcc/site/batteryMode`: external battery mode (writable: `normal`, `hold`, `charge`) - directly controls all controllable batteries, overrules other evcc modes, resets after 60s
2930

3031
## Vehicles
3132

0 commit comments

Comments
 (0)