Introducción:

Ana Rosa es un emulador de ordenadores de la arquitectura Amstrad PcW16. También es capaz de emular hardware adicional, diferentes opciones y configuraciones, etc.

No emula los modelos clásicos de PCW, pues pertenecen a una arquitectura distinta; para ello está su propio emulador.

La versión actual del emulador es la 0.1.1, siendo a la cual hace referencia este manual.

El objetivo es lograr una emulación lo más fiel posible a la máquina original.

Características:

Todo incluido en un solo fichero ejecutable.
Entra en un disco de 3,5".
Emula diferentes tamaños de RAM y Flash (1MB / 2MB).
Emula el hardware integrado: disqueteras MF2HD, puertos serie, paralelo, puerto ATA, teclado PS/2, ratón Mouse Systems.
- Nota: el SO no aprovecha el puerto ATA (aunque tiene rutinas para ello) ni la segunda unidad de disco.
Emula además:
- PcW16AY (sonido + joystick por el puerto paralelo).
- Salida de color.
Entiende los formatos:
- Snapshot: P16.
- Disco: DSK, IMG.
- Acciones: A16.
- Pantalla: PNG.
- Video: WMV.
- Almacenamiento: HDF, RAW / BIN / IMG.
La interfaz permite arrastre.
Modo rápido para acelerar manualmente cuando el usuario decida.
Opciones de audio y video, incluyendo filtros. Soporta pantalla completa.
Modo rápido en carga de disco.
Opción de arranque rápido.
Capaz de usar joysticks / pads de PC.
Depurador con capacidad puntos de ruptura en ejecución, lectura, escritura, input y output, soportando rangos y patrones.
Soporte de macros / comandos.

Requerimientos:

Windows XP o superior.
Intel Pentium 4 / AMD Athlon 64 o superior (SSE2).
Dispositivo de audio.
Para grabación de video se requiere Windows 7 o superior, recomendando además un ordenador capaz.

Rollo legal:

No asumo responsabilidad alguna.
Puedes hacer lo que quieras con este programa.
Todas las marcas o derechos de cualquier tipo, nombres registrados, logos o insignias, son propiedad de sus respectivos dueños.

Instalación y uso:

Instalación:

Este emulador no precisa de instalación alguna, simplemente basta con descomprimir los contenidos del fichero ZIP en alguna carpeta y proceder a ejecutarlo.

Adicionalmente, el programa soporta la automatización de comandos a través de la línea de comandos, siendo su sintaxis idéntica a las de las macros. Se puede utilizar para asociar extensiones de ficheros, ejecutarlo desde lanzadores externos, etc.

Por otro lado, la máquina emulada sí requiere de una instalación, pues no se incluye una imagen completa de la flash por defecto.

Snapshots:

Un fichero de snapshot es un estado completo de la máquina (incluyendo memoria, estado del hardware, contenido de discos, etc.) junto con metadatos sobre la máquina emulada.

Al arrastrarse un fichero sobre la ventana este se cargaría sin más. Si durante el soltado sobre la ventana estuviese apretada la tecla de mayúsculas, la emulación se activaría en caso de estar desactivada.

Acciones:

Un fichero de acciones es un snapshot junto con datos adicionales que describen los eventos sucedidos tras ese momento. Es útil para guardar tutoriales o partidas de forma más compacta que un video.

Discos:

Un fichero de disco contiene los datos de usuario de un disquete físico, junto con información geométrica del mismo.

El emulador es capaz de cargar tanto discos en formato DSK del CPCEmu (normales y extendidos, con o sin protección) como imágenes crudas con extensión IMG.

El emulador trabaja con imágenes de disco en memoria, con la opción de volcarlas al ser desmontadas. También tiene la opción de montarlas con protección de escritura.

Al arrastrarse un fichero sobre la ventana este se montaría en la unidad A. Si durante el soltado sobre la ventana estuviese apretada la tecla control, este se insertaría en la unidad B; si estuviese apretada la tecla de mayúsculas, el emulador se reiniciaría y la emulación se activaría en caso de estar desactivada (opción interesante para discos de arranque).

