AddressLearn MobaLedLib Extension

[jueff]

Servus Zusammen,

es gibt eine neue AddressLearn Extension, siehe https://github.com/Jueff/AddressLearnMLX#readme.

Die Bibliothek erweitert die MobaLedLib um eine Funktion zum Erlernen von Adressen. Wenn die Funktion aktiviert ist, wartet sie darauf, dass ein Schalter oder Taster über DCC/CAN/SX/LNet betätigt wird. Die Adresse wird als Basisadresse gespeichert.

Die Basisadresse wird bei nachfolgenden Schalt- und Tasterfunktionen berücksichtigt.

Anwendung: Mit der AddressLearn Funktion ist es möglich, Firmwaredatei für beliebige Anwendungen zu erstellen, die ein Benutzer auch ohne Installation der MobaLedLib einfach auf eine Hautplatine bringt.
Ähnlich wie bei kommerziellen Produkten ist die Funktion vordefiniert, es kann lediglich die Adresse angelernt werden, mit der Effekte geschaltet werden.

Beispiel: Der Verkehrssicherungsanhänger
Dieser benötigt auf jeden Fall eine Zentrale, die das entsprechende Signal zur Steuerung der Effekte erzeugt.
Hier wird als Zentrale eine Molli Verwendet, die kleinste Version einer MobaLedLib Zentrale, an der ein Verkehssicherungsanhänger angeschlossen ist. Die Zentrale wird mit Strom versorgt und ist am DCC-Gleissignal angeschlossen.

Vorgehensweise:

Erstinstallation - einmalig
- der Benutzer lädt sich die Firmwaredatei "Verkehrssicherungsanhaenger.uf2" herunter
- die Zentral wird am PC über USB angeschlossen
- der Benutzer versetzt die CPU der Molli durch Drücken der Boot und Reset Taste in den Programmiermodus
- Im Dateiexplorer erscheint ein neues USB-Speicherlaufwerk
- die Firmwaredatei wird auf das USB-Laufwerk kopiert
- die Zentrale ist somit programmiert und kann vom PC getrennt werden

- die Zentrale wird auf der Anlage eingebaut, mit Strom versorgt und an DCC sowie den Verkehrsischerungsanhänger angeschlossen
- die Status-LED blinkt grün, der Anhänger ist aus
- die beiden Pins an der Oberseite der Molli werden mit einem Stück Draht oder einer Büroklammer kurz verbunden
- die Status-LED blinkt nun gelb, die Zentrale ist für 30 Sekunden im Adresse Lernen Modus
- der Benutzer wählt an seine Digitalzentrale die gewünschte Adresse und löst einen Schaltbefehl aus
- die Status-LED wechselt wieder auf grün Blinken, die Adresse ist gelernt.

Anwendung:
Der Verkehrssicherungsanhaenger verwendet vier DCC-Adressen

Adresse 1 und 2: Modus des gelben Pfeils
- aus
- links
- rechts
- gerade

Adresse 3: Warnleuchten blinken
- ein
- aus

Adresse 4: Bremslichter leuchten
- ein
- aus

Der Letztzustand der gewählten Einstellung wird gespeichert, beim nächsten Einschalten werden die Effekte wieder so gesetzt, wie sie beim Ausschalten waren.


Was hat das nun mit der AddressLearn MobaLedLib Extension zu tun?
Diese Extension ermöglicht es einem MobaLedLib Anwender, beliebige vorgefertigte Firmwaredateien zu erzeugen.
Dazu benötigt er
- mindestens MobaLebLib Version 3.5.0I
- die AddressLearnMLX Bibliothek, die er z.B. über die Arduino IDE Bibliotheksverwaltung herunterladen kann
- die Beispieldatei "AddressLearn.MLL_pgf", welche im Verzeichnis Prog_Generator_Examples abgelegt ist

Anwendung:
- ProgrammGenerator starten
- wähle Optionen -> Datei -> Laden aus Datei
- Die Datei AddressLearn.MLL_pgf im Verzeichnis Prog_Generator_Examples auswählen
- Importieren
- Blatt AddressLearn wählen

Die Zeilen ab 24 sind die Effekte für obiges Beispiel des Verkehrssicherungsanhängers.
Diese können nach Belieben geändert werden.
In der Adressspalte beginnt man immer mit 1, egal welche Adresse der Benutzer dann anlernt.

Sind die gewünschten Effekte eingestellt wird die Firmware mit "Z. Arduino schicken" erzeugt und zur Zentrale geschickt.
Der Lernmodus wird durch den ersten Hautplatinentaster aktiviert (SwitchD1)

Anmerkung zur Molli: die kelien MLL Zentrale hat keinen Taster, um den Lern-Modus zu aktivieren wird der Lichtsensoreingang an der Oberseite des Gehäuses verwendet. Für die Molli ist die Konfiguration daher etwas anderes, es muss auf jeden Fall die Zeile 7 aktiviert werden, alternativ auch die Zeile 6.

