Prima simulazione RTL in Digital Design Studio

Prima simulazione RTL in Digital Design Studio per Windows. Apri l’esempio del contatore, esegui il suo banco di prova sul tuo PC e leggi la forma d’onda.

Digital Design Studio per Windows: questo tutorial esegue un banco di prova sul tuo PC con i simulatori OSS CAD Suite, che l'app scarica e installa solo quando lo chiedi. Consulta Download per i pacchetti pubblicati.

Panoramica

Digital Design Studio include un piccolo progetto di esempio: un contatore a 4 bit (rtl/counter.sv) e il suo banco di prova (tb/counter_tb.sv). In questo tutorial apri l'esempio, installi i simulatori una sola volta, premi Esegui e leggi la forma d'onda. La simulazione viene eseguita sul tuo PC e non avvia alcun job Cloud.

Ti servono:

  • L'app Windows di Digital Design Studio su Windows x64.

  • Un account Altifigence è facoltativo: puoi eseguire i simulatori senza accedere, e l'app Windows non richiede una licenza del dispositivo.

  • Una connessione a Internet per un download una tantum di circa 574 MiB da GitHub. Dopo l'installazione restano sul PC circa 226 MiB.

Installare e accedere

  1. Scarica l'app Windows da Download e installala come descritto nella guida all'installazione per Windows.

  2. Avvia Digital Design Studio. In Sign in to Digital Design Studio, scegli Continue with Altifigence e completa l'accesso nel browser.

  3. Se invece scegli Continue without login, puoi comunque aprire, modificare ed eseguire l'esempio; accedi più tardi quando ti servono servizi dell'account come Cloud o AI.

Aprire l'esempio del contatore

Quando un nuovo utente avvia l'app su un PC per la prima volta, l'esempio del contatore si apre da solo dopo l'accesso o dopo aver continuato senza accedere. L'app apre il banco di prova tb/counter_tb.sv e la scheda RTL simulation.

L'esempio non si apre da solo se Digital Design Studio è già stato usato su questo PC (ad esempio un accesso salvato, un progetto recente o di Academy, o una finestra salvata), se l'app è stata avviata per aprire un progetto specifico o se l'organizzazione a cui hai effettuato l'accesso ha già progetti Cloud. Per aprirlo manualmente:

  1. In cima al pannello di navigazione, apri il menu dell'ambiente e scegli Locale.

  2. In Progetti su questo PC, scegli Apri esempio. Se è già aperto un progetto di questo PC, scegli Locale sotto l'elenco dei progetti per tornare a questa pagina.

Salva prima le modifiche e attendi che le attività in corso finiscano: l'app non cambia progetto finché ci sono modifiche non salvate o un'attività in esecuzione.

L'esempio è una tua copia, creata una sola volta nella cartella dei dati dell'app. Se lo riapri, le tue modifiche vengono mantenute.

File

Contenuto

rtl/counter.sv

Un contatore a 4 bit con reset asincrono attivo basso (rst_n). Conta finché enable è alto.

tb/counter_tb.sv

Il banco di prova. Resetta il contatore, lo abilita per 20 cicli di clock, verifica che il conteggio abbia fatto il giro fino a 4 e scrive counter_tb.vcd.

README.md

Una breve descrizione dell'esempio.

.gitignore

Esclude da Git la cartella .alti/, che contiene i risultati delle esecuzioni.

Installare i simulatori OSS (una volta sola)

Digital Design Studio non include i simulatori. Quando lo chiedi, scarica la build ufficiale YosysHQ OSS CAD Suite 2026-10-09, verifica il download con uno SHA-256 fissato e installa solo i file necessari a Icarus Verilog, Verilator e GTKWave.

  1. Nella scheda RTL simulation, lascia selezionato Banco prova. Finché i simulatori non sono installati, il pannello mostra "L'estensione del simulatore OSS CAD Suite non è installata. Esegui lo installa prima."

  2. Premi Esegui. In Installare i simulatori OSS CAD Suite?, scegli Scarica e installa. Non ora chiude la finestra di dialogo senza installare nulla.

  3. La finestra di dialogo mostra il download, il controllo SHA-256 e l'installazione. Annulla la interrompe; il download parziale viene conservato e riprende la volta successiva.

  4. Al termine dell'installazione, l'esecuzione si avvia.

