wiki.openlighting.org - User contributions [en]

LLA and Q Light Controller OSX Tutorial

2009-05-14T07:48:56Z

66.31.41.250: Final Draft

[[Category:Tutorials]]

== 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 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 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 http://www.macports.org/install.php]

Once you have these core packages installed, continue

=== Helper progams ===

<code><pre>
sudo port install git-core pkgconfig protobuf-cpp cppunit unittest-cpp libtool wget
</pre></code>

== Download and Install the Enttec DMX USB Pro driver ==

[http://www.ftdichip.com/Drivers/VCP.htm 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:

<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 http://www.nomis52.net/git/lla
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!

LLA and Q Light Controller OSX Tutorial

2009-05-14T07:47:28Z

66.31.41.250:

[[Category:Tutorials]]

== 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 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 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 http://www.macports.org/install.php]

Once you have these core packages installed, continue

=== Helper progams ===

<code><pre>
sudo port install git-core pkgconfig protobuf-cpp cppunit unittest-cpp libtool wget
</pre></code>

== Download and Install the Enttec DMX USB Pro driver ==

[http://www.ftdichip.com/Drivers/VCP.htm 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:

<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 http://www.nomis52.net/git/lla
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>

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

Open Lighting Architecture

2009-05-14T07:45:53Z

66.31.41.250: Adding link to OS X / LLA / QLC Tuitorial

Link: http://www.nomis52.net/?section=projects&sect2=lla&page=llaintro 
{{Features|free=yes|tx=yes|rx=yes|linux=yes|osx=yes}}
[[Image:Llad_home.png|right]]

LLA is a framework that allows applications to send and receive DMX, using various hardware devices and 'DMX over IP' protocols. It can make [[:Category:Controllers | software controllers]] talk to DMX hardware.

LLA allows DMX sent using various DMX over IP protocols to be converted from one format to another. This enables devices from different manufacturers to talk to each another (for example a [[Strand_Lighting|Strand]] Console can send DMX to an [[Enttec]] [[DmxEtherGate MKII|EtherGate]]).

[[LLA Live]] is a stand-alone bootable CD containing software from the Linux Lighting Architecture project.

When combined with a physical DMX interface such as the [[DMX USB Pro]], LLA Live can send and receive data from traditional wired DMX networks.

LLA can run on Linux with all its drivers, and on Mac OS X (but at the moment the drivers (LLA plugins) needs to be modified to work).
A port to Windows is feasible, if someone wants to add the necessary code.

Bugs?: Check the bug tracker at http://code.google.com/p/linux-lighting/issues/list

Questions?: See the news group at http://groups.google.com/group/linux-lighting

Supported Devices/Protocols:

{| border=1
! '''Driver'''!! Linux !! '''Mac OS X'''
|-
|| [[:Category:ArtNet|ArtNet]] || Yes || Yes
|-
|| [[:Category:ShowNet|ShowNet]] || Yes || ??
|-
|| [[:Category:ESP Net|ESP Net]] || Yes || ??
|-
|| [[:Category:Sandnet|Sandnet]] || Yes || ??
|-
|| [[E1.31]] / [[ACN]] || underway || ??
|-
|| [[DMX USB Pro]] || Yes || Yes
|-
|| [[Open DMX USB]] || Yes || ??
|-
|| [[StageProfi]] || Yes || ??
|-
|| [[:Category:Pathport|Pathport]] || in testing || ??
|-
|| [[DMX 4 Linux]] || Yes || -
|}

Getting Started

Start here if you've never used LLA before and read these in order.
* [[Download LLA]]
* [[Building LLA]] - How to get it compiled (old version)
* [[Using LLA]] - A basic introduction
* [[LLA Device Specific Configuration]]

Documentation:
* [[LLA 0.3]] - The new release
* [[LLA developer info]] - about the source code and structure
* [[LLA Tips & Tricks]]
* [[Using the Python libraries]] - easy DMX programming

Tutorials
* [[LLA Sandnet Tutorial]] - Setup Horizon using Sandnet and LLA
* [[LLA and Q Light Controller Ubuntu Tutorial]] - Setup LLA on Ubuntu/Debian-type distro with QLC
* [[LLA and Q Light Controller OSX Tutorial]] - Setup LLA on Mac OS X with QLC

LLA can also run on a wireless access point. [http://nomis52.net/?section=projects&sect2=artnet&page=node]

There is a project underway to build packages for OpenWrt. See http://lists.culturebase.org/cgi-bin/mailman/listinfo/lla-openwrt for more details.

[[Category:ArtNet]]
[[Category:ESP Net]]
[[Category:Sandnet]]
[[Category:ShowNet]]
[[Category:Utilities]]

LLA and Q Light Controller OSX Tutorial

2009-05-14T07:44:26Z

66.31.41.250: Near-final draft

[[Category:Tutorials]]

== 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 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 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 http://www.macports.org/install.php]

Once you have these core packages installed, continue

=== Helper progams ===

<code><pre>
sudo port install git-core pkgconfig protobuf-cpp cppunit unittest-cpp libtool wget
</pre></code>

== Download and Install the Enttec DMX USB Pro driver ==

[http://www.ftdichip.com/Drivers/VCP.htm 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:

<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 http://www.nomis52.net/git/lla
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>

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

LLA and Q Light Controller OSX Tutorial

2009-05-14T07:37:46Z

66.31.41.250:

[[Category:Tutorials]]

== 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 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 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 http://www.macports.org/install.php]

Once you have these core packages installed, continue

=== Helper progams ===

<code><pre>
sudo port install git-core pkgconfig protobuf-cpp cppunit unittest-cpp libtool wget
</pre></code>

== Download and Install the Enttec DMX USB Pro driver ==

[http://www.ftdichip.com/Drivers/VCP.htm 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:

<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 http://www.nomis52.net/git/lla
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: Open DMX USB Device
</pre>

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:

<code><pre>
lla_patch -d2 -p0 -u0
</pre></code>

(replace -d2 with whichever device number is your Open DMX USB)

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>

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

LLA and Q Light Controller OSX Tutorial

2009-05-14T07:22:55Z

66.31.41.250:

[[Category:Tutorials]]

== 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 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 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 http://www.macports.org/install.php]

Once you have these core packages installed, continue

=== Helper progams ===

<code><pre>
sudo port install git-core pkgconfig protobuf-cpp cppunit unittest-cpp libtool wget
</pre></code>

== Download and Install the Enttec DMX USB Pro driver ==

[http://www.ftdichip.com/Drivers/VCP.htm 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:

<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 http://www.nomis52.net/git/lla
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>

</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: Open DMX USB Device
</pre>

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:

<code><pre>
lla_patch -d2 -p0 -u0
</pre></code>

(replace -d2 with whichever device number is your Open DMX USB)

now do:

<code><pre>
lla_dev_info
</pre></code>

and it should say

<code><pre>
Device 2: Open DMX USB Device
port 0, cap 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 QLC =

= Install DMX USB Pro Drivers =

LLA and Q Light Controller OSX Tutorial

2009-05-14T05:31:54Z

66.31.41.250: Tuitorial to document the steps needed to install QLC, LLA and Enttec DMX USB Pro on Mac OS X

Building LLA for OS X

2009-05-09T18:45:44Z

66.31.41.250: /* Build Dependencies */ PKG_CONFIG_PATH was incorrect.

See also: [[Building LLA]] and the [[LLA| main article about LLA]].

==Base Development Tools==

Download & install Xcode from http://developer.apple.com/tools/

Download & install fink from http://finkproject.org/

== Install Git ==

If you want to use the git repos, you'll need to install git. If you're just going to use tarballs you can skip this step.

Git requires expat so download & install: http://sourceforge.net/projects/expat/
Download & install git: http://git.or.cz/

Add the following to your .bashrc file:

PATH=$PATH:/usr/local/bin:~/bin

== Build Dependencies ==

apt-get install libtool make automake autoconf wget m4 pkgconfig

edit /sw/share/aclocal/pkg.m4 and replace

AC_DEFUN(PKG_CHECK_MODULES, [

with

AC_DEFUN([PKG_CHECK_MODULES], [

Add the following to your .profile

export PKG_CONFIG_PATH=/usr/local/lib/pkgconfig

== LLA Dependencies ==

Install Template.pm:

apt-get install template-pm586

Install XML::Simple

sudo perl -MCPAN -e shell;
install XML::Simple

Talk:OLA on OS X

2009-05-09T16:21:44Z

66.31.41.250: New page: Are there any instructions for building lla-examples?

Are there any instructions for building lla-examples?