跳转到主要内容

CircuitPython API,适用于非CircuitPython版本的Python,如Linux上的CPython和MicroPython。

项目描述

简介

Documentation Status Discord Build Status Code Style: Black

此存储库包含一组用于在运行CPython或MicroPython的设备或主机上模拟CircuitPython API的包。存在用于模拟这些CircuitPython包的工作代码

  • analogio - 使用板+微控制器包中的引脚标识符的模拟输入/输出引脚

  • bitbangio - 用于I2C、SPI的软件驱动接口

  • board - 突破特定引脚标识符

  • busio - 用于I2C、SPI、UART的硬件驱动接口

  • digitalio - 使用板+微控制器包中的引脚标识符的数字输入/输出引脚

  • keypad - 支持扫描键和键盘矩阵

  • microcontroller - 芯片特定引脚标识符

  • micropython - MicroPython特定模块

  • neopixel_write - 低于NeoPixels的底层接口

  • 脉冲IO - 包含提供基本脉冲IO(PWM)访问的类

  • 脉冲IO - 包含提供基本脉冲IO(PWM)访问的类

  • 彩虹IO - 提供colorwheel()函数

  • USB HID - 使用usb_gadget内核驱动程序作为HID设备

有关详细信息,请参阅Blinka API参考

依赖项

上述模拟旨在为运行CPython或Micropython的设备提供类似CircuitPython的API。由于相应的包应内置到任何标准CircuitPython镜像中,因此在已经运行CircuitPython的设备上它们没有价值,并且可能会以不愉快的方式发生冲突。

位于testing.universal下的test/src文件夹中的测试套件旨在在任一 CircuitPython CPython/Micropython+兼容层上运行以证明一致性。

从PyPI安装

在支持的GNU/Linux系统(如Raspberry Pi)上,您可以从PyPI本地安装驱动程序(点击安装)。为当前用户安装

pip3 install Adafruit-Blinka

为系统范围安装(在某些情况下可能需要)

sudo pip3 install Adafruit-Blinka

在当前项目的虚拟环境中安装

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

使用示例

引脚名称可能因板而异,因此您可能需要更改代码中的引脚名称。此示例在Raspberry Pi板上运行,闪烁连接到GPIO 18(引脚12)的LED

import time
import board
import digitalio

PIN = board.D18

print("hello blinky!")

led = digitalio.DigitalInOut(PIN)
led.direction = digitalio.Direction.OUTPUT

while True:
    led.value = True
    time.sleep(0.5)
    led.value = False
    time.sleep(0.5)

贡献

欢迎贡献!在贡献之前,请阅读我们的行为准则,以帮助保持本项目的友好氛围。

本地构建

Sphinx文档

Sphinx用于根据rST文件和代码中的注释构建文档。首先,安装依赖项(请随意重复使用上面的虚拟环境)

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

这将输出文档到docs/_build/html。在浏览器中打开index.html以查看它们。它还会(由于-W)在警告(如Travis)上出错。这是一种在本地验证它是否通过的好方法。

项目详情


发布历史 发布通知 | RSS源

下载文件

下载适用于您平台的文件。如果您不确定选择哪个,请了解更多关于 安装包 的信息。

源分发

adafruit_blinka-8.47.0.tar.gz (245.1 kB 查看哈希值)

上传时间

构建分发

Adafruit_Blinka-8.47.0-py3-none-any.whl (356.1 kB 查看哈希值)

上传时间 Python 3

支持