ETCDmxTool is a free, open-source tool with the ability to capture DMX/RDM data; to control DMX levels; and to act as an RDM controller. It is provided by ETC Inc without any warranty, in the hope that it is a useful tool.
To interface to a DMX/RDM system, ETCDmxTool supports three USB devices - the ETC Gadget I, the ETC Gadget II and the ETC USB Whip. The features available differ slightly depending on the selected device:
| Feature | USB Whip | Gadget I1 | Gadget II1 | Gadget II (CPU2)1 |
|---|---|---|---|---|
| DMX/RDM Data Capture | ✔️ | ❌ | ✔️ 2 | ✅ 3 |
| DMX Output | ✔️ | ✔️ | ✔️ | ✔️ |
| RDM Controller | ❌ | ✔️ | ✔️ | ✅ 3 |
1 Windows Only
2 Firmware v1.2.0 or above
3 Coming in future firmware versions
ETCDmxTool is supported on Windows (Win 7/Win 10).
An installer is provided on the release page
ETCDmxTool also supports Linux, but only certain hardware currently (see the table above).
For help with configuring on Linux, please see the Linux readme.
In order to sniff DMX/RDM, you will need to wire your DMX device in to your system in a slighly unusual way using male-male XLR connectors or similar. Below is an example of how this might be set up.
The application supports the ability to run in a scripted mode which may help with automation of testing or troubleshooting. For more info, take a look at the Scripting readme file.
If you are interested in building the application you will need the following:
- Qt Library and Creator - https://www.qt.io/ide/
- To build the windows installer - NSIS - http://nsis.sourceforge.net/
- If NSIS is included in your $PATH the installer will be built automatically
The dissectors are arranged as plugins; additional dissectors can simply be added to the src/dissectors directory
ETCDmxTool is designed to interact with ETC products, but it is not official ETC software. For challenges using, integrating, compiling, or modifying items in this project, we encourage posting on the Issues page. ETCDmxTool is a community-supported initiative, and the community is the best place to ask for help!