From aa9024e2c1a04c4815da2085d12182e0c2652844 Mon Sep 17 00:00:00 2001 From: Joachim Hummel Date: Sat, 14 Nov 2026 12:30:29 +0000 Subject: [PATCH] added scripts --- README.md | 76 +++++++++++++++++++++++++++++++++++++++++++++ update_talkgrups.sh | 49 +++++++++++++++++++++++++++++ 2 files changed, 125 insertions(+) create mode 100755 update_talkgrups.sh diff --git a/README.md b/README.md index e69de29..ffca195 100644 --- a/README.md +++ b/README.md @@ -0,0 +1,76 @@ + +Dieses Repository stellt eine PHP-Zuordnung von **Talkgroup-Nummern zu lesbaren Namen** für SvxLink-Webdashboards bereit. Damit erscheint in der Spalte **TG Name** beispielsweise `Bayern` statt einer leeren oder unbekannten Bezeichnung. + +## Inhalt + +| Datei | Zweck | +| --- | --- | +| `talkgroups.php` | PHP-Array `$tgdb_array` mit TG-Nummern und Bezeichnungen | +| `scripts/update-talkgroups.sh` | Aktualisiert die lokale `tgdb.php` mit Syntaxprüfung und Backup | + +Die Datenbank verwendet das Array `$tgdb_array`, etwa: + +```php +$tgdb_array = [ + '882' => 'Region Muenchen', + '888' => 'Oberbayern', + '2628' => 'Bayern', +]; +``` + +Das sind Beispiele; maßgeblich sind die Einträge in [`talkgroups.php`](talkgroups.php). + +## Installation / einmaliges Update + +Voraussetzungen: PHP-CLI, `curl`, Schreibberechtigung für das Dashboard-Verzeichnis und ein Dashboard, das `$tgdb_array` aus `include/tgdb.php` liest. + +Repository auf dem Raspberry Pi klonen: + +```bash +git clone https://git.unixweb.net/joachim/svxlink-talkgroups.git +cd svxlink-talkgroups +``` + +Dann das Update-Skript starten: + +```bash +sudo bash scripts/update-talkgroups.sh +``` + +Standardziel: `/var/www/html/include/tgdb.php`. Bei einem anderen Installationsort kann ein vollständiger Dateipfad übergeben werden: + +```bash +sudo bash scripts/update-talkgroups.sh /pfad/zum/dashboard/include/tgdb.php +``` + +Das Skript lädt die aktuelle `talkgroups.php` aus dem `main`-Branch über HTTPS, prüft die PHP-Syntax und die erwartete Datenstruktur, erstellt bei Änderungen ein zeitgestempeltes Backup (`tgdb.php.bak.JJJJMMTT-HHMMSS`) und ersetzt die Datei. Bei unverändertem Inhalt wird nichts überschrieben. **Es ändert weder die SvxLink-Konfiguration noch verknüpfte Talkgroups.** Anschließend die Dashboard-Seite neu laden; üblicherweise ist kein SvxLink-Neustart nötig. + +> **Hinweis:** Das Update lädt ausführbaren PHP-Code vom Repository. Nur verwenden, wenn du dem Repository und seinen Schreibberechtigten vertraust. Für größere Installationen empfiehlt sich eine geprüfte, versionierte Freigabe statt automatischer Aktualisierung vom `main`-Branch. + +## Automatisches Update (optional) + +Zunächst den manuellen Aufruf testen. Danach kann ein Root-Cronjob wöchentlich nach Updates suchen. Der Pfad muss an den lokalen Checkout angepasst werden: + +```cron +15 4 * * 1 /bin/bash /opt/svxlink-talkgroups/scripts/update-talkgroups.sh >> /var/log/svxlink-talkgroups-update.log 2>&1 +``` + +Das Skript benötigt keine Netzwerkverbindung zum laufenden SvxLink-Dienst, aber Zugriff auf `git.unixweb.net`. + +## Datenquellen und Aktualität + +Die vorhandenen Einträge stammen aus einer lokalen Betreiberdatei und einer **älteren** veröffentlichten FM-Funknetz-Liste (SHRG: , Seiten 6–9). Das aktuelle dynamische Verzeichnis auf wurde **nicht** automatisch synchronisiert. Talkgroups können inzwischen andere Namen haben, entfallen oder hinzukommen. Bitte Einträge vor einer Änderung prüfen. + +## Talkgroup ergänzen oder korrigieren + +1. `talkgroups.php` bearbeiten und TG-Nummer sowie Bezeichnung ergänzen oder korrigieren. +2. Die Änderung möglichst mit einer aktuellen, öffentlich überprüfbaren Quelle belegen. +3. PHP-Syntax prüfen: `php -l talkgroups.php`. +4. Einen Pull Request eröffnen oder ein Issue mit TG-Nummer, Bezeichnung und Quelle anlegen. + +Bitte keine Zugangsdaten, persönlichen Informationen oder internen Verbindungsdetails eintragen. + +## Lizenz + +Derzeit ist im Repository keine Lizenzdatei hinterlegt. Eine Open-Source-Lizenz sollte vor einer breiteren Weiterverwendung ausdrücklich festgelegt werden; aus der öffentlichen Lesbarkeit allein folgt noch keine Nutzungslizenz. + diff --git a/update_talkgrups.sh b/update_talkgrups.sh new file mode 100755 index 0000000..4892c42 --- /dev/null +++ b/update_talkgrups.sh @@ -0,0 +1,49 @@ +#!/usr/bin/env bash +# Aktualisiert die Talkgroup-Namen eines SvxLink-PHP-Dashboards. +set -Eeuo pipefail + +SOURCE_URL='https://git.unixweb.net/joachim/svxlink-talkgroups/raw/branch/main/talkgroups.php' +TARGET="${1:-/var/www/html/include/tgdb.php}" + +if (( EUID != 0 )); then + echo 'Fehler: Bitte mit sudo ausführen (Schreibrechte und Backup erforderlich).' >&2 + exit 1 +fi +for cmd in curl php mktemp cmp cp date dirname chmod chown mv; do + command -v "$cmd" >/dev/null || { echo "Fehlendes Programm: $cmd" >&2; exit 1; } +done +if [[ ! -f "$TARGET" ]]; then + echo "Zieldatei nicht gefunden: $TARGET" >&2 + exit 1 +fi + +TARGET_DIR="$(dirname -- "$TARGET")" +TMP="$(mktemp "$TARGET_DIR/.tgdb-update.XXXXXXXX.php")" +trap 'rm -f -- "$TMP"' EXIT + +curl --fail --silent --show-error --location --proto '=https' --tlsv1.2 \ + --connect-timeout 10 --max-time 40 --retry 2 "$SOURCE_URL" -o "$TMP" +php -l "$TMP" >/dev/null +# Plausibilitätsprüfung: Datei muss das erwartete Array mit relevanten IDs bereitstellen. +php -r ' + include $argv[1]; + if (!isset($tgdb_array) || !is_array($tgdb_array) || count($tgdb_array) < 50 + || !isset($tgdb_array["0"], $tgdb_array["2628"])) { + fwrite(STDERR, "Unerwartete/zu kurze Talkgroup-Datenbank\n"); exit(1); + } +' "$TMP" + +if cmp -s -- "$TMP" "$TARGET"; then + echo 'Bereits aktuell – keine Änderungen.' + exit 0 +fi + +BACKUP="${TARGET}.bak.$(date +%Y%m%d-%H%M%S)" +cp -p -- "$TARGET" "$BACKUP" +# Existierende Zugriffsrechte und Besitzer beibehalten; atomarer Austausch auf gleichem Dateisystem. +chmod --reference="$TARGET" "$TMP" +chown --reference="$TARGET" "$TMP" +mv -f -- "$TMP" "$TARGET" +echo "Aktualisiert: $TARGET" +echo "Backup: $BACKUP" +