GNU Radio 3.6.5.1 C++ API
gr_correlate_access_code_tag_bb.h
Go to the documentation of this file.
1 /* -*- c++ -*- */
2 /*
3  * Copyright 2005,2006,2011 Free Software Foundation, Inc.
4  *
5  * This file is part of GNU Radio
6  *
7  * GNU Radio is free software; you can redistribute it and/or modify
8  * it under the terms of the GNU General Public License as published by
9  * the Free Software Foundation; either version 3, or (at your option)
10  * any later version.
11  *
12  * GNU Radio is distributed in the hope that it will be useful,
13  * but WITHOUT ANY WARRANTY; without even the implied warranty of
14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15  * GNU General Public License for more details.
16  *
17  * You should have received a copy of the GNU General Public License
18  * along with GNU Radio; see the file COPYING. If not, write to
19  * the Free Software Foundation, Inc., 51 Franklin Street,
20  * Boston, MA 02110-1301, USA.
21  */
22 
23 #ifndef INCLUDED_gr_correlate_access_code_tag_bb_H
24 #define INCLUDED_gr_correlate_access_code_tag_bb_H
25 
26 #include <gr_core_api.h>
27 #include <gr_sync_block.h>
28 #include <string>
29 
32 
33 /*!
34  * \param access_code is represented with 1 byte per bit, e.g., "010101010111000100"
35  * \param threshold maximum number of bits that may be wrong
36  * \param tag_name key of the tag inserted into the tag stream
37  */
39 gr_make_correlate_access_code_tag_bb (const std::string &access_code, int threshold,
40  const std::string &tag_name);
41 
42 /*!
43  * \brief Examine input for specified access code, one bit at a time.
44  *
45  * input: stream of bits, 1 bit per input byte (data in LSB)
46  * output: unaltered stream of bits (plus tags)
47  *
48  * This block annotates the input stream with tags. The tags have key
49  * name [tag_name], specified in the constructor. Used for searching
50  * an input data stream for preambles, etc.
51  */
53 {
55  gr_make_correlate_access_code_tag_bb (const std::string &access_code, int threshold,
56  const std::string &tag_name);
57  private:
58  unsigned long long d_access_code; // access code to locate start of packet
59  // access code is left justified in the word
60  unsigned long long d_data_reg; // used to look for access_code
61  unsigned long long d_mask; // masks access_code bits (top N bits are set where
62  // N is the number of bits in the access code)
63  unsigned int d_threshold; // how many bits may be wrong in sync vector
64  unsigned int d_len; //the length of the access code
65 
66  pmt::pmt_t d_key, d_me; //d_key is the tag name, d_me is the block name + unique ID
67 
68  protected:
69  gr_correlate_access_code_tag_bb(const std::string &access_code, int threshold,
70  const std::string &tag_name);
71 
72  public:
74 
75  int work(int noutput_items,
76  gr_vector_const_void_star &input_items,
77  gr_vector_void_star &output_items);
78 
79 
80  /*!
81  * \param access_code is represented with 1 byte per bit, e.g., "010101010111000100"
82  */
83  bool set_access_code (const std::string &access_code);
84 };
85 
86 #endif /* INCLUDED_gr_correlate_access_code_tag_bb_H */