home *** CD-ROM | disk | FTP | other *** search
/ World of A1200 / World_Of_A1200.iso / datafiles / hardware / scope / amigascope.hlp < prev    next >
Text File  |  1995-02-27  |  7KB  |  197 lines
  1. ------------------------------------------------------------------------
  2. AmigaScope  HELP  file     (C) 1990, Stephen L. Childress, (818)706-5247
  3.                                      PLINK: ops274
  4. ------------------------------------------------------------------------
  5.  
  6. WHAT IS AMIGASCOPE?
  7.  
  8.   A program which makes your Amiga function like an eight channel digital
  9.   data analyzer or oscilloscope. The eight channels of data are 5V logic
  10.   signals connected to the Amiga's parallel port. When using AmigaScope,
  11.   the Amiga's parallel port is used as an INPUT port.
  12.   AmigaScope is digital; it will not accept analog signals.
  13.  
  14.   An interlaced display is used. AmigaScope should run on any Amiga,
  15.   however to date I've only tested it on an A1000 with 1.5MB of RAM.
  16.  
  17.   AmigaScope also writes and reads data files containing your acquired
  18.   data. To print a 'scope display, you may write your data to a disk
  19.   file, connect the parallel port to a printer, recall the disk data,
  20.   and click on PRINT.
  21.  
  22.   I retain all commercial and educational rights to AmigaScope.
  23.   I grant a usary license only to not-for-profit users.
  24.   AmigaScope is written in C for Lattice 5.x.
  25.   AmigaScope was developed with Amiga OS 1.3.
  26.   It might run on 2.0.
  27.  
  28.  
  29. FOR A QUICK DEMO...
  30.  
  31.   Run AmigaScope. A 640 x 480 screen/window will appear.
  32.   Click on the "60HZ CALIB" button.
  33.   Click on the "SINGLE SWEEP" button.
  34.   Click/Drag the two sliders which control the scope display.
  35.   Click somewhere on the waveforms to change the display start point.
  36.   Change the sample interval and duration as desired.
  37.   Leave TRIGGER MASK at 0 until you read the DATA TRIGGER instructions.
  38.  
  39.  
  40. GENERAL RULES OF USE...
  41.  
  42.   When you key in numeric data, YOU MUST PRESS THE RETURN KEY.
  43.  
  44.   Slide the MAGNIFICATION slider to the left of center to fit more
  45.   data onto the screen. Slide to the right of center to see sample detail.
  46.  
  47.   At low magnification (slider to the left) the display may be wrong
  48.   because of data compression/subsampling for display purposes.
  49.  
  50.   If you click to change the display start point or magnification,
  51.   the program redisplays immediately without reacquiring data.
  52.  
  53.   The arrows left of the display start slider give you very fine control.
  54.  
  55.   Click within the waveform display to change the start point.
  56.  
  57.   The display start point slider ranges 0-500 as displayed to the right.
  58.   The magnification slider ranges 0-100.
  59.  
  60.  
  61. WHAT LOGIC SPEEDS CAN AMIGASCOPE HANDLE?
  62.  
  63.   The limiting factor is the speed of the Amiga's CPU. An A1000 can
  64.   sample approx. every 5 microseconds. The other machines may be
  65.   extrapolated from this. I've not tested this program on other
  66.   machines. Please let me know if you do!
  67.  
  68.   Fast sampling rates and long durations take lots of memory. AmigaScope
  69.   allocates and releases memory for every acquisition cycle, based upon
  70.   your sample interval and duration settings.
  71.  
  72.   Beware that the program's estimate of the absolute sampling interval time
  73.   is a very rough estimate. Using the 60HZ CALIB. button, you can change
  74.   the sample rates, etc., and look at the effect given a known square wave.
  75.   The square wave is obtained from the 8520 chip's timer.
  76.  
  77.   At sample rates of less than 10 miliseconds, the rate is contolled by a
  78.   software delay loop. While this is running, Amiga interrupts are disabled
  79.   to ensure a more accurate sample interval. Because of this, AmigaScope
  80.   should not be used when this would interfere with multitasked programs.
  81.  
  82.   At sample rates of 10 miliseconds and slower, sampling is controlled by
  83.   the timer device in the Amiga. In this case, interrupts are not
  84.   disabled.
  85.  
  86.   AmigaScope computes the proper CPU delay loop count by performing
  87.   a calibration when you do the first acquisition. The 8520 chip timer
  88.   is assumed to be 1/60 sec and the proper loop count is estimated. This
  89.   applies to the less than 10 milisecond sampling case only.
  90.  
  91.   Unknown limitations are the speed of the 8520 chip and the
  92.   Amiga-internal capacitive load on the parallel port input pins.
  93.  
  94.  
  95. HOW TO USE AMIGASCOPE WITH REAL DIGITAL DATA...
  96.  
  97.   Into your parallel port, plug in a cable which you've made which
  98.   connects up to 8 logic signals. BEWARE! If you connect an input pin
  99.   on your port to +5 or Ground, you *WILL* break the 8520 chip inside
  100.   the Amiga. It's true! I did it!
  101.  
  102.   The connections are:
  103.     Ground is on pin 14,15, ... or 22
  104.     The inputs are pins 2,3, ... and 9
  105.  
  106.   I urge you to connect 220 ohm resistors in series with your input
  107.   lines on pins 14...22 to limit the current in case of a boo-boo.
  108.   Be VERY careful about static discharges.
  109.  
  110.  
  111. DATA TRIGGERS...
  112.  
  113.   If you need to delay the start of data acquisition/sampling until a
  114.   particular pattern occurs or a particular bit changes state, use
  115.   the data trigger capability. Set the TRIGGER MASK gadget to 00 to
  116.   disable DATA TRIGGERS.
  117.  
  118.   The TRIGGER MASK is a two digit hexadecimal number. It is and'ed with
  119.   the sampled data as explained below.
  120.  
  121.   The TRIGGER itself is a two digit hexadecimal number. It is and'ed with
  122.   the TRIGGER MASK.
  123.  
  124.   When you start data acquisition (SINGLE SWEEP or BEGIN SAMPLING), and
  125.   if TRIGGER MASK is non-zero, the following happens:
  126.  
  127.     AmigaScope does the following:
  128.  
  129.       1. Read new input data from the parallel port.
  130.       2. AND the new data with TRIGGER mask.
  131.       3. Compare the result of (2) with the value in TRIGGER.
  132.       4. Go to step #1 if the comparison is unequal.
  133.       5. Start acquisition of all data if the comparison is equal.
  134.  
  135.   Examples:
  136.  
  137.     A. Trigger when the input data is 10001010.
  138.        Set TRIGGER MASK to FF.
  139.        Set TRIGGER      to 8A.
  140.  
  141.     A. Trigger when the input data is 1xxx1010.
  142.        Set TRIGGER MASK to 9F.
  143.        Set TRIGGER      to 8A.
  144.  
  145.     C. Trigger when bit 0 becomes 0.
  146.        Set TRIGGER MASK to 01.
  147.        Set TRIGGER      to 00
  148.  
  149.     D. Trigger when bit 0 becomes 1.
  150.        Set TRIGGER MASK to 01.
  151.        Set TRIGGER      to 01
  152.  
  153.  
  154.   TO ABORT A HUNG-UP TRIGGER, merely click on STOP. This will happen if
  155.   you choose a trigger condition which is not happening.
  156.  
  157.   Warning: Interrupts are enabled while waiting for the data to match
  158.   the trigger condition. Therefore, at fast sampling rates, the time
  159.   between the first and second sample may be quite long.
  160.  
  161.  
  162. PRINTING...
  163.  
  164.   The PRINT SCREEN button does just that. The current program requires
  165.   an EPSON compatible printer connected to the parallel port. The
  166.   program uses the PAR: device. Thus, the PREFERENCES settings don't
  167.   matter.
  168.  
  169.   BEWARE! If you click on PRINT SCREEN with your digital inputs
  170.   connected, your signals and the 8520 in output mode will "buck"
  171.   the data lines. This might damage something, though I've not found.
  172.   that to be true. Doing so *will* drive your circuit's signals
  173.   to the wrong state because of the wire-or.
  174.  
  175.   Every time you acquire data, the 8520 chip is reprogrammed for input
  176.   mode. So if you accidentally PRINT SCREEN, just reacquire data.
  177.  
  178.  
  179. FILES...
  180.  
  181.   Click on FILES. An Amiga-style file requestor appears. Choose SAVE
  182.   to write the current acquired data to a disk file. A file name
  183.   suffix of ".dat" is assumed.
  184.  
  185.   Choose LOAD to recall and display saved ".dat" files. You can LOAD
  186.   and display any file. Doing so for program files is interesting.
  187.  
  188.   To eliminate the ".dat" suffix, change the File Requestor's extension
  189.   data input box contents as desired.
  190.  
  191.   AmigaScope files are simply a byte stream. Use TYPE opt H from
  192.   the CLI to view the data.
  193.  
  194.  
  195. GOOD LUCK!
  196.  
  197. END.