Bluetooth LED Control Project BLE Arduino ESP32 App

Build a complete Bluetooth Low Energy (BLE) project that lets you control RGB LEDs from your smartphone. This hands-on project demonstrates core BLE concepts including GATT services, characteristics, advertising, and low-power wireless communication.

Project Overview and Objectives

The primary learning goal here is not just making an LED glow — it is understanding the wireless protocol stack that makes the communication possible. Every smartphone interaction with a BLE device follows the same architecture we will implement.

Understanding BLE Architecture

Before we start building, let us understand the BLE communication model. BLE operates very differently from classic Bluetooth. While classic Bluetooth maintains a continuous connection (like a phone call), BLE works in short bursts (like sending text messages). This is why your fitness tracker battery lasts months instead of hours.

BLE Protocol Stack

BLE uses a layered architecture. At the bottom, the Physical Layer operates in the 2.4 GHz ISM band, using 40 channels with 2 MHz spacing. Above that, the Link Layer handles advertising, scanning, and connection management. The most important layer for our project is the Generic Attribute Profile (GATT), which defines how data is organized and exchanged.

GATT Structure Explained

GATT organizes data in a hierarchical structure. Think of it like a filing cabinet. A Profile contains one or more Services (like drawers in the cabinet). Each Service contains Characteristics (like folders in the drawer). Each Characteristic holds actual data values (like documents in the folder).

Hardware Circuit Design

Components Required

Circuit Connections

The RGB LED has four pins: one common cathode (ground) and three anodes for Red, Green, and Blue. Each anode connects through a 220Ω current-limiting resistor to an ESP32 GPIO pin. We use GPIO 25 for Red, GPIO 26 for Green, and GPIO 27 for Blue. The common cathode connects directly to ESP32 GND.

The current limiting resistor is essential. Without it, the LED would draw excessive current and potentially damage both the LED and the ESP32 GPIO pin. At 3.3V with a 220Ω resistor, each channel draws approximately 15mA, which is well within the ESP32's 40mA per-pin limit.

Software Implementation

Arduino IDE Setup

First, install the ESP32 board package in Arduino IDE. Go to File → Preferences → Additional Board Manager URLs and add the Espressif URL. Then install "ESP32 by Espressif Systems" from the Board Manager. Select "ESP32 Dev Module" as your board.

BLE Server Code Structure

The code creates a BLE server on the ESP32 that advertises itself and waits for a phone to connect. Here is the logical flow:

1. Initialize BLE — Set device name and create server
2. Create Service — Define our custom LED Control service with its UUID
3. Add Characteristics — Create Color, Power, and Brightness characteristics with Read/Write properties
4. Start Advertising — Begin broadcasting so phones can discover us
5. Handle Callbacks — When phone writes new values, update the LED accordingly

Key Code Concepts

The BLE library uses callback classes to handle events. When a client (your phone) writes a new color value to the Color characteristic, the onWrite callback fires. Inside this callback, we parse the three bytes (R, G, B) and apply them to the LED using PWM (Pulse Width Modulation) via the analogWrite function.

PWM is crucial here because LEDs are either ON or OFF — there is no "half brightness" in hardware. PWM rapidly switches the LED on and off. A 50% duty cycle means the LED is on half the time, appearing at 50% brightness to our eyes. The ESP32 supports 8-bit PWM resolution, giving us 256 brightness levels (0-255) per color channel.

BLE Communication Flow

Here is what happens when you tap a color on your phone:

1. Phone scans — Discovers ESP32 advertising as "LED_Controller"
2. Connection established — Phone becomes the Central, ESP32 is the Peripheral
3. Service discovery — Phone reads the GATT table to find available services
4. Write operation — Phone writes RGB values [255, 0, 128] to Color characteristic
5. Callback triggered — ESP32's onWrite function executes
6. LED updates — PWM outputs change, LED displays purple (Red + Blue mix)

The entire process from tap to LED color change takes approximately 7.5 milliseconds on BLE 5.0 — faster than human perception.

Wireless Concepts Demonstrated

Testing with nRF Connect App

The nRF Connect app (by Nordic Semiconductor) is the best tool for BLE development. After uploading code to ESP32, open nRF Connect on your phone. You will see "LED_Controller" in the scan results. Tap Connect, then navigate to the custom service. You can write hex values directly to characteristics.

For example, writing FF0000 to the Color characteristic should turn the LED pure red. Writing 00FF00 gives green, and 0000FF gives blue. Writing FF00FF produces magenta through additive color mixing.

Troubleshooting Common Issues

Extensions and Improvements

Once the basic project works, consider these enhancements to deepen your learning:

• Custom mobile app — Build an Android app with MIT App Inventor or Flutter that shows a color wheel
• Multiple LEDs — Control an LED strip using WS2812B addressable LEDs
• Animations — Add a characteristic for pattern selection (breathing, rainbow, strobe)
• Security — Implement BLE pairing with passkey authentication
• Power optimization — Add deep sleep mode when no client is connected for 5 minutes

Key Takeaways

1. BLE operates fundamentally differently from classic Bluetooth — designed for low power, intermittent data transfer
2. GATT provides a standardized way to organize and exchange data between BLE devices
3. The Central (phone) initiates connections; the Peripheral (ESP32) advertises and waits
4. Frequency hopping across 40 channels provides robustness against interference
5. PWM enables smooth brightness control despite LEDs being binary (on/off) devices
6. BLE 5.0 supports data rates up to 2 Mbps, but our project needs minimal bandwidth
7. The same architecture powers commercial products like smart bulbs, fitness trackers, and wireless sensors