Saltar al contenido principal

Integración domótica Art-Net, gratuita y de código abierto

Integración Art-Net para Gladys Assistant

DMX stage lighting through an Art-Net node, on the local network.

info

La documentación de esta integración la escribe su autor y, por ahora, solo está disponible en inglés.

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​

  1. 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.

  2. 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:

      ProfileChannelsGladys features
      dimmerintensityon/off, brightness
      rgbred, green, blueon/off, brightness, colour
      rgbwred, green, blue, whiteon/off, brightness, colour
      drgbintensity, red, green, blueon/off, brightness, colour
      drgbwintensity, red, green, blue, whiteon/off, brightness, colour
      cctcold white, warm whiteon/off, brightness, white temperature
    • name: up to 40 characters (optional: Fixture 1/4 otherwise).

    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.

  3. 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 /data unreadable, or /data still 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).

Parámetros de configuración​

Estos son los parámetros que Art-Net te pide en su pantalla de configuración en Gladys.

ParámetroTipoObligatorioDescripción
Getting startedsectionNoGive 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 addressstringSí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.
FixturesstringNoOne 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 namesselectNo

Cómo instalar Art-Net en Gladys​

  1. En Gladys, abre Integraciones: Art-Net aparece en el catálogo junto a las integraciones nativas, con una insignia de comunidad.
  2. Haz clic en Instalar. Gladys descarga la imagen Docker (ghcr.io/lm1lc3n7/gladys-artnet:0.1.1), la ejecuta en un entorno aislado del núcleo y genera la interfaz de la integración (dispositivos, descubrimiento y configuración).
  3. Abre la pantalla de Configuración de la integración, rellena los parámetros y guarda.
  4. También puedes instalarla directamente desde la URL de su repositorio: https://github.com/LM1LC3N7/gladys-artnet.

Art-Net requiere Gladys >=5.1.0. El catálogo de Gladys se actualiza cada hora, así que una nueva versión está disponible como máximo una hora después de publicarse.

¿Todavía no usas Gladys? Es gratuito y de código abierto: sigue la guía de instalación para empezar.

Sobre las integraciones externas​

Art-Net es una integración externa: una integración comunitaria empaquetada como contenedor Docker y publicada en GitHub. Gladys la instala con un clic y la ejecuta en un entorno aislado del núcleo. La publica y mantiene LM1LC3N7, no el equipo principal de Gladys.

Suscríbete a la newsletter de Gladys Assistant

Unos pocos correos al mes sobre nuevas versiones y novedades del proyecto. Enviados por Pierre-Gilles Leymarie, fundador del proyecto. Puedes darte de baja cuando quieras 🙂