blockdef.hpp

Go to the documentation of this file.

//
// Copyright 2014-2015 Ettus Research LLC
//
// This program is free software: you can redistribute it and/or modify
// it under the terms of the GNU General Public License as published by
// the Free Software Foundation, either version 3 of the License, or
// (at your option) any later version.
//
// This program is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
// GNU General Public License for more details.
//
// You should have received a copy of the GNU General Public License
// along with this program.  If not, see <http://www.gnu.org/licenses/>.
//

#ifndef INCLUDED_LIBUHD_RFNOC_BLOCKDEF_HPP
#define INCLUDED_LIBUHD_RFNOC_BLOCKDEF_HPP

#include <boost/cstdint.hpp>
#include <boost/enable_shared_from_this.hpp>
#include <uhd/config.hpp>
#include <uhd/types/device_addr.hpp>
#include <vector>
#include <set>

namespace uhd { namespace rfnoc {

class UHD_RFNOC_API blockdef : public boost::enable_shared_from_this<blockdef>
{
public:
    typedef boost::shared_ptr<blockdef> sptr;

    //
    // This is not the same as a uhd::rfnoc::stream_sig_t. This is used
    // to describe which ports are defined in a block definition, and
    // to describe what kind of connection is allowed for this port.
    //
    // All the keys listed in PORT_ARGS will be available in this class.
    class port_t : public uhd::dict<std::string, std::string> {
      public:
        static const device_addr_t PORT_ARGS;

        port_t();

        bool is_variable(const std::string &key) const;
        bool is_keyword(const std::string &key) const;
        //  keywords are not resolved.
        bool is_valid() const;
        std::string to_string() const;
    };
    typedef std::vector<port_t> ports_t;

    class arg_t : public uhd::dict<std::string, std::string> {
      public:
        static const device_addr_t ARG_ARGS;
        static const std::set<std::string> VALID_TYPES;

        arg_t();

        bool is_valid() const;
        std::string to_string() const;

    };
    typedef std::vector<arg_t> args_t;

    typedef uhd::dict<std::string, size_t> registers_t;

    static sptr make_from_noc_id(boost::uint64_t noc_id);

    virtual bool is_block() const = 0;

    virtual bool is_component() const = 0;

    virtual std::string get_key() const = 0;

    virtual std::string get_name() const = 0;

    virtual boost::uint64_t noc_id() const = 0;

    virtual ports_t get_input_ports() = 0;
    virtual ports_t get_output_ports() = 0;

    virtual std::vector<size_t> get_all_port_numbers() = 0;

    //
    // \throws uhd::runtime_error if args are invalid.
    virtual args_t get_args() = 0;

    virtual registers_t get_settings_registers() = 0;

    virtual registers_t get_readback_registers() = 0;
};

}} /* namespace uhd::rfnoc */

#endif /* INCLUDED_LIBUHD_RFNOC_BLOCKDEF_HPP */
// vim: sw=4 et: