56 lines
		
	
	
		
			1.7 KiB
		
	
	
	
		
			Plaintext
		
	
	
	
			
		
		
	
	
			56 lines
		
	
	
		
			1.7 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.
 | |
| 
 | |
| Pairing and un-pairing of devices is planned, but not implemented at this time.
 | |
| 
 | |
| 
 | |
| Requirements
 | |
| ------------
 | |
| 
 | |
| - Python (2.7 or 3.2).
 | |
| - 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.
 | |
| 
 | |
| 
 | |
| 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 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.
 | |
| 
 | |
| 
 | |
| 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
 |