Adicionalmente, el emulador permite acelerar la emulación durante las cargas de disco.

Videos:

El emulador permite la grabación de videos, grabando exactamente lo mostrado en la pantalla emulada y el sonido emitido.

Esta opción requiere Windows 7 o superior, así como de un ordenador capaz de comprimir video en tiempo real.

Teclado:

El emulador mapea por defecto cada tecla del PC a la correspondiente del PcW16. Cuando no está capturada la entrada, los atajos de teclado del emulador no generan pulsaciones, y viceversa: cuando hay captura no funcionan los atajos de teclado.

Para salir de la captura, basta pulsar la tecla Aplicación (entre Windows derecho y Control derecho), o retirando el foco de la aplicación (tecla Windows, etc.).

Joystick:

El emulador reconoce cualquier joystick / pad que Windows reconozca, mapeando directamente el eje X, Y y los dos primeros botones hacia el joystick emulado y convirtiendo la señal a digital en caso de ser necesario.

Ratón:

El emulador es capaz de emular un ratón de PcW16. Para poder manejar el puntero en el PcW16 emulado debemos capturar la entrada, lo cual se efectúa haciendo click con el botón derecho sobre la pantalla emulada. Para liberarlo de nuevo, basta pulsar la tecla Aplicación.

Almacenamiento masivo:

El emulador es capaz de emular varios dispositivos de almacenamiento masivo: Flash y ATA. En el primer caso, se intentará usa un fichero llamado 1024.bin o 2048.bin según el tamaño de la flash en la carpeta del emulador. En caso de no existir serán creados, y requerirán una instalación.

En el segundo caso se pueden utilizar tanto imágenes crudas como ficheros HDF que incluyen información geométrica del disco.

Dado el tamaño de dichos ficheros su información no se almacena en los snapshots, sino un vínculo al fichero que lo contiene.

Interfaz:

En modo de ventana, se disponen de los siguientes elementos:

Título:

En la parte superior de la ventana, como en cualquier otra aplicación, se encuentra la barra de título.

Esta incluye el título de la aplicación y además el nombre del disco insertado en la unidad A.

Por último, se incluyen los típicos iconos de minimizar, maximizar y cerrar la ventana, los cuales tienen el comportamiento esperado de cualquier otra aplicación, con la excepción del maximizar: pulsando sobre él se activa el modo de pantalla completa, del cual puede salirse pulsando Escape.

Menús:

Archivo
- Snapshot
  - Abrir - Abre un snapshot.
  - Guardar - Guarda un snapshot.
- Acciones
  - Reproducir - Comienza la reproducción de acciones.
  - Guardar - Comienza la grabación de acciones.
  - Detener - Detiene la grabación o reproducción de las acciones.
- Captura - Guarda una captura de la pantalla.
- Video
  - Grabar - Comienza la grabación de video.
  - Detener - Detiene la grabación de video.
- Unidad A / B
  - Insertar - Inserta disco en la unidad.
  - Extraer - Extrae disco de la unidad.
  - Nuevo - Crea un disco nuevo sin formatear y lo inserta.
  - SL - Disco de solo lectura.
  - Volcar - Volcar de vuelta el fichero de disco si fue modificado.
- Salir - Cerrar el emulador.
Opciones
- Hardware - Abre las opciones sobre el hardware. Tiene su propia sección en el manual.
- Emulación - Abre las opciones sobre el emulador. Tiene su propia sección en el manual.
- Idiomas - Tiene un submenú con los lenguajes soportados y la autodetección de los mismos, para poder elegir.
- Depurador - Abre el depurador. Tiene su propia sección en el manual.
- Persistencia - Nivel de emulación de la persistencia del fósforo de la pantalla. Tiene 4 niveles, de menor a mayor efecto.
- Inicio / fin - Alterna la emulación entre encendida y apagada.
- Modo rápido - Alterna entre velocidad normal y máxima.
- Botón - Algunas interfaces tienen un botón, aparece cuando se selecciona dicho hardware. Su efecto depende de la interfaz.
- Reiniciar - Reinicia la máquina emulada, como pulsar un botón de reset.
- Hard reset - Emula de cero la máquina, como si se apagase y encendiese de nuevo.
Ayuda
- Manual - Abre este manual en el navegador.
- Acerca - Muestra información sobre el emulador.

