Third-Party Developers | ArtNet DMX RDM Node Interface - LED Pixel Controller - Player USB Wireless Stripe Dimmer Stepper Merger Splitter Mux Demux Relais Motor Servo DALI 0-10V

Art-Net specification

Art-Net was created by Artistic Licence to overcome the channel restriction of DMX while still utilizing its structure. It allows multiple DMX universes to be transported over a single Cat5 cable using ethernet technology.

Art-Net specification
Development

Art-Net ™ Designed by and Copyright Artistic Licence Holdings Ltd.

Preliminary information

For communication with DMX4ALL products it is necessary to open a connection.

After connecting to the device you can use the DMX4ALL commands.
Please note that not all products support all commands!

This can be done with different connection types:

RS232 - COM port

Open a RS232-COM port with the following parameters:

Baudrate: 38400 Baud (Some old interface can be switched to 19200 Baud)
Bytes: 8
Stop-Bits: 1
Parity: None
Handshake: None

After you open the connection and have the COM handle, you can use the standard transfer functions to write and read the data from the interface.

Possible with the following devices:

DMX Player XS

USB - Virtual COM Port (USB-VCP)

Open a USB-VCP-COM port with the following parameters:

Baudrate: 38400 Baud (Some old interface can be switched to 19200 Baud)
Bytes: 8
Stop-Bits: 1
Parity: None
Handshake: None

After you open the connection and have the COM handle, you can use the standard transfer functions to write and read the data from the interface.

Possible with the following devices:

USB - FTDI D2XX driver

To communicate with the USB-Driver, you have to use the FTDI D2XX driver.
More informations you can find in the “D2XX Programmer’s Guide” from FTDI.
To send data to the interface, you have to open the device with FT_Open.
After you got a handle to the device, you can send the data via FT_Write and read back data with FT_Read.

Possible with the following devices:

Mini-USB-DMX-Interface
USB-DMX STAGE-PROFI MK2
DMX Player S
DMX Player L
DMX Player ONE

Example:

FTDI D2XX Driver Example

Ethernet - Virtual COM Port (LAN-VCP)

Open a LAN-VCP-COM port with the following parameters:

Baudrate: 38400 Baud (Some old interface can be switched to 19200 Baud)
Bytes: 8
Stop-Bits: 1
Parity: None
Handshake: None

After you open the connection and have the COM handle, you can use the standard transfer functions to write and read the data from the interface.

Possible with the following devices:

Ethernet - Transmission Control Protocol (TCP)

To control the device over the TCP connection please use the IP-address of the device and use the configured port (default 10001) to open the TCP connection.

The sent and received data are RAW-data packets with the DMX4ALL command data inside.

Possible with the following devices:

* = The DMX4ALL Command Options must be set to TCP !

Ethernet - User Datagram Protocol (UDP)

To control the device over the UDP connection please use the IP-address of the device and use the configured port (default 10001) to send data packets.

The sent and received data are RAW-data packets with the DMX4ALL command data inside.

Possible with the following devices:

ArtNet-DMX STAGE-PROFI 1.1*
ArtNet-DMX UNIVERSE DR1.1*
DMX STAGE-PROFI 1.1 RDM*
DMX UNIVERSE DR1.1 RDM*
DMX TwinPoE AP RDM*

* = The DMX4ALL Command Options must be set to UDP !

Ethernet - HTTP Requests

The HTTP request must be send to the device using the following format:

xxx.xxx.xxx.xxx/dmx4all?cmd=command

xxx.xxx.xxx.xxx → IP-Address of the device
command → DMX4ALL Command

Example:

Set DMX address 1 to value 255	2.0.0.10/dmx4all?cmd=C000L255
Start programm 1	2.0.0.10/dmx4all?cmd=P001

Possible with the following devices:

DMX STAGE-PROFI 1.1 RDM
DMX UNIVERSE DR1.1 RDM
DMX TwinPoE AP RDM
ArtNet-LED Dimmer 4 Mk2

DMX4ALL Commands

ASCII commands

Pay attention to the upper and lower case.

Check connection

Description:
Check if the connection is OK.

Definition:

Transmit	C?
Receive	G

Possible with the following devices:

All devices

Get Informations

Description:
Get informations about the device.

Definition:

Transmit

