Welcome to the Apple II Simulator!

This program simulates an Apple II. Graphic (Hires and Lores) is
supported.  A Disk II Controller and a Language Card simulation is
included. There also exists a generic slotcard simulation skeleton.

Needed equipment:
	Unix machine with X Windows
	X Display
	Apple II firmware
	some Apple II software

Bugs and Enhancements: Please report to: koch@informatik.uni-kl.de

In detail:
	In addition to this package, you need some files, which
	can be downloaded from an Apple II via serial port and/or
	read from the roms with a eprommer: 

		controller.rom: C600.C6FF, the controller prom

		f800.rom:	F800.FFFF, the autostart monitor
		d000.rom:
		d800.rom:
		e000.rom:
		e800.rom:
		f000.rom:	D000.F7FF, the applesoft basic
	or
		f800.rom:	F800.FFFF, the old monitor
		e000.rom:
		e800.rom:
		f000.rom:	E000.F7FF, the integer basic

	Images of some Apple II disks, for example:
		dos_3.3_system_master.dsk
	or
		apple_pascal.dsk
	or
		prodos_basic_system.dsk
	or
		any_normal_sectored_disk_you_can_think_of.dsk

	Disk images are 1:1 copies of a 35 track, 16 sector disk in a
	single file. Tracks and sectors are arranged as:
		Byte		Track	Sector
		00000-000FF	0	0
		00100-001FF	0	1
		  :  -  :	:	:
		00F00-00FFF	0	F
		01000-010FF	1	0
		01100-011FF	1	1
		  :  -  :	:	:
		  :  -  :	:	:
		  :  -  :	:	:
		22000-220FF	22	0
		  :  -  :	:	:
		22F00-22FFF	22	F
	Such disk images have usualy a size of 143360 bytes.
	The arrangment of disks with 36 or even 40 tracks is analogous
	and left as an exercise to the reader.
	To create a empty file for formatting, type
		mkfile -n 140k empty.dsk

	The access to a disk image within the simulator goes through a
	symbolic file name in the current directory. The names are
	s6d1, s6d2, s5d1, s5d2, ... (You guess it, right???)
	Ok, ok, s6d2 stands for drive 2 of controller-card in slot 6.

Usage:
	apple2 [-disasm] [-showreg] [-flush] [-mono] [-solid] [-beep] [-keep]

	-disasm : disassemble instructions
	-regshow: show register after each instruction
	-flush  : flush on every draw instruction
	-mono   : use black&white graphic on color station
	-solid  : draw solid colors in hires
	-beep	: beep when speaker is toggled
	-keep	: keep the pixmaps of invisible screens

	A window will show up and the simulation starts. If character.rom
	is not found, the simulator will print an error. The same holds,
	if f800.rom is missing. If f800.rom is the autostart monitor and the
	basic roms are missing, no error and no warning will be reported,
	but the Simulation will hang (besides: a real Apple will hang too!!!).

	To use disk images, it is strongly recommended to create a link
	to the image file in the current directory:
		ln -s dos_3.3_system_master.disk s6d1
		ln -s empty.disk s6d2

	To change disks while the simulator is running, send a SIGUSR1
	to the simulator process (this case: %1 assumed):
		kill -USR1 %1

	A little shell skript will do all this for you. It is called 'floppy'
	and will make the proper link and do the kill -USR1 automatically.

	There is a file 'aliases', which contains some convenient aliases
	for 'csh' or 'tcsh'.

Example:
	source aliases		loads the aliases
	run			places the simulation window on the screen
	s6d1 master.dsk r	inserts a DOS 3.3 disk readonly in drive 1
	rst			press the reset button on the apple
	s6d2 empty.dsk rw	inserts a empty disk writable in drive 2

Peter Koch (e-mail: koch@informatik.uni-kl.de)
