diff --git a/apps/README.md b/apps/README.md index 7c53e3da8..2e00e9101 100644 --- a/apps/README.md +++ b/apps/README.md @@ -19,6 +19,7 @@ PCjs also includes a small collection of disk images in the [Disk Libraries](/di * [IBM PC](/disks/pcx86/) * [Challenger 1P](/disks/c1p/) +* [DEC](/disks/dec/) --- diff --git a/devices/pdp11/machine/1170/panel/README.md b/devices/pdp11/machine/1170/panel/README.md index fb4de628b..279007e60 100644 --- a/devices/pdp11/machine/1170/panel/README.md +++ b/devices/pdp11/machine/1170/panel/README.md @@ -10,85 +10,3 @@ machines: {% include machine.html id="test1170" %} This machine is also available with our built-in [Debugger](debugger/). - -Front Panel Basics ------------------- - -From the [PDP-11/70 Handbook (1979)](http://archive.pcjs.org/pubs/dec/pdp11/1170/PDP1170_Handbook_1979.pdf), Chapter 10, -p. 325: - -> ### CONSOLE OPERATION - -> The PDP-11/70 console allows direct control of the computer system. It contains a power switch for the CPU, -which is also usually used as the Master Switch for the system. The console is used for starting, stopping, resetting, -and debugging. Lights and switches provide the facilities for monitoring operation, system control, and maintenance. -Debugging and detailed tracing of operations can be accomplished by having the computer execute single instructions or -single cycles. Contents of all locations can be examined, and data can be entered manually from the console switches. - -The PDPjs Front Panel replicates most (but not all) the features of a real PDP-11/70 Console. The switches, which -PDPjs displays as green to make them stand out from the rest of the traditional pink-and-magenta controls, are summarized -below. - -### 0..21 - -Switches 0 to 21 control bits 0 to 21 of the SWITCH register. The UP position represents a 1, and the DOWN position -represents a 0. Once all the bits have been set, you can choose to load the contents of the SWITCH register into the -ADDRESS register (as displayed by the top row of LEDs), or directly into the memory location referenced by the ADDRESS -register (where it will become the DATA displayed by the second row of LEDs). - -The SWITCH, ADDRESS, and DATA (aka DISPLAY) registers are all internal to the Front Panel hardware, and should not be -confused with CPU registers. - -### TEST - -This is a momentary switch that is normally in the DOWN position. When held in the UP position, it turns on all LEDs. -This "lamp test" was more important in the days when the lights were produced by bulbs with filaments that could burn out, -and if you didn't realize that a particular light was "burned out", you could mistake it for a zero. - -While the TEST switch is more "cute" than useful on a virtual Front Panel, we have added one "innovation" to the switch: -pressing it also returns all the SWITCH register switches (0-21) to their DOWN position. - -### LOAD [ADRS] - -This is a momentary switch that is normally in the UP position. When pressed DOWN, it copies the SWITCH register to the -ADDRESS register. - -### EXAM - -This is a momentary switch that is normally in the UP position. When pressed DOWN, it reads the memory location referenced -by the ADDRESS register and displays it in the DATA register. If pressed repeatedly, each repetition also automatically -adds 2 to the ADDRESS register, making it easier to examine a series of words. Note that if the CPU registers are being -examined (starting at address 177700), the ADDRESS register will advance by 1 instead of 2. - -Another "innovation" unique to PDPjs: if the STEP switch is toggled from the UP to the DOWN position, repeated EXAM or DEP -operations will decrease the ADDRESS register instead of increasing it. - -### DEP - -This is a momentary switch that is normally in the DOWN position. When pressed UP, it writes the contents of the SWITCH -register to the memory location referenced by the ADDRESS register, and displays the result in the DATA register. Like the -EXAM switch, if DEP is pressed repeatedly, each repetition also automatically adds 2 to the ADDRESS register, making it easier -to deposit the same value to a series of words. - -### CONT - -This is a momentary switch that is normally in the UP position. When pressed DOWN, it will start the CPU if it's currently -halted. If the CPU is already running, CONT has no effect. Also, if the ENABLE/HALT switch is in the DOWN (HALT) position, -then the CPU will continue for only ONE instruction and then stop again. - -### ENABLE/HALT - -This switch is a toggle that is normally in the UP (ENABLE) position. If it pressed DOWN while the CPU is running, the CPU will -stop. Once the CPU is stopped, this switch has no effect, other than determining what CONT will do when pressed. - -### STEP - -On a real PDP-11, this would select between cycle-stepping vs. instruction-stepping. Since PDPjs doesn't support cycle-stepping, -this switch has no effect (except as described above when the EXAM or DEP switches are pressed repeatedly). - -### START - -The START switch is similar to CONT, but it also performs the equivalent a RESET instruction before starting the CPU, so -unless you're starting execution at the beginning of a program, using START instead of CONT to continue execution is probably -not a good idea. Also, if the ENABLE/HALT switch is in the DOWN (HALT) position, START will still reset the machine but not -execute anything. diff --git a/devices/pdp11/machine/1170/panel/debugger/README.md b/devices/pdp11/machine/1170/panel/debugger/README.md index 8b5471f08..4b89bcfc8 100644 --- a/devices/pdp11/machine/1170/panel/debugger/README.md +++ b/devices/pdp11/machine/1170/panel/debugger/README.md @@ -19,7 +19,7 @@ Toggle-Ins As DEC notes in the [PDP-11/70 Maintenance Service Guide](http://archive.pcjs.org/pubs/dec/pdp11/1170/PDP1170_Maintenance_Service_Guide_Apr88.pdf), Chapter 4: "There are several useful toggle-ins that are probably not very well known." Excerpts are provided below. If you're -not sure how to "toggle in" code using a Front Panel, check out [Front Panel Basics](/devices/pdp11/machine/1170/panel/#front-panel-basics). +not sure how to "toggle in" code using a Front Panel, check out [Front Panel Basics](/devices/pdp11/panel/1170/#front-panel-basics). However, since the above machine also includes the PDPjs Debugger, you'll find that it's much easier to use the Debugger commands described below to load and execute these "toggle-ins". diff --git a/devices/pdp11/panel/1170/README.md b/devices/pdp11/panel/1170/README.md index 62094298e..0a6187cf8 100644 --- a/devices/pdp11/panel/1170/README.md +++ b/devices/pdp11/panel/1170/README.md @@ -7,4 +7,90 @@ permalink: /devices/pdp11/panel/1170/ PDP-11/70 Control Panels ------------------------ +The following Control Panel configurations are available: + * [PDP-11/70 Front Panel](front.xml) (with [Debugger](debugger/front.xml)) + +Use this [PDP-11/70](/devices/pdp11/machine/1170/panel/debugger/) to see the [PDP-11/70 Front Panel](debugger/front.xml) in action. + +Front Panel Basics +------------------ + +From the [PDP-11/70 Handbook (1979)](http://archive.pcjs.org/pubs/dec/pdp11/1170/PDP1170_Handbook_1979.pdf), Chapter 10, +p. 325: + +> ### CONSOLE OPERATION + +> The PDP-11/70 console allows direct control of the computer system. It contains a power switch for the CPU, +which is also usually used as the Master Switch for the system. The console is used for starting, stopping, resetting, +and debugging. Lights and switches provide the facilities for monitoring operation, system control, and maintenance. +Debugging and detailed tracing of operations can be accomplished by having the computer execute single instructions or +single cycles. Contents of all locations can be examined, and data can be entered manually from the console switches. + +The PDPjs Front Panel replicates most (but not all) the features of a real PDP-11/70 Console. The switches, which +PDPjs displays as green to make them stand out from the rest of the traditional pink-and-magenta controls, are summarized +below. + +### 0..21 + +Switches 0 to 21 control bits 0 to 21 of the SWITCH register. The UP position represents a 1, and the DOWN position +represents a 0. Once all the bits have been set, you can choose to load the contents of the SWITCH register into the +ADDRESS register (as displayed by the top row of LEDs), or directly into the memory location referenced by the ADDRESS +register (where it will become the DATA displayed by the second row of LEDs). + +The SWITCH, ADDRESS, and DATA (aka DISPLAY) registers are all internal to the Front Panel hardware, and should not be +confused with CPU registers. + +### TEST + +This is a momentary switch that is normally in the DOWN position. When held in the UP position, it turns on all LEDs. +This "lamp test" was more important in the days when the lights were produced by bulbs with filaments that could burn out, +and if you didn't realize that a particular light was "burned out", you could mistake it for a zero. + +While the TEST switch is more "cute" than useful on a virtual Front Panel, we have added one "innovation" to the switch: +pressing it also returns all the SWITCH register switches (0-21) to their DOWN position. + +### LOAD [ADRS] + +This is a momentary switch that is normally in the UP position. When pressed DOWN, it copies the SWITCH register to the +ADDRESS register. + +### EXAM + +This is a momentary switch that is normally in the UP position. When pressed DOWN, it reads the memory location referenced +by the ADDRESS register and displays it in the DATA register. If pressed repeatedly, each repetition also automatically +adds 2 to the ADDRESS register, making it easier to examine a series of words. Note that if the CPU registers are being +examined (starting at address 177700), the ADDRESS register will advance by 1 instead of 2. + +Another "innovation" unique to PDPjs: if the STEP switch is toggled from the UP to the DOWN position, repeated EXAM or DEP +operations will decrease the ADDRESS register instead of increasing it. + +### DEP + +This is a momentary switch that is normally in the DOWN position. When pressed UP, it writes the contents of the SWITCH +register to the memory location referenced by the ADDRESS register, and displays the result in the DATA register. Like the +EXAM switch, if DEP is pressed repeatedly, each repetition also automatically adds 2 to the ADDRESS register, making it easier +to deposit the same value to a series of words. + +### CONT + +This is a momentary switch that is normally in the UP position. When pressed DOWN, it will start the CPU if it's currently +halted. If the CPU is already running, CONT has no effect. Also, if the ENABLE/HALT switch is in the DOWN (HALT) position, +then the CPU will continue for only ONE instruction and then stop again. + +### ENABLE/HALT + +This switch is a toggle that is normally in the UP (ENABLE) position. If it pressed DOWN while the CPU is running, the CPU will +stop. Once the CPU is stopped, this switch has no effect, other than determining what CONT will do when pressed. + +### STEP + +On a real PDP-11, this would select between cycle-stepping vs. instruction-stepping. Since PDPjs doesn't support cycle-stepping, +this switch has no effect (except as described above when the EXAM or DEP switches are pressed repeatedly). + +### START + +The START switch is similar to CONT, but it also performs the equivalent a RESET instruction before starting the CPU, so +unless you're starting execution at the beginning of a program, using START instead of CONT to continue execution is probably +not a good idea. Also, if the ENABLE/HALT switch is in the DOWN (HALT) position, START will still reset the machine but not +execute anything. diff --git a/devices/pdp11/rl11/README.md b/devices/pdp11/rl11/README.md index 742167fb5..e77f1e046 100644 --- a/devices/pdp11/rl11/README.md +++ b/devices/pdp11/rl11/README.md @@ -12,7 +12,7 @@ Machines containing the [RL11 Component](/modules/pdp11/lib/pc11.js) include: - [PDP-11/70 Boot Monitor](/devices/pdp11/machine/1170/monitor/) (with [Debugger](/devices/pdp11/machine/1170/monitor/debugger/)) - [PDP-11/70 with Front Panel](/devices/pdp11/machine/1170/panel/) (with [Debugger](/devices/pdp11/machine/1170/panel/debugger/)) -PCjs has archived a selection of [RL02K Disk Images](/disks/dec/rl02k/) for use by those machines, most of which are +PCjs has archived a selection of [RL02K Disk Images](/disks/dec/rl02k/) for use by those machines, which are listed in the following RL11 Device XML file: - [Default](/devices/pdp11/rl11/default.xml) @@ -25,18 +25,15 @@ Device XML files not only configure a device, but also list all the resource the used to control the device, such as choosing which disks should be "auto-mounted" by the RL11 device. For example: - - Paper Tape Controls + + Disk Drive Controls - - - - + + + - Attach - Load - - - Tape Progress + Load + + diff --git a/disks/README.md b/disks/README.md index 235deb4bd..0a37946c6 100644 --- a/disks/README.md +++ b/disks/README.md @@ -11,6 +11,7 @@ Browse these PCjs Disk Libraries: * [IBM PC](pcx86/) * [Challenger 1P](c1p/) +* [DEC](dec/) Additional selected software is available in the PCjs [Software Archives](/apps/). diff --git a/disks/dec/README.md b/disks/dec/README.md new file mode 100644 index 000000000..f5ff14061 --- /dev/null +++ b/disks/dec/README.md @@ -0,0 +1,10 @@ +--- +layout: page +title: DEC Disk Images +permalink: /disks/dec/ +--- + +DEC Disk Images +--------------- + +* [RL02K](rl02k/) diff --git a/disks/dec/rl02k/README.md b/disks/dec/rl02k/README.md new file mode 100644 index 000000000..1acffcb79 --- /dev/null +++ b/disks/dec/rl02k/README.md @@ -0,0 +1,10 @@ +--- +layout: page +title: DEC RL02K Disk Images +permalink: /disks/dec/rl02k/ +--- + +DEC RL02K Disk Images +--------------------- + +* [XXDP Diagnostics](http://archive.pcjs.org/disks/dec/rl02k/RL02K-XXDP.json)