Browse Source

doc: Move the readme for PCE/ibmpc and PCE/macplus to separate files

Hampa Hug 9 years ago
parent
commit
b1f3867dda
4 changed files with 126 additions and 62 deletions
  1. 1
    1
      Makefile.inc.in
  2. 13
    61
      README
  3. 62
    0
      doc/pce-ibmpc.txt
  4. 50
    0
      doc/pce-macplus.txt

+ 1
- 1
Makefile.inc.in View File

@@ -99,7 +99,7 @@ DIST += AUTHORS COPYING ChangeLog INSTALL \
99 99
 	configure configure.in gendep install-sh
100 100
 
101 101
 DIST += doc/char-drivers.txt doc/keys.txt doc/messages.txt
102
-DIST += doc/monitor.txt
102
+DIST += doc/monitor.txt doc/pce-ibmpc.txt doc/pce-macplus.txt
103 103
 
104 104
 # ----------------------------------------------------------------------
105 105
 

+ 13
- 61
README View File

@@ -1,50 +1,24 @@
1
-PCE - IBM PC Emulator
1
+PCE - PC Emulator
2 2
 ==============================================================================
3 3
 
4
-PCE is an IBM PC emulator. It emulates most (but see below) of the hardware
5
-of an IBM PC 5150. The emulation is complete enough to boot DOS and run most
6
-DOS applications.
4
+PCE is a collection of microcomputer emulators.
7 5
 
8
-Emulated parts:
6
+For further information check out these files:
9 7
 
10
-Part		Status
8
+doc/pce-ibmpc.txt
9
+	PCE/ibmpc, an IBM PC 5150 emulator
11 10
 
12
-CPU		A complete 8086/80186 emulator. The specific CPU model can
13
-		be set to 8088, 8086, 80188 or 80186 at run time.
11
+doc/pce-macplus.txt
12
+	PCE/macplus, a Macintosh Plus emulator
14 13
 
15
-BIOS		The included BIOS is a partially disassembled, slightly
16
-		hacked IBM BIOS dated 1982-10-27.
14
+doc/keys.txt
15
+	Key combinations to control the emulator
17 16
 
18
-8237 DMAC	Supported, but not particularily useful yet
17
+doc/monitor.txt
18
+	The monitor interface
19 19
 
20
-8250 UART	Supported
21
-
22
-8253 PIT	Only counting modes 0, 2 and 3 are supported at this time
23
-
24
-8255 PPI	Supported
25
-
26
-8259 PIC	Supported
27
-
28
-MDA		Supported
29
-
30
-CGA		Supported
31
-
32
-HGC		Supported
33
-
34
-EGA		Supported. A custom BIOS is included, but a real EGA BIOS
35
-		should work as well.
36
-
37
-EMS		Supported, with a custom DOS driver.
38
-
39
-XMS		Supported, with a custom DOS driver.
40
-
41
-Disks		Only supported through INT 13h ATM.
42
-
43
-Mouse		A Microsoft serial mouse is emulated.
44
-
45
-Parallel Port	Partially supported. Output is written to a file.
46
-
47
-Serial Port	Supported.
20
+doc/messages.txt
21
+	Messages to control the emulator
48 22
 
49 23
 
50 24
 Install
@@ -68,27 +42,5 @@ Build the X11 based terminal.
68 42
 Build the SDL based terminal.
69 43
 
70 44
 
