MobaLedLib Wiki - anleitungen:spezial:pyprogramgenerator

arduinoeinstellungen

anonymous@undisclosed.example.com (Anonymous) — Sun, 03 Jan 2021 16:00:44 +0000

pyProgramGenerator - ARDUINO-Einstellungen

Hier können Sie die Einstellungen für den ARDUINO vornehmen.

Schliessen Sie den ARDUINO an einen USB Port an. Der ARDUINO wird automatisch in der Liste der gefundenen Geräte angezeigt. Wenn nur ein ARDUINO gefunden wurde, wird er automatisch auch als Anschluss eingetragen. Sie könnnen dies aber auch von Hand ändern. Der Boardtyp wird auch automatisch übernommen.

Wenn mehrer ARDUINOs angeschlossen sind, können Sie den ausgewählten ARDUINO blinken lassen.

Die Eingabefelder

„Alle Anschlüße zeigen“: Es werden in der Liste all Anschlüsse angezeigt, auch die an denen kein ARDUINO erkannt wurde. Wenn man viele belegte USB-Anschlüsse hat, kann man diese Option löschen, damit nur die erkannten ARDUINOs angezeigt werden.
„Automatisch übernehmen“: Ist diese Option eingeschaltet, wird der gefundene ARDUINO automatisch unter „Anschluss“ und „Board Typ“ eingetragen, wenn nur ein ARDUINO gefunden wurde.
„Anschluss“: Com-Anschluss des ARDUINOs auswählen.
Board-Typ: Typ des ARDUINO-Boards („Nano/Uno (alt)“,„Nano/Uno (Neu)“, „Typ von ARDUINO IDE“) - bei der letzten Option wird der Typ des ARDUINOs von den IDE Einstellungen übernommen (nur für Experten)
„Verbinden mit LED ARDUINO: Eine Verbindung zum LED ARDUINO wird aufgebaut.
Initialisiere LED ARDUINO: Ein Basis MLL-Programm wird an den LED ARDUINO geschickt. Damit reagiert der LED-ARDUINO richtig auf den Kommandos vom ProgrammGenerator
Digital System: Welches DigitalSystem wird für die Steuerung verwendet. (CAN, DCC, Selectrix) Diese Einstellung ist wichtig für das Programm, dass zum DCC/Selectrix ARDUINO geschickt wird, und für die Einstellung des LED ARDUINOs, auf welche Kommandos er hören soll.
Init DCC/Selectrix ARDUINO: Initialisiert den DCC/Selectrox ARDUINO mit dem notwendigen Programm. Der DCC/Selectrix ARDUINO (und nur dieser) muss dazu mit dem USB-Anschluss des PCs verbunden sein
Individuelle Pfad zur ARDUINO IDE: Diese Option ist für Spezialisten, die die ARDUINO IDE nicht am Standard-ort installiert haben, oder pyProgrammGenerator auf einem Mac oder LINUX System nutzen wollen

arduinomonitor

anonymous@undisclosed.example.com (Anonymous) — Sun, 03 Jan 2021 15:45:42 +0000

pyProgramGenerator - ARDUINO Monitor

Diese Seite zeigt die Meldungen der ARDUINO-Tools beim Erzeugen des Programms und beim Hochladen an

Das folgende Bild zeigt einen Screenshot des ARDUINO Monitors

dcckeyboard

anonymous@undisclosed.example.com (Anonymous) — Thu, 03 Apr 2025 09:07:47 +0000

pyProgramGenerator - DCC - Keyboard

Der Keyboard Simulator schickt an den ARDUINO direkt Kommandos, die den Kommandos entsprechen, die der DCC-ARDUINO an den LED-ARDUINO schicken würde. Damit kann man die Funktion der DCC Schalter austesten.

ACHTUNG: Beim ersten Tastendruck kann es etwas dauern, da der ARDUINO den Modus umschalten muss und eventuell neu verbunden wird. Manchmal reagiert der ARDUINO auch erst auf den 2ten Tastendruck Das folgende Bild zeigt einen Screenshot der DCC Keyboard Seite.

Die Basis-Adresse ist die Startadresse mit der die Taster anfangen. Ansonsten verhält sich das Keyboard wie ein normales Keyboard. Bei Druck auf die Grüne-Taste wird ein Makro, das im ProgrammGenerator mit einer DCC-Adresse als Ein/Aus Schalter konfiguriert wurde, eingeschaltet. Mit der roten Taste wird er wider ausgeschaltet.

CAN und L-Net

Das DCC-Keyboard kann auch mit CAN und LNET Programmen verwendet werden und funktioniert dort genauso wie mit DCC.

Selectrix

Das DCC-Keyboard kann auch mit Selectrix Programmen verwendet werden. Allerdings muß man dann die Adresse etwas anders berechnen:

DCC-Adresse = Selectrix-Adresse * 8 + Bitposition

Beispiel: Selectrix-Adresse: 10 Bitpos: 1

DCC-Keyboardadresse: 81

direct-mode-servo

anonymous@undisclosed.example.com (Anonymous) — Mon, 01 Jul 2024 11:30:30 +0000

Direct Mode Servo

In der Servo Platine 510 wird das digitale Signal vom ARDUINO erst vo einem WS2811 Chip in drei analoge Werte umgewandelt (R,G,B). Diese drei anaolgen Signale werden dann von einem Attiny-85 eingelesen und in digitale Signale für die drei angeschlossenen Servos umgewandelt. Dieser etwas umständliche Weg mußte gewählt werden, da die direkte Verarbeitung des ARDUINO Signals im Attiny nicht möglich erschien, da der Attiny dafür zu langsam war.

Mit dem Direct Mode Servo hat es Eckhard geschafft, mit dem Attiny die ARDUINO Signale direkt auszuwerten und daraus die digitalen Servo Signale zu erzeugen. Dieser direkte Weg hat mehrere Vorteile:

Einsparung des WS2811 - kleinere Platine
genauere Reaktion der Servos, da die Umwandlung in Analogsignale und Verarbeitunmg im Attiny zu Ungenauigkeiten führt.
einfachere Programmierung der Endlagen

Für den Aufbau einer Direct-Mode-Servo-Platine gibt es zwei Möglichkeiten:

die neue Platine 511 (in Entwicklung - noch nicht verfügbar)
Anpassung der Platine 510

Platine 511

Beschreibung folgt, wenn die Platine verfügbar ist

Umbau PLatine 510 zu Direct Mode Servo

Da sich die Verfügbarkeit der echten 511 Direkt-Mode-Servo Platine etwas hinzieht (Schuld liegt bei mir, bzw. meinem Zeit-Budget für unser Hobby ;)) bin ich schon gefragt worden, wie die Anders-Bestückung der bisherigen 510er Servos Platine, quasi als Übergangs-Lösung, genau aussieht. Daher gibt es hier jetzt die 510 Umbau-Beschreibung, die ich auch Harold, als er mit dem Python Programm Generator, für den Direkt Mode-Servo begonnen hat, gegeben habe:

Basis ist eine modifizierte MobaLedLib 510 Servoplatine. Bei dieser muss der WS2811 Chip weggelassen, bzw. entfernt werden. Ausserdem müssen die Widerstände R5/R9/R10 weggelassen, bzw. entfernt werden. R5 und R9 würden die Lichtbus DI/DO Leitungen unzulässig dämpfen. Statt R5 zu entfernen reicht es auch, die Brücke SERVO1 wieder zu öffnen. Statt R10 mit 1K sollte ein 10K Widerstand eingebaut werden, wenn wir den ATTiny85 Pin 1 nicht zum I/O umkonfigurieren (dieser Pin wird nicht gebraucht), sondern als RESET belassen.

Außerdem müssen statt des WS2811 Chips zwei Brücken eingebaut werden. Und zwar am Bauelementeplatz des WS2811 (egal ob DIP-8, oder SOP-8 unten) von Pin 1 zu Pin 6 und von Pin 2 zu Pin 5. Bitte unbedingt die Zählweise der Pins beachten, die Brücken dürfen sich NICHT kreuzen!

Bei einer Neubestückung können auch der Widerstand R1 und der Kondensator C1 weggelassen werden; bei einer Abänderung der alten Variante stören sie aber nicht!

Dazu kommen Bilder, die den Umbau, bis auf die 4,7K Servo-Pull-Up Widerstände R6, R7, R8, zeigen:

Eine Diskussion zu dem Umbau findet Ihr hier: https://www.stummiforum.de/t226083f195-pyMLL-fuer-Windows-LINUX-und-MAC.html

Dieses Bild zeigt schematisch, was zu ändern ist:

Programmieren kann man den ATTiny85, mit dem bekannten 400er Progger, aus dem Python Programm Generator heraus; fast an der selben Stelle, wie auch Hardies Variante. Es heißt dort „Servo 2“

Es gibt aber auch eine einfachere Alternative zu dem 400er Progger, die mit dem Direct-Mode-Servo funktioniert: Einfacher-Attiny-Programmer

Zudem WICHTIG: Die Chip Ein- und Ausgänge des ATTiny85 haben NICHT die selben physikalischen Eigenschaften der DI und DO Leitungen von echten WS2811/12 LEDs! Die Tiny Pins sind eigentlich für die Kommunikation von Chips untereinander, auf einer gemeinsamen Platine, gedacht. Man kann sie nicht, wie die WS2811/12 LEDs bis zu 2m voneinander entfernen! Ich habe aber erfolgreich Reichweiten mit bis zu 50-70cm getestet.

Ergänzung: Eigentlich wisst ihr alle, die ihr eine normale MLL Hauptplatine verwendet, doch gut bescheid! Denn wenn ihr die Heartbeat LED dort weglasst (oder ohne MLL Hauptplatine mal eben einen freien Arduino dafür verwendet), hat die Reichweite zur ersten Nutz-LED andere Grenzen, als mit Heartbeat LED! Der Nano hat hier nämlich die selbe Physik, wie der DM Tiny. Nur macht der DM Tiny es nicht nur einmal vorwärts, sondern auch noch einmal rückwärts!

Man sollte also, bei der DM modifizierten 510 Platine und später auch der orginären 511 Platine, nicht zu weit entfernt davor und dahinter im Strang echte WS2811/12 LEDs haben!

Folgende Jumper müssen geschlossen werden: SERVO, SERVO2, SERVO3 und nach Bedarf (letzter 510(1) in der Kette) TERM.

SERVO1 ist egal, wenn R5 nicht bestückt ist und muss geöffnet werden, wenn R5 vorher mal bestückt wurde.

Adressierung der Servos

Bei der modifizierten Platine belegt jeder Servo eine RGB-Adresse. (Bei der originalen Platine hatte das gesamte Modul eine RGB-LED Adresse und die Servos wurde durch die R-G-B Kanäle angesprochen). Die Adressen bei der modifizierten Platine sind fortlaufend. D.h. erste Servo-Adresse 5, dann haben die beiden anderen Servos die Adresse 6 und 7. Diese Adresse ist auch bei der Endlageneinstellung und in der Servo-Animation angegeben werden, damit der richtige Servo angesprochen wird.

Einstellung der Endlagen

Die Einstellung der Endlagen erfolgt über die „Servo2“ Seite des pyProgrammGenerators. Die Beschreibung findest Du hier: pyProgrammGenerator - Servo2 Seite

Programmierung von Animationen

Die Programmierung von Animationen erfolgt durch den Servo-Animations Macro im pyProgrammGenerator. Detail ssind hier zu finden: pyProgrammGenerator - Servo Animation

einfacher-attiny-programmer

anonymous@undisclosed.example.com (Anonymous) — Sun, 30 Jun 2024 09:15:25 +0000

Einfacher Attiny Programmer

Für den Attiny der Direct-Mode-Servo-Platine gibt es noch eine alternative zu dem 400er Programmer, die auf einem Steckbrett aufgebaut werden kann:

Ich habe mir einen sehr einfachen Programmer bestehend aus einem Nano, einem Null-Kraft-Sockel, einem 100nf Kondensator und 6 Kabeln gebaut siehe Bild.

Die Anleitung dazu habe ich hier gefunden:

