Initial commit (a clone of the jsmachines project as of v1.15.3)

devices/pc/bios/5170/1984-01-10.map

@@ -0,0 +1,118 @@
+ F000:002C	@	POST1
+ F000:033B	@	POST1_TEST08	; TEST.08: DMA PAGE REGISTER TEST
+ F000:03DD	@	POST1_GETSW		; GET SWITCH SETTINGS
+ F000:0606	@	POST1_SETMFG	; SET MFG_TST
+ F000:060D	@	POST1_TEST11A	; TEST.11A: VERIFY GDT/IDT INSTRUCTIONS
+	  0C3F	+	
+ F000:0000	@	POST2			; TEST.17: 8259 PIC TEST
+ F000:0058	@	POST2_CP27		; CHECKPOINT 0x27
+ F000:0093	@	POST2_CP29		; CHECKPOINT 0x29
+ F000:00C6	@	POST2_TEST18	; TEST.18: 8253 TIMER TEST (CHECKPOINT 0x2A)
+ F000:00E7	@	POST2_ERR102	; DISPLAY 102 ERROR
+ F000:00F1	@	POST2_CP2B		; CHECKPOINT 0x2B
+ F000:0107	.					; TIMER COUNTING TOO FAST, DISPLAY 102 ERROR
+ F000:0111	@	POST2_CP2C		; CHECKPOINT 0x2C
+ F000:0139	@	POST2_CP2D		; CHECKPOINT 0x2D
+ F000:014E	@	POST2_TEST19	; TEST.19: ADDITIONAL MEMORY TESTS (CHECKPOINT 0x2F)
+ F000:0558	@	POST2_TEST20	; TEST.20: ADDITIONAL PROTECTED-MODE TESTS
+ F000:0595	@	POST2_TEST21	; TEST.21: KEYBOARD TEST (CHECKPOINT 0x35)
+ F000:05AD	@	POST2_CP36		; CHECKPOINT 0x36 (BEGIN KEYBOARD TEST)
+ F000:05F6	@	POST2_CP37		; CHECKPOINT 0x37 (CHECK KBD_RESET SCAN CODE)
+ F000:05FF	@	POST2_CP38		; CHECKPOINT 0x38 (RE-ENABLE KEYBOARD)
+ F000:0612	@	POST2_CP39		; CHECKPOINT 0x39 (STUCK KEYS)
+ F000:0655	@	POST2_CP3A		; CHECKPOINT 0x3A
+ F000:079E	@	POST2_RTCUP		; TEST CLOCK UPDATING
+ F000:080D	@	POST2_COMBOHF	; CHECK FOR COMBO HARD FILE/DISKETTE CARD
+	  1753	+
+ F000:0000	@	POST4
+ F000:007F	@	KBD_RESET
+ F000:00B2	@	TEMP_ISR
+ F000:00CC	@	HW_INT
+ F000:00E8	@	NOT_SEC
+ F000:00F6	@	SET_INTR_FLAG
+	  187F	+
+ F000:0000	@	POST5
+ F000:0055	@	EXC_13			; INT 13 (0x0D) GP FAULT HANDLER
+ F000:00B4	@	SYS_32			; INT 32 (0x20) PROT-MODE TEST HANDLER
+	  199C	+
+ F000:0000	@	POST6
+ F000:0189	@	XMIT_8042
+	  1C2D	+
+ F000:0000	@	POST7
+ F000:0043	@	POST7_CPF1		; CHECKPOINT 0xF1
+ F000:004B	@	POST7_INT20		; TEST NORMAL SOFTWARE INTERRUPT
+ F000:007F	@	POST7_INT0D		; TEST GP FAULT (SEG LIMIT VIOLATION)
+ F000:0093	@	POST7_LLDT		; TEST LLDT
+ F000:00DB	@	POST7_BOUND		; TEST BOUND
+ F000:0146	@	POST7_PUSHA		; TEST PUSHA/POPA
+ F000:019A	@	POST7_VERW		; TEST VERW/VERR
+ F000:01EC	@	POST7_ARPL		; TEST ARPL
+ F000:021A	@	POST7_LAR		; TEST LAR/LSL
+ F000:0264	@	POST7_LOWMEG	; TEST WRITE TO 0x1B0000 VS. B000:0000
+	  1F1A	+
+ F000:0000	@	SYSINIT1
+	  20A5	+
+ F000:0000	@	DISKETTE_IO_1
+ F000:0096	@	DISK_RETRY
+ F000:01CA	@	DISK_RESET
+ F000:020C	@	DISK_STATUS
+ F000:020D	@	DISK_READ
+ F000:0216	@	DISK_VERF
+ F000:021A	@	DISK_FORMAT
+ F000:0240	@	DISK_WRITE
+ F000:024C	@	RW_OPN
+ F000:0382	@	GET_PARM
+ F000:03E2	@	NEC_OUTPUT
+ F000:041C	@	SEEK
+ F000:04CA	@	DMA_SETUP
+ F000:051A	@	CHK_STAT_2
+ F000:053B	@	WAIT_INT
+ F000:0569	@	DISK_INT_1
+ F000:0580	@	RESULTS
+ F000:05CB	@	NUM_TRANS
+ F000:0604	@	READ_DSKCHNG
+ F000:0646	@	DISK_CHANGE
+ F000:0698	@	DISK_TYPE
+ F000:070D	@	FORMAT_SET
+ F000:0771	@	DSKETTE_SETUP
+ 	  28DA	+
+ F000:0000	@	DISK_SETUP
+ F000:0197	@	DISK_IO
+ F000:06CA	@	HD_INT
+ 	  0000	+
+ F000:2FC8	@	KEYBOARD_IO_1
+ F000:3054	@	KB_INT_1
+ F000:30A9	@	K16
+ F000:346F	@	PRINTER_IO_1
+ F000:34F5	@	RS232_IO_1
+ F000:3605	@	VIDEO_IO_1
+ F000:364E	@	SET_MODE
+ F000:372A	@	SET_CTYPE
+ F000:3751	@	SET_CPOS
+ F000:377B	@	READ_CURSOR
+ F000:3792	@	ACT_DISP_PAGE
+ F000:37B6	@	SET_COLOR
+ F000:37DC	@	VIDEO_STATE
+ F000:37FF	@	SCROLL_UP
+ F000:38A3	@	SCROLL_DOWN
+ F000:38F5	@	READ_AC_CURRENT
+ F000:393B	@	WRITE_AC_CURRENT
+ F000:396E	@	WRITE_C_CURRENT
+ F000:3A3B	@	READ_DOT
+ F000:3A4C	@	WRITE_DOT
+ F000:3D38	@	WRITE_TTY
+ F000:3DBC	@	READ_LPEN
+ F000:3E62	@	MEMORY_SIZE_DETERMINE_1
+ F000:3E6C	@	EQUIPMENT_1
+ F000:3E76	@	NMI_INT_1
+ F000:3F2F	@	SET_TOD			; CONVERT CMOS TIME TO TIMER TICKS
+ F000:3FE2	@	CASSETTE_IO_1
+ F000:4252	@	SHUT9
+ F000:4392	@	GATE_A20
+ F000:445C	@	TIME_OF_DAY_1
+ F000:462A	@	RTC_INT
+ F000:4684	@	TIMER_INT_1
+ F000:46CC	@	PRINT_SCREEN_1
+ F000:4752	@	FILL
+ F000:E05B	@	START
+ F000:FFF0	@	P_O_R			; POWER-ON RESET

