http://amikit.amiga.sk/

Cómo instalar AmiKit y E-UAE (o UAE)

Guía AmiKit para la plataforma Linuxv3

Redactada por Tom Newsom

Traducción española por Víctor Gutiérrez

Este documento no presupone ningún nivel de conocimiento en el uso de E-UAE. Tanto si eres un neófito recién llegado en busca de ayuda para utilizar E-UAE y AmiKit, como si eres un usuario

experimentado con E-UAE y buscas ayuda para hacer funcionar AmiKit, esperamos que esta guía sirva de ayuda para todos.

Existen diferencias sutiles entre UAE y E-UAE que explicaremos al final del documento. Por lo demás se puede utilizar E-UAE sin problemas en cualquier momento del documento.

- 2 -

Comencemos pues. Necesitamos E-UAE instalado y con la interfaz de configuración (GUI) al menos cargada. Puedes descargar un binario ya compilado o el código fuente desde http://www.rcdrummond.net/uae/index.html. Sea cual sea el que uses, asumimos de ahora en adelante que es capaz de cargar la interfaz de configuración.

Es el momento idóneo para descargar la versión Linux de AmiKit desde http://amikit.amiga.sk/. Asegúrate de estar situado en el directorio donde deseas guardar AmiKit. Más adelante necesitarás la ruta cuando la tengas que especificar durante la configuración. Yo tengo todos mis ficheros relativos a la emulación de Amiga en un directorio situado en mi directorio home que he nombrado (imaginariamente) Amiga-Emulation. En él guardo todos los hardfiles, p.ej. Beneath.hdf, ROMs y todo lo relacionado con el Amiga. Reconozco que tengo una estructura de directorios nítida y ordenada, algo que no es habitual en muchos usuarios, así que en esto no hay reglas establecidas aunque hay ciertas ventajas implícitas en tenerlo todo con este esquema, pero no voy a entrar a explicarlas en este artículo. Tendrás que confiar en mí. Aclaro que las rutas que he usado como ejemplo están tomadas de mi propia configuración y no tienes por qué seguirlas, pero si tienes algún problema y necesitas ayuda de los foros de AmiKit, facilitará poder ayudarte y será más rápido si lo hiciste así.

Dicho esto. Crea un directorio con el nombre AmiKit, cd a dicho directorio y utiliza unzip para extraer los fuentes en el directorio hacia donde hiciste cd. (Observa que para reducir el tamaño global el archivo AmiKit.zip se sitúa dentro de otro archivo zip llamado AmiKit-linux-latest.zip que tendrás que descomprimir en primer lugar.)

mkdir -p ~/Amiga-Emulation/AmiKit cd ~/Amiga-Emulation/AmiKit unzip /path/to/the/amikit/AmiKit.zip

Deberías tener todos los ficheros de AmiKit (si seguiste mi consejo) en ~/Amiga-Emulation/AmiKit/. Son binarios de Amiga y no son funcionales por sí mismos sin algún emulador de Amiga que los pueda ejecutar.

Existen dos ficheros .uaerc diferentes (ficheros de configuración de E-UAE). Uno para x86 (procesador de 32bits) y otro para x86_64 (procesador de 64bits). El de x86 denominado .uaerc-x86 y el de x86_64 denominado .uaerc-x86_64. Según el tipo de su procesador instalarás uno u otro. Si no estás seguro de qué tipo de procesador tienes, puedes utilizar el comando ‘uname -m' (sin comas) para averiguarlo.

Cuando ya conoces el tipo de procesador que tienes puedes copiar uno de los ficheros de configuración a tu directorio home (p.ej. /home/<usuario>/.uaerc) que es donde E-UAE buscará automáticamente (no olvides renombrarlo como .uaerc). Si, como es mi caso, te gusta tener varias configuraciones para E-UAE para diferentes propósitos puedes copiar uno de los ficheros en cualquier otro lugar donde guardes tus configuraciones. En caso de hacerlo así tendrás que arrancar E-UAE con el modificador -f. Por ejemplo:

./uae -f /ruta/de/tus/configuraciones/uaerc-x86 o ./uae -f /ruta/de/tus/configuraciones/uaerc-x86_64

Ahora abre E-UAE. Lo primero que ves es la interfaz de configuración. Puede modificarse este arranque pero por ahora necesitamos esta ventana para poder configurar y utilizar AmiKit.