Diese Anleitung ist sehr einfach nachzuvollziehen. Ist aber leider nur auf Englisch.

Eine Anleitung auf Deutsch gibt es hier:

https://wolles-elektronikkiste.de/attiny-mit-arduino-code-programmieren

einstellungen

anonymous@undisclosed.example.com (Anonymous) — Sun, 03 Jan 2021 16:08:18 +0000

pyProgramGenerator - Einstellungen

Hier können Sie die Grundeinstellungen für das Programm an Ihre Wünsche anpassen.

Das folgende Bild zeigt einen Screenshot der Einstellungen Seite

Eingabefelder

Farbauswahl: Hier kann man wählen, ob im Farb-Tester für die Farbauswahl ein Farbrad oder der HSV-Farbtonwähler verwendet werden soll.
Startseite: Gibt an, mit welcehr Seite PyProgrammGenerator gestartet werden soll
Maximale Anzahl LED: Gibt an, wieviele LED sich maximal in der Kette befinden. Max ist 255. Sollte so niedrig wie möglich eingestellt werden, um Speicher im ARDUINO zu sparen.
LED-Farbkorrektur: Die Farbe der LEDs entspricht nicht der Farbanzeige am Monitor. Die LEDs haben eine Farbstich. Durch dies LED-Farbkorrektur kann dieser Farbstich korrigiert werden.
Z21 Portliste verwenden: Diese Funktion ist noch nicht implementiert.
Schriftgröße anpassen: Bei kleinen Bildschirmen kann die Schriftgrösse angepasst werden, um den Text besser und vollständig lesen zu könen

farbtest

anonymous@undisclosed.example.com (Anonymous) — Sun, 03 Jan 2021 14:57:50 +0000

PyProgrammGenerator - Der Farbtester

Der Farbtester ist jetzt ein Teil des pyProgrammGenerators. Der pyProgrammGenerator und ergänzt jetzt das Excelprogramm mit einer graphischen Benutzeroberfläche und verschiedenen Tools. Da es Python basiert ist, läuft es auch auf nicht Windows Plattformen, wie z.B. Linux oder Mac

Eine erste Beschreibung findet Ihr hier:pyProgramGenerator.

Der Farbtester unterstützt die Arbeit mit der MobaLedLib.

Der Farbtester bietet dabei folgende Funktionen:

Testen von Farbeinstellungen direkt am ARDUINO
Speichern von Farbeinstellung in der Col-Tab
Korrektur der Monitoransicht der Farben um Farbstich der LED zu kompensieren
Automatisches Verbinden mit dem ARDUINO
Sofortiges Senden von Einstellungsänderungen an den ARDUINO
Monitoring der seriellen Schnittstelle des ARDUINO

Das Menue

Datei
- Farbpalette von Datei lesen
- Farbpalette in Datei speichern
- LED Tabelle von Datei lesen
- LED Tabelle in Datei speichern
- Beenden und Daten speichern
- Beenden ohne Daten zu speichern

Farbpalette
- letzte Änderung rückgängig machen
- von Datei lesen
- in Datei speichern
- Auf Standard zurück setzen

ARDUINO
- Verbinden
- Trennen
- Alle LED aus
Hilfe
- Hilfe öffnen
- About …

Tabulator-Fenster

Die verschiedenen Fenster können über Tabulatoren erreicht werden. Es stehen folgende Fenster zur Verfügung:

Led Farbtest
Effekt Test
Effekt Macro
Sound Test
Serial Monitor
Einstellungen

LED Farbtest Seite

Die Farbauswahlseite erlaubt es die Wirkung einer LED-Farbe direkt zu testen. Dazu bietet sie die Möglichkeit die LED auszuwählen, die gewünschte LED-Farbe einzustellen und diese dann an den ARDUINO zu senden.

Zur Auswahl der Farbe stehen folgende Hilfsmittel zur Verfügung:

Farbrad mit Helligkeitsbalken

Durch Anklicken eines Punktes im Farbrad kann die Farbe und Sättigung eingestellt werden. Die Helligkeit kann über den Helligkeitsbalken oberhalb eingestellt werden.

Eingabefelder:

Die Eingabefelder rechts zeigen die eingestellte Farbe in verschiedenen Farbmodi an:

Farbton/Sattigung/Helligkeit: HSV-Modus
Rot/Grün/Blau: RGB-Modus
HTML: Hexadezimaldarstellung der Farbe
Farbtemperatur

Farbpalette

Die Farbpalette enthält die Farben der ColTab aus der MobaLedLib. Zu Beginn enthält sie voreingestellte Farben für typische Beleuchtung.

Die Farbe kann durch Anklicken ausgewählt werden und wird zur „Aktuellen Farbe“. Ausserdem kann die aktuelle Farbeinstellung durch „CTRL-Click“ mit der rechten Maustaste in einem Palettenfeld gespeichert werden. Das Palettenfeld zeigt die Farben IMMER mit der maximalen Helligkeit an, damit der Farbeindruck erhalten bleibt.

Die Anzeige „xx%“ zeigt die eingestellte Helligkeit an.

Mit <CTRL-Z> kann man die Einstellungen wieder rückgängig machen.

Mit der rechten Maustaste wird ein Kontextmenu geöffnet:

aktuelle Farbe in Palette uebernehmen [CRTL-rechte Maustaste]
Palettenfarbe zur aktuellen Farbe machen [Linke Maustaste]
Paletten Farbe auf Standard zuruecksetzen

ACHTUNG: Die Farben am Monitor entsprechen nicht unbedingt den LED Farben. Zum einen werden die dunklen LED Farben auf dem Monitor fast schwarz, zum anderen haben alle RGB LED einen Farbstich. Deswegen werden die Farben folgendermassen dargestellt:

ALLE Farben auf dem Monitor haben 100% Helligkeit. Damit kann man Farbe und Sättigung gut erkennen. Die Helligkeit wird bei den Farben in % mit angegeben. z.b. 50% für eine LED mit halber Helligkeit. Den Farbstich kann man etwas durch die Farbkorrektor auf der Einstellungen-Seite korrigieren.

LED Steuerung:

Mit diesen Kontrollen kann man die LED auswählen, deren Farbe geändert werden soll. Wenn man die LED Adresse oder die Anzahl der LED ändert, blinken die ausgewählten LED zuerst hell. Damit hat man die Möglichkeit die LEDs zu identifizieren und zu überprüfen, ob die richtige(n) LED8s) ausgewählt wurden.

Das Blinken wird beendet durch:

die Schaltfläche „Blinken beenden“ anklicken – die LED leuchtet dann mit ihrer zuletzt eingestellten Farbe oder gar nicht, wenn sie vorher aus war
die „aktuelle Farbe“ anklicken – die LED erhält dann die aktuelle Farbe
eine Farbe aus der Farbpalette anklicken – die LED erhält dann die aktuelle Farbe
eine Farbe auf dem Farbwähler anklicken oder die Zahlen in den Eingabefeldern ändern - die LED erhält dann die aktuelle Farbe

Folgende Parameter stehen zur Verfügung:

LED-Adresse: Gibt die Nummer der LED an, die in der ausgewählten Farbe leuchten soll.
LED Anzahl: Gibt die Anzahl der LEDs an, die mit der Farbe leuchten sollen. Sinnvoll z.B: bei Strassen und Bahnsteigbeleuchtung, bei der viele LEDs mit der gleichen Farbe/Helligkeit leuchten sollen
Schalter „Alle LED aus“: Beim Anklicken, werden alle LEDs ausgeschaltet.

installation

anonymous@undisclosed.example.com (Anonymous) — Fri, 31 May 2024 09:46:03 +0000

pyMobaLedLib Installation Windows

Erst die MobaLedLib entsprechend der Installationsanweisung installieren - auch wenn man die Excel-Version nicht nutzen möchte!!

Für die Installation der pyMobaLedLib unter Windows steht ein eigenes Paket zur Verfügung.

Das Paket findet man im GitHub Release-Verzeichnis: https://github.com/haroldlinke/pyMobaLedLib/releases. Bitte den neuesten Release verwenden auch wenn er „nur“ Beta-Status hat.

Auf die Release-Nummer klicken.

Die Datei pyMobaLedLib_win_x.x.x.zip herunterladen.

Das Programm kann in jedem beliebigen Verzeichnis installiert werden.

Ich habe es im Verzeichnis

Dokumente\pyMLL

abgespeichert.

ACHTUNG: In einer früheren Version hatte ich vorgeschlagen, die PyMobaLedLib im Libraries-Verzeichnis zu installieren. Dies bitte NICHT machen. Das Libarries-Verzeichnis sollte nur von offiziellen ARDUINO-Libraries genutzt werden. Eine Änderung im Libraries-Verzeichnis kann zu Problemen beim Kompilieren von ESP32 Programmen führen und eventuell auch andere Probleme machen!!

Sollte es bereits einen Ordner pyMobaLedLib_xxxx mit einer alten Installation geben. Diesen bitte löschen.

Mit der rechte Maustaste die zip-Datei anklicken und „Alle extrahieren“ auswählen.

Im folgenden Dialog „Extrahieren“ anklicken.

Es wird ein neues Verzeichnis mit dem Namen der zip-Datei angelegt.

Dieser Ordner kann in „pyMobaLedLib“ umbenannt werden - muß aber nicht.

Den Ordner pyMobaLedLib_xxx öffnen:

In dem Ordner befindet sich die Datei pyMobaledLib.bat.

Diese Datei ist die Startdatei für die pyMobaLedLib.

Beim Starten des Programms wird sich Windows beschwere, daß es die Datei nicht kennt.

Bitte „Trotzdem Ausführen“ anklicken.

Beim Starten überprüft das Programm, ob es eine neuere Version in Github gibt.

Wenn ja, wird eine entsprechende Meldung angezeigt.

Zum Updaten des Programms geht man folgendermaßen vor:

Im Programmgenerator den Button „Optionen“ anklicken.

In dem Fenster den Reiter „Update“ auswählen.

In dem Fenster den Button „Aktualisiere pyMobaLedLib“ anklicken.

Das Programm fragt dann nochmal nach, ob man die neue Version herunterladen will und startetr dann den Download.

Nach dem Download fragt das Programm, ob es die neue Version starten soll. Wenn ja, wird das aktuelle Programm beendet und die neue Version gestartet.

linux_mint_installation

anonymous@undisclosed.example.com (Anonymous) — Thu, 11 Sep 2025 11:36:39 +0000

Achtung Baustelle. Anleitung noch im Aufbau

Installation auf einem Rechner mit Ubuntu (z.B.: Linux Mint)

Die Installation auf einem Rechner mit Linux ist einfach und je nach Internetleitung innerhalb von 15 - 60 Minuten erledigt.

Vorraussetzung

PC oder Laptop mit einem aktuellen Linuxsystem.
Die Anleitung hier verwendet einen alten Laptop mit Linux Mint 22.1 Cinnamon

Schritt 1: Die ARDUINO IDE auf dem Linuxrechner installieren

Im Prinzip erfolgt die Installation der ARDUINO IDE auf dem Linuxrechner ähnlich der Installation auf einem Windows PC. Da es einige kleine aber wichtige Unterschiede gibt, findest Du im folgenden die angepasste Anleitung:

Installation ARDUINO IDE

Los geht’s

Als Einstieg und zum Ausprobieren reichen

ein Arduino (Original oder preiswerter Clone)
ein paar WS2812 RGB-LEDs und
drei Kabel
ein Rechner / Laptop mit Linux Mint 22.1 Cinnamon 64-Bit (32-Bit hat keine Unterstützung für Python 3.9) - Für einen 32-Bit Rechner/Laptop muß die LDME-Version von Mint installiert werden https://linuxmint.com/download_lmde.php. Diese Version enthält python 3.11.

völlig aus. Der Arduino kann ein Uno, Nano oder alles, was die MLL unterstützt, sein.

Diese Anleitung gilt für eine Linux Umgebung mit einem installierten Linux Mint System.

Zunächst muss man die aktuelle Arduino Entwicklungsumgebung IDE (Integrated Development Environment) herunterladen und installieren. Der Arduino WEB-Editor oder die Arduino App können für die MobaLedLib nicht genutzt werden.

Die ARDUINO Download Seite erreicht man über den Link: https://www.arduino.cc/en/Main/Software

Es muß die Version 1.8.19 verwendet werden. ACHTUNG: Die 2.xx Version geht leider nicht.

Für den Rechner die passende Version LINUX 64 bits auswählen und anklicken.

Anschließend wird man aufgefordert, für das Arduino Projekt zu spenden. Es ist gut, wenn man das großartige Projekt auf diese Weise unterstützt. Das Programm kann aber problemlos auch ohne Spenden heruntergeladen werden. Das heruntergeladene Programm, hier „arduino-1.8.19-linux64.tar.gz“ findet man in dem „Downloads„-Ordner des Rechners.

Zur Installation wird das Programm entpackt. Ich habe es gleich im Downloads Ordner entpackt. Ist nicht optimal, aber funktioniert.

Auf den Dateinamen Rechts-klicken und „Extract Here“ auswählen.

Nach dem Entpacken in das entpackte Verzeichnis wechseln und die Datei install.sh doppelt anklicken. Es kann sein, dass die Datei nicht ausgeführt werden kann. Dann auf die Datei Rechts-klicken. Die Eigenschaften (properties) auswählen. Und bei „Execute“ „Anybody“ auswählen.

Das Installationsscript erzeugt ein Desktop Icon für die ARDUINO Benutzeroberfläche.

Schritt 2: Die MobaLedLib installieren

Die Installation der MobaLedLib über die ARDUINO IDE erfolgt genauso, wie bei der original MLL, wie es hier beschrieben ist:

Anleitung für den ersten Schnelleinstieg

Die ARDUINO IDE aufrufen durch Doppelklick auf das ARDUINO-Icon auf dem Desktop.

Nun den Arduino an einen freien USB-Port anschließen. Linux installiert nun bei erstmaliger Verbindung USB/Geräte-Treiber für den Arduino. Bei fehlerfreier Installation sollten Serielle Schnitstelle und Arduino, wie im folgenden Bild dargestellt, aufrufbar sein. Die Bezeichnung der Seriellen-Schnittstelle ist abhängt von der Belegung der Schnittstellen des Raspi mit anderen Geräten.

Für Einsteiger ist möglicherweise ein kleiner zusätzlicher Test interessant. Mehr dazu am Ende der Anleitung unter Test.

Überprüfung Sketch-Ordner

Damit alle Funktionen der MobaLedLib aufgerufen werden können, muss der Pfad zum Sketch-Ordner auf dem Standard-Pfad stehen.

/home/<user>/Arduino

Dies kann über das Menü innerhalb der Arduino IDE gemacht werden.

Zum Installieren der MLL in der ARDUINO IDE Tools - Manage Libraries aufrufen:

Es öffnet sich der Library Manager (der Start kann länger dauern, also Geduld …).

Im Filter MobaLedLib eingeben und warten …

Nach einiger Zeit erscheint die Beschreibung der MobaLedLib

Etwas nach unter scrollen, bis die „install“ Schaltfläche sichtbar ist und anklicken.

Es kommt die Frage ob die zusätzlichen Bibliotheken installiert werden sollen.

Diese Frage mit „Install all“ beantworten.

Jetzt ist die ARDUINO und MLL Installation beendet. Normalerweise wird jetzt mit dem Excel-Programm weiter gemacht. Da Excel unter Linux aber nicht läuft, benötigen wir jetzt die pyMobaLedlIb.

Schritt 3: PyMobaLedLib installieren

Den neuesten Release der PyMobaLedLib von GitHub https://github.com/haroldlinke/pyMobaLedLib/releases herunterladen.

Hier ist die neueste Version die 5.2.5-beta.

Auf Assets klicken um die zu dem Release gehörenden Dateien zu sehen.

Für Linux benötigen wir die Souce code Datei vom Typ tar.gz

Für den Download auf den Link klicken.

Die Datei wird ins Downloadsverzeichnis heruntergeladen.

Von dort die Datei in das ARDUINO-Daten Verzeichnis kopieren. Bei einer Standard-Installation der ARDUINO SW sollte dies das Verzeichnis: home/<user>/Arduino sein. Siehe Bild:

Die ZIP-Datei „hier entpacken“, so daß sich das Verzeichnis pyMobaLedLib-xxxx in dem ARDUINO-Verzeichnis befindet. Siehe Bild oben.

Dieses Verzeichnis muss in „pyMobaLedLib“ umbenannt werden.

Als nächstes muss eine virtuelle Umgebung eingerichtet werden. Dies erfolgt über folgende Befehle Diese virtuelle Umgebung verfügt über eine eigene Python3-Installation und unabhängigen Modulbibliothek. Dazu benötigt man das Tool venv.

Installation unter Mint:

sudo apt install python3-venv python3-pip

Achtung: Rootpasswort wird abgefragt.

Danach erstellen des virtuellen environments:

python3 -m venv ~/pyMLL-env

Die pyMobaledLib kann dann mit den Kommandos:

source ~/pyMLL-env/bin/activate

und

python3 /home/<user>/Arduino/pyMobaLedLib/python/pyMobaLedLib.py gestartet werden.

Schritt 4: Desktop Icon erstellen

Da dieser Aufruf doch etwas kompliziert ist, kann man auf dem Desktop ein Startskript anlegen.

Wenn Sie ein Desktop Icon zum Aufruf der pyMobaledLib haben möchten, müssen Sie folgendermaßen vorgehen:

Den Pfad der pyMobaLedLib (“/home/<user>/Arduino/pyMobaLedLib/„) öffnen.
hier die Datei „Start_pyMobaLedLib.sh“ auswählen und mit einem Rechtsklick das Menü öffnen und bei „Senden an“ „Schreibtisch (Verknüpfung erstellen)“ auswählen.
Nun ist auf dem Desktop ein Verknpüfung vorhanden.
Diese Verknüpfung kann mit einem Rechtsklick und „Öffnen mit Terminal“ gestartet werden.

Schritt 5: Berechtigungen zuweisen

Für den Zugriff auf die USB-Schnittstelle des Arduinos, benötigt der Benutzer noch die Rechte für die Nutzung.
Diese kann über das Terminal zugewiesen werden.

unten links auf das schwarze Symbol klicken
den Befehl sudo usermod -a -G dialout <BENUTZERNAME> eingeben. Dabei bitte wieder den Platzhalter <BENUTZERNAME> durch den korrekten Namen ersetzen.
Nun fragt das Fenster nach dem Kennwort für den Befehl.
Im Anschluss den Rechner neu starten, damit die Berechtigung korrekt geladen wird.

Schritt 6: Der erste Aufruf von pyMobaLedLib

Beim ersten Aufruf meldet sich das Programm mit einer fehlermeldung: Die ARDUINO Bilbilothek wurde nicht gefunden.

Das ist bei Linux normal, da es leider keine automatische Möglichkeit gibt, den Installationsort der ARDUINO IDE zu bestimmen. Diese Information müssen wir der pyMobaledLib von Hand mitteilen.

Zuerst diese Meldung mit „OK“ bestätigen.

Dannach kommt eine weitere Meldung, dass das Programm eine Verbindung zum ARDUINO aufbauen möchte.

Zu dieser Meldung sagen wir „Nein“.

Danach sehen wir die Startseite der pyMobaLedLib.

Die Seite mit den ARDUINO Einstellungen öffnen.

Auf den Button „Pfad zur ARDUINO IDE auswählen“ klicken.

Die ARDUINO IDE befindet sich in dem Ordner, in dem wir vorher die ARDUINO IDE-Datei entpackt haben. In unserem Fall /home/<user>/Downloads/arduino-1.8.19

Nicht vergessen, den Haken bei „Individuellen Pfad zur ARDUINO IDE verwenden“ zu setzen.

Am Besten die pyMobaLedLib jetzt neu starten.

Nach dem Start kann es sein, daß das Programm weitere Bibliotheken installieren möchte. Diese Frage mit „Ja“ beantworten.

Die Frage nach der Verbindung mit dem ARDUINO sollte wieder mit „Nein“ beantwortet werden, da das Programm unter Linux den Boardtyp nicht automatisch erkennen kann und dieser sehr wahrscheinlich falsch eingestellt ist. Wir müssen den Boardtyp von Hand einstellen.

Dazu den Programm Generator öffnen:

Auf den Button „Optionen“ klicken.

Es öffnet sich das Fenster mit dem man den Boardtyp festlegen kann.

Den Haken bei „Automatisch erkennen“ löschen und den Boardtyp einstellen. Beim nano gibt es verschiedene Typen:

neue offizielle Nanos haben meist den Typ Nano (New Version)
China Nachbauten den Typ Nano Normal (old Bootloader)

Sie können die verschiedenen Typen auch durch probieren und sehen ob es klappt.

Nach der Einstellung des Boardtyps, den Button „Detect USB Port“ anklicken:

Es erscheint der USB-Port Auswahl Dialog

Hier den Port auswählen, bei dem der Nano erkannt wird entweder mit einem Namen oder als USB Serial:

Mit OK bestätigen.

Es kommt wahrscheinlich die Meldung, dass kein ARDUINO erkannt wurde. Da die automatische Erkennung bei Linux meistens nicht funktioniert, diese Meldung mit „Nein“ ignorieren.

Dieselbe Meldung kommt auch beim Hochladen eines Programms zum ARDUINO. Diese dann auch ignorieren.

Sollte das Hochladen nicht klappen, liegt es meistens daran, dass der falsche Typ eingestellt wurde. Die obige Prozedur dann bitte wiederholen und den richtigen Typ einstellen.

Pattern Configurator aktivieren

Wenn die Pattern Configurator Seite nicht angezeigt wird, kann sie einfach durch eine Einstellung auf der „Einstellungen“ Seite aktiviert werden.

Bei der Option „Patterngenerator anzeigen muß ein Haken sein, damit die Pattern Configurator Seite angezeigt wird. Nach dem Setzen des Hakes, die Einstellungen speichern und pyMobaledLib neu starten.

macinstallation

anonymous@undisclosed.example.com (Anonymous) — Wed, 23 Apr 2025 07:37:51 +0000

Installation auf einem Mac

Die Installation auf einem Mac ist sehr ähnlich der Installation auf einem Raspi.

Hier ist eine Anleitung von Frank Becker: mll-mac_installation_v2.pdf

patternconfigurator

anonymous@undisclosed.example.com (Anonymous) — Tue, 15 Apr 2025 10:01:15 +0000

Python PatterConfigurator

in Arbeit …

programmgenerator

anonymous@undisclosed.example.com (Anonymous) — Sun, 30 Jun 2024 07:51:17 +0000

pyMobaLedLib - Der Programm Generator

Das folgende Bild zeigt einen Screenshot des ProgrammGenerators (Beispiel Raspi)

Der pyProgrammGenerator sieht genauso aus, wie der Excel ProgrammGenerator und wird auch genauso bedient. Es sind deshalb alle Anleitungen für den Excel Programmgenerator auch für den PyProgrammgenerator gültig:

Anleitung zum Programm-Generator

Zusätzliche Funktionen

Assistenten zur Erzeugung von individuellen Pattern

Der Pattern Configurator erlaubt die Erstellung von ausgefeilten individuellen Pattern zur LED und Servosteuerung. Durch seine Flexibilität benötigt der Pattern Configurator etwas Einarbeitung.

Um auch anderen Anwendern die Erstellung von individuellen Pattern zu erleichtern gibt es im PyProgrammGenerator Assistenten, die diese Pattern nach Eingabe von wenigen Daten erzeugen.

Folgende Assistenten stehen zur Verfügung:

Servo Animation
LED Farbverlauf Animation (noch nicht freigegeben)
LED Helligkeit Animation (noch nicht freigegeben)

Alle 3 Animations Assistenten haben einen ähnlichen Aufbau.

Auswahl der Assistenten

Die Assistenten werden genauso wie ein Macro, z.B. der HausMacro, im Macro Dialog ausgewählt:

Servo Animation

Die Beschreibung der Servo Animation findest Du hier: pyProgrammGenerator - Servo Animation

programmvorschau

