====== pyMobaLedLib ======

===== Allgemeine Hinweise =====

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.

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:

  - Servo Animation
  - LED Farbverlauf Animation (Grundversion)
  - LED Helligkeit Animation (Grundversion)


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

{{:bilder:anleitungen:mll_raspi_01.jpg?400|}}


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.

{{:bilder:anleitungen:pymll08.jpg?600|}}


==== ACHTUNG ==== 
**Das Programm ist noch in der Entwicklung. Es kann daher Fehler und Einschränkungen gegenüber der Excel-Version haben.
Wenn Du das Programm nutzt hilfst Du mit Deinem Feedback das Programm besser und stabiler zu machen.
Feedback bitte ins StummiForum in die "Tageszeitung" setzen.
Um Fehlerursachen zu finden ist die LogDatei hilfreich. Sie befindet sich im Order /Python und heisst logfile.log.
**
==== Installation =====

Das Programm kann hier heruntergeladen werden: [[https://github.com/haroldlinke/pyMobaLedLib]]

Die Installation muß man dann von Hand machen, wie hier unten beschrieben.

==== Installation unter Windows ====

Die Installation für Windows ist auf der folgenden Seite beschrieben: [[anleitungen:spezial:pyprogramgenerator:Installation|Windows Installation]]

=== 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]]


==== 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/Uni/ESP32 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.



===== 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.
  - [[anleitungen:spezial:pyprogramgenerator:Programmvorschau |Programmvorschau]] - zeigt das erzeugte Macroprogramm an (nur für Experten interessant)
  - [[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.
  - [[anleitungen:spezial:pyprogramgenerator:SoundTest|Sound Test]] - ermöglicht das einfache Testen von Soundeinstellungen
  - [[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.
  - [[anleitungen:spezial:pyprogramgenerator:Servortest|Servo Test]] - ermöglicht das Testen und Einstellen der MobaLedLib Servos
  - [[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
  - [[anleitungen:spezial:pyprogramgenerator:SerialMonitor|Serial Monitor]] - (nur für Experten) zeigt alle Informationen, die über die serielle Schnittstellen zum ARDUINO geschickt wurden an
  - [[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