File: INSTALL

package info (click to toggle)
g15daemon 1.9.5.3-12
  • links: PTS, VCS
  • area: main
  • in suites: bullseye, sid
  • size: 2,144 kB
  • sloc: sh: 9,189; ansic: 3,188; perl: 115; makefile: 66
file content (119 lines) | stat: -rw-r--r-- 4,903 bytes parent folder | download | duplicates (5)
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
/*
    This file is part of g15daemon.

    g15daemon is free software; you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation; either version 2 of the License, or
    (at your option) any later version.

    g15daemon is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with g15daemon; if not, write to the Free Software
    Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301 USA

    (c) 2006 Mike Lampard, Philip Lawatsch, and others

    This daemon listens on localhost port 15550 for client connections,
    and arbitrates LCD display.  Allows for multiple simultaneous clients.
    Client screens can be cycled through by pressing the 'L1' key.
*/

Install Notes for g15daemon-1.2.1 

1.About the G15Daemon.
2.Check list.
3.Installing.
4.Additional Notes 

1. About the G15Daemon. 
The G15Daemon was written in a effort to add functionality to the Logitech G15 keyboard under Linux.  
These functions include the handling of the additional keys (or G keys) and writing 
of data to the LCD display on the keyboard. The data that is written to the LCD is sent by 
additional programs/scripts that are written for the g15daemon. 
A clock for the LCD is loaded as default for the daemon. 
The g15daemon was written by Mike Lampard, Philip Lawatsch, and others. 
My thanks to them for a great program. 

2. Check list. 
A few things we need to check before installing the g15daemon. 

For compiling you need: 
libg15, libg15render, and libusb development packages.

For running the daemon you need:
linux kernel uniput module
This module used to send the new keypresses for the additional keys (or G keys).
You can check if you have the uniput module loaded by using the lsmod command. 
If not you can manually the uinput module with 'modprode uinput' (as root...) . 
You can load the module on boot by adding it your /etc/modules or 
/etc/modules.preload (depending on your distribution.)

libg15
This library is needed by the daemon for managing the LCD on the keyboard. 
You can download the libg15 library from the g15tools homepage on Sourceforge. 
libg15 depends on libusb-dev so please install libusb-dev before compiling libg15. 
libusb-dev can be found in your distribution's repositories... hopefully. 
IMPORTANT!!  When libg15 is compiled it will be copied into /usr/local/lib but the 
daemon looks for it in /usr/lib. If you have not already, add /usr/local/lib to the 
file /etc/ld.so.conf and run the command 'ldconfig' as root. This will  allow 
Linux to find the libraries installed there.  Alternatively, run the libg15 
configure script with --prefix=/usr as an argument, it will then be installed in /usr/lib. 

And that is about it for the check list...

3.Installing.
Ok browse to the directory where you extracted the daemon to. 
As a user or root type 
./configure 
make 

Then as root type
make install

To run the g15daemon type 
g15daemon
This must be done as root. 

You should see the initial logo and then default clock appear.

to kill a previously running daemon 
g15daemon -k


4. Additional Notes. 

As of version 1.2, the MR key is used for switching between LCD clients,
and cannot be used for other purposes if the LCD is being used. 

For a number of reasons, by default the keys on the G15 arent usable -
especially without g15daemon :)  With g15daemon running, the kernel will
know all about the new keys, but your 'X' server won't without a bit of help.
In the contrib subfolder of the g15daemon distrobution, you'll find an xmodmaprc
script.  To have all those new keys working in X11, you'll need to have
xmodmap read that file on every startup.  Depending on your distro, xmodmap
may automatically load the file if it is copied to ${HOME}/.Xmodmap
otherwise you will have to load it yourself.  There is an example xmodmap.sh
file in the contrib directory that will do this, if it's placed (for
instance) in kde's Autostart folder.


Patches are available for libgraphlcd, in the g15daemon patches
subdirectory.  You'll need a copy of graphlcd source, which is available
from http://graphlcd.berlios.de . The patches are against the current
version, which is 1.3. [UPDATE] The g15daemon graphlcd driver is now 
in the graphlcd SVN repository.  If you use the SVN version of graphlcd, 
you won't need to patch the library to use the LCD.

To patch the graphlcd source, extract the graphlcd-base archive, then type:
patch -p0 -i "g15daemon_src_folder"/patches/graphlcd-1.3_g15daemon_drv.patch

where 'g15daemon_src_folder' is the directory you extracted the g15daemon
sourcecode into...