Yottabits · domiko96 · Aug 6, 2026 · Aug 6, 2026 · Aug 8, 2026 · Aug 8, 2026
diff --git a/.gitignore b/.gitignore
@@ -0,0 +1 @@
+.DS_Store
diff --git a/Makefile b/Makefile
@@ -0,0 +1,35 @@
+# Top-level convenience targets wrapping PlatformIO (software/) and the
+# doc-gif generation pipeline (tools/gifgen/).
+
+PIO := pio
+PIO_ENV := esp12e
+SOFTWARE_DIR := software
+
+.PHONY: build upload uploadAndMonitor uploadOTA doc-gifs
+
+build:
+	cd $(SOFTWARE_DIR) && $(PIO) run -e $(PIO_ENV)
+
+upload: build
+	cd $(SOFTWARE_DIR) && $(PIO) run -e $(PIO_ENV) -t upload
+
+uploadAndMonitor: build
+	cd $(SOFTWARE_DIR) && $(PIO) run -e $(PIO_ENV) -t upload -t monitor
+
+# Flash a board over WiFi via ArduinoOTA. Prompts for the target device's MAC
+# address rather than an IP, since the board's OTA hostname is derived from
+# its MAC (see initOTA() in src/main.cpp) and mDNS (.local) resolution finds
+# it regardless of its current DHCP-assigned IP.
+uploadOTA: build
+	@read -p "Enter device MAC address (e.g. 84:F3:EB:B7:09:A5): " mac; \
+	host="espled-$$(echo "$$mac" | tr -d ':')"; \
+	auth=$$(grep -oE 'OTA_PASSWORD *"[^"]*"' $(SOFTWARE_DIR)/config/device_config.h | grep -oE '"[^"]*"' | tr -d '"'); \
+	if [ -z "$$auth" ]; then \
+		echo "OTA_PASSWORD not found in $(SOFTWARE_DIR)/config/device_config.h - see config/device_config.h.example"; \
+		exit 1; \
+	fi; \
+	echo "Flashing $$host.local ..."; \
+	cd $(SOFTWARE_DIR) && PLATFORMIO_UPLOAD_PROTOCOL=espota PLATFORMIO_UPLOAD_PORT=$$host.local PLATFORMIO_UPLOAD_FLAGS="--auth=$$auth" $(PIO) run -e $(PIO_ENV) -t upload
+
+doc-gifs:
+	python3 tools/gifgen/generate.py
diff --git a/Readme.md b/Readme.md
@@ -61,25 +61,12 @@ Software:
 ## Which parts do I need?
 See the Bill-Of-Materials file named ESPLED.csv in the hardware folder.
 
