actions.hpp

Go to the documentation of this file.

//
// Copyright 2019 Ettus Research, a National Instruments Brand
//
// SPDX-License-Identifier: GPL-3.0-or-later
//
 
#pragma once
 
#include <uhd/config.hpp>
#include <uhd/types/device_addr.hpp>
#include <uhd/types/metadata.hpp>
#include <uhd/types/ranges.hpp>
#include <uhd/types/stream_cmd.hpp>
#include <uhd/types/time_spec.hpp>
#include <uhd/types/tune_request.hpp>
#include <uhd/types/tune_result.hpp>
#include <boost/optional.hpp>
#include <cstddef>
#include <cstdint>
#include <memory>
#include <optional>
#include <string>
#include <vector>
 
namespace uhd { namespace rfnoc {

struct UHD_API action_info
{
public:
    virtual ~action_info() {}
 
    using sptr = std::shared_ptr<action_info>;
    const size_t id;
    std::string key;
    // (de-)serialize it.
    std::vector<uint8_t> payload;
    uhd::device_addr_t args;

    static sptr make(const std::string& key = "",
        const uhd::device_addr_t& args      = uhd::device_addr_t(""));
 
protected:
    action_info(
        const std::string& key, const uhd::device_addr_t& args = uhd::device_addr_t(""));
};
 
struct UHD_API stream_cmd_action_info : public action_info
{
public:
    using sptr = std::shared_ptr<stream_cmd_action_info>;
 
    uhd::stream_cmd_t stream_cmd;

    static sptr make(const uhd::stream_cmd_t::stream_mode_t stream_mode);
 
private:
    stream_cmd_action_info(const uhd::stream_cmd_t::stream_mode_t stream_mode);
};
 
struct UHD_API rx_event_action_info : public action_info
{
public:
    using sptr = std::shared_ptr<rx_event_action_info>;

    uhd::rx_metadata_t::error_code_t error_code;

    static sptr make(uhd::rx_metadata_t::error_code_t error_code);
 
protected:
    rx_event_action_info(uhd::rx_metadata_t::error_code_t error_code);
};
 
struct UHD_API tx_event_action_info : public action_info
{
public:
    using sptr = std::shared_ptr<tx_event_action_info>;

    uhd::async_metadata_t::event_code_t event_code;

    bool has_tsf;

    uint64_t tsf;

    static sptr make(uhd::async_metadata_t::event_code_t event_code,
        const std::optional<uint64_t>& tsf);

    //
    // Required to avoid ambiguity between boost and std versions when using
    // timestamp directly.
    static sptr make(uhd::async_metadata_t::event_code_t event_code, uint64_t tsf);

    [[deprecated("Prefer std::optional over boost::optional.")]] static sptr make(
        uhd::async_metadata_t::event_code_t event_code,
        const boost::optional<uint64_t>& tsf);
 
protected:
    tx_event_action_info(uhd::async_metadata_t::event_code_t event_code,
        const std::optional<uint64_t>& tsf);
};

struct UHD_API tune_request_action_info : public action_info
{
public:
    using sptr = std::shared_ptr<tune_request_action_info>;
 
    uhd::tune_request_t tune_request;
    uhd::time_spec_t time_spec;
    uhd::tune_result_t tune_result;
    uhd::freq_range_t dsp_range;
    uhd::freq_range_t rf_range;
    uhd::freq_range_t overall_freq_range;
    static sptr make(const uhd::tune_request_t tune_request);
 
private:
    tune_request_action_info(const uhd::tune_request_t tune_request);
};
 
}} /* namespace uhd::rfnoc */