# ravenslofty/mistral architecture

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

- Interactive diagram: https://gitdiagram.com/ravenslofty/mistral
- Repository: https://github.com/ravenslofty/mistral

## Overview

Mistral is a Cyclone V bitstream library and command-line utility. The primary workflow is a user invoking a CLI command, which creates a device model and uses it to inspect or decompile bitstream data; the README notes that routing databases are expected alongside the utility. The model also exposes routing, block-mux, and timing/analog-simulation capabilities. The generator builds compact device data from text inputs. Some subsystem links are documented only at a high level; those are marked unverified rather than inferred from module names.

Main entry points: [`libmistral/cyclonev.cc`](https://github.com/ravenslofty/mistral/blob/master/libmistral/cyclonev.cc) (Cyclone V model), [`generator/generator.cc`](https://github.com/ravenslofty/mistral/blob/master/generator/generator.cc) (Data generator), [`mistral-cv/main.cc`](https://github.com/ravenslofty/mistral/blob/master/mistral-cv/main.cc) (CLI commands), [`libmistral/cv-rpats.cc`](https://github.com/ravenslofty/mistral/blob/master/libmistral/cv-rpats.cc) (Routing database)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_cli["Command interface"]
  node_cli_main["CLI commands<br/>[main.cc]"]
end

subgraph group_model["Device model"]
  node_device_model["Cyclone V model<br/>[cyclonev.cc]"]
  node_bitstream["Bitstream I/O<br/>[cv-files.cc]"]
  node_block_mux["Block muxes<br/>[cv-bmux.cc]"]
  node_route_mux["Route muxes<br/>[cv-rmux.cc]"]
  node_routing_data[("Routing database<br/>[cv-rpats.cc]")]
  node_package_data["Package data<br/>[cv-pkg.cc]"]
  node_device_models["Device variants<br/>[cvd-gt300f.cc]"]
  node_model_options["Device options<br/>[cv-opt.cc]"]
end

subgraph group_generator["Device data generation"]
  node_generator_entry["Data generator<br/>[generator.cc]"]
  node_route_parser["Route parser<br/>[routes.cc]"]
  node_node_parser["Node reader<br/>[nodes.h]"]
  node_line_parser["Wire lines<br/>[lines.h]"]
  node_driver_parser["Driver data<br/>[drivers.cc]"]
end

subgraph group_simulation["Timing simulation"]
  node_analog_sim["Analog simulator"]
  node_timing_model["Route timing<br/>[cv-rmux.cc]"]
end

node_user(("CLI user"))

node_user -->|"invokes"| node_cli_main
node_cli_main -->|"uses model"| node_device_model
node_device_model -.->|"loads data"| node_bitstream
node_cli_main -.->|"inspects muxes"| node_block_mux
node_cli_main -.->|"inspects routes"| node_route_mux
node_device_model -.->|"uses routing data"| node_routing_data
node_device_model -.->|"uses packages"| node_package_data
node_device_model -.->|"selects variant"| node_device_models
node_device_model -.->|"exposes options"| node_model_options
node_generator_entry -->|"parses routes"| node_route_parser
node_generator_entry -->|"reads nodes"| node_node_parser
node_generator_entry -->|"parses lines"| node_line_parser
node_generator_entry -->|"parses drivers"| node_driver_parser
node_generator_entry -.->|"writes data"| node_routing_data
node_cli_main -.->|"runs simulation"| node_analog_sim
node_timing_model -.->|"builds circuit"| node_analog_sim

click node_cli_main "https://github.com/ravenslofty/mistral/blob/master/mistral-cv/main.cc"
click node_device_model "https://github.com/ravenslofty/mistral/blob/master/libmistral/cyclonev.cc"
click node_bitstream "https://github.com/ravenslofty/mistral/blob/master/libmistral/cv-files.cc"
click node_block_mux "https://github.com/ravenslofty/mistral/blob/master/libmistral/cv-bmux.cc"
click node_route_mux "https://github.com/ravenslofty/mistral/blob/master/libmistral/cv-rmux.cc"
click node_routing_data "https://github.com/ravenslofty/mistral/blob/master/libmistral/cv-rpats.cc"
click node_package_data "https://github.com/ravenslofty/mistral/blob/master/libmistral/cv-pkg.cc"
click node_device_models "https://github.com/ravenslofty/mistral/blob/master/libmistral/cvd-gt300f.cc"
click node_model_options "https://github.com/ravenslofty/mistral/blob/master/libmistral/cv-opt.cc"
click node_generator_entry "https://github.com/ravenslofty/mistral/blob/master/generator/generator.cc"
click node_route_parser "https://github.com/ravenslofty/mistral/blob/master/generator/routes.cc"
click node_node_parser "https://github.com/ravenslofty/mistral/blob/master/generator/nodes.h"
click node_line_parser "https://github.com/ravenslofty/mistral/blob/master/generator/lines.h"
click node_driver_parser "https://github.com/ravenslofty/mistral/blob/master/generator/drivers.cc"
click node_analog_sim "https://github.com/ravenslofty/mistral/blob/master/libmistral/mistral-analogsim.cc"
click node_timing_model "https://github.com/ravenslofty/mistral/blob/master/libmistral/cv-rmux.cc"

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_cli_main,node_user toneBlue
class node_device_model,node_bitstream,node_block_mux,node_route_mux,node_routing_data,node_package_data,node_device_models,node_model_options toneAmber
class node_generator_entry,node_route_parser,node_node_parser,node_line_parser,node_driver_parser toneMint
class node_analog_sim,node_timing_model toneRose
```

## Components

### Command interface

- [CLI commands](https://github.com/ravenslofty/mistral/blob/master/mistral-cv/main.cc): `mistral-cv/main.cc`

### Device model

- [Cyclone V model](https://github.com/ravenslofty/mistral/blob/master/libmistral/cyclonev.cc): `libmistral/cyclonev.cc`
- [Bitstream I/O](https://github.com/ravenslofty/mistral/blob/master/libmistral/cv-files.cc): `libmistral/cv-files.cc`
- [Block muxes](https://github.com/ravenslofty/mistral/blob/master/libmistral/cv-bmux.cc): `libmistral/cv-bmux.cc`
- [Route muxes](https://github.com/ravenslofty/mistral/blob/master/libmistral/cv-rmux.cc): `libmistral/cv-rmux.cc`
- [Routing database](https://github.com/ravenslofty/mistral/blob/master/libmistral/cv-rpats.cc): `libmistral/cv-rpats.cc`
- [Package data](https://github.com/ravenslofty/mistral/blob/master/libmistral/cv-pkg.cc): `libmistral/cv-pkg.cc`
- [Device variants](https://github.com/ravenslofty/mistral/blob/master/libmistral/cvd-gt300f.cc): `libmistral/cvd-gt300f.cc`
- [Device options](https://github.com/ravenslofty/mistral/blob/master/libmistral/cv-opt.cc): `libmistral/cv-opt.cc`

### Device data generation

- [Data generator](https://github.com/ravenslofty/mistral/blob/master/generator/generator.cc): `generator/generator.cc`
- [Route parser](https://github.com/ravenslofty/mistral/blob/master/generator/routes.cc): `generator/routes.cc`
- [Node reader](https://github.com/ravenslofty/mistral/blob/master/generator/nodes.h): `generator/nodes.h`
- [Wire lines](https://github.com/ravenslofty/mistral/blob/master/generator/lines.h): `generator/lines.h`
- [Driver data](https://github.com/ravenslofty/mistral/blob/master/generator/drivers.cc): `generator/drivers.cc`

### Timing simulation

- [Analog simulator](https://github.com/ravenslofty/mistral/blob/master/libmistral/mistral-analogsim.cc): `libmistral/mistral-analogsim.cc`
- [Route timing](https://github.com/ravenslofty/mistral/blob/master/libmistral/cv-rmux.cc): `libmistral/cv-rmux.cc`

### Other components

- **CLI user**

## Connections

- CLI user → CLI commands: invokes
- CLI commands → Cyclone V model: uses model (evidence: `mistral-cv/main.cc`)
- Cyclone V model → Bitstream I/O: loads data
- CLI commands → Block muxes: inspects muxes
- CLI commands → Route muxes: inspects routes
- Cyclone V model → Routing database: uses routing data
- Cyclone V model → Package data: uses packages
- Cyclone V model → Device variants: selects variant
- Cyclone V model → Device options: exposes options
- Data generator → Route parser: parses routes (evidence: `generator/generator.cc`)
- Data generator → Node reader: reads nodes (evidence: `generator/generator.cc`)
- Data generator → Wire lines: parses lines (evidence: `generator/generator.cc`)
- Data generator → Driver data: parses drivers (evidence: `generator/generator.cc`)
- Data generator → Routing database: writes data
- CLI commands → Analog simulator: runs simulation
- Route timing → Analog simulator: builds circuit
