231 lines
9.5 KiB
Markdown
231 lines
9.5 KiB
Markdown
# Wachalarm-Kiosk
|
|
|
|
Hier finden Sie ein einfach zu nutzendes SD-Karten-Image für einen **Raspberry Pi**, mit dem der Wachalarm (oder eine andere Webseite) direkt im Vollbild z.B. auf einem Monitor anzeigt werden kann.
|
|
|
|
## Beispielfoto
|
|
|
|
|
|
|
|
## Funktionen
|
|
|
|
- **Startet unmittelbar im Vollbild** - Chromium Web-Browser mit allen wichtigen Funktionen
|
|
- **Automatatische Sicherheitsupdates** - wichtige Updates werden automatisch installiert, bei Bedarf erfolgt in der Nacht ein automatischer Neustart
|
|
- **Automatische Wiederherstellung** - bei Neustart oder Stromausfall startet das System im vorherigen Zustand eigenständig neu
|
|
- *Optional:* **Stromsparfunktion** - liegt kein Alarm an, kann der Monitor ausgeschaltet werden
|
|
- **Maus wird ausgeblendet** - sofern eine Maus angeschlossen ist, wird diese nach inaktivität ausgeblendet
|
|
|
|
---
|
|
|
|
## Inbetriebnahme
|
|
|
|
> **Hinweis**
|
|
>
|
|
> Benötigt wird ein Raspberry Pi ([kompatible Hardware](#hardware)).
|
|
|
|
1. Laden Sie das [aktuelle Image](https://github.com/Robert-112/Wachalarm-Kiosk/releases) aus dem Release-Bereich herunter.
|
|
2. Entpacken Sie die komprimierte Datei auf Ihrem Computer (z.B. dem Programm [7Zip](https://7-zip.de/index.html)).
|
|
3. Schreiben Sie das Image mit Hilfe eines SD-Karten-Lesegeräts auf eine SD-Karte. Hierzu kann unter Windows die Anwendung [Win32 Disk Imager](https://sourceforge.net/projects/win32diskimager/) genutzt werden.
|
|
4. Legen Sie die anzuzeigende [Webseite und die weitere Optionen fest](#konfigurations-datei).
|
|
5. *Optional*: Legen Sie fest, ob der Raspberry Pi sich automatisch mit einem [WLAN verbinden](#wlan-setup) soll.
|
|
6. *Optional*: Setzen Sie eine [feste IP-Adresse](#ip-adresse) für das System.
|
|
7. Setzen Sie die SD-Karte in den Raspberry Pi. Verbinden Sie Ihn mit dem Monitor und dem Internet (Netzwerkkabel oder WLAN). Starten Sie das Gerät.
|
|
|
|
---
|
|
|
|
## Einstellungen
|
|
|
|
### Konfigurations-Datei
|
|
|
|
Die wichtigsten Einstellungen lassen sich ohne vorkenntnisse (von z.B. Linux) direkt mit einem normalen PC anpassen.
|
|
|
|
Benötigt wird ein SD-Karten-Lesegerät und ein Text-Editor.
|
|
|
|
1. Schließen Sie die zuvor mit dem Image beschriebene SD-Karte an ihren PC an (z.B. per USB-Adapter).
|
|
2. Im Datei-Explorer sollte jetzt ein neues Laufwerk erscheinen. In der Partition "Boot" der SD-Karte findet sich die Datei *[wachalarm_einstellungen.txt](https://github.com/Robert-112/Wachalarm-Kiosk/blob/custom/home/wachalarm_einstellungen.txt)*.
|
|
3. folgende Einstellungen können gesetzt werden:
|
|
|
|
|
|
#### Webseite beim Start
|
|
|
|
Legt fest, welche Webseite beim Start geöffnet werden soll. Wollen Sie den Wachalarm für die Feuerwehr Cottbus anzeigen wäre dies z.B. die Adresse https://wachalarm.leitstelle-lausitz.de/waip/520101
|
|
|
|
```
|
|
startup_url=https://wachalarm.leitstelle-lausitz.de/waip/520101
|
|
```
|
|
|
|
#### Standby - Funktion ein-/ausschalten
|
|
|
|
Legt fest ob der Bildschirm automatisch ausgeschaltet werden soll, wenn kein Einsatz anliegt.
|
|
|
|
Es gibt folgende Optionen:
|
|
- 1 = aktiviert diese Funktion (Monitor geht aus sobald kein Alarm mehr angzeigt wird)
|
|
- 0 = deaktivert diese Funktion (Monitor bleibt immer an)
|
|
|
|
```
|
|
standby_enable=1
|
|
```
|
|
|
|
#### Standby - Art des Monitors festlegen
|
|
*(gilt nur wenn die Standby-Funktion aktiviert wurde)*
|
|
|
|
Legt fest, was für ein Monitor verwendet wird. Je nach Typ (PC-Monitor oder Fernseher mit HDMI-CEC), sind unterschiedliche Befehle notwendig um den Monitor ein- oder auszuschalten.
|
|
|
|
Es gibt folgende Optionen:
|
|
- t = Typ "TV", nutzt [CEC-Befehle](https://de.wikipedia.org/wiki/Consumer_Electronics_Control) um den Fernseher ein- oder auszuschalten
|
|
- m = Typ "Monitor", nutzt den Befehlssatz `vcgencmd display_power` um einen PC-Monitor ein- oder auszuschalten
|
|
|
|
```
|
|
screen_type=t
|
|
```
|
|
|
|
#### Standby - Websocket-URL
|
|
*(gilt nur wenn die Standby-Funktion aktiviert wurde)*
|
|
|
|
Dieser Wert sollte normalerweise nicht geändert werden. Es handelt sich um die URL des Wachalarm-Servers, über welche die Websocket-Befehle empfangen und verarbeitet werden. Nur mit dieser URL kann das Standby-Signal korrekt ausgewertet werden.
|
|
|
|
|
|
```
|
|
standby_waipurl=https://wachalarm.leitstelle-lausitz.de/waip
|
|
```
|
|
|
|
> **Achtung!**
|
|
>
|
|
> Es handelt sich hierbei nicht die URL des einzelnen Alarmmonitors!
|
|
|
|
#### Standby - Wachennummer
|
|
*(gilt nur wenn die Standby-Funktion aktiviert wurde)*
|
|
|
|
Nummer der Wache, für die bei Alarmen der Monitor angeschaltet werden soll, z.B. 520101 für CB FW Cottbus
|
|
|
|
```
|
|
standby_wachennr=520101
|
|
```
|
|
|
|
> **Achtung!**
|
|
>
|
|
> Hier sollte im Normalfall immer die gleiche Nummer des aufgerufenen Alarmmonitors hinterlegt werden (siehe Parameter `startup_url`).
|
|
|
|
#### System-Statusmeldungen aktivieren
|
|
|
|
Hiermit kann ein automatisches Senden von Status-Meldungen aktiviert werden.
|
|
|
|
Es handelt sich um allgemeine Systeminforamtionen wie z.B. Kernel-Version, Hardwaremerkmale & Udpatestatus. Personenbezogene Daten werden nicht verarbeitet.
|
|
|
|
- 1 = an
|
|
- 0 = aus
|
|
|
|
```
|
|
report_enable=1
|
|
```
|
|
|
|
#### System-Statusmeldungen - Status-URL
|
|
*(gilt nur wenn System-Statusmeldungen aktiviert wurden)*
|
|
|
|
URL an welche Status-Meldungen durch das System gesendet werden.
|
|
|
|
```
|
|
report_url=https://wachalarm.leitstelle-lausitz.de/client_statusmessage
|
|
```
|
|
|
|
#### automatische Neustarts
|
|
|
|
Legt fest, ob und wenn ja wann, ein automatischer Neustart des Raspberry Pi erfolgen soll. Diese Funktion ist hilfreich um z.B. bei schlechten WLAN-Verbindungen das System automatisch neuzustarten.
|
|
|
|
Es gibt folgende Optionen:
|
|
- 0 = automatischer Neustart ist deaktiviert.
|
|
- w = Neustart jeden Montag um 3:00 Uhr.
|
|
- z = Neustart jeden Dienstag und jeden Freitag um 3:00 Uhr.
|
|
- t = Neustart jeden Tag um 3:00 Uhr.
|
|
|
|
```
|
|
restart_type=w
|
|
```
|
|
|
|
---
|
|
|
|
### WLAN einstellen
|
|
|
|
WLAN-Verbindungen lassen Sich beim Raspberry über eine spezielle Datei vorgeben, ohne weitere Einstellungen am System zu tätigen. Gehen Sie wie folgt vor, um WLAN zu aktivieren:
|
|
|
|
1. Schließen Sie die zuvor mit dem Image beschriebene SD-Karte an ihren PC an (z.B. per USB-Adapter).
|
|
2. Im Datei-Explorer sollte jetzt ein neues Laufwerk erscheinen. In der Partition "Boot" der SD-Karte erstellen Sie eine Datei mit dem Namen `wpa_supplicant.conf`.
|
|
3. Eine fertige Vorlage findet sich hier: [wpa_supplicant.conf](https://github.com/Robert-112/Wachalarm-Kiosk/blob/custom/optional_boot_config/wpa_supplicant.conf)
|
|
4. Ersetzen Sie `Name-des-WLANs` und `ganz-geheimes-kennwort` mit Ihren eigenen WLAN-Einstellungen.
|
|
5. Speichern Sie die Datei auf der SD-Karte und setzen Sie diese wieder in den Raspberry Pi ein. Nach Abschluss des Startvorgangs sollte sich das Gerät eigenständig mit dem WLAN verbinden.
|
|
|
|
#### Beispiel wpa_supplicant.conf für WLAN _mit Kennwort_
|
|
```
|
|
country=DE
|
|
update_config=1
|
|
ctrl_interface=DIR=/var/run/wpa_supplicant GROUP=netdev
|
|
network={
|
|
key_mgmt=WPA-PSK
|
|
ssid="Name-des-WLANs"
|
|
psk="ganz-geheimes-kennwort"
|
|
}
|
|
```
|
|
|
|
#### Beispiel wpa_supplicant.conf für WLAN _ohne Kennwort_
|
|
```
|
|
country=DE
|
|
update_config=1
|
|
ctrl_interface=DIR=/var/run/wpa_supplicant GROUP=netdev
|
|
network={
|
|
ssid="Name-des-WLANs"
|
|
key_mgmt=NONE
|
|
}
|
|
```
|
|
|
|
---
|
|
|
|
### IP-Adresse vorgeben
|
|
|
|
Mittels der Datei `cmdline.txt` kann direkt eine feste IP-Adresse für den Raspberry Pi vorgegeben werden.
|
|
|
|
1. SD-Karte in PC einsetzen.
|
|
2. In der Boot-Partition die Datei `cmdline.txt` finden und mit einem Editor öffnen.
|
|
3. Am ende der ersten Zeile folgenden Text hinzufügen (keine neue Ziele):
|
|
|
|
```ip=192.168.2.20::192.168.2.1:255.255.255.0:wachalarm:eth0:off:192.168.2.1```
|
|
|
|
Damit wird die IP-Adresse für die Schnittstelle `eth0` auf 192.168.2.20 festlegt. Einstellungen für das Gateway (`192.168.2.1`), das Subnetz (`255.255.255.0`), den Hostnamen (`wachalarm`) und den DNS-Server (`192.168.2.1`) werden ebenfalls definiert.
|
|
|
|
Bereits angepasste `cmdline.txt`-Dateien finden Sie hier: [optional_boot_config](https://github.com/Robert-112/Wachalarm-Kiosk/blob/custom/optional_boot_config)
|
|
|
|
---
|
|
|
|
## Hardware
|
|
|
|
Dieses Image sollte mit allen bekannten [Raspberry Pi's](https://www.raspberrypi.org/products/) funktionieren. Die Versionen 3 und 4 werden empfohlen, da die älteren Varianten zu wenig Leistung bieten. Raspberry 3 und 4 haben zudem ein eingebautes WLAN-Modul.
|
|
|
|
Stellen Sie sicher, dass Sie eine [kompatible SD-Karte](http://elinux.org/RPi_SD_cards) verwenden (mind. 4 GB). `Class 10`-Karten sollten in jedem Fall funktionieren.
|
|
|
|
Ein Raspberry Pi benötigt ein [2.5 A USB-Netzteil](https://www.raspberrypi.org/documentation/hardware/raspberrypi/power/README.md).
|
|
|
|
---
|
|
|
|
## Bekannte Fehler
|
|
|
|
### kein Ton über HDMI (Raspberry Pi 4)
|
|
- stellen Sie sicher das sie das HDMI-Kabel am HDMI-Port 0 des Raspberrys angeschlossen haben (direkt neben dem USB-C-Stromanschluss)
|
|
- prüfen Sie ob der Monitor / Fernseher über den angeschlossenen HDMI-Port auch wirklich einen Ton ausgegeben kann
|
|
- prüfen Sie mittels `sudo raspi-config` ob HDMI als Audio-Ausgabequelle eingestellt wurde
|
|
|
|
### ich benötige ein anderes Kennwort
|
|
- öffnen Sie die Eingabekonsole am Raspberry Pi
|
|
- `sudo raspi-config`
|
|
- Navigieren Sie zu `Change User Password`
|
|
- geben Sie ein neues Passwort ein und bestätigen Sie es
|
|
- das eingegebene Kennwort gilt für den Benutzer `pi`
|
|
|
|
### Monitor / Fernseher aus Standby erwecken
|
|
|
|
- Wenn die Standby-Funktion aktiviert wurde, schaltet sich der angeschlossene Monitor oder Fernseher aus, solange kein Alarm angezeigt wird
|
|
- Mit einer Tastutur kann der Monitor durch folgende Tastenkombinationen ein- und ausgeschaltet werden:
|
|
- `STRG` + `i` -> schaltet den Monitor ein
|
|
- `STRG` + `o` -> schaltet den Monitor aus
|
|
|
|
## Sonstiges
|
|
|
|
Dieses Projekt ist ein Fork von [chilipie-kiosk](https://github.com/jareware/chilipie-kiosk). Dort finden sich weitere Informationen und Antworten zu vielen Detailfragen.
|