Userpages - Hermann (hermannk)

die normale Ansicht	die Ansicht von unten	Rocrail-Plan
Display und fünf LEDs	Verdrahtung, WIO ESP8266	Textfelder, Ausgänge

Vorwort 1:
Damit wurde diese Dokumentation erstellt: Stand 14.02.2022; Update 13.02.2024

Vorwort 2:
- die Nutzung dieser Lösung erfolgt auf eigenes Risiko;
- regelmäßige Datensicherungen des Rocrail-Arbeitsbereichs werden empfohlen;

Ein H0-Bahnsteig-Bausatz soll mit einer Bahnsteig-Anzeige und LED-Beleuchtung unter der Überdachung aufgepeppt werden.

Auf dem Foto sind zwei unterschiedlich platzierte Displays zu sehen mit Analoguhr und Textinhalt.

a) Bahnsteig-Anzeige
b) Bahnsteig-Beleuchtung

Das verwendete 0,91 Zoll OLED I2C Display hat 128 x 32 Pixel. Es ist mit 38 mm Länge so lang wie ein schmaler H0-Bahnsteig breit ist. Da das Display vorsichtig um 2 mm gekürzt werden kann, passt es in diesem Beispiel zwei zum Bahnsteig (dauerhaft) platziert zu werden.

Das Display kann mit einer Höhe von 32 Pixeln vier Zeilen Text darstellen. Bei zwei Bahnsteig-Gleisen soll dann für jedes Gleis eine jeweils zweizeilige Anzeige von Rocrail-Lok und Rocrail-Zug angezeigt werden, wenn der Bahnsteig-Block besetzt wird. Das kann man über Rocrail-Aktionen in einem Block steuern. Hier werden die Stati "enter", "occupied" und "free" angewendet, um eine Aktion auszulösen.

Im Rocrail-Plan wird das "Gleis 1" als Block "bk02" und das "Gleis 2" wird als Block "bk03" dargestellt.

So sorgen die im Kreis fahrenden Lokomotiven für einen ständigen Wechsel auf der Display-Anzeige.

Der Status "free", "enter" und "occupied" sollen ausgewertet werden, um eine Aktion im Block auszulösen:

Der Schriftzeichen-Puffer für das Display kann 120 Schriftzeichen speichern; darin ist der darzustellende Textinhalt enthalten und es sind sämtliche benötigte Steuerzeichen enthalten.
Die Textinhalte werden in Textfeldern gespeichert, die eine "Schnittstelle" zum WIO konfiguriert haben und so bei jeder Aktualisierung des Textfeldes den Inhalt des Textfeldes an den WIO übertragen.
Für vier Zeilen Text wird der gesamte darzustellende Text in zwei Teile aufgeteilt, weil die Grenze von 120 Schriftzeichen sonst leicht überschritten wird:

Um auf dem Display etwas anzuzeigen, wird ein Rocrail-Textfeld mit dem gewünschten Inhalt gefüllt; da müssen alle notwendigen Befehle und der gewünschte Text enthalten sein. Das Textfeld hat als Schnittstelle den WIO konfiguriert und sendet bei jedem Update den Textfeldinhalt an den WIO. Der WIO gibt den Inhalt weiter an das Display.
Hier werden jetzt vier Aktionen definiert, die den Inhalt der Textfelder aktualisieren.
Noch eine Bemerkung vorne weg:
Einzelne Schriftzeichen auf der Anzeige lassen sich am Einfachsten durch Löschen der gesamten Anzeige löschen. Da dann jeweils ein Textpuffer verloren ist, wird er aktualisiert ("…recall"). Das Löschen erfolgt durch den Befehl "{E}", der am Anfang von tx_bahnsteiganzeige1 abgelegt ist. Die Ausgabe des gesamten Textpuffers erfolgt mit dem Befehl "{P}", der am Ende von tx_bahnsteiganzeige2 abgelegt ist.

Hinweis: falls keine Lok oder kein Zug vorhanden ist, werden die Werte für "%lcid%" und "%operatorid%" von Rocrail nicht gefüllt - wunderbar.
Die Beschreibung der Befehle für das Display findet man unter Display SSD1306/SH1106.

