Aller au contenu principal

Intégration Pellet Stock pour Gladys Assistant

Intégration Pellet Stock pour Gladys Assistant

Suivez votre stock de pellets : livraisons, consommation et autonomie, avec un widget dédié.

Voir sur GitHubToutes les intégrations externes

Cette intégration suit votre stock de pellets (granulés de bois) : livraisons, consommation, consommation moyenne par jour et autonomie restante. Elle ajoute un widget au tableau de bord, un appareil virtuel pour l'historique et les scènes, et une action de scène.

Aucun matériel ni compte en ligne n'est nécessaire : l'intégration tient un registre des mouvements de sacs et en déduit tout le reste.

Premiers pas​

  1. Ouvrez l'onglet Configuration de l'intégration et vérifiez le poids d'un sac (15 kg par défaut) et le nombre de sacs par palette (66 par défaut).
  2. Lancez l'action « Corriger le stock » et indiquez le nombre de sacs que vous avez actuellement.
  3. Ajoutez le widget « Stock de pellets » à votre tableau de bord (modifier le tableau de bord → ajouter une boîte → Stock de pellets).

Au quotidien​

  • Appuyez sur « −1 sac » dans le widget à chaque fois que vous remplissez le poêle.
  • Appuyez sur « +1 sac » pour chaque sac acheté à l'unité (en magasin par exemple).
  • Appuyez sur « Palette livrée » à chaque livraison d'une palette : le nombre de sacs par palette est ajouté (une confirmation est demandée).
  • Une fausse manipulation ? « Annuler » retire la dernière opération.
  • Pour ajouter plusieurs sacs d'un coup (une demi-palette, un lot de 10 sacs…), utilisez l'action « Enregistrer une livraison » de la configuration.

Vous n'êtes pas obligé d'appuyer à chaque sac : recompter le stock de temps en temps avec « Corriger le stock » suffit. Les sacs manquants depuis le dernier comptage sont comptés comme consommés.

Ce qu'affiche le widget​

  • Stock en sacs : vert, puis orange sous le seuil de stock bas (10 sacs par défaut), rouge à zéro. Un rappel « Pensez à commander » apparaît alors.
  • Autonomie en jours.
  • Un graphique, au choix dans les réglages du widget : l'évolution du stock, avec les livraisons repérées, ou les sacs utilisés par jour en barres (par semaine sur 1 an). Période réglable : 1 mois, 3 mois, 1 an. Pour voir les deux, mettez deux widgets côte à côte. Les sacs manquants trouvés lors d'un recomptage sont comptés le jour du recomptage.
  • La consommation moyenne par jour, le dernier sac utilisé (« il y a 2 jours »), le poids restant, la dernière livraison et la consommation depuis (en sacs et en kg).
  • La date à laquelle commander (quand le stock atteindra le seuil de stock bas) et la date estimée à laquelle le stock sera vide.
  • Si vous indiquez le prix d'une palette dans la configuration : la valeur du stock et le coût par mois.

Seules les livraisons de plusieurs sacs (une palette, un lot…) comptent comme livraisons : les sacs ajoutés un par un ne sont ni repérés sur le graphique, ni pris en compte pour « Dernière livraison » et la consommation depuis.

Dans les réglages du widget, vous pouvez masquer les boutons, par exemple pour un écran mural en lecture seule.

Comment l'autonomie est calculée​

