Intégration Home Assistant¶
Description¶
Les appareils Solar-Router-for-ESPHome apparaissent dans Home Assistant via l'intégration native ESPHome. Une fois adoptés, HA expose des interrupteurs, nombres, capteurs et lumières pour surveiller et piloter le routeur.
Cette page est le point d'entrée central pour les sujets Home Assistant. Pages détaillées :
| Sujet | Page |
|---|---|
| Réduire la croissance de la base | Configuration du recorder |
| Capteurs de diagnostic supplémentaires | Capteurs de debug |
| Quels packages sont chargés | Versions des modules |
| Priorité du surplus à un chargeur VE | Blueprint — Priorité au VE |
| Puissance depuis des capteurs HA | Compteur de puissance Home Assistant |
| Sécurité température depuis HA | Limiteur de température Home Assistant |
Adoption¶
- Flashez un appareil ESPHome vide et adoptez-le dans Home Assistant (voir Installation).
- Ajoutez les packages Solar Router au YAML de l'appareil et téléversez via OTA.
- Les entités apparaissent sur la page de l'appareil. Les noms sont préfixés par le nom de votre appareil (les exemples ci-dessous utilisent
solarrouter).
Masquer les entités bruyantes
Par défaut, l'ouverture du régulateur et les LED sont masquées (hide_regulators / hide_leds). Mettez-les à 'False' dans les vars de l'engine pour les exposer dans HA. Voir Aperçu des engines.
Entités principales¶
Les identifiants d'entités dépendent du nom de votre appareil. La colonne Nom est ce qu'ESPHome publie.
Contrôle¶
| Nom | Entité typique | Rôle |
|---|---|---|
| Activate Solar Routing | switch.solarrouter_activate_solar_routing | Active la régulation automatique et la scrutation du compteur |
| Router Level | number.solarrouter_router_level | Niveau de routage principal 0–100 % (à préférer à l'ouverture du régulateur) |
| Target grid exchange | number.solarrouter_target_grid_exchange | Cible d'échange réseau en W (0 = pas d'échange ; <0 continuer à exporter ; >0 autoriser un léger import) |
| Up Reactivity | number.solarrouter_up_reactivity | Vitesse de montée du niveau quand le surplus augmente |
| Down Reactivity | number.solarrouter_down_reactivity | Vitesse de descente du niveau quand le surplus diminue |
| Regulator Opening | number.solarrouter_regulator_opening | Ouverture physique du régulateur (souvent masquée) |
Supervision¶
| Nom | Entité typique | Rôle |
|---|---|---|
| Real Power | sensor.solarrouter_real_power | Échange réseau (W). Positif = import, négatif = export |
| Consumption | sensor.solarrouter_consumption | Consommation de la maison lorsque fournie par le compteur |
| Power divertion | sensor.solarrouter_power_divertion | Puissance détournée instantanée (avec compteur d'énergie) |
| Total energy diverted | sensor.solarrouter_total_energy_diverted | Énergie détournée cumulée (compteur théorique) |
Sécurité (si limiteur de température installé)¶
| Nom | Entité typique | Rôle |
|---|---|---|
| Safety limit reached | binary_sensor.solarrouter_safety_limit_reached | Détournement inhibé lorsque ON |
| Stop temperature / Restart temperature | number.* | Seuils avec hystérésis |
| safety_temperature | sensor.* | Température mesurée utilisée pour la limite |
Spécifique à l'engine¶
| Engine | Entités supplémentaires |
|---|---|
| 1 × switch | Niveaux et tempos de démarrage/arrêt |
| 1 × dimmer + bypass | Relais de bypass, Bypass tempo |
| Multi-canaux | Comptes à rebours des relais, Bypass tempo, détournement par relais |
Planificateur (optionnel)¶
Voir Scheduler Forced Run / Planificateur Marche forcée : Activate scheduler, heure/minute de début et de fin, niveau du routeur, seuil de vérification de fin.
Tableau de bord Lovelace suggéré¶
Jeu minimal de cartes pour un usage quotidien :
type: vertical-stack
cards:
- type: entities
title: Solar Router
entities:
- entity: switch.solarrouter_activate_solar_routing
- entity: number.solarrouter_router_level
- entity: number.solarrouter_target_grid_exchange
- entity: number.solarrouter_up_reactivity
- entity: number.solarrouter_down_reactivity
- type: history-graph
title: Échange réseau
hours_to_show: 24
entities:
- entity: sensor.solarrouter_real_power
- entity: sensor.solarrouter_power_divertion
- type: gauge
entity: number.solarrouter_router_level
name: Niveau du routeur
min: 0
max: 100
severity:
green: 0
yellow: 50
red: 90
Remplacez solarrouter par le préfixe de votre appareil. Ajoutez les entités de sécurité et de planificateur si ces packages sont chargés.
Automatisations et blueprints¶
- Utilisez l'interrupteur Activate Solar Routing depuis n'importe quelle automatisation HA pour suspendre ou reprendre le détournement (ex. : quand une pompe à chaleur ou un chargeur VE a besoin du surplus).
- Blueprint prêt à l'emploi : Priorité au VE — coupe le routeur pour laisser le chargeur VE prendre le surplus, puis le rétablit.
Bonnes pratiques¶
- Excluez les capteurs haute fréquence du recorder (
real_power, compteurs d'énergie) — voir Configuration du recorder. - Préférez Router Level pour le contrôle manuel ; ne combattez pas le curseur de régulation automatique tant que Activate est ON.
- Conservez les entités de versions de modules activées si vous pouvez avoir besoin de support.
- Pour une régulation qui doit survivre à une panne de HA, préférez un compteur natif au compteur HA.