Episode 7 – Domotiser la distribution de croquettes pour animaux

On se lance aujourd’hui dans un sujet assez complexe, et qui est à la mode, la distribution automatisée de croquettes pour vos animaux de compagnie préférés. Aujourd’hui, très peu de marques proposent des intégrations simplifiées sur Jeedom ou autres systèmes domotiques. Toutefois, nous allons voir qu’il est possible de faire une intégration, ainsi que quelques commandes sympas ; en utilisant le fait que les distributeurs se connectent via le Wifi domestique.

Présentation du distributeur de croquettes

Pour ma part, j’ai un Balimo 4L, ancienne génération, compatible Tuya, que j’ai acheté il y a quelques années. Comme son nom l’indique, il possède un réservoir de 4L convenant aux croquettes pour chat. J’ai testé plusieurs tailles de croquettes et aucune n’a posé de problème.
La dernière version est disponible entre 40 et 90€, en fonction de s’il possède une caméra ou pas. Mon modèle n’en possédant pas, je n’ai pas testé si Jeedom sait manipuler le flux vidéo issu du distributeur.
Des retours que j’ai pu voir, ce tutoriel fonctionne avec tous les distributeurs de croquettes, du moment qu’ils sont connectés à votre WiFi ainsi qu’à l’application Tuya.

Connexion à Jeedom

Pré-requis

La première étape pour pouvoir réaliser ce tutoriel, est d’avoir le distributeur connecté sur votre Wifi domestique, et de l’avoir ajouté sur votre compte Tuya.
La procédure d’appareillage dépendra de votre modèle, mais elle reste expliquée dans l’application Tuya et/ou dans le manuel utilisateur.
Pour la grande partie des distributeurs, il s’agit d’appuyer sur le bouton Reset de l’appareil jusqu’à entendre un bruit, puis de lancer la détection automatique d’équipement depuis l’application en étant (très) à proximité du distributeur.
Autre chose à savoir, ces distributeurs utilisent la fréquence radio 2,4 GHz et non la 5 GHz (comme la grande majorité de nos appareils électroniques). Si jamais vous l’avez désactivée sur votre Wifi, l’appareil ne pourra pas se connecter.

Plugin WifilightV2

Si vous ne l’avez pas déjà, commencez par installer le plugin WifilightV2. Il est actuellement au prix de 6€ sur le market Jeedom.
Une fois installé, activez-le.

Création d’un projet développeur Tuya

Dans la partie Configuration du plugin, vous pouvez vous apercevoir que vous allez devoir renseigner votre access ID et votre token pour Tuya. Et pour les non habitués à l’informatique, il ne s’agit pas de votre nom d’utilisateur Tuya avec votre mot de passe.

L’entreprise chinoise Tuya a pris comme postulat que pour manipuler les données issues des équipements, il fallait être un développeur… Vous l’aurez donc compris, on va se faire passer pour un développeur et créer un projet pour obtenir notre Access Id.

Commencez par créer un compte développeur Tuya sur https://iot.tuya.com/.
Connectez-vous avec votre login Tuya.
Si vous n’en avez pas, ce qui est possible, créez-en un en cliquant sur Sign Up.
Si on vous le demande, validez les clauses légales.
NB : Utilisez un mot de passe différent et unique à Tuya, ce n’est pas très clair l’exploitabilité qui est faites derrière avec nos données personnelles.

Lors de votre première connexion, un tutoriel du fonctionnement du site vous sera présenté, vous pouvez le regarder ou le passer, à votre guise.
Puis un choix de type de compte vous sera également demandé, vous pouvez prendre « Individual Developer » puis valider.

Création d’un projet sur Tuya Platform

Commencez par cliquer sur Cloud dans la barre d’icones à gauche de votre écran. Puis sur Development.
Puis pour finir sur le bouton Create Cloud Project que vous aurez à votre droite.

Remplissez les champs obligatoires avec les informations que vous souhaitez, elles n’ont pas d’importance.
Le seul avec une importance est le DataCenter, qui doit correspondre avec votre compte Tuya. Si vous êtes en France choisissez Central Europe Data Center. Si vous n’êtes pas en France, vous pouvez chercher votre datacenter ici.
Puis une page sur les autorisations d’API apparaitra, que vous pouvez fermer en cliquant sur Skip.

Ouvrez votre projet tout juste créé.
Maintenant on va chercher à lier notre application mobile Tuya qui contiendra le distributeur avec notre projet.
Commencez par aller dans l’onglet Devices, puis dans Link Tuya App Account. Puis cliquez sur le bouton Add App Account.

Scanner le QRCode qui apparaitra avec votre application mobile Tuya.
La possibilité de scanner se trouver dans l’onglet Profil.
Ensuite confirmez la connexion sur votre téléphone.

Si la connexion fonctionne, cette page apparaitra sur votre ordinateur.
Validez avec ce qui est présélectionné par défaut.
Vous verrez que votre projet détectera par lui même l’ensemble des éléments Tuya que vous avez rattaché sur l’application mobile, et les remontera dans le projet.

Maintenant, on va devoir modifier les autorisations pour pouvoir autoriser une inclusion de l’équipement depuis votre système Jeedom.
Cliquez sur l’icone Cloud à gauche, puis sur Cloud Services.
Souscrivez à la partie IoT Core en cliquant sur Free Trials à gauche, et en acceptant les écrans suivants.

Récupération des informations de connexion Tuya

Inclusion du distributeur de croquettes

On peut dorénavant passer à l’inclusion du distributeur de croquettes au sein de Jeedom.
Sur la page du plugin Wifilight, cliquez sur Tuya Passer en inclusion.

Si l’inclusion se passe bien, votre distributeur de croquettes apparaitra de lui-même dans vos équipements.
Si cela ne se passe pas bien, vous pouvez activer les logs du plugin pour avoir plus d’infos.

Parmi les erreurs fréquentes, il y en a deux que vous pouvez regarder directement :

• AccessId et/ou AccessSecret incorrects : vérifiez que vous ne vous êtes pas trompés lors de la copie
• Wifi différents entre la box domotique et le distributeur de croquettes. Si vous avez plusieurs Wifi dans votre configuration (comme chez moi par exemple avec un Wifi IoT et un Wifi Domestique), l’inclusion ne fonctionnera pas.

Vous pouvez modifier le nom et d’autres paramètres pour adapter l’équipement à votre maison.

Attribution d’une IP fixe

La prochaine étape est d’attribuer une adresse IP fixe à votre distributeur de croquettes car le plugin a besoin qu’elle soit figée, l’ip étant renseignée directement dans la configuration de l’équipement.

La procédure dépend de votre routeur (souvent votre box), une recherche internet sera votre meilleur allié si vous ne savez pas comment faire.

Modification des commandes

Si vous allez voir sur votre dashboard à quoi ressemble nativement le widget de votre distributeur de croquettes, vous verrez qu’il n’est pas très digeste.

Nous allons donc voir pour modifier ça. Allez dans le plugin WifilightV2, puis sur votre équipement, puis dans l’onglet Commandes.

Les modifications sont totalement à votre main pour faire apparaître ce dont vous avez besoin. Vous pouvez changer des noms de commandes, afficher ou cacher des commandes, etc.
Je vais vous montrer ce que moi j’ai fait de mon côté, ayant besoin d’un widget minimaliste, avec l’information pour voir si le distributeur était bien en ligne (donc alimenté) et pouvoir faire descendre des croquettes au besoin sans aller jusqu’au distributeur.

• Pour pouvoir voir l’état de connexion, j’ai affiché la commande Connecté car elle est cachée par défaut, puis inverser l’affichage pour afficher le bon état.
• J’ai renommé la commande Manual_feed_3_VALUE en Quantité.
• J’ai masqué l’ensemble des autres commandes

