Added gr-pager component to trunk by merging from r3474:r3537 in
[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/13/06):
5
6 FLEX receiving is in mid-stream of implemention.
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_deframer()   Accepts a symbol stream from slicer_fb() and
13                         outputs received 32-bit FLEX codewords for each
14                         defined phase.  Auto adjusts for 1600 or 3200 bps, 
15                         and 2 or 4 level FSK encoding based on received
16                         synchronization word.  The sync portion of this
17                         block may factor out into its own block for
18                         purposes of clarity and code complexity.
19
20 pager.bch3221_ecd()     (not yet implemented) Accepts a stream of 32-bit
21                         FLEX codewords and applies BCH (32,21) error
22                         detection/correction (up to 2 bits), the emits
23                         corrected stream. This may be absorbed into the
24                         deframer at some point.
25
26 pager.message_decode()  (not yet implemented) Accepts a stream of 32-bit
27                         FLEX codewords and separates individual paging
28                         messages into output stream as bytes.
29
30 pager.flex_decode()     Combines the above blocks correctly to convert
31                         from downconverted baseband to pager messages
32
33 usrp_flex.py            Instantiates USRP receive chain to receive FLEX
34                         protocol pages.  See command-line help for options.
35                         This will probably make it into gnuradio-examples.
36
37 Johnathan Corgan
38 jcorgan@aeinet.com