client: add labgrid-client debugger command

start a debug session using the DebuggerProtocol

Author: Alexander Merkle

labgrid/remote/client.py

@@ -915,6 +915,29 @@ def flashscript(self):
 
         drv = self._get_driver_or_new(target, "FlashScriptDriver", name=name)
         drv.flash(script=self.args.script, args=self.args.script_args)
+    
+    def debugger(self):
+        place = self.get_acquired_place()
+        target = self._get_target(place)
+        name = self.args.name
+        from ..resource.lauterbach import (NetworkLauterbachDebugger, NetworkUSBLauterbachDebugger)
+        from ..resource.udev import (USBLauterbachDebugger)
+
+        drv = None
+        try:
+            drv = target.get_driver("DebuggerProtocol", name=name)
+        except NoDriverFoundError:
+            for resource in target.resources:
+                if isinstance(resource, (NetworkLauterbachDebugger, NetworkUSBLauterbachDebugger, USBLauterbachDebugger)):
+                    drv = self._get_driver_or_new(target, "LauterbachDriver", activate=False,
+                                                  name=name)
+                if drv:
+                    break
+
+        if not drv:
+            raise UserError("target has no compatible resource available")
+        target.activate(drv)
+        drv.start()
 
     def bootstrap(self):
         place = self.get_acquired_place()
@@ -1646,6 +1669,11 @@ def main():
     subparser.add_argument('--name', '-n', help="optional resource name")
     subparser.set_defaults(func=ClientSession.flashscript)
 
+    subparser = subparsers.add_parser('debugger',
+                                      help="start a debugger")
+    subparser.add_argument('--name', '-n', help="optional resource name")
+    subparser.set_defaults(func=ClientSession.debugger)
+
     subparser = subparsers.add_parser('bootstrap',
                                       help="start a bootloader")
     subparser.add_argument('-w', '--wait', type=float, default=10.0)