Aller au contenu principal

Intégration domotique ComEd Hourly Pricing, gratuite et open source

Intégration ComEd Hourly Pricing pour Gladys Assistant

ComEd Hourly Pricing (Illinois) : prix temps réel à 5 min, moyenne horaire et prix de demain.

Les prix de l'électricité en temps réel de ComEd Hourly Pricing dans Gladys : le prix à 5 minutes, la moyenne de l'heure en cours (le prix facturé), les minimums et maximums du jour, les prix prévus du lendemain, une courbe des prix, des déclencheurs de scène et une action de scène pour lancer vos appareils quand l'électricité est la moins chère.

Les prix viennent de l'API publique de ComEd. Cette intégration n'a aucun lien avec ComEd. Elle a été testée contre l'API réelle de ComEd, mais pas encore sur le Gladys d'un client Hourly Pricing : vos retours sont les bienvenus.

Présentation​

Hourly Pricing est un tarif optionnel de ComEd (Commonwealth Edison, nord de l'Illinois) : au lieu d'un prix fixe, le prix de fourniture suit heure par heure le marché de gros PJM. ComEd publie, sans compte ni clé :

  • un prix temps réel toutes les 5 minutes ;
  • les prix day-ahead (prévus) : un prix par heure, fixé la veille par le marché PJM. Ceux du lendemain arrivent l'après-midi. C'est une prévision : ce qui est facturé, c'est la moyenne horaire temps réel.

Tous les prix sont le prix de fourniture en cents par kWh (¢/kWh), comme sur le site de ComEd et dans l'intégration Home Assistant comed_hourly_pricing : acheminement, capacité et taxes ne sont pas compris. Ils peuvent être négatifs.

Les heures sont celles de Chicago, quel que soit le fuseau de votre Gladys.

Prérequis​

  • Gladys Assistant 5.1.0 ou plus récent.
  • Un accès Internet de Gladys vers hourlypricing.comed.com.
  • Rien d'autre : ni compte, ni clé d'API, ni matériel. Pas besoin d'être client de ComEd pour suivre les prix.

Installation​

  1. Dans Gladys, ouvrez Intégrations → Installer depuis GitHub et saisissez https://github.com/guim31/gladys-comed.
  2. Ouvrez l'intégration, choisissez la langue des noms de fonctionnalités, enregistrez.
  3. Ouvrez l'onglet Découverte et ajoutez l'appareil ComEd Hourly Pricing.
  4. Ajoutez le widget Prix de l'électricité ComEd à un tableau de bord.

Configuration​

  • Langue des noms de fonctionnalités : anglais, français, allemand ou espagnol. Elle nomme les fonctionnalités quand l'appareil est ajouté ; les noms ne changent plus ensuite.
  • Le bouton Relever les prix maintenant interroge ComEd tout de suite et affiche le dernier prix à 5 minutes, la moyenne de l'heure en cours et si les prix de demain sont publiés.

L'appareil ComEd​

Chaque fonctionnalité est un capteur en lecture seule en ¢/kWh, gardé dans l'historique :

FonctionnalitéCe que c'est
Prix 5 minutesLe dernier prix temps réel, publié environ 6 minutes après ses 5 minutes
Moyenne de l'heure en coursLa moyenne des prix à 5 minutes de l'heure jusqu'ici : le prix facturé
Prix moyen du jourLa moyenne des prix à 5 minutes du jour
Prix horaire min / max du jourLa plus basse et la plus haute moyenne horaire depuis minuit (une heure compte à partir de HH:15)
Prix prévu de l'heureLa prévision pour l'heure en cours
Moyenne, prix min, prix max prévus demainLa prévision du lendemain, à partir de l'après-midi
Prix de demain publiés1 une fois les prix prévus du lendemain publiés, 0 avant

La moyenne, le min et le max de demain gardent leur dernière valeur jusqu'à la publication des prix suivants : vérifiez Prix de demain publiés avant de vous en servir le matin.

Quand ComEd ne publie plus de prix à 5 minutes pendant 30 minutes, l'intégration cesse de mettre à jour le prix à 5 minutes et la moyenne de l'heure, et le signale dans l'écran de configuration.

Widget du tableau de bord​

Le widget Prix de l'électricité ComEd affiche :

  • le dernier prix à 5 minutes, la moyenne de l'heure en cours et la moyenne du jour ;
  • une courbe des prix temps réel à 5 minutes du jour et des prix prévus du jour et du lendemain, avec les heures la moins chère et la plus chère du jour marquées ;
  • l'heure prévue la moins chère restant aujourd'hui, l'heure la moins chère et la moyenne de demain, ou le moment où les prix de demain sont attendus.

Il fonctionne même avant l'ajout de l'appareil.

Déclencheurs de scène​

Le prix horaire passe sous un seuil​

Se déclenche quand la moyenne de l'heure en cours passe sous le seuil choisi (0 à 20 ¢/kWh), après avoir été au-dessus ou égale. La moyenne est jugée à partir de son troisième prix à 5 minutes (HH:15) : à HH:05 ce n'est qu'un prix, trop volatil. Une fois par heure au plus et par seuil. Variables : la moyenne de l'heure, le prix à 5 minutes, l'heure (HH:MM) et l'heure du prix.

Le prix horaire passe au-dessus d'un seuil​

La même chose, vers le haut : pour couper une pompe à chaleur ou une borne pendant un pic de prix.

Le prix devient négatif​

Se déclenche quand un prix à 5 minutes passe sous zéro après un prix positif ou nul. Mêmes variables.

Les prix de demain sont publiés​

Une fois par jour, l'après-midi, quand ComEd publie les prix prévus du lendemain (pas après 23 h). Variables : prix moyen, minimum et maximum, heures la moins chère et la plus chère, et début des 3 heures les moins chères.

Action de scène​

Trouver les heures les moins chères avant une heure limite cherche, dans les prix prévus, la plage de 1 à 8 heures consécutives la moins chère à partir de maintenant, finie avant l'heure choisie (heure de Chicago), ou sans limite. Sorties : plage trouvée ou non, si elle commence maintenant, son début et sa fin (HH:MM), son prix moyen et les minutes avant son début. Le matin, avant la publication des prix de demain, seules les heures du jour sont cherchées.

Exemples de scènes​

  • Lave-vaisselle : chaque soir à 21 h, trouver les 2 heures les moins chères avant 7 h ; si la plage commence maintenant, allumer la prise connectée, sinon attendre minutes_to_start minutes.
  • Pic de prix : quand le prix horaire passe au-dessus de 10 ¢/kWh, couper le chauffe-eau et envoyer un message ; le rallumer quand il repasse sous 5.
  • Prix négatifs : quand le prix devient négatif, lancer la recharge de la voiture électrique.

Rafraîchissement et usage de l'API​

L'intégration lit le flux à 5 minutes (les dernières 24 heures, environ 13 Ko) quand le prix suivant doit être sorti : environ une fois toutes les 5 minutes, toutes les 10 minutes au moins. Les prix prévus du jour sont lus une fois par jour, ceux du lendemain toutes les 30 minutes à partir de midi jusqu'à leur publication. Après un échec, elle attend 1, 2, 5, 10 puis 15 minutes. Cela fait environ 300 petites requêtes par jour vers une API publique qui ne demande pas de clé.

Dépannage​

  • Pas de valeur, « ComEd est injoignable » : vérifiez que Gladys atteint hourlypricing.comed.com ; les derniers prix connus restent utilisés en attendant.
  • « plus de prix à 5 minutes depuis 30 minutes » : ComEd a cessé de publier, cela arrive pendant ses maintenances. L'intégration reprend seule.
  • Un déclencheur ne s'est pas lancé : la moyenne horaire est jugée à partir de HH:15, et le seuil doit être franchi (une heure qui commence et reste sous le seuil après une autre déjà dessous ne déclenche rien).
  • Passez LOG_LEVEL=debug pour voir chaque requête dans les logs de l'intégration.

Limites​

  • Développée sans être client de ComEd : les prix sont vérifiés contre le site et l'API de ComEd, pas contre une facture.
  • Prix de fourniture seulement : ni acheminement, ni capacité, ni taxes, donc pas votre coût complet du kWh.
  • Les prix prévus sont une prévision ; l'action de scène s'appuie dessus, le prix temps réel peut différer.
  • Le jour du passage à l'heure d'hiver, ComEd publie un seul prix prévu pour les deux heures 01:00 : les deux le reçoivent. Le flux de 24 heures peut aussi manquer la première heure de cette journée de 25 heures.

Paramètres de configuration​

Voici les paramètres demandés par ComEd Hourly Pricing dans son écran de configuration dans Gladys.

ParamètreTypeObligatoireDescription
ComEd Hourly PricingsectionNonComEd publie toutes les 5 minutes les prix temps réel de l'électricité de son programme Hourly Pricing (nord de l'Illinois), et l'après-midi les prix prévus du lendemain (day-ahead), sans compte ni clé. Les prix sont le prix de fourniture en cents/kWh, à l'heure de Chicago. Ajoutez l'appareil ComEd depuis l'onglet Découverte, et le widget des prix depuis le tableau de bord. Sans lien avec ComEd.
Langue des noms de fonctionnalitésselectNonUtilisée quand l'appareil est ajouté à Gladys : les noms ne changent plus ensuite.

Comment installer ComEd Hourly Pricing dans Gladys​

  1. Dans Gladys, ouvrez Intégrations : ComEd Hourly Pricing 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/guim31/gladys-comed:1.0.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/guim31/gladys-comed.

ComEd Hourly Pricing 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​

ComEd Hourly Pricing 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 guim31, 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 🙂