Userpages - Hermann (hermannk) → de: Lok-Aktions-Aufrufe

Vorwort 1:
Diese Dokumentation wurde erstellt am: 05.11.2025

Vorwort 2:
- Die Nutzung dieser Lösung erfolgt auf eigene Gefahr;
- Regelmäßige Datensicherungen des Rocrail-Arbeitsbereichs werden empfohlen.

Welchen Status kann eine Lokomotive annehmen, was bedeutet der Status und wie kann man den Status in einer Aktionssteuerung anwenden?

Die verwendeten Worte/Zeichen für einen Lok-Status sind nicht eindeutig. So wird das Wort "stop" sowohl als Befehl als auch als Status verwendet. Der jeweilige Kontext, in dem das Wort angewendet wird, schafft aber in der Regel Klarheit.

Die Befehle einer Lokomotive sind im Rocrail-Wiki beschrieben: Die Typen, Befehle & Parameter - Lokomotiven
go (starten), govirtual (virtuell starten), stop (anhalten), velocity (Geschwindigkeit stellen), velocity2 (Geschwindigkeit 2. Dekoder stellen), percent (Prozent), dispatch (abfertigen), swap (Logische Richtung tauschen), blockside (Blockseite), carcount (Wagenzählung), min (min), mid (mittel), cruise (Reise), max (max), consist (Mehrfachtrakton), assigntrain (Zug zuweisen), releasetrain (Zug lösen), binstate_on (Binär ein), binstate_off (Binär aus), pomwrite (CV via POM), Vvar (Geschwindigkeit), shuntingon (Rangiermodus ein), shuntingoff (Rangiermodus aus)

Der Status einer Lokomotive ist im Rocrail-Wiki beschrieben: Aktions-Steuerung / Status
home, forwards, reverse, diesel, steam, electric, battery, min, mid, cruise, max, fon, foff, +, -, #, x, light, lightgoods, local, goods, post, ice, mixed, regional, shunting, cleaning, none, service, commuter, class, schedule:, idle, wait, auto, run, manual, automatic, stop, stall, f1-f28, eventtimeout, eventtimeoutreset

In dieser Liste stehen auch Worte/Zeichen, die in Aktions-Bedingungen angewendet werden: Mögliche Zustände für den Typ Lok
Im Folgenden sollen die Worte/Zeichen erklärt und angewendet werden.

Die Lok-Aktionen in diesem Beispiel schreiben einen Text in ein Textfeld im Rocrail-Plan, damit man schnell erkennen ab, ob eine Aktion ausgeführt wurde und welche Aktion ausgeführt wurde.
Eine praktische Anwendung würde z.B. einen Pfiff auslösen, eine Schranke schliessen oder … .

Im Arbeitsbereich ist der Rocrail-Plan von dieser Beschreibung enthalten. Er kann für eigene Test gerne erweitert werden.

Hier sollen aus der Liste die Worte/Zeichen beschrieben werden, die in der Aktionssteuerung einer Lokomotive angewendet werden können.
Der Status der Lokomotive wird dabei im Status-Feld bzw. im Substatus-Feld der Aktionssteuerung angewendet.

Hinzu kommen Worte, die im Aktions-Kontextmenü einer Lokomotive enthalten sind:

Die Aktions-Kennung bezieht sich auf die Beispiele im unten stehenden Arbeitsbereich .
- Objekt "lc" = Lokomotive.

Realisiert man die Aufgabe mit XMLScripts, so könnte man in einem einzigen XMLScript jeden oben aufgeführten Status mit einer "switch-case"-Konstruktion abhandeln. Das XMLScript "ac_alx_lc_xmlscript.xml" ist so aufgebaut. Der beim Aufruf vorliegende Status (<switch var="%state%">) verzweigt zu den je nach Status erforderlichen Massnahmen, z.B. <case val="useschedule"> .

  <switch var="%state%">
    <case val="useschedule">
      ...
    </case>
    <case val="f3">
      ...
    </case>
    <case val="assigntrain">
      ...
    </case>
    <case val="dirchange">
      ...
    </case>
    <case val="lights">
      ...
    </case>
    <default>
      ...
    </default>
  </switch>

Hier sollen aus der Liste die Worte/Zeichen beschrieben werden, die in der Aktionssteuerung eines Blocks bezogen auf eine Lokomotive angewendet werden können.
Der Status der Lokomotive wird dabei nicht im Status-Feld der Aktion angewendet, sondern in der Aktions-Bedingung.
Sollte ein Zug der Lokomotive zugeordnet sein, wird in der Aktions-Bedingung die Eigenschaft des Zuges angewendet.

Die Aktions-Kennung und die callerid beziehen sich auf die Beispiele im unten stehenden Arbeitsbereich .
- Objekt "bk" = Block.
- nicht für jeden Lok-Status wurde eine normale Aktion angelegt.

Jetzt sind noch einige Punkte aus der Liste die Worte/Zeichen nicht beschrieben worden.

Das wird später ergänzt.

Aufgabe:
- ein ICE soll auf seiner Rangierfahrt
- einen Pfiff auslösen,
- wenn er im Block bk22 ist und
- die Funktion "F3" aktiv ist (warum auch immer).

Voraussetzungen:
- alle Lokomotiven haben eine Funktion "horn", welche das Pfeifen durchführen soll. In diesen Beispielen ist das die Funktion "F2".
In diesem Beispiel ist die Funktion für 2 Sekunden eingeschaltet.

Realisierung:
Es gibt eine Aktions-Definition "ac_example_horn", die das Pfeifen bei einer beliebigen Lok auslösen soll:

In der Aktionssteuerung von Block bk22 wird diese Aktion angewendet:

Test:
Bei der Lokomotive "lc23" (das ist eine Lokomotive vom Typ "ice")
- die Funktion "F3" einschalten
- das "Rangieren" einschalten
- in den Block "bk22" fahren lassen,
dann wird die Funktion "horn" ausgelöst.
In allen anderen Fällen passiert das nicht.

Zusätzlich wird durch zwei Aktionen in der Lokomotive “lc23” der Zustand der Funktion in dem Textfeld protokolliert.
Die Definitionen der Aktionen:

Die Anwendung der Aktionen bei der Lokomotive “lc23”:

Der heruntergeladene Arbeitsbereich " loco_action_calls.zip" enthält die folgenden Dateien:

zurück zu B) Einleitung.

Den Arbeitsbereich öffnen;
- die Lokomotiven in verschiedene Blöcke platzieren, um alle verschiedenen Situationen zu testen;
- oder
- die Lokomotiven zum Testen starten.
Vorzugsweise:
- die Lokomotive lc01 im Block bk01 (und bk02 und bk03);
- die Lokomotiven lc21, lc22, lc23 und lc24 im Block bk21 (und bk22 und bk23).

Viel Spaß!
Fragen beantwortet das Rocrail-Forum.

Das XMLScript ist optional; für alle normalen Lok-Aktionen gibt es in diesem Beispiel nur ein XMLScript.
Die Block-Aktionen wurden zur besseren Dokumention von Abläufen hinzugefügt.

Während bei normalen Aktionen für jeden Status eine Aktion angelegt werden muss, kann ein XMLScript mehrere Einzelaktion abdecken:

Die Lokomotiven haben für die Tests unterschiedliche Eigenschaften.

In den Blöcken sind für die Tests unterschiedliche Aktionen vorgesehen.