nunogbento / led-lightpainter Goto Github PK

Forked from the great work from TheMasterFX. Adapted to use an esp32 board with OLED and touch buttons.

A DIY Pixelstick clone for Light Painting using the ESP32 and a WS2812 Strip (Neopixel)

Light painting is a technique to paint different patterns on a long exposure photograph by using a moving light source like a flashlight or in this case an WS2812 LED Strip. This project uses a cheap ESP32 based Microcontroller board with OLED (heltec_wifi_kit_32) and an addressable WS2812 based LED strip.

• Direct BMP support, no special conversion tools are needed. Just upload your 24 Bit BMP.
• The images are stored on the internal SPI-Flash in the SPIFFS Filesystem
• The images can be uploaded via Webinterface
• All configurations such as STA/AP Mode, number of LEDs, Pin for dataline of LED, Trigger-Pin, Image selection and time for each image row to be displayed are also be done in via Webinterface
• Automatic fallback to AP-Mode when the configured Wifi Station couldn't be connected
• Fallback to AP when trigger button is pressed on Bootup
• DeepSleep after 2 minutes of inactivity
• Uses touch button features of esp32 for wakeup from deep sleep and trigger.

• Open the project in PlatformIO. Edit the platformio.ini to match your board.
• Edit the configuration initialization according to your settings (Config configuration = ....) or leave it as it is.
• Compile the Firmware and upload to your controller.
• Put your images to the data-folder of the project (or leave it as it is) and select "Upload SPIFFS image" to make the SPIFFS Filesystem ready.

• Adafruit NeoPixel
• ArduinoJson
• [ESP8266_SSD1306] (https://github.com/ThingPulse/esp8266-oled-ssd1306)
• BMP drawing code is based on Bodmer's TFT_HX8357 example

• If you have not changed your settings in the source code, the controller will start in AP Mode after 10 Seconds since it couldn't connect to the default Station. After 10-15 Seconds connect to the AP "LED_PainterAP" with the password "ledpainter" and go to the url http://192.168.4.1/config in your browser. Else go to http://esp8266.local/config or if this doesn't work to the IP which your ESP8266 got from your AP.
• Now set your configuration
• The line time is the time each pixelline is displayed in milliseconds. Start with 20ms (which means an image with 500 px width takes 10 seconds to display).
• Click on Store to save the Settings permanent to the SPIFFS (as config.json) or click on Set Temporarily to store the settings in RAM.
• Attention: LED Pin and Trigger Pin values are the integer values behind the Arduino Pin defines.

Before you upload an image to LED-Painter you have to generate an image with an image edititor of your choice.

• You have to rotate the image by 90° so that the bottom pixel row of the image is the first line to draw.
• Make sure the image width (after rotation) is the same as the number of LEDs you have (e.g. 60 for a 60 LED strip)
• Make sure you save the image as 24 Bit BMP.

• Go to your LED-Lightpainters IP (e.g. http://192.168.4.1/upload) to upload a file.
• Go to the configuration page http://192.168.4.1/config and click on browse to select the image. You will see a preview after selecting the image in the selection box. Click on Select to save. On the next page you may chose Store to save the selection in SPIFFS (only needed when you want to reboot but keep the image as default)

Note: you can upload any file you want, but only bmp is displayed on the image selection page