home *** CD-ROM | disk | FTP | other *** search
/ World of Ham Radio 1994 January / AMSOFT_1994.iso / misc / fftdsp / prog / fftdsp.doc < prev    next >
Encoding:
Text File  |  1993-12-31  |  8.5 KB  |  239 lines
  1.                              FFTDSP Documentation
  2.  
  3.                            Version 3 - March 2, 1993
  4.  
  5.  
  6. PROGRAM DESCRIPTION
  7.  
  8.      FFTDSP is a Digital Signal Processing (DSP) program which can detect
  9. very weak signals from a Radio Receiver using realtime Fast Fourier Transforms
  10. (FFT).  Amplitude levels for each FFT frequency are converted to color and
  11. displayed as a continuous spectrograph.  The resulting screen simultaneously
  12. shows the output of 640, 2 Hz wide filters between approximately 300 and 1500
  13. hertz.  Each horizontal line represents the output of all 640 filters during a
  14. 0.5 second period.  Over time, as each line is added to the screen, the eye
  15. can begin to see weak signals emerge from the darker background.  These weak
  16. signals may not be audible during a short listening period.
  17.  
  18.      Primary Features of the FFTDSP program are:
  19.  
  20.        - Realtime 4096 Point FFT for 2Hz Filtering
  21.        - Signal Amplitude Conversion to color for continuous spectrograph
  22.        - Numerical Frequency display of Max Amplitude Signal (2 Hz resolution)
  23.        - Input Audio Signal Strength Meter for setting level from receiver
  24.        - Color Level adjustment for color conversion range
  25.        - Spectrograph screen Save and Display in standard GIF format
  26.        - Mouse point and click for Frequency Measurement and Offset
  27.  
  28.  
  29. SYSTEM REQUIREMENTS
  30.  
  31.      - 386, 20 Mhz with Coprocessor (Minimum System)
  32.        (486 recommended for full performance and future upgrades)
  33.      - Sound Card: ProSpectrum-16, ThunderCard, SoundBlaster or
  34.                    SoundBlaster-Pro
  35.      - Audio line from radio to sound card record (or line) input
  36.  
  37.  
  38. DISTRIBUTION & PRICE
  39.  
  40.      - A fully functional, but time limited FFTDSP program is being
  41.        distributed via the public BBSs.  Without the registration file,
  42.        operation will stop after 30 seconds.
  43.  
  44.      - Registration Price: $20 US, $25 Foreign (includes shipping & handling)
  45.        The registration file will allow the public FFTDSP demo program to
  46.        operate continuously.
  47.  
  48.      - Available from:    Mike Cook, AF9Y
  49.                           501 E. Cedar Canyon Rd.
  50.                           Huntertown, IN  46748
  51.                           Tel: (219-637-3399)
  52.  
  53.        BBSs used by author for program updates and mail:
  54.  
  55.             Midnight Escape (2400-14400 Baud)      (219) 456-4127
  56.             East Coast Atlantic BBS (2400 Baud)    (704) 284-4854
  57.             Apogee BBS (9600 Baud)                 (508) 368-4137 & 7036
  58.  
  59.  
  60.  
  61. ******************************* NOTE **************************************
  62.  
  63.    If the program halts unexpectedly with an message such as "RUNTIME ERROR at
  64. XXXX", it is strongly recommended that the computer be forced thru RESET.
  65. This program uses DMA and depends upon the program normal exit to turn off
  66. DMA.  Improper program termination without computer RESET could cause file
  67. overwrites.
  68.  
  69. ***************************************************************************
  70.  
  71.  
  72. MAIN SCREEN
  73.  
  74.    o Level Meter:  Rectangular box located in the upper left area of the
  75.                    screen to show audio input level to the Sound card.
  76.  
  77.         - Green/Red bar shows signal level for both positive and negative
  78.           peaks on a logarithmic scale.
  79.  
  80.         - Recommended level is mostly Green with occasional Red peaks.
  81.  
  82.         - Numeric display below the box shows peak signal level (0-255)
  83.  
  84.  
  85.    o Max Freq: Upper Right area which displays the highest average amplitude
  86.                Frequency during each 0.5 second sample period.
  87.  
  88.         - Operates like a frequency counter with 2 Hz resolution
  89.  
  90.  
  91.    o Mouse Operation: Used to point to area on the screen and show the
  92.                       frequency and relative offset.
  93.  
  94.         - Point and Click left mouse button to show frequency
  95.  
  96.         - Point and Click right mouse button to show offset from last
  97.           frequency (last click from left button)
  98.  
  99.  
  100.    o CPU Time: Upper Right area that displays the measured CPU % time required
  101.                to process the 0.5 second sample period.
  102.  
  103.         - Less than 100% is desired.  This indicates that the computer is
  104.           keeping up with the real time data coming into the Sound Card.
  105.           Any 486 computer with coprocessor will typically be below 100%.
  106.  
  107.         - Greater than 100% will result in some loss of detection for
  108.           weak signals.  Every other 0.5 second sample will be used in
  109.           this case.  Time will also be compressed so that it will take
  110.           aprox 5 mins to fill the screen instead of the normal 2.5 minutes.
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.    o Color Level: Shows current Color Level scaling factor (0 to >5000)
  122.  
  123.         - Typical setting should be approximately 150 (default) if the Input
  124.           Audio level is set for mostly green with occasional red peaks.
  125.  
  126.         - Use the + or - keys to change this value up or down.  The change
  127.           in level may appear slow because of the 0.5 second updates periods.
  128.           Holding down the + or - key too long will cause beeping due to
  129.           keyboard buffer overflow.
  130.  
  131.         - Recommended setting is a dark blue background for optimum weak
  132.           signal detection.  See examples of demo spectrograph GIF pictures.
  133.  
  134.         - Brighter colors (ie light Green, Red, Yellow) require a larger
  135.           signal level change for transition to the next color.  The total
  136.           range for the 16 possible colors is greater than 30 db.
  137.  
  138.  
  139.  
  140.    o [F7] Save Image
  141.  
  142.         - This key will store the full screen as a GIF file that can
  143.           be viewed later using standard GIF view programs.  A program for
  144.           viewing previously stored spectrographs is available under
  145.           the [F1] utilities.
  146.  
  147.         - After the image is stored and the operation continues, a
  148.           horizontal white line is drawn across the screen as a marker
  149.           showing where the screen save occurred.
  150.  
  151.  
  152.    o [C] Clear Screen
  153.  
  154.         - This key will clear the screen and restart the spectrograph
  155.           at the top.
  156.  
  157.  
  158.    o [Alt-X] Exit
  159.  
  160.         - Terminates the program and returns to DOS
  161.  
  162.  
  163.    o Frequency Scale
  164.  
  165.         - Horizontal scale across the screen showing Frequency in Khz.
  166.  
  167.  
  168.    o Time Markers
  169.  
  170.         - 1 Minute GMT Time marks are printed along the left side of the
  171.           spectrograph.
  172.  
  173.         - Normally 3 Time marks will be shown since a full screen represents
  174.           a little more than 2 minutes.  On slower computers, more time marks
  175.           may be seen due to a compressed time scale. (See CPU Time)
  176.  
  177.  
  178.  
  179.  
  180.  
  181. [F1] UTILITIES
  182.  
  183.      Selecting the F1 Utilities from the Main screen will change to a
  184. secondary screen which displays additional program utilities.  While
  185. in the secondary screen, the FFT processing will be suspended.  Returning
  186. to the Main screen will continue the FFT processing with a horizontal white
  187. line showing where the interruption occurred.
  188.  
  189.  
  190.    o [F8] View Stored Picture (GIF) File
  191.  
  192.         - This key will shell to a simple GIF viewer program called
  193.           GIFVU.  Names of previously stored GIF files will be shown
  194.           and can be selected for display.  Also see Note 1.
  195.  
  196.  
  197.    o [F9] VU Meter (toggle)
  198.  
  199.         - This key toggles the Signal Level Meter on and off.  It may
  200.           be desirable to cut off the Meter if the CPU Time is just
  201.           above 100% to improve the processing speed. (See CPU Time)
  202.  
  203.  
  204.    o [F4] Convert Local Time to GMT
  205.  
  206.        - This function is useful if your computer is set for local time
  207.          instead of GMT.  A delta in hours is requested and will be added
  208.          to the computer local time so that the Time Marks will be in GMT.
  209.  
  210.  
  211.    o [F10] Save Sound for Selected Picture Area (N/A)
  212.  
  213.        - A future option which will save the sound of a marked area in the
  214.          spectrograph as a standard VOC file.
  215.  
  216.  
  217.    o [F6] Change Color Ranges (N/A)
  218.  
  219.        - A future option which will save FFT information and allow
  220.          modification of color threshold points.
  221.  
  222.  
  223.    o [F3] HiRes (640 x 400)
  224.  
  225.        - This key will toggle the Main Screen between HiRes (640 x 400)
  226.          and MediumRes (640 x 350).  The disadvantage of HiRes is that
  227.          the screen will not scroll when reaching the bottom.
  228.  
  229.  
  230.    o [ESC] Return to Main Screen
  231.  
  232.        - Upon return to the Main Screen, a horizontal white line will mark
  233.          the point where spectrograph operation was suspended.
  234.  
  235.  
  236.  
  237.   NOTE 1: The GIFVU program provided can be run outside of the FFTDSP
  238.           program.  It can be used for viewing recorded spectrograph
  239.           GIF files.