First Commit of my working state

[simh.git] / ALTAIR / altair.txt

Altair 8800 Simulator\r
=====================\r
\r
1. Background.\r
\r
	The MITS (Micro Instrumentation and Telemetry Systems) Altair 8800\r
was announced on the January 1975 cover of Popular Electronics, which\r
boasted you could buy and build this powerful computer kit for only $397.\r
The kit consisted at that time of only the parts to build a case, power\r
supply, card cage (18 slots), CPU card, and memory card with 256 *bytes* of\r
memory.  Still, thousands were ordered within the first few months after the\r
announcement, starting the personal computer revolution as we know it today.\r
\r
	Many laugh at the small size of the that first kit, noting there\r
were no peripherals and the 256 byte memory size.  But the computer was an\r
open system, and by 1977 MITS and many other small startups had added many\r
expansion cards to make the Altair quite a respectable little computer. The\r
"Altair Bus" that made this possible was soon called the S-100 Bus, later\r
adopted as an industry standard, and eventually became the IEE-696 Bus.\r
\r
2. Hardware\r
\r
	We are simulating a fairly "loaded" Altair 8800 from about 1977,\r
with the following configuration:\r
\r
	device		simulates\r
	name(s)\r
\r
	CPU		Altair 8800 with Intel 8080 CPU board, 62KB\r
			of RAM, 2K of EPROM with start boot ROM.\r
	2SIO		MITS 88-2SIO Dual Serial Interface Board. Port 1\r
			is assumed to be connected to a serial "glass\r
			TTY" that is your terminal running the Simulator.\r
	PTR		Paper Tape Reader attached to port 2 of the\r
			2SIO board.\r
	PTP		Paper Tape Punch attached to port 2 of the\r
			2SIO board.  This also doubles as a printer\r
			port.\r
	DSK		MITS 88-DISK Floppy Disk controller with up\r
			to eight drives.\r
\r
2.1 CPU\r
\r
	We have 2 CPU options that were not present on the original\r
machine but are useful in the simulator.  We also allow you to select\r
memory sizes, but be aware that some sample software requires the full\r
64K (i.e. CP/M) and the MITS Disk Basic and Altair DOS require about\r
a minimum of 24K.\r
\r
	SET CPU 8080	Simulates the 8080 CPU (normal)\r
	SET CPU Z80	Simulates the later Z80 CPU [At the present time\r
			this is not fully implemented and is not to be\r
			trusted with real Z80 software]\r
	SET CPU ITRAP	Causes the simulator to halt if an invalid 8080\r
			Opcode is detected.\r
	SET CPU NOITRAP	Does not stop on an invalid Opcode.  This is \r
			how the real 8080 works.\r
	SET CPU 4K\r
	SET CPU 8K\r
	SET CPU 12K\r
	SET CPU 16K\r
	  ......\r
	SET CPU 64K	All these set various CPU memory configurations.\r
			The 2K EPROM at the high end of memory is always\r
			present and will always boot.\r
\r
The BOOT EPROM card starts at address 177400.  Jumping to this address\r
will always boot drive 0 of the floppy controller.  If no valid bootable\r
software is present there the machine crashes.  This is historically\r
accurate behavior.\r
\r
The real 8080, on receiving a HLT (Halt) instruction, freezes the processor\r
and only an interrupt or CPU hardware reset will restore it.  The simulator\r
is alot nicer, it will halt but send you back to the simulator command line.\r
\r
CPU Registers include the following:\r
\r
	name	size	comments\r
	\r
	PC	16	The Program Counter\r
	A	8	The accumulator\r
	BC	16	The BC register pair.  Register B is the high\r
			8 bits, C is the lower 8 bits\r
	DE	16	The DE register pair.  D is the top 8 bits, E is\r
			the bottom.\r
	HL	16	The HL register pair.  H is top, L is bottom.\r
	C	1	Carry flag.\r
	Z	1	Zero Flag.\r
	AC	1	Auxillary Carry flag.\r
	P	1	Parity flag.\r
	S	1	Sign flag.\r
	SR	16	The front panel switches.\r
	BREAK	16	Breakpoint address (377777 to disable).\r
	WRU	8	The interrupt character.  This starts as 005\r
			(ctrl-E) but some Altair software uses this\r
			keystroke so best to change this to something\r
			exotic such as 035 (which is Ctl-]).\r
\r
\r
2.2 The Serial I/O Card (2SIO)\r
\r
	This simple programmed I/O device provides 2 serial ports to the\r
