Tutorials zur Ereignisverwaltung

tim-fischertechnik · 1. Januar

Kurztoturial [05] - Wie man (zufällige) Verzögerungen einbaut, damit die Zugfolge nicht so dicht ist

Zuerst möchte ich dir zeigen, wie du eine Verzögerung mit fester Dauer in das Ereignis "schieben" kannst. Das sieht dann so aus.

Hier wird die Ausfahrt für den Nachbar erst 120 Sekunden später gestellt.

Wenn du das hinbekommen hast, kannst du im nächsten Schritt probieren, die Dauer zufällig zu gestallten.

Dafür musst du Zahl (Zufall) auswählen. Unter (1) trägst du die minimale Zeit ein und unter (2) die maximale Zeit. Im Ereignis steht dann auch [minimale Zeit] bis [maximale Zeit].

Viele Grüße
Tim

tim-fischertechnik · 2. Januar

Kurztutorial [06] - Wie programmiere ich eine vollautomatische Zugnummernanzeige mit zwei Ereignissen?

Welche Variablen muss ich wo eintragen:

Zuerst benötigt man ein oder mehrere Textfelder, worin später der Zugnamen automatisch hineingeschrieben werden soll. Man platziert für jede Einfahrt in ein Gleis einen Gleiskontakt und weist ihm das Schlagwort "Zugnummer anzeigen" hinzu. Dann erstellt man die Objektvariable Textfeld Zugnummeranzeige und wählt das passende Textfeld aus.

Dasselbe macht man nun für die Ausfahrt aus einem Gleis.

Was sind erweiterte Variablen und Eigenschaften?
Kurz gesagt versteckt sich dahinter das Konzept von Objekt Orientiertem Programmieren (kurz OOP). Man kann sich das in etwa so vorstellen. Man baut einen Bauplan mithilfe der EV und legt genau fest, welche Eigenschaften und Variablen ein Objekt (das ist hier der Gleiskontakt) besitzen kann. In einer Anlage können also mehrere Objekte wie Gleiskontakte den gleichen Variablennamen haben wie zum Beispiel Textfeld Zugnummeranzeige. Das ist ganz praktisch, weil man nicht für jedes Objekt ein einzelnes Ereignis schreiben muss. Nur der Inhalt also der Bezug zum Objekt bzw. Gleiskontakt ist ganz individuell und abhängig davon, welcher Wert in der erweiterten Variable steht, verhält sich auch die EV intern ganz verschieden. Es gibt verschiedene Variablenbezüge. Hier ist ein Auszug welche du bereits in deiner Anlage verwendet hast und noch werden wirst:

Objekt: Hier wählt man Objekte wie Signale oder auch Schalter etc. aus.
Fahrstraße: Hier wählt man Fahrstraßen aus, die zu einem Objekt gehören

Nun, was sind Eigenschaften eines Objekts? Das sind interne Bezüge die, Neo in seinem Programm festgelegt hat. So hat ein Objekt immer den Namen als Eigenschaft. Manche Objekte habe je nach Ausstattung aber noch mehrere Eigenschaften

Wie wird der Zugname angezeigt?

Jeder Gleiskontakt ist ein Objekt und besitzt die erweiterte Variable. Der Gleiskontakt kennt also seine individuelle Zugnummernanzeige, die man in den Objektvariablen unter den Namen "Textfeld Zugnummeranzeige" abgespeichert hat. Die Zugnummernanzeige steht also in Beziehung mit dem Gleiskontakt, mit dem das Ereignis ausgelöst wird. Das Ereignis Gleiskontakt wird betreten hat aber zwei Auslöser. Einmal den Gleiskontakt und einmal das Fahrzeug. Nun möchten wir aber nicht den Namen also die Eigenschaft des Gleiskontaktes anzeigen, das wäre ja irgendwie komisch, sondern die des Fahrzeuges. Deswegen muss man genau darauf achten, was man als Auslöser ausgewählt.

Wie wird der Zugname wieder gelöscht?

