1
0
mirror of https://github.com/myhdl/myhdl.git synced 2024-12-14 07:44:38 +08:00
myhdl/README.md
2016-12-08 16:43:50 -05:00

75 lines
2.0 KiB
Markdown

MyHDL 1.0dev
============
[![Join the chat at https://gitter.im/jandecaluwe/myhdl](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/myhdl/myhdl?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
[![Documentation Status](https://readthedocs.org/projects/myhdl/badge/?version=stable)](http://docs.myhdl.org/en/stable/manual)
[![Documentation Status](https://readthedocs.org/projects/myhdl/badge/?version=latest)](http://docs.myhdl.org/en/latest/manual)
[![Build Status](https://travis-ci.org/myhdl/myhdl.svg?branch=master)](https://travis-ci.org/myhdl/myhdl)
What is MyHDL?
--------------
MyHDL is a free, open-source package for using Python as a hardware
description and verification language.
To find out whether MyHDL can be useful to you, please read:
- http://www.myhdl.org/start/why.html
License
-------
MyHDL is available under the LGPL license. See ``LICENSE.txt``.
Website
-------
The project website is located at http://www.myhdl.org
Documentation
-------------
The manual is available on-line:
- http://docs.myhdl.org/en/stable/manual
What's new
----------
To find out what's new in this release, please read:
- http://docs.myhdl.org/en/stable/whatsnew/0.9.html
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 proper installation as follows:
```
cd myhdl/test/core
py.test
```
To install co-simulation support:
Go to the directory ``cosimulation/<platform>`` for your target platform
and following the instructions in the ``README.txt`` file.