ArtNzs Packet Definition

For an introduction to ArtNzs, please refer to Streaming Packets.

ArtNzs – Packet Definition

artnzs tab1
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

ID

The ID field is 8 bytes in length and contains the null terminated string of ASCII characters:

                A r t – N e t

The purpose of the field is to identify the packet as an Art-Net protocol packet. All Art-Net packets start with this field. Receivers must check this field is correct and discard the packet if it is not.

OpCode

The OpCode field is a 16-bit word transmitted low byte first. The OpCode identifies the packet type. In the ArtNzs packet this field is set to ‘OpNzs’.

ProtVer

The ProtVer field is a 16-bit word transmitted high byte first. It identifies the version of the Art-Net protocol. The protocol version is not related to Art-Net 1, II, 3 or 4. Only one protocol version has ever existed in production equipment which is 1410. Receivers should use the following good packet test:

                 ProtVer >= 14

The ProtVer may be increased in a future releases to identify significant functionality changes.

Sequence

The Sequence field is an 8-bit number that is designed to show the order in which packets were originated. When Art-Net is transferred over media such as the Internet, it is possible for packets to arrive at their destination out of sequence. This field allows the receiver to trap such errors.

The generating device increments this number for every packet sent to a specific Port-Address. The number increments from 110 to 25510 and then rolls over to 110 and repeats. This is because the value 010 is reserved to show that Sequence is not implemented.

Start Code

The Start Code field is an 8-bit number that defines the start code of the DMX512 frame encoded by this packet. Not all start codes are allowed with the ArtNzs packet.

Net & SubUni

Net and SubUni are combined to form the 15-bit Port-Address to which this packet is directed.

The low 7-bits of the Net field define bits 14-8 of the 15-bit Port-Address.

The 8-bits of the SubUni field define bits 7-0 of the 15-bit Port-Address.

The diagram below shows the bit allocation within the Net field.

artdmx pd 2 v2

The bit organisation of the Port-Address is shown in the diagram below.

artdmx pd 3

Length

The Length field is a 16-bit number transmitted most significant byte first. It defines the number of bytes encoded in the Data[] field. The Length field can be set to any even value in the range 210 – 51210.

Data

The Data field contains the data slot array of the DMX512 frame that is encoded by this packet. The first 8-bit entry in the Data field is always data-slot 1.