Incremental Build Workflow with UGG

The Unified Graphics & Model Generator (UGG) enables a high-performance, incremental approach to generating EHANDBOOK Containers. This workflow is specifically designed for large-scale projects where fast build times and frequent updates are critical.

Conceptual Overview

In a standard build process, the EHANDBOOK Container-Build (EHB-CB) performs model conversion and container assembly in a single sequence. For large ECU projects, converting hundreds of Simulink or ASCET models can be time-consuming.

The UGG decouples these steps by pre-generating interactive model artifacts. This allows for an Incremental Build strategy:

  • Artifact Generation: UGG processes the raw models (Simulink, ASCET, or C-Code) to create intermediate artifacts, including interactive model data, SVG images, and map files.

  • Incremental Update: During subsequent builds, UGG only needs to re-process models that have changed.

  • Fast Assembly: The EHB-CB framework "fetches" these pre-generated artifacts and combines them with other documentation sources (like AsciiDoc or ASAM FSX) to compile the final .ehb container.

Target Usage

The incremental workflow is the recommended solution for the following scenarios:

  • Continuous Integration (CI): Integration into automated build pipelines (e.g., Jenkins, GitLab CI) where documentation must be updated alongside every software build.

  • Large Model Landscapes: Projects involving multiple models or different formats where a full conversion would exceed the desired build window.

  • Fast Feedback Loops: Environments where developers require rapid access to the latest documentation container.

Workflow Visualization

Incremental Build Workflow with UGG

Target Users

This workflow is primarily intended for:

  • ECU Software Build Experts: Responsible for maintaining the automated build environment.

  • Process & Tooling Leads: Responsible for defining the methods and tools used in ECU software development.

Starting with EHANDBOOK 13.2, the UGG and EHB-CB packages are merged into a single software distribution to simplify the setup of incremental build environments. However, the UGG functionality still requires its specific electronic license (e.g., EHB_CB_UGG_SIMULINK).