Packet Summary

Packet Summary

This section details all the Art-Net OpCodes.

OpCodes are a 16-bit enumeration that defines the Art-Net packet type. The OpCode and the related packet are prefixed with ‘Op’ or ‘Art’ respectively. Thus the OpCode OpPoll is used in the packet ArtPoll.

Device Discovery Packets

Device discovery packets are used to allow the network controller to discover all Art-Net devices attached to the network.

OpCode Value Purpose
OpPoll 200016 OpPoll is transmitted by controllers in order to discover all Art-Net devices connected to the network.
OpPollReply 210016 OpPollReply is the response to an OpPoll. It both acknowledges the discovery process and also contains key status information.

 

Device Configuration Packets

Device configuration packets are used to configure discovered Art-Net devices.

OpCode Value Purpose
OpAddress 600016 The OpAddress packet is used to configure the Port-Address (universe), name strings and operating mode of a device.
OpInput 700016 The OpInput packet is used to enable or disable the DMX512 inputs of a node.
OpIpProg f80016 The OpIpProg packet is used to re-programme the IP address of a node.
OpIpProgReply f90016 The OpIpProgReply packet is used to acknowledge an OpIpProg packet.
OpCommand 240016 The OpCommand packet is used to issue property->set commands.

 

Streaming Control Packets

Streaming control packets are the core of Art-Net and allow real-time channel based control data to be streamed over the network.

OpCode Value Purpose
OpDmx 500016 The OpDmx OpCode defines the ArtDmx packet which is used to stream zero start code DMX512 packets over the network.
OpNzs 510016 The OpNzs OpCode defines the ArtNzs packet which is used to stream selected non-zero start code DMX512 packets over the network. This packet must not be used for zero start code or RDM data.
OpSync 520016 This is an ArtSync data packet. It is used to force synchronous transfer of ArtDmx packets to a node’s output.

 

RDM Packets

RDM packets are used to discover which RDM devices are connected to which Art-Net nodes and then to control them.

OpCode Value Purpose
OpTodRequest 800016 The OpTodRequest packet is used to instruct all Art-Net devices to transmit their TOD (Table of Devices) to the network.
OpTodData 810016 The OpTodData packet is used to transmit TOD (Table of Devices) to the network.
OpTodControl 820016 The OpTodControl packet is used to transmit RDM discovery control messages to the network.
OpRdm 830016 The OpRdm packet is used to transfer all non-discovery RDM packets.
OpRdmSub 840016 The OpRdmSub packet can be used to send compressed RDM Sub-Device data.

Time-Keeping Packets

Time-keeping packets are used to synchronise Art-Net devices across the network.

OpCode Value Purpose
OpTimeCode 970016 OpTimeCode is used to transport time code (MTC, SMPTE, EBU etc) over the network.
OpTimeSync 980016 OpTimeSync is used to synchronise the real time date and clock off Art-Net devices.

 

Triggering Packets

Triggering packets allow Art-Net devices to trigger macro events in each other.

OpCode Value Purpose
OpTrigger 990016 The OpTrigger packet is used to send trigger macros between Art-Net devices.

 

Diagnostics Packets

Diagnostics packets are used to send diagnostic information over the network to be logged by software such as DMX-Workshop.

OpCode Value Purpose
OpDiagData 230016 Contains diagnostics data.

 

File Transfer Packets

File transfer packets are used to upload new firmware to devices and also for the transfer of data files between controllers and nodes.

OpCode Value Purpose
OpFirmwareMaster f20016 The OpFirmwareMaster packet is used by a controller to transfer or upload firmware to a node.
OpFirmwareReply f30016 The OpFirmwareReply packet is used by nodes to acknowledge receive of OpFirmwareMaster and OpFileTnMaster packets. That is: it acknowledges both types of upload.
OpDirectory 9a0016 The OpDirectory packet is used by a controller to request a files directory listing from a node.
OpDirectoryReply 9b0016 The OpDirectoryReply packet is used by a node to send a directory listing in response to the OpDirectory packet.
OpFileTnMaster f40016 The OpFileTnMaster packet is used by a controller to upload a user file to a node.
OpFileFnMaster f50016 The OpFileFnMaster packet is used by a controller to download a user file from a node.
OpFileFnReply f60016 The OpFileFnReply packet is used by a controller to acknowledge the previous OpFileFnMaster packet received from a node.

 

Deprecated Packets

This category includes packet definitions that while still legal are no longer in common use.

OpCode Value Purpose
OpVideoSetup a01016 OpVideoSetup is used to configure text based video screens as network status repeaters. This packet was used on ADB Vision consoles.
OpVideoPalette a02016 OpVideoPalette is used to configure the colour palettes of text based video screens as network status repeaters. This packet was used on ADB Vision consoles.
OpVideoData a04016 OpVideoData is used to transfer real time real time text based video screens as network status repeaters. This packet was used on ADB Vision consoles.
OpPollFnReply 220016 OpPollFnReply was used by Artistic Licence in it’s Four-Play product. The functionality has since been superseded by ‘Binding’.
OpMacMaster f00016 The OpMacMaster packet is used by custom manufacturing software to programme the MAC address of a device. As MAC addresses are globally unique, immense care must be exercised when using this packet.
OpMacSlave f10016 The OpMacSlave packet is used by nodes to acknowledge an OpMacMaster packet.