Added VHDL export to the documentation.

This commit is contained in:
hneemann 2017-08-20 21:52:19 +02:00
parent e95650e1eb
commit 4a0ac4f0be
3 changed files with 55 additions and 0 deletions

View File

@ -42,6 +42,11 @@ These are the main features of Digital:
but sufficient for beginners exercises, easy to understand and well documented. Also the
[ATF1502](http://www.microchip.com/wwwproducts/en/ATF1502AS) and
[ATF1504](http://www.microchip.com/wwwproducts/en/ATF1504AS) are supported which offer 32/64 macro-cells.
- Export to VHDL: A circuit can be exported to VHDL. There is also support for the
[BASYS3 Board](https://reference.digilentinc.com/reference/programmable-logic/basys-3/start), which means
that the constrains file containing the pin-mapping is created.
[Xilinx-Vivado](https://www.xilinx.com/products/design-tools/vivado.html) is needed to create the bitstream
and to programm the board. The examples folder contains a variant of the simple CPU, which can run on a BASYS3 board.
- SVG export of circuits, including a LaTeX/Inkscape compatible SVG version (see
[ctan](https://www.ctan.org/tex-archive/info/svg-inkscape))
- No legacy code

View File

@ -163,6 +163,32 @@
Unter Linux lässt sich <e>fit1502.exe</e> ebenfalls von Digital starten, wenn <e>wine</e> installiert ist.
</par>
</chapter>
<chapter name="VHDL">
<par>
Eine Schaltung kann zu VHDL exportiert werden. Dabei wird eine Datei erzeugt, welche die komplette
Beschreibung der Schaltung enthält. Der erzeugte VHDL code wurde mit
<a href="https://www.xilinx.com/products/design-tools/vivado.html">Xilinx Vivado</a>
und dem Open Source VHDL Simulator <a href="http://ghdl.free.fr/">ghdl</a> getestet.
</par>
<par>
Wenn eine Schaltung Testfälle enthält, wird anhand der Testdaten eine VHDL-Test-Bench erzeugt.
Diese kann verwendet werden, um die korrekte Funktion der Schaltung in einer VHDL Simulation zu
überprüfen.
</par>
<par>
Für spezielle Boards können zusätzliche Dateien erzeugt werden. Zur Zeit wird nur das
<a href="https://reference.digilentinc.com/reference/programmable-logic/basys-3/start">BASYS3</a> Board unterstützt.
Dabei wird eine Constrains-Datei erzeugt, welche die Zuordnung der Pins beinhaltet. Die Bezeichnung der Pins
kann dem BASYS3 Datenblatt entnommen werden, und muss als Pinnummer bei den Ein- und Ausgängen eingetragen werden.
Soll eine Schaltung auf einem BASYS3 Board laufen, kann in Vivado ein neues Projekt angelegt werden.
Dabei ist die erzeugte VHDL Datei und die Constrains-Datei
dem Projekt hinzuzufügen. Wurde das Projekt erstellt, kann der Bitstream erzeugt und in ein BASYS3 Board geladen werden.
</par>
<par>
Um neben der VHDL Datei auch die erforderliche Constrains-Datei erzeugen zu lassen, muss die Schaltung
ein Textfeld mit dem Text "Board: BASYS3" enthalten.
</par>
</chapter>
<chapter name="Häufig gestellte Fragen">
<faq>
<question>Wie kann ich eine Leitung verschieben?</question>

View File

@ -156,6 +156,30 @@
On Linux systems, <e>fit1502.exe</e> can also be executed by Digital if <e>wine</e> is installed.
</par>
</chapter>
<chapter name="VHDL">
<par>
A circuit can be exported to VHDL. A file is generated which contains the complete description of the circuit.
The generated VHDL code was tested with <a href="https://www.xilinx.com/products/design-tools/vivado.html">Xilinx Vivado</a>
and the open source VHDL simulator <a href="http://ghdl.free.fr/">ghdl</a>.
</par>
<par>
If a circuit contains test cases, the test data is used to generate a VHDL test bench. This can be used to
check the correct function of the circuit in a VHDL simulation.
</par>
<par>
Additional files can be created for special boards. At present only the
<a href="https://reference.digilentinc.com/reference/programmable-logic/basys-3/start">BASYS3</a>
board is supported.
A constrains file is created, which contains the assignment of the pins. The description of the pins can be
found in the BASYS3 data sheet, and must be entered as a pin number for the inputs and outputs.
If a circuit is to run on a BASYS3 board, a new project can be created in Vivado.
The generated VHDL file and the constraints file must be added to the project.
Once the project has been created, the bitstream can be generated and loaded into a BASYS3 board.
</par>
<par>
To create the required constrains file, the circuit must contain a text field with the text "Board: BASYS3".
</par>
</chapter>
<chapter name="Frequently asked Questions">
<faq>
<question>How to move a wire?</question>