Receive

char-array with informations about the device

Infotext from Device

Possible with the following devices:

All devices

Set Channel

Description:
Write a value (Level) to one Channel.

Definition:

Transmit	CxxxLyyy xxx = Channel (000 … 511) yyy = Level (000 … 255)
Receive	G

Possible with the following devices:

All devices

Definition:

Transmit	CxxxxxLyyy xxxxx = Channel (000 … 65535) Value depends on device output universes Channel 0 – 511 → Universe 1 Channel 512-1023 → Universe 2 : : : : : : : : : : : : : : : : : : : : : : : yyy = Level (000 … 255)
Receive	G

Possible with the following devices:

ArtNet-DMX UNIVERSE 4.1
ArtNet-DMX UNIVERSE DR4.1
ArtNet-DMX TWIN PoE (V1.02 or higher)
DMX TwinPOE AP RDM

Set Channel ALL

Description:
Write a value (Level) to all Channles.

Definition:

Transmit	CALLLyyy yyy = Level (000 … 255)
Receive	G

Possible with the following devices:

ArtNet-LED-Dimmer 4 (V2.12 or higher)
ArtNet-LED-Dimmer 6 (V2.12 or higher)
ArtNet-DMX STAGE-PROFI 1.1 (V2.15 or higher)
ArtNet-DMX TWIN PoE (V1.02 or higher)

Set Channel with fade

Description:
Writes a value (Level) to a channel that is reached via a fade with the given time will.

Definition:

Transmit	CxxxTzzzzzLyyy xxx = Channel (000 … 511) yyy = Level (000 … 255) zzzzz = Time, Unit 0,1s (00000 … 65535)
Receive	G

Possible with the following devices:

ArtNet-LED-Dimmer 4 (V2.12 or higher)
ArtNet-LED-Dimmer 6 (V2.12 or higher)
ArtNet-DMX STAGE-PROFI 1.1 (V2.15 or higher)

Set Channel ALL with fade

Description:
Writes a value (Level) to all channels that is reached via a fade with the given time will.

Definition:

Transmit	CALLTzzzzzLyyy yyy = Level (000 … 255) zzzzz = Time, Unit 0,1s (00000 … 65535)
Receive	G

Possible with the following devices:

ArtNet-LED-Dimmer 4 (V2.12 or higher)
ArtNet-LED-Dimmer 6 (V2.12 or higher)
ArtNet-DMX STAGE-PROFI 1.1 (V2.15 or higher)

Stop fade

Description:
Stops a fade for the specified channel that was started with Set CHANNEL with fade or Set CHANNEL ALL with fade was started.

Definition:

Transmit	CxxxT00000 xxx = Channel (000 … 511)
Receive	G

Possible with the following devices:

ArtNet-LED-Dimmer 4 (V2.12 or higher)
ArtNet-LED-Dimmer 6 (V2.12 or higher)
ArtNet-DMX STAGE-PROFI 1.1 (V2.15 or higher)

Stop fade ALL

Description:
Stops all fades started with Set CHANNEL with fade or Set CHANNEL ALL with fade.

Definition:

Transmit	CALLT00000
Receive	G

Possible with the following devices:

ArtNet-LED-Dimmer 4 (V2.12 or higher)
ArtNet-LED-Dimmer 6 (V2.12 or higher)
ArtNet-DMX STAGE-PROFI 1.1 (V2.15 or higher)

Get Channel

Description:
Read back a DMX output channel value.

Definition:

Transmit	Cxxx? xxx = Channel (000 … 511)
Receive	yyyG yyy = Level (000 … 255)

Possible with the following devices:

All devices

Get Channel from DMX-INPUT

Description:
Read a DMX input channel value.

Definition:

Transmit	Vxxx? xxx = Channel (000 … 511)
Receive	yyyG yyy = Level (000 … 255)

Possible with the following devices:

USB-DMX STAGE PROFI MK3
ArtNet-DMX STAGE-PROFI 1.1
ArtNet-DMX UNIVERSE DR1.1

Run Program (1)

Description:
Start a program.

Definition:

Transmit	Raaa aaa = Program (001…max. program)
Receive	G

Possible with the following devices:

DMX-Player S / L / ONE

Run Program (2)

Description:
Start a program.

