1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML>
<HEAD>
<TITLE>Q Light Controller Plus - Enttec DMXUSB Output Plugin</TITLE>
<SCRIPT SRC="utility.js" TYPE="text/javascript"></SCRIPT>
<link href="style.css" rel="stylesheet" type="text/css" />
</HEAD>
<BODY onLoad="replaceqrc()">
<H1>DMX USB input/output plugin</H1>
<H2>Introduction</H2>
<P>
The DMX USB plugin supports a variety of FTDI-based USB-to-DMX devices:
<UL>
<LI>DMXKing USB DMX512-A</LI>
<LI><A HREF="https://dmxking.com/usbdmx/ultradmxmicro">DMXKing ultraDMX micro</A></LI>
<LI><A HREF="https://dmxking.com/discontinued/ultradmx-pro">DMXKing ultraDMX Pro</A></LI>
<LI><A HREF="https://www.enttec.com/products/controls/usb/open-dmx-usb/">Enttec DMXUSB Open</A></LI>
<LI><A HREF="https://www.enttec.com/products/controls/usb/2-universe-usb-computer-interface-dmx/">Enttec DMXUSB Pro</A></LI>
<LI><A HREF="https://www.enttec.com/products/controls/usb/dmx-usb-pro-mk2-2-universe-usb-computer-interface-dmx/">Enttec DMX USB PRO Mk2</A></LI>
<LI><A HREF="http://www.dmx4all.de/produkte_usb_dmx_interfaces.html">DMX4ALL USB-DMX STAGE-PROFI MK2</A></LI>
<LI><A HREF="http://www.dmx4all.de/produkte_usb_dmx_interfaces.html">DMX4ALL NanoDMX</A></LI>
<LI><A HREF="http://www.guselectronics.com/usb-dmx-interface-512">Gus Electronics USB-VL344</A></LI>
<LI><A HREF="http://www.dmx512-online.net/en-article58.html">Vince DMX512 USB</A></LI>
<LI><A HREF="http://www.electrotas.com/usbdmx.html">ElectroTAS USB-DMX</A></LI>
<LI><A HREF="https://www.steinigke.de/en/mpn51860118-eurolite-usb-dmx512-interface-update-adaptor.html">Eurolite USB-DMX512</A></LI>
<LI><A HREF="https://www.steinigke.de/en/mpn51860120-eurolite-usb-dmx512-pro-interface.html">Eurolite USB DMX512 Pro</A></LI>
<LI><A HREF="https://www.steinigke.de/en/mpn51860122-eurolite-usb-dmx512-pro-cable-interface.html">Eurolite USB-DMX512 Pro Cable</A></LI>
<LI><A HREF="https://www.steinigke.de/en/mpn51860121-eurolite-usb-dmx512-pro-interface-mk2.html">Eurolite USB DMX512 Pro MK2</A></LI>
<LI><A HREF="http://www.ftdichip.com/Products/Modules/USBRSxxx.htm">FTDI USBCOM 485+</A></LI>
</UL>
<H2>Configuration</H2>
<P>
DMX USB devices should be automatically detected from QLC+ and displayed in the input/output panels list.<br>
If for some reason the auto-detection fails, you can "force" the type of your DMX USB adapter manually.<br>
Click on the name of your device and open the configuration dialog by clicking on
the <IMG SRC="qrc:/configure.png" width=32> icon on the bottom-right side of the panel.<br>
You will see a list of DMX USB devices currently connected to your computer. Each one has a drop down menu
where you can force the device type.<br>
Here's the meaning of each one:
<UL>
<LI><B>Open TX</B>: Enttec USB DMX Open (and clones) in output mode</LI>
<LI><B>Open RX</B>: Generic FTDI devices receive mode</LI>
<LI><B>Pro RX/TX</B>: Enttec USB DMX Pro or most of the DMXKing devices</LI>
<LI><B>Pro Mk2</B>: Enttec USB DMX Pro Mk2 - 2 DMX outputs, 1 DMX input, 1 MIDI IN and 1 MIDI OUT ports are available</LI>
<LI><B>Ultra Pro</B>: DMXKing ultraDMX Pro with 2 outputs and 1 input</LI>
<LI><B>DMX4ALL</B>: DMX4ALL USB-DMX STAGE-PROFI MK2</LI>
<LI><B>Vince Tx</B>: Vince DMX512 USB in output mode</LI>
</UL>
<B>Note for OSX users:</B> If your adapter is detected but doesn't produce any output, most likely you'll find the solution
in the <A HREF="questionsandanswers.html#osx-mavericks">Questions and Answers</A> page (Question #3).<br>
<B>Note 1</B>: Eurolite USB-DMX512 Pro devices must be forced to the "Pro RX/TX" mode to operate correctly.<br>
<B>Note 2</B>: On Windows, Enttec open DMX clones might flicker at 44Hz. You can try and decrease the output frequency until the issue is resolved.
</P>
<H2>Requirements</H2>
<H3>Linux</H3>
<P>
On all Linux distributions, you need to install libftdi. If you install QLC+ with the Ubuntu
Software Center or some other automatic installer tool, this library will be installed
automatically for you.<br>
In some cases, if the device doesn't output anything, it might be useful to add your user
to the "dialout" group with the following command:<br>
<PRE>sudo adduser your_user_name dialout</PRE>
</P>
<H3>macOS</H3>
<P>
On Apple macOS, you don't need any drivers at all since QLC+ uses the macOS native USB
interface. Installing the D2XX drivers should cause no harm, but <B>DO NOT INSTALL VCP (Virtual COM Port) drivers</B> as they will definitely interfere
with QLC+. If you have previously installed the VCP drivers, consult the
<A HREF="http://www.ftdichip.com/Support/Documents/InstallGuides.htm">FTDI installation guides</A> on how to uninstall them.<br>
<br>
<B>OSX Mavericks (or later) issues</B>: please check <a href="questionsandanswers.html#osx-mavericks">Questions & answers #3</A>
</P>
<H3>Windows</H3>
<P>
On Microsoft Windows, the plugin needs the <A HREF="http://www.ftdichip.com/Drivers/D2XX.htm">latest D2XX drivers from FTDI</A>.
Normally, when a FTDI device is plugged in for the first time, Windows will automatically download the D2XX drivers for you, so no
action is needed at all.<br>
If that doesn't happen, please consult the <A HREF="http://www.ftdichip.com/Support/Documents/InstallGuides.htm">FTDI installation guides</A>
to know how to install the drivers.<br>
<B>DO NOT INSTALL VCP (Virtual COM Port) drivers</B> as they will probably interfere with the D2XX interface.
</P>
<H2>ENTTEC DMX USB Pro supported modes</H2>
<P>
Following a grid showing the IO modes supported by QLC+ for devices like DMX USB Pro and Pro Mk2.<br>
If a mode is not listed here, it means it is not supported by QLC+ or the device itself because of hardware limitations,
so please do not report them as issues in the QLC+ forum.<br>
<br>
<TABLE BORDER=1 class="qlcTable">
<TR>
<TD></TD>
<TD>1</TD><TD>2</TD><TD>3</TD><TD>4</TD><TD>5</TD><TD>6</TD><TD>7</TD><TD>8</TD><TD>9</TD><TD>10</TD><TD>11</TD><TD>12</TD><TD>13</TD><TD>14</TD>
</TR>
<TR>
<TD>DMX1 IN</TD>
<TD>o</TD><TD> </TD><TD> </TD><TD>o</TD> <TD></TD> <TD></TD><TD>o</TD><TD> </TD><TD> </TD><TD>o </TD><TD> </TD><TD> </TD><TD>o </TD><TD> </TD>
</TR>
<TR>
<TD>DMX1 OUT</TD>
<TD> </TD><TD>o</TD><TD> </TD><TD> </TD><TD>o</TD><TD> </TD><TD> </TD><TD>o</TD><TD> </TD><TD> </TD><TD>o </TD><TD> </TD><TD> </TD><TD>o </TD>
</TR>
<TR>
<TD>DMX2 OUT (1)</TD>
<TD> </TD><TD> </TD><TD>o</TD><TD>o</TD><TD>o</TD><TD> </TD><TD> </TD><TD> </TD><TD> </TD><TD> </TD><TD> </TD><TD> </TD><TD> </TD><TD> </TD>
</TR>
<TR>
<TD>MIDI IN (2)</TD>
<TD> </TD><TD> </TD><TD> </TD><TD> </TD><TD> </TD><TD>o</TD><TD>o</TD><TD>o</TD><TD> </TD><TD> </TD><TD> </TD><TD>o </TD><TD>o </TD><TD>o </TD>
</TR>
<TR>
<TD>MIDI OUT (2)</TD>
<TD> </TD><TD> </TD><TD> </TD><TD> </TD><TD> </TD><TD> </TD><TD> </TD><TD> </TD><TD>o</TD><TD>o </TD><TD>o </TD><TD>o </TD><TD>o </TD><TD>o </TD>
</TR>
</TABLE>
<br>
(1) DMX2 OUT is available only on DMX USB Mk2 Pro<br>
(2) MIDI IN and MIDI OUT are available only on DMX USB Mk2 Pro with a 5-way breakout cable. MIDI OUT signals are sent
from 1 to 512 as described in the <a href="midiplugin.html#channelsmap">MIDI plugin channels map</A><br>
</P>
<H2>Tuning</H2>
<P>
<B>Note: Manual tuning should never be performed except for some very particular cases. Use it at your own risk!</B><BR>
It is possible to change the DMX frame size for Enttec Open (and like) devices with a
hidden settings key on each platform. The key tells QLC+ how many channels should be transmitted in each DMX frame, so for a DMX universe (by default 512).<BR>
Please refer to the <A HREF="parameterstuning.html#EnttecOpen">Manual parameters tuning</A> DMX USB Enttec Open section
</P>
</BODY>
</HTML>
|
