[Commit-gnuradio] r6012 - in gnuradio/branches/developers/jcorgan/radar/gr-radar-mono: . src/python

[jcorgan]

Author: jcorgan
Date: 2007-07-18 14:08:11 -0600 (Wed, 18 Jul 2007)
New Revision: 6012

Modified:
   gnuradio/branches/developers/jcorgan/radar/gr-radar-mono/README
   
gnuradio/branches/developers/jcorgan/radar/gr-radar-mono/src/python/usrp_radar_mono.py
Log:
Added documentation, fix default parameter.

Modified: gnuradio/branches/developers/jcorgan/radar/gr-radar-mono/README
===================================================================
--- gnuradio/branches/developers/jcorgan/radar/gr-radar-mono/README     
2007-07-18 19:38:53 UTC (rev 6011)
+++ gnuradio/branches/developers/jcorgan/radar/gr-radar-mono/README     
2007-07-18 20:08:11 UTC (rev 6012)
@@ -1,14 +1,64 @@
-This GNU Radio component implements (will implement) a monostatic 
-radar transmitter and receiver.  It uses (will use) a custom FPGA 
-build to generate a linear FM chip waveform directly in the USRP.
-Echo returns are (will be) recorded to a file.
+This GNU Radio component implements a monostatic radar transmitter
+and receiver.  It uses a custom FPGA build to generate a linear 
+FM chirp waveform directly in the USRP. Echo returns are (will be) 
+recorded to a file for offline analysis.
 
-Currently, only a CW signal is generated for testing the frequency
-response of the FPGA code, AD9862, and daughterboard mixer.
+The LFM chirp can be up to 32 MHz in width, whose center frequency
+is set by which transmit daughter board is installed.  This gives
+a range resolution of approximately 5 meters.
 
+Only boards in slot A are supported.
+
+The script to run is place in $prefix/bin:
+
+Usage: usrp_radar_mono.py [options]
+
+Options:
+  -h, --help            show this help message and exit
+  -f FREQ, --frequency=FREQ
+                        set transmitter center frequency to FREQ in Hz,
+                        default is 0.0
+  -w FREQ, --chirp-width=FREQ
+                        set LFM chirp bandwidth in Hz, default is 32000000.0
+  -a AMPLITUDE, --amplitude=AMPLITUDE
+                        set waveform amplitude in % full scale, default is
+                        100,
+  --ton=TON             set pulse on period in seconds, default is 5e-06,
+  --tsw=TSW             set transmitter switching period in seconds, default
+                        is 4.0625e-07,
+  --tlook=TLOOK         set receiver look time in seconds, default is 5e-06,
+  --prf=PRF             set pulse repetition frequency in Hz, default is
+                        10000.0,
+  -v, --verbose         enable verbose output, default is disabled
+  -D, --debug           enable debugging output, default is disabled
+
+The transmitter creates a LFM chirp, evenly centered on the supplied frequency.
+The four timing parameters are:
+
+ton    Chirp on time in seconds.  
+
+tsw     Transmitter switching time in seconds.  This the delay after the chirp
+        is transmitted before the receiver is enabled. These two (tsw and ton)
+        parameters determine the minimum range of the radar.
+
+tlook   The the amount of time in seconds the receiver is enabled to record
+        echo responses ("look" time). This parameter determines the maximum
+        radar range that can be measured, though transmitter power will also
+        limit return strength and practical range.
+
+prf     Pulse repetition frequency in Hz.  This establishes to overall pulse
+        repetition period, which results in idle time between when the receiver
+        is turned off and the next transmitted chirp begins.
+
+Currently, only the transmitter is written. Also, there is not yet any sanity
+checks on the supplied parameters to the script.
+
+The receiver, when completed, will record the radar returns, preserving phase,
+into a file with metadata about each chirp.
+
 This is experimental code.
 
 Johnathan Corgan
 Corgan Enterprises LLC
 address@hidden
-7/17/2007
+7/18/2007

Modified: 
gnuradio/branches/developers/jcorgan/radar/gr-radar-mono/src/python/usrp_radar_mono.py
===================================================================
--- 
gnuradio/branches/developers/jcorgan/radar/gr-radar-mono/src/python/usrp_radar_mono.py
      2007-07-18 19:38:53 UTC (rev 6011)
+++ 
gnuradio/branches/developers/jcorgan/radar/gr-radar-mono/src/python/usrp_radar_mono.py
      2007-07-18 20:08:11 UTC (rev 6012)
@@ -33,7 +33,7 @@
     parser = OptionParser(option_class=eng_option)
     parser.add_option("-f", "--frequency", type="eng_float", default=0.0,
                       help="set transmitter center frequency to FREQ in Hz, 
default is %default", metavar="FREQ")
-    parser.add_option("-w", "--chirp-width", type="eng_float", default=16e6,
+    parser.add_option("-w", "--chirp-width", type="eng_float", default=32e6,
                       help="set LFM chirp bandwidth in Hz, default is 
%default", metavar="FREQ")
     parser.add_option("-a", "--amplitude", type="eng_float", default=100,
                       help="set waveform amplitude in % full scale, default is 
%default,")