https://github.com/faizpuru/ha-pilot-wire-climate
A Home Assistant integration that simplifies managing pilot wire heating systems by converting select and power entities into a unified climate entity.
https://github.com/faizpuru/ha-pilot-wire-climate
climate hacs hacs-integration home-assistant thermostat
Last synced: 8 months ago
JSON representation
A Home Assistant integration that simplifies managing pilot wire heating systems by converting select and power entities into a unified climate entity.
- Host: GitHub
- URL: https://github.com/faizpuru/ha-pilot-wire-climate
- Owner: faizpuru
- License: mit
- Created: 2024-10-31T08:56:00.000Z (about 1 year ago)
- Default Branch: master
- Last Pushed: 2025-04-02T12:35:04.000Z (8 months ago)
- Last Synced: 2025-04-02T13:24:12.941Z (8 months ago)
- Topics: climate, hacs, hacs-integration, home-assistant, thermostat
- Language: Python
- Homepage:
- Size: 30.3 KB
- Stars: 10
- Watchers: 3
- Forks: 2
- Open Issues: 1
-
Metadata Files:
- Readme: README-fr.md
- License: LICENSE
Awesome Lists containing this project
README
# README - Intégration Fil Pilote pour Home Assistant
[](https://github.com/faizpuru/ha-pilot-wire-climate/blob/master/README.md)
[](https://github.com/faizpuru/ha-pilot-wire-climate/blob/master/README-fr.md)
## Vue d'ensemble
Cette intégration pour Home Assistant simplifie l'installation de modules fil pilote pour les systèmes de chauffage, en convertissant automatiquement plusieurs entités (`select` et `power`) en une seule entité `climate`. Une entité `sensor` de température peut également être ajoutée en option. Cette intégration est idéale pour contrôler et surveiller les modules fil pilote de chauffage.
### Caractéristiques principales
- Convertit les entités `select` et `power` en une seule entité `climate`.
- Utilise l'entité `select` pour ajuster les modes prédéfinis du fil pilote.
- Utilise l'entité `power` pour détecter si le chauffage est actif.
- Mode par défaut à l'allumage configurable.
- Seuil de puissance configurable pour déterminer l'état de chauffe.
- Prise en charge optionnelle pour une entité `sensor` de température.
### Compatibilité
L'intégration est compatible avec les appareils suivants ou tout thermostat contrôlable avec une entité de type select:
- **Equation** : SIN-4-FP-21_EQU
- **Legrand** : 064882
- **NodOn** : SIN-4-FP-20, SIN-4-FP-21
## Installation
### Option 1 : Utilisation de HACS (Home Assistant Community Store)
1. Accédez à HACS dans Home Assistant.
2. Cliquez sur "Intégrations" et sélectionnez le menu à trois points en haut à droite.
3. Sélectionnez "Dépôts personnalisés".
4. Ajoutez l'URL du dépôt suivant : `https://github.com/faizpuru/ha-pilot-wire-climate`
5. Choisissez "Integration" comme catégorie.
6. Installez l'intégration, puis redémarrez Home Assistant.
### Option 2 : Installation manuelle
1. Copiez les fichiers de l'intégration dans le répertoire des composants personnalisés de Home Assistant.
2. Redémarrez Home Assistant.
3. Ajoutez l'intégration via l'interface utilisateur de Home Assistant ou en modifiant le fichier `configuration.yaml`.
## Configuration
Pour configurer cette intégration, vous pouvez l'ajouter via l'interface utilisateur de Home Assistant ou configurer manuellement via YAML.
> [!IMPORTANT]
> Cette intégration est implémentée comme un **Helper** dans Home Assistant et non comme une intégration personnalisée classique.
>
> Pour initialiser ce helper, suivez ce chemin dans votre interface Home Assistant :
> 1. Paramètres
> 2. Appareils et Services
> 3. Entrées
> 4. Créer une entrée
> 5. Thermostat Fil Pilote
>
> Une fois configuré, l'entité climate apparaîtra dans l'onglet Entrées. Elle sera également automatiquement liée à l'appareil de l'entité select choisie lors de la configuration.
## Configuration YAML
Bien que vous puissiez utiliser `yaml`, il est recommandé d'utiliser l'interface utilisateur, car de plus en plus d'intégrations sont adaptées à cette méthode. Toutes les options sont disponibles dans l'interface utilisateur.
| Clé | Type | Requis | Description |
| :----------------- | :------ | :------- | :------------------------------------------------------------------------------------------------------------------------------ |
| `platform` | string | oui | `pilot_wire_climate` |
| `presets` | string | oui | ID de l'entité select pour ajuster les modes prédéfinis du fil pilote |
| `power` | string | non | ID de l'entité pour détecter si le chauffage est actif ou non |
| `temperature` | string | non | ID du capteur de température (pour l'affichage) |
| `additional_modes` | boolean | non | Prise en charge des 6 ordres (ajoute les modes Confort -1 et Confort -2) |
| `power_threshold` | integer | non | Seuil de puissance (en watts) à partir duquel le radiateur est considéré en chauffe |
| `default_preset` | string | no | Mode par défaut à l'allumage: "frost_protection", "eco", "comfort-2", "comfort-1" "comfort" |
| `name` | string | non | Nom à afficher dans l'interface utilisateur. |
| `unique_id` | string | non | Un identifiant unique pour ce climat. Si deux climats ont le même identifiant unique, Home Assistant renverra une erreur. |
L’identifiant unique est recommandé pour permettre des modifications de l'icône, de l'ID d'entité ou du nom via l'interface utilisateur.
```yaml
climate:
- platform: pilot_wire_climate
name: Radiateur Salon
unique_id: radiateur_salon_climate
presets: select.radiateur_mode
power: sensor.radiateur_puissance
power_threshold: 10
temperature: sensor.salon_temperature
default_preset: eco
additional_modes: true
```
## 🤝 Contributions
Les contributions sont les bienvenues ! N'hésitez pas à :
- 🐛 Signaler des bugs
- 💡 Suggérer des améliorations
- 🔀 Soumettre des pull requests
## 📄 Licence
Ce projet est sous licence MIT. Consultez le fichier LICENSE pour plus de détails.
---
Si vous trouvez cette intégration utile, pensez à lui donner une ⭐️ sur GitHub !