DMX Out CHOP

From TouchDesigner 099 Wiki

Summary

The DMX Out CHOP sends channels to DMX, Art-Net, or sACN devices. Channel values for DMX are 0-255.

The first channel you send into the DMX Out will correspond to the first DMX address (DMX channel) As you add channels to the DMX Out, you will access the next DMX channels in order. For example, if you input 12 channels into the DMX out, you will be controlling DMX channels 1 thru 12.

The DMX in TouchDesigner was developed on the ENTTEC device, namely their DMX USB Pro and DMX over Ethernet devices, but it should work for many devices and software that support DMX/Art-Net/sACN.

A Routing Table can be provided in a DAT where addresses can be specified by adding rows for each channel and specifying net, subnet and universe.

ENTTEC NOTE: - Use ENTTEC's NMU (Node Management Utility) to configure and inspect the ENTTEC devices found on your network.

macOS NOTE: - ENTTEC USB Pro will not connect automatically, to enable it enter the following command in the Terminal:

sudo kextunload -b com.apple.driver.AppleUSBFTDI


See also: Art-Net, sACN, DMX In CHOP

PythonIcon.png dmxoutCHOP_Class

Parameters - Port Page

Active - Connects to the device while On.

Interface - Select the type of interface to connect to the device with.

  • Generic Serial - uses the operating system's serial calls to write data.
  • FTDI Serial - attempts to connect to the DMX driver if one is installed. This allows setting of lower-level parameters such as latency.
  • Art-Net - sets the interface to Art-Net protocol.
  • sACN - sets the interface to sACN protocol.

Format - Select between sending Packet Per Sample or Packet Per Channel.

Routing Table - Available when using Packet Per Channel Format for Art-Net or sACN. Use the docked Table DAT to route channels to the appropriate universes. Addresses can be specified by adding rows for each channel and specifying net, subnet and universe. The net, subnet and universe columns are optional. If for example the net column is missing from the Routing Table, the Net parameter is used instead.

When removing the Routing Table from the parameter, the specified address will be used for the first channel while all other channels are assigned to consecutive addresses.

Note: For sACN the first available universe has the index 1 as universe 0 is reserved by the system for future use.

Device - Select a DMX device from the menu.

Serial Port - When the Interface parameter is set to Generic Serial this parameter lets you select which Serial (COM) port to use.

Rate - How often data is sent to the device (per second).

Net (0-127) - When the Interface parameter is set to Art-Net, this sets the net address. A net is a groups of 16 consecutive subnets or 256 consecutive universes. The range for this parameter is 0-127. This is not a network IP address.

Subnet (0-15) - When the Interface parameter is set to Art-Net, this sets the subnet address. A subnet is a group of 16 consecutive universes. The range for this parameter is 0-15. This is not a network subnet mask.

Universe (0-15) - When the Interface parameter is set to Art-Net, this sets the universe address. A single DMX512 frame of 512 channels is referred to as a universe. The range for this parameter is 0-15.

CID - The unique ID of the sender.

Source - User assigned name of source (for informative purposes).

Priority - The priority of the data being sent, if there are multiple sources.

Multicast - Enable multicast for sACN. Multicast automatically builds the IP based on Net, Subnet, and Universe of the device. This allows for sending to multiple devices at once by specifying multiple universes.

Network Address - Specify the IP address to use when Interface is set to Art-Net. This address corresponds to the receiving device address. When the address is set to its default 255.255.255.255, the messages are instead broadcast to all devices on the network. The Art-Net Net Subnet and Universe of the receiving devices must still match those specified in the DMX Out CHOP in all cases.

WARNING: DMX512 devices have a maximum refresh rate of 44Hz. It is recommended that Rate <= 44 for reliable performance.

Device Support

Many DMX/Art-Net devices and software will work with the DMX CHOPs. The following list of devices have been certified to work