mirror of
https://github.com/myhdl/myhdl.git
synced 2024-12-14 07:44:38 +08:00
79 lines
2.2 KiB
Plaintext
79 lines
2.2 KiB
Plaintext
MyHDL Release 0.2
|
|
=================
|
|
|
|
INTRODUCTION
|
|
------------
|
|
|
|
MyHDL is a Python package for using Python as a hardware description
|
|
language. Popular hardware description languages, like Verilog and
|
|
VHDL, are compiled languages. Python with MyHDL can be viewed as a
|
|
"scripting language" counterpart of such languages. However, Python is
|
|
more accurately described as a very high level language (VHLL). MyHDL
|
|
users have access to the amazing power and elegance of Python for
|
|
their modeling work.
|
|
|
|
The key idea behind MyHDL is to use Python generators to model the
|
|
concurrency required in hardware descriptions. As generators are a
|
|
recent Python feature, MyHDL requires Python 2.2.2 or higher.
|
|
|
|
MyHDL can be used to experiment with high level modeling, and with
|
|
verification techniques such as unit testing. The most important
|
|
practical application however, is to use it as a hardware verification
|
|
language by co-simulation with Verilog and VHDL.
|
|
|
|
The present release, MyHDL 0.2, enables MyHDL for co-simulation. The
|
|
MyHDL side is designed to work with any simulator that has a PLI. For
|
|
each simulator, an appropriate PLI module in C needs to be
|
|
provided. The release contains such a module for the Icarus Verilog
|
|
simulator.
|
|
|
|
|
|
INSTALLATION
|
|
------------
|
|
|
|
If you have superuser power, you can install MyHDL as follows:
|
|
|
|
python setup.py install
|
|
|
|
This will install the package in the appropriate site-wide Python
|
|
package location.
|
|
|
|
Otherwise, you can install it in a personal directory, e.g. as
|
|
follows:
|
|
|
|
python setup.py install --home=$HOME
|
|
|
|
In this case, be sure to add the appropriate install dir to the
|
|
$PYTHONPATH.
|
|
|
|
If necessary, consult the distutils documentation in the standard
|
|
Python library if necessary for more details; or contact me.
|
|
|
|
You can test the installation as follows:
|
|
|
|
cd test
|
|
python test.py
|
|
|
|
To install co-simulation support:
|
|
|
|
Go to the directory co-simulation/<platform> for your target platform
|
|
and following the instructions in the README.txt file. Currently, the
|
|
only supported platform is Icarus.
|
|
|
|
|
|
DOCUMENTATION
|
|
-------------
|
|
|
|
See the doc/ subdirectory.
|
|
|
|
|
|
EXAMPLES
|
|
--------
|
|
|
|
See the example/ subdirectory for examples.
|
|
|
|
|
|
AUTHOR
|
|
------
|
|
Jan Decaluwe <jan@jandecaluwe.com>
|