Merge pull request #435 from eblot/ft4232h_followup

eblot · web-flow · commit 25d77b02960d · 2026-06-02T18:12:31.000+02:00
FT4232HP follow up
diff --git a/README.md b/README.md
@@ -32,8 +32,7 @@ Suported FTDI devices include:
   * FT2232C/D (dual port, clock up to 6 MHz)
   * FT232H (single port, clock up to 30 MHz)
   * FT2232H (dual port, clock up to 30 MHz)
-  * FT4232H (quad port, clock up to 30 MHz)
-  * FT4232HA (quad port, clock up to 30 MHz)
+  * FT4232H/HA/HP (quad port, clock up to 30 MHz)
 
 ## Features
 
diff --git a/pyftdi/__init__.py b/pyftdi/__init__.py
@@ -1,12 +1,12 @@
-# Copyright (c) 2010-2025 Emmanuel Blot <emmanuel.blot@free.fr>
+# Copyright (c) 2010-2026 Emmanuel Blot <emmanuel.blot@free.fr>
 # Copyright (c) 2010-2016, Neotion
 # All rights reserved.
 #
 # SPDX-License-Identifier: BSD-3-Clause
 
 # pylint: disable=missing-docstring
 
-__version__ = '0.57.1'
+__version__ = '0.57.2'
 __title__ = 'PyFtdi'
 __description__ = 'FTDI device driver (pure Python)'
 __uri__ = 'http://github.com/eblot/pyftdi'
diff --git a/pyftdi/doc/api/i2c.rst b/pyftdi/doc/api/i2c.rst
@@ -132,8 +132,8 @@ Fortunately, FT232H device is fitted with real open collector outputs, and
 PyFtdi always enable this mode on SCL and SDA lines when a FT232H device is
 used.
 
-Other FTDI devices such as FT2232H, FT4232H and FT4232HA do not support open
-collector mode, and source current to SCL and SDA lines.
+Other FTDI devices such as FT2232H and FT4232H/HA/HP do not
+support open collector mode, and source current to SCL and SDA lines.
 
 Clock streching
 ```````````````
@@ -142,9 +142,9 @@ Clock stretching is supported through a hack that re-uses the JTAG adaptative
 clock mode designed for ARM devices. FTDI HW drives SCL on ``AD0`` (`BD0`), and
 samples the SCL line on : the 8\ :sup:`th` pin of a port ``AD7`` (``BD7``).
 
-When a FTDI device without an open collector capability is used
-(FT2232H, FT4232H, FT4232HA) the current sourced from AD0 may prevent proper
-sampling ofthe SCL line when the slave attempts to strech the clock. It is
+When a FTDI device without an open collector capability is used (FT2232H,
+FT4232H/HA/HP) the current sourced from AD0 may prevent proper sampling of
+the SCL line when the slave attempts to strech the clock. It is
 therefore recommended to add a low forward voltage drop diode to `AD0` to
 prevent AD0 to source current to the SCL bus. See the wiring section.
 
@@ -187,5 +187,6 @@ Wiring
 *Fig.1*:
 
 * ``D1`` is only required when clock streching is used along with
-  FT2232H, FT4232H or FT4232HA devices. It should not be fit with an FT232H.
+  FT2232H or FT4232H/HA/HP devices. It should not be fit with
+  an FT232H.
 * ``AD7`` may be used as a regular GPIO with clock stretching is not required.
diff --git a/pyftdi/doc/api/spi.rst b/pyftdi/doc/api/spi.rst
@@ -158,7 +158,7 @@ Application Node 114:
 
 Support for mode 1 and mode 3 is implemented with some workarounds, but
 generated signals may not be reliable: YMMV. It is only available with -H
-series (232H, 2232H, 4232H, 4232HA).
+series (FT232H, FT2232H, FT4232H/HA/HP).
 
 The 3-clock phase mode which has initially be designed to cope with |I2C|
 signalling is used to delay the data lines from the clock signals. A direct
diff --git a/pyftdi/doc/authors.rst b/pyftdi/doc/authors.rst
@@ -54,3 +54,4 @@ Contributors
  * Alessandro Zini
  * Sjoerd Simons
  * David Schneider
+ * Christophe Leblanc
diff --git a/pyftdi/doc/defs.rst b/pyftdi/doc/defs.rst
@@ -7,6 +7,7 @@
 .. _FT2232H: https://www.ftdichip.com/Products/ICs/FT2232H.html
 .. _FT4232H: https://www.ftdichip.com/Products/ICs/FT4232H.htm
 .. _FT4232HA: http://ftdichip.com/products/ft4232haq/
+.. _FT4232HP: https://www.ftdichip.com/Support/Documents/DataSheets/ICs/DS_FT4233HP.pdf
 .. _FTDI_Recovery: https://www.ftdichip.com/Support/Documents/AppNotes/AN_136%20Hi%20Speed%20Mini%20Module%20EEPROM%20Disaster%20Recovery.pdf
 .. _PyFtdi: https://www.github.com/eblot/pyftdi
 .. _PyFtdiTools: https://github.com/eblot/pyftdi/tree/master/pyftdi/bin
diff --git a/pyftdi/doc/features.rst b/pyftdi/doc/features.rst
@@ -61,7 +61,7 @@ Note: FTDI*232* devices cannot be used as an SPI slave.
 |I2C| master
 ````````````
 
-Supported devices: FT232H_, FT2232H_, FT4232H_, FT4232HA_
+Supported devices: FT232H_, FT2232H_, FT4232H_, FT4232HA_, FT4232HP_
 
 For now, only 7-bit addresses are supported.
 
diff --git a/pyftdi/doc/gpio.rst b/pyftdi/doc/gpio.rst
@@ -76,7 +76,7 @@ the actual hardware, *i.e.* the FTDI model:
   `BDBUS/BCBUS`,
 * FT2232H features two ports, which are 16-bit wide each: `ADBUS/ACBUS` and
   `BDBUS/BCBUS`,
-* FT4232H/FT4232HA features four ports, which are 8-bit wide each: `ADBUS`,
+* FT4232H/HA/HP features four ports, which are 8-bit wide each: `ADBUS`,
   `BDBUS`, `CDBUS` and `DDBUS`,
 * FT230X features a single port, which is 4-bit wide,
 * FT231X feature a single port, which is 8-bit wide
diff --git a/pyftdi/doc/index.rst b/pyftdi/doc/index.rst
@@ -44,8 +44,7 @@ Supported FTDI devices include:
   * FT2232C/D (dual port, clock up to 6 MHz)
   * FT232H (single port, clock up to 30 MHz)
   * FT2232H (dual port, clock up to 30 MHz)
-  * FT4232H (quad port, clock up to 30 MHz)
-  * FT4232HA (quad port, clock up to 30 MHz)
+  * FT4232H/HA/HP (quad port, clock up to 30 MHz)
 
 Features
 --------
diff --git a/pyftdi/doc/installation.rst b/pyftdi/doc/installation.rst
@@ -40,6 +40,8 @@ configure `udev`, here is a typical setup:
     SUBSYSTEM=="usb", ATTR{idVendor}=="0403", ATTR{idProduct}=="6015", GROUP="plugdev", MODE="0664"
     # FT4232HA
     SUBSYSTEM=="usb", ATTR{idVendor}=="0403", ATTR{idProduct}=="6048", GROUP="plugdev", MODE="0664"
+    # FT4232HP
+    SUBSYSTEM=="usb", ATTR{idVendor}=="0403", ATTR{idProduct}=="6043", GROUP="plugdev", MODE="0664"
 
 .. note:: **Accessing FTDI devices with custom VID/PID**
 
@@ -101,7 +103,7 @@ The probably easiest way to deal with libusb on Windows is to use Zadig_
    stored in the FTDI EEPROM.
 
   * With FTDI devices with multiple channels, such as FT2232 (2 channels) and
-    FT4232 (4 channels), you **must** install the driver for the composite
+    FT4232H/HA/HP (4 channels), you **must** install the driver for the composite
     parent, **not** for the individual interfaces. If you install the driver
     for each interface, each interface will be presented as a unique FTDI
     device and you may have difficulties to select a specific FTDI device port
diff --git a/pyftdi/doc/pinout.rst b/pyftdi/doc/pinout.rst
@@ -31,9 +31,9 @@ FTDI device pinout
           feature, and they should be connected together and to the SDA |I2C|
           bus line. Pull-up resistors on SCK and SDA lines should be used.
 .. [#if2] FT232H_ does not support a secondary MPSSE port, only FT2232H_,
-          FT4232H_ and FT4232HA_ do. Note that FT4232H_/FT4232HA_ has 4 serial
+          and FT4232H_ series do. Note that FT4232H_ series have 4 serial
           ports, but only the first two interfaces are MPSSE-capable. C232HD
           cable only exposes IF/1 (ADBUS).
 .. [#rck] In order to support I2C clock stretch mode, ADBUS7 should be
           connected to SCK. When clock stretching mode is not selected, ADBUS7
-          may be used as GPIO7.
+          may be used as GPIO7.
diff --git a/pyftdi/doc/urlscheme.rst b/pyftdi/doc/urlscheme.rst
@@ -28,7 +28,7 @@ where:
   * Supported product aliases:
 
     * ``232``, ``232r``, ``232h``, ``2232d``, ``2232h``, ``4232h``, ``4232ha``,
-      ``230x``
+      ``4232hp``, ``230x``
     * ``ft`` prefix for all aliases is also accepted, as for example ``ft232h``
 
 * ``serial``: the serial number as a string. This is the preferred method to
diff --git a/pyftdi/eeprom.py b/pyftdi/eeprom.py
@@ -1,4 +1,4 @@
-# Copyright (c) 2019-2024, Emmanuel Blot <emmanuel.blot@free.fr>
+# Copyright (c) 2019-2026, Emmanuel Blot <emmanuel.blot@free.fr>
 # All rights reserved.
 #
 # SPDX-License-Identifier: BSD-3-Clause
@@ -61,6 +61,7 @@ class FtdiEeprom:
         0x0800: _PROPS(256, 0x1A, 0x9A, 0x18),   # FT4232H
         0x0900: _PROPS(256, 0x1A, 0xA0, 0x1e),   # FT232H
         0x1000: _PROPS(1024, 0x1A, 0xA0, None),  # FT230X/FT231X/FT234X
+        0x3100: _PROPS(256, 0x1A, 0x9A, 0x18),   # FT4232HP
         0x3600: _PROPS(256, 0x1A, 0x9A, 0x18),   # FT4232HA
     }
     """EEPROM properties."""
@@ -73,7 +74,7 @@ class FtdiEeprom:
     CBUSH = IntEnum('CBusH',
                     'TRISTATE TXLED RXLED TXRXLED PWREN SLEEP DRIVE0 DRIVE1 '
                     'GPIO TXDEN CLK30 CLK15 CLK7_5', start=0)
-    """Alternate features for FT232H/FT2232H/FT4232H devices."""
+    """Alternate features for FT232H, FT2232H, FT4232H/HA/HP devices."""
 
     CBUSX = IntEnum('CBusX',
                     'TRISTATE TXLED RXLED TXRXLED PWREN SLEEP DRIVE0 DRIVE1 '
@@ -1054,8 +1055,8 @@ def _set_bus_control_230x(self, bus: str, control: str,
 
     def _set_group_x232h(self, group: int, control: str, value: str,
                          out: Optional[TextIO]) -> None:
-        # 2232H/4232H/4232HA
-        if self.device_version in (0x0700, 0x800, 0x3600):
+        # 2232H/4232H/4232HA/4232HP
+        if self.device_version in (0x0700, 0x800, 0x3100, 0x3600):
             offset = 0x0c + group//2
             nibble = group & 1
         else:  # 232H
@@ -1225,7 +1226,7 @@ def _decode_4232h(self):
                 'RS485' if conf & (rs485 << chix) else 'UART')
 
     def _decode_x232h(self, cfg):
-        # common code for 2232h, 4232h, 4232ha
+        # common code for 2232H, 4232H, 4232HA, 4232HP
         cfg0, cfg1 = self._eeprom[0x00], self._eeprom[0x01]
         cfg['channel_a_driver'] = 'VCP' if (cfg0 & (1 << 3)) else 'D2XX'
         cfg['channel_b_driver'] = 'VCP' if (cfg1 & (1 << 3)) else 'D2XX'
diff --git a/pyftdi/ftdi.py b/pyftdi/ftdi.py
@@ -1,4 +1,4 @@
-# Copyright (c) 2010-2024 Emmanuel Blot <emmanuel.blot@free.fr>
+# Copyright (c) 2010-2026 Emmanuel Blot <emmanuel.blot@free.fr>
 # Copyright (c) 2016 Emmanuel Bouaziz <ebouaziz@free.fr>
 # All rights reserved.
 #
@@ -506,8 +506,8 @@ def open(self, vendor: int, product: int, bus: Optional[int] = None,
            the USB device in random order. serial argument is more reliable
            selector and should always be prefered.
 
-           Some FTDI devices support several interfaces/ports (such as FT2232H,
-           FT4232H and FT4232HA). The interface argument selects the FTDI port
+           Some FTDI devices support several interfaces/ports (such as
+           FT4232H/HA/HP). The interface argument selects the FTDI port
            to use, starting from 1 (not 0).
 
            :param int vendor: USB vendor id
@@ -652,8 +652,8 @@ def open_mpsse(self, vendor: int, product: int, bus: Optional[int] = None,
            the USB device in random order. serial argument is more reliable
            selector and should always be prefered.
 
-           Some FTDI devices support several interfaces/ports (such as FT2232H,
-           FT4232H and FT4232HA). The interface argument selects the FTDI port
+           Some FTDI devices support several interfaces/ports (such as
+           FT4232H/HA/HP). The interface argument selects the FTDI port
            to use, starting from 1 (not 0). Note that not all FTDI ports are
            MPSSE capable.
 
@@ -705,8 +705,8 @@ def open_mpsse_from_device(self, device: UsbDevice,
            the USB device in random order. serial argument is more reliable
            selector and should always be prefered.
 
-           Some FTDI devices support several interfaces/ports (such as FT2232H,
-           FT4232H and FT4232HA). The interface argument selects the FTDI port
+           Some FTDI devices support several interfaces/ports (such as
+           FT4232H/HA/HP). The interface argument selects the FTDI port
            to use, starting from 1 (not 0). Note that not all FTDI ports are
            MPSSE capable.
 
diff --git a/pyftdi/tests/backend/ftdivirt.py b/pyftdi/tests/backend/ftdivirt.py
@@ -1,6 +1,6 @@
 """PyUSB virtual FTDI device."""
 
-# Copyright (c) 2020-2024, Emmanuel Blot <emmanuel.blot@free.fr>
+# Copyright (c) 2020-2026, Emmanuel Blot <emmanuel.blot@free.fr>
 # All rights reserved.
 #
 # SPDX-License-Identifier: BSD-3-Clause
@@ -231,6 +231,7 @@ class BitMode(IntEnum):
         0x0800: (2048, 2048),  # FT4232H:   TX: 2KiB, RX: 2KiB
         0x0900: (1024, 1024),  # FT232H:    TX: 1KiB, RX: 1KiB
         0x1000: (512, 512),    # FT-X:      TX: 512, RX: 512
+        0x3100: (2048, 2048),  # FT4232HA:  TX: 2KiB, RX: 2KiB
         0x3600: (2048, 2048),  # FT4232HA:  TX: 2KiB, RX: 2KiB
     }
     """FTDI chip internal FIFO sizes.
@@ -247,6 +248,7 @@ class BitMode(IntEnum):
         0x0800: 8,
         0x0900: 16,
         0x1000: 8,
+        0x3100: 8,
         0x3600: 8}
     """Interterface pin count."""
 
@@ -966,6 +968,7 @@ class Properties(NamedTuple):
         0x0800: Properties(4, 8, 0),   # FT4232H
         0x0900: Properties(1, 8, 10),  # FT232H
         0x1000: Properties(1, 8, 4),   # FT231X
+        0x3100: Properties(4, 8, 0),   # FT4232HP
         0x3600: Properties(4, 8, 0),   # FT4232HA
     }
     """Width of port/bus (regular, cbus)."""
diff --git a/pyftdi/tests/gpio.py b/pyftdi/tests/gpio.py
@@ -1,7 +1,7 @@
 #!/usr/bin/env python3
 # -*- coding: utf-8 -*-
 
-# Copyright (c) 2016-2024, Emmanuel Blot <emmanuel.blot@free.fr>
+# Copyright (c) 2016-2026, Emmanuel Blot <emmanuel.blot@free.fr>
 # All rights reserved.
 #
 # SPDX-License-Identifier: BSD-3-Clause
@@ -354,7 +354,7 @@ def test_gpio_baudate(self):
 
 class GpioMultiportTestCase(FtdiTestCase):
     """FTDI GPIO test for multi-port FTDI devices,
-       i.e. FT2232H/FT4232H/FT4232HA.
+       i.e. FT2232H/FT4232H/FT4232HA/FT4232HP.
 
        Please ensure that the HW you connect to the FTDI port A does match
        the encoded configuration. Check your HW setup before running this test
diff --git a/pyftdi/tests/i2c.py b/pyftdi/tests/i2c.py
@@ -3,7 +3,7 @@
 
 """I2C unit tests."""
 
-# Copyright (c) 2017-2024, Emmanuel Blot <emmanuel.blot@free.fr>
+# Copyright (c) 2017-2026, Emmanuel Blot <emmanuel.blot@free.fr>
 # All rights reserved.
 #
 # SPDX-License-Identifier: BSD-3-Clause
@@ -240,7 +240,7 @@ def test(self):
 
 class I2cDualMasterTestCase(TestCase):
     """Check the behaviour of 2 I2C masters. Requires a multi port FTDI device,
-       i.e. FT2232H, FT4232H or FT4232HA. See issue #159.
+       i.e. FT2232H, FT4232H, FT4232HA or FT4232HP. See issue #159.
     """
 
     def test(self):
diff --git a/pyftdi/tests/mockusb.py b/pyftdi/tests/mockusb.py
@@ -1,7 +1,7 @@
 #!/usr/bin/env python3
 # -*- coding: utf-8 -*-
 
-# Copyright (c) 2020-2024, Emmanuel Blot <emmanuel.blot@free.fr>
+# Copyright (c) 2020-2026, Emmanuel Blot <emmanuel.blot@free.fr>
 # All rights reserved.
 
 # pylint: disable=empty-docstring
@@ -100,16 +100,18 @@ def test_list_devices(self):
                 '2232h': 0x6010,
                 '4232h': 0x6011,
                 '4232ha': 0x6048,
+                '4232hp': 0x6043,
             }
         }
         devs = UsbTools.list_devices('ftdi:///?', vids, pids, vid)
-        self.assertEqual(len(devs), 7)
+        self.assertEqual(len(devs), 8)
         ifmap = {
             0x6001: 1,
             0x6010: 2,
             0x6011: 4,
             0x6014: 1,
             0x6015: 1,
+            0x6043: 4,
             0x6048: 4
         }
         for dev, desc in devs:
@@ -143,7 +145,7 @@ def setUpClass(cls):
     def test_list_devices(self):
         """List FTDI devices."""
         devs = Ftdi.list_devices('ftdi:///?')
-        self.assertEqual(len(devs), 7)
+        self.assertEqual(len(devs), 8)
         devs = Ftdi.list_devices('ftdi://:232h/?')
         self.assertEqual(len(devs), 2)
         devs = Ftdi.list_devices('ftdi://:2232h/?')
@@ -152,16 +154,19 @@ def test_list_devices(self):
         self.assertEqual(len(devs), 1)
         devs = Ftdi.list_devices('ftdi://:4232ha/?')
         self.assertEqual(len(devs), 1)
+        devs = Ftdi.list_devices('ftdi://:4232hp/?')
+        self.assertEqual(len(devs), 1)
         out = StringIO()
         Ftdi.show_devices('ftdi:///?', out)
         lines = [ln.strip() for ln in out.getvalue().split('\n')]
         lines.pop(0)  # "Available interfaces"
         while lines and not lines[-1]:
             lines.pop()
-        self.assertEqual(len(lines), 14)
+        # 232:1, 2232: 2, 4232: 4
+        self.assertEqual(len(lines), 18)
         portmap = defaultdict(int)
         reference = {'232': 1, '2232': 2, '4232': 4, '232h': 2, 'ft-x': 1,
-                     '4232ha': 4}
+                     '4232ha': 4, '4232hp': 4}
         for line in lines:
             url = line.split(' ')[0].strip()
             parts = urlsplit(url)
@@ -253,7 +258,7 @@ def test_enumerate(self):
 
 
 class MockFourPortDeviceTestCase(FtdiTestCase):
-    """Test FTDI APIs with a quad-port FTDI device (FT4232H, FT4232HA)
+    """Test FTDI APIs with a quad-port FTDI device (FT4232H/HA/HP)
     """
 
     @classmethod
@@ -299,15 +304,16 @@ def test_enumerate(self):
         lines.pop(0)  # "Available interfaces"
         while lines and not lines[-1]:
             lines.pop()
-        self.assertEqual(len(lines), 14)
+        # 232:1, 2232: 2, 4232: 4
+        self.assertEqual(len(lines), 18)
         for line in lines:
             self.assertTrue(line.startswith('ftdi://'))
             # skip description, i.e. consider URL only
             url = line.split(' ')[0]
             urlparts = urlsplit(url)
             self.assertEqual(urlparts.scheme, 'ftdi')
             parts = urlparts.netloc.split(':')
-            if (parts[1] == '4232') or (parts[1] == '4232ha'):
+            if parts[1].startswith('4232'):
                 # def file contains no serial number, so expect bus:addr syntax
                 self.assertEqual(len(parts), 4)
                 self.assertRegex(parts[2], r'^\d$')
diff --git a/pyftdi/tests/resources/ft4232hp.yaml b/pyftdi/tests/resources/ft4232hp.yaml
diff --git a/pyftdi/tests/resources/ftmany.yaml b/pyftdi/tests/resources/ftmany.yaml
diff --git a/pyftdi/usbtools.py b/pyftdi/usbtools.py
