Imported Upstream version 3.0
[debian/gnuradio] / gnuradio-examples / python / apps / hf_explorer / README
1 hfx.py is meant to be a full-featured Long Wave / Medium Wave
2 and Short Wave (250kHz to 30Mhz) AM and Single Sideband receiver.
3 It uses the USRP with a Basic RX board, and will need an
4 antenna and some preamps, about 30db gain will work. See the
5 'Help' menu or hfx_help for more info.
6
7 ----------------------------------------------------------
8
9 hfx2.py is a major revision built about complex fir filter
10 coeffecients ability and cleaner python script. Inherits
11 most features from hfx.py - Powermate knob supported but
12 not required, tooltip frequency display, single click
13 tuning, AGC, record to disk, play from disk and record audio.
14 New feature is ability to tailor the audio passband with two
15 sliders over the spectrum display. The sliders almost align
16 with the actual frequency. Preset filter settings for LSB
17 (-3000 to 0kHz), USB (0 to +3000kHz), CW (-400 to -800Hz)
18 and AM (-5kHz from carrier to +5kHz).
19
20 AM now switches in a synchronous PLL detector with the
21 carriers at 7.5kHz. The PLL carrier is displayed in the
22 bottom display and helps show where on the upper spectrum
23 the demodulated signal lies. Everything gets shifted up
24 7.5kHz in AM, center frequency, tooltips, etc.  The target
25 AM carrier needs to be closely tuned in, it will have a
26 hollow sound untill it is locked, and then the PLL carrier
27 in the bottom display will jump up and remain relatively 
28 constant. There is a slider "AM sync carrier" to play with
29 different levels to mix with the signal for demodulation.
30 The filter in AM is preset to 2500/12500 (7.5kHz +/- 5kHz)
31 and is handy for removing adjacent channel interference.
32 Change AM_SYNC_DISPLAY in script for whether to show AM
33 Sync carrier or not.
34 Run with "-h" for command line help with setting USRP 
35 ddc center frequency, decimation, rf data record, playback
36 and audio data recording.
37
38 There are some controls for controlling a varactor and
39 tuning an antenna - just ignore them unless you want
40 to build a voltage tuned antenna to track frequency.
41
42 There is also code for Web based control of frequency and
43 volume - so I can tune the radio with an Ipaq from bed.
44 Disabled by default - it takes a web server, some
45 directories and scripts to use.
46
47
48