Personal tools
The Open Lighting Project has moved!

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

Jump to: navigation, search
(Tuitorial to document the steps needed to install QLC, LLA and Enttec DMX USB Pro on Mac OS X)
 
(Checkout LLA)
 
(5 intermediate revisions by one other user not shown)
Line 7: Line 7:
  
 
==Introduction==
 
==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.
+
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.
 
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.
Line 38: Line 38:
 
Once you have these core packages installed, continue
 
Once you have these core packages installed, continue
  
=== GIT ===
+
=== Helper progams ===
  
 
<code><pre>
 
<code><pre>
sudo port install git-core
+
sudo port install git-core pkgconfig protobuf-cpp cppunit unittest-cpp libtool wget
 
</pre></code>
 
</pre></code>
  
= Build LLA =
+
== Download and Install the Enttec DMX USB Pro driver ==
  
= Build QLC =
+
[http://www.ftdichip.com/Drivers/VCP.htm http://www.ftdichip.com/Drivers/VCP.htm]
  
= Install DMX USB Pro Drivers =
+
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:
 +
 
 +
<code><pre>
 +
sudo dmesg
 +
</pre></code>
 +
 
 +
you should see something like:
 +
 
 +
<pre>
 +
FTDIUSBSerialDriver:        0  4036001 start - ok
 +
</pre>
 +
 
 +
==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 ==
 +
 
 +
<code><pre>
 +
  mkdir svn
 +
  git clone https://github.com/OpenLightingProject/ola.git
 +
  cd lla
 +
</pre></code>
 +
 
 +
== Fix libltdl/ ==
 +
 
 +
Somehow this got broken. But this fixes it. For now.
 +
 
 +
<code><pre>
 +
 
 +
  glibtoolize --ltdl --force --copy
 +
  cp /opt/local/share/aclocal/pkg.m4 config
 +
  cp /opt/local/share/aclocal/* libltdl/m4/
 +
 
 +
</pre></code>
 +
 
 +
If glibtoolize fails for some reason, make sure you have the libtool sources
 +
 
 +
== Set some Environment Vars ==
 +
 
 +
<code><pre>
 +
  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/"
 +
</pre></code>
 +
 
 +
== Run autoreconf==
 +
 
 +
If this is the first time run with -i to install the missing files and --force to make up for ./libltdl wierdness
 +
 
 +
<code><pre>
 +
autoreconf -i --force
 +
</pre></code>
 +
 
 +
== Do the usual steps==
 +
 
 +
<code><pre>
 +
./configure
 +
make
 +
make check
 +
sudo make install
 +
</pre></code>
 +
 
 +
 
 +
===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:
 +
 
 +
<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>
 +
 
 +
 
 +
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:
 +
 
 +
<code><pre>
 +
lla_dev_info
 +
</pre></code>
 +
 
 +
you should get something like:
 +
 
 +
<pre>
 +
Device 2: Enttec Usb Pro Device
 +
  port 0, capability IN
 +
  port 1, capability OUT
 +
</pre>
 +
 
 +
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:
 +
 
 +
<code><pre>
 +
lla_patch -d2 -p1 -u0
 +
</pre></code>
 +
 
 +
(replace -d2 with whichever device number is your Usb Pro)
 +
 
 +
now do:
 +
 
 +
<code><pre>
 +
lla_dev_info
 +
</pre></code>
 +
 
 +
and it should say
 +
 
 +
<code><pre>
 +
Device 2: Enttec Usb Pro Device
 +
  port 0, capability IN
 +
  port 1, capability OUT, universe 1
 +
</pre></code>
 +
 
 +
Finally:
 +
 
 +
<code><pre>
 +
lla_dmxconsole
 +
</pre></code>
 +
 
 +
and play with the console!
 +
 
 +
Don't forget to remove your test patch afterwards:
 +
 
 +
<code><pre>
 +
lla_patch -r -d2 -p0 -u0
 +
</pre></code>
 +
 
 +
 
 +
 
 +
= 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>
 +
 
 +
*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!

Latest revision as of 21:21, 19 January 2014


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 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.

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 https://github.com/OpenLightingProject/ola.git
  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: 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)

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!