Personal tools
The Open Lighting Project has moved!

We've launched our new site at This wiki will remain and be updated with more technical information.

Linux ArtNet Node


Revision as of 10:37, 11 January 2007 by Nomis52 (talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

Written by Thomas Hinterberger.

This HOWTO outlines a method for creating an ArtNetNode on an Intel/AMD32 Computer (minmum proved: PI/200 32 MB Ram/400MB Harddisk ) using an Enttec Open DMX USB Interface (not the Pro). For instructions on how to install on to a USB stick see

This howto uses the Debian Sarge Netinstall-CD-Image (100 Mb) -

The computer must be connected to the Internet using DHCP to download the packages.

For installation follow: (enter linux26 at the boot prompt to install a 2.6 kernel)

choose Node1 as hostname and ArtNet as Domainname

on page 2 of the installation guide "debian software configuration" you choose manual package selection by going there with the courser and use the space tab to select it.

On the Configuration Exim v4 you choose no configuration on this time and you will end up with aptitude

close aptitude with :q

log in with your username and password

now you typ to the console with the following convention:

  1. command Type command as root- to get root type 'su' followed by the root password

$ command Type command as user - to get user type exit

#:nano /etc/apt/sources.list

You add the following line:

deb ./

ctrl (strg) o + enter to save ctrl x to exit nano

#:apt-get update
#:apt-get install kernel-headers-$(uname -r) g++ make libartnet1 artnet-examples

before you say yes note the version of your kernel-headers

$:tar -zxf dmx_usb_module-20040914.tar.gz
$:cd dmx_usb_module
$:cd ..
#:cp dmx_usb_module/dmx_usb.ko /lib/modules/2.6.x-x-386/kernel/drivers/usb/serial/dmx_usb.ko (x-use the noted version of your kernel headers)
#:rm /lib/modules/2.6.x-x-386/kernel/drivers/usb/serial/ftdi_sio.ko
#:cd /dev
#:mknod -m 666 dmx0 c 180 192
#:nano /etc/modules

you ad now the following line:


ctrl (strg) o + enter to save ctrl x to exit nano


login with your username and password

plug in the Enttec Open DMX Interface


and the node is working now on Artnet: Universe 0 and Port 0

If you enable now Artnet Universe 0 in MagicQ from ChamSys, you have a fully functioning one universe DMX512 interface - this is working much better than MagicQ with the OpenDMX Windows drivers. And you can add as much universes artnet supports.

artnet_usb -v does the same thing, but gives you debug information

Usage: artnet-usb [OPTIONS] Acts as an ArtNet to DMX node using the Enttec Open Usb Interface

-a <ip-address>        IP address to listen on (defaults to the address
                       of the first non loopback interface)
-d <dmx-device>        device for dmx output (default /dev/dmx0)
-p <port-address>      port address for output universe (default 0)
-s <subnet-address>    subnet address for output universe (default 0)
-v                     be verbose (prints data for first four channels)

The universe address of the port is made up from the subnet address and the port address. The four least significat bits are the port address, the four most significat are the subnet address.

For example :

artnet-usb -p 3 -s 2

sets the universe address to 0x23