Barra:

Bajo los menús tenemos la barra, la cual se divide en tres secciones:

Atajos - Atajos de diferentes acciones presentes en los menús. Estas son, de izquierda a derecha:
- Inicio / fin.
- Reiniciar.
- Botón (en caso de existir).
- Modo rápido.
- Volumen del audio.
Botón - El botón del PcW16, activo durante la emulación.
Macros - Situada a continuación de los atajos, esta sección son todas las macros definidas para el emulador. Por defecto no hay ninguna. Cuentan con su propia sección en el manual.
Estado - Alineada a la derecha, esta sección nos muestra de forma visual el estado de diferentes elementos hardware. De izquierda a derecha tenemos:
- Ratón (captura de la entrada).
- Flash.
- Disco.

Pantalla:

Esta sección representa la pantalla del ordenador emulado, con sus correspondientes opciones visuales.

Admite el arrastre de ficheros de snapshots, acciones y discos.

Hardware:

En esta ventana se pueden escoger las opciones hardware a emular. La aceptación de las mismas provocará un reinicio de la emulación. Las opciones se dividen en varias pestañas:

PcW16 - Definen el modelo base a emular:
- RAM - Cantidad de RAM, 1MB o 2MB.
- Flash - Cantidad de Flash, 1MB o 2MB.
- Unidad A / B - Tipo de unidad de disco en dicha unidad.
- ATA HD - Imagen de disco a emular; puede estar vacía.
Extras: PcW16AY.

Emulación:

En esta ventana se pueden escoger las opciones del emulador. La aceptación de las mismas no provocará un reinicio. Las opciones se dividen en varias pestañas:

Multimedia
- Monitor - Pantalla a emular, color o luminosidad a partir de verde.
- Scanlines - Muestra los píxeles definidos o interpolados en horizontal de forma similar a un monitor CRT.
- Borde - Zona de overscan a visualizar.
- PcW16AY - Permite elegir los niveles de salida, normal o lineal.
- Unidades - Reproducir sonido de disco al ser accedido.
- Filtro bajo-paso - Aplica un filtro bajo-paso, que elimina frecuencias altas.
Emulación
- Ventana - Opción de escalado de ventana: interpolado de salida, opción de aspecto y auto esconder cursor (PC).
- Joypad - Permite la elección del joystick / gamepad usado.
- Unidad - Permite elegir si el indicador de disco se enciende en señal motor o ejecución de comandos. También existe la opción de carga rápida que acelera el emulador mientras el motor esté activo.

Uso avanzado:

Depurador:

La ventana del depurador es flotante, redimensionable y queda siempre por encima de la del emulador. Mientras esté abierta, el emulador trabaja en modo de depuración.

Al ejecutar código ésta adquiere transparencia para indicar indisponibilidad y poder ver lo que tenga debajo. Con la tecla Escape se puede detener siempre la ejecución.

Si no ejecuta código, sobre la pantalla del PCW estará marcada la posición de vídeo actual con dos líneas rojas.

La ventana consta de varias secciones:

Registros:

En esta sección se muestra el valor de los diferentes registros del Z80, en rojo si fueron modificados desde la última operación. El valor de los mismos se puede modificar de forma directa.

Además se puede ver el estado de los distintos flags. Con doble click sobre los mismos se cambia su valor.

Por último, si se está usando el modo decimal, los valores de los registros muestran sus partes altas y bajas separadas si se posa el ratón encima.

Desensamble:

Esta sección representa un desensamble de la memoria, por defecto a partir del registro PC.

