Primera simulación RTL en Digital Design Studio

Primera simulación RTL en Digital Design Studio para Windows. Abra el ejemplo del contador, ejecute su banco de pruebas en su PC y consulte la forma de onda.

Digital Design Studio para Windows: este tutorial ejecuta un banco de pruebas en su PC con los simuladores de OSS CAD Suite, que la aplicación descarga e instala solo cuando usted lo solicita. Consulte Descargas para ver los paquetes publicados.

Descripción general

Digital Design Studio incluye un pequeño proyecto de ejemplo: un contador de 4 bits (rtl/counter.sv) y su banco de pruebas (tb/counter_tb.sv). En este tutorial abre el ejemplo, instala los simuladores una vez, pulsa Ejecutar y lee la forma de onda. La simulación se ejecuta en su PC y no inicia ningún trabajo de Cloud.

Necesita:

  • La aplicación para Windows de Digital Design Studio en Windows x64.

  • La cuenta de Altifigence es opcional: puede ejecutar los simuladores sin iniciar sesión, y la aplicación para Windows no necesita una licencia de dispositivo.

  • Una conexión a internet para una descarga única de unos 574 MiB desde GitHub. Después de la instalación quedan unos 226 MiB en su PC.

Instalar e iniciar sesión

  1. Descargue la aplicación para Windows desde Descargas e instálela como se describe en la guía de instalación en Windows.

  2. Inicie Digital Design Studio. En Sign in to Digital Design Studio, elija Continue with Altifigence y termine de iniciar sesión en el navegador.

  3. Si en su lugar elige Continue without login, igualmente puede abrir, editar y ejecutar el ejemplo; inicie sesión más tarde cuando necesite servicios de la cuenta como Cloud o IA.

Abrir el ejemplo del contador

Cuando un usuario nuevo inicia la aplicación en un PC por primera vez, el ejemplo del contador se abre solo después de iniciar sesión o de continuar sin iniciar sesión. La aplicación abre el banco de pruebas tb/counter_tb.sv y la pestaña RTL simulation.

El ejemplo no se abre solo si Digital Design Studio ya se usó en este PC (por ejemplo, un inicio de sesión guardado, un proyecto reciente o de Academy, o una ventana guardada), si la aplicación se inició para abrir un proyecto concreto o si la organización en la que inició sesión ya tiene proyectos de Cloud. Para abrirlo usted mismo:

  1. En la parte superior del panel de navegación, abra el menú de entorno y elija Locales.

  2. En Proyectos en este PC, elija Abrir ejemplo. Si ya hay un proyecto de este PC abierto, elija Locales debajo de la lista de proyectos para volver a esta página.

Guarde primero sus cambios y deje que terminen las tareas en curso: la aplicación no cambia de proyecto mientras haya trabajo sin guardar o una tarea en ejecución.

El ejemplo es su propia copia, creada una sola vez en la carpeta de datos de la aplicación. Si vuelve a abrirlo, se conservan sus cambios.

Archivo

Contenido

rtl/counter.sv

Un contador de 4 bits con reinicio asíncrono activo en bajo (rst_n). Cuenta mientras enable está en alto.

tb/counter_tb.sv

El banco de pruebas. Reinicia el contador, lo habilita durante 20 ciclos de reloj, comprueba que la cuenta dio la vuelta hasta 4 y escribe counter_tb.vcd.

README.md

Una breve descripción del ejemplo.

.gitignore

Deja fuera de Git la carpeta .alti/, que guarda los resultados de las ejecuciones.

Instalar los simuladores OSS (una vez)

Digital Design Studio no incluye los simuladores. Cuando lo pide, descarga la compilación oficial de YosysHQ OSS CAD Suite 2026-10-09, comprueba la descarga con un SHA-256 fijado e instala solo los archivos que necesitan Icarus Verilog, Verilator y GTKWave.

  1. En la pestaña RTL simulation, deje seleccionado Testbench. Hasta que los simuladores estén instalados, el panel muestra "La extensión del simulador OSS CAD Suite no está instalada. Ejecutar lo instala primero."

  2. Pulse Ejecutar. En ¿Instalar los simuladores OSS CAD Suite?, elija Descargar e instalar. Ahora no cierra el diálogo sin instalar nada.

  3. El diálogo muestra la descarga, la comprobación SHA-256 y la instalación. Cancelar la detiene; la descarga parcial se conserva y se reanuda la próxima vez.

  4. Cuando termina la instalación, se inicia la ejecución.

