# Test Vamos

## 1. Introduction

This directory contains the test suite of vamos. The suite combines a set
of native Amiga programs and python test scripts. First the native Amiga
programs will be compiled by various cross-compilers (see below) into native
Amiga binaries. Then vamos will be run with these binaries and the output
of the test programs will be compared to output generated by the programs
run on a real Amiga system.

In `src` directory you will find the Amiga test programs. In `suite` you
find the associated Python test programs.

## 2. Setup

You will need the `pytest` module to run the tests. Use pip to install
the module:

```
sudo pip install pytest
```

## 3. Cross-Compiler Setup

amitools currently supports the following cross-compilers to create the
AmigaOS binaries:

  - *gcc*: gcc 2.95 with AmigaOS support
  - *vc*: [vbcc](http://sun.hasenbraten.de/vbcc/) and [vasm]()
  - *agcc*: gcc 4.x with AROS m68k support
  - *sc*: SAS C v6.52 Amiga version running in vamos (commercial)

### 3.1 m68k-amigaos-toolchain

Krystian Baclawski's great script suite called
[m68k-amigaos-toolchain](https://github.com/cahirwpz/m68k-amigaos-toolchain)
allows to greatly simplify the installation of gcc 2.95 and vbcc cross on
unix based plattforms.

#### Prerequisites

  - Mac OS X
    - Install [MacPorts](http://macports.org)
    - Install the following Ports:

```
> sudo port install wget lha unzip
```

#### Build

  - create a user accessible installation directory

```
> sudo mkdir -p /opt/m68k-amigaos
> sudo chown $USER /opt/m68k-amigaos
```

  - run build and install

```
> git clone https://github.com/cahirwpz/m68k-amigaos-toolchain
> cd m68k-amiga-toolchain
> (cd archives && ./fetch.sh)
> ./bootstrap.sh --prefix=/opt/m68k-amigaos build
```

  - add the bin directory to your PATH (also add to your shell startup)

      > export PATH=/opt/m68k-amigaos/bin:$PATH

### 3.2 AROS

AROS now supports m68k directly and also provides a gcc 4.x based toolchain
to build m68k binaries

#### Prerequisites

  - Mac OS X
    - Install [MacPorts](http://macports.org)
    - Install the following Ports:

```
> sudo port install gawk gsed netpbm
```

#### Build

  - create a user accessible installation directory

```
> sudo mkdir -p /opt/m68k-aros
> sudo chown $USER /opt/m68k-aros
```

  - run build and install

```
> git clone http://repo.or.cz/AROS.git
> mkdir AROS-build
> cd AROS-build
> ../AROS/configure --target=m68k-amiga --with-aros-toolchain-install=/opt/m68k-aros
> make tools-crosstools
```

  - add the bin directory to your PATH (also add to your shell startup)

      > export PATH=/opt/m68k-aros:$PATH

### 3.3 SAS C 6.52

This is no cross-compiler but the native Amiga compiler. You will need a
pre-installed directory tree from the Amiga installation to run it here
with vamos.

The `Makefile` in this directory contains a line *SASC_INSTALL_DIR* that
describes the location where the `sc` directory of the Amiga installation
can be found in the host file system. The default is `volumes/sc`.

EOF