ArtInput

ArtInput

The ArtInput packet is unicast by a controller to enable or disable the node’s four input ports.

A node replies to ArtInput by unicasting an ArtPollReply to the sender.

ArtInput

ArtInput – Packet Definition

ArtInput packet definition table

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 ArtInput packet this field is set to ‘OpInput’.

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.

Filler1           

This field is not used. It is transmitted as zero and never tested by receivers.

BindIndex           

The BindIndex is used to identify the bound node which originated the packet when binding with identical IP addresses is used. This field was introduced with Art-Net 4. It takes a value in the range 110-25510 where 1 indicates the Root.

NumPorts

In the ArtInput packet this field is superfluous and should be ignored by receivers.

Inputs[]

Inputs[] is an array of 4-bytes. Bit-0 is used to define enable the Input-Ports.

artinput3

Art-Net™ is a trademark of Artistic Licence Engineering Ltd.