diff --git a/.gitignore b/.gitignore index ae018efb6..dc0e6f10d 100644 --- a/.gitignore +++ b/.gitignore @@ -9,16 +9,15 @@ .idea .project .settings +.sass-cache +_site +Gemfile.lock node_modules -npm-debug.log -archive/ -/books -/notes -/states /videos /web +archive/ +c64/ +ecp/ private/ src/ tmp/ -_site -.sass-cache diff --git a/README.md b/README.md index d139df339..575def75e 100644 --- a/README.md +++ b/README.md @@ -349,12 +349,15 @@ where PCjs could run amok and destroy the planet. Other parameters that can be passed via the URL: - *autostart*: set it to "true" to allow all machines to start normally, "false" to prevent all machines from starting, -or "no" to prevent all machines from starting *unless* they have no "Run" button. - -For example: +or "no" to prevent all machines from starting *unless* they have no "Run" button; e.g.: http://localhost:8088/?gort=debug&autostart=false +- *aspect*: set it to a numeric value >= 0.3 and <= 3.33 to modify the default aspect ratio of a machine's screen on the +specified page; e.g.: + + http://localhost:8088/?aspect=2.0 + Updating PCjs --- diff --git a/_config.yml b/_config.yml index 7177eeec2..b7b29356f 100644 --- a/_config.yml +++ b/_config.yml @@ -31,7 +31,7 @@ gems: pcjs: domain: pcjs.org # whereas site.url is used for linking purposes, site.pcjs.domain is used for display purposes - version: 1.21.5 # IMPORTANT: keep pcjs.version in sync with package.json:version + version: 1.21.6 # IMPORTANT: keep pcjs.version in sync with package.json:version compiled: true # by default, the compiled pcjs.version scripts will be used (eg, pc.js or pc-dbg.js) pc_scripts: # if pcjs.compiled is false, the following scripts will be included instead, in the order listed - /modules/shared/lib/defines.js diff --git a/apps/pc/1981/visicalc/manifest.xml b/apps/pc/1981/visicalc/manifest.xml index dfd654d06..afb061172 100644 --- a/apps/pc/1981/visicalc/manifest.xml +++ b/apps/pc/1981/visicalc/manifest.xml @@ -1,5 +1,5 @@ - + VisiCalc diff --git a/apps/pc/1982/esuite/manifest.xml b/apps/pc/1982/esuite/manifest.xml index db2e244be..51ca52324 100644 --- a/apps/pc/1982/esuite/manifest.xml +++ b/apps/pc/1982/esuite/manifest.xml @@ -1,5 +1,5 @@ - + Executive Suite diff --git a/apps/pc/1985/rogue/manifest.xml b/apps/pc/1985/rogue/manifest.xml index b0a6b9835..3930f3139 100644 --- a/apps/pc/1985/rogue/manifest.xml +++ b/apps/pc/1985/rogue/manifest.xml @@ -1,5 +1,5 @@ - + Rogue diff --git a/apps/pc/1987/thinktank/manifest.xml b/apps/pc/1987/thinktank/manifest.xml index ac8102182..628c25468 100644 --- a/apps/pc/1987/thinktank/manifest.xml +++ b/apps/pc/1987/thinktank/manifest.xml @@ -1,5 +1,5 @@ - + ThinkTank 2.41NP diff --git a/apps/pc/1988/moria/manifest.xml b/apps/pc/1988/moria/manifest.xml index 71888dc8a..0296e5199 100644 --- a/apps/pc/1988/moria/manifest.xml +++ b/apps/pc/1988/moria/manifest.xml @@ -1,5 +1,5 @@ - + The Dungeons of Moria 4.872 diff --git a/apps/pc/1992/moria/manifest.xml b/apps/pc/1992/moria/manifest.xml index ca8986d0e..c7d53db6e 100644 --- a/apps/pc/1992/moria/manifest.xml +++ b/apps/pc/1992/moria/manifest.xml @@ -1,5 +1,5 @@ - + The Dungeons of Moria 5.5 diff --git a/bin/COPYING b/bin/COPYING new file mode 100644 index 000000000..d64569567 --- /dev/null +++ b/bin/COPYING @@ -0,0 +1,202 @@ + + Apache License + Version 2.0, January 2004 + http://www.apache.org/licenses/ + + TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION + + 1. Definitions. + + "License" shall mean the terms and conditions for use, reproduction, + and distribution as defined by Sections 1 through 9 of this document. + + "Licensor" shall mean the copyright owner or entity authorized by + the copyright owner that is granting the License. + + "Legal Entity" shall mean the union of the acting entity and all + other entities that control, are controlled by, or are under common + control with that entity. For the purposes of this definition, + "control" means (i) the power, direct or indirect, to cause the + direction or management of such entity, whether by contract or + otherwise, or (ii) ownership of fifty percent (50%) or more of the + outstanding shares, or (iii) beneficial ownership of such entity. + + "You" (or "Your") shall mean an individual or Legal Entity + exercising permissions granted by this License. + + "Source" form shall mean the preferred form for making modifications, + including but not limited to software source code, documentation + source, and configuration files. + + "Object" form shall mean any form resulting from mechanical + transformation or translation of a Source form, including but + not limited to compiled object code, generated documentation, + and conversions to other media types. + + "Work" shall mean the work of authorship, whether in Source or + Object form, made available under the License, as indicated by a + copyright notice that is included in or attached to the work + (an example is provided in the Appendix below). + + "Derivative Works" shall mean any work, whether in Source or Object + form, that is based on (or derived from) the Work and for which the + editorial revisions, annotations, elaborations, or other modifications + represent, as a whole, an original work of authorship. For the purposes + of this License, Derivative Works shall not include works that remain + separable from, or merely link (or bind by name) to the interfaces of, + the Work and Derivative Works thereof. + + "Contribution" shall mean any work of authorship, including + the original version of the Work and any modifications or additions + to that Work or Derivative Works thereof, that is intentionally + submitted to Licensor for inclusion in the Work by the copyright owner + or by an individual or Legal Entity authorized to submit on behalf of + the copyright owner. For the purposes of this definition, "submitted" + means any form of electronic, verbal, or written communication sent + to the Licensor or its representatives, including but not limited to + communication on electronic mailing lists, source code control systems, + and issue tracking systems that are managed by, or on behalf of, the + Licensor for the purpose of discussing and improving the Work, but + excluding communication that is conspicuously marked or otherwise + designated in writing by the copyright owner as "Not a Contribution." + + "Contributor" shall mean Licensor and any individual or Legal Entity + on behalf of whom a Contribution has been received by Licensor and + subsequently incorporated within the Work. + + 2. Grant of Copyright License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + copyright license to reproduce, prepare Derivative Works of, + publicly display, publicly perform, sublicense, and distribute the + Work and such Derivative Works in Source or Object form. + + 3. Grant of Patent License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + (except as stated in this section) patent license to make, have made, + use, offer to sell, sell, import, and otherwise transfer the Work, + where such license applies only to those patent claims licensable + by such Contributor that are necessarily infringed by their + Contribution(s) alone or by combination of their Contribution(s) + with the Work to which such Contribution(s) was submitted. If You + institute patent litigation against any entity (including a + cross-claim or counterclaim in a lawsuit) alleging that the Work + or a Contribution incorporated within the Work constitutes direct + or contributory patent infringement, then any patent licenses + granted to You under this License for that Work shall terminate + as of the date such litigation is filed. + + 4. Redistribution. You may reproduce and distribute copies of the + Work or Derivative Works thereof in any medium, with or without + modifications, and in Source or Object form, provided that You + meet the following conditions: + + (a) You must give any other recipients of the Work or + Derivative Works a copy of this License; and + + (b) You must cause any modified files to carry prominent notices + stating that You changed the files; and + + (c) You must retain, in the Source form of any Derivative Works + that You distribute, all copyright, patent, trademark, and + attribution notices from the Source form of the Work, + excluding those notices that do not pertain to any part of + the Derivative Works; and + + (d) If the Work includes a "NOTICE" text file as part of its + distribution, then any Derivative Works that You distribute must + include a readable copy of the attribution notices contained + within such NOTICE file, excluding those notices that do not + pertain to any part of the Derivative Works, in at least one + of the following places: within a NOTICE text file distributed + as part of the Derivative Works; within the Source form or + documentation, if provided along with the Derivative Works; or, + within a display generated by the Derivative Works, if and + wherever such third-party notices normally appear. The contents + of the NOTICE file are for informational purposes only and + do not modify the License. You may add Your own attribution + notices within Derivative Works that You distribute, alongside + or as an addendum to the NOTICE text from the Work, provided + that such additional attribution notices cannot be construed + as modifying the License. + + You may add Your own copyright statement to Your modifications and + may provide additional or different license terms and conditions + for use, reproduction, or distribution of Your modifications, or + for any such Derivative Works as a whole, provided Your use, + reproduction, and distribution of the Work otherwise complies with + the conditions stated in this License. + + 5. Submission of Contributions. Unless You explicitly state otherwise, + any Contribution intentionally submitted for inclusion in the Work + by You to the Licensor shall be under the terms and conditions of + this License, without any additional terms or conditions. + Notwithstanding the above, nothing herein shall supersede or modify + the terms of any separate license agreement you may have executed + with Licensor regarding such Contributions. + + 6. Trademarks. This License does not grant permission to use the trade + names, trademarks, service marks, or product names of the Licensor, + except as required for reasonable and customary use in describing the + origin of the Work and reproducing the content of the NOTICE file. + + 7. Disclaimer of Warranty. Unless required by applicable law or + agreed to in writing, Licensor provides the Work (and each + Contributor provides its Contributions) on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or + implied, including, without limitation, any warranties or conditions + of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A + PARTICULAR PURPOSE. You are solely responsible for determining the + appropriateness of using or redistributing the Work and assume any + risks associated with Your exercise of permissions under this License. + + 8. Limitation of Liability. In no event and under no legal theory, + whether in tort (including negligence), contract, or otherwise, + unless required by applicable law (such as deliberate and grossly + negligent acts) or agreed to in writing, shall any Contributor be + liable to You for damages, including any direct, indirect, special, + incidental, or consequential damages of any character arising as a + result of this License or out of the use or inability to use the + Work (including but not limited to damages for loss of goodwill, + work stoppage, computer failure or malfunction, or any and all + other commercial damages or losses), even if such Contributor + has been advised of the possibility of such damages. + + 9. Accepting Warranty or Additional Liability. While redistributing + the Work or Derivative Works thereof, You may choose to offer, + and charge a fee for, acceptance of support, warranty, indemnity, + or other liability obligations and/or rights consistent with this + License. However, in accepting such obligations, You may act only + on Your own behalf and on Your sole responsibility, not on behalf + of any other Contributor, and only if You agree to indemnify, + defend, and hold each Contributor harmless for any liability + incurred by, or claims asserted against, such Contributor by reason + of your accepting any such warranty or additional liability. + + END OF TERMS AND CONDITIONS + + APPENDIX: How to apply the Apache License to your work. + + To apply the Apache License to your work, attach the following + boilerplate notice, with the fields enclosed by brackets "[]" + replaced with your own identifying information. (Don't include + the brackets!) The text should be enclosed in the appropriate + comment syntax for the file format. We also recommend that a + file or class name and description of purpose be included on the + same "printed page" as the copyright notice for easier + identification within third-party archives. + + Copyright [yyyy] [name of copyright owner] + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. diff --git a/bin/compiler.md b/bin/compiler.md new file mode 100644 index 000000000..30fd7c004 --- /dev/null +++ b/bin/compiler.md @@ -0,0 +1,507 @@ +# [Google Closure Compiler](https://developers.google.com/closure/compiler/) + +[![Build Status](https://travis-ci.org/google/closure-compiler.svg?branch=master)](https://travis-ci.org/google/closure-compiler) + +The [Closure Compiler](https://developers.google.com/closure/compiler/) is a tool for making JavaScript download and run faster. It is a true compiler for JavaScript. Instead of compiling from a source language to machine code, it compiles from JavaScript to better JavaScript. It parses your JavaScript, analyzes it, removes dead code and rewrites and minimizes what's left. It also checks syntax, variable references, and types, and warns about common JavaScript pitfalls. + +## Getting Started + * [Download the latest version](http://dl.google.com/closure-compiler/compiler-latest.zip) ([Release details here](https://github.com/google/closure-compiler/wiki/Releases)) + * [Download a specific version](https://github.com/google/closure-compiler/wiki/Binary-Downloads). Also available via: + - [Maven](https://github.com/google/closure-compiler/wiki/Maven) + - [NPM](https://www.npmjs.com/package/google-closure-compiler) + * See the [Google Developers Site](https://developers.google.com/closure/compiler/docs/gettingstarted_app) for documentation including instructions for running the compiler from the command line. + +## Options for Getting Help +1. Post in the [Closure Compiler Discuss Group](https://groups.google.com/forum/#!forum/closure-compiler-discuss) +2. Ask a question on [Stack Overflow](http://stackoverflow.com/questions/tagged/google-closure-compiler) +3. Consult the [FAQ](https://github.com/google/closure-compiler/wiki/FAQ) + +## Building it Yourself + +Note: The Closure Compiler requires [Java 7 or higher](http://www.java.com/). + +### Using [Ant](http://ant.apache.org/) + +1. Download the [Ant build tool](http://ant.apache.org/bindownload.cgi). + +2. At the root of the source tree, there is an Ant file named ```build.xml```. + To use it, navigate to the same directory and type the command + + ``` + ant jar + ``` + + This will produce a jar file called ```build/compiler.jar```. + +### Using [Eclipse](http://www.eclipse.org/) + +1. Download and open the [Eclipse IDE](http://www.eclipse.org/). +2. Navigate to ```File > New > Project ...``` and create a Java Project. Give + the project a name. +3. Select ```Create project from existing source``` and choose the root of the + checked-out source tree as the existing directory. +3. Navigate to the ```build.xml``` file. You will see all the build rules in + the Outline pane. Run the ```jar``` rule to build the compiler in + ```build/compiler.jar```. + +## Running + +On the command line, at the root of this project, type + +``` +java -jar build/compiler.jar +``` + +This starts the compiler in interactive mode. Type + +```javascript +var x = 17 + 25; +``` + +then hit "Enter", then hit "Ctrl-Z" (on Windows) or "Ctrl-D" (on Mac or Linux) +and "Enter" again. The Compiler will respond: + +```javascript +var x=42; +``` + +The Closure Compiler has many options for reading input from a file, writing +output to a file, checking your code, and running optimizations. To learn more, +type + +``` +java -jar compiler.jar --help +``` + +More detailed information about running the Closure Compiler is available in the +[documentation](http://code.google.com/closure/compiler/docs/gettingstarted_app.html). + +## Compiling Multiple Scripts + +If you have multiple scripts, you should compile them all together with one +compile command. + +```bash +java -jar compiler.jar --js_output_file=out.js in1.js in2.js in3.js ... +``` + +You can also use minimatch-style globs. + +```bash +# Recursively include all js files in subdirs +java -jar compiler.jar --js_output_file=out.js 'src/**.js' + +# Recursively include all js files in subdirs, exclusing test files. +# Use single-quotes, so that bash doesn't try to expand the '!' +java -jar compiler.jar --js_output_file=out.js 'src/**.js' '!**_test.js' +``` + +The Closure Compiler will concatenate the files in the order they're passed at +the command line. + +If you're using globs or many files, you may start to run into +problems with managing dependencies between scripts. In this case, you should +use the [Closure Library](https://developers.google.com/closure/library/). It +contains functions for enforcing dependencies between scripts, and Closure Compiler +will re-order the inputs automatically. + +## How to Contribute +### Reporting a bug +1. First make sure that it is really a bug and not simply the way that Closure Compiler works (especially true for ADVANCED_OPTIMIZATIONS). + * Check the [official documentation](https://developers.google.com/closure/compiler/) + * Consult the [FAQ](https://github.com/google/closure-compiler/wiki/FAQ) + * Search on [Stack Overflow](http://stackoverflow.com/questions/tagged/google-closure-compiler) and in the [Closure Compiler Discuss Group](https://groups.google.com/forum/#!forum/closure-compiler-discuss) +2. If you still think you have found a bug, make sure someone hasn't already reported it. See the list of [known issues](https://github.com/google/closure-compiler/issues). +3. If it hasn't been reported yet, post a new issue. Make sure to add enough detail so that the bug can be recreated. The smaller the reproduction code, the better. + +### Suggesting a Feature +1. Consult the [FAQ](https://github.com/google/closure-compiler/wiki/FAQ) to make sure that the behaviour you would like isn't specifically excluded (such as string inlining). +2. Make sure someone hasn't requested the same thing. See the list of [known issues](https://github.com/google/closure-compiler/issues). +3. Read up on [what type of feature requests are accepted](https://github.com/google/closure-compiler/wiki/FAQ#how-do-i-submit-a-feature-request-for-a-new-type-of-optimization). +4. Submit your reqest as an issue. + +### Submitting patches +1. All contributors must sign a contributor license agreement (CLA). + A CLA basically says that you own the rights to any code you contribute, + and that you give us permission to use that code in Closure Compiler. + You maintain the copyright on that code. + If you own all the rights to your code, you can fill out an + [individual CLA](http://code.google.com/legal/individual-cla-v1.0.html). + If your employer has any rights to your code, then they also need to fill out + a [corporate CLA](http://code.google.com/legal/corporate-cla-v1.0.html). + If you don't know if your employer has any rights to your code, you should + ask before signing anything. + By default, anyone with an @google.com email address already has a CLA + signed for them. +2. To make sure your changes are of the type that will be accepted, ask about your patch on the [Closure Compiler Discuss Group](https://groups.google.com/forum/#!forum/closure-compiler-discuss) +3. Fork the repository. +4. Make your changes. +5. Submit a pull request for your changes. A project developer will review your work and then merge your request into the project. + +## Closure Compiler License + +Copyright 2009 The Closure Compiler Authors. + +Licensed under the Apache License, Version 2.0 (the "License"); +you may not use this file except in compliance with the License. +You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0. + +Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License. + +## Dependency Licenses + +### Rhino + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Code Path + src/com/google/javascript/rhino, test/com/google/javascript/rhino +
URLhttp://www.mozilla.org/rhino
Version1.5R3, with heavy modifications
LicenseNetscape Public License and MPL / GPL dual license
DescriptionA partial copy of Mozilla Rhino. Mozilla Rhino is an +implementation of JavaScript for the JVM. The JavaScript +parse tree data structures were extracted and modified +significantly for use by Google's JavaScript compiler.
Local ModificationsThe packages have been renamespaced. All code not +relevant to the parse tree has been removed. A JsDoc parser and static typing +system have been added.
+ +### Args4j + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Code Pathlib/args4j.jar
URLhttps://args4j.dev.java.net/
Version2.0.26
LicenseMIT
Descriptionargs4j is a small Java class library that makes it easy to parse command line +options/arguments in your CUI application.
Local ModificationsNone
+ +### Guava Libraries + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Code Pathlib/guava.jar
URLhttps://github.com/google/guava
Version18.0
LicenseApache License 2.0
DescriptionGoogle's core Java libraries.
Local ModificationsNone
+ +### JSR 305 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Code Pathlib/jsr305.jar
URLhttp://code.google.com/p/jsr-305/
Versionsvn revision 47
LicenseBSD License
DescriptionAnnotations for software defect detection.
Local ModificationsNone
+ +### JUnit + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Code Pathlib/junit.jar
URLhttp://sourceforge.net/projects/junit/
Version4.11
LicenseCommon Public License 1.0
DescriptionA framework for writing and running automated tests in Java.
Local ModificationsNone
+ +### Protocol Buffers + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Code Pathlib/protobuf-java.jar
URLhttp://code.google.com/p/protobuf/
Version2.5.0
LicenseNew BSD License
DescriptionSupporting libraries for protocol buffers, +an encoding of structured data.
Local ModificationsNone
+ +### Truth + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Code Pathlib/truth.jar
URLhttps://github.com/google/truth
Version0.24
LicenseApache License 2.0
DescriptionAssertion/Proposition framework for Java unit tests
Local ModificationsNone
+ +### Ant + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Code Path + lib/ant.jar, lib/ant-launcher.jar +
URLhttp://ant.apache.org/bindownload.cgi
Version1.8.1
LicenseApache License 2.0
DescriptionAnt is a Java based build tool. In theory it is kind of like "make" +without make's wrinkles and with the full portability of pure java code.
Local ModificationsNone
+ +### GSON + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Code Pathlib/gson.jar
URLhttps://code.google.com/p/google-gson/
Version2.2.4
LicenseApache license 2.0
DescriptionA Java library to convert JSON to Java objects and vice-versa
Local ModificationsNone
+ +### Node.js Closure Compiler Externs + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Code Pathcontrib/nodejs
URLhttps://github.com/dcodeIO/node.js-closure-compiler-externs
Versione891b4fbcf5f466cc4307b0fa842a7d8163a073a
LicenseApache 2.0 license
DescriptionType contracts for NodeJS APIs
Local ModificationsSubstantial changes to make them compatible with NpmCommandLineRunner.
diff --git a/devices/c1p/machine/32kb/machine.xml b/devices/c1p/machine/32kb/machine.xml index 7a70bc375..60cd7ebc5 100644 --- a/devices/c1p/machine/32kb/machine.xml +++ b/devices/c1p/machine/32kb/machine.xml @@ -1,5 +1,5 @@ - + OSI Challenger 1P (32Kb) with Disk Support diff --git a/devices/c1p/machine/8kb/README.md b/devices/c1p/machine/8kb/README.md new file mode 100644 index 000000000..245911755 --- /dev/null +++ b/devices/c1p/machine/8kb/README.md @@ -0,0 +1,17 @@ +--- +layout: page +title: Machines +permalink: /devices/c1p/machine/8kb/ +--- + +Challenger 1P Machine Configurations with 8Kb +--- + +Here are some sample C1P Machine Configurations with 8Kb: + +* [8kb with Large Display](large/) ([Debugger](large/debugger/)) +* [8kb with Small Display](small/) +* [8kb with Large Display w/Additional Software](all/) ([Debugger](all/debugger/)) +* [8kb "Server Array" Demo](array/) + +See the [Documentation](/docs/c1pjs/) for details on the operation of C1Pjs. diff --git a/devices/c1p/machine/8kb/all/debugger/machine.xml b/devices/c1p/machine/8kb/all/debugger/machine.xml index 962f0e9ed..c29d4dee8 100644 --- a/devices/c1p/machine/8kb/all/debugger/machine.xml +++ b/devices/c1p/machine/8kb/all/debugger/machine.xml @@ -1,5 +1,5 @@ - + OSI Challenger 1P (8Kb, Additional Software) diff --git a/devices/c1p/machine/8kb/all/machine.md b/devices/c1p/machine/8kb/all/machine.md new file mode 100644 index 000000000..054e89d13 --- /dev/null +++ b/devices/c1p/machine/8kb/all/machine.md @@ -0,0 +1,10 @@ +--- +layout: page +title: "OSI Challenger 1P (8Kb) with Additional Software" +permalink: /devices/c1p/machine/8kb/all/ +machines: + - type: c1p + id: c1p8kb +--- + +{% include machine.html id="c1p8kb" %} diff --git a/devices/c1p/machine/8kb/all/machine.xml b/devices/c1p/machine/8kb/all/machine.xml new file mode 100644 index 000000000..a071cce97 --- /dev/null +++ b/devices/c1p/machine/8kb/all/machine.xml @@ -0,0 +1,29 @@ + + + + OSI Challenger 1P (8Kb, Additional Software) + + + + + + + + + + + + + + + + + + CTRL-C + CTRL-O + BREAK + + + diff --git a/devices/c1p/machine/8kb/array/machine.xml b/devices/c1p/machine/8kb/array/machine.xml index 106dd0652..eb6a66dae 100644 --- a/devices/c1p/machine/8kb/array/machine.xml +++ b/devices/c1p/machine/8kb/array/machine.xml @@ -1,5 +1,5 @@ - + Challenger 1P (8Kb) "Server Array" diff --git a/devices/c1p/machine/8kb/embed/machine.md b/devices/c1p/machine/8kb/embed/machine.md new file mode 100644 index 000000000..d2466e3e1 --- /dev/null +++ b/devices/c1p/machine/8kb/embed/machine.md @@ -0,0 +1,13 @@ +--- +layout: page +title: "OSI Challenger 1P (8Kb) with Small Display" +permalink: /devices/c1p/machine/8kb/embed/ +machines: + - type: c1p + id: c1pEmbed +redirect_from: + - /configs/c1p/machines/8kb/embed/ + - /demos/c1p/embed.xml/ +--- + +{% include machine.html id="c1pEmbed" %} diff --git a/devices/c1p/machine/8kb/large/debugger/machine.xml b/devices/c1p/machine/8kb/large/debugger/machine.xml index 3a299f361..a16a735b8 100644 --- a/devices/c1p/machine/8kb/large/debugger/machine.xml +++ b/devices/c1p/machine/8kb/large/debugger/machine.xml @@ -1,5 +1,5 @@ - + OSI Challenger 1P (8Kb) with Debugger diff --git a/devices/c1p/machine/8kb/large/machine.xml b/devices/c1p/machine/8kb/large/machine.xml index 471f1662a..88f6ee508 100644 --- a/devices/c1p/machine/8kb/large/machine.xml +++ b/devices/c1p/machine/8kb/large/machine.xml @@ -1,5 +1,5 @@ - + OSI Challenger 1P (circa 1978) diff --git a/devices/c1p/machine/8kb/small/machine.xml b/devices/c1p/machine/8kb/small/machine.xml index 966ee79c0..bcc9b6466 100644 --- a/devices/c1p/machine/8kb/small/machine.xml +++ b/devices/c1p/machine/8kb/small/machine.xml @@ -1,5 +1,5 @@ - + diff --git a/devices/c1p/machine/README.md b/devices/c1p/machine/README.md index 9a23551fe..a1eddf256 100644 --- a/devices/c1p/machine/README.md +++ b/devices/c1p/machine/README.md @@ -9,11 +9,10 @@ Challenger 1P Machine Configurations Here are some sample C1P Machine Configurations: -* [8kb with Large Display](8kb/large/) -* [8kb with Large Display, Debugger](8kb/large/debugger/) +* [8kb with Large Display](8kb/large/) ([Debugger](8kb/large/debugger/)) * [8kb with Small Display](8kb/small/) -* [8kb with Large Display, Debugger, Additional Software](8kb/all/debugger) +* [8kb with Large Display w/Additional Software](8kb/all/) ([Debugger](8kb/all/debugger/)) * [8kb "Server Array" Demo](8kb/array/) * [32kb with Diskette Support](32kb/) -See the [Documentation](/docs/c1pjs/) for details on the operation of C1Pjs. +See the [C1Pjs Documentation](/docs/c1pjs/) for operational details of our Challenger 1P emulator. diff --git a/devices/pc/README.md b/devices/pc/README.md index 325a087dc..832226a71 100644 --- a/devices/pc/README.md +++ b/devices/pc/README.md @@ -7,7 +7,7 @@ permalink: /devices/pc/ IBM PC Device Configurations --- -[IBM PC Machine Configurations](machine/) are built from a collection of devices, including: +[PC Machines](machine/) are built from a collection of devices, including: * CPU * RAM diff --git a/devices/pc/machine/5150/README.md b/devices/pc/machine/5150/README.md index 5d34e5b25..1fea87634 100644 --- a/devices/pc/machine/5150/README.md +++ b/devices/pc/machine/5150/README.md @@ -1,15 +1,15 @@ --- layout: page -title: IBM PC Machines (Model 5150) +title: IBM PC (Model 5150) Machines permalink: /devices/pc/machine/5150/ redirect_from: - /configs/pc/machines/5150/ --- -IBM PC Machines (Model 5150) +IBM PC (Model 5150) Machines --- -All our Model 5150 configurations of the IBM PC are located here, including: +Our IBM PC 5150 configurations include: * [IBM PC with Monochrome Display](/devices/pc/machine/5150/mda/) * [IBM PC with Color Display](/devices/pc/machine/5150/cga/) diff --git a/devices/pc/machine/5150/cga/384kb/softkbd/machine.xml b/devices/pc/machine/5150/cga/384kb/softkbd/machine.xml index 94f9e43e9..6cf0c91ba 100644 --- a/devices/pc/machine/5150/cga/384kb/softkbd/machine.xml +++ b/devices/pc/machine/5150/cga/384kb/softkbd/machine.xml @@ -1,5 +1,5 @@ - + IBM PC (Model 5150), CGA, 384K diff --git a/devices/pc/machine/5150/cga/64kb/donkey/debugger/machine.xml b/devices/pc/machine/5150/cga/64kb/donkey/debugger/machine.xml index d8c5afa17..2d793fa3b 100644 --- a/devices/pc/machine/5150/cga/64kb/donkey/debugger/machine.xml +++ b/devices/pc/machine/5150/cga/64kb/donkey/debugger/machine.xml @@ -1,5 +1,5 @@ - + IBM PC (Model 5150), CGA, 64K diff --git a/devices/pc/machine/5150/cga/64kb/donkey/machine.xml b/devices/pc/machine/5150/cga/64kb/donkey/machine.xml index 6245e2c5d..735eb121e 100644 --- a/devices/pc/machine/5150/cga/64kb/donkey/machine.xml +++ b/devices/pc/machine/5150/cga/64kb/donkey/machine.xml @@ -1,5 +1,5 @@ - + IBM PC (Model 5150), CGA, 64K diff --git a/devices/pc/machine/5150/cga/64kb/softkbd/machine.xml b/devices/pc/machine/5150/cga/64kb/softkbd/machine.xml index 83db02ec5..32331b7dd 100644 --- a/devices/pc/machine/5150/cga/64kb/softkbd/machine.xml +++ b/devices/pc/machine/5150/cga/64kb/softkbd/machine.xml @@ -1,5 +1,5 @@ - + IBM PC (Model 5150), CGA, 64K diff --git a/devices/pc/machine/5150/dual/64kb/machine.xml b/devices/pc/machine/5150/dual/64kb/machine.xml index 27b2ddde0..be18da3ef 100644 --- a/devices/pc/machine/5150/dual/64kb/machine.xml +++ b/devices/pc/machine/5150/dual/64kb/machine.xml @@ -1,5 +1,5 @@ - + IBM PC (Model 5150) with Dual Displays diff --git a/devices/pc/machine/5150/mda/64kb/debugger/machine.xml b/devices/pc/machine/5150/mda/64kb/debugger/machine.xml index b8c3fdc4f..151f54c82 100644 --- a/devices/pc/machine/5150/mda/64kb/debugger/machine.xml +++ b/devices/pc/machine/5150/mda/64kb/debugger/machine.xml @@ -1,5 +1,5 @@ - + IBM PC (Model 5150) with Monochrome Display diff --git a/devices/pc/machine/5150/mda/64kb/machine.xml b/devices/pc/machine/5150/mda/64kb/machine.xml index 84d61d4b0..0f1e07c62 100644 --- a/devices/pc/machine/5150/mda/64kb/machine.xml +++ b/devices/pc/machine/5150/mda/64kb/machine.xml @@ -1,5 +1,5 @@ - + IBM PC (Model 5150) with Monochrome Display diff --git a/devices/pc/machine/5150/mda/64kb/softkbd/machine.xml b/devices/pc/machine/5150/mda/64kb/softkbd/machine.xml index 2bf7af6f7..253d479b3 100644 --- a/devices/pc/machine/5150/mda/64kb/softkbd/machine.xml +++ b/devices/pc/machine/5150/mda/64kb/softkbd/machine.xml @@ -1,5 +1,5 @@ - + IBM PC (Model 5150), MDA, 64K diff --git a/devices/pc/machine/5160/README.md b/devices/pc/machine/5160/README.md index e67c2f71c..8baed4ada 100644 --- a/devices/pc/machine/5160/README.md +++ b/devices/pc/machine/5160/README.md @@ -1,13 +1,13 @@ --- layout: page -title: IBM PC XT (Model 5160) +title: IBM PC XT (Model 5160) Machines permalink: /devices/pc/machine/5160/ --- -IBM PC XT Machines (Model 5160) +IBM PC XT (Model 5160) Machines --- -All our Model 5160, aka IBM PC XT, configurations are located here, including: +Our IBM PC XT 5160 configurations include: * [IBM PC XT with Monochrome Display](/devices/pc/machine/5160/mda/) * [IBM PC XT with Color Display](/devices/pc/machine/5160/cga/) diff --git a/devices/pc/machine/5160/cga/256kb/array/machine.xml b/devices/pc/machine/5160/cga/256kb/array/machine.xml index 5c14e87c3..ba872050f 100644 --- a/devices/pc/machine/5160/cga/256kb/array/machine.xml +++ b/devices/pc/machine/5160/cga/256kb/array/machine.xml @@ -1,5 +1,5 @@ - + IBM PC XT (Model 5160), CGA, 256K, 10Mb Drive diff --git a/devices/pc/machine/5160/cga/256kb/demo/debugger/machine.xml b/devices/pc/machine/5160/cga/256kb/demo/debugger/machine.xml index 4864ec78c..5b25fecc1 100644 --- a/devices/pc/machine/5160/cga/256kb/demo/debugger/machine.xml +++ b/devices/pc/machine/5160/cga/256kb/demo/debugger/machine.xml @@ -1,5 +1,5 @@ - + IBM PC XT (Model 5160), CGA, 256Kb, 10Mb Drive diff --git a/devices/pc/machine/5160/cga/256kb/demo/machine.xml b/devices/pc/machine/5160/cga/256kb/demo/machine.xml index 501538458..8927acf05 100644 --- a/devices/pc/machine/5160/cga/256kb/demo/machine.xml +++ b/devices/pc/machine/5160/cga/256kb/demo/machine.xml @@ -1,5 +1,5 @@ - + IBM PC XT (Model 5160), CGA, 256Kb, 10Mb Drive diff --git a/devices/pc/machine/5160/cga/256kb/softkbd/machine.xml b/devices/pc/machine/5160/cga/256kb/softkbd/machine.xml index 3e0fbd4e3..c3ab99763 100644 --- a/devices/pc/machine/5160/cga/256kb/softkbd/machine.xml +++ b/devices/pc/machine/5160/cga/256kb/softkbd/machine.xml @@ -1,5 +1,5 @@ - + IBM PC XT (Model 5160), CGA, 256K, 10Mb Drive diff --git a/devices/pc/machine/5160/cga/256kb/win101/debugger/machine.xml b/devices/pc/machine/5160/cga/256kb/win101/debugger/machine.xml index 2b2b3aa39..dc7697c0b 100644 --- a/devices/pc/machine/5160/cga/256kb/win101/debugger/machine.xml +++ b/devices/pc/machine/5160/cga/256kb/win101/debugger/machine.xml @@ -1,5 +1,5 @@ - + IBM PC XT (Model 5160) running Windows 1.01 diff --git a/devices/pc/machine/5160/cga/256kb/win101/machine.xml b/devices/pc/machine/5160/cga/256kb/win101/machine.xml index b3803f5ee..edca389a7 100644 --- a/devices/pc/machine/5160/cga/256kb/win101/machine.xml +++ b/devices/pc/machine/5160/cga/256kb/win101/machine.xml @@ -1,5 +1,5 @@ - + IBM PC XT (Model 5160) running Windows 1.01 diff --git a/devices/pc/machine/5160/cga/256kb/win101/softkbd/machine.xml b/devices/pc/machine/5160/cga/256kb/win101/softkbd/machine.xml index 7619b253d..fa0842a98 100644 --- a/devices/pc/machine/5160/cga/256kb/win101/softkbd/machine.xml +++ b/devices/pc/machine/5160/cga/256kb/win101/softkbd/machine.xml @@ -1,5 +1,5 @@ - + IBM PC XT (Model 5160), CGA, 256K, Windows 1.01 diff --git a/devices/pc/machine/5160/cga/512kb/win101/softkbd/machine.xml b/devices/pc/machine/5160/cga/512kb/win101/softkbd/machine.xml index 3525c6885..1b14f7ddb 100644 --- a/devices/pc/machine/5160/cga/512kb/win101/softkbd/machine.xml +++ b/devices/pc/machine/5160/cga/512kb/win101/softkbd/machine.xml @@ -1,5 +1,5 @@ - + IBM PC XT (Model 5160), CGA, 512K, WIN101 diff --git a/devices/pc/machine/5160/cga/640kb/debugger/machine.xml b/devices/pc/machine/5160/cga/640kb/debugger/machine.xml index 701a56618..a8c4e8311 100644 --- a/devices/pc/machine/5160/cga/640kb/debugger/machine.xml +++ b/devices/pc/machine/5160/cga/640kb/debugger/machine.xml @@ -1,5 +1,5 @@ - + IBM PC XT (Model 5160), CGA, 640K, 10Mb Drive diff --git a/devices/pc/machine/5160/cga/640kb/machine.xml b/devices/pc/machine/5160/cga/640kb/machine.xml index 4583b73a6..2b94eaf44 100644 --- a/devices/pc/machine/5160/cga/640kb/machine.xml +++ b/devices/pc/machine/5160/cga/640kb/machine.xml @@ -1,5 +1,5 @@ - + IBM PC XT (Model 5160), CGA, 640K, 10Mb Drive diff --git a/devices/pc/machine/5160/cga/640kb/softkbd/machine.xml b/devices/pc/machine/5160/cga/640kb/softkbd/machine.xml index 2acd2b8ab..50f6686b6 100644 --- a/devices/pc/machine/5160/cga/640kb/softkbd/machine.xml +++ b/devices/pc/machine/5160/cga/640kb/softkbd/machine.xml @@ -1,5 +1,5 @@ - + IBM PC XT (Model 5160), CGA, 640K, 10Mb Drive diff --git a/devices/pc/machine/5160/ega/256kb/debugger/machine.xml b/devices/pc/machine/5160/ega/256kb/debugger/machine.xml index 576525a3f..84730cc63 100644 --- a/devices/pc/machine/5160/ega/256kb/debugger/machine.xml +++ b/devices/pc/machine/5160/ega/256kb/debugger/machine.xml @@ -1,5 +1,5 @@ - + IBM PC XT (Model 5160), 64K EGA, 256K RAM, 10Mb Hard Disk diff --git a/devices/pc/machine/5160/ega/256kb/machine.md b/devices/pc/machine/5160/ega/256kb/machine.md index 78e1b8adf..84121a655 100644 --- a/devices/pc/machine/5160/ega/256kb/machine.md +++ b/devices/pc/machine/5160/ega/256kb/machine.md @@ -2,6 +2,8 @@ layout: page title: "IBM PC XT (Model 5160, 256Kb, 10Mb Drive) with EGA Display" permalink: /devices/pc/machine/5160/ega/256kb/ +redirect_from: + - /configs/pc/machines/5160/ega/256kb/ machines: - type: pc id: ibm5160 diff --git a/devices/pc/machine/5160/ega/256kb/machine.xml b/devices/pc/machine/5160/ega/256kb/machine.xml index abd479b00..611b06664 100644 --- a/devices/pc/machine/5160/ega/256kb/machine.xml +++ b/devices/pc/machine/5160/ega/256kb/machine.xml @@ -1,5 +1,5 @@ - + IBM PC XT (Model 5160), 64K EGA, 256K RAM, 10Mb Hard Disk diff --git a/devices/pc/machine/5160/ega/640kb/array/machine.xml b/devices/pc/machine/5160/ega/640kb/array/machine.xml index a08ccdf11..9decc27d9 100644 --- a/devices/pc/machine/5160/ega/640kb/array/machine.xml +++ b/devices/pc/machine/5160/ega/640kb/array/machine.xml @@ -1,5 +1,5 @@ - + IBM PC XT, 128K EGA, 640K RAM, 10Mb Hard Disk diff --git a/devices/pc/machine/5160/ega/640kb/debugger/machine.xml b/devices/pc/machine/5160/ega/640kb/debugger/machine.xml index a4c1623ff..c8ad75a7f 100644 --- a/devices/pc/machine/5160/ega/640kb/debugger/machine.xml +++ b/devices/pc/machine/5160/ega/640kb/debugger/machine.xml @@ -1,5 +1,5 @@ - + IBM PC XT, 128K EGA, 640K RAM, 10Mb Hard Disk diff --git a/devices/pc/machine/5160/ega/640kb/machine.md b/devices/pc/machine/5160/ega/640kb/machine.md index 43d2b3c01..d7d6a3ee6 100644 --- a/devices/pc/machine/5160/ega/640kb/machine.md +++ b/devices/pc/machine/5160/ega/640kb/machine.md @@ -2,6 +2,8 @@ layout: page title: "IBM PC XT (Model 5160, 640Kb, 10Mb Drive) with EGA Display" permalink: /devices/pc/machine/5160/ega/640kb/ +redirect_from: + - /configs/pc/machines/5160/ega/640kb/ machines: - type: pc id: ibm5160 diff --git a/devices/pc/machine/5160/ega/640kb/machine.xml b/devices/pc/machine/5160/ega/640kb/machine.xml index aa83b83cf..a3aedd285 100644 --- a/devices/pc/machine/5160/ega/640kb/machine.xml +++ b/devices/pc/machine/5160/ega/640kb/machine.xml @@ -1,5 +1,5 @@ - + IBM PC XT, 128K EGA, 640K RAM, 10Mb Hard Disk diff --git a/devices/pc/machine/5160/mda/256kb/debugger/machine.xml b/devices/pc/machine/5160/mda/256kb/debugger/machine.xml index 24787145a..d68860988 100644 --- a/devices/pc/machine/5160/mda/256kb/debugger/machine.xml +++ b/devices/pc/machine/5160/mda/256kb/debugger/machine.xml @@ -1,5 +1,5 @@ - + IBM PC XT (Model 5160), MDA, 256Kb, 10Mb Drive diff --git a/devices/pc/machine/5160/mda/256kb/fake188/debugger/machine.xml b/devices/pc/machine/5160/mda/256kb/fake188/debugger/machine.xml index 27830d0eb..927d08bcb 100644 --- a/devices/pc/machine/5160/mda/256kb/fake188/debugger/machine.xml +++ b/devices/pc/machine/5160/mda/256kb/fake188/debugger/machine.xml @@ -1,5 +1,5 @@ - + IBM PC XT (Model 5160), MDA, 256Kb, 10Mb Drive diff --git a/devices/pc/machine/5160/mda/256kb/fake188/machine.xml b/devices/pc/machine/5160/mda/256kb/fake188/machine.xml index c31abf9eb..c81e7dd9a 100644 --- a/devices/pc/machine/5160/mda/256kb/fake188/machine.xml +++ b/devices/pc/machine/5160/mda/256kb/fake188/machine.xml @@ -1,5 +1,5 @@ - + IBM PC XT (Model 5160), MDA, 256Kb, 10Mb Drive diff --git a/devices/pc/machine/5160/mda/256kb/machine.xml b/devices/pc/machine/5160/mda/256kb/machine.xml index f425f10a8..7b202822d 100644 --- a/devices/pc/machine/5160/mda/256kb/machine.xml +++ b/devices/pc/machine/5160/mda/256kb/machine.xml @@ -1,5 +1,5 @@ - + IBM PC XT (Model 5160), MDA, 256Kb, 10Mb Drive diff --git a/devices/pc/machine/5160/mda/64kb/softkbd/machine.xml b/devices/pc/machine/5160/mda/64kb/softkbd/machine.xml index 888e5da77..785bde9d0 100644 --- a/devices/pc/machine/5160/mda/64kb/softkbd/machine.xml +++ b/devices/pc/machine/5160/mda/64kb/softkbd/machine.xml @@ -1,5 +1,5 @@ - + IBM PC XT (Model 5160), MDA, 64K, 10Mb Drive diff --git a/devices/pc/machine/5160/mda/README.md b/devices/pc/machine/5160/mda/README.md index bb9d20768..aa739c4bc 100644 --- a/devices/pc/machine/5160/mda/README.md +++ b/devices/pc/machine/5160/mda/README.md @@ -2,6 +2,8 @@ layout: page title: IBM PC Machines (Model 5160) with Monochrome (MDA) Display permalink: /devices/pc/machine/5160/mda/ +redirect_from: + - /configs/pc/machines/5160/mda/ --- IBM PC XT with Monochrome (MDA) Display diff --git a/devices/pc/machine/5170/README.md b/devices/pc/machine/5170/README.md index 6ece8fe3d..2b212042d 100644 --- a/devices/pc/machine/5170/README.md +++ b/devices/pc/machine/5170/README.md @@ -1,15 +1,456 @@ --- layout: page -title: IBM PC AT (Model 5170) +title: IBM PC AT (Model 5170) Machines permalink: /devices/pc/machine/5170/ --- -IBM PC AT Machines (Model 5170) +IBM PC AT (Model 5170) Machines --- -All our Model 5170, aka IBM PC AT, configurations are located here, including: +Our IBM PC AT 5170 configurations include: * [IBM PC AT with MDA Display](/devices/pc/machine/5170/mda/) * [IBM PC AT with CGA Display](/devices/pc/machine/5170/cga/) * [IBM PC AT with EGA Display](/devices/pc/machine/5170/ega/) * [IBM PC AT with VGA Display](/devices/pc/machine/5170/vga/) + +The IBM PC AT 5170 came in a variety of its own models over a three-year period. + +### 5170 Models 68 and 99 + +Models 68 and 99 were [introduced](#ibm-pc-at-5170-models-68-and-99-announcement) in August 1984: + +* Model 68 + - Type 1 motherboard + - 6 MHz CPU + - 256Kb RAM + - [Rev 1 BIOS](/devices/pc/rom/5170/#ibm-pc-at-rom-bios-rev-1) dated "01/10/84" +* Model 99 + - All of the above + - 256Kb additional RAM (total of 512Kb) + - 20Mb Hard Drive + - 1 Serial/Parallel Adapter + +### 5170 Model 239 + +Model 239 was introduced in October 1985: + +* Model 239 + - Type 2 motherboard + - 6 MHz CPU + - 512Kb RAM + - 30Mb Hard Drive + - 1 Serial/Parallel Adapter + - [Rev 2 BIOS](/devices/pc/rom/5170/#ibm-pc-at-rom-bios-rev-2) dated "06/10/85" + +### 5170 Models 319 and 339 + +Models 319 and 339 were introduced in April 1986: + +* Model 319 + - Type 3 motherboard + - 8 MHz CPU + - 512Kb RAM + - 30MB hard drive + - 1 Serial/Parallel Adapter + - [Rev 3 BIOS](/devices/pc/rom/5170/#ibm-pc-at-rom-bios-rev-3) dated "11/15/85" +* Model 339 + - All of the above + - Enhanced 101-key keyboard + +IBM PC AT 5170 Configuration Options +--- + +The IBM PC AT 5170 doesn't have DIP switches like previous models, but it still has a few switches and jumpers. + +First and foremost, there is a **Display Switch** near the battery connector that must be pushed "toward the +front of your system unit" if you have a CGA that is your only (or primary) display adapter, or "toward the +back of your system unit" if you're using an MDA as your only (or primary) display. + +In PCjs, the 5170 **Display Switch** is configured with the <[ChipSet](/docs/pcjs/chipset/)> *monitor* +property, which you can set to either "mono" (aka "mda") or "color" (aka "cga"). Unlike the Model 5150/5160 DIP +switches, there is no UI for this switch, so once the machine has been created, it cannot be changed by the user. + +Also, there is the "keyboard inhibit switch"; it defaults to UNLOCKED and stays UNLOCKED, since no UI or +configuration property is currently provided. + +Finally, there is a "manufacturing jumper" that can be installed, enabling additional diagnostic functions +in the ROM; it defaults to UNINSTALLED and stays UNINSTALLED, since no UI or configuration property is currently +provided. + +The rest of a 5170 machine's configuration is normally handled through CMOS settings, such as the number and type +of floppy diskette drives, which can be configured with the <[ChipSet](/docs/pcjs/chipset/)> *floppies* property; +e.g.: + + + +The number of elements in the array determines the number of drives, and the value of each element +determines the type of drive; the value corresponds to the maximum supported diskette size, in Kb: + ++ 360 ++ 720 ++ 1200 ++ 1440 + +However, for the 3.5-inch diskette capacities (720 and 1440) to work properly, the machine should also use a +["Rev 3"](/devices/pc/rom/5170/#ibm-pc-at-rom-bios-rev-3) IBM PC AT ROM BIOS and boot with DOS 3.20 or later. + +Like the **Display Switch**, there is no UI for this or any other CMOS setting, so once the machine has been created, +it cannot be changed by the user. + +--- + +IBM PC AT 5170 (Models 68 and 99) Announcement +--- + +The following details come from a [copy](http://www.minuszerodegrees.net/misc/IBM%20PC%20AT%205170%20announcement%20letter.txt) +of IBM's PC AT Announcement Letter, dated August 14, 1984. + +> The IBM Personal Computer AT is designed for professional +applications, office environments, and increased personal +productivity. It includes many advanced technology features +previously not available in IBM Personal Computers: increased +performance, advanced microprocessor, high capacity diskette drives, +high capacity fixed disk drives, large memory capacity, and advanced +co-processor. The 5170 provides compatibility with existing hardware +and software products for the IBM Personal Computer family. + +> ### HIGHLIGHTS + +> * Performs more than two times faster than current members of the IBM Personal Computer family +> * Based on high-performance Intel 80286 microprocessor, compatible with the IBM Personal Computer family +> * Includes 1.2Mb high-capacity diskette drives +> * Allows 20Mb fixed disk drives +> * Contains a standard combination fixed disk and diskette adapter +> * Provides 512Kb memory capacity on the system board +> * Offers a combination Serial (Asynchronous)/Parallel (Printer) Adapter +> * Allows workstation growth with eight I/O expansion slots +> * Includes an improved keyboard +> * Includes a clock/calendar with battery backup +> * Provides improved security capability with a standard keylock + +> ### DESCRIPTION + +> The 5170 system unit/keyboard includes the following standard features: + +> * Advanced high-performance Intel 80286 microprocessor +> * ROM based automatic power on self test of system components +> * ROM based BASIC language interpreter +> * 8086 compatible real address mode +> * Protected virtual address mode +> * 256Kb of memory (Model 68) +> * 512Kb of memory (Model 99) +> * 1.2Mb high capacity diskette drive +> * Diskette interface +> * 20Mb fixed disk drive (Model 99) +> * Fixed disk interface +> * Fixed disk-in-use indicator light (red) +> * Serial/parallel interface (Model 99) +> * System clock/calendar/system configuration storage with battery back-up +> * Sound system +> * Keylock +> * Bi-directional keyboard interface +> * Enhanced keyboard +> * Switchable worldwide power supply +> * Power-on indicator light (green) +> * Eight I/O expansion slots +> * Socket for 80287 math co-processor +> * 24-bit addressing +> * 16-bit data path +> * Seven-channel direct memory access (DMA) +> * 16-level interrupt +> * Three programmable timers + +> Based on a high performance 16/24-bit Intel 80286 microprocessor, +both models of the 5170 are equipped with a high capacity (1.2Mb) +diskette drive, enhanced keyboard, ROM based BASIC language, +clock/calendar with battery backup, and keylock. Standard memory on +Model 68 is 256Kb and on Model 99 is 512Kb. In addition, Model 99 is +equipped with a 20Mb fixed disk drive and a serial +(asynchronous)/parallel (printer) adapter. Each system can be further +expanded through customer setup options. Model 68 memory may be +expanded to 512Kb by addition of pluggable memory modules on the +system board. Both models may be further expanded to 640Kb with the +128Kb memory option or up to 3Mb with 512Kb memory options. + +> Additional direct access storage is available with a 20Mb +Fixed Disk Drive, a second 1.2Mb High Capacity Diskette Drive, and a +Dual-sided (320/360Kb) Diskette Drive. A maximum of two diskette +drives and one fixed disk drive, or one diskette drive and two fixed +disk drives can be attached to the system unit. These combinations +result in direct access storage capacity of up to 41.2Mb. + +> DOS 3.0 supports the 20Mb Fixed Disk Drive and 1.2Mb High +Capacity Diskette Drive in the 5170 system. With DOS 3.0, the 1.2Mb +diskette drive will also read single- and dual-sided diskettes +formatted at 160/180Kb and 320/360Kb capacity, respectively. The +Dual-sided Diskette Drive (320/360Kb) option is available for +downward diskette portability with other IBM Personal Computer family +members. + +> The IBM Personal Computer AT is also supported by two other +operating systems. Personal Computer Interactive Executive (PC/IX) +Version 1.1 will support the IBM Personal Computer AT in +compatibility, real address mode. PC/IX will be available in the +fourth quarter of 1984. The IBM Personal Computer XENIX* will support +the IBM Personal Computer AT in the 80286 protected address mode. IBM +Personal Computer XENIX will be available in the first quarter of +1985. + +> The 5170 contains eight option (feature) slots that support +feature cards for additional devices, features, or memory. Six of the +slots support either the advanced 16-bit or 8-bit option cards. Two +support 8-bit option cards only. However, both models use one 16-bit +slot for the standard combination fixed disk and diskette drive +adapter. The Model 99 uses one 8-bit slot for the Serial/Parallel +Adapter. The result is seven available expansion slots on Model 68 +and six on Model 99. + +> Both models include a world-wide power supply and a +temperature-controlled variable speed cooling fan that significantly +reduces acoustical noise in most user environments. Both models also +include a security keylock, which, when locked by the user, prevents +removal of the 5170 cover, initialization of the system, and entry of +command/data from the keyboard. + +> The keyboard is attached to the 5170 via a ten-foot coiled +cable, permitting a variety of workspace configurations. The enhanced +84-key keyboard, with an adjustable typing angle, offers commonly +used data and word processing functions along with separate +typewriter and numeric keypads. Key-location enhancements and mode +indicators (Cap Lock, Numeric Lock, Scroll Lock) improve keyboard +usability. Special symbols may be accessed with a combination of +keys. Depending on the application program, from 10 to 40 special +function keys may be supported. + +> Exploring the IBM Personal Computer AT, a program on a +diskette, is supplied with the 5170. It will familiarize a new +computer user with the 5170. The program takes 1-1/2 to 2-1/2 hours +to complete. There are two versions of the program, monochrome and +color. The program is self-loading from the diskette. It contains +tutorial information on the keyboard, printer, and disk storage, as +well as DOS and text editing. It requires a 5170 with a minimum of +one diskette drive, 256Kb of storage, and one display adapter (either +monochrome or color). + +> ### OPTIONAL FEATURES + +> #### 256Kb Memory Module Kit (#0202) + +> This option increases the 5170 Model 68 memory from 256Kb to +512Kb. The kit consists of 18 modules that are plugged into existing +sockets on the system board. A maximum of one kit may be installed on +Model 68 only. It is required on the Model 68 for installation +of #0209 and #0203. + +> #### 512Kb Memory Expansion Option (#0203) + +> This option adds memory above 1Mb, in 512Kb increments. Up to +five options may be plugged into the I/O expansion slots of the +system unit to provide a total of three megabytes of primary storage. +Performance characteristics are the same as other 5170 user memory. + +> The system unit must have at least 512 Kb installed. This option +requires one 16-bit expansion slot. Note: This option may not be used +for address storage from 512Kb to 640Kb. The memory range from 640Kb +to 1Mb is reserved for system functions. + +> #### 128Kb Memory Expansion Option (#0209) + +> This option expands the memory from 512Kb to 640Kb. +Performance characteristics are the same as other 5170 user memory. +Only one 128Kb Memory Expansion Option may be installed on a 512Kb +system unit and it requires a 16-bit expansion slot. + +> #### 20Mb Fixed Disk Drive (#0205) + +> Two optional fixed disk drives may be installed on Model 68 or +one, as a second fixed disk drive, on Model 99, providing a total of +40Mb of fixed disk storage capacity. Space and power are provided in +the system unit for this drive(s). All fixed disk or diskette drives +use the standard combination fixed disk and diskette drive adapter in +the system unit. A dedicated landing zone for the read/write heads +is available to protect the file and its contents during shipping, +movement, or storage. Increased performance of 40 ms average access +time is possible from the quasi-closed loop servo positioning system +utilized in the drive. The number of fixed disk drives and diskette +drives must not exceed three. No more than two fixed disk drives can +be installed in a system unit. + +> CHARACTERISTICS: + +> * 20Mb of storage +> * 512 bytes per sector +> * 17 sectors per track +> * 615 tracks per surface (cylinders) +> * 40 ms average access time +> * four surfaces +> * 3573 RPM +> * 5M bit per second transfer rate +> * Dimensions: +> - Height 82.55 mm (3.25 inches) +> - Width 154.3 mm (6.1 inches) +> - Depth 203.2 mm (8.0 inches) +> - Weight 2.9 Kg (6.4 lbs.) + +> #### High Capacity Diskette Drive (#0206) + +> This is a half-high, 5-1/4-inch, dual-sided drive with 1.2Mb +storage capacity. Space and power have been provided in the system +unit for up to two drives. The drive is fully self-contained and +consists of a spindle drive system, a read positioning system and a +read/write/erase system. + +> One of these drives is standard in both models. An optional +second drive (#0206) may be installed in the system unit directly +under the first if the space is not occupied by another disk or +diskette drive. Both drives use the standard fixed disk and diskette +drive adapter in the system unit. + +> The drive uses the new 96-TPI, high density media. In +addition, it will read or write 48-TPI, single- or dual-sided media +written for the IBM PCjr, IBM Personal Computer, IBM Personal +Computer XT, and IBM Portable Personal Computer, giving a high level +of compatibility with existing applications. However, once the +48-TPI media has been written in this drive, it may only be readable +on a high capacity diskette drive. + +> CHARACTERISTICS: + +> * 1.2Mb storage +> * 512 bytes per sector +> * 15 sectors per track +> * 96 tracks per inch +> * Two sides +> * 80 tracks per side +> * 360 RPM +> * Supports 300 and 500 bits/sec data transfer rate +> * 94 ms average access time in 96-TPI mode +> * Dimensions: +> - Height 42.9 mm (1.7 inches) +> - Width 154.3 mm (6.1 inches) +> - Depth 203.2 mm (8.0 inches) +> - Weight: 1.6 Kg (3.5 lbs.) + +> #### Dual-sided Diskette Drive (#0207) + +> This diskette drive permits the exchange of 320/360Kb diskette +media between the Personal Computer AT, to the IBM Personal Computer, +the IBM Personal Computer XT, the IBM Portable Personal Computer, and +the IBM PCjr. It is a half-high, 5-1/4-inch, dual-sided drive with a +320/360Kb storage capacity. Space and power for one drive have been +provided in the system unit. The drive is fully self-contained and +consists of a spindle drive system, a read positioning system, and a +read/write/erase system. + +> This drive is available for both 5170 models. It is installed +in the system unit directly under the standard high capacity diskette +drive if the space is not occupied by another fixed disk or diskette +drive. This drive uses the standard fixed disk and diskette drive +adapter in the system unit. + +> CHARACTERISTICS: + +> * 320/360Kb of storage +> * 512 bytes per sector +> * 8/9 sectors per track +> * Two sides +> * 91 ms average access time +> * 40 tracks per surface +> * 48 tracks per inch +> * 300 RPM +> * Transfer rate of 250K bits/second +> * Dimensions: +> - Height 42.9 mm (1.7 inches) +> - Width 154.3 mm (6.1 inches) +> - Depth 203.2 mm (8.0 inches) +> - Weight: 1.6 Kg (3.5 lbs.) + +> #### Math Co-Processor (#0211) + +> This option is a high performance numeric 80287 processor +extension with floating point, extended integer, and BCD data types, +compatible with the Intel 8087 Math Co-Processor. When installed, +the system fully conforms to the proposed IEEE Floating Point +Standard and is an excellent facility for high-performance numeric +processing. Only one 80287 can be installed in a system unit. + +> #### Serial/Parallel Adapter (#0215) + +> This option provides a serial port and a parallel port. It +occupies only one expansion slot of either type. The serial portion +is fully programmable and supports asynchronous communications from +50 to 9600 baud. The back of the adapter has a nine-pin D-shell +connector that is classified as an RS232-C port. When the optional +10-foot Serial Adapter Cable (#0217) or 10-inch Serial Adapter +Connector (#0242) is connected to the adapter, the 25-pin end of the +cable or connector has all the signals of a standard EIA RS232-C +interface. The parallel portion of the adapter provides the ability +to attach various devices that accept eight bits of parallel data. +The parallel port is provided by a 25-pin, D-shell connector. One or +two Serial/Parallel Adapters may be installed in either model. Note: +This adapter does not support current loop operation. The 5218 +Printer is not supported. + +> #### Prototype Adapter (#0220) + +> This adapter is 4.8 inches high by 13.12 inches long and plugs +into any system unit expansion slot except 1 or 7. Two card edge +tabs, one 2 by 31 positions and one 2 by 18 positions, provide all +system control signals and voltages. No components are shipped with +this card. + +> The adapter contains a voltage bus (+5 Vdc) and a ground bus +(0 Vdc). Each bus borders the adapter with the ground bus on the +component side and the voltage bus on on the pin side. A system +interface (wiring only) is also provided with a space for a jumper to +specify whether the device has an 8- or a 16-bit data bus. This +adapter also accommodates a D-shell connector from 9 to 37 positions. +A recommended system interface logic diagram is available along with +a list of recommended components to be used to interface custom logic +to the 5170. Up to five Prototype Adapters can be installed in a +system unit. Each requires a 16-bit expansion slot. + +> #### Binary Synchronous Communications Adapter (#1204) + +> The BSC Adapter provides an EIA RS232-C interface. It is +compatible with the IBM Personal Computer, the Portable Personal +Computer, and the Personal Computer XT. A maximum of two BSC Adapters +may be installed. Only one BSC Adapter may be installed if an SDLC +Adapter is installed. + +> #### SDLC Communications Adapter (#1205) + +> The SDLC Communications Adapter provides an EIA RS232-C +interface. It is compatible with the IBM Personal Computer, the +Portable Personal Computer, and the Personal Computer XT. Only one +SDLC Adapter may be installed. + +> #### Floor Standing Enclosure (#0218) + +> This optional enclosure is available to customers who desire +to remove their system unit from the work surface. With the system +unit mounted vertically in the floor standing enclosure, only the +essential parts of the system such as the display and keyboard need +to be on the work surface. The unit may be positioned left or right +of the workspace or under the workspace. + +> #### Display Stand (#0216) + +> The display stand is available for the IBM 5151 Monochrome +Display Model 1 and IBM 5153 Color Display Model 1. It can be placed +under the display to allow the customer to tilt and/or swivel the +display for comfortable viewing. + +> ### PUBLICATIONS + +> Each system will be shipped with three manuals: + +> * IBM Personal Computer AT Installation and Setup Manual (#2491) +> * IBM Personal Computer AT Guide to Operations (#2241) +> * IBM Personal Computer Basic Reference Manual Version 3.0 (#1132) + +> The following are available for purchase: + +> * IBM Personal Computer AT Technical Reference Manual (#2243) +> * IBM Personal Computer AT Hardware Maintenance and Service Manual (#2242) diff --git a/devices/pc/machine/5170/cga/640kb/rev3/debugger/machine.xml b/devices/pc/machine/5170/cga/640kb/rev3/debugger/machine.xml index 07fe90698..341165c0a 100644 --- a/devices/pc/machine/5170/cga/640kb/rev3/debugger/machine.xml +++ b/devices/pc/machine/5170/cga/640kb/rev3/debugger/machine.xml @@ -1,12 +1,12 @@ - + IBM PC AT (8Mhz, 640Kb, Dual Floppy) with Color Display -