Version vom 28. September 2007, 08:55 Uhr

Allgemeines

Bei SRCP (Simple Railroad Command Protocol) handelt es sich um eine Sprachdefinition, mit der Computerprogramme zur Modellbahnsteuerung in einem Client-Server-System Informationen untereinander austauschen können. Das Protokoll selbst ist in der Anwendung vergleichbar mit anderen Internetprotokollen wie SMTP, HTTP, FTP etc., widmet sich aber speziell den Anforderungen der Steuerung einer digitalen Modellbahn. Eine Auflistung der bislang verfügbaren SRCP-Programme befindet sich im Artikel Digitalprojekt.

Spezifikation

Die aktuell gültige SRCP-Spezifikation trägt die Versionsnummer 0.8.3 (HTML, PDF).

Die nächste Version ist unter der Nummer 0.8.4 derzeit in Bearbeitung.

Beim Übergang von Version 0.7.3 auf 0.8 gab es größere Änderungen im Protokoll, bei der eine Abwärtskompatibilität aufgegeben werden mußte. Programme, die nur eine der beiden Protokollversionen implementieren, können sich daher nicht miteinander verständigen. Bereits vorhandene Software für SRCP 0.7.x wird daher im Laufe der Zeit auf SRCP 0.8.x umgestellt.

Historische Spezifikationsversionen

• SRCP - Simple Railroad Command Protocol 0.5.0
• SRCP - Simple Railroad Command Protocol 0.6.0
• SRCP - Simple Railroad Command Protocol 0.6.1
• SRCP - Simple Railroad Command Protocol 0.7.0
• SRCP - Simple Railroad Command Protocol 0.7.2
• SRCP - Simple Railroad Command Protocol 0.7.3
• SRCP - Simple Railroad Command Protocol 0.8.0
• SRCP - Simple Railroad Command Protocol 0.8.2

Designprinzipien

SRCP benutzt zeilenorientierten Klartext. Der Text besteht aus Kommandos und Informationen. Kommandos werden vom Client an den Server übermittelt, Informationen vom Server an den Client. Jedes Kommando und jede Information besteht aus exakt einer Zeile. Es ist eine maximale Zeilenlänge definiert, um auch Programmieranfängern einfache Fehler wie Pufferüberläufe (Buffer Overflows) vermeiden zu helfen.

Der Server stellt seine Dienste im Netzwerk bereit. Zur Verbindungsaufnahme sind sein Hostname (ersatzweise die IP-Adresse) und der Netzwerkport (z.B. 4303) bei jedem Client anzugeben. Der Client kann diese Angaben über andere Dienste anfordern (Bonjour, Zeroconf, Active Directory).

Einrichtung einer Kommandositzung zwischen SRCP-Client und -Server nach Protokollversion 0.8. [], ---: optional, 1-8: Handshake-Phase, 9: Kommandoaustausch

Nach Verbindungsaufnahme wird vom Server eine zunächst anonyme Sitzung (Session) gestartet. Diese wird »Handshake« genannt. In ihr kann der Client verschiedene Betriebsparameter einstellen. Derzeit sind zwei unterschiedliche Betriebsmodi definiert:

• COMMAND und
• INFO

Weitere Parameter betreffen z.B. die SRCP-Version, die benutzt werden soll. Da diese Wahlmöglichkeit für unterschiedliche Protokollversionen erst mit Version 0.8 eingeführt wurde, bieten frühere, aber noch immer benutzte Versionen (0.7), diese Möglichkeit nicht.

Mit dem Befehl GO wird die Handshake-Phase beendet und die noch anonyme Sitzung erhält eine Identifikationsnummer (Session-ID). Gleichzeitig wird die Verbindung auf den gewählten Betriebsmodus eingestellt. Die Session-ID ist ein numerischer Wert, der die Sitzung identifiziert.