71
-
72
-Configuration
73
-==============================================================================
74
-
75
-PCE is configured by means of a config file. A documented example config
76
-file is installed in $(prefix)/etc/pce-ibmpc.cfg.
77
-
78
-(note to self: one of these days you really need to document
79
-this stuff properly...)
80
-
81
-
82
-Running PCE
83
-==============================================================================
84
-
85
-After starting the emulator, pce is in command mode (unless the -r
86
-option was used). Type 'h' to get a short summary of the available
87
-commands.
88
-
89
-The 'g' command starts the simulation. It can be interrupted by
90
-pressing Ctrl-`.
91
-
92
-
93 45
 have fun
94 46
 Hampa Hug <hampa@hampa.ch>

+ 62
- 0
doc/pce-ibmpc.txt View File

@@ -0,0 +1,62 @@
1
+PCE/ibmpc - IBM PC Emulator
2
+==============================================================================
3
+
4
+PCE/ibmpc is an IBM PC emulator. It emulates most (but see below) of the
5
+hardware of an IBM PC 5150. The emulation is complete enough to boot DOS and
6
+run most DOS applications.
7
+
8
+Emulated parts:
9
+
10
+Part		Status
11
+
12
+CPU		An 8086/80186 emulator. The specific CPU model can be set
13
+		to 8088, 8086, 80188 or 80186 at run time.
14
+
15
+BIOS		An unmodified BIOS from an IBM PC or PC/XT is needed.
16
+
17
+8237 DMAC	Supported, but not particularily useful yet
18
+
19
+8250 UART	Supported
20
+
21
+8253 PIT	Only counting modes 0, 2 and 3 are supported at this time
22
+
23
+8255 PPI	Supported
24
+
25
+8259 PIC	Supported
26
+
27
+Sound		Not yet supported
28
+
29
+Video		Supported video cards are: MDA, CGA, Plantronics ColorPlus,
30
+		Wyse 700, HGC, EGA, VGA
31
+
32
+EMS		Supported, with a custom DOS driver.
33
+
34
+XMS		Supported, with a custom DOS driver.
35
+
36
+Disks		Only supported through INT 13h at the moment.
37
+
38
+Sound		Not yet supported.
39
+
40
+Mouse		A Microsoft serial mouse is emulated.
41
+
42
+Parallel Port	Partially supported. Output is written to a file.
43
+
44
+Serial Port	Supported.
45
+
46
+
47
+Configuration
48
+==============================================================================
49
+
50
+PCE/ibmpc is configured by means of a config file. A documented example config
51
+file is installed in $(prefix)/etc/pce-ibmpc.cfg.
52
+
53
+
54
+Running PCE/ibmpc
55
+==============================================================================
56
+
57
+After starting the emulator, pce is in command mode (unless the -r
58
+option was used). Type 'h' to get a short summary of the available
59
+commands.
60
+
61
+The 'g' command starts the simulation. It can be interrupted by
62
+pressing Ctrl-`.

+ 50
- 0
doc/pce-macplus.txt View File

@@ -0,0 +1,50 @@
1
+PCE/macplus - Macintosh Plus Emulator
2
+==============================================================================
3
+
4
+PCE/macplus is a Macintosh Plus emulator. It emulates a Macintosh 128K,
5
+Macintosh 512k, Macintosh 512ke or a Macintosh Plus on Unix-like and Windows
6
+host operating systems.
7
+
8
+Emulated parts:
9
+
10
+Part		Status
11
+
12
+CPU		A complete MC68000 emulator.
13
+
14
+ROM		An unmodified ROM image from a Macintosh Plus is needed.
15
+
16
+RAM		Memory configurations of 128K, 512K, 1M, 2.5M and 4M are
17
+		supported.
18
+
19
+Video		Supported (512*342*2)
20
+
21
+Sound		Not yet supported
22
+
23
+Floppy disks	Supported by a custom driver. For this to work the ROM is
24
+		patched at runtime.
25
+
26
+SCSI		Up to 7 harddisks are supported
27
+
28
+Serial ports	Supported
29
+
30
+Mouse		Supported
31
+
32
+Keyboard	Supported
33
+
34
+
35
+Configuration
36
+==============================================================================
37
+
38
+PCE/macplus is configured by means of a config file. A documented example
39
+config file is installed in $(prefix)/etc/pce-macplus.cfg.
40
+
41
+
42
+Running PCE/macplus
43
+==============================================================================
44
+
45
+After starting the emulator, pce/macplus is in command mode (unless the -r
46
+option was used). Type 'h' to get a short summary of the available
47
+commands.
48
+
49
+The 'g' command starts the simulation. It can be interrupted by
50
+pressing Ctrl-`.

Loading…
Cancel
Save