Link updates

This commit is contained in:
Jeff Parsons 2016-05-23 14:14:42 -07:00
commit d29ef36ea1
30 changed files with 84 additions and 66 deletions

View file

@ -18,4 +18,4 @@ All PCjs machines are built from the following collections of devices:
* [8086-based Devices](pcx86/) (e.g., [IBM PC, including 80286 and 80386-based compatibles](pcx86/machine/))
These devices are user-installable components that you would typically find in a real personal computer,
such as keyboards, disk controllers with one or more disk drives, video cards, etc.
such as keyboards, disk drive controllers with one or more drives, video cards, etc.

View file

@ -9,12 +9,14 @@ Challenger 1P Device Configurations
All our [Challenger 1P Machines](machine/) are built from a collection of devices, including:
* [Control Panel](panel/)
* CPU (6502)
* Debugger
* Floppy Drive Controller
* Keyboard
* RAM
* [ROMs](rom/)
* Keyboards
* [Video Resources](video/)
* Floppy Drive Controllers
* [Control Panels](panel/)
* [ROM](rom/)
* Serial Port
* [Video](video/)
The project also includes an assortment of Challenger 1P [Applications](/apps/c1p/) and [Disk Images](/disks/c1p/).

View file

@ -7,6 +7,9 @@ permalink: /devices/c1p/panel/
Challenger 1P Control Panels
---
A Control Panel is a collection of machine controls (e.g., buttons, register values, etc) bound to the *CPU* and
*Debugger* components and usually defined in a separate XML file.
The following C1P Control Panels are available:
- [default.xml](default.xml)

View file

@ -12,28 +12,32 @@ IBM PC Device Configurations
All our [IBM PC Machines](machine/) are built from a collection of devices, including:
* CPU (e.g., 8088, 80286, 80386)
* RAM
* [ROMs](rom/)
* ChipSets (e.g., 8259, 8253, 8237)
* [Keyboards](keyboard/)
* [Video Adapters](video/)
* Floppy Drive Controllers
* Hard Drive Controllers
* [Control Panels](panel/)
* [ChipSet](chipset/)
* [Control Panel](panel/)
* [CPU](/docs/pcx86/cpu/)
* [Debugger](/docs/pcx86/debugger/)
* [Floppy Drive Controller](/docs/pcx86/fdc/)
* [Hard Drive Controller](/docs/pcx86/hdc/)
* [Keyboard](keyboard/)
* [Mouse](/docs/pcx86/mouse/)
* [RAM](/docs/pcx86/ram/)
* [ROM](rom/)
* [Parallel Port](/docs/pcx86/parallel/)
* [Serial Port](/docs/pcx86/serial/)
* [Video](video/)
Each of those devices can be configured in multiple ways, and some support external UI controls.
For example, the IBM PC Keyboard component supports different keyboard models (eg, 83-key, 84-key, 101-key),
and each of those models can also be configured to have dedicated buttons for selected key combinations,
or even entire keyboard layouts.
For example, the IBM PC *[Keyboard](/docs/pcx86/keyboard/)* component supports different keyboard models
(eg, 83-key, 84-key, 101-key), and each of those models can also be configured to have dedicated buttons for
selected key combinations, or even entire keyboard layouts.
Complete machine configurations are constructed from those devices. A Machine Configuration is a single XML file
that lists all the device components to be used. A Machine XML file can choose to configure every device itself,
or it can include pre-configured device XML files, such as those provided above or elsewhere.
Here's an example of [IBM 5150](/devices/pcx86/machine/5150/mda/64kb/)
[XML](/devices/pcx86/machine/5150/mda/64kb/machine.xml):
Here's an [IBM 5150](/devices/pcx86/machine/5150/mda/64kb/) [XML](/devices/pcx86/machine/5150/mda/64kb/machine.xml)
example:
```xml
<machine id="ibm5150" class="pcx86" border="1" pos="center" background="#FAEBD7">
@ -54,6 +58,7 @@ Here's an example of [IBM 5150](/devices/pcx86/machine/5150/mda/64kb/)
```
In this example, all the devices are fully configured within the machine XML file, except for the
[Video](/docs/pcx86/video/) [XML](/devices/pcx86/video/ibm/mda/ibm-mda.xml),
[Floppy Disk Controller (FDC)](/docs/pcx86/fdc/) [XML](/disks/pcx86/compiled/samples.xml), and
[Keyboard](/docs/pcx86/keyboard/) [XML](/devices/pcx86/keyboard/us83-buttons-arrows.xml).
*[Video](/docs/pcx86/video/)* ([XML](/devices/pcx86/video/ibm/mda/ibm-mda.xml)),
*[Floppy Drive Controller](/docs/pcx86/fdc/)* ([XML](/disks/pcx86/compiled/samples.xml)), and
*[Keyboard](/docs/pcx86/keyboard/)* ([XML](/devices/pcx86/keyboard/us83-buttons-arrows.xml)) components,
which refer to separate XML configuration files.

