# Sonoff TRVZB

## Informations sur l'appareil

Cette vanne thermostatique est la vanne recommandée pour Versatile Thermostat. Nous recommandons de l'utiliser avec Zigbee2MQTT.

## Contrôle direct de la vanne

### Configuration de l'appareil

1. Créez un _VTherm_ `over_climate` sur l'entité `climate` du TRV, avec l'auto-régulation [`Contrôle direct de la vanne`](https://www.versatile-thermostat.org/fr/docs/self-regulation/#auto-régulation-par-contrôle-direct-de-la-vanne). Laissez décochée l'option `Compenser la température interne du sous-jacent`.
2. Dans la configuration de la régulation par vanne, sélectionnez les entités `number` du TRV : `opening_degree` pour l'ouverture et `closing_degree` pour la fermeture. Ces entités peuvent être masquées ou désactivées par défaut dans Zigbee2MQTT ou ZHA : activez-les d'abord.
3. Pour aligner le thermomètre interne du TRV sur la température de la pièce, activez la [synchronisation de la température de l'appareil](https://www.versatile-thermostat.org/fr/docs/feature-sync_device_temp/), avec son entité de calibrage ou son entité `external_temperature_input`.
4. N'activez l'entité `Follow underlying temp change` du _VTherm_ qu'après avoir vérifié que cette configuration de base fonctionne (voir [suivre les changements de température du sous-jacent](https://www.versatile-thermostat.org/fr/docs/over-climate/#suivre-les-changements-de-température-du-sous-jacent)).

### Calibrage

Avec le contrôle direct de la vanne (`over_valve` ou `over_climate` avec `auto_regulation_valve`), le *Seuil de régulation* doit être spécifié **en pourcentage** et **ne doit pas être inférieur à 3 %** :

> [!IMPORTANT]
> Avec un seuil plus bas, le calibrage peut être perdu.

Si le calibrage a été perdu, vous pouvez le restaurer avec le [service de recalibrage des vannes](https://www.versatile-thermostat.org/fr/docs/feature-recalibrate-valves/) (`recalibrate_valves`).

Voir [auto-régulation](https://www.versatile-thermostat.org/fr/docs/self-regulation/) pour plus de détails sur ces réglages.

## État de compatibilité

- **Supporté**: Cet appareil est utilisé directement par le mainteneur ou un contributeur de Versatile Thermostat, ou a fait l’objet de tests approfondis. Appareils : Sonoff - TRVZB

## Configuration VTherm

### Initialisation

Allez dans vos paramètres puis intégration puis cliquez sur ajouter une nouvelle intégration. Cherchez Versatile Thermostat.

Cliquez sur Thermostat sur un autre thermostat.

### Attributs de base

Rentrez dans la section "Principaux attributs".

1. Choisissez un nom pour votre thermostat
2. Mettez le capteur de température pour votre pièce
3. Si vous utilisez le protocole Zigbee et vous avez une entité "last_seen" pour votre capteur de température, renseignez le.

Vous pouvez valider et revenir au menu de configuration.

### Sous-jacents

Rentrez dans la section sous-jacents.

1. Ajouter les thermostats qui seront contrôlés
2. Dans la section auto-régulation, choisissez "controle direct de la vanne"

Vous pouvez valider et revenir au menu de configuration.

## Références communautaires

Les références complémentaires peuvent être vieilles. Un bug reporté sur une ancienne version de VTherm peut avoir été corrigé sur une version plus récente.

- [#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)
