======= WS2811 ======
===== Erklärung =====
==== Modulvarianten ====
Leider gibt es von den WS2811-Modulen mind zwei verschiedene Varianten. \\
Nachfolgend das Anschlussbild für ein einzelnes WS2811-Modul. \\ Bitte beachten, dass es leider mind. zwei verschiedene Module auf dem Markt gibt. \\
Der Dateneingang (**DI**) ist bei beiden Varianten auf der Unterseite und mit einem Pfeil markiert.\\ 
Der Datenausgang (**DO**) ist auf der Oberseite (Seite mit dem IC) das mittlere Lötpad. \\ \\
<wrap em>Bei beiden Modulen gibt es vor allem den Unterschied, das VCC (+5V) und GND vertauscht sind. \\ Bitte beachten, andernfalls gibt es ein unschönes Rauchwölkchen. \\ 

<WRAP  info 80%>
Die Mobaledlib verwendet am LED Bus das WS2812 Protokoll, welches sich vom WS2811 Protokoll dadurch unterscheidet, dass die Helligkeitswerte für den R und G Kanal in einer anderer Reihenfolge geschickt werden.

Diese Protokollentscheidung wurde ganz bewusst gewählt, da die WS2812 LEDs die erste Wahl für die MLL sind. Diese haben einen internen Chip und bieten daher keine Möglichkeit, Kanäle zu tauschen. Diese LEDs geben also das Protokoll vor.

Im Wissen der vertauschten Kanäle mit dem WS2811 wurden die MLL Platinen so entwickelt, dass R und G schon auf der Platine getauscht sind. 

Zusätzlich gibt es das Makro „define USE_WS2811“, welches das Protokoll für den GESAMTEN LED Bus ändert, was zur Folge hat, dass R/G mit den WS2811 stimmt und bei den WS2812 falsch ist.

Alternativen: \\
- statt der WS2811 „Schokotafeln“ die MobaLedLib Platinen 503, 520, 521 oder 522 verwenden \\
- die R und G LED in umgekehrter Reihenfolge an die „nicht-MLL“ Adapterplatinen anlöten.
</WRAP>


