Difference between revisions of "Open Lighting Architecture"

Latest revision as of 14:10, 24 March 2016

Link: http://www.openlighting.org/ola/
{{ #if: yes | }}{{ #if: yes | }}{{ #if: yes | }}{{ #if: yes | }}{{ #if: yes | }}{{ #if: yes | }}{{ #if: yes | }}{{ #if: | }}{{ #if: yes | }}

Universe Settings

RDM Devices Page

Drag & Drop RDM Patching

Mobile UI

The Open Lighting Architecture (OLA) is part of the Open Lighting Project and provides applications with a mechanism to send and receive DMX512 & RDM commands using hardware devices and DMX over IP protocols. This enables software lighting controllers to communicate with hardware either via Ethernet or traditional DMX512 networks.

OLA can also convert DMX512 data sent using DMX over IP protocols from one format to another, allowing devices from different manufacturers to interact with one another. For example a Strand Lighting Console using ShowNet can send DMX512 to an Enttec EtherGate. When combined with a physical DMX interface such as the DMX USB Pro, OLA can send and receive data from wired DMX512 networks.

Supported Protocols

Protocol	FreeBSD	Windows
ArtNet, ArtNet 2, ArtNet 3
E1.31 / ACN		Not yet
ESP Net
KiNET
OSC (Open Sound Control)	?
Pathport
Sandnet
ShowNet

Supported Devices

Device	Mac OS X	FreeBSD	Windows
Anyma uDMX		?	no
Arduino RGB Mixer		?	no
DMX 4 Linux		?	no
DMX USB Pro			no
DMX USB Pro MkII			no
DMX-TRI			no
DMXking USB DMX512-A		?	no
DMXter4 RDM / MiniDMXter		?	no
Eurolite USB DMX512 PRO		?	no
KarateLight		?	no
KMtronic DMX Adapter		?	no
Open DMX USB		?	no
Milford Instruments 1-463	?	?	no
Packetheads USB_DMX Dongle		?	no
RDM USB Pro		?	no
RDM-TRI			no
Renard Serial Protocol (Renard SS24, SS8, etc)	?	?	no
Robe Universal Interface		?	no
RUNIT WTX		?	no
SPI control of LED pixels	?	?	no
StageProfi	(Ethernet version only)	?	no
uDMX_asp		?	no
ultraDMX Pro		?	no
ultraDMX Micro		?	no
USBDMX2		?	no
USB-DMX512		?	no
Velleman K8062		?	no
VX8062		?	no

Getting Started

Start here if you've never used OLA before and read these in order.

Download & Install OLA
Using OLA - A basic introduction
OLA Command Line Tools - Documentation for the tools in ola-examples
OLA Device Specific Configuration
OLA Tips & Tricks
RDM with OLA

Tutorials

OLA on Windows with VMWare
OLA Live CD, instructions on how to use the Live CD
OLA Raspberry Pi
OLA on Beaglebone
OLAGuruPlug - Running OLA on a GuruPlug
OLA RDM Responder Testing
OLA LED Pixels - Using OLA and a Pi to drive SPI LED tape
OlaOutput Max External - Setup OlaOutput on Mac OS X to send DMX messages from Max/MSP/Jitter
OlaLED - control RGB LED via HTTP

Advanced Topics

OLA Merging Algorithms
OLA DiffServ support (QOS settings)
OLA Thread Scheduling (Control latency)
OLA DMX Trigger - Using OLA and DMX to trigger events on a computer
OLA Patch persistency

Developer Documentation

The developer documentation is in the process of being re-written as doxygen comments in the src tarball. The latest generated copy of the docs is hosted at https://docs.openlighting.org/doc/latest/ versions for specific releases are hosted at https://docs.openlighting.org/doc/.

OLA developer info - about the source code and structure
OLA Doxygen Docs - Generated Doxygen docs aimed at developers creating clients.
- See here for info on generating Doxygen docs locally.
Walkthrough of the OSC plugin code - good for people wanting to create new plugins
OLA APIs - See also https://www.openlighting.org/ola/apis/
- Protobufs Based
  - OLA Client API - the C++ API, (also older examples)
  - OLA Python API - easy DMX programming
  - Java - currently a work in progress (see an example using it here)
- Alternatives
  - JSON - Browse to /help on your OLA webserver to see the available commands (append ?help=1 to the end of a command for more info in newer versions of OLA)
  - OSC - Not technically an API, but not strictly a lighting protocol either, enable the OSC plugin and use it to communicate with OLA from a variety of software
Build OLA Mac Packages - notes for building the .dmg images
Building OLA for Windows - Notes on Windows support (in progress)
OLA on Android - Notes on Android support (in progress)
Cross Compiling OLA
Buildbot - For continuous build and testing
Using OLA with Xcode - on a Mac, in Objective-C++
Writing RDM Responder Tests
Port Throttling
RDM PID Definitions
OLA Performance Stats
OLA TimeCode
RPC Protocol (or "How do I talk to OLA in a different language")

Old Tutorials

These refer to the previous release but parts of them are still relevant.

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

@@ Line 1: / Line 1: @@
-Link: http://www.nomis52.net/?section=projects&sect2=lla&page=llaintro <br>
+[[Image:OLA-Logo-Fitted-48px.png|right]]
-{{Features|free=yes|tx=yes|rx=yes|linux=yes}}
+Link: http://www.openlighting.org/ola/ <br>
-[[Image:Llad_home.png|right]]
+{{Features|free=yes|tx=yes|rx=yes|linux=yes|osx=yes|http=yes|rdm=yes|win=yes}}
+[[Image:Ola-download.png |right|link=http://opendmx.net/index.php/Download_%26_Install_OLA]]
+[[Image:Llad_home.png| thumb |200px|right|Universe Settings]]
+[[Image:Ola-rdm.png|thumb|200px|right|RDM Devices Page]]
+[[Image:OLA_patching.png|thumb|200px|right|Drag & Drop RDM Patching]]
+[[Image:Ola-mobile.png|thumb|200px|right|Mobile UI]]
+__NOTOC__
+The Open Lighting Architecture (OLA) is part of the [[Open Lighting Project]] and provides applications with a mechanism to send and receive [[DMX512]] & [[RDM]] commands using hardware devices and DMX over IP protocols. This enables [[:Category:Controllers | software lighting controllers]] to communicate with hardware either via Ethernet or traditional DMX512 networks.
-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]]).
+OLA can also convert DMX512 data sent using DMX over IP protocols from one format to another, allowing devices from different manufacturers to interact with one another. For example a [[Strand_Lighting|Strand]] Lighting Console using ShowNet can send DMX512 to an [[Enttec]] [[DmxEtherGate MKII|EtherGate]]. When combined with a physical DMX interface such as the [[DMX USB Pro]], OLA can send and receive data from wired DMX512 networks.
-LLA Live is a stand-alone bootable CD containing software from the Linux Lighting Architecture project.
+==Supported Protocols==
-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.
+{| border=1 cellspacing="0"
+! '''Protocol'''!! Linux !! '''Mac OS X'''  || '''FreeBSD''' || '''Windows'''
+|-
+|| [[:Category:ArtNet|ArtNet, ArtNet 2, ArtNet 3]]   || [[Image:Green-tick.png|center]] [[Image:Rdm.gif|center]] || [[Image:Green-tick.png|center]][[Image:Rdm.gif|center]] || [[Image:Green-tick.png|center]][[Image:Rdm.gif|center]] || [[Image:Green-tick.png|center]] [[Image:Rdm.gif|center]]
+|-
+|| [[E1.31]] / [[ACN]] || [[Image:Green-tick.png|center]]  || [[Image:Green-tick.png|center]]  || [[Image:Green-tick.png|center]] ||  Not yet
+|-
+|| [[:Category:ESP Net|ESP Net]] || [[Image:Green-tick.png|center]]  || [[Image:Green-tick.png|center]]  || [[Image:Green-tick.png|center]] || [[Image:Green-tick.png|center]]
+|-
+|| [[KiNET]] ||  [[Image:Trans.gif|center]]  ||  [[Image:Trans.gif|center]] ||  [[Image:Trans.gif|center]] || [[Image:Trans.gif|center]]
+|-
+|| [[OSC]] (Open Sound Control)  || [[Image:Green-tick.png|center]]  || [[Image:Green-tick.png|center]] || ? || [[Image:Green-tick.png|center]]
+|-
+|| [[:Category:Pathport|Pathport]]  || [[Image:Green-tick.png|center]]  || [[Image:Green-tick.png|center]] || [[Image:Green-tick.png|center]] || [[Image:Green-tick.png|center]]
+|-
+|| [[:Category:Sandnet|Sandnet]] || [[Image:Green-tick.png|center]]  || [[Image:Green-tick.png|center]] || [[Image:Green-tick.png|center]] || [[Image:Green-tick.png|center]]
+|-
+|| [[:Category:ShowNet|ShowNet]] || [[Image:Green-tick.png|center]]  || [[Image:Green-tick.png|center]] || [[Image:Green-tick.png|center]] || [[Image:Green-tick.png|center]]
+|}
-<b>Questions?</b>: See http://groups.google.com/group/linux-lighting
+==Supported Devices==
-<b>Supported Devices/Protocols:</b>
+{| border=1 cellspacing="0"
-* [[:Category:ArtNet|ArtNet]]
+! '''Device'''!! Linux !! '''Mac OS X'''  || '''FreeBSD''' || '''Windows'''
-* [[:Category:ShowNet|ShowNet]]
+|-
-* [[:Category:ESP Net|ESP Net]]
+||  [[Anyma uDMX]] || [[Image:Trans.gif|center]] || [[Image:Trans.gif|center]]  || ? || no
-* [[:Category:Sandnet|Sandnet]]
+|-
-* [[DMX USB Pro]]
+|| [[Arduino RGB Mixer]] || [[Image:Green-tick.png|center]] [[Image:Rdm.gif|center]]  || [[Image:Green-tick.png|center]] [[Image:Rdm.gif|center]] || ? || no
-* [[Open DMX USB]] (through the [http://www.erwinrol.com/index.php?opensource/dmxusb.php Linux kernel module from Erwin Rol], as detailed in [[LLA, OpenDMX USB and Q Light Controller Tutorial]])
+|-
-* [[DMX 4 Linux]]
+|| [[DMX 4 Linux]] || [[Image:Trans.gif|center]]  ||  ||  ? || no
-* [[StageProfi]]
+|-
+|| [[DMX USB Pro]] || [[Image:Trans.gif|center]] [[Image:Recv.gif|center]] [[Image:Rdm.gif|center]]  || [[Image:Trans.gif|center]] [[Image:Recv.gif|center]] [[Image:Rdm.gif|center]]  ||  [[Image:Trans.gif|center]] [[Image:Recv.gif|center]] [[Image:Rdm.gif|center]] || no
+|-
+|| [[DMX USB Pro MkII]] || [[Image:Trans.gif|center]] [[Image:Recv.gif|center]] [[Image:Rdm.gif|center]]  || [[Image:Trans.gif|center]] [[Image:Recv.gif|center]] [[Image:Rdm.gif|center]]  ||  [[Image:Trans.gif|center]] [[Image:Recv.gif|center]] [[Image:Rdm.gif|center]] || no
+|-
+|| [[DMX-TRI]] || [[Image:Trans.gif|center]] || [[Image:Trans.gif|center]]  || [[Image:Trans.gif|center]] || no
+|-
+|| [[DMXking USB DMX512-A]] || [[Image:Trans.gif|center]] [[Image:Recv.gif|center]] || [[Image:Trans.gif|center]] [[Image:Recv.gif|center]] || ? || no
+|-
+|| [[DMXter4 RDM]] / [[MiniDMXter]] || [[Image:Rdm.gif|center]] || [[Image:Rdm.gif|center]] || ? || no
+|-
+|| [[Eurolite USB DMX512 PRO]] || [[Image:Trans.gif|center]] || [[Image:Trans.gif|center]]  || ? || no
+|-
+|| [[KarateLight]] || [[Image:Trans.gif|center]] ||  || ? || no
+|-
+|| [http://kmtronic.com/kmtronic-dmx-adapter.html KMtronic DMX Adapter] || [[Image:Trans.gif|center]] ||  || ? || no
+|-
+|| [[Open DMX USB]] || [[Image:Trans.gif|center]]  ||  || ? || no
+|-
+|| [[Milford Instruments 1-463]] || [[Image:Trans.gif|center]] || ? || ? || no
+|-
+|| [[Packetheads USB_DMX Dongle]] ||  [[Image:Green-tick.png|center]]  ||  [[Image:Green-tick.png|center]]  || ? || no
+|-
+|| [[RDM USB Pro]] || [[Image:Trans.gif|center]]  [[Image:Recv.gif|center]]  || [[Image:Trans.gif|center]]  [[Image:Recv.gif|center]] || ? || no
+|-
+|| [[RDM-TRI]] || [[Image:Trans.gif|center]] [[Image:Rdm.gif|center]] || [[Image:Trans.gif|center]] [[Image:Rdm.gif|center]] ||   [[Image:Trans.gif|center]] [[Image:Rdm.gif|center]]  || no
+|-
+|| [http://www.doityourselfchristmas.com/wiki/index.php?title=Renard Renard Serial Protocol (Renard SS24, SS8, etc)] || [[Image:Trans.gif|center]] || ? || ? || no
+|-
+|| [[Robe Universal Interface]] || [[Image:Trans.gif|center]]  [[Image:Recv.gif|center]] [[Image:Rdm.gif|center]] || [[Image:Trans.gif|center]]  [[Image:Recv.gif|center]] [[Image:Rdm.gif|center]] || ? || no
+|-
+|| [[RUNIT WTX]] || [[Image:Trans.gif|center]]  [[Image:Recv.gif|center]] [[Image:Rdm.gif|center]] || [[Image:Trans.gif|center]]  [[Image:Recv.gif|center]] [[Image:Rdm.gif|center]] ||  ? || no
+|-
+|| [[OLA_LED_Pixels|SPI control of LED pixels]] || [[Image:Trans.gif|center]] [[Image:Rdm.gif|center]] || ? || ? || no
+|-
+|| [[StageProfi]] || [[Image:Trans.gif|center]]  || [[Image:Trans.gif|center]] (Ethernet version only) || ? || no
+|-
+|| [http://machosehead.wordpress.com/2010/06/12/udmx_asp/ uDMX_asp] || [[Image:Trans.gif|center]]  || [[Image:Trans.gif|center]]  || ? || no
+|-
+|| [[ultraDMX Pro]] ||  [[Image:Trans.gif|center]] [[Image:Recv.gif|center]]  || [[Image:Trans.gif|center]] [[Image:Recv.gif|center]]  || ? || no
+|-
+|| [[ultraDMX Micro]] ||  [[Image:Trans.gif|center]] [[Image:Recv.gif|center]]  || [[Image:Trans.gif|center]] [[Image:Recv.gif|center]]  || ? || no
+|-
+|| [[USBDMX2]] || [[Image:Trans.gif|center]]  || [[Image:Trans.gif|center]]  || ? || no
+|-
+|| [http://www.soh.cz/produkty/modul-usb-dmx512 USB-DMX512] || [[Image:Trans.gif|center]]  || [[Image:Trans.gif|center]]  || ? || no
+|-
+|| [[Velleman K8062]] || [[Image:Trans.gif|center]]  || [[Image:Trans.gif|center]]  || ? || no
+|-
+|| [[Velleman_K8062_Upgrade|VX8062]] || [[Image:Trans.gif|center]]  || [[Image:Trans.gif|center]]  || ? || no
+|}
-<b>Under development:</b>
+==Getting Started==
-* [[:Category:Pathport|Pathport]] (in testing)
-* [[E1.31]] / [[ACN]] ("Architecture for Control Networks" protocol)
-<b>Documentation:</b>
+Start here if you've never used OLA before and read these in order.
-* [[Using LLA]] - A basic introduction
+* [[Download & Install OLA]]
-* [[Building LLA]] - How to get it compiled
+* [[Using OLA]] - A basic introduction
-* [[Using the Python libraries]] - easy DMX programming
+* [[OLA Command Line Tools]] - Documentation for the tools in ola-examples
-* [[LLA Tips & Tricks]]
+* [[OLA Device Specific Configuration]]
-* [[LLA Sandnet Tutorial]] - Setup Horizon using Sandnet and LLA
+* [[OLA Tips & Tricks]]
-* [[LLA and Q Light Controller Ubuntu Tutorial]] - Setup LLA on Ubuntu/Debian-type distro with QLC
+* [[RDM with OLA]]
-There
-<b>Availability:</b>
+===Tutorials===
+* [[OLA on Windows with VMWare]]
+* [[OLA Live CD]], instructions on how to use the Live CD
+* [[OLA Raspberry Pi]]
+* [[OLA on Beaglebone]]
+* [[OLAGuruPlug]] - Running OLA on a [http://www.globalscaletechnologies.com/c-4-guruplugs.aspx GuruPlug]
+* [[OLA RDM Responder Testing]]
+* [[OLA LED Pixels]] - Using OLA and a Pi to drive SPI LED tape
+* [[OlaOutput Max External]] - Setup OlaOutput on Mac OS X to send DMX messages from Max/MSP/Jitter
+* [[OlaLED]] - control RGB LED via HTTP
-Sources (via git)
+===Advanced Topics===
+* [[OLA Merging Algorithms]]
+* [[OLA DiffServ support]] (QOS settings)
+* [[OLA Thread Scheduling]] (Control latency)
+* [[OLA DMX Trigger]] - Using OLA and DMX to trigger events on a computer
+* [[OLA Patch persistency]]
- http://www.nomis52.net/git/lla
+===Developer Documentation===
- http://www.nomis52.net/git/lla-examples
-Debian Packages:
+The developer documentation is in the process of being re-written as doxygen comments in the src tarball. The latest generated copy of the docs is hosted at https://docs.openlighting.org/doc/latest/ versions for specific releases are hosted at https://docs.openlighting.org/doc/.
- http://www.nomis52.net/data/debian
+* [[OLA developer info]] - about the source code and structure
+* [[doc:index|OLA Doxygen Docs]] - Generated Doxygen docs aimed at developers creating clients.
-RPMS:
+** See [[OLA_on_Linux#Doxygen_Documentation|here]] for info on generating Doxygen docs locally.
+* [[code-raw:plugins/osc/README|Walkthrough of the OSC plugin code]] - good for people wanting to create new plugins
- http://rpms.netmindz.net/
+* OLA APIs - See also [https://www.openlighting.org/ola/apis/ https://www.openlighting.org/ola/apis/]
+** Protobufs Based
-Live CD (iso):
+*** [[doc:client_tutorial|OLA Client API]] - the C++ API, (also [[OLA Client API|older examples]])
+*** [[OLA Python API]] - easy DMX programming
- [https://sourceforge.net/project/showfiles.php?group_id=126566&package_id=192352 Sourceforge]
+*** [[code:java|Java]] - currently a work in progress (see an example using it [https://github.com/neophob/ola-to-tpm2net here])
+** Alternatives
+*** [[OLA JSON API|JSON]] - Browse to /help on your OLA webserver to see the available commands (append ?help=1 to the end of a command for more info in newer versions of OLA)
-There is a project underway to build packages for OpenWrt. See http://lists.culturebase.org/cgi-bin/mailman/listinfo/lla-openwrt for more details.
+*** [[OSC]] - Not technically an API, but not strictly a lighting protocol either, enable the OSC plugin and use it to communicate with OLA from a variety of software
+* [[Build OLA Mac Packages]] - notes for building the .dmg images
-This means that you can send DMX data over WiFi, and connect a DMX interface to the router/access point.
+* [[Building OLA for Windows]] - Notes on Windows support (in progress)
+* [[OLA on Android]] - Notes on Android support (in progress)
+* [[Cross Compiling OLA]]
+* [[OLA Buildbot|Buildbot]] - For continuous build and testing
+* [[Using OLA with Xcode]] - on a Mac, in Objective-C++
+* [[Writing RDM Responder Tests]]
+* [[Port Throttling]]
+* [[RDM PID Definitions]]
+* [[OLA Performance Stats]]
+* [[OLA TimeCode]]
+* [[doc:rpc_system|RPC Protocol]] (or "How do I talk to OLA in a different language")
+===Old Tutorials===
+These refer to the previous release but parts of them are still relevant.
+* [[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
 [[Category:ArtNet]]
 [[Category:ESP Net]]
+[[Category:E1.31]]
 [[Category:Sandnet]]
 [[Category:ShowNet]]
 [[Category:Utilities]]
+[[Category:Pathport]]

Personal tools

Difference between revisions of "Open Lighting Architecture" - wiki.openlighting.org

Search

Navigation

Tools