#include <Device.hpp>

Public Member Functions
virtual	~Device (void)
	virtual destructor for inheritance More...

virtual std::string	getDriverKey (void) const

virtual std::string	getHardwareKey (void) const

virtual Kwargs	getHardwareInfo (void) const

virtual void	setFrontendMapping (const int direction, const std::string &mapping)

virtual std::string	getFrontendMapping (const int direction) const

virtual size_t	getNumChannels (const int direction) const

virtual bool	getFullDuplex (const int direction, const size_t channel) const

virtual Stream *	setupStream (const int direction, const std::string &format, const std::vector< size_t > &channels=std::vector< size_t >(), const Kwargs &args=Kwargs())

virtual void	closeStream (Stream *stream)

virtual int	activateStream (Stream *stream, const int flags=0, const long long timeNs=0, const size_t numElems=0)

virtual int	deactivateStream (Stream *stream, const int flags=0, const long long timeNs=0)

virtual int	readStream (Stream stream, void const *buffs, const size_t numElems, int &flags, long long &timeNs, const long timeoutUs=100000)

virtual int	writeStream (Stream stream, const void const *buffs, const size_t numElems, int &flags, const long long timeNs=0, const long timeoutUs=100000)

virtual std::vector< std::string >	listAntennas (const int direction, const size_t channel) const

virtual void	setAntenna (const int direction, const size_t channel, const std::string &name)

virtual std::string	getAntenna (const int direction, const size_t channel) const

virtual void	setDCOffsetMode (const int direction, const size_t channel, const bool automatic)

virtual bool	getDCOffsetMode (const int direction, const size_t channel) const

virtual void	setDCOffset (const int direction, const size_t channel, const std::complex< double > &offset)

virtual std::complex< double >	getDCOffset (const int direction, const size_t channel) const

virtual void	setIQBalance (const int direction, const size_t channel, const std::complex< double > &balance)

virtual std::complex< double >	getIQBalance (const int direction, const size_t channel) const

virtual std::vector< std::string >	listGains (const int direction, const size_t channel) const

virtual void	setGainMode (const int direction, const size_t channel, const bool automatic)

virtual bool	getGainMode (const int direction, const size_t channel) const

virtual void	setGain (const int direction, const size_t channel, const double value)

virtual void	setGain (const int direction, const size_t channel, const std::string &name, const double value)

virtual double	getGain (const int direction, const size_t channel) const

virtual double	getGain (const int direction, const size_t channel, const std::string &name) const

virtual Range	getGainRange (const int direction, const size_t channel) const

virtual Range	getGainRange (const int direction, const size_t channel, const std::string &name) const

virtual void	setFrequency (const int direction, const size_t channel, const double frequency, const Kwargs &args=Kwargs())

virtual double	getFrequency (const int direction, const size_t channel) const

virtual double	getFrequency (const int direction, const size_t channel, const std::string &name) const

virtual std::vector< std::string >	listFrequencies (const int direction, const size_t channel) const

virtual RangeList	getFrequencyRange (const int direction, const size_t channel) const

virtual void	setSampleRate (const int direction, const size_t channel, const double rate)

virtual double	getSampleRate (const int direction, const size_t channel) const

virtual std::vector< double >	listSampleRates (const int direction, const size_t channel) const

virtual void	setBandwidth (const int direction, const size_t channel, const double bw)

virtual double	getBandwidth (const int direction, const size_t channel) const

virtual std::vector< double >	listBandwidths (const int direction, const size_t channel) const

virtual void	setMasterClockRate (const double rate)

virtual double	getMasterClockRate (void) const

virtual std::vector< std::string >	listClockSources (void) const

virtual void	setClockSource (const std::string &source)

virtual std::string	getClockSource (void) const

virtual std::vector< std::string >	listTimeSources (void) const

virtual void	setTimeSource (const std::string &source)

virtual std::string	getTimeSource (void) const

virtual bool	hasHardwareTime (const std::string &what="") const

virtual long long	getHardwareTime (const std::string &what="") const

