Skip to main content

A Python to VHDL compiler

Project description

CoHDL

CoHDL is a hardware description language embedded in Python. It translates a subset of Python into synthesizable VHDL.


examples/introduction

You can find an introduction and many examples in this documentation repository.

features

At its core CoHDLs language model is very similar to VHDL. Designs are made up of signals and variables built from types like Bit and BitVector. There are concurrent contexts, for expressions that would appear in the architecture scope of VHDL entities and sequential contexts equivalent to VHDL processes.

Code that uses only basic features also found in VHDL (if-statements, signal/variable assignments, arithmetic operators and so on) essentially looks like VHDL written in Python syntax. On top of that CoHDL supplies many additional features

coroutines

The initial motivation for CoHDL was to explore how well coroutines, found in many modern programming languages, translate to the domain of hardware description languages.

CoHDL turns Pythons async/await style coroutines into VHDL state machines. This process is completely deterministic and allows clock accurate modeling of sequential processes. The main advantage over explicit state machine implementations is, that coroutines are reusable.

Common sequences such as AXI transactions can be defined once and instantiated whenever needed.

supported Python subset

The following is an incomplete list of Python constructs supported in synthesizable contexts

  • statements
    • if
    • for
    • if expressions
    • generator expressions
    • most operators
  • functions
    • arbitrary argument types
    • default arguments
    • keyword arguments
    • variadic arguments
    • compile time recursion
    • compile time evaluated builtin functions
  • classes
    • member access
    • methods
    • operator overloading
    • inheritance
    • overriding methods
  • python container types
    • list
    • dict
  • coroutines

meta programming

Since CoHDL is embedded in Python, it is possible to run arbitrary code before and after the compilation. This can be used to load configuration files or run external programs like simulators or synthesis tools on the generated VHDL.

For a working example of this checkout cohdl_xil. It generates Makefile projects for CoHDL designs targeting Xilinx FPGAs.


getting started

CoHDL requires Python3.10 or higher and has no further dependencies. You can install it by running

python3 -m pip install cohdl

in a terminal window. You should then be able to run the code snippets, found in the introduction repository and implement own designs.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

cohdl-0.2.3.tar.gz (186.4 kB view details)

Uploaded Source

Built Distribution

cohdl-0.2.3-py3-none-any.whl (213.9 kB view details)

Uploaded Python 3

File details

Details for the file cohdl-0.2.3.tar.gz.

File metadata

  • Download URL: cohdl-0.2.3.tar.gz
  • Upload date:
  • Size: 186.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.0.0 CPython/3.11.6

File hashes

Hashes for cohdl-0.2.3.tar.gz
Algorithm Hash digest
SHA256 52e88737457cc6089537f4bfb1fae50563386d3a9238c20f90bbb6eb169af76f
MD5 040767ece54efb831223e2be0fd4bb93
BLAKE2b-256 b3063db7d581193a03718de79c10f2b1a16ba4f1abf5a9370c7e2fbf1ef58bd9

See more details on using hashes here.

Provenance

File details

Details for the file cohdl-0.2.3-py3-none-any.whl.

File metadata

  • Download URL: cohdl-0.2.3-py3-none-any.whl
  • Upload date:
  • Size: 213.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.0.0 CPython/3.11.6

File hashes

Hashes for cohdl-0.2.3-py3-none-any.whl
Algorithm Hash digest
SHA256 d6044c1511a896d8afa3e9f6d4f78f6c384c5f3ffae34701416fc6ca8ff367cd
MD5 e7131dba7c49d6c5a946fbacd4db2d47
BLAKE2b-256 aa384d383626bda97a384aad04736bc2b617d91c112bb6f0ca912b203d088892

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page