Im Betriebsmodus INFO wird ausschließlich vom Server zum Client kommuniziert. Es werden alle im Protokoll als INFO gekennzeichneten Angaben (Code 100 bis 199) übertragen. Alle Angaben markieren Veränderungen. Der Client beendet die INFO-Sitzung, indem er die Verbindung kappt; es besteht für diesen Modus keine Möglichkeit zur Kommandoübermittlung an den Server.

Im Betriebsmodus COMMAND wartet der Server auf Kommandos vom Client. Sobald ein Kommando eintrifft, wird es bearbeitet, eine Antwort generiert und diese an den Client gesendet. Die Antworten sind Bestätigungen dafür, dass das Kommando angenommen wurde, Fehlermeldungen oder Abfrageergebnisse.

Kommandos bestehen aus einem Kommandowort, einer Adressangabe und weiteren Parametern. Kommandoworte bestehen aus Verben, die eine Tätigkeit beschreiben: SET, GET, INIT, TERM usw. Adressangaben sind im allgemeinen dreiteilig: Ein Bus, eine Gerätegruppe und eine Adressangabe (Decoderadresse).

Eine Gerätegruppe markiert Geräte mit gleichen Parametern. Dies können reale Geräte wie Decoder sein (jeder hat eine Adresse, einen Motor mit unterschiedlichen Fahrstufen und 0 oder mehr Funktionsausgängen) oder nur logische Geräte wie das TIME-Device sein, die nicht unbedingt ein Hardwarependant haben müssen.

Ein Bus kennzeichnet einen Adressraum, über den verschiedene Geräte erreichbar sind. Im einfachsten Fall ist ein Bus eine Verbindung zwischen dem SRCP-Server und dem Computerinterface der Modellbahnanlage.

Gründe für das Design

Parameterlisten versus benamte Parameter

Die Diskussion wurde per Mehrheitsbeschluß entschieden. Eine technische Über- oder Unterlegenheit einer der beiden Varianten konnte nicht festgestellt werden. Allgemein wurde vermutet, dass benamte Parameter aufwendiger in der Umsetzung sind.

Kommandoworte

Die Kommandoworte wurden zugunsten einer größeren Gerätegruppenzahl klein und abstrakt gehalten. Jeden beeinflußbaren Parameter kann man via GET/SET bearbeiten. Es wurde allgemein für einfacher gehalten, neue Gerätegruppen mit den definierten Kommandos zu kombinieren als für neue Geräte auch neue Kommandos einzuführen.

Kommerzielle Anwendung

Natürlich ist es wünschenswert, daß sich SRCP auch über die Grenzen des DER_MOBA Digitalprojekts verbreitet. Deshalb ist auch der Einsatz von SRCP in kommerziellen Produkten erlaubt. Allerdings sind folgende Bedingungen einzuhalten:

1. Sowohl in der Software, wie auch in der zugehörigen Dokumentation wird auf die SRCP-Entwicklergruppe und diese Internetseite verwiesen.
2. Es findet keine eigenmächtige Erweiterung von SRCP statt. Stattdessen werden Erweiterungen mit der SRCP-Entwicklergruppe diskutiert und offiziell in SRCP integriert bzw. verworfen.
3. Bei kommerziellem Erfolg des jeweiligen Produktes würden wir es gerne sehen, wenn sich die Entwickler über eine Spende zur Unterstützung von DER_MOBA Gedanken machen ;-).

Common Railroad Configuration Files (CRCF)

Ein Entwurf für ein Dateinformat, das eine zentrale SRCP-Server-Konfiguration beschreibt, stammt von Edbert van Eimeren und ist zur Diskusssion in der Newsgroup de.rec.modelle.bahn freigegeben. Die weitere Entwicklung der Spezifikation und eine Ideensammlung zu dessen Nutzung unter SRCP findet im Abschnitt SRCP-Erweiterungen statt.

• Entwurf CRCF 0.2.0 / CRCF Beispiel

• Historie:
  • Entwurf CRCF 0.1.0