La consommation moyenne est calculée sur les 14 derniers jours (réglable de 3 à 90 jours dans la configuration). Plus court, elle suit plus vite la météo ; plus long, elle est plus stable.

  • Tant qu'il y a moins d'un jour d'historique, l'autonomie reste inconnue (un tiret s'affiche) : un seul sac utilisé ne permet pas d'extrapoler.
  • Sans aucune consommation sur la période (en été par exemple), l'autonomie est également inconnue.

Appareil « Stock de pellets » (optionnel)​

Depuis l'onglet Découverte, vous pouvez ajouter l'appareil « Stock de pellets ». Il expose deux valeurs avec historique :

  • Stock de pellets (nombre de sacs) ;
  • Autonomie pellets (jours).

Il permet d'afficher l'historique dans une boîte graphique classique et, surtout, de créer des scènes : par exemple « quand le stock passe sous 10 sacs, m'envoyer un message ». Une autonomie inconnue n'est jamais envoyée comme 0, pour ne pas déclencher une scène « stock vide » à tort.

Le widget fonctionne sans cet appareil.

Plusieurs maisons​

Pour suivre les pellets d'une autre maison (une résidence secondaire, un chalet…), lancez l'action « Ajouter un stock » dans la configuration et donnez-lui un nom. Chaque stock a son propre historique et son propre appareil :

  1. Dans l'onglet Découverte, ajoutez l'appareil « Stock de pellets – Chalet » (avec le nom choisi) et placez-le dans une pièce de cette maison.
  2. Lancez « Corriger le stock » en choisissant ce stock, pour indiquer ses sacs actuels.
  3. Ajoutez un widget « Stock de pellets » et choisissez ce stock dans ses réglages. Son nom apparaît dans le titre du graphique.

Les actions de la configuration et l'action de scène ont un champ Stock : laissé vide, elles portent sur le stock principal. Un bouton Zigbee du chalet peut ainsi décompter uniquement le stock du chalet.

Les réglages (poids d'un sac, sacs par palette, seuil, prix…) sont communs à tous les stocks. « Supprimer un stock » retire un stock ajouté et son historique ; le stock principal ne peut pas être supprimé.

Scènes​

Actions​

  • « Utiliser des sacs de pellets » retire des sacs du stock. Exemple : un bouton Zigbee posé à côté du poêle, qui déclenche une scène retirant un sac à chaque appui. L'action échoue si le stock enregistré est insuffisant : recomptez alors votre stock.
  • « Ajouter des sacs de pellets » ajoute des sacs (une livraison, des sacs achetés à l'unité).
  • « Corriger le stock de pellets » fixe le stock au nombre de sacs comptés.
  • « Lire le stock de pellets » ne modifie rien : elle sert à récupérer les chiffres pour la suite de la scène, par exemple un message hebdomadaire.

Chaque action a un champ Stock (vide : le stock principal) et renvoie aux actions suivantes les sacs restants, l'autonomie (jours), les sacs par jour, les jours avant de commander et le poids restant (kg). Une valeur encore inconnue (autonomie sans consommation, par exemple) n'est pas renvoyée, plutôt que de valoir 0.

Déclencheurs​

  • « Stock de pellets bas » : le stock descend au seuil de stock bas de la configuration. Il se déclenche une fois, au passage du seuil, pas à chaque sac en dessous.
  • « Stock de pellets épuisé » : le dernier sac a été utilisé.
  • « Palette de pellets livrée » : une livraison de plusieurs sacs a été enregistrée depuis le widget ou la configuration.

Chaque déclencheur a un champ Stock (vide : tous les stocks) et fournit les mêmes chiffres que les actions, plus les sacs livrés pour la palette. Exemple : « Stock de pellets bas → m'envoyer "Il reste {{triggerEvent.data.bags_left}} sacs, pensez à commander" ».

Une livraison ajoutée par une scène ne déclenche pas « Palette livrée », pour qu'une scène ne puisse pas se relancer elle-même en boucle. Les déclencheurs de stock bas et épuisé, eux, partent quelle que soit l'origine, y compris un bouton Zigbee passant par une scène.

Sauvegarde​

Le registre des mouvements (les 500 derniers) est enregistré dans la base de Gladys : il fait partie des sauvegardes Gladys et survit à une mise à jour de l'intégration. Il est supprimé si vous désinstallez l'intégration.

Paramètres de configuration​

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

ParamètreTypeObligatoireDescription
FonctionnementsectionNonCommencez par indiquer votre stock actuel avec l'action « Corriger le stock » ci-dessous. Ajoutez ensuite le widget « Stock de pellets » à votre tableau de bord : appuyez sur « −1 sac » à chaque remplissage du poêle, sur « +1 sac » pour un sac acheté à l'unité, et sur « Palette livrée » à chaque palette livrée. Recompter le stock de temps en temps avec « Corriger le stock » suffit aussi : les sacs manquants sont comptés comme consommés.
Poids d'un sac (kg)numberNonSert à afficher le poids restant. La plupart des sacs pèsent 15 kg.
Sacs par palettenumberNonNombre de sacs ajoutés par le bouton « Palette livrée ». Une palette de sacs de 15 kg compte en général 66 ou 72 sacs.
Seuil de stock bas (sacs)numberNonÀ partir de ce nombre de sacs, le widget affiche le stock en orange et vous rappelle de commander.
Période de calcul (jours)numberNonLa consommation moyenne par jour, et donc l'autonomie, est calculée sur ce nombre de jours passés. Plus court suit plus vite la météo, plus long est plus stable.
Prix d'une palette (€)numberNonFacultatif. Affiche la valeur du stock et le coût par mois dans le widget. Le prix d'un sac est ce prix divisé par le nombre de sacs par palette.

Comment installer Pellet Stock dans Gladys​

  1. Dans Gladys, ouvrez Intégrations : Pellet Stock 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/william-de71/gladys-pellet-stock: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/William-De71/gladys-pellet-stock.

Pellet Stock 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​

Pellet Stock 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 William-De71, 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