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
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
|
******************************************
* Razer device configuration tool *
* Copyright (c) 2007-2011 Michael Buesch *
******************************************
This is a configuration utility for Razer devices on Linux systems.
DEPENDENCIES
============
* python 2.5 or 2.6
http://www.python.org/
Debian Linux:
aptitude install python
* libusb 1.0
http://libusb.org/
Debian Linux:
aptitude install libusb-1.0-0-dev
* QT4 python bindings (for the graphical qrazercfg tool only)
http://www.riverbankcomputing.co.uk/software/pyqt/intro
http://qt.nokia.com/
Debian Linux:
aptitude install python-qt4
* cmake 2.4 or later (for building only)
http://www.cmake.org/
Debian Linux:
aptitude install cmake
Note that almost all distributions ship prebuilt packages of the
above dependencies.
BUILDING
========
First invoke "cmake" to build the makefiles.
Then invoke "make" to build the binaries.
cmake .
make
(Note the required space and dot after the cmake command)
INSTALLING
==========
First you need to install the tool libraries and binaries. Do this by typing
in the following commands:
sudo -i # become root
make install
To automatically start the required system daemon "razerd" at system bootup time,
you need to install the init-script. This software package includes a generic
example script, that should work out-of-the-box on many Linux distributions.
To install it, invoke the following commands:
sudo -i # become root
cp ./razerd.initscript /etc/init.d/razerd
ln -s /etc/init.d/razerd /etc/rc2.d/S99razerd
ln -s /etc/init.d/razerd /etc/rc5.d/S99razerd
ln -s /etc/init.d/razerd /etc/rc0.d/K01razerd
ln -s /etc/init.d/razerd /etc/rc6.d/K01razerd
UDEV notification:
The 'make install' step did already install the UDEV script automatically.
It installed the script to
/etc/udev/rules.d/01-razer-udev.rules
This should work on most distributions.
If udev notification does not work, try to reboot the system.
RAZERD CONFIGURATION
====================
The user may create a razerd configuration file in /etc/razer.conf which
can be used to specify various razerd options and initial hardware
configuration settings.
And example config file is included as "razer.conf" in this package.
If no configuration file is available, razerd will work with default settings.
X11-WINDOW (X.ORG) CONFIGURATION
================================
If you don't have an xorg.conf, you don't have to do anything and it
should work out-of-the-box.
The X-server must _not_ be configured to a specific mouse device like /dev/input/mouse0,
because on configuration events razerd may have to temporarly unregister the mouse from the
system. This will confuse the X-server, if it's configured to a specific device.
Configure it to the generic /dev/input/mice device instead. This will enable the X-server
to pick up the mouse again after a configuration event from razerd.
Example xorg.conf snippet:
...
Section "InputDevice"
Identifier "Mouse"
Driver "mouse"
Option "Device" "/dev/input/mice"
EndSection
...
Alternatively do not specify a "Device" at all. The X-server will autodetect
the device then:
...
Section "InputDevice"
Identifier "Mouse"
Driver "mouse"
EndSection
...
In any case, do _NOT_ use:
Option "Device" "/dev/input/mouseX"
USING THE TOOLS
===============
To use the tools, the "razerd" daemon needs to be started as root, first.
Without the background daemon, nothing will work. The daemon is responsible
for doing the lowlevel hardware accesses and for tracking the current state
of the device.
While the daemon is running, the user interfaces "razercfg" (commandline) and
"qrazercfg" (graphical user interface) can be used.
ARCHITECTURE
============
The architecture layout of the razer tools looks like this:
-------------------
| hardware driver 0 |--v
------------------- |
| ----------
------------------- | | lowlevel | -------- ---------
| hardware driver 1 |--x---| librazer |----| razerd |----| pyrazer |
------------------- | ---------- -------- ---------
| | ^ ^ ^
------------------- | --------------------------- | | |
| hardware driver n |--^ | (to be written) librazerd | | | |
------------------- --------------------------- | | |
^ ^ ^ | | |
| | | | | |
--------------- | | | | | |
| Application 0 |---^ | | | | |
--------------- | | | | |
| | | | |
--------------- | | | | |
| Application 1 |-----^ | | | |
--------------- | | | |
| | | |
--------------- | | | |
| Application n |-------^ | | |
--------------- | | |
| | |
---------- | | |
| razercfg |----------------------^ | |
---------- | |
| |
----------- | |
| qrazercfg |-----------------------^ |
----------- |
|
-------------------------- |
| Other Python applications |---------^
---------------------------
So in general, your application wants to access the razer devices through
pyrazer or (if it's not a python app) through librazerd.
(Note that librazerd is not written, yet. So currently the only way to
access the devices is through pyrazer).
Applications should never poke with lowlevel librazer directly, because there
will be no instance that keeps track of the device state and permissions and
concurrency.
|