Definition:

Transmit	Paaa aaa = Program (001…max. program)
Receive	G

Possible with the following devices:

ArtNet-LED-Dimmer 4
ArtNet-LED-Dimmer 6
ArtNet Player 4
ArtNet MultiPixxPlayer 16
DMX-Configurator (V2.1 or higher)

Get Program

Description:
Request the actual executed program.

Definition:

Transmit	P?
Receive	yyyG yyy = Actual program

Possible with the following devices:

ArtNet-LED-Dimmer 4
ArtNet-LED-Dimmer 6
ArtNet Player 4
ArtNet MultiPixxPlayer 16
DMX-Configurator (V2.1 or higher)

Set MasterDimmer

Description:
Write the MasterDimmer value.

Definition:

Transmit	Laaa aaa = MasterDimmer value ( 000 … 255 )
Receive	G

Possible with the following devices:

ArtNet-LED-Dimmer 4
ArtNet-LED-Dimmer 6
ArtNet Player 4
ArtNet MultiPixxPlayer 16
DMX-Configurator (V2.1 or higher)

Get MasterDimmer

Description:
Read the MasterDimmer value.

Definition:

Transmit	L?
Receive	bbbG bbb = actual read MasterDimmer value

Possible with the following devices:

ArtNet-LED-Dimmer 4
ArtNet-LED-Dimmer 6
ArtNet Player 4
ArtNet MultiPixxPlayer 16
DMX-Configurator (V2.1 or higher)

Set RED Brightness

Description:
Write the brightness value for RED channels.

Definition:

Transmit	Raaa aaa = RED brightness value (000 … 255)
Receive	G

Possible with the following devices:

ArtNet-LED-Dimmer 4
ArtNet-LED-Dimmer 6
ArtNet Player 4
ArtNet MultiPixxPlayer 16
DMX-Configurator (V2.1 or higher)

Get RED Brightness

Description:
Read the RED brightness value.

Definition:

Transmit	R?
Receive	bbbG bbb = actual read RED brightness value

Possible with the following devices:

ArtNet-LED-Dimmer 4
ArtNet-LED-Dimmer 6
ArtNet Player 4
ArtNet MultiPixxPlayer 16
DMX-Configurator (V2.1 or higher)

Set GREEN Brightness

Description:
Write the brightness value for GREEN channels.

Definition:

Transmit	Gaaa aaa = GREEN brightness value (000 … 255)
Receive	G

Possible with the following devices:

ArtNet-LED-Dimmer 4
ArtNet-LED-Dimmer 6
ArtNet Player 4
ArtNet MultiPixxPlayer 16
DMX-Configurator (V2.1 or higher)

Get GREEN Brightness

Description:
Read the GREEN brightness value.

Definition:

Transmit	G?
Receive	bbbG bbb = actual read GREEN brightness value

Possible with the following devices:

ArtNet-LED-Dimmer 4
ArtNet-LED-Dimmer 6
ArtNet Player 4
ArtNet MultiPixxPlayer 16
DMX-Configurator (V2.1 or higher)

Set BLUE Brightness

Description:
Write the brightness value for BLUE channels.

Definition:

Transmit	Baaa aaa = BLUE brightness value (000 … 255)
Receive	G

Possible with the following devices:

ArtNet-LED-Dimmer 4
ArtNet-LED-Dimmer 6
ArtNet Player 4
ArtNet MultiPixxPlayer 16
DMX-Configurator (V2.1 or higher)

Get BLUE Brightness

Description:
Read the BLUE brightness value.

Definition:

Transmit	B?
Receive	bbbG bbb = actual read BLUE brightness value

Possible with the following devices:

ArtNet-LED-Dimmer 4
ArtNet-LED-Dimmer 6
ArtNet Player 4
ArtNet MultiPixxPlayer 16
DMX-Configurator (V2.1 or higher)

Set BlackOut

Description:
Write the actual BlackOut state.

Definition:

Transmit	Ba a = 0 (BLACKOUT off) / a = 1 (BLACKOUT on)
Receive	G

Possible with the following devices:

DMX-Player S / L / ONE

Get BlackOut

Description:
Read the actual BlackOut state.

Definition:

Transmit	B?
Receive	bG b = 0 (BLACKOUT is off) b = 1 (BLACKOUT is on)

