Art-Net


Art-Net is a royalty-free communications protocol for transmitting the DMX512-A lighting control protocol and Remote Device management protocol over the User Datagram Protocol of the Internet protocol suite. It is used to communicate between "nodes" and a "server".

Facilities

Art-Net is a simple implementation of DMX512-A protocol over UDP in which lighting control information is conveyed in IP packets, typically on a private local area network such as Ethernet. Supported functions include transmitting and receiving lighting data ; management functions such as detecting nodes, updating node control parameters, and transmitting timecodes; and functions that allow nodes to "subscribe" to "publisher" nodes so that, for example, nodes A and B can subscribe to node C.

Versions

Art-Net has gone through four versions which are claimed to be interoperable. Art-Net I used broadcasts extensively, giving a universe limit of approximately 40. Art-Net II mostly uses unicast packets, and addresses 256 universes. Art-Net III, released in 2011, addresses issues in managing larger numbers of universes, up to 32,768. A further version, Artnet IV was released in 2016.
Internally to the protocol, it is referred to as version 14.

Addressing

In its simplest implementation, nodes all broadcast, originally on the 2.0.0.0/8 networks.
Addressing is typically fixed per node, often locked to the MAC Address and an "OEM" code allocated to the manufacturer, and jumper settings. Networks can use DHCP or statically configured IP addresses, and use unicast packets for greater network efficiency. The protocol can address 32768 DMX "universes", each of 512 channels, limited by bandwidth.
The fixed addressing can be problematic in networks with other addressing requirements. Revision Q of the protocol addressed this problem by adding 10.0.0.0/8 as an addressing scheme, For node discovery, broadcast packets are used.

Packet format

The following table shows a typical packet, ArtDMX, for transmitting lighting values. It is sent to the fixed UDP port 0x1936.
The pink portion is the same on all Art-Net packets; the green portion is variable. The opcode tells the recipient this is a packet containing DMX data in the data portion, intended to be output of the specified universe. Sequence is a sequential number between 1 and 255 allowing the recipient to reorder packets to address out-of-order delivery ; physical is an information packet showing the original physical universe of this data, if required. Then follows up to 512 lighting values in the range 0 to 255. Conceptually, this packet is broadcast to all nodes; but is ignored by all nodes except the one which is configured to listen for this universe. In practice the packet is typically unicast to the correct node.