Hier ist es eigentlich ganz simpel, da das Ereignis Gleiskontakt wird verlassen (Zugnummer löschen) dem Ereignis Zugnummer anzeigen ziemlich ähnelt bis darauf, dass hier der Text leer ist und somit die Zugnummer gelöscht wird.

Viele Grüße
Tim

tim-fischertechnik · 3. Januar

Kurztutorial [07] - Wofür kann man Wiederholungen einsetzen und wie funktionieren diese? (Viele Wege führen nach Rom)

keine Wiederholung

Angenommen man möchte vier Biergartenlaternen mit einem Schalter an und ausschalten. Wie könnte man da vorgehen? Nun man kann

Hier habe ich den integrierten Schalter, der in V9 neu hinzugefügt wurde, angesprochen, der wesentlich einfacher anzusprechen ist als die Animationen.

jede einzelne Laterne in der EV direkt ansprechen. Das ist aber sehr aufwändig und wenn man eine Laterne hinzufügen möchte, muss man viermal an zwei Stellen die EV verändern. Einmal dort, wo die Laterne ausgeschaltet werden soll und an anderer Stelle, wo die Laterne eingeschaltet werden soll. Gibt es eine bessere und einfachere Lösung? Die Antwort lautet ja und hier kommen Wiederholungen ins Spiel. Wiederholungen sind also dann immer gut, wenn ein und dieselbe Sache mehrmals wiederholt werden kann.

Wie sieht eine Wiederholung in der EV aus?

Erstmal ist eine Wiederholung immer braun gefärbt. Oben steht der Schleifenkopf. Im Schleifenkopf wird die Art der Wiederholung wie zum Beispiel für alle Fahrstraßen mit einem Schlagwort festgelegt. Im Schleifenkörper werden dann die Elemente der Wiederholung durch einen Platzhalter angesprochen. @Wdh ist schon vor belegt. Man kann aber diesen Iterationsnamen jederzeit abändern. Wichtig! In Schleifen darf alles hinzugefügt werden außer Verzögerungen und der Platzhalter muss identisch mit dem im Schleifenkopf und denen im Schleifenkörper lauten.

Wiederholung mittels Schlagwörtern

Zuerst (1) wählt man das Objekt direkt aus, damit man die richtige Schaltereigenschaft, hier lautet sie Licht, verwendet und sich nicht vertippt. Dann (2) ändert man das Objekt zur Wiederholung. Zuletzt (3) stellt man sicher, dass der Iterationsname aus dem Schleifenkörper identisch mit dem aus dem Schleifenkopf lautet. Hier sieht man, dass man statt acht Einträgen nur noch zwei Einträge benötigt. Die Schleife spricht alle Objekte auf der Anlage an, die das Schlagwort "Laterne" besitzen.

Wiederholung mittels einer Liste (Variante A)
Getreu dem Motto "Viele Wege führen nach Rom" kann man auch statt einer Wiederholung für Objekte mit einem Schlagwort auch die Wiederholung mittels einer Liste verwenden. Das sieht dann so aus.

Der Schleifenkörper bleibt unverändert. Allerdings wurde der Schleifenkopf verändert und hier wurde zuerst vier Laternen mit STRG + C kopiert und dann oben in die Liste im Schleifenkopf selbst eingefügt.

Wiederholung mittels einer Liste (Variante B)

Hier ist die Wiederholung genau dieselbe wie zuvor nur mit dem Unterschied, dass über die erweiterte Variable die Liste angesprochen wird, über die später jedes einzelne Element aus der Liste angesprochen werden soll. Im Schalter (Auslöser) selbst werden die Biergartenlaternen und der dem Namen Laternen abgespeichert und das Schlagwort Schalter Laterne wird vergeben. Das hat den entschiedenen Vorteil, das nun mehrere Schalter in der Anlage platziert werden können und jeder Schalter (Auslöser) seine dazugehörigen Biergartenlaternen kennt.

Dazu habe ich hier eine Beispielanlage gebaut:
Demoanlage - verschiedene Wiederholungen.mbp