Voici ce que donne au final le widget une fois allégé. En jouant avec le slider sur la quantité cela active la distribution de croquettes.
Et vous verrez à l’utilisation que ce n’est pas forcément le plus pratique, je suis donc passé par des scénarios, que l’on va voir juste après.

Ajout d’une action sur un design

Ayant des designs qui sont diffusés sur une tablette, je cherche souvent à optimiser la place que prend chacun de mes widgets. J’ai donc créer un bouton permettant de lancer des descentes de croquettes.

Création du scénario

Commencez par créer un scénario en lui donnant le nom et l’emplacement que vous souhaitez.
Puis dans la partie Scénario, créer une action avec la commande [Localisation][Nom équipement][Quantité], puis en valeur ce que vous avez l’habitude de donner à vos animaux. Pour ma part j’appuie trois fois sur le bouton du distributeur quand je leur donne manuellement, j’ai donc mis 3.
Enregistrer et c’est déjà terminé !

Si vous souhaitez le voir et pouvoir l’utiliser en cliquant sur vos dashboard et/ou design, vous n’avez qu’à l’afficher et le tour est joué.

Création du virtuel – Optionnel

Pour pouvoir créer un virtuel, vous avez besoin d’avoir le plugin Virtuel. Si vous ne l’avez pas déjà, installé le depuis le market Jeedom, il est gratuit.
J’ai décidé d’utiliser un virtuel plutôt que l’affichage par défaut car actuellement Jeedom ne permet pas de custom l’affichage des briques de scénarios. Et pour mes design, je cherche à avoir des widget avec un fond transparent, c’est pour cela que je suis passé par un virtuel.

Pour ce faire, commencez par créer un virtuel avec le nom que vous souhaitez et rendez le actif. Au niveau des commandes, créez une action virtuelle, comme dans le screen ci-dessous. Une fois sauvegardé, l’info virtuelle se créera toute seule.

Vérifiez que le type créé est binaire, et retirez l’affichage pour ne pas que l’info apparaisse dans widget.
Dans l’action renseignez le paramètre pour pointer sur l’info virtuelle Etat.
J’ai mis une petite icone de chat dans le nom de l’action pour que ça remplace le texte, mais pareil, libre à vous de faire ce qu’il vous plaira.
Ensuite il faut configurer l’appel au scénario depuis le virtuel. Il existe plusieurs façons de faire mais pour ma part j’ajoute l’appel au scénario avant l’exécution de la commande du bouton (qui ne fait rien au final).
Cela se passe en trois étapes :

• Cliquez sur le rouage de votre action
• Allez dans l’onglet Configuration
• Ajoutez une action après exécution de la commande, qui appelle un scénario. Puis recherchez votre scénario et indiquez lui l’action Démarrer.

Si vous retournez dans votre scénario, vous allez voir le lien avec votre virtuel apparaitre.

Ajout d’une action sur le cube T1 Pro

J’ai voulu aller encore un peu plus loin dans l’automatisation afin de tester le cube T1 Pro de chez Aqara. Voici le principe que j’ai voulu appliquer, lorsque je mets le cube sur la face 2, ça lance le scénario de distribution de croquettes.
Cela se fait dans le scénario de la manière suivante :

• Dans la configuration du scenario, il faut ajouter un déclencheur lorsque l’état du bouton change. Il faut pour cela choisir un déclenchement de type provoqué.
• Puis dans le scénario, faire un test sur la valeur du cube (il faut savoir que la valeur des faces n’est pas leur valeur naturelle, exemple la face 2 n’a pas pour valeur 2 mais 1025).

On peut aussi imaginer utiliser un simple bouton connecté pour lancer le scénario, et le principe sera le même.

Pour aller encore plus loin, on pourrait imaginer passer par une balance connectée ou par une camera, ou bien encore un détecteur de présence proche du distributeur.