Primeira simulação RTL no Digital Design Studio

Primeira simulação RTL no Digital Design Studio para Windows. Abra o exemplo do contador, execute seu banco de testes no seu PC e leia a forma de onda.

Digital Design Studio para Windows: este tutorial executa um banco de testes no seu PC com os simuladores do OSS CAD Suite, que o aplicativo baixa e instala somente quando você pede. Veja os pacotes publicados em Downloads.

Visão geral

O Digital Design Studio inclui um pequeno projeto de exemplo: um contador de 4 bits (rtl/counter.sv) e seu banco de testes (tb/counter_tb.sv). Neste tutorial, você abre o exemplo, instala os simuladores uma vez, clica em Executar e lê a forma de onda. A simulação é executada no seu PC e não inicia nenhum job do Cloud.

Você precisa de:

  • O aplicativo para Windows do Digital Design Studio no Windows x64.

  • A conta Altifigence é opcional: você pode executar os simuladores sem entrar, e o aplicativo para Windows não precisa de licença de dispositivo.

  • Uma conexão com a internet para um download único de cerca de 574 MiB do GitHub. Depois da instalação, cerca de 226 MiB ficam no seu PC.

Instalar e entrar

  1. Baixe o aplicativo para Windows em Downloads e instale-o como descrito no guia de instalação no Windows.

  2. Inicie o Digital Design Studio. Em Sign in to Digital Design Studio, escolha Continue with Altifigence e conclua o login no navegador.

  3. Se você escolher Continue without login, ainda poderá abrir, editar e executar o exemplo; entre mais tarde quando precisar de serviços da conta, como o Cloud ou a IA.

Abrir o exemplo do contador

Quando um novo usuário inicia o aplicativo em um PC pela primeira vez, o exemplo do contador abre sozinho depois que você entra ou continua sem login. O aplicativo abre o banco de testes tb/counter_tb.sv e a guia RTL simulation.

O exemplo não abre sozinho se o Digital Design Studio já foi usado neste PC (por exemplo, um login salvo, um projeto recente ou da Academy, ou uma janela salva), se o aplicativo foi iniciado para abrir um projeto específico ou se a organização em que você entrou já tem projetos do Cloud. Para abri-lo você mesmo:

  1. Na parte superior do painel de navegação, abra o menu de ambiente e escolha Local.

  2. Em Projetos neste PC, escolha Abrir exemplo. Se um projeto deste PC já estiver aberto, escolha Local abaixo da lista de projetos para voltar a esta página.

Salve suas edições e deixe as tarefas em execução terminarem primeiro: o aplicativo não troca de projeto enquanto houver trabalho não salvo ou uma tarefa em execução.

O exemplo é a sua própria cópia, criada uma única vez na pasta de dados do aplicativo. Ao abri-lo de novo, suas alterações são mantidas.

Arquivo

Conteúdo

rtl/counter.sv

Um contador de 4 bits com reset assíncrono ativo em nível baixo (rst_n). Ele conta enquanto enable está em nível alto.

tb/counter_tb.sv

O banco de testes. Ele reinicia o contador, habilita-o por 20 ciclos de clock, verifica se a contagem deu a volta e chegou a 4 e grava counter_tb.vcd.

README.md

Uma breve descrição do exemplo.

.gitignore

Mantém fora do Git a pasta .alti/, que guarda os resultados das execuções.

Instalar os simuladores OSS (uma vez)

O Digital Design Studio não inclui os simuladores. Quando você pede, ele baixa a compilação oficial YosysHQ OSS CAD Suite 2026-10-09, verifica o download com um SHA-256 fixado e instala somente os arquivos de que Icarus Verilog, Verilator e GTKWave precisam.

  1. Na guia RTL simulation, mantenha Aparelho de ensaio selecionado. Até que os simuladores estejam instalados, o painel mostra "A extensão do simulador OSS CAD Suite não está instalada. Executar instala-o primeiro."

  2. Clique em Executar. Em Instalar os simuladores OSS CAD Suite?, escolha Baixe e instale. Agora não fecha a caixa de diálogo sem instalar nada.

  3. A caixa de diálogo mostra o download, a verificação SHA-256 e a instalação. Cancelar interrompe o processo; o download parcial é mantido e continua na próxima vez.

  4. Quando a instalação termina, a execução começa.