virtual void	setHardwareTime (const long long timeNs, const std::string &what="")

virtual void	setCommandTime (const long long timeNs, const std::string &what="")

virtual std::vector< std::string >	listSensors (void) const

virtual std::string	readSensor (const std::string &name) const

virtual void	writeRegister (const unsigned addr, const unsigned value)

virtual unsigned	readRegister (const unsigned addr) const

virtual void	writeSetting (const std::string &key, const std::string &value)

virtual std::string	readSetting (const std::string &key) const

virtual std::vector< std::string >	listGPIOBanks (void) const

virtual void	writeGPIO (const std::string &bank, const unsigned value)

virtual unsigned	readGPIO (const std::string &bank) const

virtual void	writeI2C (const int addr, const std::string &data)

virtual std::string	readI2C (const int addr, const size_t numBytes)

virtual unsigned	transactSPI (const int addr, const unsigned data, const size_t numBits)

virtual std::vector< std::string >	listUARTs (void) const

virtual void	writeUART (const std::string &which, const std::string &data)

virtual std::string	readUART (const std::string &which, const long timeoutUs=100000) const

Static Public Member Functions
static std::vector< Kwargs >	enumerate (const Kwargs &args=Kwargs())

static std::vector< Kwargs >	enumerate (const std::string &args)

static Device *	make (const Kwargs &args=Kwargs())

static Device *	make (const std::string &args)

static void	unmake (Device *device)

Detailed Description

Abstraction for an SDR tranceiver device - configuration and streaming.

Constructor & Destructor Documentation

virtual SoapySDR::Device::~Device ( void )

virtual

virtual destructor for inheritance

Member Function Documentation

virtual int SoapySDR::Device::activateStream	(	Stream *	stream,
		const int	flags = `0`,
		const long long	timeNs = `0`,
		const size_t	numElems = `0`
	)

virtual

Activate a stream. Call activate to prepare a stream before using read/write(). The implementation control switches or stimulate data flow.

The timeNs is only valid when the flags have SOAPY_SDR_HAS_TIME. The numElems count can be used to request a finite burst size. The SOAPY_SDR_END_BURST flag can signal end on the finite burst. Not all implementations will support the full range of options. In this case, the implementation returns SOAPY_SDR_NOT_SUPPORTED.

Parameters

stream	the opaque pointer to a stream handle
flags	optional flag indicators about the stream
timeNs	optional activation time in nanoseconds
numElems	optional element count for burst control

Returns: 0 for success or error code on failure

virtual void SoapySDR::Device::closeStream ( Stream * stream )

virtual

Close an open stream created by setupStream The implementation may change switches or power-down components.

Parameters

stream the opaque pointer to a stream handle

virtual int SoapySDR::Device::deactivateStream	(	Stream *	stream,
		const int	flags = `0`,
		const long long	timeNs = `0`
	)

virtual

Deactivate a stream. Call deactivate when not using using read/write(). The implementation control switches or halt data flow.

The timeNs is only valid when the flags have SOAPY_SDR_HAS_TIME. Not all implementations will support the full range of options. In this case, the implementation returns SOAPY_SDR_NOT_SUPPORTED.

Parameters

stream	the opaque pointer to a stream handle
flags	optional flag indicators about the stream
timeNs	optional deactivation time in nanoseconds

Returns: 0 for success or error code on failure

static std::vector<Kwargs> SoapySDR::Device::enumerate ( const Kwargs & args = Kwargs() )

static

Enumerate a list of available devices on the system.

Parameters

args	device construction key/value argument filters

Returns: a list of argument maps, each unique to a device

static std::vector<Kwargs> SoapySDR::Device::enumerate ( const std::string & args )

static

Enumerate a list of available devices on the system. Markup format for args: "keyA=valA, keyB=valB".

Parameters

args	a markup string of key/value argument filters

Returns: a list of argument maps, each unique to a device

virtual std::string SoapySDR::Device::getAntenna	(	const int	direction,
		const size_t	channel
	)		const

virtual

Get the selected antenna on a chain.

