Import Upstream version 1.9.0
This commit is contained in:
Giacomo Catenazzi committed
commit
a60b7c6315
79 files changed
+51673
No files matched your search
@@ -0,0 +1,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...
|
||||
|
||||
|
||||
|
||||
|
||||
Reference in new issue
Block a user