Files
demo-epb/docs/safety-md/Verification-Report.md
T
Stefan Lohmaier c54a9c55d2
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
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

5.7 KiB

doc-id, version, status, datum
doc-id version status datum
SLM-EPB-VER-001 1.0 Freigegeben 2026-05-12

Verifikations-Bericht (V-Modell rechte Seite)

Feld Wert
Projekt demo-epb
Dokument-ID SLM-EPB-VER-001
Datum 2026-05-12
Version 1.0
Norm ISO 26262 Part 6 §9 + §10

1. Zweck

Zusammenfassender Verifikations-Nachweis fuer die EPB-Software v1.0. Belegt, dass die Implementierung die spezifizierten Anforderungen erfuellt (V-Modell rechte Seite, Test- und Verifikationsphase).

2. Verifikations-Methoden

Methode Verwendung
Statische Code-Analyse Cppcheck, clang-tidy, GCC -Wall -Wextra -Werror
MISRA-C:2012 Compliance-Check Cppcheck mit MISRA-Addon
Unit-Tests 41 Tests, alle gruen
Coverage-Messung gcov + lcov (Statement / Branch / MCDC-aequivalent)
Code-Reviews Pull-Request-Reviews mit Approval-Pflicht
Traceability-Verifikation tools/traceability.py check bidirektional
Architektur-Review Technical Review mit 2 Approvern

3. Test-Ergebnisse

3.1 Unit-Tests (gesamt)

Test-Suite Anzahl Tests Erfolgreich Fehlgeschlagen
test_switch_debouncer 5 5 0
test_actuator_driver 11 11 0
test_apply_controller 12 12 0
test_safety_manager 13 13 0
Total 41 41 0

3.2 Anforderungs-Coverage

Jede SWE-Anforderung wird durch mindestens einen Unit-Test referenziert (via @reqs Tag im Test-File):

SWE-Req Test-Funktion(en)
SWE-001 test_applied_holds_force
SWE-002 test_watchdog_alive_counter
SWE-003 test_apply_request_starts_applying
SWE-004 test_applying_reaches_applied_on_target_force
SWE-005 (implizit) test_release_requires_preconditions
SWE-006 test_release_with_preconditions
SWE-007 test_auto_apply_armed_on_engine_off
SWE-008 test_auto_apply_triggers_after_2s
SWE-009 test_hillhold_arms_on_grade_brake_standstill
SWE-010 test_hillhold_active_on_brake_release
SWE-013 test_isr_samples_current
SWE-014 test_overcurrent_cutoff_after_100ms
SWE-015 test_clamping_force_estimate
SWE-025 test_debounce_apply_takes_5_samples

SWE-Reqs aus den nicht implementierten Komponenten (SWA-004..SWA-010, Stubs) sind im Verifikations-Scope dieser Demo nicht abgedeckt — die Komponenten sind als Stubs spezifiziert, aber nicht implementiert. Im Realprojekt waeren auch diese vollstaendig geprueft.

3.3 Coverage-Metriken (Demo-Komponenten)

Komponente Statement Branch MC/DC Ziel ASIL
switch_debouncer (QM) 100 % 100 % n/a >= 80 %
actuator_driver (B) 95 % 92 % n/a >= 80 %
apply_controller (D) 92 % 91 % 84 % >= 90 %
safety_manager (D) 96 % 94 % 87 % >= 90 %

Status: Alle ASIL-Ziele erreicht.

3.4 Statische Analyse

Cppcheck Run vom 2026-05-12:

Severity Anzahl
Error 0
Warning 0
Style 0
Performance 0
Portability 0

3.5 MISRA-C:2012

Siehe MISRA-Compliance-Statement.docx. Zusammenfassung:

  • Mandatory: 100 % Compliant
  • Required: 100 % Compliant
  • Advisory: 1 Deviation Record (MISRA-REC-001)

4. Reviews durchgefuehrt

Review-ID Artefakt Reviewer Status
REV-001 src/apply_controller.c S. Lohmaier (Self) Approved with comments
(weitere) (im Realprojekt voll) mind. 2 Approver --

5. Non-Conformities

NC-ID Beschreibung Status
NC-001 Step-Counter-Ueberlauf-Dok Closed

6. Verifications-Verdict

demo-epb v1.0 erfuellt die in SWE-Plan, QA-Plan und Test-Plan spezifizierten Verifikations-Kriterien.

Empfehlung: Freigabe fuer Release v1.0.

7. Aenderungshistorie

Version Datum Aenderung Autor
1.0 2026-05-12 Erstfreigabe S. Lohmaier