Você também pode instalar os simuladores com antecedência: abra Plugins, selecione Simuladores OSS CAD Suite e escolha Instalar. As próximas execuções neste PC usam a mesma instalação.

Executar o banco de testes

  1. Confira o painel: Aparelho de ensaio é counter_tb · tb/counter_tb.sv, Simulador é Icarus Verilog e Formato de onda é VCD. Abaixo deles, o painel mostra "Arquivo(s) fonte(s) 2 · topo counter_tb".

  2. Clique em Executar. Primeiro, a execução salva os arquivos .v, .sv, .svh e .vh alterados. Em seguida, compila todos os arquivos .v e .sv do projeto, exceto os que estão em .alti/, .altifigence/, .git/ e node_modules/, com o banco de testes selecionado como módulo de nível superior.

  3. Quando a execução é aprovada, o painel mostra Passado com a versão do simulador e o tempo de execução e abre a forma de onda abaixo.

  4. Expanda Diário do simulador para ver a saída do compilador e do simulador. O banco de testes imprime counter_tb: PASS count=4 at 260 ns.

Ler o resultado

O período do clock é de 10 ns. O banco de testes muda suas entradas nas bordas de descida do clock, e o contador conta nas bordas de subida. A forma de onda mostra:

Tempo

Sinais

0–20 ns

rst_n está em nível baixo. Com o Icarus Verilog, count é desconhecido (x) até que a borda de subida em 5 ns o reinicie para 0.

20 ns

rst_n vai para nível alto.

30 ns

enable vai para nível alto.

35–225 ns

count aumenta 1 a cada borda de subida de clk, volta de 15 para 0 em 185 ns e chega a 4 em 225 ns.

230 ns

enable vai para nível baixo; count fica em 4.

260 ns

O banco de testes verifica count, imprime a linha PASS e encerra a simulação.

A linha de status mostra como a execução terminou:

Status

Significado

Passado · …

O simulador terminou com o código de saída 0 e o log do banco de testes não relatou uma falha.

Falha (código de saída N) · …

O simulador terminou com um código de saída diferente de zero, por exemplo após um erro de compilação. Leia Diário do simulador para ver a mensagem do compilador ou do banco de testes. Quando o Digital Design Studio rejeita a entrada antes da simulação, o log explica o caminho ou a configuração rejeitada; a ausência de um código de saída do simulador não indica uma execução concluída.

O banco de ensaio relatou uma falha · …

O simulador terminou com o código de saída 0, mas o log do banco de testes relatou uma falha. Leia a mensagem da falha no Diário do simulador.

Interrupção após o limite de tempo · …

A execução levou mais de 2 minutos, o limite para execuções a partir deste painel.

Cancelado

Você clicou em Cancelar durante a execução.

Cada execução é mantida na própria pasta em .alti/sim/ do projeto, com a forma de onda e um receipt.json. O receipt registra o log e a versão do simulador, a versão do OSS CAD Suite e o SHA-256 de cada arquivo-fonte e arquivo incluído. O Digital Design Studio mantém as 20 execuções mais recentes. Se um arquivo-fonte, um arquivo incluído ou uma configuração do Verilog mudar durante uma execução, ela é marcada como falha; execute-a novamente.

Corrigir erros comuns

Sintoma

O que fazer

O exemplo não abriu sozinho

A abertura automática é só para novos usuários. Escolha Abrir exemplo em Projetos neste PC (Local).

"Não foi possível abrir o projeto de exemplo. Para tentar novamente, escolha Abrir exemplo em Local."

Escolha Abrir exemplo em Local. Enquanto o exemplo não existir, as próximas inicializações do aplicativo também tentam novamente, até três tentativas no total.

Não há o botão Aparelho de ensaio

No aplicativo para Windows, abra um projeto neste PC e use a visualização Aparelho de ensaio para executar o banco de testes.

