'****************************************************************************
'**************                LAWSON LABS INC.                 *************
'**************              15 Phoenixville Pike               *************
'**************               Malvern, PA  19355                *************
'**************                 610 725-8800                    *************
'**************                 800 321-5355                    *************
'**************                    LOG140                       *************
'**************            VERSION 1.1     09/6/95              *************
'****************************************************************************

'               First install the 140 A/D card in the computer. See your A/D
'        manual for complete installation instructions.

'               Back up this disk, and store the original in a safe place.
'       The original disk contains 4 files:

'               README.140      : Operating instructions for the program

'               LOG140.EXE      : Executable program

'               LOG140.BAS      : Source Code

'               LOG140.CFG      : Configuration File

'               The program will read/write a configuration file "LOG140.CFG",
'       from/to the current directory. Make sure there is not an unrelated
'       file of the same name in the current directory.
'               Use the DOS COPY command to transfer all the files on this
'       disk to the current directory. The LOG140.BAS file is for programmers,
'       and is not necessary for program execution. Note that the "LOG140.BAS"
'       file will not run under interpreted (GW) BASIC. Type "LOG140", then
'       press Enter to run the program.
'               A copyright notice is displayed when the program starts. Press
'       the space bar to continue. After the Configuration File is read, The
'       Main Menu is displayed with 3 options, 1) Gather Data, 2) Configure
'       System, & 3) Exit Program. You execute an option by pressing it's
'       associated number. If there is an error reading the "M140.CFG" file,
'       or it does not exist in the current directory, you are prompted to
'       press Esc to go to the Main Menu.
'               When first running the program you will want to configure the
'       system. Execute option 2) Configure System. The Configuration Menu is
'       displayed with 3 options, 1) Define Data Points, 2) Define Data Run,
'       & 3) Return To Main Menu.
'               Executing option 1) Define Data Points allows you to format a
'       particular A/D channel. If a configuration file was found when the
'       program started, then you are asked if you have changed the switch
'       settings on the 140 A/D card. If you press "N" for No, then the Define
'       Data Points screen is displayed. If you press "Y"  for Yes, or if no
'       configuration file was found when the program started, then you are
'       prompted for which switch on the 140 A/D card is in the ON position.
'       Respond by pressing a number between 1 & 4. The program then checks to
'       see if it can read the 140 A/D card. If it cannot, then you are
'       prompted to enter the information again. If you cannot get past this
'       point in the program, refer to the troubleshooting section at the end
'       of this file. If the program can read the 140 A/D card then the Define
'       Data Points screen is displayed.
'               The Define Data Points screen includes :

'            a header indicating which channel is currently selected

'         1) Label          A descriptive title to display with the channel
'                           reading
'         2) Units          Units label to display with the channel reading

'         3) Decimal Places Number of decimal places to display

'         4) Offset  Factor Offset to apply in calculating the channel reading

'         5) Scaling Factor Scaling factor used in calculating the channel
'                                   reading, Enter 0 to exclude this channel

'            The channel Reading  = (MV + Offset) * Scaling Factor

'     M) for main menu  N) for next one  S) for skip  D) for delete this one
      
'               When you are done with the Define Data Points screen, press
'       "M" to return to the Configuration Menu. Next execute option 2) Define
'       Data Run. The first item is the storage interval in Hours, Minutes, &
'       Seconds. The values you enter are displayed. Press "C" to Change them,
'       or press "N" for the Next item. If the total storage interval exceedes
'       24 hours, then you are prompted to re-enter the storage interval. The
'       next item is Autostore. Press "C" to toggle Autostore ON/OFF. Press
'       "N" for the Next item. The next item is Printer Logging. Press "C" to
'       toggle Printer Logging ON/OFF. Press "N" to return to the
'       Configuration Menu.
'               Now execute option 3) Return To Main Menu. Before the Main
'       Menu is displayed, you are asked if you would like to save the
'       configuration on the disk. Press "Y" to save the "LOG140.CFG" file in
'       the current directory. Pressing "N" leaves the changes you made
'       intact, but does not preserve them for later use.
'               Executing option 1) Gather data causes the program to start
'       sampling data. If the configuration data is invalid then you are
'       prompted to go to the Configuration Menu. If the program cannot read
'       the card, you are prompted for which switch on the 140 A/D card is in
'       the ON position. If Autostore is ON then you are asked to enter the
'       Data filespec. Type the full drive, path, and filename where data is
'       to be stored, then press Enter. You are asked to verify the data
'       filespec by pressing "Y" for Yes, or "N" for No. Once sampling
'       commences, the sampling screen is displayed with the selected A/D
'       channel's data. To stop sampling data, press Esc, and you are returned
'       to the Main Menu. Note that if Printer Logging is ON, and the printer
'       is offline, the program will stop with "Printing ...." displayed at
'       the bottom of the screen, if you place the printer ONLINE data
'       gathering will continue. Otherwise, eventually an error message is
'       displayed.
'               Executing option 3) Exit Program returns control to DOS. If
'       Printer Logging was ON, and the printer is OFFLINE when exiting, the
'       printer may not be reset to 80 column mode.

'****************************************************************************
'**************                TROUBLESHOOTING                  *************
'****************************************************************************

'       1)  If at anytime the program encounters an error while printing, or
'           reading/writing files to disk, then an apropriate error message is
'           displayed, and you are prompted to press Esc to return to the Main
'           Menu. Some common situations where errors occur are:
' Error #
'    24     Printer offline      :  Place printer online, & check the cable
'                                   It can take several minutes for this error
'                                   message to appear
'    25     Printer turned off   :  Make sure the printer is ON
'    27     Printer out of paper :  Replace paper, Make sure printer is online
'    57     Unformatted disk     :  Use a disk that is formatted correctly
'    61     Disk full            :  Make sure you have sufficient disk space
'                                   before gathering data
'    68     Device unavailable   :  Printer or disk is not attached, check for
'                                   loose cables
'    71     Disk not ready       :  If saving to a floppy drive, make sure the
'                                   the drive door is closed
'    76     Path not found       :  You specified a data filespec with a path
'                                   that does not exist

'       2)  If the program continually asks you to recheck the switch settings
'           on the card, make sure the switch number you enter, 1 - 4, is in
'           the ON position. Otherwise, there may be an address overlap with
'           another card installed in the computer. Refer to the manuals of
'           any non-standard cards for port address usage.

'       3)  If you cannot get an A/D channel to print or display, make sure
'           the Scaling Factor for that channel is non-zero.

'       4)  If the system is not configured properly at re-start, there may be
'           no LOG140.CFG file in the current directory.

'       5)  If a % sign precedes a formatted data reading, then the reading
'           is overflowing the 8 position display field. Decrease the number
'           of displayed decimal places, or reduce the scaling factor.

'       6)  If you encounter a problem you can not resolve, please do not
'           hesitate to contact us.

'       7)  Fast computers may cause readings to be periodically erratic.
'           You may need a larger value for DELAY. Increase the value of
'           DELAY in the source code near the top of the program.