Puoi anche installare i simulatori in anticipo: apri Plugins, seleziona Simulatori OSS CAD Suite e scegli Installa. Le esecuzioni successive su questo PC usano la stessa installazione.

Eseguire il banco di prova

  1. Controlla il pannello: Banco prova è counter_tb · tb/counter_tb.sv, Simulatore è Icarus Verilog e Formato della forma d'onda è VCD. Sotto, il pannello mostra "2 file sorgente · top counter_tb".

  2. Premi Esegui. L'esecuzione salva prima i file .v, .sv, .svh e .vh modificati. Poi compila tutti i file .v e .sv del progetto, tranne quelli in .alti/, .altifigence/, .git/ e node_modules/, con il banco di prova selezionato come modulo di livello superiore.

  3. Quando l'esecuzione riesce, il pannello mostra Superato con la versione del simulatore e il tempo di esecuzione e apre la forma d'onda sotto.

  4. Espandi Registro del simulatore per vedere l'output del compilatore e del simulatore. Il banco di prova stampa counter_tb: PASS count=4 at 260 ns.

Leggere il risultato

Il periodo di clock è di 10 ns. Il banco di prova cambia i suoi ingressi sui fronti di discesa del clock, e il contatore conta sui fronti di salita. La forma d'onda mostra:

Tempo

Segnali

0–20 ns

rst_n è basso. Con Icarus Verilog, count è sconosciuto (x) finché il fronte di salita a 5 ns non lo resetta a 0.

20 ns

rst_n diventa alto.

30 ns

enable diventa alto.

35–225 ns

count aumenta di 1 a ogni fronte di salita di clk, torna da 15 a 0 a 185 ns e arriva a 4 a 225 ns.

230 ns

enable diventa basso; count resta a 4.

260 ns

Il banco di prova controlla count, stampa la riga PASS e termina la simulazione.

La riga di stato mostra come è terminata l'esecuzione:

Stato

Significato

Superato · …

Il simulatore è terminato con il codice di uscita 0 e il registro del banco di prova non ha segnalato errori.

Fallito (codice di uscita N) · …

Il simulatore è terminato con un codice di uscita diverso da zero, ad esempio dopo un errore di compilazione. Leggi Registro del simulatore per il messaggio del compilatore o del banco di prova. Quando Digital Design Studio rifiuta l'input prima della simulazione, il registro spiega il percorso o l'impostazione rifiutati; l'assenza di un codice di uscita del simulatore non indica un'esecuzione completata.

Il banco prova ha segnalato un errore · …

Il simulatore è terminato con il codice di uscita 0, ma il log del testbench ha segnalato un errore. Leggi il messaggio di errore in Registro del simulatore.

Arrestato dopo il limite di tempo · …

L'esecuzione è durata più di 2 minuti, il limite per le esecuzioni da questo pannello.

Annullato

Hai premuto Annulla durante l'esecuzione.

Ogni esecuzione viene conservata in una propria cartella in .alti/sim/ del progetto, con la forma d'onda e un file receipt.json. Il receipt registra il log e la versione del simulatore, la release di OSS CAD Suite e lo SHA-256 di ogni file sorgente e incluso. Digital Design Studio conserva le 20 esecuzioni più recenti. Se durante un'esecuzione cambia un file sorgente, un file incluso o un'impostazione Verilog, l'esecuzione viene contrassegnata come non riuscita; eseguila di nuovo.

Risolvere gli errori comuni

Sintomo

Cosa fare

L'esempio non si è aperto da solo

L'avvio automatico è solo per i nuovi utenti. Scegli Apri esempio in Progetti su questo PC (Locale).

"Impossibile aprire il progetto di esempio. Per riprovare, scegli Apri esempio in Locale."

Scegli Apri esempio in Locale. Finché l'esempio non esiste, anche gli avvii successivi dell'app riprovano, fino a tre tentativi in totale.

Non c'è il pulsante Banco prova

Nell’app per Windows, apri un progetto su questo PC e usa la vista Banco prova per eseguire il testbench.

