DMX in Home Assistant: Beleuchtung per Art-Net steuern
· 8 Min. Lesezeit

DMX in Home Assistant: Beleuchtung per Art-Net steuern

DMX in Home Assistant einbinden: Showtec NET-2/3 als Art-Net-Node konfigurieren, Scheinwerfer adressieren und als Licht-Entität automatisieren.

Affiliate-Hinweis: Einige Links in diesem Artikel sind Affiliate-Links. Beim Kauf über diese Links erhalten wir eine kleine Provision — für dich ändert sich am Preis nichts.

Mit DMX in Home Assistant steuerst du vorhandene Bühnenleuchten wie normale Licht-Entitäten: Farbe, Helligkeit und Übergänge landen im Dashboard und in Automationen. Dazwischen sitzt ein Art-Net-Node wie der Showtec NET-2/3 Pocket, der Netzwerkpakete in das elektrische DMX-Signal übersetzt. Diese Anleitung zeigt das komplette Setup am Beispiel eines RGB-Fluters mit vier DMX-Kanälen.

So funktioniert DMX in Home Assistant

Home Assistant sendet in diesem Aufbau keine DMX-Signale über USB. Eine Community-Integration erzeugt Art-Net-Pakete im lokalen Netzwerk. Der Art-Net-Node empfängt sie per Ethernet und gibt an seiner XLR-Buchse ein klassisches DMX512-Signal aus. Die Signalkette sieht so aus:

Home Assistant → Ethernet/Art-Net → Showtec NET-2/3 → DMX-Kabel → LED-Fluter

Das ist vor allem dann sinnvoll, wenn DMX-Leuchten bereits vorhanden sind oder du mehrere robuste, kabelgebundene Scheinwerfer gemeinsam automatisieren willst. Für einen einzelnen LED-Streifen ist WLED mit ESP32 meist einfacher und günstiger. Normale Zigbee-Lampen passen dagegen besser zu einer klassischen smarten Beleuchtung mit Home Assistant.

Wichtig: Die hier verwendete Art-Net-Anbindung gehört nicht zum Home-Assistant-Core. Sie wird als benutzerdefinierte Integration installiert. Ein Home-Assistant-Update kann deshalb Anpassungen nötig machen. Prüfe vor einem Update die Versionshinweise und halte ein Backup bereit.

Hardware: Art-Net-Node, Leuchte und DMX-Kabel

Der im Briefing vorgesehene Showtec NET-2/3 Pocket passt technisch sehr gut. Laut Hersteller stellt er zwei DMX-Universen als Ein- oder Ausgang bereit, unterstützt Art-Net und sACN und lässt sich per Netzteil oder PoE versorgen. Seine beiden dreipoligen XLR-Ports passen ohne Adapter zu vielen günstigen DMX-Flutern. Das Gerät ist mit IP20 ausschließlich für trockene Innenräume gedacht.

Falls der Showtec nicht verfügbar ist, übernimmt ein Pknight CR021R mit zwei DMX-Universen dieselbe grundsätzliche Aufgabe. Nutze nicht beide Nodes gleichzeitig für dasselbe Universum. Für diese Anleitung bleibt der Showtec die Referenz, weil Display und Weboberfläche die Fehlersuche erleichtern.

Als Leuchte eignet sich zum Beispiel das Stairville LED Flood Panel 150 40° RGB. Thomann nennt drei, vier oder acht DMX-Kanäle; für Home Assistant ist der übersichtliche 4-Kanal-Modus ideal: Gesamtdimmer, Rot, Grün und Blau. Der Fluter besitzt dreipolige DMX-Ein- und Ausgänge. Ein vergleichbares, konkret bei Amazon erhältliches Set ist das U’King 1082X4 mit DMX-Steuerung. Übernimm dessen Kanalbelegung aber aus dem mitgelieferten Handbuch und nicht ungeprüft aus dem Stairville-Beispiel.

Zusätzlich brauchst du ein echtes DMX-Kabel mit 110 bis 120 Ohm Wellenwiderstand und am Ende einer längeren Kette einen 120-Ohm-Abschlussstecker. Ein Mikrofonkabel hat zwar dieselben XLR-Stecker, kann bei längeren Strecken aber Reflexionen und sporadisches Flackern verursachen. Verkette die Geräte immer von DMX OUT zu DMX IN; sternförmige Abzweigungen benötigen einen aktiven DMX-Splitter.

DMX-Leuchten arbeiten meist direkt an 230 Volt. Öffne weder Leuchte noch Netzteil und verändere keine Netzanschlüsse. Festinstallationen und Arbeiten an der Elektroinstallation gehören in die Hände einer Elektrofachkraft.

