wiki.openlighting.org - User contributions [en]

OLA on FreeBSD

2013-11-09T13:49:26Z

Douglas Heriot: Added FreeBSD 10.0 pkgng install line

Since version 0.8.22, OLA can run on FreeBSD (tested on 9.0).

=Dependencies=

* pkg_add -r bison (will install m4, libiconv, gettext)
* pkg_add -r pkg-config
* pkg_add -r protobuf
* pkg_add -r ossp-uuid
* pkg_add -r cppunit
* pkg_add -r libmicrohttpd

* pkg_add -r python27
* pkg_add -r py27-protobuf (will install py27-setuptools)

==FreeBSD 10 pkgng==

One-liner to install everything using the new pkgng in FreeBSD 10

<code>pkg install bison pkgconf protobuf ossp-uuid cppunit libmicrohttpd python27 py27-protobuf autoconf automake libtool</code>

==Packages==

You can use this combo line:
* pkg_add -r bison pkg-config protobuf ossp-uuid cppunit libmicrohttpd python27 py27-protobuf

pkg_info (FreeBSD 9.0-RELEASE)

* bison-2.4.3,1 A parser generator from FSF, (mostly) compatible with Yacc
* cppunit-1.12.1 C++ port of the JUnit framework for unit testing
* gettext-0.18.1.1 GNU gettext package
* libiconv-1.13.1_1 A character set conversion library
* libmicrohttpd-0.9.15 C library for embedding HTTP server functionality
* m4-1.4.16,1 GNU m4
* ossp-uuid-1.6.2_1 ISO-C & Perl API and CLI for generating Universally Unique
* pkg-config-0.25_1 A utility to retrieve information about installed libraries
* protobuf-2.4.1 A data interchange format library
* py27-protobuf-2.4.1 Google protobuf Python Client Library
* py27-setuptools-0.6c11_1 Download, build, install, upgrade, and uninstall Python pac
* python27-2.7.2_3 An interpreted object-oriented programming language

==Tools==

If you want to run autoreconf (after git clone for example):
* pkg_add -r autoconf268 automake111 libtool

pkg_info

* autoconf-2.68 Automatically configure source code on many Un*x platforms
* automake-1.11.1 GNU Standards-compliant Makefile generator (1.11)
* libtool-2.4_1 Generic shared library support script

=Building OLA=

You can use the tarball or git to get the code.

---

Version >= 0.8.22

See here what has been done:

http://forums.freebsd.org/showthread.php?t=33715

---

Code:

http://code.google.com/p/open-lighting/source/checkout

You just need to run:
* $ ./configure (--enable-rdm-tests will need python)
* $ make
* # make install

=Running OLA=

* $ olad -l3

Since you built with libmicrohttpd, you can use the web UI from http://127.0.0.1:9090

=Other BSD=

We don't forget these nice systems !

But you need to know that bsd is not like linux, each system has its kernel and userland.

So it could work on one system and not on another.

==NetBSD==

You can build ola on NetBSD (5.1 or 6.0)

(without python-libs because python-protobuf is missing):