Las filas en rojo indican que causarán ruptura; además, la correspondiente al valor de PC tiene fondo naranja. Con doble click sobre una fila se rellenan los datos para poner un punto de ruptura en esa dirección.

Debajo existen los siguientes botones:

Ir a - Cambia la dirección a partir de la cual se desensambla.
Paso - Ejecuta solo la instrucción actual.
Siguiente - Punto de ruptura temporal en la instrucción siguiente a la actual y ejecuta.
Salir - Punto de ruptura temporal en la dirección indicada en el tope de la pila y ejecuta.
Ejecutar - Ejecuta de forma incondicional.
Ejecutar hasta - Punto de ruptura temporal en la dirección seleccionada y ejecuta.
Tron - Activa / desactiva el modo de ejecución instrucción por instrucción.
Subir, Bajar - Navegar por la memoria. Esto mismo puede lograrse con la rueda del ratón sobre el desensamble.

Puntos de ruptura:

Esta sección permite definir puntos de ruptura. Cada uno tiene las siguientes propiedades:

Tipo - Los tipos de accesos para los cuales se produce. Pueden combinarse entre Fetch (X), Lectura (R), Escritura (W), Entrada (I) y Salida (O).
Expresión - Mediante una expresión se determina a qué direcciones se aplica. Se describe abajo.
Activo - Determina si se detiene la ejecución al producirse.
Contador - Determina si se incrementa la cuenta al producirse.
Cuenta - Valor que puede incrementarse con la opción Contador.

En la parte de abajo se encuentran botones para añadir, eliminar y editar un punto de ruptura. Un doble click sobre uno existente también lo edita, y además pueden arrastrarse para reordenar la lista.

La expresión determina a qué direcciones debe aplicarse. Su sintaxis puede describirse como:

[Expresión]:=[Términos] | [Términos] "=" [Valor]
[Términos]:= [Término] [Términos2]
[Términos2]:="" | [Términos]
[Término]:=[Base] [Patrón] | [Base] [Rango]
[Rango]:=[Patrón] "-" [Patrón]
[Valor]:=[Base] [Patrón]
[Base]:= "" | "%" [Patrón]
[Patrón]:=[Dígito] [Dígitos]
[Dígitos]:="" | [Patrón]
[Dígito]:="0" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9" | "A" | "B" | "C" | "D" | "E" | "F" | "X"

Notas sobre la semántica:

Por defecto la base es 16.
No distingue mayúsculas / minúsculas.
Cualquier espacio en blanco, retorno de carro, etc. es ignorado, salvo entre dos [Dígito]s.
El patrón de la base debe ser un número natural válido entre 2 y 16, en base 10.
En otro contexto, un patrón debe conformar un número natural válido en su base correspondiente, pudiendo ser alguno de sus dígitos "X" indicando que vale cualquiera.
Un patrón que no cubra explícitamente todos los bits requeridos (16 para direcciones, 8 para valores) casará los restantes a 0. Cualquier bit sobrante será ignorado.
[Base] cambia la base numérica de la expresión de ese punto en adelante.
En caso de existir un valor, éste debe casar con el contenido de la memoria / IO correspondiente (en esta versión solo se casa XR); de no hacerlo, casa siempre.

Ejemplos:

----O "XXF1" - ruptura en cualquier cambio de memoria en bloque 1.
X---- "%8 X0" - ruptura en cualquier RST.

Otros:

Pila - Muestra los últimos valores en la pila.
Mapa memoria - Muestra el mapa de memoria del PCW. Con doble click sobre una fila puede cambiarse el mapeo de forma temporal.

Registros hardware:

Aquí se muestra el valor de algunos registros hardware; de nuevo, en rojo los que han cambiado.

Memoria:

Esta ventana representa un volcado de la memoria. El valor de cada posición puede ser cambiado escribiendo otro valor en su casilla.

Debajo existen los siguientes botones y opciones:

