# About

`pycosmicsdk` is the Python SDK for the [Binho](https://binho.io/) USB host
adapters. It wraps the native
[CosmicSDK](https://binhollc.github.io/CosmicSDK/) C/C++ library in a compiled
extension and exposes two symmetric APIs over the same hardware —
{py:obj}`~pycosmicsdk.Device` for blocking code and
{py:obj}`~pycosmicsdk.AsyncDevice` for `asyncio` — plus compatibility shims for
the Python packages it supersedes.

## The hardware

The SDK is built specifically for use with:

- [Binho Pulsar](https://binho.io/test-measurement/products/binho-pulsar/) — a
  versatile USB host adapter supporting I2C, SPI, UART, RS-485, CAN-FD and
  GPIO interfaces.
- [Binho Supernova](https://binho.io/test-measurement/products/binho-supernova/) —
  a next-generation USB host adapter featuring MIPI I3C support alongside I2C,
  SPI, UART and GPIO.
- Binho Atira — a debug probe for Arm Cortex-M targets: SWD debug, SPI NOR
  flash programming, switchable target power and a USB-to-UART bridge. See the
  [Atira debug probe guide](guides/debugprobe.md).

All three devices are ideal for rapid development, hardware validation and
automated testing. For more information, visit [binho.io](https://binho.io/).

Which of those interfaces this SDK reaches on which device is a per-model
question, answered in the table on the [landing page](index.md) and at runtime
by {py:obj}`~pycosmicsdk.DeviceCapabilities`.

## The SDK family

| Project | What it is |
| --- | --- |
| **CosmicSDK** | the native C++ SDK and C API — the layer this package wraps ([documentation](https://binhollc.github.io/CosmicSDK/)) |
| **pycosmicsdk** | this package: the Python surface, including the legacy compatibility shims |

Both run on the developer's machine and talk to the adapter over USB HID; the
firmware on the adapter is what executes the bus transactions.

## License

`pycosmicsdk` is proprietary software — Copyright © 2026 Binho Inc, all rights
reserved. See the `LICENSE` file shipped with the distribution for the terms.