myhdl.v2we workspace¶

Prototyping/examples for 'next generation' HDL.

It is assumed, that you are familiar with Python and Jupyter Notebooks (see also below).

myHDL emulation¶

This is still a draft for some 'next generation' syntax, however some compatibility will be preserved. See 'Changes' below.

For details, see

• Syntax issues:
  • Changes from 'classic' myHDL
  • Migration notes - Porting legacy myHDL code
• Advanced tricks:
  • Factory classes: Object oriented, fully parametrizeable @block creation
  • Composite classes:
    • Signals associated with RTL elements
    • Counter abstractions (Gray counter)
• Pitfalls: Classical 'programming' mistakes and legacy issues
  • Arithmetic issues and pitfalls
  • Boolean pitfalls
  • Conditional code issues
  • Concat issues

Basic examples:

• Gray counter
• Simple hysteresis example with FSM
• Barrel shifter
  • From the 'library': Cythonized barrel shifter

Direct synthesis and CXXRTL simulation via yosys:

• RTLIL target - Direct generation and simulation of synthesizable elements
• Memory inference tests - From functional memory description to FPGA block RAM

IRL extension examples¶

• Generators - Advanced procedural generation of RTL
  • Pipeline generator example
  • Advanced generators - Advanced generator examples for verification
  • CRC generator
  • 10b8b encoder/decoder - Digital Video (HDMI) 10b8b coding
• Creation by derivation - Examples from the Cyrite library (Memory, ...)
  • Register map / SoC auxiliaries - Register map decoders
  • Dual port memory (VHDL)
  • Vector operations: RGB to YUV conversion - Pipeline and basic vector extensions
• Fun stuff - Things you could do but maybe shouldn't...
  • Defining your own infix operators
  • Using HDL style <= for signal assignments

Kernel reference and examples¶

Documentation examples/HOWTOs - The HOWTO and kernel reference 'manual' for developers

Mybinder¶

The mybinder environment allows you to run your HDL simulation demos via the browser in a virtual machine, spinning somewhere in the cloud. This virtual machine is supplied as a Docker container hackfin/myhdl_v2we (check for matching tag in the Dockerfile of this repo). If you don't feel safe with clouds in general, you can also run it locally as specified in the myhdl_v2we README.

To create your own notebooks, you may simply use your own repo and pull them using git, such as this fork from @pcornier's project (unverified to synthesize):

Open 1pCPU

Or, you might just create a fork of this project via github and change the code of the launch button in README.md (replace hackfin by your user ID).

[![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/hackfin/myhdl.v2we.git/HEAD?filepath=examples%2Findex.ipynb)

Note: One important thing to know: Google binders can time out and your work is then lost. For persistent storage of your notebook, you can:

• Use an authentication token to push your changes to a git repo
• Download the notebook and store locally

The safest method is to run the container locally and mount your project's directory as /work volume.