| USRP Hardware Driver and Device Manual Version: 4.10.0.0 UHD and USRP Manual |

Loading...
Searching...
No Matches
stream.hpp
Go to the documentation of this file.
1//
2// Copyright 2011-2013 Ettus Research LLC
3// Copyright 2018 Ettus Research, a National Instruments Company
4//
5// SPDX-License-Identifier: GPL-3.0-or-later
6//
7
8#pragma once
9
10#include <uhd/config.hpp>
11#include <uhd/rfnoc/actions.hpp>
12#include <uhd/types/device_addr.hpp>
13#include <uhd/types/ref_vector.hpp>
14#include <uhd/types/stream_cmd.hpp>
15#include <uhd/utils/noncopyable.hpp>
16#include <cstddef>
17#include <memory>
18#include <string>
19#include <vector>
20
21 namespace uhd {
22 struct async_metadata_t;
23 struct rx_metadata_t;
24 struct tx_metadata_t;
25
50 struct UHD_API stream_args_t
51{
53 stream_args_t(const std::string& cpu = "", const std::string& otw = "")
54 {
55 cpu_format = cpu;
56 otw_format = otw;
57 }
58
75 std::string cpu_format;
76
95 std::string otw_format;
96
132 device_addr_t args;
133
161 std::vector<size_t> channels;
162};
163
169 class UHD_API rx_streamer : uhd::noncopyable
170{
171 public:
172 typedef std::shared_ptr<rx_streamer> sptr;
173
174 virtual ~rx_streamer(void);
175
177 virtual size_t get_num_channels(void) const = 0;
178
180 virtual size_t get_max_num_samps(void) const = 0;
181
183 typedef ref_vector<void*> buffs_type;
184
327 virtual size_t recv(const buffs_type& buffs,
328 const size_t nsamps_per_buff,
329 rx_metadata_t& metadata,
330 const double timeout = 0.1,
331 const bool one_packet = false) = 0;
332
344 virtual void issue_stream_cmd(const stream_cmd_t& stream_cmd) = 0;
345
351 virtual void post_input_action(
352 const std::shared_ptr<uhd::rfnoc::action_info>& action, const size_t port) = 0;
353};
354
360 class UHD_API tx_streamer : uhd::noncopyable
361{
362 public:
363 typedef std::shared_ptr<tx_streamer> sptr;
364
365 virtual ~tx_streamer(void);
366
368 virtual size_t get_num_channels(void) const = 0;
369
371 virtual size_t get_max_num_samps(void) const = 0;
372
374 typedef ref_vector<const void*> buffs_type;
375
404 virtual size_t send(const buffs_type& buffs,
405 const size_t nsamps_per_buff,
406 const tx_metadata_t& metadata,
407 const double timeout = 0.1) = 0;
408
415 virtual bool recv_async_msg(
416 async_metadata_t& async_metadata, double timeout = 0.1) = 0;
417
423 virtual void post_output_action(
424 const std::shared_ptr<uhd::rfnoc::action_info>& action, const size_t port) = 0;
425};
426
427} // namespace uhd
actions.hpp
uhd::device_addr_t
Definition device_addr.hpp:39
uhd::ref_vector
Definition ref_vector.hpp:22
uhd::rx_streamer
Definition stream.hpp:170
uhd::rx_streamer::buffs_type
ref_vector< void * > buffs_type
Typedef for a pointer to a single, or a collection of recv buffers.
Definition stream.hpp:183
uhd::rx_streamer::sptr
std::shared_ptr< rx_streamer > sptr
Definition stream.hpp:172
uhd::rx_streamer::post_input_action
virtual void post_input_action(const std::shared_ptr< uhd::rfnoc::action_info > &action, const size_t port)=0
uhd::rx_streamer::~rx_streamer
virtual ~rx_streamer(void)
uhd::rx_streamer::issue_stream_cmd
virtual void issue_stream_cmd(const stream_cmd_t &stream_cmd)=0
uhd::rx_streamer::get_num_channels
virtual size_t get_num_channels(void) const =0
Get the number of channels associated with this streamer.
uhd::rx_streamer::get_max_num_samps
virtual size_t get_max_num_samps(void) const =0
Get the max number of samples per buffer per packet.
uhd::rx_streamer::recv
virtual size_t recv(const buffs_type &buffs, const size_t nsamps_per_buff, rx_metadata_t &metadata, const double timeout=0.1, const bool one_packet=false)=0
uhd::tx_streamer
Definition stream.hpp:361
uhd::tx_streamer::~tx_streamer
virtual ~tx_streamer(void)
uhd::tx_streamer::recv_async_msg
virtual bool recv_async_msg(async_metadata_t &async_metadata, double timeout=0.1)=0
uhd::tx_streamer::sptr
std::shared_ptr< tx_streamer > sptr
Definition stream.hpp:363
uhd::tx_streamer::buffs_type
ref_vector< const void * > buffs_type
Typedef for a pointer to a single, or a collection of send buffers.
Definition stream.hpp:374
uhd::tx_streamer::get_max_num_samps
virtual size_t get_max_num_samps(void) const =0
Get the max number of samples per buffer per packet.
uhd::tx_streamer::post_output_action
virtual void post_output_action(const std::shared_ptr< uhd::rfnoc::action_info > &action, const size_t port)=0
uhd::tx_streamer::send
virtual size_t send(const buffs_type &buffs, const size_t nsamps_per_buff, const tx_metadata_t &metadata, const double timeout=0.1)=0
uhd::tx_streamer::get_num_channels
virtual size_t get_num_channels(void) const =0
Get the number of channels associated with this streamer.
UHD_API
#define UHD_API
Definition config.h:87
config.hpp
device_addr.hpp
uhd
Definition build_info.hpp:12
uhd::noncopyable
boost::noncopyable noncopyable
Definition noncopyable.hpp:45
noncopyable.hpp
ref_vector.hpp
stream_cmd.hpp
uhd::async_metadata_t
Definition metadata.hpp:203
uhd::rx_metadata_t
Definition metadata.hpp:23
uhd::stream_args_t::otw_format
std::string otw_format
Definition stream.hpp:95
uhd::stream_args_t::args
device_addr_t args
Definition stream.hpp:132
uhd::stream_args_t::cpu_format
std::string cpu_format
Definition stream.hpp:75
uhd::stream_args_t::stream_args_t
stream_args_t(const std::string &cpu="", const std::string &otw="")
Convenience constructor for streamer args.
Definition stream.hpp:53
uhd::stream_args_t::channels
std::vector< size_t > channels
Definition stream.hpp:161
uhd::stream_cmd_t
Definition stream_cmd.hpp:42
uhd::tx_metadata_t
Definition metadata.hpp:163