SPL Sense pour Linux

• 1: Matériel et système d'exploitation
• 2: Installation
• 3: Mise à jour
• 4: Exploitation

1 - Matériel et système d'exploitation

Matériel

Tu trouves le Raspberry Pi dans le commerce électronique. Nous avons testé :

• Raspberry Pi 4 ou 5, Model B (toutes les variantes de mémoire)
• pour l’alimentation par le câble réseau : le module Power-over-Ethernet officiel (PoE HAT) pour les Raspberry Pi 3B+ et 4B

Carte mémoire

La carte mémoire est la pièce la plus susceptible de tomber en panne après de nombreuses heures de fonctionnement. SPL Sense écrit peu, mais une carte micro SD de qualité en vaut tout de même la peine. Nous avons eu de bonnes expériences avec la « SanDisk Extreme Pro ».

La taille n’est guère un problème : Raspberry Pi OS avec bureau tient sur 8 Go, et même beaucoup de données de mesure occupent à peine un gigaoctet. Nous recommandons au moins 16 Go.

Installer le système d’exploitation

1. Installe Raspberry Pi Imager sur ton ordinateur (disponible sur le site web de Raspberry Pi).
2. Écris avec lui Raspberry Pi OS with Desktop sur la carte mémoire.
   • Choisis 32 ou 64 bits. Pour un Raspberry Pi 5, nous recommandons 64 bits. Note ton choix : tu auras besoin du paquet correspondant lors de l’installation de SPL Sense.
   • Dans les paramètres de l’Imager, définis un nom d’utilisateur et un mot de passe, et active SSH si tu veux configurer le Raspberry Pi depuis un autre ordinateur.

Si tu as l’habitude de la ligne de commande et n’as pas besoin d’écran sur le Raspberry Pi, Raspberry Pi OS Lite sans bureau suffit. Ce guide part de la variante avec bureau.

Assembler

1. Monte le Raspberry Pi avec les modules souhaités dans le boîtier et insère la carte mémoire.
2. Branche l’écran, le clavier et la souris.
3. Branche l’alimentation (ou le câble réseau en PoE). Le Raspberry Pi démarre.
4. Au premier démarrage, configure une connexion réseau, par câble ou Wi-Fi. SPL Sense sera téléchargé depuis Internet à l’étape suivante.
5. Si ce n’est pas déjà fait dans l’Imager : active SSH sous menu Raspberry › Préférences › Configuration du Raspberry Pi › Interfaces.
6. Note l’adresse IP du Raspberry Pi : elle apparaît lorsque tu passes la souris sur l’icône réseau en haut à droite.

2 - Installation

SPL Sense s’installe en ligne de commande, soit directement sur le Raspberry Pi (programme Terminal), soit par SSH depuis un autre ordinateur. Avec SSH, tu peux copier-coller les commandes et éviter les fautes de frappe.

Se connecter par SSH

Ton ordinateur doit être dans le même réseau que le Raspberry Pi.

• macOS et Linux : dans le terminal ssh <utilisateur>@<adresse-ip>, par exemple ssh pi@192.168.10.144
• Windows : dans le terminal (PowerShell) également ssh <utilisateur>@<adresse-ip>, ou avec PuTTY : saisis l’adresse IP sous Host Name, règle Connection type sur SSH, puis Open

L’utilisateur et le mot de passe sont ceux que tu as définis dans Raspberry Pi Imager.

Remarques générales

• Linux distingue les majuscules et les minuscules. Reprends les commandes exactement.
• Une commande réussie n’affiche généralement aucun message. Si un message d’erreur apparaît, lis-le et corrige l’erreur avant de continuer.
• Au premier sudo, le Raspberry Pi demande le mot de passe de ton utilisateur.

1. Créer un utilisateur pour SPL Sense

sudo useradd splsense -m -d /opt/splsense-data

SPL Sense s’exécute sous cet utilisateur dédié et enregistre ses données dans /opt/splsense-data.

2. Télécharger et décompresser SPL Sense

Pour un système d’exploitation 32 bits :

wget https://r.spl.swiss/dl/splsense/linux-arm -O splsense-latest.tar.gz
tar xfvz splsense-latest.tar.gz
rm splsense-latest.tar.gz

Pour un système d’exploitation 64 bits :

wget https://r.spl.swiss/dl/splsense/linux-arm64 -O splsense-latest.tar.gz
tar xfvz splsense-latest.tar.gz
rm splsense-latest.tar.gz

3. Déplacer le programme à sa place

