https://github.com/ivorforce/lled-wifi

ArtNET / Atmospheric LED Engine for ESP32
https://github.com/ivorforce/lled-wifi

Last synced: over 1 year ago
JSON representation

ArtNET / Atmospheric LED Engine for ESP32

• Host: GitHub
• URL: https://github.com/ivorforce/lled-wifi
• Owner: Ivorforce
• Created: 2021-07-22T23:29:05.000Z (about 5 years ago)
• Default Branch: master
• Last Pushed: 2021-07-22T23:33:08.000Z (about 5 years ago)
• Last Synced: 2025-02-09T20:18:44.085Z (over 1 year ago)
• Language: C++
• Size: 1.5 MB
• Stars: 0
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# About

This software is intended to run an LED strip using Wifi ArtNET, or just passively.

While it does support FastLED for a variety of strip types, Apa102 / SK9822 are recommended for optimal output. Here, about 100x the FPS and 32x the color accuracy can be achieved.

# Setup

Clion Recommended:

    platformio init --ide clion --board esp32dev

Relies on the flash file system for storage / static html files.

Run uploadfs as well as upload to flash the ESP32.

Take a look at Setup.h to see if it fits your build.

# Hacks

Since some stuff currently works... sub-bar, do the following steps too:

    #include   // On top of FastLED.h

    // Merge this: 

    https://github.com/5chmidti/FastLED/commit/1550a942ba69272e10e4ca56fd51dd9f074e1671

    // Set task priority to 20 in AsyncUDP.cpp

# First Run

Check the correct partition file to use and select it in the platformio.ini.

Remember to hold boot and press "EN" on the ESP to put it to flash mode. Run:

	SETUP_FILE="" bash -c "platformio run -t upload"

	SETUP_FILE="" bash -c "platformio run -t uploadfs"

It should boot up with a new WiFi. When connected, its local IP is `192.168.4.1`.

## Debug

(macOS only) To debug a message, run

    ./decode_stacktrace.sh 

which creates and deletes a temporary __dmp.txt file.

## Update

Run 

    platformio run --target upload --upload-port IP-ADDRESS

To update using a non-default setup file, create SomeSetup.h in builds/. The file will "inherit" from the default setup, so it can focus on overriding variables.

    SETUP_FILE="SomeSetup" bash -c "platformio run --target upload --upload-port IP-ADDRESS"

    

as per http://docs.platformio.org/en/latest/platforms/espressif32.html#over-the-air-ota-update.

## Factory

If reversion to factory is required, run `./otatool_proxy.py --port "/dev/ttyUSB1" erase_otadata`. This will erase OTA partitions and revert back to what was uploaded via serial.

The script is sub-par, especially with the parts provided from esp-idf, and may need be checked. It is recommended to set output from parttool not to "None" since several restarts of the device are required during running of scripts.

## Performance Considerations

Some quick tests gave the following numbers:

    nop                       : 0.004 us

    digitalRead               : 0.143 us

    digitalWrite              : 0.125 us

    pinMode                   : 2.708 us

    multiply byte             : 0.038 us

    divide byte               : 0.053 us

    add byte                  : 0.034 us

    multiply integer          : 0.054 us

    divide integer            : 0.058 us

    add integer               : 0.054 us

    mod integer               : 0.062 us

    or/and integer            : 0.054 us

    shift integer             : 0.054 us

    multiply long             : 0.055 us

    divide long               : 0.073 us

    add long                  : 0.054 us

    multiply float            : 0.055 us

    divide float              : 0.248 us

    add float                 : 0.058 us

    itoa()                    : 0.703 us

    ltoa()                    : 0.898 us

    dtostrf()                 : 11.323 us

    y |= (1<