Ir a - Cambia la dirección a partir de la cual se vuelca.
Cargar - Carga un volcado sobre la memoria, a partir de la dirección especificada.
Grabar - Graba un volcado de la memoria, a partir de la dirección y longitud especificada.
Buscar - Abre la ventana flotante de búsquedas. Permite buscar cadenas de texto (MAY/min) o binarias sobre la memoria.
Lectura / Escritura - Sirven para escoger sobre qué memoria se trabaja, la que se lee o escribe (no tienen por qué ser iguales).
Video exacto - Esta opción hace que se pinte la pantalla sincronizada y con valores anteriores como futuros (no han sido dibujados todavía). En caso contrario, se pinta entera a partir del estado actual.
Hexadecimal - Esta opción cambia las vistas y entradas de datos entre decimal y hexadecimal.

Aparte, mientras se está en modo de depuración se admiten ciertas instrucciones Z80 especiales:

ED FE (DEBUG_BP) - Punto de ruptura por software.
ED FF (DEBUG) - API de depuración; función en A y parámetro en BC:
- 0 - Idem ED FE; el contenido de BC se ignora.
- 1 - Imprime la cadena de texto ANSI terminada en 0 apuntada por BC, hasta 256 caracteres.
- 2 - Muestra el valor de BC, permitiendo su modificación antes de continuar.
- 3 - Quita o pone el modo rápido, según BC sea 0 u otro valor.

Formato P16:

El formato de snapshot PcW16 nace de la necesidad de representar todo lo necesario para la emulación (incluyendo discos) en un solo archivo y al mismo tiempo ser manipulable por el usuario avanzado de forma sencilla.

Por eso mismo cada archivo PcW16 no es más que un archivo ZIP, el cual contiene dentro otros archivos. De esta forma puede manipularse con cualquier programa compresor.

Dentro hay dos tipos de archivos: textuales (INI, legibles y editables con cualquier editor de texto) y volcados de datos (resto, normalmente BIN).

Siempre se hayan presentes "Config.ini" (configuración hardware del emulador), "Hardware.ini" (estado de dicho harware), "Memory.bin" (volcado de la RAM) y "Flash.bin" (idem flash).

Cada linea en los archivos de texto es de la forma "A=B", asignando el valor B a la propiedad A. Dentro de "Hardware.ini", los registros del Z80 son las propiedades "Z80_xxx".

Las acciones son exactamente un snapshot junto con un fichero extra que contiene los valores que han de ser leídos en los puertos, así como los correspondientes al teclado.

Macros:

El emulador tiene un pequeño intérprete de macros, las cuales consisten en la ejecución de uno o más comandos del emulador.

Estos pueden lanzarse desde la línea de comandos o bien almacenarse como macreos en la carpeta macros del emulador.

En el caso de almacenarse en la carpeta, estas constan de dos ficheros con el mismo nombre y extensiones TXT y PNG respectivamente. Al arrancar el emulador estas se enumeran y se añaden en forma de botones al emulador, en la barra superior, y se pueden invocar apretando dicho botón.

El lenguaje de macros está compuesto por tokens (comandos o parámetros de los mismos) separados por blancos (espacios, tabuladores, retornos de carro). En el caso que un parámetro contenga espacios, puede rodearse de comillas para no ser fragmentado en tokens.

El lenguaje es muy simple: una sucesión de comandos separados entre sí, cada uno seguido de sus parámetros igualmente separados. Cada comando tiene una forma corta (un carácter, menos escritura) y una larga (una palabra, más intuitiva), pudiendo emplearse ambas de forma indistinta.

Los comandos no distinguen mayúsculas de minúsculas. En forma corta los comandos pueden de forma opcional estar precedidos de - o /, por compatibilidad.

La ejecución de dichos comandos es asíncrona a la emulación en caso de estar activa, salvo que se indique lo contrario.

Los comandos son:

