|
1 |
| -# LED-Controller-Kit |
| 1 | +# LED Controller |
| 2 | + |
| 3 | +A user-friendly LED controller that allows you to control each individual LED on an LED strip, set static colors, or play animations. This controller is based on an ESP8266 or ESP32 microcontroller and connects via Wi-Fi. |
| 4 | + |
| 5 | +## Features: |
| 6 | + |
| 7 | +* Control each individual LED on the strip |
| 8 | +* Set static colors for the entire strip |
| 9 | +* Play animated lights and effects |
| 10 | +* Flexibility in LED arrangement (customized to the number and position of LEDs) |
| 11 | + |
| 12 | +## Prerequisites: |
| 13 | + |
| 14 | +* **Arduino IDE** or **VSCode with PlatformIO Extension** |
| 15 | +* **Adafruit NeoPixel Library** for controlling the LEDs |
| 16 | +* **Wi-Fi connection** to control LEDs remotely |
| 17 | + |
| 18 | +## Setup: |
| 19 | + |
| 20 | +### 1. Install Arduino IDE or PlatformIO: |
| 21 | + |
| 22 | +* Download **[Arduino IDE](https://www.arduino.cc/en/software)**, or |
| 23 | +* Install **[PlatformIO](https://platformio.org/)** as an extension in **VSCode**. |
| 24 | + |
| 25 | +### 2. Open the `main.cpp` file: |
| 26 | + |
| 27 | +* Open the file in either **Arduino IDE** or **VSCode with PlatformIO**. |
| 28 | + |
| 29 | +### 3. Install the required library: |
| 30 | + |
| 31 | +* Download the **Adafruit NeoPixel Library** for Arduino IDE or PlatformIO: |
| 32 | + |
| 33 | + * **Arduino IDE**: Go to **Sketch > Include Library > Manage Libraries**, search for "Adafruit NeoPixel" and install it. |
| 34 | + * **PlatformIO**: Add the following line to your `platformio.ini` file: |
| 35 | + |
| 36 | + ```ini |
| 37 | + lib_deps = Adafruit NeoPixel |
| 38 | + ``` |
| 39 | + |
| 40 | +### 4. Restart your IDE: |
| 41 | + |
| 42 | +* Close and reopen Arduino IDE or VSCode to ensure the library loads correctly. |
| 43 | + |
| 44 | +### 5. Configure your Wi-Fi and LED strip settings: |
| 45 | + |
| 46 | +* Replace the placeholders in `main.cpp` with your own details: |
| 47 | + |
| 48 | + ```cpp |
| 49 | + const char* ssid = ""; // (line 16) |
| 50 | + const char* password = ""; // (line 17) |
| 51 | + #define LED_PIN 2 // (line 20) |
| 52 | + #define NUM_LEDS 60 // (line 21) |
| 53 | + ``` |
| 54 | + |
| 55 | + * Set `ssid` to your Wi-Fi network name and `password` to your Wi-Fi password. |
| 56 | + * Make sure `LED_PIN` is set to the correct pin where your LED strip is connected, and `NUM_LEDS` matches the number of LEDs in your strip. |
| 57 | + |
| 58 | +### 6. Upload the code to your Arduino: |
| 59 | + |
| 60 | +* Connect your microcontroller (ESP8266 or ESP32) to your computer. |
| 61 | +* Upload the code by clicking **Upload** in Arduino IDE or PlatformIO. |
| 62 | + |
| 63 | +--- |
| 64 | + |
| 65 | +## Usage: |
| 66 | + |
| 67 | +### 1. Download and Setup: |
| 68 | + |
| 69 | +* Download the executable file `main.exe` from this repository. |
| 70 | +* Create a folder on your computer, for example: `C:/LED-Controller`. |
| 71 | +* Copy the downloaded `main.exe` into that folder. |
| 72 | + |
| 73 | +### 2. Connect the Arduino and LED strip: |
| 74 | + |
| 75 | +* Connect the microcontroller and the LED strip. |
| 76 | +* Ensure the LED strip is powered on. |
| 77 | + |
| 78 | +### 3. Launch the application: |
| 79 | + |
| 80 | +* Run `main.exe`. |
| 81 | +* Your LEDs should now be controllable via Wi-Fi. |
| 82 | + |
| 83 | +### 4. Control: |
| 84 | + |
| 85 | +* **Individual LED Control**: You can control each LED on the strip individually, creating various colors and effects. |
| 86 | +* **Static Colors**: Set a static color for the entire strip. |
| 87 | +* **Animations**: Play different light effects and animations, which can be adjusted via the Wi-Fi control program. |
| 88 | + |
| 89 | +--- |
| 90 | + |
| 91 | +## Notes: |
| 92 | + |
| 93 | +* Make sure your microcontroller is powered adequately, especially when using a large number of LEDs. |
| 94 | + |
| 95 | +--- |
| 96 | + |
| 97 | +## Enjoy controlling your LEDs! |
| 98 | + |
2 | 99 |
|
0 commit comments