11lein · 11lein · Aug 16, 2023 · Aug 16, 2023 · Aug 16, 2023 · Aug 17, 2023
diff --git a/.DS_Store b/.DS_Store
diff --git a/.gitignore b/.gitignore
@@ -3,3 +3,5 @@
 .vscode/c_cpp_properties.json
 .vscode/launch.json
 .vscode/ipch
+src/MP3_24
+.DS_Store
diff --git a/README.md b/README.md
@@ -0,0 +1,101 @@
+# 🚗 Soundboard für den Carbage Run
+
+## 🎯 Motivation
+
+Beim **Carbage Run** – einer Rallye mit Schrottautos – haben viele Teilnehmer Fanfaren, Megafone oder lustige Sounds abgespielt.  
+Wir hatten zwar bereits ein Megafon mit Line-In und Bluetooth, aber:
+
+> 🎛️ "Wenn ich hupen will, will ich auf einen Knopf hauen – nicht erst das Handy entsperren!"
+
+Deshalb: ein eigenständiges Soundboard mit 25 Tasten, SD-Karte und Sofortreaktion.
+
+---
+
+## 📸 Vorschau
+
+### Gehäuse (3D-gedruckt)
+
+![Soundboard Gehäuse](docu/20240531_110053.jpg)
+![Soundboard Gehäuse](docu/20240531_110109.jpg)
+![Soundboard Gehäuse](docu/20230827_103529.jpg)
+![Soundboard Gehäuse](docu/20230720_205834.jpg)
+![Soundboard Gehäuse](docu/20230727_214800.jpg)
+![Soundboard Gehäuse](docu/Screenshot_20230727-233512_Onshape.jpg)
+![Soundboard Gehäuse](docu/Screenshot_20230727-233618_Onshape.jpg)
+
+### Innenleben
+![Soundboard Elektronik](docu/20230720_202601.jpg)
+![Soundboard Elektronik](docu/20230720_220237.jpg)
+
+### Tastenmatrix in Aktion
+![Tastenmatrix](docu/Schaltung.jpg)
+
+> Alle Bilder findest du im Ordner `docu/`
+
+---
+
+## ⚙️ Features
+
+- 🎵 **25 Tasten** in 5×5 Matrix für direkte Soundauswahl
+- 🔁 **Zweifachbelegung:** Shift-Modus (Taster gedrückt halten oder Bluetooth-Befehl → Track +25)
+- 💾 **DFPlayer Mini** spielt MP3s direkt von SD-Karte
+- 📡 **Bluetooth**-Steuerung per Smartphone-App oder Terminal
+- 🧠 **ESP32** mit frei programmierbarer Logik
+- 🧰 [**3D-gedrucktes Gehäuse**](https://cad.onshape.com/documents/51f835b686c64aa4e062ca5b/w/735ce97b22fc647d3e8dc544/e/93c6d67ebc2946beec692255?renderMode=0&uiState=6890fba874e54c0f2372ca89)
+
+---
+
+## 🧠 Schaltung
+
+Erstellt in [Wokwi](https://wokwi.com) (Virtueller Schaltplan: `wokwi_project.json`)
+
+### 🔘 Tastenanschlüsse
+
+| Zeile (row) | ESP32 Pin |
+|-------------|-----------|
+| R1          | D19       |
+| R2          | D18       |
+| R3          | D5        |
+| R4          | D17       |
+| R5          | D16       |
+
+| Spalte (col) | ESP32 Pin |
+|--------------|-----------|
+| C1           | D32       |
+| C2           | D33       |
+| C3           | D25       |
+| C4           | D26       |
+| C5           | D27       |
+
+### 🎧 DFPlayer Mini Anschluss 
+Für die korrekte Verkabelung siehe
+[DFPlayer Mini Dokumentation](https://www.elektronik-kompendium.de/sites/praxis/bauteil_dfplayer-mini.htm)
+
+| DFPlayer Pin | ESP32 Pin |
+|--------------|-----------|
+| TX           | GPIO22    |
+| RX           | GPIO23    |
+| VCC          | 5V        |
+| GND          | GND       |
+|----| **Endstufe**|
+| SPK1     | Left Audio  |
+| GND      | GND Audio   |
+| SPK2     | Right Audio |
+
+
+💾 SD-Karte:  
+MP3-Dateien im Format `0001.mp3` bis `0050.mp3` im MP3 Verzeichnis.
+
+
+---
+
+## 📂 Projektstruktur
+
+```text
+/
+├── src/
+│   ├── MP3/                # Arduino-Quellcode
+│   └── main.cpp
+├── printfiles/         # STL-Dateien für 3D-Druck
+├── docu/               # Fotos, Schaltpläne, Screenshots
+└── README.md
diff --git a/docu/20230720_202601.jpg b/docu/20230720_202601.jpg
diff --git a/docu/20230720_205834.jpg b/docu/20230720_205834.jpg
diff --git a/docu/20230720_220237.jpg b/docu/20230720_220237.jpg
diff --git a/docu/20230720_220250.jpg b/docu/20230720_220250.jpg
diff --git a/docu/20230727_214752 (1).jpg b/docu/20230727_214752 (1).jpg
diff --git a/docu/20230727_214752.jpg b/docu/20230727_214752.jpg
diff --git a/docu/20230727_214800.jpg b/docu/20230727_214800.jpg
diff --git a/docu/20230827_103529.jpg b/docu/20230827_103529.jpg
diff --git a/docu/20240531_110053.jpg b/docu/20240531_110053.jpg
diff --git a/docu/20240531_110109.jpg b/docu/20240531_110109.jpg
diff --git a/docu/Schaltung.jpg b/docu/Schaltung.jpg
diff --git a/docu/Screenshot_20230727-233512_Onshape.jpg b/docu/Screenshot_20230727-233512_Onshape.jpg
diff --git a/docu/Screenshot_20230727-233618_Onshape.jpg b/docu/Screenshot_20230727-233618_Onshape.jpg
diff --git a/src/list_5x5_1.csv → docu/list_5x5_1.csv b/src/list_5x5_1.csv → docu/list_5x5_1.csv
diff --git a/src/list_5x5_2.csv → docu/list_5x5_2.csv b/src/list_5x5_2.csv → docu/list_5x5_2.csv
diff --git a/docu/list_5x5_with_Numbers.pdf b/docu/list_5x5_with_Numbers.pdf
diff --git a/docu/list_5x5_with_Numbers.xlsx b/docu/list_5x5_with_Numbers.xlsx