Corta	Larga	Descripción
8	EXIT	Sin parámetros. Salir del emulador.
9	WAITK	Sin parámetros. Espera a que el buffer de teclado quede vacío.
@	EXEC	Toma cinco parámetros. El primero es el valor del registro PC del Z80, los otros cuatro la configuración de memoria (puertos $F0-$F3 del GA).
R	RESET	Toma un parámetro opcional. Reinicia el emulador, y en caso de haber un parámetro especifica un fichero con la definición hardware a hacer efectiva, o hace un hard reset si es *.
A	DISKA	Toma un parámetro. Si el valor es . entonces extrae el disco de la unidad A, en caso contrario inserta el fichero imagen de disco especificada en el parámetro. Obsoleto.
B	DISKB	Igual que el caso anterior, pero para la unidad B.
D	DISK	Similar a los dos casos anteriores, pero toma dos parámetros. El primero es la unidad (A o B), el segundo el fichero especificado o bien si es . extrae el actual.
E	SYNC	Sin parámetros. "Sincroniza" estado (detiene el emulador y lo pone a velocidad normal). Obsoleto.
T	TYPE	Toma un parámetro. Añade el parámetro como cadena de caracteres al buffer de teclado. Admite el carácter # como escape para caracteres, en formato de dos dígitos hexadecimales.
W	WAIT	Toma un parámetro. Esperar el número determinado por el mismo de milisegundos. En caso de estar detenida la emulación, la inicia.
F	FULL	Toma un parámetro de forma opcional. Este puede ser OFF o 0 para modo ventana, ON o 1 para modo pantalla completa, ninguno para alternar.
G	SPEED	Toma un parámetro de forma opcional. OFF o 0 para modo normal, ON o 1 para el modo rápido, ninguno para alternar.
O	TURN	Toma un parámetro de forma opcional. OFF o 0 para emulación detenida, ON o 1 para iniciada, ninguno para alternar.
X	EXTERNAL	Toma dos parámetros. Ejecuta el programa externo indicado por el primero con los parámetros indicados en el segundo.
P	POKE	Toma dos parámetros. Escribe en la dirección de memoria absoluta indicada por el primero el valor indicado por el segundo. Ambos son números en hexadecimal.
Q	DEBUG	Sin parámetros. Abre el debugger.
S	SNAPLOAD	Toma un parámetro. Carga el fichero de snapshot indicado por él.
U	SNAPSAVE	Igual que el caso anterior, pero grabando.
Y	BINLOAD	Toma dos parámetros. Carga en la dirección de memoria absoluta indicada por el primero el fichero binario indicada por el segundo.
Z	BINSAVE	Igual que el caso anterior, pero grabando.

Notas:

En contrucción.

F.A.Q.:

¿Cómo instalo el sistema operativo? => Basta insertar una imagen del disco del sistema cuando te lo pida y pulsar el botón. Se recomienda usar el modo rápido porque es un proceso lento.
¿Dónde puedo conseguir juegos y aplicaciones? => Aquí no. Y por motivos de copyright no puedo decirte dónde ni cómo usarlas.
¿Cómo se ejecuta un programa externo? => Task -> Run External Program; o pulsar alternativamente Task+F7. En el cuadro de diálogo se escoge la ubicación (normalmente disc en vez de cabinet y escoger de lista que aparece).
¿Cómo se usa un PcW16? => Existen webs donde lo explican, además del manual del mismo.
¿Vas a portarlo a Linux? ¿Necesitas ayuda para programarlo? => No, de momento.
¿Cuándo saldrá la siguiente versión? => No lo sé.
¿Vas a liberar el código fuente? => No, de momento; hay mucho que limpiar todavía.
¿Aceptas donaciones? => Claro. Acepto cualquier material de PcW16.

Errores comunes:

He puesto dos unidades de disco y la segunda no funciona. => El SO no usa la unidad B.
He puesto una imagen ATA y no funciona. => El SO no usa el ATA.

Más información:

Contacto:

Web: http://www.habisoft.com/pcw16
Correo: pcw [ARROBA] habisoft [PUNTO] com

Agradecimientos: