Retro/pcjs
Watch
1
0
Fork
You've already forked pcjs
 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Cleaned up the C1P docs

Browse source
This commit is contained in:
Jeff Parsons 2016-05-01 16:17:19 -07:00
commit 98597a21da
3 changed files with 15 additions and 14 deletions
Download patch file Download diff file Expand all files Collapse all files

2
README.md
View file

@ -8,7 +8,7 @@ It was added to the [JavaScript Machines](/docs/about/) project in Fall 2012, an
The project includes the following web-based emulators: The project includes the following web-based emulators:
* [PCjs](/docs/pcjs/): an IBM PC and PC-compatible emulator * [PCjs](/docs/pcjs/): an IBM PC and PC-compatible emulator
* [PC8080](/modules/pc8080/): an 8080-based machine emulation module * [PC8080](/modules/pc8080/): an 8080-based machine emulator
* [C1Pjs](/docs/c1pjs/): a simulation of the 6502-based OSI Challenger 1P * [C1Pjs](/docs/c1pjs/): a simulation of the 6502-based OSI Challenger 1P
PCjs first simulated the 4.77Mhz 8088-based IBM PC, and has steadily evolved to support more classic x86 machines, PCjs first simulated the 4.77Mhz 8088-based IBM PC, and has steadily evolved to support more classic x86 machines,

25
docs/c1pjs/README.md
View file

@ -49,13 +49,10 @@ idiosyncrasies and television-related limitations.
#### Starting the Simulator #### Starting the Simulator
Press the **RUN** or **BREAK** button to start the C1Pjs Simulator. * Press the **RUN** or **BREAK** button to start the C1Pjs Simulator.
* Press **C** to select a COLD START.
Press **C** to select a COLD START. * At the MEMORY SIZE prompt, press **Return** to use all available memory.
* At the TERMINAL WIDTH prompt, press **Return** to select the default screen width.
At the MEMORY SIZE prompt, press **Return** to use all available memory.
At the TERMINAL WIDTH prompt, press **Return** to select the default screen width.
Wait for the BASIC "OK" prompt before using the **Load File** button; Wait for the BASIC "OK" prompt before using the **Load File** button;
this will allow the Simulator to automatically "LOAD" and "RUN" the selected program. this will allow the Simulator to automatically "LOAD" and "RUN" the selected program.
@ -95,9 +92,7 @@ presumably this feature was added to prevent the display of passwords or other s
If the Simulator is not responding to any keys, try clicking on the black display area to restore focus; If the Simulator is not responding to any keys, try clicking on the black display area to restore focus;
if all else fails, press **BREAK** and then **W** for a WARM START. if all else fails, press **BREAK** and then **W** for a WARM START.
#### Operating Tips #### Using The Control Panel
##### Using The Control Panel
Press the **Run** button to start the Simulator; it will change to **Halt** while running. Press the **Run** button to start the Simulator; it will change to **Halt** while running.
@ -116,7 +111,7 @@ Press the spacebar at the end of the "LOAD" operation to restore keyboard contro
Press the **Load Disk** button to mount the selected disk image into the simulated floppy disk drive; Press the **Load Disk** button to mount the selected disk image into the simulated floppy disk drive;
press **BREAK** and then **D** to boot from the image and load the OS-65D operating system. press **BREAK** and then **D** to boot from the image and load the OS-65D operating system.
##### Using The Debugger #### Using The Debugger
A built-in Debugger is provided as part of the Control Panel. A built-in Debugger is provided as part of the Control Panel.
@ -126,7 +121,7 @@ The instruction frequency ("f") and history ("p") commands collect data only whi
running (not stepping) and one or more breakpoints have been set; set a dummy execution breakpoint running (not stepping) and one or more breakpoints have been set; set a dummy execution breakpoint
(eg, "bp 0") to enable collection. (eg, "bp 0") to enable collection.
##### Controlling The Speed #### Controlling The Speed
The default speed of the simulated CPU is roughly 1Mhz, or one million simulated CPU cycles per second. The default speed of the simulated CPU is roughly 1Mhz, or one million simulated CPU cycles per second.
@ -136,12 +131,16 @@ the default speed of 1Mhz.
Slow computers, as well as browsers with slow JavaScript interpreters, may not be able to achieve 1Mhz operation; Slow computers, as well as browsers with slow JavaScript interpreters, may not be able to achieve 1Mhz operation;
in those situations, the speed controls will have no effect. in those situations, the speed controls will have no effect.
---
### Embedding ### Embedding
Want to embed the C1Pjs Simulator on your own web page? Everything you need to know is explained [here](embed/). Want to embed the C1Pjs Simulator on your own web page? Everything you need to know is explained [here](embed/).
You can even launch multiple simulations on a single page; check out the C1P "Server Array" You can even launch multiple simulations on a single page; check out the C1P "Server Array"
[demo](/devices/c1p/machine/8kb/array/). [demo](/devices/c1p/machine/8kb/array/).
---
### Implementation ### Implementation
This computer simulation was written in JavaScript, in part to test the performance limits of web-based applications. This computer simulation was written in JavaScript, in part to test the performance limits of web-based applications.
@ -155,6 +154,8 @@ This application was tested with current versions of Safari, Firefox, Chrome and
current versions will probably work as well, with the exception of Internet Explorer, which did not add support for current versions will probably work as well, with the exception of Internet Explorer, which did not add support for
the <canvas> tag until IE9. the <canvas> tag until IE9.
---
### Challenger 1P Reference Manuals ### Challenger 1P Reference Manuals
[<img src="http://archive.pcjs.org/pubs/c1p/techref/thumbs/OSI_BASIC-IN-ROM_Reference_Manual-thumb.jpg" width="200" height="260" alt="OSI BASIC-IN-ROM Manual"/>](http://archive.pcjs.org/pubs/c1p/techref/pdfs/OSI_BASIC-IN-ROM_Reference_Manual.pdf) [<img src="http://archive.pcjs.org/pubs/c1p/techref/thumbs/OSI_BASIC-IN-ROM_Reference_Manual-thumb.jpg" width="200" height="260" alt="OSI BASIC-IN-ROM Manual"/>](http://archive.pcjs.org/pubs/c1p/techref/pdfs/OSI_BASIC-IN-ROM_Reference_Manual.pdf)

2
index.md
View file

@ -18,7 +18,7 @@ It was added to the [JavaScript Machines](/docs/about/) project in Fall 2012, an
The project includes the following web-based emulators: The project includes the following web-based emulators:
* [PCjs](/docs/pcjs/): an IBM PC and PC-compatible emulator * [PCjs](/docs/pcjs/): an IBM PC and PC-compatible emulator
* [PC8080](/modules/pc8080/): an 8080-based machine emulation module * [PC8080](/modules/pc8080/): an 8080-based machine emulator
* [C1Pjs](/docs/c1pjs/): a simulation of the 6502-based OSI Challenger 1P * [C1Pjs](/docs/c1pjs/): a simulation of the 6502-based OSI Challenger 1P
PCjs first simulated the 4.77Mhz 8088-based IBM PC, and has steadily evolved to support more classic x86 machines, PCjs first simulated the 4.77Mhz 8088-based IBM PC, and has steadily evolved to support more classic x86 machines,