anonymous@undisclosed.example.com (Anonymous) — Sun, 03 Jan 2021 15:05:32 +0000

pyProgramGenerator - Programm Vorschau

Das folgende Bild zeigt einen Screenshot der Programmvorschau Seite

Die Programmvorschau zeigt den erstellten Code für den ARDUINO an. (Nur für Experten)

raspberryinstallation

anonymous@undisclosed.example.com (Anonymous) — Mon, 06 Jan 2025 16:37:04 +0000

Installation auf einem Raspberry

ACHTUNG: Die Seite ist noch in ARBEIT - die Angaben hier beziehen sich auf ein alte Version

Die Installation der MobaLedLib auf einem Raspberry Pi wird folgendermassen durchgeführt:

Vorraussetzung

Raspberry Pi 3B, B+ oder 4 mit installiertem Rasbian. Ich empfehle die neueste Version zu installieren.

Schritt 1: Die ARDUINO IDE auf dem Raspberry Pi installieren

Im Prinzip erfolgt die Installation der ARDUINO IDE auf dem Raspberry ähnlich der Installation auf einem Windows PC. Da es einige kleine aber wichtige Unterschiede gibt, findest Du im folgenden die angepasste Anleitung:

Installation ARDUINO IDE

Los geht’s

Als Einstieg und zum Ausprobieren reichen

ein Arduino (Original oder preiswerter Clone)
ein paar WS2812 RGB-LEDs und
drei Kabel
ein Raspberry PI 3 B, B+, 4 oder 5

völlig aus. Der Arduino kann ein Uno, Nano oder alles, was die MLL unterstützt.

Diese Anleitung gilt für eine Raspberry Umgebung mit einem installierten Raspbian.

Die ARDUINO Download Seite erreicht man über den Link: https://www.arduino.cc/en/Main/Software

Es muß die Version 1.8.19 verwendet werden. ACHTUNG: Die 2.xx Version geht leider nicht.

Für den Raspberry Pi den LINUX ARM 32 Installer auswählwen und anklicken.

Anschließend wird man aufgefordert, für das Arduino Projekt zu spenden. Es ist gut, wenn man das großartige Projekt auf diese Weise unterstützt. Das Programm kann aber problemlos auch ohne Spenden heruntergeladen werden. Das heruntergeladene Programm, hier „arduino-1.8.19-linux.arm.tar.gz“ findet man in dem „Downloads„-Ordner des Raspberry.

Zur Installation wird das Programm entpackt. Ich habe es gleich im Downloads Ordner entpackt. Ist nicht optimal, aber funktioniert.

Auf den Dateinamen Rechts-klicken und „Extract Here“ auswählen.

Das Installationsscript erzeugt ein Desktop Icon für die ARDUINO Benutzeroberfläche.

Schritt 2: Die MobaLedLib installieren

Die Installation der MobaLedLib über die ARDUINO IDE erfolgt genauso, wie bei der original MLL, wie es hier beschrieben ist:

Anleitung für den ersten Schnelleinstieg

Die ARDUINO IDE aufrufen durch Doppelklick auf das ARDUINO-Icon auf dem Desktop.

Nun den Arduino an einen freien USB-Port anschließen. Der Raspi installiert nun bei erstmaliger Verbindung USB/Geräte-Treiber für den Arduino. Bei fehlerfreier Installation sollten Serielle Schnitstelle und Arduino, wie im folgenden Bild dargestellt, aufrufbar sein. Die Bezeichnung der Seriellen-Schnittstelle ist abhängt von der Belegung der Schnittstellen des Raspi mit anderen Geräten.

Für Einsteiger ist möglicherweise ein kleiner zusätzlicher Test interessant. Mehr dazu am Ende der Anleitung unter Test.

Überprüfung Sketch-Ordner

Damit alle Funktionen der MobaLedLib aufgerufen werden können, muss der Pfad zum Sketch-Ordner auf dem Standard-Pfad stehen.

/home/<user>/Arduino

Dies kann über das Menü innerhalb der Arduino IDE gemacht werden.

Zum Installieren der MLL in der ARDUINO IDE Tools - Manage Libraries aufrufen:

Es öffnet sich der Library Manager (der Start kann auf dem Raspi länger dauern, als Geduld …).

Im Filter MobaLedLib eingeben und warten …

Nach einiger Zeit erscheint die Beschreibung der MobaLedLib

Etwas nach unter scrollen, bis die „install“ Schaltfläche sichtbar ist und anklicken.

Es kommt die Frage ob die zusätzlichen Bibliotheken installiert werden sollen.

Diese Frage mit „Install all“ beantworten.

Jetzt ist die ARDUINO und MLL Installation. Normalerweise wird jetzt mit dem Excel-Programm weiter gemacht. Da Excel auf dem RASPI aber nicht läuft, benötigen wir jetzt die pyMobaLedlIb.

PyMobaLedLib installieren

Den neuesten Release der PyMobaLedLib von GitHub https://github.com/haroldlinke/pyMobaLedLib/releases herunterladen.

Hier ist die neueste Version die 5.2.5-beta.

Auf Assets klicken um die zu dem Release gehörenden Dateien zu sehen.

Für Linux benötigen wir die Souce code Datei vom Typ tar.gz

Für den Download auf den Link klicken.

Die Datei wird ins Downloadsverzeichnis heruntergeladen.

Von dort die Datei in das ARDUINO-Daten Verzeichnis kopieren. Bei einer Standard-Installation der ARDUINO SW sollte dies das Verzeichnis: home/<user>/Arduino sein. Siehe Bild:

Die ZIP-Datei „hier entpacken“, so daß sich das Verzeichnis pyMobaLedLib-xxxx in dem ARDUINO-Verzeichnis befindet. Siehe Bild oben.

Dieses Verzeichnis kann in „pyMobaLedLib“ umbenannt werden. Muß aber nicht, der Name ist beliebig

Die pyMobaledLib kann dann mit dem Kommando: Python3 /home/<user>/Arduino/pyMobaLedLib/python/pyMobaLedLib.py gestartet werden.

Desktop Icon erstellen

Da dieser Aufruf doch etwas kompliziert ist, kann man auf dem Desktop ein Icon installieren.

Wenn Sie ein Desktop Icon zum Aufruf der pyMobaledLib haben möchten, müssen Sie folgendermaßen vorgehen:

Erstellen Sie eine Textdatei mit folgendem Inhalt:

[Desktop Entry]

Type=Application

Name=pyMLL

GenericName=pyMll

Comment=Open-source electronics prototyping platform

Exec=python3 /home/<user>/Arduino/pyMobaLedLib/python/pyMobaLedLib.py

Icon=/home/<user>/Arduino/pyMobaLedLib/python/images/06_Michael_MLL.png

Terminal=false

Categories=Development;IDE;Electronics;

MimeType=text/x-arduino;

Keywords=embedded electronics;electronics;avr;microcontroller;

StartupWMClass=processing-app-Base

Name[en_US]=pyMll

Path=home/<user>/Arduino/pyMobaLedLib/python/

<user> muß durch Deinen usernamen ersetzt werden.

Diese Textdatei unter einem beliebigen Namen mit der Endung .desktop speichern Die Datei auf den Desktop ziehen.

Der erste Aufruf von pyMobaLedLib

Beim ersten Aufruf meldet sich das Programm mit einer fehlermeldung: Die ARDUINO Bilbilothek wurde nicht gefunden.

Das ist bei Linux normal, da es leider keine automatische Möglichkeit gibt, den Installationsort der ARDUINO IDE zu bestimmen. Diese Information müssen wir der pyMobaledLib von Hand mitteilen.

Zuerst diese Meldung mit „OK“ bestätigen.

Dannach kommt eine weitere Meldung, dass das Programm eine Verbindung zum ARDUINO aufbauen möchte.

Zu dieser Meldung sagen wir „Nein“.

Danach sehen wir die Startseite der pyMobaLedLib.

Die Seite mit den ARDUINO Einstellungen öffnen.

Auf den Button „Pfad zur ARDUINO IDE auswählen“ klicken.

Die ARDUINO IDE befindet sich in dem Ordner, in dem wir vorher die ARDUINO IDE-Datei entpackt haben. In unserem Fall /home/<user>/Downloads/arduino-1.8.19

Nicht vergessen, den Haken bei „Individuellen Pfad zur ARDUINO IDE verwenden“ zu setzen.

Am Besten die pyMobaLedLib jetzt neu starten.

Nach dem Start kannes sein, daß das Programm weitere Bibliotheken installieren möchte. Diese Frage mit „Ja“ beantworten.

Dazu den Programm Generator öffnen:

Auf den Button „Optionen“ klicken.

Es öffnet sich das Fenster mit dem man den Boardtyp festlegen kann.

Den Haken bei „Automatisch erkennen“ löschen und den Boardtyp einstellen. Beim nano gibt es verschiedene Typen:

neue offizielle Nanos haben meist den Typ Nano (New Version)
China Nachbauten den Typ Nano Normal (old Bootloader)

Sie können die verschiedenen Typen auch durch probieren und sehen ob es klappt.

Nach der Einstellung des Boardtyps, den Button „Detect USB Port“ anklicken:

Es erscheint der USB-Port Auswahl Dialog

Hier den Port auswählen, bei dem der Nano erkannt wird entweder mit einem Namen oder als USB Serial:

Mit OK bestätigen.

Es kommt wahrscheinlich die Meldung, dass kein ARDUINO erkannt wurde. Da die automatische Erkennung bei Linux meistens nicht funktioniert, diese Meldung mit „Nein“ ignorieren.

Dieselbe Meldung kommt auch beim Hocvhladen eines Programms zum ARDUINO. Diese dann auch ignorieren.

Sollte das Hochladen nicht klappen, liegt es meistens daran, dass der falsche Typ eingestellt wurde. Die obige Prozedur dann bitte wiederholen und den richtigen Typ einstellen.

Pattern Configurator aktivieren

Wenn die Pattern Configurator Seite nicht angezeigt wird, kann sie einfach durch eine Einstellung auf der „Einstellungen“ Seite aktiviert werden.

Desktop Icon

Wenn Sie ein Desktop Icon zum Aufruf der pyMobaledLib haben möchten, müssen Sie folgendermaßen vorgehen:

Erstellen Sie eine Textdatei mit folgendem Inhalt: <webcode name=„Default“ frameborder=0 width=100% scrolling=yes externalResources=“,“ renderingMode=story >

[Desktop Entry]

Type=Application

Name=pyMLL

GenericName=pyMll

Comment=Open-source electronics prototyping platform

Exec=python3 /home/<user>/Arduino/pyMobaLedLib/python/pyMobaLedLib.py

Icon=/home/<user>/Arduino/pyMobaLedLib/python/images/06_Michael_MLL.png

Terminal=false

Categories=Development;IDE;Electronics;

MimeType=text/x-arduino;

Keywords=embedded electronics;electronics;avr;microcontroller;

StartupWMClass=processing-app-Base

Name[en_US]=pyMll

Path=home/<user>/Arduino/pyMobaLedLib/python/

<user> muß durch Deinen usernamen ersetzt werden.

Diese Textdatei unter einem beliebigen Namen mit der Endung .desktop speichern Die Datei auf den Desktop ziehen.

serialmonitor

anonymous@undisclosed.example.com (Anonymous) — Sun, 03 Jan 2021 15:44:52 +0000

pyProgramGenerator - Serila Monitor

Der Serial Monitor protokolliert die Kommunikation des Programms mit dem ARDUINO. Dies ist mehr für die Fehlerbehebung gedacht und für Experten.

Das folgende Bild zeigt einen Screenshot des Serial Monitors

servo_animation

anonymous@undisclosed.example.com (Anonymous) — Sun, 30 Jun 2024 16:06:35 +0000

pyProgrammGenerator - Servo Animation

Der Servo-Animations Assistent ermöglicht die einfache Erstellung von komplexen Servo Animationen. Er ist Teil des pyProgrammGenerators.

Die Servo Animation arbietet am besten mit den Direct Mode Servos von Eckhard (Platine 511) zusammen, funktioniert aber auch mit den bisherigen Servos (Platine 510).

