Versatile Thermostat
A full featured Thermostat for Home Assistant: presets, window, motion, presence and overpowering management.
https://github.com/jmcollin78/versatile_thermostat
Category: Consumption
Sub Category: Buildings and Heating
Keywords
hacs-custom hacs-integration home-assistant python thermostat
Keywords from Contributors
integration solar hacs sensor
Last synced: about 11 hours ago
JSON representation
Repository metadata
A full featured Thermostat for Home Assistant: presets, window, motion, presence and overpowering management
- Host: GitHub
- URL: https://github.com/jmcollin78/versatile_thermostat
- Owner: jmcollin78
- License: mit
- Created: 2022-12-27T09:48:13.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2025-04-21T09:28:16.000Z (7 days ago)
- Last Synced: 2025-04-25T21:01:55.184Z (3 days ago)
- Topics: hacs-custom, hacs-integration, home-assistant, python, thermostat
- Language: Python
- Homepage:
- Size: 6.55 MB
- Stars: 529
- Watchers: 12
- Forks: 57
- Open Issues: 20
- Releases: 241
-
Metadata Files:
- Readme: README-fr.md
- Contributing: CONTRIBUTING-fr.md
- License: LICENSE
README-fr.md
Versatile Thermostat
Ce fichier README est disponible en
Anglais | Français
Cette intégration de thermostat vise à simplifier considérablement vos automatisations autour de la gestion du chauffage. Parce que tous les événements autour du chauffage classiques sont gérés nativement par le thermostat (personne à la maison ?, activité détectée dans une pièce ?, fenêtre ouverte ?, délestage de puissance ?), vous n'avez pas à vous encombrer de scripts et d'automatismes compliqués pour gérer vos thermostats. ;-).
Ce composant personnalisé pour Home Assistant est une mise à niveau et une réécriture complète du composant "Awesome thermostat" (voir Github) avec l'ajout de fonctionnalités.
Captures d'écran
Le composant Versatile Thermostat UI Card (Disponible sur Github) :
Quoi de neuf ?
- Release 7.2:
Prise en compte native des équipements pilotable via une entité de type
select
(ouinput_select
) ouclimate
pour des VTherm de typeover_switch
. Cette évolution rend obsolète, la création de switch virtuels pour l'intégration des Nodon ou Heaty ou eCosy ... etc. Plus d'informations ici.Lien vers la documentation : cette version 7.2 expérimente des liens vers la documentation depuis les pages de configuration. Le lien est accessible via l'icone
. Elle est expérimentée sur certaines pages de la configuration.
Ajout d'un chapitre dans la documentation nommé 'Démarrage rapide' permettant de mettre en oeuvre rapidement un VTherm en fonction de votre équipement. La page est ici
🍻 Merci pour les bières 🍻
Un grand merci à tous mes fournisseurs de bières pour leurs dons et leurs encouragments. Ca me fait très plaisir et ça m'encourage à continuer ! Si cette intégration vous a fait économiser, payez moi une p'tite bière en retour, j'en vous en serais très reconnaissant !
Glossaire
VTherm
: Versatile Thermostat dans la suite de ce document
TRV
: tête thermostatique équipée d'une vanne. La vanne s'ouvre ou se ferme permettant le passage de l'eau chaude
AC
: Air conditionné. Un équipement est AC si il fait du froid. Les températures sont alors inversées : Eco est plus chaud que Confort qui est plus chaud que Boost. Les algorithmes tiennent compte de cette information.
EMA
: Exponential Moving Average. Utilisé pour lisser les mesures de températures de capteur. Elle correspond à une moyenne glissante de la température de la pièce. Elle est utilisée pour calculer la pente de la courbe de température (slope) qui serait trop instable sur la courbe brute.
slope
: la pente de la courbe de température. Elle est mesurée en °(C ou K)/h. Elle est positive si la température augmente et négative si elle diminue. Cette pente est calculée sur l'EMA
PAC
: Pompe à chaleur
HA
: Home Assistant
sous-jacent
: l'équipement controlé par VTherm
Documentation
La documentation est maintenant découpée en plusieurs pages pour faciliter la lecture et la recherche d'informations :
- Présentation
- Installation
- Démarrage rapide
- Choisir un type de VTherm
- Les attributs de base
- Configurer un VTherm sur un
switch
- Configurer un VTherm sur un
climate
- Configurer un VTherm sur une vanne
- Les pré-régages (preset)
- La gestion des ouvertures
- La gestion de la présence
- La gestion de mouvement
- La gestion de la puissance
- L'auto start and stop
- La contrôle centralisé de tous vos VTherms
- La commande du chauffage central
- Aspects avancés, mode sécurité
- L'auto-régulation
- Exemples de réglages
- Les différents algorithmes
- Documentation de référence
- Exemple de réglages
- Dépannage
- Notes de version
Quelques résultats
Stabilité de la température autour de la cible configurée par preset: :
Cycle de marche/arrêt calculé par l'intégration over_climate
:
Régulation avec un over_switch
:
Regulation forte en over_climate
:
Regulation avec contrôle direct de la vanne en over_climate
:
Enjoy !
Les contributions sont les bienvenues !
Si vous souhaitez contribuer, veuillez lire les directives de contribution
Owner metadata
- Name: Jean-Marc Collin
- Login: jmcollin78
- Email:
- Kind: user
- Description:
- Website: http://clouderial.com
- Location: France
- Twitter:
- Company: Clouderial
- Icon url: https://avatars.githubusercontent.com/u/1712374?u=28dcf780c3c2043f176ba88bea0b0135c6f6670b&v=4
- Repositories: 13
- Last ynced at: 2023-09-20T14:50:26.970Z
- Profile URL: https://github.com/jmcollin78
GitHub Events
Total
- Create event: 117
- Commit comment event: 2
- Release event: 69
- Issues event: 357
- Watch event: 230
- Delete event: 58
- Issue comment event: 1301
- Push event: 283
- Pull request review event: 49
- Pull request review comment event: 18
- Pull request event: 146
- Fork event: 35
Last Year
- Create event: 117
- Commit comment event: 2
- Release event: 69
- Issues event: 357
- Watch event: 230
- Delete event: 58
- Issue comment event: 1301
- Push event: 283
- Pull request review event: 49
- Pull request review comment event: 18
- Pull request event: 146
- Fork event: 35
Committers metadata
Last synced: 8 days ago
Total Commits: 451
Total Committers: 32
Avg Commits per committer: 14.094
Development Distribution Score (DDS): 0.417
Commits in past year: 180
Committers in past year: 24
Avg Commits per committer in past year: 7.5
Development Distribution Score (DDS) in past year: 0.494
Name | Commits | |
---|---|---|
Jean-Marc Collin | j****n@r****m | 263 |
Jean-Marc Collin | j****8@g****m | 135 |
Paulo Ferreira de Castro | p****o@g****m | 10 |
adi90x | a****0@g****m | 7 |
Andrea Nicotra | n****a@g****m | 3 |
misa1515 | 6****5 | 3 |
Gernot Messow | g****r@g****m | 3 |
hilburn | c****9@g****m | 2 |
Vassilis Papanikolaou | v****k@g****m | 2 |
Joeri Colman | c****i@m****m | 1 |
Bergoglio | 6****o | 1 |
EPicLURcher | 7****r | 1 |
Edwin ten Haaf | e****n@f****l | 1 |
Eric Scherlinger | 3****e | 1 |
Fabio Coatti | f****i@g****m | 1 |
Frank Mainz | 5****z | 1 |
Frederic Seiler | f****c@s****o | 1 |
zepala | 4****a | 1 |
ms5 | m****5 | 1 |
jkreiss-coexya | 9****p | 1 |
felix schwenzel | d****x@g****m | 1 |
echopage | 3****e | 1 |
domozer | 4****r | 1 |
cddu33 | 5****3 | 1 |
Tomasz Madycki | t****i@g****m | 1 |
Tierry Danquin | c****t@o****m | 1 |
Sebastian Noe | g****b@s****e | 1 |
Romain Van Vooren | r****v@g****m | 1 |
Maxwell Gonsalves | 5****2 | 1 |
Matt Bush | m****h@g****m | 1 |
and 2 more... |
Committer domains:
- snoe.me: 1
- oothkoo.com: 1
- seiler.io: 1
- familietenhaaf.nl: 1
- msn.com: 1
- renault.com: 1
Issue and Pull Request metadata
Last synced: 1 day ago
Total issues: 527
Total pull requests: 143
Average time to close issues: 24 days
Average time to close pull requests: 3 days
Total issue authors: 144
Total pull request authors: 24
Average comments per issue: 4.78
Average comments per pull request: 1.01
Merged pull request: 127
Bot issues: 0
Bot pull requests: 0
Past year issues: 278
Past year pull requests: 119
Past year average time to close issues: 15 days
Past year average time to close pull requests: 2 days
Past year issue authors: 124
Past year pull request authors: 23
Past year average comments per issue: 6.0
Past year average comments per pull request: 1.03
Past year merged pull request: 106
Past year bot issues: 0
Past year bot pull requests: 0
Top Issue Authors
- jmcollin78 (208)
- maia (17)
- adi90x (17)
- kadaan (13)
- Bergoglio (11)
- Davxci (9)
- gael1980 (8)
- tomtom13 (7)
- hacscred (6)
- Merangle (6)
- mag2352 (4)
- TTLucian (4)
- asdkjasdfla (4)
- vador31 (4)
- MaxWaldorf (4)
Top Pull Request Authors
- jmcollin78 (98)
- adi90x (9)
- Bergoglio (6)
- hilburn (4)
- gpayer (4)
- ms5 (2)
- eflye (2)
- lboue (2)
- felixfischer (1)
- pounard (1)
- ericsche (1)
- tmad (1)
- carlolars (1)
- cova-fe (1)
- depuits (1)
Top Issue Labels
- developed (198)
- enhancement (140)
- bug (124)
- P1 (103)
- wontfix (65)
- question (49)
- Not VTherm issue (28)
- documentation (27)
- invalid (24)
- help wanted (22)
- Waiting response (21)
- Template not respected (18)
- not reproduced (15)
- duplicate (12)
- need PR (10)
Top Pull Request Labels
- Waiting response (1)
Dependencies
- actions/checkout v2 composite
- hacs/action main composite
- home-assistant/actions/hassfest master composite
- actions/checkout v2 composite
- actions/setup-python v1 composite
- hacs/action main composite
- home-assistant/actions/hassfest master composite
- actions/checkout v2 composite
- actions/setup-python v1 composite
- hacs/action main composite
- home-assistant/actions/hassfest master composite
- hacs/action main composite
- ffmpeg * development
- homeassistant ==2023.10.3 development
- aiodiscover * test
- pytest-asyncio * test
- pytest-homeassistant-custom-component * test
- ulid_transform * test
Score: 9.773834344309257