-
Notifications
You must be signed in to change notification settings - Fork 0
/
INSTALL
125 lines (78 loc) · 3.9 KB
/
INSTALL
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
* First make sure the dependencies are met
* If you have an old Kone (ROC-11-500, ROC-11-501) you, in certain cases, may
additionally need my kmod-roccat package. If not done already, download it
from here
http://sourceforge.net/projects/roccat/
and install it according to the contained instructions.
* You need libgaminggear to be installed before continuing with roccat-tools.
Download it here
http://sourceforge.net/projects/libgaminggear/
and install it according to the contained instructions.
* You will need some development tools and header packages. For ease of use,
there are some install_deps_* scripts for various distributions in the scripts
folder of this package, which you can execute or take as guideline.
* Compilation and Installation
In any shell type the following:
$ tar -xjf roccat-tools-X.X.X.tar.bz2
$ cd roccat-tools-X.X.X
$ mkdir build
$ cd build
$ cmake -DCMAKE_INSTALL_PREFIX="/usr" ..
$ make
$ sudo make install
* optional cmake entries you can set with -D:
* LIBDIR If cmake doesn't find the right install directory
for libraries, you can set it manually. For rpm based 64bit systems that's
normally $PREFIX/lib64, but dpkg based systems use something like
$PREFIX/lib/x86_64-linux-gnu/
* UDEVDIR If cmake doesn't find the right install directory
for udev rules, you can set it manually. Normally it's /lib/udev/rules.d
but Fedora 17 started to merge /lib into /usr/lib completely.
* DEVICES If omitted, tools for all devices are compiled and
installed. You can give a semicolon separated list with as many supported
devices as you want e.g. -DDEVICES="isku;koneplus".
* WITH_LUA Set this to 5.1 or 5.2 if you want to use lua
scripting possibilities.
* EVENTHANDLER_PLUGIN_DIR Set this if you want to manually change the install
directory for eventhandler plugins. Default is the same as LIBDIR.
* It is strongly recommended to install everything in /usr instead of the default
directory /usr/local.
* Last steps
* Preparation the fast way...
* Execute the scripts/post_install script with sudo, not as root.
* ...or manually
* Make the libraries known to the dynamic linker
Just call
$ sudo /sbin/ldconfig
after installation.
* Refresh the icon cache
Call the command
$ sudo touch --no-create /usr/share/icons/hicolor
where /usr has to be substituted with your install prefix.
This has to be done only for the first time.
* Create a group called roccat.
$ sudo groupadd --system roccat
* Create a folder for systemwide profile storage
$ sudo mkdir /var/lib/roccat
$ sudo chown root:roccat /var/lib/roccat
$ sudo chmod 2770 /var/lib/roccat
* To be on the save side you can update the udev rules
$ sudo udevadm control --reload-rules
* To use the device features as normal user you have to add yourself and all
other users to group roccat.
$ sudo usermod -a -G roccat $USER
* Do a logout/login to apply your new group ownership and replug your device
and everything should work as expected.
* Using the software under GNOME
* The GUIs can be found in the menu System/Settings
* The eventhandler is autostarted via a .desktop file in /etc/xdg/autostart
* Building an rpm
The package contains the file roccat-tools.spec that fits at least fedora which
you can use.
The easiest way is to write
$ rpmbuild -ta --clean roccat-tools-X.X.X.tar.bz2
which creates all rpms on the fly
* optional build variables
* udevdir If you wan't the udev rules to be installed in /usr/lib/udev/rules.d
instead of the default /lib/udev/rules.d invoke rpmbuild like this:
rpmbuild -ta --clean roccat-tools-X.X.X.tar.bz2 --define 'udevdir /usr/lib/udev/rules.d'