Echoes of Tomorrow - Toppiece Firmware

This repository contains the embedded firmware for the microcontrollers that operate the toppiece in the Echoes of Tomorrow GLOW 2025 project.

Overview

• Written in C++
• Compiled and uploaded to microcontrollers (ESP32 S3)
• Receives when the climax starts
• Receives when the climax is over

Project Structure

arm/
├── firmware/           # C++ firmware source
├── tests/              # Diagnostic sketches/tests
└── documentation/      # Schematics and setup guides

Setup Instructions

1. Open firmware/top.ino in the Arduino IDE
2. Select the correct board (ESP32 doit devkit)
3. Upload to the connected board

Testing

Diagnostic sketches are in tests/

Documentation

See documentation/ or the Wiki for details on architecture, function descriptions, and setup.

Branches

• main: Production-ready code
• develop: Active development
• feature/<name>, bugfix/<name>, hotfix/<name>: Use Git Flow

Commit Convention

<type>: <short description>

Example: fix: LED flickering on pin 6