sudo mv splsense /usr/local
sudo chown splsense /usr/local/splsense -R
sudo chgrp splsense /usr/local/splsense -R

4. Configurer le service

Pour que SPL Sense démarre automatiquement au boot, configure-le comme service système. Ouvre un nouveau fichier dans l’éditeur nano :

sudo nano /etc/systemd/system/splsense.service

Copie-y ce contenu :

[Unit]
Description=SPL Sense
After=network-online.target
User=splsense
Group=splsense

[Service]
Type=simple
ExecStart=/usr/local/splsense/SplSense.App.Browser
WorkingDirectory=/usr/local/splsense
Environment="ASPNETCORE_URLS=http://0.0.0.0:8080"
Environment="SPLSENSE_DATA=/opt/splsense-data"

[Install]
WantedBy=multi-user.target

Enregistrer et fermer : Ctrl+X, puis confirmer avec Y.

La ligne ASPNETCORE_URLS définit l’adresse et le port auxquels SPL Sense est accessible : ici 8080 sur toutes les interfaces réseau. Indique ici un autre port si nécessaire. Sans cette ligne, SPL Sense n’est accessible que sur le Raspberry Pi lui-même (http://localhost:5000).

5. Activer et démarrer le service

sudo systemctl enable splsense
sudo service splsense start

6. Redémarrer

sudo reboot

Terminé

SPL Sense démarre désormais automatiquement à chaque boot et tourne en arrière-plan. Dans le navigateur du Raspberry Pi ou d’un autre appareil du réseau, ouvre l’adresse IP avec le port, par exemple http://192.168.10.144:8080.

La suite se déroule comme sur toute autre plateforme, par exemple avec le démarrage rapide. Pour l’exploitation comme station de mesure fixe, voir Exploitation.

3 - Mise à jour

Automatiquement

Sous Linux, SPL Sense se met à jour lui-même comme sur les autres plateformes : lorsqu’une nouvelle version est disponible, Mise à jour disponible apparaît dans le tableau de bord. Arrête la mesure et clique sur Mise à jour puis Mise à jour et redémarrage. Voir Installation et mises à jour.

Cela fonctionne si SPL Sense est configuré comme décrit dans l’installation.

Manuellement

Si la mise à jour automatique échoue, mets à jour en ligne de commande. Connecte-toi au Raspberry Pi comme lors de l’installation. Les remarques générales s’appliquent ici aussi.

1. Arrêter SPL Sense

sudo service splsense stop

2. Télécharger et décompresser la nouvelle version

32 bits :

wget https://r.spl.swiss/dl/splsense/linux-arm -O splsense-latest.tar.gz
tar xfvz splsense-latest.tar.gz
rm splsense-latest.tar.gz

64 bits :

wget https://r.spl.swiss/dl/splsense/linux-arm64 -O splsense-latest.tar.gz
tar xfvz splsense-latest.tar.gz
rm splsense-latest.tar.gz

3. Remplacer l’ancienne version

sudo rm -rf /usr/local/splsense
sudo mv splsense /usr/local
sudo chown splsense /usr/local/splsense -R
sudo chgrp splsense /usr/local/splsense -R

Les données de mesure se trouvent dans /opt/splsense-data et sont conservées.

4. Démarrer et redémarrer

sudo service splsense start
sudo reboot

4 - Exploitation

Adresses

Avec le port 8080 de l’installation :

Sur le Raspberry Pi lui-même, tu peux utiliser localhost au lieu de l’adresse IP.

Affichage kiosque

Pour un affichage fixe, par exemple un écran à la cabine du DJ, le navigateur ouvre la vue live directement en mode kiosque, par exemple avec Chromium :

chromium-browser --kiosk "http://localhost:8080/measurement/live?kiosk"

Le mode kiosque n’affiche que les widgets et une fine barre d’état, et s’adapte à la taille de l’écran. Voir Vue live et kiosque.

Station de mesure fixe sans surveillance

1. Active le mode autonome : la mesure démarre d’elle-même après chaque redémarrage, par exemple après une panne de courant.
2. Définis un code PIN opérateur : sans le code PIN, seule la vue live est accessible, y compris dans le navigateur d’autres appareils.
3. Connecte-toi à SPL Cloud et active la liaison cloud.
4. En option avec Pro : alarmes en cas de panne et commande à distance.

Limitation

Tu ne peux pas calibrer le capteur sous Linux. Pour cela, il te faut SPL Sense pour Windows ou macOS.