Merge pull request #1548 from jluebbe/usbhub-resource

add USBHub resource and export

Author: Emantor

doc/configuration.rst

@@ -1222,6 +1222,27 @@ Arguments:
 Used by:
   - `HTTPVideoDriver`_
 
+USBHub
+~~~~~~
+
+A :any:`USBHub` resource describes an USB hub.
+There is no corresponding driver, as this resource is only useful to monitor
+whether the expected USB hubs are detected by an exporter.
+To control individual ports, use `USBPowerPort`_.
+
+.. code-block:: yaml
+
+   USBHub:
+     match:
+       ID_PATH: 'pci-0000:02:00.0-usb-0:4:1.0'
+
+
+Arguments:
+  - match (dict): key and value pairs for a udev match, see `udev Matching`_
+
+Used by:
+  - none
+
 Providers
 ~~~~~~~~~
 Providers describe directories that are accessible by the target over a

labgrid/remote/exporter.py

@@ -549,7 +549,7 @@ def __attrs_post_init__(self):
 exports["USBSDMuxDevice"] = USBSDMuxExport
 exports["USBSDWireDevice"] = USBSDWireExport
 exports["USBDebugger"] = USBGenericExport
-
+exports["USBHub"] = USBGenericRemoteExport
 exports["USBMassStorage"] = USBGenericExport
 exports["USBVideo"] = USBGenericExport
 exports["USBAudioInput"] = USBAudioInputExport

labgrid/resource/udev.py

@@ -542,6 +542,20 @@ def update(self):
     def path(self):
         return self.disk_path
 
+
+@target_factory.reg_resource
+@attr.s(eq=False)
+class USBHub(USBResource):
+    """The USBHub describes a USB hub.
+
+    This is mainly useful to monitor if all expected hubs are detected.
+    """
+    def __attrs_post_init__(self):
+        self.match['DEVTYPE'] = 'usb_interface'
+        self.match['DRIVER'] = 'hub'
+        super().__attrs_post_init__()
+
+
 @target_factory.reg_resource
 @attr.s(eq=False)
 class USBPowerPort(USBResource):