Deployed 64e1339 with MkDocs version: 1.5.3

index.html

@@ -640,13 +640,15 @@ <h2 id="quick-start">Quick Start</h2>
 </code></pre>
 <p>and then run a <a href="https://pulp-platform.github.io/carfield/tg/sim">simulation</a> with Questasim by
 typing:</p>
-<pre><code>make car-vsim-sim-build
-cd target/sim/vsim &amp;&amp; car-vsim-sim-run CHS_BINARY=../../../sw/tests/bare-metal/hostd/helloworld.car.l2.elf
+<pre><code class="language-tcl">cd target/sim/vsim
+make car-vsim-sim-build
+make car-vsim-sim-run CHS_BINARY=../../../sw/tests/bare-metal/hostd/helloworld.car.l2.elf
 </code></pre>
 <hr />
 <p>To display the main <em>Make</em> build targets and their usage, from the root repository type:</p>
-<pre><code>make help
+<pre><code class="language-tcl">make help
 </code></pre>
+<p>The Make files are autodocumented.</p>
 <h2 id="license">License</h2>
 <p>Unless specified otherwise in the respective file headers, all code checked into this repository is
 made available under a permissive license. All hardware sources and tool scripts are licensed under

tg/sim/index.html

@@ -834,17 +834,29 @@ <h2 id="questasim">QuestaSim</h2>
 <p>After building Carfield, the design can be compiled and simulated with QuestaSim. Below, we provide
 an example with <code>Serial Link</code> passive preload of a baremetal program <code>helloworld.car.l2.elf</code> to be
 executed on the <em>host domain</em> (Cheshire, i.e., <code>X=CHS</code>):</p>
-<pre><code class="language-tcl"># Compile the design
+<pre><code class="language-tcl"># Initialize Carfield
+make car-init-all
+
+# Enter Questasim folder
+cd target/sim/vsim
+
+# Compile the design
 make car-vsim-sim-build
 
 # Preload `helloworld.car.l2.elf` in passive bootmode through serial link, then start the simulation
-cd target/sim/vsim &amp;&amp; make car-vsim-sim-run CHS_BOOTMODE=0 CHS_PRELMODE=1 CHS_BINARY=../../../sw/tests/bare-metal/hostd/helloworld.car.l2.elf
+make car-vsim-sim-run CHS_BOOTMODE=0 CHS_PRELMODE=1 CHS_BINARY=../../../sw/tests/bare-metal/hostd/helloworld.car.l2.elf
 </code></pre>
 <p>The design needs to be recompiled only when hardware is changed.</p>
+<p>To clean simulation builds, from the <code>vsim</code> folder run</p>
+<pre><code class="language-tcl">make car-vsim-sim-clean
+</code></pre>
+<p>To display general help for each <em>Make</em> target, type</p>
+<pre><code class="language-tcl">make help
+</code></pre>
 <h3 id="debugging">Debugging</h3>
 <p>Per default, Questasim compilation is performance-optimised, and GUI and simulation logging are
-disabled. To enable full visibility, logging, and the Questa GUI, set <code>DEBUG=1</code> when executing the
-steps above.</p>
+disabled. To enable full visibility, logging, and the Questa GUI, set <code>DEBUG=1</code> when launching the
+simulation.</p>