added scripts
This commit is contained in:
1 parent
95a0ac423b
commit
aa9024e2c1
2 files changed
+125
No files matched your search
@@ -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.
|
||||||
|
|
||||||
Executable
+49
@@ -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"
|
||||||
|
|
||||||
Reference in new issue
Block a user