From 0743593e7adec852e293e5e42d851256c225cd74 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?IOhannes=20m=20zm=C3=B6lnig?= Date: Mon, 30 Jun 2008 11:01:03 +0000 Subject: split the readme into several files svn path=/trunk/externals/iem/dmx512/; revision=10118 --- dmx512/FAQ.txt | 2 ++ dmx512/README.dmx4linux.txt | 79 +++++++++++++++++++++++++++++++++++++++++++ dmx512/README.txt | 82 ++++++++++++--------------------------------- 3 files changed, 102 insertions(+), 61 deletions(-) create mode 100644 dmx512/FAQ.txt create mode 100644 dmx512/README.dmx4linux.txt (limited to 'dmx512') diff --git a/dmx512/FAQ.txt b/dmx512/FAQ.txt new file mode 100644 index 0000000..484dc8a --- /dev/null +++ b/dmx512/FAQ.txt @@ -0,0 +1,2 @@ +Q: Where do I find answers to questions not answered here? +A: try the "Pure Data" community mailinglist http://lists.puredata.info diff --git a/dmx512/README.dmx4linux.txt b/dmx512/README.dmx4linux.txt new file mode 100644 index 0000000..94c5bfc --- /dev/null +++ b/dmx512/README.dmx4linux.txt @@ -0,0 +1,79 @@ +DMX512 +====== + +THIS IS NOT A DOCUMENTATION. +NO WARRANTIES OF ANY KIND, EITHER EXPRESSED OR IMPLIED! + +these are just random notes on what i found useful in getting dmx4linux running. +it might freeze your computer or boil your lights. + + +A. setting up dmx4linux +======================= +note: there are debian(etch)-packages for dmx4linux, + but these seem to be pretty old (2.5) + i haven't really tried these. + instead i used dmx4linux-2.6.1 + +first get dmx4linux from http://llg.cubic.org/dmx4linux/ +and extract it. + +the drivers should compile fine with 2.6.18 kernels, but +alas! i am using 2.6.25 and there are some quirks to make +these work. + +first of all i had problems compiling the ISA/PCI/parport drivers, +but since i only wanted to use a USB device, i just disabled those. +second, dmx4linux's build-system tries to override CFLAGS when building +the kernel-modules, which newer kernel versions (e.g. 2.6.25) do not like +at all. i had to modify the makefiles in order to use the EXTRA_CFLAGS + +all the changes i did can be found in the dmx4linux2.6.1.patch +just run: +% patch -p1 < dmx4linux2.6.1.patch + +then do +% ./configure +(which will produce a /tmp/dmxconfig.mk) +and run +% make + +finally become root and do +# make install + +after all has gone well, load the appropriate kernel modules + + +btw, it is always a good idea to read the readme that comes with dmx4linux... + + +B. permissions +============== +the dmx device-files created by udev will be owned by root.root and not be +read/writeable by anyone but root. +in order to use them as an ordinary user, become root and create a group +"dmx" and add users who need access to the dmx-devices to this group: +# addgroup dmx +# adduser zmoelnig dmx + +in theory this should be enough to allow you access to your dmx devices +the next time you load a dmx-driver +if you have problems, try plugging your device out and in again + +if you don't care for a clean setup, you could also just grant everyone read/write permissions. +# chmod a+rw /dev/dmx* +be aware that this might be a security risk. + + + +C. more drivers +=============== +for using a "JMS USB2DMX" device, i had some driver problems. +finally i found +http://www.opendmx.net/index.php/Linux_ArtNet_Node +which directed me to +http://www.erwinrol.com/index.php?opensource/dmxusb.php +and the "dmx_usb" module which seems to work fine. +i guess, it will also work for the "enttec opendmx" device + + diff --git a/dmx512/README.txt b/dmx512/README.txt index 346934e..327c744 100644 --- a/dmx512/README.txt +++ b/dmx512/README.txt @@ -3,68 +3,13 @@ DMX512 controlling DMX from within Pd +this readme assumes that you have a running dmx4linux setup. +if not, read the README.dmx4linux.txt file for hints on how to +get it going... - -A. setting up dmx4linux -======================= -note: there are debian(etch)-packages for dmx4linux, - but these seem to be pretty old (2.5) - i haven't really tried these. - instead i used dmx4linux-2.6.1 - -first get dmx4linux from http://llg.cubic.org/dmx4linux/ -and extract it. - -the drivers should compile fine with 2.6.18 kernels, but -alas! i am using 2.6.25 and there are some quirks to make -these work. - -first of all i had problems compiling the ISA/PCI/parport drivers, -but since i only wanted to use a USB device, i just disabled those. -second, dmx4linux's build-system tries to override CFLAGS when building -the kernel-modules, which newer kernel versions (e.g. 2.6.25) do not like -at all. i had to modify the makefiles in order to use the EXTRA_CFLAGS - -all the changes i did can be found in the dmx4linux2.6.1.patch -just run: -% patch -p1 < dmx4linux2.6.1.patch - -then do -% ./configure -(which will produce a /tmp/dmxconfig.mk) -and run -% make - -finally become root and do -# make install - -after all has gone well, load the appropriate kernel modules - - -btw, it is always a good idea to read the readme that comes with dmx4linux... - - -B. permissions -============== -the dmx device-files created by udev will be owned by root.root and not be -read/writeable by anyone but root. -in order to use them as an ordinary user, become root and create a group -"dmx" and add users who need access to the dmx-devices to this group: -# addgroup dmx -# adduser zmoelnig dmx - -in theory this should be enough to allow you access to your dmx devices -the next time you load a dmx-driver -if you have problems, try plugging your device out and in again - -if you don't care for a clean setup, you could also just grant everyone read/write permissions. -this might be a security risk. - - -C. compiling the Pd-objects +A. compiling the Pd-objects =========================== -so now it is time to get the Pd-objects going. -for this change into the "./src" directory of the iem/dmx512/ folder +for this, change into the "./src" directory of the iem/dmx512/ folder (this might well be the folder that holds this README.txt you are currently reading) @@ -80,9 +25,24 @@ then run you should now have 2 binary files in the src/ folder called [dmxin] and [dmxout] -go on and use em! +B. Installation +=============== +you should install the binaries (+helpfiles) somewhere Pd can find them. +i would suggest to put them into + /extra/dmx512/ +and add this path to the startup-flags of Pd. + + +C. Usage +======== +there should be help-files in the ./help directory +if not, the useage should be very similar to that of [ctlin] and [ctlout] +(it's just using DMX512 instead of MIDI) +D. Help! +======== +read the FAQ -- cgit v1.2.1