Die fertige Firmwaredatei ist hier zu finden: %USERPROFILE%\AppData\Local\Temp\MobaLedLib_build\Pico und heißt LEDs_AutoProg.ino.uf2
Die Datei kann beliebig umbenannt werden.

Weitere Details:
Die Zeilen 10-18 definieren den Lernmodus
12: Mit SwitchD1 wird der Leanmodus ein- und ausgeschaltet. Die Variable PROG ist im Leanmodus gesetzt. Das Flip-Flop setzt sie nach 30 Sekunden zurück, oder wenn die Variable RES gesetzt ist
13: Setzt die Variable RUN entgehen zu PROG, eine der Beiden ist immer „EIN“, die andere „AUS“.
14: die RES-Variable wird auf „AUS“ gesetzt
15: ist RUN „EIN“ wird auf LED1 eine grüne Heartbeat angezeigt
16: zurück zu LED1
17: ist PROG „EIN“ wird auf LED1 eine gelbe Heartbeat angezeigt
18: Die AddressLearnExtension wird aktiv, wenn PROG „EIN“ ist. Wird ein DCC-Befehl erkannt wird der Learnmodus beendet, das wird durch setzen der Variable RES mitgeteilt.
Das zeigt uns, dass auch die Signalisierung des Lern-Modus beliebig einstellbar ist.

Soweit die Erstinformationen zum neuen Feature.

Danke für Feedback, Lob und Kritik.

Jürgen...

[TMaa]

Hallo Jürgen, (@jueff)

Anmerkung zur Molli: die kelien MLL Zentrale hat keinen Taster, um den Lern-Modus zu aktivieren wird der Lichtsensoreingang an der Oberseite des Gehäuses verwendet. Für die Molli ist die Konfiguration daher etwas anderes, es muss auf jeden Fall die Zeile 7 aktiviert werden, alternativ auch die Zeile 6.

Der Anschluss oben am MoLLi dient nicht dem Anschluss eines lichtempfindlichen Sensors, sondern dem Anschluss von Tastern und/oder Schaltern. Diese können über den SwitchAx-Befehl im PG angesteuert werden. Die dafür notwendige Hardware ist bereits im MoLLi vorhanden.

Lediglich die Widerstandsdekade muss extern realisiert werden. Dadurch ergeben sich 10 Eingänge. Die verwendete Pin-Nummer ist identisch mit der des MLL010, sodass im PG keine Anpassungen erforderlich sind. (Siehe beigefügtes Dokument: MoLLi_Manual.pdf)

Grüße,
Theo.

[TMaa]

Hallo Jürgen, (@jueff)

Erstinstallation - einmalig
- der Benutzer lädt sich die Firmwaredatei "Verkehrssicherungsanhaenger.uf2" herunter
- die Zentral wird am PC über USB angeschlossen
- der Benutzer versetzt die CPU der Molli durch Drücken der Boot und Reset Taste in den Programmiermodus
- Im Dateiexplorer erscheint ein neues USB-Speicherlaufwerk
- die Firmwaredatei wird auf das USB-Laufwerk kopiert
- die Zentrale ist somit programmiert und kann vom PC getrennt werden

Wäre es nicht praktischer, die entsprechende .uf2-Datei in das Firmware-Verzeichnis einzufügen, damit sie über die vorhandene Option im PG geladen werden kann? (C:\Users\XXXX\Documents\Arduino\MobaLedLib\firmware) Alle MoLLis sind mit einem MLL-Sketch vorinstalliert und werden daher vom PG erkannt. Schließlich sind die Boot- und Reset-Tasten des PICO von außen nicht zugänglich, ohne den MoLLi zu öffnen (was den Deckel beschädigen könnte).

Grüße,
Theo.

[jueff]

Hallo Jürgen, (@jueff)
Der Anschluss oben am MoLLi dient nicht dem Anschluss eines lichtempfindlichen Sensors,….
Theo.

Danke Theo für die Richtigstellung, ich werde die Beschreibung entsprechend anpassen.

Jürgen

[jueff]

Hallo Jürgen, (@jueff)
Wäre es nicht praktischer, die entsprechende .uf2-Datei in das Firmware-Verzeichnis einzufügen, ….,
Theo.

Hallo Theo,
Ja, das funktioniert auch.
Ich wollte nur den Weg erklären, bei dem der Benutzer ohne Installation von Zusatztools arbeiten kann.
Es gibt auch Tools im Web, die den Firmwaredownload ohne Tasterbetätigung machen.

Jürgen…

[TMaa]

Hallo Jürgen, (@jueff)

Danke Theo für die Richtigstellung, ich werde die Beschreibung entsprechend anpassen.

Wurden meine Änderungen korrekt vorgenommen? (Beispiel: AddressLearn.MLL_pgf)

Bei Verwendung von MoLLi kann meines Erachtens Zeile 7 (rot markiert) weggelassen und SwitchD1 in den übrigen Zeilen durch SwitchA1 (gelb markiert) ersetzt werden.
Die Kommentare in den markierten Zeilen habe ich bereits angepasst.

Grüße,
Theo