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.