Experimental:DMX Out POP
Summary
The DMX Out POP can send to DMX, Art-Net, sACN, KiNET, or FTDI devices.
The DMX Out POP merges the DMX universes from each of its DMX Fixture POP inputs, and sends them to the device. It can merge any number of DMX Fixture POPs but conflicts may arise if multiple DMX Fixture POPs write to the same channel value of a DMX universe. A warning will be output in that case, and for debugging such conflicts the DMX Map DAT is a useful tool.
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/KiNET.
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 may not connect automatically, to enable it enter the following command in the Terminal:
sudo kextunload -b com.apple.driver.AppleUSBFTDI
Tip: Use WireShark to watch your DMX network traffic.
See also: Art-Net, sACN, DMX In CHOP, DMX Out CHOP, DMX
Parameters - DMX Page
active
- When enabled, will be actively sending to the device.
interface
- ⊞ - Select the type of interface to connect to the device with.
- Generic Serial
serial
- Uses the operating system's serial calls to write data.
- Enttec USB Pro
enttecusbpro
-
- Enttec USB Pro Mk2
enttecusbpromk2
-
- Art-Net
artnet
- Sets the interface to Art-Net protocol.
- sACN
sacn
- Sets the interface to sACN protocol.
- KiNET
kinet
- Sets the interface to KiNET protocol.
rate
- How often data is sent to the device (per second).
WARNING: DMX512 devices have a maximum refresh rate of 44Hz. It is recommended that Rate <= 44 for reliable performance.
Parameters - Fixtures Page
fixture
- Sequence block for DMX Fixture POP inputs, either wired or referenced.
fixture0active
- When active, this Fixture is merged and sent.
fixture0pop
- A reference to one or more DMX Fixture POPs. The parameter is disabled if there is a corresponding wired input.
Parameters - Serial Page
serialport
- ⊞ - When the Interface parameter is set to Generic Serial this parameter lets you select which Serial (COM) port to use.
- COM3
com3
-
dmxkingport
- ⊞ - Select a DMXking port to send to.
- Default
default
-
device
- ⊞ - Select a DMX device from the menu.
- *
*
-
Parameters - Network Page
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.
netaddress
- Specify the IP address to use. 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 Net, Subnet and Universe of the receiving devices must still match those specified in the DMX Out CHOP in all cases. If a netaddress is specified in the Routing Table for a given net/subnet/universe then that will be used instead.
localaddress
- ⊞ - When the sending machine is equipped with multiple network adapters, this parameter can be used to choose which adapter to send the data from by specifying its IP address here.
- 192.168.178.150
192.168.178.150
-
- 10.2.0.2
10.2.0.2
-
localport
- In rare cases it can be necessary to supply a custom port from which the data should be sent. The default of -1
means the O/S assigned port is being used.
customport
- Enable the Network Port parameter to specify the port of the receiving hardware. When disabled, default port is 6454 for Art-Net, 5568 for sACN, and 6038 for KiNET.
netport
- Specify the port of the receiving hardware.
priority
- The data priority, if there are multiple sources. Used with sACN and KiNET protocols.
sendartsync
- When enabled will send out ArtSync packets. ArtSync packets are used to synchronize multiple universes together.
cid
- The unique ID of the sender.
source
- User assigned name of source (for informative purposes).
kinetversion
- ⊞ - Select the version of the KiNET protocol to use.
- DmxOut (v1)
v1
-
- PortOut (v2)
v2
-
customkinetport
- When enabled, can specify a custom port for the KiNET v2 interface. When disabled, the port will be the broadcast port: 255.
kinetport
- Specifies the port for KiNET v2 interface.
routingtable
- Use a Table DAT to specify netaddress, source, cid, priority, and kinetport values for specific universes. The net, subnet, universe columns must be filled in with valid values. Note: the DMX Fixture POP can override the netaddress value with its own Routing Table.
Parameters - Common Page
bypass
-
delinputattrs
-
Operator Inputs
- Input 0: -
Info CHOP Channels
Extra Information for the DMX Out POP can be accessed via an Info CHOP.
Common POP Info Channels
Common Operator Info Channels
- total_cooks - Number of times the operator has cooked since the process started.
- cook_time - Duration of the last cook in milliseconds.
- cook_frame - Frame number when this operator was last cooked relative to the component timeline.
- cook_abs_frame - Frame number when this operator was last cooked relative to the absolute time.
- cook_start_time - Time in milliseconds at which the operator started cooking in the frame it was cooked.
- cook_end_time - Time in milliseconds at which the operator finished cooking in the frame it was cooked.
- cooked_this_frame - 1 if operator was cooked this frame.
- warnings - Number of warnings in this operator if any.
- errors - Number of errors in this operator if any.
TouchDesigner Build: