AMSpiriT Lite — Referencia rápida

AMSpiriT Lite es un emulador Amstrad CPC para Linux basado en el núcleo AMSpiriT de David MANUEL.

Teclas de control

Tecla	Acción
`F1`	Abrir esta ayuda en el navegador
`F2`	Guardar una captura de pantalla PNG en el directorio actual
`Shift`+`F4`	Guardar snapshot (.sna) en la ranura actual
`Ctrl`+`F4`	Cargar snapshot desde la ranura actual
`Ctrl`+`0` a `Ctrl`+`9`	Cambiar a la ranura de snapshot 0–9 (guardados persistentes)
`Ctrl`+`E`	Exportar (detokenizar) programa BASIC desde RAM
`F7`	Bajar el volumen (-10 %)
`F8`	Subir el volumen (+10 %)
`F9`	Activar / desactivar el modo turbo (velocidad máxima, audio silenciado)
`F10`	Reinicio total (arranque en frío)
`Shift`+`F10`	Reinicio suave (arranque en caliente)
`F11`	Cambiar tipo de pantalla (color, monitor verde, variantes ASIC)
`Shift`+`F11`	Mostrar / ocultar el indicador FPS
`Ctrl`+`F11`	Cambiar los modos de visualización CRTC (depuración)
`F12`	Alternar pantalla completa / modo ventana
`Shift`+`F12`	Alternar vista: pantalla CPC visible ↔ trama CRTC completa
`Pause`	Pausar / Reanudar la emulación
`Ctrl`+`O`	Abrir un diálogo de selección de archivo
`Alt`+`F4`	Cerrar la ventana (gestionado por el gestor de ventanas)
`Esc`	Salir (solo cuando la emulación está en pausa)
`Ctrl`+`1` a `Ctrl`+`0`	Teclado numérico CPC 1–0 (para portátiles sin teclado numérico)

Carga de archivos

Arrastre y suelte un archivo sobre la ventana del emulador para cargarlo, o use Ctrl+O para abrir un diálogo de archivo (requiere zenity o kdialog).

Consejo: mantenga Ctrl mientras arrastra un archivo para realizar un reinicio total antes de cargarlo — útil para iniciar una imagen de disco en un estado limpio.

Formato	Descripción
`.dsk`	Imagen de disco estándar
`.hfe` / `.ipf`	Imagen de disco de alta fidelidad (CAPS)
`.cdt` / `.wav`	Cinta (CDT o audio WAV)
`.sna`	Snapshot (estado guardado)
`.cpr`	Cartucho CPC Plus / GX4000 — cambia automáticamente al modelo CPC 6128+ y tipo CRTC 3

Modo turbo

El modo turbo desactiva la cadencia de 50 Hz y silencia el audio, permitiendo al emulador funcionar a la velocidad máxima de la CPU. Útil para omitir cargas largas de cinta o intros.

Pulse F9 para activar o desactivar el modo turbo en cualquier momento.
Al lanzar con --turbo junto con --autotype o -A, el turbo se detiene automáticamente cuando finaliza la secuencia de escritura automática.

Joystick

Los joysticks USB se detectan automáticamente al inicio y al conectarlos. El primer joystick encontrado se asigna al puerto 1 del CPC.

Botón	Acción CPC
Botón 0	Disparo 1
Botón 1	Disparo 2
Botón 2	Disparo 3
Botón 3 / Start	Pausar / Reanudar emulación
LB (botón izquierdo)	Guardado rápido del snapshot en la ranura actual
RB (botón derecho)	Carga rápida del snapshot desde la ranura actual
Eje X / Y o sombrero	Direcciones (arriba, abajo, izquierda, derecha)

Servidor web de depuración

Al lanzar con --web-ui, el emulador inicia un servidor HTTP local que expone una interfaz de depuración en el navegador: registros Z80, Gate Array, PSG, FDC, FPS y controles (pausa, reinicio, cambio de modelo).

amspirit-lite-sdl --web-ui [--web-addr 0.0.0.0] [--web-port 8765] [--web-html ruta/a/ui.html]

Opción	Descripción
`--web-ui`	Activar el servidor (desactivado por defecto)
`--web-addr <dirección>`	Dirección de escucha (por defecto: `127.0.0.1` — solo local; use `0.0.0.0` para todas las interfaces)
`--web-port <puerto>`	Puerto de escucha (por defecto: `8765`)
`--web-html <archivo>`	Ruta al archivo HTML de la interfaz (por defecto: `amspirit-lite.html` junto al binario)

