CircuitPython API,适用于非CircuitPython版本的Python,如Linux上的CPython和MicroPython。
项目描述
简介
此存储库包含一组用于在运行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的设备上它们没有价值,并且可能会以不愉快的方式发生冲突。
位于
从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)上出错。这是一种在本地验证它是否通过的好方法。
项目详情
下载文件
下载适用于您平台的文件。如果您不确定选择哪个,请了解更多关于 安装包 的信息。