feat: Vollstaendige Demo-Doku — Safety, Manuals, Reports, API-Doc
Validate / build-test (macos-latest) (push) Failing after 4s
Validate / build-test (windows-latest) (push) Failing after 15s
Validate / build-test (ubuntu-latest) (push) Failing after 15s
Validate / reports (push) Has been skipped
Release / release (push) Successful in 50s

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
This commit is contained in:
Stefan Lohmaier
2026-05-12 00:55:37 -07:00
parent 84fab72f23
commit c54a9c55d2
21 changed files with 1396 additions and 27 deletions
+138
View File
@@ -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 |