Parameters

direction	the channel direction RX or TX
channel	an available channel on the device

Returns: the name of an available antenna

virtual double SoapySDR::Device::getBandwidth	(	const int	direction,
		const size_t	channel
	)		const

virtual

Get the baseband filter width of the chain.

Parameters

direction	the channel direction RX or TX
channel	an available channel on the device

Returns: the baseband filter width in Hz

virtual std::string SoapySDR::Device::getClockSource ( void ) const

virtual

Get the clock source of the device

Returns: the name of a clock source

virtual std::complex<double> SoapySDR::Device::getDCOffset	(	const int	direction,
		const size_t	channel
	)		const

virtual

Get the frontend DC offset correction.

Parameters

direction	the channel direction RX or TX
channel	an available channel on the device

Returns: the relative correction (1.0 max)

virtual bool SoapySDR::Device::getDCOffsetMode	(	const int	direction,
		const size_t	channel
	)		const

virtual

Get the automatic DC offset corrections mode.

Parameters

direction	the channel direction RX or TX
channel	an available channel on the device

Returns: true for automatic offset correction

virtual std::string SoapySDR::Device::getDriverKey ( void ) const

virtual

A key that uniquely identifies the device driver. This key identifies the underlying implementation. Serveral variants of a product may share a driver.

virtual double SoapySDR::Device::getFrequency	(	const int	direction,
		const size_t	channel
	)		const

virtual

Get the center frequency of the chain.

Parameters

direction	the channel direction RX or TX
channel	an available channel on the device

Returns: the center frequency in Hz

virtual double SoapySDR::Device::getFrequency	(	const int	direction,
		const size_t	channel,
		const std::string &	name
	)		const

virtual

Get the frequency of a tunable element in the chain. Recommended names used to represent tunable components:

"CORR" - freq error correction in PPM
"RF" - frequency of the RF frontend
"BB" - frequency of the baseband DSP
Parameters

direction the channel direction RX or TX

channel an available channel on the device

name the name of an frequency component

Returns
a dictionary of tunable elements to frequencies in Hz

virtual RangeList SoapySDR::Device::getFrequencyRange	(	const int	direction,
		const size_t	channel
	)		const

virtual

Get the range of possible frequency values.

Parameters

direction	the channel direction RX or TX
channel	an available channel on the device

Returns: a list of frequency ranges in Hz

virtual std::string SoapySDR::Device::getFrontendMapping ( const int direction ) const

virtual

Get the mapping configuration string.

Parameters

direction	the channel direction RX or TX
the	vendor-specific mapping string

virtual bool SoapySDR::Device::getFullDuplex	(	const int	direction,
		const size_t	channel
	)		const

virtual

Find out if the specified channel is full or half duplex.

Parameters

direction	the channel direction RX or TX
channel	an available channel on the device

Returns: true for full duplex, false for half duplex

virtual double SoapySDR::Device::getGain	(	const int	direction,
		const size_t	channel
	)		const

virtual

Get the overall value of the gain elements in a chain.

Parameters

direction	the channel direction RX or TX
channel	an available channel on the device

Returns: the value of the gain in dB

virtual double SoapySDR::Device::getGain	(	const int	direction,
		const size_t	channel,
		const std::string &	name
	)		const

virtual

Get the value of an individual amplification element in a chain.

Parameters

direction	the channel direction RX or TX
channel	an available channel on the device
name	the name of an amplification element

Returns: the value of the gain in dB

virtual bool SoapySDR::Device::getGainMode	(	const int	direction,
		const size_t	channel
	)		const

virtual

Get the automatic gain mode on the chain.

Parameters

direction	the channel direction RX or TX
channel	an available channel on the device

Returns: true for automatic gain setting

virtual Range SoapySDR::Device::getGainRange	(	const int	direction,
		const size_t	channel
	)		const

virtual

Get the overall range of possible gain values.

Parameters

direction	the channel direction RX or TX
channel	an available channel on the device

Returns: a list of gain ranges in dB

virtual Range SoapySDR::Device::getGainRange	(	const int	direction,
		const size_t	channel,
		const std::string &	name
	)		const

virtual

Get the range of possible gain values for a specific element.

Parameters

direction	the channel direction RX or TX
channel	an available channel on the device
name	the name of an amplification element

Returns: a list of gain ranges in dB

virtual Kwargs SoapySDR::Device::getHardwareInfo ( void ) const

virtual

Query a dictionary of available device information. This dictionary can any number of values like vendor name, product name, revisions, serials... This information can be displayed to the user to help identify the instantiated device.

virtual std::string SoapySDR::Device::getHardwareKey ( void ) const

virtual

A key that uniquely identifies the hardware. This key should be meaningful to the user to optimize for the underlying hardware.

virtual long long SoapySDR::Device::getHardwareTime ( const std::string & what = "" ) const

virtual

Read the time from the hardware clock on the device. The what argument can refer to a specific time counter.

Parameters

what	optional argument

Returns: the time in nanoseconds

virtual std::complex<double> SoapySDR::Device::getIQBalance	(	const int	direction,
		const size_t	channel
	)		const

virtual

Get the frontend IQ balance correction.

Parameters

direction	the channel direction RX or TX
channel	an available channel on the device

Returns: the relative correction (1.0 max)

virtual double SoapySDR::Device::getMasterClockRate ( void ) const

virtual

Get the master clock rate of the device.

Returns: the clock rate in Hz

virtual size_t SoapySDR::Device::getNumChannels ( const int direction ) const

virtual

Get a number of channels given the streaming direction

virtual double SoapySDR::Device::getSampleRate	(	const int	direction,
		const size_t	channel
	)		const

virtual

Get the baseband sample rate of the chain.

Parameters

direction	the channel direction RX or TX
channel	an available channel on the device

Returns: the sample rate in samples per second

virtual std::string SoapySDR::Device::getTimeSource ( void ) const

virtual

Get the time source of the device

Returns: the name of a time source

virtual bool SoapySDR::Device::hasHardwareTime ( const std::string & what = "" ) const

virtual

Does this device have a hardware clock?

Parameters

what	optional argument

Returns: true if the hardware clock exists

virtual std::vector<std::string> SoapySDR::Device::listAntennas	(	const int	direction,
		const size_t	channel
	)		const

virtual

Get a list of available antennas to select on a given chain.

Parameters

direction	the channel direction RX or TX
channel	an available channel on the device

Returns: a list of available antenna names

virtual std::vector<double> SoapySDR::Device::listBandwidths	(	const int	direction,
		const size_t	channel
	)		const

virtual

Get the range of possible baseband filter widths.

Parameters

direction	the channel direction RX or TX
channel	an available channel on the device

Returns: a list of possible bandwidths in Hz

virtual std::vector<std::string> SoapySDR::Device::listClockSources ( void ) const

virtual

Get the list of available clock sources.

Returns: a list of clock source names

virtual std::vector<std::string> SoapySDR::Device::listFrequencies	(	const int	direction,
		const size_t	channel
	)		const

virtual

List available tunable elements in the chain.

Parameters

direction	the channel direction RX or TX
channel	an available channel

Returns: a list of tunable elements by name

virtual std::vector<std::string> SoapySDR::Device::listGains	(	const int	direction,
		const size_t	channel
	)		const

virtual

List available amplification elements.

Parameters

direction	the channel direction RX or TX
channel	an available channel

Returns: a list of gain string names

virtual std::vector<std::string> SoapySDR::Device::listGPIOBanks ( void ) const

virtual

Get a list of available GPIO banks by name.

virtual std::vector<double> SoapySDR::Device::listSampleRates	(	const int	direction,
		const size_t	channel
	)		const

virtual

Get the range of possible baseband sample rates.

Parameters

direction	the channel direction RX or TX
channel	an available channel on the device

Returns: a list of possible rates in samples per second

virtual std::vector<std::string> SoapySDR::Device::listSensors ( void ) const

virtual

List the available readback sensors. A sensor can represent a reference lock, RSSI, temperature.

