SPL Sense für Linux

• 1: Hardware und Betriebssystem
• 2: Installation
• 3: Update
• 4: Betrieb

1 - Hardware und Betriebssystem

Hardware

Den Raspberry Pi bekommst du im Elektronikhandel. Getestet haben wir:

• Raspberry Pi 4 oder 5, Model B (alle Arbeitsspeicher-Varianten)
• für die Stromversorgung über das Netzwerkkabel: das offizielle Power-over-Ethernet-Modul (PoE HAT) für den Raspberry Pi 3B+ und 4B

Speicherkarte

Die Speicherkarte ist das Teil, das bei vielen Betriebsstunden am ehesten ausfällt. SPL Sense schreibt zwar wenig, aber eine hochwertige Micro-SD-Karte lohnt sich trotzdem. Gute Erfahrungen haben wir mit «SanDisk Extreme Pro» gemacht.

Die Grösse ist kaum ein Thema: Raspberry Pi OS mit Desktop passt auf 8 GB, und auch viele Messdaten brauchen kaum ein Gigabyte. Wir empfehlen mindestens 16 GB.

Betriebssystem installieren

1. Installiere den Raspberry Pi Imager auf deinem Computer (erhältlich auf der Website von Raspberry Pi).
2. Schreibe damit Raspberry Pi OS with Desktop auf die Speicherkarte.
   • Wähle 32 oder 64 Bit. Für einen Raspberry Pi 5 empfehlen wir 64 Bit. Merke dir die Wahl: Bei der Installation von SPL Sense brauchst du das passende Paket.
   • Lege im Imager unter den Einstellungen Benutzername und Passwort fest, und schalte SSH ein, wenn du den Raspberry Pi von einem anderen Computer aus einrichten willst.

Hast du Erfahrung mit der Kommandozeile und brauchst keinen Bildschirm am Raspberry Pi, genügt auch Raspberry Pi OS Lite ohne Desktop. Diese Anleitung geht von der Desktop-Variante aus.

Zusammenbauen

1. Baue den Raspberry Pi mit den gewünschten Zusatzmodulen ins Gehäuse und stecke die Speicherkarte ein.
2. Schliesse Bildschirm, Tastatur und Maus an.
3. Schliesse den Strom an (oder das Netzwerkkabel bei PoE). Der Raspberry Pi startet.
4. Richte beim ersten Start eine Netzwerkverbindung ein, per Kabel oder WLAN. SPL Sense wird im nächsten Schritt aus dem Internet geladen.
5. Falls nicht schon im Imager eingeschaltet: SSH aktivieren unter Raspberry-Menü › Einstellungen › Raspberry Pi Konfiguration › Schnittstellen.
6. Notiere die IP-Adresse des Raspberry Pi: Sie erscheint, wenn du mit der Maus oben rechts über das Netzwerksymbol fährst.

2 - Installation

SPL Sense wird über die Kommandozeile installiert, entweder direkt am Raspberry Pi (Programm Terminal) oder per SSH von einem anderen Computer. Mit SSH kannst du die Befehle kopieren und einfügen und vermeidest Tippfehler.

Per SSH verbinden

Dein Computer muss im selben Netzwerk sein wie der Raspberry Pi.

• macOS und Linux: im Terminal ssh <benutzer>@<ip-adresse>, zum Beispiel ssh pi@192.168.10.144
• Windows: im Terminal (PowerShell) ebenfalls ssh <benutzer>@<ip-adresse>, oder mit PuTTY: bei Host Name die IP-Adresse eintragen, Connection type auf SSH, dann Open

Benutzer und Passwort sind die, die du im Raspberry Pi Imager festgelegt hast.

Allgemeine Hinweise

• Linux unterscheidet Gross- und Kleinschreibung. Übernimm die Befehle genau.
• Ein erfolgreicher Befehl zeigt meist keine Meldung. Erscheint eine Fehlermeldung, lies sie und behebe den Fehler, bevor du weitermachst.
• Beim ersten sudo fragt der Raspberry Pi nach dem Passwort deines Benutzers.

