SuperviMesh
Mon espace

Centre d'aide › Passerelle

Installer la passerelle sur un Raspberry Pi

De la carte SD vierge à la passerelle « en ligne » en une vingtaine de minutes.

La passerelle écoute votre réseau radio grâce à un boîtier MeshCore branché en USB, et transmet son état à SuperviMesh. Elle n'ouvre aucun port chez vous : toutes ses connexions sont sortantes et chiffrées.

Il vous faut

  • Un Raspberry Pi 4 ou 5, son alimentation officielle et une carte SD de 16 Go ou plus.
  • Un boîtier Heltec V3 ou V4 flashé en Companion USB et un câble USB de données.
  • Une connexion internet (câble réseau conseillé, ou Wi-Fi).

1. Préparer le Raspberry Pi

  1. Avec Raspberry Pi Imager, installez Raspberry Pi OS Lite (64 bits). Dans les réglages, choisissez un nom (par exemple passerelle), un utilisateur, le Wi-Fi si besoin, et activez SSH.
  2. Démarrez le Pi, puis depuis votre ordinateur : ssh utilisateur@passerelle.local
  3. Branchez le boîtier MeshCore, puis vérifiez qu'il est reconnu :
ls /dev/ttyUSB* /dev/ttyACM*

2. Créer la passerelle dans SuperviMesh

  1. Dans votre site, onglet Passerelles, choisissez Raspberry Pi + agent, donnez un nom et validez.
  2. Téléchargez les deux fichiers proposés (config.yaml et le certificat). Le mot de passe n'est affiché qu'une seule fois : s'il est perdu, vous pourrez en générer un nouveau.

3. Installer l'agent

Sur le Pi (pas sur votre ordinateur) :

curl -fsSL https://raw.githubusercontent.com/themistercash/supervimesh-agent/main/deploy/install.sh | sudo bash

Copiez ensuite les fichiers téléchargés, depuis votre ordinateur :

scp config.yaml supervimesh-ca.crt utilisateur@passerelle.local:/tmp/

Puis sur le Pi :

sudo install -m 640 -g supervimesh /tmp/config.yaml /etc/supervimesh/config.yaml
sudo install -m 644 /tmp/supervimesh-ca.crt /etc/supervimesh/
rm /tmp/config.yaml
sudo systemctl restart supervimesh-agent && journalctl -u supervimesh-agent -f

Vous devez lire « radio connectée » puis « connecté au broker ». Dans SuperviMesh, la passerelle passe en ligne en moins d'une minute.

4. Et ensuite

  • Mise à jour automatique chaque lundi : relancez l'installation avec -s -- --auto-update après sudo bash.
  • Tableau de bord local, même sans internet : http://passerelle.local:8080 depuis le même réseau.
  • Ajoutez vos relais à administrer : Administrer ses relais.

Astuce. Ça ne marche pas ? La page Dépannage couvre les cas les plus fréquents.