MicroPython WS2812 驱动项目教程

MicroPython WS2812 驱动项目教程

micropython-ws2812 MicroPython driver for WS2812 RGB LEDs (WS2812B, AdaFruit NeoPixels, ...). 项目地址: https://gitcode.com/gh_mirrors/mi/micropython-ws2812

1. 项目目录结构及介绍

micropython-ws2812/
├── .gitignore
├── LICENSE
├── README.md
├── example_240_leds.py
├── example_advanced.py
├── example_simple.py
└── ws2812.py

目录结构说明

• .gitignore: Git 忽略文件配置，用于指定哪些文件或目录不需要被 Git 管理。
• LICENSE: 项目的开源许可证文件，本项目使用 MIT 许可证。
• README.md: 项目的说明文档，包含项目的基本介绍、安装方法、使用示例等。
• example_240_leds.py: 针对 240 个 LED 的示例代码，展示如何控制较长的 LED 灯带。
• example_advanced.py: 高级示例代码，展示如何使用更复杂的动画效果。
• example_simple.py: 简单示例代码，展示如何基本控制 LED 灯带。
• ws2812.py: 核心驱动文件，包含控制 WS2812 RGB LED 的 MicroPython 驱动代码。

2. 项目的启动文件介绍

example_simple.py

这是一个简单的启动文件，适合初学者使用。它展示了如何使用 ws2812.py 驱动文件来控制一个包含 16 个 LED 的 NeoPixels 环。

from ws2812 import WS2812

chain = WS2812(spi_bus=1, led_count=16)
data = [
    (255, 0, 0),  # 红色
    (0, 255, 0),  # 绿色
    (0, 0, 255),  # 蓝色
    (85, 85, 85), # 白色
]
chain.show(data)

example_advanced.py

这是一个高级启动文件，适合有一定经验的用户。它展示了如何使用更复杂的动画效果来控制 LED 灯带。

from ws2812 import WS2812

chain = WS2812(spi_bus=1, led_count=16)
# 这里可以添加更复杂的动画逻辑
chain.show(data)

3. 项目的配置文件介绍

ws2812.py

这是项目的核心配置文件，包含了控制 WS2812 RGB LED 的 MicroPython 驱动代码。用户可以通过修改这个文件来调整 LED 的控制逻辑。

class WS2812:
    def __init__(self, spi_bus, led_count):
        self.spi = SPI(spi_bus, baudrate=3200000, polarity=0, phase=0)
        self.led_count = led_count
        self.buf = bytearray(led_count * 3)

    def show(self, data):
        for i in range(self.led_count):
            self.buf[i * 3] = data[i][0]
            self.buf[i * 3 + 1] = data[i][1]
            self.buf[i * 3 + 2] = data[i][2]
        self.spi.write(self.buf)

配置说明

• spi_bus: 指定使用的 SPI 总线编号，通常为 1 或 2。
• led_count: 指定 LED 的数量，根据实际连接的 LED 数量进行设置。
• data: 一个包含 RGB 颜色值的列表，用于设置每个 LED 的颜色。

通过修改 ws2812.py 文件中的参数，用户可以自定义 LED 的控制逻辑，实现更复杂的效果。

micropython-ws2812 MicroPython driver for WS2812 RGB LEDs (WS2812B, AdaFruit NeoPixels, ...). 项目地址: https://gitcode.com/gh_mirrors/mi/micropython-ws2812