See english version below.

SPANISH VERSION.

        Aliados version preliminar.
        (C) 2004 Julian Albo.
        Utilizable y distribuible bajo la licencia GPL.

Aliados puede usar dos emulaciones del procesador Z80:

La librería libz80 de Gabriel Gambetta, obtenible en
http://libz80.sourceforge.net/
La incluida con Aliados, a la que llamaremos ImcZ80, que es una adaptación de la emulación de Z80 de Joyce, emulador de Amstrad PCW de John Elliott, http://www.seasip.demon.co.uk/Unix/Joyce/ , que a su vez es una adaptación de la del emulador de Spectrum xz80, de Ian Collier.

Las opciones posibles para compilar son:

1- Si se quire usar la librería libz80:

Primero hay que compilar e instalar libz80.

Hecho esto, ejecutar: make aliadoslz

        2- Si se quiere usar ImcZ80, pero usar el desensamblador de
        libz80 en modo depuración de CPU:

        Editar el fichero cpm.cpp y descomentar la siguiente línea si
        está comentada.

        //#define DISASM_WITH_libz80

        Editar el Makefile, en donde dice:

        # Uncomment this if you compile with ImcZ80 and with libz80.
        #aliados: aliados.o cpm.o Z80.o realconsole.o
        #       g++ $(CPPFLAGS) $(LDFLAGS) -o aliados \
        #               aliados.o cpm.o realconsole.o Z80.o -lz80

        # Comment this if you compile with ImcZ80 and with libz80.
        aliados: aliados.o cpm.o Z80.o realconsole.o
                g++ $(CPPFLAGS) $(LDFLAGS) -o aliados \
                        aliados.o cpm.o realconsole.o Z80.o disasm.o

        Compilar e instalar libz80.
        
        Hecho esto, ejecutar: make

        3- Si se quiere usar exclusivamente ImcZ80:

        Ejecutar: make

La opción recomendada es la 3, ya que Aliados incluye su propio desensambador y la librería libz80 no está bien depurada.

Para instalar:

        No hay instalador por ahora, simplemnete copiar el ejecutable
        a un directorio del PATH. Si se ha usado la opción 1 habrá
        que renombrar aliadoslz a aliados.

Para ejecutar:

aliados [opciones] [programa [argumentos] ]

Si no se especifica programa arrancará la línea de comandos de Aliados, que se comporta de forma parecida a una línea de comandos de CP/M, dar "@exit" para salir. El fichero aliados.doc contiene la documentación de los comandos admitidos.

Si se especifica programa, éste es buscado como fichero normal en el sistema de ficheros nativo, no con las convenciones de uso de ficheros de la emulación. Además los argumentos no son convertidos a mayúsculas.

Opciones

-d --> Debug all. Activa todos los modos de depuración.

        -s      -->     Debug system. Muestra infomación de depuración
                        en muchas de las llamadas a BDOS y BIOS.

        -z      -->     Debug Z80. Muestra el estado de los registros
                        del Z80 antes de ejecutar cada instrucción y, si
                        las opciones de compilación lo permiten, el
                        desensamblado de la instrucción.

        --rawout-->     Salida a conosola en modo crudo: los códigos de
                        control no son convertidos y los caracteres no
                        son remapaeados. Si no se especifica esta opción
                        la salida se comporta de forma similar a la
                        emulación de terminal Zenith Z19/Z29 de las versiones
                        de CP/M Plus de Amstrad.

        --rawin -->     Entrada de consola en modo crudo. Las teclas
                        especiales no son remapeadas.

        --raw   -->     Es lo mismo que especificar --rawin y --rawout.

        --ws    -->     Teclado WordStar. Asigna a varias teclas especiales
                        el significado adecuado para WordStar. Sin efecto
                        en modo --rawin.

        --printer -->   Dirige la salida de impresora a un fichero. Si no
                        se especifica la salida irá dirigida al comando lp.

                                *       *       *

Comentarios y críticas a: ninsesabe@arrakis.es

ENGLISH VERSION.

        Aliados preliminary version.
        (C) 2004 Julian Albo.
        Usable and distributable under the terms of the GPL license.

        Aliados can use two emulations of the Z80 processor:

The libz80 library from Gabriel Gambetta, available in
http://libz80.sourceforge.net/
The included in Aliados, called ImcZ80, that is an adaptation of the Z80 emulation of Joyce, an Amstrad PCW emulator from John Elliot, http://www.seasip.demon.co.uk/Unix/Joyce/, that is itself an adaptation from the xz80 Spectrum emulator from Ian Collier.

The possible options to compile are:

1- If you want to use libz80.

First you must compile and install libz80.

Then execute: make aliadoslz

        2- If you want to use ImcZ80 but want to use the libz80
        disassembler in the mode of CPU debugging.

        Edit the cpm.cpp and uncomment the following line:

        //#define DISASM_WITH_libz80

        Edit the Makefile, and where it says:

        # Uncomment this if you compile with ImcZ80 and with libz80.
        # aliados: aliados.o cpm.o Z80.o realconsole.o
        #       g++ $(CPPFLAGS) $(LDFLAGS) -o aliados \
        #               aliados.o cpm.o realconsole.o Z80.o -lz80

        # Comment this if you compile with ImcZ80 and with libz80.
        aliados: aliados.o cpm.o Z80.o realconsole.o
                g++ $(CPPFLAGS) $(LDFLAGS) -o aliados \
                        aliados.o cpm.o realconsole.o Z80.o disasm.o

        Uncomment the first block and comment the second.

        Compile and install libz80.

        Then execute: make.

        3- If you want to use ImcZ80 exlusively:

        Execute: make.

The recomended option is 3, Aliados include his own disassembler and the libz80 library is not sufficiently debugged.

To install:

        There is no installer yet, you must copy the executable to a
        directory in the PATH. If you have used the option 1 you must
        raname aliadoslz to aliados.

To execute:

aliados [options] [program [arguments] ]

If no program is specified the Aliados command line is started, that works in a way similar to a CP/M command line, give @exit to exit. The file aliados.doc contains the documentation of the commands admitted.

If program is specified this is searched as a regular file in the native filesystem, not with the emulator file conventions. Arguments are not converted to uppercase.

Options

-d --> Debug all. All debugging modes are activated.

        -s      -->     Debug system. Show debugging information in most
                        BDOS and BIOS calls.

        -z      -->     Debug Z80. Shows register status before executing
                        any instruction and, if compiling options allow it,
                        the disassembly of the instruction.

        --rawout-->     Console output in raw mode. Control codes are not
                        converted and characters are not remapped. If this
                        option is no specified the console behavour is
                        similar to the Zenith Z19/Z29 terminal emulation of
                        an Amstrad PCW CP/M Plus version.

        --rawin -->     Console input in raw mode. Special keys are not
                        remapped.

        --raw   -->     Same as specifying both --rawin and --rawout.

        --ws    -->     WordStar keyboard. Assigns to several special keys
                        the meaning appropriate for WordStar. No effect
                        in --rawin mode.

        --printer -->   Directs printer output to a file. If not specified
                        the ouput is directed to the lp command.

                                *       *       *

Comments and criticisms to: ninsesabe@arrakis.es