====== Anleitung für den ersten Schnelleinstieg ======
Die MobaLedLib unterstützt im aktuellen Release als LED-Controller nur den **Arduino Nano mit einem AtMega328P** (ab Version 3.3 auch 328PB) und den **ESP32**. \\ Die Verwendung eines **Raspberry Pico 2040** befindet sich noch in der Entwicklung. \\ Den Arduino Nano mit einem **AtMega168** kann man ausschließlich für den DCC-Arduino verwenden, auf Grund des beschränkten Speicherplatzes mit nur 16KB im Gegensatz zum AtMega328P mit 32KB. [[:mobaledlib_onlie-shop#arduino_nano_versionen|weitere Infos]]
===== 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
völlig aus. Der Arduino kann ein Uno, Nano oder auch ein Mini Pro o.ä. sein.
Diese Anleitung gilt für eine __WINDOWS 10__ Umgebung mit einem installierten Microsoft Office/Excel. MS Office Alternativen wie OpenOffice oder LibreOffice werden zur Zeit nicht unterstützt.
__Tipp__: Um diese Anleitung und das aktuelle Installationsfenster gleichzeitig auf dem Bildschirm zu sehen, kann man den Bildschirm teilen. Damit lässt sich ein Ausdruck vermeiden. Eine Anleitung dazu befindet sich am Ende der Anleitung unter [[anleitungen:quickstart#tipp|Tipp]].
Zunächst muss man die aktuelle Arduino Entwicklungsumgebung IDE (Integrated Development Environment) herunterladen und installieren.
Die ARDUINO Download Seite erreicht man über den Link:
[[https://www.arduino.cc/en/Main/Software]] \\
Die MobaLedLib läuft mit allen aktuellen Versionen der Arduino IDE und wurde mit den Versionen 1.8.8 - 1.8.19 erfolgreich getestet. Bei der Verwendung der Arduino IDE in den Versionen 1.8.8 und 1.8.9 kann es zu Problemen mit der Bibliothek "FastLED" und einer veralteten Version der Arduino Boards kommen. In diesem Fall bitte die folgenden [[anleitungen:fehlersuche:fastled|Problemlösung]] lesen.
Für die Unterstützung aller Funktionen der MobaLedLib empfehlen wir die letzte erhältliche Version 1.8.19 zu installieren und nicht die aktuelle Version 2.X. Die Version 1.8.19 wird nach wie vor auf der Arduino Seite unterhalb der Version 2.X zum Download angeboten. \\
Der Arduino WEB-Editor oder die Arduino App können für die MobaLedLib __nicht__ genutzt werden.
{{bilder:anleitungen:schnelleinstieg:quickstart_arduino_ide1.jpg}}
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-windows.exe“ findet man in dem „Downloads"-Ordner seines PC. Die Position des Ordners hängt vom verwendeten Internet Browser und dessen Einstellungen ab.
Zur Installation wird das Programm mit einem Doppelklick gestartet. Anschließend befolgt man die Anweisungen auf dem Bildschirm.
Zur Installation der IDE findet man bei Bedarf im Internet ausführliche Anleitungen, zum Beispiel:
[[https://draeger-it.blog/arduino-ide-installieren/?cn-reloaded=1&cn-reloaded=1]]
Bei der Installation wird auf dem Desktop eine ICON angelegt, über das die Entwicklungsumgebung gestartet werden kann.
{{bilder:anleitungen:schnelleinstieg:arduino_link.jpg?50}}
Nun den Arduino an einen freien USB-Port anschließen. WINDOWS installiert nun bei erstmaliger Verbindung USB/Geräte-Treiber für den Arduino. Bei fehlerfreier Installation sollten COM-Port und Arduino, wie im folgenden Bild dargestellt, aufrufbar sein. Die Nummer des COM-Ports ist abhängt von der Belegung der Schnittstellen des PC mit anderen Geräten.
{{bilder:anleitungen:schnelleinstieg:arduino_comport.jpg}}
Falls das nicht der Fall ist, sollte zunächst überprüft werden, ob der Arduino erkannt wird und an welchem COM-Port er angeschlossen wurde. Dazu im WINDOWS Geräte-Manager, zu erreichen über die WINDOWS Starttaste mit rechter Maustaste anklicken, unter „Anschlüsse(COM&LPT)“ prüfen ob der Arduino dort aufgelistet ist.
{{bilder:anleitungen:schnelleinstieg:geraete-manager.jpg}}
Im Falle von original Arduinos erscheint der Namen z.B. NANO. Clones werden hingegen mit dem verbauten Chip aufgeführt, hier der CH340. Das liegt daran, dass dort statt der FTDI-Chips die deutlich preiswerteren CH340G USB 2 Serial Chips verbaut werden.
Werden im Gerätemanager weder der NANO noch der CH340 angezeigt sondern nur ein gelber Warnhinweis, ist der notwendige Treiber möglicherweise nicht installiert.
In dem Fall wie auch bei sonstigen Problemen:
Hilfe, mein Arduino wird nicht erkannt. **→** siehe Abschnitt [[anleitungen:fehlerbehebung_installation|Fehlerbehebung]].
Tritt beim Kompilieren ein Fehler auf, hilfen vielleicht [[anleitungen:faq|FAQ]] weiter.
Für Einsteiger ist möglicherweise ein kleiner zusätzlicher Test interessant. Mehr dazu am Ende der Anleitung unter [[anleitungen:fehlerbehebung_installation#test|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. \\
C:\Users\**BENUTZERNAME**\Documents\Arduino
\\
Dies kann über das Menü innerhalb der Arduino IDE gemacht werden. \\
{{bilder:anleitungen:bauanleitungen:400de:2020-04-12_16_57_05-02.tiny_uniprog_arduino_1.8.9.png?200|}}
{{bilder:anleitungen:bauanleitungen:400de:2020-04-12_16_57_36-voreinstellungen.png?600|}}
Weiterhin sollte unter \Datei\Voreinstellungen eine zusätzliche URL eingetragen werden.\\
{{:bilder:anleitungen:bauanleitungen:400de:screenshot_2024-06-15_123311.png?nolink&400|}}\\
**https://descartes.net/package_drazzy.com_index.json**
===== MobaLedLib (MLL) einrichten =====
Zunächst muss die Bibliotheksverwaltung der IDE über Sketch -> Bibliothek einbinden -> Bibliothek verwalten
geöffnet werden.
{{bilder:anleitungen:schnelleinstieg:10_bibliothekverwalteeaknu.jpg}}
Es öffnet sich der Bibliotheksverwalter. \\
{{bilder:anleitungen:schnelleinstieg:einst_mobaled_ausw-1.png}}
Nun in das Suchfeld rechts oben „mobaledlib“ eingeben. \\
{{bilder:anleitungen:schnelleinstieg:einst_mobaled_ausw-2.png?direct}}
In den gefundenen Eintrag klicken, dann erscheint der Installieren-Knopf \\
{{bilder:anleitungen:schnelleinstieg:einst_mobaled_ausw-3.png?direct}}
Im Bedarfsfall kann über diesen Menüpunkt auch eine andere Version oder ein Update installiert werden. \\
Mit einem Klick auf den Knopf wird die Installation angestoßen. Im folgenden Fenster kann man noch entscheiden ob alle möglicherweise fehlenden Libraries zum Betrieb der MobaLedLib ebenfalls automatisch installiert werden sollen.
{{ :bilder:anleitungen:schnelleinstieg:inst-neu.png |}}
Jetzt kann endlich das MobaLedLib-Excel Programm geöffnet werden.
Dazu auf der Tastatur die WINDOWS und die „R“ Taste gleichzeitig drücken.
In den erscheinenden „Ausführen“ Dialog die folgende Zeile kopieren:
%USERPROFILE%\Documents\Arduino\libraries\MobaLedLib\extras\Prog_Generator_MobaLedLib.xlsm
{{bilder:anleitungen:schnelleinstieg:06_ausfueren-fensterl4kux.jpg}}
Nun sollte sich endlich die aktuelle Version des Programm Generators der MobaLedLib öffnen. \\
Sollte dies nicht der Fall sein, hat der Virenscanner die MobaLedLib blockiert.
**→** siehe Abschnitt [[anleitungen:fehlerbehebung_installation|Fehlerbehebung]].
{{bilder:anleitungen:schnelleinstieg:startseiteagklv.jpg}}
Da es sich um ein Excel Programm mit eingebetteten Makros handelt, wird beim ersten Start eine Sicherheitswarnung angezeigt. Mit einem Klick auf „Inhalte aktivieren“ werden die Makros ausführbar gemacht. \\
Danach wird das Programm //__automatisch__// in das Verzeichnis
%USERPROFILE%\Documents\Arduino\MobaLedLib_x.y.z\LEDs_AutoProg
kopiert und ein Icon auf dem Desktop angelegt (x.y.z entspicht der Versionsnummer). Darüber kann der Prog-Generator künftig gestartet werden. \\
{{bilder:anleitungen:schnelleinstieg:einst_desktop_verkn.png?400|}}
{{bilder:anleitungen:schnelleinstieg:einst_prg_erzeugen.png?400|}}
Ein Klick auf OK führt zu einem ersten Auswahldialog. Für erste Versuche ist es zunächst unerheblich welche der drei angebotenen Möglichkeiten (DCC-, Selektrix- oder CAN-Steuerung) ausgewählt wird.
{{bilder:anleitungen:schnelleinstieg:einst_mobaled_dialog-1.png}}
Nach Anklicken des Start-Knopfes werden weitere Dialoge geöffnet. Eingaben sind für den ersten Einstieg nicht notwendig. Es genügt, die rot markierten Optionen auszuwählen. Erläuterungen zu den Dialogen sind in der ausführlichen Anleitung zum Prog_Gen zu finden. \\ Sollte der Interviewer-Dialog nicht aufgehen, einfach auf den Button "Dialog" klicken. \\
{{bilder:anleitungen:schnelleinstieg:einst_mobaled_dialog-2.png?720|}}
{{bilder:anleitungen:schnelleinstieg:einst_mobaled_dialog-3.png?720|}} \\
{{bilder:anleitungen:schnelleinstieg:einst_mobaled_dialog-4.png?720|}}
{{bilder:anleitungen:schnelleinstieg:einst_mobaled_dialog-5.png?720|}} \\
{{bilder:anleitungen:schnelleinstieg:einst_mobaled_dialog-6.png?720}}
Die letzte Schaltfläche führt uns schließlich zur Makroauswahl.
{{bilder:anleitungen:schnelleinstieg:13_macrossskid.jpg}}
===== Auswahl eines Beispiels (belebtes Haus) =====
Für unseren ersten Test wählen wir mit dem Select-Knopf das „House“ aus und erhalten die folgende Seite zur weiteren Auswahl der Funktionen:
{{bilder:anleitungen:schnelleinstieg:14_belebteshauszxju1.jpg}}
Über das Tastenfeld „mögliche Beleuchtungstypen“ können unterschiedliche Beleuchtungen für die Räume eines Hauses ausgewählt werden. Wenn in einem Gebäude fünf Räume beleuchtet sind, müssen fünf Beleuchtungen ausgewählt werde. Auswahl und Anzahl werden angezeigt. Über die Taste „lösche Raum“ lassen sich Räume löschen um eine andere Beleuchtung auszuwählen. Durch Anklicken der Option „individuelle Zeiten“ lassen sich die Zeiten für den Beleuchtungswechsel den eigenen Bedürfnissen entsprechend anpassen. Für Testzwecke bietet es sich an, die „Maximale Zeit bis zur nächsten Änderung“ auf 5 [Sec] zu setzen. Nun über „OK“ die Auswahl bestätigen. Damit werden die Werte in die Excel-Tabelle eingefügt und die Seite sollte wie folgt aussehen:
{{bilder:anleitungen:schnelleinstieg:16_prog_genauswahlldkjm.jpg}}
Zwei Zeilen sind aktiv geschaltet. Das ist an dem per Mausklick gesetzten Häkchen zu erkennen. Nicht-aktive Zeilen werden __nicht__ zum Arduino übertragen. Die Felder in den Spalten Filter, DCC Adresse, Typ und Startwert bleiben frei. Das Feld „Beschreibungen“ kann zur Erläuterung für eigene Zwecke genutzt werden. Der grau hinterlegte Bereich ist automatisch befüllt worden und kann bzw. __sollte nicht geändert werden.__ Über die roten Dreiecke in den Feldern könne zur weiteren Erklärung Tooltips aufgerufen werden.
Die erste Zeile mit dem Beispiel B01 „RGB_Heartbeat(#LED)“ wird standardmäßig gesetzt. Damit wird die erste LED in der Kette genutzt, um zu signalisieren, dass die Übertragung des Programms an den Arduino erfolgreich war und das System „lebt“. Falls die folgenden LEDs dann trotzdem nicht so arbeiten wie erwartet, hat man irgendwo in der Auswahl für die LEDs einen Fehler gemacht oder in der Verdrahtung der LEDs liegt ein Fehler vor. Die zweite wichtige Funktion der Heartbeat LED ist die Aufbereitung des Datensignals, das vom integrierten Chip für die Strecke bis zur ersten LED auf der Anlage verstärkt wird.
Im nächsten Schritt wird unsere Auswahl zum ARDUINO geschickt. Beim ersten Sendeversuch erfolgt die Aufforderung, den benutzten COM-Port festzulegen. Einfach den Anweisungen folgen und anschließend den „Z.Arduino schicken“ Knopf drücken.
Der Vorgang zum Erkennen des COM-Ports kann auch über „Optionen“ -> „USB Port erkennen“ angestoßen werden. Inzwischen erkennt das Programm den Arduino automatisch wenn das entsprechende Häkchen gesetzt ist. Die Auswahl benötigt man nur für den Uno oder sonstige Arduinos. Nach der automatischen Erkennung sollte für eine fehlerfreie Übertragung zum Arduino im Auswahlmenu der genutzte Arduino-Typ markiert sein, für Arduino Nano Clones i.d.R. „Nano Normal (__old Bootloader__)“. Ist der Arduino Typ nicht aufgeführt, sollte über das Arduino IDE der Typ ausgewählt werden und hier übernommen werden: "Typ von Arduino IDE benutzen".
{{bilder:anleitungen:schnelleinstieg:15_optionen.jpg}}
Hat bis hierher alles wie gewünscht funktioniert ist jetzt zwar das Programm auf dem Arduino aber es fehlen noch die LEDs.
===== Anschluss der RGB LEDs an einen Arduino =====
Im Abschnitt [[anleitungen:quickstart#bezugsquellen|Bezugsquellen]] sind Händler aufgeführt, die schnell und etwas teurer bzw. „billiger“ und mit längeren Lieferzeiten die Bauteile liefern.
{{bilder:anleitungen:schnelleinstieg:19_ws2612likjc.jpg?200}}
{{bilder:anleitungen:schnelleinstieg:20_ws2612rueckseitepiku3.jpg?200}}
Für den ersten Versuche reicht es, einfach ein paar RGB LEDs zusammen zu löten und direkt mit den Anschlüssen des Arduinos zu verbinden. Vorsichtshalber vorher den Arduino vom Computer trennen. Aber nicht übertreiben. Wenn der Arduino mit einem normalen USB-Netzteil und USB2.0 betrieben wird stehen 500 mA am 5V-Anschluss zur Verfügung. Das entspricht 5 RGB-LEDs mit maximaler Helligkeit auf allen Kanälen. Verbindet man mehr LEDs, reicht die Stromversorgung über den Arduino ggf. nicht mehr aus.
**Bitte beachten, dass hierfür unbedingt RGB-LED verwendet werden müssen und keine RGBW-LED. Das W steht hierbei für einen zusätzlichen Weiß-Kanal, der von der Software nicht unterstützt wird. Wird zwischen mehreren RGB-LED eine RGBW-LED in Reihe geschaltet, kann es passieren, dass die Kanalprogrammierung aus dem Prog-Generator nicht mehr die richtigen LED anspricht, weil er nacheinander drei Farb-Kanäle erwartet, wo tatsächlich aber vier Kanäle (Rot, Grün, Blau plus Weiß) sind. RGBW- und RGB-LED sehen äußerlich gleich aus und auch in den Produktbeschreibungen ist nicht immer eindeutig erkennbar, welche Art von LED angeboten wird. **
Es werden nur drei Kabel benötigt:
* //5 Volt// von der ersten LED zum 5V Pin des Arduino
* //GND// von der ersten LED zu einem GND Pin des Arduino
* //In// von der ersten LED zum Pin D6 des Arduino.
Nun den Arduino wieder über das USB Kabel mit dem Computer verbinden. Sind keine Änderungen vorgesehen, reicht auch eine 5 Volt Spannungsquelle aus.
Die LEDs sollten nun leuchten, wie oben über das „House“ festgelegt.
{{bilder:anleitungen:schnelleinstieg:18_testaufbau09jlr.jpg?400}}
Nun können weitere Macros ausprobiert werden, um erste Erfahrungen zu sammeln.
Einfach im House Macro andere Einstellungen wählen und erneut zum Arduino schicken. Ebenso können zusätzliche Zeilen eingefügt werden und vorhandene aktiviert bzw. deaktiviert werden.
Bitte bedenken, dass die Anzahl der im MACRO ausgewählten LEDs die der tatsächlich angeschlossenen LEDs für ein sinnvolles Ergebnis nicht übersteigen sollte.
**Nun viel Spaß mit der MobaLedLib!**
===== Tipp =====
==== Fenster teilen: ====
**Anordnung einstellen mit der Maus**
Um ein Fenster zu teilen, müssen Sie mit der linken Maustaste auf die obere Leiste des Fensters klicken. Halten Sie die Maustaste gedrückt und ziehen Sie das Fenster entweder bis an die linke oder rechte Seite Ihres Bildschirms. Es ist auch möglich, das Fenster in eine der vier Ecken zu ziehen, wenn Sie den Bildschirm in 4 Fenster unterteilen möchten. Das Fenster wird nun automatisch an eine Seite angedockt und ermöglicht die Auswahl anderer Fenster anhand einer Miniaturvorschau.
Klicken Sie auf einen der Vorschläge, wird dieses Programm an die andere Seite angedockt.
**Anordnung einstellen durch Taskleiste**
Es ist auch möglich, die Anordnung über die Taskleiste einzustellen. Klicken Sie dafür mit der rechten Maustaste unten auf ein freies Feld in der Taskleiste. Es erscheint ein Menü, bei welchem Sie zwischen "Fenster überlappen", "Fenster gestapelt anzeigen" oder "Fenster nebeneinander anzeigen" auswählen können.
**Shortcut für das Anordnen der Fenster**
Öffnen Sie eines der Fenster, das Sie verwenden wollen. Halten Sie die spezielle Windows-Taste auf der Tastatur gedrückt und bestimmen Sie mit den Pfeiltasten, an welche Seite bzw. Ecke des Bildschirms das Fenster angedockt werden soll:
z.B.: [Windows] + [Pfeil rechts]
===== Bezugsquellen =====
Die angegebenen Bezugsquellen sind nur Beispiele.
Die Teile gibt es sicherlich kostengünstig auch bei vielen anderen Herstellern.
• WS2812 LEDs schnelle Lieferzeit: [[https://www.amazon.de/Kuman-100pcs-WS2812B-Addressable-Arduino/dp/B07B7GVFRG/ref=pd_sbs_60_2?_encoding=UTF8&pd_rd_i=B07B7GVFRG&pd_rd_r=c86c60ff-1663-11e9-bcfc-89e94cb2608a&pd_rd_w=IoTGG&pd_rd_wg=RoOus&pf_rd_p=51bcaa00-4765-4e8f-a690-5db3c9ed1b31&pf_rd_r=H975JS0KT92BHS6HGA50&psc=1&refRID=H975JS0KT92BHS6HGA50]]
• WS2812 LEDs billiger aber lange Lieferzeit: [[https://www.aliexpress.com/item/32694592019.html?spm=a2g0s.9042311.0.0.27424c4d1oivPG]]
• WS2812 LEDs mit angelöteten Kabeln: [[https://de.aliexpress.com/item/1941066393.html?spm=a2g0s.9042311.0.0.3da24c4dXk8Cxy]]
• WS2811 Module zum ansteuern normaler LEDs: [[https://www.aliexpress.com/item/32755999690.html?spm=a2g0s.9042311.0.0.27424c4d1R2J3z]]
• 64 WS2812 LEDs für Tests am Schreibtisch: [[https://www.amazon.de/AZDelivery-Matrix-CJMCU-8-Arduino-Raspberry/dp/B078HYP681/ref=sr_1_19?keywords=Ws2812+Led&qid=1570436873&sr=8-19]]
• Platinen: [[https://wiki.mobaledlib.de/anleitungen/platinen_bestellung|Platinen-Bestellung]]