VDR Firmware Konfiguration

Aus open7x0.org

Wechseln zu: Navigation, Suche

Informationen zu den Einstellungen der VDR Firmware in der Datei /opt/local/etc/fw-config.txt.


Inhaltsverzeichnis


Einleitung

Die Datei /opt/local/etc/fw-config.txt enthält Parameter, die die VDR Firmware steuern. Durch den Speicherort /opt/local/etc kann es verschiedene Konfigurationsdateien geben, die dann tatsächlich unter /opt/local/etc1 bis /opt/local/etc9 liegen. Die Dateiendung .txt deutet an, das es sich um eine Text-Datei handelt, die der Benutzer editieren kann. Die Datei wird speziell gescanned, damit semantische und syntaktische Fehleingaben korrigiert werden können.

Die einzelnen Parameter sind sind im Artikel »VDR Konfigurations-Parameter« beschrieben.

Aufbau der Datei

Die Datei /opt/local/etc/fw-config.txt wird bei jedem Systemstart neu geschrieben. Der Aufbau der Datei ist dabei so gewählt, dass sie sowohl maschinenlesbar als auch informativ für Personen ist.

Der Aufbau im Detail:

  • Alle Parameter und alle Gruppentitel sind voneinander durch mindestens eine Leerzeile getrennt.
  • Die Parameter sind in Gruppen eingeteilt. Diese Gruppierung hat keinerlei Auswirkung auf die Interpretation der Parameter; sie dient lediglich der logischen Gliederung. Ein Parameter wird logisch der letzten vor dem Parameter definierten Gruppe zugeordnet. 
    Syntax:
   '#-----' Gruppentitel

    Zum Gruppentitel gehören alle Zeichen bis zum Zeilenende. Leerzeichen am Anfang und Ende werden ignoriert.

  • Jeder Parameter beginnt mit einer Zeile der Form: '#PARAMETER: Beschreibung' Dieser Teil ist maschinenlesbar und beschreibt Name, Typ, Voreinstellung und Wertebereich des Parameters: 
    Syntax:
   '#PARAMETER:' name 'key' key1 [[=]keyN]...
   '#PARAMETER:' name 'list' key1 [[=]keyN]...
   '#PARAMETER:' name 'num' def min max
   '#PARAMETER:' name 'str' [default_text]

    Nach der Einleitung '#PARAMETER:' folgt als erstes der Name des Parameters. Gültige Zeichen für den Namen sind Buchstaben (ASCII), Ziffern und der Unterstrich. Der Name beginnt immer mit einem Buchstaben.

    Danach folgt genau eines der vier Schlüsselworte 'key', 'list', 'num' oder 'str', wobei zukünftig weitere Schlüsselworte hinzukommen können. Dieses Schlüsselwort legt den Typ und die weitere Syntax fest.

    • key
      Der Parameter kann als Wert nur einen der Schlüsselwörter (key1..keyN) annehmen. Gültige Zeichen für die Schlüsselwörter sind Buchstaben (ASCII), Ziffern, der Unterstrich, das Minuszeichen und der Doppelpunkt. Groß-/Kleinschreibung ist unerheblich. Das erste Schlüsselwort ist gleichzeitig die Voreinstellung. Wird ein Schlüsselwort mit einem '=' Zeichen eingeleitet, dann hat es dieselbe Bedeutung wie das vorherige Schlüsselwort: Es handelt sich also um ein Synonym.
    • list
      Der Parameter erwartet als Wert eine Komma-separtierte Liste der Schlüsselwörter (key1..keyN). Die Schlüsselwörter können in beliebiger Reihenfolge auftreten. Ein mehrfaches Vorkommen eines Schlüsselwortes wird genauso wie ein einfache Vorkommen interpretiert. Die Liste kann auch leer sein. Gültige Zeichen für die Schlüsselwörter sind Buchstaben (ASCII), Ziffern, der Unterstrich, das Minuszeichen und der Doppelpunkt. Groß-/Kleinschreibung ist unerheblich. Wird ein Schlüsselwort mit einem '=' Zeichen eingeleitet, dann hat es dieselbe Bedeutung wie das vorherige Schlüsselwort: Es handelt sich also um ein Synonym.
    • num
      Es handelt sich um einen numerischen Parameter. Die drei folgenden Zahlen beschreiben die Voreinstellung, das Minimum und das Maximum des Wertes. Bei der Eingabe darf die Zahl auch von einem der Buchstaben 'kKmMgG' gefolgt werden. Diese Zeichen werden als Kilo, Mega und Giga erkannt und sind als Faktor auf Basis 1024 anzusehen.
    • str
      Der Parameter erwartet eine beliebige Zeichenkette. Alle Zeichen bis zum Zeilenende werden als Wert verwendet, wobei alle ASCII-Zeichen < 32 und die Zeichen '&', '|', ';', '<' und '>' zu einem Leerzeichen gewandelt werden. Die Zeichenkette darf auch mit Anführungszeichen umschlossen werden. Leerzeichen am Anfang und Ende werden ignoriert. 'default_text' ist die Voreinstellung.
  • Nun folgen weitere Kommentarzeilen, die als Fließtext-Information zu behandeln sind. Jede dieser Kommentarzeilen beginnt mit einem '#' in der ersten Spalte.
  • Nach den Kommentaren folgt eine Zeile im Format: 
    name=wert

    Mit dieser Wertzuweisung ist der Block beendet.

Wichtig: Ist ein Parameter in der Konfigurationsdatei mehrfach vorhanden, dann wird nur der letzte Parameter aus der Datei verwendet. Dieses bedeutet für andere Tools: Änderungen müssen nur an das Ende der Datei geschrieben werden.

Einstellungen vornehmen

Es existieren verschiedenen Möglichkeiten, die Einstellungen vorzunehmen.

Editor

Die Datei /opt/local/etc/fw-config.txt kann direkt editiert werden. Durch ein spezielles Scanning werden Syntax und Semantikfehler erkannt und ignoriert.

FTP/SCP

Die Datei /opt/local/etc/fw-config.txt kann mittels ftp oder scp auf ein anderes System kopiert, dort editiert und wieder zurückkopiert werden.

Web-Server

Im eingebauten Web-Server gibt es eine Seite »Firmware Konfiguration bearbeiten«, mit der sich die Einstellungen anzeigen und ändern lassen.

VDR Plugin 'Setup'

Durch das VDR Plugin 'Setup' ist es möglich, die Einstellungen im laufenden VDR vorzunehemen. Hierzu muss im Hauptmenu der Punkt 'Gigaset 7x0 Firmware Setup' und dort der Punkt 'o7o Einstellungen' ausgewählt werden. Es ist aich eine Hilfe für die einzelnen Einstellungen vorhanden (rote Taste).

Ports 12100 bis 12102

An Port 12100 können die Parameter von einem externen Programm abgefragt werden. Die Parameter werden inklusive Syntax (siehe oben) und Hilfetext ausgeliefert. Port 12101 liefert die Parameter ohne Syntax-Regel und Hilfe. Mittels Port 12102 können die Parameter gesetzt werden.

Unter Unix ist so z.B. das folgende möglich: 

cat </dev/tcp/m740av/12100 >tempfile
vi tempfile
cat >/dev/tcp/m740av/12102 <tempfile

Die folgenden externen Tools verwenden diese Ports:

Links zum Thema »VDR Firmware« 

Von „http://open7x0.xnc.de/wiki/VDR_Firmware_Konfiguration“
Persönliche Werkzeuge