
Linguagem de domínio específico para escrever modelos de dispositivos funcionais rápidos para plataformas virtuais. Compila DML para C com chamadas de API adaptadas para o simulador Intel Simics, permitindo simulação de hardware e testes de segurança.
A Device Modeling Language (DML) é uma linguagem de domínio específico para escrever modelos de dispositivos funcionais ou de nível de transação rápidos para plataformas virtuais. A DML fornece abstrações de alto nível adequadas para modelos de dispositivos funcionais, incluindo construções como bancos de registradores, registradores, campos de bits, postagem de eventos, interfaces entre modelos e registro de logs. O código DML é compilado pelo DML Compiler (DMLC), produzindo código C com chamadas de API adaptadas para um simulador específico.
Atualmente, o compilador suporta a construção de modelos para o simulador Intel® Simics®, mas outros back-ends podem ser adicionados no futuro.
Para compilar o DMLC, você precisa ter uma instalação do simulador Simics e um projeto Simics configurado.
Se você ainda não tem uma instalação do simulador Simics ou acesso ao simulador Simics por canais comerciais, instale a versão pública do Intel Simics simulator e crie um projeto Simics (automático no fluxo de instalação padrão).
Seu projeto Simics deve estar configurado para usar o python do host (passando
--python para project-setup), e não deve fixar ply==3.4 em seu
arquivo requirements.txt.
Nesse projeto, faça o checkout do repositório DML no diretório modules/dmlc.
Em seguida, configure o CMake* (veja Usando CMake com o Intel
Simics Simulator),
passando -DSIMICS_DMLC_DIR=<your-project>/<hosttype>/bin para garantir que os dispositivos
que você compila via CMake utilizem seu DMLC local. Depois disso, o DMLC pode ser compilado via
cmake --build bt --target dmlc.
Para executar os testes unitários fornecidos com o DMLC, execute
bin/test-runner --suite modules/dmlc/test a partir do nível superior do projeto.
As seguintes variáveis de ambiente são úteis ao desenvolver o DMLC. Se você trabalha
regularmente com um DMLC compilado localmente, considere definir as variáveis
DMLC_DIR T126_JOBS, DMLC_PATHSUBST e PY_SYMLINKS em seu
.bashrc. As demais variáveis é melhor habilitar apenas quando necessário.
Após compilar o DMLC, você precisa definir DMLC_DIR como <your-project>/<hosttype>/bin
em invocações subsequentes de make para compilar dispositivos com o compilador
compilado localmente. <hosttype> é linux64 ou win64, dependendo do seu
tipo de host.
Quando definida, o número fornecido de testes é executado em paralelo.
A compilação do DMLC copia alguns arquivos da biblioteca DML, por exemplo dml-builtins.dml, para
<hosttype>/bin. Quando ocorre um erro de compilação, as mensagens de erro normalmente apontarão
para esta cópia em vez do código-fonte. Ao definir DMLC_PATHSUBST como
<hosttype>/bin/dml=modules/dmlc/lib, as mensagens de erro serão reescritas para apontar
para o arquivo de origem. <hosttype> é linux64 ou win64
dependendo do seu tipo de host.
Quando definida como 1, make dmlc criará links simbólicos para os arquivos Python em vez de copiá-los.
Isso tem dois efeitos: os tracebacks do Python levarão você ao arquivo de origem
no repositório, e você não precisa executar make novamente após editar arquivos
Python.
Quando definida como 1, exceções inesperadas no compilador são ecoadas para
stderr. O padrão é ocultar tracebacks em um arquivo dmlc-error.log.
Substitui o compilador padrão nos testes unitários.
Quando definida, o DMLC faz auto-perfilamento e grava o perfil em um arquivo .prof.
Quando definida, a DMLC emite um arquivo .tar.bz2 contendo todos os arquivos-fonte DML,
empacotados de uma forma que possam ser compilados de forma autônoma. Isso é útil quando um problema
de DML aparece dentro de um ambiente de build complexo, e você quer reproduzir
o problema de forma isolada. No arquivo criado, todos os arquivos DML estão localizados no
mesmo diretório (seja no nível superior ou sob uma série de subdiretórios chamados
_), e as importações relativas são tratadas incluindo também symlinks no
arquivo. No Windows, a DMLC às vezes não consegue resolver esses symlinks
corretamente; por esse motivo, recomenda-se que o arquivo seja apenas
extraído e compilado no Linux.
Quando definida, a DMLC gera um arquivo terminado em -size-stats.json, que mostra estatísticas
de geração de código úteis para reduzir o tamanho do código gerado e aumentar a velocidade
de compilação. O arquivo lista quanto código C é gerado para cada método DML. A
saída é uma lista de triplas [tot_size, location, num], onde tot_size é
o número total de bytes de código C gerados a partir de uma declaração de método,
num é quantas vezes o código C foi gerado a partir dessa declaração (porque
foi expandida por um template), e location é a localização no código-fonte da
declaração.
Uma entrada com um tot_size grande e um num grande pode ser reduzida declarando
o método como shared; isso deve dividir aproximadamente o tamanho por num. Uma entrada
com tot_size grande e num igual a 1 geralmente significa que o método é dominado
por uma construção como #foreach ou #select, e pode ser reduzida separando o
corpo do loop em um método separado, ou reformulando o loop em
alguma outra construção como foreach.
Observe que as estatísticas incluem apenas o código gerado diretamente a partir de declarações de métodos; o tamanho total do código inclui muito mais. Um megabyte de tamanho de código proveniente de declarações de métodos geralmente contribui com alguns segundos de tempo de compilação.