221 lines
		
	
	
		
			8.0 KiB
		
	
	
	
		
			Python
		
	
	
	
			
		
		
	
	
			221 lines
		
	
	
		
			8.0 KiB
		
	
	
	
		
			Python
		
	
	
	
| # -*- python-mode -*-
 | |
| # -*- coding: UTF-8 -*-
 | |
| 
 | |
| ## Copyright (C) 2012-2013  Daniel Pavel
 | |
| ##
 | |
| ## This program 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.
 | |
| ##
 | |
| ## This program 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 this program; if not, write to the Free Software Foundation, Inc.,
 | |
| ## 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
 | |
| 
 | |
| from __future__ import absolute_import, division, print_function, unicode_literals
 | |
| 
 | |
| 
 | |
| from logitech_receiver import (
 | |
| 				hidpp10 as _hidpp10,
 | |
| 				hidpp20 as _hidpp20,
 | |
| 				special_keys as _special_keys,
 | |
| 			)
 | |
| 
 | |
| 
 | |
| def _print_receiver(receiver):
 | |
| 	paired_count = receiver.count()
 | |
| 
 | |
| 	print ('Unifying Receiver')
 | |
| 	print ('  Device path  :', receiver.path)
 | |
| 	print ('  USB id       : 046d:%s' % receiver.product_id)
 | |
| 	print ('  Serial       :', receiver.serial)
 | |
| 	for f in receiver.firmware:
 | |
| 		print ('    %-11s: %s' % (f.kind, f.version))
 | |
| 
 | |
| 	print ('  Has', paired_count, 'paired device(s) out of a maximum of %d.' % receiver.max_devices)
 | |
| 
 | |
| 	notification_flags = _hidpp10.get_notification_flags(receiver)
 | |
| 	if notification_flags is not None:
 | |
| 		if notification_flags:
 | |
| 			notification_names = _hidpp10.NOTIFICATION_FLAG.flag_names(notification_flags)
 | |
| 			print ('  Notifications: %s (0x%06X)' % (', '.join(notification_names), notification_flags))
 | |
| 		else:
 | |
| 			print ('  Notifications: (none)')
 | |
| 
 | |
| 	activity = receiver.read_register(_hidpp10.REGISTERS.devices_activity)
 | |
| 	if activity:
 | |
| 		activity = [(d, ord(activity[d - 1:d])) for d in range(1, receiver.max_devices)]
 | |
| 		activity_text = ', '.join(('%d=%d' % (d, a)) for d, a in activity if a > 0)
 | |
| 		print ('  Device activity counters:', activity_text or '(empty)')
 | |
| 
 | |
| 
 | |
| def _print_device(dev):
 | |
| 	assert dev
 | |
| 	# check if the device is online
 | |
| 	dev.ping()
 | |
| 
 | |
| 	print ('  %d: %s' % (dev.number, dev.name))
 | |
| 	print ('     Codename     :', dev.codename)
 | |
| 	print ('     Kind         :', dev.kind)
 | |
| 	print ('     Wireless PID :', dev.wpid)
 | |
| 	if dev.protocol:
 | |
| 		print ('     Protocol     : HID++ %1.1f' % dev.protocol)
 | |
| 	else:
 | |
| 		print ('     Protocol     : unknown (device is offline)')
 | |
| 	if dev.polling_rate:
 | |
