#!/usr/bin/env python3 # # 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. # from gi.repository import GObject, Gio, GLib import sys import argparse import os import json import logging import re import select import time import svgwrite logging.basicConfig(format='%(levelname)s: %(message)s', level=logging.INFO) logger = logging.getLogger('tuhi-kete') TUHI_DBUS_NAME = 'org.freedesktop.tuhi1' ORG_FREEDESKTOP_TUHI1_MANAGER = 'org.freedesktop.tuhi1.Manager' ORG_FREEDESKTOP_TUHI1_DEVICE = 'org.freedesktop.tuhi1.Device' ROOT_PATH = '/org/freedesktop/tuhi1' class DBusError(Exception): def __init__(self, message): self.message = message class _DBusObject(GObject.Object): _connection = None def __init__(self, name, interface, objpath): GObject.GObject.__init__(self) if _DBusObject._connection is None: self._connect_to_session() self.interface = interface self.objpath = objpath try: self.proxy = Gio.DBusProxy.new_sync(_DBusObject._connection, Gio.DBusProxyFlags.NONE, None, name, objpath, interface, None) except GLib.Error as e: if (e.domain == 'g-io-error-quark' and e.code == Gio.IOErrorEnum.DBUS_ERROR): raise DBusError(e.message) else: raise e if self.proxy.get_name_owner() is None: raise DBusError('No-one is handling {}, is the daemon running?'.format(name)) self.proxy.connect('g-properties-changed', self._on_properties_changed) self.proxy.connect('g-signal', self._on_signal_received) def _connect_to_session(self): try: _DBusObject._connection = Gio.bus_get_sync(Gio.BusType.SESSION, None) except GLib.Error as e: if (e.domain == 'g-io-error-quark' and e.code == Gio.IOErrorEnum.DBUS_ERROR): raise DBusError(e.message) else: raise e def _on_properties_changed(self, proxy, changed_props, invalidated_props): # Implement this in derived classes to respond to property changes pass def _on_signal_received(self, proxy, sender, signal, parameters): # Implement this in derived classes to respond to signals pass def property(self, name): p = self.proxy.get_cached_property(name) if p is not None: return p.unpack() return p class TuhiKeteDevice(_DBusObject): def __init__(self, manager, objpath): _DBusObject.__init__(self, TUHI_DBUS_NAME, ORG_FREEDESKTOP_TUHI1_DEVICE, objpath) self.manager = manager self.is_pairing = False @classmethod def is_device_address(cls, string): if re.match(r"[0-9a-f]{2}(:[0-9a-f]{2}){5}$", string.lower()): return string raise argparse.ArgumentTypeError(f'"{string}" is not a valid device address') @GObject.Property def address(self): return self.property('Address') @GObject.Property def name(self): return self.property('Name') @GObject.Property def listening(self): return self.property('Listening') @GObject.Property def drawings_available(self): return self.property('DrawingsAvailable') def pair(self): logger.debug('{}: Pairing'.format(self)) # FIXME: Pair() doesn't return anything useful yet, so we wait until # the device is in the Manager's Devices property self.manager.connect('notify::devices', self._on_mgr_devices_updated) self.is_pairing = True self.proxy.Pair() def start_listening(self): self.proxy.StartListening() def stop_listening(self): self.proxy.StopListening() def json(self, index): return self.proxy.GetJSONData('(u)', index) def _on_signal_received(self, proxy, sender, signal, parameters): if signal == 'ButtonPressRequired': logger.info(f'{self}: Press button on device now') elif signal == 'ListeningStopped': err = parameters[0] if err < 0: logger.error(f'{self}: an error occured: {os.strerror(err)}') self.notify('listening') def _on_properties_changed(self, proxy, changed_props, invalidated_props): if changed_props is None: return changed_props = changed_props.unpack() if 'DrawingsAvailable' in changed_props: self.notify('drawings-available') elif 'Listening' in changed_props: self.notify('listening') def __repr__(self): return '{} - {}'.format(self.address, self.name) def _on_mgr_devices_updated(self, manager, pspec): if not self.is_pairing: return for d in manager.devices: if d.address == self.address: self.is_pairing = False logger.info(f'{self}: Pairing successful') self.manager.quit() class TuhiKeteManager(_DBusObject): __gsignals__ = { "pairable-device": (GObject.SIGNAL_RUN_FIRST, None, (GObject.TYPE_PYOBJECT,)), } def __init__(self): _DBusObject.__init__(self, TUHI_DBUS_NAME, ORG_FREEDESKTOP_TUHI1_MANAGER, ROOT_PATH) Gio.bus_watch_name(Gio.BusType.SESSION, TUHI_DBUS_NAME, Gio.BusNameWatcherFlags.NONE, None, self._on_name_vanished) self.mainloop = GObject.MainLoop() self._devices = {} self._pairable_devices = {} for objpath in self.property('Devices'): device = TuhiKeteDevice(self, objpath) self._devices[device.address] = device @GObject.Property def devices(self): return [v for k, v in self._devices.items()] @GObject.Property def searching(self): return self.proxy.get_cached_property('Searching') def start_search(self): self._pairable_devices = {} self.proxy.StartSearch() def stop_search(self): self.proxy.StopSearch() self._pairable_devices = {} def run(self): try: self.mainloop.run() except KeyboardInterrupt: print('\r', end='') # to remove the ^C self.mainloop.quit() def quit(self): self.mainloop.quit() def _on_properties_changed(self, proxy, changed_props, invalidated_props): if changed_props is None: return changed_props = changed_props.unpack() if 'Devices' in changed_props: objpaths = changed_props['Devices'] for objpath in objpaths: try: d = self._pairable_devices[objpath] self._devices[d.address] = d del self._pairable_devices[objpath] except KeyError: # if we called Pair() on an existing device it's not in # pairable devices pass self.notify('devices') def _on_signal_received(self, proxy, sender, signal, parameters): if signal == 'SearchStopped': self.notify('searching') elif signal == 'PairableDevice': objpath = parameters[0] device = TuhiKeteDevice(self, objpath) self._pairable_devices[objpath] = device logger.debug('Found pairable device: {}'.format(device)) self.emit('pairable-device', device) def _on_name_vanished(self, connection, name): logger.error('Tuhi daemon went away') self.mainloop.quit() def __getitem__(self, btaddr): return self._devices[btaddr] def __enter__(self): return self def __exit__(self, exc_type, exc_val, exc_tb): pass class Worker(GObject.Object): """Implements a command to be executed. Subclasses need to overwrite run() that will be executed to setup the command (before the mainloop). Subclass can also implement the stop() method which will be executed to terminate the command, once the mainloop has finished. The variable need_mainloop needs to be set from the subclass if the command requires the mainloop to be run from an undetermined amount of time.""" need_mainloop = False def __init__(self, manager, args=None): GObject.GObject.__init__(self) self.manager = manager self._run = self.run self._stop = self.stop def run(self): pass def stop(self): pass def start(self): self._run() if self.need_mainloop: self.manager.run() self._stop() class Searcher(Worker): need_mainloop = True def __init__(self, manager, args): super(Searcher, self).__init__(manager) self.address = args.address self.is_pairing = False def run(self): if self.manager.searching: logger.error('Another client is already searching') return self.s1 = self.manager.connect('notify::searching', self._on_notify_search) self.s2 = self.manager.connect('pairable-device', self._on_pairable_device) self.manager.start_search() logger.debug('Started searching') for d in self.manager.devices: self._on_pairable_device(self.manager, d) def stop(self): if self.manager.searching: logger.debug('Stopping search') self.manager.stop_search() self.manager.disconnect(self.s1) self.manager.disconnect(self.s2) def _on_notify_search(self, manager, pspec): if not manager.searching: logger.info('Search cancelled') if not self.is_pairing: self.stop() def _on_pairable_device(self, manager, device): print('Pairable device: {}'.format(device)) if self.address is None: print('Connect to device? [y/N] ', end='') sys.stdout.flush() i, o, e = select.select([sys.stdin], [], [], 5) if i: answer = sys.stdin.readline().strip() if answer.lower() == 'y': self.address = device.address else: print('timed out') if device.address == self.address: self.is_pairing = True device.pair() class Listener(Worker): need_mainloop = True def __init__(self, manager, args): super(Listener, self).__init__(manager) self.device = None for d in manager.devices: if d.address == args.address: self.device = d break else: logger.error("{}: device not found".format(args.address)) # FIXME: this should be an exception return def run(self): if self.device is None: return if self.device.drawings_available: self._log_drawings_available(self.device) if self.device.listening: logger.info("{}: device already listening".format(self.device)) return logger.debug("{}: starting listening".format(self.device)) self.s1 = self.device.connect('notify::listening', self._on_device_listening) self.s2 = self.device.connect('notify::drawings-available', self._on_drawings_available) self.device.start_listening() def stop(self): logger.debug("{}: stopping listening".format(self.device)) try: self.device.stop_listening() self.device.disconnect(self.s1) self.device.disconnect(self.s2) except GLib.Error as e: if (e.domain != 'g-dbus-error-quark' or e.code != Gio.IOErrorEnum.EXISTS or Gio.dbus_error_get_remote_error(e) != 'org.freedesktop.DBus.Error.ServiceUnknown'): raise e def _on_device_listening(self, device, pspec): if self.device.listening: return logger.info('{}: Listening stopped'.format(device)) def _on_drawings_available(self, device, pspec): self._log_drawings_available(device) def _log_drawings_available(self, device): s = ", ".join(["{}".format(t) for t in device.drawings_available]) logger.info('{}: drawings available: {}'.format(device, s)) class Fetcher(Worker): def __init__(self, manager, args): super(Fetcher, self).__init__(manager) self.device = None self.indices = None address = args.address index = args.index for d in manager.devices: if d.address == address: self.device = d break else: logger.error("{}: device not found".format(address)) return if index != 'all': try: index = int(index) if index not in self.device.drawings_available: raise ValueError() self.indices = [index] except ValueError: logger.error("Invalid index {}".format(index)) return else: self.indices = self.device.drawings_available def run(self): if self.device is None or self.indices is None: return for idx in self.indices: jsondata = self.device.json(idx) data = json.loads(jsondata) t = time.gmtime(data['timestamp']) t = time.strftime('%Y-%m-%d-%H-%M', t) path = f'{data["devicename"]}-{t}.svg' self.json_to_svg(data, path) logger.info(f'{data["devicename"]}: saved file "{path}"') def json_to_svg(self, js, filename): dimensions = js['dimensions'] if dimensions == [0, 0]: dimensions = 100, 100 svg = svgwrite.Drawing(filename=filename, size=dimensions) g = svgwrite.container.Group(id='layer0') for s in js['strokes']: svgpoints = [] mode = 'M' for p in s['points']: x, y = p['position'] svgpoints.append((mode, x, y)) mode = 'L' path = svgwrite.path.Path(d=svgpoints, style="fill:none;stroke:black;stroke-width:5") g.add(path) svg.add(g) svg.save() class Printer(Worker): def run(self): logger.debug('Listing available devices:') for d in self.manager.devices: print(d) def parse_list(parser): sub = parser.add_parser('list', help='list known devices') sub.set_defaults(worker=Printer) def parse_pair(parser): sub = parser.add_parser('pair', help='pair a new device') sub.add_argument('address', metavar='12:34:56:AB:CD:EF', type=TuhiKeteDevice.is_device_address, nargs='?', default=None, help='the address of the device to pair') sub.set_defaults(worker=Searcher) def parse_listen(parser): sub = parser.add_parser('listen', help='listen to events from a device') sub.add_argument('address', metavar='12:34:56:AB:CD:EF', type=TuhiKeteDevice.is_device_address, default=None, help='the address of the device to listen to') sub.set_defaults(worker=Listener) def parse_fetch(parser): sub = parser.add_parser('fetch', help='download a drawing from a device and save as svg in $PWD') sub.add_argument('address', metavar='12:34:56:AB:CD:EF', type=TuhiKeteDevice.is_device_address, default=None, help='the address of the device to fetch from') sub.add_argument('index', metavar='[|all]', type=str, default=None, help='the index of the drawing to fetch or a literal "all"') sub.set_defaults(worker=Fetcher) def parse(args): desc = 'Commandline client to the Tuhi DBus daemon' parser = argparse.ArgumentParser(description=desc) parser.add_argument('-v', '--verbose', help='Show some debugging informations', action='store_true', default=False) subparser = parser.add_subparsers(help='Available commands') parse_list(subparser) parse_pair(subparser) parse_listen(subparser) parse_fetch(subparser) return parser.parse_args(args[1:]) def main(args): args = parse(args) if args.verbose: logger.setLevel(logging.DEBUG) if not hasattr(args, 'worker'): args.worker = Printer try: with TuhiKeteManager() as mgr: worker = args.worker(mgr, args) worker.start() except DBusError as e: logger.error(e.message) if __name__ == "__main__": main(sys.argv)