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.