🐰 Le Terrier

Ton Mir:ror sur Le Terrier

Un Ztamp ou un Nano:ztag posé sur le Mir:ror fait ce qu'il fait sur le nez de ton lapin. Retourner le Mir:ror, puis le remettre à l'endroit, sont deux gestes de plus à associer.

Ce qu'il te faut

Le Mir:ror, et un ordinateur sous Linux toujours allumé et connecté — un Raspberry Pi est idéal — avec Python 3 (déjà présent sur Raspberry Pi OS). Il se branche sur son port USB. Windows et macOS ne savent pas le lire de cette façon. Compte une dizaine de minutes, en tapant les commandes ci-dessous dans un terminal de cet ordinateur.

L'installer

1. Récupère le lecteur. Un seul fichier Python, rien d'autre à installer :

mkdir -p ~/mirror
curl -fsSLo ~/mirror/mirror.py https://raw.githubusercontent.com/ClaraVnk/nabaztag/main/mirror/mirror.py

2. Autorise-le à ouvrir le Mir:ror. Branche le Mir:ror, puis donne-lui un nom fixe et laisse ton utilisateur le lire. Déconnecte-toi puis reconnecte-toi après la ligne usermod. La dernière ligne doit afficher /dev/violet-mirror.

echo 'SUBSYSTEM=="hidraw", ATTRS{idVendor}=="1da8", ATTRS{idProduct}=="1301", MODE="0660", GROUP="plugdev", SYMLINK+="violet-mirror"' \
  | sudo tee /etc/udev/rules.d/99-violet-mirror.rules
sudo udevadm control --reload && sudo udevadm trigger
sudo usermod -aG plugdev $USER
ls -l /dev/violet-mirror

3. Dis-lui pour quel lapin. Crée un jeton d'API sur la page Home Assistant, et relève l'adresse de ton lapin sur sa page, dans la carte Mir:ror. Mets les deux dans un fichier que toi seul peux lire, à la place des exemples :

mkdir -p ~/.config
cat > ~/.config/violet-mirror.env <<'END'
TERRIER_TOKEN=trr_...
RABBIT_MAC=0019db123456
END
chmod 600 ~/.config/violet-mirror.env

4. Essaie-le. Il affiche reading the Mir:ror on /dev/violet-mirror. Pose un Ztamp dessus : tag … put on it. Arrête-le avec Ctrl-C.

set -a; . ~/.config/violet-mirror.env; set +a
python3 ~/mirror/mirror.py

5. Lance-le tout seul. Pour qu'il tourne après chaque redémarrage de l'ordinateur, sans que tu sois connecté :

mkdir -p ~/.config/systemd/user
cat > ~/.config/systemd/user/violet-mirror.service <<'END'
[Unit]
Description=Violet Mir:ror reader for Le Terrier

[Service]
EnvironmentFile=%h/.config/violet-mirror.env
ExecStart=/usr/bin/python3 %h/mirror/mirror.py
Restart=always

[Install]
WantedBy=default.target
END
systemctl --user daemon-reload
systemctl --user enable --now violet-mirror
sudo loginctl enable-linger $USER

Associer un tag

Un tag posé sur le Mir:ror apparaît sur la page du lapin, parmi les tags récents, prêt à recevoir une action — comme un tag montré au nez du lapin. La carte Mir:ror de cette page dit quand le Mir:ror a parlé au lapin pour la dernière fois.

Coincé ? Solutions rapides

Ce que dit le lecteur, en direct :

journalctl --user -u violet-mirror -f
Il dit « no Mir:ror plugged in »

ls -l /dev/violet-mirror n'affiche rien : débranche le Mir:ror, rebranche-le, puis refais l'étape 2.

Il dit « Permission denied »

Ton utilisateur n'est pas encore dans le groupe plugdev : déconnecte-toi et reconnecte-toi (ou redémarre l'ordinateur), puis vérifie avec groups.

Il dit « the warren refused » avec 401 ou 404

401 : le jeton est faux ou a été révoqué — crées-en un nouveau. 404 : l'adresse dans RABBIT_MAC n'est pas celle d'un de tes lapins — recopie-la depuis la page du lapin, 12 caractères sans deux-points.

Le tag est lu mais le lapin ne fait rien

Le tag n'a pas encore d'action : donne-lui en une sur la page du lapin, parmi les tags récents.