AmiKit requiere AmigaOS 3.1 o superior. Por ejemplo, AmigaOS 3.1, AmigaOS 3.5 y demás. En esta guía utilizaremos Amiga Forever http://amikit.amiga.sk/amigaforever.htm ya que contiene los ficheros comerciales requeridos. Si tienes AmigaOS3.9 o 3.5 no necesitas AmigaForever, así que en lugar de copiar el CD Amiga Forever en el disco duro copiaremos la versión que tengamos modificando los nombres (AmigaOS3.9 o AmigaOS3.5) según se indica en la sección relacionada de esta guía.

Tenemos AmiKit instalado, y también el medio de instalación. Pero como aún no hemos configurado E-UAE para poder utilizar unidades de CD/DVD, ahora nos pondremos con ello. Montamos el CD Amiga Forever y copiamos el contenido del CD al disco duro.

- 3 -

Dentro del directorio ~/Amiga-Emulation creamos uno llamado AmigaForever y copiamos el CD completo en este directorio.

mkdir -p ~/Amiga-Emulation/AmigaForever cp -Rav /mnt/cdrom/* ~/Amiga-Emulation/AmigaForever/

NOTA: para que funcione WHDLoad (Cargador de Juegos de Amiga instalado en AmiKit) copia el fichero ROM3.1 (dentro del paquete Amiga Forever nombrado ”amiga-os-310.rom”) al directorio AmiKit/Devs/Kickstarts y renómbralo como “kick40068.A4000”. Copia también el fichero ROM1.3 (”amiga-os-130.rom”) en la misma ubicación y renómbralo como ”kick34005.A500”. No olvides copiar también aquí el fichero “rom.key”.

Ya tenemos AmiKit y Amiga Forever instalados. Es momento de añadir los dos directorios a E-UAE. Abre E-UAE si aún no lo hiciste. Al arrancar E-UAE vemos la ventana GUI que tiene el aspecto de la siguiente imagen.

- 4 -

En la interfaz de configuración, en las pestañas de la parte superior verás una llamada 'hard disks'. Pulsa sobre 'Hard disks'. Pulsa sobre el botón 'Add' y verás algo parecido a la siguiente imagen.

Primero configuramos AmiKit pulsando el botón ‘select’ escogiendo la ruta de los ficheros AmiKit. A continuación ponemos DH0 en ‘Device name’ y AmiKit en ‘Volume name’. Ahora configuramos Amiga Forever pulsando 'Add' y luego 'Browse', indicando dónde tenemos los ficheros de Amiga Forever. En 'Device name' ponemos DH1 y en 'Volume name' AmigaForever.

Una vez terminado hay que ajustar algunas opciones de la interfaz de configuración, mientras que otras opciones tendremos que editarlas desde el fichero ~/.uaerc directamente.

- 5 -

Vé a la primera pestaña 'CPU' que tiene el aspecto de la siguiente imagen.

Al pulsar sobre el botón 'CPU Model' aparecerá una lista de los procesadores disponibles. Como se ve en la imagen, yo utilizo un 68040 pero el recomendado para AmiKit es el 68020. No hay reglas fijas en cuanto al procesador a utilizar, pero evita seleccionar el 68060 puesto que el esquema de emulación no es completo para dicho procesador.

- 6 -

A continuación tenemos la pestaña ‘Memory’ (imagen inferior).

Aquí se indica el fichero ROM de Amiga. Se necesita una ROM Amiga OS 3.1, así que pulsa 'change', búscala y selecciónala. Si utilizas una ROM de Cloanto Amiga Forever debes indicar también dónde se encuentra la ROM key. Tanto la ROM de Amiga OS como la ROM de Cloanto se encuentran en el CD de Amiga Forever que copiamos anteriormente al disco duro. Así que deben estar disponibles.

Aquí seleccionamos también los ajustes de memoria. AmiKit consume bastante así que a modo orientativo pondremos 2MB Chip Mem, 128MB Z3 Mem y 32MB P96 Mem. Más tarde puedes jugar con estos ajustes si estimas que es necesaria más memoria. RECUERDA que no puedes utilizar JIT con acceso directo a memoria si utilizas más de 32Mb de memoria Z3.

- 7 -

La siguiente pestaña es Chipset (imagen inferior).

Mediante el botón Chipset model se nos ofrecen varias opciones, aunque recomendamos con rotundidad seleccionar AGA. Cualquier otra opción puede producir resultados inesperados. Emulation speed lo podemos dejar tal y como viene por defecto.

- 8 -

Pestaña Sound

No hay demasiado que modificar aquí. Recomendamos utilizar Mode = Accurate, Channels = Stereo con Resolution = 16 bit.

- 9 -

Pestaña JIT (no disponible en todos los sistemas)

La opción JIT (Just In Time compiler – Compilador en tiempo real) aumenta el rendimiento de la emulación. Por ahora solo funciona en sistemas x86 (no válido para procesadores de 64 bits). Configura las opciones tal y como se ven en la imagen. Más tarde puedes modificar los ajustes si te parece que AmiKit funciona demasiado lento, pero lo más importante de todo es ajustar la opción 'Translation Buffer' por encima de cero (se recomienda 16384 o más). En caso contrario JIT no estará activado.

En algunos sistemas se dan problemas de rendimiento cuando se activa la opción JIT. Si es tu caso y el rendimiento es paupérrimo en tu sistema, haz lo siguiente:

Edita el fichero ~/.uaerc file y ajusta la opción 'x86.use_tsc=no'. En la pestaña JIT debes indicar 'Flags' como 'Always generate' NOTA: No tengas la interfaz de configuración de E-UAE abierta al editar el fichero.

- 10 -

La Pestaña Game Port

Port 0 y Port 1 se refieren a los puertos de ratón del Amiga. Se pueden emular de diferentes maneras. Como se puede apreciar en la imagen, tengo configurados Port 0 como Ratón y Port 1 como teclado numérico.

- 11 -

Y eso es todo lo que se tiene que configurar en la interfaz de E-UAE. Así, que guarda los cambios si los hiciste desde la opción 'File' del menú y pulsa 'Save config'. Guardará todos los ajustes en un fichero situado en tu directorio home denominado .uaerc. Puedes editar este fichero en tu editor preferido siempre que recuerdes cerrar E-UAE y reiniciarlo para que cargue los ajustes.

Ahora vamos a editar el fichero ~/.uaerc puesto que hay algunas opciones no disponibles en la interfaz de configuración. Abre el fichero .uaerc en el editor que prefieras.

Deberías ver algo semejante a la imagen inferior.

Como puedes ver es un fichero de texto plano. Eso facilita su edición. Échale un vistazo y verás que hay varias opciones configuradas como false y true y otras que tienen cadenas de texto a continuación. Otras opciones disponibles no se encuentran aquí. Podremos modificar y añadir todas las opciones disponibles. Recuerda cerrar y abrir E-UAE para que los cambios surtan efecto.

- 12 -

Busca las siguientes opciones. Si no encuentras alguna, añádela tal y como aparece escrita.

*.use.tsc= (donde * significa x86 o amd64 según el tipo de tu procesador)

Las opciones son ‘yes’ o ‘no’.

Hay un ajuste en el fichero .uaerc que varía según el tipo de tu procesador. Se denomina *.use.tsc=yes/no. En procesadores x86_64 UAE lo configura como amd64.use.tsc=yes, en procesadores x86 queda configurado como x86.use.tsc=yes Este ajuste depende totalmente de tus necesidades. En equipos x86 sin embargo, se suele decir que ajustando x86.use.tsc como yes, no hace rendir mejor el apartado JIT. Como dije antes, el uso de esta opción depende totalmente de las necesidades del usuario.

bsdsocket_emu= probablemente ajustado como 'false'. Cámbialo a 'true' o las funciones de red no funcionarán con el Amiga.

scsi= es una opción no disponible por defecto así que añádela e indícala como 'true'. Esta opción, junto con alguna otra que veremos más adelante, permite al Amiga utilizar la grabadora de CDROM o la grabadora de DVD del anfitrión (PC).

scsi_device= esta opción suele aparecer en blanco. En Linux deberíamos añadir el nodo de dispositivo CD/DVD. P.ej /dev/hda or /dev/sdb etc.

Resumiendo, estas tres opciones serían de este modo:

bsdsocket_emu=true scsi=true scsi_device=/dev/hda (o /dev/hdc o /dev/sdc etc)

Otro ajuste que merece la pena tener en cuenta al menos en sistemas Linux x86_64 es la opción 'frame rate’. Vuelve a observar la imagen anterior en busca de la pestaña 'chipset' y observa este ajuste hacia la parte inferior. Los usuarios de x86 no necesitan este apaño puesto que ya se benefician del JIT aún no disponible para plataformas x86_64. Pero, si utilizas x86 puedes modificar esta opción para exprimir hasta la última gota de velocidad de la emulación. Si estás editando ~/.uaerc o ~/.uaerc-amikit busca directamente la opción 'gfx_framerate='. El valor por defecto es 1, pero jugando con esta cifra podemos acelerar E-UAE. 8 es un valor que satisface mis necesidades. Puede que para ti sea mejor un valor inferior o superior. Si utilizas el fichero .uaerc-amikit este aparece configurado como 4, así que no merece mucho la pena cambiarlo por unas cifras más arriba o abajo. La opción 'gfx_framerate=' conlleva un coste (¿qué intercambio no es así?). La documentación de E-UAE lo describe así:

gfx_framerate= (por defecto=1)

Indica el ratio de generación de frames a la hora de emular la salida gráfica del juego de chips del Amiga. Puede ser un número entre 1 y 20, donde 1 indica que se generan todos los frames, mientras que 20 indica que sólo se genera 1 de cada 20 frames.

Al aumentarlo se eleva la velocidad de la emulación (hay menos trabajo por realizar), pero se resiente la calidad de la imagen.

Por ejemplo, al emular una salida PAL (50 Hz), para obtener una calidad de imagen total (gfx_framerate=1), E-UAE necesita actualizar la imagen 50 veces durante un segundo. Si se ajusta como gfx_framerate=4 E-UAE solo tendrá que dibujar 1 de cada 4 frames de modo que la imagen sólo se mostrará 12,5 veces por segundo.

Con esta opción merece la pena trastear hasta conseguir los resultados que consideremos óptimos. Una vez instalado AmiKit, y configurada una partición 'Work' en el Amiga, tendremos instalado el programa uaectrl. Echa un vistazo a 'Work:UAE-Control', dentro encontrarás el programa para Workbench 'UAE-Control’. Una vez ejecutado, muestra una ventana en Workbench. Ofrece la

- 13 -

posibilidad de insertar y retirar ‘disquetes’. Básicamente permite cargar imágenes de disco .adf (Amiga Disk Format) e .ipf (formato de la Software Preservation Society) en lugar de tener que acudir a la interfaz de configuración. Aparte, ofrece algunas opciones modificables durante la emulación, así como botones para depuración y reseteo. Una de las opciones durante la ejecución es el cambio al vuelo del ratio de frames (cuadros x segundo). Puedes jugar con este valor tanto como desees al tiempo que facilita comprobar en el acto lo que estamos ajustando. Una vez has encontrado un ajustes de ratio de frames que te satisfaga, puedes indicar el valor en la interfaz de configuración y guardar el ajuste para que permanezca tras cada reinicio.

Hay otras muchas opciones a la vista en el fichero de ajustes que cuentan con los valores ’false', 'true', 'yes' o 'no' y otros con diferentes textos. Puedes modificarlos y hacer pruebas con los mismos.

Esperamos que este documento te haya sido de ayuda y que te propicie muchas horas de entretenimiento utilizando AmiKit con E-UAE.

Tom Newsom (alias Jeepster) jeepster@gmx.co.uk

Diferencias entre UAE y E-UAE

Al inicio del documento mencioné algunas diferencias apreciables entre UAE y E-UAE. Se centran en cómo almacenan los datos de configuración, no en el aspecto de sus interfaces de configuración. Hay un potencial problema que deberías conocer, y es cómo almacenan UAE y E-UAE la información de filesystem y hardfile en el fichero ~/.uaerc. Aunque es posible guardar los ajustes de configuración por separado y utilizar el modificador ‘-f’ para cargar aquel que desees, este método puede resultar irrealizable por muchos motivos. Así que, ¿cuál es la diferencia? Te lo explicaré. Ten en cuenta cómo guarda E-UAE la información:

filesystem2=rw,DH0:AmiKit:$(FILE_PATH)/Amiga-Emulation/AmiKit,0 filesystem=rw,AmiKit:$(FILE_PATH)/Amiga-Emulation/AmiKit filesystem2=rw,DH1:AmigaForever:$(FILE_PATH)/Amiga-Emulation/AmigaForever,0 filesystem=rw,AmigaForever:$(FILE_PATH)/Amiga-Emulation/AmigaForever filesystem2=rw,DH2:Work:$(FILE_PATH)/Amiga-Emulation/Work,0 filesystem=rw,Work:$(FILE_PATH)/Amiga-Emulation/Work

Y cómo es en UAE:

filesystem=rw,AmiKit:$(FILE_PATH)/Amiga-Emulation/AmiKit2 filesystem=rw,AmigaForever:$(FILE_PATH)/Amiga-Emulation/AmigaForever filesystem=rw,Work:$(FILE_PATH)/Amiga-Emulation/Work

Observa que E-UAE incorpora la información adicional 'filesystem2'. Ese es el motivo que puede impedir que UAE lo cargue. Por el contrario, E-UAE no tiene problema alguno para arrancar con un fichero de configuración creado con UAE. El resto de las opciones, pueden compartirse entre ambos programas.

Acerca del autor de esta guía

Tom Newsom (alias Jeepster) es usuario de Slackware desde 1993. En la actualidad utiliza Bluewhite64, que es un sistema derivado de Slackware. Trabaja desde casa como administrador remoto estando especializado en administración de Sistemas Slackware.