* ksh (Don't forget to switch to ksh !)
* export PKG_PATH="http://ftp.netbsd.org/pub/pkgsrc/packages/NetBSD/i386/5.1/All/"
or
* export PKG_PATH="http://ftp.netbsd.org/pub/pkgsrc/packages/NetBSD/i386/6.0/All/"

* pkg_add bison pkg-config protobuf ossp-uuid cppunit
* pkg_add libmicrohttpd (will install more dependencies)

* pkg_add ncurses (not enough, feel free to edit)
* pkg_add autoconf automake libtool
* pkg_add scmgit (to use git repo)

* $ ./configure
* $ make
* # make install

==OpenBSD==

We still have problems to build on OpenBSD (5.1 or 5.2) :/

Because of this bug:

http://code.google.com/p/protobuf/issues/detail?id=406

But you can try with:

* export PKG_PATH="ftp://ftp.openbsd.org/pub/OpenBSD/5.1/packages/i386/"
* pkg_add bison protobuf ossp-uuid cppunit

* pkg_add autoconf automake (it will tell you the versions)
* pkg_add autoconf-2.68 automake-1.11.1p2 libtool
* export AUTOCONF_VERSION=2.68
* export AUTOMAKE_VERSION=1.11
* hack config/ola.m4 if you want
* autoreconf -fi

++

OLA Logo

2012-09-02T23:15:41Z

Douglas Heriot: Added links to logo files.

[[Image:OLA_Logo.png|right|250px|OLA Logo]]

= Terms of Use =

The logo for the Open Lighting Project is released under the following license.
<pre>
Original version Copyright © 2010 Simon Newton
Revised version Copyright © 2012 Douglas Heriot
This logo may be used by anyone to refer to the Open Lighting Project project, but does not indicate endorsement by the project.
</pre>

For all permitted uses of our logos, you may not:

* alter our logos in any way
* place our logos in such close proximity to other content that it is indistinguishable
* use our logos in a way that is harmful, deceptive, obscene or otherwise objectionable to the average person
* use our logos on websites or other places containing content associated with hate speech, gambling or illegal activities
* use our logos to, or in connection with, content that disparages us or sullies our reputation

Please link to http://www.openlighting.org/ if you use the logo on a web page.

= Graphical usage guidelines =

The logo is in sharp contrast with the background. The normal appearance is black on white. When the logo must be used on dark background it is inverted to white on black instead of the normal black on white.

= Creative Kit =

https://github.com/DouglasHeriot/open-lighting-logo.git contains the logo in various sizes as well as the source files.

= Individual Files =

* [https://github.com/DouglasHeriot/open-lighting-logo/raw/master/OLA%20Logo.ai Original Adobe Illustrator CS6 source file]
* [https://github.com/DouglasHeriot/open-lighting-logo/raw/master/vector/OLA%20Logo.svg SVG]

Other files:
* [https://github.com/DouglasHeriot/open-lighting-logo/tree/master/vector Other Vector files]
* [https://github.com/DouglasHeriot/open-lighting-logo/tree/master/raster Raster files]
* [https://github.com/DouglasHeriot/open-lighting-logo/tree/master/web%20fitted Web Fitted]

File:OLA-Logo-Fitted-48px@2x.png

2012-09-02T22:05:14Z

Douglas Heriot:

File:OLA Logo.png

2012-09-02T21:59:08Z

Douglas Heriot:

DMX Assistant

2012-04-22T05:40:16Z

Douglas Heriot:

[[Image:DMX Assistant Icon.png|200px|right]]
Link: http://douglasheriot.com/dmxassistant/ 
Made by: [[User:Douglas Heriot|Douglas Heriot]] 
{{Features|osx=yes|tx=yes|rx=yes|midi=yes}}

DMX Assistant is a Mac app that allows you to send & receive DMX via [[ArtNet]]. The interface is designed to be as simple as possible for when all you need is a quick way to send some DMX for testing equipment or simple shows. It also displays all [[ArtNet]] universes being broadcast around the network so you can see what’s going on.

The latest version now supports MIDI for controlling the level of saved submasters.

[[Image:DMX Assistant Faders.png]]

Related Products:
* [[Open DMX Ethernet]]

[[Category:Controllers]]

File:DMX Assistant Faders.png

2012-04-22T05:35:21Z

Douglas Heriot: Screenshot of DMX Assistant’s main screen.

Screenshot of [[DMX Assistant]]’s main screen.

User:Douglas Heriot

2012-04-22T05:29:14Z

Douglas Heriot:

Hi there!

I’m a software engineer, mostly working on Mac & iOS. I’ve created the handy [[DMX Assistant]] Mac app, and have some other fun stuff coming soon too.

See [http://douglasheriot.com DouglasHeriot.com]

User:Douglas Heriot

2012-04-22T05:26:12Z

Douglas Heriot:

Developer of [[DMX Assistant]]

See [http://douglasheriot.com DouglasHeriot.com]

DMX Assistant

2012-04-22T05:25:18Z

Douglas Heriot: Created page with "File:DMX Assistant Icon.png"

[[File:DMX Assistant Icon.png]]

File:DMX Assistant Icon.png

2012-04-22T05:24:11Z

Douglas Heriot: DMX Assistant’s icon

[[DMX Assistant]]’s icon

User talk:Douglas Heriot

2012-04-22T05:20:13Z

Douglas Heriot: Created page with "Hi! The best way to get in contact with me is probably via [http://douglasheriot.com/#contact my website]."

Hi!

The best way to get in contact with me is probably via [http://douglasheriot.com/#contact my website].

User:Douglas Heriot

2012-04-22T05:15:05Z

Douglas Heriot: Created page with "Developer of [http://douglasheriot.com/dmxassistant/ DMX Assistant] See [http://douglasheriot.com DouglasHeriot.com]"

Developer of [http://douglasheriot.com/dmxassistant/ DMX Assistant]

See [http://douglasheriot.com DouglasHeriot.com]

UltraDMX Pro

2012-04-22T05:13:42Z

Douglas Heriot: removed example link added by accident

[[Image:UltraDMX_Pro.png|right|200px]]

Link: http://dmxking.com/index.php?option=com_virtuemart&page=shop.product_details&flypage=flypage.tpl&product_id=14&Itemid=2&vmcchk=1&Itemid=2 
Made by: [[DMXKing]] 
{{Features|win=yes|linux=yes|osx=yes|tx=yes|rx=yes}}

The DMXking.com ultraDMX Pro product is a robust 3 universe bi-directional DMX512 interface communicating with the host computer over USB. An onboard Atmel microcontroller ensures complete timing accuracy and no flickering effects no matter what your computer is doing. Device communication using FTDI virtual COM port (VCP) or direct (D2XX) drivers allows use of any mainstream OS.

Operation in 3 universe mode (1 in, 2 out) requires compatible software (see [[USB_Protocol_Extensions#Send_DMX_Multiple_Universes.2C_Label_.3D_100.2C_101|protocol extensions]]). Enhanced mode is disabled automatically when standard (ENTTEC USB Pro) commands are received and only 1 universe operation can be achieved however all outputs are available.

A standalone mode is also available for DMX512 splitter functionality making the ultraDMX Pro product truly universal.

Main Features

* Fully isolated between all XLR connectors and USB interface
* Supported operating systems: Windows, Mac OS, Linux
* DMX512 Transmitter and Receiver (OUT and IN)
* Tough metal enclosure with multiple mounting options
* Available with 3 pin or 5 pin XLR socket, no adapter purchase required.
* ANSI E1.11-2008 and E1.20-2006 compliant (DMX512-A and RDM).
* E1.11 Higher Protection Level “DMX512-A Protected” device.
* Internal double buffered DMX512 streams resulting in zero lost frames.
* Fully compatible with *ALL* software suitable for ENTTEC USB Pro.
* Configuration utility (Windows platform only .NET 3.5 – contact support for other OS).
* Firmware update utility (Windows platform only .NET 3.5 – contact support for other OS).

[[Category:USB]]

UltraDMX Pro

2012-04-22T05:13:03Z

Douglas Heriot: added link to protocol extension for 1 in, 2 out mode.

[http://www.example.com link title][[Image:UltraDMX_Pro.png|right|200px]]

Link: http://dmxking.com/index.php?option=com_virtuemart&page=shop.product_details&flypage=flypage.tpl&product_id=14&Itemid=2&vmcchk=1&Itemid=2 
Made by: [[DMXKing]] 
{{Features|win=yes|linux=yes|osx=yes|tx=yes|rx=yes}}

The DMXking.com ultraDMX Pro product is a robust 3 universe bi-directional DMX512 interface communicating with the host computer over USB. An onboard Atmel microcontroller ensures complete timing accuracy and no flickering effects no matter what your computer is doing. Device communication using FTDI virtual COM port (VCP) or direct (D2XX) drivers allows use of any mainstream OS.

Operation in 3 universe mode (1 in, 2 out) requires compatible software (see [[USB_Protocol_Extensions#Send_DMX_Multiple_Universes.2C_Label_.3D_100.2C_101|protocol extensions]]). Enhanced mode is disabled automatically when standard (ENTTEC USB Pro) commands are received and only 1 universe operation can be achieved however all outputs are available.

A standalone mode is also available for DMX512 splitter functionality making the ultraDMX Pro product truly universal.

Main Features

* Fully isolated between all XLR connectors and USB interface
* Supported operating systems: Windows, Mac OS, Linux
* DMX512 Transmitter and Receiver (OUT and IN)
* Tough metal enclosure with multiple mounting options
* Available with 3 pin or 5 pin XLR socket, no adapter purchase required.
* ANSI E1.11-2008 and E1.20-2006 compliant (DMX512-A and RDM).
* E1.11 Higher Protection Level “DMX512-A Protected” device.
* Internal double buffered DMX512 streams resulting in zero lost frames.
* Fully compatible with *ALL* software suitable for ENTTEC USB Pro.
* Configuration utility (Windows platform only .NET 3.5 – contact support for other OS).
* Firmware update utility (Windows platform only .NET 3.5 – contact support for other OS).

[[Category:USB]]

USB Protocol Extensions

2012-04-22T05:08:52Z

Douglas Heriot: Added note about DMX King ultraDMX Pro multiple output universes, label 100 & 101

This documents the additional message types added to the [[Enttec]] [[DMX USB Pro]] protocol to support multiple device types. As the number of devices supporting the protocol grows, it becomes difficult for software like [[OLA]] to differentiate the device types. The ''Device Manufacturer'' & ''Device Name'' messages allow the host software to determine the device and know which set of messages it supports.

== Other Solutions ==

=== USB Serial Number ===

Enttec USB Pro devices have only started programming the serial numbers recently (>2008?).
When using the standard USB Serial drivers on Mac & Linux, the host application doesn't have access to the serial numbers. This would require us to write our own USB drivers using libusb to expose this information.

=== Use the User Addressable EEPROM ===

Some devices don't support the ''Set Widget Parameters'' message so this isn't an option. Also it suffers from the bootstrapping issue, we need to know what device it is before we can write the information about what device it is...

== Device Manufacturer, Label = 77, no data ==

This message requests the device manufacturer information from the widget. The response is of the form:

{| border=1
! '''Size in Bytes'''!! Description
|-
|| 2 || [[ESTA]] ID, Least significant byte first
|-
|| 32 || Up to 32 bytes containing the manufacturer name. Not null terminated.
|}

== Device Name, Label = 78, no data ==

This message requests the device name information from the widget. The response is of the form:

{| border=1
! '''Size in Bytes'''!! Description
|-
|| 2 || Device Type ID, Manufacturer assigned. Least significant byte first.
|-
|| 32 || Up to 32 bytes containing the device type. Not null terminated.
|}

== Devices Supporting these Message Types ==

* [[Arduino RGB Mixer]] , ESTA ID: 0x7a70, Device ID: 0x1
* [[Packetheads USB_DMX Dongle]] , ESTA ID: 0x7a70, Device ID: 0x2
* [[DMX-TRI]], ESTA ID: 0x6864, Device ID 0x0: 0x1
* [[RDM-TRI]], ESTA ID: 0x6864, Device ID 0x0: 0x2
* [[DMXking USB DMX512-A]], ESTA ID: 0x6A6B, Device ID: 0x0
* [[UltraDMX]], ESTA ID: 0x6A6B, Device ID: 0x1
* [[UltraDMX Pro]], ESTA ID: 0x6A6B, Device ID: 0x2
* [[UltraDMX Micro]], ESTA ID: 0x6A6B, Device ID: 0x3
* [[UltraDMX RDM Pro]], ESTA ID: 0x6A6B, Device ID: 0x4
* [[DMXter4_RDM]], ESTA ID: 0x4744, Device ID: 0x4D44
* [[MiniDMXter]], ESTA ID: 0x4744, Device ID: 0x494D

== Send DMX Multiple Universes, Label = 100, 101 ==

The DMX King [[UltraDMX Pro]] supports 2 universes output and 1 input simultaneously. They have added extensions to cater for these separate output universes:

''Label = 100 Output Only Send DMX Packet Request Universe 1 on outputs 1 & 2 (same format as label 6)
Label = 101 Output Only Send DMX Packet Request Universe 2 on outputs 3 & 4 (same format as label 6)

When Label 6 data is received the ultraDMX Pro reverts back to standard mode and outputs 1 universe data on outputs 1,2,3&4.''

== External References ==

* [http://www.enttec.com/docs/dmx_usb_pro_api_spec.pdf DMX Pro API]
* [http://www.esta.org/tsp/working_groups/CP/mfctrIDs.php ESTA IDs]
* [http://dmxking.com/downloads/0080/0080-700-1.0.pdf ultraDMX Pro User Manual] (see section 9 "Communications Protocol" for label 100, 101 description)