\\ Die gängigen WS2811-Module sind im Gegensatz zu den MLL Platinen richtig gelötet, was unter Verwendung des WS2812-Protokolls zu vertauschten  Anschlüssen von "Rot" und "Grün" führt. \\ Die Reihenfolge dieser Module ist dann: | G | + | R | B | statt | R | + | G | B | (jeweils von oben betrachtet)</wrap> \\ \\
Die Bilder sind wieder mit Beschreibungen versehen. Einfach mit der Maus über die Bilder gehen. \\
<webcode renderingMode="onlyResult" frameborder="0" ><code html>
<map name="image-map2a">
    <area target="_parent" alt="Kanal &quot;R&quot; vom WS2811-Modul" title="Kanal &quot;G&quot; vom WS2811-Modul" href="#" coords="49,36,14,1" shape="rect">
    <area target="_parent" alt="Kanal &quot;G&quot; vom WS2811-Modul" title="Kanal &quot;R&quot; vom WS2811-Modul" href="#" coords="79,1,113,37" shape="rect">
    <area target="_parent" alt="Kanal &quot;B&quot; vom WS2811-Modul" title="Kanal &quot;B&quot; vom WS2811-Modul" href="#" coords="147,38,114,1" shape="rect">
    <area target="_parent" alt="Kanal &quot;R&quot; vom WS2811-Modul" title="Kanal &quot;G&quot; vom WS2811-Modul" href="#" coords="281,2,315,42" shape="rect">
    <area target="_parent" alt="Kanal &quot;G&quot; vom WS2811-Modul" title="Kanal &quot;R&quot; vom WS2811-Modul" href="#" coords="216,5,249,40" shape="rect">
    <area target="_parent" alt="Kanal &quot;B&quot; vom WS2811-Modul" title="Kanal &quot;B&quot; vom WS2811-Modul" href="#" coords="184,1,212,39" shape="rect">
    <area target="_parent" alt="5V vom WS2811-Modul zur LED" title="5V vom WS2811-Modul zur LED" href="#" coords="48,1,80,37" shape="rect">
    <area target="_parent" alt="5V vom Verteiler/Arduino zum Modul" title="5V vom Verteiler/Arduino zum Modul" href="#" coords="159,215,107,152" shape="rect">
    <area target="_parent" alt="5V vom WS2811-Modul zur LED" title="5V vom WS2811-Modul zur LED" href="#" coords="251,3,278,42" shape="rect">
    <area target="_parent" alt="5V vom Verteiler/Arduino zum Modul" title="5V vom Verteiler/Arduino zum Modul" href="#" coords="170,137,223,211" shape="rect">
    <area target="_parent" alt="DI (DataIn) - Dateneingang für das WS2811-Modul. Kommt vom Verteiler oder einem vorherigen Modul bzw einer WS2812-LED" title="DI (DataIn) - Dateneingang für das WS2811-Modul. Kommt vom Verteiler oder einem vorherigen Modul bzw einer WS2812-LED" href="#" coords="223,134,282,213" shape="rect">
    <area target="_parent" alt="DO (DataOut) - Datenausgang für das WS2811-Modul. Geht zurück zum Verteiler oder weiter zum nächsten Modul bzw einer WS2812-LED" title="DO (DataOut) - Datenausgang für das WS2811-Modul. Geht zurück zum Verteiler oder weiter zum nächsten Modul bzw einer WS2812-LED" href="#" coords="53,148,105,214" shape="rect">
    <area target="_parent" alt="GND / Masse vom LED-Bus zum WS2811-Modul" title="GND / Masse vom LED-Bus zum WS2811-Modul" href="#" coords="283,135,328,212" shape="rect">
    <area target="_parent" alt="GND / Masse vom LED-Bus zum WS2811-Modul" title="GND / Masse vom LED-Bus zum WS2811-Modul" href="#" coords="4,147,52,215" shape="rect">
    <area target="_parent" alt="Kondensator 100nF" title="Kondensator 100nF" href="#" coords="32,121,73,140" shape="rect">
    <area target="_parent" alt="Widerstand 150Ω" title="Widerstand 150Ω" href="#" coords="88,121,138,146" shape="rect">
    <area target="_parent" alt="WS2811-IC in SMD-Bauweise" title="WS2811-IC in SMD-Bauweise" href="#" coords="6,38,146,120" shape="rect">
</map>

<map name="image-map2b">
    <area target="_parent" alt="Kanal &quot;R&quot; vom WS2811-Modul" title="Kanal &quot;R&quot; vom WS2811-Modul" href="#" coords="24,1,50,35" shape="rect">
    <area target="_parent" alt="Kanal &quot;G&quot; vom WS2811-Modul" title="Kanal &quot;G&quot; vom WS2811-Modul" href="#" coords="88,3,111,37" shape="rect">
    <area target="_parent" alt="Kanal &quot;B&quot; vom WS2811-Modul" title="Kanal &quot;B&quot; vom WS2811-Modul" href="#" coords="115,5,143,35" shape="rect">
    <area target="_parent" alt="5V vom WS2811-Modul" title="5V vom WS2811-Modul" href="#" coords="54,1,87,37" shape="rect">
    <area target="_parent" alt="Kanal &quot;R&quot; vom WS2811-Modul" title="Kanal &quot;R&quot; vom WS2811-Modul" href="#" coords="276,0,311,57" shape="rect">
    <area target="_parent" alt="Kanal &quot;G&quot; vom WS2811-Modul" title="Kanal &quot;G&quot; vom WS2811-Modul" href="#" coords="209,2,246,54" shape="rect">
    <area target="_parent" alt="Kanal &quot;B&quot; vom WS2811-Modul" title="Kanal &quot;B&quot; vom WS2811-Modul" href="#" coords="177,2,209,58" shape="rect">
    <area target="_parent" alt="5V vom WS2811-Modul" title="5V vom WS2811-Modul" href="#" coords="248,2,275,55" shape="rect">
    <area target="_parent" alt="5V vom LED-Bus zum WS2811-Modul" title="5V vom LED-Bus zum WS2811-Modul" href="#" coords="10,164,64,213" shape="rect">
    <area target="_parent" alt="5V vom LED-Bus zum WS2811-Modul" title="5V vom LED-Bus zum WS2811-Modul" href="#" coords="279,108,322,212" shape="rect">
    <area target="_parent" alt="DI (DataIn) - Dateneingang für das WS2811-Modul. Kommt vom Verteiler oder einem vorherigen Modul bzw einer WS2812-LED" title="DI (DataIn) - Dateneingang für das WS2811-Modul. Kommt vom Verteiler oder einem vorherigen Modul bzw einer WS2812-LED" href="#" coords="215,81,274,215" shape="rect">
    <area target="_parent" alt="DO (DataOut) - Datenausgang für das WS2811-Modul. Geht zurück zum Verteiler oder weiter zum nächsten Modul bzw einer WS2812-LED" title="DO (DataOut) - Datenausgang für das WS2811-Modul. Geht zurück zum Verteiler oder weiter zum nächsten Modul bzw einer WS2812-LED" href="#" coords="65,162,100,215" shape="rect">
    <area target="_parent" alt="GND / Masse vom LED-Bus zum WS2811-Modul" title="GND / Masse vom LED-Bus zum WS2811-Modul" href="#" coords="100,164,158,214" shape="rect">
    <area target="_parent" alt="GND / Masse vom LED-Bus zum WS2811-Modul" title="GND / Masse vom LED-Bus zum WS2811-Modul" href="#" coords="168,82,217,214" shape="rect">
    <area target="_parent" alt="Kondensator 100nF" title="Kondensator 100nF" href="#" coords="96,39,144,63" shape="rect">
    <area target="_parent" alt="Widerstand 150Ω" title="Widerstand 150Ω" href="#" coords="26,38,93,61" shape="rect">
    <area target="_parent" alt="WS2811-IC in SMD-Bauweise" title="WS2811-IC in SMD-Bauweise" href="#" coords="14,65,151,162" shape="rect">
