91 lines
3.6 KiB
Python
91 lines
3.6 KiB
Python
## 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.
|
|
|
|
|
|
def run(receivers, args, find_receiver, find_device):
|
|
assert receivers
|
|
|
|
if getattr(args, "slot", None) is not None:
|
|
_run_slot_unpair(receivers, args, find_receiver)
|
|
return
|
|
|
|
assert args.device, "unpair requires a device name, or use --slot"
|
|
|
|
device_name = args.device.lower()
|
|
dev = next(find_device(receivers, device_name), None)
|
|
if not dev:
|
|
raise Exception(f"no device found matching '{device_name}'")
|
|
|
|
if not dev.receiver.may_unpair:
|
|
print(
|
|
f"Receiver with USB id {dev.receiver.product_id} for {dev.name} [{dev.wpid}:{dev.serial}] does not unpair,",
|
|
"but attempting anyway.",
|
|
)
|
|
try:
|
|
# query these now, it's last chance to get them
|
|
number, codename, wpid, serial = dev.number, dev.codename, dev.wpid, dev.serial
|
|
dev.receiver._unpair_device(number, True) # force an unpair
|
|
print(f"Unpaired {int(number)}: {dev.name} ({codename}) [{wpid}:{serial}]")
|
|
except Exception as e:
|
|
raise e
|
|
|
|
|
|
def _run_slot_unpair(receivers, args, find_receiver):
|
|
if args.receiver:
|
|
rcv = find_receiver(receivers, args.receiver.lower())
|
|
if not rcv:
|
|
raise Exception(f"no receiver found matching '{args.receiver}'")
|
|
elif len(receivers) == 1:
|
|
rcv = receivers[0]
|
|
else:
|
|
names = ", ".join(f"{r.name} [{r.serial}]" for r in receivers)
|
|
raise Exception(f"multiple receivers present, pass --receiver to pick one (found: {names})")
|
|
|
|
if rcv.receiver_kind != "lightspeed":
|
|
raise Exception(
|
|
f"--slot unpair is currently only supported on Lightspeed receivers "
|
|
f"(this is a {rcv.receiver_kind or 'unknown'} receiver: {rcv.name})"
|
|
)
|
|
|
|
slot = int(args.slot)
|
|
max_slots = rcv.max_devices or 1
|
|
if slot < 1 or slot > max_slots:
|
|
raise Exception(f"--slot {slot} out of range (valid: 1..{max_slots} on {rcv.name})")
|
|
|
|
# Populate the cache from the receiver's pairing registers so we can report
|
|
# what the slot currently holds. Truthy cache does NOT imply the device is
|
|
# reachable on RF — it only means the pairing registers are readable.
|
|
list(rcv)
|
|
cached = rcv._devices.get(slot)
|
|
if cached:
|
|
slot_desc = f"{cached.name} [{cached.wpid}:{cached.serial}]"
|
|
elif slot in rcv._devices:
|
|
slot_desc = "cached None sentinel (pairing info unreadable)"
|
|
else:
|
|
slot_desc = "no pairing info cached"
|
|
|
|
print(f"Slot {slot} on {rcv.name} [{rcv.serial}]: {slot_desc}")
|
|
|
|
if getattr(args, "dry_run", False):
|
|
print(f"[dry-run] would force-unpair slot {slot} — no register write issued")
|
|
return
|
|
|
|
ok = rcv.force_unpair_slot(slot)
|
|
if ok:
|
|
print(f"Slot {slot} unpair register write acknowledged by receiver")
|
|
else:
|
|
print(f"Slot {slot} unpair register write was not acknowledged (may be a no-op)")
|