Home » Recent acquisitions » Acorn ADFS disks » adfs_AcornUser_199610.adf » Features » MikeC/QandA/!Rs232stat/!Help

MikeC/QandA/!Rs232stat/!Help

This website contains an archive of files for the Acorn Electron, BBC Micro, Acorn Archimedes, Commodore 16 and Commodore 64 computers, which Dominic Ford has rescued from his private collection of floppy disks and cassettes.

Some of these files were originally commercial releases in the 1980s and 1990s, but they are now widely available online. I assume that copyright over them is no longer being asserted. If you own the copyright and would like files to be removed, please contact me.

Tape/disk: Home » Recent acquisitions » Acorn ADFS disks » adfs_AcornUser_199610.adf » Features
Filename: MikeC/QandA/!Rs232stat/!Help
Read OK:
File size: 17BF bytes
Load address: 0000
Exec address: 0000
File contents
!RS232Stat Version 1.00 - Released April 14, 1994
=======================

A program to monitor the serial port status.

It proved invaluable to me when I was first getting a modem going on
my Arc - maybe it will to you.


The display is derived from various OS_SerialOp and OS_Byte calls
and is updated ONLY on null events when the window is open. Any changes
you make to the various parameters will update the window on the next
null event. The display is never changed DIRECTLY as a result of a
mouse click. Hence when you see a change in status after you have clicked
on something, you can be sure it's the device driver which has acted upon
it.

The 'option' icons can be used to change the current settings. Click with
select to toggle the current setting.

The 'radio' buttons are read-only; they reflect the state of various signals
received by the computer from the modem.


Line Parameters
===============
The RX speed and the TX speed can, in theory, be set independantly to
different values. In practise however the hardware is only capable of
one pair of unequal TX and RX speeds - transmit at 75 baud and receive
at 1200 baud. The newer machines cannot even do that.
If you change the RX speed, both the RX and TX speeds are configured
using OS_SerialOp 5/6. If you change the TX speed, TX only is configured
using OS_SerialOp 6. Normally a change to either will result in the
driver changing both.
The Data Format display is derived from OS_SerialOp 1. The menu to configure
it is at present based on the much more restricted OS_Byte 156. In the future
I want to expand this to include all possible options allowed by OS_SerialOp 1.

Buffers
=======
The Input buffer count is the number of bytes received which have not yet
been read by a program.
The Output buffer count is the number of bytes for which there is room for
a program to write.
The Threshold value indicates the minimum number of bytes in the input buffer
before the driver takes action to stop the flow towards the computer (see
Hardware and Software Flow Control). This value can be changed by clicking
in the icon. Enter the new value and press Return. While the caret is in
this icon, the field will not be updated on null events.

Control
=======
DTR is the signal the computer uses to tell the modem that it is powered on
and ready for use. Some modems don't work if DTR is off; none that I know
of will auto-answer in this state. I always ensure DTR is off when I'm not
using the modem. This has the side-effect of giving the modem a good reset
when DTR is dropped (see modem command AT&D3).

DCD is the signal the modem uses to indicate to the computer that there is
a carrier, i.e. the data connection is established. The Arc can be told
to ignore DCD (the normal situation) or to respect it and disable the
serial port unless DCD is on. Modems can usually be configured to use
DCD normally (AT&C1) or to force DCD on (AT&C0).

DSR is the signal the modem uses to tell the computer that it is powered on
and ready for use, i.e. the reverse of DTR. The Arc can be told to ignore
DSR or to respect it and disable the serial port unless DSR is on. If DSR
is to be used and it is off, serial port output is still enabled but input
characters are ignored. Modems can often be configured to do different
things with DSR.

The RI (Ring Indicator) icon will pulse on and off when the modem recognizes
that the phone is ringing. Otherwise it will be Off.

Software Flow Control aka Xon/Xoff
==================================

This is mostly used for end-to-end flow control, so the Arc can tell the
host to stop or resume transmission and vice versa. Terminal connections
usually work this way, but it may cause problems during file transfers.
The host program will probably reconfigure its port to disable Xon/Xoff
during file transfers, but most Arc programs do not!
TX Unblocked means that the Arc thinks it is free to send, i.e. it has
not received an Xoff (DC3) since the last Xon (DC1).
RX Unblocked means that the Arc has told the other end to stop sending
by transmitting an Xoff.

Hardware Flow Control
=====================

This is normally used for the local connection between computer and modem.
It is necessary because of the interspeeder which modern modems use, so that
the speed with which the computer talks to the modem is not necessarily the
same speed at which the modem transmits and receives over the telephone line.
RTS is the signal with which the computer indicates to the modem whether it
has room in its buffer to receive more characters. Normally it is under the
control of the flow control business, but if you are only using software
flow control you may need to force RTS on to get the modem to cooperate.
CTS is the opposite; the modem uses CTS to tell the computer it can send.
The Arc can respect or ignore this signal.

Suggested settings to get going
===============================

If you can't seem to persuade your Arc to talk to your modem or vice versa,
try:
    Speed: as appropriate
    Data Format: 8N1
    'DTR State' On
    'Use DCD' Off
    'Use DSR' Off
    'Use CTS' Off

Once that works, the following should prove serviceable for most purposes:
    'Use DCD' Off
    'Use DSR' On
    H/W Flow Control Enabled
    'Force RTS On' Off
    'Use CTS' On
    Software Flow Control Enabled (disable during file transfers and when
        using SLIP!)
    
Futures
=======

*   add better configuration facilities for the Data Format.
*   add facility to save and restore settings, and to reset them to
    defaults

Contacting me
=============

If you have any comments to make about this program or this text, I can be
contacted via e-mail: colin@integrity.nl.
Alternatively:
    Colin Smale
    Spechtenkamp 87
    3607 KE   MAARSSEN
    Netherlands
    Tel: +31-3465-69038
    Fax: same number, phone first!

Legaleze
========

