Quelltext der Seite Art-Net-Node für 25 Euro

{{Infobox Selbstbauprojekt
| Name = 
| Logo = 
| Hersteller = Stefan Krupop
| AktuelleVersion = 
| Status = fertig
| Lizenz = 
| Email = Stefan.Krupop@dmxcontrol.de
| Homepage = 
| Download = 
}}

= Beschreibung =
Ziel:
* Realisierung eines besonders preiswerten Ethernet->DMX-Wandlers (Art-Net Node)


= Was ist Art-Net? =

Kurz gesagt ist Art-Net ein Netzwerkprotokoll, mit dem DMX-Werte über ein normales Ethernet-Netzwerk per UDP übertragen werden können. Weitere Details zum Protokoll und seinen Einsatzmöglichkeiten finden sich in diesem [[ArtNet|Wiki-Artikel]].

Um über Art-Net gewöhnliche DMX-Geräte ansteuern zu können braucht man einen Wandler, der zwischen Ethernet und DMX-Protokoll vermitteln kann, einen sogenannten Art-Net Node. Normalerweise gehören solche Geräte in die Profi-Liga und sind dementsprechend teuer (mehrere Hundert Euro). 

= Vorgeschichte =

[[Image:AvrArtNode-box.jpg|thumb|right|240px]]
Seit einiger Zeit bietet [http://www.pollin.de Pollin Electronic] einen Bausatz [http://www.pollin.de/shop/dt/MTQ5OTgxOTk-/Bausaetze_Module/Bausaetze/Bausatz_AVR_NET_IO.html AVR-NET-IO] zu einem sehr günstigen Preis von 19,95 € an. Mit dieser Platine ist es möglich, Steuerungsaufgaben über ein Netzwerk zu erledigen. Wie sich herausstellte, ist der Bausatz ähnlich genug zum [http://www.ulrichradig.de/home/index.php/avr/eth_m32_ex ETH_M32_EX]-Projekt von [http://www.ulrichradig.de/ Ulrich Radig], um dessen (quelloffene) Software einsetzen zu können.

Mit ein paar zusätzlichen Bauteilen zu einem Preis von ca. 5 € lässt sich der Bausatz leicht um eine Möglichkeit zur DMX-Ausgabe erweitern. Dann fehlt(e) nur noch die nötige Software, um die Platine Art-Net und DMX sprechen zu lassen...

= AvrArtNode =

[[Image:AvrArtNode-development.jpg|thumb|right|240px|Entwicklungschaos...]]
Das Ergebnis meiner Mühen ist eine angepasste Version der Firmware von Ulrich Radig, die von etlichen Funktionen befreit und dafür um Art-Net und DMX erweitert wurde. Die vorliegende Version bietet folgende Möglichkeiten:

*Kann wahlweise ein DMX-Universe senden (Art-Net =&gt; DMX) oder empfangen (DMX =&gt; Art-Net)
*Automatische Erkennung im Netzwerk (reagiert auf ArtPoll-Anfragen) 
*Über Netzwerk konfigurierbar: Name (Kurz- und Langname), Art-Net-Subnetz, Art-Net-Universes, IP-Einstellungen 
*Unterstützt die Standard-Netzwerkadressen 2.x.x.x, 10.x.x.x sowie eigene Konfigurationen

Da sowohl der TCP-Stack ([http://www.ulrichradig.de/ Ulrich Radig]) als auch die DMX-Routinen ([http://www.hoelscher-hi.de/hendrik/ Hendrik Hölscher]) der GPL unterliegen, wird die Art-Net-Firmware hier auch unter der GPL angeboten. Das Projekt kann hier heruntergeladen werden: 

*Fertig kompilierte Version: [[Media:AvrArtNode-compiled.zip|AvrArtNode-compiled.zip]]‎<br>(Achtung: MAC-Adresse entspricht dann nicht der des jeweiligen Bausatzes)
*Quelltexte: [[Media:AvrArtNode-source.zip|AvrArtNode-source.zip]]<br>Benötigt AVR-Studio 4 oder neuer und AVR-GCC bzw. WINAVR
*Programm, um Bootloader von Pollin zum Flashen zu verwenden: [[Media:AvrNetIOUpdater.zip|AvrNetIOUpdater.zip]]

''Update 31.01.09:'' Jetzt hat der AvrArtNode auch eine offiziell vergebene OEM-Id: 0x08b1. Diese wird nun in den ArtPollReply-Paketen gesendet.

''Update 02.04.10:'' Firmware erweitert! Mit der neuen Version [http://nebel-werfer.de/projekte/avrartnodev2_0/download.php?download=1&file_name=AvrArtNodeV2_0.zip AvrArtNodeV2_0] (erweitert von [mailto:ulrich.betz@nebel-werfer.de Ulrich Betz]) ist es jetzt möglich, auf zwei Universen gleichzeitig zu senden bzw. zu empfangen. Die Firmware ist nur kompatibel zu der [[ArtNet-Node/NetNode_auf_einer_Platine|neuen Platine]] von Morpheus238 in Verbindung mit einem ATMega644p.


'''ACHTUNG:''' Das Projekt scheint (zumindest laut Hennes DMX-Tester) korrekt zu funktionieren. Dennoch übernehme ich keine Haftung für eventuell auftretende Probleme. Bitte beachten Sie, dass es sich um kein professionell getestetes Produkt mit irgendwelchen Garantien handelt. Es wurden auch keine Vorkehrungen getroffen, um einen stabilen Betrieb zu garantieren. In kritischen Situationen sollte also evtl. ein professionelleres Gerät in Betracht gezogen werden!

[[Image:AvrArtNode-complete.jpg|thumb|center|480px|Fertiggestellter AvrArtNode]]

= Aufbau =
== Hardware ==

Zunächst wird der Bausatz wie in der beigelegten Anleitung aufgebaut und in Betrieb genommen. Sollte die Platine zunächst nicht aus dem Netzwerk erreichbar sein (wie bei mir), können die Informationen auf der mikrocontroller.net-Seite zum Bausatz sehr hilfreich sein: [http://www.mikrocontroller.net/articles/AVR_Net-IO_Bausatz_von_Pollin AVR Net-IO Bausatz von Pollin].

Funktioniert alles mit der vorgegebenen Firmware, kann im nächsten Schritt die sehr einfache DMX-Erweiterung aufgebaut werden. Hierzu sind nur wenige Bauteile notwendig:

{| {{prettytable}}
|-
| Menge<br> 
| Reichelt-Bestellnr.<br> 
| Bezeichnung<br> 
| Preis<br>
|-
| 1<br> 
| SN 75176BP<br> 
| SN 75176<br> 
| 0,30€<br>
|-
| 1<br> 
| NT 02<br> 
| DIP-Schalter, 2polig<br> 
| 0,32€<br>
|-
| 1<br> 
| XLR 3ES<br> 
| XLR-Einbaustecker, 3polig<br> 
| 0,95€<br>
|-
| 1<br> 
| XLR 3EB-N<br> 
| XLR-Einbaubuchse, 3polig<br> 
| 0,52€<br>
|-
| 1<br> 
| PFL 10<br> 
| 2x5-Pol Pfostenverbinder<br> 
| 0,55€<br>
|-
| 1<br> 
| GS 8P<br> 
| IC-Sockel 8polig<br> 
| 0,10€<br>
|-
| 1<br> 
| AWG 28-10G 3M<br> 
| Flachbandkabel, 10polig<br> 
| 2,05€<br>
|-
| 1<br> 
| H25PR050<br> 
| Lochrasterplatine<br> 
| 0,63€<br>
|}

Die teuerste Komponente ist also das Flachbandkabel, von dem es leider bei Reichelt nur eine 3m-Rolle gibt. Benötigt werden eigentlich nur wenige Zentimeter...

Die Bauteile können leicht auf einer Lochrasterplatine nach folgendem Schaltplan verbunden werden:

[[Image:AvrArtNode-schematics.png|center|Schaltplan]] 

Das fertige Ergebnis kann dann so aussehen:

{| align="center"
|-
| [[Image:AvrArtNode-dmx.jpg|thumb|center|240px|DMX-Zusatzplatine (Bauteilseite)]] 
| [[Image:AvrArtNode-dmx-solder.jpg|thumb|center|240px|DMX-Zusatzplatine (Lötseite)]]
|}

Verbunden wird die kleine Zusatzplatine hauptsächlich über den "EXT."-Erweiterungsanschluss auf dem AVR-NET-IO-Board. Leider führt dieses nicht die für die DMX-Ausgabe nötigen seriellen Signale, so dass diese direkt vom Mikrocontroller an den Pins 14 und 15 abgegriffen werden müssen:

[[Image:AvrArtNode-serial.jpg|thumb|center|240px|Abgriff der TXD- und RXD-Signale]]
Damit ist der Hardware-Aufbau abgeschlossen. Nun fehlt nur noch die richtige Firmware, um den Art-Net Node zu komplettieren.

== Hardware alternativ (alles auf eine Platine) ==

'''Abschnitts-Autor'''
* [[http://www.dmxcontrol.de/forum/index.php?page=User&userID=668 Stefan]]

Für den Art-Net Node braucht man eigentlich gar nicht alle Möglichkeiten, welche die Platine bietet. Man braucht Stromversorgung, Netz-Anschluss, Mikrocontroller - weg bleiben können RS232-Treiber und -Anschluss, EXT-Buchse (ISP-Buchse brauchen wir aber zum Programmieren), 25-Pol D-SUB Buchse und der AREF-Jumper
Im Detail werden die Bauteile J3 - J10, EXT., C14 - C17 und IC4 weggelassen.

Nachdem man an der Platine für den Umbau auf DMX eh Änderungen machen muss (Pin 14 und 15 des AVRs sind auf keine Anschlüsse herausgeführt) bietet es sich nicht nur aufgrund des Platzbedarfs an, alles auf eine Platine zu löten.

Dafür sind dann nur noch folgende Bauteile notwendig:

{| {{prettytable}}
|-
| Menge<br> 
| Reichelt-Bestellnr.<br> 
| Bezeichnung<br> 
| Preis<br>
|-
| 1<br> 
| SN 75176BP<br> 
| SN 75176<br> 
| 0,30 €<br>
|-
| 1<br> 
| GS 8<br> 
| IC-Sockel 8polig<br> 
| 0,03 €<br>
|-
| 1<br> 
| NT 02<br> 
| DIP-Schalter, 2polig<br> 
| 0,32 €<br>
|-
| 1<br> 
| XLR 3ES-N<br> 
| XLR-Einbaustecker, 3polig<br> 
| 0,40 €<br>
|-
| 1<br> 
| XLR 3EB-N<br> 
| XLR-Einbaubuchse, 3polig<br> 
| 0,52 €<br>
|-
| <br> 
| <br> 
| '''Summe'''<br> 
| 1,57 €<br>
|}

Der RS485 Leitungstreiber (SN 75176) wird dann an dem Platz von IC4 eingelötet, und zwar so, dass der Pin 1 des ICs auf Pin 11 des IC4 liegt.

Der DIP-Schalter wird auf Pin 7-10 des IC4 gelötet (braucht dann etwas Kraft).

Bei J4 wird AREF fest über eine Drahtbrücke mit int. verbunden.

Nun sind auf der Unterseite der Platine noch zwei Leiterbahnen, die Verbindung von AVR Pin 14 + 15 nach IC4, zu unterbrechen (auf nachfolgendem Bild beim AVR zwischen Pin 19 und 20 sichtbar), und folgende Verbindungen herzustellen:
* IC4 Pin 6 -> IC4 Pin 16 (VCC SN 75176)
* IC4 Pin 3 -> IC4 Pin 15 (GND SN 75176)
* IC4 Pin 15 -> IC4 Pin 9 + 10 (GND DIP-Schalter)
* IC4 Pin 7 -> AVR Pin 1
* IC4 Pin 8 -> AVR Pin 4
* IC4 Pin 11 (R SN 75176) -> AVR Pin 14 (RXD AVR)
* IC4 Pin 12 + 13 -> AVR Pin 17
* IC4 Pin 14 (D SN 75176) -> AVR Pin 15 (TXD AVR)

Die DMX-Buchsen sind dann hier anzuschließen:
* XLR Pin 1 -> C14 + (GND)
* XLR Pin 2 -> C15 - (DMX -)
* XLR Pin 3 -> C15 + (DMX +)

Das fertige Ergebnis kann dann so aussehen:

{| align="center"
|-
| [[Image:AvrArtNode-aio-front.jpg|thumb|center|240px|Art-Net Node (Bauteilseite)]] 
| [[Image:AvrArtNode-aio-back.jpg|thumb|center|240px|Art-Net Node (Lötseite)]]
|}

Damit ist der Hardware-Aufbau abgeschlossen. Nun fehlt nur noch die richtige Firmware, um den Art-Net Node zu komplettieren.

== Software ==
=== Anpassen und kompilieren ===
Bevor die Firmware kompiliert wird, sollten die MAC-Adresse und evtl. die Default-IP-Adresse angepasst werden. Beide Parameter werden in der Datei "config.h" eingestellt:

[[Image:AvrArtNode-ip.png]]<br>
[[Image:AvrArtNode-mac.png]]

Die angegebene IP-Adresse sollte im gleichen Subnetz wie der zum Konfigurieren benutzte PC liegen, damit der Art-Net Node nach dem Programmieren auch erreichbar ist.
Die anzugebende MAC-Adresse finden sie auf der Verpackung des Netzwerkcontroller-ICs im Bausatz.

Nachdem diese Angaben erledigt sind, kann die Firmware kompiliert werden (Taste F7). Die Kompilierung sollte keine Fehler oder Warnungen liefern:
'''Build succeeded with 0 Warnings...'''

Die entstandene Datei "AvrArtNode.hex" (im Verzeichnis "default") kann dann auf den Controller geflasht werden.

=== Controller programmieren ===

Der Controller kann regulär mit dem Hex-File beschrieben werden. Zu beachten ist nur, dass die Fuse-Bits korrekt gesetzt sind und evtl. das EEPROM vorher gelöscht wurde.
Die Fuses sollten wie folgt gesetzt werden (High: 0xC9, Low: 0x8F):

[[Image:AvrArtNode-fuses.png|center]]

Ist der Controller einmal programmiert, kann die Fuse "EESAVE" auch wieder aktiviert werden, um bei einem eventuellen neuprogrammieren nicht die geänderten Einstellungen zu verlieren.

=== Controller mit Bootloader programmieren ===

Die AVR-NET-IO-Platine wird mit einem vorinstallierten Bootloader ausgeliefert, der das installieren einer neuen Firmware ohne speziellen Programmer über die serielle Schnittstelle erlaubt.
[[Media:AvrNetIOUpdater.zip|Hier]] kann ein kleines Programm heruntergeladen werden, was diesen Bootloader ansprechen kann um beliebige Hex-Files auf den Controller zu flashen. Starten Sie dazu nach dem Download das Programm, wählen Com-Port und Hex-Datei aus und folgen Sie den Anweisungen.

= Benutzung =

Der fertige AvrArtNode hat als Bedienelemente nur zwei Dipschalter - alle anderen Einstellungen werden per Netzwerk über das Art-Net-Protokoll vorgenommen.

Die DIP-Schalter haben folgende Bedeutung: 

{| {{prettytable}}
|-
| rowspan="2" | Schalter 1: Datenrichtung
| Ein 
| DMX =&gt; Art-Net
|-
| Aus 
| Art-Net =&gt; DMX
|-
| rowspan="2" | Schalter 2: Netzwerkkonfiguration
| Ein 
| Art-Net IP 2.x.x.x
|-
| Aus 
| Art-Net IP 10.x.x.x
|}

Ein neu programmierter AvrArtNode startet zunächst mit der in der Firmware hinterlegten Default-Adresse (wenn nicht geändert: 192.168.0.90). Hat der PC eine IP-Adresse aus dem gleichen Subnetz (z.B. 192.168.0.2), sollte der AvrArtNode von Art-Net-kompatiblen Programmen erkannt werden. Am Beispiel von "[http://www.artisticlicence.com/WebSiteMaster/Software/dmxworkshopsetup.msi DMX-Workshop]"sollte das wie folgt aussehen:

[[Image:AvrArtNode-dmxworkshop.png|center]]
Ein Rechtsklick auf den Node bringt dann ein Kontextmenü zum Vorschein, mit dem der Knoten konfiguriert werden kann.

[[Kategorie: Selbstbau-Projekte]]