61 lines
2.0 KiB
Plaintext
61 lines
2.0 KiB
Plaintext
Solaar
|
|
------
|
|
|
|
|
|
This application connects to a Logitech Unifying Receiver
|
|
(http://www.logitech.com/en-us/66/6079) and listens for events from devices
|
|
attached to it.
|
|
|
|
Currently the K750 solar keyboard is also queried for its solar charge status.
|
|
Support for other devices could be added in the future, but the K750 keyboard is
|
|
the only device I have and can test on.
|
|
|
|
|
|
Requirements
|
|
------------
|
|
|
|
- Python (2.7 or 3.2). Either version should work well.
|
|
- Gtk 3; Gtk 2 should partially work with some problems.
|
|
- Python GI (GObject Introspection), for Gtk bindings.
|
|
- pyudev for enumerating udev devices.
|
|
- Optional libnotify GI bindings, for desktop notifications.
|
|
|
|
The necessary packages for Debian/Ubuntu are `python-pyudev`/`python3-pyudev`,
|
|
`python-gi`/`python3-gi`, `gir1.2-gtk-3.0`, and optionally `gir1.2-notify-0.7`.
|
|
|
|
|
|
Installation
|
|
------------
|
|
|
|
Normally USB devices are not accessible for r/w by regular users, so you will
|
|
need to install a udev rule to allow access to the Logitech Unifying Receiver.
|
|
|
|
In rules.d/ you'll find a udev rule file, to be copied in /etc/udev/rules.d/ (as
|
|
root).
|
|
|
|
In its current form it makes the UR device available for r/w by all users
|
|
belonging to the 'plugdev' system group (standard Debian/Ubuntu group for
|
|
pluggable devices). It may need changes, specific to your particular system's
|
|
configuration.
|
|
|
|
If in doubt, replacing GROUP="plugdev" with GROUP="<your username>" should just
|
|
work.
|
|
|
|
After you copy the file to /etc/udev/rules.d (and possibly modify it for your
|
|
system), run 'udevadm control --reload-rules' as root for it to apply. Then
|
|
physically remove the Unifying Receiver, wait 30 seconds and re-insert it.
|
|
|
|
|
|
Thanks
|
|
------
|
|
|
|
This project began as a third-hand clone of Noah K. Tilton's logitech-solar-k750
|
|
project on GitHub (no longer available). It was developed further thanks to the
|
|
diggings in Logitech's HID protocol done, among others, by Julien Danjou
|
|
(http://julien.danjou.info/blog/2012/logitech-k750-linux-support) and
|
|
Lars-Dominik Braun (http://6xq.net/git/lars/lshidpp.git).
|
|
|
|
|
|
Cheers,
|
|
-pwr
|