TVIP Knowledge Base Update Server Set-Up

Update Server Set-Up

Ein TVIP Update Server stellt Firmware-Dateien für TVIP STBs über eine feste URL-Struktur bereit.

Welche Firmware eine STB abruft, ergibt sich aus dem Modell, dem Betriebssystem und dem gewünschten Update-Kanal.

Für den Betrieb kann grundsätzlich jeder Webserver verwendet werden, der statische Dateien bereitstellen kann, zum Beispiel Apache, NGINX oder lighttpd.

URL-Struktur

Der Update Server verwendet folgende grundlegende Struktur: 

http://tvipupdate.net/stb/<model>/<OS>/<update_type>/tvip_firmware.ota.zip

Die URL setzt sich aus folgenden Bestandteilen zusammen:

  • Domain – die Domain des eigenen Update Servers
  • /stb/ – fester Verzeichnispfad
  • Model – Modell beziehungsweise Modellreihe der TVIP STB
  • OS – Betriebssystem der STB
  • Update Type – gewünschter Update-Kanal
  • tvip_firmware.ota.zip – eigentliche Firmware-Datei

Modelle

Nach /stb/ folgt das Verzeichnis des entsprechenden TVIP STB-Modells beziehungsweise der Modellreihe.

Für die Modelle werden folgende Verzeichnisnamen verwendet: 

s6xx
s705a
s706a
s710a
s725a
s726
s730a

Bei der 6xx-Reihe steht xx für die jeweilige Modellnummer.

Bei den entsprechenden Modellen der 7xx-Reihe wird die konkrete Modellnummer verwendet, zum Beispiel s710a, s725a oder s730a.

Wichtig bei S726

Sowohl die TVIP S726 als auch die TVIP S726 Ultra verwenden das Modellverzeichnis s726.

Betriebssystem

Nach dem Modell folgt das Betriebssystem der STB.

Unterstützte Verzeichnisnamen sind:

  • android
  • linux-qt

Update-Kanal

Anschließend wird festgelegt, aus welchem Update-Kanal die Firmware bereitgestellt wird.

  • release – reguläre Firmware-Versionen
  • beta – Beta-Firmware-Versionen

Firmware-Dateien

Im entsprechenden Verzeichnis müssen sich die Firmware-Datei und die zugehörige Informationsdatei befinden.

  • tvip_firmware.ota.zip – die eigentliche Firmware-Datei
  • tvip_firmware.info – enthält Informationen zur Firmware

Eine vollständige Verzeichnisstruktur kann beispielsweise folgendermaßen aussehen: 

/stb/
└── s710a/
    └── android/
        └── release/
            ├── tvip_firmware.ota.zip
            └── tvip_firmware.info

Die Firmware wäre in diesem Beispiel über folgende URL erreichbar: 

http://tvipupdate.net/stb/s710a/android/release/tvip_firmware.ota.zip

Update Server mit TVIP synchronisieren

Der eigene Update Server kann außerdem mit dem TVIP Update Server synchronisiert werden.

Dafür kann rsync verwendet werden: 

rsync -P --timeout=3000 -aWvH --stats --force --delete --delete-after --exclude=prov* rsync://rsync.tvip.tv/tvipupdate/ /var/www/tvipupdate.net

Hinweis

Durch die Optionen --delete und --delete-after können lokale Dateien entfernt werden, wenn sie auf der TVIP-Quelle nicht mehr vorhanden sind.