
Предметно-ориентированный язык для написания быстрых функциональных моделей устройств для виртуальных платформ. Компилирует DML в C с вызовами API, адаптированными для симулятора Intel Simics, что позволяет проводить симуляцию аппаратного обеспечения и тестирование безопасности.
Device Modeling Language (DML) — это предметно-ориентированный язык для написания быстрых функциональных или транзакционно-уровневых моделей устройств для виртуальных платформ. DML предоставляет высокоуровневые абстракции, подходящие для функциональных моделей устройств, включая такие конструкции, как банки регистров, регистры, битовые поля, отправка событий, интерфейсы между моделями и логирование. Код DML компилируется компилятором DML (DMLC), который порождает C код с вызовами API, адаптированными для конкретного симулятора.
В настоящее время компилятор поддерживает сборку моделей для симулятора Intel® Simics®, но в будущем могут быть добавлены другие бэкенды.
Для сборки DMLC вам нужна установка симулятора Simics и настроенный проект Simics.
Если у вас ещё нет установки симулятора Simics или доступа к симулятору Simics через коммерческие каналы, установите публичный релиз симулятора Intel Simics и создайте проект Simics (автоматически в стандартном процессе установки).
Ваш проект Simics должен быть настроен на использование host python (путём передачи
--python в project-setup) и не должен фиксировать ply==3.4 в своём
файле requirements.txt.
В этом проекте выгрузите репозиторий DML в каталог modules/dmlc.
Затем настройте CMake* (см. Using CMake with the Intel
Simics Simulator),
передав -DSIMICS_DMLC_DIR=<your-project>/<hosttype>/bin, чтобы устройства,
которые вы собираете через CMake, использовали ваш локальный DMLC. После этого DMLC можно собрать через
cmake --build bt --target dmlc.
Чтобы запустить модульные тесты, поставляемые с DMLC, выполните
bin/test-runner --suite modules/dmlc/test из корневого каталога проекта.
Следующие переменные окружения удобны при разработке DMLC. Если вы работаете
регулярно с локально собранным DMLC, то рассмотрите возможность установки переменных
DMLC_DIR T126_JOBS, DMLC_PATHSUBST и PY_SYMLINKS в вашем
.bashrc. Остальные переменные лучше включать только при необходимости.
После сборки DMLC вам нужно установить DMLC_DIR в <your-project>/<hosttype>/bin
в последующих вызовах make, чтобы собирать устройства с локально
собранным компилятором. <hosttype> — это либо linux64, либо win64 в зависимости от вашего
типа хоста.
Если задано, указанное число тестов запускается параллельно.
Сборка DMLC копирует несколько файлов библиотеки DML, например dml-builtins.dml, в
<hosttype>/bin. Когда происходит ошибка компиляции, сообщения об ошибках обычно указывают
на эту копию, а не на исходный файл. Установив DMLC_PATHSUBST в
<hosttype>/bin/dml=modules/dmlc/lib, сообщения об ошибках будут переписаны так, чтобы указывать
на исходный файл. <hosttype> — это либо linux64, либо win64
в зависимости от вашего типа хоста.
Если установлено в 1, make dmlc будет создавать символические ссылки на файлы Python вместо их копирования.
Это имеет два эффекта: трассировки Python будут приводить вас к исходному файлу
в репозитории, и вам не нужно повторно запускать make после редактирования файлов Python.
Если установлено в 1, неожиданные исключения в компиляторе выводятся в
stderr. По умолчанию трассировки скрываются в файле dmlc-error.log.
Переопределяет компилятор по умолчанию в модульных тестах.
Если задано, DMLC выполняет самоанализ производительности и записывает профиль в файл .prof.
Если задана, DMLC создаёт архив .tar.bz2, содержащий все исходные файлы DML,
упакованные в виде, допускающем автономную компиляцию. Это полезно, когда
проблема DML возникает в сложной среде сборки, и вы хотите воспроизвести
проблему изолированно. В созданном архиве все файлы DML расположены в
одном каталоге (либо на верхнем уровне, либо внутри серии подкаталогов с именем
_), а относительные импорты обрабатываются путём включения в архив также
символических ссылок. В Windows DMLC иногда не может корректно разрешить эти
символические ссылки; по этой причине рекомендуется распаковывать и
компилировать архив только в Linux.
Если задана, DMLC выводит файл с окончанием -size-stats.json, который
показывает статистику генерации кода, полезную для уменьшения размера
сгенерированного кода и ускорения компиляции. Файл перечисляет, сколько C-кода
генерируется для каждого метода DML. Вывод представляет собой список троек
[tot_size, location, num], где tot_size — общее число байт C-кода,
сгенерированного из одного объявления метода, num — сколько раз C-код был
сгенерирован из этого объявления (поскольку оно было раскрыто шаблоном), а
location — исходное местоположение объявления.
Запись с большим tot_size и большим num можно уменьшить, объявив
метод как shared; это должно примерно разделить размер на num. Запись
с большим tot_size при num, равном 1, обычно означает, что метод
доминируется конструкцией вроде #foreach или #select, и его можно уменьшить,
вынеся тело цикла в отдельный метод или иным образом переработав цикл в
какую-либо другую конструкцию, например foreach.
Обратите внимание, что статистика включает только код, непосредственно сгенерированный из объявлений методов; общий размер кода включает гораздо больше. Один мегабайт размера кода из объявлений методов обычно даёт несколько секунд времени компиляции.