Via Home Assistant
Si vous utilisez Home Assistant (HA) pour de la domotique chez vous et que vous pouvez y connecter un compagnon, il peut servir à plein de choses, notamment transmettre vers la carte internet l’existence, la position et la dernière annonce des répéteurs autour de vous (avec plusieurs sauts, pas juste les contacts directs). C’est très pratique car ça évite d’avoir à le faire à la main ET ça indique leur « fraîcheur », à savoir s’ils communiquent régulièrement ou non, ce qui peut permettre de repérer un répéteur HS.
Si vous ne l’avez pas déjà fait, installez HACS. Il s’agit d’un fournisseur d’extensions « non officielles », ce qui permet l’intégration de systèmes que Home Assistant ne prend pas en charge nativement. Je passe les détails de l’installation car ça sort un peu de ce tuto.
Ensuite dans l’interface d’administration de HA, cliquez sur HACS dans le menu gauche, puis sur les 3 points en haut à droite et choisissez « Dépôts personnalisés ».
Collez l’adresse suivante dans la case « dépôt » :
https://github.com/meshcore-dev/meshcore-ha
Choisissez « intégration » comme « type » et cliquez sur le bouton « ajouter ».
Fermez la fenêtre, et dans le champ de recherche des intégrations possibles, recherchez MeshCore. Cliquez dessus et cliquez sur le bouton « télécharger » en bas à droite. Laissez les paramètres par défaut.
En parallèle, flashez un compagnon en USB via le flasher officiel MeshCore, paramétrez-le (nom, preset radio, envoyez une annonce …) et branchez-le en USB sur la machine qui fait tourner Home Assistant. S’il s’agit d’une machine virtuelle (proxmox par exemple), n’oubliez pas de passer le périphérique USB à la machine virtuelle.
Redémarrez Home Assistant.
Rendez-vous dans la section terminal et tapez la commande suivante :
ls /dev/serial/by-id
Vous devriez obtenir une liste des périphériques USB disponibles, et retrouver celui qui correspond à votre compagnon. Le nom n’est pas toujours évident, dans le cas de mon ESP32 c’était par exemple « usb-Espressif_USB_JTAG_serial_debug_unit_… »
Copiez ce nom, nous allons en avoir besoin plus tard.
Cliquez sur le menu de gauches « Paramètres », puis « Appareils et service ». Cliquez sur le bouton « Ajouter une intégration » en bas à droite
Sélectionnez MeshCore dans la liste, choisissez USB comme type de connexion.
Dans le champ « USB Device Path », mettez :
/dev/serial/by-id/LeNomQueVousVenezDeCopier
par exemple pour moi : /dev/serial/by-id/usb-Espressif_USB_JTAG_serial_debug_unit…
Laissez les autres paramètres par défaut et validez.
Si tout a fonctionné vous devriez arriver sur une liste qui récupère le nom MeshCore de votre compagnon.
Cliquez sur L’icône engrenage à droite du nom du compagnon, sélectionnez le bouton radio « global settings » et validez.
Dans la liste de paramètres, cochez la case « Enable Map Auto Uploader… » et validez.
Normalement c’est fonctionnel.
Pour vérifier, connectez-vous (avec un autre compagnon par exemple) à un de vos répéteurs et forcez l’envoi d’une annonce (advert). Elle va être captée par le compagnon relié à Home Assistant et l’information sera relayée via internet à la carte https://map.meshcore.io/
Il peut y avoir quelques minutes de délai, mais rapidement vous devriez voir le répéteur en question apparaître en vert sur la carte. Dans les heures qui suivent les autres répéteurs devraient être verts également.
L’intégration MeshCore-HA permet également bien d’autres fonctions, mais attention à ne pas faire n’importe quoi qui risquerait d’occuper la faible bande passante disponible en LoRa. N’allez pas récupérer la température et le niveau de batterie de tous vos répéteurs toutes les heures par exemple. Souvenez-vous bien d’une chose : la force et la résilience de MeshCore réside dans son principe d’aller chercher l’information juste au moment où on en a besoin et non pas d’automatiser la transmission de données que personnes ne regarde !
Sans Home Assistant
Il est également possible de brancher directement le compagnon sur un serveur qui ne fait pas tourner home assistant. Celà utilise node-js (un mini serveur) et un peu plus de bricolage. Sachez que ça existe, mais c’est pour les plus geeks.
On vous laisse avec le lien et la doc officielle :
https://github.com/recrof/map.meshcore.io-uploader
Bon courage 😉