440 lines
17 KiB
Python
440 lines
17 KiB
Python
from dataclasses import dataclass
|
|
from dataclasses import field
|
|
from struct import pack
|
|
from typing import Any
|
|
|
|
import pytest
|
|
|
|
from logitech_receiver import common
|
|
from logitech_receiver import hidpp20
|
|
from logitech_receiver import hidpp20_constants
|
|
from logitech_receiver import special_keys
|
|
|
|
from . import hidpp
|
|
|
|
|
|
@dataclass
|
|
class Device:
|
|
name: str = "DEVICE"
|
|
online: bool = True
|
|
protocol: float = 2.0
|
|
responses: Any = field(default_factory=list)
|
|
|
|
def request(self, id, *params, no_reply=False):
|
|
if params is None:
|
|
params = []
|
|
params = b"".join(pack("B", p) if isinstance(p, int) else p for p in params)
|
|
print("REQUEST ", self.name, hex(id), params)
|
|
for r in self.responses:
|
|
if id == r.id and params == bytes.fromhex(r.params):
|
|
print("RESPONSE", self.name, hex(r.id), r.params, r.response)
|
|
return bytes.fromhex(r.response) if r.response is not None else None
|
|
|
|
def feature_request(self, feature, function=0x00, *params, no_reply=False):
|
|
if self.protocol >= 2.0:
|
|
return hidpp20.feature_request(self, feature, function, *params, no_reply=no_reply)
|
|
|
|
|
|
device_offline = Device("REGISTERS", False)
|
|
device_registers = Device("OFFLINE", True, 1.0)
|
|
device_nofeatures = Device("NOFEATURES", True, 4.5)
|
|
device_zerofeatures = Device("ZEROFEATURES", True, 4.5, [hidpp.Response("0000", 0x0000, "0001")])
|
|
device_broken = Device("BROKEN", True, 4.5, [hidpp.Response("0500", 0x0000, "0001"), hidpp.Response(None, 0x0100)])
|
|
device_standard = Device("STANDARD", True, 4.5, hidpp.r_keyboard_2)
|
|
|
|
|
|
@pytest.mark.parametrize(
|
|
"device, expected_result, expected_count",
|
|
[
|
|
(device_offline, False, 0),
|
|
(device_registers, False, 0),
|
|
(device_nofeatures, False, 0),
|
|
(device_zerofeatures, False, 0),
|
|
(device_broken, False, 0),
|
|
(device_standard, True, 9),
|
|
],
|
|
)
|
|
def test_FeaturesArray_check(device, expected_result, expected_count):
|
|
featuresarray = hidpp20.FeaturesArray(device)
|
|
|
|
result = featuresarray._check()
|
|
result2 = featuresarray._check()
|
|
|
|
assert result == expected_result
|
|
assert result2 == expected_result
|
|
assert (hidpp20_constants.FEATURE.ROOT in featuresarray) == expected_result
|
|
assert len(featuresarray) == expected_count
|
|
assert bool(featuresarray) == expected_result
|
|
|
|
|
|
@pytest.mark.parametrize(
|
|
"device, expected0, expected1, expected2, expected5, expected5v",
|
|
[
|
|
(device_zerofeatures, None, None, None, None, None),
|
|
(device_standard, 0x0000, 0x0001, 0x1000, hidpp20_constants.FEATURE.REPROG_CONTROLS_V4, 3),
|
|
],
|
|
)
|
|
def test_FeaturesArray_get_feature(device, expected0, expected1, expected2, expected5, expected5v):
|
|
featuresarray = hidpp20.FeaturesArray(device)
|
|
device.features = featuresarray
|
|
|
|
result0 = featuresarray.get_feature(0)
|
|
result1 = featuresarray.get_feature(1)
|
|
result2 = featuresarray.get_feature(2)
|
|
result5 = featuresarray.get_feature(5)
|
|
result2r = featuresarray.get_feature(2)
|
|
result5v = featuresarray.get_feature_version(hidpp20_constants.FEATURE.REPROG_CONTROLS_V4)
|
|
|
|
assert result0 == expected0
|
|
assert result1 == expected1
|
|
assert result2 == expected2
|
|
assert result2r == expected2
|
|
assert result5 == expected5
|
|
assert result5v == expected5v
|
|
|
|
|
|
@pytest.mark.parametrize(
|
|
"device, expected_result",
|
|
[
|
|
(device_zerofeatures, []),
|
|
(
|
|
device_standard,
|
|
[
|
|
(hidpp20_constants.FEATURE.ROOT, 0),
|
|
(hidpp20_constants.FEATURE.FEATURE_SET, 1),
|
|
(hidpp20_constants.FEATURE.BATTERY_STATUS, 2),
|
|
(hidpp20_constants.FEATURE.DEVICE_FW_VERSION, 3),
|
|
(common.NamedInt(256, "unknown:0100"), 4),
|
|
(hidpp20_constants.FEATURE.REPROG_CONTROLS_V4, 5),
|
|
(None, 6),
|
|
(None, 7),
|
|
(None, 8),
|
|
],
|
|
),
|
|
],
|
|
)
|
|
def test_FeaturesArray_enumerate(device, expected_result):
|
|
featuresarray = hidpp20.FeaturesArray(device)
|
|
|
|
result = list(featuresarray.enumerate())
|
|
|
|
assert result == expected_result
|
|
|
|
|
|
def test_FeaturesArray_setitem():
|
|
featuresarray = hidpp20.FeaturesArray(device_standard)
|
|
|
|
featuresarray[hidpp20_constants.FEATURE.ROOT] = 3
|
|
featuresarray[hidpp20_constants.FEATURE.FEATURE_SET] = 5
|
|
featuresarray[hidpp20_constants.FEATURE.FEATURE_SET] = 4
|
|
|
|
assert featuresarray[hidpp20_constants.FEATURE.FEATURE_SET] == 4
|
|
assert featuresarray.inverse[4] == hidpp20_constants.FEATURE.FEATURE_SET
|
|
|
|
|
|
def test_FeaturesArray_delitem():
|
|
featuresarray = hidpp20.FeaturesArray(device_standard)
|
|
|
|
with pytest.raises(ValueError):
|
|
del featuresarray[5]
|
|
|
|
|
|
@pytest.mark.parametrize(
|
|
"device, expected0, expected1, expected2, expected1v",
|
|
[(device_zerofeatures, None, None, None, None), (device_standard, 0, 5, None, 3)],
|
|
)
|
|
def test_FeaturesArray_getitem(device, expected0, expected1, expected2, expected1v):
|
|
featuresarray = hidpp20.FeaturesArray(device)
|
|
device.features = featuresarray
|
|
|
|
result_get0 = featuresarray[hidpp20_constants.FEATURE.ROOT]
|
|
result_get1 = featuresarray[hidpp20_constants.FEATURE.REPROG_CONTROLS_V4]
|
|
result_get2 = featuresarray[hidpp20_constants.FEATURE.GKEY]
|
|
result_1v = featuresarray.get_feature_version(hidpp20_constants.FEATURE.REPROG_CONTROLS_V4)
|
|
|
|
assert result_get0 == expected0
|
|
assert result_get1 == expected1
|
|
assert result_get2 == expected2
|
|
assert result_1v == expected1v
|
|
|
|
|
|
@pytest.mark.parametrize(
|
|
"device, index, cid, tid, flags, default_task, flag_names",
|
|
[
|
|
(device_standard, 2, 1, 1, 0x30, "Volume Up", ["reprogrammable", "divertable"]),
|
|
(device_standard, 1, 2, 2, 0x20, "Volume Down", ["divertable"]),
|
|
],
|
|
)
|
|
def test_ReprogrammableKey_key(device, index, cid, tid, flags, default_task, flag_names):
|
|
key = hidpp20.ReprogrammableKey(device, index, cid, tid, flags)
|
|
|
|
assert key._device == device
|
|
assert key.index == index
|
|
assert key._cid == cid
|
|
assert key._tid == tid
|
|
assert key._flags == flags
|
|
assert key.key == special_keys.CONTROL[cid]
|
|
assert key.default_task == common.NamedInt(cid, default_task)
|
|
assert list(key.flags) == flag_names
|
|
|
|
|
|
@pytest.mark.parametrize(
|
|
"device, index, cid, tid, flags, pos, group, gmask, default_task, flag_names, group_names",
|
|
[
|
|
(device_standard, 2, 1, 1, 0x30, 0, 1, 3, "Volume Up", ["reprogrammable", "divertable"], ["g1", "g2"]),
|
|
(device_standard, 1, 2, 2, 0x20, 1, 2, 1, "Volume Down", ["divertable"], ["g1"]),
|
|
],
|
|
)
|
|
def test_ReprogrammableKeyV4_key(device, index, cid, tid, flags, pos, group, gmask, default_task, flag_names, group_names):
|
|
key = hidpp20.ReprogrammableKeyV4(device, index, cid, tid, flags, pos, group, gmask)
|
|
|
|
assert key._device == device
|
|
assert key.index == index
|
|
assert key._cid == cid
|
|
assert key._tid == tid
|
|
assert key._flags == flags
|
|
assert key.pos == pos
|
|
assert key.group == group
|
|
assert key._gmask == gmask
|
|
assert key.key == special_keys.CONTROL[cid]
|
|
assert key.default_task == common.NamedInt(cid, default_task)
|
|
assert list(key.flags) == flag_names
|
|
assert list(key.group_mask) == group_names
|
|
|
|
|
|
# mapped_to requires ensuring that all keys are set up, so this is done below
|
|
|
|
|
|
@pytest.mark.parametrize(
|
|
"device, index", [(device_zerofeatures, -1), (device_zerofeatures, 5), (device_standard, -1), (device_standard, 6)]
|
|
)
|
|
def test_KeysArrayV4_query_key_indexerror(device, index):
|
|
keysarray = hidpp20.KeysArrayV4(device, 5)
|
|
|
|
with pytest.raises(IndexError):
|
|
keysarray._query_key(index)
|
|
|
|
|
|
@pytest.mark.parametrize("device, index, cid", [(device_standard, 0, 0x0011), (device_standard, 4, 0x0003)])
|
|
def test_KeysArrayV4_query_key(device, index, cid):
|
|
keysarray = hidpp20.KeysArrayV4(device, 5)
|
|
|
|
keysarray._query_key(index)
|
|
|
|
assert keysarray.keys[index]._cid == cid
|
|
|
|
|
|
@pytest.mark.parametrize(
|
|
"device, count, index, cid, tid, flags, pos, group, gmask",
|
|
[
|
|
(device_standard, 4, 0, 0x0011, 0x0012, 0xCDAB, 1, 2, 3),
|
|
(device_standard, 6, 1, 0x0111, 0x0022, 0xCDAB, 1, 2, 3),
|
|
(device_standard, 8, 3, 0x0311, 0x0032, 0xCDAB, 1, 2, 4),
|
|
],
|
|
)
|
|
def test_KeysArrayV4__getitem(device, count, index, cid, tid, flags, pos, group, gmask):
|
|
keysarray = hidpp20.KeysArrayV4(device, count)
|
|
|
|
result = keysarray[index]
|
|
|
|
assert result._device == device
|
|
assert result.index == index
|
|
assert result._cid == cid
|
|
assert result._tid == tid
|
|
assert result._flags == flags
|
|
assert result.pos == pos
|
|
assert result.group == group
|
|
assert result._gmask == gmask
|
|
|
|
|
|
@pytest.mark.parametrize(
|
|
"key, index", [(special_keys.CONTROL.Volume_Up, 2), (special_keys.CONTROL.Mute, 4), (special_keys.CONTROL.Next, None)]
|
|
)
|
|
def test_KeysArrayV4_index(key, index):
|
|
keysarray = hidpp20.KeysArrayV4(device_standard, 7)
|
|
|
|
result = keysarray.index(key)
|
|
|
|
assert result == index
|
|
|
|
|
|
responses_key = [
|
|
hidpp.Response("0A00", 0x0100),
|
|
hidpp.Response("01000000", 0x0000, "0001"),
|
|
hidpp.Response("09000300", 0x0000, "1b04"),
|
|
hidpp.Response("00500038010001010400000000000000", 0x0910, "00"),
|
|
hidpp.Response("00510039010001010400000000000000", 0x0910, "01"),
|
|
hidpp.Response("0052003A310003070500000000000000", 0x0910, "02"),
|
|
hidpp.Response("0053003C310002030500000000000000", 0x0910, "03"),
|
|
hidpp.Response("0056003E310002030500000000000000", 0x0910, "04"),
|
|
hidpp.Response("00C300A9310003070500000000000000", 0x0910, "05"),
|
|
hidpp.Response("00C4009D310003070500000000000000", 0x0910, "06"),
|
|
hidpp.Response("00D700B4A00004000300000000000000", 0x0910, "07"),
|
|
hidpp.Response("00500000000000000000000000000000", 0x0920, "0050"),
|
|
hidpp.Response("00510000000000000000000000000000", 0x0920, "0051"),
|
|
hidpp.Response("00520000500000000000000000000000", 0x0920, "0052"),
|
|
hidpp.Response("00530000000000000000000000000000", 0x0920, "0053"),
|
|
hidpp.Response("00560000000000000000000000000000", 0x0920, "0056"),
|
|
hidpp.Response("00C30000000000000000000000000000", 0x0920, "00C3"),
|
|
hidpp.Response("00C40000500000000000000000000000", 0x0920, "00C4"),
|
|
hidpp.Response("00D70000510000000000000000000000", 0x0920, "00D7"),
|
|
]
|
|
device_key = Device("KEY", True, 4.5, responses=responses_key)
|
|
|
|
|
|
@pytest.mark.parametrize(
|
|
"key, expected_index, expected_mapped_to, expected_remappable_to",
|
|
[
|
|
(
|
|
special_keys.CONTROL.Left_Button,
|
|
0,
|
|
common.NamedInt(0x50, "Left Click"),
|
|
[common.NamedInt(0x50, "Left Click"), common.NamedInt(0x51, "Right Click")],
|
|
),
|
|
(
|
|
special_keys.CONTROL.Right_Button,
|
|
1,
|
|
common.NamedInt(0x51, "Right Click"),
|
|
[common.NamedInt(0x51, "Right Click"), common.NamedInt(0x50, "Left Click")],
|
|
),
|
|
(special_keys.CONTROL.Middle_Button, 2, common.NamedInt(0x50, "Left Click"), None),
|
|
(special_keys.CONTROL.Back_Button, 3, common.NamedInt(0x53, "Mouse Back Button"), None),
|
|
(special_keys.CONTROL.Forward_Button, 4, common.NamedInt(0x56, "Mouse Forward Button"), None),
|
|
(special_keys.CONTROL.Mouse_Gesture_Button, 5, common.NamedInt(0xC3, "Gesture Button Navigation"), None),
|
|
(special_keys.CONTROL.Smart_Shift, 6, common.NamedInt(0x50, "Left Click"), None),
|
|
(special_keys.CONTROL.Virtual_Gesture_Button, 7, common.NamedInt(0x51, "Right Click"), None),
|
|
],
|
|
)
|
|
def test_KeysArrayV4_key(key, expected_index, expected_mapped_to, expected_remappable_to):
|
|
device_key.features = hidpp20.FeaturesArray(device_key)
|
|
device_key.features[hidpp20_constants.FEATURE.REPROG_CONTROLS_V4]
|
|
device_key.keys = hidpp20.KeysArrayV4(device_key, 8)
|
|
device_key.keys._ensure_all_keys_queried()
|
|
|
|
index = device_key.keys.index(key)
|
|
mapped_to = device_key.keys[expected_index].mapped_to
|
|
remappable_to = device_key.keys[expected_index].remappable_to
|
|
|
|
assert index == expected_index
|
|
assert mapped_to == expected_mapped_to
|
|
if expected_remappable_to is not None:
|
|
assert list(remappable_to) == expected_remappable_to
|
|
|
|
|
|
@pytest.mark.parametrize(
|
|
"hex, ID, color, speed, period, intensity, ramp, form",
|
|
[
|
|
("FFFFFFFFFFFFFFFFFFFFFF", None, None, None, None, None, None, None),
|
|
("0000000000000000000000", common.NamedInt(0x0, "Disabled"), None, None, None, None, None, None),
|
|
("0120304010000000000000", common.NamedInt(0x1, "Static"), 0x203040, None, None, None, 0x10, None),
|
|
("0220304010000000000000", common.NamedInt(0x2, "Pulse"), 0x203040, 0x10, None, None, None, None),
|
|
("0800000000000000000000", common.NamedInt(0x8, "Boot"), None, None, None, None, None, None),
|
|
("0300000000005000000000", common.NamedInt(0x3, "Cycle"), None, None, 0x5000, 0x00, None, None),
|
|
("0A20304010005020000000", common.NamedInt(0xA, "Breathe"), 0x203040, None, 0x1000, 0x20, None, 0x50),
|
|
("0B20304000100000000000", common.NamedInt(0xB, "Ripple"), 0x203040, None, 0x1000, None, None, None),
|
|
],
|
|
)
|
|
def test_LEDEffectSetting(hex, ID, color, speed, period, intensity, ramp, form):
|
|
byt = bytes.fromhex(hex)
|
|
setting = hidpp20.LEDEffectSetting.from_bytes(byt)
|
|
|
|
assert setting.ID == ID
|
|
if ID is None:
|
|
assert setting.bytes == byt
|
|
else:
|
|
assert getattr(setting, "color", None) == color
|
|
assert getattr(setting, "speed", None) == speed
|
|
assert getattr(setting, "period", None) == period
|
|
assert getattr(setting, "intensity", None) == intensity
|
|
assert getattr(setting, "ramp", None) == ramp
|
|
assert getattr(setting, "form", None) == form
|
|
assert setting.to_bytes() == byt
|
|
|
|
|
|
@pytest.mark.parametrize(
|
|
"feature, function, response, ID, capabilities, period",
|
|
[
|
|
[hidpp20_constants.FEATURE.COLOR_LED_EFFECTS, 0x20, hidpp.Response("0102000300040005", 0x0420, "010200"), 3, 4, 5],
|
|
[hidpp20_constants.FEATURE.COLOR_LED_EFFECTS, 0x20, hidpp.Response("0102000700080009", 0x0420, "010200"), 7, 8, 9],
|
|
],
|
|
)
|
|
def test_LEDEffectInfo(feature, function, response, ID, capabilities, period):
|
|
device = hidpp.Device(feature=feature, responses=[response])
|
|
|
|
info = hidpp20.LEDEffectInfo(feature, function, device, 1, 2)
|
|
|
|
assert info.zindex == 1
|
|
assert info.index == 2
|
|
assert info.ID == ID
|
|
assert info.capabilities == capabilities
|
|
assert info.period == period
|
|
|
|
|
|
zone_responses_1 = [
|
|
hidpp.Response("00000102", 0x0410, "00FF00"),
|
|
hidpp.Response("0000000300040005", 0x0420, "000000"),
|
|
hidpp.Response("0001000B00080009", 0x0420, "000100"),
|
|
]
|
|
zone_responses_2 = [
|
|
hidpp.Response("0000000102", 0x0400, "00FF00"),
|
|
hidpp.Response("0000000300040005", 0x0400, "000000"),
|
|
hidpp.Response("0001000200080009", 0x0400, "000100"),
|
|
]
|
|
|
|
|
|
@pytest.mark.parametrize(
|
|
"feature, function, offset, effect_function, responses, index, location, count, id_1",
|
|
[
|
|
[hidpp20_constants.FEATURE.COLOR_LED_EFFECTS, 0x10, 0, 0x20, zone_responses_1, 0, 1, 2, 0xB],
|
|
[hidpp20_constants.FEATURE.RGB_EFFECTS, 0x00, 1, 0x00, zone_responses_2, 0, 1, 2, 2],
|
|
],
|
|
)
|
|
def test_LEDZoneInfo(feature, function, offset, effect_function, responses, index, location, count, id_1):
|
|
device = hidpp.Device(feature=feature, responses=responses)
|
|
|
|
zone = hidpp20.LEDZoneInfo(feature, function, offset, effect_function, device, index)
|
|
|
|
assert zone.index == index
|
|
assert zone.location == location
|
|
assert zone.count == count
|
|
assert len(zone.effects) == count
|
|
assert zone.effects[1].ID == id_1
|
|
|
|
|
|
@pytest.mark.parametrize(
|
|
"responses, setting, expected_command",
|
|
[
|
|
[zone_responses_1, hidpp20.LEDEffectSetting(ID=0), None],
|
|
[zone_responses_1, hidpp20.LEDEffectSetting(ID=3, period=0x20, intensity=0x50), "000000000000000020500000"],
|
|
[zone_responses_1, hidpp20.LEDEffectSetting(ID=0xB, color=0x808080, period=0x20), "000180808000002000000000"],
|
|
],
|
|
)
|
|
def test_LEDZoneInfo_to_command(responses, setting, expected_command):
|
|
device = hidpp.Device(feature=hidpp20_constants.FEATURE.COLOR_LED_EFFECTS, responses=responses)
|
|
zone = hidpp20.LEDZoneInfo(hidpp20_constants.FEATURE.COLOR_LED_EFFECTS, 0x10, 0, 0x20, device, 0)
|
|
|
|
command = zone.to_command(setting)
|
|
|
|
assert command == (bytes.fromhex(expected_command) if expected_command is not None else None)
|
|
|
|
|
|
effects_responses_1 = [hidpp.Response("0100000001", 0x0400)] + zone_responses_1
|
|
effects_responses_2 = [hidpp.Response("FFFF0100000001", 0x0400, "FFFF00")] + zone_responses_2
|
|
|
|
|
|
@pytest.mark.parametrize(
|
|
"feature, cls, responses, readable, count, count_0",
|
|
[
|
|
[hidpp20_constants.FEATURE.COLOR_LED_EFFECTS, hidpp20.LEDEffectsInfo, effects_responses_1, 1, 1, 2],
|
|
[hidpp20_constants.FEATURE.RGB_EFFECTS, hidpp20.RGBEffectsInfo, effects_responses_2, 1, 1, 2],
|
|
],
|
|
)
|
|
def test_LEDEffectsInfo(feature, cls, responses, readable, count, count_0):
|
|
device = hidpp.Device(feature=feature, responses=responses)
|
|
|
|
effects = cls(device)
|
|
|
|
assert effects.readable == readable
|
|
assert effects.count == count
|
|
assert effects.zones[0].count == count_0
|