General improvements in HRPT receiver
[debian/gnuradio] / gr-noaa / README
1 This component implements an NOAA POES HRPT receiver.  After installation,
2 the scripts described below will be install in the users PATH.
3
4 As the scripts are generated using GRC, GRC must be installed at runtime
5 in order for them to operate.
6
7
8 HRPT Operation
9 --------------
10
11 usrp_rx_hrpt.py
12
13 This GUI script will receive HRPT RF, demodulate, synchronize, and deframe
14 HRPT minor frames into a file.  The file stores a series of 11090 word,
15 16-bits per word corresponding to the HRPT minor frame format (only the
16 lower 10-bits per word are significant.)
17
18 The script file by default uses USRP side A, 1698 MHz, at decimation 16. A
19 configuration file 'usrp_rx_hrpt.cfg' in the current working directory will
20 allow changing this, as well as implementing persistent storage of GUI
21 entered parameters from invocation to invocation.
22
23 The present HRPT demodulator is only tested at decimation 16.  The only other
24 valid decimation rates are 24 and 32, which may word but with more bit
25 errors.  No other decimation rates will work.
26
27
28 demod_hrpt_file.py
29
30 This command-line only script will operate on a file generated with
31 usrp_rx_cfile.py and output frames in the same format as above.  It does
32 *not* use the configuration file above.
33
34 Usage: demod_hrpt_file.py: [options]
35
36 Options:
37   -h, --help            show this help message and exit
38   -d DECIM, --decim=DECIM
39                         Set Decimation [default=16]
40   -p PLL_ALPHA, --pll-alpha=PLL_ALPHA
41                         Set pll_alpha [default=50m]
42   -s SYNC_ALPHA, --sync-alpha=SYNC_ALPHA
43                         Set sync_alpha [default=50m]
44   -F FILENAME, --filename=FILENAME
45                         Set Filename [default=usrp.dat]
46   -o OUTPUT, --output=OUTPUT
47                         Set Output [default=frames.dat]
48
49
50 LRIT Operation
51 --------------
52
53 The work-in-progress LRIT GRC script is not currently in a usable state.