View file

@ -7,9 +7,15 @@ permalink: /devices/pcx86/chipset/
IBM PC ChipSet Configurations
---
The following ChipSet configurations are available:
The following predefined *[ChipSet](/docs/pcx86/chipset/)* XML configurations are currently available:
- [IBM Model 5150 w/CGA](5150-cga-max.xml)
- [AT&amp;T Personal Computer 6300](att6300-cga-max.xml)
- [Columbia Data Products MPC 1600](mpc1600-cga-max.xml)
- [Zenith Z-150](z150-cga-max.xml)
However, most machines use their own *[ChipSet](/docs/pcx86/chipset/)* model, DIP switch settings, etc; e.g.:
```xml
<chipset id="chipset" model="5160" sw1="01001001"/>
```

View file

@ -11,8 +11,8 @@ IBM PC Keyboard Devices
### Keyboard Configuration Files
The easiest way for a machine to include a *[Keyboard](/docs/pcx86/keyboard/)* component in its XML configuration file
is to reference one of the project's keyboard configuration files, using the *ref* attribute; eg:
The easiest way for a machine to add a *[Keyboard](/docs/pcx86/keyboard/)* component to its XML configuration file
is to use one of the project's predefined configuration files, with the *ref* attribute; e.g.:
```xml
<keyboard ref="/devices/pcx86/keyboard/us83-buttons-minimal.xml"/>

View file

@ -10,13 +10,13 @@ redirect_from:
IBM PC Machine Configurations
---
PCx86 supports these early [IBM PC Machines](#ibm-pc-machines):
PCjs supports these early [IBM PC Machines](#ibm-pc-machines):
* [IBM PC](/devices/pcx86/machine/5150/) (Model 5150)
* [IBM PC XT](/devices/pcx86/machine/5160/) (Model 5160)
* [IBM PC AT](/devices/pcx86/machine/5170/) (Model 5170)
PCx86 also supports IBM PC-compatibles, such as:
PCjs also supports IBM PC-compatibles, such as:
* [AT&amp;T](/devices/pcx86/machine/att/) ([AT&amp;T 6300](/devices/pcx86/machine/att/6300/))
* [Columbia Data Products](/devices/pcx86/machine/cdp/) ([MPC 1600](/devices/pcx86/machine/cdp/mpc1600/cga/640kb/))

View file

@ -9,13 +9,15 @@ redirect_from:
IBM PC Control Panels
---
[Control Panels](/docs/pcx86/panel/) are XML files that define layouts for Debugger-related controls.
A *[Control Panel](/docs/pcx86/panel/)* is a collection of machine controls (e.g., buttons, register values, etc)
bound to the *[CPU](/docs/pcx86/cpu/)* and *[Debugger](/docs/pcx86/debugger/)* components and usually defined in a
separate XML file.
The following IBM PC control panel configuration files are currently available:
The following predefined IBM PC *[Control Panel](/docs/pcx86/panel/)* XML configuration are currently available:
- [default.xml](default.xml) (a simple layout for 8086/8088-based machines)
- [wide.xml](wide.xml) (a wide version of default.xml)
- [wide386.xml](wide386.xml) (a wide version of default.xml for 80386-based machines)
The visual controls described by these layouts are provided by the [Computer](/docs/pcx86/computer/),
[CPU](/docs/pcx86/cpu/), [Keyboard](/docs/pcx86/keyboard/), and [Debugger](/docs/pcx86/debugger/) components.
The visual controls described by these layouts are provided by the *[Computer](/docs/pcx86/computer/)*,
*[CPU](/docs/pcx86/cpu/)*, *[Keyboard](/docs/pcx86/keyboard/)*, and *[Debugger](/docs/pcx86/debugger/)* components.

View file

@ -73,6 +73,6 @@ The project also contains BIOS ROMs, along with more detailed information, for t
### Other ROMs
The project contains other ROMs, including IBM [EGA](/devices/pcx86/video/ibm/ega/#ibm-ega-rom) and
[VGA](/devices/pcx86/video/ibm/vga/#ibm-vga-rom) ROMs, the Xebec Hard Disk Controller ROM used in
[VGA](/devices/pcx86/video/ibm/vga/#ibm-vga-rom) ROMs, the Xebec Hard Drive Controller ROM used in
the PC XT, etc, but those ROMs seemed more appropriately filed in their respective component folders;
eg, [IBM PC Video Devices](/devices/pcx86/video/).

View file

@ -17,7 +17,7 @@ Our COMPAQ [EGA ROM BIOS](000412-001B/compaq-ega.json) comes from
### Font Information
As noted in [Video.onROMLoad()](/modules/pcjs/lib/video.js), the Video component needs to know where the card's
As noted in [Video.onROMLoad()](/modules/pcx86/lib/video.js), the Video component needs to know where the card's
font data is located:
For EGA cards, in the absence of any parameters, we assume that we're receiving the original

View file

@ -11,7 +11,7 @@ IBM PC Video Configurations
Sample XML configurations are available for the following IBM PC Video Adapters:
* Monochrome Display Adapter (MDA)
* [Monochrome Display Adapter (MDA)](mda/)
* [Color Graphics Adapter (CGA)](cga/)
* [Enhanced Graphics Adapter (EGA)](ega/)
* [Video Graphics Array (VGA)](vga/)

View file

@ -48,7 +48,7 @@ The following IBM CGA configuration files are currently available:
There is only one known CGA Character ROM ([ibm-cga.json](ibm-cga.json)), and it is identical to the MDA Character ROM,
because the ROM contains both the 8x14 MDA and 8x8 CGA fonts.
As documented in [Video.doneLoad()](/modules/pcjs/lib/video.js):
As documented in [Video.doneLoad()](/modules/pcx86/lib/video.js):
[T]here are TWO CGA fonts in the ROM: a thin 5x7 "single dot" font located at offset 0x1000, and a thick 7x7
"double dot" font at offset 0x1800. The latter is the default font, unless overridden by a jumper setting on

View file

@ -64,7 +64,7 @@ The PCjs server's Dump API can be used as well:
### IBM EGA Font Information
As noted in [Video.onROMLoad()](/modules/pcjs/lib/video.js), the Video component needs to know where the card's
As noted in [Video.onROMLoad()](/modules/pcx86/lib/video.js), the Video component needs to know where the card's
font data is located:
For EGA cards, in the absence of any parameters, we assume that we're receiving the original

View file

@ -44,7 +44,7 @@ The following IBM MDA configuration files are currently available:
There is only one known MDA Character ROM ([ibm-mda.json](ibm-mda.json)), and it is identical to the CGA Character ROM,
because the ROM contains both the 8x14 MDA and 8x8 CGA fonts.
As documented in [Video.doneLoad()](/modules/pcjs/lib/video.js):
As documented in [Video.doneLoad()](/modules/pcx86/lib/video.js):
[T]here are TWO CGA fonts in the ROM: a thin 5x7 "single dot" font located at offset 0x1000, and a thick 7x7
"double dot" font at offset 0x1800. The latter is the default font, unless overridden by a jumper setting on