Die Demoanlage soll dazu anregen, die Wiederholung an die eigene Bedürfnisse anzupassen. So kann man eine Gleisbesetzmeldeanlage daraus kreieren, indem man statt dem Ereignis Schalter wird betätigt, das Ereignis Gleiskontakt wird betreten verwendet. Anstatt den integrierten Schalter verwendet man den GBS-Baustein als Signal.

Viele Grüße
Tim

Bearbeitet 3. Januar von tim-fischertechnik

tim-fischertechnik · 13. Januar

Kurztutorial [08] - Wie man ein fehlerhaftes Ereignis mithilfe der Ereignisprotokollierung entlarven und beheben kann

Angenommen man hat die EV für eine Gleisbesetztmeldeanlage geschrieben und möchte diese nun flächendeckend auf der Anlage einsetzen.

Hier sieht man auszugsweise, wie beim Aktivieren einer Fahrstraße mit dem Schlagwort FS mit GBS-Elementen die GBS-Elemente auf Gelb (Stellung 1) geschaltet werden. Die GBS-Elemente wurden als Liste unter dem Namen GBS Elemente in der Fahrstraße hinterlegt.

Wie kann man sicherstellen, dass man sich nicht vertippt hat oder irgendwie wichtige Variablen falsch eingetragen oder gar vergessen hat. Hier hilft einem die Ereignisprotokollierung weiter, denn diese stoppt, falls irgendetwas nicht ganz richtig programmiert ist, wenn diese dementsprechend geöffnet wurde. Ganz praktisch, oder?

Zunächst muss man die Ereignisprotokollierung mit der Funktionstaste F12 öffnen.
Dann wartet man ab, bis die Anlage aus irgendeinem Grund stoppt. Denn das ist ein Indiz für eine fehlerhaftes Ereignis oder eine fehlerhafte Variable.

Zur Fehlerlokalisierung geht man wie folgt vor:

Zuerst sucht man nach dem eigentlichen Fehler, der immer rot markiert wird. Attempt to index a nil value heißt zu Deutsch: Versuch, einen nicht vorhandenen Wert anzusprechen / (zu induzieren). Die EV sucht also nach irgendeinem Objekt, findet aber nicht das Objekt, weil der Bezug fehlt, sprich leer ist! „Index“ verrät uns, dass etwas anhand des Index angesprochen wird in Form einer Iteration. Iterieren bedeutet, dass etwas regelmäßig durchlaufen wird und das ist immer bei Schleifen der Fall. Es liegt also ein Schleifenfehler vor bzw. ein Fehler innerhalb einer Schleife vor.
Nun muss man das Ereignis, in dem der Fehler auftrat, identifizieren. Man sucht also nach dem zuletzt ausgeführten Ereignis in blau oder man klickt doppelt auf die rote Zeile. Ein Doppelklick auf die rote Zeile öffnet das betroffene Ereignis. Das fehlerhafte Ereignis ist hier Fahrstraße wird aktiviert GBS -> gelb. Und dann sollte man einen Blick in die EV werfen. Wir wissen nämlich nicht, ob eine Variable fehlt oder die EV fehlerhaft ist. Das sagt einem der Fehler leider nicht.

In diesem Fall liegt ein EV-Fehler vor, dass der Bezug zum Signal leer ist. Richtig wäre natürlich als Bezug, die Wiederholung auszuwählen.

Angenommen wir haben mit der EV alles richtig gemacht so wie im ersten Bild des Kurztutorials dann kann nur eine fehlerhafte Variable Ursache für den Abbruch sein. Dann benötigen wir aber mehr Informationen.
Falls also das Ereignis selbst nicht fehlerhaft ist, prüft man was vor dem Ereignis passiert ist. Hier müssen wird diese Zeile betrachten:
[20:02:31] Fahrstraße wird aktiviert/deaktiviert -> Einfahr-Signal A00 – Ausfahr-Signal P00, True
Hieran können wir also den tatsächlichen Übertäter identifizieren, und zwar fehlt in der Fahrstraße Einfahrsignal A00 – Ausfahr-Signal P00 die Liste mit den GBS-Elementen.
So ist es falsch, da fehlt die Liste:

So wäre es richtig: