HAM Radio 1

home *** CD-ROM | disk | FTP | other *** search

/ HAM Radio 1 / HamRadio.cdr / misc / yappprot / rtty.doc < prev next >

Wrap

Text File | 1983-07-10 | 31.6 KB | 966 lines

ACBAACBHF HF HF HF HF HF HF HF HF HF HF HF HF HF HF HF AHF HF HF GERadio Teletype ProgramHF HF GEFor The IBM Personal ComputerHF HF GEVersion 1.0HF HF GEJuly 10, 1983HF HF HF HF HF HF Glenn E. Welman - WB0OWT HF HF 3301 Pastern Ct. HF Lexington, Ky 40513 HF HF IBM PC RTTY Ver 1.0 EG Table of Contents HF EG 1.0 Introduction ........................................... 1 HF 1.1 Distribution Guidelines ................................ 1 EG 2.0 Program Operation ...................................... 2 HF 2.1 Features ............................................... 3 HF 2.2 Special Keys ........................................... 4 HF 2.3 Function Keys .......................................... 5 HF 2.4 Program Files .......................................... 9 HF 2.4.1 Required Files ....................................... 9 HF 2.4.2 Optional Files ....................................... 9 HF 2.5 Utility Program ....................................... 11 EG 3.0 Interface Information ................................. 12 HF 3.1 Interface Signals ..................................... 12 HF 3.2 Kantronics 'The Interface' information ................ 13 HF 3.3 Kantronics RS-232C Interface Schematic ................ 14 HF Table of Contents iiHF IBM PC RTTY Ver 1.0 EG ___ ____________ HF EG 1.0 Introduction HF HF This program runs on the IBM Personal Computer and interfaces to HF your Amateur Radio equipment through the Asynchrounous HF Communications adapter. I wrote the program to be as flexible as HF possible hoping that it will be useable with any Terminal Unit HF (TU) and radio combination. I have attempted to provide enough HF information to help you make your system operational. HF HF I intend for the program to be distributed by hams, rather than HF retailers. I suggest the following. HF EG 1.1 Distribution Guidelines HF HF Please share the program with others who are interested in HF RTTY. HF HF Please don't sell or barter the program to anyone. HF HF When you pass along the program, include only the original HF unmodified version. HF HF Send a SASE along with your current version number and I will HF let you know if any known problems have been fixed by a later HF version. HF HF Don't remove these guidelines from the program or document. HF HF If you find the program of value, a small contribution to the HF cause would be appreciated ($25 suggested). Please note that HF I expect to be moving to Lexington, Kentucky in August, 1983. HF With any luck the Post Office will forward mail for about a HF year. I am also giving serious consideration to getting a "4" HF call too. HF 1.0 Introduction 1HF IBM PC RTTY Ver 1.0 EG ___ _______ _________ HF EG 2.0 Program Operation HF HF The program is started by placing the program diskette in the HF default drive (usually drive A:) and entering RTTY HF Several files should be personalized prior to running the program HF with your callsign and other pertinent information. These files HF are identified further on in this document and may be changed with HF any text editor. The program is primarily written in BASIC and HF compiled to acheive a useable operating speed. There are two HF subroutines written in Assembly Language to do things which I HF couldn't do well in BASIC. Specifically, one routine scrolls half HF screens and the other subroutine sends the CW identification with HF accurate timings. HF HF The program takes advantage of the IBM Personal Computer's HF capabilities. The interrupt capabilities of the Asynchrounous HF Communications adapter and the keyboard allow many things to occur HF simultaneously without the loss of desired information. The use of HF DOS files allows the storage and retreival of a large supply of HF RTTY data. I hope you find the program's many features useful. HF 2.0 Program Operation 2HF IBM PC RTTY Ver 1.0 HF EG 2.1 Features HF HF The program will run on a 64K PC under DOS 1.1 and supports HF both the 80X25 mode and the 40X25 mode. HF HF The program runs in a split screen mode with received data HF displayed on the top half and the transmit buffer displayed HF on the bottom half of the screen. Run time information is HF displayed in the center of the screen, such as current time, HF date and elapsed time since last CW ID. Prompts for operator HF input are displayed in the center of the screen. The HF definition and status of the function keys is displayed at HF the bottom of the screen. Errors are also reported at the HF bottom of the screen. HF HF The program supports both BAUDOT and ASCII RTTY modes. Common HF BAUDOT rates of 60, 67, 75, and 100 WPM are supported. Common HF ASCII baud rates of 110 and 300 BAUD are also supported. HF HF The received input goes to the display and can be directed to HF the printer and/or a DOS file. File compression is supported HF which can result in using less DOS file space. HF HF While you are receiving, you can fill a 1000 character HF transmit buffer from the keyboard or DOS files. HF HF While the program is prompting you for information, received HF characters are placed into a 1000 character receive buffer. HF If more than 1000 characters are received while the program HF is prompting you, a communications buffer overflow error will HF result and the program will terminate. HF HF There are several predefined files which can be loaded into HF the transmit buffer with the stroke of a function key. Up to HF six files can be qued to be placed into the transmit buffer HF at any one time. HF HF A cursor is displayed at the current Transmit buffer HF location. When the cursor reaches column 64, an audible beep HF can be heard. HF HF The transmit buffer can be edited minimally by using the HF backspace key. HF HF In the transmit mode, a date and time stamp can be sent over HF RTTY, as well as, a predefined RTTY ID field. HF HF At any time during transmission a function key can be pressed HF which will wait for all characters in the BASIC HF communications buffer to be transmitted, send your CW ID in HF Morse code and then resume the RTTY transmission. HF HF The transmit buffer is filled first by any transmit files, HF second by characters resulting from special keys, and finally HF from keyboard input. The program will stop placing characters HF in the transmit buffer when it is full and will resume as HF characters are transmitted from the transmit buffer. HF 2.0 Program Operation 3HF IBM PC RTTY Ver 1.0 HF EG 2.2 Special Keys HF HF Backspace - Pressing the backspace key erases the last HF character entered into the transmit buffer and the cursor HF backs up. If the last character was a line feed, the cursor HF backs up to the previous line and the character is displayed HF in reverse video. When you backspace beyond the top line of HF the transmit screen, the previous line entered into the HF transmit buffer appears on the top line. Lines prior to the HF line at the top of the screen are not visible. Note that you HF cannot back up beyond the last character sent to the HF Asynchronous communications adapter. HF HF ENTER - Pressing the "ENTER" key at the end of a line HF normally causes a carriage return and line feed to be placed HF into the transmit buffer. HF HF Ctrl S - Pressing Ctrl S causes the program to prompt you for HF a line of characters which will be stored for later HF retreival. The information is kept in memory until the HF program is ended or another Ctrl S is entered. HF HF Ctrl R - This is the companion key of Ctrl S. Pressing Ctrl R HF retrieves the stored line and places it in the transmit HF buffer. HF HF Ctrl W - Ctrl W is pressed to instruct the program to place HF only a carriage return in the transmit buffer. Pressing the HF "ENTER" key after a Ctrl W will be ignored by the program. HF Pressing a character key will result in an overprint HF condition. The Ctrl W key will find primary application in HF sending RTTY art. This character is placed in the receive HF file for any carriage return. An idea of what character may HF be displayed by various editors can be found in appendix C of HF the Technical Reference manual. HF HF Ctrl T - Ctrl T is the companion of the Ctrl W key and HF results in a single line feed being placed in the transmit HF buffer. Pressing "ENTER" after a Ctrl T will be ignored by HF the program. The Ctrl T key will be used in RTTY art and may HF be used to replace a line feed erased by backspacing. This HF character is placed in the receive file for any line feed. An HF idea of what character may be displayed by various editors HF can be found in appendix C of the Technical Reference manual. HF HF Ctrl X - Ctrl X is provided to force the sending of the HF "Figures" character in Baudot mode only. Only time will tell HF the uses of this key. This key will appear in the transmit HF buffer as a up arrow. HF HF Ctrl Y - Ctrl Y can be used to force the sending of the HF "Letters" character in BAUDOT mode only. I'm not sure what HF use this key is either. This key will appear in the transmit HF buffer as a down arrow. HF HF 2.0 Program Operation 4HF IBM PC RTTY Ver 1.0 HF EG 2.3 Function Keys HF HF The ten function keys are used during program operation to direct HF the flow of information in the computer system. The definition and HF status of the function keys is displayed at the bottom of the HF screen. The function keys are defined as follows: HF HF General Funtion Keys HF HF F1 - KEYS HF HF This key toggles the definition of function keys 3 HF through 10 and changes the status line. HF HF F2 - RECV/XMIT HF HF This key toggles the program between receive mode HF and transmit mode. When the program begins, this HF key defaults to RECV. HF HF HF Function Key Set 1 HF HF F3 - RX FLE HF HF Receive a File. Pressing this key prompts you for a HF filename in which to place the received HF information. The information is appended to the HF file. Pressing only "ENTER" results in no file HF being opened. Pressing this key while a file is HF currently open is taken as a request to stop using HF the file. HF HF When a filename is entered, you are asked if you HF want the file to be saved as a compressed file. HF Compressed files will take up less room on your DOS HF diskette, but are not readily alterable in an HF editor. HF HF When a receive file is open, a reminder is HF displayed on the center line of the screen. The HF form of the display is "RX-filename". HF HF F4 - UOS ON/UOS OF HF HF This key toggles between Unshift On Space being HF turned on and turned off. This key only applies to HF received data. When unshift on space is on, the HF program will shift back to "letters" mode any time HF a space, carriage return or line feed is received. HF HF Independent of this key, the program will transmit HF a "letters" character in the BAUDOT mode as HF required with a space, a carriage return or a line HF feed. When the program begins, this key defaults to HF UOS ON. HF HF 2.0 Program Operation 5HF IBM PC RTTY Ver 1.0 HF F5 - END HF HF This key provides a means to terminate the program HF gracefully. You will be prompted for confirmation HF of your request to quit. HF HF F6 - PRT OF/PRT ON HF HF This key toggles output to the printer on and off. HF When PRT ON is displayed, all characters received HF will also be printed on the matrix printer. Bell HF characters are not sent to the printer to keep down HF the noise pollution. When the program begins, this HF key defaults to PRT OF. HF HF F7 - 45.5/50.0/56.9/74.2/110/300 (Actual Baud Rate) HF HF This key toggles through the baud rates supported HF by the program. The status line is updated with HF each change. In Baudot mode, the baud rates of HF 45.5, 50.0, 56.9, and 74.2 correspond to character HF rates of 60, 67, 75, and 100 words per minute (WPM) HF respectively. When the program begins, this key HF defaults to 45.5. HF HF F8 - BAUDOT/ASCII HF HF This key toggles between Baudot and ASCII modes. HF Any combination of baud rate and mode is HF obtainable. When the program begins, this key HF defaults to BAUDOT. HF HF F9 - NEW LN HF HF This key provides the ability to force a CR/LF (new HF line) in the middle of received text. Such an HF operation might be needed if the original CR/LF HF were lost in the noise. HF HF F10 - LTRS HF HF This is the "letters" key. During Baudot reception HF it is occaisionally desirable to force the receive HF mode back into the "letters" mode. This key HF accomplishes that task. HF HF 2.0 Program Operation 6HF IBM PC RTTY Ver 1.0 HF HF Function Key Set 2 HF HF F3 - TX FLE HF HF Transmit a File. Pressing this key allows the HF contents of a DOS file to be placed into the HF transmit buffer for transmission. You will be HF prompted for the filename of the file to transmit. HF Pressing just "ENTER" will result in no file being HF transmitted. Entering the word "stop" will cause HF the current file being processed to be closed. HF HF The filename is placed in a buffer que which will HF eventually be opened and read. This allows for HF placing several transmit files into the transmit HF buffer in sequential order. The filename of the HF file currently being read is displayed on the HF center display line. The form of the display is HF "TX-filename". HF HF If an error is encountered in opening the file, an HF error status is displayed for about a second at the HF bottom of the screen and a beep is sounded. HF HF F4 - TX CQ HF HF Transmit a CQ. Pressing this key causes the file HF "CQ.RTY" to be loaded into the transmit buffer. HF This file is qued just like a transmit file and is HF displayed on the center screen. Note that you must HF personalize the "CQ.RTY" file with your callsign HF and name. HF HF F5 - RESET HF HF This is the reset key. Pressing this key will close HF all transmit files, clear the screen and start the HF program over. There is no prompting to make sure HF you mean it. HF HF F6 - TX RYS HF HF Transmit RYs. Pressing this key will result in the HF "RYS.RTY" file to be placed into the transmit file HF que and eventually into the transmit buffer. This HF is handy for placing a bunch of RYs at the start of HF your transmission, which gives the guy at the other HF end a chance to lock back onto your signal. HF HF F7 - PSE OF/PSE ON HF HF Transmit Pause Off / Transmit Pause On. This key is HF used to temporarily stop the program from sending HF any more characters out of the transmit buffer. HF This is useful for sending a steady carrier signal HF for tuning purposes or for stopping at a particular HF place so that a CWID can be sent. It should be HF 2.0 Program Operation 7HF IBM PC RTTY Ver 1.0 HF noted, that BASIC can buffer up to 128 characters. HF These characters cannot be stopped from being sent. HF Thus, you may not be able to make the program pause HF exactly where you want. When the program begins, HF this key defaults to PSE OF. HF HF F8 - TTY ID HF HF Teletype ID. Pressing this key causes the second HF line of the "CWID.RTY" file to be placed into the HF transmit buffer. Note that this line of data is HF read from the file at the beginning of the program HF and stored in program memory. Also note that the HF "CWID.RTY" file must be personalized with your name HF and callsign. HF HF F9 - CW ID HF HF This key causes the first line of the "CWID.RTY" HF file to be sent over the air in Morse code. The HF file is read at the beginning of the program and HF stored in program memory. Note that the "CWID.RTY" HF file must be personalized with your name and HF callsign. HF HF F10 - DT&TM HF HF Date and Time stamp. This causes the current date HF and time to be placed into the transmit buffer. HF Note that the time sent is the time the key is HF pressed, not the time the characters are actually HF sent. HF HF 2.0 Program Operation 8HF IBM PC RTTY Ver 1.0 HF EG 2.4 Program Files HF HF There are three files which the program expects to find on the HF default DOS drive. If any of these files are absent, the results HF will be unpredictable, possibly resulting in the program dying in HF the middle of a QSO. There is also an optional file which may be HF absent from the default DOS drive. The files are described below. HF EG 2.4.1 Required Files HF HF CWID.RTY - This file is required to have two lines. The first HF line contains the characters to be sent as the CW ID (e.g. DE HF WB0OWT). The second line contains the characters to be placed HF in the transmit buffer for your RTTY ID (e.g. DE WB0OWT HF "GLENN" IN BOCA RATON, FLA). Note, you must personalize this HF file with your callsign, name and location. HF HF CQ.RTY - This file contains all the information you would HF like to send for a RTTY CQ. Note, you must customize this HF file with your callsign, name, and location. You may HF optionally change the format of the CQ. HF HF RYS.RTY - This file is simply a line of RYs which will be HF sent in response to a function key being pressed. This file HF could be changed in just about any way you desired. HF EG 2.4.2 Optional Files HF HF PARMS.RTY - This file can have one or more of the following HF keywords on a single line separated by commas or on separate HF lines. Only the first four characters of the words are HF compared, so extra information between commas or on the line HF is ignored. HF HF COM2 - This keyword will cause the program to use the HF second async communications adapter for RTTY. The HF program default is the first adapter (COM1). This option HF may be useful if the first adapter is primarily used for HF some other reason such as a telephone modem or a serial HF printer. HF HF DIDL - This keyword is provided for those folks who like HF to send something (even null) while the transmit buffer HF is empty. Null characters are sent about once per second HF while the transmit buffer is empty. HF HF ECHO - This keyword causes each character sent to the HF BASIC COMn: port to be displayed on the receiver half of HF the screen. This option is provided for those who have HF TUs which do not place the transmitted data back onto HF the receive line coming back to the computer. The HF program default is no ECHO. HF HF Note - BASIC has a 128 byte transmit buffer. When this HF keyword is active, the receive screen shows the HF character when it is placed into the BASIC buffer. In HF other words, just because you see it on the screen HF 2.0 Program Operation 9HF IBM PC RTTY Ver 1.0 HF doesn't mean it has been sent yet! If you use this mode, HF you will need some way to know when all of the data has HF actually been transmitted. HF HF FSK - This keyword is provided to allow for ON/OFF HF keying of the transmitter for those who are not using a HF TU with an AFSK output which goes to the microphone HF jack. The default is the AFSK mode. HF HF FSK? - This keyword is for those people, like myself, HF who have two radios which may be used and one uses the HF AFSK mode and the other uses the FSK mode. If this HF keyword is specified, you are asked at the beginning of HF the program if you want to run in the AFSK mode. Any HF answer beginning with the letter "Y" will place the HF program in the AFSK mode. Any other entry will place the HF program in the FSK mode. Refer to the Interface HF Information section for definitions of the signals used HF in the two modes. HF HF LPT2 - This keyword allows the printer output to go to HF the printer attached to the second printer adapter. The HF default is the first printer adapter (LPT1). HF HF LPT3 - This keyword allows the printer output to go to HF the printer attached to the third printer adapter. The HF default is the first printer adapter (LPT1). HF HF QB - This keyword causes a bell character to be sent any HF time a quote character is sent in the transmit mode. HF This is possibly useful in RTTY ART, since some machines HF have the quote and the bell reversed. No action is taken HF in the receive mode. The default is no QB. HF HF 2.0 Program Operation 10HF IBM PC RTTY Ver 1.0 HF EG 2.5 Utility Program HF HF A utility program has been provided to perform some of the normal HF program functions offline. The utility is started by entering HF RTTYU HF The program uses the same "PARMS.RTY" file to determine which HF printer to use for output and to decide whether or not to add a HF bell character after a quote. The program prompts you for the name HF of the file to be processed. A name must be entered and if any HF problems are encountered, the program stops. HF HF You are then asked if you want the processed data sent to another HF file. If you answer in the affirmative, you will be asked the name HF for the file. Responding will only an "ENTER" for the filename HF will be interpreted as meaning you do not really want to save the HF data in a new file. If the filename is OK, you are then asked if HF you would like the data in the new file compressed. Here again as HF in other places, responding with anything other than a word HF starting with the letter "Y" will be taken to mean "NO". This HF feature should be good for uncompressing a file so it can be HF edited or for compressing a file to save diskette space. HF HF You will also be asked if you want the file printed on the matrix HF printer. Answer in the affirmative if you would like hard copy. HF Again, this routine does not send the noisy bell character to the HF printer, the IBM Personal Computer makes enough noise all by HF itself. HF HF Regardless of the choices you make in processing the file, the HF information is displayed on the display so you can keep current HF with the progress of the program. HF 2.0 Program Operation 11HF IBM PC RTTY Ver 1.0 EG ___ ____________________ HF EG 3.0 InterfaceInformation HF EG 3.1 Interface Signals HF HF This program interfaces to the Amateur Radio equipment through the HF Asynchronous Communications adapter. The specifications for the HF voltage levels are those for a standard RS-232C interface. In HF particular, the standard specifies voltage levels of +12 volts and HF -12 volts to represent the logic states of the signal. Further HF information can be obtained in the Technical Reference Manual. The HF signals which the program uses are as follows. HF HF Pin 2 - Transmit Data (Tx data) - characters to TU HF HF Pin 3 - Receive Data (Rx data) - characters from TU HF HF Pin 8 - Carrier Detect (CD) - CW data in from TU HF HF Pin 4 - Request to Send (RTS) - Transmitter control HF HF Pin 20 - Data Terminal Ready (DTR) - CW ID control HF HF Pin 7 - Ground (Gnd) - reference level HF HF HF For Tx data and Rx data, mark is -12v and space is +12v. CD is HF tied to Rx data and is not required for RTTY, however, I expect to HF use this line when and if I get around to writing a Morse receive HF routine. HF HF RTS and DTR are -12v in receive mode and +12v in normal transmit HF mode. HF HF For AFSK CW ID, DTR only toggles from the normal transmit level. HF HF For FSK CW ID, both DTR and RTS toggle from the normal transmit HF level. HF HF Hopefully this is enough information to help you interface to your HF terminal unit. HF 3.0 Interface Information 12HF IBM PC RTTY Ver 1.0 HF EG 3.2 Kantronics 'The Interface' information HF HF While I will give information here on how I interfaced the HF Kantronics TU to my system, I must add that it was a decision HF based on availability and price more than anything else. If you HF are trying to make a decision, check around and see what is HF available and what seems to work well. While the Kantronics does HF well in many cases, it does seem to have difficulty with weak HF and/or fading signals. The Kantronics interface does not provide HF an RS-232C level interface and also requires an external power HF supply. Additionally, the RTTY transmit line requires a normal HF space condition for receive to operate correctly. Based on these HF considerations, I designed a special RS-232C to Kantronics HF interface box. The schematic is included below. HF HF First, just a few words about the circuit. The interface chips HF used are the same as those used in the IBM PC, namely, the 75150 HF line driver and the 75154 line receiver. The 1488 line driver and HF 1489 line receiver from Radio Shack could also be used but the HF pinouts are different. The 74LS00 is used to gate the Tx data HF signal with the transmitter control, to invert the RTTY transmit HF signal and to invert signals for the normal/reverse switch. The HF circuitry needs +5v, +12v and -12v to run. I used the 7805, 7812 HF and the 7912 voltage regulators to get my voltages, but you can HF use your favorite regulator. Just be sure to have enough filter HF capacitance on the input and enough heat sink on the regulators. HF There is nothing worse than intermittent problems when things get HF hot and heavy. Also note, the signal ground from the async HF adapter, the special interface ground and the TU ground should all HF be tied together. HF 3.0 Interface Information 13HF IBM PC RTTY Ver 1.0 HF EG 3.3 Kantronics RS-232C Interface Schematic HF HF HF +5v HF ┌───────┴───────┐ HF │ ┌──────────┐ │ HF ├─┤1 ├─ │ ┌─────────────────────────────────────── CWID HF ├─┤ ├──┘ │ HF └─┤ ├─ │ ┌──────────────────────── KEYIN HF DTR ─────────┤ ├────┘ │ ┌──────────┐ HF Tx data ─────┤ ├────┐ ├──┤1 ├─ +5v HF RTS ─────────┤ ├───────────────────┴──┤ ├───┬───┬── DECODE HF ─┤ 75154 ├─ │ ┌──┤ ├───┘ │ HF Gnd ─┤ ├──┐ │ └──┤ ├─────┐ │ HF └──────────┘ │ │ ┌───────┤ ├───┐ │ │ HF ┌────────────────┘ │ │┌──────┤ 74LS00 ├───┤ │ │ HF │ │ ││ Gnd ─┤ ├─┐ │ │ │ HF │ │ ││ └──────────┘ │ │ │ │ HF │ │ ││ │ │ │ │ HF │ │ │└──────────────────────────── RTTY HF │ └───────────────────────┐ │ │ │ │ HF ┌─────────────────────────────┐ │ /o────────┘ │ │ HF │ │ │ └───────────o| │ │ │ HF │ │ │ |o──────┘ │ │ HF │ │ ┌──────────┐ │ | │ │ HF │ └──┤1 ├─ +12v │ /o────────────┘ HF ├──────┤ ├─────────┐ └──────────────o │ HF └──────┤ 75150 ├───────┐ │ o──────────┘ HF Gnd ─┤ ├─ -12v │ │ HF └──────────┘ │ │ Normal/Reverse HF │ │ DPDT switch shown HF Rx data ────────────────────────┘ │ in normal position HF CD ───────────────────────────────┘ HF Gnd ───────────────────────────────────────────────────────────────── Gnd HF HF Computer Kantronics HF Interface Interface HF HF │ HF Note: Non-Intersections are indicated by ─── HF │ HF All grounds are connected. HF HF An IBM Graphics Printer is required for this schematic HF to print correctly. HF HF HF HF Kantronics RS-232C Interface HF HF 3.0 Interface Information 14HF