home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
World of Ham Radio 1997
/
WOHR97_AmSoft_(1997-02-01).iso
/
rtty
/
rtty_01
/
amsoft.iii
next >
Wrap
Text File
|
1997-02-01
|
102KB
|
2,577 lines
ACB
Radio Teletype Program
For The IBM Personal Computer
Version 1.2E
12-18-1985
Glenn E. Welman - KF4NB
3301 Pastern Ct.
Lexington, Ky 40513
(C) Copyright Welman Software 1983, 1984, 1985
IBM PC RTTY Ver 1.2
Contents
Introduction ........................................... 1
Distribution Guidelines ................................ 1
Summary of Version 1.2 changes ......................... 2
Summary of Version 1.2A changes ........................ 3
Summary of Version 1.2B changes ........................ 3
Summary of Version 1.2C changes ........................ 3
Summary of Version 1.2D changes ........................ 4
Summary of Version 1.2E changes ........................ 4
Program Operation ...................................... 5
System Requirements .................................... 6
Features ............................................... 7
Special Keys .......................................... 10
Function Keys ......................................... 14
General Funtion Keys ................................ 14
Function Key Set 1 .................................. 15
Function Key Set 2 .................................. 17
Program Files ......................................... 19
Required Files ...................................... 19
Optional Files ...................................... 20
Utility Program ....................................... 32
BASIC Compiling HELP .................................. 33
Compiling the RTTY program ............................ 33
Compiling the RTTYU program ........................... 33
Getting and Assembling the RTTYSUBS program ........... 34
Interface Information ................................. 35
Interface Signals ..................................... 35
Kantronics 'The Interface' information ................ 36
Kantronics RS-232C Interface Schematic ................ 37
A terminal unit design compliments of Bob Austin, N4CLH 39
Contents ii
IBM PC RTTY Ver 1.2
INTRODUCTION
This program runs on the IBM Personal Computer and
interfaces to your Amateur Radio equipment through the
Asynchrounous Communications adapter. I wrote the program
to be as flexible as possible hoping that it will be
useable with any Terminal Unit (TU) and radio combination.
I have attempted to provide enough information to help you
make your system operational. The program will work on the
IBM PCjr with one minor limitation which is explained
further on in this document. I suspect that the program
will also work on the IBM Portable PC, most PC clones and
possibly the IBM PC AT, even though I have not had the
opportunity to test the program on those machines.
I intend for the program to be distributed by hams, rather
than retailers. I suggest the following.
DISTRIBUTION GUIDELINES
Please share (copy) the program with others who are
interested in RTTY.
Do not sell or barter the program to anyone. (That's my
right!)
When you pass along the program, include only the
original unmodified version.
Send a SASE along with your current version number and
I will let you know if any known problems have been
fixed by a later version.
Don't remove these guidelines from the program or
document.
If you find the program of value, a small contribution
for my effort will be appreciated ($25 suggested).
Introduction 1
IBM PC RTTY Ver 1.2
SUMMARY OF VERSION 1.2 CHANGES
■ Capability to clear the transmit buffer.
■ Capability to save the transmit buffer, clear it and
later restore it.
■ Up to 10 filenames can be specified for easy loading
into the transmit buffer from diskette.
■ The screen can now be used in color instead of white
only. The colors can be modified to your own taste.
■ The program can now handle any oscillator frequency
input to the 8250 Async chip. (e.g. The PCjr's
frequency is different from the PC.)
■ There are now separate baud rates for Baudot and ASCII
modes. Additional baud rates can be user specified for
extended flexibility.
■ Several enhancements have been added for our European
friends
- The European date format is supported. (e.g.
15.Nov.1984)
- 100 and 200 baud rates are now in the default ASCII
set.
- The column for the warning beep is 56 and there is
an automatic CR/LF at column 64. These values can
be changed and the automatic CR/LF turned off.
- The Baudot character set is modified to support the
European standard.
■ Several characters have been defined to support unique
ASCII to Baudot conversions for MARS useage.
■ The ASCII to Baudot and Baudot to ASCII conversion
tables can be modified at program startup time to
support unique conversions.
■ The title screen will now go away after 10 seconds or
after the first keystroke.
■ The default time type can be specified in the
"PARMS.RTY" file and no prompting will occur.
■ The operation of the DTR and RTS outputs can be user
specified for transmit and receive.
Introduction 2
IBM PC RTTY Ver 1.2
■ The number of ASCII data bits, parity bits and stop
bits can now be specified.
■ SELCAL has been implemented for unattended monitoring
operations.
■ A simple QSO logging capability has been added.
SUMMARY OF VERSION 1.2A CHANGES
■ Added MARS keyword support to the PARMS.RTY file
processor.
SUMMARY OF VERSION 1.2B CHANGES
■ Redefined some MARS special characters for ASCII to
Baudot translation.
■ Fixed a bug, in ASCII mode "+" would be sent 12 times,
now it is sent only once.
■ Enhanced the setting of baud rates in the PARMS.RTY
file. You can now specify the rates positionally (you
define the order).
SUMMARY OF VERSION 1.2C CHANGES
■ Fixed bug when a transmit file with blank lines was
sent, two line feeds were sent for each blank line.
■ Fixed a bug in receive mode, with unshift on space
turned on, the program assumed an automatic unshift
with CRs and LFs.
■ Provided a method to make the program start up in the
ASCII mode.
■ Added the capability to specify the parms filename on
the command line.
■ Provide some special support for packet radio users.
Introduction 3
IBM PC RTTY Ver 1.2
■ Enhanced the MARS support to include the automatic
sending of 12 letters functions when "NNNN" is sent.
SUMMARY OF VERSION 1.2D CHANGES
■ Made a change to the handling of blank lines. Changed
the default to always send carriage return and line
feed for blank lines. If you only want line feeds for
blank lines then specify "BLLF" in the parameter file.
SUMMARY OF VERSION 1.2E CHANGES
■ Fixed the scroll routine to handle foreground and
background colors.
■ Changed the program to allow a greater range of
foreground and background colors.
■ Added the capability to specify the SELCAL end string
and added an alternate string capability.
■ Provided to start the program in the ART mode and/or in
the unshift-on-space mode.
■ Added the capability to inhibit the bell (beeps) in the
ART mode.
■ Added some enhancements for packet operation. Packet
starts up in the transmit mode. You can specify a
string to send the current time and date to your TNC.
You can inhibit sending of the time and date on
power-up and send it later with the use of the alt-D
character. You can let the system send a note that you
are not around and then save data to a file for stored
messages.
■ I put the scrolling routine assembler source code in
the BAS file so there would be one less file to send
and keep track of.
Introduction 4
IBM PC RTTY Ver 1.2
PROGRAM OPERATION
The program is started by placing the program diskette in
the default drive (usually drive A:) and entering
RTTY or RTTY filename
In the above example, "filename" is the name of the
paramater file to use instead of "PARMS.RTY". This feature
allows multiple runtime configuration files to be used for
various operation modes. This and other files should be
personalized prior to running the program with your
callsign and other pertinent information. These files are
identified further on in this document and may be changed
with any text editor. The program is primarily written in
BASIC and compiled to acheive a useable operating speed.
There is one subroutine written in Assembly Language to do
things which I can't do well in BASIC. Specifically, the
routine scrolls half screens for the receive and transmit
screens.
The program takes advantage of the IBM Personal Computer's
capabilities. The interrupt capabilities of the
Asynchrounous Communications adapter and the keyboard allow
many things to occur simultaneously without the loss of
information. The use of DOS files allows the storage and
retreival of a large supply of RTTY data. I hope you find
the program's many features useful.
In version 1.2 I have tried to make the program a little
more flexible. The price that is paid for flexibility is a
little more complexity in setup. One of the changes is to
allow the use of the program on the IBM PCjr. The PCjr has
a slightly different input frequency to the 8250 Async chip
and it does not have DMA (direct memory access) during
diskette operations. The significance of no DMA is that
data through the Async port will stop during any diskette
accesses. Specifically, if you are sending the received
data to a diskette file, then about every 500 characters
there is a chance of missing one or more received
characters. During some tests which I performed with a
5200 character test file, 2 characters were dropped at 45.5
baud (BAUDOT mode), 8 characters were dropped at 74 baud
(BAUDOT) and 110 baud (ASCII), 28 characters were dropped
at 300 baud (ASCII) and 35 characters were dropped at 1200
baud (ASCII). Note that this is a hardware limitation as
noted in the PCjr Technical Reference. Characters are only
lost when received characters are placed in a diskette
file, all other operations of the program are functional
with no known problems.
Program Operation 5
IBM PC RTTY Ver 1.2
SYSTEM REQUIREMENTS
An IBM Personal Computer with at least 128K bytes of
memory and a minimum of one diskette drive or a true
IBM PC compatible computer.
An IBM Personal Computer Asynchrounous Communications
Adapter or equivalent. Note that for the compiled
BASIC program to work correctly, the Async adapter must
use an 8250 UART chip mapped into the same I/O address
space and interrupt level as the IBM PC version.
IBM Personal Computer Disk Operating System (DOS)
version 1.1 or later (or equivalent).
A Terminal Unit (TU) for amateur radio teletype (RTTY)
applications. Or a packet terminal node controller
(TNC) for packet radio operation.
A radio receiver or transceiver capable of operating
RTTY.
Program Operation 6
IBM PC RTTY Ver 1.2
FEATURES
The program will run under DOS 1.1 or later.
The program will run on a monochrome display and both
the 80X25 and the 40X25 mode on a color display.
The program runs in a split screen mode with received
data displayed on the top half and the transmit buffer
displayed on the bottom half of the screen.
Run time information is displayed in the center of the
screen, such as current time, date and elapsed time
since the last TTY ID was sent.
Prompts for operator input are also displayed in the
center of the screen.
The definition and status of the function keys is
displayed at the bottom of the screen.
Errors and informational messages are also reported at
the bottom of the screen.
In transmit mode the program sends CR, CR, LF, and
letters at the end of a line. This provides some
degree of compatiblility with the old mechanical
teletype machines.
The program supports both BAUDOT and ASCII RTTY modes.
■ Common BAUDOT rates of 60, 67, 75, and 100 WPM are
supported. Those are baud rates of 45.5, 50, 56.9,
and 74.2 respectively.
■ Common ASCII baud rates of 100, 110, 200, 300, 400
and 1200 BAUD are supported.
■ Additional baud rates can be user specified in the
"PARMS.RTY" file up to a maximum of 10 rates on
both modes.
The received input goes to the display and can be
directed to the printer and/or a DOS file. File
compression is supported which can result in using less
diskette/disk file space.
While you are receiving, you can fill a 4000 character
transmit buffer from the keyboard or DOS files.
Program Operation 7
IBM PC RTTY Ver 1.2
While the program is prompting you for information,
received characters are placed into a 4000 character
receive buffer. If more than 4000 characters are
received while the program is prompting you, a
communications buffer overflow error will result. The
program will attempt to recover as much as possible.
There are several predefined files which can be loaded
into the transmit buffer with the stroke of a function
key. Up to 10 files can be user defined to be loaded
into the transmit buffer with the use of the "Alt" and
numeral keys. Up to six files can be qued to be placed
into the transmit buffer at any one time.
A cursor is displayed at the current Transmit buffer
location. When the cursor reaches column 56, the
program will sound a beep. The user can define a new
warning column and can specify an ending column with an
automatic CR/LF insertion.
The transmit buffer can be edited minimally by using
the backspace key. There is no full screen support.
In the transmit mode, a date and time stamp can be sent
over RTTY, as well as, a predefined RTTY ID field.
There is a key defined to allow the storage of the
callsign of the other station in the QSO. The contents
of this storage field will be placed at the beginning
of the TTY ID when it is selected. This buffer can be
changed at any time.
The transmit buffer is filled first by any transmit
files, second by characters resulting from special
keys, and finally from keyboard input. The program
will stop placing characters in the transmit buffer
when it is full and will resume as characters are
transmitted from the transmit buffer.
A special Baudot mode can be selected for European
useage.
Program Operation 8
IBM PC RTTY Ver 1.2
Some special characters have been defined for ASCII to
Baudot translation for the MARS program. These
characters and their meanings are as follows
* causes a carriage return to be sent
= causes a line feed to be sent
+ causes 12 letters characters to be sent
@ causes the bell character to be sent
\ causes the null character to be sent (&H00)
> causes the figures character to be sent
< causes the letters character to be sent
Note that these characters may not operate correctly in
the European mode.
An additional MARS mode reduces the end-of-line
function to CR, CR, LF and does not send a letters
character automatically at the end-of-line or on the
space character.
SELCAL is now supported to automatically print or store
received signals when a user specified sequence of
characters is received.
The transmit buffer can be cleared or stored for those
times when you really want to send something other than
what's in the buffer.
A limited logging function can be executed with the use
of a few keystrokes. You will be prompted for
pertinent information and it will be placed on
diskette.
When multiple blank lines are sent, the program only
sends line feed characters to speed things up.
Carriage retruns are not sent for blank lines.
Special support has been added for packet radio
controller support. I implemented a few things for use
with my Kantronics Packet Communicator. I believe that
these are compatible with most TNCs on the market which
follow the TAPR command structure. There is a DAY
command to set the clock in the TNC. The program will
also send a message when you are away from the
keyboard.
Program Operation 9
IBM PC RTTY Ver 1.2
SPECIAL KEYS
Backspace - Pressing the backspace key erases the last
character entered into the transmit buffer and the
cursor backs up. If the last character was a line
feed, the cursor backs up to the previous line and the
character is displayed in reverse video. When you
backspace beyond the top line of the transmit screen,
the previous line entered into the transmit buffer
appears on the top line. Lines prior to the line at
the top of the screen are not visible. Note that you
cannot back up beyond the last character sent to the
Asynchronous communications adapter.
ENTER - Pressing the "ENTER" key at the end of a line
causes a carriage return and line feed to be placed
into the transmit buffer.
Cntl E - Cntl E is a new added feature. Typing a Cntl
E into the transmit buffer will cause the program to
automatically return to the receive mode upon reading
the Cntl E from the transmit buffer. Additional
transmit buffer contents are retained but not
transmitted until the XMIT mode is entered again. This
should be useful when you are transmiting a long file
and you want to take a break and may not make it back
in time to switch it over manually.
Ctrl S - Pressing Ctrl S causes the program to prompt
you for a line of characters which will be stored for
later retreival. The information is kept in memory
until the program is ended or another Ctrl S is
entered.
Ctrl R - This is the companion key of Ctrl S. Pressing
Ctrl R retrieves the stored line and places it in the
transmit buffer.
Ctrl W - Ctrl W is pressed to instruct the program to
place only a carriage return in the transmit buffer.
Pressing the "ENTER" key immediately after a Ctrl W
will be ignored by the program. Pressing a character
key will result in an overprint condition. The Ctrl W
key will find primary application in sending RTTY art.
This character is placed in the receive file for any
carriage return. An idea of what character may be
displayed by various editors can be found in appendix C
of the Technical Reference manual.
Note that the absence of the Ctrl W/Ctrl T at the end
of the line will result in the normal end of line
processing which send CR, CR, LF and ltrs.
Program Operation 10
IBM PC RTTY Ver 1.2
Ctrl T - Ctrl T is the companion of the Ctrl W key and
results in a single line feed being placed in the
transmit buffer. Pressing "ENTER" immediately after a
Ctrl T will be ignored by the program. The Ctrl T key
will be used in RTTY art and may be used to replace a
line feed erased by backspacing. This character is
placed in the receive file for any line feed. An idea
of what character may be displayed by various editors
can be found in appendix C of the Technical Reference
manual.
Note that the absence of the Ctrl W/Ctrl T at the end
of the line will result in the normal end of line
processing which send CR, CR, LF and ltrs.
Ctrl X - Ctrl X is provided to force the sending of the
"Figures" character in Baudot mode only. This key
could be useful in send a SELCAL prefix. This key will
appear in the transmit buffer as a up arrow.
Ctrl Y - Ctrl Y can be used to force the sending of the
"(ltrs)" character in BAUDOT mode only. This key can
also be used in sending a SELCAL prefix. This key will
appear in the transmit buffer as a down arrow.
Alt A - Alt A can be used to toggle between the Art
mode and the No Art mode. Art mode is for overstrike
lines to darken (fill in) the print. Note that
multiple strikes are visable only on the printer, not
on the display. The No Art mode is used for noisy
conditions (primarily text) where you want a CR/LF any
time a CR or LF is received for maximum copy. The
status of the Art mode is included at the bottom of the
screen in the receive mode. Art mode is indicated by
an "A" beside "RECV" and the No Art mode is indicated
by an "N". At program start the default is the No Art
mode. The "BELL" file on the diskette is an example of
RTTY Art.
Note that files which are received in the Art mode will
have Ctrl-W and Ctrl-T characters in the file. Files
received in the no Art mode will not contain the Ctrl-W
and Ctrl-T characters.
Alt C - This option can be used to clear the transmit
buffer. The buffer is cleared, all loading from
diskette files is stopped, and you can start again with
a clean slate.
Program Operation 11
IBM PC RTTY Ver 1.2
Alt D - This option will send the current time and date
over the Async port in the format specified by the PDAT
keyword. The PDAT keyword is relatively free format to
allow for different TNC implementations. See the
PARMS.RTY description for additional details.
Alt T - This option saves the transmit buffer in a file
named "TXBUFFER.RTY" and then clears the transmit
buffer just like the "Alt C" option. If the transmit
buffer was previously saved (this session) it will
first clear the transmit buffer and then load the file
"TXBUFFER.RTY". Note that once the file has been
restored it will reset the flag indicating that the
transmit buffer was previously saved.
Alt S - Alt S is used to toggle the SELCAL (Selective
Call) option on and off. When the SELCAL option is
turned on, you will be prompted to find out if you want
to send the selected data to the printer or diskette.
A filename will be asked for when the diskette option
is selected. A message will appear at the bottom of
the screen when the option is turned off. The
character string to search for to start saving the data
can be specified in the "PARMS.RTY" file. Because
there is no letters or figures character in ASCII, I
have included the capability to specify a separate
SELCAL ID for both the BAUDOT and ASCII mode. SELCAL
saving is terminated by the receipt of the sequence
"NNNN".
Alt L - This option will place information into a
logging file with a filename of "LOG.RTY". You will be
prompted for the callsign of the station worked and for
any other pertinent data. You may want to include such
things as signal reports, frequency, names and so on.
The date, time and your data will be appended to the
"LOG.RTY" file.
Alt N - This option toggles the not-at-keys
enable/disable flag. The current status is displayed
on the error line for approximately 5 seconds. When
turned on, the program will send the file "AWAY.MSG"
when a string is received which matches the NKEY
string. All incoming data will be stored in the file
"WHILE.OUT" or the already active received data file.
This option is primarily for packet use.
Alt 0-9 - This key sequence will load the file defined
in the "PARMS.RTY" file corresponding to the file
numbers 1 to 10. If the filename has not been
specified, then no action will be taken.
Program Operation 12
IBM PC RTTY Ver 1.2
Note that some of the special keys may be the same as the
control keys for some TNCs. The RTTY program will take
action on the special key and will generally not pass any
code over the Async line. To circumvent the inherent
problem, my suggestion is to respecify the control key to
the TNC, making sure that you do not pick another RTTY
special key.
Program Operation 13
IBM PC RTTY Ver 1.2
FUNCTION KEYS
The ten function keys are used during program operation to
direct the flow of information in the computer system. The
definition and status of the function keys is displayed at
the bottom of the screen. The function keys are defined as
follows:
General Funtion Keys
F1 - KEYS
This key toggles the definition of function keys 3
through 10 and changes the status line.
F2 - RECV/XMIT
This key toggles the program between receive mode
and transmit mode. When the program begins, this
key defaults to RECV. When the key is pressed to
go from XMIT to RECV, the program will wait until
the basic communication buffer is empty before
returning to the RECV mode. BASIC buffers up to
128 characters independent of the program. So
don't get too anxious if the transmitter doesn't
stop immediately.
There is a short delay of about one half a second
from the time the program turns the transmitter on
and the first data is sent. This should give the
other station a chance to lock onto your signal.
Additionally, an A or N will appear with RECV to
indicate the current status of the Art mode (See
Alt A for additional information).
Program Operation 14
IBM PC RTTY Ver 1.2
Function Key Set 1
F3 - RX FLE
Receive a File. Pressing this key prompts you for
a filename in which to place the received
information. The information is appended to the
file. Pressing only "ENTER" results in no file
being opened. Pressing this key while a file is
currently open will close the file. Another
filename must be entered to continue saving data.
Entering the same name as an existing file will
result in that data being appended to the file.
When a filename is entered, you are asked if you
want the file to be saved as a compressed file.
Compressed files will take up less room on your DOS
diskette, but are not readily alterable in an
editor. A utility is provided to decompress or
compress a file offline.
When a receive file is open, a reminder is
displayed on the center line of the screen. The
form of the display is "RX-filename".
F4 - UOS ON/UOS OF
This key toggles between "Unshift On Space" being
turned on and turned off. This key only applies to
received data. When "unshift on space" is on, the
program will shift back to "letters" mode any time
a space is received.
Independent of this key, the program will transmit
a "(ltrs)" character in the BAUDOT mode as required
with a space. This makes the program compatible
with either type of teletype which may be in the
other station. When the program begins, this key
defaults to UOS OF.
F5 - END
This key provides a means to terminate the program
gracefully. You will be prompted for confirmation
of your request to quit.
Program Operation 15
IBM PC RTTY Ver 1.2
F6 - PRT OF/PRT ON
This key toggles output to the printer on and off.
When PRT ON is displayed, all characters received
will also be printed on the matrix printer. Bell
characters are not sent to the printer to keep down
the noise pollution. When the program begins, this
key defaults to PRT OF.
F7 - Baud Rate Selector
This key toggles through the baud rates supported
by the program. The status line is updated with
each change. In Baudot mode, the baud rates of
45.5, 50.0, 56.9, and 74.2 correspond to character
rates of 60, 67, 75, and 100 words per minute (WPM)
respectively. When the program begins, this key
defaults to 45.5.
For ASCII the baud rates of 100, 110, 200, 300,
400, and 1200 are supported. When the ASCII mode
is selected this key defaults to 110 baud.
Up to 10 baud rates per mode are possible by adding
baud rates through the use of the BAUD and ASCI
options of the "PARMS.RTY" file. The default rates
can also be changed.
F8 - BAUDOT/ASCII
This key toggles between Baudot and ASCII modes.
Any combination of baud rate and mode is
obtainable. When the program begins, this key
defaults to BAUDOT unless specified otherwise in
the parms file. Each time this key is pressed, the
baud rate selection will change to the first baud
rate for that mode, the default if 45.5 baud for
Baudot and 110 baud for ASCII.
F9 - NEW LN
This key provides the ability to force a CR/LF (new
line) in the middle of received text. Such an
operation might be needed if the original CR/LF
were lost in the noise.
F10 - LTRS
This is the "letters" key. During Baudot reception
it is occaisionally desirable to force the receive
mode back into the "letters" mode. This key
accomplishes that task.
Program Operation 16
IBM PC RTTY Ver 1.2
Function Key Set 2
F3 - TX FLE
Transmit a File. Pressing this key allows the
contents of a DOS file to be placed into the
transmit buffer for transmission. You will be
prompted for the filename of the file to transmit.
Pressing just "ENTER" will result in no file being
transmitted. Entering the word "stop" will cause
the current file being processed to be closed.
The filename is placed in a buffer que which will
eventually be opened and read. This allows for
placing several transmit files into the transmit
buffer in sequential order. The filename of the
file currently being read is displayed on the
center display line. The form of the display is
"TX-filename".
If an error is encountered in opening the file, an
error status is displayed for about five seconds at
the bottom of the screen and a beep is sounded.
Note that the program will not handle tab
characters. The file should contain spaces to get
to the correct column. For example, if the file is
created using the Personal Editor program, be sure
to use the "notabs" keyword when the file is
saved.
F4 - TX CQ
Transmit a CQ. Pressing this key causes the file
"CQ.RTY" to be loaded into the transmit buffer.
This file is qued just like a transmit file and is
displayed on the center screen. Note that you must
personalize the "CQ.RTY" file with your callsign
and name.
F5 - RESET
This is the reset key. Pressing this key will
close all transmit files, clear the screen and
start the program over. There is no prompting to
make sure you mean it. Note, BASIC sometimes
decides to clean up the string area at the most
inappropriate times. When it does this, the system
may appear to lock up for several seconds (maybe
many), so try to be patient.
Program Operation 17
IBM PC RTTY Ver 1.2
F6 - TX RYS
Transmit RYs. Pressing this key will result in the
"RYS.RTY" file to be placed into the transmit file
que and eventually into the transmit buffer. This
is handy for placing a bunch of RYs at the start of
your transmission, which gives the guy at the other
end a chance to lock back onto your signal.
F7 - PSE OF/PSE ON
Transmit Pause Off / Transmit Pause On. This key
is used to temporarily stop the program from
sending any more characters out of the transmit
buffer. This is useful for sending a steady
carrier signal for tuning purposes or whatever. It
should be noted, that BASIC can buffer up to 128
characters. These characters cannot be stopped
from being sent. Thus, you may not be able to make
the program pause exactly where you want. When the
program begins, this key defaults to PSE OF.
F8 - TTY ID
Teletype ID. Pressing this key causes the contents
of the "TTYID.RTY" file to be placed into the
transmit buffer. The contents of the QSO ID buffer
is placed at the beginning of the line. Note that
this line of data is read from the file at the
beginning of the program and stored in program
memory. Also note that the "TTYID.RTY" file must
be personalized with your name and callsign. The
little block at the end of the TTYID when it is
placed in the buffer is used by the program to
reset the time since last ID.
F9 - QSO ID
This key prompts you for an entry of the current
QSO station id. The data entered is placed at the
beginning of the TTY ID when that key is pressed.
F10 - DT&TM
Date and Time stamp. This causes the current date
and time to be placed into the transmit buffer.
Note that the time sent is the time the key is
pressed, not the time the characters are actually
sent.
Program Operation 18
IBM PC RTTY Ver 1.2
PROGRAM FILES
There are three files which the program expects to find on
the default DOS drive. If any of these files are absent
when they are accessed, an error message will be
displayed. There is also an optional file which may be
absent with no adverse effects. There are also two files
which will be created if absent and will be written to by
the program. The files are described below.
Required Files
TTYID.RTY - This file is required to have one line
only. The line contains the characters to be placed in
the transmit buffer for your RTTY ID (e.g. DE KF4NB
"GLENN" IN LEXINGTON, KY). Note, you must personalize
this file with your callsign, name, location and
whatever.
CQ.RTY - This file contains all the information you
would like to send for a RTTY CQ. Note, you must
customize this file with your callsign, name, and
location. You may optionally change the format of the
CQ. This file may contain any number of lines.
RYS.RTY - This file is simply a line of RYs which will
be sent in response to a function key being pressed.
This file could be changed in just about any way you
desired. Multiple lines are allowed.
Program Operation 19
IBM PC RTTY Ver 1.2
Optional Files
LOG.RTY - This file will be appended to by the "Alt L"
command. The information placed in the file is the
date, time, Station ID worked and your comments. If
the file does not exist, a new file will be created.
TXBUFFER.RTY - This file will be created or read by the
"Alt T" command. The transmit buffer will be dumped
into the file on the first use of the "Alt T" command
and the file will be reloaded into the transmit buffer
on the second occurance of the "Alt T" command.
AWAY.MSG - This file is the file which will be sent
when the not-at-keys string is received. This is
primarily intended for packet operation to allow you to
tell someone to leave you a message when they
connect. All received input up until the time the end
string is received (disconnect) will be placed into the
file "WHILE.OUT". Both the start and stop strings can
be user defined.
PARMS.RTY - This file can have one or more of the
following keywords on a single line separated by commas
or on separate lines. The first three or four
characters of the words are compared and when a match
is found, the pertinent information is obtained from
the text string. Any extra information between commas
or at the end of the line is ignored.
The filename can be overridden by specifying the
alternate filename on the command line (e.g. RTTY
ASCII.RTY). The contents of the file may be any valid
keywords for the PARMS.RTY file. When an alternate
filename is specified on the command line, the program
will prompt for a new filename anytime during that
session that the RESET key is used. This allows the
user to switch back and forth between operating sets if
so desired.
As the file is processed, each parameter specification
is displayed on the screen. When the file has been
processed, the program will wait approximately three
seconds and then clear the screen and continue. This
waiting period can be bypassed by pressing any key.
During processing of the file any parameters which are
incorrectly specified will be displayed on the screen
and the program will wait for you to press "Enter" to
continue.
Program Operation 20
IBM PC RTTY Ver 1.2
AGSL - This keyword is used to set the general
SELCAL search string for ASCII mode selection. The
format is AGSL=QST. Up to 10 characters can be
specified. The default is "QST".
ALCR - This keyword can be specified to override
the default value put into the ASCII Line Control
Register of the 8250 Async chip. This value will
determine format of the ASCII data. It controls
the number of data bits, the number of stop bits,
use of the parity bit and the type of parity if
used. The format of the option is ALCR=&H3E. The
default value is &H3E, which sets the ASCII mode to
7 data bits, 2 stop bits and parity bit stuck low.
Further information on the possible values of this
parameter can be found in the Technical Reference
Manual.
ART - This keyword allows you to start the RTTY
program in the ART mode. If it is not specified
the program defaults to NoART mode.
ASCI - This keyword is used to add extra values to
the ASCII baud rate selection list. The format is
ASCI=nnnn where "nnnn" is any baud rate number you
want to be able to run. Up to 10 baud rates are
allowed. A second form of the keyword allows you
to redefine the baud rate for any of the rates in
the list (even the default values). The format is
ASCIxx=nnnn where "xx" is a number from 1 to 10 and
"nnnn" is the desired baud rate. The number "xx"
must correspond to a previously defined rate or
just one more than the total number of rates
defined.
When the baud rate is specified, the program will
set the 8250 Async chip timer divisor rate to the
closest value to achieve the specified rate. The
divisor rate of the 8250 is set to the integer
value of the crystal frequency divided by the baud
rate. A total of four ASCII baud rates can be
specified. Refer to the Technical Reference manual
for further information on divisor rates.
ASEL - This keyword is used to set the specific
SELCAL search string for ASCII mode selection. The
format is ASEL=KF4NB. Up to 10 characters can be
specified. The default is "??????????".
Program Operation 21
IBM PC RTTY Ver 1.2
ATCR - This keyword is used to turn on the
automatic carriage return and line feed (CR/LF)
option. When this option is on, a CR/LF will be
added to the transmit data if the data reaches
column 64 or the column specified in the LLEN
option. This option defaults to off.
BAUD - This keyword is used to add extra values to
the Baudot baud rate selection list. The format is
BAUD=nnn.n where "nnn.n" is any baud rate number
you want to be able to run. Note that the baud
rate is different from the words per minute rate.
Up to 10 baud rates are allowed. A second form of
the keyword allows you to redefine the baud rate
for any of the rates in the list (even the default
values). The format is BAUDxx=nnn.n where "xx" is
a number from 1 to 10 and "nnn.n" is the desired
baud rate. The number "xx" must correspond to a
previously defined rate or just one more than the
total number of rates defined.
When the baud rate is specified, the program will
set the 8250 Async chip timer divisor rate to the
closest integer value to achieve the specified
rate. The divisor rate of the 8250 is set to the
integer value of the crystal frequency divided by
the baud rate. A total of six Baudot baud rates
can be specified. Refer to the Technical Reference
manual for further information on divisor rates.
BDLW - This keyword provides the capability to
change the Baudot to ASCII conversion table of the
program. The BDLW command is used to specify the
letters mode Baudot character to ASCII character
relationship. The format of the command is
BDLWnn=xxxx. Where "nn" is a number from 0 to 31
representing the 5 bit Baudot code and "xxxx" is
the value of the ASCII character. For example,
"BDLW10=&H52" causes the receipt of a Baudot
character of 10 in the letters mode to be
translated to an ASCII character of &H52 which is
the correct representation of the letter "R". Any
number of BDLW commands may be contained in the
file.
Program Operation 22
IBM PC RTTY Ver 1.2
BDUP - This keyword provides the capability to
change the Baudot to ASCII conversion table of the
program. The BDUP command is used to specify the
figures mode Baudot character to ASCII character
relationship. The format of the command is
BDUPnn=xxxx. Where "nn" is a number from 0 to 31
representing the 5 bit Baudot code and "xxxx" is
the value of the ASCII character. For example,
"BDUP10=&H34" causes the receipt of a Baudot
character of 10 in the figures mode to be
translated to an ASCII character of &H34 which is
the correct representation of the number "4". Any
number of BDUP commands may be contained in the
file.
BDOT - This keyword provides the capability to
change the ASCII to Baudot conversion table of the
program. The BDOT command is used to specify the
ASCII character to Baudot character relationship.
Part of this command requires the capability to
specify if the Baudot character should be sent in
letters mode, figures mode or don't care mode.
This is accomplished by adding 64, 128 or 192
(decimal) respectively to the Baudot character.
This can also be respresented by &H40, &H80, and
&HC0 (hexidecimal). The format of the command is
BDOTnn=xxxx, where "nn" is the value of the ASCII
character and "xxxx" is the value of the Baudot
character with the added value for the proper
mode. For example, "BDOT52=&H8A" causes an ASCII
character of 52 ("4") in the transmit buffer to be
sent as a "figures" followed by a Baudot 10. Note
that if the figures mode was already valid then no
figures character would have been sent. Any number
of BDOT commands may be contained in the file.
BGSL - This keyword is used to set the general
SELCAL search string for Baudot mode selection.
The format is BGSL=(ltrs)N(ltrs)N(ltrs)N where the
"(ltrs)" indicates the letters Baudot character.
Up to 10 characters can be specified. The default
is "(ltrs)N(ltrs)N(ltrs)N". Note that "(ltrs)" is
defined to be "Ctrl Y" and "(figs)" is defined to
be "Ctrl X" during program operation.
BLLF - This keyword is used to suppress the sending
of carriage returns when a blank line is
encountered. Only line feeds will be sent for
blank lines when this option is used.
Program Operation 23
IBM PC RTTY Ver 1.2
BSEL - This keyword is used to set the specific
SELCAL search string for Baudot mode selection.
The format is BSEL=(ltrs)KF4NB where the "(ltrs)"
indicates the letters Baudot character. Up to 10
characters can be specified. The default is
"??????????". Note that "(ltrs)" is defined to be
"Ctrl Y" and "(figs)" is defined to be "Ctrl X"
during program operation.
COLO - This keyword is used to set the values for
the color characters for a color display. The
colors can be further modified independently
through other options of the "PARMS.RTY" file. Any
further changing must occur after the COLO
statement. The default is to black and white
characters.
COM2 - This keyword will cause the program to use
the second async communications adapter for RTTY.
The program default is the first adapter (COM1).
This option may be useful if the first adapter is
primarily used for some other reason such as a
telephone modem or a serial printer. This keyword
must be used with a PCjr if an internal modem
option is installed.
COMM - This keyword should be used with the PCjr.
It specifies the base I/O address of the 8250 chip
(serial port). The default is COMM=&H3F8. For the
PCjr the parameter should be specified as
COMM=&H2F8. If the PCjr also contains the internal
modem option, the COMM keyword must come after the
COM2 keyword in the PARMS.RTY file.
DIDL - This keyword is provided for those folks who
like to send something (even null) while the
transmit buffer is empty. Null characters are sent
about once per second while the transmit buffer is
empty.
DTR - This keyword can be used to specify what
logic level the DTR (Data Terminal Ready) line out
of the Async adapter should be set to for receive
and transmit modes. The format is DTR=xy, where xy
can be 00, 01, 10, or 11. The number corresponding
to "x" is the logic level during receive and the
number corresponding to "y" is the logic level
during transmit. "0" corresponds to a low logic
level and a "1" corresponds to a high logic level.
The default is DTR=01.
Program Operation 24
IBM PC RTTY Ver 1.2
ECHO - This keyword causes each character sent to
the BASIC "COMn:" port to be displayed on the
receiver half of the screen. This option is
provided for those who have TUs which do not place
the transmitted data back onto the receive line
coming back to the computer. The program default
is no ECHO.
Note - BASIC has a 128 byte transmit buffer. When
this keyword is active, the receive screen shows
the character when it is placed into the BASIC
buffer. In other words, just because you see it on
the screen doesn't mean it has been sent yet! The
program contains a check to make sure that the
Async adapter has finished before turning off the
transmitter.
If the receive buffer seems to be repeating
characters while in the transmit mode, then the
most likely problem is that you have specified echo
and your TU is also feeding back into the receive
input. ECHO should be remove from the "PARMS.RTY"
file.
ERRB - This keyword is used to set the error line
background color. The format is ERRB=7. The
defaults are ERRB=7 for the monochrome mode and
ERRB=0 for the color mode. Refer to the BASIC
manual for colors associated with possible values.
ERRF - This keyword is used to set the error line
foreground color. The format is ERRF=0. The
defaults are ERRF=0 for the monochrome and ERRF=12
for the color mode. Refer to the BASIC manual for
colors associated with possible values.
ESEL - This keyword is used to set the specific
SELCAL search string for turning off SELCAL and/or
packet not-at-keys data storage. The format is
ESEL=* DISCON. UP to 10 characters are allowed.
The default is "NNNN".
Program Operation 25
IBM PC RTTY Ver 1.2
EURO - This keyword is used to specify the European
mode. This mode uses the automatic CR/LF option
and changes the Baudot to ASCII conversion table to
fit the European standards instead of the U.S.
standards. The differences are for figures mode
only and are as follows
Baudot European
code character
05 '
09 #
11 bell
13 [
17 +
20 !
26 ]
30 =
Note that any parameter specifications using the
BDLW, BDUP or BDOT commands should occur after the
EURO command in the file.
FILE - This keyword is used to specify the names of
files to be transmitted with the use of the "Alt n"
keys, where "n" is one of the number keys at the
top of the QWERTY section of the keyboard. The
format of the command is FILEnn=filename, where
"nn" is a number from 1 to 10 and filename is any
valid DOS filename. For example, FILE1=PARMS.RTY
will cause the "PARMS.RTY" file to be loaded into
the transmit buffer when "Alt 1" is pressed. Note
that "Alt 0" will cause FILE10 to be loaded. Note
that the file must be in the current directory.
GESL - This keyword is used to set the general
SELCAL search string for turning off SELCAL and/or
packet not-at-keys data storage. The format is
GESL=QUIT. UP to 10 characters are allowed. The
default is "NNNN".
KEYB - This keyword is used to set the keys status
line background color. The format is KEYB=7. The
defaults are KEYB=7 for the monochrome mode and
KEYB=3 for the color mode. Refer to the BASIC
manual for colors associated with possible values.
KEYF - This keyword is used to set the keys status
line foreground color. The format is KEYF=0. The
defaults are KEYF=0 for the monochrome and the
color mode. Refer to the BASIC manual for colors
associated with possible values.
Program Operation 26
IBM PC RTTY Ver 1.2
LLEN - Use this keyword to specify the column at
which you want the end of the line to be. This is
used in conjunction with the ATCR command. The
format is LLEN=nn, where nn is the column number of
the end of the line. The default is 64.
LPT2 - This keyword allows the printer output to go
to the printer attached to the second printer
adapter. The default is the first printer adapter
(LPT1).
LPT3 - This keyword allows the printer output to go
to the printer attached to the third printer
adapter. The default is the first printer adapter
(LPT1).
MARS - This keyword modifies the operation of the
program slightly for compatibility with the MARS
format rules. Specifically, end-of-line processing
is set to CR, CR, and LF. A letters character is
not sent automatically at the end of the line or
after the "space" character if a number preceeded
it. Also the bell character is represented by an
"@" in the receive file. The letters character
after space can be reenabled by specifying
BDOT32=&H44 after the MARS keyword int the
PARMS.RTY file. Twelve consecutive characters will
be sent after "NNNN" is transmitted. The
characters will be the letters function or any
alternate character specified using the NCHR
keyword.
MODE - This keyword can be used to make the program
start up in the ASCII mode. The form of the
keyword is "MODE=A". The normal default is to
start in the Baudot mode.
NCHR - This keyword is used in conjunction with the
MARS keyword to specify the character to send when
"NNNN" is sent. The character will be sent twelve
times. The form of the keyword is NCHR=nn, where
nn is the value of the character to be sent. The
default is NCHR=60 which causes twelve letters
functions to be sent.
Program Operation 27
IBM PC RTTY Ver 1.2
NKEY - This is the keyword to use to specify the
search string for the not-at-keys message during
packet operation. When the string is found, all
received data up to the reception of the stop
search string will be saved in the file WHILE.OUT,
unless a receive file is currently open. When this
string is received, the file AWAY.MSG is sent out
over the Async line. The format of the keyword is
NKEY=** CONNECT. Up to 10 characters are allowed.
The default is "* CONNECTE".
NOBP - This keyword is used to disable the bell
character (beep) on the PC while in the ART mode
only. It is only controllable at program startup
time.
NPDT - This keyword tells the program to not send
the packet time/date over the async line when the
program is just starting or has just been reset.
To send the packet time/date, use the alt-D key
during normal program operation.
PACK - This keyword is used to make the controller
compatible with some packet radio TNCs. The
program is modified to send only one CR at the end
of the line instead of the normal two CRs. Also
when backspace is used, the program will send the
backspace character to the TNC for any character
already sent up to the last CR. The program will
also erase the characters on the last line which
have been sent. The program will come up in the
transmit mode. Most TNCs are semi-full duplex, so
there is no need to run in the half duplex mode.
(You can send data at any time without tying up the
channel.)
PDAT - This keyword is used to specify the packet
time/date command format, which is sent by the use
of the alt-D key. You can specify just about any
form you want with the exception of no imbedded
commas. The format of the keyword is
"PDAT=MO-DD-YYYY AT HH:MM:SS EST". Where the
program will substitue in the proper numbers from
the date and time commands. The parameters to use
are YYYY for the full 4 digit year, YY for just the
last 2 digits of the year, MO for the month, DD for
the day of the month, HH for the hours digit, MM
for the minutes and SS for the seconds. Any other
characters in the string will be sent as is with no
substitutions. Any of the parameters can be left
out of the string. The default is
"PDAT=DAY YYMODDHHMMSS".
Program Operation 28
IBM PC RTTY Ver 1.2
QB - This keyword causes a bell character to be
sent any time a quote character is sent in the
transmit mode. This is possibly useful in RTTY
ART, since some machines have the quote and the
bell reversed. No action is taken in the receive
mode. The default is no QB.
RTS - This keyword can be used to specify what
logic level the RTS (Request To Send) line out of
the Async adapter should be set to for receive and
transmit modes. The format is RTS=xy, where xy can
be 00, 01, 10, or 11. The number corresponding to
"x" is the logic level during receive and the
number corresponding to "y" is the logic level
during transmit. "0" corresponds to a low logic
level and a "1" corresponds to a high logic level.
The default is RTS=01.
RXB - This keyword is used to set the receive
buffer background color. The format is RXB=0. The
defaults are RXB=0 for the monochrome and RXB=2 for
the color mode. Refer to the BASIC manual for
colors associated with possible values.
RXF - This keyword is used to set the receive
buffer foreground color. The format is RXF=7. The
defaults are RXF=7 for the monochrome mode and
RXF=14 for the color mode. Refer to the BASIC
manual for colors associated with possible values.
SPLF - This keyword is used to suppress the sending
of line feeds over the communications link. This
may prove useful when the program is used to send
data to a packet radio TNC which cannot handle the
CR/LF normally sent at the end of a line.
STSB - This keyword is used to set the status line
background color. The format is STSB=7. The
defaults are STSB=7 for the monochrome mode and
STSB=6 for the color mode. Refer to the BASIC
manual for colors associated with possible values.
STSF - This keyword is used to set the status line
foreground color. The format is STSF=0. The
defaults are STSF=0 for the monochrome and the
color mode. Refer to the BASIC manual for colors
associated with possible values.
Program Operation 29
IBM PC RTTY Ver 1.2
TIME - This keyword is used to set the time-type at
program startup time. When this keyword is used,
the program will assume that the time and date are
set according to the time-type and no prompting for
the time will be done at program startup time.
(Generally people always set their time the same
way every time.) The format is TIME=EST. If
TIME=? is used then prompting will occur.
TXB - This keyword is used to set the transmit
buffer background color. The format is TXB=0. The
defaults are TXB=0 for the monochrome and TXB=1 the
color mode. Refer to the BASIC manual for colors
associated with possible values.
TXF - This keyword is used to set the transmit
buffer foreground color. The format is TXF=7. The
defaults are TXF=7 for the monochrome mode and
TXF=11 for the color mode. Refer to the BASIC
manual for colors associated with possible values.
UOS - This keyword will cause the program to begin
operation with the unshift-on-space option turned
on. The default is to start with the option turned
off.
WARN - Use this keyword to specify the column at
which you want the program to beep at you in the
transmit buffer to warn you that you are
approaching the end of the line. The format is
WARN=nn, where nn is the column number at which you
would like to be warned. The default is 56.
Program Operation 30
IBM PC RTTY Ver 1.2
XTAL - This keyword is used to specify the crystal
input frequency to the 8250 Async chip. The format
of the command is XTAL=1.8432. For the IBM PCjr
XTAL should be set to 1.78977. Note that the
complete number must be given and that any
inaccuracies will affect the accuracy of the baud
rate. The default is set to 1.8432 MHz.
ZULU - This keyword is used to specify that time is
to be sent in a military format of the form
"DDHHMMZ MON YR", where DD is the day, HH is the
hours, MM is the minutes, MON is the first three
letters of the month and YR is the last two digits
of the year. If the time displayed on the screen
is anything other than "UTC", you will be prompted
at the start of the program for the amount of time
in hours to be added to the local time to convert
it to UTC time. Anytime the timestamp is placed in
the transmit buffer, the program will convert the
displayed time to "UTC" time, correcting for any
overflow into the next day, month and/or year.
Leap years are also taken into account.
Additionally, when this keyword is specified the
timestamp will also be appended to the end of your
"TTY ID".
Program Operation 31
IBM PC RTTY Ver 1.2
UTILITY PROGRAM
A utility program has been provided to perform some of the
normal program functions offline. The utility is started
by entering
RTTYU
The program uses the same "PARMS.RTY" file to determine
which printer to use for output and to decide whether or
not to add a bell character after a quote. The program
prompts you for the name of the file to be processed. A
name must be entered and if any problems are encountered,
the program terminates.
You are then asked if you want the processed data sent to
another file. If you answer in the affirmative, you will
be asked the name for the file. Responding with only an
"ENTER" for the filename will be interpreted as meaning you
do not really want to save the data in a new file. If the
filename is OK, you are then asked if you would like the
data in the new file compressed. Here again as in other
places, responding with anything other than a word starting
with the letter "Y" will be taken to mean "NO". This
feature should be good for uncompressing a file so it can
be edited or for compressing a file to save diskette
space.
You will also be asked if you want the file printed on the
matrix printer. Answer in the affirmative if you would
like hard copy. Again, this routine does not send the
noisy bell character to the printer.
Regardless of the choices you make in processing the file,
the information is displayed on the display so you can keep
current with the progress of the program.
Program Operation 32
IBM PC RTTY Ver 1.2
BASIC COMPILING HELP
COMPILING THE RTTY PROGRAM
I am changing my stance on sending out the source code from
my original position. Originally, I intended only for the
compiled program to be sent to the general public and the
source code to stay under relatively tight control. Well,
as luck would have it, some well meaning soul took the
liberty of placing "My source code" on the public access
disk of CompuServe and Lord knows where else. Well, if you
can't lick 'em. . . join 'em! This little episode along
with some requests for help in getting it to run on some PC
clones has helped change my mind.
So much for the philosophical statements, now to the good
stuff. There is one assembly language routine which must
be assembled. This routine is a basic subroutine to scroll
half screens. It must be properly linked into the basic
program before it will work. If it isn't done correctly or
the BASIC program is run in the interpretive mode, chances
are the PC will lock up really well when the receive screen
is full. Because the execution speed of the interpretive
mode is totally unacceptable (by my standards) I won't even
try to explain how to link in the assembly language routine
to the interpretive mode. The following lines show how to
compile the RTTY program and properly link the appropriate
programs to end up with the executeable RTTY file.
BASCOM RTTY,,,/X/W/O/C:4096 (Assumes source in B: and BASIC
LINK RTTY+RTTYSUBS+A:IBMCOM,,,A: compiler in A:, B: is primary)
COMPILING THE RTTYU PROGRAM
The RTTYU program is similarly compiled as follows
BASCOM RTTYU,,,/E/O (Assumes source in B: and BASIC
LINK RTTYU,,,A: compiler in A:, B: is primary)
BASIC Compiling HELP 33
IBM PC RTTY Ver 1.2
GETTING AND ASSEMBLING THE RTTYSUBS PROGRAM
Starting with version 1.2E, the Assembly language for the
Scrolling routine to support the half screens is included
in the RTTY.BAS file. In order to properly assemble the
program, first of all copy the RTTY.BAS program to a file
called RTTYSUBS.ASM. Next using an editor of some flavor,
preferably a full screen editor such as Personal Editor,
remove the first several hundered lines of the basic
program up to the start of the assembly code. Next, remove
the BASIC line numbers and the quote mark and leading blank
caracters from the remaining statements. Once this has
been accomplished, you can use the macro assembler to
generate the object module necessary to link the Compiled
BASIC RTTY program.
BASIC Compiling HELP 34
IBM PC RTTY Ver 1.2
INTERFACE INFORMATION
INTERFACE SIGNALS
This program interfaces to the Amateur Radio equipment
through the Asynchronous Communications adapter. The
specifications for the voltage levels are those for a
standard RS-232C interface. In particular, the standard
specifies voltage levels of +12 volts and -12 volts to
represent the logic states of the signal. Further
information can be obtained in the Technical Reference
Manual. The signals which the program uses are as
follows.
Pin 2 - Transmit Data (Tx data) - characters to TU
Pin 3 - Receive Data (Rx data) - characters from TU
Pin 8 - Carrier Detect (CD) - CW data in from TU
Pin 4 - Request to Send (RTS) - Transmitter
control
Pin 20 - Data Terminal Ready (DTR) - CW ID control
Pin 7 - Ground (Gnd) - reference level
For Tx data and Rx data, mark is -12v and space is +12v.
CD is tied to Rx data and is not required for RTTY,
however, I included it for future use if I ever get around
to writing a Morse receive routine.
RTS and DTR are -12v in receive mode and +12v in normal
transmit mode.
Hopefully this is enough information to help you interface
to your terminal unit.
Interface Information 35
IBM PC RTTY Ver 1.2
KANTRONICS 'THE INTERFACE' INFORMATION
While I will give information here on how I interfaced the
Kantronics TU to my system, I must add that it was a
decision based on availability and price at the time of
purchase more than anything else. If you are trying to
make a decision, check around and see what is available and
what seems to work well. While the Kantronics does well in
many cases, it does seem to have difficulty with weak
and/or fading signals. The Kantronics interface does not
provide an RS-232C level interface and also requires an
external power supply. Additionally, the RTTY transmit
line requires a normal space condition for receive to
operate correctly. Based on these considerations, I
designed a special RS-232C to Kantronics interface box.
The schematic is included below.
Since my original purchase of a TU, Kantronics has come out
with some new models which seem to have addressed some of
the above mentioned problems. In particular, they have
increased the sensitivity of the circuits and have provided
an RS-232C level interface. So remember, it pays to
inquire before you purchase.
Next, just a few words about the circuit. The interface
chips used are the same as those used in the IBM PC,
namely, the 75150 line driver and the 75154 line receiver.
The 1488 line driver and 1489 line receiver from Radio
Shack could also be used but the pinouts are different.
The 74LS00 is used to gate the Tx data signal with the
transmitter control, to invert the RTTY transmit signal and
to invert signals for the normal/reverse switch. The
circuitry needs +5v, +12v and -12v to run. I used the
7805, 7812 and the 7912 voltage regulators to get my
voltages, but you can use your favorite regulator. Just be
sure to have enough filter capacitance on the input and
enough heat sink on the regulators. There is nothing worse
than intermittent problems when things get hot and heavy.
Also note, the signal ground from the async adapter, the
special interface ground and the TU ground should all be
tied together.
Due to popular demand, I have also included a schematic
using the 1488 and 1489 which should be readily available
at Radio Shack.
Interface Information 36
IBM PC RTTY Ver 1.2
KANTRONICS RS-232C INTERFACE SCHEMATIC
+5v
│
┌──────────┐ │
─┤1 ├─ │ ┌─────────────────────────────────────── CWID
─┤ ├──┘ │
─┤ ├─ │ ┌──────────────────────── KEYIN
DTR ─────────┤ ├────┘ │ ┌──────────┐
Tx data ─────┤ ├────┐ ├──┤1 ├─ +5v
RTS ─────────┤ ├───────────────────┴──┤ ├───┬───┬── DECODE
─┤ 75154 ├─ │ ┌──┤ ├───┘ │
Gnd ─┤ ├──┐ │ └──┤ ├─────┐ │
└──────────┘ │ │ ┌───────┤ ├───┐ │ │
┌────────────────┘ │ │┌──────┤ 74LS00 ├───┤ │ │
│ │ ││ Gnd ─┤ ├─┐ │ │ │
│ │ ││ └──────────┘ │ │ │ │
│ │ ││ │ │ │ │
│ │ │└──────────────────────────── RTTY
│ └───────────────────────┐ │ │ │ │
┌─────────────────────────────┐ │ /o────────┘ │ │
│ │ │ └───────────o| │ │ │
│ │ │ |o──────┘ │ │
│ │ ┌──────────┐ │ | │ │
│ └──┤1 ├─ +12v │ /o────────────┘
├──────┤ ├─────────┐ └──────────────o │
└──────┤ 75150 ├───────┐ │ o──────────┘
Gnd ─┤ ├─ -12v │ │
└──────────┘ │ │ Normal/Reverse
│ │ DPDT switch shown
Rx data ────────────────────────┘ │ in normal position
CD ───────────────────────────────┘
Gnd ───────────────────────────────────────────────────────────────── Gnd
Computer Kantronics
Interface Interface
│
Note: Non-Intersections are indicated by ───
│
All grounds are connected together.
An IBM Graphics Printer is required for this schematic
to print correctly.
Kantronics RS-232C Interface
Interface Information 37
IBM PC RTTY Ver 1.2
DTR ────────────────────────────┐
│
┌──────────┐ +5v │
Tx data ─────┤1 ├──┘ │ ┌───────────────────────────── CWID
─┤ ├───────┘ │
┌──────┤ ├─ │ ┌──────────────────────── KEYIN
RTS ─────────┤ ├──────────────┘ │ ┌──────────┐
┌────┘ ─┤ ├─ ├──┤1 ├─ +5v
│ ┌──────┤ 1489 ├─ ┌────────────┴──┤ ├───┬───┬── DECODE
│ │ Gnd ─┤ ├─ │ ┌──┤ ├───┘ │
│ │ └──────────┘ │ └──┤ ├─────┐ │
│ │ │ ┌───────┤ ├───┐ │ │
│ │ │ │┌──────┤ 74LS00 ├───┤ │ │
│ └────────────────────────┘ ││ Gnd ─┤ ├─┐ │ │ │
│ ││ └──────────┘ │ │ │ │
│ ││ │ │ │ │
│ │└──────────────────────────── RTTY
└───────────────────────────────────────────────────┐ │ │ │ │
┌────────────────────────────────┐ │ /o────────┘ │ │
│ │ └───────────o| │ │ │
│ │ |o──────┘ │ │
│ ┌──────────┐ │ | │ │
│ -12v ─┤1 ├─ +12v │ /o────────────┘
└─────────┤ ├───────────┴──────────────o │
Rx data ─────┤ ├─ o──────────┘
─┤ ├─────┐
─┤ ├─ │ Normal/Reverse
─┤ 1488 ├─ │ DPDT switch shown
Gnd ─┤ ├─ │ in normal position
└──────────┘ │
CD ───────────────────────────┘
Gnd ───────────────────────────────────────────────────────────────── Gnd
Computer Kantronics
Interface Interface
│
Note: Non-Intersections are indicated by ───
│
All grounds are connected.
An IBM Graphics Printer is required for this schematic
to print correctly.
Kantronics RS-232C Interface
Interface Information 38
IBM PC RTTY Ver 1.2
A TERMINAL UNIT DESIGN COMPLIMENTS OF BOB AUSTIN, N4CLH
W1GAFSK MODULATOR WITH XR-2206
W0H
** ALL PARTS ARE AVAILABLE AT RADIO SHACK **
┌────┐
┌──────────────────────────────────────────┤1 16├
R1= 220 │ AUDIO OUT├───────────────┤C5├───────────┤ ├
R2= 33K │ ┌─────────┤R8├─────────────────┤ ├──┤R1├──────┐
R3= 20K │ │ ┌───────────────┤ ├────────────┘
R4= 20K │ │ │ ┌────┤C3├───┤ ├───────────────┐
R5= 33K │ │ +12V├─────┤ └───────────┤ ├ │
R6= 4.7K │ │ │ ┌───────┤ ├────────────┐ │
R7= 4.7K │ │ │ │ ┌──┤8 9├────┐ │ │
R8= 50K │ │ │ ┴ ┴ └────┘ ├──TTL │ │
│ ┌──────┼────┤R7├──────┘ R5 R2 │ IN │ │
C1= 1uf │ │ │ ┬ ┬ │ + ┴ │
C2= .001uf │ + ┴ ┴ ┴ │ ┴ C1 │
C3= .01uf │ C4 R6 R4 ┴ C2 ┬ │
C4= 10uf │ ┬ ┬ ┬ R3 ┬ │ │
C5= .1uf │ │ │ │ ┬ │ │ │
┬┼┬ ┬┼┬ ┬┼┬ ┬┼┬ ┬┼┬ ┬┼┬ ┬┼┬┬┼┬
-----------------------------------------------------------------------------
NOTES:
C3 MUST BE STABLE CAPACITOR
R3/R4 SHOULD BE MULTI-TURN POTS
R8 VARIABLE POT TO ADJUST AUDIO OUTPUT
C1/C4 ARE ELECTROLITIC
SETUP:
POWER TO PIN 4, ADJUST R3 FOR 2125 HZ AT AUDIO OUTPUT
POWER TO PIN 4, GROUND PIN 9, ADJUST R4 FOR 2295 HZ AT AUDIO OUTPUT
ADJUST R8 FOR DESIRED AUDIO OUTPUT LEVEL TO MICROPHONE CONNECTION
NORMALY LESS THAN 1 VOLT PEAK.
NOTE**
THE XR2211 WILL BLOW IF MORE THAT 2V PEAK AUDIO IS APPLIED. IF YOU HOOK UP
THE RELAY CIRCUIT TO ECHO XMIT BUFFER DO NOT ADJUST R8 FOR MORE THAN THE
2V PEAK.
Interface Information 39
IBM PC RTTY Ver 1.2
From Bob Austin, N4CLH
W1GAFSK DEMODULATOR USING XR-2211
W0H
┌─────┐
IN +12V├────────┤1 14├─────┤C6├────┐
AUDIO ├───────┤C11┤───┤ ├─────────────┘
┌───┬──────────────────────────────┤ ├─────────────┐
│ │ ┌──────────────────────────┤ ├───┬─┤R9├────┴──┤R10├────┐
│ │ │ ┤ ├───│───────────────┐ │
│ │ │ TTL OUT├────────┬──┤ ├ └─────────┐ │ │
│ │ │ ├──┤7 8├─┬──┤R12├────┤ │ │
│ │ │ +5V├────┤R15├───┤ └─────┘ │ │ │ │
│ │ │ │ │ │ │ │
│ │ │ └───┤R13├──┤ ┴ ┴ ┴
┴ ┴ │ │ C7 C8 R11
R14 C10 │ ┴ ┬ ┬ ┬
┬ ┬ │ C9 │ │ │
│ │ │ ┬ │ │ │
┬┼┬ ┬┼┬ ┬┼┬ ┬┼┬ ┬┼┬ ┬┼┬ ┬┼┬
-----------------------------------------------------------------------------
R9 = 220K
R10= 15K NOTES: PINS 10 AND 11 DONOT CONNECT
R11= 20K R11 IS MULTITURN POT
R12= 100K C6 MUST BE STABLE CAPACITOR
R13= 470K C9 IS FOR 110 ASCII/BAUDOT OR LESS
R14= 470K I SWITCH TWO CAPS AT C9 FOR LOW SPEED AND HIGH
R15= 10K SPEED USING .047 AND .0047(HIGH) 300 ASCII/BAUDOT
C6 = .022 ADJUSTMENT:
C7 = .0047 POWER TO PIN 1, ADJUST R11 FOR CLEAN COPY
C8 = .1 (I USE A STRING OF *U FOR ADJUSTMENT AT 110 ASCII)
C9 = .047
C10= .05
C11= .1
Interface Information 40
IBM PC RTTY Ver 1.2
From Bob Austin, N4CLH
W1GTTL TO EIA INTERFACE
W0H
I LIKE TO USE A 7404 OR 74LS04 BETWEEN THE EIA LINE DRIVER/RECEVIER
AND THE EXAR CHIPS TO LET ME USE SOME L E D'S FOR MARK AND SPACE.
YOU MAY ELIMINATE THIS CIRCUIT AND CONNECT THE EXAR CHIPS TO THE
LINE DRIVER/RECEIVER DIRECT.
TTL IN FROM XR2211-PIN6
─┬─
│ 7404 OR 74LS04
│ ┌─────┐
N ┌────┴─────────┤1 14├─────────┤+5V
┌─────── S1 ┌──┤ ├
│ R └─┬─────────┴──┤ ├
│ │ ┌──┤ ├
│ ┴ ┌──┴──┤ ├
│ R16 │ ┤ ├
│ ┬ ┴ ┌─┤7 8 ├
│ │ R17 │ └─────┘
│ ┴ ┬ │ S1= SPDT FOR NORMAL AND REVERSE
│ D1 │ │ SIGNALS
│ ┬ ┴ │ R16= 390
│ │ D2 │ R17= 390
│ │ ┬ │ D1= LED (MARK)
│ ┌┼┐ ┌┼┐ ┌┼┐ D2= LED (SPACE)
------│---------------------------------------------------------------------
│ 1488 DRIVER
└──────────────────────────┐ 1489 RECEIVER
│
+12V -12V EIA PIN6 │ PIN4 PIN9 PIN2 +5V
┬ ┬ ┬ │ ┬EIA ┬ ┬EIA ┬
│ └─────┐ │ │ │ │XR │ │
│ ┌─────┐ │ │ │ │ │2206│ │
└─────┤1 14├─┘ │ │ │ │ │ ┌─────┐ │
──┤ ├───┐ │ │ │ │ └──┤1 14├──┘
──┤ ├───┴────│──┐ │ ┌───│───────────────┤ ├
──┤ ├────────┘ │ │ │ │ └───────┤ ├
──┤ ├───┐ │ │ │ └───────────────┤ ├
──┤ ├───┴───────│──┘ │ ┌────────────┤ ├
┌─┤7 8 ├────┐ │ ┴ │ ┌─────┤ ├
│ └─────┘ │ │ C11 │ │ ┌─┤7 8 ├
│ │ │ ┬ ┴ ┴ │ └─────┘
│ EIA ├───┘ │ │ C12 RELAY│
│ PIN3 │ │ ┬ DRIVE│
┌┼┐ ┌┼┐ ┌┼┐ ┌┼┐ ┌┼┐
C11= .1
C12= .1
Interface Information 41
IBM PC RTTY Ver 1.2
From Bob Austin, N4CLH
W1GPTT CIRCUIT
W0H
FOR THE RELAY TRANSISTOR, I USED A PNP 2N3906.
E
PIN6 ┌────┬── +5V
1489 ├──────┤R18├──┤B │
RCVR └────┴── RELAY COIL (OTHER END GND)
C
R18= 470
RELAY= DPDT 5VOLT MINATURE.
** THERE ARE SEVERAL WAYS TO HOOK THE RELAY UP TO YOUR PTT.
I COUPLED MY AUDIO OUTPUT TO THE AUDIO INPUT TO ECHO
MY XMITTED BUFFER BACK TO ME.(THIS ALLOWS ME TO SEE BOTH XMIT AND
RECEIVE IN MY SAVED FILES)
IF YOU USE THE ECHO FUNCTION OF A RTTY PROGRAM YOU DO NOT HAVE TO
HOOK THIS UP.. A SPST RELAY IS SUFFICIENT FOR PTT
AUDIO HOOKUPS ON THE RELAY ARE MADE WITH COUPLING CAPS C5 AND C11 BETWEEN
XR CHIPS AND RELAY.
XR2206 COM ┌─────┐COM
AUDIO INPUT ├────────┤ ├────────┤ PTT INPUT
XR2211 N/OPEN│ │ N/OPEN
AUDIO OUTPUT ├────────┤ ├───────────┐
N/CLOSE│ │ N/CLOSE │
RIG AUDIO OUT ├────────┤ ├─────── │
(SPKR) └─────┘ │
│
│
│
┌┼┐
W1G73's N4CLHW0H
Interface Information 42 ┌┼┐
W1G73's N4CLH