Intégration domotique Anova, gratuite et open source

Sous vide et fours Anova par l'API officielle : température, minuterie, arrêt ; démarrage en option.
Affiche vos Anova Precision Cooker (cuiseurs sous vide) et Anova Precision Oven dans Gladys par l'API officielle Anova Developer (un WebSocket du cloud d'Anova), et permet à Gladys de les arrêter, et de démarrer une cuisson sous vide si vous l'autorisez.
Jamais testé avec un vrai appareil : écrit d'après la documentation officielle et la bibliothèque de l'intégration Anova de Home Assistant. Sans lien avec Anova. Vos retours sont les bienvenus sur le forum Gladys.
Ce qu'il faut
- Un compte Anova avec vos appareils appairés dans l'application Anova.
- Un jeton d'accès personnel : dans l'application Anova Oven (même pour
un cuiseur sous vide : connectez-vous avec le même compte), allez dans
Plus → Développeur → Personal Access Tokens, donnez-lui un nom et créez-le.
Il commence par
anova-. Un compte peut avoir jusqu'à 10 jetons. - L'usage de l'API est soumis aux conditions d'utilisation de l'API Anova (https://developer.anovaculinary.com/terms) : usage personnel, non commercial.
Configuration
- Collez le jeton dans Jeton d'accès personnel et enregistrez. Le jeton est gardé par Gladys dans sa base, jamais réaffiché, envoyé seulement à Anova.
- Le statut doit indiquer « Connecté à Anova : N appareils ».
- Ouvrez l'onglet Découverte et ajoutez vos appareils.
Fonctionnalités de chaque appareil
| Fonctionnalité | Precision Cooker | Precision Oven |
|---|---|---|
| Température | de l'eau (°C) | du four, bulbe sec ou humide (°C) |
| Température visée | lecture seule (°C) | lecture seule, pendant la cuisson (°C) |
| Temps restant | minutes (0 à l'arrêt) | minutes, quand la minuterie tourne |
| Durée de cuisson | minutes | minutes, pendant la cuisson |
| État | à l'arrêt, préchauffage, cuisson, maintien… | à l'arrêt ou cuisson |
| Alerte | niveau d'eau bas ou critique, fuite, trop chaud | réservoir vide, porte ouverte |
| Arrêter la cuisson | bouton | bouton |
Une valeur qu'Anova ne donne pas reste inconnue : elle n'est jamais affichée à 0. Anova envoie un état quand quelque chose change ; sans rien pendant 25 min, l'intégration rouvre la connexion pour avoir des états frais (Anova ferme une connexion inactive au bout de 30 min).
Les valeurs du four viennent de la description communautaire de ses messages d'état : elles ne sont pas dans la documentation officielle. Les cuiseurs A3, A4/A5 et A6/A7 envoient leur état sous des formes différentes, toutes lues ; les autres types sont lus s'ils envoient l'une de ces formes.
Arrêter
Le bouton Arrêter la cuisson de chaque appareil, et l'action de scène
Anova : arrêter la cuisson, ne demandent aucune option et ne sont jamais
refusés : ni par l'option de démarrage, ni par une pause demandée par Anova
(HTTP 429), ni par un jeton refusé (un essai par clic, et un pour un arrêt
gardé au redémarrage), ni par un /data lent ou illisible. Sans connexion,
une connexion est ouverte tout de suite ; si elle ne s'ouvre pas en 3,5 s,
l'arrêt est gardé (aussi dans /data, 10 min) et envoyé dès qu'une connexion
s'ouvre.
Un arrêt part avec un ping : sans la réponse, un message ou le pong sous 1,5 s, la connexion est jugée morte (une box redémarrée, par exemple), coupée et rouverte aussitôt, et l'arrêt part sur la nouvelle (3 connexions mortes au plus par arrêt, puis le délai entre essais). Un tel envoi ne compte pas.
Il part 3 fois en tout au plus, de nouveau tant que l'appareil indique la même
cuisson 20 s après ; il n'est pas renvoyé si une autre cuisson apparaît (lancée
ensuite depuis l'application ou l'appareil). Un clic part toujours tout de
suite, quelle que soit la cuisson affichée, y compris sur la connexion qu'il a
ouverte lui-même dans ses 3,5 s. Seul un arrêt gardé (pas envoyé dans ces
3,5 s, ou relu de /data après un redémarrage) dont la cuisson est connue la
vérifie sur une nouvelle connexion, états reçus à l'ouverture compris (2 s au
plus) : à l'arrêt, c'est fini ; une autre cuisson, il ne part pas ; la même
cuisson, ou pas d'état, il part. Un arrêt déjà accepté par Anova est vérifié de
la même façon avant d'être renvoyé. L'identité de la cuisson est gardée dans
/data. Un arrêt annule aussi un démarrage pas encore envoyé.
Ce qu'un arrêt ne peut pas faire : joindre Anova sans jeton, ou avant que le
jeton soit lu depuis Gladys après un redémarrage (le jeton n'est jamais écrit
dans /data).
L'action de scène donne un résultat : confirmed (l'appareil indique l'arrêt),
accepted (Anova a répondu ok), refused (Anova a répondu une erreur : revérifié
et renvoyé), sent (envoyé, pas encore de réponse), queued (envoyé dès la
connexion) ou skipped (arrêt gardé non envoyé : une autre cuisson a été lancée).
Démarrer une cuisson sous vide (désactivé par défaut)
Démarrer chauffe de l'eau : il faut l'option Autoriser le démarrage d'une cuisson, désactivée par défaut. L'action de scène Anova : démarrer une cuisson sous vide prend alors un Precision Cooker, une température (25 à 92 °C, arrondie à 0,1 °C) et une minuterie (minutes entières, 1 à 5999). Vérifiez avant que le cuiseur est dans l'eau.
Le démarrage est refusé, et rien n'est envoyé, quand :
- l'option est désactivée (revérifiée juste avant l'envoi) ;
- l'appareil est un four (démarrer un four n'est pas pris en charge), ou n'est pas sur le compte Anova ;
- la température ou la minuterie est hors bornes ou n'est pas un nombre ;
- la connexion est fermée, ou il n'y a pas d'état du cuiseur sur la connexion en cours depuis moins de 30 minutes ;
- le cuiseur cuit déjà (ou son état est inconnu), ou signale un problème (niveau d'eau, fuite, trop chaud, panne) ;
- le cuiseur démarre ou se met à jour (état inconnu ou occupé) ;
- un autre démarrage du cuiseur est en cours, ou aucun état n'est arrivé depuis le dernier démarrage (un démarrage sans confirmation bloque le suivant jusqu'à un état reçu après lui) ;
- un arrêt du cuiseur est en cours, ou a été demandé entre-temps ;
/datane peut pas être écrit en 10 s (le démarrage y est noté avant de partir ; au-delà de 10 s, rien n'est envoyé : Gladys n'affiche jamais un échec pendant que l'eau chauffe).
Résultats : started (un état montre la cuisson), accepted (Anova a répondu
ok, pas encore d'état) ou sent (pas de réponse : sans confirmation). Un
démarrage refusé par Anova fait échouer l'action. Une cuisson en cours n'est
jamais modifiée : arrêtez-la, puis redémarrez. Changer la consigne pendant une
cuisson n'est pas dans cette version (les jetons d'accès personnels ne
permettent que démarrer, arrêter et l'unité de température).
Arrêt à la fin de la minuterie (option, désactivée par défaut)
Comme dans l'application Anova, un Precision Cooker garde l'eau à température quand sa minuterie se termine. Avec Arrêter le cuiseur à la fin de sa minuterie, Gladys envoie un arrêt, une fois par cuisson, quand le cuiseur indique sa minuterie finie.
Connexion, limites et confidentialité
- Une connexion par intégration, adresse de la documentation ; le jeton va dans
l'adresse comme la documentation l'exige : il n'est jamais journalisé, jamais
affiché, jamais écrit dans
/data. Le User-Agent indiquegladys-anova/<version>. - Anova coupe la connexion quand sa limite de débit est atteinte : l'intégration
se reconnecte après 5 s, 15 s, 30 s, 1, 2, 5, 10 puis 30 min (de la moitié au
tout de chaque palier), et repart de 5 s quand une connexion a tenu 3 min.
Après un redémarrage, jamais plus vite (l'heure de la dernière tentative est
dans
/data). - HTTP 429 : pause de la durée de son Retry-After (1 min à 6 h, 15 min sans),
gardée dans
/dataau redémarrage. Un arrêt passe quand même. - Jeton refusé : un HTTP 401, ou (ce que fait Anova d'un jeton invalide) une
connexion fermée par Anova avec le code 1005 dans les 5 s après son
ouverture, sans aucun message, deux fois de suite. Une coupure réseau ou un
autre code (1006, 1012, 1013…) n'est jamais un refus. Rien n'est renvoyé tout seul : enregistrez un
nouveau jeton, ou cliquez sur Tester la connexion (un nouvel essai). Seuls
8 bits d'une empreinte du jeton refusé sont gardés dans
/data. Un 403 ou un autre code n'est pas un refus : l'intégration espace ses essais. /dataillisible : rien n'est envoyé tout seul (relu toutes les 10 s) ; Tester la connexion repart d'un état vide.- Les messages de plus de 256 Ko sont coupés avant d'être lus.
Tester la connexion
Se connecte tout de suite si besoin (au plus toutes les 30 s, pas pendant une pause 429) et indique combien d'appareils Anova liste.
Paramètres de configuration
Voici les paramètres demandés par Anova dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Votre compte Anova | section | Non | Affiche vos Anova Precision Cooker (sous vide) et Precision Oven dans Gladys par l'API officielle Anova Developer, en temps réel : température, consigne, temps restant, état et alertes, et un bouton Arrêter. Créez un jeton d'accès personnel dans l'application Anova Oven (même pour un cuiseur sous vide) : Plus, Développeur, Personal Access Tokens. Collez-le ci-dessous, enregistrez, puis ajoutez les appareils depuis l'onglet Découverte. Démarrer une cuisson sous vide est une action de scène qui demande l'option ci-dessous, désactivée par défaut ; arrêter ne demande aucune option. Démarrer un four n'est pas pris en charge. Jamais testé avec un vrai appareil. Sans lien avec Anova. |
| Jeton d'accès personnel | secret | Oui | Commence par « anova- ». Créé dans l'application Anova Oven (Plus, Développeur, Personal Access Tokens). Gardé par Gladys dans sa base, jamais réaffiché, envoyé seulement à Anova. |
| Autoriser le démarrage d'une cuisson | boolean | Non | Désactivé par défaut. Activé : l'action de scène « Démarrer une cuisson sous vide » peut chauffer l'eau d'un Precision Cooker (25 à 92 °C, 1 min à 99 h 59). Vérifiez avant que le cuiseur est dans l'eau. Désactivé : cette action n'envoie rien. Arrêter n'a jamais besoin de cette option. |
| Arrêter le cuiseur à la fin de sa minuterie | boolean | Non | Désactivé par défaut : comme dans l'application Anova, un Precision Cooker garde l'eau à température quand sa minuterie se termine. Activé : Gladys envoie un arrêt, une fois par cuisson, quand le cuiseur indique sa minuterie finie. |
| Langue des noms des fonctionnalités | select | Non | Sert aux noms des fonctionnalités des appareils ajoutés désormais, aux textes d'état et aux erreurs des commandes. |
Comment installer Anova dans Gladys
- Dans Gladys, ouvrez Intégrations : Anova 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-anova: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-anova.
Anova 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
Anova 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