CRCF - Common Railroad Configuration Files 0.1: Unterschied zwischen den Versionen
(→1.1 Konventionen) |
(Interen/externe Links angepasst) |
||
(15 dazwischenliegende Versionen von einem anderen Benutzer werden nicht angezeigt) | |||
Zeile 4: | Zeile 4: | ||
− | == 1 | + | == 1 Einleitung == |
+ | |||
+ | {| width="98%" cellpadding="1" align="Center" cellspacing="0" border="0" | ||
− | |||
|- valign="Top" | |- valign="Top" | ||
− | | colspan="3" | | + | | colspan="3" | |
Die CRCF beschreiben einen Reihe von Dateien zur Konfiguration von Serverprozessen zur Steuerung von digitalen Modelleisenbahnen. Clientprozesse können auf diese Informationen über einen entsprechenden Auskunftsbefehl zugreifen. | Die CRCF beschreiben einen Reihe von Dateien zur Konfiguration von Serverprozessen zur Steuerung von digitalen Modelleisenbahnen. Clientprozesse können auf diese Informationen über einen entsprechenden Auskunftsbefehl zugreifen. | ||
Zeile 15: | Zeile 16: | ||
Ziel ist es eine klare, auch vom Menschen lesbare Basis für die Fähigkeiten einer konkreten Serverimplementierung einerseits und eine Beschreibung der verwendeten Dekoder mit ihren spezifischen Eigenschaften andererseits zu schaffen. | Ziel ist es eine klare, auch vom Menschen lesbare Basis für die Fähigkeiten einer konkreten Serverimplementierung einerseits und eine Beschreibung der verwendeten Dekoder mit ihren spezifischen Eigenschaften andererseits zu schaffen. | ||
− | + | Diese Fassung basiert auf [[SRCP - Simple Railroad Command Protocol 0.7.0 | SRCP Version 0.7.0]]. | |
− | | | + | | |
− | | bgcolor="#666666" | | + | | bgcolor="#666666" | |
|} | |} | ||
+ | |||
=== 1.1 Konventionen === | === 1.1 Konventionen === | ||
− | {| width=" | + | {| width="98%" cellpadding="1" align="Center" cellspacing="0" border="0" |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | colspan="3" | | + | | colspan="3" | |
Alle Informationen werden einzeilig mit variabler Länge gespeichert. Eine Zeile wird mit dem Zeichen '\n' (line feed, LF, #10) abgeschlossen. Ein vorangestelltes '\r' (carriage return, CR, #13) wird akzeptiert. Jede Informationszeile besteht aus Worten, die durch Whitespace (Leerzeichen, Tabulatoren) getrennt sind. | Alle Informationen werden einzeilig mit variabler Länge gespeichert. Eine Zeile wird mit dem Zeichen '\n' (line feed, LF, #10) abgeschlossen. Ein vorangestelltes '\r' (carriage return, CR, #13) wird akzeptiert. Jede Informationszeile besteht aus Worten, die durch Whitespace (Leerzeichen, Tabulatoren) getrennt sind. | ||
Zeile 39: | Zeile 42: | ||
Die Informationen sind in Bereiche aufgeteilt. Jeder Bereich hat eine Überschrift. Alle Informationen aus einem Bereich müssen hinter dieser Überschrift stehen. Stehen sie an einer anderen Stelle, so werden sie als Fehler gewertet. Innerhalb eines Bereichs ist eine angemessene Ordnung sinnvoll (Name | Protokoll | Adresse | ...). Diese Ordnung ist für die bessere Lesbarkeit und daher nicht zwingend vorgeschrieben. Es steht im Ermessen des Erstellers, welche Ordnung, wenn überhaupt, er/sie benutzt. | Die Informationen sind in Bereiche aufgeteilt. Jeder Bereich hat eine Überschrift. Alle Informationen aus einem Bereich müssen hinter dieser Überschrift stehen. Stehen sie an einer anderen Stelle, so werden sie als Fehler gewertet. Innerhalb eines Bereichs ist eine angemessene Ordnung sinnvoll (Name | Protokoll | Adresse | ...). Diese Ordnung ist für die bessere Lesbarkeit und daher nicht zwingend vorgeschrieben. Es steht im Ermessen des Erstellers, welche Ordnung, wenn überhaupt, er/sie benutzt. | ||
− | An einigen Stellen sind Werte reserviert, die im SRCP noch nicht festgelegt sind, da es zur Zeit noch keine Server gibt, die das unterstützen. Diese Werte sind als Platzhalter zu betrachten, sie können sich noch ändern. Solche reservierten Werte sind mit ''kursiver Schrift'' markiert. | + | An einigen Stellen sind Werte reserviert, die im SRCP noch nicht festgelegt sind, da es zur Zeit noch keine Server gibt, die das unterstützen. Diese Werte sind als Platzhalter zu betrachten, sie können sich noch ändern. Solche reservierten Werte sind mit ''kursiver Schrift'' markiert. |
− | | | + | | |
− | | bgcolor="#666666" | | + | | bgcolor="#666666" | |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | colspan="3" | | + | | colspan="3" | |
− | Änderungen gegenüber der vorherigen Version werden mit einem farbigen Strich am rechten Rand markiert. Dabei bedeutet <font color="#FF0000"> '''rot'''</font> Neues oder wesentliche (inhaltliche) Änderungen, <font color="#00FF00">'''grün'''</font> kleinere (textliche) Änderungen, und <font color="#0000FF">'''blau'''</font> Weglassungen. Unveränderte Abschnitte haben eine <font color="#666666">'''graue'''</font> Markierung. Korrekturen von Tipfehlern werden nicht markiert. <br /> Da diese Version komplett neu ist, sind alle Abschnitte grau markiert. Die rote Markierung dieses Abschnittes, ebenso wie die grüne Markierung des [ | + | Änderungen gegenüber der vorherigen Version werden mit einem farbigen Strich am rechten Rand markiert. Dabei bedeutet <font color="#FF0000"> '''rot'''</font> Neues oder wesentliche (inhaltliche) Änderungen, <font color="#00FF00">'''grün'''</font> kleinere (textliche) Änderungen, und <font color="#0000FF">'''blau'''</font> Weglassungen. Unveränderte Abschnitte haben eine <font color="#666666">'''graue'''</font> Markierung. Korrekturen von Tipfehlern werden nicht markiert. <br /> |
− | | | + | Da diese Version komplett neu ist, sind alle Abschnitte grau markiert. Die rote Markierung dieses Abschnittes, ebenso wie die grüne Markierung des Abschnitts [[#8 Änderungsprotokoll]] dient ledigich als Beispiel. |
− | | bgcolor="#FF0000" | | + | | |
+ | | bgcolor="#FF0000" | | ||
|} | |} | ||
− | |||
− | {| width=" | + | |
+ | == 2 Servereigenschaften == | ||
+ | |||
+ | {| width="98%" cellpadding="1" align="Center" cellspacing="0" border="0" | ||
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | colspan="3" | Hier werden die Eigenschaften beschrieben, die eine Serverimplementierung ausmachen, das heißt, welche Möglichkeiten ein Server seinen Clients zur Verfügung stellt. | + | | colspan="3" | |
− | | | + | Hier werden die Eigenschaften beschrieben, die eine Serverimplementierung ausmachen, das heißt, welche Möglichkeiten ein Server seinen Clients zur Verfügung stellt. |
− | | bgcolor="#666666" | | + | | |
+ | | bgcolor="#666666" | | ||
|} | |} | ||
+ | |||
=== 2.1 Serverversion === | === 2.1 Serverversion === | ||
− | {| width=" | + | {| width="98%" cellpadding="1" align="Center" cellspacing="0" border="0" |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | colspan="3" | | + | | colspan="3" | '''Überschrift: '= Version =' ''' |
− | '''Überschrift: '= Version =' ''' | + | |
Es gibt genau eine Zeile mit der Information über die Version des Servers und des verwendeten SRCP. | Es gibt genau eine Zeile mit der Information über die Version des Servers und des verwendeten SRCP. | ||
− | | | + | | |
− | | bgcolor="#666666" | | + | | bgcolor="#666666" | |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | colspan="2" | '''VERS <name> <vers> SRCP <srcp>''' | + | | colspan="2" nowrap="NOWRAP" | '''VERS <name> <vers> SRCP <srcp>''' |
− | | | + | | |
− | | bgcolor="#666666" | | + | | bgcolor="#666666" | |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | <name> | + | | <name> || Name des Servers |
− | | Name des Servers | + | | |
− | | | + | | bgcolor="#666666" | |
− | | bgcolor="#666666" | | + | |
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | <vers> | + | | <vers> || Version des Servers |
− | | Version des Servers | + | | |
− | | | + | | bgcolor="#666666" | |
− | | bgcolor="#666666" | | + | |
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | <srcp> | + | | <srcp> || Version des verwendeten SRCP |
− | | Version des verwendeten SRCP | + | | |
− | | | + | | bgcolor="#666666" | |
− | | bgcolor="#666666" | | + | |
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | Hinweis: | + | | nowrap="NOWRAP" | Hinweis: |
− | | nowrap="NOWRAP" | Die Versionsinformation sollte als erstes in einer Konfigurationsdatei stehen. | + | | nowrap="NOWRAP" | Die Versionsinformation sollte als erstes in einer Konfigurationsdatei stehen. |
− | | | + | | |
− | | bgcolor="#666666" | | + | | bgcolor="#666666" | |
|} | |} | ||
+ | |||
=== 2.2 Übertragungskanäle === | === 2.2 Übertragungskanäle === | ||
− | {| width=" | + | {| width="98%" cellpadding="1" align="Center" cellspacing="0" border="0" |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | colspan="3" | | + | | colspan="3" | |
Welche Kanäle werden von einer Serverimplementierung zur Kommunikation mit Clients benutzt. Dies ist durch das SRCP weitgehend festgelegt. | Welche Kanäle werden von einer Serverimplementierung zur Kommunikation mit Clients benutzt. Dies ist durch das SRCP weitgehend festgelegt. | ||
− | '''Überschrift: '= Ports ='''' | + | '''Überschrift: '= Ports =' ''' |
+ | |||
+ | Für jeden Kanal gibt es eine Zeile des Formats: | ||
+ | | | ||
+ | | bgcolor="#666666" | | ||
− | |||
− | |||
− | |||
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | colspan="2" | '''PORT <port> <direction> ''' | + | | colspan="2" nowrap="NOWRAP" | '''PORT <port> <direction> ''' |
− | | | + | | |
− | | bgcolor="#666666" | | + | | bgcolor="#666666" | |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | colspan="3" | Werte für '''<port>''' sind: | + | | colspan="3" | Werte für '''<port>''' sind: |
− | | | + | | |
− | | bgcolor="#666666" | | + | | bgcolor="#666666" | |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | COMMAND | + | | nowrap="NOWRAP" | COMMAND |
− | | nowrap="NOWRAP" | Kommando Port <br /> Befehle des Clients an den Server, direkte Antworten des Servers darauf. | + | | nowrap="NOWRAP" | Kommando Port <br /> |
− | | | + | Befehle des Clients an den Server, direkte Antworten des Servers darauf. |
− | | bgcolor="#666666" | | + | | |
+ | | bgcolor="#666666" | | ||
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | FEEDBACK | + | | FEEDBACK |
− | | Rückmelde Port <br /> Statusänderungen von Rückmelde Modulen. | + | | Rückmelde Port <br /> Statusänderungen von Rückmelde Modulen. |
− | | | + | | |
− | | bgcolor="#666666" | | + | | bgcolor="#666666" | |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | INFO | + | | INFO |
− | | Info Port (Broadcast Kanal) <br /> Statusänderungen von Lok- und Schaltdekodern, Modellzeit. | + | | Info Port (Broadcast Kanal) <br /> Statusänderungen von Lok- und Schaltdekodern, Modellzeit. |
− | | | + | | |
− | | bgcolor="#666666" | | + | | bgcolor="#666666" | |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | colspan="3" | Werte für '''<direction>''' sind: | + | | colspan="3" | Werte für '''<direction>''' sind: |
− | | | + | | |
− | | bgcolor="#666666" | | + | | bgcolor="#666666" | |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | CLIENT | + | | CLIENT || Unidirektional vom Client zum Server |
− | | Unidirektional vom Client zum Server | + | | |
− | | | + | | bgcolor="#666666" | |
− | | bgcolor="#666666" | | + | |
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | SERVER | + | | SERVER || Unidirektional vom Server zum Client |
− | | Unidirektional vom Server zum Client | + | | |
− | | | + | | bgcolor="#666666" | |
− | | bgcolor="#666666" | | + | |
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | BOTH | + | | BOTH || Bidirektional |
− | | Bidirektional | + | | |
− | | | + | | bgcolor="#666666" | |
− | | bgcolor="#666666" | | + | |
|} | |} | ||
+ | |||
=== 2.3 Serverbefehle === | === 2.3 Serverbefehle === | ||
− | {| width=" | + | {| width="98%" cellpadding="1" align="Center" cellspacing="0" border="0" |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | colspan="3" | | + | | colspan="3" | |
Welche Befehle werden von einer Server zu seiner Steuerung akzeptiert. Dies ist durch das SRCP weitgehend festgelegt. | Welche Befehle werden von einer Server zu seiner Steuerung akzeptiert. Dies ist durch das SRCP weitgehend festgelegt. | ||
− | '''Überschrift: '= Server Commands ='''' | + | '''Überschrift: '= Server Commands =' ''' |
+ | |||
+ | Für jeden Befehl gibt es eine Zeile des Formats: | ||
+ | | | ||
+ | | bgcolor="#666666" | | ||
− | |||
− | |||
− | |||
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | colspan="2" | '''SCMD <command> ''' | + | | colspan="2" nowrap="NOWRAP" | '''SCMD <command> ''' |
− | | | + | | |
− | | bgcolor="#666666" | | + | | bgcolor="#666666" | |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | colspan="3" | Werte für '''<command>''' sind: | + | | colspan="3" | Werte für '''<command>''' sind: |
− | | | + | | |
− | | bgcolor="#666666" | | + | | bgcolor="#666666" | |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | LOGOUT | + | | LOGOUT || Befehl zum Beenden der Verbindung zu einem Client. |
− | | Befehl zum Beenden der Verbindung zu einem Client. | + | | |
− | | | + | | bgcolor="#666666" | |
− | | bgcolor="#666666" | | + | |
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | RESET | + | | RESET || Befehl zur Neu-Initialisieung des Servers. |
− | | Befehl zur Neu-Initialisieung des Servers. | + | | |
− | | | + | | bgcolor="#666666" | |
− | | bgcolor="#666666" | | + | |
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | SHUTDOWN | + | | nowrap="NOWRAP" | SHUTDOWN |
− | | Befehl zum Beenden des Servers. | + | | Befehl zum Beenden des Servers. |
− | | | + | | |
− | | bgcolor="#666666" | | + | | bgcolor="#666666" | |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | VOLTAGE | + | | nowrap="NOWRAP" | VOLTAGE |
− | | nowrap="NOWRAP" | Ein-/Ausschalten des Digitalstroms über STARTVOLTAGE/STOPVOLTAGE <br /> Kompatibilität zu früheren Versionen des SRCP | + | | nowrap="NOWRAP" | |
− | | | + | Ein-/Ausschalten des Digitalstroms über STARTVOLTAGE/STOPVOLTAGE <br /> |
− | | bgcolor="#666666" | | + | Kompatibilität zu früheren Versionen des SRCP |
+ | | | ||
+ | | bgcolor="#666666" | | ||
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | POWER | + | | nowrap="NOWRAP" | POWER |
− | | Ein-/Ausschalten des Digitalstroms über SET POWER [ON/OFF] <br /> Aktueller Befehl in SRCP (ab Version 0.???) | + | | nowrap="NOWRAP" | |
− | | | + | Ein-/Ausschalten des Digitalstroms über SET POWER [ON/OFF] <br /> |
− | | bgcolor="#666666" | | + | Aktueller Befehl in SRCP (ab Version 0.???) |
+ | | | ||
+ | | bgcolor="#666666" | | ||
|} | |} | ||
+ | |||
=== 2.4 Allgemeine Befehle === | === 2.4 Allgemeine Befehle === | ||
− | {| width=" | + | {| width="98%" cellpadding="1" align="Center" cellspacing="0" border="0" |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | colspan="3" | | + | | colspan="3" | |
Welche Befehle werden von einer Server zu seiner Steuerung akzeptiert. Dies ist durch das SRCP weitgehend festgelegt. | Welche Befehle werden von einer Server zu seiner Steuerung akzeptiert. Dies ist durch das SRCP weitgehend festgelegt. | ||
− | '''Überschrift: '= General Commands ='''' | + | '''Überschrift: '= General Commands =' ''' |
+ | |||
+ | Für jeden Befehl gibt es eine Zeile des Formats: | ||
+ | | | ||
+ | | bgcolor="#666666" | | ||
− | |||
− | |||
− | |||
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | colspan="2" | '''GCMD <command> ''' | + | | colspan="2" nowrap="NOWRAP" | '''GCMD <command> ''' |
− | | | + | | |
− | | bgcolor="#666666" | | + | | bgcolor="#666666" | |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | colspan="3" | Werte für '''<command>''' sind: | + | | colspan="3" | Werte für '''<command>''' sind: |
− | | | + | | |
− | | bgcolor="#666666" | | + | | bgcolor="#666666" | |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | SET | + | | SET || Befehl zum Setzen eines Wertes. |
− | | Befehl zum Setzen eines Wertes. | + | | |
− | | | + | | bgcolor="#666666" | |
− | | bgcolor="#666666" | | + | |
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | GET | + | | GET || Befehl zum Ermitteln eines Wertes. |
− | | Befehl zum Ermitteln eines Wertes. | + | | |
− | | | + | | bgcolor="#666666" | |
− | | bgcolor="#666666" | | + | |
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | WAIT | + | | WAIT |
− | | Befehl zum Warten bis ein bestimmter Zustand erreicht wird. | + | | nowrap="NOWRAP" | Befehl zum Warten bis ein bestimmter Zustand erreicht wird. |
− | | | + | | |
− | | bgcolor="#666666" | | + | | bgcolor="#666666" | |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | INIT | + | | INIT || Befehl zum Initialisieren von Geräte(gruppen). |
− | | Befehl zum Initialisieren von Geräte(gruppen). | + | | |
− | | | + | | bgcolor="#666666" | |
− | | bgcolor="#666666" | | + | |
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | TERM | + | | TERM |
− | | nowrap="NOWRAP" | Befehl zum Aufheben von mit INIT getroffenen Einstellungen. | + | | nowrap="NOWRAP" | Befehl zum Aufheben von mit INIT getroffenen Einstellungen. |
− | | | + | | |
− | | bgcolor="#666666" | | + | | bgcolor="#666666" | |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | WRITE | + | | WRITE |
− | | Befehl zum Programmieren eines Wertes eines Dekoders. | + | | nowrap="NOWRAP" | Befehl zum Programmieren eines Wertes eines Dekoders. |
− | | | + | | |
− | | bgcolor="#666666" | | + | | bgcolor="#666666" | |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | READ | + | | READ || Befehl zum Lesen eines Wertes eines Dekoders. |
− | | Befehl zum Lesen eines Wertes eines Dekoders. | + | | |
− | | | + | | bgcolor="#666666" | |
− | | bgcolor="#666666" | | + | |
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | VERIFY | + | | nowrap="NOWRAP" | VERIFY |
− | | Befehl zum Überprüfen eines Wertes eines Dekoders. | + | | nowrap="NOWRAP" | Befehl zum Überprüfen eines Wertes eines Dekoders. |
− | | | + | | |
− | | bgcolor="#666666" | | + | | bgcolor="#666666" | |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | CONFGET | + | | nowrap="NOWRAP" | CONFGET |
− | | Befehl zum Ermitteln von Konfigurationsinformationen. | + | | nowrap="NOWRAP" | Befehl zum Ermitteln von Konfigurationsinformationen. |
− | | | + | | |
− | | bgcolor="#666666" | | + | | bgcolor="#666666" | |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | colspan="3" | Ein Befehl, der nicht eingetragen ist, wird nicht unterstützt. Lediglich der Befehl SET ist zwingend vorgeschrieben, alle anderen können implementiert werden. <br /> Der Befehl GET wird meistens unterstützt, der Befehl WAIT falls Rückmelder oder Modellzeit unterstützt werden. Die Befehle WRITE, READ, VERIFY dienen dem Programmieren von Dekodern. Sie werden nur dann unterstützt, wenn ein Server diese Funktionalität bereitstellt. | + | | colspan="3" | |
− | | | + | Ein Befehl, der nicht eingetragen ist, wird nicht unterstützt. Lediglich der Befehl SET ist zwingend vorgeschrieben, alle anderen können implementiert werden. <br /> |
− | | bgcolor="#666666" | | + | Der Befehl GET wird meistens unterstützt, der Befehl WAIT falls Rückmelder oder Modellzeit unterstützt werden. Die Befehle WRITE, READ, VERIFY dienen dem Programmieren von Dekodern. Sie werden nur dann unterstützt, wenn ein Server diese Funktionalität bereitstellt. |
+ | | | ||
+ | | bgcolor="#666666" | | ||
|} | |} | ||
+ | |||
=== 2.5 Protokolle Lokdekoder === | === 2.5 Protokolle Lokdekoder === | ||
− | {| width=" | + | {| width="98%" cellpadding="1" align="Center" cellspacing="0" border="0" |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | colspan="3" | | + | | colspan="3" | |
− | Welche Protokolle für Lokdekoder werden von einem Server akzeptiert. Funktionsdekoder werden wie Lokdekoder behandelt. <br /> Dies ist zwar durch das SRCP festgelegt, jedoch muss ein Server nicht alle in SRCP beschriebenen Protokolle unterstützen (z.B. Ansteuerung einer systemspezifischen Zentraleinheit). Weiter sind bereits Werte für noch nicht unterstützte Protokolle reserviert. | + | Welche Protokolle für Lokdekoder werden von einem Server akzeptiert. Funktionsdekoder werden wie Lokdekoder behandelt. <br /> |
+ | Dies ist zwar durch das SRCP festgelegt, jedoch muss ein Server nicht alle in SRCP beschriebenen Protokolle unterstützen (z.B. Ansteuerung einer systemspezifischen Zentraleinheit). Weiter sind bereits Werte für noch nicht unterstützte Protokolle reserviert. | ||
− | '''Überschrift: '= Protocols Loco & Function ='''' | + | '''Überschrift: '= Protocols Loco & Function =' ''' |
+ | |||
+ | Für jedes unterstützte Protokoll gibt es eine Zeile des Formats: | ||
+ | | | ||
+ | | bgcolor="#666666" | | ||
− | |||
− | |||
− | |||
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | colspan="2" | '''PRGL <prot> <addrmax> <speedmax> <dir> <n-func>''' | + | | colspan="2" nowrap="NOWRAP" | '''PRGL <prot> <addrmax> <speedmax> <dir> <n-func>''' |
− | | | + | | |
− | | bgcolor="#666666" | | + | | bgcolor="#666666" | |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | colspan="3" | Werte für '''<prot>''' sind: | + | | colspan="3" | Werte für '''<prot>''' sind: |
− | | | + | | |
− | | bgcolor="#666666" | | + | | bgcolor="#666666" | |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | M. | + | | M. |
− | | nowrap="NOWRAP" | Protokolle nach den Märklin/Motorola Standards. | + | | nowrap="NOWRAP" | Protokolle nach den Märklin/Motorola Standards. |
− | | | + | | |
− | | bgcolor="#666666" | | + | | bgcolor="#666666" | |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | N. | + | | N. || Protokolle nach den NMRA-DCC Standards. |
− | | Protokolle nach den NMRA-DCC Standards. | + | | |
− | | | + | | bgcolor="#666666" | |
− | | bgcolor="#666666" | | + | |
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | ''S.'' | + | | ''S.'' |
− | | ''Protokolle nach den Trix Selectrix Standards.'' | + | | nowrap="NOWRAP" | ''Protokolle nach den Trix Selectrix Standards.'' |
− | | | + | | |
− | | bgcolor="#666666" | | + | | bgcolor="#666666" | |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | ''F.'' | + | | ''F.'' |
− | | ''Protokolle nach den Fleischmann FMZ Standards.'' | + | | nowrap="NOWRAP" | ''Protokolle nach den Fleischmann FMZ Standards.'' |
− | | | + | | |
− | | bgcolor="#666666" | | + | | bgcolor="#666666" | |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | ''Z.'' | + | | ''Z.'' || ''Protokolle nach den ZIMO Standards.'' |
− | | ''Protokolle nach den ZIMO Standards.'' | + | | |
− | | | + | | bgcolor="#666666" | |
− | | bgcolor="#666666" | | + | |
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | colspan="2" | | + | | colspan="2" | |
− | Der Punkt ist durch geeignete Buchstaben/Ziffern zu ersetzen. Siehe dazu die aktuelle Spezifikation des SRCP. <br /> Die Werte für Selectrix, FMZ und ZIMO sind reserviert für zukünftige Entwicklungen (Intellibox, Twin-Box, ...). | + | Der Punkt ist durch geeignete Buchstaben/Ziffern zu ersetzen. Siehe dazu die aktuelle Spezifikation des SRCP. <br /> |
+ | Die Werte für Selectrix, FMZ und ZIMO sind reserviert für zukünftige Entwicklungen (Intellibox, Twin-Box, ...). | ||
PS (= Protocol by Server) ist hier nicht aufgeführt, da es kein reales Protokoll ist, sondern eine Anweisung an den Server, selbständig ein geeignetes Protokoll zu wählen. | PS (= Protocol by Server) ist hier nicht aufgeführt, da es kein reales Protokoll ist, sondern eine Anweisung an den Server, selbständig ein geeignetes Protokoll zu wählen. | ||
− | | | + | | |
− | | bgcolor="#666666" | | + | | bgcolor="#666666" | |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | colspan="3" | Wert für '''<addrmax>''' | + | | colspan="3" | Wert für '''<addrmax>''': |
− | | | + | | |
− | | bgcolor="#666666" | | + | | bgcolor="#666666" | |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | colspan="2" | Der Wert für <addrmax> gibt die höchste Adresse an, die von diesem Protokoll unterstützt wird. Aktuelle Werte für den Adressbereich sind 80, 99, 256, 9999. Ein Adressbereich beginnt immer bei der Adresse 0. | + | | colspan="2" | |
− | | | + | Der Wert für <addrmax> gibt die höchste Adresse an, die von diesem Protokoll unterstützt wird. Aktuelle Werte für den Adressbereich sind 80, 99, 256, 9999. Ein Adressbereich beginnt immer bei der Adresse 0. |
− | | bgcolor="#666666" | | + | | |
+ | | bgcolor="#666666" | | ||
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | colspan="3" | Wert für '''<speedmax>''' | + | | colspan="3" | Wert für '''<speedmax>''': |
− | | | + | | |
− | | bgcolor="#666666" | | + | | bgcolor="#666666" | |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | colspan="2" | Der Wert für <speedmax> gibt die höchste Fahrstufen an, die von diesem Protokoll unterstützt wird. Aktuelle Werte für die höchste Fahrstufe sind 14, 27, 28, 128. Ein Fahrstufenbereich beginnt immer bei der Fahrstufe 0. | + | | colspan="2" | |
− | | | + | Der Wert für <speedmax> gibt die höchste Fahrstufen an, die von diesem Protokoll unterstützt wird. Aktuelle Werte für die höchste Fahrstufe sind 14, 27, 28, 128. Ein Fahrstufenbereich beginnt immer bei der Fahrstufe 0. |
− | | bgcolor="#666666" | | + | | |
+ | | bgcolor="#666666" | | ||
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | colspan="3" | Werte für '''<dir>''' sind: | + | | colspan="3" | Werte für '''<dir>''' sind: |
− | | | + | | |
− | | bgcolor="#666666" | | + | | bgcolor="#666666" | |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | abs | + | | abs || Absolute Fahrtrichtungsangabe. |
− | | Absolute Fahrtrichtungsangabe. | + | | |
− | | | + | | bgcolor="#666666" | |
− | | bgcolor="#666666" | | + | |
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | rel | + | | rel || Relative Fahrtrichtungsangabe. |
− | | Relative Fahrtrichtungsangabe. | + | | |
− | | | + | | bgcolor="#666666" | |
− | | bgcolor="#666666" | | + | |
|- valign="Top" | |- valign="Top" | ||
− | | colspan="3" | Wert für '''<n-func>''' | + | | colspan="3" | Wert für '''<n-func>''': |
− | | | + | | |
− | | bgcolor="#666666" | | + | | bgcolor="#666666" | |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | colspan="2" | Der Wert für <n-func> gibt an wieviele Zusatzfunktionen von diesem Protokoll unterstützt werden. Aktuelle Dekoder untertützen 0, 2, 4, 8 Zusatzfunktionen. Es wird implizit davon ausgegeangen, dass eine Standardfunktion immer implementiert ist. | + | | colspan="2" | |
− | | | + | Der Wert für <n-func> gibt an wieviele Zusatzfunktionen von diesem Protokoll unterstützt werden. Aktuelle Dekoder untertützen 0, 2, 4, 8 Zusatzfunktionen. Es wird implizit davon ausgegeangen, dass eine Standardfunktion immer implementiert ist. |
− | | bgcolor="#666666" | | + | | |
+ | | bgcolor="#666666" | | ||
|} | |} | ||
+ | |||
=== 2.6 Protokolle Schaltdekoder === | === 2.6 Protokolle Schaltdekoder === | ||
− | {| width=" | + | {| width="98%" cellpadding="1" align="Center" cellspacing="0" border="0" |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | colspan="3" | | + | | colspan="3" | |
− | Welche Protokolle für Schaltdekoder werden von einem Server akzeptiert. Dies ist zwar durch das SRCP festgelegt, jedoch muss ein Server nicht alle in SRCP beschriebenen Protokolle unterstützen (z.B. Ansteuerung einer systemspezifischen Zentraleinheit). Weiter sind bereits Werte für noch nicht unterstützte Protokolle reserviert. | + | Welche Protokolle für Schaltdekoder werden von einem Server akzeptiert. <br /> |
+ | Dies ist zwar durch das SRCP festgelegt, jedoch muss ein Server nicht alle in SRCP beschriebenen Protokolle unterstützen (z.B. Ansteuerung einer systemspezifischen Zentraleinheit). Weiter sind bereits Werte für noch nicht unterstützte Protokolle reserviert. | ||
+ | |||
+ | '''Überschrift: '= Protocols Accessory =' ''' | ||
− | + | Für jedes unterstützte Protokoll gibt es eine Zeile des Formats: | |
+ | | | ||
+ | | bgcolor="#666666" | | ||
− | |||
− | |||
− | |||
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | colspan="2" | '''PRGA <prot> <addrmax>''' | + | | colspan="2" nowrap="NOWRAP" | '''PRGA <prot> <addrmax>''' |
− | | | + | | |
− | | bgcolor="#666666" | | + | | bgcolor="#666666" | |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | colspan="3" | Werte für '''<prot>''' sind: | + | | colspan="3" | Werte für '''<prot>''' sind: |
− | | | + | | |
− | | bgcolor="#666666" | | + | | bgcolor="#666666" | |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | N | + | | N |
− | | nowrap="NOWRAP" | Protokoll nach den Märklin/Motorola Standards. | + | | nowrap="NOWRAP" | Protokoll nach den Märklin/Motorola Standards. |
− | | | + | | |
− | | bgcolor="#666666" | | + | | bgcolor="#666666" | |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | M | + | | M || Protokoll nach den NMRA-DCC Standards. |
− | | Protokoll nach den NMRA-DCC Standards. | + | | |
− | | | + | | bgcolor="#666666" | |
− | | bgcolor="#666666" | | + | |
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | ''S'' | + | | ''S'' |
− | | ''Protokoll nach den Trix Selectrix Standards.'' | + | | nowrap="NOWRAP" | ''Protokoll nach den Trix Selectrix Standards.'' |
− | | | + | | |
− | | bgcolor="#666666" | | + | | bgcolor="#666666" | |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | ''F'' | + | | ''F'' |
− | | ''Protokoll nach den Fleischmann FMZ Standards.'' | + | | nowrap="NOWRAP" | ''Protokoll nach den Fleischmann FMZ Standards.'' |
− | | | + | | |
− | | bgcolor="#666666" | | + | | bgcolor="#666666" | |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | ''Z'' | + | | ''Z'' || ''Protokoll nach den ZIMO Standards.'' |
− | | ''Protokoll nach den ZIMO Standards.'' | + | | |
− | | | + | | bgcolor="#666666" | |
− | | bgcolor="#666666" | | + | |
|- valign="Top" | |- valign="Top" | ||
− | | colspan="3" | Wert für '''<addrmax>''' | + | | colspan="3" | Wert für '''<addrmax>''': |
− | | | + | | |
− | | bgcolor="#666666" | | + | | bgcolor="#666666" | |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | colspan="2" | Der Wert für <addrmax> gibt die höchste Adresse an, die von diesem Protokoll unterstützt wird. Aktuelle Werte für den Adressbereich sind ???, 4096. Ein Adressbereich beginnt bei der Adresse 1. | + | | colspan="2" | |
− | | | + | Der Wert für <addrmax> gibt die höchste Adresse an, die von diesem Protokoll unterstützt wird. Aktuelle Werte für den Adressbereich sind ???, 4096. Ein Adressbereich beginnt bei der Adresse 1. |
− | | bgcolor="#666666" | | + | | |
+ | | bgcolor="#666666" | | ||
|} | |} | ||
+ | |||
=== 2.7 Protokolle Rückmelde Module === | === 2.7 Protokolle Rückmelde Module === | ||
− | {| width=" | + | {| width="98%" cellpadding="1" align="Center" cellspacing="0" border="0" |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | colspan="3" | | + | | colspan="3" | |
− | Welche Rückmelde Module und Anschlussarten werden von einem Server akzeptiert. <br /> Dies ist zwar durch das SRCP festgelegt, jedoch muss ein Server nicht alle in SRCP beschriebenen Module oder Arten unterstützen. Weiter sind bereits Werte für noch nicht definierte Protokolle reserviert. | + | Welche Rückmelde Module und Anschlussarten werden von einem Server akzeptiert. <br /> |
+ | Dies ist zwar durch das SRCP festgelegt, jedoch muss ein Server nicht alle in SRCP beschriebenen Module oder Arten unterstützen. Weiter sind bereits Werte für noch nicht definierte Protokolle reserviert. | ||
'''Überschrift: '= Feedback Types =' ''' | '''Überschrift: '= Feedback Types =' ''' | ||
− | + | Für jeden unterstützten Modultyp gibt es eine Zeile des Formats: | |
− | | | + | | |
− | | bgcolor="#666666" | | + | | bgcolor="#666666" | |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | colspan="2" | '''PRFB <module-type> <port-max> <port-inc>''' | + | | colspan="2" nowrap="NOWRAP" | '''PRFB <module-type> <port-max> <port-inc>''' |
− | | | + | | |
− | | bgcolor="#666666" | | + | | bgcolor="#666666" | |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | colspan="3" | Werte für '''<module-type>''' sind: | + | | colspan="3" | Werte für '''<module-type>''' sind: |
− | | | + | | |
− | | bgcolor="#666666" | | + | | bgcolor="#666666" | |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | S88 | + | | S88 || Märklin s88-Bus am Parallelport des PC. |
− | | Märklin s88-Bus am Parallelport des PC. | + | | |
− | | | + | | bgcolor="#666666" | |
− | | bgcolor="#666666" | | + | |
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | I8255 | + | | I8255 || i8255 Karte. |
− | | i8255 Karte. | + | | |
− | | | + | | bgcolor="#666666" | |
− | | bgcolor="#666666" | | + | |
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | M6051 | + | | M6051 || Märklin s88-Bus via Interface 6051. |
− | | Märklin s88-Bus via Interface 6051. | + | | |
− | | | + | | bgcolor="#666666" | |
− | | bgcolor="#666666" | | + | |
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | ''LENZFB'' | + | | ''LENZFB'' || ''Rückmelde-Module aus dem Lenz System.'' |
− | | ''Rückmelde-Module aus dem Lenz System.'' | + | | |
− | | | + | | bgcolor="#666666" | |
− | | bgcolor="#666666" | | + | |
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | ''DTFB'' | + | | ''DTFB'' |
− | | nowrap="NOWRAP" | ''Rückmelde-Module aus dem Digitrax System (LocoNet).'' | + | | nowrap="NOWRAP" | ''Rückmelde-Module aus dem Digitrax System (LocoNet).'' |
− | | | + | | |
− | | bgcolor="#666666" | | + | | bgcolor="#666666" | |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | ''SELFB'' | + | | ''SELFB'' |
− | | ''Rückmelde-Module aus dem Trix Selectrix System.'' | + | | nowrap="NOWRAP" | ''Rückmelde-Module aus dem Trix Selectrix System.'' |
− | | | + | | |
− | | bgcolor="#666666" | | + | | bgcolor="#666666" | |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | ''FMZFB'' | + | | ''FMZFB'' |
− | | ''Rückmelde-Module aus dem Fleischmann FMZ System.'' | + | | nowrap="NOWRAP" | ''Rückmelde-Module aus dem Fleischmann FMZ System.'' |
− | | | + | | |
− | | bgcolor="#666666" | | + | | bgcolor="#666666" | |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | ''ZIMOFB'' | + | | ''ZIMOFB'' || ''Rückmelde-Module aus dem ZIMO System.'' |
− | | ''Rückmelde-Module aus dem ZIMO System.'' | + | | |
− | | | + | | bgcolor="#666666" | |
− | | bgcolor="#666666" | | + | |
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | Hinweis: | + | | Hinweis: || Die letzten fünf sind reservierte Namen, die sich ggfs. noch ändern können. |
− | | Die letzten fünf sind reservierte Namen, die sich ggfs. noch ändern können. | + | | |
− | | | + | | bgcolor="#666666" | |
− | | bgcolor="#666666" | | + | |
|- valign="Top" | |- valign="Top" | ||
− | | colspan="3" | Wert von '''<port-max>''' | + | | colspan="3" | Wert von '''<port-max>''' |
− | | | + | | |
− | | bgcolor="#666666" | | + | | bgcolor="#666666" | |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | colspan="2" | Der Wert von <port-max> gibt die höchste Adresse an, die für diesen Modultype zulässig ist. Ein Nummerbereich beginnt mit (0 | 1) ???. | + | | colspan="2" | |
− | | | + | Der Wert von <port-max> gibt die höchste Adresse an, die für diesen Modultype zulässig ist. Ein Nummerbereich beginnt mit (0 | 1) ???. |
− | | bgcolor="#666666" | | + | | |
+ | | bgcolor="#666666" | | ||
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | colspan="3" | Wert von '''<port-inc>''' | + | | colspan="3" | Wert von '''<port-inc>''' |
− | | | + | | |
− | | bgcolor="#666666" | | + | | bgcolor="#666666" | |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | colspan="2" | Der Wert von <port-inc> gibt an wieviele Ports in einem Modul dieses Typs zusammengefasst sind. | + | | colspan="2" | Der Wert von <port-inc> gibt an wieviele Ports in einem Modul dieses Typs zusammengefasst sind. |
− | | | + | | |
− | | bgcolor="#666666" | | + | | bgcolor="#666666" | |
|} | |} | ||
+ | |||
=== 2.8 Sonstige Gerätetypen === | === 2.8 Sonstige Gerätetypen === | ||
− | {| width=" | + | {| width="98%" cellpadding="1" align="Center" cellspacing="0" border="0" |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | colspan="3" | Dies kann erst dann spezifiziert werden, wenn entsprechende Definitionen in SRCP vorliegen. | + | | colspan="3" | Dies kann erst dann spezifiziert werden, wenn entsprechende Definitionen in SRCP vorliegen. |
− | | | + | | |
− | | bgcolor="#666666" | | + | | bgcolor="#666666" | |
|} | |} | ||
− | |||
− | {| width=" | + | |
+ | == 3 Geräte und ihre Eigenschaften == | ||
+ | |||
+ | {| width="98%" cellpadding="1" align="Center" cellspacing="0" border="0" | ||
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | colspan="3" | Hier werden die Eigenschaften beschrieben, die ein tatsächliches Gerät (Lok-, Schaltdekoder, Rückmeldemodul) hat. Das heißt, welche Funktionen von einem Dekoder oder Modul tatsächlich realisiert werden. Dies kann ggfs. weniger sein, als das Protokoll erlaubt. | + | | colspan="3" | |
− | | | + | Hier werden die Eigenschaften beschrieben, die ein tatsächliches Gerät (Lok-, Schaltdekoder, Rückmeldemodul) hat. Das heißt, welche Funktionen von einem Dekoder oder Modul tatsächlich realisiert werden. Dies kann ggfs. weniger sein, als das Protokoll erlaubt. |
− | | bgcolor="#666666" | | + | | |
+ | | bgcolor="#666666" | | ||
|} | |} | ||
+ | |||
=== 3.1 Lok- und Funktionsdekoder === | === 3.1 Lok- und Funktionsdekoder === | ||
− | {| width=" | + | {| width="98%" cellpadding="1" align="Center" cellspacing="0" border="0" |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | colspan="3" | | + | | colspan="3" | '''Überschrift: '= Locomotive & Function =' ''' |
− | '''Überschrift: '= Locomotive & Function ='''' | + | |
+ | Für jeden definierten Lok- und Funktionsdekoder gibt es eine Zeile des Formats: | ||
+ | | | ||
+ | | bgcolor="#666666" | | ||
− | |||
− | |||
− | |||
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | colspan="2" | '''DCGL <name> <prot> <addr> <speed> <dir> <n-func> <prog> [<type>]''' | + | | colspan="2" nowrap="NOWRAP" | '''DCGL <name> <prot> <addr> <speed> <dir> <n-func> <prog> [<type>]''' |
− | | | + | | |
− | | bgcolor="#666666" | | + | | bgcolor="#666666" | |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | colspan="3" | Wert von '''<name>''' | + | | colspan="3" | Wert von '''<name>''' |
− | | | + | | |
− | | bgcolor="#666666" | | + | | bgcolor="#666666" | |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | colspan="2" | Der Wert von <name> ist ein eindeutiger Name für diesen Lok-/Funktions- Dekoder (z.B. die Loknummer). Der Name muss ein Wort sein. Das heisst er darf kein Leerzeichen oder Tabultorzeichen enthalten. Zur optischen Gliederung ist ggfs. das Zeichen '-' einzusetzen . Beispiele: "V188-003", "Berghexe", "Zuckersusi". <br /> Soll keine Name angegeben werden, ist stattdessen das Zeichen '-' zu verwenden. | + | | colspan="2" | |
− | | | + | Der Wert von <name> ist ein eindeutiger Name für diesen Lok-/Funktions- Dekoder (z.B. die Loknummer). Der Name muss ein Wort sein. Das heisst er darf kein Leerzeichen oder Tabultorzeichen enthalten. Zur optischen Gliederung ist ggfs. das Zeichen '-' einzusetzen . Beispiele: "V188-003", "Berghexe", "Zuckersusi". <br /> |
− | | bgcolor="#666666" | | + | Soll keine Name angegeben werden, ist stattdessen das Zeichen '-' zu verwenden. |
+ | | | ||
+ | | bgcolor="#666666" | | ||
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | colspan="3" | Werte für '''<prot>'''<nowiki>: </nowiki> | + | | colspan="3" | Werte für '''<prot>'''<nowiki>: </nowiki> |
− | | | + | | |
− | | bgcolor="#666666" | | + | | bgcolor="#666666" | |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | colspan="2" | | + | | colspan="2" nowrap="NOWRAP" | |
− | Die Werte für <prot> sind wie in | + | Die Werte für <prot> sind wie in [[#2.5 Protokolle Lokdekoder]] definiert. |
− | | | + | | |
− | | bgcolor="#666666" | | + | | bgcolor="#666666" | |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | colspan="3" | Wert von '''<addr>''' | + | | colspan="3" | Wert von '''<addr>''': |
− | | | + | | |
− | | bgcolor="#666666" | | + | | bgcolor="#666666" | |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | colspan="2" | Der Wert von <addr> gibt die Adresse dieses Dekoders unter dem gewählten Protokoll an. Multiprotokolldekoder können demgemäss mehrere Einträge haben. | + | | colspan="2" | |
− | | | + | Der Wert von <addr> gibt die Adresse dieses Dekoders unter dem gewählten Protokoll an. Multiprotokolldekoder können demgemäss mehrere Einträge haben. |
− | | bgcolor="#666666" | | + | | |
+ | | bgcolor="#666666" | | ||
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | colspan="3" | Wert für '''<speed>'''<nowiki>: </nowiki> | + | | colspan="3" | Wert für '''<speed>'''<nowiki>: </nowiki> |
− | | | + | | |
− | | bgcolor="#666666" | | + | | bgcolor="#666666" | |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | colspan="2" | Der Wert von <speed> gibt die höchste Fahrstufen an, die von diesem Dekoder unterstützt wird. Für Funktionsdekoder ist dieser Wert ggfs. auf 0 zu setzen. | + | | colspan="2" | |
− | | | + | Der Wert von <speed> gibt die höchste Fahrstufen an, die von diesem Dekoder unterstützt wird. Für Funktionsdekoder ist dieser Wert ggfs. auf 0 zu setzen. |
− | | bgcolor="#666666" | | + | | |
+ | | bgcolor="#666666" | | ||
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | colspan="3" | Werte für '''<dir>''' sind: | + | | colspan="3" | Werte für '''<dir>''' sind: |
− | | | + | | |
− | | bgcolor="#666666" | | + | | bgcolor="#666666" | |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | abs | + | | abs || Absolute Fahrtrichtungsangabe. |
− | | Absolute Fahrtrichtungsangabe. | + | | |
− | | | + | | bgcolor="#666666" | |
− | | bgcolor="#666666" | | + | |
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | rel | + | | rel || Relative Fahrtrichtungsangabe. |
− | | Relative Fahrtrichtungsangabe. | + | | |
− | | | + | | bgcolor="#666666" | |
− | | bgcolor="#666666" | | + | |
|- valign="Top" | |- valign="Top" | ||
− | | colspan="3" | Wert von '''<n-func>'''<nowiki>: </nowiki> | + | | colspan="3" | Wert von '''<n-func>'''<nowiki>: </nowiki> |
− | | | + | | |
− | | bgcolor="#666666" | | + | | bgcolor="#666666" | |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | colspan="2" | Der Wert für <n-func> gibt an wieviele Zusatzfunktionen von diesem Dekoder unterstützt werden. Es wird implizit davon ausgegeangen, dass eine Standardfunktion immer implementiert ist. | + | | colspan="2" | |
− | | | + | Der Wert für <n-func> gibt an wieviele Zusatzfunktionen von diesem Dekoder unterstützt werden. |
− | | bgcolor="#666666" | | + | Es wird implizit davon ausgegeangen, dass eine Standardfunktion immer implementiert ist. |
+ | | | ||
+ | | bgcolor="#666666" | | ||
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | colspan="3" | Der Wert von '''<prog>''' ist ein Wort mit 7 Buchstaben: | + | | colspan="3" | Der Wert von '''<prog>''' ist ein Wort mit 7 Buchstaben: |
− | | | + | | |
− | | bgcolor="#666666" | | + | | bgcolor="#666666" | |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | 1) | + | | 1) |
− | | nowrap="NOWRAP" | Modus (P = Programmiergleis, F = on the Fly [im Betrieb]) | + | | nowrap="NOWRAP" | Modus (P = Programmiergleis, F = on the Fly [im Betrieb]) |
− | | | + | | |
− | | bgcolor="#666666" | | + | | bgcolor="#666666" | |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | 2) | + | | 2) || WRITE- Befehl (W = unterstützt) |
− | | WRITE- Befehl (W = unterstützt) | + | | |
− | | | + | | bgcolor="#666666" | |
− | | bgcolor="#666666" | | + | |
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | 3) | + | | 3) || READ- Befehl (R = unterstützt) |
− | | READ- Befehl (R = unterstützt) | + | | |
− | | | + | | bgcolor="#666666" | |
− | | bgcolor="#666666" | | + | |
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | 4) | + | | 4) || VERIFY-Befehl (V = unterstützt) |
− | | VERIFY-Befehl (V = unterstützt) | + | | |
− | | | + | | bgcolor="#666666" | |
− | | bgcolor="#666666" | | + | |
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | 5) | + | | 5) || REGISTER (R = unterstützt) |
− | | REGISTER (R = unterstützt) | + | | |
− | | | + | | bgcolor="#666666" | |
− | | bgcolor="#666666" | | + | |
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | 6) | + | | 6) || VARIABLE (V = unterstützt) |
− | | VARIABLE (V = unterstützt) | + | | |
− | | | + | | bgcolor="#666666" | |
− | | bgcolor="#666666" | | + | |
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | 7) | + | | 7) || BIT (B = unterstützt) |
− | | BIT (B = unterstützt) | + | | |
− | | | + | | bgcolor="#666666" | |
− | | bgcolor="#666666" | | + | |
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | colspan="2" | Wird eine Funktion nicht unterstützt, so ist statt dessen das Zeichen N (= none) zu setzen. <br /> Beispiele: Ein Dekoder, der nur Register auf dem Programmiergleis schreiben kann, erhält die Zeichenkette "PWNNRNN". <br /> Ein Dekoder, der Register und Variablen im laufenden Betrieb lesen und schreiben kann, erhält die Zeichenkette "FWRNRVN". <br /> Ein Dekoder, der nur über Mäuseklavier und Potis eingestellt wird, erhält die Zeichenkette "NNNNNNN". | + | | colspan="2" | |
− | | | + | Wird eine Funktion nicht unterstützt, so ist statt dessen das Zeichen N (= none) zu setzen. <br /> |
− | | bgcolor="#666666" | | + | Beispiele: Ein Dekoder, der nur Register auf dem Programmiergleis schreiben kann, erhält die Zeichenkette "PWNNRNN". <br /> |
+ | Ein Dekoder, der Register und Variablen im laufenden Betrieb lesen und schreiben kann, erhält die Zeichenkette "FWRNRVN". <br /> | ||
+ | Ein Dekoder, der nur über Mäuseklavier und Potis eingestellt wird, erhält die Zeichenkette "NNNNNNN". | ||
+ | | | ||
+ | | bgcolor="#666666" | | ||
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | colspan="3" | Wert von '''<type>'''<nowiki>: </nowiki> | + | | colspan="3" | Wert von '''<type>'''<nowiki>: </nowiki> |
− | | | + | | |
− | | bgcolor="#666666" | | + | | bgcolor="#666666" | |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | colspan="2" | Der Wert von <type> ist eine Kennung für den Dekodertype. Dekoder des gleichen Typs erhalten den gleichen Wert für <type>. Der Wert von <type> muss ein Wort sein. Das heisst er darf kein Leerzeichen oder Tabultorzeichen enthalten. Zur optischen Gliederung ist ggfs. das Zeichen '-' einzusetzen. Sinnvollerweise hält man sich an die Bezeichnung des Hersteller. Die Angabe dient zur Zeit nur der Dokumentation und ist daher optional. | + | | colspan="2" | |
− | | | + | Der Wert von <type> ist eine Kennung für den Dekodertype. Dekoder des gleichen Typs erhalten den gleichen Wert für <type>. Der Wert von <type> muss ein Wort sein. Das heisst er darf kein Leerzeichen oder Tabultorzeichen enthalten. Zur optischen Gliederung ist ggfs. das Zeichen '-' einzusetzen. Sinnvollerweise hält man sich an die Bezeichnung des Hersteller. Die Angabe dient zur Zeit nur der Dokumentation und ist daher optional. |
− | | bgcolor="#666666" | | + | | |
+ | | bgcolor="#666666" | | ||
|} | |} | ||
+ | |||
=== 3.2 Schaltdekoder === | === 3.2 Schaltdekoder === | ||
− | {| width=" | + | {| width="98%" cellpadding="1" align="Center" cellspacing="0" border="0" |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | colspan="3" | | + | | colspan="3" | '''Überschrift: '= Accessory =' ''' |
− | '''Überschrift: '= Accessory ='''' | + | |
+ | Für jeden definierten Schaltdekoder gibt es eine Zeile des Formats: | ||
+ | | | ||
+ | | bgcolor="#666666" | | ||
− | |||
− | |||
− | |||
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | colspan="2" | '''DCGA <name> <prot> <addrmin> <addrmax> [<type>]''' | + | | colspan="2" nowrap="NOWRAP" | '''DCGA <name> <prot> <addrmin> <addrmax> [<type>]''' |
− | | | + | | |
− | | bgcolor="#666666" | | + | | bgcolor="#666666" | |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | colspan="3" | Wert von '''<name>'''<nowiki>: </nowiki> | + | | colspan="3" | Wert von '''<name>'''<nowiki>: </nowiki> |
− | | | + | | |
− | | bgcolor="#666666" | | + | | bgcolor="#666666" | |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | colspan="2" | Der Wert von <name> ist ein eindeutiger Name für diesen Lok-/Funktions- Dekoder (z.B. die Loknummer). Der Name muss ein Wort sein. Das heisst er darf kein Leerzeichen oder Tabultorzeichen enthalten. Zur optischen Gliederung ist ggfs. das Zeichen '-' einzusetzen . Beispiele: "V188-003", "Berghexe", "Zuckersusi". <br /> Soll keine Name angegeben werden, ist stattdessen das Zeichen '-' zu verwenden. | + | | colspan="2" | |
− | | | + | Der Wert von <name> ist ein eindeutiger Name für diesen Lok-/Funktions- Dekoder (z.B. die Loknummer). Der Name muss ein Wort sein. Das heisst er darf kein Leerzeichen oder Tabultorzeichen enthalten. Zur optischen Gliederung ist ggfs. das Zeichen '-' einzusetzen . Beispiele: "V188-003", "Berghexe", "Zuckersusi". <br /> |
− | | bgcolor="#666666" | | + | Soll keine Name angegeben werden, ist stattdessen das Zeichen '-' zu verwenden. |
+ | | | ||
+ | | bgcolor="#666666" | | ||
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | colspan="3" | Werte für '''<prot>''' sind: | + | | colspan="3" | Werte für '''<prot>''' sind: |
− | | | + | | |
− | | bgcolor="#666666" | | + | | bgcolor="#666666" | |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | colspan="2" nowrap="NOWRAP" | | + | | colspan="2" nowrap="NOWRAP" | |
− | Die Werte für <prot> sind wie in | + | Die Werte für <prot> sind wie in [[#2.6 Protokolle Schaltdekoder]] angegeben. |
− | | | + | | |
− | | bgcolor="#666666" | | + | | bgcolor="#666666" | |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | colspan="3" | Wert von '''<addrmin>'''<nowiki>: </nowiki> | + | | colspan="3" | Wert von '''<addrmin>'''<nowiki>: </nowiki> |
− | | | + | | |
− | | bgcolor="#666666" | | + | | bgcolor="#666666" | |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | colspan="2" | Der Wert von <addrmin> gibt die die Adresse des ersten verwendeten Ausgang dieses Dekoders an. | + | | colspan="2" | Der Wert von <addrmin> gibt die die Adresse des ersten verwendeten Ausgang dieses Dekoders an. |
− | | | + | | |
− | | bgcolor="#666666" | | + | | bgcolor="#666666" | |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | colspan="3" | Wert von '''<addrmax>'''<nowiki>: </nowiki> | + | | colspan="3" | Wert von '''<addrmax>'''<nowiki>: </nowiki> |
− | | | + | | |
− | | bgcolor="#666666" | | + | | bgcolor="#666666" | |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | colspan="2" | Der Wert von <addrmax> gibt die die Adresse des letzten verwendeten Ausgang dieses Dekoders an. | + | | colspan="2" | Der Wert von <addrmax> gibt die die Adresse des letzten verwendeten Ausgang dieses Dekoders an. |
− | | | + | | |
− | | bgcolor="#666666" | | + | | bgcolor="#666666" | |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | colspan="3" | Wert von '''<type>'''<nowiki>: </nowiki> | + | | colspan="3" | Wert von '''<type>'''<nowiki>: </nowiki> |
− | | | + | | |
− | | bgcolor="#666666" | | + | | bgcolor="#666666" | |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | colspan="2" | Der Wert von <type> ist eine Kennung für den Dekodertype. Dekoder des gleichen Typs erhalten den gleichen Wert für <type>. Der Wert von <type> muss ein Wort sein. Das heisst er darf kein Leerzeichen oder Tabultorzeichen enthalten. Zur optischen Gliederung ist ggfs. das Zeichen '-' einzusetzen. Sinnvollerweise hält man sich an die Bezeichnung des Hersteller. Die Angabe dient zur Zeit nur der Dokumentation und ist daher optional. | + | | colspan="2" | |
− | | | + | Der Wert von <type> ist eine Kennung für den Dekodertype. Dekoder des gleichen Typs erhalten den gleichen Wert für <type>. Der Wert von <type> muss ein Wort sein. Das heisst er darf kein Leerzeichen oder Tabultorzeichen enthalten. Zur optischen Gliederung ist ggfs. das Zeichen '-' einzusetzen. Sinnvollerweise hält man sich an die Bezeichnung des Hersteller. Die Angabe dient zur Zeit nur der Dokumentation und ist daher optional. |
− | | bgcolor="#666666" | | + | | |
+ | | bgcolor="#666666" | | ||
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | colspan="3" | Hinweis: | + | | colspan="3" | Hinweis: |
− | | | + | | |
− | | bgcolor="#666666" | | + | | bgcolor="#666666" | |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | colspan="2" | Für einen Einzeldekoder gilt <addrmin> = <addrmax> Auf diese Art kann je nach Wunsch eine Gruppendefiniton oder eine Einzeldefinition der Schaltdekoderausgänge erfolgen. | + | | colspan="2" | |
− | | | + | Für einen Einzeldekoder gilt <addrmin> = <addrmax> Auf diese Art kann je nach Wunsch eine Gruppendefiniton oder eine Einzeldefinition der Schaltdekoderausgänge erfolgen. |
− | | bgcolor="#666666" | | + | | |
+ | | bgcolor="#666666" | | ||
|} | |} | ||
+ | |||
=== 3.3 Rückmelde Module === | === 3.3 Rückmelde Module === | ||
− | {| width=" | + | {| width="98%" cellpadding="1" align="Center" cellspacing="0" border="0" |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | colspan="3" | | + | | colspan="3" | '''Überschrift: '= Feedback Units =' ''' |
− | '''Überschrift: '= Feedback Units ='''' | + | |
+ | Für jede definierte Rückmelde Modul gibt es eine Zeile des Formats: | ||
+ | | | ||
+ | | bgcolor="#666666" | | ||
− | |||
− | |||
− | |||
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | colspan="2" | '''DCGA <name> <modul-type> <port-min> <port-max> [<type>]''' | + | | colspan="2" nowrap="NOWRAP" | '''DCGA <name> <modul-type> <port-min> <port-max> [<type>]''' |
− | | | + | | |
− | | bgcolor="#666666" | | + | | bgcolor="#666666" | |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | colspan="3" | Wert von '''<name>''' | + | | colspan="3" | Wert von '''<name>''': |
− | | | + | | |
− | | bgcolor="#666666" | | + | | bgcolor="#666666" | |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | colspan="2" | Der Wert von <name> ist ein eindeutiger Name für dieses Rückmelde Modul. Der Name muss ein Wort sein. Das heisst er darf kein Leerzeichen oder Tabultorzeichen enthalten. Zur optischen Gliederung ist ggfs. das Zeichen '-' einzusetzen. Beispiele: "V188-003", "Berghexe", "Zuckersusi". <br /> Soll keine Name angegeben werden, ist stattdessen das Zeichen '-' zu verwenden. | + | | colspan="2" | |
− | | | + | Der Wert von <name> ist ein eindeutiger Name für dieses Rückmelde Modul. Der Name muss ein Wort sein. Das heisst er darf kein Leerzeichen oder Tabultorzeichen enthalten. Zur optischen Gliederung ist ggfs. das Zeichen '-' einzusetzen. Beispiele: "V188-003", "Berghexe", "Zuckersusi". <br /> |
− | | bgcolor="#666666" | | + | Soll keine Name angegeben werden, ist stattdessen das Zeichen '-' zu verwenden. |
+ | | | ||
+ | | bgcolor="#666666" | | ||
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | colspan="3" | Werte für '''<modul-type>''' | + | | colspan="3" | Werte für '''<modul-type>''': |
− | | | + | | |
− | | bgcolor="#666666" | | + | | bgcolor="#666666" | |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | colspan="2" | | + | | colspan="2" | |
− | Der Wert von <modul-type> gibt Art des verwendeten Modules an. Es gelten die Werte, die in | + | Der Wert von <modul-type> gibt Art des verwendeten Modules an. Es gelten die Werte, die in [[#2.7 Protokolle Rückmelde Module]] dafür definiert sind. |
− | | | + | | |
− | | bgcolor="#666666" | | + | | bgcolor="#666666" | |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | colspan="3" | Wert von '''<port-min>''' | + | | colspan="3" | Wert von '''<port-min>''': |
− | | | + | | |
− | | bgcolor="#666666" | | + | | bgcolor="#666666" | |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | colspan="2" | Der Wert von <port-min> gibt die Portnummer des ersten verwendeten Eingang dieses Modules an. | + | | colspan="2" | Der Wert von <port-min> gibt die Portnummer des ersten verwendeten Eingang dieses Modules an. |
− | | | + | | |
− | | bgcolor="#666666" | | + | | bgcolor="#666666" | |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | colspan="3" | Wert von '''<port-max>''' | + | | colspan="3" | Wert von '''<port-max>''': |
− | | | + | | |
− | | bgcolor="#666666" | | + | | bgcolor="#666666" | |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | colspan="2" | Der Wert von <port-max> gibt die Portnummer des letzten verwendeten Eingang dieses Modules an. | + | | colspan="2" | Der Wert von <port-max> gibt die Portnummer des letzten verwendeten Eingang dieses Modules an. |
− | | | + | | |
− | | bgcolor="#666666" | | + | | bgcolor="#666666" | |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | colspan="3" | Wert von '''<type>'''<nowiki>: </nowiki> | + | | colspan="3" | Wert von '''<type>'''<nowiki>: </nowiki> |
− | | | + | | |
− | | bgcolor="#666666" | | + | | bgcolor="#666666" | |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | colspan="2" | Der Wert von <type> ist eine Kennung für den konkreten Typ eines Rückmelde Modules. Hier dient er hauptsächlich zur Unterscheidung verschiedener Lieferanten eines Modultypes. Rückmelder des gleichen Typs erhalten den gleichen Wert für <type>. Der Wert von <type> muss ein Wort sein. Das heisst er darf kein Leerzeichen oder Tabultorzeichen enthalten. Zur optischen Gliederung ist ggfs. das Zeichen '-' einzusetzen. Sinnvollerweise hält man sich an die Bezeichnung des Hersteller. Die Angabe dient zur Zeit nur der Dokumentation und ist daher optional. | + | | colspan="2" | |
− | | | + | Der Wert von <type> ist eine Kennung für den konkreten Typ eines Rückmelde Modules. Hier dient er hauptsächlich zur Unterscheidung verschiedener Lieferanten eines Modultypes. Rückmelder des gleichen Typs erhalten den gleichen Wert für <type>. Der Wert von <type> muss ein Wort sein. Das heisst er darf kein Leerzeichen oder Tabultorzeichen enthalten. Zur optischen Gliederung ist ggfs. das Zeichen '-' einzusetzen. Sinnvollerweise hält man sich an die Bezeichnung des Hersteller. Die Angabe dient zur Zeit nur der Dokumentation und ist daher optional. |
− | | bgcolor="#666666" | | + | | |
+ | | bgcolor="#666666" | | ||
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | colspan="3" | Hinweis: | + | | colspan="3" | Hinweis: |
− | | | + | | |
− | | bgcolor="#666666" | | + | | bgcolor="#666666" | |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | colspan="2 | + | | colspan="2" | Mit <port-min> = <port-max> kann man falls gewünscht auch jeden Port einzeln definieren. |
− | | | + | | |
− | | bgcolor="#666666" | | + | | bgcolor="#666666" | |
|} | |} | ||
− | |||
− | {| width=" | + | |
+ | == 4 Sonstiges == | ||
+ | |||
+ | {| width="98%" cellpadding="1" align="Center" cellspacing="0" border="0" | ||
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | colspan="3" | | + | | colspan="3" | |
Dies ist erst einmal ein Platzhalter für zukünftige Erweiterungen oder Festlegungen, die übergreifend sind. Beispielsweise könnte ich mir hier eine Liste von Rückgabewerten vorstellen, wenn das INFO Statement als Antwort auf einen GET Befehl keine Daten zur Verfügung stellen kann. | Dies ist erst einmal ein Platzhalter für zukünftige Erweiterungen oder Festlegungen, die übergreifend sind. Beispielsweise könnte ich mir hier eine Liste von Rückgabewerten vorstellen, wenn das INFO Statement als Antwort auf einen GET Befehl keine Daten zur Verfügung stellen kann. | ||
'''Beispiel: INFO <value> <lang> <Text>''' | '''Beispiel: INFO <value> <lang> <Text>''' | ||
− | + | Dabei ist <value> der Rückgabewert (eine Zahl, in der Regel negativ), <lang> eine Sprache (z.B. de := deutsch, en := englisch). Alle weiteren Worte in dieser Zeile sind dann der Meldungstext. Das Paar <value>, <lang> muss eindeutig sein. Werden mehrere Sprachen angeboten, so sind für jede Sprache alle möglichen Werte von <value> mit Text zu versehen. | |
− | | | + | | |
− | | bgcolor="#666666" | | + | | bgcolor="#666666" | |
|} | |} | ||
− | |||
− | {| width=" | + | |
+ | == 5 Abfrage der Konfiguration == | ||
+ | |||
+ | {| width="98%" cellpadding="1" align="Center" cellspacing="0" border="0" | ||
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | colspan="3" | | + | | colspan="3" | |
− | Der Befehl CONFGET dient dazu, Clients die Möglichkeit zu geben beim Server nachzufragen, welche Fähigkeiten er hat | + | Der Befehl CONFGET dient dazu, Clients die Möglichkeit zu geben beim Server nachzufragen, welche Fähigkeiten er hat (siehe [[#2 Servereigenschaften]]). Diese Angaben sind '''verbindlich'''. |
− | Als zweites kann mit diesem Befehl abgefragt werden, welche Lok-, Funktions-, Schalt-Dekoder und Rückmelde Module dem Server bekannt sind | + | Als zweites kann mit diesem Befehl abgefragt werden, welche Lok-, Funktions-, Schalt-Dekoder und Rückmelde Module dem Server bekannt sind (siehe [[#3 Geräte und ihre Eigenschaften]]). Diese Information dient (mehreren) Clients dazu einen gleichen Informationsstand zu haben. Diese Informationen sind jedoch '''nicht verbindlich'''. |
* Die Informationen müssen nicht vollständig sein. | * Die Informationen müssen nicht vollständig sein. | ||
Zeile 887: | Zeile 1.051: | ||
Informationen zu Schaltdekodern und Rückmeldern als ortsfeste Bauteile hingegen sollten (in der Regel) korrekt und vollständig sein. | Informationen zu Schaltdekodern und Rückmeldern als ortsfeste Bauteile hingegen sollten (in der Regel) korrekt und vollständig sein. | ||
− | + | Anmerkung: | |
− | | | + | | |
− | | bgcolor="#666666" | | + | | bgcolor="#666666" | |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | colspan="2" | Die Spezifikation des Befehl CONFGET gehört eigentlich in das SRCP (Simple Railroad Command Protocol). Dies hier ist nur der erste Vorschlag. | + | | colspan="2" nowrap="NOWRAP" | |
− | | | + | Die Spezifikation des Befehl CONFGET gehört eigentlich in das SRCP <br /> |
− | | bgcolor="#666666" | | + | (Simple Railroad Command Protocol). Dies hier ist nur der erste Vorschlag. |
+ | | | ||
+ | | bgcolor="#666666" | | ||
|} | |} | ||
+ | |||
=== 5.1 Konfigurationstypen === | === 5.1 Konfigurationstypen === | ||
− | {| width=" | + | {| width="98%" cellpadding="1" align="Center" cellspacing="0" border="0" |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | colspan="3" | Zur Zeit sind 10 verschiedene '''Konfigurationstypen''' definiert. | + | | colspan="3" | Zur Zeit sind 10 verschiedene '''Konfigurationstypen''' definiert. |
− | | | + | | |
− | | bgcolor="#666666" | | + | | bgcolor="#666666" | |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | VERS | + | | VERS || <name> <vers> SRCP <srcp> |
− | | <name> <vers> SRCP <srcp> | + | | |
− | | | + | | bgcolor="#666666" | |
− | | bgcolor="#666666" | | + | |
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | PORT | + | | PORT || <port> <direction> |
− | | <port> <direction> | + | | |
− | | | + | | bgcolor="#666666" | |
− | | bgcolor="#666666" | | + | |
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | SCMD | + | | SCMD || <command> |
− | | <command> | + | | |
− | | | + | | bgcolor="#666666" | |
− | | bgcolor="#666666" | | + | |
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | GCMD | + | | GCMD || <command> |
− | | <command | + | | |
− | | | + | | bgcolor="#666666" | |
− | | bgcolor="#666666" | | + | |
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | PRGL | + | | PRGL || <prot> <addrmax> <speedmax> <dir> <n-func> |
− | | <prot> <addrmax> <speedmax> <dir> <n-func> | + | | |
− | | | + | | bgcolor="#666666" | |
− | | bgcolor="#666666" | | + | |
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | PRGA | + | | PRGA || <prot> <addrmax> |
− | | <prot> <addrmax> | + | | |
− | | | + | | bgcolor="#666666" | |
− | | bgcolor="#666666" | | + | |
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | PRFB | + | | PRFB || <module-type> <port-max> <port-inc> |
− | | <module-type> <port-max> <port-inc | + | | |
− | | | + | | bgcolor="#666666" | |
− | | bgcolor="#666666" | | + | |
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | DCGL | + | | DCGL |
− | | nowrap="NOWRAP" | <name> <prot> <addr> <spmax> <dir> <n-func> <prog> [<type>] | + | | nowrap="NOWRAP" | <name> <prot> <addr> <spmax> <dir> <n-func> <prog> [<type>] |
− | | | + | | |
− | | bgcolor="#666666" | | + | | bgcolor="#666666" | |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | DCGA | + | | DCGA || <name> <prot> <addrmin> <addrmax> [<type>] |
− | | <name> <prot> <addrmin> <addrmax> [<type>] | + | | |
− | | | + | | bgcolor="#666666" | |
− | | bgcolor="#666666" | | + | |
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | DCFB | + | | DCFB || <name> <module-type> <port-min> <port-max> [<type>] |
− | | <name> <module-type> <port-min> <port-max> [<type>] | + | | |
− | | | + | | bgcolor="#666666" | |
− | | bgcolor="#666666" | | + | |
|- valign="Top" | |- valign="Top" | ||
− | | colspan="3" | Dabei haben die ersten vier keine weitere Identifikation, die nächsten drei Protokoll/Modultype als genauere Identifikation. Die letzten drei haben Protokoll/Modultype + Adresse/Portnummer als genauere Identifikation. Bei diesen ist jedoch als Besonderheit zwischen dem Konfigurationstyp und der genaueren Identifikation ein frei wählbarer - allerdings eindeutiger - Name eingefügt. | + | | colspan="3" | |
− | | | + | Dabei haben die ersten vier keine weitere Identifikation, die nächsten drei Protokoll/Modultype als genauere Identifikation. Die letzten drei haben Protokoll/Modultype + Adresse/Portnummer als genauere Identifikation. Bei diesen ist jedoch als Besonderheit zwischen dem Konfigurationstyp und der genaueren Identifikation ein frei wählbarer - allerdings eindeutiger - Name eingefügt. |
− | | bgcolor="#666666" | | + | | |
+ | | bgcolor="#666666" | | ||
|} | |} | ||
+ | |||
=== 5.2 Befehl CONFGET === | === 5.2 Befehl CONFGET === | ||
− | {| width=" | + | {| width="98%" cellpadding="1" align="Center" cellspacing="0" border="0" |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | colspan="3" | Das generelle Format des Befehls ist: | + | | colspan="3" | Das generelle Format des Befehls ist: |
− | | | + | | |
− | | bgcolor="#666666" | | + | | bgcolor="#666666" | |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | colspan="2" | '''CONFGET <conf-type> [<spec-1>] [<spec-2>]''' | + | | colspan="2" nowrap="NOWRAP" | '''CONFGET <conf-type> [<spec-1>] [<spec-2>]''' |
− | | | + | | |
− | | bgcolor="#666666" | | + | | bgcolor="#666666" | |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | colspan="3" | Der Wert von <conf-type> ist der Typ der Information der angefordert wird (vier Zeichen | + | | colspan="3" | Der Wert von <conf-type> ist der Typ der Information der angefordert wird (vier Zeichen Code): |
− | | | + | | |
− | | bgcolor="#666666" | | + | | bgcolor="#666666" | |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | | + | | VERS, PORT, SCMD, GCMD, || Servereigenschaften |
− | | Servereigenschaften | + | | |
− | | | + | | bgcolor="#666666" | |
− | | bgcolor="#666666" | | + | |
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | PRGL, PRGA, PRFB, | + | | PRGL, PRGA, PRFB, || unterstützte Protokolle [<spec-1>] |
− | | unterstützte Protokolle [<spec-1>] | + | | |
− | | | + | | bgcolor="#666666" | |
− | | bgcolor="#666666" | | + | |
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | DCGL, DCGA, DCFB, | + | | DCGL, DCGA, DCFB, || Dekoder, Rückmelder [<spec-1>] [<spec-2>] |
− | | | + | | |
− | | | + | | bgcolor="#666666" | |
− | | bgcolor="#666666" | | + | |
|- valign="Top" | |- valign="Top" | ||
− | | colspan="3" | [<spec-1>] und [<spec-2>] sind genauere Identifikationen von Protokollen, Dekodern und Rückmeldern: | + | | colspan="3" | [<spec-1>] und [<spec-2>] sind genauere Identifikationen von Protokollen, Dekodern und Rückmeldern: |
− | | | + | | |
− | | bgcolor="#666666" | | + | | bgcolor="#666666" | |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | Protokoll / Modultype | + | | Protokoll / Modultype || für Protokolle, (PRGL, PRGA, PRFB) |
− | | | + | | |
− | | | + | | bgcolor="#666666" | |
− | | bgcolor="#666666" | | + | |
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | Protokoll + Adresse | + | | Protokoll + Adresse || für Lokdekoder, (DCGL) |
− | | für Lokdekoder, (DCGL) | + | | |
− | | | + | | bgcolor="#666666" | |
− | | bgcolor="#666666" | | + | |
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | Protokoll + Portnummer | + | | Protokoll + Portnummer || für Schaltdekoder, (DCGA) |
− | | für Schaltdekoder, (DCGA) | + | | |
− | | | + | | bgcolor="#666666" | |
− | | bgcolor="#666666" | | + | |
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | | + | | Modultype + Portnummer || für Rückmelder. (DCFB) |
− | | für Rückmelder. (DCFB) | + | | |
− | | | + | | bgcolor="#666666" | |
− | | bgcolor="#666666" | | + | |
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | colspan="2" | Für die anderen Informationenstypen sind sie ohne Belang. | + | | colspan="2" nowrap="NOWRAP" | Für die anderen Informationenstypen sind sie ohne Belang. |
− | | | + | | |
− | | bgcolor="#666666" | | + | | bgcolor="#666666" | |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | colspan="3" | Hinweis: | + | | colspan="3" | Hinweis: |
− | | | + | | |
− | | bgcolor="#666666" | | + | | bgcolor="#666666" | |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | colspan="2" | Für [<spec-1>], [<spec-2>] kann ein '*' als Wildcard verwendet werden. Als Beispiel liefert "CONFGET DCGL NB *" alle Lokdekoder zurück, die mit dem NMRA-DCC Basic Protokoll angesprochen werden. | + | | colspan="2" | |
− | | | + | Für [<spec-1>], [<spec-2>] kann ein '*' als Wildcard verwendet werden. Als Beispiel liefert "CONFGET DCGL NB *" alle Lokdekoder zurück, die mit dem NMRA-DCC Basic Protokoll angesprochen werden. |
− | | bgcolor="#666666" | | + | | |
+ | | bgcolor="#666666" | | ||
|} | |} | ||
+ | |||
=== 5.3 Antwort auf CONFGET === | === 5.3 Antwort auf CONFGET === | ||
− | {| width=" | + | {| width="98%" cellpadding="1" align="Center" cellspacing="0" border="0" |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | colspan="3" | Das generelle Format der Antwort ist: | + | | colspan="3" | Das generelle Format der Antwort ist: |
− | | | + | | |
− | | bgcolor="#666666" | | + | | bgcolor="#666666" | |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | colspan="2" nowrap="NOWRAP" | | + | | colspan="2" nowrap="NOWRAP" | |
'''INFO CONF <conf-type> [<spec-1>] [<spec-2>] [.*] ''' | '''INFO CONF <conf-type> [<spec-1>] [<spec-2>] [.*] ''' | ||
− | + | [.*] steht dabei für alle weiteren Angaben entsprechend dem Konfigurationstyp. | |
− | | | + | | |
− | | bgcolor="#666666" | | + | | bgcolor="#666666" | |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | colspan="3" | Wird der Befehl CONFGET nicht unterstützt, lautet die Antwort: | + | | colspan="3" | Wird der Befehl CONFGET nicht unterstützt, lautet die Antwort: |
− | | | + | | |
− | | bgcolor="#666666" | | + | | bgcolor="#666666" | |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | colspan="2" | INFO -1 | + | | colspan="2" | INFO -1 |
− | | | + | | |
− | | bgcolor="#666666" | | + | | bgcolor="#666666" | |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | colspan="3" | Sind keine Daten zu <conf-type> oder [<spec-x>] vorhanden, ist die Antwort: | + | | colspan="3" | Sind keine Daten zu <conf-type> oder [<spec-x>] vorhanden, ist die Antwort: |
− | | | + | | |
− | | bgcolor="#666666" | | + | | bgcolor="#666666" | |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | colspan="2" | INFO -2 | + | | colspan="2" | INFO -2 |
− | | | + | | |
− | | bgcolor="#666666" | | + | | bgcolor="#666666" | |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | colspan="3" | Hinweis: | + | | colspan="3" | Hinweis: |
− | | | + | | |
− | | bgcolor="#666666" | | + | | bgcolor="#666666" | |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | | + | | |
− | | colspan="2" | Die Antwort auf einen Befehl CONFGET kann mehrere Zeilen "INFO CONF ..." umfassen. Ein Client muss darauf vorbereitet sein, diese sinnvoll zu verarbeiten. | + | | colspan="2" | |
− | | | + | Die Antwort auf einen Befehl CONFGET kann mehrere Zeilen "INFO CONF ..." umfassen. Ein Client muss darauf vorbereitet sein, diese sinnvoll zu verarbeiten. |
− | | bgcolor="#666666" | | + | | |
+ | | bgcolor="#666666" | | ||
|} | |} | ||
− | |||
− | {| width=" | + | == 6 Zukünftige Entwicklungen == |
+ | |||
+ | {| width="98%" cellpadding="1" align="Center" cellspacing="0" border="0" | ||
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | colspan="3" | Auf der Basis des SRCP sind ja schon viele Entwicklungen angedacht. Hier ist der Platz um ihr Informationsbedürfnis festzulegen. Denkbar sind z.B Beschreibung einer Anlage und ihrer logischen Struktur (Blöcke, Fahrstrassen, Besetztmelder, ...) oder Informationen für den Fahrplanbetrieb (Züge, Fahrstrecke, Fahrzeittrassen, ...) und vieles andere. | + | | colspan="3" | |
− | | | + | Auf der Basis des SRCP sind ja schon viele Entwicklungen angedacht. Hier ist der Platz um ihr Informationsbedürfnis festzulegen. Denkbar sind z.B Beschreibung einer Anlage und ihrer logischen Struktur (Blöcke, Fahrstrassen, Besetztmelder, ...) oder Informationen für den Fahrplanbetrieb (Züge, Fahrstrecke, Fahrzeittrassen, ...) und vieles andere. |
− | | bgcolor="#666666" | | + | | |
+ | | bgcolor="#666666" | | ||
|} | |} | ||
− | |||
− | {| width=" | + | == 7 Einige Anmerkungen == |
+ | |||
+ | {| width="98%" cellpadding="1" align="Center" cellspacing="0" border="0" | ||
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | colspan="3" | Hier will ich kurz Erklärungen zu einigen von mir vorgeschlagenen Punkten geben. | + | | colspan="3" | Hier will ich kurz Erklärungen zu einigen von mir vorgeschlagenen Punkten geben. |
− | | | + | | |
− | | bgcolor="#666666" | | + | | bgcolor="#666666" | |
|} | |} | ||
+ | |||
=== 7.1 Hintergrund === | === 7.1 Hintergrund === | ||
− | {| width=" | + | {| width="98%" cellpadding="1" align="Center" cellspacing="0" border="0" |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | colspan="3" | | + | | colspan="3" | |
In der Diskussion um das SRCP wurde mehrfach der Wunsch nach einer zentralen Konfigurationsbasis geäussert. Dies ist für eine einzige Serverimplementierung sicher nicht zwingend. Werden jedoch unterschiedliche Serverimplementierung angeboten, so ist es für alle weiteren Programme (Clients, Middleware, ...) sinnvoll, die Eigenschaften eines Servers ermitteln zu können. | In der Diskussion um das SRCP wurde mehrfach der Wunsch nach einer zentralen Konfigurationsbasis geäussert. Dies ist für eine einzige Serverimplementierung sicher nicht zwingend. Werden jedoch unterschiedliche Serverimplementierung angeboten, so ist es für alle weiteren Programme (Clients, Middleware, ...) sinnvoll, die Eigenschaften eines Servers ermitteln zu können. | ||
Weiter wurde angeregt eine gemeinsame Datenbasis für alle Clients bezüglich Lokdekoder, Schaltdekoder und Rückmelder zu haben. | Weiter wurde angeregt eine gemeinsame Datenbasis für alle Clients bezüglich Lokdekoder, Schaltdekoder und Rückmelder zu haben. | ||
− | + | Beiden Wünschen soll mit dieser Definition Rechnung getragen werden. | |
− | | | + | | |
− | | bgcolor="#666666" | | + | | bgcolor="#666666" | |
|} | |} | ||
+ | |||
=== 7.2 Aufteilung === | === 7.2 Aufteilung === | ||
− | {| width=" | + | {| width="98%" cellpadding="1" align="Center" cellspacing="0" border="0" |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | colspan="3" | | + | | colspan="3" | |
− | Bisher ist nichts zur Aufteilung der Konfigurationsdaten auf Dateien gesagt worden. Dieser Punkt ist bewusst offengelassen, da ich dafür keinen Vorschlag machen will. Sinnvoll ist sicherlich eine Aufteilung in eine Datei für die Servereigenschaften (siehe [ | + | Bisher ist nichts zur Aufteilung der Konfigurationsdaten auf Dateien gesagt worden. Dieser Punkt ist bewusst offengelassen, da ich dafür keinen Vorschlag machen will. Sinnvoll ist sicherlich eine Aufteilung in eine Datei für die Servereigenschaften (siehe [[#2 Servereigenschaften | Kapitel 2]]) und eine Datei für die Dekoder und Rückmelder (siehe [[#3 Geräte und ihre Eigenschaften | Kapitel 3]]). Sollte eines Tages Informationen über das Layout definiert werden, so ist dafür sicher eine weitere Datei sinnvoll. |
− | + | Ob eine weitere Aufteilung wünschenswert ist soll die Diskussion zeigen. | |
− | | | + | | |
− | | bgcolor="#666666" | | + | | bgcolor="#666666" | |
|} | |} | ||
+ | |||
=== 7.3 Namen und Typen === | === 7.3 Namen und Typen === | ||
− | {| width=" | + | {| width="98%" cellpadding="1" align="Center" cellspacing="0" border="0" |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | colspan="3" | | + | | colspan="3" | |
− | Für die Definition der Dekoder und Rückmelder sind Namen eingeführt worden. Dies ist ein Konzept, dass im SRCP bisher nicht existiert und dort auch nicht notwendig ist. Es dient dazu, dass alle Clients Dekoder und Rückmelder mit gleichen Namen darstellen können. <br /> Namen wie "V188-003" oder "Abzweig-Valkenburg" sind für einen Mensch als Benutzer der Clients sicherlich einfacher zuzuordnen als M3-17 oder N-327. | + | Für die Definition der Dekoder und Rückmelder sind Namen eingeführt worden. Dies ist ein Konzept, dass im SRCP bisher nicht existiert und dort auch nicht notwendig ist. Es dient dazu, dass alle Clients Dekoder und Rückmelder mit gleichen Namen darstellen können. <br /> |
+ | Namen wie "V188-003" oder "Abzweig-Valkenburg" sind für einen Mensch als Benutzer der Clients sicherlich einfacher zuzuordnen als M3-17 oder N-327. | ||
− | + | Ebenso sind Typen zur Klassifizierung verschiedener Dekoder- / Rückmeldertypen eingeführt worden. Auch diese sind in SRCP weder definiert noch notwendig. Sie dienen hauptsächlich der Dokumentation. Inwieweit ein Client diese Information verwendet bleibt ihm überlassen. | |
− | | | + | | |
− | | bgcolor="#666666" | | + | | bgcolor="#666666" | |
|} | |} | ||
+ | |||
=== 7.4 Englische Begriffe === | === 7.4 Englische Begriffe === | ||
− | {| width=" | + | {| width="98%" cellpadding="1" align="Center" cellspacing="0" border="0" |
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | colspan="3" | Genauso wie im SRCP werden in der formalen Definition englische Begriffe bzw. Abkürzungen davon verwendet. Dies wurde in SRCP in Hinblick auf eine mögliche internationale Verbreitung so beschlossen. Ich schliesse mich diesem Vorgehen an. | + | | colspan="3" | |
− | | | + | Genauso wie im SRCP werden in der formalen Definition englische Begriffe bzw. Abkürzungen davon verwendet. Dies wurde in SRCP in Hinblick auf eine mögliche internationale Verbreitung so beschlossen. Ich schliesse mich diesem Vorgehen an. |
− | | bgcolor="#666666" | | + | | |
+ | | bgcolor="#666666" | | ||
|} | |} | ||
− | |||
− | {| width=" | + | == 8 Änderungsprotokoll == |
+ | |||
+ | {| width="98%" cellpadding="1" align="Center" cellspacing="0" border="0" | ||
+ | |||
|- valign="Top" | |- valign="Top" | ||
− | | colspan="3" | Hier wird in späteren Versionen eine Übersicht über die wichtigsten Änderungen von Version zu Version stehen. | + | | colspan="3" | |
− | | | + | Hier wird in späteren Versionen eine Übersicht über die wichtigsten Änderungen von Version zu Version stehen. |
− | | bgcolor="#00FF00" | | + | | |
+ | | bgcolor="#00FF00" | | ||
|} | |} | ||
[[Kategorie:SRCP]] | [[Kategorie:SRCP]] |
Aktuelle Version vom 21. Februar 2006, 14:38 Uhr
Erster Entwurf zur Diskussion
von Edbert van Eimeren
Inhaltsverzeichnis
1 Einleitung
Die CRCF beschreiben einen Reihe von Dateien zur Konfiguration von Serverprozessen zur Steuerung von digitalen Modelleisenbahnen. Clientprozesse können auf diese Informationen über einen entsprechenden Auskunftsbefehl zugreifen. Die in CRCF zu speichernden Informationen ergeben sich aus dem Bedarf des SRCP (Simple Railroad Command Protocol) wie von Torsten Vogt & anderen definiert. In diesem Sinne sind die CRCF eine Ergänzung zum SRCP. Ziel ist es eine klare, auch vom Menschen lesbare Basis für die Fähigkeiten einer konkreten Serverimplementierung einerseits und eine Beschreibung der verwendeten Dekoder mit ihren spezifischen Eigenschaften andererseits zu schaffen. Diese Fassung basiert auf SRCP Version 0.7.0. |
1.1 Konventionen
Alle Informationen werden einzeilig mit variabler Länge gespeichert. Eine Zeile wird mit dem Zeichen '\n' (line feed, LF, #10) abgeschlossen. Ein vorangestelltes '\r' (carriage return, CR, #13) wird akzeptiert. Jede Informationszeile besteht aus Worten, die durch Whitespace (Leerzeichen, Tabulatoren) getrennt sind. Die Worte der Informationszeilen können aus der Menge der Zeichen { '0', .., '9', '-', 'A', .., 'Z', 'a', .., 'z' } gebildet werden. Der Server wertet die Informationszeilen case-sensitive aus, d.h. zwischen Groß- und Kleinbuchstaben wird unterschieden. Kommentarzeilen beginnen mit dem Zeichen '#' und enden mit dem Zeilenende. Sie werden ebenso ignoriert wie Leerzeilen (nur White Spaces und CR, LF). Sie dürfen alle druckbaren Zeichen des ASCII Zeichensatzes enthalten. Sie dienen ausschliesslich der besseren Lesbarkeit durch einen Menschen. Einzelne Bereiche werden durch Überschriften getrennt. Diese beginnen (Zeilenanfang) mit '= ' und enden mit ' ='. Weiterer Text in der Überschriftzeile ist Kommentar und wird ignoriert. Alle Informationszeilen beginnen mit einer Kennung aus vier Buchstaben, die die Art der Information kennzeichnet. Die weiteren Angaben sind je nach Art der Information unterschiedlich. Informationen über Protokolle enthalten eine weitere Angabe zur genauen Identifizierung (Protokoll/Modultype). Informationen über Dekoder und Rückmelder enthalten zwei weitere Angaben zur genauen Identifizierung (Protokoll/Modultype + Adresse/Portnummer). Für jede vom Server unterstützte Funktion / Eigenschaft gibt es eine Informationszeile. Für jeden dem Server bekannten Dekoder / Rückmelder gibt es eine Informationszeile. Informationszeilen, die unvollständig oder offensichtlich falsch sind werden vom Server ignoriert. Eine (summarische) Fehlermeldung sollte in diesem Fall vom Server beim Start ausgegeben werden. In Protokoll- oder Trace-Dateien kann ggfs. jeder Fehler einzeln aufgeführt werden. Die Informationen sind in Bereiche aufgeteilt. Jeder Bereich hat eine Überschrift. Alle Informationen aus einem Bereich müssen hinter dieser Überschrift stehen. Stehen sie an einer anderen Stelle, so werden sie als Fehler gewertet. Innerhalb eines Bereichs ist eine angemessene Ordnung sinnvoll (Name | Protokoll | Adresse | ...). Diese Ordnung ist für die bessere Lesbarkeit und daher nicht zwingend vorgeschrieben. Es steht im Ermessen des Erstellers, welche Ordnung, wenn überhaupt, er/sie benutzt. An einigen Stellen sind Werte reserviert, die im SRCP noch nicht festgelegt sind, da es zur Zeit noch keine Server gibt, die das unterstützen. Diese Werte sind als Platzhalter zu betrachten, sie können sich noch ändern. Solche reservierten Werte sind mit kursiver Schrift markiert. |
||||
Änderungen gegenüber der vorherigen Version werden mit einem farbigen Strich am rechten Rand markiert. Dabei bedeutet rot Neues oder wesentliche (inhaltliche) Änderungen, grün kleinere (textliche) Änderungen, und blau Weglassungen. Unveränderte Abschnitte haben eine graue Markierung. Korrekturen von Tipfehlern werden nicht markiert. |
2 Servereigenschaften
Hier werden die Eigenschaften beschrieben, die eine Serverimplementierung ausmachen, das heißt, welche Möglichkeiten ein Server seinen Clients zur Verfügung stellt. |
2.1 Serverversion
Überschrift: '= Version ='
Es gibt genau eine Zeile mit der Information über die Version des Servers und des verwendeten SRCP. |
||||
VERS <name> <vers> SRCP <srcp> | ||||
<name> | Name des Servers | |||
<vers> | Version des Servers | |||
<srcp> | Version des verwendeten SRCP | |||
Hinweis: | Die Versionsinformation sollte als erstes in einer Konfigurationsdatei stehen. |
2.2 Übertragungskanäle
Welche Kanäle werden von einer Serverimplementierung zur Kommunikation mit Clients benutzt. Dies ist durch das SRCP weitgehend festgelegt. Überschrift: '= Ports =' Für jeden Kanal gibt es eine Zeile des Formats: |
||||
PORT <port> <direction> | ||||
Werte für <port> sind: | ||||
COMMAND | Kommando Port Befehle des Clients an den Server, direkte Antworten des Servers darauf. |
|||
FEEDBACK | Rückmelde Port Statusänderungen von Rückmelde Modulen. |
|||
INFO | Info Port (Broadcast Kanal) Statusänderungen von Lok- und Schaltdekodern, Modellzeit. |
|||
Werte für <direction> sind: | ||||
CLIENT | Unidirektional vom Client zum Server | |||
SERVER | Unidirektional vom Server zum Client | |||
BOTH | Bidirektional |
2.3 Serverbefehle
Welche Befehle werden von einer Server zu seiner Steuerung akzeptiert. Dies ist durch das SRCP weitgehend festgelegt. Überschrift: '= Server Commands =' Für jeden Befehl gibt es eine Zeile des Formats: |
||||
SCMD <command> | ||||
Werte für <command> sind: | ||||
LOGOUT | Befehl zum Beenden der Verbindung zu einem Client. | |||
RESET | Befehl zur Neu-Initialisieung des Servers. | |||
SHUTDOWN | Befehl zum Beenden des Servers. | |||
VOLTAGE |
Ein-/Ausschalten des Digitalstroms über STARTVOLTAGE/STOPVOLTAGE |
|||
POWER |
Ein-/Ausschalten des Digitalstroms über SET POWER [ON/OFF] |
2.4 Allgemeine Befehle
Welche Befehle werden von einer Server zu seiner Steuerung akzeptiert. Dies ist durch das SRCP weitgehend festgelegt. Überschrift: '= General Commands =' Für jeden Befehl gibt es eine Zeile des Formats: |
||||
GCMD <command> | ||||
Werte für <command> sind: | ||||
SET | Befehl zum Setzen eines Wertes. | |||
GET | Befehl zum Ermitteln eines Wertes. | |||
WAIT | Befehl zum Warten bis ein bestimmter Zustand erreicht wird. | |||
INIT | Befehl zum Initialisieren von Geräte(gruppen). | |||
TERM | Befehl zum Aufheben von mit INIT getroffenen Einstellungen. | |||
WRITE | Befehl zum Programmieren eines Wertes eines Dekoders. | |||
READ | Befehl zum Lesen eines Wertes eines Dekoders. | |||
VERIFY | Befehl zum Überprüfen eines Wertes eines Dekoders. | |||
CONFGET | Befehl zum Ermitteln von Konfigurationsinformationen. | |||
Ein Befehl, der nicht eingetragen ist, wird nicht unterstützt. Lediglich der Befehl SET ist zwingend vorgeschrieben, alle anderen können implementiert werden. |
2.5 Protokolle Lokdekoder
Welche Protokolle für Lokdekoder werden von einem Server akzeptiert. Funktionsdekoder werden wie Lokdekoder behandelt. Überschrift: '= Protocols Loco & Function =' Für jedes unterstützte Protokoll gibt es eine Zeile des Formats: |
||||
PRGL <prot> <addrmax> <speedmax> <dir> <n-func> | ||||
Werte für <prot> sind: | ||||
M. | Protokolle nach den Märklin/Motorola Standards. | |||
N. | Protokolle nach den NMRA-DCC Standards. | |||
S. | Protokolle nach den Trix Selectrix Standards. | |||
F. | Protokolle nach den Fleischmann FMZ Standards. | |||
Z. | Protokolle nach den ZIMO Standards. | |||
Der Punkt ist durch geeignete Buchstaben/Ziffern zu ersetzen. Siehe dazu die aktuelle Spezifikation des SRCP. PS (= Protocol by Server) ist hier nicht aufgeführt, da es kein reales Protokoll ist, sondern eine Anweisung an den Server, selbständig ein geeignetes Protokoll zu wählen. |
||||
Wert für <addrmax>: | ||||
Der Wert für <addrmax> gibt die höchste Adresse an, die von diesem Protokoll unterstützt wird. Aktuelle Werte für den Adressbereich sind 80, 99, 256, 9999. Ein Adressbereich beginnt immer bei der Adresse 0. |
||||
Wert für <speedmax>: | ||||
Der Wert für <speedmax> gibt die höchste Fahrstufen an, die von diesem Protokoll unterstützt wird. Aktuelle Werte für die höchste Fahrstufe sind 14, 27, 28, 128. Ein Fahrstufenbereich beginnt immer bei der Fahrstufe 0. |
||||
Werte für <dir> sind: | ||||
abs | Absolute Fahrtrichtungsangabe. | |||
rel | Relative Fahrtrichtungsangabe. | |||
Wert für <n-func>: | ||||
Der Wert für <n-func> gibt an wieviele Zusatzfunktionen von diesem Protokoll unterstützt werden. Aktuelle Dekoder untertützen 0, 2, 4, 8 Zusatzfunktionen. Es wird implizit davon ausgegeangen, dass eine Standardfunktion immer implementiert ist. |
2.6 Protokolle Schaltdekoder
Welche Protokolle für Schaltdekoder werden von einem Server akzeptiert. Überschrift: '= Protocols Accessory =' Für jedes unterstützte Protokoll gibt es eine Zeile des Formats: |
||||
PRGA <prot> <addrmax> | ||||
Werte für <prot> sind: | ||||
N | Protokoll nach den Märklin/Motorola Standards. | |||
M | Protokoll nach den NMRA-DCC Standards. | |||
S | Protokoll nach den Trix Selectrix Standards. | |||
F | Protokoll nach den Fleischmann FMZ Standards. | |||
Z | Protokoll nach den ZIMO Standards. | |||
Wert für <addrmax>: | ||||
Der Wert für <addrmax> gibt die höchste Adresse an, die von diesem Protokoll unterstützt wird. Aktuelle Werte für den Adressbereich sind ???, 4096. Ein Adressbereich beginnt bei der Adresse 1. |
2.7 Protokolle Rückmelde Module
Welche Rückmelde Module und Anschlussarten werden von einem Server akzeptiert. Überschrift: '= Feedback Types =' Für jeden unterstützten Modultyp gibt es eine Zeile des Formats: |
||||
PRFB <module-type> <port-max> <port-inc> | ||||
Werte für <module-type> sind: | ||||
S88 | Märklin s88-Bus am Parallelport des PC. | |||
I8255 | i8255 Karte. | |||
M6051 | Märklin s88-Bus via Interface 6051. | |||
LENZFB | Rückmelde-Module aus dem Lenz System. | |||
DTFB | Rückmelde-Module aus dem Digitrax System (LocoNet). | |||
SELFB | Rückmelde-Module aus dem Trix Selectrix System. | |||
FMZFB | Rückmelde-Module aus dem Fleischmann FMZ System. | |||
ZIMOFB | Rückmelde-Module aus dem ZIMO System. | |||
Hinweis: | Die letzten fünf sind reservierte Namen, die sich ggfs. noch ändern können. | |||
Wert von <port-max> | ||||
Der Wert von <port-max> gibt die höchste Adresse an, die für diesen Modultype zulässig ist. Ein Nummerbereich beginnt mit (0 | 1) ???. |
||||
Wert von <port-inc> | ||||
Der Wert von <port-inc> gibt an wieviele Ports in einem Modul dieses Typs zusammengefasst sind. |
2.8 Sonstige Gerätetypen
Dies kann erst dann spezifiziert werden, wenn entsprechende Definitionen in SRCP vorliegen. |
3 Geräte und ihre Eigenschaften
Hier werden die Eigenschaften beschrieben, die ein tatsächliches Gerät (Lok-, Schaltdekoder, Rückmeldemodul) hat. Das heißt, welche Funktionen von einem Dekoder oder Modul tatsächlich realisiert werden. Dies kann ggfs. weniger sein, als das Protokoll erlaubt. |
3.1 Lok- und Funktionsdekoder
Überschrift: '= Locomotive & Function ='
Für jeden definierten Lok- und Funktionsdekoder gibt es eine Zeile des Formats: |
||||
DCGL <name> <prot> <addr> <speed> <dir> <n-func> <prog> [<type>] | ||||
Wert von <name> | ||||
Der Wert von <name> ist ein eindeutiger Name für diesen Lok-/Funktions- Dekoder (z.B. die Loknummer). Der Name muss ein Wort sein. Das heisst er darf kein Leerzeichen oder Tabultorzeichen enthalten. Zur optischen Gliederung ist ggfs. das Zeichen '-' einzusetzen . Beispiele: "V188-003", "Berghexe", "Zuckersusi". |
||||
Werte für <prot>: | ||||
Die Werte für <prot> sind wie in #2.5 Protokolle Lokdekoder definiert. |
||||
Wert von <addr>: | ||||
Der Wert von <addr> gibt die Adresse dieses Dekoders unter dem gewählten Protokoll an. Multiprotokolldekoder können demgemäss mehrere Einträge haben. |
||||
Wert für <speed>: | ||||
Der Wert von <speed> gibt die höchste Fahrstufen an, die von diesem Dekoder unterstützt wird. Für Funktionsdekoder ist dieser Wert ggfs. auf 0 zu setzen. |
||||
Werte für <dir> sind: | ||||
abs | Absolute Fahrtrichtungsangabe. | |||
rel | Relative Fahrtrichtungsangabe. | |||
Wert von <n-func>: | ||||
Der Wert für <n-func> gibt an wieviele Zusatzfunktionen von diesem Dekoder unterstützt werden. Es wird implizit davon ausgegeangen, dass eine Standardfunktion immer implementiert ist. |
||||
Der Wert von <prog> ist ein Wort mit 7 Buchstaben: | ||||
1) | Modus (P = Programmiergleis, F = on the Fly [im Betrieb]) | |||
2) | WRITE- Befehl (W = unterstützt) | |||
3) | READ- Befehl (R = unterstützt) | |||
4) | VERIFY-Befehl (V = unterstützt) | |||
5) | REGISTER (R = unterstützt) | |||
6) | VARIABLE (V = unterstützt) | |||
7) | BIT (B = unterstützt) | |||
Wird eine Funktion nicht unterstützt, so ist statt dessen das Zeichen N (= none) zu setzen. |
||||
Wert von <type>: | ||||
Der Wert von <type> ist eine Kennung für den Dekodertype. Dekoder des gleichen Typs erhalten den gleichen Wert für <type>. Der Wert von <type> muss ein Wort sein. Das heisst er darf kein Leerzeichen oder Tabultorzeichen enthalten. Zur optischen Gliederung ist ggfs. das Zeichen '-' einzusetzen. Sinnvollerweise hält man sich an die Bezeichnung des Hersteller. Die Angabe dient zur Zeit nur der Dokumentation und ist daher optional. |
3.2 Schaltdekoder
Überschrift: '= Accessory ='
Für jeden definierten Schaltdekoder gibt es eine Zeile des Formats: |
||||
DCGA <name> <prot> <addrmin> <addrmax> [<type>] | ||||
Wert von <name>: | ||||
Der Wert von <name> ist ein eindeutiger Name für diesen Lok-/Funktions- Dekoder (z.B. die Loknummer). Der Name muss ein Wort sein. Das heisst er darf kein Leerzeichen oder Tabultorzeichen enthalten. Zur optischen Gliederung ist ggfs. das Zeichen '-' einzusetzen . Beispiele: "V188-003", "Berghexe", "Zuckersusi". |
||||
Werte für <prot> sind: | ||||
Die Werte für <prot> sind wie in #2.6 Protokolle Schaltdekoder angegeben. |
||||
Wert von <addrmin>: | ||||
Der Wert von <addrmin> gibt die die Adresse des ersten verwendeten Ausgang dieses Dekoders an. | ||||
Wert von <addrmax>: | ||||
Der Wert von <addrmax> gibt die die Adresse des letzten verwendeten Ausgang dieses Dekoders an. | ||||
Wert von <type>: | ||||
Der Wert von <type> ist eine Kennung für den Dekodertype. Dekoder des gleichen Typs erhalten den gleichen Wert für <type>. Der Wert von <type> muss ein Wort sein. Das heisst er darf kein Leerzeichen oder Tabultorzeichen enthalten. Zur optischen Gliederung ist ggfs. das Zeichen '-' einzusetzen. Sinnvollerweise hält man sich an die Bezeichnung des Hersteller. Die Angabe dient zur Zeit nur der Dokumentation und ist daher optional. |
||||
Hinweis: | ||||
Für einen Einzeldekoder gilt <addrmin> = <addrmax> Auf diese Art kann je nach Wunsch eine Gruppendefiniton oder eine Einzeldefinition der Schaltdekoderausgänge erfolgen. |
3.3 Rückmelde Module
Überschrift: '= Feedback Units ='
Für jede definierte Rückmelde Modul gibt es eine Zeile des Formats: |
||||
DCGA <name> <modul-type> <port-min> <port-max> [<type>] | ||||
Wert von <name>: | ||||
Der Wert von <name> ist ein eindeutiger Name für dieses Rückmelde Modul. Der Name muss ein Wort sein. Das heisst er darf kein Leerzeichen oder Tabultorzeichen enthalten. Zur optischen Gliederung ist ggfs. das Zeichen '-' einzusetzen. Beispiele: "V188-003", "Berghexe", "Zuckersusi". |
||||
Werte für <modul-type>: | ||||
Der Wert von <modul-type> gibt Art des verwendeten Modules an. Es gelten die Werte, die in #2.7 Protokolle Rückmelde Module dafür definiert sind. |
||||
Wert von <port-min>: | ||||
Der Wert von <port-min> gibt die Portnummer des ersten verwendeten Eingang dieses Modules an. | ||||
Wert von <port-max>: | ||||
Der Wert von <port-max> gibt die Portnummer des letzten verwendeten Eingang dieses Modules an. | ||||
Wert von <type>: | ||||
Der Wert von <type> ist eine Kennung für den konkreten Typ eines Rückmelde Modules. Hier dient er hauptsächlich zur Unterscheidung verschiedener Lieferanten eines Modultypes. Rückmelder des gleichen Typs erhalten den gleichen Wert für <type>. Der Wert von <type> muss ein Wort sein. Das heisst er darf kein Leerzeichen oder Tabultorzeichen enthalten. Zur optischen Gliederung ist ggfs. das Zeichen '-' einzusetzen. Sinnvollerweise hält man sich an die Bezeichnung des Hersteller. Die Angabe dient zur Zeit nur der Dokumentation und ist daher optional. |
||||
Hinweis: | ||||
Mit <port-min> = <port-max> kann man falls gewünscht auch jeden Port einzeln definieren. |
4 Sonstiges
Dies ist erst einmal ein Platzhalter für zukünftige Erweiterungen oder Festlegungen, die übergreifend sind. Beispielsweise könnte ich mir hier eine Liste von Rückgabewerten vorstellen, wenn das INFO Statement als Antwort auf einen GET Befehl keine Daten zur Verfügung stellen kann. Beispiel: INFO <value> <lang> <Text> Dabei ist <value> der Rückgabewert (eine Zahl, in der Regel negativ), <lang> eine Sprache (z.B. de := deutsch, en := englisch). Alle weiteren Worte in dieser Zeile sind dann der Meldungstext. Das Paar <value>, <lang> muss eindeutig sein. Werden mehrere Sprachen angeboten, so sind für jede Sprache alle möglichen Werte von <value> mit Text zu versehen. |
5 Abfrage der Konfiguration
Der Befehl CONFGET dient dazu, Clients die Möglichkeit zu geben beim Server nachzufragen, welche Fähigkeiten er hat (siehe #2 Servereigenschaften). Diese Angaben sind verbindlich. Als zweites kann mit diesem Befehl abgefragt werden, welche Lok-, Funktions-, Schalt-Dekoder und Rückmelde Module dem Server bekannt sind (siehe #3 Geräte und ihre Eigenschaften). Diese Information dient (mehreren) Clients dazu einen gleichen Informationsstand zu haben. Diese Informationen sind jedoch nicht verbindlich.
Informationen zu Schaltdekodern und Rückmeldern als ortsfeste Bauteile hingegen sollten (in der Regel) korrekt und vollständig sein. Anmerkung: |
||||
Die Spezifikation des Befehl CONFGET gehört eigentlich in das SRCP |
5.1 Konfigurationstypen
Zur Zeit sind 10 verschiedene Konfigurationstypen definiert. | ||||
VERS | <name> <vers> SRCP <srcp> | |||
PORT | <port> <direction> | |||
SCMD | <command> | |||
GCMD | <command> | |||
PRGL | <prot> <addrmax> <speedmax> <dir> <n-func> | |||
PRGA | <prot> <addrmax> | |||
PRFB | <module-type> <port-max> <port-inc> | |||
DCGL | <name> <prot> <addr> <spmax> <dir> <n-func> <prog> [<type>] | |||
DCGA | <name> <prot> <addrmin> <addrmax> [<type>] | |||
DCFB | <name> <module-type> <port-min> <port-max> [<type>] | |||
Dabei haben die ersten vier keine weitere Identifikation, die nächsten drei Protokoll/Modultype als genauere Identifikation. Die letzten drei haben Protokoll/Modultype + Adresse/Portnummer als genauere Identifikation. Bei diesen ist jedoch als Besonderheit zwischen dem Konfigurationstyp und der genaueren Identifikation ein frei wählbarer - allerdings eindeutiger - Name eingefügt. |
5.2 Befehl CONFGET
Das generelle Format des Befehls ist: | ||||
CONFGET <conf-type> [<spec-1>] [<spec-2>] | ||||
Der Wert von <conf-type> ist der Typ der Information der angefordert wird (vier Zeichen Code): | ||||
VERS, PORT, SCMD, GCMD, | Servereigenschaften | |||
PRGL, PRGA, PRFB, | unterstützte Protokolle [<spec-1>] | |||
DCGL, DCGA, DCFB, | Dekoder, Rückmelder [<spec-1>] [<spec-2>] | |||
[<spec-1>] und [<spec-2>] sind genauere Identifikationen von Protokollen, Dekodern und Rückmeldern: | ||||
Protokoll / Modultype | für Protokolle, (PRGL, PRGA, PRFB) | |||
Protokoll + Adresse | für Lokdekoder, (DCGL) | |||
Protokoll + Portnummer | für Schaltdekoder, (DCGA) | |||
Modultype + Portnummer | für Rückmelder. (DCFB) | |||
Für die anderen Informationenstypen sind sie ohne Belang. | ||||
Hinweis: | ||||
Für [<spec-1>], [<spec-2>] kann ein '*' als Wildcard verwendet werden. Als Beispiel liefert "CONFGET DCGL NB *" alle Lokdekoder zurück, die mit dem NMRA-DCC Basic Protokoll angesprochen werden. |
5.3 Antwort auf CONFGET
Das generelle Format der Antwort ist: | ||||
INFO CONF <conf-type> [<spec-1>] [<spec-2>] [.*] [.*] steht dabei für alle weiteren Angaben entsprechend dem Konfigurationstyp. |
||||
Wird der Befehl CONFGET nicht unterstützt, lautet die Antwort: | ||||
INFO -1 | ||||
Sind keine Daten zu <conf-type> oder [<spec-x>] vorhanden, ist die Antwort: | ||||
INFO -2 | ||||
Hinweis: | ||||
Die Antwort auf einen Befehl CONFGET kann mehrere Zeilen "INFO CONF ..." umfassen. Ein Client muss darauf vorbereitet sein, diese sinnvoll zu verarbeiten. |
6 Zukünftige Entwicklungen
Auf der Basis des SRCP sind ja schon viele Entwicklungen angedacht. Hier ist der Platz um ihr Informationsbedürfnis festzulegen. Denkbar sind z.B Beschreibung einer Anlage und ihrer logischen Struktur (Blöcke, Fahrstrassen, Besetztmelder, ...) oder Informationen für den Fahrplanbetrieb (Züge, Fahrstrecke, Fahrzeittrassen, ...) und vieles andere. |
7 Einige Anmerkungen
Hier will ich kurz Erklärungen zu einigen von mir vorgeschlagenen Punkten geben. |
7.1 Hintergrund
In der Diskussion um das SRCP wurde mehrfach der Wunsch nach einer zentralen Konfigurationsbasis geäussert. Dies ist für eine einzige Serverimplementierung sicher nicht zwingend. Werden jedoch unterschiedliche Serverimplementierung angeboten, so ist es für alle weiteren Programme (Clients, Middleware, ...) sinnvoll, die Eigenschaften eines Servers ermitteln zu können. Weiter wurde angeregt eine gemeinsame Datenbasis für alle Clients bezüglich Lokdekoder, Schaltdekoder und Rückmelder zu haben. Beiden Wünschen soll mit dieser Definition Rechnung getragen werden. |
7.2 Aufteilung
Bisher ist nichts zur Aufteilung der Konfigurationsdaten auf Dateien gesagt worden. Dieser Punkt ist bewusst offengelassen, da ich dafür keinen Vorschlag machen will. Sinnvoll ist sicherlich eine Aufteilung in eine Datei für die Servereigenschaften (siehe Kapitel 2) und eine Datei für die Dekoder und Rückmelder (siehe Kapitel 3). Sollte eines Tages Informationen über das Layout definiert werden, so ist dafür sicher eine weitere Datei sinnvoll. Ob eine weitere Aufteilung wünschenswert ist soll die Diskussion zeigen. |
7.3 Namen und Typen
Für die Definition der Dekoder und Rückmelder sind Namen eingeführt worden. Dies ist ein Konzept, dass im SRCP bisher nicht existiert und dort auch nicht notwendig ist. Es dient dazu, dass alle Clients Dekoder und Rückmelder mit gleichen Namen darstellen können. Ebenso sind Typen zur Klassifizierung verschiedener Dekoder- / Rückmeldertypen eingeführt worden. Auch diese sind in SRCP weder definiert noch notwendig. Sie dienen hauptsächlich der Dokumentation. Inwieweit ein Client diese Information verwendet bleibt ihm überlassen. |
7.4 Englische Begriffe
Genauso wie im SRCP werden in der formalen Definition englische Begriffe bzw. Abkürzungen davon verwendet. Dies wurde in SRCP in Hinblick auf eine mögliche internationale Verbreitung so beschlossen. Ich schliesse mich diesem Vorgehen an. |
8 Änderungsprotokoll
Hier wird in späteren Versionen eine Übersicht über die wichtigsten Änderungen von Version zu Version stehen. |