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 ™ 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:
- 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
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:
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:
- 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
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:
- 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 !
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 | I |
| Receive | char-array with informations about the 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:
- 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).
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:
- 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
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:
- 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
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:
- 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
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:
- 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
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
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] |
||
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
Cookies helfen uns bei Funktionen und Diensten. Durch Nutzung unserer Webseite erklären Sie sich damit einverstanden, dass wir Cookies setzen.