From e9dc3cf8e6b51bb097e842b7aaed6b26a9540620 Mon Sep 17 00:00:00 2001
From: docolli <78646938+docolli@users.noreply.github.com>
Date: Sat, 25 Apr 2026 14:13:49 +0200
Subject: [PATCH] chore: update 'scale' parameter and relay usage description
 (#29382)

---
 templates/definition/charger/ac-thor.yaml | 18 +++++++++++++++---
 1 file changed, 15 insertions(+), 3 deletions(-)

diff --git a/templates/definition/charger/ac-thor.yaml b/templates/definition/charger/ac-thor.yaml
index 9edab3929..538b6aa16 100644
--- a/templates/definition/charger/ac-thor.yaml
+++ b/templates/definition/charger/ac-thor.yaml
@@ -9,8 +9,20 @@ products:
 group: heating
 requirements:
   description:
-    de: Über das lokale Webinterface des AC•THOR muss der Wert für die "Zeitablauf Ansteuerung" auf einen Wert etwas größer der Intervall Zeit von evcc (z.B. + 5s) gesetzt werden.
-    en: Use the local web interface of AC•THOR to set the value "Power timeout" to a value slightly higher (e.g. + 5s) than the interval time of evcc.
+    de: |
+      Über das lokale Webinterface des AC•THOR muss der Wert für die "Zeitablauf Ansteuerung" auf einen Wert etwas größer der Intervall Zeit von evcc (z.B. + 5s) gesetzt werden.
+      Hat der Heizstab am geregelten Ausgang < 9 kW muss der Skalierungsfaktor wie folgt berechnet und gesetzt werden: `scale = 9000 / Nennleistung` des angeschlossenen Heizstabs. 
+
+      Die Betriebsart M3: 9 + 9 kW mit einem zusätzlichen Heizstab am Relais-Ausgang wird unterstützt. Ohne Lastmessung mittels my-PV Meter muss "Last am Relais" im lokalen Webinterface des AC•THOR passend zur Nennleistung des Heizstabs am Relais gesetzt werden.
+      Hat der Heizstab am geregelten Ausgang < 9 kW ist AC•THOR Firmware a0022200 oder höher erforderlich und der Wert für "Last am Relais" muss folgendermaßen mit dem Skalierungsfaktor umgerechnet werden:
+      Last am Relais = Nennleistung des Heizstabs am Relais * Skalierungsfaktor
+    en: |
+      Use the local web interface of AC•THOR to set the value "Power timeout" to a value slightly higher (e.g. + 5s) than the interval time of evcc.
+      If the heating element at the controlled output has <9kW, the scaling factor has to be calculated as follows: `scale = 9000 / nominal power` of the connected heater.
+
+      Operation mode M3: 9 + 9 kW with an additional heater connected to the relay output is supported. Without load measurement using my-PV meter, the "Load at relay" setting in the local web interface of the AC•THOR must be set to match the nominal power of the heating element at the relay.
+      If the heater at the controlled output has <9kW, AC•THOR firmware a0022200 or higher is required and the value for "Load at relay" must be converted using the scaling factor as follows:
+      Load at relay = nominal power of the heater at the relay * scale factor
   evcc: ["sponsorship"]
 params:
   - name: modbus
@@ -22,8 +34,8 @@ params:
     type: float
     default: 1
     description:
-      en: "Scale factor for power limit"
       de: "Skalierungsfaktor der Leistungsvorgabe"
+      en: "Scale factor for power target value"
 render: |
   type: ac-thor
   {{- include "modbus" . }}