---
id: libusbsio
version: "2.2.1"
license: BSD-3-Clause
license_treatment: permissive
maintenance: active
---

# libusbsio — Python wrapper around NXP LIBUSBSIO library

License: permissive · Maintenance: active · Downloads: 545.9K/mo

## What it is and what it does

libusbsio is a Python wrapper around NXP's binary libusbsio library, which provides low-level access to SPI, I2C, and GPIO buses through NXP's LPCLink2 and MCUlink Pro USB debug probes. The wrapper encapsulates the native library and exposes its functionality to Python applications, handling the underlying HID API communication with the USB devices across Windows, macOS, and Linux platforms.

The package is designed for embedded systems development and debugging workflows where you need to communicate with microcontroller boards over USB without writing to the native library directly. It supports multiple simultaneous LIBUSBSIO objects for different connected devices, offers configurable logging, and includes methods for device enumeration, opening by serial number or path, and controlling low-level HID read timeouts.

Use it for:

- Debug and communicate with NXP LPCLink2 or MCUlink Pro devices from Python scripts during embedded development.
- Automate SPI or I2C bus testing and validation against target MCU applications running on connected boards.
- Read and write GPIO pins on target microcontrollers via USB without direct hardware access.
- Integrate NXP debug probe control into Python-based test frameworks or CI/CD pipelines for embedded projects.
- Enumerate and manage multiple connected USBSIO devices simultaneously in a single Python application.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides a Python wrapper around NXP's libusbsio binary library to control SPI, I2C, and GPIO interfaces over USB on LPCLink2 and MCUlink Pro debug probes.

Yes, if you own or work with NXP LPCLink2 or MCUlink Pro hardware and need to control SPI, I2C, or GPIO from Python. The package is actively maintained, has no external dependencies, carries a permissive license, and is free of known vulnerabilities. Install only if you have the required NXP hardware; it is not useful as a standalone library.

## Install

pip install libusbsio
uv add libusbsio
poetry add libusbsio

## Installing libusbsio

Before you install: Low install friction with no external Python dependencies. Package is actively maintained, with the latest release from June 2026 and a release cycle showing regular updates.

License in practice: BSD-3-Clause permissive license allows use in commercial and proprietary projects with minimal restrictions; source code availability since v2.1.11.

Quickstart:

python -m pip install libusbsio

from libusbsio import LIBUSBSIO
import logging

logging.basicConfig()
sio = LIBUSBSIO(loglevel=logging.INFO)

Requires the NXP libusbsio binary library to be installed on the system; LPCLink2 or MCUlink Pro hardware device must be connected via USB.

Verify before relying:

- Whether the package works with Python versions beyond 3.6 in practice, despite the requires_python declaration.
- Availability and completeness of API documentation beyond the description excerpt.
- Whether all platform binaries (Windows, macOS, Linux including armv7l and aarch64) are included in the PyPI wheel.

## Package facts

- License: BSD-3-Clause (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 545.9K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

nxp usbsio python wrapper, spi i2c gpio usb interface, lpclink2 mculink pro control, embedded device usb communication, nxp debug probe interface, embedded-systems, hardware-interface, nxp-tools

[View on SkillFed](https://skillfed.io/packages/libusbsio) · [View on PyPI](https://pypi.org/project/libusbsio/)