Manual · 3

Compilar, ejecutar y depurar

Una tecla compila, otra ejecuta y otra depura. VCSIDE pasa al emulador el formato de cartucho, la norma de TV, los símbolos y tus puntos de ruptura, así que se abre listo para usar.

Compilar

F7 compila el proyecto:

• Ensamblador: DASM, con un listado (.lst) y los símbolos (.sym) junto a la ROM.
• batari Basic: su propio guion de compilación. Mira proyectos en batari Basic.
• C para ELF: el build_command del proyecto, normalmente make. Mira C para cartuchos ELF.

Los errores y avisos van a Problemas, y al hacer clic en uno se abre su línea. Los símbolos que DASM no puede resolver se listan con la línea que los usa. Tras compilar, el informe de espacio se actualiza.

Ejecutar

F5 compila y ejecuta la ROM en el emulador del proyecto, Gopher2600 (el predeterminado) o Stella (Compilar → Emulador). Los dos cargan los símbolos de la compilación, así que sus depuradores muestran tus etiquetas en lugar de direcciones sueltas.

La norma de TV se pasa en la línea de órdenes. Los dos emuladores tienen NTSC, PAL, PAL60 y SECAM; NTSC50 y SECAM60 solo están en Stella, y PAL-M solo en Gopher2600. Si el emulador no tiene la norma elegida, VCSIDE lo avisa y deja que el emulador decida.

Puntos de ruptura

Haz clic en el margen izquierdo, o pulsa F9, para poner un punto de ruptura en una línea. F6 compila el programa e inicia el depurador del emulador con todos los puntos de ruptura puestos:

• cada punto de ruptura va a la primera instrucción de su línea o posterior;
• su dirección y su banco salen del listado, siguiendo RORG, así que son correctos también en juegos con cambio de banco;
• una línea dentro de una macro pertenece a la línea que llama a la macro;
• en batari Basic, los puntos de ruptura están en las líneas del .bas.

Gopher2600 los recibe en un guion que ejecuta al arrancar. Stella los recibe en build/<rom>.script, que su depurador ejecuta al abrirse (la aplicación de macOS lo lee de otro sitio, así que allí va también una copia). Se guardan en <project>.vcsproj.user.

Los cartuchos de C para ELF se ejecutan en el ARM del cartucho, donde ningún emulador puede parar en una línea, así que sus puntos de ruptura no se pasan.

Opciones del emulador

Compilar → Opciones del emulador... define cómo arranca cada emulador en este proyecto: 54 opciones para Stella y 21 para Gopher2600, cada una con su ayuda al pasar el ratón.

• Sonido, colores de depuración, el tipo de TV y los interruptores de dificultad.
• Mandos de cada puerto.
• Paleta y efectos de TV.
• RAM al azar, registros de la CPU y del TIA al reiniciar, para cazar código que espera ceros.
• Paradas por accesos erróneos a puertos, revisiones del TIA y las comprobaciones del ARM para DPC+, CDFJ y ELF.
• Argumentos extra libres, para todo lo demás.

Tus ajustes del emulador no se tocan

Stella guarda en sus propios ajustes cada opción de la línea de órdenes cuando se cierra. Si VCSIDE lo arrancara con las tuyas, una prueba con RAM al azar u otra paleta se quedaría para siempre en tus ajustes. Por eso cada emulador arranca con una copia privada de tus ajustes, renovada cada vez:

• Stella con su propia carpeta base (en macOS, su HOME apunta a la copia);
• Gopher2600 en modo portable, cuando una opción ha cambiado.

Tus ajustes nunca cambian, y lo que modifiques dentro de un emulador lanzado desde VCSIDE no se conserva.

Ir a dirección

Cuando el emulador se detiene en una dirección, Ctrl+Shift+G te lleva a la línea del código fuente. Escribe una dirección o una etiqueta y, si quieres, un banco. El 6507 ve el cartucho en varias direcciones ($F000 es lo mismo que $1000), y VCSIDE lo sabe. Si la dirección existe en más de un banco, lista cada línea.