Details zu den Direct Mode Servos ist hier zu finden:

Direct-Mode-Servo

Auswahl der Servo Animation

Die Assistenten werden genauso wie ein Macro, z.B. der HausMacro, im Macro Dialog ausgewählt:

Servo Animation

Nach Auswahl des Macros Servo Animation erscheint folgendes Fenster:

Links sind die Eingabefelder zum Definieren von einfachen Bewegungskurven. Rechts wird die erstellte Kurve grafisch dargestellt nachdem man auf den Button „Update Grafik“ geklickt hat.

Der Assistent unterstützt den Direkt Mode Servo von Eckhart (Servo DM) und die normalen MLL-Servos (Servo1, Servo2 und Servo3)

Durch Eingabe der Ein- und Ausschaltparameter wird der Zeitablauf bestimmt. Es stehen 3 Kurven-Modi zur Verfügung: Linear, Beschleunigung und Individuell.

Die berechneten Kurven werden in der Grafik rechts angezeigt.

Achtung: Die Änderungen werden erst nach Betätigung des Tasters „Update Grafik“ in die Grafik übernommen

Bei der Einstellung Individuell können die Kurvenwerte (Grüne Punkte) einzeln eingestellt werden.

Wurde unter Servo-Adresse die Adresse des Servos angegeben, kann die Servostellung direkt überprüft werden.

Beim Ausführen kann man wählen zwischen:

Wiederholen: die Ein-und Ausschaltsequenz wird automatisch wiederholt,
PingPong: die Sequenz wird vor- und zurück abgespielt,
Ein/Aus: Bei Schalter auf EIN wird die Einschaltsequenz, bei Schalter auf AUS, wird die Auschaltsequenz abgespielt.

Ein Beispiel für eine individuelle Sequenz zeigt das folgende Bild. Die Sequenz simuliert einen umstürzenden Baum, der beim ersten Schlag sich etwas bewegt und dann mit einer Beschleunigungskurve umfällt, um dann noch mal kurz hoch zu springen.

Das Ergebnis in der ProgrammGenerator Tabelle sieht dann so aus:

individuelle Sequenzen erstellen

Zum Erstellen von individuellen Sequenzen gibt es 2 Einstellungen:

1. individuelle Kurvenparameter

Wenn der Kurvenparametertypauf „Individuell“ gestellt wurde, kann man die Werte für jeden Kurvenpunkt mit der Maus ändern. Es ist nicht möglich, die Zeitpunkte zu ändern.

2. Individuelle Zeitstufen Wenn der Zeitstufenparametertypauf „Individuell“ gestellt wurde, kann man die Werte und die Zeitpunkte für jeden Kurvenpunkt mit der Maus ändern.

Es ist auch möglich Punkte zu löschen und neue Punkte einzufügen (ab Version 5.3.1D)

Bedienung der Kurvenverlaufgrafik

Bewegung der Punkte:

Punkte können mit der Maus angeklickt und mit gedrückter linker Maustaste bewegt werden. Die aktuellen Werte für die Zeit und die Servostufe, werden unten links unter der Grafik angezeigt.

Zusätzlich zur Maus können Punkte nachdem sie mit der Maus angeklickt wurden auch mit den Cursortasten bewegt werden.

Für die Zeit ist das Raster auf 20ms gesetzt.

Punkte löschen, bzw neu erstellen

Nachdem ein Punkt mit der Maus angeklickt wurde, kann er mit der „Entf“-Taste gelöscht werden.

Nachdem ein Punkt mit der Maus angeklickt wurde, kann er mit der „Einfg“-Taste ein neuer Punkt rechts von dem angeklickten Punkt erzeugt werden. Der neue Punkt wird in der Mitte zwischen dem angeklickten Punkt und dem nächsten Punkt erzeugt.

Zoom

Mit Ctrl-Mausrad und Ctrl-Pfeil-auf/ab kann in die Grafik gezoomt werden.

Mit Shift-Linke-Maustaste und Shift-Pfeiltasten kann das Fenster verschoben werden.

Durch klick auf „Update Grafik“ wird der Zoom Faktor 100% wieder hergestellt.

Gesamtzeit ändern

Ist der Zeitstufenparametertyp auf „Individuell“ eingestellt, kann die Gesamtzeit für die Einschalt- und die Ausschaltphase durch Ändern der Einschalt- bzw. Ausschaltparameter geändert werden. Maßgeblich ist jeweils die gesamte Zeit aus Startpause, Dauer und Endepause. Wird „Update Grafik“ betätigt, werden alle Punkte entsprechend proportional an die neue Gesamtzeit angepasst.

Einige Tips

Es empfiehlt sich mit einer linearen oder Beschleunigungskurve und einem festen Zeitraster zu starten und die Zeitparameter entsprechend zu setzen.
Erst wenn diese einfachen Kurven funktionieren, sollte man zu den individuellen Einstellungen gehen um die Bewegung zu optimieren und z.B. ein Nachwippen zu erzeugen.
Das Zeitraster nicht zu klein wählen. Jeder Kurvenpunkt kostet Speicher im ARDUINO und Zeit beim Erstellen des Programms.
Das Programm erzeugt einen Patternmacro. Dieser Macro enthält die Abstände zwischen den Zeitpunkte und alle Werte zu einem Zeitpunkt. Wenn alle Zeitpunkte denselben Abstand haben, wird nur ein Zeitwert benötigt. Alle folgenden haben dann denselben Abstand. Dadurch kann man die Anzahl der Zeitwerte reduzieren, in dem man am Ende möglichst viele gleiche Abstände zwischen den Zeitpunkten verwendet.

Bekannte Probleme

Beim Neustart des ARDUINO, z.B. beim Einschalten und nach Neuverbinden mit dem PC, wird die letzte Sequenz nochmal ausgeführt. Dies führt dazu, daß der Sero, wenn die letzte Sequenz z.B. Torschießen war, erst einmal das Tor mit voller Geschwindigkeit öffnet und dann entsprechend der Animation wieder schließt. Wir arbeiten daran, diesen Effekt zu verhindern.

Deshalb vorsichtig sein mit empfindlichen Modellen.

Außerdem ist es sinnvoll eine Federung zwischen Servo und Modell einzubauen, falls der Servo mal die programmierte Endlage überschreitet.

servo2_seite

anonymous@undisclosed.example.com (Anonymous) — Thu, 06 Feb 2025 12:34:59 +0000

Direct Mode Servo

1.Tutorials

Tutorial: Legacy Mode , 3-Positionen-Makro Servo3 mit DM-Servos anwenden
Tutorial: Endposition einstellen
Tutorial: Mehrere Attinys hintereinander abgleichen

2. Die Servo2 Test- und Einstellseite

In pyMobaLedLib die Seite „Servo Test 2“ öffnen.

Auf der Seite gibt es folgende Parameter:

Servo Modul Adresse
Servo Control Betriebsart („Normal Position“, „Training End Pos“, „Training End Pos (special)“, „Einstellen Max Geschwindigkeit“, „Reset Servo“)
Use fast Refresh – für Experten, schnellere Reaktion auf Schieberänderungen
Servo Position-Schieber
Enter-Taster
Pos 0 – Taste – stellt den Schieber auf 1 (0 geht im Legacy Mode nicht)
Pos255-Taste – stellt den Schieber auf 255
Servo Programmieren-Taster
Attiny Direkt Programmieren (nur zum Testen für Experten)

2.1 Servo Modul Adresse

Adresse des Servo Moduls, das eingestellt werden soll - bis jetzt können leider noch keine LED-Strang-Kanäle angesprochen werden.

Achtung Bei der modifizierten Platine belegt jeder Servo eine RGB-Adresse. (Bei der originalen Platine hatte das gesamte Modul eine RGB-LED Adresse und die Servos wurden durch die R-G-B Farbkanäle angesprochen). Die Adressen bei der modifizierten Platine sind fortlaufend. D.h. wenn die erste Servo-Adresse 5 ist, dann haben die beiden anderen Servos die Adresse 6 und 7. Diese Adresse muß bei der Endlageneinstellung und in der Servo-Animation angegeben werden, damit der richtige Servo angesprochen wird.

Das mit den Kanälen ist leider etwas mißverständlich: Es gibt z.B. bei der ESP32-Platine 8 Kanäle für 8 LED Stränge. Und es gibt bei den Servo-Platinen Servo-Kanäle für die 3 Servos

2.2. Servo Control Betriebsart

Bestimmt die aktuelle Betriebsart:

„Normal Position“,
„Training End Pos“,
„Training End Pos (special for Experts only)“,
„Einstellen Max Geschwindigkeit“,
„Toggle Invers“, Drehrichtung ändern
„Reset Servo“, aktuellen Servo zurücksetzen
„Factory Reset“, Attiny (alle Servos) in Grundzustand bringen
„Reset last mem pos“, Speicherung der letzten Position löschen
„Tune Clock“, mehrere Attinys hintereinander abgleichen
„Einstellen Legacy Speed“, DM-Servo kompatibel zu „Alt“-Servos machen

2.2.1 "Normal Position"

In dieser Betriebsart kann der Servo direkt über den Sero Positionsschieber gesteuert werden. Der Servo folgt dem Schieber direkt.

Achtung: Direkt nach dem Flashen des Attiny85 und im Normalmodus bewegt sich der Servo mit dem Schieberegler von 0 bis 255 nur etwa 30°. Die 30 Grad default sind eine Sicherheitsfunktion, damit man sich nicht gleich seine Mechanik beschädigt. Im Trainingsmodus kann der gesamte Bereich angefahren werden.

2.2.2"Training End Pos"

In dieser Betriebsart werden die Endlagen eingestellt.

- Eine Schieberposition zwischen den aktuellen Endlagen suchen (siehe Achtungshinweis unten) - Mit dem Schieber aus dieser Position langsam in die eine Endlage fahren - Enter-Taste drücken - Mit dem Schieber in die andere Endlage fahren - Enter-Taste drücken - Fertig

In Normal_Betriebsart, die Endlagen testen

Achtung: In der Trainingsbetriebsart kann jede Servo Position angefahren werden. Also auch Positionen, die für die Mechanik gefährlich sein können!! Der Attiny hat eine Sicherheitsfunktion. Da das Trainingstool nicht wissen kann, wo die aktuellen Endlagen des angeschlosenen Attinys sich befinden, muß der Schieber erst in eine Position zwischen den aktuellen Endlagen gebracht werden. Man bewegt also am besten den Schieber von der 0 Stellung aus langsam nach rechts, bis der Servo dem Schieber folgt. Ab jetzt kann man jede beliebige Endstellung anfahren und programmieren.

Siehe auch: Direct Mode Servo - Einstellung der Endlagen

2.2.3 "Training End Pos (special)"

In dieser Betriebsart werden die Endlagen in einem erweiterten Bereich eingestellt.

- Mit dem Schieber aus der Mittelposition langsam in die eine Endlage fahren - Enter-Taste drücken - Mit dem Schieber in die andere Endlage fahren - Enter-Taste drücken - Fertig

In Normal_Betriebsart, die Endlagen testen

Wenn du den Servo im Normalbereich mit den Endlagen trainierst, dann entspricht der Bereich von 0 bis 255 den PWM Werten von 1ms bis 2ms. Wenn du das selbe mit der Einstellung (spezial) tust, dann umfassen die Werte 0 bis 255 die PWM Werte von 0,5ms bis 2,5ms.

Achtung: In der Trainingsbetriebsart kann jede Servo Position angefahren werden. Also auch Positionen, die für die Mechanik gefährlich sein können!! Der Attiny hat eine Sicherheitsfunktion. Da das Trainingstool nicht wissen kann, wo die aktuellen Endlagen des angeschlosenen Attinys sich befinden, muß der Schieber erst in eine Position zwischen den aktuellen Endlagen gebracht werden. Man bewegt also am besten den Schiber von der 0 Stellung aus langsam nach rechts, bis der Servo dem Schieber folgt. Ab jetzt kann man jede beliebige Endstellung anfahren und programmieren.

2.2.4 "Einstellen Max Geschwindigkeit"

In dieser Betriebsart kann die „Höchstgeschwindigkeit“ eingestellt werden.

