Home Assistant

Si vous utilisez déjà Home Assistant chez vous, vous pouvez y faire remonter les mesures de votre système Azimut : production solaire, charge de la batterie, échanges avec le réseau, consommation de la maison. Elles s'ajoutent à vos autres appareils, alimentent le tableau de bord Énergie et deviennent utilisables dans vos automatisations.

L'intégration est publiée en open source par Azimut Energy : azimut-energy/azimut-ha-integration.

Ce que couvre notre support

Nous développons et maintenons l'intégration elle-même : c'est notre responsabilité, et les problèmes qui la concernent se signalent dans les issues du dépôt.

En revanche, nous n'accompagnons pas la configuration de Home Assistant — installation, tableaux de bord, automatisations, cartes personnalisées. Ce terrain-là appartient à la communauté Home Assistant, bien plus outillée que nous pour y répondre.

L'application Azimut, elle, reste le chemin pris en charge de bout en bout : voir L'application Azimut.

Ce qu'il vous faut

• Home Assistant 2024.1.0 ou plus récent.
• Votre système Azimut et votre serveur Home Assistant sur le même réseau local. L'intégration ne passe pas par internet : elle parle directement à votre installation, chez vous.

Rien à activer côté Azimut : votre système publie déjà ses mesures sur votre réseau local, c'est ce à quoi l'intégration s'abonne.

Installer l'intégration

Par HACS (recommandé)

HACS est le gestionnaire d'extensions communautaires de Home Assistant, et l'intégration Azimut y figure au catalogue par défaut.

1. Dans Home Assistant, ouvrez HACS.
2. Allez dans Integrations.
3. Cherchez Azimut Energy.
4. Cliquez sur Download.
5. Redémarrez Home Assistant.

Manuellement

Si vous n'utilisez pas HACS : téléchargez la dernière version publiée, placez le dossier azimut_energy dans le répertoire custom_components de votre configuration, puis redémarrez Home Assistant.

Ajouter votre système

Détection automatique

Votre système s'annonce sur votre réseau local (mDNS). Dans la plupart des cas, Home Assistant le trouve seul :

1. Allez dans Paramètres → Appareils et services.
2. Une notification Azimut Battery {numéro de série} discovered vous attend.
3. Cliquez sur Configurer, vérifiez les informations, puis Valider.

Configuration manuelle

Si la détection automatique n'aboutit pas — c'est fréquent quand votre serveur Home Assistant et votre système ne sont pas sur le même segment réseau, ou quand le mDNS ne traverse pas votre routeur :

1. Paramètres → Appareils et services → + Ajouter une intégration.
2. Cherchez Azimut Energy.
3. Renseignez deux informations :

Champ	Ce que c'est	Exemple
Adresse IP	L'adresse de votre système sur votre réseau local	192.168.1.100
Numéro de série	Le numéro de série de votre Azen	504589

Le port n'est pas demandé : il est toujours le même.

Si l'adresse IP de votre système change plus tard, inutile de tout refaire — Paramètres → Appareils et services → intégration Azimut Energy → Configurer permet de la corriger.

Les mesures remontées

Les capteurs sont créés automatiquement d'après ce que publie votre installation : la liste ci-dessous est celle des mesures courantes, et la vôtre peut en compter davantage ou moins selon votre matériel.

Mesure	Unité	Ce qu'elle dit
Grid Power	W	Puissance échangée avec le réseau — positive en prélèvement, négative en injection
Grid Power L1/L2/L3	W	La même, phase par phase
Grid Voltage L1/L2/L3	V	Tension du réseau, phase par phase
Grid Energy Import	kWh	Énergie prélevée au réseau, cumulée
Grid Energy Export	kWh	Énergie injectée sur le réseau, cumulée
Battery State of Charge	%	Niveau de charge de la batterie
Battery Power	W	Puissance de la batterie — positive en décharge, négative en charge
Battery Voltage	V	Tension de la batterie
Battery Capacity	Ah	Capacité de la batterie
PV Power	W	Production solaire instantanée
PV Energy	kWh	Énergie solaire produite
MPPT Power	W	Puissance au régulateur MPPT
Inverter Power	W	Puissance en sortie d'onduleur
Consumption Power	W	Consommation totale de la maison

Les valeurs ne collent pas à celles de l'application ?

C'est normal, et ce n'est pas une erreur de mesure. L'application Azimut affiche par défaut une moyenne sur une minute, alors que Home Assistant reçoit les valeurs au fil de l'eau. Sur des flux qui bougent en permanence, les deux ne peuvent pas coïncider à la seconde près — l'explication complète est dans L'application Azimut.

Le tableau de bord Énergie

Les capteurs d'énergie sont compatibles avec le tableau de bord Énergie de Home Assistant. Dans Paramètres → Tableaux de bord → Énergie :

• Consommation du réseau → Grid Energy Import
• Retour au réseau → Grid Energy Export
• Production solaire → PV Energy

Pour la batterie, Home Assistant attend deux compteurs d'énergie séparés (entrante et sortante), que l'intégration ne fournit pas directement : ils se construisent depuis Battery Power avec des helpers d'intégration Riemann côté Home Assistant.

Un exemple d'automatisation

Une alerte quand la batterie descend sous 20 % — en remplaçant 504589 par votre numéro de série :

automation:
  - alias: "Batterie faible"
    trigger:
      - platform: numeric_state
        entity_id: sensor.azen_504589_battery_soc
        below: 20
    action:
      - service: notify.mobile_app
        data:
          title: "Batterie faible"
          message: "La batterie est à {{ states('sensor.azen_504589_battery_soc') }} %"

D'autres exemples — production solaire élevée, injection sur le réseau, carte de flux d'énergie — figurent dans le README du dépôt, tenu à jour avec l'intégration.

Si ça ne fonctionne pas

• Votre système n'est pas détecté : vérifiez que le serveur Home Assistant et votre installation sont bien sur le même réseau local, puis passez par la configuration manuelle avec l'adresse IP.
• Aucun capteur n'apparaît après l'ajout : les capteurs sont créés à mesure que les données arrivent. Laissez passer quelques minutes avant de conclure.
• Le problème persiste : téléchargez les diagnostics depuis la page de l'intégration et joignez-les à une issue GitHub. C'est le canal de suivi de l'intégration.