DMX4ALL- Development

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:

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

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:

  • NanoDMX
  • Mini-USB-DMX-Interface
  • USB-DMX STAGE-PROFI MK2
  • USB-DMX STAGE-PROFI MK3
  • DMX Player S
  • DMX Player L
  • DMX Player ONE
  • DMX Player L MK2
  • ArtNet-DMX TWIN PoE
  • DMX STAGE-PROFI 1.1 RDM

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

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:

  • LAN-DMX-Interface
  • ArtNet-DMX STAGE-PROFI 1.1
  • ArtNet-DMX UNIVERSE DR1.1
  • ArtNet-DMX UNIVERSE 4.1
  • ArtNet-DMX UNIVERSE DR4.1
  • ArtNet-LED Dimmer 4/4R
  • ArtNet-LED Dimmer 6/6R
  • ArtNet-LED Dimmer 4 MK2
  • ArtNet Player 4
  • ArtNet-DMX TWIN PoE
  • DMX STAGE-PROFI 1.1 RDM
  • DMX UNIVERSE DR1.1 RDM
  • DMX TwinPoE AP RDM

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:

  • LAN-DMX-Interface
  • ArtNet-DMX STAGE-PROFI 1.1*
  • ArtNet-DMX UNIVERSE DR1.1*
  • ArtNet-DMX UNIVERSE 4.1
  • ArtNet-DMX UNIVERSE DR4.1
  • ArtNet-LED Dimmer 4/4R
  • ArtNet-LED Dimmer 6/6R
  • ArtNet-LED Dimmer 4 MK2
  • ArtNet Player 4
  • ArtNet-DMX TWIN PoE
  • DMX STAGE-PROFI 1.1 RDM*
  • DMX UNIVERSE DR1.1 RDM*
  • DMX TwinPoE AP RDM*

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

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 !

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.

Description:
Check if the connection is OK.

Definition:

Transmit C?
Receive G

Possible with the following devices:

  • All devices

Description:
Get informations about the device.

Definition:

Transmit I
Receive char-array with informations about the device

Infotext from Device

Possible with the following devices:

  • All devices

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

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)

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)

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)

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)

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)

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

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

Description:
Start a program.

Definition:

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

Possible with the following devices:

  • DMX-Player S / L / ONE

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)

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)

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)

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)

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)

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)

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)

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)

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)

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)

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

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

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)

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)

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)

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)

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

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

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

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

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:

  • ArtNet-LED-Dimmer 4
  • ArtNet-LED-Dimmer 6
  • ArtNet Player 4
  • ArtNet MultiPixxPlayer 16
  • ArtNet Analog/Relais Interface
  • DMX-Configurator (V2.1 or higher)
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).

HinweisPlease 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) !

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

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

Possible with the following devices:

  • Mini USB DMX Interface
  • NanoUSB DMX Interface
  • USB-DMX STAGE PROFI MK2
  • USB-DMX STAGE PROFI MK3
  • LAN-DMX STAGE-PROFI
  • DMX-Player XS / S / L / ONE
  • ArtNet-DMX STAGE-PROFI 1.1
  • ArtNet-DMX UNIVERSE DR1.1

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

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:

  • Mini USB DMX Interface
  • NanoUSB DMX Interface
  • USB-DMX STAGE PROFI MK2
  • USB-DMX STAGE PROFI MK3
  • LAN-DMX STAGE-PROFI
  • ArtNet-DMX STAGE-PROFI 1.1
  • ArtNet-DMX UNIVERSE DR1.1

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:

  • Mini USB DMX Interface
  • NanoUSB DMX Interface
  • USB-DMX STAGE PROFI MK2
  • USB-DMX STAGE PROFI MK3
  • LAN-DMX STAGE-PROFI
  • ArtNet-DMX STAGE-PROFI 1.1
  • ArtNet-DMX UNIVERSE DR1.1

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:

  • Mini USB DMX Interface
  • NanoUSB DMX Interface
  • USB-DMX STAGE PROFI MK2
  • USB-DMX STAGE PROFI MK3
  • LAN-DMX STAGE-PROFI
  • ArtNet-DMX STAGE-PROFI 1.1
  • ArtNet-DMX UNIVERSE DR1.1

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

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

HinweisDon`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

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]

HinweisDon`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

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
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]

HinweisDon`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