Hierzu eine kleine Erklärung, was ihr dort als „Höchstgeschwindigkeit“ einstellen könnt und wie dieser Wert wirkt. (die wirklich wirksame Geschwindigkeit macht die Servo Animation, bzw. die MLL-Hauptplatine!)

Einstellbar sind, als maximale Begrenzung, auch wieder die Werte von 0 bis 255

- Bei 0 (Null) ist die Begrenzung abgeschaltet. - Die Werte von 1 bis 255 stellen die maximal zulässige Schrittweite der Stellwerte (die gehen auch von 0 bis 255) [b]PRO ÜBERTRAGUNG[/b] von der Hauptplatine dar! - Wenn ich z.B. 10 einstelle, dann dürfen die Stellwerte immer nur 10 Stellwertpunkte pro Übertragung weiter springen, sonst werden sie begrenzt - Bei 20ms Übertragungstakt (also 50 Stellwerte pro Sekunde) kann ich damit z.B. die Gesamtstrecke des gesamten Stellwegs in einer halben Sekunde zurücklegen „1 / ( 50 / (255 / 10)) = ~0,5-Sek“ - Die maximale Begrenzung wäre der Wert 1, mit dem es 5 Sekunden dauert, bis der Stellweg zurückgelegt ist.„ 1 / ( 50 / (255 / 1)) = ~5-Sek“

Aber !!!ACHTUNG!!! Dieser Wert ist nur als Obergrenze gedacht (um mechanische Beschädigungen zu vermeiden) Wenn man zu stark begrenzt, dann werden die Werte von Harolds pyPG bzw. der Hauptplatine nicht mehr schnell genug ausgeführt sondern merkwürdig aussehend gedämpft.

PS: Der Wert 255 würde wirken, wie mit 0 abgeschaltet, da ja dann der Sprung von 255 Werten, als von Stellwert 0 zu Stellwert 255 ad hoc erlaubt ist.

2.2.5 "Reset Servo"

Der Servo wird wieder auf die Startwerte zurückgesetzt

2.2.6 "Toogle Invers"

Dreht die Drehrichtug des Servos um,

2.2.7 "Factory reset"

Der komplette Attiny wird zurück gesetzt,

2.2.8 "Reset last mem pos"

Um das schnelle ruckartige Bewegen des Servos zu reduzieren, speichert der Attiny die letzte Position des Servos. Wenn der Attiny wieder Strom bekommt, muß erst ein Stellwert mit dieser Position beim Attiny ankommen, bevor er den Servo bewegt. In bestimmten Fällen kann das zu einer Blockade führen, deshalb kann man mit diesem Befehl, den Speicher löschen.

2.2.9 "Tune Clock"

Der auf den MLL Platinen verwendete ATTiny85 Microcontroller wird ohne eigenen Quarz verwendet. Leider ist die Taktgenauigkeit dieser Lösung nicht sehr hoch. Das kann dazu führen, daß das ausgegebene Datensignal nicht ganz genau ist. Es liegt noch innerhalb der Spezifikation, so daß eine nachfolgende WS2012 oder WS2811 das Signal richtig verarbeitet. Folgt auf einen Attiny aber direkt ein weiterer Attiny, so besteht die Möglichkeit, sich die Ungenauigkeiten der beiden Attinys addieren und der zweite Attiny das Datensignal des ersten nicht mehr sauber erkennt. Mit der „Tune Clock“-Funktion kann ein Abgleich zwischen den Attinys erfolgen. Für Details bitte das Tutorial Direct Mode Servo - Mehrere Attinys hintereinander abgleichen anschauen.

2.2.10 "Einstellen Legacy Speed"

Die DM-Servos folgen sehr schnell jeder Einstellwertänderung. Dadurch sind Bewegungen, wie Nachwippen möglich. Mit Hilfe des Servo-Animations-Makros können diese Bewegungen erstellt werden.

Für einfache Bewegungen mit 2 bis 5 Positionen gibt es die Makros Servo2, Servo3, Servo4 und Servo5.

Mit der Funktion „Legacy Speed einstellen“ können diese Makros jetzt auch mit den DM-Servos verwendet werden. Damit können die DM-Servos mit der Platine 511 die bisherige Servo-Platine 510 ersetzen.

Details sind im Tutorial Direct Mode Servo - Einstellung Legacy Speed zu finden.

2.3. Servo Position-Schieber

Der Servo-Positionsschieber erlaubt die direkte Steuerung des Servos. Es werde direkt die eingestellten Werte an den Servo gesendet.

2.4. Enter-Taste

Mit der Enter-Taste werden Endlagen bestätigt

2.5. Servo Programmieren-Taste

Mit der Servo Programmieren Taste, wird ein Dialog zum Programmieren der Firmware des Attinys aufgerufen. Es öffnmet sich das „Optionen“-Fenster des Patterconfigurators für den „Servo2“. Durch Drücken von „Prog Servo2“ wird ein Auswahldialog aufgerufen, in dem man die Firmware-Datei (.hex) auswählen kann. Wenn die Firmware einen fertigen Stand erreicht hat, wird diser Dialog entfernt und die Programmierung startet direkt.

2.6. Attiny direkt Programmieren

Dies ist eine Funktion, die noch im Test ist, und erst später freigegeben wird

3. Hinweise aus der Diskussion

Hier sind einige Hinweise aus der Diskussion im Forum zusammengefasst:

- Genau genommen ist der Bereich von 0 bis 255, beim Direct Mode Servo, eine Art „Zahlenwerte Matroschka“! (die russische „Puppe in der Puppe“) Wenn du den Servo im Normalbereich mit den Endlagen trainierst, dann entspricht der Bereich von 0 bis 255 den PWM Werten von 1ms bis 2ms. Wenn du das selbe mit der Einstellung (spezial) tust, dann umfassen die Werte 0 bis 255 die PWM Werte von 0,5ms bis 2,5ms. Doch egal, welche Millisekunden Werte du für die Endlagen festlegst, der gewählte Bereich hat vom Python Programm Generator aus wieder den Bereich von 0 bis 255. Das wäre auch dann der Fall, wenn der Bereich zwischen den gewählten Endlagen sehr schmal ist. Damit erhält man in dem schmalen Bereich eine sehr hohe Genauigkeit!

- Ein DM Servo belegt den Adressraum einer RGB LED mit drei Mal 8 Bit bzw. Werten von 0..255! Im ersten Kanal kommt eine Steuerinformation und eine CRC Prüfsumme, im zweiten Kanal ein Stellwert von 0.255 und der dritte Kanal ist bei der Std. MLL derzeit nicht genutzt. Außerdem hat die Std. MLL die ersten beiden Kanäle technisch vertauscht. - Nach meinen Messungen und meiner Erfahrung haben SG90 Servos, bei der Servo Norm-PWM von 1-2ms, nur 90 Grad Stellwinkel! Die 170 Grad Aussage kommt dadurch zustande, dass fast alle eben nicht 1-2ms PWMs machen, sondern mehr! Das gibt es beim DM Servo auch und heißt „Training Pos Mode (spezial)“ Warnung: (gerade auch sehr kraftvolle) Servos können sich, wenn sie an den mechanischen Anschlag gefahren werden, selbst beschädigen!

- Wenn der Attiny direkt an einem ARDUINO angeschlossen ist, verhält er sich komisch.

Antwort: Eine direkte Verbindung Attiny zum ARDUINO ist nicht zu empfehlen. Es sollte immer ein WS2811 oder WS2812 dazwischen liegen. Tatsächlich haben die Tinys hinter einer echten physikalischen WS2811 oder WS2812B LED eine ganz passable Reichweite! Die nächste WS2811, hinter dem Tiny, kann auch ganz ordentlich weg sein (z.B. 70cm kein Problem), aber ATMega238 auf ATTiny85 ist irgendwie seltsam. Es wundert mich ein wenig, denn ATTiny auf ATTiny, also zwei meiner Direct Mode Servo Platinen, vertragen durchaus einen halben Meter zwischeneinander!

servortest

anonymous@undisclosed.example.com (Anonymous) — Sun, 03 Jan 2021 15:36:30 +0000

pyProgramGenerator - Servotest und Programmierung

Mit der Servoplatine von Hardi können über die MLL auch Servos angesteuert werden. Auf dieser Seite können Sie den Servo testen und konfigurieren.

Das folgende Bild zeigt einen Screenshot der Servotest Seite

Eingabefelder

Servo-Adresse: „LED“-Nummer des Servos. z.B. 5, wenn der Servo in der LED-Kette an 5. Stelle steht.
Servo-Anschluss: Die Servo-Platine kann 3 Servos aneteuern. Servo-Anschluss ist die Nummer des Anschlusses, an den der Servo angeschlossen ist (0, 1 oder 2)
Servo-Stop: Beim Anklicken wird der Servo angehalten, egal wo er gerade steht. Kann Zerstörungen verhindern, wenn der Servoarnm zu weit läuft.
Schieberegler: Mit dem Schieberegler kann die Position des Servos direkt eingestellt werden. (Position des Servos 10..220).

Anklicken zum Aktivieren der Tasten:

[Pfeil Rechts]/[Pfeil Links]:einfacher Schritt
[CTRL-Rechts]/[CTRL-Links]: 20er Schritt
[Pos1]/[Ende]: Anfang/Ende

Klicken auf dem Sliderfeld:

<Linke Taste>: single step vorwärts/rückwärts in Richtung der Maus
<Rechte Taste>:spring zum angeklickten Wert
<CTRL Linke Taste>\n - springe zum Anfang/Ende

Programmierung der Min/Max Position und Geschwindigkeit des Servos

Über die Servotester Seite lassen sich die Endpositionen und die Geschwindigkeit des servos bequem einstellen. Der Ablauf ist folgendermaßen:

Zum Start der Programmierung auf die Taste „Starte Min-Max Pos/Speed programmieren“ klicken
Programmiering der Minimal Position startet.
Der Servo muss jetzt mit den Tasten Dec«, Dec<, Inc> , Inc» an die gewünschte Min Position gefahren werden
Ist die gewünschte Min Position erreicht, auf den Taster „Gehe zu Max Pos programmieren“ klicken
Der Servo muss jetzt mit den Tasten Dec«, Dec<, Inc> , Inc» an die gewünschte Max Position gefahren werden
Ist die gewünschte Max Position erreicht, auf den Taster „Beende Max Pos programmieren“ klicken
Die Programmierung der Endstellungen ist nur beended, es folgt nun die Geschwindigkeitseinstellung
Mit den Tastern Dec«, Dec<, Inc> , Inc» kann die gewünschte Geschwindigkeit eingestellt werden. Der Servoarm bewegt sich dazu mit der eingestellten Geschwindigkeit zwisch Min- und Max Pos hin- und her.
Ist die gewünschte Geschwindigkeit eingestellt, auf „beende Speed programmieren“ klicken. Die eingestelleten Werte werden jetzt im Servo-Modul gespeichert.

Man kann jederzeit durch klicken auf „Beende Programmierung ohne Speichern“ den Programmiervorgang abbrechen.

soundtest

anonymous@undisclosed.example.com (Anonymous) — Sun, 03 Jan 2021 15:07:52 +0000

pyProgramGenerator - Soundtest

Die Soundtest-Seite unterstützt das Testen von Soundmodulen, die an die MLL angeschlossen sind.

Die MLL-Soundplatine mit dem <MP3-TF-16> Modul ermöglicht die Erzeugung von verschiedenen selbst erzeugten Geräuschen. Leider kommt es immer wieder vor, dass die wiedergegebenen Sounds nicht richtig stimmen. Es kommt nicht immer die gewünschte Sound Datei. Das liegt an Bauteiletoleranzen. Auf der Soundtest Seite können die Werte für die verschiedenen Geräusche ausprobiert werden. Einfach die Soundmoduladresse angeben und in den Felder R/G/B die verschiedenen Werte durchprobieren, bis der richtige Sound kommt.

Das folgende Bild zeigt einen Screenshot der Soundtest Seite

stellwerk

anonymous@undisclosed.example.com (Anonymous) — Thu, 03 Apr 2025 16:59:58 +0000

