跳转到主要内容

CircuitPython库,用于NeoPixel LED灯带。

项目描述

Adafruit CircuitPython NeoPixel

Documentation Status Discord Build Status Code Style: Black

高级NeoPixel驱动程序,将条带表示为序列。这是原始MicroPython驱动程序的超级增强版。现在它更像是一个正常的Python序列,并具有切片支持、reprlen支持。

颜色默认存储为元组。但是,您也可以使用int十六进制语法设置类似于网页上颜色的值。例如,0x100000(在网页上为#100000)相当于(0x10, 0, 0)

依赖项

此驱动程序依赖于

请确保所有依赖项都可在CircuitPython文件系统中使用。这可以通过下载Adafruit库和驱动程序包轻松实现。

从PyPI安装

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

pip3 install adafruit-circuitpython-neopixel

全局安装系统(在某些情况下可能需要)

sudo pip3 install adafruit-circuitpython-neopixel

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

mkdir project-name && cd project-name
python3 -m venv .venv
source .venv/bin/activate
pip3 install adafruit-circuitpython-neopixel

使用示例

此示例演示了在Feather M0 ExpressMetro M0 Express上集成的单个内置NeoPixel库。

import board
import neopixel

pixels = neopixel.NeoPixel(board.NEOPIXEL, 1)
pixels[0] = (10, 0, 0)

此示例演示了在Circuit Playground Express上集成的十个内置NeoPixel库。它关闭了auto_write,以便在调用show方法时一次性更新所有像素。

import board
import neopixel

pixels = neopixel.NeoPixel(board.NEOPIXEL, 10, auto_write=False)
pixels[0] = (10, 0, 0)
pixels[9] = (0, 10, 0)
pixels.show()

此示例演示了如何使用一个连接到GPIO引脚的单个NeoPixel,并通过pixel_order指定颜色通道顺序。请注意,bpp不需要指定,因为它由提供的pixel_order计算得出。

import board
import neopixel

pixel = neopixel.NeoPixel(board.D0, 1, pixel_order=neopixel.RGBW)
pixel[0] = (30, 0, 20, 10)

在Raspberry Pi板上的sudo-free使用设置

  1. 通过raspi-config工具或手动添加以下内容来启用SPI和串行端口硬件(串行接口):

    dtparam=spi=on
    enable_uart=1

    /boot/config.txt

  2. 重启Pi以应用更改 - 硬件设置在启动过程中进行。

  3. 将LED的DIN连接到GPIO10(物理引脚19)

在初始化NeoPixel对象时,始终使用board.D10(GPIO10)

import board
import neopixel

DATA_PIN = board.D10
pixel = neopixel.NeoPixel(DATA_PIN, ...)

现在您可以使用python执行代码,无需sudo

文档

此库的API文档可以在Read the Docs上找到。

有关构建库文档的信息,请参阅本指南

贡献

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

项目详情


下载文件

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

源分布

adafruit-circuitpython-neopixel-6.3.11.tar.gz (28.5 kB 查看哈希值)

上传时间

构建分布

由以下支持