Create README.md

This commit is contained in:
Thomas Cherryhomes 2019-02-01 23:16:17 -06:00 committed by GitHub
parent bce4bb82fb
commit 0b691cbdf7
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 175 additions and 0 deletions

175
README.md Normal file
View File

@ -0,0 +1,175 @@
PLATOTerm for Classic Macintosh
===============================
PLATOTerm is a terminal emulator to access CYBIS services now available
on the Internet utilizing a WIFI Modem.
For the purposes of this documentation. PLATO and CYBIS are interchangeable
names for the same platform.
Requirements
------------
* Classic 68000 or PPC based Apple Macintosh
* 1MB of RAM
* System 6.0.3 or greater
* WIFI Modem or computer acting as WIFI modem, attached to MODEM port
--------------------------------------------------------------
What services are currently available to access via PLATOTerm?
--------------------------------------------------------------
As of writing this preliminary documentation (February 2019), there are
two major CYBIS systems running. CYBER1.ORG and IRATA.ONLINE.
---------------------------
WHAT IS PLATO? (aka CYBIS?)
---------------------------
(from the PLATO wikipedia page:)
PLATO (Programmed Logic for Automatic Teaching Operations), was the first
generalized computer-asisted instruction system. Starting in 1960, it ran
on the University of Illinois ILLIAC I computer. By the late 1970s, it
supported several thousand graphics terminals distributed worldwide, running
on nearly a dozen different networked mainframe computers. Many modern
concepts in multi-user computing were originally developed on PLATO, including
forums, message boards, online testing, e-mail, chat rooms, picture languages,
instant messaging, remote screen sharing, and multi-player games.
-------------------
What is CYBER1.ORG?
-------------------
CYBER1.ORG is a CYBIS system initially set up in 2004, as a haven for
ex-PLATO users to experience a classic PLATO author experience.
CYBER1.ORG is home to many thousands of classic PLATO lessons and
notesfiles which have been restored from various sources, and have
been made available in the interests of preserving PLATO.
---------------------
What is IRATA.ONLINE?
---------------------
IRATA.ONLINE is a CYBIS system that has been set up for the benefit of
the greater vintage computing community, in the interest to provide
a unique experience that can be accessed on a wide variety of
vintage computers with a bitmapped graphics display. To this end,
IRATA.ONLINE develops PLATOTerm for dozens of platforms, so that they
can access CYBIS systems, as well as provide a community and learning
infrastructure for vintage computing users of all types, in the hopes
that as a cohesive community, something unique can hopefully
emerge.
-----------------------------------------------------------
What is the connection between IRATA.ONLINE and CYBER1.ORG?
-----------------------------------------------------------
CYBER1.ORG and IRATA.ONLINE are independent of one another. With that said,
the reason IRATA.ONLINE and PLATOTerm exist, are because of the efforts of
CYBER1.ORG to not only preserve a running PLATO system, and provide the
necessary information for interested parties to write terminal software
to access CYBIS systems, but also in their effort to produce a publically
available distribution of CYBIS that others who are interested may also
run their own CYBIS installation. IRATA.ONLINE is a direct result of the
public release of this distribution.
Loading PLATOTerm
-----------------
PLATOTerm can be loaded by clicking on the PLATOTerm icon from the Finder.
Default Settings
----------------
This Pre-release version of PLATOTerm99 is configured for the following settings:
* MODEM port
* 57600 Baud
* No Parity
* 8 Data Bits
* 1 Stop Bit
Connecting to IRATA.ONLINE
--------------------------
Once PLATOTerm is started, you can connect to CYBER1.ORG using your WIFI modem,
using a command such as:
```
ATDTIRATA.ONLINE:8005
```
Connecting to CYBER1.ORG
------------------------
Once PLATOTerm is started, you can connect to CYBER1.ORG using your WIFI modem,
using a command such as:
```
ATDTCYBERSERV.ORG:8005
```
PLATO Keyboard
-------------------
The PLATO keyboard is mapped to the Atari keys, like so:
(TODO: Map all the keys)
| PLATO KEY | X68000 Key |
|--- |--- |
| ANS | CTRL A |
| BACK | CTRL B |
| SHIFT-BACK | SHIFT CTRL B |
| COPY | CTRL C |
| SHIFT-COPY | SHIFT CTRL 1 |
| DATA | CTRL D |
| SHIFT-DATA | SHIFT CTRL D |
| EDIT | CTRL E |
| SHIFT-EDIT | SHIFT CTRL E |
| ERASE | BACKSPACE |
| SHIFT-ERASE | SHIFT BACKSPACE |
| FONT | CTRL F |
| ÷ | CTRL G |
| HELP | CTRL H |
| SHIFT-HELP | SHIFT CTRL H |
| LAB | CTRL L |
| SHIFT-LAB | SHIFT CTRL L |
| MICRO | CTRL M |
| NEXT | ENTER |
| SHIFT-NEXT | SHIFT ENTER |
| SUPER | CTRL P |
| SHIFT-SUPER | SHIFT CTRL P |
| SQUARE | CTRL Q |
| ACCESS | SHIFT CTRL Q |
| STOP | CTRL S |
| SHIFT-STOP | SHIFT CTRL S |
| TERM | CTRL T |
| × | CTRL X |
| SUB | CTRL Y |
| SHIFT-SUB | SHIFT CTRL Y |
| SIGMA | CTRL + |
| DELTA | CTRL - |
| ASSIGN | ESC |
| UNION | SHIFT CTRL + |
| INTERSECT | SHIFT CTRL - |
TTY Mode Keys
-------------
In addition, the following keys are available in TTY mode:
| Key | Function |
|--- |--- |
| Command-P | PLATO Mode |
| Command-T | TTY Mode |
| Command-Q | Quit |
| Command-H| Hang Up |
| Command-3 | 300 Baud |
| Command-1 | 1200 Baud |
| Command-2 | 2400 Baud |
| Command-6 | 9600 Baud |
| Command-9 | 19200 Baud |
| Command-8 | 38400 Baud |
| Command-7 | 57600 Baud |
Credits
=======
* '''Thomas Cherryhomes''' - Terminal coding, sleepless nights.
* '''Steve Peltz''' - original PAD protocol decoder from MacPAD.