pyProgramGenerator - Stellwerk

tutorial_endpos

anonymous@undisclosed.example.com (Anonymous) — Thu, 06 Feb 2025 13:44:58 +0000

Direct Mode Servo - Einstellung der Endlagen

Video

Der Einstellvorgang

Der Einstellvorgang läuft folgendermaßen ab:

Die Adresse des Servomoduls einstellen
Servo Control Betriebsart „Normal Position“
Die Servo Position in die Mitte stellen.
Die Servo Control Betriebsart auf: „Training End Pos“ einstellen
Eine Schieberposition zwischen den aktuellen Endlagen suchen (siehe Achtungshinweis unten)
Mit dem Schieber aus dieser Position langsam zur gewünschten Endposition fahren. Der Servo sollte dieser Bewegung folgen.
Wenn die erste Endposition erreicht ist, „Enter drücken“
zur zweiten Endposition fahren.
Nochmal „Enter“ drücken
Betriebsart wieder auf „Normal“ stellen.

Wichtige Hinweise

Achtung: In der Trainingsbetriebsart kann jede Servo Position angefahren werden. Also auch Positionen, die für die Mechanik gefährlich sein können!! Der Attiny hat eine Sicherheitsfunktion. Da das Trainingstool nicht wissen kann, wo die aktuellen Endlagen des angeschlosenen Attinys sich befinden, muß der Schieber erst in eine Position zwischen den aktuellen Endlagen gebracht werden. Man bewegt also am besten den Schiber von der 0 Stellung aus langsam nach rechts, bis der Servo dem Schieber folgt. Ab jetzt kann man jede beliebige Endstellung anfahren und programmieren.

Achtung: Wenn du den Servo im Normalbereich mit den Endlagen trainierst, dann entspricht der Bereich von 0 bis 255 den PWM Werten von 1ms bis 2ms. Wenn du das selbe mit der Einstellung (Training End Pos spezial) tust, dann umfassen die Werte 0 bis 255 die PWM Werte von 0,5ms bis 2,5ms. Damit ist ein größerer Stellumfang möglich. Es kann aber sein, daß nicht alle Servos diese unterstützen. Wenn der Einstellbereich mit den Endlagen bei „Training End Pos“ nicht ausreicht, kann man „Training End Pos spezial“ ausprobieren.

tutorial_legacyspeed

anonymous@undisclosed.example.com (Anonymous) — Thu, 06 Feb 2025 12:24:28 +0000

Direct Mode Servo - Einstellung Legacy Mode

1. Einleitung

Mit dem Einstellen der „Legacy Speed“ wird der sogenannte „Legacy Mode“ (Altlasten-Mode) eingestellt. Mit dieser Einstellung kann der DM-Servo das Verhalten der Servos der bisherigen Servo-Platine 510 simulieren. Damit können die bisherigen Servo-Macros Servo2- Servo5 auch mit den DM-Servos verwendet werden.

Diese Funktion MUSS als letzte Einstellung durchgeführt werden.

2. Tutorial Video

3. Einstellung Schritt für Schritt

Zuerst müssen die Endlagen, eingestellt werden. siehe Direct Mode Servo - Einstellung der Endlagen
Zum Schluß „Einstellen Legacy Speed“ als Bewtriebsart auswählen
mit dem Schieber die gewünschte Geschwindigkeit einstellen
„Enter“ betätigen.
Die Betriebsart wechselt dann automatisch zu „Normal“ zurück.
Geschwindigkeit mit dem Pos0 und Pos255 Taster testen. Der Servo läuft jetzt langsam hin- und her.
Den Vorgang wiederholen, bis die Geschwindigkeit stimmt.

4. DM-Servo mit Servo3 Macro benutzen

Nachdem die Legacy Speed eingestellt wurde, verhält sich der DM-Servo genauso, wie ein Servo an der Platine 510.

Der Servo kann mit den Macros Servo2 – Servo5 gesteuert werden.

4.1 Beispiel DM-Servo mit 3 Positionen

beim DM-Servo, wie oben beschrieben,die „Legacy Speed“ einstellen
in den ProgrammGenerator wechseln
Macrozeile definieren, als Macro den Servo3 Makro aus Dynamik → Servo → Servo mit 3 Positionen auswählen
Im Parametereingabefenster den LED-Kanal auf ROT stellen.
Die gewünschten Positionen eingeben. Der DM-Servo kann Positionen von 1 bis 255 einnehmen. (Bisher 10 bis 210).
Mit OK-Abspeichern. Das Programm beschwert sich, wenn die Positionen < 10 und > 210 sind. Aber es funktioniert trotzdem.
Mit den Testbutons die Positionen testen.

4.2 ACHTUNG

Beim LED-Kanal muß IMMER „Rot“ ausgewählt werden. Der Servo wird durch die Servo-Adresse bestimmt.

Bei der Platine 510 konnten 3 Servos angeschlossen werden Die 3 Servos hatten dieselbe LED Adresse und wurden durch die LED-Kanäle Rot, Grün, Blau unterschieden.

Bei den DM-Servos hat JEDER Servo eine eigene LED-Adresse die fortlaufend bei der Adresse des ersten Servos beginnt.

Beispiel:

Bisher: Platine 510 ist an Servoadresse 5

Servo1: 5-rot
Servo2: 5-grün
Servo3: 5-blau

Bei DM-Servo in legacy mode:

Servo1: 5-rot
Servo2: 6-rot
Servo3: 7-rot

Im Unterschied zur 510 Platine kann der Bereich von 1 bis 255 genutzt werden (obwohl das Programm meckert, daß das nicht geht)

5. Hintergrund

Der Legacy Speed ist, wie in der alten 510er Lösung, in einer maximalen Veraenderung von 1/8 us (Mikrosekunde) pro 20ms definiert.

BEISPIEL: Ein mittlerer Wert von 128 ergibt eine Laufzeit von Stellung 0 (1ms) zu 255 (2ms) „8000 1/8us / 50 / 128“ = 1.25 Sec.

FULL-LEGACY: Ist ein Legacy-Speed programmiert, sowie die Endlagen eingestellt, kann das Servo alleine durch Stellwerte im Bereich von 1..255 im zweiten Farbkanal bewegt werden. Der erste und der letzte Farbkanal muessen hierbei 0 sein!

ACHTUNG!: Auch die maximale Geschwindigkeit von 255 ist vergleichsweise LANGSAM und fuer schnelle Animationen, wie z.B. Nachschwingen, NICHT geeignet! Hier ist „max speed“, definiert in Schrittweite, als Limit gegen Zerstörung, zu verwenden!

tutorial_tuneclock

anonymous@undisclosed.example.com (Anonymous) — Thu, 06 Feb 2025 12:12:09 +0000

Direct Mode Servo - Mehrere Attinys hintereinander abgleichen

1. Tutorial Video

2. Hintergrund

Der auf den MLL Platinen verwendete ATTiny85 Microcontroller wird ohne eigenen Quarz verwendet, da dieser zwei Pins brauchen würde, sowie Platinenfläche und zusätzliche Lötungen und zudem Kosten verursacht. Der verwendete Betriebsmodus hierfür ist „PLL mit chip-internem Oszillator und 16 MHz“. Leider ist die Taktgenauigkeit dieser Lösung nicht sehr hoch und man kann exemplarabhängig Frequenzen zwischen 15,5 und 17,5 MHz messen.

Atmel/Microchip gibt auch Prozeduren zum Trimmen der Taktfrequenz ohne Quarz an, die allerdings entweder einen Atmel Progger mit Kalibriereigenschaften, wie z.B. den Atmel AVRICE, oder einen genauen Frequenzzähler, oder ein Qszilloskop erfordern.

Da das alles für die MLL zu aufwendig ist, wurde ein manuelles (*) Ersatzverfahren entwickelt, dass hier im Weiteren beschrieben werden soll. Hilfreich ist in jedem Fall auch das verlinkte Youtube Video: https://www.youtube.com/watch?v=cKx1rNHql40

(*) „manuell“ heißt, dass DU! ;) arbeiten musst, um es klein und preisgünstig zu bekommen!

3. Vorbereitungen

3.1 Man benötigt an Hardware

- Eine Hauptplatine 101 (Nano) oder 102 (ESP32) - Eine Verteilerplatine z.B. 200 - Zwei oder mehr DM-Servo Platinen 511 (die von Michael/raily74), oder alternativ umgebaute 510 (Anleitung im Wiki) - Eine RGB-LED Kette als finale Heartbeat LED und nachfolgende „Null-Value Detektor LEDs“ Bei Verwendung einer Hauptplatine 102, zusammen mit Heartbeat-Breakout-Boards der ersten Serien (mit Spannungs-Reduktions-Diode) benötigt man eine zusätzliche Heartbeat LED vor der ersten 511 DM-Servo Platine!

3.2 Zu installierende Software

Benötigt wird weiterhin eine aktuelle Version des MLL Python Programm Generators von Harold Linke. (Version > 5.3.5e)

3.3 Programmieren der ATTiny85

Mit dem aktuellen pyPG wird, unter Zuhilfenahme des 400er Tina Proggers (oder eines anderen geeigneten Programmierwerkzeugs), ein Firmware-Code auf den Tiny geschrieben, der die „Tune Clock“ Fähigkeit besitzt. (steht im pyPG zur Verfügung!)

4. Aufbau

4.1 Hardware

Man schließt zuerst den Verteiler an die Hauptplatine an. Wenn man eine 102 mit Dioden hat, folgt als erstes eine weitere Heartbeat RGB LED. Dann kommen zwei, oder mehr 511 DM-Servo Platinen mit programmiertem DM-Servo ATTiny85 und auf der finalen 511 gesetztem Terminator. Zuletzt kommt auf den Verteiler ein RGB LED Streifen mit mindestens 10 RGB LEDs.

4.2 Software

Im pyPG erzeugt man ein neues Blatt genau für diesen Kalibrierungs-Aufbau. Dieses Blatt sollte folgende Einträge enthalten - Eine Heartbeat LED auf der Hauptplatine - Bei einer 102 mit Diode(n) eine weitere Heartbeat LED auf dem ersten Platz des Verteilers - Pro 511 DM-Servo Platine 3 Servo Beispiel-Animationen die mit DCC Adressen, oder Buttons zu Testzwecken eingeschaltet werden können. Das sind 6 Animationen bei zwei zu trimmenden 511 Platinen, oder 9 Animationen bei drei 511 Platinen usw.! - Eine abschließende Heartbeat RGB LED für den LED Streifen

5. ATTiny85 vorsortieren

Die Software auf den ATTiny85 kann nicht nur mit vollkommen gleichschnell laufenden Tinys ein gutes Ergebnis erzielen, sondern auch mit dem Prinzip der „Wasserfall Kaskaden“ von „oben nach unten“. Das heißt, ein vorhergehender Tiny darf auch einen Tick schneller laufen, als sein direkter Nachfolger. Nur nicht umgekehrt! (wenn sie genau gleichschnell laufen, ist das aber auch OK)

Diese Anforderung können wir in vielen Fällen schon durch Sortieren der Tinys erreichen! In positiven Fällen muss dann gar nicht nachgetrimmt werden!

Um die optimale Sortierung zu erreichen beginnen wir mit zwei Tinys in den ersten beiden 511 Platinen und terminieren hier die zweite Platine. Wenn jetzt nicht nur der erste, sondern auch der zweite Tiny, im Animations- bzw. Effekt Modus gleichmäßig langsam blinkt und auf dem nachfolgenden LED Streifen die finale Heartbeat LED, auf einer Position weiter hinten, ruhig und gleichmäßig changiert, sowie die LEDs dahinter aus sind, haben wir bereits eine funktionierende Reihenfolge gefunden!

Wenn hingegen die LED auf der zweiten 511 Platine flimmert, oder die finale Heartbeat LED nicht gleichmäßig changiert, oder die LEDs dahinter nicht aus sind und konstant aus bleiben, dann müssen wird die beiden Tinys, in den 511 Platinen, vertauschen!

Eine der beiden Reihenfolgen wird das bessere Ergebnis zeigen!