Returns: a list of available sensor string names

virtual std::vector<std::string> SoapySDR::Device::listTimeSources ( void ) const

virtual

Get the list of available time sources.

Returns: a list of time source names

virtual std::vector<std::string> SoapySDR::Device::listUARTs ( void ) const

virtual

Enumerate the available UART devices.

Returns: a list of names of available UARTs

static Device* SoapySDR::Device::make ( const Kwargs & args = Kwargs() )

static

Make a new Device object given device construction args. The device pointer will be stored in a table so subsequent calls with the same arguments will produce the same device. For every call to make, there should be a matched call to unmake.

Note: This call is not thread safe. Implementations calling into make from multiple threads should protect this call with a mutex.

Parameters

args	device construction key/value argument map

Returns: a pointer to a new Device object

static Device* SoapySDR::Device::make ( const std::string & args )

static

Make a new Device object given device construction args. The device pointer will be stored in a table so subsequent calls with the same arguments will produce the same device. For every call to make, there should be a matched call to unmake.

Note: This call is not thread safe. Implementations calling into make from multiple threads should protect this call with a mutex.

Parameters

args	a markup string of key/value arguments

Returns: a pointer to a new Device object

virtual unsigned SoapySDR::Device::readGPIO ( const std::string & bank ) const

virtual

Readback the value of a GPIO bank.

Parameters

bank	the name of an available bank

Returns: an integer representing GPIO bits

virtual std::string SoapySDR::Device::readI2C	(	const int	addr,
		const size_t	numBytes
	)

virtual

Read from an available I2C slave. If the device contains multiple I2C masters, the address bits can encode which master.

Parameters

addr	the address of the slave
numBytes	the number of bytes to read

Returns: an array of bytes read from the slave

virtual unsigned SoapySDR::Device::readRegister ( const unsigned addr ) const

virtual

Read a register on the device.

Parameters

addr	the register address

Returns: the register value

virtual std::string SoapySDR::Device::readSensor ( const std::string & name ) const

virtual

Readback a sensor given the name. The value returned is a string which can represent a boolean ("true"/"false"), an integer, or float.

Parameters

name	the name of an available sensor

Returns: the current value of the sensor

virtual std::string SoapySDR::Device::readSetting ( const std::string & key ) const

virtual

Read an arbitrary setting on the device.

Parameters

key	the setting identifier

Returns: the setting value

virtual int SoapySDR::Device::readStream	(	Stream *	stream,
		void const	buffs,
		const size_t	numElems,
		int &	flags,
		long long &	timeNs,
		const long	timeoutUs = `100000`
	)

virtual

Read elements from a stream for reception. This is a multi-channel call, and buffs should be an array of void *, where each pointer will be filled with data from a different channel.

Parameters

stream	the opaque pointer to a stream handle
buffs	an array of void* buffers num chans in size
numElems	the number of elements in each buffer
flags	optional flag indicators about the result
timeNs	the buffer's timestamp in nanoseconds
timeoutUs	the timeout in microseconds

Returns: the number of elements read per buffer or error code

virtual std::string SoapySDR::Device::readUART	(	const std::string &	which,
		const long	timeoutUs = `100000`
	)		const

virtual

Read bytes from a UART until timeout or newline. Its up to the implementation to set the baud rate, carriage return settings, flushing on newline.

Parameters

which	the name of an available UART
timeoutUs	a timeout in microseconds

Returns: an array of bytes read from the UART

virtual void SoapySDR::Device::setAntenna	(	const int	direction,
		const size_t	channel,
		const std::string &	name
	)

virtual

Set the selected antenna on a chain.

Parameters

direction	the channel direction RX or TX
channel	an available channel on the device
name	the name of an available antenna

virtual void SoapySDR::Device::setBandwidth	(	const int	direction,
		const size_t	channel,
		const double	bw
	)

virtual

Set the baseband filter width of the chain.

Parameters

direction	the channel direction RX or TX
channel	an available channel on the device
bw	the baseband filter width in Hz