Für den Block "bk02" werden die folgenden Aktionen angewendet; die Reihenfolge ist entscheidend!

Für den Block "bk03" werden die folgenden Aktionen angewendet; auch hier ist die Reihenfolge entscheidend!

Auf der Basis dieser Lösung dürfen gerne eigene Ideen umgesetzt werden. Als Stichworte seien hier genannt: Fahrpläne, Wagenreihung, (Verspätungen gibt es im Modell normal nicht), Sonderzeichen als Bitmaps, Analoguhr, Digitaluhr, Besucherbegrüßungstext, Sondermeldungen, …

Es sollen verschiedene Lösungs-Techniken zur Ansteuerung von LEDs aufgezeigt werden.
b1) Mit einem Rocrail-Ausgang lässt sich eine LED ansteuern.
b2) Mit Rocrail-IOscripts können mit einem Rocrail-Ausgang mehrere LEDs angesteuert werden.
b3) Mit Rocrail-LEDScripts können dynamische Abläufe mit LEDs realisiert werden.

In dem Arbeitsbereich gibt es zahlreiche Ausgänge, mit denen die hier vorgestellten Beispiele ausprobiert werden können.

Jede LED kann mit je einem Rocrail-Ausgang ein- und aus-geschaltet werden. Der Farbton und die Helligkeit sind fest eingestellt. Hier soll ein "warmweißes" Licht verwendet werden, das etwa den RGB-Werten R=100%, G=80%, B=10% entspricht - also R=255, G=204, B=25. Die Helligkeit wird moderat eingestellt (hier mit Sättigung=063); das spart einerseits Energie und stellt andererseits sicher, nicht geblendet zu werden.
Hinweis: LEDs können sehr hell strahlen und die Augen schädigen! Nehmt Rücksicht auf euch und eure Besucher!

Alle 5 LEDs sollen mit einem Rocrail-Ausgang ein- und aus-geschaltet werden; das kann mit einem IOscript erreicht werden. Der Konfigurations-Aufwand wird damit reduziert.

Der Name des IOscripts ist "000_14_001.io"; Achtung: die Nummer im Namen ist um 1 kleiner als die Adresse vom Rocrail-Ausgang!
Der Inhalt des IOscripts für eingeschaltetes warmweißes Licht kann dann so aussehen:

#Bahnsteig mit 5 LEDs \\
#alle an \\
#warmweiss = 100% Rot, 80% Grün, 10% Blau \\
#p o t sla bri b de red gre blu \\
00 1 P 000 063 0 00 255 204 025 \\
01 1 P 000 063 0 00 255 204 025 \\
02 1 P 000 063 0 00 255 204 025 \\
03 1 P 000 063 0 00 255 204 025 \\
04 1 P 000 063 0 00 255 204 025 \\

Weitere Details zu IOscripts stehen im Wiki unter IOscript

Der Name des IOscripts für ausgeschaltetes Licht ist "000_14_000.io".
Der Inhalt des IOscripts für ausgeschaltetes warmweißes Licht kann dann so aussehen (die Spalte "o" hat den Wert 0):

#Bahnsteig mit 5 LEDs \\
#alle aus \\
#warmweiss = 100% Rot, 80% Grün, 10% Blau \\
#p o t sla bri b de red gre blu \\
00 0 P 000 063 0 00 255 204 025 \\
01 0 P 000 063 0 00 255 204 025 \\
02 0 P 000 063 0 00 255 204 025 \\
03 0 P 000 063 0 00 255 204 025 \\
04 0 P 000 063 0 00 255 204 025 \\

Beide Dateien müssen in den WIO geladen werden.

In diesem Rocrail-Plan werden fünf LEDScript-Beispiele vorgestellt. Die Ideen und Inhalte zu den LEDScripts stammen zum Teil aus dem Rocrail-Forum und wurden an die hier dargestellte Umgebung angepasst.
Jedes LEDScript wird von je einem Rocrail-Ausgang aktiviert.
Update1: die Adresse hat sich geändert auf eine maximal 2-stellige Script-Nummer
Update2: der Typ hat sich geändert: vorher "LED"; jetzt "LEDScript"

Die Dateinamen beginnen alle mit "ls_", damit die LEDScripts alphabetisch sortiert zusammen stehen.
Weitere Details zu LEDScripts stehen im Wiki unter LEDScript
Mit einem Rocrail-Ausgang kann man ein LEDScript aktivieren (EIN) und de-aktivieren (AUS).
Alle LEDScripts sind in der Download-Datei enthalten.

Alle 5 LEDs sollen mit einem Rocrail-Ausgang ein- und aus-geschaltet werden; das kann mit einem LEDScript erreicht werden. Der Konfigurations-Aufwand wird damit reduziert.

Hinweis: wenn man unter Schnittstelle / Wert = 126 einträgt und unter Farbe / RGB / rot = 253 einträgt, dann sieht man im Rocrail-Plan für den Ausgang einen optischen Unterschied zwischen EIN und AUS; sonst wäre er immer schwarz.
Die Werte 126 und 253 sind hier willkürlich gewählt; es sollte immer ein heller sichtbarer Farbton sein.
Der Name des LEDScripts ist "ls_bahnsteig_21.led".
Der Inhalt des LEDScripts für ausgeschaltetes warmweißes Licht ist im LEDScript bereits enthalten.
Der Inhalt des LEDScripts für eingeschaltetes warmweißes Licht kann dann so aussehen:

#Skript für Bahnsteig mit 5 WS2812
s0 //Skript läuft immer
#warmweiss = 100% Rot, 80% Grün, 10% Blau
l0 //LED 1. definieren beginnend bei 0 = 1.te LED
c5 //x folgende LEDs
r255 //feste Vorgabe für Rot
g204 //feste Vorgabe für Grün
b25 //feste Vorgabe für blau
i063 //brightness, Helligkeit
#LED-off
D0 //Erste LED definieren
T5 //inkl. der 5 folgenden
e

Weitere Details zu LEDScripts stehen im Wiki unter LEDScript

Hinweise: siehe b3.1)

# Lauflicht
s0 			//Skript läuft endlos
l0			//LED definieren beginnend bei 0 = 1.te LED
c1			//nur 1 LED keine folgenden
r255
g204
b025
i017		//brightness, Helligkeit
p005		//bei Großschreibung wird mit Zufallswerten gearbeitet
# LED 
...
#LED-off
D0 //Erste LED definieren
T5 //inkl. der 5 folgenden
e

Hinweise: siehe b3.1)

# einblenden
s0 			//Skript läuft endlos
l0			//LED definieren beginnend bei 0 = 1.te LED
c5			//alle 5 LEDs
r255
g204
b025
>063		//brightness, Helligkeit
p005
#LED-off
D0 //Erste LED definieren
T5 //inkl. der 5 folgenden
e

Hinweise: siehe b3.1)

# vielfallt
s0 			//Skript läuft endlos
l0			//LED definieren beginnend bei 0 = 1.te LED
c1			//nur 1 LED keine folgenden
R51455	// range= 200*256 + 255 = 51455
G38604	// range= 150*256 + 204 = 38604
B00281	// range= 001*256 + 025 = 00281
I017		//brightness, Helligkeit
# LED
...
#LED-off
D0 //Erste LED definieren
T5 //inkl. der 5 folgenden
e

Hinweise: siehe b3.1)

# Defekte Neonröhre
s0 		//Skript läuft endlos
l0		// zuerst sind alle an
c5	
r255
g204
b25
i017
p50
#kurze Leuchtzeit (aufblinken) max 50 ms
...
#LED-reset, LED lässt sich dann über den Ausgang ausschalten.
d0
t5
e

In dem Download-Arbeitsbereich "WIO_Bahnsteig_20240213.zip" sind folgende Dateien enthalten:
- Hinweis: ab 29.11.2022 passen die LED-Script-Adressen der Plan-Datei zu der Beschreibung hier im Wiki;
Update: ab 13.02.2024 positiv getestet mit WIO Version 814 und Rocrail Version 2.1.4194

zurück zu den Lösung-Details.

Ein kurzer Überblick, was für die Anwendung zu erledigen ist:

WIO - Anschluss an I2C-OLED-Displays und WS2812B RGB-LEDs (FastLED, NeoPixel):
wio_esp8266_20220325.pdf
Ohne Gewähr.

Viel Spass und gutes Gelingen.