Simulator

Die aktuellen Simulator Versionen 1.7 nach dem 30.10.2012 können nur noch zusammen mit den Quellen des SpartanMC-SoC aus dem GIT ausgefasst werden. Der Simulator verwendet die Biblioteken des Systembilders zur Erstellung der Konfiguration aus den *.xml Dateien die mit dem Systembilder für jedes Projekt erstellt werden. Desshalb ist er nur noch in dem Verzeichnissystem des SoC lauffähig.

Java Version 1.7 wird benötigt.

Der Simulator befindet sich im Verzeichnis $SPARTANMC_ROOT/bin/sim und kann in diesem Verzeichnis mit dem Kommando "java -jar sim.jar &" gestartet werden.

Der Simulator wird in einem Projekt mit dem Kommando make spmcsim gestartet.

Nach dem Start muss als 1. die *.xml Datei des Projektes eingelesen werden, um die Hardware des Simulators genau wie im Projekt einzustellen. Sie wird mit "Load jConfig Document" eingelesen. Danach kann dann die übersetzte Firmware mit "Load Firmware Program" geladen werden. Dazu wird im Simulator die *.sph Dateien aus den Verzeichnispfad des Projekts z.B.:"build/firmware/subsystem_0/spartanmc_0.sph" geladen. Um die Symbolischen Adressen in der Simulation mit anzuzeigen, kann ein Programm auch mit "Load Firmware Listing" als listfile *.lst geladen werden. Eine Datei *.lst kann im gleichen Verzeichnis wo auch die *.sph Datei steht erstellt werden, wenn man im Projektverzeichnis "make firmware" aufruft. Nach dem öffnen der benötigten Fenster zur Anzeige der Register und der Speicherinhalte kann die Simulation gestartet werden.

Konfigurations Einstellungen des Simulators, die nicht in der XML-Datei stehen:

  1. unter Settings im Simulator den Zeichensatz auf Courier New stellen. (unter LINUX DejaVu Sans Mono wählen. Die Schriftart Monospaced ist nicht immer geeignet!)
  2. im Fenster Assembly/Settings "18 Bit addresses" wählen. (Simulatorfehler bei 9 Bit)
  3. Wird eine UART verwendet, dann im Fenster der UART die Einstellung "Newline character 0xd" als Code der ENTER Taste einstellen.

Sind alle Einstellungen vorgenommen, dann kann man im Simulator alle Einstellungen mit "Save Project Environment" in einer *.spmc Datei sichern. In dieser Datei werden auch alle Fensterpositionen und Größen gesichert. Bei einem erneutem Start können dann alle Einstellungen aus dieser Datei geladen werden. Der Start erfolgt dann mit:

make spmcsim +args="project.spmc"

Danach sind dann keine weiteren Einstellungen mehr notwendig. Die Simulation kann sofort gestartet werden.

weitere Lektüre


ACHTUNG, das Simulatorfenster kann zur Zeit nicht maximiert werden!

Durch einen Fehler im Java unter Linux ist nach dem Maximieren des Fensters keine Eingabe mehr möglich. Das Fenster muss über die Ecken und Kanten durch Ziehen mit der Maus vergrößert werden! Wird dann nach dem Einrichten des Fensters die "project.spmc" Datei erstellt, dann wird beim nächsten Start mit dieser Datei (siehe oben) auch das Fenster wieder in dieser Größe hergestellt. Die Project Dateien sind Rechner spezifisch und können nur auf dem Rechner verwendet werden, auf dem sie erstellt wurden!

Lehre

SpartanMC