start tutorial

TROUBLESHOOTING.md

@@ -0,0 +1,41 @@
+# Troubleshooting
+
+## Host Setup
+
+1. `rustup: command not found`
+   - Rust via rustup installieren.
+2. `probe-rs: command not found`
+   - `cargo install probe-rs-tools`
+3. Target fehlt
+   - `rustup target add thumbv7m-none-eabi`
+
+## Probe / Flashing
+
+1. `No probe found`
+   - USB-Kabel/Port prüfen
+   - ST-Link Treiber/udev prüfen
+   - `probe-rs list` erneut ausführen
+2. `chip not found`
+   - Runner-String prüfen: `STM32F103C8`
+3. `Permission denied` (Linux)
+   - udev-Regeln für ST-Link setzen und neu laden
+
+## Runtime Behavior
+
+1. LED blinkt nicht
+   - PC13 active-low beachten
+   - Versorgung prüfen
+2. Button reagiert nicht
+   - Taster nach GND verdrahten
+   - `PA0` korrekt belegt?
+3. Analogwerte ändern sich nicht
+   - Sensor/Poti wirklich an `PA1`
+   - Gemeinsame Masse sicherstellen
+
+## Fallback in Session
+
+Wenn eine Station nicht stabil läuft:
+
+1. Mit funktionierender Nachbarn pairen.
+2. `solution/` ausführen.
+3. Später wieder auf `task/` zurückwechseln.