Aller au contenu principal

Intégration domotique Amber Electric, gratuite et open source

Intégration Amber Electric pour Gladys Assistant

Prix Amber Electric en direct et prévus, pics de prix et renouvelables, pour vos scènes.

Voir sur GitHubToutes les intégrations

Cette intégration relie Gladys à votre compte Amber Electric (Australie) et remonte le prix de votre électricité, en direct et en prévision, pour que vos scènes lancent la pompe de piscine, l'eau chaude ou la recharge de la voiture quand le courant est bon marché, et les arrêtent avant un pic de prix.

Elle ne parle qu'au cloud Amber (elle porte le tag cloud) : il n'y a rien à installer sur votre réseau.

Ce que vous obtenez​

  • Un appareil par site Amber (un compteur, affiché avec son NMI), avec :
    • le prix de l'électricité que vous payez en ce moment, en $/kWh ;
    • le prix spot de gros ;
    • le prix de la charge pilotée, si votre compteur en a une (l'eau chaude, par exemple) ;
    • le prix d'injection, si vous revendez du solaire : ce que vous gagnez par kWh injecté. Il est négatif quand injecter vous coûte de l'argent ;
    • la part de renouvelables sur le réseau, en %.
  • Trois déclencheurs de scène, deux actions de scène et un widget de tableau de bord (Gladys 5.1 ou plus récent).

Avant de commencer​

Il vous faut un compte Amber Electric avec au moins un site actif, et un jeton d'API personnel.

Créer votre jeton d'API​

  1. Connectez-vous à l'application web Amber : app.amber.com.au.
  2. Ouvrez la page Developers (app.amber.com.au/developers).
  3. Cliquez sur Generate a new token, donnez-lui un nom (par exemple Gladys) et copiez-le. Amber ne l'affiche qu'une fois.

Le jeton ne donne qu'un accès en lecture à vos sites et à vos prix. Vous pouvez le révoquer sur la même page à tout moment.

Configuration​

  1. Ouvrez l'onglet Configuration de l'intégration.
  2. Collez le jeton dans Jeton d'API Amber.
  3. Site : laissez vide pour suivre tous les sites actifs du compte. Pour n'en suivre qu'un, saisissez son identifiant Amber ou son NMI (le bouton Tester la connexion les liste).
  4. Intervalle de rafraîchissement : 300 secondes (5 minutes) par défaut. Amber publie un nouveau prix toutes les 5 minutes et limite le nombre d'appels : inutile d'aller plus vite, et une minute est le minimum.
  5. Horizon des prévisions : le nombre d'heures de prix prévus à lire, pour le graphique du widget et le créneau le moins cher. 12 heures par défaut.
  6. Enregistrez, puis cliquez sur Tester la connexion : il liste vos sites et affiche le prix du moment.
  7. Ouvrez l'onglet Découverte et ajoutez votre site : ses fonctionnalités se remplissent au rafraîchissement suivant.

Les lectures sont calées sur les intervalles Amber (quelques secondes après :00, :05, :10…) : le prix change dans Gladys en même temps que dans l'application Amber.

Les appareils​

FonctionnalitéUnitéCe que c'est
Prix de l'électricité$/kWhCe que vous payez maintenant, réseau et TVA (GST) inclus
Prix spot de gros$/kWhLe prix du marché NEM derrière
Prix de la charge pilotée$/kWhSeulement si votre compteur a une charge pilotée
Prix d'injection$/kWhCe que vous gagnez par kWh injecté (négatif = ça coûte)
Renouvelables sur le réseau%Part d'électricité renouvelable dans votre région

Les fonctionnalités gardent leur historique : les graphiques standard de Gladys montrent l'évolution du prix sur la journée. Une valeur n'est envoyée à Gladys que quand elle change (et toutes les 30 minutes sinon).

Vous pouvez utiliser ces fonctionnalités dans le déclencheur standard état d'un appareil des scènes : « quand le prix de l'électricité dépasse 0,30 $/kWh… ».

Scènes​

L'intégration ajoute ses propres cartes à l'éditeur de scènes (Gladys 5.1 ou plus récent), dans la catégorie Intégrations.

Déclencheurs​

  • Le niveau du prix de l'électricité change — se déclenche quand le niveau de prix Amber change : extrêmement bas, très bas, bas, moyen, élevé ou pic. Choisissez si besoin le site et les nouveaux niveaux qui lancent la scène. Les actions suivantes peuvent lire {{triggerEvent.data.level}}, {{triggerEvent.data.previous_level}} et {{triggerEvent.data.price}}.
  • Un pic de prix est possible, commence ou se termine — se déclenche quand le statut de pic passe entre aucun, possible et pic en cours. Choisissez « pic possible » pour vous préparer (rafraîchir la maison à l'avance), « pas de pic (terminé) » pour reprendre.
  • L'injection sur le réseau devient payante ou rapporte — se déclenche quand le prix d'injection franchit zéro : injecter le solaire commence à coûter de l'argent (brider l'onduleur, charger la batterie, lancer la pompe de piscine) ou rapporte à nouveau.

Un déclencheur se déclenche une fois par changement, jamais à chaque rafraîchissement. La première lecture après le démarrage de l'intégration enregistre seulement l'état actuel : un redémarrage ne rejoue pas les déclencheurs.

Actions​

  • Lire le prix actuel de l'électricité — donne aux actions suivantes le prix actuel (price), le prix spot, le niveau (level), le statut de pic (spike_status), la part de renouvelables, si le prix est encore estimé, et la période tarifaire. Choisissez le prix à lire : électricité achetée, charge pilotée ou injection. available vaut faux quand le site n'a pas ce canal.
  • Trouver le moment le moins cher — indiquez une durée (60 minutes par défaut) et un horizon (les 12 prochaines heures par défaut) : l'action répond starts_in_minutes, start_time et end_time (UTC), et le average_price de ce créneau. found vaut faux quand les prévisions sont trop courtes. Exemple : « tous les soirs à 21 h, trouver les 2 heures les moins chères dans les 10 prochaines heures, puis m'envoyer un message : lance le lave-vaisselle dans starts_in_minutes minutes ».

Tableau de bord​

Ajoutez le widget Prix Amber à un tableau de bord. Il affiche :

  • le prix actuel, le prix d'injection et la part de renouvelables, en c/kWh comme dans l'application Amber, colorés selon le niveau de prix ;
  • le graphique des prévisions, avec l'heure la moins chère et les pics marqués ;
  • le niveau de prix, le statut de pic et la période tarifaire ;
  • un bouton Actualiser qui relit les prix tout de suite.

Dans les réglages du widget, choisissez le site à afficher (le premier si vide).

Dépannage​

  • « Amber a refusé le jeton d'API » : le jeton a été révoqué ou mal copié. Créez-en un nouveau sur la page Developers et recollez-le.
  • « Aucun site de ce compte Amber n'a l'identifiant saisi dans le champ Site » : videz le champ, ou copiez un identifiant donné par Tester la connexion.
  • « Ce compte Amber n'a pas encore de site actif » : Amber n'alimente pas encore votre compteur (site en attente). Les prix apparaîtront quand il sera actif.
  • « Amber limite le nombre d'appels » : les lectures font une pause de quelques minutes. Si cela se répète (un autre outil utilise le même jeton), augmentez l'intervalle de rafraîchissement.
  • Les fonctionnalités restent vides : ajoutez d'abord le site depuis l'onglet Découverte.
  • Pour plus de détails, activez Journaux détaillés dans la configuration et consultez les journaux de l'intégration. Votre jeton n'y est jamais écrit.

Paramètres de configuration​

Voici les paramètres demandés par Amber Electric dans son écran de configuration dans Gladys.

ParamètreTypeObligatoireDescription
Pour commencersectionNonCette intégration lit vos prix Amber Electric depuis le cloud Amber. Créez un jeton d'API personnel dans l'application web Amber (page Developers, Generate a new token), collez-le ci-dessous et enregistrez : vos sites apparaissent dans l'onglet Découverte.
Jeton d'API AmbersecretOuiLe jeton personnel créé sur app.amber.com.au/developers. Il ne fait que lire vos sites et vos prix.
SitestringNonLaissez vide pour suivre tous les sites actifs du compte. Pour n'en suivre qu'un, son identifiant Amber ou son NMI : « Tester la connexion » les liste.
Intervalle de rafraîchissement (s)numberNonFréquence de lecture des prix, en secondes. Amber publie un nouveau prix toutes les 5 minutes (300 s) et limite le nombre d'appels : une minute au minimum.
Horizon des prévisions (h)numberNonNombre d'heures de prix prévus à lire, pour le graphique du tableau de bord et le créneau le moins cher.
Journaux détaillés (debug)booleanNonJournalise chaque appel à Amber et chaque prix lu. Le jeton d'API n'est jamais journalisé.

Comment installer Amber Electric dans Gladys​

  1. Dans Gladys, ouvrez Intégrations : Amber Electric apparaît dans le catalogue, aux côtés des intégrations natives, avec un badge communautaire.
  2. Cliquez sur Installer. Gladys télécharge l'image Docker (ghcr.io/prohand/gladys-amberelectric:1.1.0), la démarre dans un bac à sable isolé du cœur, et génère l'interface de l'intégration (appareils, découverte et configuration).
  3. Ouvrez l'écran Configuration de l'intégration, remplissez les paramètres, puis enregistrez.
  4. Vous pouvez aussi l'installer directement depuis l'URL de son dépôt : https://github.com/prohand/gladys-amberelectric.

Amber Electric nécessite Gladys >=5.1.0. Le catalogue dans Gladys se rafraîchit toutes les heures : une nouvelle version est donc disponible au plus tard une heure après sa sortie.

Vous n'utilisez pas encore Gladys ? C'est gratuit et open source : suivez le guide d'installation pour démarrer.

À propos des intégrations externes​

Amber Electric est une intégration externe : une intégration communautaire empaquetée dans un conteneur Docker et publiée sur GitHub, que Gladys installe en un clic et exécute dans un bac à sable isolé de son cœur. Elle est publiée et maintenue par prohand, et non par l'équipe cœur de Gladys.

Inscrivez-vous à la newsletter Gladys Assistant

Quelques emails par mois sur les nouveautés et l'actualité du projet. Envoyés par Pierre-Gilles Leymarie, le fondateur du projet. Désinscription possible à tout moment 🙂
Dernière mise à jour le