博客笔记：用MicroPython点亮ESP32-S3开发板的板载WS2812 RGB LED

1. 引言

ESP32-S3开发板（如DevKitC-1）集成WS2812 RGB LED，可通过MicroPython快速实现灯光控制。本文整理关键步骤与代码，帮助开发者快速上手[[9]]。

2. 硬件与引脚确认

• 板载LED引脚：开发板标注 RGB@IO48，实际使用 GPIO48 控制WS2812[[3]][[8]]。
• 供电设计：板载专用LDO为LED和无线模块供电，无需额外电源[[1]][[5]]。

3. 代码实现

使用MicroPython的 neopixel 库驱动LED，核心代码如下：

from machine import Pin
import neopixel

# 初始化（引脚48，1个LED）
pin = Pin(48, Pin.OUT)
np = neopixel.NeoPixel(pin, 1)

# 设置颜色（红色）
np[0] = (255, 0, 0)
np.write()  # 提交颜色设置

4. 关键说明

• 时序处理：neopixel 库自动处理WS2812的精确时序信号，无需手动配置PWM[[9]]。
• 颜色格式：通过元组 (R, G, B) 定义颜色，数值范围0-255。
• 非直接驱动：LED通过专用电路连接，避免GPIO直接驱动的电平问题[[6]]。

5. 调试与验证

• 常见问题：
  • 未调用 np.write() 导致颜色未生效。
  • 误用其他GPIO引脚（如GPIO14用于外部扩展）[[7]]。
• 验证方法：上传代码后观察LED是否点亮红色，若失败需检查引脚配置与代码逻辑。

6. 扩展应用

• 多LED控制：修改 NeoPixel 参数（如 n=8 控制8颗LED）。
• Web控制：结合ESP32 WebServer库，通过网页动态调整颜色[[9]]。

7. 参考资料

• WS2812驱动逻辑与GPIO引脚定义[[3]][[8]]。
• MicroPython官方文档中的 neopixel 库用法[[9]]。

总结：通过简单代码即可实现ESP32-S3的RGB LED控制，适合物联网灯光项目或状态指示场景。后续可结合传感器或网络功能扩展交互逻辑。