Skip to main content

dau build

Build tools for dau

Build Status codecov License

Overview

dau-build turns a declarative FPGA build spec into the files a build needs: generated SystemVerilog, artlink.manifest/v0 artifact bundles, backend handoff manifests, Vivado Tcl, and ordered hardware command plans. The operations are typed ccflow.CallableModels composed from the Hydra config tree in dau_build/config. The whole pipeline composes, inspects and tests on a development machine; the steps that need Vivado, a JTAG cable or a PCIe bus run only when you pass execute=true.

Two synthesis engines are supported: Vivado for the FPGA bitstream flow, and yosys for open-source synthesis that runs in CI. The config plumbing does not depend on either, so more can be added.

Other packages extend dau-build by composition rather than by editing it. A package registers its own config tree on the shared Hydra search path through a hydra.lernaplugins entry point, and its task, design and board groups then compose through this CLI without dau-build importing the package. The core registry arrives the same way: dau-core publishes each hardware building block as a CoreDefinition at /dau-core/<name>, and the synthesize-cores task resolves cores from that registry to characterize them one at a time, out of context. Without a synthesis host it stages the Tcl and a command plan; with model.execute=true on a machine that has Vivado it runs the synthesis and reports any drift from the resource and timing envelope the registry records:

dau-build task=tasks/build/synthesize-cores   'model.cores=[/dau-core/int32-predicate-filter]'   model.output_root=outputs/ooc model.part=xc7a200tfbg484-2

Installation

Python 3.11 or later. There is no package index release yet; install from a clone or straight from GitHub:

pip install git+https://github.com/dau-dev/dau-build.git

For development, clone and run make develop. Vivado and yosys are needed only for the steps that run them; everything else composes, generates and tests without them.

Quickstart

Build the checked-in identity example. No board and no vendor tools are needed:

dau-build task=tasks/spec/inspect  spec=specs/identity
dau-build task=tasks/spec/build     spec=specs/identity model.output_root=outputs/identity
dau-build task=tasks/spec/validate  model.manifest_path=outputs/identity/dau-identity.manifest model.root=outputs/identity
dau-build task=tasks/sim/simulate   spec=specs/identity model.module=dau_identity_top

Task names are paths into the config tree (task=tasks/spec/inspect).

Documentation

Metadata

Release files for dau-build 0.15.2

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

Source distribution (sdist)

Source distribution for dau-build 0.15.2
File Size Uploaded Provenance Actions
dau_build-0.15.2.tar.gz 270.6 kB Without provenance Details for dau_build-0.15.2.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for dau-build 0.15.2
File Interpreter ABI Platform Actions
dau_build-0.15.2-py3-none-any.whl Python 3 none any Details for dau_build-0.15.2-py3-none-any.whl

Total release size: 592.5 kB

Release files / dau_build-0.15.2.tar.gz

Download URL dau_build-0.15.2.tar.gz
Size 270.6 kB
Tags Source
SHA-256 checksum
How to use checksums
ab57f9a6b9e2db0160f0d7c313d939a25a8fe9656286fd77a3a4d14dc172ed04
BLAKE2b-256 checksum
How to use checksums
9325a67b6ed55a73bc6fab72a35a1c8deec1dcf6ed5f711b8c7114cfec7a5430
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.15

Release files / dau_build-0.15.2-py3-none-any.whl

Download URL dau_build-0.15.2-py3-none-any.whl
Size 321.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
b320d2b45b247c45cd1a55580da9eb2265635473bebda690073ac0ce28674dbf
BLAKE2b-256 checksum
How to use checksums
1e672226fb8a0aba1bb67de7acaf002d04886f646cedcda66b60078b288f69e2
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.15

Security for dau-build 0.15.2

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.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page