added scripts

This commit is contained in:
jhummel committed 2026-11-14 12:30:29 +00:00
1 parent 95a0ac423b
commit aa9024e2c1
2 files changed
+125

No files matched your search

+76
View File
@@ -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: <https://www.fox50.de/SHRG/shrg.pdf>, Seiten 6–9). Das aktuelle dynamische Verzeichnis auf <https://dashboard.fm-funknetz.de/tg.php> 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.
+49
View File
@@ -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"