Skip to content

Add WLEDTubes documentation and development plan#61

Open
theysayheygreg wants to merge 307 commits intoSteveEisner:mainfrom
theysayheygreg:docs/wledtubes-planning
Open

Add WLEDTubes documentation and development plan#61
theysayheygreg wants to merge 307 commits intoSteveEisner:mainfrom
theysayheygreg:docs/wledtubes-planning

Conversation

@theysayheygreg
Copy link

Summary

  • Add comprehensive architecture documentation (WLEDTubes.md)
  • Add development roadmap and planning doc (WLEDTubes_Plan.md)

Documentation Included

WLEDTubes.md - Architecture documentation covering:

  • WLED basics and software stack
  • PlatformIO configuration
  • Tubes usermod components and structure
  • Mesh network protocol (ESP-NOW)
  • Beat synchronization system
  • 3-layer effect composition
  • Device roles and modifications from standard WLED

WLEDTubes_Plan.md - Development roadmap including:

  • Project goals and phases
  • Hardware support (ESP32-S3, ESP32-C3, QuinLED, custom PCB)
  • Remote control design (button-based ESP32 controller with full protocol spec)
  • Pattern library expansion plans
  • Custom web UI design
  • Implementation milestones

Test plan

  • Markdown renders correctly on GitHub
  • Review for accuracy against existing codebase

🤖 Generated with Claude Code

craiglink and others added 26 commits August 19, 2024 13:41
restart ESPNOW after WiFi AP stopped
out WLED_RELEASE_NAME macro to info json
and reset the wifi after update
- WLEDTubes.md: Architecture documentation covering WLED basics,
  Tubes usermod structure, mesh networking, and system design
- WLEDTubes_Plan.md: Development roadmap including hardware targets,
  feature roadmap (remote control, patterns, web UI), and milestones

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Single press: Toggle LED strip on/off
- Double press: Switch to next pattern (stays synced with mesh)
- Long press (1-5s): Activate WLED WiFi AP mode

Removes power save toggle from long press in favor of WiFi AP
activation for easier device configuration.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Features:
- New warm lamp pattern (2700K white with organic shimmer)
- Double-press button toggles between lamp mode and rave mode
- Lamp mode ignores mesh sync to stay independent
- When switching back to rave, picks fresh random pattern

Button behavior:
- Single press: Toggle on/off
- Double press: Toggle lamp/rave mode
- Long press: WiFi AP mode

Files changed:
- pattern.h: Added warmLamp() and warmLampGentle() patterns
- controller.h: Added lamp_mode state, toggle methods, renderLampMode(),
  and sync bypass when in lamp mode
- Tubes.h: Updated button handler for mode switching

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Add development log for Jan 11 session (firmware flash, gateway fix)
- Add 5 new ESP32 boards to target platforms:
  - Waveshare ESP32-S3-Audio (recommended, multi-button)
  - ESP32-S3-BOX-Lite (3 buttons, LCD)
  - Adafruit Sparkle Motion (WLED-native, 4 outputs)
  - SMLIGHT SLWF-03 (pre-flashed, sensor button)
  - ATHOM Sound Reactive (relay, dual output)
- Add detailed board configurations with GPIO mappings
- Add PlatformIO environment configs for each board
- Add multi-button hardware interface tasks
- Add state machine logic for OFF/LAMP/RAVE/CONFIG modes
- Add single-button fallback for boot-button-only boards

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@SteveEisner SteveEisner force-pushed the main branch 4 times, most recently from f9fe4a9 to c24da10 Compare February 21, 2026 09:06
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants