LLA and Q Light Controller OSX Tutorial
- 1 Purpose
- 2 Introduction
- 3 Operating System
- 4 LLA and Q Light Controller on OSX
- 5 Prerequisite packages
- 6 Download and Install the Enttec DMX USB Pro driver
- 7 Download and install LLA
- 8 Checkout LLA
- 9 Fix libltdl/
- 10 Set some Environment Vars
- 11 Run autoreconf
- 12 Do the usual steps
- 13 Build and Test QLC
To show the steps to get the Enttec DMX USB Pro interface working with the Linux Lighting Architecture under OS X. Also getting the Q Lighting Controller (QLC) to work with LLA.
I have used the page LLA, OpenDMX USB and Q Light Controller Tutorial as a template because it was well written and made sense.
Having used QLC in Linux with dmx4linux and an open dmx usb interface in the past I was excited to have a Mac OS X port of QLC and a DMX USB Pro interface with OS X drivers.
This process was completed on a Mac OS X Leopard 10.5.6 and 10.5.7 system with Xcode 3.2.1 and Qt Framework 4.5.1
LLA and Q Light Controller on OSX
This is a Tutorial for building and installing LLA and Q Light Controller with an Enttec USB Dmx Pro interface.
XCode contains some of the necessary programs and libraries to compile LLA and QLC.
QLC uses the Qt Framework, so might as well have the newest one.
MacPorts is used as a source for many of the tools needed.
Once you have these core packages installed, continue
sudo port install git-core pkgconfig protobuf-cpp cppunit unittest-cpp libtool wget
Download and Install the Enttec DMX USB Pro driver
Install the correct driver depending on if you have an Intel or PPC architechiture machine.
Test the driver
Plug in your dongle!! Hopefully all will go well, and if you type:
you should see something like:
FTDIUSBSerialDriver: 0 4036001 start - ok
Download and install LLA
LLA is Linux Lighting Architecture, a general framework for lighting applications in Linux. It's available as a live CD, but we're just using the package as a way to interface QLC with the USB driver. More info about LLA on its webpage.
Install the packages
mkdir svn git clone https://github.com/OpenLightingProject/ola.git cd lla
Somehow this got broken. But this fixes it. For now.
glibtoolize --ltdl --force --copy cp /opt/local/share/aclocal/pkg.m4 config cp /opt/local/share/aclocal/* libltdl/m4/
If glibtoolize fails for some reason, make sure you have the libtool sources
Set some Environment Vars
export PKG_CONFIG_PATH=$PKG_CONFIG_PATH:/usr/local/lib/pkgconfig export CPPFLAGS="-I/opt/local/var/macports/software/protobuf-cpp/2.0.3_0/opt/local/include/" export LDFLAGS="-L/opt/local/var/macports/software/protobuf-cpp/2.0.3_0/opt/local/lib/ -L/usr/local/lib/ -L/opt/local/lib/"
If this is the first time run with -i to install the missing files and --force to make up for ./libltdl wierdness
autoreconf -i --force
Do the usual steps
./configure make make check sudo make install
Test the installation
With your dongle connected as in section 3, you're now ready to test. Connect a DMX device up to your dongle, make sure you know the channel number it's on, make sure it's working correctly, make sure you got the polarity in your DMX lead right, etc. etc. Being sure that the dongle/hardware/software combination is the only weak link will save a lot of hair-pulling...
Edit your ~/.lla/dmxusbpro.conf file:
Add the following string, replacing the X's for what you have listed in /dev
device = /dev/cu.usbserial-XXXXXXXX
First, start the daemon with debug mode on:
llad -d 3 -f -s
Next, in another terminal find out what number the OpenDMX device is:
you should get something like:
Device 2: Enttec Usb Pro Device port 0, capability IN port 1, capability OUT
If you can't see 'Enttec Usb Pro Device' in there somewhere, then you haven't got the driver installed properly.
Assuming everything is OK, you need to patch this device so we can use it:
lla_patch -d2 -p1 -u0
(replace -d2 with whichever device number is your Usb Pro)
and it should say
Device 2: Enttec Usb Pro Device port 0, capability IN port 1, capability OUT, universe 1
and play with the console!
Don't forget to remove your test patch afterwards:
lla_patch -r -d2 -p0 -u0
Build and Test QLC
svn co https://qlc.svn.sourceforge.net/svnroot/qlc qlc cd qlc qmake -spec macx-g++ make sudo make install lla_patch -d2 -p1 -u1 llad -s -f /Applications/qlc.app/Contents/MacOS/qlc
- Click on Manager
- Select Outputs
- Double-click Universe 1
- Check the box under LLA Output Plugin for 'LLA Output 1'
- Click Ok
- Close the Output Manager
- Click the Parcan icon, add a fixtue, test it out in the console!