Showtec NET-2/3 für Art-Net einrichten

Verbinde den Showtec per Ethernet mit demselben lokalen Netz, in dem Home Assistant erreichbar ist. Eine Kabelverbindung ist für dauerhaftes Licht sinnvoller als eine WLAN-Brücke. Weise dem Node im Router eine feste DHCP-Zuordnung zu. Die IP-Adresse darf sich später nicht ändern, weil sie in der Home-Assistant-Konfiguration steht.

Öffne anschließend die Weboberfläche des NET-2/3. Stelle den verwendeten XLR-Port als DMX-Ausgang ein, wähle Art-Net und ordne ihm ein freies Universum zu. Für das erste Setup reicht ein Port mit einem Universum. Notiere die im Showtec angezeigte Universe-/Port-Zuordnung genau.

Bei Art-Net beginnen manche Oberflächen mit Universum 0, andere zeigen das erste Universum als 1 an. Entscheidend ist nicht die Beschriftung, sondern dass Sender und Node denselben numerischen Wert verwenden. Wenn trotz sichtbarer Netzwerkaktivität kein DMX-Signal ankommt, ist dieser Versatz der erste Prüfpunkt.

Setze nun den Stairville-Fluter in den 4-Kanal-DMX-Modus und gib ihm die Startadresse 1. Damit belegt er die Kanäle 1 bis 4. Ein zweiter identischer Fluter beginnt auf Adresse 5. Sollen beide stets synchron leuchten, dürfen sie auch dieselbe Startadresse verwenden.

Art-Net-Integration in Home Assistant installieren

Das Projekt ha-artnet-led wird als benutzerdefiniertes HACS-Repository eingebunden:

  1. Öffne HACS und gehe zu „Integrationen“.
  2. Füge unter „Benutzerdefinierte Repositories“ die URL https://github.com/Breina/ha-artnet-led mit der Kategorie „Integration“ hinzu.
  3. Suche nach „Art-Net LED Lighting for DMX“, installiere die Integration und starte Home Assistant neu.

Falls HACS noch nicht eingerichtet ist, folge ausschließlich der aktuellen HACS-Dokumentation. Kopiere keine zufälligen Installationsbefehle aus alten Forenbeiträgen. Benutzerdefinierter Code läuft innerhalb von Home Assistant und sollte deshalb aus einem nachvollziehbaren Repository stammen.

Die Geräte werden anschließend in der configuration.yaml beschrieben. Das folgende Beispiel bildet den Stairville im 4-Kanal-Modus als eine RGB-Licht-Entität ab:

light:
  - platform: artnet_led
    host: 192.168.10.50
    port: 6454
    node_type: artnet-direct
    max_fps: 25
    refresh_every: 0
    universes:
      0:
        send_partial_universe: true
        devices:
          - channel: 1
            name: "DMX Fluter Wohnzimmer"
            type: rgb
            channel_setup: drgb
            transition: 0.5

Ersetze 192.168.10.50 durch die reservierte Adresse des Showtec. channel: 1 ist die Startadresse des Fluters. Das Schema drgb bedeutet Gesamtdimmer, Rot, Grün und Blau und entspricht damit dem 4-Kanal-Modus des Stairville. Für eine andere Leuchte musst du Reihenfolge und Anzahl der Kanäle aus ihrem Handbuch übernehmen.

Der Standardport für Art-Net ist 6454. artnet-direct sendet gezielt an die IP-Adresse des Nodes. Das reduziert unnötigen Broadcast-Verkehr. Mit max_fps: 25 werden Übergänge flüssig genug dargestellt, ohne die maximal mögliche Bildrate auszureizen. Speichere die Datei, prüfe die YAML-Konfiguration und starte Home Assistant neu.

Funktion prüfen und typische Fehler finden

Öffne nach dem Neustart die neue Licht-Entität und teste zunächst Helligkeit, dann Rot, Grün und Blau einzeln. Stimmen Farben nicht, ist meist die Kanalreihenfolge falsch. Zeigt Rot beispielsweise Grün an, korrigierst du channel_setup passend zum Gerätehandbuch, etwa von drgb zu dgrb.

Wenn die Leuchte gar nicht reagiert, gehe die Kette in dieser Reihenfolge durch:

  • Erreicht Home Assistant die feste IP-Adresse des Nodes?
  • Zeigt der Showtec eingehende Netzwerk- und ausgehende DMX-Aktivität?
  • Stimmen Art-Net-Universum und DMX-Startadresse überein?
  • Läuft die Leuchte wirklich im richtigen DMX-Kanalmodus?
  • Steckt das Kabel in DMX OUT des Nodes und DMX IN der Leuchte?

Flackern mehrere Geräte zufällig, prüfe DMX-Kabel, Abschlusswiderstand und Verkettung. Netzwerkprobleme zeigen sich eher dadurch, dass alle Leuchten eines Universums gleichzeitig nicht mehr aktualisiert werden. Ein eigenes VLAN ist möglich, aber Firewall-Regeln müssen den UDP-Verkehr von Home Assistant zum Node auf Port 6454 erlauben.

Strobe-, Makro- oder Sound-to-Light-Kanäle solltest du nicht blind in eine normale RGB-Entität aufnehmen. Ein falscher fester Wert kann einen Effekt aktivieren. Beginne mit dem kleinsten DMX-Modus, der Dimmer und Farben direkt abbildet.

DMX-Licht sinnvoll automatisieren

Nach der Einrichtung verhält sich der Fluter wie andere light-Entitäten. Du kannst ihn in Szenen gruppieren, über das Dashboard dimmen oder in Home-Assistant-Automationen an Präsenz, Uhrzeit und Medienwiedergabe koppeln.

Dieses Beispiel schaltet den Fluter bei erkannter Bewegung abends für zehn Minuten warm gedimmt ein:

alias: "DMX-Fluter bei Bewegung"
triggers:
  - trigger: state
    entity_id: binary_sensor.bewegung_keller
    to: "on"
conditions:
  - condition: sun
    after: sunset
actions:
  - action: light.turn_on
    target:
      entity_id: light.dmx_fluter_wohnzimmer
    data:
      rgb_color: [255, 120, 35]
      brightness_pct: 35
      transition: 1
  - delay: "00:10:00"
  - action: light.turn_off
    target:
      entity_id: light.dmx_fluter_wohnzimmer
    data:
      transition: 2
mode: restart

Für Alltagsbeleuchtung solltest du dezente Übergänge und eine begrenzte Helligkeit verwenden. Schnelle Farbwechsel und Stroboskop-Effekte sind für Automationen in Wohnräumen ungeeignet und können Menschen gesundheitlich belasten. Automatisiere außerdem keine bewegten Scheinwerfer, Nebelmaschinen oder pyrotechnischen Geräte nach diesem einfachen Lichtschema.

FAQ zu DMX und Home Assistant

Brauche ich für DMX in Home Assistant zwingend HACS?

Für die hier beschriebene direkte Art-Net-Lichtsteuerung ja. ha-artnet-led ist eine Community-Integration und kein Bestandteil von Home Assistant Core. Alternativ kann externe Lichtsoftware Art-Net empfangen und über andere Schnittstellen mit Home Assistant gekoppelt werden, das ist aber deutlich aufwendiger.

Kann der Showtec NET-2/3 zwei Universen gleichzeitig ausgeben?

Ja. Der Hersteller spezifiziert zwei DMX-Universen als Ein- oder Ausgang. In Home Assistant legst du dafür einen zweiten Universe-Block an und ordnest den zweiten Showtec-Port entsprechend zu. Für wenige Fluter bringt ein zweites Universum noch keinen Vorteil.

Funktionieren auch fünfpolige DMX-Leuchten?

Ja, sofern du einen korrekt beschalteten 3-auf-5-Pol-DMX-Adapter verwendest. Das Protokoll bleibt DMX512. Verwende keinen beliebigen Audioadapter und kontrolliere die Pinbelegung in beiden Gerätehandbüchern.

Bleibt das Licht bei einem Home-Assistant-Ausfall an?

Das hängt vom Node und von der Leuchte ab. DMX-Geräte können den letzten empfangenen Wert halten oder bei Signalverlust abschalten. Plane sicherheitskritische Beleuchtung deshalb unabhängig von Home Assistant und teste das Verhalten, indem du den Sender kontrolliert stoppst.

Fazit: gut für vorhandene DMX-Technik

DMX in Home Assistant lohnt sich, wenn du vorhandene Bühnenleuchten kabelgebunden in Szenen und Automationen übernehmen willst. Der Showtec NET-2/3 Pocket ist dafür mit zwei Universen, PoE und Weboberfläche eine schlüssige Brücke. Für ein oder zwei gewöhnliche Wohnraumlampen ist das Setup dagegen unnötig komplex; dort sind Zigbee oder WLED wartungsärmer. Wer DMX nutzt, sollte Kanalplan, feste IP-Adresse und Universe-Zuordnung sauber dokumentieren — dann bleibt die Anlage auch Monate später nachvollziehbar.

Philipp Just

Gründer & Autor

Schreibt über Home Assistant, ESP32 und alles was das Smart Home smarter macht.