Skip to content

hobzcalvin/blume

Repository files navigation

Blume LED Controller

A flexible LED controller for ESP32 that supports Bluetooth Low Energy (BLE) communication and various LED patterns.

Features

  • BLE control interface
  • Support for WS2812/APA102 LED strips
  • Multiple display modes and patterns
  • Text display mode
  • Demo mode with saved presets
  • Configurable dimensions and LED layout

Hardware Requirements

  • ESP32 development board
  • WS2812 or APA102 LED strips
  • Power supply (5V, sufficient for your LED count)

Software Setup

Option 1: Using PlatformIO (Recommended)

  1. Install PlatformIO
  2. Clone this repository
  3. Open the project in PlatformIO
  4. Build and upload to your ESP32

Option 2: Using Arduino IDE

  1. Install Arduino IDE
  2. Install ESP32 board support:
    • Open Arduino IDE
    • Go to File > Preferences
    • Add https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_index.json to Additional Boards Manager URLs
    • Go to Tools > Board > Boards Manager
    • Search for "esp32" and install "ESP32 by Espressif Systems"
  3. Install required libraries:
    • FastLED (3.6.0 or later)
    • Adafruit GFX Library (1.11.5 or later)
    • Adafruit BusIO (1.14.1 or later)
  4. Open blume.ino in Arduino IDE
  5. Select your ESP32 board from Tools > Board
  6. Build and upload

Configuration

The project can be configured through build flags in platformio.ini or by modifying the defines in the code:

  • WIDTH and HEIGHT: Physical dimensions of your LED matrix
  • NUM_LEDS: Total number of LEDs
  • CHIPSET: LED type (WS2812 or APA102)
  • DATA_PIN_0, DATA_PIN_1, CLOCK_PIN_0, CLOCK_PIN_1: Pin assignments
  • MAX_MILLIAMPS: Maximum current draw
  • BLUETOOTH_NAME: Name of the BLE device

Usage

  1. Power on the ESP32
  2. Connect to the BLE device named "Blume" (or your configured name)
  3. Send commands through the BLE interface:
    • !D: Request dimensions
    • !d: Demo mode commands
    • Other commands as documented in the code

License

[Add your license information here]

About

Cross-platform bluetooth control of LEDs

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published