</map>
<table style=" border: 3px solid; border-collapse: collapse; border-spacing: 0;">
	<tr>
		<th style=" border: 2px solid;">Variante 1</th>
		<th style=" border: 2px solid;">Variante 2</th>
	</tr>
	<tr>
		<td style=" border: 2px solid;"><img src="https://wiki.mobaledlib.de/_media/bilder/anleitungen/hilfestellungen/ws2811/ws2811-modul_v1.jpg" usemap="#image-map2a"></td>
		<td style=" border: 2px solid;"><img src="https://wiki.mobaledlib.de/_media/bilder/anleitungen/hilfestellungen/ws2811/ws2811-modul_v2.jpg" usemap="#image-map2b"></td>
	</tr>
</table>

</code></webcode>



===== Anschlussbeispiele =====

<WRAP round info 100%>
Alle hier gezeigten Schaltbilder orientieren sich an den [[anleitungen:hilfestellungen:kabelfarben|Standard-Kabelfarben]] der MobaLedLib.
</WRAP>

==== WS2811 und normale LEDs ====
{{:bilder:anleitungen:hilfestellungen:ws2811:ws2811_leds.jpg?nolink&1000|}}
----

{{bilder:anleitungen:hilfestellungen:ws2811:anschlussbeispiele_ws2811_led_relais.jpg}}

<WRAP round tip 100%>
Relais, die per WS2811 geschaltet werden, neigen bedingt durch das PWM-Signal zum Pfeifen. Dies kann ganz einfach durch jeweils einen 100nF Keramikkondensator zwischen Plus und Minus (Rot, Grün und/oder Blau) unterbunden werden.
</WRAP>


====== WS2811 parallel ======
Hier ein Anschlussbeispiel für zwei parallel geschaltete WS2811 mit sechs PLCC2 LEDs (3528) zur Ausleuchtung großer Räume. \\

{{:bilder:anleitungen:hilfestellungen:ws2811:ws2811_parallel.jpg?nolink&600|}}

Wenn in einem Raum vier oder mehr Einzel-LEDs gebraucht werden, um den Raum beispielsweise gleichmäßig auszuleuchten, können WS2811-Chips ganz einfach parallel angeschlossen werden. \\
Um all diese Einzel-LEDs innerhalb eines belebten Hauses gleichzeitig ein- und auszuschalten, muss der WS2811 beispielsweise mit der Funktion ROOM_BRIGHT angesteuert werden. \\
Näheres dazu findet man als Tipp in der Erklärung der [[anleitungen:effekte_mll#belebtes_haus|Belebtes Haus-Funktion]].   

<WRAP important 100%>
ACHTUNG: Das Signal für den Datenausgang (D Out) darf in diesem Fall nur von einem dieser parallel geschalteten WS2811 weiter gereicht werden.
</WRAP>

====== WS2811 mit 12 Volt ======

<wrap em>Vorsicht!</wrap> Bei Verwendung von sechspoligen Flachbandkabeln zwischen den Verteilern führt das Einspeisen von 12 Volt an einem Verteiler dazu, dass an allen Verteilern 12 Volt an Pin 6 anliegen. Das ist nicht weiter tragisch, solange man nicht die Leitungen 1 & 6 eines Flachbandkabels zwecks Erhöhung der Belastbarkeit kurzschließt. 

Für den Anschluss mehrerer LEDs in Reihe bietet es sich an, mit den maximal zulässigen 12 Volt zu arbeiten. So kann man beispielsweise eine Lichterkette für eine Pergola mit bis zu fünf LEDs an einen Strang anschließen. Mit einem WS2811 lassen sich somit bis zu 15 LEDs betreiben (jeweils 5 rote, grüne und/oder gelbe LEDs). Selbstverständlich lassen sich auf die einzelnen LEDs einer Reihe keine unterschiedlichen Effekte anwenden. Der gewählte Effekt (z.B. Neonlampe) wird von allen LEDs einer Reihe synchron durchgeführt.\\

<WRAP round alert 80%>
**ACHTUNG:** Mit 12 Volt ist am WS2811 die maximale Spannung erreicht. Das verwendete Netzteil muss also stabilisiert sein bzw. ist ein Step Down Wandler oder ein Festspannungsregler zwischenzuschalten! Andernfalls werden die WS2811 kurzfristig zu Rauchgeneratoren. 
</WRAP>

Bei der Anzahl der LEDs pro Reihenschaltung ist die Durchlass-Spannung je LED zu beachten, deren Summe 12 Volt nicht überschreiten sollte. Steht kein Datenblatt zur Verfügung, kann man sich an folgenden Werten orientieren. Der Strom, der durch jede Reihe fließt, wird auch hier auf die spezifischen 18,5 mA des WS2811 begrenzt, sodass kein Widerstand benötigt wird.\\

^ LED-Farbe ^ Farbe ^ LED-Stromfluss ^ LED-Spannung normal (spezifisch)^ 
| Rot | <color #ed1c24>█████</color> | 20 mA | 2,3 Volt (1,6–2,2 V)|
| Grün | <color #22b14c>█████</color> | 20 mA | 2,1 Volt (1,9–2,5 V)|
| Blau | <color #004EFF>█████</color> | 30 mA | 3,3 Volt (2,7–3,5 V)|
| Gelb | <color #fff200>█████</color> | 20 mA | 2,1 Volt (1,9–2,5 V)|
| Amber | <color #ff7f27>█████</color> | 40 mA | 2,0 Volt|
| Weiß |   | 20 mA | 3,6 Volt (2,7–3,5 V)|
| Pink | <color #ff69b4>█████</color> | 20 mA | 3,6 Volt|
| Türkis | <color #40E0D0>█████</color> | 20 mA | 3,8 Volt|
| Violett | <color #6600a1>█████</color> | 20 mA | 3,6 Volt|

Somit kann man eine Lichterkette mit den Farben\\
<color #ed1c24>██</color> <color #fff200>██</color> <color #22b14c>██</color> <color #004EFF>██</color> (9,8V) oder\\
<color #ed1c24>██</color> <color #fff200>██</color> <color #22b14c>██</color> <color #004EFF>██</color> 
<color #ed1c24>██</color> (12,1V) oder\\
<color #ed1c24>██</color> <color #fff200>██</color> <color #22b14c>██</color> <color #ed1c24>██</color> <color #fff200>██</color> (10,9V) oder\\
<color #004EFF>██</color> <color #004EFF>██</color> <color #004EFF>██</color> (9,9V)\\
bedenkenlos an einem 12 Volt-Ausgang betreiben.

Nicht vergessen darf man dabei, dass gerade in beleuchteten Kraftfahrzeugen bereits die 5 Volt Reihenschaltung von Vorteil ist:\\
<color #ed1c24>██</color> <color #ed1c24>██</color> (4,6V für zwei Rück- bzw. Bremsleuchten) oder\\
<color #fff200>██</color> <color #fff200>██</color> (4,2V für zwei Blinker links oder rechts) \\

**Anschluss-Schema am WS2811:**

{{:bilder:anleitungen:hilfestellungen:ws2811:ws2811_reihe.jpg?600|}}

<WRAP important 100%>
Einzel-LEDs und Reihenschaltungen können wie im oberen Beispiel gezeigt, im Mischbetrieb an einem WS2811 betrieben werden. Dabei sollten Einzel-LEDs aber nach wie vor mit 5 Volt versorgt werden und nur die Reihenschaltungen, die 12 Volt erfordern mit 12 Volt. Erforderlich werden 12 Volt bei mehr als einer blauen/weißen LED oder bei mehr als zwei roten/grünen/gelben LED. Bei nur zwei weißen/blauen bzw. drei roten LEDs ist ein zusätzlicher Widerstand innerhalb der Reihe erforderlich. 
</WRAP>


Dieselbe Schaltung lässt sich selbstverständlich auch an einem Ausgang eines [[anleitungen:bauanleitungen:521de_ws2811_extender24_v1-1|Single LED Connectors]] verwirklichen.\\

{{:bilder:anleitungen:hilfestellungen:ws2811:f7t165060p2483198n2_cujwiszd.png?600|}}

<WRAP round info 100%>
Die Reihenschaltung lässt sich selbstverständlich auch mit 5 Volt nutzen. So können beispielsweise Blinker/Warnblinker (2x Gelb), Rückleuchten oder Bremslichter (2x Rot) paarweise in Reihe an einen WS2811 angeschlossen werden. Je nach Anzahl der verbauten Fahrzeuge kann man somit eine Menge WS2811 einsparen. 
</WRAP>

====== WS2812 ======
Hier ein Anschlussbeispiel für zwei Ketten mit WS2812B. \\
Dabei sind jeweils vier RGB-LEDs in einer Reihe geschaltet. \\
Von der letzten LED geht ein Kabel zurück zum Flachbandkabel, damit das LED-Signal wieder zurück zum Verteiler kommt. \\
Jede LED ist dabei mit Ihrer Vorder- und Rückseite abgebildet. \\
{{bilder:vorlagen:ws281x:2xws2812_verteiler_grafik.jpg?720|direct}}

====== WS2812 parallel ======
Hier ein Anschlussbeispiel für zwei parallel geschaltete WS2812B. \\

Wenn in einem Raum zwei oder mehr RGB-LEDs gebraucht werden, um den Raum beispielsweise gleichmäßig auszuleuchten, können WS2812B-LEDs ganz einfach parallel angeschlossen werden. \\
Diese parallel angeschlossenen LEDs bekommen alle das gleiche Signal für den Dateneingang und reagieren somit auch synchron.

{{:bilder:anleitungen:hilfestellungen:ws2812_parallel.png?320|}}

Das folgende Bild zeigt fünf große Räume. Im Programm Generator werden nur die fünf LEDs der oberen Reihe definiert. Alle LEDs ab der zweiten Reihe abwärts sind für den Arduino unsichtbar.
Das ist ein zusätzlicher Vorteil ggü. dem CopyLED-Befehl, denn im gezeigten Beispiel unten belegen 12 der 17 LEDs keinen Speicherplatz auf dem Arduino.

Diese Anschlussmöglichkeit ist immer dann empfehlenswert, wenn die LED immer und in jedem Fall exakt das gleiche tun soll wie eine andere. Es bietet sich auch bei einem Farbwechsel an, der bspw. eine Burg oder ein Viadukt beleuchtet. Wenn von vornherein klar ist, dass alle LEDs, die das Objekt anstrahlen immer dieselbe Farbe erzeugen sollen, könnte man hier ganz viele LEDs zu einer zusammenfassen.

{{:bilder:anleitungen:hilfestellungen:ws2812b_parallel.jpg?800|}}

<WRAP important 100%>
ACHTUNG: Das Signal für den Datenausgang (D Out) darf in diesem Fall nur von einer dieser parallel geschalteten WS2812B weiter gereicht werden.
</WRAP>