| 		print ('     Polling rate :', dev.polling_rate, 'ms (%dHz)' % (1000 // dev.polling_rate))
 | |
| 	print ('     Serial number:', dev.serial)
 | |
| 	for fw in dev.firmware:
 | |
| 		print ('       %11s:' % fw.kind, (fw.name + ' ' + fw.version).strip())
 | |
| 
 | |
| 	if dev.power_switch_location:
 | |
| 		print ('     The power switch is located on the %s.' % dev.power_switch_location)
 | |
| 
 | |
| 	if dev.online:
 | |
| 		notification_flags = _hidpp10.get_notification_flags(dev)
 | |
| 		if notification_flags is not None:
 | |
| 			if notification_flags:
 | |
| 				notification_names = _hidpp10.NOTIFICATION_FLAG.flag_names(notification_flags)
 | |
| 				print ('     Notifications: %s (0x%06X).' % (', '.join(notification_names), notification_flags))
 | |
| 			else:
 | |
| 				print ('     Notifications: (none).')
 | |
| 
 | |
| 	if dev.online and dev.features:
 | |
| 		print ('     Supports %d HID++ 2.0 features:' % len(dev.features))
 | |
| 		for index, feature in enumerate(dev.features):
 | |
| 			feature = dev.features[index]
 | |
| 			flags = dev.request(0x0000, feature.bytes(2))
 | |
| 			flags = 0 if flags is None else ord(flags[1:2])
 | |
| 			flags = _hidpp20.FEATURE_FLAG.flag_names(flags)
 | |
| 			print ('        %2d: %-22s {%04X}   %s' % (index, feature, feature, ', '.join(flags)))
 | |
| 			if feature == _hidpp20.FEATURE.HIRES_WHEEL:
 | |
| 				wheel = _hidpp20.get_hires_wheel(dev)
 | |
| 				if wheel:
 | |
| 					multi, has_invert, has_switch, inv, res, target, ratchet = wheel
 | |
| 					print("            Multiplier: %s" % multi)
 | |
| 					if has_invert:
 | |
| 						print("            Has invert")
 | |
| 						if inv:
 | |
| 							print("              Inverse wheel motion")
 | |
| 						else:
 | |
| 							print("              Normal wheel motion")
 | |
| 					if has_switch:
 | |
| 						print("            Has ratchet switch")
 | |
| 						if ratchet:
 | |
| 							print("              Normal wheel mode")
 | |
| 						else:
 | |
| 							print("              Free wheel mode")
 | |
| 					if res:
 | |
| 						print("            High resolution mode")
 | |
| 					else:
 | |
| 						print("            Low resolution mode")
 | |
| 					if target:
 | |
| 						print("            HID++ notification")
 | |
| 					else:
 | |
| 						print("            HID notification")
 | |
| 			if feature == _hidpp20.FEATURE.MOUSE_POINTER:
 | |
| 				mouse_pointer = _hidpp20.get_mouse_pointer_info(dev)
 | |
| 				if mouse_pointer:
 | |
| 					print("            DPI: %s" % mouse_pointer['dpi'])
 | |
| 					print("            Acceleration: %s" % mouse_pointer['acceleration'])
 | |
| 					if mouse_pointer['suggest_os_ballistics']:
 | |
| 						print("            Use OS ballistics")
 | |
| 					else:
 | |
| 						print("            Override OS ballistics")
 | |
| 					if mouse_pointer['suggest_vertical_orientation']:
 | |
| 						print("            Provide vertical tuning, trackball")
 | |
| 					else:
 | |
| 						print("            No vertical tuning, standard mice")
 | |
| 			if feature == _hidpp20.FEATURE.VERTICAL_SCROLLING:
 | |
| 				vertical_scrolling_info = _hidpp20.get_vertical_scrolling_info(dev)
 | |
| 				if vertical_scrolling_info:
 | |
| 					print("            Roller type: %s" % vertical_scrolling_info['roller'])
 | |
| 					print("            Ratchet per turn: %s" % vertical_scrolling_info['ratchet'])
 | |
| 					print("            Scroll lines: %s" % vertical_scrolling_info['lines'])
 | |
| 			if feature == _hidpp20.FEATURE.HI_RES_SCROLLING:
 | |
| 				scrolling_mode, scrolling_resolution = _hidpp20.get_hi_res_scrolling_info(dev)
 | |
| 				if scrolling_mode:
 | |
| 					print("            Hi-res scrolling enabled")
 | |
| 				else:
 | |
| 					print("            Hi-res scrolling disabled")
 | |
| 				if scrolling_resolution:
 | |
| 					print("            Hi-res scrolling multiplier: %s" % scrolling_resolution)
 | |
| 			if feature == _hidpp20.FEATURE.POINTER_SPEED:
 | |
| 				pointer_speed = _hidpp20.get_pointer_speed_info(dev)
 | |
| 				if pointer_speed:
 | |
| 					print("            Pointer Speed: %s" % pointer_speed)
 | |
| 			if feature == _hidpp20.FEATURE.LOWRES_WHEEL:
 | |
| 				wheel_status = _hidpp20.get_lowres_wheel_status(dev)
 | |
| 				if wheel_status:
 | |
| 					print("            Wheel Reports: %s" % wheel_status)
 | |
| 
 | |
| 	if dev.online and dev.keys:
 | |
| 		print ('     Has %d reprogrammable keys:' % len(dev.keys))
 | |
| 		for k in dev.keys:
 | |
| 			flags = _special_keys.KEY_FLAG.flag_names(k.flags)
 | |
| 			# TODO: add here additional variants for other REPROG_CONTROLS
 | |
| 			if dev.keys.keyversion == 1:
 | |
| 				print ('        %2d: %-26s => %-27s   %s' % (k.index, k.key, k.task, ', '.join(flags)))
 | |
| 			if dev.keys.keyversion == 4:
 | |
| 				print ('        %2d: %-26s, default: %-27s => %-26s' % (k.index, k.key, k.task, k.remapped))
 | |
| 				print ('             %s, pos:%d, group:%1d, gmask:%d' % ( ', '.join(flags), k.pos, k.group, k.group_mask))
 | |
| 	if dev.online:
 | |
| 		battery = _hidpp20.get_battery(dev)
 | |
| 		if battery is None:
 | |
| 			battery = _hidpp10.get_battery(dev)
 | |
| 		if battery is not None:
 | |
| 			from logitech_receiver.common import NamedInt as _NamedInt
 | |
| 			level, status = battery
 | |
| 			if level is not None:
 | |
| 				if isinstance(level, _NamedInt):
 | |
| 					text = str(level)
 | |
| 				else:
 | |
| 					text = '%d%%' % level
 | |
| 			else:
 | |
| 				text = 'N/A'
 | |
| 			print ('     Battery: %s, %s.' % (text, status))
 | |
| 		else:
 | |
| 			battery_voltage = _hidpp20.get_voltage(dev)
 | |
| 			if battery_voltage :
 | |
| 				(voltage, charging, charge_sts, charge_lvl, charge_type) = battery_voltage
 | |
| 				print ('     Battery: %smV, %s.' % (voltage, 'Charging' if charging else 'Discharging'))
 | |
| 			else:
 | |
| 				print ('     Battery status unavailable.')
 | |
| 	else:
 | |
| 		print ('     Battery: unknown (device is offline).')
 | |
| 
 | |
| 
 | |
| def run(receivers, args, find_receiver, find_device):
 | |
| 	assert receivers
 | |
| 	assert args.device
 | |
| 
 | |
| 	device_name = args.device.lower()
 | |
| 
 | |
| 	if device_name == 'all':
 | |
| 		for r in receivers:
 | |
| 			_print_receiver(r)
 | |
| 			count = r.count()
 | |
| 			if count:
 | |
| 				for dev in r:
 | |
| 					print ('')
 | |
| 					_print_device(dev)
 | |
| 					count -= 1
 | |
| 					if not count:
 | |
| 						break
 | |
| 			print ('')
 | |
| 		return
 | |
| 
 | |
| 	dev = find_receiver(receivers, device_name)
 | |
| 	if dev:
 | |
| 		_print_receiver(dev)
 | |
| 		return
 | |
| 
 | |
| 	dev = find_device(receivers, device_name)
 | |
| 	assert dev
 | |
| 	_print_device(dev)
 |