
Lenguaje de dominio específico para escribir modelos rápidos de dispositivos funcionales para plataformas virtuales. Compila DML a C con llamadas API adaptadas para el simulador Intel Simics, lo que permite la simulación de hardware y las pruebas de seguridad.
El Lenguaje de Modelado de Dispositivos (DML) es un lenguaje de dominio específico para escribir modelos de dispositivos funcionales o de nivel de transacción rápidos para plataformas virtuales. DML proporciona abstracciones de alto nivel adecuadas para modelos de dispositivos funcionales, incluyendo construcciones como bancos de registros, registros, campos de bits, publicación de eventos, interfaces entre modelos y registro de logs. El código DML es compilado por el Compilador DML (DMLC), produciendo código C con llamadas a la API adaptadas para un simulador en particular.
Actualmente, el compilador soporta la construcción de modelos para el simulador Intel® Simics®, pero otros back-ends podrían añadirse en el futuro.
Para construir DMLC, necesitas tener una instalación del simulador Simics y un proyecto Simics configurado.
Si aún no tienes una instalación del simulador Simics o acceso al simulador Simics a través de canales comerciales, instala la versión pública del simulador Intel Simics y crea un proyecto Simics (automático en el flujo de instalación predeterminado).
Tu proyecto Simics debe estar configurado para usar el python del host (pasando
--python a project-setup), y no debe fijar ply==3.4 en su
archivo requirements.txt.
En ese proyecto, extrae el repositorio DML en el directorio modules/dmlc.
Luego configura CMake* (consulta Uso de CMake con el simulador Intel
Simics),
pasando -DSIMICS_DMLC_DIR=<your-project>/<hosttype>/bin para asegurar que los dispositivos
que construyas mediante CMake aprovechen tu DMLC local. Después de eso, DMLC puede construirse mediante
cmake --build bt --target dmlc.
Para ejecutar las pruebas unitarias proporcionadas con DMLC, ejecuta
bin/test-runner --suite modules/dmlc/test desde el nivel superior del proyecto.
Las siguientes variables de entorno son útiles al desarrollar DMLC. Si trabajas
regularmente con un DMLC construido localmente, entonces considera establecer las variables
DMLC_DIR T126_JOBS, DMLC_PATHSUBST y PY_SYMLINKS en tu
.bashrc. El resto de variables es mejor habilitarlas solo cuando sea necesario.
Después de construir DMLC, necesitas establecer DMLC_DIR a <your-project>/<hosttype>/bin
en invocaciones posteriores de make para construir dispositivos con el compilador
construido localmente. <hosttype> es linux64 o win64 dependiendo de tu
tipo de host.
Cuando se establece, el número dado de pruebas se ejecutan en paralelo.
La construcción de DMLC copia algunos archivos de la biblioteca DML, por ejemplo dml-builtins.dml, en
<hosttype>/bin. Cuando ocurre un error de compilación, los mensajes de error normalmente apuntarán
a esta copia en lugar del origen. Al establecer DMLC_PATHSUBST a
<hosttype>/bin/dml=modules/dmlc/lib, los mensajes de error se reescribirán para apuntar
al archivo de origen en su lugar. <hosttype> es linux64 o win64
dependiendo de tu tipo de host.
Cuando se establece a 1, make dmlc creará enlaces simbólicos a los archivos Python en lugar de copiarlos.
Esto tiene dos efectos: los tracebacks de Python te llevarán al archivo de origen
en el repositorio, y no necesitas volver a ejecutar make después de editar archivos
Python.
Cuando se establece a 1, las excepciones inesperadas en el compilador se muestran en
stderr. El valor predeterminado es ocultar los tracebacks en un archivo dmlc-error.log.
Sobrescribe el compilador predeterminado en las pruebas unitarias.
Cuando se establece, DMLC realiza auto-perfilado y escribe el perfil en un archivo .prof.
Cuando se establece, DMLC emite un archivo .tar.bz2 que contiene todos los archivos fuente DML, empaquetados de forma que puedan compilarse de manera independiente. Esto es útil cuando un problema de DML aparece dentro de un entorno de compilación complejo y se desea reproducir el problema de forma aislada. En el archivo creado, todos los archivos DML se encuentran en el mismo directorio (ya sea en el nivel superior o bajo una serie de subdirectorios llamados _), y las importaciones relativas se gestionan incluyendo también enlaces simbólicos en el archivo. En Windows, DMLC a veces no puede resolver estos enlaces simbólicos correctamente; por esta razón, se recomienda que el archivo solo se extraiga y compile en Linux.
Cuando se establece, DMLC genera un archivo que termina en -size-stats.json, el cual muestra estadísticas de generación de código útiles para reducir el tamaño del código generado y aumentar la velocidad de compilación. El archivo enumera cuánto código C se genera para cada método DML. La salida es una lista de tripletas [tot_size, location, num], donde tot_size es el número total de bytes de código C generados a partir de una declaración de método, num es cuántas veces se generó código C a partir de esta declaración (porque fue expandida por una plantilla), y location es la ubicación en el código fuente de la declaración.
Una entrada con un tot_size grande y un num grande puede reducirse declarando el método como shared; esto debería dividir aproximadamente el tamaño entre num. Una entrada con un tot_size grande con num igual a 1 generalmente significa que el método está dominado por una construcción como #foreach o #select, y puede reducirse extrayendo el cuerpo del bucle a un método separado, o reestructurando de otro modo el bucle en alguna otra construcción como foreach.
Tenga en cuenta que las estadísticas solo incluyen el código generado directamente a partir de las declaraciones de métodos; el tamaño total del código incluye mucho más. Un megabyte de tamaño de código proveniente de declaraciones de métodos suele contribuir con unos pocos segundos de tiempo de compilación.