rpi-ws281x库测试介绍

彩色RGB灯测试-rpi-ws281x库使用

1 rpi-ws281x库介绍

rpi-ws281x 是一个针对 Raspberry Pi 的库，用于控制WS281X 系列 LED 灯带（例如 WS2812B）的颜色和亮度。它提供了一个 Python 接口，让你可以轻松地通过 Raspberry Pi 控制这些 LED 灯带，实现各种有趣的灯光效果和项目。

这个库的主要特点包括：

简单的接口：rpi-ws281x 提供了一个简洁易用的 Python 接口，使得控制 WS281X LED 灯带变得非常简单。
高性能：由于底层是通过 C 语言编写的，因此这个库在 Raspberry Pi 上运行时性能较高，能够处理大量 LED灯带和复杂的灯光效果。支持多种 LED 类型：WS281X 系列涵盖了多种型号的 LED，例如 WS2812B、WS2811、WS2813 等，rpi-ws281x 库支持这些型号，可以灵活地应用于不同类型的 LED 灯带。
灵活的控制：你可以通过这个库控制 LED 灯带的颜色、亮度和灯珠的排列方式，实现各种效果，例如彩虹流动、呼吸灯效果、跑马灯等。

这个需要提前安装对应的驱动库，如果你还没有安装好库。可以参考我的这篇论文：

树莓派驱动RGB灯-利用rpi-ws281x库来编写-------python版本

2 电路接法

连接 WS2812B LED 灯带到树莓派的 GPIO 引脚需要遵循一定的步骤和注意事项，主要包括以下几个方面：

确定引脚：首先，你需要确定将 LED 灯带连接到树莓派上的哪个 GPIO 引脚。在示例代码中，引脚被指定为 LED_PIN = 18，这意味着 LED 灯带将连接到树莓派的 GPIO 18 引脚上。
硬件连接：接下来，使用杜邦线或类似的电线将 LED 灯带的信号引脚连接到树莓派的 GPIO 引脚。确保将信号线连接到正确的 GPIO 引脚，并根据需要连接灯带的电源和接地线。
供电需求：WS2812B LED 灯带通常需要 5V 的电源供应。确保你为 LED灯带提供足够的电流和电压，以避免过载或不稳定的情况发生。

3 测试代码

首先导入了需要的库，然后设置了 LED 灯带的配置参数。接着创建了 PixelStrip 对象，并定义了一个 wheel 函数来生成彩虹颜色序列。在主循环中，不断更新 LED 灯带的颜色，实现彩虹流动的效果。最后，通过捕获键盘中断来优雅地关闭 LED 灯带。

python 复制代码

from rpi_ws281x import PixelStrip, Color
# LED灯带配置
LED_COUNT = 30  # LED 灯珠数量
LED_PIN = 18    # 连接到树莓派的GPIO引脚
LED_FREQ_HZ = 800000  # LED频率（通常是800kHz）
LED_DMA = 10  # DMA通道
LED_BRIGHTNESS = 255  # 亮度（0-255之间）
LED_INVERT = False  # 反转信号（True时，信号反转）
# 创建PixelStrip对象
strip = PixelStrip(LED_COUNT, LED_PIN, LED_FREQ_HZ, LED_DMA, LED_INVERT, LED_BRIGHTNESS)

# 初始化LED灯带
strip.begin()

# 定义彩虹颜色序列
def wheel(pos):
    if pos < 85:
        return Color(pos * 3, 255 - pos * 3, 0)
    elif pos < 170:
        pos -= 85
        return Color(255 - pos * 3, 0, pos * 3)
    else:
        pos -= 170
        return Color(0, pos * 3, 255 - pos * 3)

try:
    while True:
        # 循环显示彩虹流动效果
        for j in range(256):
            for i in range(strip.numPixels()):
                strip.setPixelColor(i, wheel((i + j) & 255))
            strip.show()
            time.sleep(0.02)

except KeyboardInterrupt:
    # Ctrl+C退出时关闭LED灯带
    strip.clear()
    strip.show()