start tutorial

HARDWARE.md

@@ -0,0 +1,31 @@
+# Hardware Baseline (Bluepill + ST-Link)
+
+## Board and Probe
+
+- MCU board: STM32F103C8T6 Bluepill
+- Debug probe: ST-Link (SWD)
+
+## SWD Wiring
+
+1. ST-Link `SWDIO` -> Bluepill `PA13`
+2. ST-Link `SWCLK` -> Bluepill `PA14`
+3. ST-Link `GND` -> Bluepill `GND`
+4. ST-Link `3V3` -> Bluepill `3V3` (falls notwendig)
+5. Optional: ST-Link `NRST` -> Bluepill `NRST`
+
+## Workshop I/O Wiring
+
+1. LED:
+   - Onboard LED an `PC13` (active-low)
+2. Button:
+   - Externer Taster von `PA0` nach `GND`
+   - Interner Pull-up wird im Code aktiviert
+3. Analog:
+   - Poti/Sensor-Ausgang an `PA1`
+   - Sensorversorgung über `3V3` + `GND`
+
+## Sanity Checks
+
+1. `probe-rs list` zeigt ST-Link an.
+2. `probe-rs chip list | grep STM32F103C8` findet Target.
+3. Beim Flashen keine "No probe found"-Meldung.