Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- anleitungen:spezial:pyprogramgenerator [2020/06/13 16:02] – [Funktionen in PyProgGen] hlinke
+++ anleitungen:spezial:pyprogramgenerator [2024/04/28 11:32] (aktuell) – [pyMobaLedLib] hlinke
@@ Zeile 1: / Zeile 1: @@
-====== pyProgramGenerator ======
+====== pyMobaLedLib (früher pyProgrammGenerator) ======
 ===== Allgemeine Hinweise =====
-Bei dem pyProgramGenerator pyProgGen handelt es sich um eine Ergänzung zu dem Excel basierten ProgrammGenerator, die komplett in Python entwickelt wurde. dadurch ist das Programm unabhängig von Excel und sollte auf jedem Betriebssystem laufen, das von der ARDUINO Entwicklungsumgebung und Python unterstützt wird.
+Die MobaLedLib verwendet zum Programmieren zwei Programme, ProgrammGenerator und PatternConfigurator, die auf der Windows-Version von Excel laufen. Diese Programme können deshalb nicht auf anderen Plattformen wie Linux oder Mac genutzt werden. Leider gibt es jetzt auch Berichte, daß es zu Problemen bei den neuesten Excel-Versionen unter Windows 11 kommen kann.
-pyProgGen erhebt nicht den Anspruch alle Funktinen, wie sie in den Macros implementiert sind, nachzubilden. Für Spezialfälle ist deshalb immer noch die Nutzung des Excel Programmgenerators und die direkte Macroprogrammierung notwendig.
+Die pyMobaLedLib ist eine Excel-unabhängige Version der MobaLedLib Programme, die komplett in Python entwickelt wurde und auf Windows, Linux und Mac läuft.
+Die Benutzeroberfläche bildet die Orginalbenutzeroberfläche der Excelprogramme nach, so daß die Anleitungen für die Orginal-Version genauso auch für die pyMobaLedLib gelten.
+Es werden fast alle Funktionen der Excel-Programme zur Verfügung gestellt.
+Darüberhinaus gibt zusätzliche Assistenten, die Erzeugung von speziellen Animationen unterstützen:
-Die aktuelle Version kann man automatisch im Excel ProgrammGenerator herunterladen lassen. Will oder kann man das Excel Programm nicht nutzen, gibt es das Programm hier: [[https://github.com/haroldlinke/MobaLedLib_pyProgGen]]
+  - Servo Animation
+  - LED Farbverlauf Animation (Grundversion)
+  - LED Helligkeit Animation (Grundversion)
-Die Installation muß man dann von Hand machen, wie hier unten beschrieben:
-==== Installation =====
+Das folgende Bild zeigt einen Screenshot des ProgrammGenerators (Beispiel Raspi)
-==== Installation unter Windows ====
+{{:bilder:anleitungen:mll_raspi_01.jpg?400|}}
-Die Installation für Windows ist auf der folgenden Seite beschrieben: [[anleitungen:spezial:pyprogramgenerator:Installation|Windows Installation]]
-=== Installation auf einem Rapsberry ===
+Ein Beispiel für eine **ServoAnimation** 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.
-Die Installation auf einem Raspberry ist auf der folgenden Seite beschrieben: [[anleitungen:spezial:pyprogramgenerator:RaspberryInstallation|Raspberry Installation]]
-=== Installation auf einem Mac ===
+{{:bilder:anleitungen:pymll08.jpg?600|}}
-Die Installation auf einem Macist auf der folgenden Seite beschrieben: [[anleitungen:spezial:pyprogramgenerator:MacInstallation|Mac Installation]]
-===== Funktionen in PyProgGen ======
-  - [[anleitungen:spezial:pyprogramgenerator:ProgrammGenerator |ProgrammGenerator]] - ermöglicht das Erstellen von MoBaLedLib Programmen für den ARDUINO, ohne das man etwas von Macros oder Excel wissen muss. Die Auswahl der LEDs erfolgt grafisch am Bildschirm. Die LED, die bearbeitet wird, blinkt.
+==== ACHTUNG ====
-  - [[anleitungen:spezial:pyprogramgenerator:Programmvorschau |Programmvorschau]] - zeigt das erzeugte Macroprogramm an (nur für Experten interessant)
+**Das Programm ist noch in der Entwicklung. Es kann daher Fehler und Einschränkungen gegenüber der Excel-Version haben.
-  - [[anleitungen:spezial:pyprogramgenerator:FarbTest|Farb Test]] - dies ist der schon bekannte Farbtest, mit dem an verschiende Farbeinstellungen testen kann, und fürdie Farbtabelle abspeichern kann.
+Wenn Du das Programm nutzt hilfst Du mit Deinem Feedback das Programm besser und stabiler zu machen.
-  - [[anleitungen:spezial:pyprogramgenerator:SoundTest|Sound Test]] - ermöglicht das einfache Testen von Soundeinstellungen
+Feedback bitte ins StummiForum in die "Tageszeitung" setzen.
-  - [[anleitungen:spezial:pyprogramgenerator:DCCKeyboard|DCC Keyboard]] - simuliert die Funktion eines DCC Keyboards für die MobaLedLib. Durch Betätigen einer virtuellen Taste kann eine direkt eine Aktion in der LEDkette ausgelöst werden.
+Um Fehlerursachen zu finden ist die LogDatei hilfreich. Sie befindet sich im Order /Python und heisst logfile.log.
-  - [[anleitungen:spezial:pyprogramgenerator:Z21Simulator|Z21 Simulator]] - anstatt die Tasten der DCC-Keyboard Simulation zu benutzen, die Ansteuerung dierekt von einer Modellbahnsteuersoftware wie zB. Rocrail, iTrain, WindigPet und TrainController
+**
-  - [[anleitungen:spezial:pyprogramgenerator:SerialMonitor|Serial Monitor]] - (nur für Experten) teigt alle Informationen, die über die serielle schnittstellen zum ARDUINO geschikct wurden an
+==== Installation =====
-  - [[anleitungen:spezial:pyprogramgenerator:ARDUINOMonitor|ARDUINO Monitor]] - zum Erzeugen des ARDUINO Programms und zum Hochladen zum ARDUINO, wird das ARDUINO Programm verwendet. Im ARDUINO Monitor werden die Ausgaben diese Programms,beim Kompilieren und Hochladen, angezeigt.
-  - [[anleitungen:spezial:pyprogramgenerator:ARDUINOEinstellungen|ARDUINO Einstellungen]] - hier kann man den ARDUINO suchen lassen und die Einstellungen für den ARDUINO vornehmen
-  - [[anleitungen:spezial:pyprogramgenerator:Einstellungen |Einstellungen]] - hier kann man die Grundeinstellungen des Programms anpassen
+Das Programm kann hier heruntergeladen werden: [[https://github.com/haroldlinke/pyMobaLedLib]]
-===== Schnelleinstieg ======
+Die Installation muß man dann von Hand machen, wie hier unten beschrieben.
-Im Folgenden will ich an einem Beispiel, wie man sehr schnell ein Programm mit der MobaLedLib für den ARDUINO erstellt.
-Den PyProgGen starten, aus dem ERxcel programGenerator oder direkt. Wo das programm zu finden ist, ist abhängig vom Betriebssystem und wo sie es installiert haben.
+==== Installation unter Windows ====
-Es erscheint
+Die Installation für Windows ist auf der folgenden Seite beschrieben: [[anleitungen:spezial:pyprogramgenerator:Installation|Windows Installation]]
-{{:bilder:anleitungen:spezial:colorcheck:wiki_pyproggen_01.jpg?400|}}
+=== Installation auf einem Raspberry ===
+Die Installation auf einem Raspberry ist auf der folgenden Seite beschrieben: [[anleitungen:spezial:pyprogramgenerator:RaspberryInstallation|Raspberry Installation]]
+=== Installation auf einem Mac ===
+Die Installation auf einem Mac ist auf der folgenden Seite beschrieben: [[anleitungen:spezial:pyprogramgenerator:MacInstallation|Mac Installation]]
-  - Tab **Programmgenerator** öffnen  {{:bilder:anleitungen:spezial:colorcheck:wiki_effect_test_01.jpg?100|}}
-  - **Gruppenparameter** eingeben:{{:bilder:anleitungen:spezial:wiki_effect_test_02.jpg?100|}}
-    - Gruppenfarbe auf "Gelb" setzen, durch Klicken auf den "Gruppenfarbe"-Schalter.
-    - Neuen Gruppennamen eingeben: z.B. Haus01
-    - Verteiler, Anschluss und Kommentar eingeben
-    - __Übernehmen__ anklicken, die Gruppendaten werden jetzt gespeichert - der neue Gruppenname findet sich jetzt auch in der Auswahlliste
-  - In der **LED Liste** die erste LED anklicken {{:bilder:anleitungen:spezial:colorcheck:wiki_effect_test_03.jpg?200|}}
-  - In **Macros und Effekte** den Tab "House" auswählen
-    - In der **Effekt Liste** "__Room_Dark__" anklicken. {{:bilder:anleitungen:spezial:colorcheck:wiki_effect_test_04.jpg?400|}}
-    - Der Eintrag "Haus01 (Gruppenname) House (Makro) ROOM_DARK" wird in der LED angezeigt. Da der Effekt alle 3 Kanäle der LED belegt, sind die folgenden 2 Kanäle gesperrt
-  -  In der **LED-Liste** die nächste LED (003) auswählen.
-    - Mit SHIFT-Click "ROOM_BRIGHT" auswählen.
-    - Der Effekt wird eingetragen und die nächste LED wird automatisch ausgewählt.Es werden wieder die beiden anderen Kanäle der LED gesperrt
-    - Mit SHIFT-Click "LED_SGL" auswählen. (An dieser Adresse haben wir einen WS2811 mit 3 externen LEDs angeschlossen)
-    - Mit SHIFT-Click "LED_SGL" auswählen.
-    - Mit SHIFT-Click "LED_SGL" auswählen.
-    - Das Ergebnis sieht jetzt so aus: {{:bilder:anleitungen:spezial:colorcheck:wiki_effect_test_06.jpg?200|}}
-  - In der **House-Makro** Parameterliste die Schalterart auf "DCC-Adresse" setzen. {{:bilder:anleitungen:spezial:colorcheck:wiki_effect_test_07.jpg?200|}}
-    - Die Adresse auf "105" setzen
-    - Taste **House - Daten übernehmen** anklicken, die Daten werden übernommen
-  - Auf den **Effekt Macro** - Tab klicken
-    - Das erstellte Programm wird angezeigt: {{:bilder:anleitungen:spezial:colorcheck:wiki_effect_test_08.jpg?200|}}
-    - Ein HouseT - Macro mit den Parametern für DCC Anschluss und den gewünschten Effekten wird angezeigt.
-  - zurück zum **Effekt Test** - Tab
-    - Im ARDUINO Feld den **Zum ARDUINO schicken** - Button anklicken. {{:bilder:anleitungen:spezial:colorcheck:wiki_effect_test_09.jpg?200|}}
+==== Bekannte Einschränkungen und Fehler ====
+  * Das Programm unterstützt die Funktionen der MobaLedLib bis Version 3.2.1C. Das Update auf die aktuelle Version erfolgt sobald diese Version sich als stabil genug erweist.
+  * MLL-Extensions werden noch nicht unterstützt
+  * Der Multiplexer wird noch nicht unterstützt
+  * Es kann im ProgrammGenerator- und PatterConfigurator-Fenster zu fehlerhafter oder ganz fehlender Darstellung von Icons oder Bildern in der Tabelle kommen. Zur Bereinigung der Darstellung oder der Funktion von Buttons kann im Programm-Menu **Tabelle** das Kommando **Refresh Icons** verwendet werden.
+  * Der **Haken** in der Spalte **Aktiv** wurde durch einen **"*"** ersetzt, um mit Linux und Mac Zeichensätzen kompatibel zu sein.
+  * Unter Linux und Mac und manchmal auch unter Windows wird der Nano/Uno Typ nicht automatisch erkannt. Der Typ muß dann von Hand eingetragen werden. Dazu im Programmgenerator den Optionen-Button anklicken. In dem sich öffnenden Fenster den Haken bei "automatisch erkennen" entfernen und den Typ von Hand einstellen. Bei vielen China Nanos hilft es den Typ Nano normal (old Bootloader) einzustellen.
+  * Unter Linux und Mac wird der ESP32 noch nicht unterstützt. Sollte in einer der nächsten Versionen kommen.
-===== Bedienung des Programms =====
-==== Start von pyProgGen ====
-Das Programm kann direkt durch anklicken der Python-Datei gestartet werden:
-...\MobaLedLib_1.0.1\LEDs_AutoProg\pyProg_Generator_MobaLedLib\pyProg_Generator_MobaLedLib.py
-==== Der Start-Bildschirm ====
+===== Funktionen in PyProgGen ======
-Der Startbildschirm gibt einige allgemeine Hinweise zur Bedienung des Programms.
-Die weiteren Funktionen des Programms befinden sich hinter den Reitern direkt unter dem Hauptmenue.
-Folgende Seiten stehen zur Verfügung:
+  - [[anleitungen:spezial:pyprogramgenerator:ProgrammGenerator |ProgrammGenerator]] - ermöglicht das Erstellen von MoBaLedLib Programmen für den ARDUINO, ohne das man etwas von Macros oder Excel wissen muss. Die Auswahl der LEDs erfolgt grafisch am Bildschirm. Die LED, die bearbeitet wird, blinkt.
-  * Start - der Startbildschirm
+  - [[anleitungen:spezial:pyprogramgenerator:Programmvorschau |Programmvorschau]] - zeigt das erzeugte Macroprogramm an (nur für Experten interessant)
-  * Programmgenerator - Hauptseite zum Erstellen und Testen von Macros und Effekten
+  - [[anleitungen:spezial:pyprogramgenerator:FarbTest|Farb Test]] - dies ist der schon bekannte Farbtest, mit dem an verschiende Farbeinstellungen testen kann, und für die Farbtabelle abspeichern kann.
-  * Programmvorschau - hier wird das erstellte Macro Programm angezeigt (für Spezialisten, die sich mit der Macroprogrammierung auskennen)
+  - [[anleitungen:spezial:pyprogramgenerator:SoundTest|Sound Test]] - ermöglicht das einfache Testen von Soundeinstellungen
-  * LED Farbtest - das bekannte Farbtestprogramm zum Erstellen von Farbpaletten (SetColTab). Die erstellten Farben können direkt in für Effekte genutzt werden.
+  - [[anleitungen:spezial:pyprogramgenerator:DCCKeyboard|DCC Keyboard]] - simuliert die Funktion eines DCC Keyboards für die MobaLedLib. Durch Betätigen einer virtuellen Taste kann eine direkt eine Aktion in der LEDkette ausgelöst werden.
-  * Sound test - Seite zum Austesten der Einstellungen für die Soundmodule
+  - [[anleitungen:spezial:pyprogramgenerator:Servortest|Servo Test]] - ermöglicht das Testen und Einstellen der MobaLedLib Servos
-  * Serial Monitor - Anzeige der Kommunikation zwischen PC und ARDUINO
+  - [[anleitungen:spezial:pyprogramgenerator:Z21Simulator|Z21 Simulator]] - Ansteuerung der MobaLedLib direkt von einer Modellbahnsteuersoftware wie z.B. Rocrail, iTrain, WindigiPet und TrainController oder per Smartphone App
-  * DCC Keyboard - simuliert die Kommandos eines DCC-Keyboards und schickt diese Komandos direkt an den ARDUINO. Erlaubt das Testen ohne dass einen DCC Zentrale und ein DCC ARDUINO benötigt werden.
+  - [[anleitungen:spezial:pyprogramgenerator:SerialMonitor|Serial Monitor]] - (nur für Experten) zeigt alle Informationen, die über die serielle Schnittstellen zum ARDUINO geschickt wurden an
-  * Z21 Simulator - ermöglicht die direkte Kontroll über ein Modellbahnsteuerungsprogramm wie Rocrail oder Traincontroller. Das Program simuliert eine Z21 schnittstelle. Bis zu 4 ARDUINOs können kontrolliert werden.
+  - [[anleitungen:spezial:pyprogramgenerator:ARDUINOMonitor|ARDUINO Monitor]] - zum Erzeugen des ARDUINO Programms und zum Hochladen zum ARDUINO, wird das ARDUINO Programm verwendet. Im ARDUINO Monitor werden die Ausgaben diese Programms, beim Kompilieren und Hochladen, angezeigt.
-  * Servo Tester - Testen, Einstellen und Konfigurieren der Servos
+  - [[anleitungen:spezial:pyprogramgenerator:ARDUINOEinstellungen|ARDUINO Einstellungen]] - hier kann man den ARDUINO suchen lassen und die Einstellungen für den ARDUINO vornehmen
-  * Einstellungen - ermöglicht die Anpassung des Programms an die Umgebung und die eignen Präferenzen
+  - [[anleitungen:spezial:pyprogramgenerator:Einstellungen |Einstellungen]] - hier kann man die Grundeinstellungen des Programms anpassen
-Fortsetzung folgt ...

Benutzer-Werkzeuge

Webseiten-Werkzeuge

Unterschiede

Seiten-Werkzeuge