devices/pc/bios/5170/README.md

@@ -0,0 +1,30 @@
+From [http://minuszerodegrees.net/bios/BIOS_5170_10JAN84_6MHZ/README.TXT](http://minuszerodegrees.net/bios/BIOS_5170_10JAN84_6MHZ.zip):
+
+	This is the first BIOS for the IBM 5170.
+	It is dated 10JAN84.
+	It is found in type 1 motherboards running at 6 Mhz.
+	
+	U27 has the IBM part number of 6181028, and is 32K in size
+	U47 has the IBM part number of 6181029, and is 32K in size
+	
+	8 bit checksum of 6181028 = 36
+	8 bit checksum of 6181029 = CA
+							   ----
+						added = 00
+	
+	There are two BIN files in this ZIP file:
+	
+	1. BIOS_5170_10JAN84_U27_6181028_27256_6MHZ.BIN  --> Use this to create a U27 using a 27256 EPROM (rated at 150nS or faster)
+	2. BIOS_5170_10JAN84_U47_6181029_27256_6MHZ.BIN  --> Use this to create a U47 using a 27256 EPROM (rated at 150nS or faster)
+
+The JSON-encoded ROM image that PCjs uses ([1984-01-10.json]()) was created using the *FileDump* command-line *merge* option:
+
+	filedump --file=BIOS_5170_10JAN84_U27_6181028_27256_6MHZ.BIN --merge=BIOS_5170_10JAN84_U47_6181029_27256_6MHZ.BIN --output=1984-01-10.json
+
+Similarly, to create a binary ROM image ([1984-01-10.rom]()), add *--format=rom* to the command-line.  These operations can
+only be performed using the *FileDump* command-line interface; the *FileDump* API does not support the *merge* option.
+
+A MAP file [1984-01-10.map]() exists as well, which is automatically appended to the JSON file when using a ROM input
+file (or JSON output file) with a matching filename.  For example:
+
+> [http://www.pcjs:org/api/v1/dump/?file=/devices/pc/bios/5170/1984-01-10.rom](/api/v1/dump/?file=/devices/pc/bios/5170/1984-01-10.rom)