# openbmc/smbios-mdr architecture

> Architecture diagram of the GitHub repository openbmc/smbios-mdr, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/openbmc/smbios-mdr
- Repository: https://github.com/openbmc/smbios-mdr

## Overview

smbios-mdr provides two OpenBMC applications: an SMBIOS ingestion/parser that publishes inventory over D-Bus, and Intel CPU-information/SST discovery and control. The main workflow accepts host firmware data through MDRv2 or the optional IPMI blob API, parses SMBIOS, and publishes system and component inventory. The README documents the blob cache-and-synchronize route and the CPU app’s I2C/PECI and SST capabilities. Several implementation relationships are documented only at subsystem level; unverified parser-to-publisher links are dashed.

Main entry points: [`src/mdrv2.cpp`](https://github.com/openbmc/smbios-mdr/blob/master/src/mdrv2.cpp) (SMBIOS Parser), [`src/cpuinfo_main.cpp`](https://github.com/openbmc/smbios-mdr/blob/master/src/cpuinfo_main.cpp) (CPU Info App), [`src/smbios-ipmi-blobs/handler.cpp`](https://github.com/openbmc/smbios-mdr/blob/master/src/smbios-ipmi-blobs/handler.cpp) (SMBIOS Blob Handler), [`src/speed_select.cpp`](https://github.com/openbmc/smbios-mdr/blob/master/src/speed_select.cpp) (SST Discovery and Control)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ingest["SMBIOS Ingestion"]
  node_mdrv2["MDRv2 Service<br/>[mdrv2.cpp]"]
  node_blob["SMBIOS Blob Handler<br/>[handler.cpp]"]
  node_cache[("SMBIOS Cache")]
end

subgraph group_inventory["SMBIOS Inventory"]
  node_parser["SMBIOS Parser<br/>[mdrv2.cpp]"]
  node_system["System Inventory<br/>[system.cpp]"]
  node_cpu_inventory["CPU Inventory<br/>[cpu.cpp]"]
  node_dimm["Memory Inventory<br/>[dimm.cpp]"]
  node_pcie["PCIe Inventory<br/>[pcieslot.cpp]"]
  node_pcie_device["PCIe Devices<br/>[pciedevice.cpp]"]
  node_firmware["Firmware Inventory"]
  node_tpm["TPM Inventory<br/>[tpm.cpp]"]
end

subgraph group_cpu["CPU Information"]
  node_cpu_app["CPU Info App<br/>[cpuinfo_main.cpp]"]
  node_cpu_utils["CPU Info Utilities<br/>[cpuinfo_utils.cpp]"]
end

subgraph group_sst["Speed Select"]
  node_sst["SST Discovery and Control<br/>[speed_select.cpp]"]
  node_sst_mailbox["SST Mailbox<br/>[sst_mailbox.cpp]"]
end

node_host(("Host Firmware"))
node_ipmi(("IPMI Clients"))
node_dbus(("OpenBMC D-Bus"))
node_cpu_hw["I2C / PECI"]

node_host -->|"sends SMBIOS"| node_mdrv2
node_ipmi -->|"transfers blob"| node_blob
node_blob -->|"writes table"| node_cache
node_blob -->|"requests synchronization"| node_mdrv2
node_mdrv2 -.->|"supplies table"| node_parser
node_parser -.->|"publishes system data"| node_system
node_parser -.->|"publishes CPU data"| node_cpu_inventory
node_parser -.->|"publishes memory data"| node_dimm
node_parser -.->|"publishes slot data"| node_pcie
node_parser -.->|"publishes device data"| node_pcie_device
node_parser -.->|"publishes firmware data"| node_firmware
node_parser -.->|"publishes TPM data"| node_tpm
node_system -.->|"exposes inventory"| node_dbus
node_cpu_inventory -.->|"exposes inventory"| node_dbus
node_dimm -.->|"exposes inventory"| node_dbus
node_pcie -.->|"exposes inventory"| node_dbus
node_pcie_device -.->|"exposes inventory"| node_dbus
node_firmware -.->|"exposes inventory"| node_dbus
node_tpm -.->|"exposes inventory"| node_dbus
node_cpu_app -->|"uses host-state utilities"| node_cpu_utils
node_cpu_app -->|"gathers CPU details"| node_cpu_hw
node_cpu_app -->|"discovers and controls SST"| node_sst
node_sst -.->|"uses mailbox"| node_sst_mailbox
node_sst -->|"publishes SST objects"| node_dbus

click node_mdrv2 "https://github.com/openbmc/smbios-mdr/blob/master/src/mdrv2.cpp"
click node_blob "https://github.com/openbmc/smbios-mdr/blob/master/src/smbios-ipmi-blobs/handler.cpp"
click node_parser "https://github.com/openbmc/smbios-mdr/blob/master/src/mdrv2.cpp"
click node_system "https://github.com/openbmc/smbios-mdr/blob/master/src/system.cpp"
click node_cpu_inventory "https://github.com/openbmc/smbios-mdr/blob/master/src/cpu.cpp"
click node_dimm "https://github.com/openbmc/smbios-mdr/blob/master/src/dimm.cpp"
click node_pcie "https://github.com/openbmc/smbios-mdr/blob/master/src/pcieslot.cpp"
click node_pcie_device "https://github.com/openbmc/smbios-mdr/blob/master/src/pciedevice.cpp"
click node_firmware "https://github.com/openbmc/smbios-mdr/blob/master/src/firmware_inventory.cpp"
click node_tpm "https://github.com/openbmc/smbios-mdr/blob/master/src/tpm.cpp"
click node_cpu_app "https://github.com/openbmc/smbios-mdr/blob/master/src/cpuinfo_main.cpp"
click node_cpu_utils "https://github.com/openbmc/smbios-mdr/blob/master/src/cpuinfo_utils.cpp"
click node_sst "https://github.com/openbmc/smbios-mdr/blob/master/src/speed_select.cpp"
click node_sst_mailbox "https://github.com/openbmc/smbios-mdr/blob/master/src/sst_mailbox.cpp"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_mdrv2,node_blob,node_cache,node_ipmi toneBlue
class node_parser,node_system,node_cpu_inventory,node_dimm,node_pcie,node_pcie_device,node_firmware,node_tpm toneAmber
class node_cpu_app,node_cpu_utils toneMint
class node_sst,node_sst_mailbox toneRose
class node_host,node_dbus,node_cpu_hw toneIndigo
```

## Components

### SMBIOS Ingestion

- [MDRv2 Service](https://github.com/openbmc/smbios-mdr/blob/master/src/mdrv2.cpp): `src/mdrv2.cpp`
- [SMBIOS Blob Handler](https://github.com/openbmc/smbios-mdr/blob/master/src/smbios-ipmi-blobs/handler.cpp): `src/smbios-ipmi-blobs/handler.cpp`
- **SMBIOS Cache**

### SMBIOS Inventory

- [SMBIOS Parser](https://github.com/openbmc/smbios-mdr/blob/master/src/mdrv2.cpp): `src/mdrv2.cpp`
- [System Inventory](https://github.com/openbmc/smbios-mdr/blob/master/src/system.cpp): `src/system.cpp`
- [CPU Inventory](https://github.com/openbmc/smbios-mdr/blob/master/src/cpu.cpp): `src/cpu.cpp`
- [Memory Inventory](https://github.com/openbmc/smbios-mdr/blob/master/src/dimm.cpp): `src/dimm.cpp`
- [PCIe Inventory](https://github.com/openbmc/smbios-mdr/blob/master/src/pcieslot.cpp): `src/pcieslot.cpp`
- [PCIe Devices](https://github.com/openbmc/smbios-mdr/blob/master/src/pciedevice.cpp): `src/pciedevice.cpp`
- [Firmware Inventory](https://github.com/openbmc/smbios-mdr/blob/master/src/firmware_inventory.cpp): `src/firmware_inventory.cpp`
- [TPM Inventory](https://github.com/openbmc/smbios-mdr/blob/master/src/tpm.cpp): `src/tpm.cpp`

### CPU Information

- [CPU Info App](https://github.com/openbmc/smbios-mdr/blob/master/src/cpuinfo_main.cpp): `src/cpuinfo_main.cpp`
- [CPU Info Utilities](https://github.com/openbmc/smbios-mdr/blob/master/src/cpuinfo_utils.cpp): `src/cpuinfo_utils.cpp`

### Speed Select

- [SST Discovery and Control](https://github.com/openbmc/smbios-mdr/blob/master/src/speed_select.cpp): `src/speed_select.cpp`
- [SST Mailbox](https://github.com/openbmc/smbios-mdr/blob/master/src/sst_mailbox.cpp): `src/sst_mailbox.cpp`

### Other components

- **Host Firmware**
- **IPMI Clients**
- **OpenBMC D-Bus**
- **I2C / PECI**

## Connections

- Host Firmware → MDRv2 Service: sends SMBIOS (evidence: `README.md`)
- IPMI Clients → SMBIOS Blob Handler: transfers blob (evidence: `README.md`)
- SMBIOS Blob Handler → SMBIOS Cache: writes table (evidence: `README.md`)
- SMBIOS Blob Handler → MDRv2 Service: requests synchronization (evidence: `README.md`)
- MDRv2 Service → SMBIOS Parser: supplies table (evidence: `src/mdrv2.cpp`)
- SMBIOS Parser → System Inventory: publishes system data
- SMBIOS Parser → CPU Inventory: publishes CPU data
- SMBIOS Parser → Memory Inventory: publishes memory data
- SMBIOS Parser → PCIe Inventory: publishes slot data
- SMBIOS Parser → PCIe Devices: publishes device data
- SMBIOS Parser → Firmware Inventory: publishes firmware data
- SMBIOS Parser → TPM Inventory: publishes TPM data
- System Inventory → OpenBMC D-Bus: exposes inventory
- CPU Inventory → OpenBMC D-Bus: exposes inventory
- Memory Inventory → OpenBMC D-Bus: exposes inventory
- PCIe Inventory → OpenBMC D-Bus: exposes inventory
- PCIe Devices → OpenBMC D-Bus: exposes inventory
- Firmware Inventory → OpenBMC D-Bus: exposes inventory
- TPM Inventory → OpenBMC D-Bus: exposes inventory
- CPU Info App → CPU Info Utilities: uses host-state utilities (evidence: `src/cpuinfo_main.cpp`)
- CPU Info App → I2C / PECI: gathers CPU details (evidence: `README.md`)
- CPU Info App → SST Discovery and Control: discovers and controls SST (evidence: `README.md`)
- SST Discovery and Control → SST Mailbox: uses mailbox
- SST Discovery and Control → OpenBMC D-Bus: publishes SST objects
