Introduction

This repository contains a selection of packages emulating the CircuitPython API for devices or hosts running CPython or MicroPython. Working code exists to emulate these CircuitPython packages:

• analogio - analog input/output pins, using pin identities from board+microcontroller packages

• bitbangio - software-driven interfaces for I2C, SPI

• board - breakout-specific pin identities

• busio - hardware-driven interfaces for I2C, SPI, UART

• digitalio - digital input/output pins, using pin identities from board+microcontroller packages

• microcontroller - chip-specific pin identities

• micropython - MicroPython-specific module

• neopixel_write - low-level interface to NeoPixels

• pulseio - contains classes that provide access to basic pulse IO (PWM)

• pwmio - contains classes that provide access to basic pulse IO (PWM)

For details, see the Blinka API reference.

Dependencies

The emulation described above is intended to provide a CircuitPython-like API for devices which are running CPython or Micropython. Since corresponding packages should be built-in to any standard CircuitPython image, they have no value on a device already running CircuitPython and would likely conflict in unhappy ways.

The test suites in the test/src folder under testing.universal are by design intended to run on either CircuitPython or CPython/Micropython+compatibility layer to prove conformance.

Installing from PyPI

On supported GNU/Linux systems like the Raspberry Pi, you can install the driver locally from PyPI. To install for current user:

pip3 install Adafruit-Blinka

To install system-wide (this may be required in some cases):

sudo pip3 install Adafruit-Blinka

To install in a virtual environment in your current project:

mkdir project-name && cd project-name
python3 -m venv .env
source .env/bin/activate
pip3 install Adafruit-Blinka

Usage Example

At the time of writing (git:7fc1f8ab), the following sequence runs through some basic testing of the digitalio compatibility layer…

from testing import test_module_name
test_module_name("testing.universal.digitalio")

An example log from running the suites is here .

Contributing

Contributions are welcome! Please read our Code of Conduct before contributing to help this project stay welcoming.

Building locally

python3 -m venv .env
source .env/bin/activate
pip install Sphinx sphinx-rtd-theme Adafruit-PlatformDetect

cd docs
sphinx-build -E -W -b html . _build/html