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
Baixe o aplicativo para Windows em Downloads e instale-o como descrito no guia de instalação no Windows.
Inicie o Digital Design Studio. Em Sign in to Digital Design Studio, escolha Continue with Altifigence e conclua o login no navegador.
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:
Na parte superior do painel de navegação, abra o menu de ambiente e escolha Local.
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 |
|---|---|
| Um contador de 4 bits com reset assíncrono ativo em nível baixo ( |
| 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 |
| Uma breve descrição do exemplo. |
| Mantém fora do Git a pasta |
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.
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."
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.
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.
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
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".Clique em Executar. Primeiro, a execução salva os arquivos
.v,.sv,.svhe.vhalterados. Em seguida, compila todos os arquivos.ve.svdo projeto, exceto os que estão em.alti/,.altifigence/,.git/enode_modules/, com o banco de testes selecionado como módulo de nível superior.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.
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 |
|
20 ns |
|
30 ns |
|
35–225 ns |
|
230 ns |
|
260 ns | O banco de testes verifica |
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 |
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 |
"Esta execução não gerou uma forma de onda. …" | Adicione |
A forma de onda tem mais de 32 MiB | Restrinja o |
Arquivos de inclusão e macros
Mantenha dentro do projeto os cabeçalhos
.svhe.vhincluí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
NAMEouNAME=VALUEpor 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
.ve.sve um banco de testes que grave uma forma de onda com$dumpfilee$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.