Merged jcorgan/pager developer 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 (9/28/06):
5
6 FLEX receiving is nearing completion.
7
8 pager.slicer_fb()         Accepts a complex baseband downconverted channel 
9                           and outputs 4-level FSK symbols [0-3] as bytes.
10                           This may migrate into gnuradio-core at some point.
11
12 pager.flex_sync()         Accepts 4FSK symbol stream at channel rate and
13                           outputs four phases of FLEX data bits as bytes.
14                           Auto-shifts to 3200 bps as determined by received
15                           FLEX synchronization word.
16                         
17 pager.flex_deinterleave() Accepts a single phase of FLEX data bits and performs
18                           deinterleaving on 256-bit blocks.  Resulting code
19                           words are error corrected using BCH 32,21 ecc (stub)
20                           and converted into FLEX data words for output.
21
22 pager.flex_parse()        Sink block that accepts a single phase of FLEX data 
23                           words and unpacks and parses individual pages.
24                           Currently, this block decodes the capcodes of each
25                           receive page and displays the page type, but not yet
26                           the contents.
27
28 pager.flex_decode()       Combines the above blocks correctly to convert
29                           from downconverted baseband to pager messages
30
31 usrp_flex.py              Instantiates USRP receive chain to receive FLEX
32                           protocol pages.  See command-line help for options.
33                           Right now this installs into $PREFIX/bin but will
34                           probably make it into gnuradio-examples.
35
36 Johnathan Corgan
37 jcorgan@aeinet.com