DVSim

OpenTitan logo

About the project

OpenTitan is an open source silicon Root of Trust (RoT) project. OpenTitan will make the silicon RoT design and implementation more transparent, trustworthy, and secure for enterprises, platform providers, and chip manufacturers. OpenTitan is administered by lowRISC CIC as a collaborative project to produce high quality, open IP for instantiation as a full-featured product. See the OpenTitan site and OpenTitan docs for more information about the project.

About this repository

This repository contains DVSim which is a build and run system written in Python that runs a variety of EDA tool flows. There are multiple steps involved in running EDA tool flows. DVSim encapsulates them all to provide a single, standardized command-line interface to launch them. While DVSim was written to support OpenTitan, it can be used for any ASIC project.

All EDA tool flows on OpenTitan are launched using the DVSim tool. The following flows are currently supported:

Simulations
Coverage Unreachability Analysis (UNR)
Formal (formal property verification (FPV), and connectivity)
Lint (semantic and stylistic)
Synthesis
CDC
RDC

Installation

Using nix and direnv

If you have Nix and direnv installed, then it's as simple as direnv allow ..

New to Nix? Perhaps checkout this installer which will enable flakes by default.

Using uv direct

The recommended way of installing DVSim is inside a virtual environment to isolate the dependencies from your system python install. We use the uv tool for python dependency management and creating virtual environments.

First make sure you have uv installed, see the installation documentation for details and alternative installation methods. There is a python package that can be installed with pip install uv, however the standalone installer is preferred.

macOS and Linux

curl -LsSf https://astral.sh/uv/install.sh | sh
uv venv
uv sync

From there you can run the dvsim tool.

Windows (Powershell)

irm https://astral.sh/uv/install.ps1 | iex
uv venv
uv sync

From there you can run the dvsim tool.

Using DVSim

For further information on how to use DVsim with OpenTitan see Getting Started

History

DVSim development started in the main OpenTitan repository under utils/dvsim. This repository contains the code that origionaly lived there, as well as the full git history copied over as generated by git subtree split -p utils/dvsim.

Documentation

The project contains comprehensive documentation of all IPs and tools. You can access it online at opentitan.org/book/.

How to contribute

Have a look at CONTRIBUTING and our documentation on project organization and processes for guidelines on how to contribute code to this repository.

Licensing

Unless otherwise noted, everything in this repository is covered by the Apache License, Version 2.0 (see LICENSE for full text).

Bugs

Please see link for a list of open bugs and feature requests.

Release files for dvsim 1.52.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for dvsim 1.52.1
File	Size	Uploaded
dvsim-1.52.1.tar.gz	564.5 kB	Sep 3, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for dvsim 1.52.1
File	Interpreter	ABI	Platform	Reset
dvsim-1.52.1-py3-none-any.whl 317.4 kB Sep 3, 2026	Python 3	none	any	Details

Total release size:881.9 kB

Release files / dvsim-1.52.1.tar.gz

Download URL	dvsim-1.52.1.tar.gz
Size	564.5 kB
Tags	Source
SHA-256 checksum How to use checksums	`6408a8937bf960cea9548c14d8a36276f12f1291b09470217ebda1e68733357b`
BLAKE2b-256 checksum How to use checksums	`72f985f0f2f8b578f8736d9977f18a751bf03b02e616c8d0d13be46f9635b2ea`
Upload date	Sep 3, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/lowRISC/dvsim
Publishing commit: github.com/lowRISC/dvsim/tree/e30301ae755a485394d9962dd60dd87a8dc5cd2a

Workflow

Publishing configuration: github.com/lowRISC/dvsim/blob/e30301ae755a485394d9962dd60dd87a8dc5cd2a/.github/workflows/release.yml
Publishing logs: github.com/lowRISC/dvsim/actions/runs/33732971734/attempts/1

Artifact

Subject: dvsim-1.52.1.tar.gz
SHA-256 checksum: 6408a8937bf960cea9548c14d8a36276f12f1291b09470217ebda1e68733357b Verifying attestations

Release files / dvsim-1.52.1-py3-none-any.whl

Download URL	dvsim-1.52.1-py3-none-any.whl
Size	317.4 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`f0c5013af6c7b2c54aafec99d1ceed7d1ef45792dc9a934164e86ca7cb4022e5`
BLAKE2b-256 checksum How to use checksums	`2e13b626bc0adb3aac395178cd1c60f7c47133f2c2cd8cf9facf5b09368f1d1b`
Upload date	Sep 3, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/lowRISC/dvsim
Publishing commit: github.com/lowRISC/dvsim/tree/e30301ae755a485394d9962dd60dd87a8dc5cd2a

Workflow

Publishing configuration: github.com/lowRISC/dvsim/blob/e30301ae755a485394d9962dd60dd87a8dc5cd2a/.github/workflows/release.yml
Publishing logs: github.com/lowRISC/dvsim/actions/runs/33732971734/attempts/1

Artifact

Subject: dvsim-1.52.1-py3-none-any.whl
SHA-256 checksum: f0c5013af6c7b2c54aafec99d1ceed7d1ef45792dc9a934164e86ca7cb4022e5 Verifying attestations