También puede instalar los simuladores por adelantado: abra Complementos, seleccione Simuladores OSS CAD Suite y elija Desinstalación. Las ejecuciones posteriores en este PC usan la misma instalación.

Ejecutar el banco de pruebas

  1. Compruebe el panel: Testbench es counter_tb · tb/counter_tb.sv, Simulador es Icarus Verilog y Formato de forma de onda es VCD. Debajo, el panel muestra "Archivo(s) de origen 2 · counter_tb superior".

  2. Pulse Ejecutar. Primero se guardan los archivos .v, .sv, .svh y .vh modificados. Después se compilan todos los archivos .v y .sv del proyecto, excepto los que están en .alti/, .altifigence/, .git/ y node_modules/, con el banco de pruebas seleccionado como módulo superior.

  3. Cuando la ejecución se supera, el panel muestra Aprobado con la versión del simulador y el tiempo de ejecución, y abre la forma de onda debajo.

  4. Expanda Registro del simulador para ver la salida del compilador y del simulador. El banco de pruebas imprime counter_tb: PASS count=4 at 260 ns.

Leer el resultado

El período de reloj es de 10 ns. El banco de pruebas cambia sus entradas en los flancos de bajada del reloj, y el contador cuenta en los flancos de subida. La forma de onda muestra:

Tiempo

Señales

0–20 ns

rst_n está en bajo. Con Icarus Verilog, count es desconocido (x) hasta que el flanco de subida de 5 ns lo reinicia a 0.

20 ns

rst_n pasa a alto.

30 ns

enable pasa a alto.

35–225 ns

count aumenta en 1 en cada flanco de subida de clk, pasa de 15 a 0 a los 185 ns y llega a 4 a los 225 ns.

230 ns

enable pasa a bajo; count se queda en 4.

260 ns

El banco de pruebas comprueba count, imprime la línea PASS y termina la simulación.

La línea de estado muestra cómo terminó la ejecución:

Estado

Significado

Aprobado · …

El simulador terminó con el código de salida 0 y el registro del banco de pruebas no informó de ningún fallo.

Fallo (código de salida N) · …

El simulador terminó con un código de salida distinto de cero, por ejemplo tras un error de compilación. Lea Registro del simulador para ver el mensaje del compilador o del banco de pruebas. Cuando Digital Design Studio rechaza la entrada antes de la simulación, el registro explica la ruta o el ajuste rechazados; la ausencia de un código de salida del simulador no indica una ejecución completada.

El banco de pruebas informó un fallo · …

El simulador terminó con el código de salida 0, pero el registro del banco de pruebas informó de un fallo. Lea el mensaje de fallo en Registro del simulador.

Detenido después del plazo · …

La ejecución tardó más de 2 minutos, el límite para las ejecuciones desde este panel.

Cancelado

Pulsó Cancelar durante la ejecución.

Cada ejecución se guarda en su propia carpeta dentro de .alti/sim/ del proyecto, con la forma de onda y un receipt.json. El receipt registra el registro y la versión del simulador, la versión de OSS CAD Suite y el SHA-256 de cada archivo fuente e incluido. Digital Design Studio conserva las 20 ejecuciones más recientes. Si un archivo fuente, un archivo incluido o un ajuste de Verilog cambia durante una ejecución, esta se marca como fallida; vuelva a ejecutarla.

Solucionar errores comunes

Síntoma

Qué hacer

El ejemplo no se abrió solo

El inicio automático es solo para usuarios nuevos. Elija Abrir ejemplo en Proyectos en este PC (Locales).

"No se pudo abrir el proyecto de ejemplo. Para reintentar, elija Abrir ejemplo en Local."

Elija Abrir ejemplo en Locales. Mientras el ejemplo no exista, los siguientes inicios de la aplicación también lo vuelven a intentar, hasta tres intentos en total.

No aparece el botón Testbench

En la aplicación para Windows, abra un proyecto en este PC y use la vista Testbench para ejecutar su banco de pruebas.

