PoC_BLDC_ShiftLeft

Proof-of-concept scaffold for a MATLAB/Simulink R2026a shift-left workflow on a BLDC motor controller.

What this repo supports

• Requirements Toolbox requirements with stage routing.
• GenAI-assisted requirement-to-test generation with provider-agnostic LLM configuration.
• Runtime selection between real HIL and simulated HIL fallback.
• Runtime selection between placeholder motor parameters and datasheet-driven parameters.

Important note

This workspace currently contains MATLAB-first source files plus placeholder binary artifacts for Simulink/Test/App Designer assets. Run the MATLAB setup script to replace the placeholders with real .slx, .reqx, .mldatx, and .mlapp artifacts in an environment that has the required toolboxes licensed.

Runtime switches

• HIL mode: cfg.hil.mode = "real" or "simulated" in config/pocConfig.m
• LLM provider: cfg.llm.provider = "openai" | "azureopenai" | "rest" | "auto"
• Motor source: cfg.motor.source = "placeholder" | "datasheet"

Prerequisites

• MATLAB R2026a
• Simulink
• Simscape / Simscape Electrical
• Stateflow
• Control System Toolbox
• Model Predictive Control Toolbox
• Requirements Toolbox
• Simulink Test
• Simulink Coverage
• Simulink Design Verifier
• Embedded Coder
• Simulink Real-Time for real HIL, or the simulated HIL fallback configured here

Run order

1. Edit config/pocConfig.m for your provider, HIL mode, and motor source.
2. Run scripts/setupProject.m
3. Run scripts/runMIL.m
4. Run scripts/runSIL.m
5. Run scripts/runHIL.m
6. Run traceability/generateTraceabilityReport.m
7. Open the dashboard artifact in results/

LLM configuration

Set the environment variable LLM_API_KEY before running the GenAI pipeline. Provider-specific endpoint, model, deployment, and API version values are configured in config/pocConfig.m.

Motor parameter configuration

model/params/motorParams.m supports both placeholder values and loading real datasheet values from a file path at runtime.