virtual void SoapySDR::Device::setClockSource ( const std::string & source )

virtual

Set the clock source on the device

Parameters

source the name of a clock source

virtual void SoapySDR::Device::setCommandTime	(	const long long	timeNs,
		const std::string &	what = `""`
	)

virtual

Set the time of subsequent configuration calls. The what argument can refer to a specific command queue. Implementations may use a time of 0 to clear.

Parameters

timeNs	time in nanoseconds
what	optional argument

virtual void SoapySDR::Device::setDCOffset	(	const int	direction,
		const size_t	channel,
		const std::complex< double > &	offset
	)

virtual

Set the frontend DC offset correction.

Parameters

direction	the channel direction RX or TX
channel	an available channel on the device
offset	the relative correction (1.0 max)

virtual void SoapySDR::Device::setDCOffsetMode	(	const int	direction,
		const size_t	channel,
		const bool	automatic
	)

virtual

Set the automatic DC offset corrections mode.

Parameters

direction	the channel direction RX or TX
channel	an available channel on the device
automatic	true for automatic offset correction

virtual void SoapySDR::Device::setFrequency	(	const int	direction,
		const size_t	channel,
		const double	frequency,
		const Kwargs &	args = `Kwargs()`
	)

virtual

Set the center frequency of the chain. Recommended keys to use in the args dictionary:

"CORR" - freq error correction in PPM
"OFFSET" - offset for the RF frontend
"RF" - frequency of the RF frontend
"BB" - frequency of the baseband DSP
Parameters

direction the channel direction RX or TX

channel an available channel on the device

frequency the center frequency in Hz

args optional tuner arguments

virtual void SoapySDR::Device::setFrontendMapping	(	const int	direction,
		const std::string &	mapping
	)

virtual

Set the frontend mapping of available DSP units to RF frontends. This mapping controls channel mapping and channel availability.

Parameters

direction	the channel direction RX or TX
mapping	a vendor-specific mapping string

virtual void SoapySDR::Device::setGain	(	const int	direction,
		const size_t	channel,
		const double	value
	)

virtual

Set the overall amplification in a chain. The gain will be distributed automatically across available element.

Parameters

direction	the channel direction RX or TX
channel	an available channel on the device
name	the name of an amplification element
value	the new amplification value in dB

virtual void SoapySDR::Device::setGain	(	const int	direction,
		const size_t	channel,
		const std::string &	name,
		const double	value
	)

virtual

Set the value of a amplification element in a chain.

Parameters

direction	the channel direction RX or TX
channel	an available channel on the device
name	the name of an amplification element
value	the new amplification value in dB

virtual void SoapySDR::Device::setGainMode	(	const int	direction,
		const size_t	channel,
		const bool	automatic
	)

virtual

Set the automatic gain mode on the chain.

Parameters

direction	the channel direction RX or TX
channel	an available channel on the device
automatic	true for automatic gain setting

virtual void SoapySDR::Device::setHardwareTime	(	const long long	timeNs,
		const std::string &	what = `""`
	)

virtual

Write the time to the hardware clock on the device. The what argument can refer to a specific time counter.

Parameters

timeNs	time in nanoseconds
what	optional argument

virtual void SoapySDR::Device::setIQBalance	(	const int	direction,
		const size_t	channel,
		const std::complex< double > &	balance
	)

virtual

Set the frontend IQ balance correction.

Parameters

direction	the channel direction RX or TX
channel	an available channel on the device
balance	the relative correction (1.0 max)

virtual void SoapySDR::Device::setMasterClockRate ( const double rate )

virtual

Set the master clock rate of the device.

Parameters

rate	the clock rate in Hz

virtual void SoapySDR::Device::setSampleRate	(	const int	direction,
		const size_t	channel,
		const double	rate
	)

virtual

Set the baseband sample rate of the chain.

Parameters

direction	the channel direction RX or TX
channel	an available channel on the device
rate	the sample rate in samples per second

virtual void SoapySDR::Device::setTimeSource ( const std::string & source )

virtual

