READMEFIRST - PSEUDOINSPECTOR SAMPLE

Copyright (c) 1993 Apple Computer, Inc.  All rights reserved.

This simple sample shows how to make a serial connection with a simple protocol
implemented. In order to test this app you need to have the Newton connected
to an outside source, such as a computer with a terminal emulator running,
and you will control the protocol by typing commands in the terminal window
and Newton will respond. Of course this is easier if the control is inside an
appplication.

Cables: use the same cable for this as for the tethered Newton to Macintosh
connection. If you use another platform, use a null modem cable.


CONFIGURATION INFO
This package works *only* with NTK 1.0b6 or later releases.

The terminal emulator should be set for 9600bps, 8 bit no parity, XON/XOFF.

THE PROTOCOL.

After the Connect button is pressed, the Newton will be waiting for an ACK? from the
terminal emulator-side.  Newton will then respond with ACK!.

After this you could send the following strings to Newton and it will respond:

BYE! -> Disconnects and Disposes the serial endpoint-- reconnect with Connect button
CARD! -> Newton will return parts of the card soup, strings separate by CR+LF
NAME! -> Newton will return the owner name as a string
SIZE! -> Newton will return available RAM size in bytes (string)
SEND! -> Newton responds with CR+LF, then waits for a pseudo-Inspector command such
as  playsound(@4) followed by the ">" right arrow char.  Newton attempts to compile and call
the command, catches and displays exceptions if it can't.

Example:
    SEND!
    Ticks()>
    19837
    SEND!
    playsound(@4)>
    TRUE

USER INSTRUCTIONS

1. Open up the terminal emulator (make sure local echo is on)
2. Start the Newton app
3. Hit Connect on the Newton side (now Newton will start waiting for an incoming ACK?).
4. Type ACK? on the terminal, you should immediately get back ACK! from Newton.
5. Type various other commands, and you should get input from the Newton.

Here's an example of a simple session:
ACK?ACK!CARD!Walthrop,Royce,Hillsdale
Thomas,Linda,Newton
Anderson,Bob,Fine

NAME!Jill UK  (You have to have something stored in the name preferences!)



MISC OTHER STUFF

The 'Newton Serial Connection' is a Clarisworks 2.0 communication file with all the
parameters for comms toolbox setup. Note that you need the serial tool in order to
get things working.

Bugs? I'm sure this one has bugs -- report those to us.