PETARI 0.5 Documentation

PETARI is a Commodore PET emulator for the Atari XL/XE.
It emulates a 40-column PET.  Joysticks and sound are supported.  A mini-DOS supports limited disk access.

INSTALLATION:

For reasons of copyright, the official distribution of PETARI does not include the needed ROMs.
The ROMs need to be appended to the end of the .XEX file.
For example:
copy /b petari1_stripped+chargen+basic1+edit1g+kernal1  petari1.xex
copy /b petari2_stripped+chargen+basic2+edit2g+kernal2  petari2.xex
copy /b petari4_stripped+chargen+basic4+edit4g40+kernal4  petari4.xex

USAGE:

Press START after loading a program to apply patches if necessary.
For example, if the keyboard doesn't work.
If the screen flashes after pressing START then a patch was applied.
It is only necessary to press START once.  If there was no flash, that program does not need a patch.

The disk access is limited to loading, saving, and reading the directory.  Deleting and overwriting files are not supported.  Having more than one file open at once is not supported.
4 drives are supported (D1:-D4:) as drives 8, 9, 10 and 11.  Wildcards are supported (* and ?).
Only standard 90K Atari DOS2.0S disks are supported.  Double and Extended density disks are not supported.
Filenames are 11 characters long (8+3).  The 8.3 format is not used, the extension becomes part of the filename.
Saving files is not fully tested.  Do not use PETARI to save to a disk containing important data.
Examples:
Load the directory of D1: and display it:
LOAD "$",8
LIST
Load the first file from D2: and run it
LOAD "*",9
RUN
Save a file named "FILE" to D4:
SAVE "FILE",11

JOYSTICK:

The joystick can be reprogrammed by using BASIC poke statements.
fire button:  poke 59600,X
down-right    poke 59605,X
up-right      poke 59606,X
right         poke 59607,X
down-left     poke 59609,X
down-right    poke 59610,X
left          poke 59611,X
down          poke 59613,X
up            poke 59614,X

Replace X with the Atari scan-code for the key to be used.
Default settings are the number pad and A for fire.

CREDITS
The IEEE-488 patch to BASIC 1 is from VICE.
Atari800 was used to help develop PETARI.