1. Benutzer für SPL Sense anlegen

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

SPL Sense läuft unter diesem eigenen Benutzer und speichert seine Daten in /opt/splsense-data.

2. SPL Sense herunterladen und entpacken

Für ein 32-Bit-Betriebssystem:

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

Für ein 64-Bit-Betriebssystem:

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. Programm an seinen Ort verschieben

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

4. Dienst einrichten

Damit SPL Sense beim Hochfahren automatisch startet, richtest du es als Systemdienst ein. Öffne eine neue Datei im Editor nano:

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

Kopiere diesen Inhalt hinein:

[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

Speichern und schliessen: Ctrl+X, dann mit Y bestätigen.

Die Zeile ASPNETCORE_URLS legt fest, unter welcher Adresse und welchem Port SPL Sense erreichbar ist: hier 8080 auf allen Netzwerkschnittstellen. Einen anderen Port trägst du hier ein. Fehlt die Zeile, ist SPL Sense nur auf dem Raspberry Pi selbst erreichbar (http://localhost:5000).

5. Dienst aktivieren und starten

sudo systemctl enable splsense
sudo service splsense start

6. Neu starten

sudo reboot

Fertig

SPL Sense startet jetzt bei jedem Hochfahren automatisch und läuft im Hintergrund. Öffne im Browser des Raspberry Pi oder eines anderen Geräts im Netzwerk die IP-Adresse mit dem Port, zum Beispiel http://192.168.10.144:8080.

Weiter geht es wie auf jeder anderen Plattform, zum Beispiel mit dem Schnellstart. Für den Betrieb als feste Messstation siehe Betrieb.

3 - Update

Automatisch

SPL Sense aktualisiert sich unter Linux wie auf den anderen Plattformen selbst: Ist eine neue Version verfügbar, erscheint auf der Übersicht Update verfügbar. Stoppe die Messung und klicke auf Update und Aktualisieren und neu starten. Siehe Installation und Updates.

Das funktioniert, wenn SPL Sense wie in der Installation beschrieben eingerichtet ist.

Von Hand

Schlägt das automatische Update fehl, aktualisierst du per Kommandozeile. Verbinde dich dazu wie bei der Installation mit dem Raspberry Pi. Die allgemeinen Hinweise gelten auch hier.

1. SPL Sense stoppen

sudo service splsense stop

2. Neue Version herunterladen und entpacken

32 Bit:

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 Bit:

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. Alte Version ersetzen

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

Die Messdaten liegen in /opt/splsense-data und bleiben dabei erhalten.

4. Starten und neu starten

sudo service splsense start
sudo reboot

4 - Betrieb

Adressen

Mit dem Port 8080 aus der Installation:

Am Raspberry Pi selbst geht statt der IP-Adresse auch localhost.

Kiosk-Anzeige

Für eine feste Anzeige, zum Beispiel ein Bildschirm am DJ-Pult, öffnet der Browser die Live Ansicht direkt im Kiosk-Modus, zum Beispiel mit Chromium:

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

Der Kiosk-Modus zeigt nur die Widgets und eine schmale Statusleiste und passt sich der Bildschirmgrösse an. Siehe Live-Anzeige und Kiosk.

Feste Messstation ohne Bedienung

1. Autonomer Modus einschalten: Die Messung startet nach jedem Neustart von selbst, zum Beispiel nach einem Stromausfall.
2. Operator-PIN setzen: Ohne PIN ist nur die Live Ansicht zugänglich, auch im Browser anderer Geräte.
3. Mit der SPL Cloud verbinden und die Cloud Synchronisierung einschalten.
4. Optional mit Pro: Alarme bei Ausfall und Fernsteuerung.

Einschränkung

Den Sensor kalibrieren kannst du unter Linux nicht. Dafür brauchst du SPL Sense für Windows oder macOS.