163 lines
4.0 KiB
Python
163 lines
4.0 KiB
Python
#
|
|
#
|
|
#
|
|
|
|
from __future__ import absolute_import, division, print_function, unicode_literals
|
|
|
|
from logging import getLogger # , DEBUG as _DEBUG
|
|
_log = getLogger('LUR.hidpp10')
|
|
del getLogger
|
|
|
|
from .common import (strhex as _strhex,
|
|
NamedInts as _NamedInts,
|
|
FirmwareInfo as _FirmwareInfo)
|
|
from .hidpp20 import FIRMWARE_KIND
|
|
|
|
#
|
|
# constants
|
|
#
|
|
|
|
DEVICE_KIND = _NamedInts(
|
|
keyboard=0x01,
|
|
mouse=0x02,
|
|
numpad=0x03,
|
|
presenter=0x04,
|
|
trackball=0x08,
|
|
touchpad=0x09)
|
|
|
|
POWER_SWITCH_LOCATION = _NamedInts(
|
|
base=0x01,
|
|
top_case=0x02,
|
|
edge_of_top_right_corner=0x03,
|
|
top_left_corner=0x05,
|
|
bottom_left_corner=0x06,
|
|
top_right_corner=0x07,
|
|
bottom_right_corner=0x08,
|
|
top_edge=0x09,
|
|
right_edge=0x0A,
|
|
left_edge=0x0B,
|
|
bottom_edge=0x0C)
|
|
|
|
NOTIFICATION_FLAG = _NamedInts(
|
|
battery_status=0x100000,
|
|
wireless=0x000100,
|
|
software_present=0x000800)
|
|
|
|
ERROR = _NamedInts(
|
|
invalid_SubID__command=0x01,
|
|
invalid_address=0x02,
|
|
invalid_value=0x03,
|
|
connection_request_failed=0x04,
|
|
too_many_devices=0x05,
|
|
already_exists=0x06,
|
|
busy=0x07,
|
|
unknown_device=0x08,
|
|
resource_error=0x09,
|
|
request_unavailable=0x0A,
|
|
unsupported_parameter_value=0x0B,
|
|
wrong_pin_code=0x0C)
|
|
|
|
PAIRING_ERRORS = _NamedInts(
|
|
device_timeout=0x01,
|
|
device_not_supported=0x02,
|
|
too_many_devices=0x03,
|
|
sequence_timeout=0x06)
|
|
|
|
#
|
|
# functions
|
|
#
|
|
|
|
def get_register(device, name, default_number=-1):
|
|
known_register = device.registers[name]
|
|
register = known_register or default_number
|
|
if register > 0:
|
|
reply = device.request(0x8100 + (register & 0xFF))
|
|
if reply:
|
|
return reply
|
|
|
|
if not known_register and device.ping():
|
|
_log.warn("%s: failed to read '%s' from default register 0x%02X, blacklisting", device, name, default_number)
|
|
device.registers[name] = -default_number
|
|
|
|
|
|
def get_battery(device):
|
|
"""Reads a device's battery level, if provided by the HID++ 1.0 protocol."""
|
|
if device.protocol >= 2.0:
|
|
# let's just assume HID++ 2.0 devices do not provide the battery info in a register
|
|
return
|
|
|
|
reply = get_register(device, 'battery_charge', 0x0D)
|
|
if reply:
|
|
level = ord(reply[:1])
|
|
battery_status = ord(reply[2:3])
|
|
return parse_battery_reply_0D(level, battery_status)
|
|
|
|
reply = get_register(device, 'battery_status', 0x07)
|
|
if reply:
|
|
level = ord(reply[:1])
|
|
battery_status = ord(reply[1:2])
|
|
return parse_battery_reply_07(level, battery_status)
|
|
|
|
def parse_battery_reply_0D(level, battery_status):
|
|
charge = level
|
|
status = battery_status & 0xF0
|
|
status = ('discharging' if status == 0x30
|
|
else 'charging' if status == 0x50
|
|
else 'fully charged' if status == 0x90
|
|
else None)
|
|
return charge, status
|
|
|
|
def parse_battery_reply_07(level, battery_status):
|
|
charge = (90 if level == 7 # full
|
|
else 50 if level == 5 # good
|
|
else 20 if level == 3 # low
|
|
else 5 if level == 1 # critical
|
|
else 0 ) # wtf?
|
|
status = ('charging' if battery_status == 0x25
|
|
else 'fully charged' if battery_status == 0x22
|
|
else 'discharging')
|
|
return charge, status
|
|
|
|
|
|
def get_serial(device):
|
|
if device.kind is None:
|
|
dev_id = 0x03
|
|
receiver = device
|
|
else:
|
|
dev_id = 0x30 + device.number - 1
|
|
receiver = device.receiver
|
|
|
|
serial = receiver.request(0x83B5, dev_id)
|
|
if serial:
|
|
return _strhex(serial[1:5])
|
|
|
|
|
|
def get_firmware(device):
|
|
firmware = []
|
|
|
|
reply = device.request(0x81F1, 0x01)
|
|
if reply:
|
|
fw_version = _strhex(reply[1:3])
|
|
fw_version = '%s.%s' % (fw_version[0:2], fw_version[2:4])
|
|
reply = device.request(0x81F1, 0x02)
|
|
if reply:
|
|
fw_version += '.B' + _strhex(reply[1:3])
|
|
fw = _FirmwareInfo(FIRMWARE_KIND.Firmware, '', fw_version, None)
|
|
firmware.append(fw)
|
|
|
|
if device.kind is None and device.max_devices == 1:
|
|
# Nano receiver
|
|
return firmware
|
|
if device.kind is not None and not device._unifying:
|
|
# Nano device
|
|
return firmware
|
|
|
|
reply = device.request(0x81F1, 0x04)
|
|
if reply:
|
|
bl_version = _strhex(reply[1:3])
|
|
bl_version = '%s.%s' % (bl_version[0:2], bl_version[2:4])
|
|
bl = _FirmwareInfo(FIRMWARE_KIND.Bootloader, '', bl_version, None)
|
|
firmware.append(bl)
|
|
|
|
return tuple(firmware)
|