aboutsummaryrefslogtreecommitdiff
path: root/dmx512/README.txt
blob: 346934ee61516b779f8c3d023dd3e5bfd4482eb7 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
DMX512
======

controlling DMX from within Pd



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
===========================
so now it is time to get the Pd-objects going.
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)

if you have obtained the source-code via subversion, you will first have to run
% autoconf

(this should not be needed if you downloaded the sources as a release tarball;
that is: if the person who created the tarball has not forgotten to do it for you)

then run
% configure
% make

you should now have 2 binary files in the src/ folder called [dmxin] and [dmxout]

go on and use em!