home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 3 / TheARMClub_PDCD3.iso / hensa / diagnostic / rs232stat_1 / !Rs232stat / !Help < prev    next >
Text File  |  1994-04-12  |  6KB  |  151 lines
  1.  
  2. !RS232Stat Version 1.00 - Released April 14, 1994
  3. =======================
  4.  
  5. A program to monitor the serial port status.
  6.  
  7. It proved invaluable to me when I was first getting a modem going on
  8. my Arc - maybe it will to you.
  9.  
  10.  
  11. The display is derived from various OS_SerialOp and OS_Byte calls
  12. and is updated ONLY on null events when the window is open. Any changes
  13. you make to the various parameters will update the window on the next
  14. null event. The display is never changed DIRECTLY as a result of a
  15. mouse click. Hence when you see a change in status after you have clicked
  16. on something, you can be sure it's the device driver which has acted upon
  17. it.
  18.  
  19. The 'option' icons can be used to change the current settings. Click with
  20. select to toggle the current setting.
  21.  
  22. The 'radio' buttons are read-only; they reflect the state of various signals
  23. received by the computer from the modem.
  24.  
  25.  
  26. Line Parameters
  27. ===============
  28. The RX speed and the TX speed can, in theory, be set independantly to
  29. different values. In practise however the hardware is only capable of
  30. one pair of unequal TX and RX speeds - transmit at 75 baud and receive
  31. at 1200 baud. The newer machines cannot even do that.
  32. If you change the RX speed, both the RX and TX speeds are configured
  33. using OS_SerialOp 5/6. If you change the TX speed, TX only is configured
  34. using OS_SerialOp 6. Normally a change to either will result in the
  35. driver changing both.
  36. The Data Format display is derived from OS_SerialOp 1. The menu to configure
  37. it is at present based on the much more restricted OS_Byte 156. In the future
  38. I want to expand this to include all possible options allowed by OS_SerialOp 1.
  39.  
  40. Buffers
  41. =======
  42. The Input buffer count is the number of bytes received which have not yet
  43. been read by a program.
  44. The Output buffer count is the number of bytes for which there is room for
  45. a program to write.
  46. The Threshold value indicates the minimum number of bytes in the input buffer
  47. before the driver takes action to stop the flow towards the computer (see
  48. Hardware and Software Flow Control). This value can be changed by clicking
  49. in the icon. Enter the new value and press Return. While the caret is in
  50. this icon, the field will not be updated on null events.
  51.  
  52. Control
  53. =======
  54. DTR is the signal the computer uses to tell the modem that it is powered on
  55. and ready for use. Some modems don't work if DTR is off; none that I know
  56. of will auto-answer in this state. I always ensure DTR is off when I'm not
  57. using the modem. This has the side-effect of giving the modem a good reset
  58. when DTR is dropped (see modem command AT&D3).
  59.  
  60. DCD is the signal the modem uses to indicate to the computer that there is
  61. a carrier, i.e. the data connection is established. The Arc can be told
  62. to ignore DCD (the normal situation) or to respect it and disable the
  63. serial port unless DCD is on. Modems can usually be configured to use
  64. DCD normally (AT&C1) or to force DCD on (AT&C0).
  65.  
  66. DSR is the signal the modem uses to tell the computer that it is powered on
  67. and ready for use, i.e. the reverse of DTR. The Arc can be told to ignore
  68. DSR or to respect it and disable the serial port unless DSR is on. If DSR
  69. is to be used and it is off, serial port output is still enabled but input
  70. characters are ignored. Modems can often be configured to do different
  71. things with DSR.
  72.  
  73. The RI (Ring Indicator) icon will pulse on and off when the modem recognizes
  74. that the phone is ringing. Otherwise it will be Off.
  75.  
  76. Software Flow Control aka Xon/Xoff
  77. ==================================
  78.  
  79. This is mostly used for end-to-end flow control, so the Arc can tell the
  80. host to stop or resume transmission and vice versa. Terminal connections
  81. usually work this way, but it may cause problems during file transfers.
  82. The host program will probably reconfigure its port to disable Xon/Xoff
  83. during file transfers, but most Arc programs do not!
  84. TX Unblocked means that the Arc thinks it is free to send, i.e. it has
  85. not received an Xoff (DC3) since the last Xon (DC1).
  86. RX Unblocked means that the Arc has told the other end to stop sending
  87. by transmitting an Xoff.
  88.  
  89. Hardware Flow Control
  90. =====================
  91.  
  92. This is normally used for the local connection between computer and modem.
  93. It is necessary because of the interspeeder which modern modems use, so that
  94. the speed with which the computer talks to the modem is not necessarily the
  95. same speed at which the modem transmits and receives over the telephone line.
  96. RTS is the signal with which the computer indicates to the modem whether it
  97. has room in its buffer to receive more characters. Normally it is under the
  98. control of the flow control business, but if you are only using software
  99. flow control you may need to force RTS on to get the modem to cooperate.
  100. CTS is the opposite; the modem uses CTS to tell the computer it can send.
  101. The Arc can respect or ignore this signal.
  102.  
  103. Suggested settings to get going
  104. ===============================
  105.  
  106. If you can't seem to persuade your Arc to talk to your modem or vice versa,
  107. try:
  108.     Speed: as appropriate
  109.     Data Format: 8N1
  110.     'DTR State' On
  111.     'Use DCD' Off
  112.     'Use DSR' Off
  113.     'Use CTS' Off
  114.  
  115. Once that works, the following should prove serviceable for most purposes:
  116.     'Use DCD' Off
  117.     'Use DSR' On
  118.     H/W Flow Control Enabled
  119.     'Force RTS On' Off
  120.     'Use CTS' On
  121.     Software Flow Control Enabled (disable during file transfers and when
  122.         using SLIP!)
  123.     
  124. Futures
  125. =======
  126.  
  127. *   add better configuration facilities for the Data Format.
  128. *   add facility to save and restore settings, and to reset them to
  129.     defaults
  130.  
  131. Contacting me
  132. =============
  133.  
  134. If you have any comments to make about this program or this text, I can be
  135. contacted via e-mail: colin@integrity.nl.
  136. Alternatively:
  137.     Colin Smale
  138.     Spechtenkamp 87
  139.     3607 KE   MAARSSEN
  140.     Netherlands
  141.     Tel: +31-3465-69038
  142.     Fax: same number, phone first!
  143.  
  144. Legaleze
  145. ========
  146.  
  147. I hereby place this program in the public domain. Do what you want
  148. with it, except sell it. Source code on request with a reasonable
  149. reason for wanting it. Written in C (V3!) using risc_oslib. No guarantees
  150. whatsoever.
  151.