feat: Vollstaendige Demo-Doku — Safety, Manuals, Reports, API-Doc

Neue Word-Dokumente (alle aus Markdown via pandoc): Safety (docs/safety/): - HARA.docx — Hazard Analysis & Risk Assessment, leitet ASIL-D ab - Safety-Case.docx — Argumentation pro Safety Goal (GSN-Stil) - FMEDA.docx — Pro-Komponente Failure Modes + Diagnostic Coverage - MISRA-Compliance-Statement.docx — formaler MISRA-Nachweis - Verification-Report.docx — V-Modell rechte Seite Zusammenfassung - Tool-Qualification-Cppcheck.docx — Tool-Qual (TCL2/ASIL-D) Manuals (docs/manuals/): - User-Manual.docx — Fahrerhandbuch-Auszug - Service-Manual.docx — Werkstatt-Doku mit UDS-DTCs CI-Erweiterungen: - Doxyfile + `make docs` — API-Dokumentation aus src/ - tools/generate_test_report.py + `make test-report` — Test-Summary HTML - validate.yml: Doxygen + Test-Report als CI-Artefakte - release.yml: alle Word-Docs + Engineering-Artefakte ins Release-Bundle README: - Komplette Tour durch alle Artefakte - Repo-Struktur-Diagramm aktualisiert
2026-05-12 00:55:37 -07:00
parent 84fab72f23
commit c54a9c55d2
21 changed files with 1396 additions and 27 deletions
@@ -0,0 +1,138 @@
+---
+doc-id: SLM-EPB-SVC-001
+version: 1.0
+status: Freigegeben
+datum: 2026-05-12
+---
+
+# Service Manual — Elektrische Parkbremse (EPB)
+
+| Feld         | Wert                                  |
+|--------------|----------------------------------------|
+| Produkt      | demo-epb EPB-Steuergeraet              |
+| Version      | 1.0                                    |
+| Datum        | 2026-05-12                             |
+| Zielgruppe   | Werkstatt-Techniker                    |
+
+---
+
+## 1. Werkzeuge
+
+- OBD-II-Diagnose-Tester mit UDS-Support (ISO 14229)
+- Drehmomentschluessel 60 Nm
+- Verschiebewerkzeug 28x40 mm (fuer Bremsbelag-Wechsel)
+
+## 2. UDS-Diagnose
+
+### 2.1 Identifikation
+
+| Parameter         | Wert        |
+|-------------------|-------------|
+| Tester-Adresse    | 0x712       |
+| ECU-Antwort       | 0x71A       |
+| CAN-Baudrate      | 500 kbit/s  |
+
+### 2.2 Service-IDs
+
+| SID  | Service                       | Notizen                       |
+|------|-------------------------------|-------------------------------|
+| 0x10 | DiagnosticSessionControl      | 0x03 = Extended Session       |
+| 0x11 | ECUReset                      | 0x01 = Hard Reset             |
+| 0x14 | ClearDiagnosticInformation   | Loescht alle DTCs            |
+| 0x19 | ReadDTCInformation            | Sub 0x02 = reportDTCByStatusMask |
+| 0x22 | ReadDataByIdentifier          | Siehe DID-Liste              |
+| 0x27 | SecurityAccess                | Nicht implementiert in Demo   |
+| 0x31 | RoutineControl                | 0x0301 = Service-Modus         |
+
+### 2.3 DIDs (Data Identifiers)
+
+| DID    | Beschreibung                       | Typ            |
+|--------|-------------------------------------|----------------|
+| 0xF187 | SW-Version                          | ASCII 16 byte  |
+| 0xF18B | ECU-Hardware-Version                | ASCII 16 byte  |
+| 0x0301 | Klemmkraft links                    | uint16 (N)     |
+| 0x0302 | Klemmkraft rechts                   | uint16 (N)     |
+| 0x0303 | Motorstrom links                    | uint16 (mA)    |
+| 0x0304 | Motorstrom rechts                   | uint16 (mA)    |
+| 0x0305 | Inclinometer (gefiltert)            | int16 (m°)     |
+
+## 3. DTC-Liste
+
+| DTC      | Bedeutung                                       | Aktion                                |
+|----------|--------------------------------------------------|----------------------------------------|
+| P0571    | EPB-Schalter Plausibilitaet                     | Schalter pruefen                       |
+| P0572    | EPB-Schalter dauerhaft betaetigt                | Schalter blockiert? Reinigen           |
+| P0808    | Aktor-Strom links zu hoch (Overcurrent)         | Motor + Verkabelung pruefen            |
+| P0809    | Aktor-Strom rechts zu hoch (Overcurrent)        | Motor + Verkabelung pruefen            |
+| P080A    | Klemmkraft links nicht erreicht (Apply-Timeout) | Aktor / Mechanik pruefen               |
+| P080B    | Klemmkraft rechts nicht erreicht                | Aktor / Mechanik pruefen               |
+| P080C    | Wheel-Speed-Sensor Plausibilitaet               | Sensoren / Verkabelung pruefen          |
+| P080D    | Inclinometer Plausibilitaet                     | Sensor / Montage pruefen                |
+| P080E    | Apply-Controller-Watchdog-Trip                  | Software-Reset, bei Wiederholung ECU tauschen |
+| U0123    | CAN-Bus-Kommunikation verloren                  | CAN-Verkabelung + BCM-Status            |
+
+## 4. Service-Modus (Bremsbelag-Wechsel)
+
+### 4.1 Aktivierung
+
+Voraussetzungen:
+- Zuendung an, Motor aus
+- Fahrzeug auf der Buehne oder mit gesicherten Raedern
+- Fahrertuer geschlossen (oder Tuer-Signal ueberbrueckt)
+
+Schritte:
+1. Diagnose-Tester verbinden, Extended Session (0x10 0x03)
+2. RoutineControl `0x31 01 03 01` senden — Start Routine
+3. ECU bestaetigt, EPB-LED beginnt mit 2 Hz zu blinken
+4. Aktoren fahren in Wartungs-Position (vollstaendig geloest)
+
+### 4.2 Deaktivierung
+
+1. RoutineControl `0x31 02 03 01` senden — Stop Routine
+2. EPB-LED beendet das Blinken
+3. Apply-Funktion wieder verfuegbar
+
+### 4.3 Bremsbelag-Wechsel-Ablauf
+
+1. Service-Modus aktivieren (siehe oben)
+2. Bremssattel demontieren
+3. Belaege wechseln, Fuehrungen schmieren
+4. Bremssattel mit 60 Nm anziehen
+5. Service-Modus deaktivieren
+6. Drei Apply/Release-Zyklen durchfuehren (zum Einschleifen)
+7. DTC-Speicher leeren (Service 0x14)
+
+## 5. Sensor-Pruefung
+
+### 5.1 Wheel-Speed-Sensoren
+
+- Widerstand: 800-1500 Ω bei 20 °C
+- Spannung bei 50 km/h: 2-5 V Peak-to-Peak (Hall)
+
+### 5.2 Inclinometer
+
+- SPI-Bus 1 MHz
+- Erwarteter Wert auf ebener Strasse: 0 ± 0.5°
+- Drift-Check: ECU + Tester, > 5 Min Beobachtung
+
+## 6. Aktor-Pruefung
+
+| Parameter             | Sollwert              |
+|-----------------------|------------------------|
+| Widerstand pro Motor  | 0.8 – 1.2 Ω           |
+| Stromaufnahme nominal | 3 – 5 A               |
+| Stromspitze (Apply)   | 15 – 25 A             |
+| Cutoff-Schwelle       | 8 A fuer 100 ms       |
+
+## 7. Software-Update
+
+1. UDS Extended Session (0x10 0x03)
+2. Programming Session (0x10 0x02)
+3. Flashloader-Sequenz nach OEM-Spezifikation
+4. Neue SW-Version per DID 0xF187 verifizieren
+
+## 8. Aenderungshistorie
+
+| Version | Datum       | Aenderung           | Autor       |
+|---------|-------------|---------------------|-------------|
+| 1.0     | 2026-05-12  | Erstfreigabe        | S. Lohmaier |
@@ -0,0 +1,114 @@
+---
+doc-id: SLM-EPB-USR-001
+version: 1.0
+status: Freigegeben
+datum: 2026-05-12
+---
+
+# Bedienungsanleitung — Elektrische Parkbremse (EPB)
+
+| Feld         | Wert                                  |
+|--------------|----------------------------------------|
+| Produkt      | demo-epb EPB-Steuergeraet              |
+| Version      | 1.0                                    |
+| Datum        | 2026-05-12                             |
+| Zielgruppe   | Fahrzeugfuehrer                        |
+
+---
+
+> **Wichtige Sicherheitshinweise lesen!**
+> Bevor Sie die EPB verwenden, machen Sie sich mit den Funktionen vertraut.
+
+## 1. Was ist die Elektrische Parkbremse?
+
+Die Elektrische Parkbremse (EPB) ersetzt die klassische Handbremse. Sie wird
+ueber einen Schalter in der Mittelkonsole bedient und klemmt die hinteren
+Bremsen elektromechanisch fest.
+
+## 2. Bedienung
+
+### 2.1 Parkbremse einlegen (Apply)
+
+1. Fahrzeug zum Stillstand bringen.
+2. Bremspedal getreten halten.
+3. EPB-Schalter **nach oben** ziehen (Pfeil zeigt zur Frontscheibe).
+4. Die rote LED am Schalter leuchtet dauerhaft.
+
+Sie hoeren ein leichtes Brummen — das sind die Stellmotoren.
+
+### 2.2 Parkbremse loesen (Release)
+
+**Voraussetzungen** (alle muessen erfuellt sein):
+
+- Motor laeuft
+- Bremspedal ist betaetigt
+- Gangwahlhebel ist eingelegt (kein Leerlauf)
+
+1. EPB-Schalter **nach unten** druecken.
+2. Die LED erlischt.
+3. Sie hoeren erneut ein kurzes Brummen.
+
+### 2.3 Auto-Hold (Fahrer steigt aus)
+
+Wenn Sie den Motor abschalten und das Fahrzeug stillsteht, wird die EPB
+**automatisch nach 2 Sekunden** eingelegt — auch wenn Sie sie nicht manuell
+betaetigt haben. Die LED leuchtet als Bestaetigung.
+
+### 2.4 Hill-Hold am Berg
+
+Beim Anhalten an einer Steigung (> 5 %):
+
+1. Bremspedal treten — Fahrzeug haelt.
+2. Fuss vom Bremspedal nehmen — die EPB uebernimmt automatisch.
+3. Die LED blinkt langsam waehrend Hill-Hold aktiv ist.
+4. Beim Anfahren (Gasgeben + Gang eingelegt) loest die EPB automatisch.
+
+## 3. Bedeutung der LED-Anzeige
+
+| LED-Status            | Bedeutung                                       |
+|-----------------------|--------------------------------------------------|
+| Aus                   | EPB geloest                                      |
+| Dauerleuchtend rot    | EPB aktiv (Apply / Hold)                         |
+| Langsam blinkend (2 Hz) | Hill-Hold aktiv oder Service-Modus            |
+| Schnell blinkend (4 Hz) | Fehler — bitte Werkstatt aufsuchen            |
+
+## 4. Anzeige im Kombi-Display
+
+Das Kombi-Display zeigt zusaetzliche Texte:
+
+| Anzeige                | Bedeutung                                  |
+|------------------------|---------------------------------------------|
+| "EPB aktiv"            | Parkbremse eingelegt                       |
+| "Hill-Hold aktiv"      | Hill-Hold uebernimmt                        |
+| "EPB Fehler"           | Stoerung — siehe Werkstatt                 |
+| "EPB Service-Modus"    | Im Werkstatt-Modus, nicht selbst loesen    |
+
+## 5. Notbetrieb
+
+Sollte die EPB nicht reagieren:
+
+- **Sie steht und kommt nicht weg:** EPB-Schalter mehrmals nach unten druecken;
+  bei Misserfolg Notabschleppdienst rufen.
+- **Sie steht und EPB greift nicht:** Fahrzeug mit Unterlegkeil sichern,
+  Werkstatt kontaktieren.
+
+## 6. Sicherheitshinweise
+
+> **⚠ WARNUNG**
+>
+> - EPB ersetzt nicht das Anziehen des Gangs beim Parken
+> - Auf glatten Untergruenden zusaetzlich Unterlegkeile verwenden
+> - Bei laufendem Motor und eingelegter EPB nicht ueber dem
+>   Bremspedal stehen lassen
+
+## 7. Wartung
+
+Die EPB ist wartungsfrei. Bei Bremsbelagwechsel muss die Werkstatt den
+**Service-Modus** aktivieren — bitte das Fahrzeug nicht selbst aufbocken,
+solange die EPB im aktiven Zustand ist.
+
+## 8. Aenderungshistorie
+
+| Version | Datum       | Aenderung           | Autor       |
+|---------|-------------|---------------------|-------------|
+| 1.0     | 2026-05-12  | Erstfreigabe        | S. Lohmaier |