FIXUP! update architecture over view for the power supply integration

This commit is contained in:
Hosam-Eldin.mostafa 2025-10-24 23:28:46 +02:00
parent e552e9a8e9
commit 092767ab51

View File

@ -11,6 +11,8 @@ This document provides a high-level view of the frameworks components and how
- Mock LIN Adapter — `ecu_framework/lin/mock.py` - Mock LIN Adapter — `ecu_framework/lin/mock.py`
- BabyLIN Adapter — `ecu_framework/lin/babylin.py` (SDK wrapper → BabyLIN_library.py) - BabyLIN Adapter — `ecu_framework/lin/babylin.py` (SDK wrapper → BabyLIN_library.py)
- Flasher — `ecu_framework/flashing/hex_flasher.py` - Flasher — `ecu_framework/flashing/hex_flasher.py`
- Power Supply (PSU) control — `ecu_framework/power/owon_psu.py` (serial SCPI)
- PSU tryout script — `vendor/Owon/tryout.py`
- Reporting Plugin — `conftest_plugin.py` (docstring → report metadata) - Reporting Plugin — `conftest_plugin.py` (docstring → report metadata)
- Reports — `reports/report.html`, `reports/junit.xml` - Reports — `reports/report.html`, `reports/junit.xml`
@ -30,12 +32,15 @@ flowchart TB
MOCK[ecu_framework/lin/mock.py] MOCK[ecu_framework/lin/mock.py]
BABY[ecu_framework/lin/babylin.py] BABY[ecu_framework/lin/babylin.py]
FLASH[ecu_framework/flashing/hex_flasher.py] FLASH[ecu_framework/flashing/hex_flasher.py]
POWER[ecu_framework/power/owon_psu.py]
end end
subgraph Artifacts subgraph Artifacts
REP[reports/report.html<br/>reports/junit.xml] REP[reports/report.html<br/>reports/junit.xml]
YAML[config/*.yaml<br/>babylin.example.yaml<br/>test_config.yaml] YAML[config/*.yaml<br/>babylin.example.yaml<br/>test_config.yaml]
PSU_YAML[config/owon_psu.yaml<br/>OWON_PSU_CONFIG]
SDK[vendor/BabyLIN_library.py<br/>platform-specific libs] SDK[vendor/BabyLIN_library.py<br/>platform-specific libs]
OWON[vendor/Owon/tryout.py]
end end
T --> CF T --> CF
@ -44,10 +49,13 @@ flowchart TB
CF --> MOCK CF --> MOCK
CF --> BABY CF --> BABY
CF --> FLASH CF --> FLASH
T --> POWER
PL --> REP PL --> REP
CFG --> YAML CFG --> YAML
CFG --> PSU_YAML
BABY --> SDK BABY --> SDK
T --> OWON
T --> REP T --> REP
``` ```
@ -57,6 +65,9 @@ flowchart TB
- Config loader reads YAML (or env override), returns typed dataclasses - Config loader reads YAML (or env override), returns typed dataclasses
- LIN calls are routed through the interface abstraction to the selected adapter - LIN calls are routed through the interface abstraction to the selected adapter
- Flasher (optional) uses the same interface to program the ECU - Flasher (optional) uses the same interface to program the ECU
- Power supply control (optional) uses `ecu_framework/power/owon_psu.py` and reads
`config.power_supply` (merged with `config/owon_psu.yaml` or `OWON_PSU_CONFIG` when present);
the tryout script under `vendor/Owon/` provides a quick manual flow
- Reporting plugin parses docstrings and enriches the HTML report - Reporting plugin parses docstrings and enriches the HTML report
## Extending the architecture ## Extending the architecture