"No se ha encontrado banco de pruebas. …"

Un banco de pruebas es un módulo sin puertos que ningún otro módulo instancia, como module counter_tb;. Guarde el archivo y elija Rescan.

La descarga falla o se detiene

Compruebe la conexión, el proxy o el firewall para github.com, release-assets.githubusercontent.com y objects.githubusercontent.com, y vuelva a pulsar Ejecutar. La descarga se reanuda donde se detuvo.

El antivirus bloqueó un archivo o Icarus Verilog no se inicia

Guarde el mensaje exacto del software de seguridad y verifique la descarga oficial y el hash esperado. No desactive la protección ni añada una exclusión amplia solo para forzar la ejecución. Pida al soporte o a su administrador que revise esa detección concreta antes de volver a intentarlo.

No hay suficiente espacio libre en disco

Libere la cantidad indicada en el mensaje y vuelva a intentarlo.

No se puede seleccionar Verilator

Verilator necesita un compilador de C++ y make en este PC, por ejemplo MSYS2 UCRT64 con pacman -S mingw-w64-ucrt-x86_64-gcc mingw-w64-ucrt-x86_64-make. Icarus Verilog funciona sin ellos.

"Esta carrera no escribió ninguna forma de onda. …"

Añada $dumpfile("name.vcd") y $dumpvars al banco de pruebas. Indique un nombre de archivo sin carpeta: solo se abre una forma de onda escrita en la carpeta propia de la ejecución.

La forma de onda supera los 32 MiB

Limite $dumpvars o acorte la ejecución.

Archivos de inclusión y macros

  • Mantenga dentro del proyecto los encabezados .svh y .vh que incluya. La compilación RTL, Icarus Verilog y Verilator buscan primero en la raíz del proyecto, después en Directorios de inclusión en el orden guardado y luego en las carpetas de código fuente encontradas, por orden de nombre. Si otro encabezado junto al archivo que lo incluye es diferente, Problemas y Registro del simulador indican ambas rutas y el encabezado usado.

  • Si Registro del simulador indica que no se encontró un archivo incluido, añada su carpeta, relativa a la raíz del proyecto, a Directorios de inclusión en Proyecto (Flow Navigator → Gestor de proyectos → Configuración → Proyecto → Directorios de inclusión) y vuelva a pulsar Ejecutar. Introduzca las macros en Proyecto → Definiciones, una NAME o NAME=VALUE por línea.

  • Incluir un archivo de fuera del proyecto hace fallar la ejecución antes de que empiece la simulación. Entonces Registro del simulador dice "… is outside the project: copy it into the project and include it from there".

  • Una entrada de Directorios de inclusión que apunta fuera del proyecto o contiene .., o un nombre de macro no válido en Definiciones, detiene la ejecución con un mensaje que nombra la entrada. Corríjala o elimínela. Una carpeta de la lista que no existe se omite con una advertencia en Registro del simulador.

  • Los ajustes modificados se aplican a partir de la siguiente ejecución. Los diagnósticos del editor los usan después de volver a abrir el proyecto.

Próximos pasos

  • Cambie el banco de pruebas, por ejemplo el número de ciclos de reloj habilitados y la cuenta esperada, y vuelva a pulsar Ejecutar. La ejecución guarda primero sus cambios.

  • Instale un compilador de C++ y make, elija Verilator en Simulador y compare el resultado con Icarus Verilog.

  • Ejecute su propio diseño: en Proyectos en este PC, elija Abrir carpeta de proyecto o Nuevo proyecto. Añada sus fuentes .v y .sv y un banco de pruebas que escriba una forma de onda con $dumpfile y $dumpvars. Después abra la pestaña RTL simulation desde Flow Navigator → Simulación → Ejecutar simulación → Abrir configuración de simulación. Si no ha iniciado sesión, Ejecutar simulación abre la pestaña directamente.

  • Para editar y guardar proyectos, consulte Espacio de trabajo; para los archivos Verilog, consulte Verilog.

Para las diferencias entre plataformas y las condiciones de la IA de la empresa, el almacenamiento y la cuenta que se aplican por separado de esta simulación local, consulte la guía de soporte.

Compatibilidad de entornos