Intégration domotique Tilt Pi, gratuite et open source
Non officiel : vos densimètres Tilt via l'application Tilt Pi, en local : densité, température.
Publiée par LM1LC3N7
- Appareils
- Version 0.1.1
- Nécessite Gladys >=5.1.0
- ★ 0
Connecteur non officiel, sans lien avec Tilt Hydrometer (Baron Brew Equipment). Il amène dans Gladys les densimètres Tilt qui flottent dans vos fermenteurs (bière, vin, cidre, hydromel...), lus par l'application Tilt Pi installée sur un Raspberry Pi de votre réseau, par son API HTTP locale, sans cloud.
Cette intégration n'a jamais été testée avec un vrai Tilt Pi. Elle suit la bibliothèque
tilt-piqu'utilise l'intégration Tilt Pi de Home Assistant. Merci de signaler ce que vous constatez sur le forum de Gladys.
Ce qu'il faut
- Un ou plusieurs Tilt (ou Tilt Pro, Tilt HD).
- Un Raspberry Pi avec l'application Tilt Pi (l'image officielle Tilt
Pi), sur le même réseau que Gladys, qui affiche vos Tilt sur sa page web
(
http://<adresse du Raspberry Pi>:1880/). C'est le Tilt Pi qui écoute les Tilt en Bluetooth, sur son Raspberry Pi : Gladys n'utilise jamais le Bluetooth (une intégration Gladys tourne dans un conteneur sans Bluetooth).
Ce que vous obtenez
Un appareil Gladys par couleur de Tilt (« Tilt Red », « Tilt Blue »...) :
| Fonction | Unité | Remarques |
|---|---|---|
| Specific gravity (SG) | aucune (« SG » au nom) | la densité, environ 1,000 pour l'eau |
| Temperature | °C | une sonde : hors de la moyenne de température de la pièce |
- Gladys n'a ni catégorie ni unité pour une densité : la densité est un capteur « inconnu » sans unité, l'unité (SG) est seulement écrite dans son nom. Aucune unité n'est inventée.
- La couleur est l'identité d'un Tilt sur un Tilt Pi : l'appareil d'une couleur reste le même, même si vous changez de Tilt de cette couleur.
- Les noms des fonctions sont en anglais ; renommez-les à la création si vous le souhaitez.
Installation
- Installez l'intégration depuis le catalogue de Gladys (Gladys 5.1 ou plus récent).
- Dans l'écran Configuration, saisissez l'adresse du Tilt Pi
(l'adresse IP du Raspberry Pi, par exemple
192.168.1.30, avec:portseulement si ce n'est pas 1880). - Cliquez sur Tester le Tilt Pi : le message affiche la densité et la température de chaque Tilt.
- Ouvrez l'onglet Découverte et ajoutez les appareils.
Configuration
- Adresse du Tilt Pi : une adresse IP ou un nom, avec un port s'il
n'est pas 1880 ;
http://est accepté, pashttps://(la page du Tilt Pi n'en a pas), ni chemin, ni utilisateur. Donnez au Raspberry Pi une adresse fixe dans votre box. Une nouvelle adresse est lue tout de suite (au plus une requête par minute). - Intervalle de lecture : 5 minutes par défaut, de 1 à 60.
- Pas de réglage d'unité : l'API du Tilt Pi donne toujours la température en °F, même quand sa page affiche des °C (c'est ce que fait le flux officiel de l'application). L'intégration la convertit en °C, et Gladys l'affiche dans l'unité de votre profil. Si la température de l'API ne correspond pas à celle qu'affiche la page du Tilt Pi, elle n'est pas envoyée et le statut le signale.
À quel rythme le Tilt Pi est lu
- Une lecture envoie une requête :
GET /macid/all(tous les Tilt entendus par le Tilt Pi). - Jamais plus vite que l'intervalle, compté depuis la dernière lecture
sur une horloge monotone (un changement d'heure ne fait pas relire plus
tôt) : ni par le bouton de test, ni par une reconnexion à Gladys, ni par
une configuration enregistrée sans changement, ni par l'onglet Découverte,
ni par un redémarrage du conteneur (l'heure de la dernière requête est
gardée sous
/data, écrite avant que la requête parte). Avant la fin de l'intervalle, le bouton de test affiche les dernières valeurs et l'heure de la prochaine lecture possible. - Lecture seule : l'intégration n'écrit jamais rien sur le Tilt Pi.
- Quand le Tilt Pi répond 429 ou une erreur 5xx, il est laissé
tranquille pendant le délai
Retry-Afterdonné, sinon 5 minutes, puis 10, 20... ; toujours entre 1 minute et 6 heures, aussi après un redémarrage. - Aucun Tilt entendu (entre deux brassins, ou quand le Tilt Pi vient de
vider ses emplacements après un Tilt muet plus de 2 minutes) est un cas
normal : le Tilt Pi répond
{}, le statut reste connecté et les Tilt connus passent en « pas de mesure récente ». - Pas de réponse, une page qui n'est pas celle d'un Tilt Pi (404, réponse
qui n'est ni une liste ni
{}) ou un accès refusé : réessayé à l'intervalle suivant seulement.
Quelles valeurs arrivent dans Gladys
- Chaque mesure n'est remise à Gladys qu'une fois. Une mesure est
reconnue à son heure (
timeStamp, que le Tilt Pi donne toujours), sinon à sa température, sa densité, son adresse MAC et sontimeStampbrut (jamais au signal ni aux champs d'horloge que le Tilt Pi réécrit sans nouvelle mesure). - Une mesure de 3 minutes au plus est envoyée comme valeur actuelle ; de 3 à 15 minutes, elle est envoyée datée (Gladys l'enregistre à son heure et aucune scène ne se déclenche).
- Un Tilt muet (hors de portée, pile vide, sorti du fermenteur) n'est
jamais présenté comme vivant : quand sa mesure ne change plus, rien
n'est envoyé, et le statut affiche « pas de mesure récente ». Une mesure
datée de plus de 15 minutes, mesurée avec l'horloge du Tilt Pi (la
Datede sa réponse, l'âge seul décide : un Raspberry Pi remis à une heure ancienne ne fait perdre aucune mesure), n'est jamais envoyée. Sans heure, la première mesure vue d'un Tilt n'est pas envoyée : seule une mesure qui a changé depuis la lecture précédente prouve que le Tilt est vivant. - Une valeur hors bornes (densité hors de 0,950 à 1,200, température hors de -10 à 60 °C, ce qu'un moût peut atteindre) n'est jamais envoyée ni ramenée dans les bornes ; le statut la signale. Les 0 °F que le Tilt Pi donne quand son étalonnage échoue sont ainsi écartés.
- Deux Tilt de la même couleur : sans l'option « ID by MAC » du Tilt Pi,
celui-ci n'a qu'une entrée par couleur, remplie tour à tour par les deux.
L'intégration garde une empreinte de l'adresse MAC de chaque couleur : si
elle change, rien n'est envoyé pour cette couleur et le statut affiche
« MAC changée : deux Tilt de cette couleur, ou Tilt remplacé ». Un Tilt
remplacé (l'ancienne adresse ne revient pas) reprend quand la même
nouvelle adresse est lue deux fois de suite. Si une adresse déjà
remplacée revient dans les 24 heures (A, puis B, puis A : deux Tilt qui
se relaient), la couleur est verrouillée : rien n'est envoyé pour
elle, et le statut affiche « deux Tilt de cette couleur (adresses MAC qui
alternent) : un seul Tilt par couleur est pris en charge », jusqu'à ce
qu'une seule adresse ait été lue seule pendant 24 heures, sur au moins 12
lectures (la moitié des lectures d'une journée, à l'intervalle choisi).
Le verrou est gardé sous
/data: ni un redémarrage ni une configuration enregistrée ne le lèvent. Un seul Tilt par couleur est pris en charge. L'option « ID by MAC » du Tilt Pi donne à chaque Tilt son entrée (RED:aa:bb:...), lue comme la couleur rouge ; mais si deux entrées ont la même couleur, aucune n'est envoyée non plus (« deux Tilt de cette couleur »). - Un appareil créé plus tard reçoit la dernière mesure, datée, si elle a moins de 15 minutes.
Ce qui est gardé sous /data
L'adresse lue, l'heure de la dernière requête, la pause, et pour chaque couleur rencontrée la clé de la dernière mesure vue (son heure, ou une empreinte courte de l'entrée) et une empreinte de 8 caractères de l'adresse MAC du Tilt (jamais l'adresse en clair), avec l'heure de leur dernière lecture et le verrou d'une couleur partagée par deux Tilt, jamais les valeurs. Le fichier est écrit au plus une fois par minute, sauf pour une pause ou une nouvelle couleur.
8 couleurs au plus ; 50 entrées au plus sont lues ; une réponse de plus de 256 Ko, ou de plus de 15 secondes, est abandonnée.
Identifiants externes
ext:tilt-pi:tilt:<couleur> (black, blue, green, orange, pink,
purple, red, yellow), puis :gravity ou :temperature. Ces
identifiants ne changent jamais.
Dépannage
- « pas de réponse » : vérifiez l'adresse et que la page
http://<adresse>:1880/du Tilt Pi s'ouvre depuis votre réseau. - « pas de Tilt Pi à cette adresse (404) » : un autre service répond à cette adresse ; vérifiez le port.
- « pas de mesure récente » : le Tilt Pi n'a pas entendu ce Tilt récemment (portée Bluetooth, pile, Tilt couché hors du liquide).
- Journaux : le niveau se règle avec la variable
LOG_LEVEL.
Vie privée
L'intégration ne parle qu'au Tilt Pi, sur votre réseau local, en HTTP. Elle ne garde des réponses que la couleur, la densité et la température.
Crédits
Construite d'après michaelheyman/tilt-pi
(MIT, Michael Heyman), la bibliothèque de l'intégration Tilt Pi de Home
Assistant : la route, les champs et leurs unités sont portés en JavaScript.
Sa notice est dans THIRD_PARTY_NOTICES.md. Tilt est une marque de son
propriétaire ; ce connecteur est gratuit et non officiel.
Paramètres de configuration
Voici les paramètres demandés par Tilt Pi dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Tilt Pi dans Gladys | section | Non | Connecteur non officiel, sans lien avec Tilt Hydrometer (Baron Brew Equipment). Il lit les densimètres Tilt qui flottent dans vos fermenteurs par l'application Tilt Pi installée sur un Raspberry Pi de votre réseau, par son API HTTP locale, sans cloud : la densité et la température de chaque Tilt, un appareil Gladys par couleur de Tilt. Le Tilt Pi écoute les Tilt en Bluetooth sur son Raspberry Pi ; Gladys n'utilise jamais le Bluetooth. Lecture seule : rien n'est jamais modifié sur le Tilt Pi. Jamais testé avec un vrai Tilt Pi. |
| Adresse du Tilt Pi | string | Non | L'adresse IP (ou le nom) du Raspberry Pi où tourne Tilt Pi, avec un port seulement s'il n'est pas 1880 (le port de la page Tilt Pi). Donnez-lui de préférence une adresse fixe dans votre box ; si elle change, saisissez la nouvelle : les appareils et leur historique sont gardés. |
| Intervalle de lecture (minutes) | number | Non | Chaque lecture envoie une requête au Tilt Pi. Rien ne lit plus tôt, ni le bouton de test, ni une reconnexion, ni un redémarrage. |
Comment installer Tilt Pi dans Gladys
- Dans Gladys, ouvrez Intégrations : Tilt Pi apparaît dans le catalogue, aux côtés des intégrations natives, avec un badge communautaire.
- Cliquez sur Installer. Gladys télécharge l'image Docker (
ghcr.io/lm1lc3n7/gladys-tilt-pi:0.1.1), 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). - Ouvrez l'écran Configuration de l'intégration, remplissez les paramètres, puis enregistrez.
- Vous pouvez aussi l'installer directement depuis l'URL de son dépôt : https://github.com/LM1LC3N7/gladys-tilt-pi.
Tilt Pi 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
Tilt Pi 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 LM1LC3N7, et non par l'équipe cœur de Gladys.
- Parcourir toutes les intégrations, natives et communautaires
- Créer et publier votre propre intégration externe
- Code source sur GitHub — source de cette documentation