Merged -r3690:3730 from jcorgan/pager branch into trunk.
[debian/gnuradio] / gr-pager / README
1 This GNU Radio component implements (will implement) common radiopager
2 signaling protocols such as POCSAG and FLEX.
3
4 Current status (10/6/06):
5
6 FLEX receiving is completed except for addition of BCH error correction.
7
8 pager.slicer_fb()         Accepts a complex baseband downconverted channel 
9                           and outputs 4-level FSK symbols [0-3] as bytes.
10
11 pager.flex_sync()         Accepts 4FSK symbol stream at channel rate and
12                           outputs four phases of FLEX data bits as bytes.
13                           Auto-shifts to 3200 bps as determined by received
14                           FLEX synchronization word.
15                         
16 pager.flex_deinterleave() Accepts a single phase of FLEX data bits and performs
17                           deinterleaving on 256-bit blocks.  Resulting code
18                           words are error corrected using BCH 32,21 ecc (stub)
19                           and converted into FLEX data words for output.
20
21 pager.flex_parse()        Sink block that accepts a single phase of FLEX data 
22                           words and unpacks and parses individual pages. These are 
23                           passed outside the data plane via gr_message's.
24
25 pager.flex_decode()       Combines the above blocks correctly to convert
26                           from downconverted baseband to pager messages
27
28 usrp_flex.py              Instantiates USRP receive chain to receive FLEX
29                           protocol pages.  See command-line help for options.
30                           Right now this installs into $PREFIX/bin but will
31                           probably make it into gnuradio-examples.
32
33 aypabtu.py                Decodes FLEX pages from multiple rx channels in a range.
34                           Incomplete.
35
36 Johnathan Corgan
37 jcorgan@aeinet.com