home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
kermit.columbia.edu
/
kermit.columbia.edu.tar
/
kermit.columbia.edu
/
archives
/
msr313src.zip
/
msvz10.doc
< prev
next >
Wrap
Text File
|
1991-03-18
|
8KB
|
162 lines
File MSTZ10.DOC 28 Jan 1991
DRAFT DRAFT
Documentation for MSKERMIT Version 3.0 for the Heath/Zenith-100.
This short document only describes special features for this specific
implementation for the Z-100. For general Kermit information, please refer to
KERMIT.DOC, MSKERMIT.DOC and MSKERMIT.HLP etc.
This issue corrects several serious problems with buffer overruns when using
large packets and/or windowing. It also includes improvements in the areas of
screen writing speed and handling of escape codes for the S-100 ports.
Further, the screen is now saved, when leaving terminal mode and restored upon
reentry of terminal mode. This is particularly nice for the use of HELP or
SHIFT-HELP. A one screen (26 line) scrolling function has also been added.
Work is slowly going on to implement VT100 terminal emulation, full multipage
scrolling and colors. It takes time, however. I hope I will have it finished
before all Z-100s but mine are scrapped.
NOTE!! Using the US Robotics S-100 ports, at 1200 baud only,
this Kermit implementation may lose the first character
on the line if run at the original lower clock frequency
of the H/Z-100. If run at 7 MHz or above there should be
no problem. The easy fix is to tell the host to use one
null character at the beginnig of each new line. (For
VAX VMS use "set terminal/lf=(1)")
Implements:
1. Set terminal Heath-19, set terminal None
2. Set port com1/com2/com3/com4 or 1/2/3/4 or J1/J2 or A/B (Note com1=1=J2=B,
com2=2=J1=A)
3. Support for 2 US Robotics S-100 modems at ports com3/com4 (com3 port
address 0020H, com4 port address 002EH)
4. Buffered port input and xon/xoff handshaking in terminal mode also for the
S-100 ports (to some extent).
5. Automatic sensing of presence of S-100 modem boards and automatic sensing
of carrier for the boards present.
6. Automatic selection of port
Explanations:
1. The Heath/Zenith-100 terminal inherently supports the VT-52 and the
Heath-19 terminal rules. The current keypad mode is indicated by N or A on
the mode line right after the terminal emulation info.
Separate terminal drivers like zansi.dvd may be used through the command
"ctty ansi" before invoking Kermit which then has to be left in native
terminal mode (set terminal none).
Note, however, that screen writing is done through DOS in this mode and it
is therefore very slow, particularly when performed via ANSI.
The VT52 keys PF1 (Gold) to PF4 are mapped onto the top four keys of the
shifted keypad, the VT52 - key onto the shifted down arrow and the VT52,
key onto the shifted minus key. This makes the keypad (numeric and
application mode) close in function to the VT52 keypad.
2. The H/Z-100 computer has two serial ports designated J1 or A and J2 or B.
Because the B port is of the DTE type and is the primary modem port, port B
or J2 is designated com1 or port 1.
Use the command set port ? to get help. The basics are as follows:
- set port com1, set port 1, set port B, set port J2
All activate communication over J2 at the current (as set with cofigur)
AUX baud rate and parity.
- set port com2, set port 2, set port A, set port J1
All activate communication over J1 at the current AUX baud rate and
parity.
- set port com3, set port 3 (address 0020H)
All activate communication over the first S-100 port at the current baud
rate and parity. Default is 1200 baud.
- set port com4, set port 4 (address 002EH)
All activate communication over the second S-100 port at the current
baud rate and parity. Default is 1200 baud.
3. The US Robotics S-100 modem is not interrupt driven, so the port has to be
polled and care has to be taken not to loose characters when doing other
things like screen output and disk transactions. -- See 4. below.
4. When, in terminal mode, the escape sequencies ESC-E or ESC-J are sent to
the screen or disk writing is done, characters will be lost unless special
steps are taken by the software.
The two special escape sequencies mentioned are broken down into smaller
steps for the screen handler and the port is polled in between these steps.
(ESC-E = ESC-H + ESC-J, ESC-J = ESC-K + possibly CR + a number of LF +
ESC-K combinations)
During disk capture disk writing the host is told to stop sending (xoff),
a delay to cover for transmission delays follows, then the disk capture
buffer is written after which the host is told to continue (xon). The port
is polled from the sending of xoff until the end of the delay and the
received characters are put in a buffer. The disk capture buffer is only
128 bytes long, so there will be a pause for every 128 bytes.
The pause duration may be varied by setting the receive timeout parameter
(set receive timeout) to some value other than the default. 0 results in
no delay, the default of 5 gives less than half a second and the maximum of
94 a few seconds. I have adjusted the timing to work reliably over normal
telephone lines with a VAX as a host. You may be able to speed up by
setting the timeout value as low as 1. On the other hand, if computers
further away in a network are hosting or if satellite communications are
involved you may have to adjust the timing upwards.
5. The testing for presence of S-100 modems and carriers for these takes
place when Kermit is started and a message is issued to inform the user.
I have found the automatic sensing of S-100 modems to work reliably.
There is a possibility, however, that other boards at the addresses in
question will interfere with this function.
6. Default port is in priority sequence:
- Port 3 if carrier detected there
- Port 4 if carrier detected there
- The port designated AUX
7. Use the command show key to find out exactly how the keys are mapped.
For your conveniance, here are the most important ones.
- Most function and special keys provide normal Z-100 escape sequences
- F12 toggles the terminal printer on/off.In native mode use CTRL-P.
- SF12 (dump screen to printer is not available to Kermit)
- SF11 dumps screen to a file (default kermit.scn)
- F11 enters video memory screen scrolling, 26 lines; use Back Space and
Line Feed keys to scroll and Return key to "freeze" position; any
other key to restore
- HELP displays the connect help message
- SHELP displays the status message
- The shifted top 4 numeric keypad keys) provide VT52 PF1 (gold) to PF4
8. Known shortfalls, bugs and potential problems
- Windowing does not work well for the S-100 modems, COM3 and COM4,
obviously because these modems are not interrupt driven. The windowing
routines eat cpu time in chunks too big to allow proper port polling
(unless the code in the 'generic' source files is modified).
- The screen sometimes 'tears' when entering terminal mode (defect in
atsclr). This is cosmetic only.
- Show modem only partially supported due to hardware limitations. Avoid
untested and unproven use of SHOW MODEM and WAIT \CD, \DSR. Ports 1 and
2 support \CD and \DSR, ports 3 and 4 only \CD.
- VT52 type printer control is not supported.
- Set term none will set key off and set term Heath will set key on.
(Set term will not follow set key on/off)
- Screen scrolling, beyond F11 above, is not implemented.
- Certain character translation features are implemented. These features,
however, are completely untested at this time.
Good luck using Kermit
Bo Gedda