ESP8266 LED Strip Development

This skill configures Claude Code to work effectively with PlatformIO-based embedded systems projects targeting the NodeMCU v2 (ESP8266) development board with WS2811 RGB LED strips.

Project Context

You are working with an embedded systems project configured for:

**Target Board**: NodeMCU v2 (ESP8266)

**Platform**: Espressif8266

**Framework**: Arduino

**LED Hardware**: BTF-LIGHTING 2835SMD WS2811 IC RGB Chasing Color LED Strip

- 16.4FT length

- DC24V power

- 108 LEDs/meter

- 18 Pixels/meter (addressable)

- 8mm width

- WS2811 IC controller

Development Workflow

When building, uploading, or debugging this project:

1. **Build the project**:

```bash

pio run

```

2. **Upload to device**:

```bash

pio run --target upload

```

3. **Monitor serial output**:

```bash

pio device monitor

```

4. **Clean build artifacts**:

```bash

pio run --target clean

```

5. **Build, upload, and monitor in one command**:

```bash

pio run --target upload && pio device monitor

```

Project Structure

Understand and respect the standard PlatformIO project layout:

`src/main.cpp` - Main Arduino sketch with `setup()` and `loop()` functions

`platformio.ini` - PlatformIO configuration (board, platform, dependencies)

`lib/` - Project-specific libraries

`include/` - Header files

`test/` - Unit tests

`.pio/` - Build artifacts (gitignored)

Arduino Architecture

This project follows the Arduino programming model:

`setup()` function runs once at startup (initialization)

`loop()` function runs continuously (main program logic)

Use Arduino APIs and libraries when available

For WS2811 LED control, recommend FastLED or Adafruit NeoPixel libraries

LED Strip Considerations

When working with the WS2811 LED strip:

The strip has 18 addressable pixels per meter (not 108 LEDs)

Each pixel contains 6 LEDs controlled as a single RGB unit

Requires a library supporting WS2811 protocol (FastLED or Adafruit NeoPixel)

Operates at DC24V (ensure power supply compatibility)

Data pin connection required from ESP8266 to strip

Code Modifications

When modifying code:

1. Always check `platformio.ini` for library dependencies before adding new includes

2. Verify pin assignments match the NodeMCU v2 board layout

3. Consider memory constraints of the ESP8266 (limited RAM)

4. Use `Serial.println()` for debugging via serial monitor

5. Test incrementally after each change

Common Tasks

**Add a library**: Add to `lib_deps` in `platformio.ini`, then run `pio run`

**Change board settings**: Edit `platformio.ini` under `[env:nodemcuv2]`

**Debug output**: Use `Serial.begin(115200)` in `setup()`, then `Serial.println()` statements

**Pin references**: Use Arduino pin numbers (D0-D8) for NodeMCU, not GPIO numbers

Important Notes

Always clean build artifacts if experiencing unexplained build errors

The ESP8266 requires a USB driver (CH340 or CP2102) to be installed on the development machine

Serial monitor baud rate should match `Serial.begin()` rate in code (typically 115200)

The `.pio` directory should never be committed to version control

ESP8266 LED Strip Development

ESP8266 LED Strip Development

Project Context

Development Workflow

Project Structure

Arduino Architecture

LED Strip Considerations

Code Modifications

Common Tasks

Important Notes

Reviews (0)