El archivo amspirit-lite.html puede editarse sin recompilar. Si falta, se usa la interfaz integrada en el binario como alternativa.

Distribución del teclado

La distribución del teclado del CPC se selecciona mediante la opción --lang al iniciar el emulador. Las distribuciones disponibles son:

Valor	Distribución del CPC
`FR`	Francés (AZERTY)
`EN` / `UK`	Inglés (QWERTY Reino Unido)
`US`	Inglés (QWERTY EE.UU.)
`ES`	Español
`GE`	Alemán (QWERTZ)
`IT`	Italiano
`DA`	Danés

AltGr: la tecla AltGr es absorbida y nunca se reenvía al CPC. Los caracteres AltGr (|, {, }, ~, @, …) llegan al emulador directamente a través de su sym SDL.

Opciones de línea de comandos

amspirit-lite-sdl [OPCIONES] [ARCHIVO]

Emulación

Opción	Descripción
`-m <modelo>`	Modelo CPC: `464`, `664`, `6128` (por defecto), `6128+`, `464+`, `GX4000`
`-c <tipo>`	Tipo CRTC (0 a 4)
`-R <ruta>`	Directorio de ROMs (por defecto: `./ROMs`)
`-C <ruta>`	Directorio de configuración (por defecto: `./config`)
`-F`	Iniciar en pantalla completa
`-Z` / `--turbo`	Iniciar en modo turbo (velocidad máxima)

Carga automática

Opción	Descripción
`-A` / `--autorun`	Escribe automáticamente `RUN"` tras el arranque para lanzar el primer programa
`-T <nombre>` / `--run <nombre>`	Escribe automáticamente `RUN"<nombre>` al inicio
`-t <archivo>` / `--autotype <archivo>`	Escribe el contenido de un archivo de texto en el CPC tras el arranque

Audio y pantalla

Opción	Descripción
`-L <ms>` / `--audio-latency <ms>`	Latencia del búfer de audio en milisegundos (por defecto: 80 — aumentar si hay crepitaciones)
`--show-overlay`	Mostrar el indicador FPS en la esquina superior izquierda (rojo = demasiado lento, azul = demasiado rápido)

Servidor web de depuración

Opción	Descripción
`--web-ui`	Activar el servidor HTTP de depuración (desactivado por defecto)
`--web-addr <dirección>`	Dirección de escucha (por defecto: `127.0.0.1`)
`--web-port <puerto>`	Puerto de escucha (por defecto: `8765`)
`--web-html <archivo>`	Ruta al archivo HTML de la interfaz de depuración

Varios

Opción	Descripción
`-K`	Activar la salida de depuración detallada del teclado
`--dump-keymap`	Generar un archivo `keymap.cfg` de referencia basado en la disposición actual y mostrar en stdout
`-X <segundos>`	Salir automáticamente después de N segundos (pruebas automatizadas)

Configuración del teclado (keymap.cfg)

Genere un archivo keymap.cfg usando la opción --dump-keymap, luego edítelo a su conveniencia y reinicie el emulador:

amspirit-lite-sdl --dump-keymap > keymap.cfg

Coloque el archivo keymap.cfg generado en su carpeta ROMs/ o config/. El archivo utiliza formato INI con dos secciones: [keyboard layout] y [emulator hotkeys].

Acciones de atajo admitidas: PAUSE, HELP, SCREENSHOT, SNAPSHOT_SAVE, SNAPSHOT_LOAD, BASIC_EXPORT, VOLUME_UP, VOLUME_DOWN, FULLSCREEN, MONITOR_TYPE, CRTC_SELECT, VISIBLE_FRAME

Formato de teclas: Tecla única (F1, A, Escape, Return, Space) o modificadores (Ctrl+X, Shift+F1, Alt+Shift+P). Sin distinción de mayúsculas.

Los cambios toman efecto al reiniciar. Para encontrar el código de una tecla, ejecute con la opción -K y busque mensajes DOWN en la consola. Nota: Las aplicaciones SDL y Qt utilizan códigos de tecla diferentes; use archivos keymap separados para cada una si ejecuta ambas.

Núcleo AMSpiriT por David MANUEL — port Linux por Siko — amspirit.fr