MicroTree

This project was born as a LED installation meant to be put in a tree, hence the name of the project. It has later evolved to be a framework for building animations that can be controlled from touchOSC. It is based on the PJRC Teensy microcontroller (tested with Teensy 3.2 and 3.6 so far) in combination with the PJRC octo adaptor. An ESP8266 receives OSC packets via UDP over WIFI, and relays the OSC packets to the Teensy in order to control variables, and switch between animations. The FastLED library is used to control the LEDs.

I am trying to structure the project so that main.cpp, utility_function.cpp, osc.cpp, + their respective header files form the core. If I want to build in a new function or program I add it as a separate .cpp and .h to keep things tidy. Each program should have all the necessary function to manipulate it's program specific parameters in the same file as the program. When I add a new program I also add a new "enum program" in main.h, and a new case for the program in the updateLEDs function in utility_functions.cpp. Some variables are global and all programs use them. Like hue1, hue2, saturation1, saturation2, value1, value2, and some others. The idea is that I only need to define the funtions for manipulating them once, OSC messages can activate these functions, and when I add a new program I often don't have to add a lot of controls in TouchOSC because they are already there.

Getting Started

Install the Teensy Loader
Install VS Code
Install the PlatformIO IDE plugin in VS Code
In the PIO Home tab click Projects -> Add Existing and then navigate to this folder
Click the PlatformIO tab (Alien Icon) on the far left of the vscode window. From here you can build and upload to the Teensy.

Wiring diagram

This wiring diagram is from my last installation of this project. I used 2x 100A, 5V PSUs, 16x 5m WS2812b LED strips (150 pixels pr strip), Teensy 3.6 with OCTOWS adaptor, and Wemos D1 mini (ESP8266).

Future goals

Document my code better. So other people can understand it, use it, and contribute to it
Document the hardware setup
Document the TouchOSC setup
Upload the code for the ESP to GIT
Add more cool programs and functionality!
- I want a program the lets me mix other programs toghether like a DJ mixes songs together
- ~~Fireworks effect~~
Think out better solutions for the physical connecting and setup of all the equipment
- Better connection box. Preferably water proof
- Easy power connection plugs on everything

Some example videos

https://www.youtube.com/watch?v=s0cHIyjrVMI
https://www.youtube.com/watch?v=oguy4mDjrlk&t=1s

Patch notes

2019-09-13 - Wiring diagram
- Added wiring diagram from my latest installation of the project
2019-08-30 - Program Fireworks
- Finished the first working version of Program Fireworks. I want to make some improvements to it, but for now it's going to stay like this
2019-08-18 - LED order array
- Added a new function in utility_functions.cpp: void generate_led_order_array(led_order order)
  This function fills the array led_order_array[] with a LED order depending on the specified order.
  So far four orders are defined: NORMAL, EVERY_SECOND_STRIP_REVERSED, EVERY_STRIP_REVERSED, and STRIPS_IN REVERSE_ORDER.
- Existing programs is rewritten to use led_order_array[] to reference pixels
  Example: what used to be leds[i] = CRGB::White; is now instead leds[led_order_array[i]] = CRGB::White;

harald25 / MicroTree