# Sonoff TRVZB

## Geräteinformationen

Dieses TRV ist das empfohlene Modell für Versatile Thermostat. Wir empfehlen, es mit Zigbee2MQTT zu verwenden.

## Direkte Ventilsteuerung

### Gerätekonfiguration

1. Erstellen Sie ein _VTherm_ `over_climate` auf der `climate`-Entity des TRV, mit der Selbstregulierung [`Direkte Ventilsteuerung`](https://www.versatile-thermostat.org/de/docs/self-regulation/#selbstregulierung-bei-direkter-ventilkontrolle). Lassen Sie die Option `Interne Bezugstemperatur ausgleichen` deaktiviert.
2. Wählen Sie in der Konfiguration der Ventilregelung die `number`-Entities des TRV: `opening_degree` für die Öffnung und `closing_degree` für die Schließung. Diese Entities können in Zigbee2MQTT oder ZHA standardmäßig ausgeblendet oder deaktiviert sein: Aktivieren Sie sie zuerst.
3. Um das interne Thermometer des TRV an die Raumtemperatur anzugleichen, aktivieren Sie die [Synchronisierung der Gerätetemperatur](https://www.versatile-thermostat.org/de/docs/feature-sync_device_temp/), mit seiner Kalibrierungs-Entity oder seiner Entity `external_temperature_input`.
4. Schalten Sie die Entity `Follow underlying temp change` des _VTherm_ erst ein, nachdem Sie geprüft haben, dass diese Grundkonfiguration funktioniert (siehe [Verfolgung verknüpfter Temperaturänderungen](https://www.versatile-thermostat.org/de/docs/over-climate/#verfolgung-verknüpfter-temperaturänderungen)).

### Kalibrierung

Bei einer direkten Ventilregelung (`over_valve` oder `over_climate` mit `auto_regulation_valve`) muss die *Regelschwelle* **in Prozent** angegeben werden und **darf nicht unter 3 % liegen**:

> [!IMPORTANT]
> Bei einem niedrigeren Schwellenwert kann der Sonoff TRVZB seine Kalibrierung verlieren.

Ist die Kalibrierung verloren gegangen, kann sie mit dem [Dienst zur Ventilkalibrierung](https://www.versatile-thermostat.org/de/docs/feature-recalibrate-valves/) (`recalibrate_valves`) wiederhergestellt werden.

Weitere Informationen zu diesen Einstellungen finden Sie unter [Selbstregulierung](https://www.versatile-thermostat.org/de/docs/self-regulation/).

## Kompatibilitätsstatus

- **Unterstützt**: Dieses Gerät wird direkt vom Maintainer oder einem Mitwirkenden von Versatile Thermostat verwendet oder wurde ausführlich getestet. Geräte: Sonoff - TRVZB

## VTherm-Konfiguration

### Initialisierung

Gehe zu Einstellungen, dann zu Integrationen und dort "neue Integration hinzufügen" anklicken. Suche nach Versatile Thermostat.

Klicken auf VTherm auf Thermostat.

### Grundeinstellungen

Gehe zum Abschnitt "Hauptattribute".

1. Wähle einen Namen für das Thermostat
2. Stelle den Temperatursensor des Raumes ein
3. Wenn das Zigbee-Protokoll verwendet wird und eine "last_seen"-Entität für den Temperatursensor vorhanden ist, diesen dann bitte eintragen.

Eingabe bestätigen und zum Konfigurationsmenü zurückkehren.

### Gerätezuordnung

Gehe zum Abschnitt Gerätezuordnung.

1. Die zu steuernden Thermostate hinzufügen
2. Im Abschnitt Selbstregelung "direkte Ventilsteuerung" anwählen

Eingabe bestätigen und zum Konfigurationsmenü zurückkehren.

## Community-Referenzen

Zusätzliche Referenzen können alt sein. Ein in einer alten Version von VTherm gemeldeter Fehler wurde möglicherweise in einer neueren Version behoben.

- [#645 \[Feature request\] Add native support of Sonoff TRVZB valve in VTherm](https://github.com/jmcollin78/versatile_thermostat/issues/645)
- [#902 Sonoff TRVZB workaround to the 'hvac_action' always Idle issue](https://github.com/jmcollin78/versatile_thermostat/issues/902)
- [#1456 SONOFF TRVZB - losing valve calibration v2](https://github.com/jmcollin78/versatile_thermostat/issues/1456)
- [#1554 \[Feature Request\] - Add a max opening degree for direct valve control](https://github.com/jmcollin78/versatile_thermostat/issues/1554)
- [#1656 \[Feature Request\] - Add a recalibration service (action)](https://github.com/jmcollin78/versatile_thermostat/issues/1656)
- [#1727 Phyiscal valve still open, while VTherm shows 0% open](https://github.com/jmcollin78/versatile_thermostat/issues/1727)
- [#1943 Recalibirate is not working - V-Thermostat keeps heating even though it is set to 0% (Auto TPI activated, Sonoff TRVZB)](https://github.com/jmcollin78/versatile_thermostat/issues/1943)
- [#2077 Sleep/Maintenance Mode Issue](https://github.com/jmcollin78/versatile_thermostat/issues/2077)
- [Discussion #961 Sonoff TRVZB calibration is lost](https://github.com/jmcollin78/versatile_thermostat/discussions/961)
- [Discussion #1691 TPI output is linear, but TRV valve behavior is intentionally non-linear](https://github.com/jmcollin78/versatile_thermostat/discussions/1691)