Transmit and Receive Functions¶
Setting up transmit and receive¶

bool vxsdr::tx_start(const vxsdr::time_point &t, const uint64_t n = 0, const uint8_t subdev = 0)¶
Start transmitting at time
t
untiln
samples are sent. Ift
is less than the current time, start immediately; ifn
is 0, continue until a stop command is sent. Parameters
t – the start time
n – the number of samples to send
subdev – the subdevice number
 Returns
true if the command succeeds, false otherwise

bool vxsdr::rx_start(const vxsdr::time_point &t, const uint64_t n = 0, const uint8_t subdev = 0)¶
Start receiving at time
t
untiln
samples are received. Ift
is less than the current time, start immediately; ifn
is 0, continue until a stop command is sent. Parameters
t – the start time
n – the number of samples to receive
subdev – the subdevice number
 Returns
true if the command succeeds, false otherwise
Setting up repeating transmit and receive¶

bool vxsdr::tx_loop(const vxsdr::time_point &t, const uint64_t n, const vxsdr::duration &t_delay = vxsdr::duration::zero(), const uint32_t n_repeat = 0, const uint8_t subdev = 0)¶
Start transmitting at time
t
untiln
samples are sent, repeating with a delay after each transmission oft_delay
, forn_repeat
iterations. Ift
is less than the current time, start immediately; ifn_repeat
is 0, continue until a stop command is sent. Note that if you wish to send the samples to be looped only once,n_samples
must be small enough that the entire looped waveform fits in the device’s transmit buffer. Parameters
t – the start time
n – the number of samples to send
t_delay – the delay between repeat transmissions
n_repeat – the total number of transmissions
subdev – the subdevice number
 Returns
true if the command succeeds, false otherwise

bool vxsdr::rx_loop(const vxsdr::time_point &t, const uint64_t n, const vxsdr::duration &t_delay = vxsdr::duration::zero(), const uint32_t n_repeat = 0, const uint8_t subdev = 0)¶
Start receiving at time
t
untiln
samples are received, repeating with a delay after each reception oft_delay
, forn_repeat
iterations. forn_repeat
iterations. Ift
is less than the current time, start immediately; ifn_repeat
is 0, continue until a stop command is sent. Parameters
t – the start time
n – the number of samples to receive
t_delay – the delay between repeat receptions
n_repeat – the total number of receptions
subdev – the subdevice number
 Returns
true if the command succeeds, false otherwise
Interrupting transmit and receive¶
Sending and receiving samples¶

size_t vxsdr::put_tx_data(const std::vector<std::complex<int16_t>> &data, const uint8_t subdev = 0, const double timeout_s = 10)¶
Send transmit data to the device.
 Parameters
data – the
complex<int16_t>
vector of data to be sentsubdev – the subdevice number
timeout_s – timeout in seconds
 Returns
the number of samples placed in the queue for transmission

size_t vxsdr::put_tx_data(const std::vector<std::complex<float>> &data, const uint8_t subdev = 0, const double timeout_s = 10)¶
Send transmit data to the device.
 Parameters
data – the
complex<float>
vector of data to be sentsubdev – the subdevice number
timeout_s – timeout in seconds
 Returns
the number of samples placed in the queue for transmission

size_t vxsdr::get_rx_data(std::vector<std::complex<int16_t>> &data, const size_t n_desired = 0, const uint8_t subdev = 0, const double timeout_s = 10)¶
Receive data from the device and return it in a vector.
 Parameters
data – the
complex<int16_t>
vector for the received datan_desired – the number of samples to be received (0 means use data.size(); if data.size() < n_desired, only data.size() will be acquired)
subdev – the subdevice number
timeout_s – timeout in seconds
 Returns
the number of samples received before a sequence error, or
n_desired
if no sequence errors occur

size_t vxsdr::get_rx_data(std::vector<std::complex<float>> &data, const size_t n_desired = 0, const uint8_t subdev = 0, const double timeout_s = 10)¶
Receive data from the device and return it in a vector.
 Parameters
data – the
complex<float>
vector for the received datan_desired – the number of samples to be received (0 means use data.size(); if data.size() < n_desired, only data.size() will be acquired)
subdev – the subdevice number
timeout_s – timeout in seconds
 Returns
the number of samples received before a sequence error, or
n_desired
if no sequence errors occur