APIC – DBSimGenerator

DBSimGenerator

DBSimGenerator generates simulation and interface code automatically from ICD (Interface Control Document) CSV files. Each CSV defines one or more blocks, containing fields and metadata that describe how data is structured, scaled, and interpreted.

DBSimGenerator automatically generates high-performance C++ code for simulation and interface directly from ICD (Interface Control Document) CSV files. Each CSV defines one block with fields and metadata describing how data is structured, scaled, and interpreted.

Terminology: LRU, Block, Element

ICDs are organized in a three-level hierarchy:

• LRU (Line Replacement Unit) - one physical or logical replaceable unit (a named CSV subfolder, e.g. LRU_FC). An LRU holds a list of Blocks, and it's the LRU that defines the Raw ↔ Eng conversion for everything it contains - see Raw ↔ Eng Conversion in the Model guide.
• Block - one CSV file within an LRU folder (e.g. Telemetry.csv). A Block holds a list of Elements and is the unit that streams send and receive to/from a device - the "blocks" array in streams.json is a list of Blocks.
• Element - one row of a Block CSV (one field), e.g. Altitude or Speed in the example below.

CSV Directory Structure

project_name/
├── LRU_name/
│   ├── Block_name.csv
│   └── Enums.csv
  

Key Features

• High-Performance Code: Generates optimized C++ code for fast simulations.
• RAW and ENG Types: Supports both raw data and engineering unit conversions for flexible use.
• Endian & Bit Ordering: Handles Little/Big Endian and MSB/LSB conversions automatically — see Raw ↔ Eng Conversion for the NoRaw/LElsb/LEmsb/BElsb/BEmsb block conventions.
• Hardware Integration: Integrates directly with HW drivers using streams.json for seamless system communication.
• Automated & Scalable: Reduces repetitive coding, supporting multiple blocks, LRUs, and projects effortlessly.

Workflow

1. Prepare ICD CSV files and Enums for your blocks.
2. Organize CSVs in the project → LRU → block structure.
3. DBSimGenerator reads the CSVs and generates high-performance code.
4. Generated code integrates with simulation frameworks and hardware drivers.

With DBSimGenerator, you can focus on building your technology while the platform handles 80% of the integration and boilerplate code automatically.

Example ICD CSV snippet

BlockName, FieldName, Type, Size, Description
Telemetry, Altitude, float, 4, Aircraft altitude (m)
Telemetry, Speed, float, 4, Airspeed (m/s)

1. ICD Blocks and Elements

2. Data Type Specification

3. Enums