Files
svxlink-talkgroups/README.md
T
2026-11-14 12:30:29 +00:00

77 lines
3.7 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
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.