Statistics
| Branch: | Tag: | Revision:

root / gnuradio-core / src / lib / general / gr_correlate_access_code_bb.h @ e36dc98e

History | View | Annotate | Download (3.1 kB)

1 5d69a524 jcorgan
/* -*- c++ -*- */
2 5d69a524 jcorgan
/*
3 5d69a524 jcorgan
 * Copyright 2005,2006 Free Software Foundation, Inc.
4 5d69a524 jcorgan
 * 
5 5d69a524 jcorgan
 * This file is part of GNU Radio
6 5d69a524 jcorgan
 * 
7 5d69a524 jcorgan
 * GNU Radio is free software; you can redistribute it and/or modify
8 5d69a524 jcorgan
 * it under the terms of the GNU General Public License as published by
9 937b719d eb
 * the Free Software Foundation; either version 3, or (at your option)
10 5d69a524 jcorgan
 * any later version.
11 5d69a524 jcorgan
 * 
12 5d69a524 jcorgan
 * GNU Radio is distributed in the hope that it will be useful,
13 5d69a524 jcorgan
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 5d69a524 jcorgan
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
15 5d69a524 jcorgan
 * GNU General Public License for more details.
16 5d69a524 jcorgan
 * 
17 5d69a524 jcorgan
 * You should have received a copy of the GNU General Public License
18 5d69a524 jcorgan
 * along with GNU Radio; see the file COPYING.  If not, write to
19 86f5c924 eb
 * the Free Software Foundation, Inc., 51 Franklin Street,
20 86f5c924 eb
 * Boston, MA 02110-1301, USA.
21 5d69a524 jcorgan
 */
22 5d69a524 jcorgan
23 5d69a524 jcorgan
#ifndef INCLUDED_GR_CORRELATE_ACCESS_CODE_BB_H
24 5d69a524 jcorgan
#define INCLUDED_GR_CORRELATE_ACCESS_CODE_BB_H
25 5d69a524 jcorgan
26 5d69a524 jcorgan
#include <gr_sync_block.h>
27 5d69a524 jcorgan
#include <string>
28 5d69a524 jcorgan
29 5d69a524 jcorgan
class gr_correlate_access_code_bb;
30 5d69a524 jcorgan
typedef boost::shared_ptr<gr_correlate_access_code_bb> gr_correlate_access_code_bb_sptr;
31 5d69a524 jcorgan
32 5d69a524 jcorgan
/*!
33 5d69a524 jcorgan
 * \param access_code is represented with 1 byte per bit, e.g., "010101010111000100"
34 5d69a524 jcorgan
 * \param threshold maximum number of bits that may be wrong
35 5d69a524 jcorgan
 */
36 5d69a524 jcorgan
gr_correlate_access_code_bb_sptr 
37 5d69a524 jcorgan
gr_make_correlate_access_code_bb (const std::string &access_code, int threshold);
38 5d69a524 jcorgan
39 5d69a524 jcorgan
/*!
40 5d69a524 jcorgan
 * \brief Examine input for specified access code, one bit at a time.
41 5a4b9ba9 eb
 * \ingroup sync_blk
42 5d69a524 jcorgan
 *
43 5d69a524 jcorgan
 * input:  stream of bits, 1 bit per input byte (data in LSB)
44 5d69a524 jcorgan
 * output: stream of bits, 2 bits per output byte (data in LSB, flag in next higher bit)
45 5d69a524 jcorgan
 *
46 5d69a524 jcorgan
 * Each output byte contains two valid bits, the data bit, and the
47 5d69a524 jcorgan
 * flag bit.  The LSB (bit 0) is the data bit, and is the original
48 5d69a524 jcorgan
 * input data, delayed 64 bits.  Bit 1 is the
49 5d69a524 jcorgan
 * flag bit and is 1 if the corresponding data bit is the first data
50 5d69a524 jcorgan
 * bit following the access code. Otherwise the flag bit is 0.
51 5d69a524 jcorgan
 */
52 5d69a524 jcorgan
class gr_correlate_access_code_bb : public gr_sync_block
53 5d69a524 jcorgan
{
54 5d69a524 jcorgan
  friend gr_correlate_access_code_bb_sptr 
55 5d69a524 jcorgan
  gr_make_correlate_access_code_bb (const std::string &access_code, int threshold);
56 5d69a524 jcorgan
 private:
57 5d69a524 jcorgan
  unsigned long long d_access_code;        // access code to locate start of packet
58 5d69a524 jcorgan
                                        //   access code is left justified in the word
59 5d69a524 jcorgan
  unsigned long long d_data_reg;        // used to look for access_code
60 5d69a524 jcorgan
  unsigned long long d_flag_reg;        // keep track of decisions
61 5d69a524 jcorgan
  unsigned long long d_flag_bit;        // mask containing 1 bit which is location of new flag
62 5d69a524 jcorgan
  unsigned long long d_mask;                // masks access_code bits (top N bits are set where
63 5d69a524 jcorgan
                                        //   N is the number of bits in the access code)
64 5d69a524 jcorgan
  unsigned int             d_threshold;        // how many bits may be wrong in sync vector
65 5d69a524 jcorgan
66 5d69a524 jcorgan
 protected:
67 5d69a524 jcorgan
  gr_correlate_access_code_bb(const std::string &access_code, int threshold);
68 5d69a524 jcorgan
69 5d69a524 jcorgan
 public:
70 5d69a524 jcorgan
  ~gr_correlate_access_code_bb();
71 5d69a524 jcorgan
72 5d69a524 jcorgan
  int work(int noutput_items,
73 5d69a524 jcorgan
           gr_vector_const_void_star &input_items,
74 5d69a524 jcorgan
           gr_vector_void_star &output_items);
75 5d69a524 jcorgan
76 5d69a524 jcorgan
  
77 5d69a524 jcorgan
  /*!
78 5d69a524 jcorgan
   * \param access_code is represented with 1 byte per bit, e.g., "010101010111000100"
79 5d69a524 jcorgan
   */
80 5d69a524 jcorgan
  bool set_access_code (const std::string &access_code);
81 5d69a524 jcorgan
};
82 5d69a524 jcorgan
83 5d69a524 jcorgan
#endif /* INCLUDED_GR_CORRELATE_ACCESS_CODE_BB_H */