Possible with the following devices:

DMX-Player S / L / ONE

Set Output On/Off (BlackOut)

Description:
Switch output ON/OFF.

Definition:

Transmit	Oa a = 0 (OUTPUT off) / a = 1 (OUTPUT on)
Receive	G

Possible with the following devices:

ArtNet-LED-Dimmer 4
ArtNet-LED-Dimmer 6
ArtNet Player 4
ArtNet MultiPixxPlayer 16
DMX-Configurator (V2.1 or higher)

Get Output On/Off (BlackOut)

Description:
Get the actual Output state.

Definition:

Transmit	O?
Receive	bG b = 0 (OUTPUT off) b = 1 (OUTPUT on)

Possible with the following devices:

ArtNet-LED-Dimmer 4
ArtNet-LED-Dimmer 6
ArtNet Player 4
ArtNet MultiPixxPlayer 16
DMX-Configurator (V2.1 or higher)

Set Speed

Description:
Write the speed value.

Definition:

Transmit	Saaa aaa = Speed value ( slow 000 … 255 fast )
Receive	G

Possible with the following devices:

ArtNet-LED-Dimmer 4
ArtNet-LED-Dimmer 6
ArtNet Player 4
ArtNet MultiPixxPlayer 16
DMX-Configurator (V2.1 or higher)

Get Speed

Description:
Read the actual speed value.

Definition:

Transmit	S?
Receive	bbbG bbb = actual read speed value

Possible with the following devices:

ArtNet-LED-Dimmer 4
ArtNet-LED-Dimmer 6
ArtNet Player 4
ArtNet MultiPixxPlayer 16
DMX-Configurator (V2.1 or higher)

Set Freeze

Description:
Stop the program execution.

Definition:

Transmit	Fa a = 0 (Freeze off) / a = 1 (Freeze on)
Receive	G

Possible with the following devices:

ArtNet-LED-Dimmer 4
ArtNet-LED-Dimmer 6
ArtNet Player 4
ArtNet MultiPixxPlayer 16

Get Freeze

Description:
Read the actual Freeze-State.

Definition:

Transmit	F?
Receive	bG b = 0 (Freeze off) b = 1 (Freeze on)

Possible with the following devices:

ArtNet-LED-Dimmer 4
ArtNet-LED-Dimmer 6
ArtNet Player 4
ArtNet MultiPixxPlayer 16

Set number of output channels

Description:
Set the number of channels used for the DMX output.

Definition:

Transmit	Nxxx xxx= = Number of channels (000 … 511)
Receive	G

Possible with the following devices:

DMX-Player S / L / ONE
Mini USB DMX Interface
USB-DMX STAGE-PROFI MK2

Get number of output channels

Description:
Get the actual number of output channels.

Definition:

Transmit	N?
Receive	yyyG yyy = Number of channels (000 … 511)

Possible with the following devices:

DMX-Player S / L / ONE
Mini USB DMX Interface
USB-DMX STAGE-PROFI MK2

Get Settings

Description:
Read the settings from the device into one string.

Definition:

Transmit	X?
Receive	Rxxx;Gxxx;Bxxx;Lxxx;Sxxx;Pxxx;Fb;Ob;G xxx = Current value b = Current state

Possible with the following devices:

Array commands

The array transfer is used to transfer more than one data byte (array) in one command.
Each command begins with a header byte that defines the command.
After this command the control bytes are transferred. After the last control byte the interface send the answer packet (Receive).

Please note, that the array of the transmitted data are maximum 255 bytes long.
Also the sum of the start channel and the changes channels must be a maximum of 255 (0xFF) !

Write DMX-OUT

Description:
The start channel defines the destination of the data bytes.
The number of channels gives the count of data bytes.

Definition:

Transmit		Receive
0xFF start channel L start channel H number of channels first data byte .. .. last data byte	(Block transfer header) (0x00 … 0xFF) (0x00 / 0x01) (0x00 … 0xFF) (0x00 … 0xFF)
		G

