resource: add FTDI GPIO output resources

Add local and remote resources for FTDI data-bus GPIO lines exposed
through asynchronous bit-bang mode.

The resource models one output-capable bit on a selected FTDI
interface and exports the USB identity, interface, index, and inversion
metadata needed by the driver.

Signed-off-by: Ozan Durgut <ozan.durgut@analog.com>

Author: ozan956

labgrid/remote/exporter.py

@@ -549,6 +549,25 @@ def _get_params(self):
         }
 
 
+@attr.s(eq=False)
+class USBFTDIGPIOExport(USBGenericExport):
+    """ResourceExport for GPIOs on FTDI data-bus bit-bang interfaces"""
+
+    def _get_params(self):
+        """Helper function to return parameters"""
+        return {
+            "host": self.host,
+            "busnum": self.local.busnum,
+            "devnum": self.local.devnum,
+            "path": self.local.path,
+            "vendor_id": self.local.vendor_id,
+            "model_id": self.local.model_id,
+            "index": self.local.index,
+            "interface": self.local.interface,
+            "invert": self.local.invert,
+        }
+
+
 @attr.s(eq=False)
 class USBFlashableExport(USBGenericExport):
     """ResourceExport for Flashable USB devices"""
@@ -591,6 +610,7 @@ def __attrs_post_init__(self):
 exports["USBPowerPort"] = USBPowerPortExport
 exports["DeditecRelais8"] = USBDeditecRelaisExport
 exports["HIDRelay"] = USBHIDRelayExport
+exports["FTDIGPIO"] = USBFTDIGPIOExport
 exports["USBFlashableDevice"] = USBFlashableExport
 exports["LXAUSBMux"] = USBGenericExport
 

labgrid/resource/__init__.py

@@ -12,6 +12,7 @@
     AndroidUSBFastboot,
     DFUDevice,
     DeditecRelais8,
+    FTDIGPIO,
     HIDRelay,
     IMXUSBLoader,
     LXAUSBMux,

labgrid/resource/remote.py

@@ -345,6 +345,33 @@ def __attrs_post_init__(self):
         super().__attrs_post_init__()
 
 
+@target_factory.reg_resource
+@attr.s(eq=False)
+class NetworkFTDIGPIO(RemoteUSBResource):
+    """The NetworkFTDIGPIO describes a remotely accessible FTDI GPIO line"""
+    index = attr.ib(
+        default=0,
+        converter=int,
+        validator=attr.validators.and_(
+            attr.validators.instance_of(int),
+            attr.validators.ge(0),
+            attr.validators.le(7),
+        ),
+    )
+    interface = attr.ib(
+        default=1,
+        converter=int,
+        validator=attr.validators.and_(
+            attr.validators.instance_of(int),
+            attr.validators.ge(1),
+        ),
+    )
+    invert = attr.ib(default=False, validator=attr.validators.instance_of(bool))
+    def __attrs_post_init__(self):
+        self.timeout = 10.0
+        super().__attrs_post_init__()
+
+
 @target_factory.reg_resource
 @attr.s(eq=False)
 class NetworkSysfsGPIO(NetworkResource, ManagedResource):

labgrid/resource/udev.py

@@ -797,6 +797,53 @@ def filter_match(self, device):
 
         return super().filter_match(device)
 
+@target_factory.reg_resource
+@attr.s(eq=False)
+class FTDIGPIO(USBResource):
+    """This resource describes a single GPIO line on an FTDI bit-bang interface."""
+
+    index = attr.ib(
+        default=0,
+        converter=int,
+        validator=attr.validators.and_(
+            attr.validators.instance_of(int),
+            attr.validators.ge(0),
+            attr.validators.le(7),
+        ),
+    )
+    interface = attr.ib(
+        default=1,
+        converter=int,
+        validator=attr.validators.and_(
+            attr.validators.instance_of(int),
+            attr.validators.ge(1),
+        ),
+    )
+    invert = attr.ib(default=False, validator=attr.validators.instance_of(bool))
+
+    def __attrs_post_init__(self):
+        self.match["DEVTYPE"] = "usb_device"
+        super().__attrs_post_init__()
+
+    def filter_match(self, device):
+        usb_device = device
+        if device.device_type != "usb_device":
+            usb_device = device.find_parent("usb", "usb_device")
+        if usb_device is None:
+            return False
+
+        match = (
+            usb_device.properties.get("ID_VENDOR_ID"),
+            usb_device.properties.get("ID_MODEL_ID"),
+        )
+        if match not in [("0403", "6010"),  # FT2232C/D/H Dual UART/FIFO IC
+                         ("0403", "6011"),  # FT4232H Quad UART/MPSSE IC
+                         ("0403", "6014"),  # FT232HL/Q
+                         ]:
+            return False
+
+        return super().filter_match(device)
+
 @target_factory.reg_resource
 @attr.s(eq=False)
 class USBFlashableDevice(USBResource):