LED / Strip
Controlling RGB LED Module LED / Strip with Espressif ESP32
What is the RGB LED Module?
RGB LED Module practical reference
A basic 4-pin RGB LED breakout used for teaching PWM color mixing and simple status-indicator projects.
Key specifications
- Type: Common-cathode on most breakout modules (common-anode variants also exist — verify with a multimeter before wiring)
- Forward voltage: ~2V (Red), ~3.2V (Green), ~3.2V (Blue), typical
- Control: 3 independent PWM channels, one per color, each through its own current-limiting resistor
- Current-limiting resistor: ~220Ω-330Ω per color channel at 5V logic — a shared value across R/G/B works fine even though forward voltages differ slightly
Pinout and connection notes
On a common-anode module, drive each color LOW to turn it on rather than HIGH — inverted from the common-cathode wiring most beginner tutorials assume.
- R: Red channel — through a current-limiting resistor to a PWM pin
- COM: Common cathode (to GND) or common anode (to VCC), depending on your specific module
- G: Green channel — through a current-limiting resistor to a PWM pin
- B: Blue channel — through a current-limiting resistor to a PWM pin
Integration checklist
- Confirm the exact part number and breakout-board revision.
- Verify supply voltage, current demand, logic levels, and signal direction against the datasheet.
- Check controller pin assignments and bus address or interface mode against the example code.
- Power up with external loads disconnected, then test signals before full integration.
- If readings or communication fail, check power and ground first, then pin mapping, interface settings, and library initialization.
Troubleshooting and reproducibility
Record the board used, wiring, library/version, supply arrangement, and measured behavior. Use the selected board-specific wiring example as the source of truth. Never assume visually similar modules share identical voltage tolerance or pin order.
Setting Up RGB LED Module with Espressif ESP32
Wiring
| Component pin | Espressif ESP32 pin | Note |
|---|---|---|
| R | GPIO25 (through a ~220Ω resistor) | |
| G | GPIO26 (through a ~220Ω resistor) | |
| B | GPIO27 (through a ~220Ω resistor) | |
| COM | GND | Assumes common-cathode |
Swipe sideways to see every column →
- ESP32 PWM goes through the LEDC peripheral (ledcSetup/ledcAttachPin/ledcWrite) rather than analogWrite() — each color needs its own LEDC channel, as shown.
- Same common-cathode-vs-anode verification and color-balance caveats as the Arduino Uno.
- 5kHz PWM frequency avoids visible flicker and any audible whine some people notice at lower PWM frequencies with LEDs.
Related Components
Related Guides & Projects
MicroPython vs Arduino on ESP32: Which Should You Learn First?
An honest comparison for beginners: where MicroPython is easier, where Arduino C++ is faster, how libraries and memory differ, and how to choose based on your project instead of hype.
MicroPython ESP32 Web Server: Control an LED or Relay from Your Browser
Create a working web server with the socket module, parse requests, serve a responsive control page for an LED or a relay, keep the displayed state truthful, choose a safe relay startup state and make the server survive bad or repeated requests.
MicroPython on ESP32 and Raspberry Pi Pico W: The Complete Guide
A structured MicroPython learning path for ESP32 and Pico W. Set up your tools, control GPIO, read sensors, connect to WiFi, build web servers, publish MQTT data and make projects reliable. Start here, then follow the links by level.
boot.py vs main.py in MicroPython: What Runs, When and Why
Understand the difference between boot.py and main.py in MicroPython, startup order, Wi-Fi setup, project structure, and recovery from boot errors.