WS2812B 开源项目教程

WS2812B 开源项目教程

ws2812bWS2812B full function driver library for general MCU and Linux.项目地址:https://gitcode.com/gh_mirrors/ws/ws2812b

1. 项目的目录结构及介绍

ws2812b/
├── docs/
│   └── README.md
├── examples/
│   ├── basic_example.py
│   └── advanced_example.py
├── src/
│   ├── ws2812b.py
│   └── utils.py
├── tests/
│   ├── test_ws2812b.py
│   └── test_utils.py
├── .gitignore
├── LICENSE
├── README.md
└── requirements.txt

• docs/: 存放项目文档，包括使用说明和API文档。
• examples/: 包含项目的示例代码，帮助用户快速上手。
• src/: 项目的源代码，包括主要功能模块和辅助工具。
• tests/: 项目的测试代码，确保代码的正确性和稳定性。
• .gitignore: Git版本控制忽略文件列表。
• LICENSE: 项目的开源许可证。
• README.md: 项目的基本介绍和使用说明。
• requirements.txt: 项目依赖的Python包列表。

2. 项目的启动文件介绍

项目的启动文件位于 src/ws2812b.py。该文件包含了WS2812B LED灯带的主要控制逻辑和API接口。用户可以通过导入该模块来使用WS2812B LED灯带的功能。

# src/ws2812b.py

import time
from rpi_ws281x import Adafruit_NeoPixel, Color

class WS2812B:
    def __init__(self, num_leds, pin, freq_hz=800000, dma=10, invert=False, brightness=255, channel=0):
        self.strip = Adafruit_NeoPixel(num_leds, pin, freq_hz, dma, invert, brightness, channel)
        self.strip.begin()

    def set_pixel_color(self, index, color):
        self.strip.setPixelColor(index, color)

    def show(self):
        self.strip.show()

    def clear(self):
        for i in range(self.strip.numPixels()):
            self.strip.setPixelColor(i, Color(0, 0, 0))
        self.strip.show()

# 示例代码
if __name__ == "__main__":
    led_strip = WS2812B(num_leds=30, pin=18)
    led_strip.set_pixel_color(0, Color(255, 0, 0))
    led_strip.show()
    time.sleep(1)
    led_strip.clear()

3. 项目的配置文件介绍

项目没有专门的配置文件，但用户可以通过修改 src/ws2812b.py 中的参数来配置LED灯带的行为。例如，可以修改 num_leds 和 pin 参数来适应不同的硬件环境。

# src/ws2812b.py

# 修改以下参数以适应不同的硬件环境
num_leds = 30  # LED灯带的总数
pin = 18       # GPIO引脚编号

通过修改这些参数，用户可以灵活地配置WS2812B LED灯带的行为，以满足不同的应用需求。

ws2812bWS2812B full function driver library for general MCU and Linux.项目地址:https://gitcode.com/gh_mirrors/ws/ws2812b