Revisions for Art-Net Tools

Comparing two revisions:

Mon, 2012-04-09 00:14 by gtoledo3 (4027)Sun, 2012-08-12 14:30 by smokris (1073)

removed outdated testing info about old artnet composition that worked via loopback. New test info should be added, don't remember url offhand. -gt

make it clearer that 2.0.0.0 is deprecated; add instructions for setting up network alias

Changes to Body
 
In order to send ArtDmx packets, one of your computer's network interfaces must be set to a valid Art-Net IP Subnet. These are as follows:
 
In order to send ArtDmx packets, one of your computer's network interfaces must be set to a valid Art-Net IP Subnet. These are as follows:
 
 
-
* 2.0.0.0/8[^1] (network 2.0.0.0, netmask 255.0.0.0, broadcast 2.255.255.255)
  
 
* 10.0.0.0/8 (network 10.0.0.0, netmask 255.0.0.0, broadcast 10.255.255.255)
 
* 10.0.0.0/8 (network 10.0.0.0, netmask 255.0.0.0, broadcast 10.255.255.255)
  +
* <s>2.0.0.0/8[^1] (network 2.0.0.0, netmask 255.0.0.0, broadcast 2.255.255.255)</s>
  +
  +
To set up your network accordingly, do this: System Preferences > Network > `+` (bottom left corner) > Ethernet (name it something like "Art-Net") > Create. Change "Configure IPv4" to "Manually", and set an unused `10.*.*.*` IP address and subnet mask `255.0.0.0`. No router. Click Apply, and restart Quartz Composer.
 
 
 
If none of your computer's network interfaces are set accordingly, Art-Net packets will not be sent.
 
If none of your computer's network interfaces are set accordingly, Art-Net packets will not be sent.
-
  
 
 
 
 
Current revision:

Art-Net Tools

Kineme ArtDmx Sender and Receiver PatchesKineme Art-Net Tools provides two patches for interacting with Art-Net devices:

  • ArtDmx Sender --- Broadcasts a structure of DMX values to the specified IP Network, Sub-Net, and Universe.
  • ArtDmx Receiver --- Receives broadcast DMX values from the specified Sub-Net and Universe.

Both patches work with either raw DMX values (ranging from 0 to 511) or normalized values (fractional, ranging from 0.0 to 1.0), depending on whether the "Normalized Values" checkbox is set.

Notes on the ArtDmx Sender

IP Network

In order to send ArtDmx packets, one of your computer's network interfaces must be set to a valid Art-Net IP Subnet. These are as follows:

  • 10.0.0.0/8 (network 10.0.0.0, netmask 255.0.0.0, broadcast 10.255.255.255)
  • 2.0.0.0/81 (network 2.0.0.0, netmask 255.0.0.0, broadcast 2.255.255.255)

To set up your network accordingly, do this: System Preferences > Network > + (bottom left corner) > Ethernet (name it something like "Art-Net") > Create. Change "Configure IPv4" to "Manually", and set an unused 10.*.*.* IP address and subnet mask 255.0.0.0. No router. Click Apply, and restart Quartz Composer.

If none of your computer's network interfaces are set accordingly, Art-Net packets will not be sent.

Channel Structure

The Channel Structure input is a keyed structure --- the structure's key represents the output ArtDmx channel (1 to 512), and the structure's value represents the value to send to that channel (0 to 255).

You can also specify comma-delimited keys, representing a 16bit composite channel consisting of two arbitrary 8bit channels. For example, you could specify a key of "42,79" --- "42" is the channel to which the HSB is sent, and "79" is the channel to which the LSB is sent.

Short Frames

The ArtDmx Sender patch has the option to send Short Frames. When enabled, complete DMX512 frames will be sent at start and every 4 seconds, and short frames will be sent in the interim. This is more efficient, but may be incompatible with some hardware.

When disabled, complete DMX512 frames will always be sent.

Notes on the ArtDmx Receiver

When receiving ArtDmx packets, the Sequence and Physical fields are ignored.

The ArtDmx Receiver only recognizes ArtDmx packets. Other Art-Net packet types are ignored.


  1. The 2.0.0.0/8 address range has historically been reserved by the IANA. Unfortunately, the Art-Net protocol, developed by Artistic License Ltd does not respect this reservation, and specifies it as the default address range. As of September 2009, this address range has been allocated for use. We advise that you always use the 10.0.0.0/8 address range.