-## Suggested MODES
-
-| Modenumber   |        Name      | Description | used-Arguments-from-Var-Silo|
-|--------------|------------------|-------------|-----------------------------|
-|1|  Fade to color   |  Also used for jumps -> time = 0           | RGBWW-value, Transitiontime |
-|2|  Blink color     |  Stores current State, Fades to color and back - Maybe posibility of selectiong number of blinks | RGBWW-value, Transition time, OnTime, NumOfBlinks |
-|3|Strobe|Strobe selectable color and Freq|RGBWW-value, Freq |
-|4|Sound2LIGHT|adjust brightness according to soundvalue|RGBWW-value, sensivitity |
-|5|Breathing|Strip turns brighter and darker periodically (some randomness) |RGBWW-value, frequency how often it should "breath"|
-|6|TempVis|Visualizes Temperatur Value of Temp Sensor - Cold(Blue)<>Normal(Green)<>Hot(Red)||
-|7||||
-|8||||
-|101|Lagerfeuer Animation|(gibt es online fertig)|centerposition|
-|102|Noise||RGBWW,update Rate|
-|103|VU-Meter|| RGbWW, Sensitivity, update rate, centerposition|
-|104|StrobeParts|Small x-LED long "Parts" light up in strobe mode|RGBWW, Freq, centerposition, PartLength|
-|105|Moving Parts|Small x-LED long "Parts" travel from centerpos(=Startpos) - to the end(s) of the strip|RGBWW-value, update rate, centerposition, |
-|106|American Police Light|red/blue left/right (half of adress room) flash|update rate|
-|107|Rainbow|fills strip with rainbow maybe moves it||
+## Supported MODES
+
+The full, up-to-date list of supported modes — numbers, parameters, JSON examples, and animated
+previews — lives in [`software/README.md`](/software/README.md#modes), generated directly from
+the actual firmware source. This section used to duplicate that table as a pre-implementation
+design sketch; it's been removed here to avoid the two drifting out of sync.
 
 
 ## nice Projects with led animations for insperation

diff --git a/doc/gifs/0000_fade2Color.gif b/doc/gifs/0000_fade2Color.gif
diff --git a/doc/gifs/0001_strobe.gif b/doc/gifs/0001_strobe.gif
diff --git a/doc/gifs/0002_breathe.gif b/doc/gifs/0002_breathe.gif
diff --git a/doc/gifs/0003_ocean.gif b/doc/gifs/0003_ocean.gif
diff --git a/doc/gifs/0004_forest.gif b/doc/gifs/0004_forest.gif
diff --git a/doc/gifs/0005_dusk.gif b/doc/gifs/0005_dusk.gif
diff --git a/doc/gifs/0006_fireFlicker.gif b/doc/gifs/0006_fireFlicker.gif
diff --git a/doc/gifs/0007_heartBeat.gif b/doc/gifs/0007_heartBeat.gif
diff --git a/doc/gifs/0050_sound2Light.gif b/doc/gifs/0050_sound2Light.gif
diff --git a/doc/gifs/0051_bassReact.gif b/doc/gifs/0051_bassReact.gif
diff --git a/doc/gifs/0100_wipe.gif b/doc/gifs/0100_wipe.gif
diff --git a/doc/gifs/0101_fire.gif b/doc/gifs/0101_fire.gif
diff --git a/doc/gifs/0102_noise.gif b/doc/gifs/0102_noise.gif
diff --git a/doc/gifs/0103_noiseRandomColor.gif b/doc/gifs/0103_noiseRandomColor.gif
diff --git a/doc/gifs/0104_nightSky.gif b/doc/gifs/0104_nightSky.gif
diff --git a/doc/gifs/0105_movingParts.gif b/doc/gifs/0105_movingParts.gif
diff --git a/doc/gifs/0106_movingBackAndForth.gif b/doc/gifs/0106_movingBackAndForth.gif
diff --git a/doc/gifs/0107_rainbowCycle.gif b/doc/gifs/0107_rainbowCycle.gif
diff --git a/doc/gifs/0108_theaterChase.gif b/doc/gifs/0108_theaterChase.gif
diff --git a/doc/gifs/0109_comet.gif b/doc/gifs/0109_comet.gif
diff --git a/doc/gifs/0110_cometBackAndForth.gif b/doc/gifs/0110_cometBackAndForth.gif
diff --git a/doc/gifs/0111_strobeParts.gif b/doc/gifs/0111_strobeParts.gif
diff --git a/doc/gifs/0112_policeLights.gif b/doc/gifs/0112_policeLights.gif
diff --git a/doc/gifs/0113_progressBar.gif b/doc/gifs/0113_progressBar.gif
diff --git a/doc/gifs/0500_vuMeter.gif b/doc/gifs/0500_vuMeter.gif
diff --git a/doc/gifs/0501_vuMeterPeak.gif b/doc/gifs/0501_vuMeterPeak.gif
diff --git a/doc/gifs/0502_spectrum.gif b/doc/gifs/0502_spectrum.gif
diff --git a/doc/gifs/1000_pixelArray.gif b/doc/gifs/1000_pixelArray.gif
diff --git a/doc/gifs/1001_blinkColor.gif b/doc/gifs/1001_blinkColor.gif
diff --git a/doc/modes_description.md b/doc/modes_description.md
diff --git a/software/.gitignore b/software/.gitignore
@@ -4,3 +4,4 @@
 .clang_complete
 .gcc-flags.json
 .vscode
+config/device_config.h