Nun nehmen wir einen dritten Tiny hinzu. Diesen können wir VOR den beiden vorher sortierten Tinys platzieren, oder DAZWISCHEN, oder DAHINTER.

Auch hier ist eines der Ergebnisse das Beste!

6. Nachtrimmen der ATTiny85

Wenn wir nun die Tinys sortiert haben, aber immer noch einer der nachfolgenden Tinys manchmal komisch flackert und nicht nur gleichmäßig langsam blinkt, oder die finale Heartbeat LED nicht ausschließlich gleichmäßig changiert, oder eine der LEDs hinter der finalen Heartbeat LED manchmal aufblitzt und nicht kontinuierlich „aus“ ist, dann müssen wir nachtrimmen!

6.1 Im pyPG den ersten Tiny trimmen

Wir gehen in den pyPG und verbinden uns mit der Hauptplatine.
Dann gehen wir auf „Servo Test 2“
Dort stellen wir bei „Servo Modul Adresse“ eine 1 ein, wenn wir eine Hauptplatine 101 haben, oder eine 102 ohne Diode(n). Bei einer Hauptplatine 102 mit Diode(n) stellen wir eine 2 ein.
Bei „Servo Betriebsart“ wählen wir „Tune Clock“
Nun schieben wir den Regler „Servo position“ z.B. auf 20, drücken dann den „Enter“ Button und gucken, was sich verändert.
Das Verschieben des Reglers + Enter verändern wir so lange, bis wir das beste Ergebnis erreicht haben.
Am WICHTIGSTEN ist hierbei das gleichmäßige Blinken der direkt nachfolgenden 511er Platine!

6.2 Im pyPG den zweiten Tiny trimmen

Das Trimmen des zweiten Tiny kann nur erfolgen, wenn der erste Tiny so gut getrimmt wurde, dass der zweite Tiny, genau wie der erste Tiny, gleichmäßig langsam blinkt!
Um den zweiten Tiny zu trimmen (falls überhaupt erforderlich) wählt man jetzt bei „Servo Modul Adresse“ eine 4 an (oder 5 bei Hauptplatine mit Diode) und wiederholt den Vorgang aus 6.1 so lange, bis der dritte (in diesem Beispiel letzte) 511 Controller gleichmäßig blinkt und auch die finale Heartbeat und die nachfolgenden LEDs keine komischen Effekte mehr zeigen.

6.3 Den ersten Tiny evtl. nochmal nachtrimmen

Es kann vorkommen, dass der zweite Tiny durch den eigenen Trimm den Kontakt zum ersten Tiny wieder verliert. Man merkt das daran, dass man schlagartig eine Verschlechterung erzeugt und i.d.R. kann man das auch nicht sofort wieder rückgängig machen, weil der zweite Tiny ja nun auch keine Befehle mehr über den ersten Tiny lesbar zugestellt bekommt.
Das ist aber leicht zu lösen, indem man die Prozedur aus 6.1 wiederholt und den ersten Tiny wieder besser an den …nun ja selber auch neu getrimmten …zweiten Tiny anpasst!

7. Nach dem erfolgreichen Trimmen

Wenn man mehrere 511 Controller erfolgreich durchgetrimmt hat sollte man auf jeden Fall bei ALLEN einen „Factory default Reset“ durchführen, da es durch die wirren Bits in der Trimmphase durchaus mal vorkommen konnte, dass ungewollte Programmierungen entstanden sind und gespeichert wurden!

8. Mehr als drei Tinys trimmen

Die Prozeduren gelten sinngemäß auch für mehr als drei Tinys und es ist durchaus möglich erfolgreich bis zu sechs 511 Platinen mit ATTiny85 zu trimmen. Die mögliche Anzahl an Sortier- und Trimm-Schritten steigt aber exponentiell an! Einfacher ist es in jedem Fall, nur Cluster bis zu drei 511 Platinen zu trimmen und dann eine WS2811/WS2812 RGB LED dazwischen zu packen, die den Takt aus den 800 kHz Bitrate wieder zurückgewinnen und so für einen weiteren 511er Cluster konsolidieren.

z21simulator

anonymous@undisclosed.example.com (Anonymous) — Sun, 03 Jan 2021 15:43:54 +0000

pyProgramGenerator - Z21 Simulator

Einleitung

Der Z21 Simulator ermöglicht die direkte Steuerung des ARDUINOS von Modellbahnsteuerungsprogrammen aus (z.B. Rocrail, iTrain, Traincontroller, WinDigiPet). Die Simulation verhält sich gegenüber dem Steuerprogramm wie eine Roco Z21 Zentrale. Wenn das Steuerproramm auf demselben Rechner läuft, findet das Steuerprogramm die Z21 Simulation unter der IP Adresse 127.0.0.1. Das Textfeld zeigt alle gesendeten und empfangenen Kommmandos an.

Der LED-ARDUINO wird direkt über USB mit dem PC verbunden.

Es ist kein DCC-ARDUINO notwendig!

Bei der direkten Steuerung des LED-ARDUINOs ist der ARDUINO immer mit dem USB-Anschluss des Steuer-PCs verbunden. Nicht nur zum Programmieren.

Das folgende Bild zeigt die Grundkonfiguration:

Was sind die Vorteile der direkten Steuerung?

es reicht die minimal Konfiguration für die MobaLedLib aus - ein ARDUINO, ein 100 Ohm Widerstand und eine 4- oder 6-polige Buchse.
der Steuerbus der Zentrale und auf dem Gleis wird nicht belastet - gerade bei DCC kann dies ein Problem werden, wenn komplexe Beleuchtungsszenarien geschaltet werden, können Steuerkommandos für Lokomotive verzögert werden. Was beim Bremsen zu ungenauen Haltepunkten führen kann.
die Informationsübertagung ist etwas schnelle, da die Verzögerung durch die Zentrale und das Protokoll entfallen
es ist möglich Informationen vom ARDUINO an die Software zurückzumelden, z.B. Tasterdrücke, Schalterstellungen oder Reedkontakte (in Vorbereitung)

Die Lösung hat aber auch Nachteile:

der ARDUINO muss dauerhaft mit dem USB Ausgang des Steuer-PCs verbunden sein. Das hat folgende Konsequenzen, die man beachten muss:
- über den ARDUINO sind alle Komponenten der MobaLedLib mit der PC Masse verbunden. Die MobaLedLib darf daher auf keinen Fall irgendeine direkte Verbindung zu den Gleisen haben, z.B. für Besetztmeldungen, diese dürfen nur über Optokoppler laufen.
- Beim Anschließen von zusätzlichen Netzteilen für die Stromversorgung ist darauf zu achten, dass die +5V Stromversorgung des ARDUINO von der zusätzlichen Stromversorgung auch wirklich getrennt ist. Bei einem Fehler kann der USB Anschluss des PCs zerstört werden.

Das folgende Bild zeigt die minimal Konfiguration:

Wie funktioniert das?

Die Modellbahnsteuerungssoftware muss jetzt irgendwie ihre Kommandos an den ARDUINO über die USB-Schnittstelle schicken. Da keine Modellbahnsteuerungssoftware - zumindest bis jetzt nicht - die MobaLedLib kennt müssen wir das anders lösen.

Und da kommt der Z21-Simulator ins Spiel.

„Also, wat is en Z21 Simulator? Da stelle mehr uns janz dumm. Und da sage mer so: En Z21 Simulator, dat is ene jroße schwarze Box, die hat hinten un vorn e Schnittstell. Dat eine Schnittstell, dat is de Z21 Schnittstell. Und dat andere Schnittstell, dat krieje mer später.“

Die Z21-Schnittstelle

Wenn man eine Modellbahnsteuerungssoftware dazu bringen möchte, mit einer neuen Hardware zusammenzuarbeiten, ist es am einfachsten der Software eine Schnittstelle zu einer Zentrale anzubieten, die sie schon kennt. Hier gibt es mehrere Möglichkeiten. Früher wurde gerne die Intellibox-Schnittstelle dazu verwendet.

Seit ROCO seine Z21 Zentrale auf den Markt gebracht hat, die Beschreibung der Schnittstelle zu Modellbahnsteuerungssoftware veröffentlicht hat und erlaubt diese nachzubilden (was ESU z.B. ausdrücklich für die ECOS-Schnittstelle untersagt) ist die moderne Z21 Schnittstelle das Mittel der Wahl.

Wir müssen also eine Software auf dem PC laufen lassen, die die Z21-Schnittstelle simuliert und der Modellbahnsteuerungssoftware vorgaukelt sie wäre eine Roco Z21. Und diese Software ist der Z21-Simulator.

Was die Z21 Schnittstelle so interessant macht, ist, dass sie ein LAN Protokoll ist. Das heißt, der Z21-Simulator kann auf demselben PC wie die Modellbahnsteuerungssoftware laufen oder auf irgendeinem anderen Gerät im LAN. Damit ist es auch möglich den Z21-Simulator auf einem Raspberry laufen zu lassen und den ARDUINO an die USB-Schnittstelle des Raspberrys anzuschließen. Damit könnte man die begrenzte Länge der USB-Kabel von max 5m beliebig erweitern. Man könnte an den Raspberry auch mehrere ARDUINOS anschließen, die jeweils für einen Teilbereich der Modellbahn zuständig sind. (Diese Funktion ist in Vorbereitung)

Die ARDUINO-Schnittstelle

Die andere Schnittstelle des Z21-Simulators ist die USB-Schnittstelle. Genauer gesagt wird über die USB-Schnittstelle eine serielle Kommunikation simuliert. Diese serielle Kommunikation entspricht genau der Kommunikation zwischen dem DCC-ARDUINO und dem LED-ARDUINO, wenn eine DCC-Digital Zentrale verwendet wird. Für den LED-ARDUINO ist es deshalb überhaupt kein Unterschied, ob er über eine DCC-Digital-Zentrale und den DCC-ARDUINO die Kommandos erhält oder über den Z21-Simulator und den USB-Anschluss.

Wichtig zu wissen ist, dass der LED-ARDUINO im DCC-Modus programmiert werden muss, damit er mit dem Z21-Simulator zusammenarbeiten kann.

Wie startet man den Z21-Simulator?

Der Z21 Simulator kann folgendermaßen gestartet werden:

Über den Startbutton auf der Z21-Simulator-Seite
Automatisch beim Start des pyProgrammGenerators durch eine Kommandozeilenoption

Start des Z21-Simulators mit Startbutton

ARDUINO an den USB-Anschluss des PC anschließen
pyProgrammGenerator starten
auf der ARDUINO-Einstellungen-Seite überprüfen, ob der ARDUINO richtig erkannt wurde
die geänderten Einstellungen speichern
den Reiter Z21-Simulator auswählen
der Z21-Simulator wird gestartet. Im Meldungsfenster wird angezeigt, dass der Port für den Z21-Simulaor geöffnet wurde. Außerdem wird die IP-Adresse des PCs angezeigt. Diese IP-Adresse wird nachher beim Einrichten der Modellbahnsteuerungssoftware oder der Smartphone-App benötigt.In der Status-Zeile ganz unten wird die Meldung angezeigt, dass eine Verbindung zum ARDUINO aufgebaut wird.
Wenn alles funktioniert hat, und der Z21-Simulator auch die Verbindung zum ARDUINO herstellen konnte, wird die Meldung „Z21 Simulator started“ angezeigt.
Jetzt kann die Modellbahnsteuerungssoftware oder die Smartphone App die MobaLedLib steuern. Wie das genau geht, wird weiter unten beschrieben. -

Start des Z21-Simulators über Kommandozeilenoption

Da es nicht sehr komfortabel ist, jedes mal, wenn man die MobaLedLib mit der Modellbahnsteuerungssoftware steuern möchte, den Z21-Simulator von Hand zu starten, gibt es eine Kommandozeilenoption, mit der man das Programm anweisen kann, den Z21 Simulator automatisch zu starten.

Die Option zum einschalten des Z21-Simulators lautet: –z21simulator True

Die komplette Kommandozeile würde also so aussehen: pyProg_Generator_MobaLedLib –z21simulator True

ACHTUNG: Diese Funktion ist in Vorbereitung und noch nicht implementiert!