outside world, which could be hardware jumpered to support RS-232 plugs or a\r
TTY current loop interface.  The standard I/O addresses assigned by MITS\r
was 20-21 (octal) for the first port, and 22-23 (octal) for the second.\r
We follow this standard in the Simulator.\r
\r
	The simulator directs I/O to/from the first port to the screen. The\r
second port reads from an attachable "tape reader" file on input, and writes\r
to an attachable "punch file" on output.  These files are considered a\r
simple stream of 8-bit bytes.  \r
\r
2.3 The 88-DISK controller.\r
\r
	The MITS 88-DISK is a simple programmed I/O interface to the MITS\r
8-inch floppy drive, which was basically a Pertec FD-400 with a power\r
supply and buffer board builtin.  The controller supports neither interrupts\r
nor DMA, so floppy access required the sustained attention of the CPU.\r
The standard I/O addresses were 10, 11, and 12 (octal), and we follow the\r
standard.  Details on controlling this hardware are in the altair_dsk.c\r
source file.\r
\r
\r
3. Sample Software\r
\r
	Running an Altair in 1977 you would be running either MITS Disk\r
Extended BASIC, or the brand new and sexy CP/M Operating System from Digital\r
Research.  Or possibly, you ordered Altair DOS back when it was promised in\r
1975, and are still waiting for it to be delivered in early 1977.\r
\r
	We have samples of all three for you to check out.  We can't go into\r
the details of how they work, but we'll give you a few hints.\r
\r
\r
3.1 CP/M Version 2.2\r
\r
	This version is my own port of the standard CP/M to the Altair. \r
There were some "official" versions but I don't have them.  None were\r
endorsed or sold by MITS to my knowledge, however.\r
	To boot CP/M:\r
\r
	sim> attach dsk0 altcpm.dsk\r
	sim> go 177400\r
	62K CP/M VERSION 2.2 (ALTAIR 8800)\r
	A>DIR\r
\r
	CP/M feels like DOS, sort of.  DIR will work.  I have included all\r
the standard CP/M utilities, plus a few common public-domain ones.  I also\r
include the sources to the customized BIOS and some other small programs.\r
TYPE will print an ASCII file.  DUMP will dump a binary one.  LS is a better\r
DIR than DIR.  ASM will assemble .ASM files to Hex, LOAD will "load" them to\r
binary format (.COM).  ED is a simple editor, #A command will bring the\r
source file to the buffer, T command will "type" lines, L will move lines,\r
E exits the editor.  20L20T will move down 20 lines, and type 20.  Very\r
DECish.  DDT is the debugger, SUBMIT is a batch-type command processor. \r
A sample batch file that will assemble and write out the bootable CP/M\r
image (on drive A) is "SYSGEN.SUB".  To run it, type "SUBMIT SYSGEN".\r
\r
\r
3.2 MITS Disk Extended BASIC Version 4.1\r
\r
	This was the commonly used software for serious users of the Altair\r
computer.  It is a powerful (but slow) BASIC with some extended commands to\r
allow it to access and manage the disk.  There was no operating system it\r
ran under.  To boot:\r
\r
	sim> attach dsk0 mbasic.dsk\r
	sim> go 177400\r
\r
	MEMORY SIZE? [return]\r
	LINEPRINTER? C [return]\r
	HIGHEST DISK NUMBER? 0 [return]  (3 here = 4 drive system)\r
	NUMBER OF FILES? 3 [return]\r
	NUMBER OF RANDOM FILES? 2 [return]\r
\r
	44297 BYTES FREE\r
	ALTAIR BASIC REV. 4.1\r
	[DISK EXTENDED VERSION]\r
	COPYRIGHT 1977 BY MITS INC.\r
	OK\r
	mount 0\r
	OK\r
	files\r
\r
\r
3.3 Altair DOS Version 1.0\r
\r
	This was long promised but not delivered until it was almost\r
irrelevant.  A short attempted tour will reveal it to be a dog, far inferior\r
to CP/M.  To boot:\r
\r
	sim> attach dsk0 altdos.dsk\r
	sim> go 177400\r
\r
	MEMORY SIZE? 64 [return]\r
	INTERRUPTS? N [return]\r
	HIGHEST DISK NUMBER? 0 [return]  (3 here = 4 drive system)\r
	HOW MANY DISK FILES? 3 [return]\r
	HOW MANY RANDOM FILES? 2 [return]\r
\r
	056769 BYTES AVAILABLE\r
	DOS MONITOR VER 1.0	\r
	COPYRIGHT 1977 BY MITS INC\r
	.mnt 0\r
\r
	.dir 0\r
\r
\r
\r
\r
\r