Don`t write data to different universes in one command.

Possible with the following devices:

Example:
To set the channels 10-15 to the value 100,120,140,150,255,10, please transmit the following BYTES:
FF 09 00 06 64 78 8C 96 FF 0A (Transmitted bytes)
The interface send back the ASCII char „G“ if the command is OK and executed

Write DMX-OUT Channel 1-256 (Fast Mode)

Description:
Write one DMX value to output buffer.

Definition:

Transmit		Receive
0xE2 channel low byte data byte	(Block transfer header) (0x00 … 0xFF) (0x00 … 0xFF)

Possible with the following devices:

Write DMX-OUT Channel 257-512 (Fast Mode)

Description:
Write one DMX value to output buffer.

Definition:

Transmit		Receive
0xE3 channel low byte data byte	(Block transfer header) (0x00 … 0xFF) (0x00 … 0xFF)

Possible with the following devices:

Read back DMX-OUT

Description:
Read back the DMX values from output buffer.

Definition:

Transmit		Receive
0xFE start channel L start channel H number of channels	(Block transfer header) (0x00 … 0xFF) (0x00 / 0x01) (0x00 … 0xFF)
		DATA[0] .. .. DATA[n] G

Possible with the following devices:

Read DMX-IN

Description:
Read DMX values from the input signal.

Definition:

Transmit		Receive
0xFC start channel L start channel H number of channels	(Block transfer header) (0x00 … 0xFF) (0x00 / 0x01) (0x00 … 0xFF)
		DATA[0] .. .. DATA[n] G

Possible with the following devices:

USB-DMX STAGE PROFI MK3
ArtNet-DMX STAGE-PROFI 1.1
ArtNet-DMX UNIVERSE DR1.1

MultiUniverse array transfer

The MultiUniverse array transfer commands can handle more than 512
channels (1 universe).

Write DMX-OUT

Description:
The start channel defines the destination of the data bytes, also the universe.
To access universe 1 the destination channel must be 0 to 511,
to access universe 2 the destination channel must be 512 to 1023,
to access universe 3 the destination channel must be 1024 to 1535 and so on.

Definition:

Transmit		Receive
0xD1 start channel H start channel start channel start channel L number of channels H number of channels L first data byte .. .. last data byte	(Block transfer header) (0x00 … 0xFF) (0x00 … 0xFF) (0x00 … 0xFF) (0x00 … 0xFF) (0x00 … 0xFF) (0x00 … 0xFF) (0x00 … 0xFF)
		G

Don`t write data to different universes in one command.

Possible with the following devices:

AvengerSD Player
MultiPixx DMX-Controller
ArtNet-DMX STAGE-PROFI 1.1
ArtNet-DMX UNIVERSE DR1.1

Read DMX-OUT

Description:
The start channel defines the source of the data bytes, also the universe.
To access universe 1 the source channel must be 0 to 511,
to access universe 2 the source channel must be 512 to 1023,
to access universe 3 the source channel must be 1024 to 1535 and so on.

Definition:

Transmit		Receive
0xD2 start channel H start channel start channel start channel L number of channels H number of channels L	(Block transfer header) (0x00 … 0xFF) (0x00 … 0xFF) (0x00 … 0xFF) (0x00 … 0xFF) (0x00 … 0xFF) (0x00 … 0xFF)
		DATA[0] .. .. DATA[n]

Don`t read data from different universes in one command.

Possible with the following devices:

AvengerSD Player
MultiPixx DMX-Controller
ArtNet-DMX STAGE-PROFI 1.1
ArtNet-DMX UNIVERSE DR1.1

Read DMX-IN

Definition:

Transmit		Receive
0xD8 universe start channel H start channel L number of channels H number of channels L	(Block transfer header) (0x00 … 0xFF) (0x00 … 0xFF) (0x00 … 0xFF) (0x00 … 0xFF) (0x00 … 0xFF)
		CHANNELS H CHANNELS L DATA[0] .. .. DATA[n]

Don`t read data from different universes in one command.

Possible with the following devices:

AvengerSD Player
MultiPixx DMX-Controller
ArtNet-DMX STAGE-PROFI 1.1
ArtNet-DMX UNIVERSE DR1.1

Art-Net specification

Art-Net ™ Designed by and Copyright Artistic Licence Holdings Ltd.

Preliminary information

DMX4ALL Commands

ASCII commands

Array commands

MultiUniverse array transfer

Kundenservice

Vertrieb & Showroom

DMX Switch Tool

Made in Germany