"Não foi encontrado nenhum banco de testes. …"

Um banco de testes é um módulo sem portas que nenhum outro módulo instancia, como module counter_tb;. Salve o arquivo e escolha Rescan.

O download falha ou trava

Verifique a conexão, o proxy ou o firewall para github.com, release-assets.githubusercontent.com e objects.githubusercontent.com e clique em Executar novamente. O download continua de onde parou.

O antivírus bloqueou um arquivo ou o Icarus Verilog não inicia

Guarde a mensagem exata do software de segurança e verifique o download oficial e o hash esperado. Não desative a proteção nem adicione uma exclusão ampla só para forçar a execução. Peça ao suporte ou ao seu administrador que analise essa detecção específica antes de tentar novamente.

Espaço livre em disco insuficiente

Libere o espaço indicado na mensagem e tente novamente.

Não é possível selecionar o Verilator

O Verilator precisa de um compilador C++ e do make neste PC, por exemplo o MSYS2 UCRT64 com pacman -S mingw-w64-ucrt-x86_64-gcc mingw-w64-ucrt-x86_64-make. O Icarus Verilog funciona sem eles.

"Esta execução não gerou uma forma de onda. …"

Adicione $dumpfile("name.vcd") e $dumpvars ao banco de testes. Informe um nome de arquivo sem pasta: só é aberta uma forma de onda gravada na própria pasta da execução.

A forma de onda tem mais de 32 MiB

Restrinja o $dumpvars ou encurte a execução.

Arquivos de inclusão e macros

  • Mantenha dentro do projeto os cabeçalhos .svh e .vh incluídos. A compilação RTL, o Icarus Verilog e o Verilator procuram primeiro na raiz do projeto, depois em Diretórios de inclusão na ordem salva e depois nas pastas de código-fonte encontradas, em ordem alfabética. Se outro cabeçalho ao lado do arquivo que faz a inclusão for diferente, Problemas e Diário do simulador identificam os dois caminhos e o cabeçalho usado.

  • Se Diário do simulador mostrar que um arquivo incluído não foi encontrado, adicione a pasta dele, relativa à raiz do projeto, a Diretórios de inclusão em Projeto (Flow Navigator → Gerenciador de projetos → Configurações → Projeto → Diretórios de inclusão) e clique em Executar novamente. Insira as macros em Projeto → Definições, uma NAME ou NAME=VALUE por linha.

  • Incluir um arquivo de fora do projeto faz a execução falhar antes de a simulação começar. Nesse caso, Diário do simulador diz "… is outside the project: copy it into the project and include it from there".

  • Uma entrada de Diretórios de inclusão que aponta para fora do projeto ou contém .., ou um nome de macro inválido em Definições, interrompe a execução com uma mensagem que identifica a entrada. Corrija-a ou remova-a. Uma pasta listada que não existe é ignorada com um aviso em Diário do simulador.

  • As configurações alteradas valem a partir da próxima execução. Os diagnósticos do editor passam a usá-las depois que você reabre o projeto.

Próximas etapas

  • Altere o banco de testes, por exemplo o número de ciclos de clock habilitados e a contagem esperada, e clique em Executar novamente. A execução salva suas edições primeiro.

  • Instale um compilador C++ e o make, escolha Verilator em Simulador e compare o resultado com o do Icarus Verilog.

  • Execute seu próprio projeto: em Projetos neste PC, escolha Abrir pasta de projeto ou Novo projeto. Adicione suas fontes .v e .sv e um banco de testes que grave uma forma de onda com $dumpfile e $dumpvars. Depois, abra a guia RTL simulation em Flow Navigator → Simulação → Executar simulação → Abrir configuração de simulação. Se você não entrou, Executar simulação abre a guia diretamente.

  • Para editar e salvar projetos, veja Espaço de trabalho; para arquivos Verilog, veja Verilog.

Para diferenças entre plataformas e as condições da IA da empresa, de armazenamento e de conta que se aplicam separadamente desta simulação local, veja o guia de suporte.

Suporte a ambientes