We've launched our new site at www.openlighting.org. This wiki will remain and be updated with more technical information.
Difference between revisions of "LLA and Q Light Controller OSX Tutorial"
From wiki.openlighting.org
Line 122: | Line 122: | ||
<code><pre> | <code><pre> | ||
+ | vi lla-usbpro.conf | ||
+ | </pre></code> | ||
+ | Add the following string, replacing the X's for what you have listed in /dev | ||
+ | <code><pre> | ||
+ | device = /dev/cu.usbserial-XXXXXXXX | ||
</pre></code> | </pre></code> | ||
+ | |||
First, start the daemon with debug mode on: | First, start the daemon with debug mode on: | ||
Line 160: | Line 166: | ||
<code><pre> | <code><pre> | ||
− | Device 2: | + | Device 2: Enttec Usb Pro Device |
− | port 0, | + | port 0, capability IN |
+ | port 1, capability OUT, universe 1 | ||
</pre></code> | </pre></code> | ||
Line 180: | Line 187: | ||
− | = Build QLC = | + | = Build and Test QLC = |
+ | |||
+ | <code><pre> | ||
+ | |||
+ | 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 | ||
+ | |||
+ | </pre></code> | ||
− | + | <ul> | |
+ | <li>Click on Manager | ||
+ | <li>Select Outputs | ||
+ | <li>Double-click Universe 1 | ||
+ | <li>Check the box under LLA Output Plugin for 'LLA Output 1' | ||
+ | <li>Click Ok | ||
+ | <li>Close the Output Manager | ||
+ | <li>Click the Parcan icon, add a fixtue, test it out in the console! | ||
+ | </ul> |
Revision as of 00:37, 14 May 2009
Contents
- 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
Purpose
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.
Introduction
I have used the page [ http://www.opendmx.net/index.php/LLA%2C_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.
Operating System
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.
Prerequisite packages
XCode
XCode contains some of the necessary programs and libraries to compile LLA and QLC.
http://developer.apple.com/technology/xcode.html
Qt Framework
QLC uses the Qt Framework, so might as well have the newest one.
http://www.qtsoftware.com/downloads/mac-os-cpp
MacPorts
MacPorts is used as a source for many of the tools needed.
http://www.macports.org/install.php
Once you have these core packages installed, continue
Helper progams
sudo port install git-core pkgconfig protobuf-cpp cppunit unittest-cpp libtool wget
Download and Install the Enttec DMX USB Pro driver
http://www.ftdichip.com/Drivers/VCP.htm
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:
sudo dmesg
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
Checkout LLA
mkdir svn
git clone http://www.nomis52.net/git/lla
cd lla
Fix libltdl/
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/"
Run autoreconf
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:
vi lla-usbpro.conf
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:
lla_dev_info
you should get something like:
Device 2: Open DMX USB Device
If you can't see 'Open DMX USB Device' in there somewhere, then you haven't got the kernel driver installed properly. Go straight to jail, do not pass go.
Assuming everything is OK, you need to patch this device so we can use it:
lla_patch -d2 -p0 -u0
(replace -d2 with whichever device number is your Open DMX USB)
now do:
lla_dev_info
and it should say
Device 2: Enttec Usb Pro Device
port 0, capability IN
port 1, capability OUT, universe 1
Finally:
lla_dmxconsole
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!