77 lines
3.7 KiB
Markdown
77 lines
3.7 KiB
Markdown
|
||
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.
|
||
|