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...
|