blockdef.hpp

Go to the documentation of this file.

//
// Copyright 2014-2015 Ettus Research LLC
// Copyright 2018 Ettus Research, a National Instruments Company
//
// SPDX-License-Identifier: GPL-3.0-or-later
//

#pragma once

#include <uhd/config.hpp>
#include <uhd/types/device_addr.hpp>
#include <stdint.h>
#include <memory>
#include <set>
#include <vector>

namespace uhd { namespace rfnoc {

class UHD_API blockdef : public std::enable_shared_from_this<blockdef>
{
public:
    typedef std::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(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 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 */