Art-Net Smart-Home-Integration, kostenlos und Open Source

DMX stage lighting through an Art-Net node, on the local network.
Die Dokumentation dieser Integration wird von ihrem Autor geschrieben und ist bisher nur auf Englisch verfügbar.
Drives DMX stage lighting (dimmers, RGB, RGBW and white fixtures) from Gladys through an Art-Net node: the box that turns your local network into DMX512 lines. Everything stays on the local network (UDP port 6454), with no account and no cloud.
This integration has never been tested with a real node: only against a simulated node on the same machine. Please report how it behaves with yours. It is not affiliated with Artistic Licence nor with any lighting brand.
Art-Net™ Designed by and Copyright Artistic Licence. Art-Net is a protocol of Artistic Licence Engineering Ltd.
What you need
- An Art-Net node (Art-Net 3 or 4) on your network, with a fixed IP address (set it in your router or in the node).
- The DMX address of each fixture (set on the fixture: a display, DIP switches) and the universe of the DMX line it is plugged on (set in the node).
Configuration
-
Node IP address: the address of the node, for example
192.168.1.60. The port is 6454 unless you add another (192.168.1.60:6455). A broadcast address (ending in.255,2.255.255.255...) is refused: Art-Net 4 sends DMX to the node itself. -
Fixtures: one entry per fixture, separated by
;:[universe/]address profile name. Example:1 rgb Living room; 4 dimmer Bar; 2/10 cct Desk.-
universe: 1 to 32767 (the Port-Address of the node), 1 when left out; 0 is accepted when typed (
0/4): Art-Net 4 deprecates it, but many nodes still use it; -
address: 1 to 512, the first DMX channel of the fixture;
-
profile: the order of its channels:
Profile Channels Gladys features dimmerintensity on/off, brightness rgbred, green, blue on/off, brightness, colour rgbwred, green, blue, white on/off, brightness, colour drgbintensity, red, green, blue on/off, brightness, colour drgbwintensity, red, green, blue, white on/off, brightness, colour cctcold white, warm white on/off, brightness, white temperature -
name: up to 40 characters (optional:
Fixture 1/4otherwise).
An entry that cannot be read, that runs past channel 512 or that overlaps an earlier fixture is skipped: the status gives its position and the reason. At most 64 fixtures on 16 universes.
-
-
Language of the default names: the names given to fixtures without one and to the features.
Save: the fixtures appear in Discovery (one light each). Add them.
Assumed state
Art-Net sends DMX one way: a fixture never reports its state. Gladys shows the last command sent, and the badge of each fixture says the state is assumed. If someone changes a fixture with a lighting desk or its own buttons, Gladys does not know.
After a restart of the integration, every fixture is assumed off: nothing is sent until the first command, and that first command sends the whole universe, so the other fixtures of the universe go to 0 (Gladys shows them off). The DMX channels of a universe that are not in the fixtures list are sent at 0.
How the frames are sent
- A universe starts being sent at the first command, "off" or Blackout that touches it. Its frame (the whole universe, from channel 1 to the last channel used) then leaves after each change, 25 ms after the previous frame at the earliest (40 frames a second at most, the DMX512 limit is 44), and again every 900 ms without change, as Art-Net asks, until the integration stops.
- A frame is sent by unicast to the node address, from port 6454 when it is free (else from another port, said in the status: a few nodes ignore it).
- A command is answered once its frame left the network card. If it could not leave (network error), "on", brightness, colour and temperature are undone and the answer says nothing was sent.
Off and Blackout
"Off" (on/off at 0, or brightness 0) sets every channel of the fixture to 0. Blackout (button in the configuration, and scene action "Art-Net blackout") sets every known fixture, and every universe already sent, to 0.
They need no option and no configuration read: the node address and the
fixtures are also kept in /data, read as soon as the integration starts, so
they work right after a restart, before Gladys gives the configuration (before
it is read, they wait up to 1.5 s for a /data read in progress). They are not
held back by the 32-universe bound of a session. If a frame cannot leave, the
900 ms keep-alive tries it again until it does; when it finally leaves, Gladys
is told the fixture is off. Their only refusals:
- no node address known (none configured, nothing in
/data); - "off" only: a fixture not in the configuration; before the configuration is
read, a fixture not in
/data, or/dataunreadable, or/datastill not read after 1.5 s; - Blackout only: no fixture and no universe known (same cases);
- the integration is stopping.
If the node address in the configuration becomes invalid, "off" and Blackout go to the last valid one.
Buttons
- Test the node: sends an ArtPoll and shows the name the node gives in its ArtPollReply (3 s at most, once every 10 s). Some nodes answer only to port 6454, or not at all: this does not stop the DMX frames.
- Blackout (all fixtures at 0): see above.
Status
- Ready: N fixture(s), frames go to address:port: the configuration is valid.
- Frames do not leave for ... (code): the network refuses the datagrams (cable, address); they are tried again every second.
- Configuration not read: Gladys did not give it, tried again after 5 s, then up to every 5 min.
- Entries skipped: the position and reason of each entry in error.
- Storage /data unreadable / not writable: read again every 10 s; until then "off" and Blackout need the configuration.
Limits
- At most 32 universes started in one session (after several changes of the configuration): beyond, "on", brightness, colour and temperature are refused until the integration restarts; "off" and Blackout are not.
- One node. Several nodes, ArtPoll discovery, ArtSync and RDM are not done.
- 8-bit channels only (no 16-bit "fine" channels), no moving heads, no effects.
- Nothing is read back: the state is the last command sent.
Privacy
Nothing leaves your local network. /data keeps the node address and the
universe, address and profile of each fixture (not their names).
Konfigurationseinstellungen
Diese Einstellungen fragt Art-Net in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| Getting started | section | Nein | Give the IP address of your Art-Net node (the box that turns the network into DMX lines, fixed in your router) and list your fixtures. Art-Net never reports a state: Gladys shows the last command sent. Blackout (button below, or scene action) sets every fixture to 0. |
| Node IP address | string | Ja | IPv4 address of the Art-Net node, with an optional port (6454 by default). Never a broadcast address: Art-Net sends DMX to the node itself. |
| Fixtures | string | Nein | One entry per fixture, separated by ; written [universe/]address profile name. Universe 1 to 32767 (1 when left out; 0 accepted), address 1 to 512 (first DMX channel), profile: dimmer, rgb, rgbw, drgb, drgbw (d = intensity channel first) or cct (cold then warm white). |
| Language of the default names | select | Nein |
So installierst du Art-Net in Gladys
- Öffne in Gladys Integrationen: Art-Net erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/lm1lc3n7/gladys-artnet:0.1.1) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration). - Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
- Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/LM1LC3N7/gladys-artnet.
Art-Net benötigt Gladys >=5.1.0. Der Katalog in Gladys wird stündlich aktualisiert, eine neue Version ist also spätestens eine Stunde nach ihrer Veröffentlichung verfügbar.
Du nutzt Gladys noch nicht? Es ist kostenlos und Open Source: folge der Installationsanleitung, um loszulegen.
Über externe Integrationen
Art-Net ist eine externe Integration: eine Community-Integration, die als Docker-Container verpackt und auf GitHub veröffentlicht wird. Gladys installiert sie mit einem Klick und führt sie in einer vom Kern isolierten Sandbox aus. Sie wird von LM1LC3N7 veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.
- Alle Integrationen durchsuchen, native und aus der Community
- Deine eigene externe Integration bauen und veröffentlichen
- Quellcode auf GitHub — Quelle dieser Dokumentation