wiki.openlighting.org - User contributions [en]

OLA Python API

2008-02-28T22:38:33Z

Doudou: /* Building the Python Bindings */

== Building the Python Bindings ==

See [[Building LLA]] but run ''./configure --enable-python-libs''

Note that you have to install Swig in order to build the python bindings (sudo apt-get install swig)

There is also a forgotten data in lla/python/Makefile : you have to add -I../include to the value of DEFAULT_INCLUDES at the line 70.

At the end of the installation, you should run ldconfig as root in order to use the python bindings.

== Interesting Classes ==

; LlaClient
: the main connection class
; dmxBuffer
: represents a list of DMX channel values
; LlaClientObserver
: base class to handle events
; LlaPlugin
: represents a Plugin
; LlaDevice
: represents a Device

== Sending DMX ==
A simple example to send DMX:

<pre>
from lla import *
import sys

con = LlaClient()
if con.start():
sys.exit()

universe = 0

# create a dmxBuffer for the channel values
DMX_LEN = 512
dmx = dmxBuffer(DMX_LEN)
for i in range(0, DMX_LEN):
dmx[i] = i

con.send_dmx(universe, dmx, DMX_LEN)
</pre>

== Receiving DMX ==

Receiving is slightly harder, we need to setup an Observer object to handle the events:

''' THIS ISN'T WORKING YET ''' [simonn]

<pre>
from lla import *
import sys

class Observer(LlaClientObserver):
""" Handle the events """
def new_dmx(self, uni, length, data):
""" Called with new dmx buffer """
return 0

# create a new LlaClient
con = LlaClient()

# create an observer object and register
ob = Observer()
con.set_observer(ob)

if con.start():
sys.exit()

con.register_uni(1, LlaClient.REGISTER)

while True:
con.fd_action(1)

</pre>

OLA Python API

2007-12-28T18:38:00Z

Doudou: /* Building the Python Bindings */

== Building the Python Bindings ==

See [[Building LLA]] but run ''./configure --enable-python-libs''

Note that you have to install Swig in order to build the python bindings (sudo apt-get install swig)

== Interesting Classes ==

; LlaClient
: the main connection class
; dmxBuffer
: represents a list of DMX channel values
; LlaClientObserver
: base class to handle events
; LlaPlugin
: represents a Plugin
; LlaDevice
: represents a Device

== Sending DMX ==
A simple example to send DMX:

<pre>
from lla import *
import sys

con = LlaClient()
if con.start():
sys.exit()

universe = 0

# create a dmxBuffer for the channel values
DMX_LEN = 512
dmx = dmxBuffer(DMX_LEN)
for i in range(0, DMX_LEN):
dmx[i] = i

con.send_dmx(universe, dmx, DMX_LEN)
</pre>

== Receiving DMX ==

Receiving is slightly harder, we need to setup an Observer object to handle the events:

''' THIS ISN'T WORKING YET ''' [simonn]

<pre>
from lla import *
import sys

class Observer(LlaClientObserver):
""" Handle the events """
def new_dmx(self, uni, length, data):
""" Called with new dmx buffer """
return 0

# create a new LlaClient
con = LlaClient()

# create an observer object and register
ob = Observer()
con.set_observer(ob)

if con.start():
sys.exit()

con.register_uni(1, LlaClient.REGISTER)

while True:
con.fd_action(1)

</pre>

Building OLA

2007-12-28T18:34:37Z

Doudou: /* Installed Dependencies */

Sometimes you'll need to build [[LLA]] from the sources rather than using the pre-built .deb. For example on non-debian systems or if you want to use the LLA-Dmx4Linux plugin.

See also: [[Building LLA for OS X]]

== Installed Dependencies ==

If you're building from the git version you'll need the perl Template module installed. Run the following:

perl -e "use Template"

If you get an error you'll need to download and install Template.pm (or apt-get install libtemplate-perl)

If, while compiling, you get an error that looks like

Can't locate XML/Simple.pm in @INC

you'll need to install XML::Simple (e.g. apt-get install libxml-simple-perl)

You may also install autoconf, automake and libtool (sudo apt-get install autoconf automake libtool).

In some systems like Ubuntu, default shell has been replaced by Dash. The reconf script needs bash (as it uses popd and pushd). So if you encounter problems while executing the reconf script, you may edit it and replace /bin/sh by /bin/bash in the first line.

== Download & Extract ==

Either download the latest archive or grab the sources via git:

wget http://www.nomis52.net/data/sources/lla/lla-latest.tar.gz
tar -zxf lla-latest.tar.gz

or

git clone http://www.nomis52.net/git/lla

== Build ==

If you downloaded an archive you can skip the reconf step, otherwise run reconf which will also auto-generate parts of the code:

./reconf
Generating source files...
Done lla-UsbPro
Done lla-ArtNet
Running autotools
+ aclocal -I config
+ autoconf
+ autoheader
+ automake -a
+ exit

Then run ./configure and check which plugins will be built:

./configure
...
checking for artnet_new in -lartnet... yes
checking for DMXdev in -ldmx4linux... no
checking for espnet_new in -lespnet... yes
checking for shownet_new in -lshownet... no
checking for sandnet_new in -lsandnet... yes
checking for pathport_new in -lpathport... yes

In this case we're not going to build the shownet and dmx4linux plugins as we don't have the necessary libraries installed.

Finally run make:

make

== Install ==

(become root)

make install

== Test ==

Check that llad runs:

llad -d 3 -f -s

DMX USB Pro

2007-12-18T21:58:25Z

Doudou:

[[Category:USB]]

[[Image:Dmxusb_pro.jpg|right]]

Link: http://www.enttec.com/index.php?menu=Products&prod=70304&show=description&name=dmxusbpro <br>
Made by: [[Enttec]] <br>
{{Features|win=yes|osx=yes|linux=yes|tx=yes|rx=yes|rdm=yes}}

The pro widget unlike it's little brother (The Open DMX USB) contains a microprocessor (ATMEGA88) responsible for framing and transmission, or reception of dmx. Also it's USB interface is a FTDI FT245BM, VCP (virtual com port) drivers make programming easy as opening a serial port and sending/receiving! it has 1500v dmx line isolation, A green LED which indicates RX or TX activity, and gold plated neutrik XLR's (1xmale, 1xfemale wired in parallel).

<b>Related Products:</b>

* [[RDM USB Pro]]
* [[Open DMX USB]]
* [[Pro Toolkit]]