I hereby place this program in the public domain. Do what you want
with it, except sell it. Source code on request with a reasonable
reason for wanting it. Written in C (V3!) using risc_oslib. No guarantees
whatsoever.
00000000  0a 21 52 53 32 33 32 53  74 61 74 20 56 65 72 73  |.!RS232Stat Vers|
00000010  69 6f 6e 20 31 2e 30 30  20 2d 20 52 65 6c 65 61  |ion 1.00 - Relea|
00000020  73 65 64 20 41 70 72 69  6c 20 31 34 2c 20 31 39  |sed April 14, 19|
00000030  39 34 0a 3d 3d 3d 3d 3d  3d 3d 3d 3d 3d 3d 3d 3d  |94.=============|
00000040  3d 3d 3d 3d 3d 3d 3d 3d  3d 3d 0a 0a 41 20 70 72  |==========..A pr|
00000050  6f 67 72 61 6d 20 74 6f  20 6d 6f 6e 69 74 6f 72  |ogram to monitor|
00000060  20 74 68 65 20 73 65 72  69 61 6c 20 70 6f 72 74  | the serial port|
00000070  20 73 74 61 74 75 73 2e  0a 0a 49 74 20 70 72 6f  | status...It pro|
00000080  76 65 64 20 69 6e 76 61  6c 75 61 62 6c 65 20 74  |ved invaluable t|
00000090  6f 20 6d 65 20 77 68 65  6e 20 49 20 77 61 73 20  |o me when I was |
000000a0  66 69 72 73 74 20 67 65  74 74 69 6e 67 20 61 20  |first getting a |
000000b0  6d 6f 64 65 6d 20 67 6f  69 6e 67 20 6f 6e 0a 6d  |modem going on.m|
000000c0  79 20 41 72 63 20 2d 20  6d 61 79 62 65 20 69 74  |y Arc - maybe it|
000000d0  20 77 69 6c 6c 20 74 6f  20 79 6f 75 2e 0a 0a 0a  | will to you....|
000000e0  54 68 65 20 64 69 73 70  6c 61 79 20 69 73 20 64  |The display is d|
000000f0  65 72 69 76 65 64 20 66  72 6f 6d 20 76 61 72 69  |erived from vari|
00000100  6f 75 73 20 4f 53 5f 53  65 72 69 61 6c 4f 70 20  |ous OS_SerialOp |
00000110  61 6e 64 20 4f 53 5f 42  79 74 65 20 63 61 6c 6c  |and OS_Byte call|
00000120  73 0a 61 6e 64 20 69 73  20 75 70 64 61 74 65 64  |s.and is updated|
00000130  20 4f 4e 4c 59 20 6f 6e  20 6e 75 6c 6c 20 65 76  | ONLY on null ev|
00000140  65 6e 74 73 20 77 68 65  6e 20 74 68 65 20 77 69  |ents when the wi|
00000150  6e 64 6f 77 20 69 73 20  6f 70 65 6e 2e 20 41 6e  |ndow is open. An|
00000160  79 20 63 68 61 6e 67 65  73 0a 79 6f 75 20 6d 61  |y changes.you ma|
00000170  6b 65 20 74 6f 20 74 68  65 20 76 61 72 69 6f 75  |ke to the variou|
00000180  73 20 70 61 72 61 6d 65  74 65 72 73 20 77 69 6c  |s parameters wil|
00000190  6c 20 75 70 64 61 74 65  20 74 68 65 20 77 69 6e  |l update the win|
000001a0  64 6f 77 20 6f 6e 20 74  68 65 20 6e 65 78 74 0a  |dow on the next.|
000001b0  6e 75 6c 6c 20 65 76 65  6e 74 2e 20 54 68 65 20  |null event. The |
000001c0  64 69 73 70 6c 61 79 20  69 73 20 6e 65 76 65 72  |display is never|
000001d0  20 63 68 61 6e 67 65 64  20 44 49 52 45 43 54 4c  | changed DIRECTL|
000001e0  59 20 61 73 20 61 20 72  65 73 75 6c 74 20 6f 66  |Y as a result of|
000001f0  20 61 0a 6d 6f 75 73 65  20 63 6c 69 63 6b 2e 20  | a.mouse click. |
00000200  48 65 6e 63 65 20 77 68  65 6e 20 79 6f 75 20 73  |Hence when you s|
00000210  65 65 20 61 20 63 68 61  6e 67 65 20 69 6e 20 73  |ee a change in s|
00000220  74 61 74 75 73 20 61 66  74 65 72 20 79 6f 75 20  |tatus after you |
00000230  68 61 76 65 20 63 6c 69  63 6b 65 64 0a 6f 6e 20  |have clicked.on |
00000240  73 6f 6d 65 74 68 69 6e  67 2c 20 79 6f 75 20 63  |something, you c|
00000250  61 6e 20 62 65 20 73 75  72 65 20 69 74 27 73 20  |an be sure it's |
00000260  74 68 65 20 64 65 76 69  63 65 20 64 72 69 76 65  |the device drive|
00000270  72 20 77 68 69 63 68 20  68 61 73 20 61 63 74 65  |r which has acte|
00000280  64 20 75 70 6f 6e 0a 69  74 2e 0a 0a 54 68 65 20  |d upon.it...The |
00000290  27 6f 70 74 69 6f 6e 27  20 69 63 6f 6e 73 20 63  |'option' icons c|
000002a0  61 6e 20 62 65 20 75 73  65 64 20 74 6f 20 63 68  |an be used to ch|
000002b0  61 6e 67 65 20 74 68 65  20 63 75 72 72 65 6e 74  |ange the current|
000002c0  20 73 65 74 74 69 6e 67  73 2e 20 43 6c 69 63 6b  | settings. Click|
000002d0  20 77 69 74 68 0a 73 65  6c 65 63 74 20 74 6f 20  | with.select to |
000002e0  74 6f 67 67 6c 65 20 74  68 65 20 63 75 72 72 65  |toggle the curre|
000002f0  6e 74 20 73 65 74 74 69  6e 67 2e 0a 0a 54 68 65  |nt setting...The|
00000300  20 27 72 61 64 69 6f 27  20 62 75 74 74 6f 6e 73  | 'radio' buttons|
00000310  20 61 72 65 20 72 65 61  64 2d 6f 6e 6c 79 3b 20  | are read-only; |
00000320  74 68 65 79 20 72 65 66  6c 65 63 74 20 74 68 65  |they reflect the|
00000330  20 73 74 61 74 65 20 6f  66 20 76 61 72 69 6f 75  | state of variou|
00000340  73 20 73 69 67 6e 61 6c  73 0a 72 65 63 65 69 76  |s signals.receiv|
00000350  65 64 20 62 79 20 74 68  65 20 63 6f 6d 70 75 74  |ed by the comput|
00000360  65 72 20 66 72 6f 6d 20  74 68 65 20 6d 6f 64 65  |er from the mode|
00000370  6d 2e 0a 0a 0a 4c 69 6e  65 20 50 61 72 61 6d 65  |m....Line Parame|
00000380  74 65 72 73 0a 3d 3d 3d  3d 3d 3d 3d 3d 3d 3d 3d  |ters.===========|
00000390  3d 3d 3d 3d 0a 54 68 65  20 52 58 20 73 70 65 65  |====.The RX spee|
000003a0  64 20 61 6e 64 20 74 68  65 20 54 58 20 73 70 65  |d and the TX spe|
000003b0  65 64 20 63 61 6e 2c 20  69 6e 20 74 68 65 6f 72  |ed can, in theor|
000003c0  79 2c 20 62 65 20 73 65  74 20 69 6e 64 65 70 65  |y, be set indepe|
000003d0  6e 64 61 6e 74 6c 79 20  74 6f 0a 64 69 66 66 65  |ndantly to.diffe|
000003e0  72 65 6e 74 20 76 61 6c  75 65 73 2e 20 49 6e 20  |rent values. In |
000003f0  70 72 61 63 74 69 73 65  20 68 6f 77 65 76 65 72  |practise however|
00000400  20 74 68 65 20 68 61 72  64 77 61 72 65 20 69 73  | the hardware is|
00000410  20 6f 6e 6c 79 20 63 61  70 61 62 6c 65 20 6f 66  | only capable of|
00000420  0a 6f 6e 65 20 70 61 69  72 20 6f 66 20 75 6e 65  |.one pair of une|
00000430  71 75 61 6c 20 54 58 20  61 6e 64 20 52 58 20 73  |qual TX and RX s|
00000440  70 65 65 64 73 20 2d 20  74 72 61 6e 73 6d 69 74  |peeds - transmit|
00000450  20 61 74 20 37 35 20 62  61 75 64 20 61 6e 64 20  | at 75 baud and |
00000460  72 65 63 65 69 76 65 0a  61 74 20 31 32 30 30 20  |receive.at 1200 |
00000470  62 61 75 64 2e 20 54 68  65 20 6e 65 77 65 72 20  |baud. The newer |
00000480  6d 61 63 68 69 6e 65 73  20 63 61 6e 6e 6f 74 20  |machines cannot |
00000490  65 76 65 6e 20 64 6f 20  74 68 61 74 2e 0a 49 66  |even do that..If|
000004a0  20 79 6f 75 20 63 68 61  6e 67 65 20 74 68 65 20  | you change the |
000004b0  52 58 20 73 70 65 65 64  2c 20 62 6f 74 68 20 74  |RX speed, both t|
000004c0  68 65 20 52 58 20 61 6e  64 20 54 58 20 73 70 65  |he RX and TX spe|
000004d0  65 64 73 20 61 72 65 20  63 6f 6e 66 69 67 75 72  |eds are configur|
000004e0  65 64 0a 75 73 69 6e 67  20 4f 53 5f 53 65 72 69  |ed.using OS_Seri|
000004f0  61 6c 4f 70 20 35 2f 36  2e 20 49 66 20 79 6f 75  |alOp 5/6. If you|
00000500  20 63 68 61 6e 67 65 20  74 68 65 20 54 58 20 73  | change the TX s|
00000510  70 65 65 64 2c 20 54 58  20 6f 6e 6c 79 20 69 73  |peed, TX only is|
00000520  20 63 6f 6e 66 69 67 75  72 65 64 0a 75 73 69 6e  | configured.usin|
00000530  67 20 4f 53 5f 53 65 72  69 61 6c 4f 70 20 36 2e  |g OS_SerialOp 6.|
00000540  20 4e 6f 72 6d 61 6c 6c  79 20 61 20 63 68 61 6e  | Normally a chan|
00000550  67 65 20 74 6f 20 65 69  74 68 65 72 20 77 69 6c  |ge to either wil|
00000560  6c 20 72 65 73 75 6c 74  20 69 6e 20 74 68 65 0a  |l result in the.|
00000570  64 72 69 76 65 72 20 63  68 61 6e 67 69 6e 67 20  |driver changing |
00000580  62 6f 74 68 2e 0a 54 68  65 20 44 61 74 61 20 46  |both..The Data F|
00000590  6f 72 6d 61 74 20 64 69  73 70 6c 61 79 20 69 73  |ormat display is|
000005a0  20 64 65 72 69 76 65 64  20 66 72 6f 6d 20 4f 53  | derived from OS|
000005b0  5f 53 65 72 69 61 6c 4f  70 20 31 2e 20 54 68 65  |_SerialOp 1. The|
000005c0  20 6d 65 6e 75 20 74 6f  20 63 6f 6e 66 69 67 75  | menu to configu|
000005d0  72 65 0a 69 74 20 69 73  20 61 74 20 70 72 65 73  |re.it is at pres|
000005e0  65 6e 74 20 62 61 73 65  64 20 6f 6e 20 74 68 65  |ent based on the|
000005f0  20 6d 75 63 68 20 6d 6f  72 65 20 72 65 73 74 72  | much more restr|
00000600  69 63 74 65 64 20 4f 53  5f 42 79 74 65 20 31 35  |icted OS_Byte 15|
00000610  36 2e 20 49 6e 20 74 68  65 20 66 75 74 75 72 65  |6. In the future|
00000620  0a 49 20 77 61 6e 74 20  74 6f 20 65 78 70 61 6e  |.I want to expan|
00000630  64 20 74 68 69 73 20 74  6f 20 69 6e 63 6c 75 64  |d this to includ|
00000640  65 20 61 6c 6c 20 70 6f  73 73 69 62 6c 65 20 6f  |e all possible o|
00000650  70 74 69 6f 6e 73 20 61  6c 6c 6f 77 65 64 20 62  |ptions allowed b|
00000660  79 20 4f 53 5f 53 65 72  69 61 6c 4f 70 20 31 2e  |y OS_SerialOp 1.|
00000670  0a 0a 42 75 66 66 65 72  73 0a 3d 3d 3d 3d 3d 3d  |..Buffers.======|
00000680  3d 0a 54 68 65 20 49 6e  70 75 74 20 62 75 66 66  |=.The Input buff|
00000690  65 72 20 63 6f 75 6e 74  20 69 73 20 74 68 65 20  |er count is the |
000006a0  6e 75 6d 62 65 72 20 6f  66 20 62 79 74 65 73 20  |number of bytes |
000006b0  72 65 63 65 69 76 65 64  20 77 68 69 63 68 20 68  |received which h|
000006c0  61 76 65 20 6e 6f 74 20  79 65 74 0a 62 65 65 6e  |ave not yet.been|
000006d0  20 72 65 61 64 20 62 79  20 61 20 70 72 6f 67 72  | read by a progr|
000006e0  61 6d 2e 0a 54 68 65 20  4f 75 74 70 75 74 20 62  |am..The Output b|
000006f0  75 66 66 65 72 20 63 6f  75 6e 74 20 69 73 20 74  |uffer count is t|
00000700  68 65 20 6e 75 6d 62 65  72 20 6f 66 20 62 79 74  |he number of byt|
00000710  65 73 20 66 6f 72 20 77  68 69 63 68 20 74 68 65  |es for which the|
00000720  72 65 20 69 73 20 72 6f  6f 6d 20 66 6f 72 0a 61  |re is room for.a|
00000730  20 70 72 6f 67 72 61 6d  20 74 6f 20 77 72 69 74  | program to writ|
00000740  65 2e 0a 54 68 65 20 54  68 72 65 73 68 6f 6c 64  |e..The Threshold|
00000750  20 76 61 6c 75 65 20 69  6e 64 69 63 61 74 65 73  | value indicates|
00000760  20 74 68 65 20 6d 69 6e  69 6d 75 6d 20 6e 75 6d  | the minimum num|
00000770  62 65 72 20 6f 66 20 62  79 74 65 73 20 69 6e 20  |ber of bytes in |
00000780  74 68 65 20 69 6e 70 75  74 20 62 75 66 66 65 72  |the input buffer|
00000790  0a 62 65 66 6f 72 65 20  74 68 65 20 64 72 69 76  |.before the driv|
000007a0  65 72 20 74 61 6b 65 73  20 61 63 74 69 6f 6e 20  |er takes action |
000007b0  74 6f 20 73 74 6f 70 20  74 68 65 20 66 6c 6f 77  |to stop the flow|
000007c0  20 74 6f 77 61 72 64 73  20 74 68 65 20 63 6f 6d  | towards the com|
000007d0  70 75 74 65 72 20 28 73  65 65 0a 48 61 72 64 77  |puter (see.Hardw|
000007e0  61 72 65 20 61 6e 64 20  53 6f 66 74 77 61 72 65  |are and Software|
000007f0  20 46 6c 6f 77 20 43 6f  6e 74 72 6f 6c 29 2e 20  | Flow Control). |
00000800  54 68 69 73 20 76 61 6c  75 65 20 63 61 6e 20 62  |This value can b|
00000810  65 20 63 68 61 6e 67 65  64 20 62 79 20 63 6c 69  |e changed by cli|
00000820  63 6b 69 6e 67 0a 69 6e  20 74 68 65 20 69 63 6f  |cking.in the ico|
00000830  6e 2e 20 45 6e 74 65 72  20 74 68 65 20 6e 65 77  |n. Enter the new|
00000840  20 76 61 6c 75 65 20 61  6e 64 20 70 72 65 73 73  | value and press|
00000850  20 52 65 74 75 72 6e 2e  20 57 68 69 6c 65 20 74  | Return. While t|
00000860  68 65 20 63 61 72 65 74  20 69 73 20 69 6e 0a 74  |he caret is in.t|
00000870  68 69 73 20 69 63 6f 6e  2c 20 74 68 65 20 66 69  |his icon, the fi|
00000880  65 6c 64 20 77 69 6c 6c  20 6e 6f 74 20 62 65 20  |eld will not be |
00000890  75 70 64 61 74 65 64 20  6f 6e 20 6e 75 6c 6c 20  |updated on null |
000008a0  65 76 65 6e 74 73 2e 0a  0a 43 6f 6e 74 72 6f 6c  |events...Control|
000008b0  0a 3d 3d 3d 3d 3d 3d 3d  0a 44 54 52 20 69 73 20  |.=======.DTR is |
000008c0  74 68 65 20 73 69 67 6e  61 6c 20 74 68 65 20 63  |the signal the c|
000008d0  6f 6d 70 75 74 65 72 20  75 73 65 73 20 74 6f 20  |omputer uses to |
000008e0  74 65 6c 6c 20 74 68 65  20 6d 6f 64 65 6d 20 74  |tell the modem t|
000008f0  68 61 74 20 69 74 20 69  73 20 70 6f 77 65 72 65  |hat it is powere|
00000900  64 20 6f 6e 0a 61 6e 64  20 72 65 61 64 79 20 66  |d on.and ready f|
00000910  6f 72 20 75 73 65 2e 20  53 6f 6d 65 20 6d 6f 64  |or use. Some mod|
00000920  65 6d 73 20 64 6f 6e 27  74 20 77 6f 72 6b 20 69  |ems don't work i|
00000930  66 20 44 54 52 20 69 73  20 6f 66 66 3b 20 6e 6f  |f DTR is off; no|
00000940  6e 65 20 74 68 61 74 20  49 20 6b 6e 6f 77 0a 6f  |ne that I know.o|
00000950  66 20 77 69 6c 6c 20 61  75 74 6f 2d 61 6e 73 77  |f will auto-answ|
00000960  65 72 20 69 6e 20 74 68  69 73 20 73 74 61 74 65  |er in this state|
00000970  2e 20 49 20 61 6c 77 61  79 73 20 65 6e 73 75 72  |. I always ensur|
00000980  65 20 44 54 52 20 69 73  20 6f 66 66 20 77 68 65  |e DTR is off whe|
00000990  6e 20 49 27 6d 20 6e 6f  74 0a 75 73 69 6e 67 20  |n I'm not.using |
000009a0  74 68 65 20 6d 6f 64 65  6d 2e 20 54 68 69 73 20  |the modem. This |
000009b0  68 61 73 20 74 68 65 20  73 69 64 65 2d 65 66 66  |has the side-eff|
000009c0  65 63 74 20 6f 66 20 67  69 76 69 6e 67 20 74 68  |ect of giving th|
000009d0  65 20 6d 6f 64 65 6d 20  61 20 67 6f 6f 64 20 72  |e modem a good r|
000009e0  65 73 65 74 0a 77 68 65  6e 20 44 54 52 20 69 73  |eset.when DTR is|
000009f0  20 64 72 6f 70 70 65 64  20 28 73 65 65 20 6d 6f  | dropped (see mo|
00000a00  64 65 6d 20 63 6f 6d 6d  61 6e 64 20 41 54 26 44  |dem command AT&D|
00000a10  33 29 2e 0a 0a 44 43 44  20 69 73 20 74 68 65 20  |3)...DCD is the |
00000a20  73 69 67 6e 61 6c 20 74  68 65 20 6d 6f 64 65 6d  |signal the modem|
00000a30  20 75 73 65 73 20 74 6f  20 69 6e 64 69 63 61 74  | uses to indicat|
00000a40  65 20 74 6f 20 74 68 65  20 63 6f 6d 70 75 74 65  |e to the compute|
00000a50  72 20 74 68 61 74 20 74  68 65 72 65 20 69 73 0a  |r that there is.|
00000a60  61 20 63 61 72 72 69 65  72 2c 20 69 2e 65 2e 20  |a carrier, i.e. |
00000a70  74 68 65 20 64 61 74 61  20 63 6f 6e 6e 65 63 74  |the data connect|
00000a80  69 6f 6e 20 69 73 20 65  73 74 61 62 6c 69 73 68  |ion is establish|
00000a90  65 64 2e 20 54 68 65 20  41 72 63 20 63 61 6e 20  |ed. The Arc can |
00000aa0  62 65 20 74 6f 6c 64 0a  74 6f 20 69 67 6e 6f 72  |be told.to ignor|
00000ab0  65 20 44 43 44 20 28 74  68 65 20 6e 6f 72 6d 61  |e DCD (the norma|
00000ac0  6c 20 73 69 74 75 61 74  69 6f 6e 29 20 6f 72 20  |l situation) or |
00000ad0  74 6f 20 72 65 73 70 65  63 74 20 69 74 20 61 6e  |to respect it an|
00000ae0  64 20 64 69 73 61 62 6c  65 20 74 68 65 0a 73 65  |d disable the.se|
00000af0  72 69 61 6c 20 70 6f 72  74 20 75 6e 6c 65 73 73  |rial port unless|
00000b00  20 44 43 44 20 69 73 20  6f 6e 2e 20 4d 6f 64 65  | DCD is on. Mode|
00000b10  6d 73 20 63 61 6e 20 75  73 75 61 6c 6c 79 20 62  |ms can usually b|
00000b20  65 20 63 6f 6e 66 69 67  75 72 65 64 20 74 6f 20  |e configured to |
00000b30  75 73 65 0a 44 43 44 20  6e 6f 72 6d 61 6c 6c 79  |use.DCD normally|
00000b40  20 28 41 54 26 43 31 29  20 6f 72 20 74 6f 20 66  | (AT&C1) or to f|
00000b50  6f 72 63 65 20 44 43 44  20 6f 6e 20 28 41 54 26  |orce DCD on (AT&|
00000b60  43 30 29 2e 0a 0a 44 53  52 20 69 73 20 74 68 65  |C0)...DSR is the|
00000b70  20 73 69 67 6e 61 6c 20  74 68 65 20 6d 6f 64 65  | signal the mode|
00000b80  6d 20 75 73 65 73 20 74  6f 20 74 65 6c 6c 20 74  |m uses to tell t|
00000b90  68 65 20 63 6f 6d 70 75  74 65 72 20 74 68 61 74  |he computer that|
00000ba0  20 69 74 20 69 73 20 70  6f 77 65 72 65 64 20 6f  | it is powered o|
00000bb0  6e 0a 61 6e 64 20 72 65  61 64 79 20 66 6f 72 20  |n.and ready for |
00000bc0  75 73 65 2c 20 69 2e 65  2e 20 74 68 65 20 72 65  |use, i.e. the re|
00000bd0  76 65 72 73 65 20 6f 66  20 44 54 52 2e 20 54 68  |verse of DTR. Th|
00000be0  65 20 41 72 63 20 63 61  6e 20 62 65 20 74 6f 6c  |e Arc can be tol|
00000bf0  64 20 74 6f 20 69 67 6e  6f 72 65 0a 44 53 52 20  |d to ignore.DSR |
00000c00  6f 72 20 74 6f 20 72 65  73 70 65 63 74 20 69 74  |or to respect it|
00000c10  20 61 6e 64 20 64 69 73  61 62 6c 65 20 74 68 65  | and disable the|
00000c20  20 73 65 72 69 61 6c 20  70 6f 72 74 20 75 6e 6c  | serial port unl|
00000c30  65 73 73 20 44 53 52 20  69 73 20 6f 6e 2e 20 49  |ess DSR is on. I|
00000c40  66 20 44 53 52 0a 69 73  20 74 6f 20 62 65 20 75  |f DSR.is to be u|
00000c50  73 65 64 20 61 6e 64 20  69 74 20 69 73 20 6f 66  |sed and it is of|
00000c60  66 2c 20 73 65 72 69 61  6c 20 70 6f 72 74 20 6f  |f, serial port o|
00000c70  75 74 70 75 74 20 69 73  20 73 74 69 6c 6c 20 65  |utput is still e|
00000c80  6e 61 62 6c 65 64 20 62  75 74 20 69 6e 70 75 74  |nabled but input|
00000c90  0a 63 68 61 72 61 63 74  65 72 73 20 61 72 65 20  |.characters are |
00000ca0  69 67 6e 6f 72 65 64 2e  20 4d 6f 64 65 6d 73 20  |ignored. Modems |
00000cb0  63 61 6e 20 6f 66 74 65  6e 20 62 65 20 63 6f 6e  |can often be con|
00000cc0  66 69 67 75 72 65 64 20  74 6f 20 64 6f 20 64 69  |figured to do di|
00000cd0  66 66 65 72 65 6e 74 0a  74 68 69 6e 67 73 20 77  |fferent.things w|
00000ce0  69 74 68 20 44 53 52 2e  0a 0a 54 68 65 20 52 49  |ith DSR...The RI|
00000cf0  20 28 52 69 6e 67 20 49  6e 64 69 63 61 74 6f 72  | (Ring Indicator|
00000d00  29 20 69 63 6f 6e 20 77  69 6c 6c 20 70 75 6c 73  |) icon will puls|
00000d10  65 20 6f 6e 20 61 6e 64  20 6f 66 66 20 77 68 65  |e on and off whe|
00000d20  6e 20 74 68 65 20 6d 6f  64 65 6d 20 72 65 63 6f  |n the modem reco|
00000d30  67 6e 69 7a 65 73 0a 74  68 61 74 20 74 68 65 20  |gnizes.that the |
00000d40  70 68 6f 6e 65 20 69 73  20 72 69 6e 67 69 6e 67  |phone is ringing|
00000d50  2e 20 4f 74 68 65 72 77  69 73 65 20 69 74 20 77  |. Otherwise it w|
00000d60  69 6c 6c 20 62 65 20 4f  66 66 2e 0a 0a 53 6f 66  |ill be Off...Sof|
00000d70  74 77 61 72 65 20 46 6c  6f 77 20 43 6f 6e 74 72  |tware Flow Contr|
00000d80  6f 6c 20 61 6b 61 20 58  6f 6e 2f 58 6f 66 66 0a  |ol aka Xon/Xoff.|
00000d90  3d 3d 3d 3d 3d 3d 3d 3d  3d 3d 3d 3d 3d 3d 3d 3d  |================|
*
00000db0  3d 3d 0a 0a 54 68 69 73  20 69 73 20 6d 6f 73 74  |==..This is most|
00000dc0  6c 79 20 75 73 65 64 20  66 6f 72 20 65 6e 64 2d  |ly used for end-|
00000dd0  74 6f 2d 65 6e 64 20 66  6c 6f 77 20 63 6f 6e 74  |to-end flow cont|
00000de0  72 6f 6c 2c 20 73 6f 20  74 68 65 20 41 72 63 20  |rol, so the Arc |
00000df0  63 61 6e 20 74 65 6c 6c  20 74 68 65 0a 68 6f 73  |can tell the.hos|
00000e00  74 20 74 6f 20 73 74 6f  70 20 6f 72 20 72 65 73  |t to stop or res|
00000e10  75 6d 65 20 74 72 61 6e  73 6d 69 73 73 69 6f 6e  |ume transmission|
00000e20  20 61 6e 64 20 76 69 63  65 20 76 65 72 73 61 2e  | and vice versa.|
00000e30  20 54 65 72 6d 69 6e 61  6c 20 63 6f 6e 6e 65 63  | Terminal connec|
00000e40  74 69 6f 6e 73 0a 75 73  75 61 6c 6c 79 20 77 6f  |tions.usually wo|
00000e50  72 6b 20 74 68 69 73 20  77 61 79 2c 20 62 75 74  |rk this way, but|
00000e60  20 69 74 20 6d 61 79 20  63 61 75 73 65 20 70 72  | it may cause pr|
00000e70  6f 62 6c 65 6d 73 20 64  75 72 69 6e 67 20 66 69  |oblems during fi|
00000e80  6c 65 20 74 72 61 6e 73  66 65 72 73 2e 0a 54 68  |le transfers..Th|
00000e90  65 20 68 6f 73 74 20 70  72 6f 67 72 61 6d 20 77  |e host program w|
00000ea0  69 6c 6c 20 70 72 6f 62  61 62 6c 79 20 72 65 63  |ill probably rec|
00000eb0  6f 6e 66 69 67 75 72 65  20 69 74 73 20 70 6f 72  |onfigure its por|
00000ec0  74 20 74 6f 20 64 69 73  61 62 6c 65 20 58 6f 6e  |t to disable Xon|
00000ed0  2f 58 6f 66 66 0a 64 75  72 69 6e 67 20 66 69 6c  |/Xoff.during fil|
00000ee0  65 20 74 72 61 6e 73 66  65 72 73 2c 20 62 75 74  |e transfers, but|
00000ef0  20 6d 6f 73 74 20 41 72  63 20 70 72 6f 67 72 61  | most Arc progra|
00000f00  6d 73 20 64 6f 20 6e 6f  74 21 0a 54 58 20 55 6e  |ms do not!.TX Un|
00000f10  62 6c 6f 63 6b 65 64 20  6d 65 61 6e 73 20 74 68  |blocked means th|
00000f20  61 74 20 74 68 65 20 41  72 63 20 74 68 69 6e 6b  |at the Arc think|
00000f30  73 20 69 74 20 69 73 20  66 72 65 65 20 74 6f 20  |s it is free to |
00000f40  73 65 6e 64 2c 20 69 2e  65 2e 20 69 74 20 68 61  |send, i.e. it ha|
00000f50  73 0a 6e 6f 74 20 72 65  63 65 69 76 65 64 20 61  |s.not received a|
00000f60  6e 20 58 6f 66 66 20 28  44 43 33 29 20 73 69 6e  |n Xoff (DC3) sin|
00000f70  63 65 20 74 68 65 20 6c  61 73 74 20 58 6f 6e 20  |ce the last Xon |
00000f80  28 44 43 31 29 2e 0a 52  58 20 55 6e 62 6c 6f 63  |(DC1)..RX Unbloc|
00000f90  6b 65 64 20 6d 65 61 6e  73 20 74 68 61 74 20 74  |ked means that t|
00000fa0  68 65 20 41 72 63 20 68  61 73 20 74 6f 6c 64 20  |he Arc has told |
00000fb0  74 68 65 20 6f 74 68 65  72 20 65 6e 64 20 74 6f  |the other end to|
00000fc0  20 73 74 6f 70 20 73 65  6e 64 69 6e 67 0a 62 79  | stop sending.by|
00000fd0  20 74 72 61 6e 73 6d 69  74 74 69 6e 67 20 61 6e  | transmitting an|
00000fe0  20 58 6f 66 66 2e 0a 0a  48 61 72 64 77 61 72 65  | Xoff...Hardware|
00000ff0  20 46 6c 6f 77 20 43 6f  6e 74 72 6f 6c 0a 3d 3d  | Flow Control.==|
00001000  3d 3d 3d 3d 3d 3d 3d 3d  3d 3d 3d 3d 3d 3d 3d 3d  |================|
00001010  3d 3d 3d 0a 0a 54 68 69  73 20 69 73 20 6e 6f 72  |===..This is nor|
00001020  6d 61 6c 6c 79 20 75 73  65 64 20 66 6f 72 20 74  |mally used for t|
00001030  68 65 20 6c 6f 63 61 6c  20 63 6f 6e 6e 65 63 74  |he local connect|
00001040  69 6f 6e 20 62 65 74 77  65 65 6e 20 63 6f 6d 70  |ion between comp|
00001050  75 74 65 72 20 61 6e 64  20 6d 6f 64 65 6d 2e 0a  |uter and modem..|
00001060  49 74 20 69 73 20 6e 65  63 65 73 73 61 72 79 20  |It is necessary |
00001070  62 65 63 61 75 73 65 20  6f 66 20 74 68 65 20 69  |because of the i|
00001080  6e 74 65 72 73 70 65 65  64 65 72 20 77 68 69 63  |nterspeeder whic|
00001090  68 20 6d 6f 64 65 72 6e  20 6d 6f 64 65 6d 73 20  |h modern modems |
000010a0  75 73 65 2c 20 73 6f 20  74 68 61 74 0a 74 68 65  |use, so that.the|
000010b0  20 73 70 65 65 64 20 77  69 74 68 20 77 68 69 63  | speed with whic|
000010c0  68 20 74 68 65 20 63 6f  6d 70 75 74 65 72 20 74  |h the computer t|
000010d0  61 6c 6b 73 20 74 6f 20  74 68 65 20 6d 6f 64 65  |alks to the mode|
000010e0  6d 20 69 73 20 6e 6f 74  20 6e 65 63 65 73 73 61  |m is not necessa|
000010f0  72 69 6c 79 20 74 68 65  0a 73 61 6d 65 20 73 70  |rily the.same sp|
00001100  65 65 64 20 61 74 20 77  68 69 63 68 20 74 68 65  |eed at which the|
00001110  20 6d 6f 64 65 6d 20 74  72 61 6e 73 6d 69 74 73  | modem transmits|
00001120  20 61 6e 64 20 72 65 63  65 69 76 65 73 20 6f 76  | and receives ov|
00001130  65 72 20 74 68 65 20 74  65 6c 65 70 68 6f 6e 65  |er the telephone|
00001140  20 6c 69 6e 65 2e 0a 52  54 53 20 69 73 20 74 68  | line..RTS is th|
00001150  65 20 73 69 67 6e 61 6c  20 77 69 74 68 20 77 68  |e signal with wh|
00001160  69 63 68 20 74 68 65 20  63 6f 6d 70 75 74 65 72  |ich the computer|
00001170  20 69 6e 64 69 63 61 74  65 73 20 74 6f 20 74 68  | indicates to th|
00001180  65 20 6d 6f 64 65 6d 20  77 68 65 74 68 65 72 20  |e modem whether |
00001190  69 74 0a 68 61 73 20 72  6f 6f 6d 20 69 6e 20 69  |it.has room in i|
000011a0  74 73 20 62 75 66 66 65  72 20 74 6f 20 72 65 63  |ts buffer to rec|
000011b0  65 69 76 65 20 6d 6f 72  65 20 63 68 61 72 61 63  |eive more charac|
000011c0  74 65 72 73 2e 20 4e 6f  72 6d 61 6c 6c 79 20 69  |ters. Normally i|
000011d0  74 20 69 73 20 75 6e 64  65 72 20 74 68 65 0a 63  |t is under the.c|
000011e0  6f 6e 74 72 6f 6c 20 6f  66 20 74 68 65 20 66 6c  |ontrol of the fl|
000011f0  6f 77 20 63 6f 6e 74 72  6f 6c 20 62 75 73 69 6e  |ow control busin|
00001200  65 73 73 2c 20 62 75 74  20 69 66 20 79 6f 75 20  |ess, but if you |
00001210  61 72 65 20 6f 6e 6c 79  20 75 73 69 6e 67 20 73  |are only using s|
00001220  6f 66 74 77 61 72 65 0a  66 6c 6f 77 20 63 6f 6e  |oftware.flow con|
00001230  74 72 6f 6c 20 79 6f 75  20 6d 61 79 20 6e 65 65  |trol you may nee|
00001240  64 20 74 6f 20 66 6f 72  63 65 20 52 54 53 20 6f  |d to force RTS o|
00001250  6e 20 74 6f 20 67 65 74  20 74 68 65 20 6d 6f 64  |n to get the mod|
00001260  65 6d 20 74 6f 20 63 6f  6f 70 65 72 61 74 65 2e  |em to cooperate.|
00001270  0a 43 54 53 20 69 73 20  74 68 65 20 6f 70 70 6f  |.CTS is the oppo|
00001280  73 69 74 65 3b 20 74 68  65 20 6d 6f 64 65 6d 20  |site; the modem |
00001290  75 73 65 73 20 43 54 53  20 74 6f 20 74 65 6c 6c  |uses CTS to tell|
000012a0  20 74 68 65 20 63 6f 6d  70 75 74 65 72 20 69 74  | the computer it|
000012b0  20 63 61 6e 20 73 65 6e  64 2e 0a 54 68 65 20 41  | can send..The A|
000012c0  72 63 20 63 61 6e 20 72  65 73 70 65 63 74 20 6f  |rc can respect o|
000012d0  72 20 69 67 6e 6f 72 65  20 74 68 69 73 20 73 69  |r ignore this si|
000012e0  67 6e 61 6c 2e 0a 0a 53  75 67 67 65 73 74 65 64  |gnal...Suggested|
000012f0  20 73 65 74 74 69 6e 67  73 20 74 6f 20 67 65 74  | settings to get|
00001300  20 67 6f 69 6e 67 0a 3d  3d 3d 3d 3d 3d 3d 3d 3d  | going.=========|
00001310  3d 3d 3d 3d 3d 3d 3d 3d  3d 3d 3d 3d 3d 3d 3d 3d  |================|
00001320  3d 3d 3d 3d 3d 3d 0a 0a  49 66 20 79 6f 75 20 63  |======..If you c|
00001330  61 6e 27 74 20 73 65 65  6d 20 74 6f 20 70 65 72  |an't seem to per|
00001340  73 75 61 64 65 20 79 6f  75 72 20 41 72 63 20 74  |suade your Arc t|
00001350  6f 20 74 61 6c 6b 20 74  6f 20 79 6f 75 72 20 6d  |o talk to your m|
00001360  6f 64 65 6d 20 6f 72 20  76 69 63 65 20 76 65 72  |odem or vice ver|
00001370  73 61 2c 0a 74 72 79 3a  0a 20 20 20 20 53 70 65  |sa,.try:.    Spe|
00001380  65 64 3a 20 61 73 20 61  70 70 72 6f 70 72 69 61  |ed: as appropria|
00001390  74 65 0a 20 20 20 20 44  61 74 61 20 46 6f 72 6d  |te.    Data Form|
000013a0  61 74 3a 20 38 4e 31 0a  20 20 20 20 27 44 54 52  |at: 8N1.    'DTR|
000013b0  20 53 74 61 74 65 27 20  4f 6e 0a 20 20 20 20 27  | State' On.    '|
000013c0  55 73 65 20 44 43 44 27  20 4f 66 66 0a 20 20 20  |Use DCD' Off.   |
000013d0  20 27 55 73 65 20 44 53  52 27 20 4f 66 66 0a 20  | 'Use DSR' Off. |
000013e0  20 20 20 27 55 73 65 20  43 54 53 27 20 4f 66 66  |   'Use CTS' Off|
000013f0  0a 0a 4f 6e 63 65 20 74  68 61 74 20 77 6f 72 6b  |..Once that work|
00001400  73 2c 20 74 68 65 20 66  6f 6c 6c 6f 77 69 6e 67  |s, the following|
00001410  20 73 68 6f 75 6c 64 20  70 72 6f 76 65 20 73 65  | should prove se|
00001420  72 76 69 63 65 61 62 6c  65 20 66 6f 72 20 6d 6f  |rviceable for mo|
00001430  73 74 20 70 75 72 70 6f  73 65 73 3a 0a 20 20 20  |st purposes:.   |
00001440  20 27 55 73 65 20 44 43  44 27 20 4f 66 66 0a 20  | 'Use DCD' Off. |
00001450  20 20 20 27 55 73 65 20  44 53 52 27 20 4f 6e 0a  |   'Use DSR' On.|
00001460  20 20 20 20 48 2f 57 20  46 6c 6f 77 20 43 6f 6e  |    H/W Flow Con|
00001470  74 72 6f 6c 20 45 6e 61  62 6c 65 64 0a 20 20 20  |trol Enabled.   |
00001480  20 27 46 6f 72 63 65 20  52 54 53 20 4f 6e 27 20  | 'Force RTS On' |
00001490  4f 66 66 0a 20 20 20 20  27 55 73 65 20 43 54 53  |Off.    'Use CTS|
000014a0  27 20 4f 6e 0a 20 20 20  20 53 6f 66 74 77 61 72  |' On.    Softwar|
000014b0  65 20 46 6c 6f 77 20 43  6f 6e 74 72 6f 6c 20 45  |e Flow Control E|
000014c0  6e 61 62 6c 65 64 20 28  64 69 73 61 62 6c 65 20  |nabled (disable |
000014d0  64 75 72 69 6e 67 20 66  69 6c 65 20 74 72 61 6e  |during file tran|
000014e0  73 66 65 72 73 20 61 6e  64 20 77 68 65 6e 0a 20  |sfers and when. |
000014f0  20 20 20 20 20 20 20 75  73 69 6e 67 20 53 4c 49  |       using SLI|
00001500  50 21 29 0a 20 20 20 20  0a 46 75 74 75 72 65 73  |P!).    .Futures|
00001510  0a 3d 3d 3d 3d 3d 3d 3d  0a 0a 2a 20 20 20 61 64  |.=======..*   ad|
00001520  64 20 62 65 74 74 65 72  20 63 6f 6e 66 69 67 75  |d better configu|
00001530  72 61 74 69 6f 6e 20 66  61 63 69 6c 69 74 69 65  |ration facilitie|
00001540  73 20 66 6f 72 20 74 68  65 20 44 61 74 61 20 46  |s for the Data F|
00001550  6f 72 6d 61 74 2e 0a 2a  20 20 20 61 64 64 20 66  |ormat..*   add f|
00001560  61 63 69 6c 69 74 79 20  74 6f 20 73 61 76 65 20  |acility to save |
00001570  61 6e 64 20 72 65 73 74  6f 72 65 20 73 65 74 74  |and restore sett|
00001580  69 6e 67 73 2c 20 61 6e  64 20 74 6f 20 72 65 73  |ings, and to res|
00001590  65 74 20 74 68 65 6d 20  74 6f 0a 20 20 20 20 64  |et them to.    d|
000015a0  65 66 61 75 6c 74 73 0a  0a 43 6f 6e 74 61 63 74  |efaults..Contact|
000015b0  69 6e 67 20 6d 65 0a 3d  3d 3d 3d 3d 3d 3d 3d 3d  |ing me.=========|
000015c0  3d 3d 3d 3d 0a 0a 49 66  20 79 6f 75 20 68 61 76  |====..If you hav|
000015d0  65 20 61 6e 79 20 63 6f  6d 6d 65 6e 74 73 20 74  |e any comments t|
000015e0  6f 20 6d 61 6b 65 20 61  62 6f 75 74 20 74 68 69  |o make about thi|
000015f0  73 20 70 72 6f 67 72 61  6d 20 6f 72 20 74 68 69  |s program or thi|
00001600  73 20 74 65 78 74 2c 20  49 20 63 61 6e 20 62 65  |s text, I can be|
00001610  0a 63 6f 6e 74 61 63 74  65 64 20 76 69 61 20 65  |.contacted via e|
00001620  2d 6d 61 69 6c 3a 20 63  6f 6c 69 6e 40 69 6e 74  |-mail: colin@int|
00001630  65 67 72 69 74 79 2e 6e  6c 2e 0a 41 6c 74 65 72  |egrity.nl..Alter|
00001640  6e 61 74 69 76 65 6c 79  3a 0a 20 20 20 20 43 6f  |natively:.    Co|
00001650  6c 69 6e 20 53 6d 61 6c  65 0a 20 20 20 20 53 70  |lin Smale.    Sp|
00001660  65 63 68 74 65 6e 6b 61  6d 70 20 38 37 0a 20 20  |echtenkamp 87.  |
00001670  20 20 33 36 30 37 20 4b  45 20 20 20 4d 41 41 52  |  3607 KE   MAAR|
00001680  53 53 45 4e 0a 20 20 20  20 4e 65 74 68 65 72 6c  |SSEN.    Netherl|
00001690  61 6e 64 73 0a 20 20 20  20 54 65 6c 3a 20 2b 33  |ands.    Tel: +3|
000016a0  31 2d 33 34 36 35 2d 36  39 30 33 38 0a 20 20 20  |1-3465-69038.   |
000016b0  20 46 61 78 3a 20 73 61  6d 65 20 6e 75 6d 62 65  | Fax: same numbe|
000016c0  72 2c 20 70 68 6f 6e 65  20 66 69 72 73 74 21 0a  |r, phone first!.|
000016d0  0a 4c 65 67 61 6c 65 7a  65 0a 3d 3d 3d 3d 3d 3d  |.Legaleze.======|
000016e0  3d 3d 0a 0a 49 20 68 65  72 65 62 79 20 70 6c 61  |==..I hereby pla|
000016f0  63 65 20 74 68 69 73 20  70 72 6f 67 72 61 6d 20  |ce this program |
00001700  69 6e 20 74 68 65 20 70  75 62 6c 69 63 20 64 6f  |in the public do|
00001710  6d 61 69 6e 2e 20 44 6f  20 77 68 61 74 20 79 6f  |main. Do what yo|
00001720  75 20 77 61 6e 74 0a 77  69 74 68 20 69 74 2c 20  |u want.with it, |
00001730  65 78 63 65 70 74 20 73  65 6c 6c 20 69 74 2e 20  |except sell it. |
00001740  53 6f 75 72 63 65 20 63  6f 64 65 20 6f 6e 20 72  |Source code on r|
00001750  65 71 75 65 73 74 20 77  69 74 68 20 61 20 72 65  |equest with a re|
00001760  61 73 6f 6e 61 62 6c 65  0a 72 65 61 73 6f 6e 20  |asonable.reason |
00001770  66 6f 72 20 77 61 6e 74  69 6e 67 20 69 74 2e 20  |for wanting it. |
00001780  57 72 69 74 74 65 6e 20  69 6e 20 43 20 28 56 33  |Written in C (V3|
00001790  21 29 20 75 73 69 6e 67  20 72 69 73 63 5f 6f 73  |!) using risc_os|
000017a0  6c 69 62 2e 20 4e 6f 20  67 75 61 72 61 6e 74 65  |lib. No guarante|
000017b0  65 73 0a 77 68 61 74 73  6f 65 76 65 72 2e 0a     |es.whatsoever..|
000017bf