Skip to content

Commit d2da94f

Browse files
committed
doc: Started tool specify section.
1 parent efdbdcd commit d2da94f

File tree

2 files changed

+156
-0
lines changed

2 files changed

+156
-0
lines changed

doc/ToolSpecific.rst

Lines changed: 155 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,155 @@
1+
.. _SIM:
2+
3+
Simulator Specifics
4+
###################
5+
6+
Quick Overview
7+
**************
8+
9+
.. tab-set::
10+
11+
.. tab-item:: Aldec Riviera-PRO
12+
:sync: Riviera
13+
14+
Initialize the OSVVM Script environment by sourcing :file:`StartUp.tcl` within Riviera-PRO's GUI or Tcl console:
15+
16+
.. code-block:: tcl
17+
18+
source <path-to-OsvvmLibraries>/OsvvmLibraries/Scripts/StartUp.tcl
19+
20+
.. tab-item:: Siemens Visualizer
21+
:sync: Visualizer
22+
23+
TODO
24+
25+
.. code-block:: tcl
26+
27+
source <path-to-OsvvmLibraries>/OsvvmLibraries/Scripts/StartUp.tcl
28+
29+
.. tab-item:: Siemens EDA Questa / QuestaSim
30+
:sync: Questa
31+
32+
TODO
33+
34+
.. code-block:: tcl
35+
36+
source <path-to-OsvvmLibraries>/OsvvmLibraries/Scripts/StartUp.tcl
37+
38+
.. tab-item:: Siemens EDA ModelSim
39+
:sync: ModelSim
40+
41+
TODO
42+
43+
.. code-block:: tcl
44+
45+
source <path-to-OsvvmLibraries>/OsvvmLibraries/Scripts/StartUp.tcl
46+
47+
48+
Aldec
49+
*****
50+
51+
Active-HDL
52+
==========
53+
54+
Initialize the OSVVM Script environment with the following commands:
55+
56+
.. code-block:: tcl
57+
58+
scripterconf -tcl
59+
do -tcl <path-to-OsvvmLibraries>/OsvvmLibraries/Scripts/StartUp.tcl
60+
61+
Want to avoid doing this every time? For ActiveHDL, edit :file:`/script/startup.do` and add above to it. Similarly for
62+
**VSimSA**, edit :file:`/BIN/startup.do` and add the above to it.
63+
64+
.. note::
65+
66+
Note, with 2021.02, you no longer need to set the "Start In" directory to the OSVVM Scripts directory.
67+
68+
69+
Riviera-PRO
70+
===========
71+
72+
AMD (Xilinx)
73+
************
74+
75+
xSim
76+
====
77+
78+
79+
Cadence
80+
*******
81+
82+
Xcelium
83+
=======
84+
85+
86+
GHDL
87+
****
88+
89+
GHDL on Windows in MSYS2/UCRT64
90+
===============================
91+
92+
Initialize the OSVVM Script environment within **tclsh**:
93+
94+
.. code-block:: tcl
95+
96+
winpty tclsh
97+
source <path-to-OsvvmLibraries>/OsvvmLibraries/Scripts/StartUp.tcl
98+
99+
To simplify the startup process, put :file:`source <path-to-OsvvmLibraries>/OsvvmLibraries/Scripts/StartUp.tcl` into
100+
:file:`.tclshrc` and add a Windows short cut that calls ``C:\msys64\ucrt64.exe winpty tclsh``. This will open a UCRT64
101+
console window with a Tcl shell and pre-loaded OSVVM Script environment.
102+
103+
.. hint::
104+
105+
``tclsh`` and ``tcllib`` might be missing in a fresh MSYS2/UCRT64 environment. |br|
106+
Use **pacman** to install the necessary Tcl dependencies:
107+
108+
.. code-block:: Bash
109+
110+
pacman -S ucrt64/mingw-w64-ucrt-x86_64-winpty
111+
pacman -S ucrt64/mingw-w64-ucrt-x86_64-tcl ucrt64/mingw-w64-ucrt-x86_64-tcllib
112+
113+
GHDL on Linux/macOS
114+
===================
115+
116+
Initialize the OSVVM Script environment within **tclsh**:
117+
118+
.. code-block:: tcl
119+
120+
rlwrap tclsh
121+
source <path-to-OsvvmLibraries>/OsvvmLibraries/Scripts/StartUp.tcl
122+
123+
To simplify this, put :file:`source <path-to-OsvvmLibraries>/OsvvmLibraries/Scripts/StartUp.tcl` in the :file:`.tclshrc`
124+
file and in Bash add ``alias gsim='rlwrap tclsh'`` to your :file:`.bashrc`.
125+
126+
127+
NVC
128+
***
129+
130+
NVC on Windows in MSYS2/UCRT64
131+
==============================
132+
133+
NVC on Linux
134+
============
135+
136+
Siemens EDA
137+
***********
138+
139+
ModelSim
140+
========
141+
142+
143+
Questa / QuestaSim
144+
==================
145+
146+
147+
Visualizer
148+
==========
149+
150+
151+
Synopsys
152+
********
153+
154+
VCS
155+
===

doc/index.rst

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -46,6 +46,7 @@ License
4646

4747
Installation
4848
QuickStartGuide
49+
ToolSpecific
4950

5051
.. raw:: latex
5152

0 commit comments

Comments
 (0)