Starting with the actual game \o/

This commit is contained in:
Andreas committed 2026-04-13 16:24:55 +02:00
1 parent 66e5a8c120
commit f5236476ed
8 files changed
+132395 -257

No files matched your search

+185
View File
@@ -0,0 +1,185 @@
# Exploring Uncertainties
An interactive Arduino installation using 12 push buttons and a 240-LED thermometer strip. Players answer 4 questions by pressing buttons; correct answers cool the thermometer down, wrong answers heat it up. Getting all 4 right brings the temperature to zero and triggers a rainbow win animation.
---
## Hardware
| Component | Details |
|---|---|
| Microcontroller | Arduino Uno |
| LED strip | WS2812B, 60 LEDs/m, 5V — 4 strips of 60 connected in series (240 LEDs total) |
| Buttons | 12× momentary push buttons (IP65 aluminium, 19 mm, 1NO) |
| Reset button | 1× additional momentary button (on A1) |
| Power | External 5V PSU for LED strip; USB powers the Arduino |
## Wiring Summary
See [Wiring.md](Wiring.md) for full details and diagrams.
| Component | Arduino pin |
|---|---|
| LED strip data | A0 (= digital pin 14) |
| Button 1 (Q1-A) | D2 |
| Button 2 (Q1-B) | D3 |
| Button 3 (Q1-C) | D4 |
| Button 4 (Q2-A) | D5 |
| Button 5 (Q2-B) | D6 |
| Button 6 (Q2-C) | D7 |
| Button 7 (Q3-A) | D8 |
| Button 8 (Q3-B) | D9 |
| Button 9 (Q3-C) | D10 |
| Button 10 (Q4-A) | D11 |
| Button 11 (Q4-B) | D12 |
| Button 12 (Q4-C) | D13 |
| Reset button | A1 (= digital pin 15) |
All buttons wired with `INPUT_PULLUP`: connect each button between its pin and GND. LOW = pressed.
---
## Game Rules
- **4 questions**, each answered by 3 physical buttons: 1 correct, 1 half-correct, 1 wrong.
- The LED strip acts as a **thermometer** starting at the midpoint (4 of 8 sections lit).
| Button type | LED feedback | Temperature |
|---|---|---|
| Correct | Blinks **green** | −1 section |
| Half-correct | Glows **orange/yellow** | +1 section |
| Wrong | Blinks **red** | +1 section |
- You can change an answer at any time by pressing a different button in the same group.
- **Win condition**: all 4 correct answers selected → thermometer reaches 0 → rainbow win animation plays.
- Press the **reset button** (A1) at any time to reset all answers and return the thermometer to the midpoint.
---
## Folder Structure
```
ExploringUncertanties/
├── README.md ← this file
├── Wiring.md ← full wiring diagrams and pin assignments
├── game.md ← game design notes (Ilo's spec)
├── hardware.md ← hardware specs and purchase links
├── einkaufsliste.md ← shopping list
├── ExploringUncertanties.ino ← MAIN SKETCH — upload this to the Arduino
├── LEDStrip/
│ ├── test/
│ │ └── test.ino ← LED strip test / setMirroredLED reference implementation
│ └── betterwinanimation-only.ino ← standalone win animation prototype
└── button_test/
└── button_test.ino ← standalone button wiring test
```
**The sketch to upload is `ExploringUncertanties.ino` in the project root.**
---
## For Claude
This section captures the full technical context so future conversations can pick up without re-reading every file.
### LED strip physical layout
Four 60-LED WS2812B strips are connected end-to-end, alternating direction (snake pattern), giving 240 physical LEDs total. The data pin is A0 (Arduino digital pin 14).
The strips form two mirrored pairs:
```
Strip A leds[0..59] → forward (bottom to top)
Strip B leds[119..60] → reversed (top to bottom) — mirrors strip A
Strip C leds[120..179] → forward (bottom to top) — mirrors strip A
Strip D leds[239..180] → reversed (top to bottom) — mirrors strip D
```
Because of this layout, `setMirroredLED(i, color)` is the **only** function you should call to set LEDs. It writes to all four physical positions at once so all strips show the same image:
```cpp
void setMirroredLED(int i, CRGB color) {
// i ranges 0..59 (BASE_LEDS - 1)
leds[i] = color; // Strip A
leds[119 - i] = color; // Strip B (reversed)
leds[120 + i] = color; // Strip C
leds[239 - i] = color; // Strip D (reversed)
}
```
Never write to `leds[]` directly — always go through `setMirroredLED`.
### Thermometer model
| Constant | Value | Meaning |
|---|---|---|
| `BASE_LEDS` | 60 | Total logical positions (0–59) |
| `NUM_SECTIONS` | 8 | Thermometer sections |
| `LEDS_PER_SECTION` | 7 | LEDs per section |
| `ACTIVE_LEDS` | 56 | 56 thermometer positions; i=0–3 always off (physical bottom), i=4–59 active |
| `LED_BOTTOM_OFFSET` | 4 | Bottom 4 LEDs always off; thermometer starts at i=4 |
| `BASELINE_SECTIONS` | 4 | Starting state (midpoint) |
Color gradient: **blue** (i = 4, cold) → **red** (i = 59, hot) via `blend(CRGB(0,0,180), CRGB(180,0,0), pos)`. Positions 0–3 are always black (physical bottom of the strip).
Active LEDs (below the current temperature level) are rendered at `BRIGHT_BRIGHTNESS`. Inactive LEDs (above) are rendered at `DIM_BRIGHTNESS` — still colored, so the full gradient is always visible.
### Game state
```cpp
int selectedAnswer[4]; // per question: -1 = no answer, 0/1/2 = button index within group
int tempSections; // current lit sections (0–8)
bool gameWon;
```
`tempSections = BASELINE_SECTIONS + wrong_count - correct_count`, clamped to [0, 8].
Win = all 4 `selectedAnswer[q] == CORRECT_ANSWER[q]`.
### Button mapping
```
buttonIdx = question * 3 + answerWithinGroup
question = buttonIdx / 3 (0..3)
answer = buttonIdx % 3 (0..2)
```
Correct answers are configured in `CORRECT_ANSWER[4]` — update these when the actual questions are finalised.
### Answer type system
Each question has three button types: `ANSWER_CORRECT`, `ANSWER_HALF`, `ANSWER_WRONG`.
In `ExploringUncertanties.ino`, find:
```cpp
const int CORRECT_BUTTON[NUM_QUESTIONS] = {0, 1, 2, 0};
const int HALF_BUTTON[NUM_QUESTIONS] = {1, 2, 0, 1};
```
Each value (0, 1, or 2) is the button index within that question's group. The remaining button is automatically `ANSWER_WRONG`. Update both arrays when the content is finalised.
`getAnswerType(question, button)` returns the `AnswerType` enum value for any button press.
### Feedback animations
| Type | Animation | Temp effect |
|---|---|---|
| `ANSWER_CORRECT` | Green blink × 3 | −1 section |
| `ANSWER_HALF` | Orange/yellow steady glow (700 ms) | +1 section |
| `ANSWER_WRONG` | Red blink × 3 | +1 section |
After any feedback animation, the thermometer is immediately redrawn before the slide animation runs.
### Win animation
Rainbow HSV sweep forward then backward across all 60 logical positions (using `setMirroredLED`). Plays in a loop until the reset button is pressed.
### FastLED setup
```cpp
FastLED.addLeds<WS2812, DATA_PIN, RGB>(leds, NUM_LEDS);
FastLED.setBrightness(84);
```
Note: the strip is WS2812 (not WS2812B) with `RGB` color order — this matches `test.ino`. If colors look wrong, try `GRB`.