fmcomms2_sink.h

Go to the documentation of this file.

/* -*- c++ -*- */
/*
 * Copyright 2014 Analog Devices Inc.
 * Author: Paul Cercueil <paul.cercueil@analog.com>
 *
 * SPDX-License-Identifier: GPL-3.0-or-later
 *
 */
 
 
#ifndef INCLUDED_IIO_FMCOMMS2_SINK_H
#define INCLUDED_IIO_FMCOMMS2_SINK_H
 
#include <gnuradio/hier_block2.h>
#include <gnuradio/iio/api.h>
#include <gnuradio/sync_block.h>
 
#include "device_sink.h"
 
namespace gr {
namespace iio {
 
/*!
 * \brief Device specific sink for FMComms evaluation cards
 * \ingroup iio
 *
 * \details
 * This block is a sink specifically designed for FMComms2/3/4 evaluation
 * cards. However, it should support any AD936x based device using an IIO
 * driver.
 */
 
template <typename T>
class IIO_API fmcomms2_sink : virtual public gr::sync_block
{
public:
    typedef std::shared_ptr<fmcomms2_sink<T>> sptr;
 
    static sptr make(const std::string& uri,
                     const std::vector<bool>& ch_en,
                     unsigned long buffer_size,
                     bool cyclic);
 
    /*!
     * The key of the tag that indicates packet length.
     * When not empty, samples are expected as "packets" and
     * must be tagged as such, i.e. the first sample of a packet needs to be
     * tagged with the corresponding length of that packet.
     * Note, packet size MUST be equal to buffer_size / (1+interpolation),
     * otherwise a runtime_error will be thrown. This is a deliberate design
     * choice, because all other options would result in potentially unexpected
     * behavior.
     */
    virtual void set_len_tag_key(const std::string& val = "") = 0;
 
    virtual void set_bandwidth(unsigned long bandwidth) = 0;
    virtual void set_rf_port_select(const std::string& rf_port_select) = 0;
    virtual void set_frequency(double frequency) = 0;
    virtual void set_samplerate(unsigned long samplerate) = 0;
    virtual void set_attenuation(size_t chan, double gain) = 0;
    virtual void set_filter_params(const std::string& filter_source,
                                   const std::string& filter_filename = "",
                                   float fpass = 0.0,
                                   float fstop = 0.0) = 0;
};
 
typedef fmcomms2_sink<int16_t> fmcomms2_sink_s;
typedef fmcomms2_sink<std::complex<int16_t>> fmcomms2_sink_sc16;
typedef fmcomms2_sink<gr_complex> fmcomms2_sink_fc32;
 
} // namespace iio
} // namespace gr
 
#endif /* INCLUDED_IIO_FMCOMMS2_SINK_H */