PacComm Micropower-2_Tiny-2 User guide

OPERATING
INSTRUCTIONS
TINY-2
and
MICROPOWER-2
Packet Controllers
TINY-2/MICRO-2 Operating Manual, 4th Ed. 1990
INTRODUCTION ............................................................................... 4
Computer and Radio Interfacing .............................................. 4
Software Requirements ........................................................... 4
Radio Interfacing .................................................................... 5
Other Information .................................................................. 5
OPERATING INSTRUCTIONS
Verifying Serial Port Operation ................................................. 6
Serial Port parameters ............................................................ 7
Beginning Packet Operation ..................................................... 8
First Steps ................................................................... 8
Your First Packet Connection ......................................... 9
Starting the Connection ................................................ 9
In Case of Difficulty ...................................................... 10
Digital Repeating (Digipeating) ................................................ 10
Unsuccessful Connections ....................................................... 11
Monitoring Channel Activity ..................................................... 12
Special Characters .................................................................. 13
Special Input Characters ......................................................... 14
Operating Modes .................................................................... 15
Command Mode .......................................................... 16
Entering Data-Transfer Modes ....................................... 16
KISS Mode .................................................................. 17
Converse Mode ............................................................ 17
Transparent Mode ........................................................ 18
Flow Control .......................................................................... 19
XON/XOFF Flow Control ................................................ 19
Hardware Flow Control ................................................. 20
Type-in Flow Control .................................................... 20
Station Identification .............................................................. 20
Automatic Operations ............................................................. 21
Unattended Connections ............................................... 21
Beaconing ................................................................... 21
Connect Alarm ............................................................. 22
Packet Formatting .................................................................. 22
Commands Affecting Protocol .................................................. 22
Packet Transmit Timing ................................................ 23
Packet Timing .............................................................. 23
Alternate Transmit Timing ............................................. 24
Special Protocol Times .................................................. 24
Monitor Functions ................................................................... 25
"Health" Features ................................................................... 25
Clock Operation ...................................................................... 27
Time Stamping ....................................................................... 27
Special Operations .................................................................. 27
Computer Operations .............................................................. 28
HF Operation ......................................................................... 28
Multiple Connections ............................................................... 29
Personal Message System (PMS) .............................................. 30
PMS Setup Commands ................................................. 30
PMS Operator Commands ............................................. 31
PMS User Commands ................................................... 32
- 2 -
TINY-2/MICRO-2 Operating Manual, 4th Ed. 1990
PACKET RADIO PROTOCOL ................................................................ 33
Physical Layer ........................................................................ 33
Data Link Layer ...................................................................... 33
HDLC Frames ......................................................................... 34
AX.25 Level Two ..................................................................... 34
Channel Use and Timing ......................................................... 36
Channel Flow Control .............................................................. 37
PACKET CONTROLLER COMMANDS .......................................... 38
Parameters ............................................................................ 38
Command Groups ................................................................... 40
Command List ........................................................................ 41
MESSAGES
General Messages ................................................................... 85
Command Mode Error Messages .............................................. 86
Link Status Messages .............................................................. 87
PMS Messages ....................................................................... 89
PMS Response Messages ......................................................... 89
PMS Error Messages ............................................................... 91
NOTE: Please be sure to read any errata, manual changes or software notes that accompany your manual and packet controller. These documents will describe all changes and upgrades made to your unit.
- 3 -
TINY-2/MICRO-2 Operating Manual, 4th Ed. 1990
INTRODUCTION
The purpose of the PacComm packet controller is to act as an interface between an ordinary voice radio, such as a VHF or UHF FM transceiver, and a computer. The packet controller will establish error-free radio communications between your computer and another Packet-Radio equipped sta­tion. You will be able to have a "private channel" while sharing a frequency with other packet sta­tions, operate remote computer "bulletin board" or electronic mail" stations, send messages, – in short, to enjoy all the advantages of digital communication via your radio system.
This OPERATING MANUAL explains how the packet controller operates and contains a detailed breakdown of the various commands the packet controller will accept and messages it may report, as well as a description of Packet-Radio protocol.
The COMMAND REFERENCE CARD contains a listing of packet controller commands in a conven­ient form for reference while you are operating. These two documents are written to apply to the entire line of PacComm amateur products, and may contain descriptions of commands not included in the firmware on every model.
There is a TECHNICAL REFERENCE MANUAL for each series of PacComm packet controller. Refer to the TECHNICAL REFERENCE MANUAL for details on interfacing your packet controller to specific computers and radios. The TECHNICAL REFERENCE MANUAL also contains details about the specif­ic features of the packet controller to which it applies.
The term "packet controller" was chosen to refer to the PacComm equipment throughout this man­ual. Other terms commonly used are packet assembler/disassembler, terminal node controller (TNC) packet modem, packet interface, etc. The term "computer" is used to refer to the computer or terminal which is connected to the packet controller.
Computer and Radio Interfacing
The packet controller communicates with your computer through a serial port using RS-232C sig­nal levels. Some models also_support 'TTL' level signals to interface to such popular computers as the Commodore VIC-20, C-64, and C-128 without requiring the use of an RS-232 adaptor. The seri­al port connector(s) are on the rear panel of the packet controller. Purchase or build a cable that connects to the serial port connector of your computer and the RS-232 (or TTL) connector of your packet controller. The RS-232 cable should be wired for connection from a computer (Data Termi­nation Equipment - DTE) to a modem (Data Communication Equipment - DCE). See the TECHNI­CAL REFERENCE MANUAL for detailed computer interfacing information for specific packet control­ler models. PacComm supplies the mating connectors for all of the packet controller connectors. Complete cables for most popular computers are also available from PacComm.
Software Requirements
Any Software that enables your computer to operate with an ordinary telephone modem should work with your packet controller. There are many sources of free or low cost communication soft­ware for use with a packet controller. Check your local packet radio Bulletin Board System (BBS), local telephone BBS, Public Domain Software vendors in computer magazines and at Hamfests and Computer Shows.
Software specially written for packet data communications for both personal and business use for many popular computers is available for sale from PacComm.
- 4 -
TINY-2/MICRO-2 Operating Manual, 4th Ed. 1990
Radio Interfacing
The packet controller was designed to allow hook up and testing to be done without any modifica­tions to the radio or any signal level balancing devices in the cables. The packet controller's audio signals are fed directly into the microphone connector or similarly connected auxiliary jack of the radio, and the packet controller output is adjusted to give a proper modulation level. The receiver audio is taken from an auxiliary audio output or speaker jack on the radio and fed directly to the packet controller. Refer to the TECHNICAL REFERENCE MANUAL for detailed instructions for your model of packet controller.
Other Information
The information contained in this document has been carefully checked and is believed to be en­tirely reliable, however, no responsibility is assumed for inaccuracies. PacComm reserves the right to change products or documentation for any purpose including improvement of reliability and functionality without obligation to purchasers of previous equipment. PacComm assumes no liabili­ty arising out of the application or use of any product or circuit described herein; neither does it convey any license under its patent rights or the rights of others.
- 5 -
TINY-2/MICRO-2 Operating Manual, 4th Ed. 1990
OPERATING INSTRUCTIONS
Verifying Serial Port Operation
You may use either UPPER CASE (capital letters) or lower case (small letters) when you enter com­mands. The shortest acceptable form of each command will be shown in upper case in all the ex­amples. In order to have your packet controller accept a command line, you must finish the line with a <CR>, or carriage return character. This won't be mentioned again in the examples below. Before you type the final <CR> of your command, you can correct typing mistakes or cancel the line completely.
This manual will show commands and packet controller responses in a box which roughly simu­lates a screen display. In examples showing input typed by the user together with the responses of the packet controller, the user s input will be boldfaced.
Whenever the packet controller accepts a command which changes a value, it displays the previ­ous value to remind you of what you have done, and indicate that the value has been successfully changed. For example, if you type
cmd:Xflow OFF
you might see the display
Xflow was ON
cmd:
If you type something your packet controller can't understand you will get the unrecognized com­mand error message
?unknown command
If you get a command name correctly, but the arguments are wrong, you will see the message
?parameter
Connect the packet controller to the computer with a properly configured serial cable. Turn the computer on and start the terminal program. Follow the directions for the program you are using to set the computer's baud rate to 1200 bauds, 8 bits, no parity and 1 stop bit. The packet control­ler is delivered configured to operate at that speed and settings for the terminal unless otherwise indicated on the Errata Sheet. See the TECHNICAL REFERENCE MANUAL for details.
Turn on your packet controller. You should see the following display.
| A
PacComm [model] packet controller AX.25 Level 2 Version 2.0 FEATURES: Release X n.n.n Ym mm/dd/yy - nnK RAM Checksum $xx cmd:
- 6 -
TINY-2/MICRO-2 Operating Manual, 4th Ed. 1990
The first five lines are the sign-on message, which you will normally see only when you power up the packet controller. The line following FEATURES: will contain a list of optional firmware features included in this EPROM. See the Errata for values of N, nn, Y, m and xx for your model of packet controller.
The Command Mode prompt, cmd: will appear when the packet controller is in Command Mode and is ready to accept your instructions. If you see nothing, switch off your packet controller for a few seconds, then on again. If you still see nothing, verify your wiring and restart your terminal program.
Serial Port parameters
If messages from your packet controller appear garbled, with incorrectly displayed characters, you may need to change the parity and word length of either the computer terminal, the packet con­troller, or both. The most common parity and word length combinations are 8 bits, no parity (the packet controller default), and 7 bits, even parity. The packet controller default will probably be ac­cepted even if your computer actually uses the latter setting. If your computer receives 8 bits as data, you may have to set space parity, since text may otherwise be interpreted as graphics or oth­er special characters. To set 7 bits, space parity, use the combination immediately below. To return to 7 bits, even parity, set the second combination:
AWlen 8 (8-bit words) AWlen 7 (7-bit words) PARity 0 (no parity bit) PARity 3 (even parity)
One of these combinations will satisfy most computers. You are more likely to require a different setting if you have a terminal rather than a computer, or if you have configured your terminal port for some special application If your computer requires odd parity, set PARity 1. If your computer detects framing errors, try one of the following settings:
For shorter characters. For longer characters
AWlen 7 (7-bit words) AWLen 8 (8-bit words) PARity 0 (no parity bit) PARity 1 or PARity 3
Some computers will lose the first characters of a line when several lines are typed in rapid succes­sion, for example, in the sign-on message. You can give the computer more time between lines by setting NUer ON (delay after <CR>), or NULf ON (delay after <LF>). The amount of delay is ad­justed by NULLs, which sets a number of character-times for the delay.
You may see two characters on your screen for every character you type, for example:
cmd:EECCHHOO
In this case your computer is echoing the characters you type, and the packet controller is also echoing them. Set Echo OFF to stop the packet controllers echoes. If you later use your packet controller with a different computer, or different terminal program, and nothing is displayed when you type, set Echo ON.
If the packet controllers sign-on message lines appear to be typed over each other, you should set AUtolf ON. If the packet controllers sign-on message appears to be double-spaced, you should set AUtolf OFF. If the packet controllers sign-on message appears to be single-spaced, you have AUtolf set correctly. If you change equipment you may have to set AUtolf ON to restore the pack­et controllers automatic linefeeds.
- 7 -
TINY-2/MICRO-2 Operating Manual, 4th Ed. 1990
If you are able to enter one command successfully and then begin receiving the ?unknown com- mand message set LFIgnore ON, or set your computer terminal to send only a <CR> when the ENTER key is pressed.
If you make mistakes while entering commands to the packet controller, you can make corrections. To erase the last character you typed, enter a <BACKSPACE> character. The packet controller will throw away the last character you typed (unless you are at the beginning of a line) and try to erase the character from your screen. Input editing will be discussed in more detail in the section, "Special Input Characters".
The screen-width parameter (Screenln) defaults to 0, since most computers automatically insert a <CR> to format lines to the screen width. If Screenln is non-zero the packet controller will send an extra <CR> (or <CR><LF> if AUtotf is ON) when the Screenln number of characters have sent. If your computer does not automatically break long lines, you will need to set Screenln to the width of your display. For example, using a TV set for a display, you would set Screenln to 23 or 40.
Some PacComm packet controller models have a BAud command for changing the terminal (and radio) data rates, while other models use switches or hardware Jumpers.
See the packet controller TECHNICAL REFERENCE MANUAL to learn which method is employed on your packet controller. Complete information on the BAud command is included in the Commands Listing.
Beginning Packet Operation
This section will guide you through the basics of packet radio operation with the packet controller. Packet radio has a great deal of power and flexibility, and this section only scratches the surface of your packet station's capabilities. However, it contains the basic information required to begin op­eration.
First Steps
Type the text, MYcall XXXXXX, following the command mode prompt. Of course, you should substitute your station CALLSIGN for
cmd:MYcall XXXXXX was NOCALL cmd:
Your CALLSIGN will be used by the packet controller as its "address." The packet controller re­sponds with the previous value of the MYcall parameter, and gives a new Command Mode prompt Now try typing just the command by itself:
cmd:MYcall MYCALL XXXXXX
XXXXXX
. Don't forget the <CR> at the end of the line.
This verifies that the packet controller accepted your CALLSIGN. You can see the current value of most parameters by typing the command that sets the parameter followed by just a <CR>.
Most commands can be abbreviated, and the minimum abbreviations for each command are given in the commands listings in this manual and on the COMMAND REFERENCE CARD. For the sake of clarity, only the full command names are used in this manual.
- 8 -
TINY-2/MICRO-2 Operating Manual, 4th Ed. 1990
Your First Packet Connection
Although there are still a number of features you should be familiar with for comfortable packet operation, you are probably eager to try out your packet controller. Have another packet operator help you get started. Make sure that he will be close enough to ensure solid signals, with no FM "popcorn" noise. Try to have both stations in the same room and operate on low power or into dummy loads.
Turn on your computer and the packet controller. Be sure you have adjusted your packet controller and radio according to the methods described in TECHNICAL REFERENCE MANUAL. When the oth­er station transmits, the DCD LED on your packet controller should glow steadily for the duration of the transmission. You can work through the remainder of the examples in this chapter while you try out your packet controller on the air. Remember to set your radio squelch control so no noise is being heard from the radio except during packet transmissions.
Packet radio connections are started by a connect process, which sets up the "handshaking" be­tween the two stations that insures error-free communications. Connections are terminated by a disconnect process, which leaves both stations free to start new connections.
Starting the Connection
You are ready to initiate a connection. For the sake of example, we will continue to use N2WX in place of your call sign, and we will use K4GFG for the other station's call. Make sure you are in Command Mode, and type:
cmd:Connect K4GFG
After a moment you should see the message
*** CONNECTED to K4GFG
and you will be in Converse Mode. The other station will see the message
*** CONNECTED to N2WX
and he will also be in Converse Mode. If you have trouble connecting, make sure your microphone drive level is set properly. It may be helpful to have an experienced packet operator listen to your transmissions.
If you monitor the radio transmit indicators and listen to the speaker audio from the two radios, you will have a better idea of what is happening. Your radio will be inactive most of the time, even while you are actually typing. When you get to the end of a line and type a <CR>, your radio will be keyed briefly and the other station will hear the "brrrraaaap" sound on his speaker. As your message is displayed on his computer screen, his radio will be keyed for an even shorter time and you will hear a "brraap" on your speaker. This is the ACK, or packet acknowledgment coming back. Your packet controller takes note that the packet was received correctly, but nothing is displayed on your screen.
In the example above, your packet controller entered Converse Mode automatically after the con­nect took place. To return to Command Mode,you must enter a special character, Control-C (abbre­viated <CTRL-C>), or else send a BREAK signal. "Control" characters are usually entered by hold­ing down a special control key and then typing another key without releasing the control key. If your keyboard doesn't have a key marked CTRL or something similar, consult the documentation
- 9 -
TINY-2/MICRO-2 Operating Manual, 4th Ed. 1990
for your computer or terminal program to see how to enter control characters. A BREAK signal is a special transmission (not an ASCII character) which your computer may be able to produce.
NOTE: If <CTRL-C> will cause your computer to do something to interfere with packet operations, such as halting the terminal program, and you can't send BREAK Signals, you will have to change the character that returns you to Command Mode. See the section on "Special Input Characters" below.
Now type a <CTRL-C>. The packet controller doesn't echo the <CTRL-C>, but you should immedi­ately see a Command Mode prompt. To terminate the connection, you must type the Disconnect command. The packet controller will transmit packets terminating the conversation and notify you when the disconnect is complete:
cmd:Disconnect *** DISCONNECTED
An actual connection might be ended by the other station. In that case, you would see the *** DISCONNECTED message without having issued the command.
In Case of Difficulty
If there is difficulty getting a connection established, you can try the following procedure. Both sta­tions should set Monitor ON, then enter Converse Mode and send some packets. Each station should display the packets sent by the other. If only one station is "hearing" properly, you can con­centrate on the modulator and transmitter of that station and the demodulator and receiver of the other station. You can try experimenting with the TXDelay timing parameter for the sending pack­et controller. Set TXDelay 64 for a long delay. If this solves the problem, try shorter and shorter de­lays and use the smallest value that works consistently.
Digital Repeating (Digipeating)
You may wish to have a connection with another packet station that is beyond your direct radio range. If a third packet station is on the air, that station can relay your packets. You set up the packet routing when you initiate the connection. Your packet controller will then automatically in­clude the routing information in the packets it sends.
The diagram below shows a Situation in which digipeating is useful.
AD7I
N2WX ______/\______ KE8CW
You are station N2WX, and you want to have a packet connection with KE8CW, who is not in direct range. However there is a station AD7I, which is in range of both you and KE8CW.
You direct the packet controller to set up a connection to KE8CW using AD7I as an intermediate digipeater as follows:
cmd:Connect KE8CW Via AD7I
- 10 -
TINY-2/MICRO-2 Operating Manual, 4th Ed. 1990
You can specify a routing list of up to eight intermediate stations. For example, consider a modifi­cation of the example above:
N2WX ______/\______ KE8CW
K4NTA W2VY
You can contact KE8CW by going through K4NTA and W2VY. This time you issue the connect com­mand like this:
cmd:Connect KE8CW Via K4NTA, W2VY
You specify the digipeaters in the order you would encounter them going from your station to the station to which you wish to connect
Your station can also act as a digipeater for other stations. This doesn't require any special actions on your part. Digipeating may be disabled by the command DIGIpeat OFF. The command MYAIias will allow setting an alternate callsign for your packet controller for digipeater identifica­tion.
When an alias callsign is set, the controller will digipeat frames addressed to either MYcall or MYAlias callsigns, but will accept connections only to MYcall.
Now that you are on the air, you can try out the packet controller's digipeating capabilities. This is more realistic if you have at least three stations participating, but you can get the feel for it with two stations. Return to Command Mode and disconnect from the other station and issue a new connect command:
<CTRL-C>
cmd:Disconnect ***DISCONNECTED cmd:Connect N2WX VIA K4GFG
(Remember to use actual callsigns, not the ones in the examples.). You are initiating a connect to yourself. You transmit packets to the other stations packet controller, which relays them back to you. When the connection is established you see
*** CONNECTED to N2WX VIA K4GFG
and you will be in Converse Mode. Monitor the radio transmit indicators and listen to the speaker audio. See if you can follow the packets and the acknowledgements back and forth. The other op­erator won't see anything displayed on his computer and his packet controllers state won't be af­fected at all by your connection. In fact, the other station could carry on a separate conversation completely independently.
Unsuccessful Connections
Sometimes you will initiate a connect sequence that can't be completed. The station may not be on the air, or it may not be within range of your station. You may have even mistyped the other call sign. If the packet controller does not get a response to its first connect packet, it will try again. You can control the number of attempts the packet controller will make with the command REtry. The default number of retry attempts is 10. If the packet controller doesn't get an answer after this number of transmissions, it will give up and display the message
- 11 -
TINY-2/MICRO-2 Operating Manual, 4th Ed. 1990
*** retry count exceeded *** DISCONNECTED
The retry count is also used once the connection has started. Each transmission sent to the other station is "acknowledged," or ACKed by the other station, and vice versa. The ACK means that the packet was received and that the CRC checksum indicated that it was received without errors. This is the means by which packet radio can ensure error-free communications. Sometimes a packet won't be received correctly by the other station, either because of accidental interference from an­other packet station (a collision), or because of other channel noise. If your packet controller doesn't get an ACK soon enough, it retransmits the packet and increments the retry count. If the count set by REtry is exceeded, the packet controller will automatically disconnect and send the same message shown above.
The number of tries may be determined at any time by entering the command TRies.
The automatic disconnect feature keeps a packet controller from indefinitely retransmitting a pack­et and tying up the channel under hopeless conditions. If you are operating under special condi­tions you can set REtry 0 to disable automatic disconnects (the retry limit is never reached).
If unacknowledged data packets existed at the time of the disconnection, the packet controller will send all of these data packets as Unnumbered Information (UI) frames. To prevent the dumping of these frames over the air, set the command TXUIfram OFF.
If you have a connection established but wish to change the path being used (the sequence of sta­tions listed after the VIA in the connect command) use the REConnect command. This command is used WHILE ALREADY CONNECTED. For example, if a connection exists to W2VY via N2DSY and you wish to change the path to be W2VY via KD6TH, N2DSY, issue the command
cmd:REConnect W2VY via KD6TH, N2DSY
Monitoring Channel Activity
The packet controller can allow you to monitor packet activity on the channel. Monitoring is ena­bled or disabled by the Monitor command.
cmd:Monitor ON cmd:was OFF
If you also want to see any intermediate digipeater stations being used, you can set MRpt ON. This feature would be useful if you later want to connect to one of the stations you are monitoring and will need a digipeater route in order to reach it. For example:
KF4EF > KF4LG,W4ORA:Hello, Bill!
This packet was sent from KF4EF via W4ORA to KF4LG.
If there are several digipeaters, or if the message lines are long, the display may be difficult to read. You can put the address header on a separate line from the text by setting HEaderln ON:
KF4EF > KF4LG,W4ORA: Hello, Bill!
- 12 -
TINY-2/MICRO-2 Operating Manual, 4th Ed. 1990
Ordinarily, your packet controller will stop displaying monitored packets if you connect to another station, permitting you to converse without interruption. If you want to monitor activity while con­nected to a packet station, set MCon ON.
If you want to monitor without the display of any callsigns, set ADdrdisp OFF. This would cause the last example above to be displayed as:
Hello Bill!
The ADdrdisp command is mainly useful to monitor the packets from a single station. Use the com­mands LCAlls and BUdlist to limit monitored packets to those of one station. If monitored frames seem to be double spaced when using ADdrdisp, set CRAfterOFF.
To display a list of stations heard since the last time your packet controller was powered up, type the command MHeard. The last eighteen packet stations heard by your packet controller are dis­played. The entry "K4NTA*" means that K4NTA was heard via a digipeater rather than directly. If the time-of-day clock is set, the date and time each station was most recently heard will also be displayed.
The Heard Log has an expanded format which includes the type of station heard. If the received frames can be identified properly, the term NODE, BBS or PMS will be added to the Heard Log en­try following the callsign for that station.
Nodes are identified by the transmission of a level 3 type of frame. BBS and PMS stations are iden­tified by an identification field of the format [XXX-xxxx], e.g. [PMS-3.0-C$]. Some BBS programs do not conform to this format and will not be identified in the Heard Log. Nodes may be misidenti­fied when handling BBS or PMS messages.
cmd:mh
W4DPH-15 BBS 07/30/90 17:31:12
K0ZXF BBS 07/30/90 17:31:11
W8DUV* BBS 07/30/90 17:26:14
CLW5 NODE 07/30/90 16:55:00
DAB5 NODE 07/30/90 16:50:35
K4HFL 07/30/90 16:50:09
W4MUA-1 07/30/90 16:46:23
W8DUV-15 BBS 07/30/90 16:43:46
You can clear the "heard log" with the command MHClear.
You can see the settings of the monitor parameters described above by typing DISPlay Monitor.
Special Characters
The packet controller recognizes a number of special characters for input editing, flow control, and other control functions. You may change any of these special characters. Most of the characters are set by commands which specify the ASCII character code for the desired character. You can disable any special character feature by setting the character value to 0. Input editing characters may be disabled with no serious effects. You should use caution in disabling the flow-control or Command Mode entry characters. Also be careful not to set two special characters to the same val­ue.
- 13 -
TINY-2/MICRO-2 Operating Manual, 4th Ed. 1990
Special characters are normally set to various control characters. Control characters are entered by holding down a special control key while typing the other key. For example, control-C, or <CTRL­C> is entered by holding down the control key while typing C. If your computer doesn't have a special control key you will have to consult your computers documentation to see now to enter these characters. If you have difficulty entering control characters, you can change the special characters to, for example, seldom used punctuation.
The action of each special character is described in detail under the entry in the Commands and Messages Section for the command that sets that character. You can enter the code for a character in either hexadecimal (HEX, base 16) or decimal notation. The packet controller displays character codes in hex. A number of hex notation is indicated by beginning the number with a $. The "digits" of a hex number represent multiples of the powers of 16. The values 10 through 15 are represent­ed by the letters A through F, which may be upper or lower case. For example: $1B = 1 × 16 + 11 = 27. A table of ASCII codes for control characters appears below.
Special Input Characters
The character used to return to Command Mode from Converse Mode is by default a <CTRL-C>. (Sending a BREAK signal also works.) (This character does nothing in Command Mode, so if you accidentally enter it twice you won't mess up the next command line.) You can change the Com­mand Mode entry character with the command COMmand. You can choose any character for this function, by entering the ASCII character code for the key. For example, you can use a <CTRL-E> to enter Command Mode by setting
cmd:COMmand 5 was $03
The packet controller displays the previous value in hexadecimal notation (hex). All of the special characters described below can be changed in the same way as COMmand. If you set DELete ON, you can erase characters by typing the <DELETE> character; setting DELete OFF returns to using <BACKSPACE>. <BACKSPACE> is more commonly used than <DELETE> by personal computers. If you aren't sure whether your rubout key produces <DELETE> or <BACK-SPACE> characters, try both settings and see which works.
ASCII Codes for Control Characters
Dec Hex Control Mnemonlc Dec Hex Control Mnemonlc
0 $00 <CTRL-@> NUL 17 $11 <CTRL-Q> DC1 1 $01 <CTRL-A> SOH 18 $12 <CTRL-R> DC2 2 $02 <CTRL-B> STX 19 $13 <CTRL-S> DC3 3 $03 <CTRL-C> ETX 20 $14 <CTRL-T> DC4 4 $04 <CTRL-D> EOT 21 $15 <CTRL-U> NAK 5 $05 <CTRL-E> ENQ 22 $16 <CTRL-V> SYN 6 $06 <CTRL-F> ACK 23 $17 <CTRL-W> ETB 7 $07 <CTRL-G> BEL 24 $18 <CTRL-X> CAN 8 $08 <CTRL-H> BS 25 $19 <CTRL-Y> EM 9 $09 <CTRL-I> HT 26 $1A <CTRL-Z> SUB 10 $OA <CTRL-J> LF 27 $1B <CTRL-[> ESC 11 $OB <CTRL-K> VT 28 $1C <CTRL-\> FS 12 $00 <CTRL-L> FF 29 $1D <CTRL-]> GS 13 $OD <CTRL-M> CR 30 $1E <CTRL-^> RS 14 $OE <CTRL-N> SO 31 $1F <CTRL-> US 15 $OF <CTRL-O> Sl 127 $7F <DELETE> DEL 16 $10 <CTRL-P> DLE
- 14 -
TINY-2/MICRO-2 Operating Manual, 4th Ed. 1990
When you rub out a mistyped character, the packet controller will attempt to correct the screen display. If your display doesn't look right after you rub out a character, try setting BKondel OFF. The packet controller will not try to correct the display but will indicate the rubout with a "\" char­acter (<BACKSLASH> ). You can restore display correction by setting BKondel ON.
If you want to cancel a whole line rather than rubbing out the characters one at a time, type <CTRL-X>. The controller will display a <BACKSLASH> followed by <CR> and (in Command Mode) a new prompt:
cmd:Hi, John, how ar <CTRL-X> \ [
You started typing text while in Command Mode.
cmd:
The cancel-line character can be changed to any ASCII character by the command CANline.
If you have changed your input by rubbing out and retyping characters, you may want to see a "fresh" copy of your input, especially if BKondel is set OFF. Type <CTRL-R> to have the controller retype the line you are entering.
cmd:Connect KB7\\\WA7< CTRL-R > \ [
Call sign mistyped.
]
cmd:Connect WA7
Here the user mistyped the first three characters of the call sign and rubbed them out. The packet controller displayed "\" for each character rubbed out The user then retyped the characters cor­rectly and redisplayed the line. He finished typing the call sign on the new line. The redisplay-line character can be changed to any ASCII character by the command REDisplay.
If your packet controller displays information faster than you can read it before it scrolls off the screen, you may halt the display by typing <CTRL-S>. To resume scrolling, enter <CTRL-Q>. These characters can be changed to any ASCII character by the commands STOp and STArt.
]
You can include any character in a packet, including any special character, by prefixing it with the pass character, <CTRL-V>. For example
I wasn't at the meeting.<CTRL-V><CR>
What happened?
Ordinarily, this message would be sent as two packets. By prefixing the first <CR> with <CTRL­V>, it is sent all at once, but maintains the <CR> in the text The pass character can be changed to any ASCII character by the command PASs.
Operating Modes
The packet controller has four operating modes. Two of these modes, Command Mode and Con­verse Mode, were discussed above. The third mode, Transparent Mode, is a data-transfer mode like Converse Mode but is intended primarily for computer data interchange rather than human conversation. The other data-transfer mode, KISS, is a specialized data-transfer mode for use for MicroSat satellite access and the TCP/IP protocol.
- 15 -
TINY-2/MICRO-2 Operating Manual, 4th Ed. 1990
Command Mode
Command Mode is used to enter commands which alter the packet controllers operating parame­ters. The other modes are entered from Command Mode. When the packet controller is in Com­mand Mode, the Command Mode prompt, cmd: is printed at the beginning of each input line. Note, however, that if the packet controller has received and displayed packets, the prompt may have scrolled off the screen.
The packet controller will be in Command Mode when power is turned on. After a power-off, pow­er-on sequence, or the restart command, all operating parameters of the packet controller are re­initialized to the parameter stored in battery backed-up RAM (bbRAM). After the RESET command is issued all operating parameters are reset to the default values stored in EPROM. You probably won't use this command often. The packet controller will automatically reload the bbRAM from EPROM at power up if it finds that the data is bad.
The following commands set special characters which are active in Command Mode.
CANline Cancel current line CANPac Cancel Output (Command Mode only) DELete Character deletion PASs Insert following special character REDisplay Re-display current line STArt, STOp User's flow control (sent from computer) XOff, XON Packet unit flow control (sent to computer)
The following commands enable display features which are active in Command Mode.
AUtolf Add <LF> after <CR> (data to term) BKondel Echo after character deletion Echo Automatic echo of serial port input FLow Type-in flow control LCok Lower case translation LFIgnore Line Feed characters ignored NUcr Nulls after <CR> NULf Nulls after <LF> NULLs Null count Screenln Automatic <CR> insertion
Entering Data-Transfer Modes
There are several ways to enter a data-transfer mode from Command Mode. You can type the command CONVerse (or the single-letter command "K" ) to enter Converse Mode or the com­mand TRansparent to enter Transparent Mode, and the packet controller will immediately enter the specified mode. The packet controller will automatically enter a data-transfer mode when a connection is made. You specify the data-transfer mode for automatic entry with the command CONMode:
cmd:CONMode Transparent
cmd:CONMode Converse
specify Transparent Mode and Converse Mode respectively.
- 16 -
TINY-2/MICRO-2 Operating Manual, 4th Ed. 1990
The timing of the automatic entry into data-transfer mode depends on whether you or the other station initiated the connection. If you receive a connect request which your packet controller ac­cepts, you will enter data-transfer mode when the packet controller sends the connect acknowl­edgment (ACK) and displays the message:
*** CONNECTED TO <callsign>
If you initiate the connection with the Connect command, you can control the timing of the mode change using the commands NEwmode and NOmode. If NOmode is OFF and NEwmode is OFF, the mode will change when the connect ACK is received and the *** CONNECTED TO: callsign message is displayed. If NOmode is OFF and NEwmpde is ON, you will enter data-transfer mode immediately, without waiting for a successful connection. Any text sent to the packet controller at this point will be queued up in packets which will wait for a successful connection before being sent. If the connect attempt falls, you will be returned to Command Mode. You will also be re­turned automatically to Command Mode when either station disconnects and ends the QSO.
If the command NOmode is ON, then no mode changes will be made automatically. This is an ideal way to insure control by Software in a host Computer.
KISS Mode
The KISS mode is normally used for placing the packet controller in a simple data transfer mode controlled by the attached host computer. This is used when using Transmission Control Proto­col/Internet Protocol (TCP/IP), or other communication software which interfaces with KISS, such as that used for accessing the MicroSat packet satellites. There is no value in entering the KISS mode unless such operation is contemplated.
To enter the KISS mode, enter the command
cmd:KISs ON
followed by the command
cmd:RESTART
The packet controller will stay in KISS mode despite use of the RESET command or turning the controller OFF. This 'permanent' activation of the KISS mode allows the user to access the KISS function reliably despite power outages or other problems. The battery backed RAM parameters for conventional packet operation are retained for later use.
To exit the KISS mode, the TCP/IP computer must issue the command PARAM AX0 255, or the packet controller must be given a hard reset by removing the backup power from the RAM, or you can do the following from an MS-DOS PC keyboard with most communication programs: 1) Hold down the ALT key, 2) Press keys 1 9 2 on the numeric keypad, 3) Release the ALT key, 4) Hold down the ALT key again, 5) Press keys 2 5 5 on the numeric keypad, and 6) Release the ALT key.
Converse Mode
The data mode used often for ordinary keyboard conversation is Converse Mode. In Converse Mode, the send-packet character causes the input to be packetized for transmission. If you type a full packet-length of characters without typing the send-packet character, your input will be packe­tized and transmitted anyway. The default send-packet character is <CR>, but you can specify any character with the command SEndpac, You may choose to have the send-packet character trans-
- 17 -
TINY-2/MICRO-2 Operating Manual, 4th Ed. 1990
mitted in the packet. If the send-packet character is <CR> it is natural to include it in the packet as part of the text as well as interpreting it as a command. This is accomplished by setting CR ON. If you use another character to force packet transmission, you may set CR OFF and inhibit trans­mission of the send-packet character. If you set the send-packet character to something other than <CR>, you can cancel packets of more than one line with the cancel-packet character, which is set with the command CANPac. Single-line packets can be canceled with either the cancel-line charac­ter or the cancel-packet character.
The following commands set special characters which are active in Converse Mode.
CANline Cancel current line CANPac Cancel current packet COMmand Command Mode entry DELete Character deletion MFilter Monitored characters to be filtered PASs Insert following special character REDisplay Re-display current line SEndpac Send current packet STArt, STOp User's flow control (sent to packet unit) XOff, XON Packet unit flow control (sent to computer)
The following commands enable display features which are active in Converse Mode.
8bitconv Retain all serial port bits in converse mode AUtolf Add <LF> after <CR> BKondel Echo after character deletion Echo Automatic echo of serial input EScape <ESCAPE> translation FLow Type-in flow control LCok Lower case translation LFIgnore Line Feed characters ignored NUcr Null characters after <CR> NULf Null characters after <LF> NULLs Null count Screenln Automatic <CR> insertion
Transparent Mode
Converse Mode will often work well for computer data transfer, but files such as a .EXE file on a MS/DOS System, a BASIC program, or even a word-processor text file, may contain characters which conflict with special characters in Converse Mode. If you transfer such files you will have to use Transparent Mode.
Transparent Mode recognizes no special characters – everything you type (or everything your com­puter sends to the packet controller) is sent over the radio exactly as it was received by the packet controller. There are no input editing features and there is no send-packet character, packets are sent at regular time intervals or when a full packet of information is ready. The time interval at which data is packetized is set by PACTime.
The display characteristics of the packet controller are also modified in Transparent Mode. Data is sent to the computer exactly as it is received over the radio, including all 8 bits or each byte re­ceived. Features such as auto-linefeed insertion and screen wrap are disabled, and echoing of in­put characters is disabled. The parameters that control these features in Command Mode and Con­verse Mode are not changed by entering Transparent Mode, and all display features are re-enabled
- 18 -
TINY-2/MICRO-2 Operating Manual, 4th Ed. 1990
when the packet controller is returned to Command Mode. Most of the link status messages that appear as the packet controller moves between disconnected and connected states are also disa­bled in Transparent Mode.
In order to permit the Command Mode entry character to be transmitted freely in Transparent Mode, you utilize the Command Mode entry character in the following way: You must wait for a time period after typing the last character to be sent. This time is set by the command CMdtime. Following this wait, you must type three Command Mode entry characters (default <CTRL-C>) within an interval CMdtime of each other. After a final CMdtime interval in which no characters are typed, you will see the "cmd:" prompt.
If any characters are typed during these CMdtime intervals (even Command Mode entry charac­ters) the escape will be aborted and all the Command Mode entry characters that have been typed will be sent as packet data. If you set CMdtime to zero you will not be able to escape from Trans­parent Mode using this procedure.
You can also enter Command Mode from Transparent Mode by sending a BREAK signal. If the Computer sending data to the packet controller inadvertently sends a data signal interpreted as a BREAK, set BReak OFF to disable the packet controllers response to the signal.
Flow Control
The packet controller's input buffer may fill up in Command Mode if you try to type too long a command. In Converse Mode the buffer may fill up because you are using a faster serial port baud rate than the radio data rate, or radio data transmission may have slowed down because of noise or other users on the channel, or the person or computer at the other end may have stopped out­put from that packet controller. The packet controller will signal the computer to stop sending data when there is room remaining for about 80 characters in the buffer. When the buffer fills up entire­ly, data will be lost. When the buffer empties so that there is room for at least 270 characters, the packet controller will signal the computer to start sending data again.
There are two methods of providing flow control which are supported by the packet controller. XON/XOFF flow control, sometimes called "Software flow control," is accomplished by sending a special character (usually <CTRL-S>) to request that the output stop and another special character (usually <CTRL-Q>) to restart output. Hardware flow control may be used if both computers use the Clear To Send (CTS) and Request To Send (RTS) lines of the RS-232C Standard.
Some commonly used terminal programs and file transfer programs for home computers do not implement flow control in software, and many serial ports do not support hardware flow control. Although the RTS and CTS lines appear at the connector, they may not be used unless the Soft­ware reads the state of the CTS line. If you find that the packet controller seems to lose data dur­ing file transfers, you should immediately suspect a flow control problem.
XON/XOFF Flow Control
If you are using a terminal (rather than a computer) or if your computer does not support RTS/CTS flow control, you should use XON/XOFF flow control, which is enabled by setting Xflow ON. The special flow control characters are set to <CTRL-S> and <CTRL-Q> by default. The com­mands XON and XOff set the characters which will be sent to the terminal by the packet control­ler, and the commands STArt and STOp set the characters to be sent to the packet controller by the terminal. Your computer may receive as many as 4 characters from the packet controller after sending a STOp character, since some characters may already be "enroute" through serial I/O chips.
- 19 -
TINY-2/MICRO-2 Operating Manual, 4th Ed. 1990
If you send a STOp (STArt) character to the packet controller when it is already stopped (started), the character will be ignored. If the STOp and STArt character are the same character, this charac­ter will "toggle" the output, turning it off if it is on, and on if it is off.
You can disable XON/XOFF flow control in one direction only by setting the appropriate flow con­trol characters to 0. If you do this, the packet controller will automatically use CTS flow control to stop input from the terminal. XON/XOFF flow control is normally disabled in Transparent Mode, since all characters are treated as data. If you cannot use RTS/CTS flow control, you may enable the XON and XOff characters (the commands from the packet controller to the terminal) by setting TXFlow ON and Xflow ON. The STArt and STOp characters (the commands to the packet control­ler from the terminal) can be enabled in Transparent Mode by setting TRFlow ON. Note that the mode is no longer truly transparent when these features are enabled.
Hardware Flow Control
Hardware flow control is less likely to depend on the programming of a particular communications program. RTS and CTS are normally used for flow control signals in Transparent Mode. The com­mand Xflow OFF enables hardware flow control in Converse Mode and Command Mode. Your com­puter may receive as many as 2 characters after it signals the packet controller to stop sending, since some characters may already be "enroute" through serial I/O chips. Refer to the TECHNICAL REFERENCE MANUAL for details on the interface required for hardware flow control.
Type-in Flow Control
Type-in flow control, enabled with the command FLow, is really a display feature which keeps the packet controller from interrupting you with incoming packets. As soon as you type the first char­acter of a line, the packet controller will put a "hold" on all output (except for echoing your input). The "hold" remains in effect until you type a <CR> to end. the command line, or a send-packet character to mark the end of a packet, or until you erase or re-display the line you have started. This is most helpful if you are not using a split screen communication program.
Station Idenfication
Your station identification (callsign) is set with the command MYcall, as described previously. If you will have more than one station on the air operating with the same callsign, they must be dis­tinguished – no two stations can have identical station identifications, or the packet protocol will fail. You can distinguish additional stations by setting the "secondary station ID, or SSID. This is a number from 0 to 15, appended to the callsign with a dash:
cmd:MYcall DC7XJ-3
If you don't specify the SSID extension, it will be 0, however the packet controller won't explicitly display SSIDs that are 0. If you want to connect to a station with a SSID other than 0, or use such a station as a digipeater, you must specify the SSID:
cmd:Connect N4KPU-2
or
cmd:Connect WB9FLW VIA N7CL-5
- 20 -
TINY-2/MICRO-2 Operating Manual, 4th Ed. 1990
The packet controller can send an automatic identification packet every 9-½ minutes. You can en­able this with the command HId ON. An ID packet is displayed as follows by a monitoring station:
K4RHD-3 > ID:K4RHD/R
You can request a final identification as you take your station off the air with the command Id. The packet controller will only send identification packets if it has been digipeating.
Automatic Operations
Unattended (automatic) operation is legal in the USA on frequencies above 30 MHz. Check the lat­est FCC rule book or the governing authority in your country.
Unattended Connections
Your station will normally accept a connect request from another station if it isn't already connect­ed or if multiple connections are enabled. You can disable this capability by setting CONOk OFF. If a connect request is received when when CONOk is OFF, the packet controller will display the mes­sage:
*** connect request: <callsign>
and send a "busy signal" rejection packet to the other station. If you receive a rejection packet from a station you try to connect to, your packet controller will display
*** <callsign> busy *** DISCONNECTED
If you want to have a special 'connect message' sent automatically to stations connecting to you, you can specify the message with the command CText. This message can consist of any text string up to 120 characters, and you may include <CR>s by prefixing them with the pass character (CTRL-V):
cmd:CText Sorry, I can't talk right now.<CTRL-V><CR> I'll be on the air again after 8 PM. Joe<CR>
In order for this message to be sent, CONOk must be ON so that the connection takes place (de­fault), and CMSg ON. You can cause your packet controller to issue a disconnect request as soon as the connect message is acknowledged by issuing the command CMSGDisc ON.
NOTE: Turn CMSGDisc OFF when you resume in-person operation of your station to prevent pre­mature disconnects.
If you want to leave your station on but inhibit transmitting, you can set XMitok OFF. If you do this, you would normally set CONOk OFF as well.
Beaconing
You can have your station periodically send an automatic message by enabling "beacons". The beacon message is set with the command BText, which works the same way as the CText com-
- 21 -
TINY-2/MICRO-2 Operating Manual, 4th Ed. 1990
mand. You enable beacon transmission and set the frequency at which beacons are sent with the command Beacon. To transmit the beacon at 30 minute intervals, give the command
cmd:Beacon Every 180
The beacon function also has a transmit-after mode, enabled by using the keyword AFTER in place of EVERY, in which a beacon packet is only transmitted after activity is heard on the channel. This feature might be used to leave an announcement for other packet users. If someone transmits on an otherwise idle channel, a beacon can be sent a short time later. No beacons are sent in this mode if there is a lot of packet activity on the channel, since the required period of quiet will not occur.
Use the Beacon feature with caution since much needless interference may be caused to other users of the channel by careless beaconing.
Connect Alarm
The command CBell ON will cause a 'bell' character (CTRL-G, $07) to be sent to the terminal each time a connection is established.
Packet Formatting
The maximum length of a packet is determined by the command Paclen. If you type more than the maximum number of characters without entering a send-packet character, the packet control­ler will transmit a maximum-length packet. In Transparent Mode, a packet will be sent if the maxi­mum number of characters is entered before the delay conditions set by PACTime force a packet to be sent. (Older controllers may not accept packets longer than 128 characters.)
If you have set the send-packet character to <CR>, you probably want the <CR> to be included in the packet for display at the other end. If you set the send-packet character to a special non-print­ing character, you probably want the character to be treated as a command only. The command CR controls whether the send-packet character is to be echoed and included in the packet.
You can add a <LF> after each <CR> included in your packets by setting LFadd ON. If the other station reports that lines are overprinted on his display, and he can't remedy the situation at his end, you can enable this function.
Commands Affecting Protocol
The packet controller implements AX.25 Level 2 Version 2 protocol, a set of rules for formatting messages to other packet controllers. This may be set to Version 1 with the command Ax2512v2 OFF. Digipeating may not be successful if some packet controllers are running Version 1.0 and some are running Version 2.0.
You can specify the "address" to be used for unconnected packets, as well as intermediate digi­peaters with the Unproto(col) command. The format is similar to that of the Connect command:
cmd:Unprotocol QST Via WU4W
The default address for unconnected packets is CQ.
- 22 -
TINY-2/MICRO-2 Operating Manual, 4th Ed. 1990
The following functions may be useful for tracking down protocol problems. They are seldom use­ful for ordinary packet operations. The error-checking function of the protocol is disabled for moni­tored packets with the command PASSAll. If you set PASSAll ON, any "packet" will be displayed if it meets the following conditions: It must start with a flag sequence; and it must contain an inte­gral number of 8-bit bytes. The TRACe command enables the display of the address and control fields of packets, as well as the text. The trace function displays all bytes in hex as well as ASCII equivalents.
Packet Transmit Timing
Radio equipment requires a time delay for switching between transmit and receive modes. If the packet controller starts sending data before the transmitter is operating or before the receiver has had time to switch from transmitting and lock up on the incoming signal, the packet will not be re­ceived properly. The delay between transmitter keyup and the beginning of data transmission is controlled by the command TXDelay. During the time the packet controller is keying the transmit­ter but not sending data, it will transmit a synchronizing signal (flags).
If you are transmitting packets through a voice repeater, you may require a considerably greater keyup delay than is required for direct communications. Furthermore, the extra keyup delay is not required if the repeater has not had time to "drop" since the last transmission. The command AXDelay allows you to specify an additional keyup delay to allow the repeater receiver and trans­mitter to lock up. The command AXHang sets the time the packet controller will assume is re­quired for the repeater to drop. If the packet controller has detected channel activity recently enough that the repeater transmitter should still be on, it will wait only the TXDelay time before sending data, rather than adding an AXDelay time as well. The commands TXDelay, AXDelay, and AXHang all set times in units of 10 ms.
Packet Timing
The AX.25 protocol provides for retransmitting packets if no acknowledgment is heard from the in­tended destination station within a certain period of time. A packet might not be acknowledged due to channel noise or "collision" with another packet transmission, and since there may be other stations on the channel, the receiving station may not be able to acknowledge the received packet immediately. The time lapse before the originating station retransmits the packet is set the com­mand FRack (frame acknowledge time). Do not set FRack to a small value as this will cause un­necessary retries, especially on HF.
The maximum number of re-transmissions before the originating station terminates the connection is set by the command REtry. The maximum number of transmissions of a packet is REtry+1, since the initial transmission does not count as a retransmission. Setting REtry to 0 specifies an in­finite number of retries.
Acknowledgments of digipeated packets are made from end to end, and digipeaters do not ac­knowledge the packets they relay. If there are several intermediate relays, the chance of either the original packet or the acknowledgment to be lost increases drastically. To reduce this problem, an automatic wait time can be imposed on any station not transmitting a digipeated packet. This usu­ally gives the digipeater a clear chance at the channel. The wait time is set by the command DWait, which specifies 40 ms intervals. If no digipeating is being done in the local area, this pa­rameter can be set to 0, but in any event it should be set to the same value by all members of a local packet group.
In order to avoid unnecessary packet retries, the packet controller implements a collision-avoid­ance strategy which applies to all packets except those being digipeated. On the second and sub­sequent transmissions of a particular packet, the packet controller waits an additional random time
- 23 -
TINY-2/MICRO-2 Operating Manual, 4th Ed. 1990
after detecting a clear channel before beginning transmission. This prevents repeated collisions of transmissions by the same two stations. The random time is a multiple (0-15) of the TXDelay time. The interval, in milliseconds, between the packet controller detecting carrier-drop and beginning to transmit is
• Wait time = DWait × 10
for the first transmission of a packet. For subsequent transmissions of the same packet the interval is
• Wait time = DWait × 10 + (r × TXDelay) × 10
where r is a random number from 0 to 15. Thus, if your packet controller is forced to retransmit packets, you will occasionally hear a fairly long delay before transmission begins.
Multiple packets may be transmitted before waiting for an acknowledgment. This permits more ef­ficient channel use when large amounts of data are being transferred. The maximum number of packets which the packet controller will send before waiting for acknowledgment is specified by the command MAXframe. MAXframe in combination with Paclen, which sets the maximum num­ber of characters in a packet, determines how much information can be sent in a single transmis­sion.
Alternate Transmit Timing
An alternate method of transmit timing called P-Persistance may be implemented by the command PPersist ON. (This disables the retry timing using FRAck.) This timing method is most effective if all users on a channel make use of it.
Persist uses the Parameters PErsist and SLottime. When a frame is queued for transmission and the DCD is not active, a transmit/wait decision will be made based comparing a random number between 0 and 255 to the value of Persist.
If the random number is less than the PErsist value, the channel is seized. If not, then a delay of SLottime is timed, and the random number/PErsist calculation is repeated. Thus large values for PErsist and small values for SLottime produce the most aggressive channel access, and small val­ues for PErsist and large values for SLottime produce the most civilized channel access.
Special Protocol Times
You can set up a connection timeout with the command CHeck, which specifies a time in multiples of 10-second intervals. This function prevents your packet controller from getting stuck in a con­nection when the other station disappears for longer than the specified time. The packet controller uses this time some-what differently depending on the setting of Ax25l2v2.
The command RESptime sets a delay between the receipt of a packet and the transmission of the acknowledgment packet. This delay is used to prevent collision between an acknowledgment and another packet from the sending station. This is primarily necessary during file transfers; otherwise the delay is best set to 0 (default). During file transfers the stations receiving the file should set RESptime to 10 or 12.
The timing of packet transmission in Transparent Mode is determined by the command PACTime. You can choose the way packet transmission is timed. If you are typing input to a remote comput­er it is usually best to have packets transmitted at regular intervals. If your computer is operating a remote host or bulletin board program you should send packets after an interval with no further
- 24 -
TINY-2/MICRO-2 Operating Manual, 4th Ed. 1990
input from the computer. You can enable the use of PACTime in Converse Mode with the command
CPactime.
Monitor Functions
Monitoring of packets not addressed to your station is enabled by the command Monitor ON, and separate monitor functions are individually enabled.
The command MAil OFF causes the packet controller monitor function to ignore connected pack­ets. If you want to be able to monitor packet activity when your station is not connected, but have all monitoring automatically cease when you connect to someone, set MCon OFF.
To monitor stations selectively, you can set up a list of up to eight callsigns with the command LCAlls. The callsigns in this list are regarded as "buddies," i.e., the only stations you want to listen to if BUdlist is ON. Otherwise, the stations in the list will be ignored, and all other stations will be monitored.
You can operate a group conversation with some data integrity by having the stations connect in pairs and setting MAil ON and MCon ON. This does not insure that every packet is received at ev­ery station, but it does insure that a packet involved in a collision will be retried. If you have an odd number of stations participating in this sort of conversation, one station can connect to him­self via another station as digipeater.
Ordinarily, only text packets are displayed. If you desire to monitor all packet activity on frequency including all of the 'supervisory' frames that contain no user data, set MCOM ON. This allows ev­ery correctly received frame to be displayed. For example:
WA7GXD>KV7D <I C S0 R0>:Hi Dan,
WA7GXD>KV7D <I C P Sl R0>:been on HF?
KV7D>WA7GXD <RR R F R2>
KV7D> WA7GXD < I C P Sl R2>:no, 10 meters is dead.
The abbreviations are explained in the protocol section.
You can cause the packet controller to "filter" certain characters from monitored packets with the command MFilter.
This allows you to remove, for example, form-feeds, bell characters, or clear-screen characters that may be necessary to the stations involved in a connection, but which may interfere with your display. You can specify up to four characters by giving the ASCII character codes in hex or deci­mal.
The command PId ON will eliminate the display of received frames whose Protocol Identifier (PID) is not $F0. This should prevent most unwanted 'NODE' transmissions.
"Health" Featuers
The CON and STA LEDs can be made to indicate the condition of the processor in place of their normal functions. The command HEALled ON will cause the two LEDs to turn on and off in a se­quential pattern if the processor is properly executing the software. HEALled OFF returns the LEDs to their normal functions.
Twenty five counters, all of them 16 bits wide, are provided to monitor a number of parameters in the packet controller. They are ALWAYS initialized to 0000 on power up or "RESTART". The coun-
- 25 -
TINY-2/MICRO-2 Operating Manual, 4th Ed. 1990
ters and the setting of HEALled (HEALTH LED) are displayed in response to the command DISPlay HEALTH.
ASYFRERR: Asynchronous Framing Error. Incremented when a receive framing error is detected on the serial port IC.
ASYQOVER: Asynchronous Overflow Error. Incremented each time a character was received by the serial port IC but not accepted by the firmware.
ASYRXOVR: Asynchronous Receive Overflow Error. Increases when the software does not service the asynchro­nous receiver in time. Indicates data from the user to the packet controller is being dropped.
BBFAILED: Battery Backed RSM failures. Counts number of times bbRAM checksum was in error.
DIGISENT: Digipeated Frames Sent. Each frame digipeated by this packet controller causes the counter to in­crease.
HOVRERR: HDLC Overrun Error. Increases when HDLC receiver is not serviced rapidly enough and data is lost.
HUNDRERR: HDLC Underrun Error. Increases when the HDLC transmitter is not serviced rapidly enough and frames are aborted.
PMSCONN: PMS Connections. Increments once for each connection established with MYPCALL.
RCVDFRMR: Received Frame Rejections. Increases when Frame reject frames are received from a connected station.
RCVDIFRA: Received Frames. Increases for each reception of an I-frame from a connectee.
RCVDREJ: Received Reject Frames. Increases for each reception of an REJect frame from a connected sta­tion.
RCVDSABM: Received SABM Frames. Each received SABM frame ad-dressed to the packet controller causes this counter to be increased by one.
RCVDRNR: Received RNR frames. Counts the number of received Receiver NotReady (RNR) frames. Incre­mented each time the connected station sends an RNR because it cannot take any more frames.
RXABORT: Received Aborts. Counts the number of received Abort Signals. Abort Signals are generated by the HDLC chip, not the AX.25 firmware. Abort means, in effect, a cancel frame signal.
RXCOUNT: Received frame count. Increases when any frame is received with good CRC (or any CRC if PASSAll is turned on).
RXERRORS: Received Errors. Increments each time a received frame is thrown out due to it being too short, suffering overrun(s), or it having a bad CRC. Latter occurs only when CRC checking is enabled (i.e. PASSA11 is OFF). This counter will often increment in the presence of noise.
RXLENERR: Received Length Error. Receiver detected a frame less than 15 bytes in length.
RXRESYNC: Receive Resynchronization counter. Increments each time a difference between the received pack­et length and the buffer data length has been detected, causing buffer resyncronization.
- 26 -
TINY-2/MICRO-2 Operating Manual, 4th Ed. 1990
SENTFRMR: Frame Rejects Sent. Increments for each Frame Reject frame transmitted.
SENTIFRA: Information Frames Sent Increases by one for each I frame sent.
SENTREJ: The number of Frame Rejects Sent. Whenever a REJect frame is transmitted, this counter is incre­mented.
SENTRNR: The number of Receive Not Ready (RNR) frames sent. RNR frames are sent when the packet con­troller is unable to accept any more frames, usually due to flow control by the computer.
TXCOUNT: Frames Transmitted Counter. Incremented whenever a frame is correctly transmitted.
TXQOVFLW: Transmit Queue Overflow. Counts how many times frames were discarded because the outgoing frame queue was too small.
TXTMO: Transmitter Timeouts. Counts the number of HDLC transmitter timeouts.
Clock Operations
The packet controller clock is maintained in Software by the Z-80 microprocessor.
You enable the packet controller's real-time clock by setting the date and time with the command DAytime. Once you have set the clock, you request the time by entering DAytime with no pa­rameters. The date and time will be lost each time the packet controller is powered off. The com­mand CLKadj is used to 'tweak' the software clock toward better accuracy. If the clock loses time, increase the value of the CLKadj parameter, n. Large values have a small effect on the time, while small values of n have a large effect on the time.
Since the clock accuracy varies with the amount of activity on the radio channel, it may be impos­sible to get complete clock accuracy.
NOTE: Some PacComm packet controllers have an optional hardware clock which retains the date and time even if the packet controller is powered off.
The formal of date and time display is controlled by the commands DAYusa and AMonth. DAYusa allows selection of a US or European date format and AMonth allows selection of alphabetic or nu­meric month format. The AMonth command does not affect the date format of the Personal Mes­sage System.
Time Stamping
Monitored packets can be time-stamped if DAtime has been set To enable this function, set MStamp ON. You can also time-stamp connect and disconnect messages with the command CON-
Stamp ON.
Special Operations
If you are operating a full-duplex radio station (simultaneous transmit and receive), you should set FUlldup ON. The packet controller is always electrically capable of full duplex operation, but this parameter causes the packet controller will ignore carrier detect status.
- 27 -
TINY-2/MICRO-2 Operating Manual, 4th Ed. 1990
For satellite and other full duplex modes of operation you should set DWait to 0. The random wait before retry transmissions can be disabled by setting TXDelay 0 and AXHang 0 and using AXDe­lay to set the required keyup delay.
Computer Operations
The BBsmsgs command is particularly useful when the packet controller is used with a host com­puter. When ON, the command causes all packet controller messages to either be suppressed or to begin on a fresh line.
The RXblock command should be used when the packet controller is serving a host computer. RXblock is designed for automated operations, such as packet bulletin board stations. It is intend­ed to help such systems discriminate between data received from the connected station and pack­et controller-generated messages.
If unacknowledged data packets exist at the time of a disconnection, the packet controller will send all of these data packets as Unnumbered Information (UI) frames. To prevent the dumping of these frames over the air, set the command TXUIfram to OFF.
The STATus command is useful for allowing a host computer to obtain information about whether a connection exists, whether there are any unacknowledged frames, and whether a pending con­nection or disconnection exists.
HF Operation
Some PacComm packet controllers are equipped with both VHF and HF optimized modems. See the TECHNICAL REFERENCE MANUAL for a description of your controllers capabilities. Dual-modem boards have several additional commands to support HF operation.
The POrt command selects which radio port is in use. The POrt command causes most parameters except callsign to be changed to correspond with the use of the selected port, including the radio baud rate, modem tones, and link timing parameters. If the POrt command is given without an ar­gument, the packet controller responds with the number of the currently selected port. If POrt is given followed by a port number such as:
cmd:PO2
the packet controller switches to the specified port and responds with the number of the previous­ly selected port
was 1
Only packet controllers termed 'DUAL PORT' in the TECHNICAL REFERENCE MANUAL are capable of simultaneous operation of the radio ports. Dual-radio or dual-modem models disconnect the port not currently selected.
Some PacComm packet controllers allow selection of the carrier detect signal (DCD) from either the modem circuit (hardware) or a software algorithm (software). The command SOftdcd ON se­lects the Software type of DCD, while SOfldcd OFF selects the hardware signal for DCD. Consult the TECHNICAL REFERENCE MANUAL to determine if this command applies.
- 28 -
TINY-2/MICRO-2 Operating Manual, 4th Ed. 1990
Multiple Connections
With multiple connections, you may establish simultaneous connections with several stations, and the packet controller will keep the data to and from each connection segregated. The packet con­troller defaults the multi-connect-related parameters to the following 'single connection' values:
CONPerm OFF LCStream OFF STREAMCALl OFF STREAMDbl OFF STReamswitch | USers 1
The key to enabling multiple connections is to set USers to a value greater than 1. If USers is not 1, the packet controller will allow multiple connections (as many as the value of USers) to your sta­tion from other stations. In addition, Transparent mode will operate differently, in that incoming data will be prefixed with the current STReamsw(itch) character and identifier (such as "|A"). Thus, truly transparent operation is not possible while supporting multiple connections.
The STReamsw(itch) character, defaulted to "|", should be set to a character you won't normally use. Note that this character may be set to a hex value between $80 and $FF. This may allow you to use 8-bit characters (AWlen 8) if your terminal or computer is capable of generating such "char­acters". This could help prevent confusion in interpreting incoming data from other stations if they happen to send data that includes your selected STReamswitch character. When operating a single user Mail-Box (BBS) System or other host computer application, it is highly recommended that STReamsw(itch) be set to $00 (disabled).
Although not foolproof, enabling STREAMDbl may also help in sorting out STReamswitch charac­ters included in the received data from a valid stream switches generated by your packet control­ler.
STREAMCall should be especially helpful when manually operating a station in which you allow multiple connections. This command prefixes each new stream of data from the packet controller with the stream identification.
When in command mode the stream may be switched by entering the STReamsw(itch) character (default "|"), followed by a stream identifier ("A" through "J"), followed by the command you wish to give.
cmd:| E C | E Connect in Progress cmd:
When in Converse Mode, you may switch streams by entering the STReamsw(itch) character (de­fault "|"), followed by a stream identifier ("A" through "J ), followed. by the data you wish to send to the station on that stream. See the example in the description of STREAMCall for an illustration of this. Note that the stream identifier must be in upper case (A through J) unless LCStream is set to ON.
When the packet controller firmware contains the Personal Message System (PMS), stream K is used for PMS functions and is displayed as part of the CStatus command display.
- 29 -
TINY-2/MICRO-2 Operating Manual, 4th Ed. 1990
Personal Message System
Warning: The firmware contained in all PacComm EPROMs is copyrighted by PacComm and may not be copied for any purpose.
The PacComm Personal Message System (PMS) is a self-contained message system which operates in all of PacComm's packet controllers. The PMS is contained in an EPROM along with the regular packet firmware. It is a standard feature on most PacComm packet controllers. The PMS allows the packet controller to support all standard packet functions while simultaneously allowing messages to be entered or read by an over-the-air user. PMS requires 32k of RAM to operate. Approximately 13–15k of battery backed RAM is allocated for messages. Messages are retained when the packet controller is powered off. Some PacComm controllers support 512k of RAM for message storage!
The PMS features complete compatibility with current BBS message standards. Message headers are optionally generated to allow tracking of the message in the BBS System. Message headers may be edited to allow message readdressing. To improve operator convenience the PMS supports forwarding from, and reverse forwarding to the local (home) BBS. Automatic forwarding by the PMS is NOT supported to reduce channel congestion. If the PMS is installed on a PacComm control­ler which is equipped with a printer port, messages may be printed directly to the printer at key­board command.
The PMS supports the Bulletin ID (BID). A BBD may be entered following the TO callsign field when using the SEND (or SP or ST) command. The dollar sign character must be present, but the following field may contain up to 28 characters of any type. In standard practice the Dollar sign is followed by a BID number, an underbar character and a callsign. The line must terminate with a carriage return. An example of the BID format:
SP N$UQQ @ K0ZXF $53_N4uQR
The BID does not appear in the message display header in response to the LIST command but does appear in the presentation of each individual message in the following format:
Stat : Posted : To : BID : Subject:
PMS Setup Commands
The packet controller operator is referred to as the PMS SYSOP (system operator). The commands which the SysOp uses to configure the PMS are:
3rdparty AUTOFwd CLKSet HOMebbs
KILONFWD LOGonmsg MSGHdr MYPcall
NODetext PMs REMSysop STExt
To enable the Personal Message System, set PMs ON and enter a callsign in MYPcall. The callsign must NOT be identical to MYcall. Check with other PMS operators in your area to determine what SSID is normally used to identify personal BBSs.
- 30 -
TINY-2/MICRO-2 Operating Manual, 4th Ed. 1990
If the SysOp desires to allow messages to and from other stations to be left on his PMS, set 3rdparty ON. Setting 3rdparty OFF will cause users to be prevented from leaving messages to oth­er than ALL or the PMS callsign. The SysOp may address messages to any callsign regardless of the setting of 3rdparty.
HOMebbs is used to set the callsign of the local BBS which forwards mail to your PMS. The PMS uses BBS forwarding protocol when sending messages to the HOMebbs, but uses a user protocol for all other message transfers.
CLKset ON allows the HOMebbs to automatically set the packet controller to the correct time dur­ing a forwarding session.
AUTOFwd ON causes any messages entered by the SysOp to be automatically marked for for­warding.
KILONFWD ON causes all messages which have been reverse forwarded to be deleted from the PMS to preserve memory capacity for incoming messages.
The NODetext command accepts a connect string for use by the FNPMS command. This connect string is used by the local node to connect to the desired forwarding station.
If the SysOp does not desire the standard PMS logon message to be sent, then set LOGonmsg OFF. A custom logon message of up to 80 characters may be entered in STExt and will be sent each time a station connects to the PMS. If LOGonmsg is ON and STExt contains a message, both will be sent. If LOGonmsg is OFF and STExt is blank, neither message will be sent.
If you are using the reverse forwarding capability of the PMS, set MSGHdr ON to insert a message header in outgoing messages.
The REMSysop ON command causes the PMS to allow the same privileges (read or kill any mes­sage) to the SysOp's callsign over the air as well as from the keyboard.
See the individual command descriptions in the PACKET CONTROLLER COMMANDS chapter for fur­ther information.
PMS Operator Commands
The commands used by the SysOp to operate the PMS are:
EDithdr FOrward FPms FNPms KIll
List MIne PPRint Read SEND
SP SR ST
Note that some of these commands take a different form than used by an over-the-air PMS user (below).
The SysOp may list all messages currently stored in the PMS by entering the List command at his computer keyboard. If only messages addressed to or from the SysOp's PMS station (MYPcall) are of interest, use the MIne command. Messages may be read by entering Read n, where n is the message number of interest. If the packet controller is equipped with a printer port, then messag­es may be sent direct to the printer attached to the packet controller with the command PPRint
n
Messages are deleted by the command KIlln.
- 31 -
.
TINY-2/MICRO-2 Operating Manual, 4th Ed. 1990
If any station has left a message in the PMS since the last time the SysOp accessed it, the PMS LED (STA LED on some models) will blink slowly to indicate that a message is waiting.
To send a message, use the command SEND. If the message is to be sent via the amateur packet BBS system, use the form of the command:
SEND callsign @ bbs-callsign $optional BID.
The command SP is an extension of the SEND command which marks the message as personal or private.
The command ST marks the message as official National Traffic System (NTS) traffic and the text of the message should be entered in NTS format.
The command SR n creates a reply message addressed to the sender of message n.
If an error is made in entering the callsign header, or if a message is to be readdressed, use the EDIthdr command to change the TO or @ callsigns.
To mark a message for automatic reverse forwarding, use the command FOrwardn. If a message is already marked for forwarding and is not to be forwarded, the command FOrwardn will 'un­mark' the message.
Marking messages for forwarding causes no forwarding to take place unless the HOMebbs con­nects to the PMS or the operator uses either the FPms or FNPms command. The FPms is used when the station is reached via a direct connection or via a digipeater string. The FNPms is used when a node exists in the forwarding path.
See the individual command descriptions in the PACKET CONTROLLER COMMANDS chapter for fur­ther information.
PMS User Commands
The commands used by the over-the-air user of PMS are listed below:
(B)ye (H)elp (J)log (KM)
(L)ist (M)ine (R)ead (S)end
(SR) (V)ersion
All user commands consist of one or two letters which are shown in parenthesis. Use of more than the designated letters of the command will result in the message:
[PMS CMD ERR]
To use the PMS, the user simply connects to the PMS callsign. If PMS is ON and no other station is using the PMS, the following messages will be sent after the connection is established:
*** CONNECTED TO (PMS callsign) Logged on to (PMS Callsign)'s Personal Message System
This line may contain an optional custom PMS message
CMD(B/H/J/K/KM/L/M/R/S/SR^//?)>
- 32 -
TINY-2/MICRO-2 Operating Manual, 4th Ed. 1990
See the individual command descriptions in PACKET CONTROLLER COMMANDS chapter for further information.
PACKET RADIO PROTOCOL
The following material is intended to supply an overview of the protocol used to transmit data by the packet controller. It is somewhat tutorial in nature for those who have not had previous expo­sure to layered network protocols, but it presumes some knowledge of general communications hardware and software. Persons already well versed in networking may want to skip this chapter and refer to the primary defining document, Amateur Packet-Radio Link-Layer Protocol, AX.25 Ver­sion 2.0, available from the ARRL, 225 Main Street, Newington, CT 06111.
The PacComm packet controller hardware and software architecture is organized in accordance with the International Standards Organization (ISO) layered network model. The model describes seven levels and is officially known as the ISO Reference Model of Open Systems Interconnection, or simply the ISO Model. The model and many other interesting topics are discussed in
Networks
The ISO model provides for layered processes, each supplying a set of services to a higher level process. The PacComm packet controller currently implements the first two layers, the Physical lay­er and the Data Link layer.
by Andrew S. Tanenbaum.
Computer
Physical Layer
The duty of the Physical Layer, layer one, is to provide for the transmission and reception of data at the bit level. It is concerned only with how each bit is physically transmitted, i.e., voltages on a cable or modem tones on phone or RF links.
The physical layer of the packet controller is described in the TECHNICAL REFERENCE MANUAL. It is compatible with the various packet controllers currently available. The actual modem interface is compatible with the Bell 202 Standard which is similar to the CCITT V.23 standard. Any other hard­ware device which is compatible with the Bell 202 Standard should be compatible with the Pac­Comm packet controller, at least at level one of the ISO reference model.
Data Link Layer
The duty of the Data Link layer is to supply an error-free stream of data to higher levels. Since lev­el one simply passes any bits received to level two and is unaware of the content or overlying structure of the data, transmission errors are not detectable at level one. Level two carries the re­sponsibility of detecting and rejecting bad data, retransmitting rejected data, and detecting the re­ception of duplicate data
Level two accomplishes this task by partitioning data to be transferred by level one into individual frames, each with its own error detection field and frame identification fields. The packet controller supports two versions of a level-two layer, AX.25 Version 1.0 and AX.25 Version 2.0. Each of these protocols is based on HDLC, the High-Level Data Link Control protocol defined by the ISO Version 1 is supported for compatibility with older packet controllers only.
- 33 -
TINY-2/MICRO-2 Operating Manual, 4th Ed. 1990
HDLC Frames
| FLAG | ADDRESS | CONTROL | PID & DATA | FCS | FLAG |
FLAG. A unique bit sequence (01111110) used to detect frame boundaries. A technique called "bit stuffing" is used to keep all other parts of the frame from looking like a flag.
ADDRESS. A field normally specifying the destination address. AX.25 uses a minimum of 14 bytes and a maximum of 70 bytes containing the actual call signs of the source, destination, and option­ally up to eight digipeaters. CONTROL. A byte which identifies the frame type. In the AX.25 protocol, the control field may in­clude frame numbers in one or two 3-bit fields.
PID. A Protocol Identification byte appears as the first byte of the HDLC DATA field in AX.25 Level Two information frames, and identifies which Level 3 protocol is implemented, if any. In the case where no Level 3 protocol is implemented, PID = $F0.
DATA. This field contains the actual information to be transferred. This field need not be present. Most frames used only for link control do not have data fields.
FCS. Frame Check Sequence, a 16-bit error detection field.
The communications chip recognizes the opening and closing flags and passes the address, con­trol, and data (including PID) fields to the Software. The PCS field is a FrameCheckSequence com­puted by the transmitting chip and sent with the frame. The receiving chip recomputes the FCS based on the data received and rejects any frames in which the received FCS does not match the computed FCS. There is virtually no chance of an un-detected bad frame using this method. This satisfies the level two task of bad data detection.
The circuitry used in the packet controller encodes the transmitted data in NRZI form, which enco­des a "0" data bit as a transition in the encoded bit stream and a "1" data bit as no transition. This, in combination with the "bit-stuffing" which ensures that no more than five "1"s occur in a row except when FLAG bytes are being transmitted, guarantees that a logic level transition occurs at least once every 5 bit times. These frequent transitions allow the receiver to synchronize its clock with the transmitter.
While the HDLC format supplied by the communications chips is used by the AX.25 protocol, there are several other Layer Two concerns. These are duplicate frame detection, connection and discon­nection of the level two layers on different packet controllers, and buffer overrun avoidance. The AX.25 protocol solves these problems as described below.
AX.25 Level Two
AX.25 is based on the Balanced Link Access Procedure (LAPB) of the CCITT X.25 standard. LAPB in turn conforms to the HDLC standard. Two extensions are made to LAPB in AX.25. These are the extended address field, and the unnumbered information (UI) frame. In LAPB, addresses are limit­ed to eight bits, while AX.25 uses from 112 to 560 bits, containing the originator's call sign, the destination call sign and an optional list of one to eight digipeater (simplex digital repeater) call signs.
The UI frame is used to send information bypassing the normal flow control and acknowledgment protocol. The UI frame is not acknowledged but can be transmitted at layer two without fear of disturbing higher layers. It is used for beacon frames, for automatic identification packets, and for
- 34 -
TINY-2/MICRO-2 Operating Manual, 4th Ed. 1990
sending information frames when the packet controller is not connected to another packet control­ler, e.g., CQ and QST activities.
The following table lists the frame types used by AX.25 and describes their purpose. This material is provided to give a general understanding of the protocol, and is not intended to replace the pub­lished specification. The byte fields are given as they appear in memory after data is received, i.e., the high order bit is at the left and the low order bit is at the right. This is also the format of the display provided by the TRACe command. Some texts, including the AX.25 protocol specification, list the bits in the order in wich they are transmitted, which is low order bit first.
The table also lists the format of the display of the interpretation of the command byte in each monitored frame when MCOM is turned ON. The basic structure of the MCOM information is:
< cmd_type [(C|R) (P|F)] [Sn] [Rn] >
The "<" and ">" characters are always present, and serve to delimit the new MCOM information. Cmd_type may take any of the values in the right column of the table.
C|R, P|F The C(ommand), R(esponse), P(oll) and F(inal) frame types are only used in AX.25
level 2 Version 2.0 mode. These types are not displayed for packets not using Version 2.0.
SnSn is displayed for sequenced information (I) frames. n is the frame's sequence number
and is an integer 0..7.
RnRn is present in both I frames and RR-RNR-REJ frames. The n value monitored shows the
sequence number that the sending station expects its peer will use for the next new se-
quenced information frame.
The control bytes are presented in hex with "x" used to indicate four bits which depend on the acknowledge functions the packet is performing. Usually "x" is a frame number. Frame numbers fit into three bits and are used to ensure that frames are received in order and that no frames are missed. Since only three bits are available, the frame number is counted modulo 8. The MAXframe parameter has a ceiling of 7: no more than seven frames can be "in flight" (transmitted but unac­knowledged) at once.
AX.25 CONTROL CODES AND MCOM DISPLAY CODES
Code Abrv Frame Type Code Definition x1 x5 x9 03 0F 2F 43 63 87 even
RR RNR REJ UI DM SABM DISC UA FRMR |
Receive Rdy Receive Not Rdy Reject Unnumbered Info Disconnected mode Connect request Disconnect request Unnumbered Ack Frame reject Any frame endlng in a n even number ($A, $C and $E) is an info frame.
C D UA DM FRM UI
RR RNR REJ | I
SABM connect DISC disconnect Unnumbered ACK Disconnected mode Frame reject Unnumbered info, Beacons, Id, etc. Explicit ACK, R field Rcvr not rdy, R field Reject, R fleld Sequenced info frms, both S and R fields.
I This and UI frames are the only frame types containing user data. The control byte contains
this frame's number and the number of the next frame expected to be received from the other
end of the link.
RR Usually used to acknowledge receipt of an I frame. The RR function can also be per-
formed by sending an I frame with an updated "expected next frame number" field.
- 35 -
TINY-2/MICRO-2 Operating Manual, 4th Ed. 1990
RNR Used when the buffer space on the receiving side is full.
REJ Used to request retransmission of frames starting from "x". Missed frames are detected
by receiving a frame number different from that expected.
DM Sent in response to any frame received other than a connect request (SABM) when the
packet controller is disconnected. Sent in response to an SABM whenever the packet controller
can't connect to the requesting user, e.g., if the packet controller is already connected or CON-
Ok is OFF.
SABM Set Asynchronous Balanced Mode - initiates a connect.
DISC Initiates a disconnect.
UA Sent to acknowledge receipt of an SABM or DISC.
FRMR Sent when an abnormal condition occurs, i.e., the control byte received is undefined
or not proper protocol at the time received.
UI An I frame without a frame number. It is not acknowledged.
Channel Use and Timing
The following discussions mention timing parameters which are set by various commands.
An important part of any packet radio protocol is the means by which many stations make efficient use of an RF channel achieving maximum throughput with minimum interference. The basis for this time domain multiplexing is Carrier-Sensed Multiple Access (CSMA) with collision detection and collision avoidance.
CSMA means simply that no station will transmit if the frequency is in use. The packet controller continually monitors for the presence of packet frame flags on frequency and transmits only if there is no activity present. In order to make detection of a busy channel more reliable, the packet controller sends an audio signal (continuous flags) any time the transmitter is keyed and a packet is not being sent, as during the transmitter keyup delay (TXDelay), or while a slow audio repeater is being keyed (AXDelay).
By itself, CSMA is not enough to insure a minimum, or even low, interference rate, due to the likeli­hood of simultaneous keyup by two or more stations. This is where collision detection and collision avoidance come in. The packet controller detects a collision by the absence of an ACK from the station it is sending to. The receiving station does not acknowledge the frame that suffered the collision, since either the FCS was incorrect or the packet was not heard. There are other possible reasons for non-receipt of the packet, but the packet controllers response is based on the assump­tion of a collision.
After transmitting a packet, the packet controller waits a "reasonable" length of time (FRack) for an acknowledgment. "Reasonable" is determined by the link activity, frame length, whether the packet is being digipeated, and other time-related factors. If no ACK is received, the packet must be re-sent. If the unACKed frame was lost due to a collision, the assumption is that there is at least one other packet station out there that also lost a frame and will probably have exactly the same criterion for deciding when to retry the transmission as this station is using.
In order to avoid a second collision, the collision avoidance protocol calls for the stations retrying transmissions to wait a random time interval after hearing the frequency become clear before they key their transmitters. There must be enough different random wait times to provide a reasonable chance of two or more stations selecting different values. The difference between adjacent time values must be similar to the keyup time delay of typical stations on the frequency. This is the time lapse after a station keys its transmitter before other stations detect its presence on the channel, and is a function of the keying circuitry of the transmitter and the signal detection circuitry of the receiver. We have chosen the random time to be a multiple (0–15) of the transmitting station's
- 36 -
TINY-2/MICRO-2 Operating Manual, 4th Ed. 1990
keyup delay (TXDelay). This is reasonable if one's own keyup delay is similar to that or other sta­tions on the channel.
One other factor must be taken into consideration in optimizing data throughput. The currently im­plemented link protocol provide for relaying (digipeating) of packets. The acknowledgment proce­dure for such packets is that the relay station simply repeats packets without acknowledgment to the sending station. The receiving station sends its ACK back through the same digipeaters to the originating station. Since the digipeated packets are not acknowledged to the digipeater, an unsuc­cessful transmission must be retried from scratch by the originating station. In order to help allevi­ate the congestion of the frequency that tends to result when digipeated packets suffer collisions, the digipeater is given first shot at the frequency every time it becomes clear. Other stations, in­stead of transmitting as soon as they hear the channel clear, must wait a short time (DWait). This restriction applies to all stations except the digipeater, which is permitted to transmit relayed pack­ets immediately. This prevents digipeated packets from suffering collisions except on transmission by the originating station.
A special time delay (RESptime) is used as the minimum wait time prior to transmitting acknowl­edgment frames, to prevent packet controllers accepting data at high speed from the asynchro­nous port from colliding with acknowledgment frames when fewer than MAXframe packets are out­standing. The receiving packet controller will wait long enough before sending the ACK so that it will hear the data packet which would have caused the collision, thus avoiding a fairly frequent source of delay in versions of AX.25 prior to 2.0.
Channel Flow Control
Flow control of data through the link is determined by the rate at which data is being supplied to a sending packet controller and accepted from a receiving packet controller.
A packet controller receiving data from the link will send an RNR when the next I-frame successful­ly received will not fit into the buffer for output to the serial port.
Whenever a packet controller transmitting data received from the serial port over the link runs out of temporary buffer space, the serial port will be halted by an XOff character or CTS Signal. In the packet controller implementation this happens whenever there are seven packets built and less than 210 characters left in the buffer for input from the serial port.
When the packet controller receiving data from the link clears out its buffers, it sends an RR to the transmitting packet controller. In order to guard against the possibility of the RR being lost and the link becoming permanently locked, the transmitting packet controller will periodically retransmit the packet that provoked the RNR. The receiving packet controller will continue to respond with RNR until it can accept the packet.
- 37 -
TINY-2/MICRO-2 Operating Manual, 4th Ed. 1990
PACKET CONTROLLER COMMANDS
The following conventions are used in this appendix:
Command Argument(s) Default
Parameter(s)
Packet Controller message to operator or user
Operator or user input
Caution or warning
The command name is printed with some letters underlined and in upper case. These letters form the minimum abbreviation that you may use and still have your packet controller understand the command.
For example, the command MYcall may be specified by simply typing MY. The abbreviation M is not sufficient (and will be interpreted as a different command), but MY, MYC, MYCA, MYCAL or MY­CALL are all acceptable.
Parameters
If a command requires parameters, they will be shown after the command name.
For commands that set values, your packet controller assumes a "most often used" or default con­dition. The defaults are the values stored in EPROM which are loaded into RAM when the system is first powered up, or when you give the RESET command. Immediate commands perform actions rather than setting values, and don't have defaults.
An asterisk (*) after the default value means the default may vary between models.
There are several types of parameters. Some parameters can have one of only two values, such as ON and OFF or Every and After. If a parameter must be one of two values, the choices are shown separated by a vertical bar. You may use Yes instead of ON and No instead of OFF.
A parameter designated as "n" is a numeric value. These values may be entered as ordinary deci­mal numbers, or as hexadecimal (hex), numbers by preceding the number with a $ symbol. When the packet controller shows some of these numeric parameters (those which set special charac­ters), they will be given in hex. The numbers 10 through 15 are denoted by the hexadecimal digits A through F.
A parameter designated as text, such as the argument to CText, may be entered in upper or lower case, and may include numbers, spaces, and punctuation. The text is accepted exactly as typed by the user.
Several commands require callsigns as parameters. They may be any collection of numbers and at least one letter up to six characters; they are used to identify stations sending and receiving pack­ets. A callsign may additionally include sub-station ID (SSID), which is a decimal number from 0 to 15 used to distinguish two or more stations on the air with the same call (such as a base station
- 38 -
TINY-2/MICRO-2 Operating Manual, 4th Ed. 1990
and a repeater). The call sign and SSID are entered and displayed as call-n, e.g., K0PFX-3. If the SSID is not entered, it is set to 0, and SSIDs of 0 are not displayed.
Some commands have parameters which are actually lists of items. For example, you may specify as many as eight callsigns to be selectively monitored with the command LCAlls. The second and later items in the list are optional, and you may separate the list items with blank spaces or with commas. For example:
Beacon Every|After n
means that the command Beacon requires an argument which must be either Every or After (ab­breviated to E or A), and an argument n which the user may choose from a range of values. An ac­ceptable command might be B E 2.
Connect call#1 [VIA call#2 [,call#3...,call#9]]
means that the command connect requires a callsign argument call#1. You may optionally include the Keyword Via, followed by a list of one to eight callsigns, call#2 through call#9. The callsigns in the list, if included, must be separated by commas (as shown), or by blank spaces. An acceptable command might be c N2WX V AD7I WB9FLW. You can see the current value of the command's ar­guments by typing the command name by itself, without any arguments.
- 39 -
Command Groups
TINY-2/MICRO-2 Operating Manual, 4th Ed. 1990
Async [A] commands
8bitconv AUtolf AWlen BBSmsgs BReak DISPlay Echo EScape Flow Lcok NUcr NULf NULLs PARity RXblock Screenln TRFlow TXFlow Xflow
BBS/PMS [B] commands
3rdparty AUTOFwd cLKSet EDithdr FOrward FNPms FPms KIll KILONFWD List LOGonmsg MIne MSGHdr PMs Read REMSysop SEND (SP, ST) SR
character [c] commands
BKondel cANline cANPac cOMmand DELete LcStream PASs REDisplay SEndpac STArt STOp STREAMca STREAMDb STReamsw XOff XON
ID [I] commands
Beacon BText cBell cMSg cMSGDisc cText cWid cWIdtext cWLen HId HOMebbs Id MYAlias MYcall MYPcall NODetext STExt Unproto
Health and Misc [H] commands and counters
BAud cALibra HEALled POrt RESET RESTART SAle SOftdcd
ASYFrerr ASYQover ASyrxovr BBfailed DIGISent HOvrerr HUndrerr PMScomm RcVDFrmr RcVDIfra RcVDRej RcVDRnr RcVDSabm RXAbort RXcount RXErrors RXLenerr RXResync SENTFrmr SENTIfra SENTRej SENTRNR TXcount TXQovflw TXTmo
- 40 -
TINY-2/MICRO-2 Operating Manual, 4th Ed. 1990
Link [L] commands
Ax25L2v2 cONMode connect cONOk cONPerm cONVerse cR cStatus DIGipeat DISconnect FIrmrnr FUllup KISs LFadd LFIgnore MAXframe NEwmode NOmode Paclen PASSAll REconnect REtry STATus TRAce Transparent TRIes TXUifram USers XMitok
Printer [P] commands
PRAUtolf PPRint PRint PRPAge PRPDisc PRPGln PRTTOFf PRTTON PRTTgl PRTUifra
Monitor [M] commands
ADdrdisp AMonth BUdlist cONStamp cRAfter DAYUsa HEaderln LcAlls MAll McOM Mcon MFilter MHclear MHeard Monitor MRpt MStamp PIdcheck
PMS Sysop commands
3rdparty EDithdr FNPms FOrward FPms KIll KILONFWD List MIne MSGHdr PMs Read SEND SP SR ST
Timing [T] commands
AXDelay AXHang cALSet cHeck cLKadj cMdtime cPactime DAytime DWait FRack PAcTime PErsist PPersist RESptime SLottime TXdelay
PMS User commands
Bye Help Jlog Kill KM List Mine Read Send SR Version ?
- 41 -
TINY-2/MICRO-2 Operating Manual, 4th Ed. 1990
Command List
3rdparty ON|OFf or Y|N Default: ON*
ON Allows messages to any callsign. OFF Allows messages to be addressed only to/ from MYPcall *Default may vary
Selects whether PMS messages, are accepted to other than MYPcall (SysOp). When 3rdparty is ON, over-the-air messages may be addressed to- any valid callsign. When 3rdparty is OFF, call­signs which do not exactly match MYPcall will be rejected with the message:
No third party mail allowed
The SysOp may address messages to any callsign.
8bitconv ON|OFf or Y|N Default: OFF
ON The high-order bit is not stripped in converse Mode. OFF The high-order bit is stripped in converse Mode.
This command enables transmission of 8-bit data in converse Mode. If 8bitconv is OFF, the high-or­der bit (bit 7) of characters received from the terminal is removed before the characters are trans­mitted in a packet. The standard ASCII character set requires only 7 bits, and the final bit is used as a parity bit or ignored. Setting bit 7 in text characters transmitted over the air may cause confu­sion at the other end.
If you need to transmit 8-bit data, but don't want all the features of Transparent Mode, you should set 8bitconv ON and AWlen 8. This may be useful if you are using a special non-ASCII character set.
Bit 7 is always removed in command Mode, since commands require only the Standard 7-bit ASCII character set.
ADdrdisp ON|OFf or Y|N Default: ON
ON Address on monitored frames will be displayed. OFF Address on monitored frames will not be displayed.
The ADdrdisp command enables or disables the display of the callsign addresses at the beginning of each monitored frame. The command applies only to the terminal display, not printer output If ADdrdisp is ON, the following display format will be used for monitored frames:
N4UQQ > N4UQR, TPA5* <UI R> :This is a monitored frame.
If ADdrdisp is OFF, the same frame will appear as follows:
This is a monitored frame.
- 42 -
TINY-2/MICRO-2 Operating Manual, 4th Ed. 1990
AMonth ON|OFf or Y|N Default: OFF
ON The month in all system dates will be alphabetic. OFF The month is all System dates will be numeric.
This command allows selection of alphabetic (Jan, Feb,) or numeric (01, 02) format of the month in date displays. If AMonth is ON, the following date display format is used:
Apr-15-90 19:48:01 (DAYUSAON) or 15-Apr-90 19:48:01 (DAYUSAOFF)
If AMonth is OFF, the following date display format is used:
04/15/90 19:48:01 (DAYUSAON) or 15/04/90 19:48:01 (DAYUSAOFF)
AMonth does not affect the PMS date format.
AUTOFwd ON|OFf or Y|N Default: ON
ON PMS messages are automatically marked for forwarding. OFF PMS messages are not marked for forwarding
This command enables automatic marking for forwarding of all messages with a callsign in the @BBS field. This command does not cause forwarding to take place, only marks the message for forwarding. To initiate forwarding, use the FPMS or FNPMS command or wait for your HOMEBBS to reverse forward.
AUtolf ON|OFf or Y|N Default: ON
ON A linefeed character <LF> is sent to the terminal after each carriage return character
<CR>.
OFF A <LF> is not sent to the terminal after each <CR>.
AUtolf controls the display of carriage return characters received in packets as well as echoing those that are typed in.
This command only affects what is displayed, not the data sent in packets. If you want to add line­feed characters to outgoing packets, use the command LFadd.
AWlen
n
= 7 – 8, the number of data bits per word. *Default may vary
n
Default: 8 *
This value defines the word length used by the serial IO terminal port. To transmit and receive packets retaining all 8 data bits of each character, as you need to do if you send executable files or other special data, you should use Transparent Mode and set AWlen 8. Alternatively, you can use converse Mode and set AWlen 8 and 8bitconv ON (however, the data you then send must handle the Converse Mode special characters with the PASs prefix).
- 43 -
TINY-2/MICRO-2 Operating Manual, 4th Ed. 1990
AX25l2v2 ON|OFf or Y|N Default:ON
ON The packet controller uses AX25 Level 2 Version 2.0 OFF The packet controller uses AX25 Level 2 Version 1.0
Some implementations of the earlier version of AX.25 protocol won't properly digipeat version 2.0 AX25 packets. This command exists to provide compatibility with these other packet controllers. See also CHeck.
AXDelay
n
= 0 – 180, voice repeater keyup delay in 10 ms increments.
n
Default: 0
AXDelay specifies a period of time the packet controller is to wait, in addition to the normal delay set by TXDelay, after keying the transmitter and before data is sent. This feature will be used when a standard '"voice" repeater is used to extend range. You will have to experiment to find the best value for n. Note that this command acts in conjunction with AXHang.
AXHang
n
= 0 – 20, voice repeater hang time in 100 ms increments
n
Default: 0
This value can be used to increase channel efficiency when a voice repeater with a hang time greater than 100 ms is used. For a repeater with a long rang time, it is not necessary to wait for the repeater keyup delay after keying the transmitter if the repeater is still transmitting. If the packet controller has heard a packet sent within the hang period, it will not add the repeater key­up delay (AXDelay) to the keyup time.
BAud
NOTE: This command does not apply to all models
BAud is an immediate command which displays the current terminal and radio baud rates and presents a selection menu. This command may be used at any time without changing the link state. Of course the RADIO baud rate should not be changed if a connection exists.
The initial portion of the BAud display lists the current data rate of both the terminal port and the radio port in use. The second portion of the display lists all supported radio and terminal baud rates and gives a command letter for each. The final portion of the display is the selection com­mand prompt.
If the BAud command was entered in error or if you desire just to display the current baud rates, simply enter the letter X<CR> to return to the command prompt without making any changes.
The display appears as follows:
- 44 -
TINY-2/MICRO-2 Operating Manual, 4th Ed. 1990
Radio: 300 Terminal: 1200
Baud Rates Radio Terminal A- 300 L- 300 B- 400 M- 1200 C- 600 N- 2400 D- 1200 O- 4800 E- 1800 P- 9600 F- 2400 Q- 19200 G- 4800 H- 9600 I- 19200
X Make changes
Select?
If you wish to change either the radio or terminal baud rate, enter the letter which corresponds to the desired baud rate. The menu will reappear to allow correction or additional selections. When you are ready to accept the changes, enter the letter X <CR>. The desired baud rates will take ef­fect immediately after the X response.
BBSmsgs ON|OFf or Y|N Default:ON
This command controls how the packet controller displays certain messages in COMMAND and CONVERSE modes.
MESSAGE EFFECT OF BBSMSGS - ON
*** CONNECTED TO XXXXXX Message appears on a new line *** DISCONNECTED Message appears on a new line *** retry limit exceeded Message appears on a new line *** XXXXXX Busy Message appears on a new line *** FRMR sent Message appears on a new line *** FRMR received Message appears on a new line *** Connect request: XXXXXX This message is omitted
The BBSmsgs command is primarily useful for host operation with bulletin board software that re­quire link state messages to begin in the first display column.
- 45 -
TINY-2/MICRO-2 Operating Manual, 4th Ed. 1990
Beacon Every|After
n
Default: E 0
EVERY Beacon at regular intervals. AFTER Beacon after specified interval with no activity.
n
= 0 – 250, beacon timing in 10 second intervals.
This command enables beacon sending and causes the first beacon frame to be transmitted. A beacon frame consists of the text of BText in a packet addressed to "BEACON" and sent via the digipeat addresses specified by the Unproto command.
If the keyword Every is specified, a beacon packet is sent every n × 10 seconds. If After is speci­fied, a beacon is sent only after n × 10 seconds have passed with no packet activity. In this case, the beacon is sent only once until further activity is detected. This mode can be used to send an­nouncements or test messages only when packet stations are on the air.
NOTE: If BText is blank, no beacons will be sent.
BKondel ON|OFf or Y|N Default:ON
ON <BACKSPACE><SPACE><BACKSPACE> is echoed when a character is deleted. OFF The <BACKSLASH> (\) is echoed when a character is deleted.
This command determines the way the display is updated to reflect a character deletion in Com­mand or Converse Mode. The <BACKSPACE><SPACE><BACKSPACE> sequence will properly up­date the screen of a video display. If YOU have a video display terminal or computer, you should set BKondel ON. If you have a paper-output display, or if your terminal does not respond to the <BACKSPACE> character (<CTRL-H>), you should set BKondel OFF.
BReak ON|OFf Default: ON
ON The BREAK signal operates as described in the manual. OFF The BREAK signal is ignored by the packet controller.
The BReak command controls enabling or disabling packet controller response to the BREAK sig­nal. The BREAK is a 'space' condition on the serial data input line for longer than two character times which can be generated by many computers and terminals. Some devices will generate an inadvertent BREAK signal during initialization which may force the packet controller into Command Mode. Setting BReak to OFF eliminates this.
BText
text
Any combination of 120 characters and spaces
text
Default: blank
BText specifies the content of the data portion of a beacon packet. The default text is blank, i. e., no message. You can send multiple-line messages in your beacon by including carriage return <CR> characters in the text. The <CR> character can be included by preceding it with the pass character.
If you enter a text string longer than 120 characters, an error message will appear and the com­mand will be ignored.
To clear the BText text without using the RESET command, use a % or & as the first character in the text.
NOTE: No beacons will be sent if BTEXT is null.
- 46 -
TINY-2/MICRO-2 Operating Manual, 4th Ed. 1990
BUdlist ON|OFf or Y|N Default: OFF
ON Ignore frames from stations which are not in the LCAlls list. OFF Ignore frames from stations which are listed in LCAlls.
Monitor works in conjunction with the command LCAlls, which sets up a callsign list These com­mands determine which packets will be displayed when you have set Monitor ON. BUdlist specifies whether the callsigns in the list are the ones you want to ignore or, alternatively, are the only ones you want to listen to.
(B)ye
A command used by a PMS over-the-air user.
BYE disconnects the user from the PMS with these messages:
- Logged off ***DISCONNECTED
There will be a short (up to 10 second) delay after the "***logged off" message is received be­fore the PMS issues the disconnect request. If a connection exists to PMS and there is no activity on the radio port for approximately 5 minutes, the PMS will issue a disconnect request.
CALibrate
This command does not apply to all models of PacComm packet controllers. Refer to the TECHNI­CAL REFERENCE MANUAL for details about calibration procedures and the operation of this com­mand.
CALibrate is an immediate command, and is used to transfer control to the modem tone genera­tion routine. The CALibrate command may be performed at any time without altering the current link state.
The commands available in the calibration routine are:
<SPACE> Switch the transmit audio to the other tone. K Toggle PTT line on/off. D Alternately pulse both tones. Q Quit calibration routine.
CALSet
n
Default: none
n
= 0 – 65535 setting the count setting for the calibration routine.
This command does not apply to all models of PacComm packet controllers. Refer to the TECHNI­CAL MANUAL for details.
The number to be specified by CALSet is determined by the frequency to be calibrated as follows:
modulator tones:
n
= (525,000 /f) + 1
demodulator tones:n = (262,5007 /f) + 1
n
Round
to the nearest integer.
- 47 -
TINY-2/MICRO-2 Operating Manual, 4th Ed. 1990
CANline
n
= 0 – $7F, specifying an ASCII character code.
n
Default: $18 {CTRL-X}
This command is used to change the cancel-line input editing command character. The parameter
n
is the ASCII code for the character you want to type in order to cancel an input line. You can en­ter the code in either hex or decimal. For example, to change the cancel-line character to <CTRL­U>, you would set CANline $15 or CANline 21.
If you cancel an input line in Command Mode, the line will be terminated with a <BACKSLASH> character, and you will see a new cmd: prompt. If you cancel a line in Converse Mode, you will see only the <BACKSLASH> and a new line. You can cancel only the line you are currently typing. Once a <CR> has been entered, you can not cancel an input line using the cancel-line character. Note that if your send-packet character is not <CR>, the cancel-line character will cancel only the last line of a multi-line packet. To cancel the entire packet, use the CANPAC character. Line cancel­lation, like other input editing features, is disabled in Trans Mode.
CANPac
n
= 0 – $7F, specifying an ASCII character code.
n
Default: $19 {CTRL-Y}
CANPac is used to change the cancel-packet input editing command character. The parameter n is the ASCII code for the character you want to type in order to cancel an input packet. You can en­ter the code in either hex or decimal.
If you cancel a packet in Converse Mode, the line will be terminated with a <BACKSLASH> charac­ter and a new line. You can only cancel the packet that is currently being entered. Once you have typed the send-packet character, or waited PACTime (if CPactime enabled), the packet can not be canceled even if it has not been transmitted.
Packet cancellation, like other input editing features, is disabled in Transparent Mode.
The cancel-packet character also functions to cancel display out-put in Command Mode. If you are in Command Mode and type the cancel-packet character, any characters that would be typed on the screen (except echoed characters) are "thrown away by the packet controller. Typing the can­cel-output character a second time restores output.
To see how this works, try typing DISPlay, then type a <CTRL-Y>. The command list display will stop. You won't see any response from the packet controller to commands. Now type another <CTRL-Y>, and type DISPlay again to show the display is back to normal.
CBell ON|OFf or Y|N Default: OFF
ON A bell character is sent with the connect message. OFF No bell character is included in the connect message.
The CBell command is used to control whether an ASCII $07 (BELL) character is sent as part of the connected message. When set ON, the bell character immediately precedes the asterisk por­tion of the connected indication. This command is not related to the MFilter command. CBell will produce a 'CONNECT BELL' even if MFilter is set to delete incoming $07 (BELL) characters.
- 48 -
TINY-2/MICRO-2 Operating Manual, 4th Ed. 1990
CHeck
n
= 0 – 250, specifying the check time in 10 second intervals. A value of 0 disables this feature.
n
Default: 30
This command sets a connection timeout. When your packet controller and another station are connected, and the other station "disappears" the packet controller will try to clean up the link if the specified time elapses without any packets being heard from the other packet controller. This feature depends on the setting of AX25L2V2.
If AX25L2V2 is ON, the packet controller will send a "check packet" if no packets have been heard from it for n × 10 seconds. If the receiving packet controller is still connected, it sends an appro­priate response packet. If the packet controller initiating the inquiry does not hear a response after RETRY +1 attempts, it commences a disconnect sequence, as if the Disconnect command had been given.
If AX25L2V2 is OFF and the other station has not been heard for n × 10 seconds, the packet con­troller will not attempt an inquiry, but will send a disconnect frame.
CLKADJ
n
= 0 – 65535, specifying the real-time clock speed-up factor.
n
Default: 0
This command allows the clock speed to be increased to compensate for the tendency to lose time when the radio port is very active. If the value of CLKADJ is non-zero, then the correction factor is calculated as: relative clock speed in % = 100 + (9.16667 × 1/n). NOTE: A small value of n has a large effect on the clock speed, a large value of n has a small effect. A value of "0" means no cor­rection will be applied.
CLKSet ON|OFf or Y|N Default: ON
ON The controller will accept clock update from home BBS. OFF The controller ignores clock updates.
If CLKSet is ON and the HOMebbs supports clock updating, the date and time of the packet con­troller will be updated to the BBS date and time when the home BBS connects to the PMS callsign.
CMdtime
n
= 0 – 250, Transparent Mode timeout value in seconds.
n
Default: 1
This command sets the Transparent Mode timeout value. The same Command Mode entry charac­ter is used for exit from both Converse Mode and Transparent Mode. Three Command Mode entry characters must be entered less than n seconds apart, with no intervening characters, after a de­lay of n seconds since the last characters were typed. After a final delay of n seconds, the packet controller will exit Transparent Mode and enter Command Mode. You should then see the prompt "cmd:". If n is zero, the only exit from Transparent mode is sending a BREAK to the controller.
CMSg ON|OFf or Y|N Default: OFF
ON A text message is sent when a connection is established. OFF The text message is not sent.
CMSG enables automatic sending of the message set by CTEXT whenever your packet controller accepts a connect request.
- 49 -
TINY-2/MICRO-2 Operating Manual, 4th Ed. 1990
CMSGDisc ON|OFf or Y|N Default: OFF
ON The packet controller will disconnect immediately after acknowledgement of the CTEXT
sent by CMSG command
OFF The controller will not disconnect after sending CMSG.
CMSGDisc controls whether the controller will disconnect after the packet containing connect text (CTEXT) is acknowledged.
If you receive connects with immediate disconnects and never receive any data, it's possible CMSGDISC is (inadvertently) on.
COMmand
n
= 0 – $7F, specifying an ASCII character code,
n
Default: $03 {CTRL-C}
This command is used to change the Command Mode entry character. You can enter the code in either hex or decimal. Command Mode is entered from Converse Mode when this character is typ­ed. If you type the Command Mode entry character while you are already in Command Mode, nothing happens.
See CMdtime for Information on how the Command Mode entry character is used to escape from Transparent Mode.
CONMode Conv|Tran Default: Conv
Conv Sets entry to Converse Mode when connection begins. Tran Sets entry to Transparent Mode when connection begins.
CONMode controls which mode the packet controller will be placed in after a connection. The con­nection may result either from a radio connect request or a keyboard command. If you initiate a connection from the keyboard, the timing of the mode change is determined by NEwmode.
If the packet controller is already in Converse or Transparent Mode when the connection is com­pleted, the mode will not be changed. If you have typed part or a command line when the connec­tion is completed, the mode change will not take place until you complete the command or cancel the line to prevent the last part of your command from inadvertently being sent as data.
Connect call#1 [Via call#2[,call#3...,call#9]]
call#1 Callsign of packet controller to be connected to. call#2 Optional callsign of station to act as digipeater.
Connect is an immediate command. It initiates a connect request to packet controller call#1, op­tionally through one or more digipeaters.
The bracketed part of the command line, "VIA call#2[,call#3...,call#9]" is optional. The double­bracketed text, ",call#3...,call#9," would only be used if Via call#2 is present. The brackets are not typed.
Each callsign may include an optional sub-station ID specified as "-n" immediately following the callsign. The digipeat fields are specified in the order in which you want them to relay the packets to the destination, call#1.
- 50 -
TINY-2/MICRO-2 Operating Manual, 4th Ed. 1990
If NEwmode is ON, the packet controller will immediately enter Converse or Transparent Mode, as specified by the CONMode. If NEwmode is OFF, the packet controller will enter Converse or Trans­parent Mode when the connection is successfully completed.
An error message is returned if the controller is in a connected state, or is attempting to connect or disconnect. If no response to the connect request occurs after REtry attempts, the command is aborted and a failure message is displayed.
CONOk ON|OFf or Y|N Default: ON
ON Connect requests will be accepted. OFF Connect requests will be rejected.
This command determines the action taken by the packet controller when it receives a connect re­quest. If CONOk is ON, the request will be acknowledged, the standard connect message will be typed and either Converse or Transparent Mode will be entered, depending on the setting of CON­Mode.
If CONOk is OFF and the packet controller is not in Transparent Mode, a connect request will dis­play this message:
connect request: XXXXXX (
callsign of station attempting to connect
)
The packet controller will issue a DM packet, or "busy signal" to the requesting station. If your packet controller receives a DM packet in response to a connect request, it will display:
XXXXXX Station busy (callsign to which connect was attempted)
CONPerm ON|OFf or Y|N Default: OFF
ON The current connection on the current stream will not be allowed to enter the disconnected
state.
OFF The current stream connects and disconnects normally.
CONPerm ON forces the packet controller to always maintain the current connection, even when frames to the other station exceed REtry attempts to get an acknowledgment.
RESTART and power off/on cycling will not affect this connected state. This command only takes effect when a connection is established. It functions on a stream-by-stream basis when multiple connections are allowed.
CONStamp ON|OFf or Y|N Default: OFF
ON Connect status messages are time stamped. OFF Connect status messages are not time stamped.
This command enables time stamping of *** CONNECTED Status messages. The date and time in­formation is then available for use by computer application programs.
The date and time must be set initially by the DAytime command before time stamping will occur. The date format is determined by the DAYUsa command.
- 51 -
TINY-2/MICRO-2 Operating Manual, 4th Ed. 1990
For example, if CONStamp is ON, DAYUsa is ON, and the date and time have been set, a connect message might appear as follows:
CONNECTED to N2WX [05/28/85 16:28:31]
CONVerse
NOTE: The letter K is an alias for CONVerse allowing convenient single key transfer to converse mode.
CONVerse is an immediate command which causes the packet controller to change from Command Mode into Converse Mode. Any link connections are not affected. Once in Converse Mode, every­thing you type is packetized and transmitted. Typing the Command Mode entry character returns the packet controller to the Command Mode.
CPactime ON|OFf or Y|N Default: OFF
ON Packet timeout is used in Converse Mode. OFF Packet timeout is not used in Converse Mode.
This command enables the periodic automatic sending of packets in Converse Mode. After CPac­time has elapsed since the last frame was transmitted, any characters which have been input from the terminal will be transmitted. The SEndpac character appearing in the text will also trigger transmission of a packet.
If CPactime is ON, characters are packetized and transmitted periodically as they are in Transpar­ent Mode, but local editing and display features of Converse Mode are enabled and software con­trol may be used. For a discussion of periodic packetizing, see the command PACTime, which con­trols the rate and mode of packet assembly.
You should set CR OFF in this mode, since otherwise the Sendpacket character will be inserted in the data being packetized even though it was not typed. In order to include <CR> characters in transmitted packets, set SEndpac to a normally unused character (e.g., <LF><CR>), at which point the packet controller will treat <CR> as an ordinary character.
CPactime ON provides a mode of operation in which your text is transmitted soon after you type it, out in short bursts of a few characters. It eliminates the delays while long packets are being typed.
CR ON|OFf or Y|N Default: ON
ON The send-packet character, normally <CR>, is appended to all packets sent in Converse
Mode.
OFF The send-packet character is not appended to packets.
When CR is ON, all packets sent in Converse Mode will include, as the last character of the packet, the send-packet character which forces the packet to be sent. If CR is OFF the send-packet char­acter is interpreted solely as a command to the packet controller, not as data to be included in the packet, and it will not be echoed to the terminal.
Setting CR ON and SEndpac $0D results in a natural conversation mode. Each line is sent when a <CR> is entered, and arrives at its destination with a <CR> at the end of the line. If the station at the other end reports overprinting of lines on his display, set LFadd ON, or the other station can set AUtolf ON.
- 52 -
TINY-2/MICRO-2 Operating Manual, 4th Ed. 1990
CRAfter ON|OFf Default: ON
ON A carriage return <CR> is sent after each frame. OFF Monitored frames are displayed without adding a <CR>.
A carriage return character <CR> ($0D) is normally added to the end of each monitored frame. CRAfter allows the elimination of the <CR> character for proper display of some types of frames. CRAfter affects both the terminal and printer ports.
CStatus
CStatus is an immediate command which shows the stream identifier and link state of all streams (links), the current input and output streams, and whether or not each stream is "permanent" (see CONPerm). An example of a CStatus display:
cmd:
CS
A stream - IO Link state is: CONNECTED to 305MLB B stream - Link state is: CONNECTED to AD7I-2 P C stream - Link state is: DISCONNECTED D stream - Link state is: CONNECTED to N0ADI via K9NG
The example above shows the A stream is the currently selected or active stream for both input and output, which is indicated by the I and O symbols. The B stream is connected to AD7I "perma­nently". All other streams' states are shown as they might normally appear with multiple connec­tions.
CText
text
Any combination of up to 120 characters and spaces.
text
Default: blank
CTEXT specifies the text of the packet to be sent after a connection is made, if CMSG is ON. The default text is blank, i.e., no message.
You can send multiple-line messages by including carriage return (<CR>) characters in the text. The <CR> character can be included by using the pass character (default value CTRL-V) immedi­ately preceding it (see the PASS command). If you enter a text string longer than 120 characters, an error message will appear and the command will be ignored.
To clear the CTEXT, use a RESET command, or enter % or &.
CWid Every|After
n
Default: E 0
EVERY Send CWID at regular intervals. AFTER Send CWID once if any activity during interval.
n
= 0 – 250 specifying CWID timing in 100 second intervals. A value of 0 disables the CWID.
The CWid command enables CW identification (if CWIdtext not blank) and sets the timing interval. Every/After works similarly to Beacon command except n is the number of 100 millisecond inter­vals. (Export only)
- 53 -
TINY-2/MICRO-2 Operating Manual, 4th Ed. 1990
CWIdtext
text
Up to 32 characters of text to be sent as CWID. Accepts all alphabetic, numeric, and common punctuation characters. The length of CWID is limited by the packet controller PTT watchdog timer. At 20 wpm, about 13 characters may be sent. (Export only)
CWLen
n
The CWID speed is set by specifying the relative dot length. The default CWLen setting of 6 yields approximately 20 wpm. A CWLen of 7 yields 10 wpm, and a CWLen of 3 yields 40 wpm. (Export only)
DAytime
Any combination of 32 characters, numbers, and spaces which have significance in Interna­tional Morse.
1 to 7 specifying the relative length of CWID dots.
yymmddmm
This command allows you to set the current date and time for the packet controller. The format is yymmddhhmm where yy is the last two digits of the year, mm is the two-digit month code (01-12),
dd
is date (01-31), hh is the hour (00-23), and mm is the minutes after the hour (00-59). All these
codes must be exactly two digits, so that numbers from 0 to 9 must be entered with leading zeros.
text
n
yymmddhhmm
Current date and time to set.
Default: blank
Default: 6
No Default
The date & time parameter is used by the commands CONStamp and MStamp to "time stamp" re­ceived frames. Entries in the "heard log (displayed by MHeard) are time stamped if date & time has been set. If you type DAytime witnout a parameter, the controller will display the current date and time.
DAYUsa ON|OFf or Y|N Default: ON*
ON Date is displayed in the format mm/dd/yy. * Export OFF Date is displayed in the format dd-mm-yy. Default: OFF
This command determines the format for the packet controllers display of the date. If DAYUsa is ON, the Standard U.S. format is used; if DAYUsa is OFF, the standard European format is used.
This command affects the format of the date display used in "time stamps" as well as the display when DAytime is entered without parameters.
The format for entering the time using DAytime is not affected.
DELete ON|OFf or Y|N Default: OFF
ON The delete character editing key is <DELETE> ($7F). OFF The delete character editing key is <BACKSPACE> ($08).
This command is used to change the input editing command for character deletion. When this character is typed, the last character from the input line is deleted. How the packet controller indi­cates the deletion is controlled by the BKondel command.
You cannot use this character to delete past the beginning of a line, although you can delete <CR> characters that have been entered in the text with the pass character. To see a corrected
- 54 -
TINY-2/MICRO-2 Operating Manual, 4th Ed. 1990
display of the current line after you have deleted characters, type the redisplay-line character, which is set by the REDisplay command.
DIGipeat ON|OFf or Y|N Default: ON
ON The packet controller will digipeat packets. OFF The packet controller will not digipeat packets.
When this parameter is ON, any packet received that has your packet controller's callsign (includ­ing SSID) in the digipeat list of its address field will be retransmitted. Each station included in the digipeat list relays the packet in its turn. Digipeating takes place concurrently with other packet controller operations and does not interfere with normal packet operation.
The command HId enables automatic transmission of identification packets if your station is acting as a digipeater.
Disconnect
Disconnect is an immediate command. It will initiate a disconnect request with the currently con­nected station. A successful disconnect results in the display:
*** DISCONNECTED
Other commands may be entered while the disconnect is taking place, although connects are disal­lowed until the disconnect is completed. If the retry count is exceeded while waiting for the other side to acknowledge, the packet controller moves to the disconnected state. If a disconnect com­mand is entered while the packet controller is disconnecting, the retry count is immediately set to the maximum number. In either case, the disconnect message is:
*** retry count exceeded *** DISCONNECTED
Disconnect messages are not displayed when the packet controller is in Transparent Mode.
DISPlay [class]
class Optional parameter, class identifier, one of the following:
Async display asynchronous port parameters Bbs display PMS parameters Character display special characters Health display health counters and LED status Id display ID parameters Link display link parameters Monitor display monitor parameters Printer display printer parameters Timing display timing parameter
DISPlay is an immediate command, and with no class parameter will cause all control parameters and their current values to be displayed.
- 55 -
TINY-2/MICRO-2 Operating Manual, 4th Ed. 1990
cmd:DISP<CR>
Sub-groups of related parameters can be displayed by specifying the optional parameter-class.
Individual parameters can be displayed by entering the parameter name with no options.
DWait
n
= 0 – 250, specifying default wait time in 10 ms intervals.
n
Default: 16
This value is used to avoid collisions with digipeated packets. The packet controller will wait the default wait time after last hearing data on the channel before it begins its keyup sequence, unless it is waiting to transmit digipeated packets. If all stations specify a proper wait time the digipeater will capture the frequency every time it has data to send, since digipeated packets are sent with­out this delay.
Echo ON|OFf or Y|N Default: ON
ON Characters received from the computer or terminal are echoed by the packet controller. OFF Characters are not echoed.
This command controls local echoing by the packet controller when it is in Command or Converse Mode. Local echoing is disabled in Transparent Mode. If you don't see what you type, you should set Echo ON. If you see two copies of every time you type, set Echo OFF.
EDithdr
n
n
to-call[-m] @-call[-m]
message number to be edited. to-callsign revised callsign to be placed in TO:' location. @-callsign revised callsign to be placed in '@ BBS:' location.
m
optional SSID.
The EDithdr command allows the editing of PMS message headers to allow readdressing of mes­sages (changing, the TO: callsign) and revising the callsign of the '@ BBS' field. The EDithdr com­mand will accept either two or three parameters; the message number and either or both callsigns are required. It does not allow editing the BID. If the parameters are not correct, the following message will be displayed:
Parameters are missing
To revise only the 'TO:' callsign of message 9, enter the following:
cmd:EDithdr 9 W4MUA<CR>
The PMS will respond with the following display:
Msg # Stat Date Time To From @ BBS Subject 9 T 07/15/90 09:54 W1AW WS4Z @ W4DPH VE tests New message header
Msg # Stat Date Time To From @ BBS Subject 9 T 07/15/90 09:54 W4MUA WS42 @ W4DPH VE tests
- 56 -
TINY-2/MICRO-2 Operating Manual, 4th Ed. 1990
Similarly, to revise only the '@ BBS:' callsign of message 6, enter:
cmd:EDithdr 6 @W4DPH<CR>
To revise both callsigns in message 3, enter the following:
cmd:EDithdr 3 N4UQQ @ K0ZXF<CR>
To remove the callsign in the '@ BBS' field in message 2 and leave the field blank, enter the follow­ing:
cmd:EDithdr 2 @ <CR>
The PMS will respond with the 'before' and 'after' displays in each case.
EScape ON|OFf or Y|N Default: OFF
ON The <ESCAPE> character ($1B) is output as "$" ($24). OFF The <ESCAPE> character ($1B) is output as ($1B).
This command specifies the character which will be output when an <ESCAPE> character is to be sent to the terminal, The <ESCAPE> translation is disabled in Transparent Mode.
Some terminals interpret the <ESCAPE> character as a special command prefix. If you have such a terminal, you can protect yourself from unexpected text sequences by setting EScape ON. See also the MFilter command.
FIrmrnr ON|OFf or Y|N Default: OFF
ON FIrmrnr is active. OFF FIrmrnris disabled.
This command is used to prevent the frequent polling of remote TNCs when they are busy. Works around the AX.25 protocol specification for busy-poll timing. This command operates properly with remote TNCs having FIRMRNR set to ON and with most network nodes.
Flow ON|OFf or Y|N Default: ON
ON Type-in flow control is active. OFF Type-in flow control is disabled.
When type-in flow control is enabled, any character entered from the terminal will halt output to the terminal until: (1) a packet is forced (in Converse Mode); (2) a line is completed (in Command Mode); (3) the packet length is exceeded; or (4) the terminal output buffer fills up. Canceling the current command or packet or typing the redisplay-line character will also cause output to resume. Type-in flow control is not used in Transparent Mode.
Setting Flow ON will keep received data from interfering with data entry.
- 57 -
TINY-2/MICRO-2 Operating Manual, 4th Ed. 1990
FOrward
n
= the number of the message to be marked for forwarding.
n
This command allows messages to be marked for forwarding. The PMS does not support automatic forwarding to other BBS (to reduce channel congestion), but supports manual forwarding (see FPms, FNPms commands) and automatic reverse forwarding. If you have an arrangement with your local BBS SysOp to forward BBS mail to your PMS, then the PMS will reverse forward marked messages to the local BBS when the BBS connects to deliver your mail. If you type:
cmd:FOrward n<CR>
The PMS will respond with:
Message marked for forwarding
If you try to mark a bulletin for forwarding, the PMS will display:
You cannot forward a bulletin
The FOrward command also is used to remove the forwarding flag from a marked message. To un­do the forwarding of a message, enter:
cmd:FOrward n<CR>
The PMS will respond with the message:
Message forwarding reset
FNPms call#1[Via call#2]
call#1 Callsign of node or switsh to be connected to. call#2 Optional callsign of station to be digipeated through.
This command causes the PMS to connect to a node or switch (call#1) via no more than one digi­peater (call#2).
Once this connection exists, the PMS sends the node the connect string contained in NODetext to cause the node to connect to the desired BBS/PMS station. Once that connection is established, the PMS uploads all messages marked for forwarding.
If the station connected to by the NODetext is the HOMebbs, the standard BBS forwarding format will be used for transferring messages, otherwise the PMS will follow the standard "human" for­mat.
If the FNPms command is used to connect to a station which is not a node, the NODetext will be sent but will be interpreted as data and no further action will take place. After approximately five minutes, the PMS will time-out and disconnect.
If the station connected to by the NODetext command string is not a BBS or PMS capable of re­ceiving PMS messages, or if a forwarding error occurs, automatic disconnection takes place.
- 58 -
TINY-2/MICRO-2 Operating Manual, 4th Ed. 1990
FPms call#1[Via call#2]
call#1 Callsign of BBS/PM station to be connected to. call#2 Optional callsign of station to be digipeated through.
This command causes the PMS to connect to a BBS/PMS station (call#1) via no more than one dig­ipeater (call#2). The callsign string may not exceed 23 characters. Once this connection exists, the PMS uploads all messages marked for forwarding.
This command may be used to upload messages to another PMS or human operator as well as a conventional BBS. If the station connected to by the FPms command is the HOMebbs, the stand­ard BBS forwarding format will be used for transferring messages, otherwise the PMS will follow the standard "human" format.
If the FPms command is used to connect to a station which is not a BBS or PMS capable of receiv­ing PMS messages, or if a forwarding protocol error occurs, automatic disconnection occurs.
FRack
n
= 1 – 15, marking frame acknowledgment timeout in seconds.
n
Default: 3 [HF 6]
After transmitting a packet requiring acknowledgment, the packet controller waits the frame ac­knowledgment timeout before incrementing the retry counter and sending the frame again. If the packet address includes digipeaters, the Retry interval is adjusted to n × (2 × m + 1) where m is the number of relay stations.
When a retried packet is sent, a random wait time is added to the wait times in use to avoid lock­ups in which two packet controllers repeatedly send packets which collide.
FUlldup ON|OFf or Y|N Default: OFF
ON Full duplex mode is enabled. OFF Full duplex mode is disabled.
When full duplex mode is off, the packet controller makes use of the Data Carrier Detect signal from the modem to avoid collisions, and acknowledges multiple packets in a single transmission with a single acknowledgment. When full duplex mode is enabled, the packet controller ignores the DCD signal and acknowledges packets individually. It should not be used unless both your sta­tion and the station you are communicating with are full-duplex stations.
HEaderln ON|OFf or Y|N Default: OFF
ON The header/text of monitored packets use two lines. OFF The header/text of monitored packets use one line.
This command affects the display format. If HEaderln is OFF, the address information is displayed with the packet:
KV7D > N2WX: Go ahead and transfer the file.
If HEaderln is ON, the address information is displayed, followed by the packet text on a separate line:
- 59 -
TINY-2/MICRO-2 Operating Manual, 4th Ed. 1990
N2WX>KV7D: Sorry, I'm not quite ready yet.
HEAlled ON|OFf or Y|N Default: OFF
ON The controller will "dither" the CON and STA LEDs. OFF The CON and STA LEDs operate normally.
This command allows the user to redefine the functions of the two CPU controllable LEDs (i.e. the STAtus and CONnect LEDs).
When HEAlled is set ON, the two LEDs flash in an alternate fashion. The LEDs will not flash if the software is not operating.
With HEalled set OFF, the LEDs function in their normal fashion, indicating the presence of a con­nection and whether any unacknowledged frames exist
Help or (?)
A command used by a PMS over-the-air user. Displays a list of PMS commands with a brief descrip­tion of each.
B(ye) B[CR] disconnects you from PMS H(elp) H[CR] or ? [CR] displays this help file J(log) J[CR] displays a list of callsigns heard with date/time K(ill) K n[CR] deletes message n (only to/from your callsign) KM Kill all messages addressed to users callsign L(ist) L[CR] lists the 10 latest messages M(ine) M[CR] lists the 10 latest messages to/from your callsign R(ead) R n[CR] reads message number n S(end) S (callsign) (@ BBS callsign) [CR] begins a message addressed to
(callsign) at home BBS of (@ BSBcallsign) Subject: max 28 characters ending with [CR]. Text: End each line with [CR]. End message by typing /ex[CR] or
CTRL-Z [CR] at the beginning of a new line. SP Send message marked Personal ST Send message in NTS format V(ersion) V[CR] displays the software version of the PMS System.
HId ON|OFf or Y|N Default: OFF
ON Enables HDLC identification by a digipeater. OFF Disables HDLC identification.
This command is used to enable or disable the sending of identification packets by the packet con­troller. If HId is OFF the packet controller will never send an identification packet. If HId is ON, the packet controller will send an identification packet every 9.5 minutes if the station is digipeating packets. The ID command allows the operator to send a manual identification packet.
An identification consists of an unsequenced I-frame whose data field is your station identification, The identification packet is addressed to the address set by the Unproto command. Your station identification is your callsign as set by MYcall, with "/R" appended.
- 60 -
TINY-2/MICRO-2 Operating Manual, 4th Ed. 1990
HOMebbs callsign-
n
Callsign Up to six alphanumeric characters.
n
Optional SSID from 0 to 15.
This command sets the callsign of the 'home BBS' which forwards mail to your PMS or which you normally access manually.
Id
Id is an immediate command which sends a special identification packet. Id can be used to force a final identification packet to be sent as a digipeater station is being taken off the air. The identifica­tion packet will be sent only if the digipeater has transmitted since the last automatic identifica­tion. See HId for ID frame information.
(J)log
A command used by a PMS over-the-air user.
Displays a log of the callsigns most recently heard by the PMS host packet controller. The number of entries in the display may vary based on PMS buffer space. The display is in the following for­mat:
N4UQQ* PMS 07/15/90 18:33 TPA5 NODE 07/15/90 18:32 K0ZXF BBS 00/00/00 00:00
Zeros are shown in the date and time fields if the clock was not set. An asterisk (*) means the sta­tion was heard via a digipeater.
(K)ill
n
A command used by a PMS over-the-air user. See KIll below.
(KM)
A command used by a PMS over-the-air user. Kills all messages addressed to the user's callsign. See KIll below.
KIll
n
n
The number of the message you wish to kill.
This command allows deletion of a message in the PMS. If the message is found and erased, the PMS will display:
Message erased
If an invalid message number is given, the PMS will display:
- 61 -
TINY-2/MICRO-2 Operating Manual, 4th Ed. 1990
Message not found
KIll O(ld) will delete the 10 oldest messages.
KILONFWD ON|OFf or Y|N Default: ON
ON Messages are deleted after forwarding. OFF Messages are retained after forwarding.
This command selects whether messages which have been marked for forwarding will be deleted or retained after forwarding takes place.
KISs ON|OFf or Y|N Default: OFF
ON RESTART command initiates KISS firmware. OFF RESTART command reinitiates standard packet firmware.
This command supports the use of TCP/IP, MICROSAT software, and other software which speci­fies the KISS mode.
The KISS command sets the KISS parameter. Then the RESTART command will cause the control­ler to initialize using the KISS mode. The KISS setting is preserved in bbRAM.
The KISS mode may be exited by removing the battery jumper (which destroys bbRAM parame­ters), by entering the command PARAM AX0 255 at the TCP/IP NET> prompt or from another communication program. To exit KISS when using an MS-DOS computer and communication soft­ware: 1. Hold down the ALT key, 2. Press keys 1 9 2 on the numeric keypad, 3. Release the ALT key, 4. Hold down the ALT key again, 5. Press keys 2 5 5 on the numeric keypad, and 6. Release the ALT key.
LCAlls call#1[,call#2...,call#8] Default: blank
call Callsign list. Up to 8 calls, separated by commas.
Each callsign may include an optional sub-station ID specified as -n immediately following the call. This command works in conjunction with BUdlist and allows selective control of which packets will be displayed when you have set Monitor ON, which stations will be allowed to connect, and which will be allowed to digipeat through your station. BUdUst specifies whether the cafisigns in the list are the ones you want to ignore or the only ones you want to listen to.
If you want to monitor selected callsigns, enter those calls in LCAlls and set BUdlist ON. If you want to ignore selected callsigns, enter the calls to ignore in LCAlls and set BUdlist OFF.
LCok ON|OFf or Y|N Default: ON
ON The controller will send lower case characters to the terminal. OFF Lower case characters are changed to upper case.
If LCok is OFF, lower case characters will be translated to upper case before being output to the terminal. This case translation is disabled in Transparent Mode. Input characters and echoes are not translated. Since echoes of the characters typed in are not translated to upper case, if both op­erators set LCok OFF, each operator can type messages in lower case and see incoming packets displayed in upper case.
- 62 -
TINY-2/MICRO-2 Operating Manual, 4th Ed. 1990
LCStream ON|OFf or Y|N Default: ON
ON The packet controller will convert the character following the STReamsw character to upper
case before processing it.
OFF The packet controller will process the character immediately following the STReamsw char-
acter as it is entered.
When operating multi-connect, the user must enter a stream identifier (default A through J) after the STReamsw(itch) character (default | ) to select a new logical stream to send data. Normally, the stream identifier must be in upper case, or an error message will result.
When LCSTREAM is ON, the character immediately following the Streamswitch character is con­verted to upper case before being acted upon. Thus, the case (upper or lower) becomes insignifi­cant.
LFadd ON|OFf or Y|N Default: OFF
ON A Linefeed <LF> character is added to outgoing packets following each <CR> transmitted
in the packet.
OFF No <LF> is added to outgoing packets.
This function is similar to AUtolf, except that the <LF> characters are added to outgoing packets rather than to text displayed locally. If the receiving station reports overprinting of packets from your station, set LFadd ON. This command is disabled in Transparent Mode.
LFIgnore ON|OFf or Y|N Default: OFF
ON Line Feed characters <LF> are ignored. OFF Line Feed characters <LF> are acted upon.
This command controls whether packet controller responds to ASCII Line Feed ($0A) characters in COMMAND and CONVERSE modes. When ON, line feeds are totally ignored. When turned off, line feed characters are processed normally, The LFIgnore command is useful when incoming data has embedded Line Feed characters that cause double spacing of the data on your screen or printer.
NOTE: See the LFadd command description. The transmitting station may have the LFadd com­mand set ON inadvertently.
(L)ist
A command used by a PMS over-the-air user. See List below.
- 63 -
TINY-2/MICRO-2 Operating Manual, 4th Ed. 1990
List
This command lists all messages in the PMS. A typical display:
Msg # Stat Date Time To From @ BBS Subject 4 T 07/15/90 09:54 W1AW WS4Z @ W4DPH VE tests 3 P 07/16/90 09:23 W1BEL K0ZXF @ W4DPH Hello 2 PF 07/15/90 23:45 K0ZXF W1BEL @ K0ZXF Bulletins 1 B 07/13/90 03:52 ALL N4UQQ @ W4DPH Help 15003 Bytes free Next message Number 5 cmd:
The values for Status are B(ulletin). P(rivate or Personal), and (NTS) T(raffic). Messages to 'ALL' will have a P(rivate) Status but will be readable by all users. The PMS will accept and display Bulle­tins, but cannot originate bulletins.
LOGonmsg ON|OFf or Y|N Default: ON
ON The Standard PMS log-on message is sent. OFF The Standard PMS log-on message is not sent.
This command controls sending of the standard PMS log-on message. If LOGonmsg is ON, the fol­lowing message is sent:
*** CONNECTED TO (PMS callsign) Logged on to (PMS callsign)'s Personal Message System Optional PMS system operator supplied message (STExt)
CMD(B/H/J/K/KM/UM/R/S/SR/V/?) >
If LOGonmsg is OFF, the sign-on appears as follows:
*** CONNECTED TO (PMS callsign) Optional PMS system operator supplied message (STExt)
CMD(B/H/J/K/KM/L/M/R/S/SR/W?) >
MAll ON|OFf or Y|N Default: ON
ON Monitors both "connected" and "unconnected" packets. OFF Monitors only "unconnected" packets.
This command determines the class of packets which are monitored. If MAll is OFF, only eligible packets (determined by BUdlist and LCAlls commands) sent by other packet controllers in the un­connected mode are displayed.
If MAll is ON, all otherwise eligible frames are displayed, including those sent between two other connected packet controllers.
- 64 -
TINY-2/MICRO-2 Operating Manual, 4th Ed. 1990
MAXframe
n
= 1 – 7, signifying a number of frames.
n
Default: 4
MAXframe sets a limit on the number of unacknowledged frames which the packet controller may have outstanding at any time. This is also the maximum number of contiguous packets which can be sent during any transmission.
For file transfers, and other 'high volume' data applications, there are optimum values for MAX­frarne and PACLen which may be different than the parameters set for interactive communication. The values also differ based on the quality of the RF link.
MCOM ON|OFf or Y|N Default: OFF
ON All frames are monitored. OFF Only information frames are monitored
MCOM causes the display of control frames when Monitor is ON.
When MCOM is OFF, only packets containing user Information will be displayed. When MCOM is ON all control fields are decoded and invalid ones are marked with ????. For I and S frames, se­quence number Information is also presented. Frames compatible with the AX.25 Level 2.0 Stand­ard are also decoded as to the state of the C and PF bits. See the protocol chapter for more infor­mation.
As with other monitor commands, the stations monitored are determined by BUdlist and LCAlls.
MCon ON|OFf or Y|N Default: OFF
ON Monitor mode remains active when in connected state. OFF Monitor mode is off when in connected state.
If MCON is ON, the Monitor command will enable monitoring while your packet controller is in a connected state. If MCON is OFF, the display of monitored packets is suspended when a connect occurs, and is resumed when disconnected.
MFilter
n
= 0 – $7F, specifying an ASCII character code to be filtered.
n1[,n2[,n3[,n4]]]
Default: 00 [null)
Up to 4 characters may be specified.
This command allows you to specify characters to be "filtered," or eliminated from monitored pack­ets. The parameters n1, n2, etc., are the ASCII codes for the characters you want to filter. You can enter the code in either hex or decimal.
For example, if you want to filter the <CTRL-L> screen clearing character, you can set MFilter 12. If you also want to eliminate <CTRL-Z> characters, which some computers interpret as end-of-file markers, you can set MFILTER 12,26. Clear the MF list by the command MFilter 00. Do not enter 0 or $00 as the first entry of the MFilter string as any characters entered following that entry will be ignored.
- 65 -
TINY-2/MICRO-2 Operating Manual, 4th Ed. 1990
MHClear
MHCLEAR is an immediate command. It causes the list of stations heard to be cleared. Use this command in conjunction with MHeard to keep track of the stations on the air over a given period of time. Clear the list of stations heard when you first begin to monitor the packet activity.
MHeard
MHEARD is an immediate command. It causes the packet controller to display the list of stations that have been heard since the last time the command MHClear was given.
Stations that are heard via a digipeater are marked with a * in the heard log. The maximum num­ber of heard stations that can be logged is 18. As more stations are heard, earlier entries are drop­ped. Logging of stations is disabled when PASSALL is ON.
If the date and time are set, entries in the heard log will be time stamped. Stations which can be identified by their transmissions as either a PMS, BBS, or NODE are so listed in the heard log.
(M)ine
A command used by a PMS over-the-air user. See Mine below.
MIne
Lists all messages to or from your PMS callsign (MYPCALL). For example, if MYPcall is set to W1BEL, MIne will show the following messages from the example shown above in the LIST com­mand:
Msg # Stat Date Time To From @ BBS Subject 3 P 04/16/90 09:23 W1BEL K0ZXF @ W4DPH Hello 2 PF 04/15/90 23:45 K0ZXF W1BEL @ K0ZXF Bulletins 15003 Bytes free Next message Number 4 cmd:
Monitor ON|OFf or Y|N Default: ON
ON Monitoring of packet activity is enabled. OFF Monitoring of packet activity is disabled.
If Monitor is ON and the packet controller is not in Transparent Mode, packets not addressed to your packet controller will displayed. The addresses in the packet are displayed along with the data portion of the packet. The calls are separated by a comma and the sub-station ID field (SSID) is displayed if it is other than zero.
The MAil, BUdlist, and LCAlls commands determine which packets are to be monitored. The MCon command controls the action of monitor mode when the packet controller is connected. All monitor functions are disabled in Transparent Mode.
The format of the monitor display is controlled by HEaderln. See also MRpt and MStamp.
- 66 -
TINY-2/MICRO-2 Operating Manual, 4th Ed. 1990
MRpt ON|OFf or Y|N Default: ON
ON Display digipeating stations for monitored packets. OFF Display only source and destination stations for monitored packets.
This command affects the way monitored packets are displayed.
If MRpt is OFF, only the originating station and the destination are displayed for monitored pack­ets.
WB9FLW>AD7I:Hi Paul.
If MRpt is ON, the entire path is displayed, and stations that have already relayed the packet are indicated with an asterisk.
WB9FLW>AD7I,K9NG*,N2WX-7:Hi Paul.
MSGHdr ON|OFf or Y|N Default: ON
ON Forwarded messages will have a message header inserted. OFF Forwarded messages will not have a message header.
This command selects whether forwarded messages will have a message header inserted at the beginning of the message.
The message header appears as follows:
Originated From: <callsign> mm/dd/yy hh:mm Msg #n
The format of the date depends on the setting of DAYUsa.
MStamp ON|OFf or Y|N Default: OFF
ON Monitored frames are time stamped. OFF Monitored frames are not time stamped.
This command enables time stamping of monitored packets.
The date and time are set initially by the DAytime command, and the date formal is determined by the DAYUsa command.
MYAlias call[-n] Default: blank
call Alternate identity of your controller.
n = 0 – 15, an optionally specified sub-station ID (SSID).
This command specifies an alternate callsign (in addition to the callsign specified in MYcall) for use as a digipeater only.
This command permits HId to identify normally with the MYcall-specified callsign yet permit an al­ternate (alias) repeat-only "callsign".
- 67 -
TINY-2/MICRO-2 Operating Manual, 4th Ed. 1990
MYcall call[-n] Default: NOCALL-0
call Callsign of your packet controller.
n
= 0 – 15, an optionally specified sub-station ID (SSID).
This command tells the packet controller what its callsign is. This callsign will be placed in the FROM address field for all packets it originates. It will accept frames with this callsign in the TO field and relay frames with this callsign in the digipeat field. MYcall will also be used for identifica­tion packets (see HId and Id).
The default callsign must be changed for proper operation of the protocols. There should never be more than one station with the same callsign (including SSID) on the air at once. The SSID can be used to distinguish two stations with the same call. The SSID will be 0 unless explicitly set to an­other value.
MYPcall call[-n]
call Up to six alphanumeric characters.
n
= 0 – 15, an optionally specified sub-station ID (SSID).
This command sets the callsign of the PMS, which must not be the same as MYcall. Normally use MYcall with a different SSID.
NEwmode ON|OFf or Y|N Default: OFF
ON Entry to data transfer mode occurs when the Connect command is given, and return to
command mode is automatic at disconnection.
OFF Switching to data transfer mode occurs a connection but no return to command mode
occurs at disconnection.
The NEwmode command may be used to select the way the controller behaves when connections are made and broken.
If NEwmode is OFF, the packet controller will remain in Command Mode after you issue a Connect command until a connection is actually established, then will enter Converse Mode or Transparent Mode, depending on the setting of CONMode. When the connection is terminated, the packet con­troller remains in Converse or Transparent Mode until you force it to return to Command Mode.
If NEWmode is ON, the packet controller will enter the specified CONMode as soon as you issue a Connect command, without waiting for the connection to be established. Anything typed thereafter will be packetized to be transmitted once the connection is complete. When the connection is bro­ken, or if the connect attempt fails, the packet controller returns to Command Mode.
NODetext
text
A valid connect string (limited to one digipeater).
text
Default: blank
The NODetext field should be filled with a valid connect string or left blank.. (See the Connect command for examples of a proper connect string and also note the limitations below).
This connect string is used by the FNPms command to cause the node or switch in use to connect to the desired station for message forwarding. This may be the HOMebbs or another station for forwarding of PMS messages. The NODetext should contain the C(onnect) command followed by the callsign of the station to be forwarded to. Only one digipeater field may be included and must be preceded by the V(ia) command.
- 68 -
TINY-2/MICRO-2 Operating Manual, 4th Ed. 1990
NOmode ON|OFf or Y|N Default: OFF
ON The controller will only switch modes (command, converse or transparent) upon explicit
command.
OFF The packet controller switches modes in accordance with the setting of NEwmode.
When NOmode is ON, the packet controller will never change between CONVerse or Transparent mode to COMMAND mode (or vice-versa) on its own. Only user commands (CONV, Trans, or CTRL-C) may change the type of mode.
If NOmode is OFF, then automatic mode switching is handled according to the setting of the NEW­mode command.
NUer ON|OFf or Y|N Default: OFF
ON <NULL> characters are sent to the terminal after <CR>. OFF <NULL> characters are not sent after <CR>.
This command causes transmission of <NULL> characters (ASCII code $00), producing an effec­tive delay following any <CR> sent to the terminal. The number of <NULL> characters is deter­mined by the command NULLs. This delay is required by some hardcopy terminals to allow time for the carriage to return and the paper to advance. Set NUcr ON if your terminal misses charac­ters after a <CR>.
NULf ON|OFf or Y|N Default: OFF
ON <NULL> characters are sent to the terminal after <LF> characters. OFF <NULL> characters are not sent after <LF> characters.
This command causes transmission of <NULL> characters (ASCII code $00), producing an effec­tive delay following any <LF> sent to the terminal. The number of <NULL> characters is deter­mined by the command NULLs. This delay is required by some display terminals. Set NULf ON if your terminal some-times misses characters at the beginning of the line.
NULLs
n
= 0 – 30, the number of nulls added after <CR> or <LF>.
n
Default: 0
This command specifies the number of <NULL> characters (ASCII code $00) to send to the termi­nal after a <CR> or <LF> is sent. In addition to setting this parameter value, NUcr and/or NULf must be set to indicate whether nulls are to be sent after <CR>, <LF> or both.
Devices requiring nulls after <CR> are typically hard-copy devices requiring time for carriage movement. Devices requiring nulls after <LF> are typically CRTs which scroll slowly. Extra null characters are sent only in Converse and Command Modes.
Paclen
n
Default: 128
n
= 0 – 255, specifying the maximum length of the data portion of a packet. The value 0 is
equivalent to 256.
* NOTE: The default Paclen value may vary according to model.
The packet controller will automatically transmit a packet when the number of input bytes for a
n
packet reaches
. This value is used in both Converse and Transparent Modes.
- 69 -
TINY-2/MICRO-2 Operating Manual, 4th Ed. 1990
PACTime Every|After
Every Packet timeout occurs every n × 100 milliseconds After Packet timeout occurs when n × 100 milliseconds elapse with no input from the
computer or terminal.
n
= 0 – 250, specifying 100 ms intervals.
This parameter is always used in Transparent Mode, and will be used in Converse Mode if CPactime is ON. When Every is specified, input bytes are packaged and queued for transmission every
n
× 100 ms. When After is specified, bytes are packaged when input from the terminal stops for
n
× 100 ms. In no case will a zero length packet be produced, and the timer is not started until the first byte is entered. If n = 0, packets are generated with no wait time.
PARity
n
= 0 – 3, selecting a parity option according to the following code:
0 = none, 1 = odd, 2 = none, 3 = even.
This command sets the parity mode for terminal or computer data transfer. The parity bit, if pres­ent, is automatically stripped on input and not checked in Command Mode and Converse Mode. In Transparent Mode, all eight bits, including parity if any, are transmitted in packets. If "no parity" is set and AWlen is 7, the eighth bit will be set to 0 in Transparent Mode.
n
* NOTE: Parity default value may vary on some models.
n
Default: After 10
Default: 0 (none) *
PASs
n
This command selects the ASCH character used for the "pass" input editing command. The param­eter n is the ASCII code (hex or decimal) for the character typed in order to include the following character in a packet or text string.
You can use this character to send any character in packets, even though that character may have some special function for the packet controller. A common use for the pass character is to allow <CR> to be included in the BText and CText messages. You can include <CR> in text when you are in Converse Mode, to send multi-line packets. (The default send-packet character is <CR>.
PASSAll ON|OFf or Y|N Default: OFF
ON Controller will accept packets with invalid CRCs. OFF Controller will only accept packets with valid CRCs.
This command causes the packet controller to display packets received with invalid CRC fields if they consist of an even multiple of 8 bits and up to 339 bytes.
The packet controller will attempt to decode the address field and display the callsign(s) in the standard monitor format, followed by the text of the packet.
n
= 0 - $7F, specifying an ASCII character code.
Default: $16 {CTRL-V}
If you set PASSAll ON and monitor a moderately noisy channel you will periodically see "packets" displayed in this mode, since there is no basis for distinguishing actual packets received with errors from random noise.
Logging of stations heard (for display by MHeard) is disabled whenever PASSAll is ON, since the callsigns detected may be incorrect.
- 70 -
TINY-2/MICRO-2 Operating Manual, 4th Ed. 1990
PErsist
n
= 0 – 255, setting the probability of retransmitting a frame.
n
Default: 127
PErsist is a threshold setting which is applied to a random number between 0 and 255 generated when a frame needs to be resent. If the random value is greater than the PErsist value, no retry is made. If the random value is less than or equal to PErsist, a retry attempt is made. The default value of 127 equates to a 50 % probability that channel access will be attempted. Persist = 255 provides 100 % probability of attempting to seize the channel.
PIdcheck ON|OFf or Y|N Default: OFF
ON All frames with a PID other than $F0 are ignored. OFF All frames are accepted equally.
When PIdcheck is ON, all frames with Protocol Identifier (PID) other than $F0 are ignored to re­duce the screen clutter from network nodes. PIdcheck OFF ignores the PID.
PMs ON|OFf or Y|N Default: OFF
ON The Personal Message System is enabled. OFF The Personal Message System is disabled.
This command enables or disables PMS operation via the radio port. When PMS is off, a connect request to MYPcall is sent the messages:
*** (PMS callsign) BUSY *** DISCONNECTED
Turning the PMS off will not destroy the messages in the PMS memory area. Use the KIll command to remove unwanted messages. To reset the messages to begin with number 1, the RESET com­mand must be used, which will also destroy all other battery-backed parameters and PMS messag­es.
POrt
n
Default: 2
n = 1 or 2, specifying a radio port (1 = HF, 2 = VHf).
NOTE: This command does not apply to all models.
The POrt command is used to select the radio port (on models which feature switchable ports) and engages the proper set of parameters for the selected port. If the POrt command is given without a parameter, the controller responds with the currently selected port. If a command is given to switch ports while a connection exists, the controller responds with the message:
? not while connected
- 71 -
TINY-2/MICRO-2 Operating Manual, 4th Ed. 1990
PPersist ON|OFf or Y|N Default: OFF
ON Selects PPersistance method of retry timing. OFF Selects FRACK (conventional) method of retry timing.
PErsist, PPersist, and SLottime implement the P Persistance method of timing retried frames. This superior method of retry timing will not be effective unless all stations on a channel use it. Consult with other packet operators in your local area to en-courage use of PPersistance.
PPRint
n n
PMS message number to be sent to printer port.
– nRange of PMS message numbers to be sent to printer port.
n
n
NOTE: This command does not apply to all models.
This command allows the printing of Personal Message System (PMS) messages to an attached printer.
PRAUtolf ON|OFf or Y|N Default: ON
ON A linefeed <LF> character is sent following each carriage return <CR> sent to the printer. OFF Carriage return characters are sent to the printer without an added linefeed character.
NOTE: This command does not apply to all models.
This command functions like the AUtolf command, but applies to the printer port. If your printer requires a linefeed character with each carriage return, set PRAUtolf to ON. If printed material ap­pears to be double spaced and it should be single spaced, set PRAUtolf to OFF.
PRint ON|OFf or Y|N Default: OFF
ON The printer port is enabled. OFF The printer port is disabled.
NOTE: This command does not apply to all models.
This command allows the printer port functions to be enabled or disabled. If PRint is OFF, no print­ing will occur under any condition. If PRint is ON, printing will be controlled by the link connection state and PRTTgl state.
PRPAge ON|OFf or Y|N Default: ON
ON The printer output will automatically be paginated. OFF The printer output will be non-paginated.
NOTE: This command does not apply to all models.
This command is in conjunction with the PRPGln command to paginate printed output.
If PRPAge is ON, a formfeed character will be sent to the printer after PRPGln number of lines have been printed.
If the printer automatically paginates printed data, or if no pagination is desired, set PRPAge OFF.
- 72 -
TINY-2/MICRO-2 Operating Manual, 4th Ed. 1990
PRPDisc ON|OFf or Y|N Default: ON
ON A formfeed character will be sent to the printer when the link state becomes disconnected. OFF No formfeed character will be sent to the printer.
NOTE: This command does not apply to all models.
This command allows the printer to begin printing at the top of page position each time a connec­tion is established.
PRPGln
n
number of lines printed between formfeed characters.
n
Default: 60
NOTE: This command does not apply to all models.
This command sets the number of lines to be printed on each page. The PRPGln value is used by PRPAge to paginate output.
PRTTOFf
n
Default: $0F
n = 0 – $7F, specifying an ASCII character code.
NOTE: This command does not apply to all models.
If PRTTgl is ON, printer output may be controlled by the commands PKTTON and PKTTOFf embed­ded in the Converse Mode data which is received.
The PRTTOFf command sets the value of the character in received data which is used to toggle printer Output off.
PRTTON
n
Default: $10
n = 0 – $7F, specifying an ASCII character code.
NOTE: This command does not apply to all models.
If PRTTtgl is ON, printer output may be controlled by the commands PRTTON and PRTTOFf embed­ded in the Converse Mode data which is received.
The PRTTON command sets the value of the character in received data which is used to toggle printer output on.
PRTTgl ON|OFf or Y|N Default: ON
ON Printer output in Converse Mode will be controlled by PRTTON and PRTTOFf characters in
received.
OFF Printer output occurs for all data in CONVerse mode.
NOTE: This command does not apply to all models.
The PRTTgl command controls whether printer output may be controlled by commands embedded in the Converse Mode data which is received.
- 73 -
TINY-2/MICRO-2 Operating Manual, 4th Ed. 1990
PRTUifra ON|OFf or Y|N Default: OFF
ON Monitored UI (unproto) frames are printed. OFF Only connected frames are printed.
NOTE: This command does not apply to all models.
The PRTUifra command allows printing of UI frames on the printer. It is not intended for monitor­ing of connected transmissions in the same sense that the Monitor command applies to terminal output. There is no mechanism to detect duplicate received frames, therefore these duplicate frames will be printed. This command should be used in conjunction with the LCAlls and BUdlist commands to limit data received to only one station.
Frames are printed without callsign address headers, to allow the 'reconstruction' of text or graph­ics documents sent in the UI mode. The command CRafter controls whether a carriage return character is appended to the end of each monitored frame.
(R)ead
A command used by a PMS over-the-air user. See Read below.
Read
n n – n
n – n
The number of the PMS message you wish to read The first and last numbers of the messages to be read.
This command displays message number n in the format below:
Stat :P Posted :07/15/90 19:33 To :K4NTA From :W1BEL @BBS :K0ZXF BID : Subject :FADCA Meeting
Text of message.
cmd:
If the command Read is given without a number, a listing of messages in the PMS will be displayed (same as List command). Reading any PMS message (not necessarily a newly entered message) will reset the blinking PMS or STA LED.
- 74 -
TINY-2/MICRO-2 Operating Manual, 4th Ed. 1990
REConnect call#1[Via call#2[,call3...,call#9]]
call#1 Callsign to be reconnected to. call#2 Optional callsign(s) to be digipeated through
REConnect is an immediate command. It may be used to change the path through which you are currently connected to a station. It may only be used when your packet controller is connected on the current stream to the station to which you wish to REConnect.
The integrity of outstanding frames at the time of REConnect is not assured. For details of the pa­rameter list, see the Connect command.
REDisplay
n
= 0 – $7F, specifying an ASCII character code.
n
Default: $12 {CTRL-R}
This command is used to change the redisplay-line input editing character. The parameter n (hex or decimal) is the ASCII code for the character you type in order to redisplay the current line.
When you type the redisplay-line character, type-in flow control is temporarily released (if it was enabled), displaying any incoming packets that are pending. Then a <BACKSLASH> character is typed, and the line you have begun is retyped on the next line. If you have deleted and retyped any characters, only the final form of the line is shown. You are now ready to continue typing.
Use the redisplay-line character to see a "clean" copy of your input with a printing terminal after deleting characters. If you have set BKondel OFF, deletions are designated with <BACKSLASH> characters, rather than by trying to correct the input line display.
You may use this character if you are typing a message in Converse Mode and a packet comes in. You can see the incoming message before you send your packet, without canceling your input.
REMSysop ON|OFf or Y|N Default: OFF
ON The MYPcall is allowed SysOp privileges over the air. OFF The MYPcall is not allowed SysOp privileges over the air.
When REMSysop is ON, the callsign contained in MYPcall is allowed to read and kill any message from over the air. This allows the SysOp to remotely manage the message base in the PMS equip­ped packet controller.
RESET
This is an immediate command. It resets all Parameters to default settings and reinitializes the packet controller.
WARNING: Parameters, heard lists and PMS messages are lost.
To re-initialize the packet controller using battery-backed RAM parameter values, use RESTART or turn the controller off and on.
- 75 -
TINY-2/MICRO-2 Operating Manual, 4th Ed. 1990
RESPtime
n
= 0 – 250, specifying 100 ms increments.
n
Default: 0
This command sets a minimum delay that is imposed on acknowledgment packets. This delay may run concurrently with default wait set by DWait and any random wait in effect.
This delay may be used to increase throughput during operations such as file transfer when the sending packet controller usually sends the maximum number of full-length packets. Occasionally, the sending packet controller may not have a packet ready in time to prevent transmission from being stopped temporarily, with the result that the acknowledgment of earlier packets collides with the final packet of the series. If the receiving packet controller sets RESPtime to 10, these colli­sions will be avoided.
RESTART
RESTART is an immediate command. It reinitializes the packet controller using the defaults stored in bbRAM. The effect of this command is the same as turning the packet controller OFF then ON again. RESTART does not cause a reset of the parameters in bbRAM. See also RESET.
RETry
n
= 0 – 15, specifying the number of retransmissions.
n
Default: 10
The protocol allows for retries, i.e., retransmission of frames that are not acknowledged. Frames are retransmitted n times before the operation is aborted. A value of 0 for n specifies an infinite number of retries. If the number of retries is exceeded, the packet controller goes to the discon­nected state (with an informative message if not in Transparent Mode). See also the FRack and PPersist commands.
RXblock ON|OFf or Y|N Default: OFF
ON The controller sends data to the terminal in RXblock format. OFF The controller sends data to the terminal in normal format.
RXblock is designed for automated operations, such as packet bulletin board stations. It is intend­ed to help such systems discriminate between data received from the connected station and pack­et controller-generated messages.
Correct operation of RXblock is dependent on the AWlen Parameter getting set to 8 (bits) since the character FF hex marks the beginning of a received data unit header. When RXblock is on, data from other stations will be sent from the packet controller in the following format:
$FF L0 L1 P ID DATA The fields above are defined as follows: Prefix $FF ::= A character with all 8 bits set Length L0 ::= The high order data length, length and pid fields logically ORed with $F0
L1 ::= The low order data length, length, and pid fields Pid PID ::= The Protocl IDentifier byte received for the following data field Data DATA :: = [Optional], variable length data
For best operation, parameters like AUtolf, MFilter etc. should be set OFF to prevent uncertainties in the size of the data field.
- 76 -
TINY-2/MICRO-2 Operating Manual, 4th Ed. 1990
SAle
This is an immediate command which displays to the screen whatever service information the deal­er has inserted in the EPROM. If no data has been stored in the EPROM, SAle returns the mes­sage:
not implemented
Screenln
n
= 0 – 255, specifying the character width of the terminal platen or screen.
n
Default: 0
This command is used to properly format terminal output. A <CR><LF> sequence is sent to the terminal in Command and Converse Modes after n characters have been sent. A value of zero in­hibits this action. If your computer automatically formats output lines, you should leave SCREENLN = 0 to avoid conflict.
(S)end
A command used by a PMS over-the-air user. See SEND below.
SEND To-call-n @ call-n $_BID
To-call Callsign to which you wish the message addressed. @-call The 'home-BBS' callsign of the station to which the message is sent (if known)
n
Optional SSID
$_BID Optional Bulletin Identifier
This command begins the procedure for creating a message addressed to (To-call). Addressing messages to 'ALL' is permitted. If the operator does not enter a callsign, the message will be ad­dressed to MYPCALL, the PMS callsign.
The home BBS callsign (if known) should be included as shown above, The @ symbol must be typ­ed between the callsigns; it is not provided automatically.
The BID (Bulletin Identifier) is entered beginning with a US-Dollar sign ($). The remainder of the BID field should be filled according to local practice.
You will be prompted for the subject and text.
Subject: A maximum of 28 characters ending with a <CR>. If too long a subject is entered, the PMS will truncate the part exceeding 28 characters.
Text: End each line with a <CR>. End the message by typing . (period) <CR>, /ex, or CTRL-Z at the beginning of a new line. Message size is limited only by the unused memory space available in the PMS. If that space is exceeded, the PMS will display:
Buffer overflow
When the message has been saved, the PMS will display:
Message saved as Msg # n
- 77 -
TINY-2/MICRO-2 Operating Manual, 4th Ed. 1990
SEndpac
n
= 0 – $7F, specifying an ASCII character.
n
Default: $0D <CR>
This command selects the ASCII code (parameter n) for the character that will force input to be packetized and queued for transmission in Converse Mode. You can enter the code in either hex or decimal.
For conversation, set SEndpac = $0D and CR ON. This causes packets to be sent at natural inter­vals, and causes the <CR> to be included in the packet. If CPactime is ON, set SEndpac to some value not ordinarily used (say, <CTRL-A>), and set CR OFF. This allows forcing packets to be sent, but will not result in extra <CR> characters being transmitted in the text.
SLottime
n
= 0 to 255, specifying SLOTTIME in 10 ms increments.
n
Default: 1
SLottime selects the length of the delay between generating random numbers as part of the PER­SIST retry timing. Larger SLottime values lower the packet controllers priority in accessing the channeL
SOftdcd ON|OFf or Y|N Default: See below
ON The DCD signal is derived from firmware. OFF The DCD signal is obtained from the modem hardware.
This parameter should only be set to ON when using the TNC-220 which is not equipped with a tuning indicator. SOFTDCD MUST be set to OFF for proper operation of all other models.
On packet controllers which use the 8530 controller IC, the DCD signal may alternatively be ob­tained from either the 8530 flag detection feature or from the conventional modem DCD signal.
SP
This is an extension of the PMS SEND command, SP causes the message status to be marked with a P designator for personal or private. Refer to the SEND command.
SR
n
n
= Number of PMS message which is to be replied to.
SR stands for Send Reply. The message number must be included; the SR command does not send a reply to the most recently read message. If no message number is included, the message is displayed:
Parameters are missing
SR automatically reverses the TO and FROM callsigns from message number n and enters the same subject in the reply message. No entry is made in the @BBS field since this information may not be reliably determined from all received messages. Use the EDIthdr command to edit in the @BBS callsign if one is needed. This command is especially useful for replying to messages directly entered into the PMS since no @BBS entry is needed.
- 78 -
TINY-2/MICRO-2 Operating Manual, 4th Ed. 1990
cmd:l
Msg # Stat Date Time To From @ BBS Subject 11 BR 06/28/90 10:04 N4UQR W4DPH Meeting 12 BR 06/28/90 12:49 W4DPH N4UQR Meeting 11206 Bytes free
ST
This is an extension of the PMS SEND command. ST causes the message status to be marked with a T designator for National Traffic System (NTS) traffic. The text of such a message should be fil­led with an NTS formatted message. Refer to the SEND command.
STArt
n
= 0 – $7F, specifying an ASCII character code.
n
Default: $11 {CTRL-Q}
The code may be entered in either hex or decimal.
This command selects the User Restart character, which is used to restart Output from the TNC to the terminal after it has been halted by typing the User Stop character.
The User Stop character is set by the STOP command.
If the User Restart and User Stop characters are set to $00, Software flow control to the packet controller is disabled, and the packet controller will only respond to hardware flow control (CTS). If the same character is used for both the User Restart and User Stop characters the packet control­ler will alternately start and stop transmission upon receipt of the character.
STATus
$00 - Disconnected state. $01 - Connect is in progress. $03 - Disconnect in progress. $04 - A connection exists and all frames are acknowledged. $06 - A connection exists and unacknowledged frames exist.
STATus is an immediate command which returns a hexadecimal value indicating selected link pa­rameters on the current stream.
STExt
text
A string of up to 80 text characters sending with carriage return.
text
Default: blank
STExt sets the optional text which is sent as the PMS custom sign-on message. If STExt is blank, no message is sent. LOGonmsg controls the Standard sign-on message and is not related to STExt.
STOp
n
= 0 – $7F, specifying an ASCII character. The code may be entered in either hex or decimal.
n
Default: $13 {CTRL-S}
This command selects the User Stop character, which is used to stop output from the packet con­troller to the terminal. This is the character used to halt the packet controllers terminal output and stop scrolling.
Output is restarted with the User Restart character, which is set by the STArt command.
- 79 -
TINY-2/MICRO-2 Operating Manual, 4th Ed. 1990
If the User Restart and User Stop characters are set to $00, software flow control to the packet controller is disabled, and the controller will only respond to hardware flow control (CTS).
If the same character is used for both the User Restart and User Stop characters the packet con­troller will alternately Start and stop transmission upon receipt of the character.
STREAMCa ON|OFf or Y|N Default: OFF
ON Callsign of other station is displayed. OFF Callsign of other station is not displayed.
This command is used to enable the display of the connected-to station callsign after the stream identifier. It is somewhat analogous to the use of MRpt to show digipeat paths when monitoring.
In the example below, the characters inserted by enabling STREAMCa are shown in bold face type.
STREAMCa ON STREAMCa OFF | A :K4NTA:hi howie | A hi howie hello ted how goes it? hello ted how goes it? | B :N7CL:*** CONNECTED to N7CL | B *** CONNECTED to N7CL | A Ted, AZ on other stream | A Ted, AZ on other stream
Thus, what looked like "l B" now appears as "| B: <callsign>:". This Option is very useful for hu­man operators trying to operate multiple simultaneous connections.
STREAMDbl ON|OFf or Y|N Default: OFF
ON Double all received STReamswitch characters. OFF Do not "double" received STReamswitch characters.
This command is used to display received streamswitch characters by "doubling" them. The follow­ing example illustrates this action. With STREAMDbl ON, and STReamsw(itch) set to " | ", the fol­lowing might be displayed from your packet controller:
|| this is a test.
In this case the sending station actually transmitted:
| this is a test.
The same frame received with STREAMDbl OFF would appear as:
| this is a test.
When operating with multiple connections, this is useful for differentiating between STReamsw(itch) characters received from other stations and STReamsw(itch) characters internally generated by your packet controller.
- 80 -
TINY-2/MICRO-2 Operating Manual, 4th Ed. 1990
STReamsw
n
Default: $7C < | >
n = 0 – $FF, specifying an ASCII character.
NOTE: The STReamsw(itch) character must NOT be one of the letters A-J.
This command selects the character used by both the packet controller and the user that a new "stream" (connection channel) is being addressed.
The character can be PASsed in CONVerse mode. It is always ignored as a user-initiated stream switch in Transparent Mode, and flows through as data. This means that the outgoing stream can not be changed while "on line" in Transparent Mode (you must escape to command mode to switch streams).
Also see the STREAMDbl and STREAMCall commands.
TRACe ON|OFf or Y|N Default: OFF
ON Trace mode is enabled. OFF Trace mode is disabled.
This command is used to enable the protocol debugging function. When TRACe is ON, all received frames will be displayed in their entirety, including all header information. In normal operation you will probably never need this function; however, if you need to report an apparent software bug, provide trace information if possible.
A trace display will appear in four columns on an 80-column display. Following is an example of a compressed trace display.
The frame shown in the example would be monitored as follows:
KV7B >CQ,KF7B*:this is a test message
byte –– hex display –– –– shifted ASII –– –– ASCII-
000:86A24040 40406096 CQ 0KV7B 0KF @@'. .n.@@'.. 010:6E844040 E103F074 7B P.x:449.49.0 n.@@ this is a
The byte column shows the offset into the packet of the beginning byte of the line. The hex dis­play column shows the next 16 bytes of the packet, exactly as received, in standard hex format. The shifted ASCII column attempts to decode the high order seven bits of each byte as an ASCII character code. The ASCII column attempts to decode the low order seven bits of each byte as an ASCII character code. In a Standard AX.25 packet, the callsign address field will be displayed cor­rectly in the shifted ASCII column. A text message will be displayed correctly in the ASCII column. Non-printing characters and control characters are displayed in both ASCII fields as ".". You can examine the hex display field to see the sub-station ID byte and the protocol control bytes.
Transparent
This is an immediate command. It causes the packer controller to exit from Command Mode into Transparent Mode. The current link state is not affected. Transparent Mode is primarily useful for computer communications. In this mode, the human interface" features such as input editing ca­pability, echoing of input characters, and type-in flow control are disabled.
- 81 -
TINY-2/MICRO-2 Operating Manual, 4th Ed. 1990
TRFlow ON|OFf or Y|N Default: OFF
ON Transparent Mode terminal flow control can be enabled. OFF Transparent Mode software flow control is disabled.
If TRFlow is ON, the settings of STArt and STOp are used to determine the type of flow control used in Transparent Mode. If TRFlow is OFF, only hardware flow control is available to the comput­er and all characters received by the packet controller are transmitted as data. If STArt and STOp are set to $00, disabling the User Stop and User Restart characters, hardware flow control must al­ways be used by the computer.
If TRFlow is ON, and STArt and STOp are non-zero, Software flow control is enabled for the user's computer or terminal. The packet controller will respond to the User's Restart and User's Stop characters (set by STArt and STop) while remaining transparent to all other characters from the terminal. Unless TXFlow is also ON, only hardware flow control is available to the packet controller to control Output from the terminal.
TRIes
n
= 0 – 15, specifying the RETRY level on the current stream.
n
Default: NONE
This command is used to retrieve (or force) the count of "tries" on the currently selected input stream.
When used with no argument: if the packet controller has an outstanding unacknowledged frame, it will return the current number of tries; if the packet controller has no outstanding unacknowl­edged frames, it will return the number of tries which were required to obtain an acknowledgment for the previous frame. If REtry is set to 0, the value returned by issuing a TRies command will al­ways be 0.
This command is useful for obtaining statistics on the performance of a given path or channel.
If followed by an argument, TRIes will force the "tries" counter to the entered value. This usage is NOT recommended.
TXDelay
n
= 0 – 120, specifying 10 ms intervals.
n
Default: 30
This value tells the packet controller how long to wait after keying up the transmitter before send­ing data. Some startup time is required by all transmitters to put a signal on the air; some need more, some need less. In general, crystal controlled rigs with diode antenna switching don't need much time, synthesized rigs need time for PLL lockup, and rigs with mechanical T/R relays will need time for physical relay movement. The correct value for a particular rig should be determined by experimentation.
The proper setting of this value may also be affected by the requirements of the station you are communicating with.
- 82 -
TINY-2/MICRO-2 Operating Manual, 4th Ed. 1990
TXFlow ON|OFf or Y|N Default: OFF
ON Transparent Mode software flow control is enabled. OFF Transparent Mode software flow control is disabled.
If TXFlow is ON, the setting of Xflow is used to determine the type of flow control used in Trans­parent Mode. If TXFlow is OFF, the packet controller will use only hardware flow control and all da­ta sent to the terminal remains fully transparent.
If TXFlow and Xflow are ON, the packet controller will use the TNC Restart and TNC Stop charac­ters (set by XON and XOFF) to control input from the terminal. Unless TRFlow is also ON, only hardware flow control is available to the computer or terminal to control output from the packet controller.
Note that if the TNC Restart and TNC Stop characters are set to $00, hardware flow control will al­ways be selected regardless of the setting of TXFlow.
TXUifram ON|OFf or Y|N Default: OFF
ON UI (unproto) frames may be transmitted. OFF No UI (unproto) frames will be transmitted.
This command eliminates dumping of unsent frames as UI frames when a connection falls. It is useful to operators of Packet Bulletin Board Systems. TXUifram ON will also prevent sending UI frames from the keyboard in Converse mode, but will not interfere with the sending of beacons.
Unproto call#1[Via call#2[,call#3...,call#9]] Default: CQ
call#1 Callsign to be placed in the TO address field. call#2 – 9 Optional digipeater call list, up to eight calls.
This command sets the digipeat and destination address fields of packets sent in the unconnected (unprotocol) mode. Unconnected packets are sent as unsequenced I-frames with the destination and digipeat fields taken from call#1 through call#9 options. The default destination is for uncon­nected packets is CQ.
Unconnected packets from other TNCs may be monitored by setting Monitor ON and BUdlist and LCAlls appropriately. The digipeater list is also used for Beacon packets (which are sent to destina­tion address BEACON).
USer
n
= 1 – 10, the number of connections allowed
n
Default: 1
USers affects only the manner in which incoming connect requests are handled, and has no effect on the number or handling of connections you may initiate with this packet controller. For exam­ple:
USers 0 allows incoming connections on any free stream USers 1 allows incoming connections on stream A only USers 2 allows incoming connections on streams A & B, etc.
- 83 -
TINY-2/MICRO-2 Operating Manual, 4th Ed. 1990
(V)ersion
A command used by a PMS over-the-air user. See Version below.
Version
The Version command causes the entire packet controller firmware sign-on banner to be displayed, including the features supported, firmware release date, and EPROM checksum.
XflowON|OFf or Y|N Default: ON
ON XON/XOFF (software) flow control is enabled. OFF XON/XOFF flow control is disabled.
If Xflow is ON, the computer or terminal is assumed to respond to the packet controller Start and Stop characters set by XON and XOFF. If Xflow is OFF, the packet controller will communicate flow control commands via RTS.
XMitok ON|OFf or Y|N Default: ON
ON Transmit functions are enabled. OFF Transmit functions are disabled.
When XMitok is OFF, transmitting is inhibited. All other functions of the board remain the same, in other words, the packet controller generates and sends packets as requested, but does not key the radio PTT line.
You might use this command to insure that your packet controller does not transmit in your ab­sence if you leave it operating to monitor packet activity. This command can also be used for test­ing using loopback or direct wire connections when PTT operation is not relevant.
XOff
n
n
= 0 to $7F, specifying an ASCII character code.
Default: $13 {CTRL-S}
This command selects the TNC Stop character (hex or decimal), which is sent by the packet con­troller to the computer to stop input from that device.
This character would normally be set to <CTRL-S> for Computer data transfers. If you want notifi­cation in Converse Mode when the buffers are filled, set this character to <CTRL-G> ($07), which rings the terminal bell.
XON
n
n
= 0 to $7F, specifying an ASCII character code.
Default: $11 {CTRL-Q}
This command selects the TNC Restart character (hex or decimal), which is sent by the packet controller to the computer to restart input from that device.
This character would ordinarily be set to <CTRL-Q> for computer data transfers. If you want notifi­cation in Converse Mode when the buffers are filled, set this character to <CTRL-G> ($07), which rings the terminal bell.
- 84 -
TINY-2/MICRO-2 Operating Manual, 4th Ed. 1990
MESSAGES
General Messages
|A
PacComm [model] packet controller AX.25 Level 2 Version 2.0 FEATURES: Release X n.n.n Y mm/dd/yy - nnK RAM Checksum $xx cmd:
This sign-on message that appears when you turn on your packet controller or issue the RESET command. The release number indicates the Software Version. The checksum is a hex number for comparison with the checksum given in the firmware documentation. FEATURES: is followed by a list of firmware features in the EPROM.
NOTE: The |A may display as a vertical-bar and any capital letter from "A" through "J".
bbRAM loaded with defaults
This message appears along with the sign-on message above if the battery backed-up RAM check­sum verification fails at power-on time, causing the packet controller to load the default parame­ters from ROM. (This will be the case the first time you turn on your packet controller.) This mes­sage also appears if the packet controller loads the defaults in response to the RESET command.
cmd:
This is the Command Mode prompt When this prompt appears, the packet controller is waiting for you to issue a command. Anything you type after this prompt will be interpreted as a command to the packet controller. If a monitored packet has been displayed, the prompt may not be visible, even though you are in Command Mode. You can type the redisplay-line character (set by REDis­play) to retype the prompt.
was
Whenever you change the setting of one of the packet controller parameters, the previous value will be displayed. This confirms that the packer controller properly interpreted your command, and reminds you of what you nave done.
too many packets outstanding
This message would appear in response to a CONVerse or Transparent command, under special circumstances. If you have previously entered packet data filling the outgoing buffer in Converse Mode or Transparent Mode and then returned to Command Mode. You will be allowed to enter one of these modes when some of the packets have been successfully transmitted.
- 85 -
TINY-2/MICRO-2 Operating Manual, 4th Ed. 1990
Command Mode Error Messages
If you make a mistake typing a command to the packet controller, an error message will be print­ed. You may see any of the following messages depending on the type of error you have made.
?parameter
The command was typed correctly, but the remainder of the line couldn't be interpreted.
?call
The callsign argument that does not meet the packet controller requirements for callsigns. A call­sign may be any string of numbers and letters, including at least one letter. Punctuation and spaces are not allowed. The sub-station ID, if given, must be a (decimal) number from 0 to 15, separated from the call by a hyphen.
?clock not set
The command DAytime was given to display the date and time without having previously set the clock. DAytime sets the clock if used with the daytime parameters, and displays the date and time if used alone.
?unknown command
The first word typed is not a command or a command abbreviation.
?not enough
Not enough arguments for a command that expects several parameters.
?not while connected
An attempt to change MYcall, AX25L2V2 or POrt was made while in a connected or connecting state.
?not while disconnected
You attempted to perform an operation that can only be done while connected. This message may appear when issuing a RECOnnect or CONPerm command.
?already connected to that station
The multi-connect software will not permit you to connect to the same station using multiple streams.
?range
A numeric argument for a command was too large.
- 86 -
TINY-2/MICRO-2 Operating Manual, 4th Ed. 1990
?too long
You entered too long a command line, and the line was ignored. This might happen, for example, if you try to enter too long a message with BText or CText. If you get this message, the previous text entry was not changed.
?too many
You gave too many arguments for a command.
?VIA
This message appears if you attempt to enter more than one callsign for the Connect or Unproto commands without the Via keyword.
Link Status Messages
These messages inform you of the status of AX.25 connections your packet controller may be in­volved in. You can always interrogate the link status by giving the Connect command without pa­rameters. If you attempt a connection when your packet controller is not in the disconnected state, the packet controller will display the link status but will take no other action. The following messages appear in response to the Connect command.
Link state is: CONNECTED to call#1 [VIA call#2 [,caH#3...,call#9l]
This display shows the station your packet controller is connected to and the digipeater route if any. The callsign sequence is the same sequence you would enter to initiate the connection.
*** LINK OUT OF ORDER, possible data loss [optional daytime stamp]
This message is issued upon failure of a CONPermed link.
Link state is: DISCONNECTED
No connection currently exists. You may issue the Connect command to initiate a connection.
Link state is: CONNECT in progress
You have issued a connect request, but the acknowledgment from the other station has not been received. If you issue a Disconnect command, the connect process will be aborted.
Link state is: DISCONNECT in progress
You have issued a disconnect request, but the acknowledgment from the other station has not been received. If you issue a second Disconnect command, the packet controller will go immedi­ately to the disconnected state.
- 87 -
TINY-2/MICRO-2 Operating Manual, 4th Ed. 1990
Link state is: FRMR in progress
The packet controller is connected but a protocol error has occurred. An improper implementation of the AX.25 protocol could cause this state to be entered. The packet controller will attempt to re­synchronize frame numbers with the TNC on the other end, although a disconnect may result. Connects are not legal in this state, and a disconnect will Start the disconnect process.
The packet controller will inform you whenever the link status changes. The link status may change in response to a command (Connect or Disconnect), a connect or disconnect request from another station, a disconnect due to the retry count being exceeded, an automatic time-out dis­connect (CHeck) , or a protocol error.
CONNECTED to: call#1 [VIA call#2 [,call#3...,call#9]]
This message appears when the packet controller goes from the "disconnected or "connect in progress" state to the connected state. The connection may be a result of a Connect command you issued, or of a connect request packet received from another station.
*** connect request: call#1 [VIA call#2 [,call#3...,call#9]]
This message indicates that the packet controller has received a connect request from another sta­tion which it has not accepted. This can happen if you have set CONOk OFF or if you are already connected to another station. When the packet controller types this message it also sends a DM packet (busy signal) to the station that initiated the connect request. If the packet controller re­jects a connect request because you have set CONOk OFF, you can issue your own request to the station that called.
*** DISCONNECTED
This message is displayed whenever the packet controller goes to the disconnected state from any other link state. This message may be preceded by a message explaining the reason for the dis­connect.
*** retry count exceeded *** DISCONNECTED
This message is given if the disconnect was caused by a retry failure rather than by a disconnect request from one of the stations.
*** callsign busy *** DISCONNECTED
This message indicates that your connect request was rejected by a DM packet (busy signal) from the other station. A PacComm packet controller will reject a connect request if CONOk is OFF or if it is already connected to another station.
- 88 -
TINY-2/MICRO-2 Operating Manual, 4th Ed. 1990
frmr frame just sent:
FRMR sent:string
The packet controller is connected, and a protocol error has occurred. The packet controller has sent a special FRMRpacket to attempt to re-synchronize frame numbers with the TNC on the other end. The string is replaced with the hex codes for the three bytes sent in the information part of the FRMR frame. This message will not appear if your packet controller is in Transparent Mode.
FRMR rcvd:
This message is followed by a display of the FRMR packet received in the trace display format. This format is explained in the TRACe command entry. This message will not appear if your packet con­troller is in Transparent Mode.
PMS Messages
This section describes messages generated by the Personal Message System (PMS). The term USER is applied to an over-the-air PMS user, and SYSOP to the packet operator. Messages to the user are 'SENT', while messages to the SysOp are 'DISPLAYED.
PMS Response Messages
[PMS-3.0-C$]
SID transmitted by PMS during forwarding sessions to the HOMebbs.
*** CONNECTED TO (PMS callsign) Logged on to (PMS callsign)'s Personal Message System (optional message line copied from STExt - may be blank)
CMD(B/H/J/K/KM/UM/R/S/SR/V/?) >
This message set is sent when a user connects to the PMS. Either one of the above message lines may or may not be displayed based on PMS parameter settings.
*** PMS-callsign busy *** DISCONNECTED
If the SysOp is entering a message from the computer terminal, or is PMS is OFF, a user attempt­ing to connect over the air will receive a 'busy' message.
PMS IS BUSY
This message is sent if the PMS is in use by an over-the-air user, and the system operator at­tempts to enter or kill a message or any other action which would alter the contents of the PMS memory area
-Logged off *** DISCONNECTED
These messages are sent in response to the Bye command from a PMS user.
- 89 -
TINY-2/MICRO-2 Operating Manual, 4th Ed. 1990
MYPCALL's Personal Message System
Is displayed to the connecting station if the PMS station has the parameter LOGON set to ON.
You have mail waiting.
Displayed to an over-the-air user during sign on to PMS if there is mail addressed TO that callsign.
B(ye) B[CR] disconnects you from PMS. H(elp) H[CR] or? [CR] displays this help file. J(log) J[CR] displays a list of callsigns heard (optional date/time) K(ill) K n[CR] deletes message n (only to/from your callsign). KM(ine) KM[CR] deletes all READ messages addressed to your call. L(ist) L[CR] lists the 10 latest messages. M(ine) M[CR] lists the 10 latest messages to/from your callsign R(ead) R n[CR] reads message number n. S(end) S (callsign) [CR] begins a message addressed to (callsign).
Subject: max 28 characters ending with [CR]. Text: End each line with [CR]. End message by typing /ex
[CR] or CTRL-Z [CR] at the beginning of a new line. SR(eply) SR n [CR] Sends a reply to message n prompting only for text. V(ersion) V[CR] displays the software version of the PMS system.
The help message display is sent in response to the Help or ? command from a PMS user.
Message erased
This message is sent or displayed in response to the Kill command which originates from either the SysOp or user.
Message marked for forwarding
Response to the SysOp command to mark a message for reverse forwarding.
Message forwarding reset
Response to the SysOp command to 'unforward' a message previously marked for forwarding.
Message has been sent to the printer queue
Response to the PPRint SysOp command to print a PMS message on the packet controller printer port.
Message saved as Msg # n
Response sent or displayed after the completion of 'Sending' a message by either the SysOp or user.
- 90 -
TINY-2/MICRO-2 Operating Manual, 4th Ed. 1990
nnnnn Bytes free, Next message Number n
Displayed at the end of the LEST display
PMS Error Messages
[PMS CMD ERR]
This message is issued when a PMS user sends a command in an improper format. The most com­mon error is using more than one character of the command name. SysOp command errors re­ceive the normal ?unknown command response.
Message not found
This message is issued whenever a Read or Kill command is given with an invalid message number by either a user or SysOp.
YOU CANNOT KILL THIS MESSAGE
This message is issued when a user attempts to kill a message not to or from his callsign.
YOU CANNOT READ THIS MESSAGE
This message is issued when an attempt is made to read a message not addressed to or from the user's callsign, or ALL.
No third party mail allowed
When 3rdparty is OFF, this message is issued when a user attempts to send a message to other than the PMS (SysOp) callsign.
- Buffer overflow
This message is issued when the PMS memory capacity is exhausted and the message being sent has been truncated.
Parameters are missing
This message is issued when the EDithdr command is used by the SysOp with improper parame­ters.
You cannot forward a bulletin
This message is issued when an attempt is made by the SysOp to mark a bulletin for forwarding.
Entry too long, try again
Displayed whenever too many characters are entered at prompt i.e. too long a BID or Subject en­try.
- 91 -
Loading...