
Domänenspezifische Sprache zum Schreiben schneller funktionaler Gerätemodelle für virtuelle Plattformen. Kompiliert DML zu C mit für den Intel Simics Simulator maßgeschneiderten API-Aufrufen und ermöglicht so Hardwaresimulation und Sicherheitstests.
Die Device Modeling Language (DML) ist eine domänenspezifische Sprache zum Schreiben schneller funktionaler oder transaktionsbasierter Gerätemodelle für virtuelle Plattformen. DML bietet High-Level-Abstraktionen, die für funktionale Gerätemodelle geeignet sind, einschließlich Konstrukten wie Registerbänken, Registern, Bitfeldern, Event-Posting, Schnittstellen zwischen Modellen und Logging. DML-Code wird vom DML Compiler (DMLC) kompiliert, der C- Code mit auf einen bestimmten Simulator zugeschnittenen API-Aufrufen erzeugt.
Derzeit unterstützt der Compiler das Erstellen von Modellen für den Intel® Simics® Simulator, aber andere Back-Ends könnten in Zukunft hinzugefügt werden.
Um DMLC zu bauen, benötigen Sie eine Simics- Simulator-Installation und ein eingerichtetes Simics-Projekt.
Wenn Sie noch keine Simics-Simulator-Installation haben oder keinen Zugang zum Simics-Simulator über kommerzielle Kanäle, installieren Sie die Public Release des Intel Simics Simulators und erstellen Sie ein Simics-Projekt (automatisch im Standardinstallationsablauf).
Ihr Simics-Projekt muss so eingerichtet sein, dass es Host-Python verwendet (indem
--python an project-setup übergeben wird), und darf ply==3.4 nicht in seiner
requirements.txt-Datei pinnen.
Checken Sie in diesem Projekt das DML-Repository in das Verzeichnis modules/dmlc
aus. Konfigurieren Sie dann CMake* (siehe Using CMake with the Intel
Simics Simulator),
indem Sie -DSIMICS_DMLC_DIR=<your-project>/<hosttype>/bin übergeben, um sicherzustellen, dass Geräte,
die Sie über CMake bauen, Ihr lokales DMLC nutzen. Danach kann DMLC über
cmake --build bt --target dmlc gebaut werden.
Um die mit DMLC bereitgestellten Unit-Tests auszuführen, führen Sie
bin/test-runner --suite modules/dmlc/test vom obersten Verzeichnis des Projekts aus.
Die folgenden Umgebungsvariablen sind bei der Entwicklung von DMLC praktisch. Wenn Sie
regelmäßig mit einem lokal gebauten DMLC arbeiten, sollten Sie die Variablen
DMLC_DIR, T126_JOBS, DMLC_PATHSUBST und PY_SYMLINKS in Ihrer
.bashrc setzen. Die übrigen Variablen sollten besser nur bei Bedarf aktiviert werden.
Nach dem Bauen von DMLC müssen Sie DMLC_DIR auf <your-project>/<hosttype>/bin
in nachfolgenden Aufrufen von make setzen, um Geräte mit dem lokal
gebauten Compiler zu bauen. <hosttype> ist entweder linux64 oder win64, je nach
Host-Typ.
Wenn gesetzt, wird die angegebene Anzahl von Tests parallel ausgeführt.
Der DMLC-Build kopiert einige DML-Bibliotheksdateien, z. B. dml-builtins.dml, nach
<hosttype>/bin. Wenn ein Kompilierfehler auftritt, verweisen Fehlermeldungen normalerweise
auf diese Kopie statt auf die Quelle. Durch Setzen von DMLC_PATHSUBST auf
<hosttype>/bin/dml=modules/dmlc/lib werden Fehlermeldungen so umgeschrieben, dass sie
stattdessen auf die Quelldatei verweisen. <hosttype> ist entweder linux64 oder win64,
je nach Host-Typ.
Wenn auf 1 gesetzt, erstellt make dmlc symbolische Links auf Python-Dateien, anstatt sie
zu kopieren. Dies hat zwei Effekte: Python-Tracebacks führen Sie zur Quelldatei
im Repository, und Sie müssen make nach dem Bearbeiten von Python-
Dateien nicht erneut ausführen.
Wenn auf 1 gesetzt, werden unerwartete Ausnahmen im Compiler auf
stderr ausgegeben. Standardmäßig werden Tracebacks in einer Datei dmlc-error.log verborgen.
Überschreibt den Standard-Compiler in Unit-Tests.
Wenn gesetzt, führt DMLC ein Selbst-Profiling durch und schreibt das Profil in eine .prof-Datei.
Wenn gesetzt, erzeugt DMLC ein .tar.bz2-Archiv, das alle DML-Quelldateien enthält und so gepackt ist, dass es eigenständig kompiliert werden kann. Dies ist nützlich, wenn ein DML-Problem in einer komplexen Build-Umgebung auftritt und Sie das Problem isoliert reproduzieren möchten. Im erzeugten Archiv befinden sich alle DML-Dateien im selben Verzeichnis (entweder auf oberster Ebene oder unter einer Reihe von Unterverzeichnissen namens _), und relative Importe werden dadurch behandelt, dass auch Symlinks in das Archiv aufgenommen werden. Unter Windows kann DMLC diese Symlinks manchmal nicht korrekt auflösen; aus diesem Grund wird empfohlen, das Archiv nur unter Linux zu entpacken und zu kompilieren.
Wenn gesetzt, gibt DMLC eine Datei mit der Endung -size-stats.json aus, die Statistiken zur Codegenerierung zeigt, die nützlich sind, um die Größe des generierten Codes zu reduzieren und die Kompiliergeschwindigkeit zu erhöhen. Die Datei listet auf, wie viel C-Code für jede DML-Methode generiert wird. Die Ausgabe ist eine Liste von Tripeln [tot_size, location, num], wobei tot_size die Gesamtzahl der Bytes an C-Code ist, die aus einer Methodendeklaration generiert wurden, num angibt, wie oft C-Code aus dieser Deklaration generiert wurde (weil sie durch ein Template expandiert wurde), und location die Quellposition der Deklaration ist.
Ein Eintrag mit einem großen tot_size und einem großen num kann reduziert werden, indem die Methode als shared deklariert wird; dies sollte die Größe ungefähr durch num teilen. Ein Eintrag mit großem tot_size und num gleich 1 bedeutet üblicherweise, dass die Methode von einem Konstrukt wie #foreach oder #select dominiert wird, und kann reduziert werden, indem der Schleifenkörper in eine separate Methode ausgelagert wird oder indem die Schleife anderweitig in ein anderes Konstrukt wie foreach umgearbeitet wird.
Beachten Sie, dass die Statistiken nur Code enthalten, der direkt aus Methodendeklarationen generiert wurde; die Gesamtcodegröße umfasst viel mehr. Ein Megabyte Codegröße aus Methodendeklarationen trägt üblicherweise mit einigen Sekunden Kompilierzeit bei.