lmctl man page on Mandriva
[printable version]
LMCTL(1) LMCTL(1)
NAME
lmctl - Configure Logitech Mice
SYNOPSIS
lmctl [OPTIONS]
DESCRIPTION
lmctl can configure vendor-specific options on Logitech USB mice (or
dual-personality mice plugged into the USB port). A number of recent
devices are supported. The program is mostly useful in setting the res‐
olution to 800 cpi on mice that boot at 400 cpi (such as the author's
MX-500), and disabling SmartScroll or Cruise Control for those who
would rather use the two extra buttons as ordinary mouse buttons.
Hint 1: use a Linux kernel with Event Interface support (the evdev mod‐
ule) if you want full access to the numerous buttons on these mice.
Hint 2: on Linux, the usbmouse driver ignores the extra buttons alto‐
gether. Don't let it handle your Logitech mice -- use the generic hid
driver for USB HID devices instead.
EXIT STATUS
An exit status of zero indicates successful termination. A non-zero
exit status denotes abnormal termination due to an error.
OPTIONS
lmctl accepts a number of arguments. The following arguments control
which device is accessed or modified:
-b, --bus=USB-BUS-NUMBER
Only apply the command to the specified bus, specified in full
(e.g. use -b 001 for bus 1). This is in the same format as
reported by lmctl -s (the first column, on the left hand side of
the period) or lsusb(1) (next to `Bus').
-d, --dev=USB-DEVICE-NUMBER
Only apply the command to the specified bus, specified in full
(e.g. use -d 01b for device 27). This is in the same format as
reported by lmctl -s (the first column, on the right hand side
of the period) or lsusb(1) (next to `Device').
-p, --pid=USB-PRODUCT-ID
Only apply the command to the specified USB product ID, speci‐
fied in hexadecimal and in full (e.g. use -p c025 for an MX-500
optical mouse). Again, you can use lmctl -s or lsusb(1) to get a
listing of product IDs (the right hand side of tuples like
046d:xxxx).
The following generic actions can be performed:
-i, --inquire
Obtain and display the status of all supported capabilities for
all matching devices.
-s, --scan
Scan the USB bus and report all matching, supported Logitech
mice.
The following commands configure wireless receivers and mice with the
CSR command set (use lmctl -s to see if yours supports it):
-1, --ch1
Set matching devices to channel 1. Please be aware that not all
CSR-supporting devices are dual channel.
-2, --ch2
Set matching devices to channel 2.
-c, --clear
Make all matching receivers forget about the mouse connected to
it, just as if the Connect button on the receiver had been
pressed for three seconds.
-l, --lock
Stop the 30 second search for a wireless mouse on all matching
receivers. This search is initiated using the -u option, or by
pressing the Connect button on the receiver.
-u, --unlock
Unlock all matching receivers and initiate a search for any
wireless mouse in range. This is the same as pressing the Con‐
nect button on the receiver.
The following settings control mouse resolution, for mice with both 400
and 800 cpi support, and the RES capability.
-4, --400
Sets matching devices to a resolution of 400 cpi.
-8, --800
Sets matching devices to a resolution of 800 cpi. Very useful on
certain Logitech mice (the MX500 is one of them) that boot in
400 cpi.
The following settings control SmartScroll/Cruise Control, for mice
that support it (i.e. include the SMS capability).
--no-sms
Disable SmartScroll/Cruise Control an all matching mice. `Up'
and `down' buttons do not also issue wheel events. Useful if you
want to use the additional buttons for something else.
--sms Enable SmartScroll/Cruise Control an all matching mice. `Up' and
`down' buttons will now also issue wheel events (but will also
issue their native button events, which user applications are
expected to ignore). This is how most mice boot.
Other, miscellaneous options:
-?, --help
List all available options and their meanings.
--usage
Display brief usage information.
-V, --version
Show the program's version, credits and licensing.
BUGS
I only have an MX500, which lacks the CSR set. As such, this code is
untested.
lmctl is an early version of a quick hack -- there are almost certainly
numerous other bugs.
AUTHOR
Written by Alexios Chouchoulas.
REPORTING BUGS
Report bugs to Alexios Chouchoulas <alexios@bedroomlan.org>.
COPYRIGHT
Copyright © 2004 Alexios Chouchoulas <alexios@bedroomlan.org>.
This is free software; see the source for copying conditions. There is
NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR
PURPOSE.
SEE ALSO
lsusb(1).
January 19, 2004 LMCTL(1)
[top]
List of man pages available for Mandriva
Copyright (c) for man pages and the logo by the respective OS vendor.
For those who want to learn more, the polarhome community provides shell access and support.
[legal]
[privacy]
[GNU]
[policy]
[cookies]
[netiquette]
[sponsors]
[FAQ]
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
|
Vote for polarhome
|