Set the time source on the device

Parameters

source the name of a time source

virtual Stream* SoapySDR::Device::setupStream	(	const int	direction,
		const std::string &	format,
		const std::vector< size_t > &	channels = `std::vector< size_t >()`,
		const Kwargs &	args = `Kwargs()`
	)

virtual

Initialize a stream given a list of channels and stream arguments. The implementation may change switches or power-up components.

Format string markup guidelines:

C means complex
F means floating point
U means signed integer
S means unsigned integer
number float/int size in bytes (complex is 2x this size)

Example format strings:

CF32 complex float32 (8 bytes per element)
CS16 complex int16 (4 bytes per element)
CS12 complex int12 (3 bytes per element)
CS4 complex int4 (1 byte per element)
S32 int32 (4 bytes per element)
U8 uint8 (1 byte per element)

Recommended keys to use in the args dictionary:

"WIRE" - format of the samples between device and host

Parameters

direction	the channel direction RX or TX
format	the desired buffer format in read/writeStream()
channels	a list of channels for empty for automatic
args	stream args or empty for defaults

Returns: an opaque pointer to a stream handle

virtual unsigned SoapySDR::Device::transactSPI	(	const int	addr,
		const unsigned	data,
		const size_t	numBits
	)

virtual

Perform a SPI transaction and return the result. Its up to the implementation to set the clock rate, and read edge, and the write edge of the SPI core. SPI slaves without a readback pin will return 0.

If the device contains multiple SPI masters, the address bits can encode which master.

Parameters

addr	an address of an available SPI slave
data	the SPI data, numBits-1 is first out
numBits	the number of bits to clock out

Returns: the readback data, numBits-1 is first in

static void SoapySDR::Device::unmake ( Device * device )

static

Unmake or release a device object handle.

Note: This call is not thread safe. Implementations calling into unmake from multiple threads should protect this call with a mutex.

Parameters

device a pointer to a device object

virtual void SoapySDR::Device::writeGPIO	(	const std::string &	bank,
		const unsigned	value
	)

virtual

Write the value of a GPIO bank.

Parameters

bank	the name of an available bank
value	an integer representing GPIO bits

virtual void SoapySDR::Device::writeI2C	(	const int	addr,
		const std::string &	data
	)

virtual

Write to an available I2C slave. If the device contains multiple I2C masters, the address bits can encode which master.

Parameters

addr	the address of the slave
data	an array of bytes write out

virtual void SoapySDR::Device::writeRegister	(	const unsigned	addr,
		const unsigned	value
	)

virtual

Write a register on the device. This can represent a register on a soft CPU, FPGA, IC; the interpretation is up the implementation to decide.

Parameters

addr	the register address
value	the register value

virtual void SoapySDR::Device::writeSetting	(	const std::string &	key,
		const std::string &	value
	)

virtual

Write an arbitrary setting on the device. The interpretation is up the implementation.

Parameters

key	the setting identifier
value	the setting value

virtual int SoapySDR::Device::writeStream	(	Stream *	stream,
		const void const	buffs,
		const size_t	numElems,
		int &	flags,
		const long long	timeNs = `0`,
		const long	timeoutUs = `100000`
	)

virtual

Write elements to a stream for transmission. This is a multi-channel call, and buffs should be an array of void *, where each pointer will be filled with data for a different channel.

Parameters

stream	the opaque pointer to a stream handle
buffs	an array of void* buffers num chans in size
numElems	the number of elements in each buffer
flags	optional input flags and output flags
timeNs	the buffer's timestamp in nanoseconds
timeoutUs	the timeout in microseconds

Returns: the number of elements written per buffer or error

virtual void SoapySDR::Device::writeUART	(	const std::string &	which,
		const std::string &	data
	)

virtual

Write data to a UART device. Its up to the implementation to set the baud rate, carriage return settings, flushing on newline.

Parameters

which	the name of an available UART
data	an array of bytes to write out

The documentation for this class was generated from the following file:

Device.hpp

Public Member Functions

Static Public Member Functions

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation