pylibftdi

library0.24.0pypypi✓ verified 88d ago

Pythonic interface to FTDI devices using libftdi. Current version 0.24.0, requires Python >=3.10. Released under BSL-1.0, maintained on GitHub. Cadence: irregular, with recent releases in 2024.

serialization

pip install pylibftdi

github ↗package ↗docs ↗

INSTALL

IMPORT

SIG · PYLIBFTDI

pylibftdi

serializationpythonv0.24.0

Install

1.6s avg

Import

122ms

Disk

16MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v0.24.0 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

installs and imports cleanly · install 0.0s · import 0.124s · 18MB

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 1.6s · import 0.120s · 19MB

16MB installed

● package 16MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

BitBangDevice

✓ from pylibftdi import BitBangDevice

✗ from pylibftdi.device import BitBangDevice

Public API is in pylibftdi top-level; submodules are internal.

Device

✓ from pylibftdi import Device

✗ from pylibftdi.driver import FtdiDriver

FtdiDriver was removed; use Device directly.

Driver

✓ from pylibftdi import Driver

Opens first available FTDI device in async mode, writes bytes, reads response.

import os import time from pylibftdi import Device with Device(mode='t', device_id=os.environ.get('DEVICE_SERIAL', '')) as dev: dev.write(b'hello') time.sleep(0.1) print(dev.read(10))

pylibftdi --version

Debug

Known issues

breakingpylibftdi dropped support for Python <3.10 in version 0.24.0.

fix

Upgrade Python to 3.10+ or pin pylibftdi to 0.23.x for older Python.

affects: <0.24.0

deprecatedThe 'baudrate' argument is deprecated in some contexts; use 'baud' instead.

fix

Replace baudrate=... with baud=... in Device constructor.

affects: >=0.22.0

gotchaOn Linux, you must have udev rules or run with sudo to access FTDI devices. Missing rules cause 'FtdiError: libusb_open() failed'.

fix

Add udev rule: SUBSYSTEM=="usb", ATTRS{idVendor}=="0403", ATTRS{idProduct}=="6001", MODE="0666"

affects: all

gotchaWhen using BitBangDevice, note that pin numbering is bit index, not physical pin. Miswiring is common.

fix

Check datasheet: e.g., for FT232R, D0..D7 correspond to pins 1-8 (CBUS0-3 in bitbang mode).

affects: all

Errors

Common errors & fixes

pylibftdi.exc.FtdiError: libusb_open() failed

No permission to access USB device or device not connected.

fix

Ensure device is plugged in and you have udev rules set. Or run with sudo (temporary).

pylibftdi.exc.FtdiError: FTDI device not found

The specified device_id or serial does not match any connected FTDI device.

fix

List devices with pylibftdi.Driver().list_devices() to see available serials.

AttributeError: module 'pylibftdi' has no attribute 'FtdiDriver'

FtdiDriver was removed in pylibftdi 0.22.0.

fix

Use pylibftdi.Driver instead.

Upgrade

Version history

0.24.0latest on PyPI · released Apr 4, 2026

Audit

Dependencies

libftdi1requiredRequired system library; on Linux install via apt (libftdi1-dev)

Agent activity

10 hits · last 30 days

node

Resources

githubhttps://github.com/codedstructure/pylibftdi ↗

packagehttps://pypi.org/project/pylibftdi/ ↗

docshttps://pylibftdi.readthedocs.io/en/latest/ ↗