"Nessun banco di prova trovato. …"

Un banco di prova è un modulo senza porte che nessun altro modulo istanzia, ad esempio module counter_tb;. Salva il file e scegli Nuova scansione.

Il download non riesce o si blocca

Controlla la connessione, il proxy o il firewall per github.com, release-assets.githubusercontent.com e objects.githubusercontent.com, poi premi di nuovo Esegui. Il download riprende da dove si era fermato.

L'antivirus ha bloccato un file, oppure Icarus Verilog non si avvia

Conserva il messaggio esatto del software di sicurezza e verifica il download ufficiale e l'hash previsto. Non disattivare la protezione e non aggiungere un'esclusione ampia solo per forzare l'esecuzione. Prima di riprovare, chiedi al supporto o al tuo amministratore di esaminare quel rilevamento specifico.

Spazio libero su disco insufficiente

Libera lo spazio indicato nel messaggio e riprova.

Non è possibile selezionare Verilator

Verilator richiede un compilatore C++ e make su questo PC, ad esempio MSYS2 UCRT64 con pacman -S mingw-w64-ucrt-x86_64-gcc mingw-w64-ucrt-x86_64-make. Icarus Verilog funziona senza.

"Questa esecuzione non ha scritto alcuna forma d'onda. …"

Aggiungi $dumpfile("name.vcd") e $dumpvars al banco di prova. Indica un nome di file senza cartella: viene aperta solo una forma d'onda scritta nella cartella propria dell'esecuzione.

La forma d'onda supera i 32 MiB

Restringi $dumpvars o accorcia l'esecuzione.

File inclusi e macro

  • Tieni dentro il progetto le intestazioni .svh e .vh incluse. La compilazione RTL, Icarus Verilog e Verilator cercano prima nella radice del progetto, poi in Directory include nell'ordine salvato, poi nelle cartelle sorgente trovate in ordine alfabetico. Se un'altra intestazione accanto al file che la include è diversa, Problemi e Registro del simulatore indicano entrambi i percorsi e l'intestazione usata.

  • Se Registro del simulatore indica che un file incluso non è stato trovato, aggiungi la sua cartella, relativa alla radice del progetto, a Directory include in Progetto (Flow Navigator → Gestione progetti → Impostazioni → Progetto → Directory include), poi premi di nuovo Esegui. Inserisci le macro in Progetto → Definizioni, una NAME o NAME=VALUE per riga.

  • Includere un file esterno al progetto fa fallire l'esecuzione prima che la simulazione inizi. Registro del simulatore mostra allora "… is outside the project: copy it into the project and include it from there".

  • Una voce di Directory include che punta fuori dal progetto o contiene .., oppure un nome di macro non valido in Definizioni, interrompe l'esecuzione con un messaggio che indica la voce. Correggila o rimuovila. Una cartella elencata che non esiste viene saltata con un avviso in Registro del simulatore.

  • Le impostazioni modificate si applicano dall'esecuzione successiva. La diagnostica dell'editor le usa dopo aver riaperto il progetto.

Passaggi successivi

  • Modifica il banco di prova, ad esempio il numero di cicli di clock abilitati e il conteggio previsto, poi premi di nuovo Esegui. L'esecuzione salva prima le tue modifiche.

  • Installa un compilatore C++ e make, scegli Verilator in Simulatore e confronta il risultato con Icarus Verilog.

  • Esegui il tuo progetto: in Progetti su questo PC, scegli Apri cartella progetto o Nuovo progetto. Aggiungi le sorgenti .v e .sv e un banco di prova che scriva una forma d'onda con $dumpfile e $dumpvars. Poi apri la scheda RTL simulation da Flow Navigator → Simulazione → Esegui simulazione → Apri configurazione simulazione. Se non hai effettuato l'accesso, Esegui simulazione apre direttamente la scheda.

  • Per modificare e salvare i progetti, consulta Area di lavoro; per i file Verilog, consulta Verilog.

Per le differenze tra piattaforme e le condizioni relative all'AI aziendale, all'archiviazione e all'account che si applicano separatamente da questa simulazione locale, consulta la guida al supporto.

Supporto degli ambienti