home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload / ShartewareOverload.cdr / comm / comset.zip / COMSET.DOC next >
Text File  |  1989-05-07  |  13KB  |  325 lines
  1.  
  2.  
  3.  
  4.                   ___________________________________________    
  5.     
  6.                                   C O M S E T
  7.     
  8.                            Modem / Uart Setup Program
  9.     
  10.                         Version 5.2..release date 5/7/89
  11.     
  12.                        from Hank Volpe Computers (c) 1989
  13.     
  14.                   ___________________________________________
  15.     
  16.     
  17.                                   Introduction
  18.     
  19.     Comset is a utility that is designed to setup a communications port 
  20.     and a AT (Hayes) Compatible smartmodem. Many modems, especially 
  21.     internals, do not have a method to reset the modem when it is 
  22.     activated, nor does an adequate method exist to setup the serial port
  23.     for use. 
  24.     
  25.     Comset will setup your serial port to any speed from 300 to 19200 bps 
  26.     and then check to see if your modem is on-line. If it isn't, Comset 
  27.     will perform a hardware reset to "wake" it up. Next a software reset 
  28.     is performed by sending the command ATZ. If the reply OK is received, 
  29.     you are informed that the modem is fine. If OK is not received, Comset 
  30.     will attempt 3 times to reset the modem before informing you of an 
  31.     error. If you have an external modem and it is off, Comset will abort 
  32.     after setting up the serial port to the desired baud rate.
  33.     
  34.     
  35.              Some of the features of Comset include the following ;
  36.                       Level 1 options...Shareware Version
  37.     
  38.            ** User Selected baud rates from 300 to 19200 bps.
  39.            ** User Selected Comm port assignments.
  40.            ** Modem Status register testing.
  41.            ** Redirectable output..can be sent to a file for logging.
  42.               or used over any serial link.
  43.            ** RTS/CTS DTR/DSR Handshake testing.
  44.  
  45.  
  46.              Registered Users Have the following advanced features;
  47.  
  48.           ** User Selection of Comm ports 1 2 3 4.
  49.           ** Log in of Comm ports 3 & 4 to DOS for use by other programs
  50.              such as high level languages or applications.
  51.           ** Batch file parameter passing and error reporting.
  52. è
  53.  
  54.                                       1
  55. Comset....Smart modem utility version 5.2
  56.  
  57.  
  58.     
  59.     
  60.     
  61.                                 I. USING COMSET
  62.                                 ----------------
  63.     
  64.                     The usage syntax for Comset is simple. 
  65.     
  66.                              COMSET [speed] [port]
  67.                                        or
  68.                                     COMSET h
  69.     
  70.                       [speed] and [port] are user options
  71.                       h invokes runtime help for the user
  72.     
  73.     Comset is easy to use. Typing COMSET from the dos prompt will 
  74.     automatically attempt to set up serial port COM1 to 2400 bps and 
  75.     attempt to wake up its modem. Selecting a different speed involves
  76.     only adding the speed after the word Comset...ie COMSET 1200 sets 
  77.     serial port COM1 to 1200 bps instead of the default 2400. Trailing 
  78.     zeros are not necessary, so you could also type COMSET 12 to set up 
  79.     serial port COM1 to 1200 bps. If you wish to use a different serial 
  80.     port, add that after the speed...ie COMSET 24 2 will set serial port 
  81.     COM2 to 2400 bps. If you accidentally enter an invalid baud rate, the 
  82.     default of 2400 bps will be used. If you accidentally enter an invalid 
  83.     range of comm ports, the default of COM1 will be used. Defaults are 
  84.     always used if the user does not supply speed and port.
  85.     
  86.     Typing COMSET h will bring up a runtime summary of features and other 
  87.     helpful information.
  88.  
  89.     Ideally, Comset should be run out of your autoexec.bat file when you 
  90.     first turn on your computer. Internal modem users can appreciate the 
  91.     fact that probably 2 or 3 times out of a 100 their internal modem does 
  92.     not "wake-up" properly when the computer is first turned on, and this 
  93.     can hang-up some communications programs. Also, BBS sysops sometimes 
  94.     experience problems with modems when stopping the BBS and trying to 
  95.     use the modem to call out.  This is why Comset was written!
  96.  
  97.     
  98.                           II. SERIAL PORT INFORMATION 
  99.                           ---------------------------
  100.     
  101.     Comset supports all the industry standard Serial Port address 
  102.     assignments for modems. The shareware version supports COM1 and COM2, 
  103.     while the registered version adds COM3 and COM4 support also. Almost 
  104.     all PC-modems allow you to use COM1-4, however only specific software 
  105.     can use COM3 or COM4 on most machines.
  106.     è
  107.  
  108.                                       2
  109. Comset....Smart modem utility version 5.2
  110.  
  111.  
  112.  
  113.     The full featured version of Comset not only will use COM3 or COM4 for
  114.     itself, but it will log those ports into DOS for use by other programs
  115.     such as high-level languages and applications (something that under
  116.     normal conditions can't be done with an IBM-PC or most clones without
  117.     special software).
  118.     
  119.     
  120.                         III ERROR REPORTING INFORMATION
  121.                         -------------------------------
  122.     
  123.             Comset checks your serial port in three distinct steps;
  124.     
  125.        1) Set the Serial Port computer UART to the desired baud rate
  126.           and raise the DTR and RTS lines. If a serial port is not
  127.           detected, Comset aborts and displays the message that there
  128.           is no serial port with that COMM designation in your system.
  129.  
  130.        2) Check that DSR and CTS are returning from the modem, if not
  131.           report an error and stop testing.
  132.     
  133.        3a)If steps 1 & 2 are successful, wake up the modem by sending
  134.           the command string "ATZ". If OK is received, report all is 
  135.           Normal and leave the RTS and DTR lines active.
  136.     
  137.         b)If the modem did not wake up, issue a more advanced hardware
  138.           and software command string to reset and wake up the modem.
  139.           Three attempts are made..if it fails, the RTS and DTR lines
  140.           are turned off. This could happen if you tell Comset to
  141.           test a serial port that does not have a compatible modem
  142.           attached. In that case, a "failure" of this kind would be
  143.           "normal" for your system.
  144.     
  145.     The Shareware version will report status to the screen. You can 
  146.     redirect the output of Comset to a file if you wish to maintain a log 
  147.     of each initialization. To do this, just use the command string
  148.     
  149.                       COMSET [speed] [port] >> comset.log
  150.  
  151.     Speed and port are optional. The >> symbol tells dos to make a file
  152.     called comset.log and append it each time Comset is run.
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160. è
  161.  
  162.                                       3
  163. Comset....Smart modem utility version 5.2
  164.  
  165.  
  166.  
  167.  
  168.                     IV FULL FEATURE USE AND ERROR REPORTING
  169.                     ---------------------------------------
  170.     
  171.     Registered Users of Comset receive some advanced features, some of 
  172.     which were described above in previous sections. An additional feature 
  173.     of the registered version is that of error-code reporting. Error code 
  174.     reporting simply stated passes "result-codes" from Comset to its 
  175.     calling program. This allows you to write some advanced batch-file 
  176.     procedures or to take specific actions.
  177.     
  178.     Running the registered copy, additional information is displayed 
  179.     informing you of the Error code received. Also that error code can be 
  180.     interpreted by Dos Batch files using the ERRORLEVEL function. Under 
  181.     Normal conditions, a result code of 0 is returned to the calling 
  182.     program. If something wrong is detected, an error code of 99 is 
  183.     returned to the calling program.
  184.     
  185.     A simple use of this can be to start a communications program if the 
  186.     modem is ok, but if not, default to some other action...an example 
  187.     batch-file program looks like this;
  188.      
  189.     echo off
  190.     comset 24 1
  191. áááááIF ERRORLEVEL 99 goto stop
  192.     echo passed
  193.     goto exit
  194. áááá:stop
  195.     echo failed!
  196.     :exit
  197.     
  198.     
  199.     
  200.     Other uses are left up to your imagination...you could flash up help 
  201.     screens to the user like "HEY DUMMY...TURN ON THE MODEM!!!" or 
  202.     something similar. Combined with redirecting the output to a logging 
  203.     file, you could trace a history of failures or other actions.
  204.  
  205.     
  206.     
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214. è
  215.  
  216.                                       4
  217. Comset....Smart modem utility version 5.2
  218.  
  219.  
  220.  
  221.  
  222.                           V. REGISTRATION INFORMATION
  223.                            --------------------------
  224.  
  225.     You can freely make copies and distribute Comset over BBS systems or 
  226.     public domain libraries as long as no fee for Comset is charged 
  227.     (except duplication costs) and as long as Comset.exe is distributed 
  228.     along with this file Comset.doc. These may be archived together for 
  229.     use on a bbs system.
  230.     
  231.     Comset is copyrighted by Hank Volpe and is not public domain software. 
  232.     Shareware version users are granted a limited license for its use. No 
  233.     warranties for Comset are stated or implied.
  234.     
  235.     
  236.     Shareware authors continually provide computer users with low priced 
  237.     software compared to the traditional retail approach. If you register
  238.     Comset, you will be able to use all the features ( COM 1-4 support, 
  239.     auto-log in of COM3 and 4 for Dos applications, advanced Error 
  240.     reporting and batch file support).
  241.     
  242.     Registration is simple...and price is low. Comset is only $10, which 
  243.     includes the latest version and free version updates. To register, 
  244.     send $10 along with your name and address to;
  245.     
  246.     
  247.                                    Hank Volpe
  248.                                108 Broadmoor Dr.
  249.                                Tonawanda NY 14150
  250.  
  251.  
  252.                                VI. ERROR MESSAGES
  253.  
  254.      THERE IS NO COMx IN YOUR SYSTEM -
  255.       Comset was instructed by the user to test a non-existent comm port.
  256.       This could happen automatically if you don't have a COM1 in
  257.       your system. If this is the case, use the line
  258.       COMSET [speed] [port] to select your specific needs.
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268. è
  269.  
  270.                                       5
  271. Comset....Smart modem utility version 5.2
  272.  
  273.  
  274.  
  275.      MODEM NOT RESPONDING PROPERLY -
  276.       The modem under test did not set up even after 3 extensive hardware
  277.       and software attempts to do so. Either you have a non-compatible
  278.       or non-intelligent modem, or you are using the wrong opening
  279.       baud rate. Comset's defaults are 2400 bps and COM1. If you only
  280.       have a 1200 or 300 bps modem, use the line
  281.       COMSET [speed] [port] and use a lower speed. Valid speeds are
  282.       300 bps,  1200 bps , 2400 bps [default], 4800 bps, 9600 bps
  283.       and 19200 bps. Any other values default automatically to 2400 bps.
  284.     
  285.     
  286.      MODEM APPEARS TO BE OFF OR DISCONNECTED -
  287.      The hardware handshaking pairs RTS/CTS or DTR/DSR are not 
  288.      communicating properly. This should NEVER happen on internal modems
  289.      unless the CTS signal is not enabled. Internal Modems usually keep 
  290.      this signal at a logic 1, so if you see this error, check your
  291.      internal modem for proper strapping of the CTS and DSR signals.
  292.     
  293.      If you have an external modem,and the power for the modem is on, you 
  294.      will see this error message if you do not have the CTS signal at a
  295.      logic 1 or you have a defective or inadequate Serial Cable. Most
  296.      external modems have Dip-switches on the back for setting the CTS 
  297.      signal. Normally the CTS follows the Serial Ports RTS and the modem
  298.      DSR (sometimes called MR) follows the Serial Ports DTR.
  299.     
  300.      In the case of an external modem you will see this error message
  301.      everytime the modem has not been turned on. This is telling you
  302.      that your serial port hardware is fine, just that your modem is
  303.      off.
  304.                            VII COMSET PROGRAM HISTORY
  305.                            --------------------------
  306.     
  307.     Version 1 - Simple Assy program fixed at 300 bps. Two versions
  308.                 COM1 and COM2.
  309.     
  310.     Version 2 - Baud rate raised to 1200 bps.
  311.     
  312.     Version 3 - Baud rate raised to 2400 bps.
  313.     
  314.     Version 4 - COM1 / COM2 support in one program.
  315.     
  316.     Version 5 - Major rewrite, added interrupt support, hardware
  317.                 and software testing, COM 1-4 support, Multiple
  318.                 baud rate support, error checking and reporting,
  319.                 and support for high speed modems to 19200 bps.
  320.     
  321.            Current released version is 5.2...released May 7, 1989
  322.      è
  323.  
  324.                                 6
  325.