Inheritance diagram for RigolFunctionGenerator:

[legend]

Collaboration diagram for RigolFunctionGenerator:

[legend]

Public Member Functions
	RigolFunctionGenerator (SCPITransport *transport)

virtual unsigned int	GetInstrumentTypes () const override
	Returns a bitfield describing the set of instrument types that this instrument supports.

virtual uint32_t	GetInstrumentTypesForChannel (size_t i) const override
	Returns a bitfield describing the set of instrument types that a given channel supports.

virtual bool	AcquireData () override
	Pull data from the instrument.

virtual std::vector< WaveShape >	GetAvailableWaveformShapes (int chan) override
	Query the set of available pre-defined waveforms for this generator.

virtual bool	GetFunctionChannelActive (int chan) override
	Returns true if the function generator channel's output is enabled.

virtual void	SetFunctionChannelActive (int chan, bool on) override
	Turns a function generator channel on or off.

virtual float	GetFunctionChannelDutyCycle (int chan) override
	Gets the duty cycle for a function generator output.

virtual void	SetFunctionChannelDutyCycle (int chan, float duty) override
	Sets the duty cycle for a function generator output.

virtual float	GetFunctionChannelAmplitude (int chan) override
	Gets the amplitude for a function generator output.

virtual void	SetFunctionChannelAmplitude (int chan, float amplitude) override
	Sets the amplitude for a function generator output.

virtual float	GetFunctionChannelOffset (int chan) override
	Gets the DC offset for a function generator output.

virtual void	SetFunctionChannelOffset (int chan, float offset) override
	Sets the DC offset for a function generator output.

virtual float	GetFunctionChannelFrequency (int chan) override
	Gets the frequency for a function generator output.

virtual void	SetFunctionChannelFrequency (int chan, float hz) override
	Sets the frequency for a function generator output.

virtual WaveShape	GetFunctionChannelShape (int chan) override
	Gets the waveform shape for a function generator output.

virtual void	SetFunctionChannelShape (int chan, WaveShape shape) override
	Sets the waveform shape for a function generator output.

virtual bool	HasFunctionRiseFallTimeControls (int chan) override
	Determines if the function generator allows control over rise/fall times.

virtual OutputImpedance	GetFunctionChannelOutputImpedance (int chan) override
	Gets the currently selected output impedance for a function generator output (if supported)

virtual void	SetFunctionChannelOutputImpedance (int chan, OutputImpedance z) override
	Sets the currently selected output impedance for a function generator output (if supported)

Public Member Functions inherited from FunctionGenerator
virtual bool	HasFunctionDutyCycleControls (int chan)
	Determines if the function generator allows control over duty cycles.

virtual float	GetFunctionChannelRiseTime (int chan)
	Gets the rise time for a function generator output (if supported)

virtual void	SetFunctionChannelRiseTime (int chan, float fs)
	Sets the rise time for a function generator output (if supported)

virtual float	GetFunctionChannelFallTime (int chan)
	Gets the fall time for a function generator output (if supported)

virtual void	SetFunctionChannelFallTime (int chan, float fs)
	Sets the fall time for a function generator output (if supported)

virtual bool	HasFunctionImpedanceControls (int chan)
	Determines if the function generator allows control over rise/fall times.

Public Member Functions inherited from Instrument
virtual bool	IsOffline ()
	Checks if the instrument is currently online.

size_t	GetChannelCount () const
	Gets the number of channels (of any type) this instrument has.

InstrumentChannel *	GetChannel (size_t i) const
	Gets a given channel on the instrument.

virtual std::string	GetChannelDisplayName (size_t i)
	Gets the hardware display name for a channel. This is an arbitrary user-selected string.

virtual void	SetChannelDisplayName (size_t i, std::string name)
	Sets the hardware display name for a channel. This is an arbitrary user-selected string.

InstrumentChannel *	GetChannelByDisplayName (const std::string &name)
	Gets a channel given the display name.

InstrumentChannel *	GetChannelByHwName (const std::string &name)
	Gets a channel given the hardware name.

virtual void	FlushConfigCache ()
	Instruments are allowed to cache configuration settings to reduce round trip queries to the device.

virtual YAML::Node	SerializeConfiguration (IDTable &table) const
	Serializes this instrument's configuration to a YAML node.

virtual void	LoadConfiguration (int version, const YAML::Node &node, IDTable &idmap)
	Load instrument and channel configuration from a save file.

virtual void	PreLoadConfiguration (int version, const YAML::Node &node, IDTable &idmap, ConfigWarningList &warnings)
	Parse a limited subset of instrument configuration but do not apply it.

Public Member Functions inherited from SCPIInstrument
	SCPIInstrument (SCPITransport *transport, bool identify=true)

virtual std::string	GetTransportConnectionString () override
	Gets the connection string for our transport.

virtual std::string	GetTransportName () override
	Gets the name of our transport.

virtual std::string	GetName () const override

virtual std::string	GetVendor () const override

virtual std::string	GetSerial () const override

virtual std::string	GetDriverName () const =0

virtual void	BackgroundProcessing () override
	Run various background processing typically done by a second thread (e.g. InstrumentThread)

Public Member Functions inherited from SCPIDevice
	SCPIDevice (SCPITransport *transport, bool identify=true, unsigned int identify_timeout_us=5000000)

	SCPIDevice (const SCPIDevice &rhs)=delete

SCPIDevice &	operator= (const SCPIDevice &rhs)=delete

SCPITransport *	GetTransport () const

Static Public Member Functions
static std::string	GetDriverNameInternal ()

Static Public Member Functions inherited from SCPIFunctionGenerator
static void	DoAddDriverClass (const std::string &name, GeneratorCreateProcType proc)

static void	EnumDrivers (std::vector< std::string > &names)

static std::shared_ptr< SCPIFunctionGenerator >	CreateFunctionGenerator (const std::string &driver, SCPITransport *transport)

Static Public Member Functions inherited from FunctionGenerator
static std::string	GetNameOfShape (WaveShape shape)
	Converts a WaveShape enum to a human readable name.

static WaveShape	GetShapeOfName (const std::string &name)
	Converts a human readable name to a WaveShape.

static std::string	GetNameOfImpedance (OutputImpedance imp)
	Converts an OutputImpedance enum to a human readable name.

static OutputImpedance	GetImpedanceOfName (const std::string &name)
	Converts a human readable name to an OutputImpedance.

Static Public Member Functions inherited from SCPIInstrument
static void	DoAddDriverClass (const std::string &name, GetTransportsProcType proc)

static std::vector< SCPIInstrumentModel >	GetSupportedModels (const std::string &driver)

static std::vector< SCPIInstrumentModel >	GetDriverSupportedModels ()

Protected Attributes
bool	m_cachedFrequencyValid [2]

int64_t	m_cachedFrequency [2]

Protected Attributes inherited from Instrument
std::list< sigc::slot< void(YAML::Node &, IDTable &)> >	m_serializers
	List of methods which need to be called to serialize this node's configuration.

std::list< sigc::slot< void(int, const YAML::Node &, IDTable &)> >	m_loaders
	List of methods which need to be called to deserialize this node's configuration.

std::list< sigc::slot< void(int, const YAML::Node &, IDTable &, ConfigWarningList &)> >	m_preloaders
	List of methods which need to be called to pre-load this node's configuration.

std::vector< InstrumentChannel * >	m_channels
	Set of all channels on this instrument.

Protected Attributes inherited from SCPIDevice
SCPITransport *	m_transport

std::string	m_vendor

std::string	m_model

std::string	m_serial

std::string	m_fwVersion

Additional Inherited Members
Public Types inherited from SCPIFunctionGenerator
typedef std::shared_ptr< SCPIFunctionGenerator >(*	GeneratorCreateProcType) (SCPITransport *)

Public Types inherited from FunctionGenerator
enum	WaveShape { SHAPE_SINE , SHAPE_SQUARE , SHAPE_TRIANGLE , SHAPE_PULSE , SHAPE_DC , SHAPE_NOISE , SHAPE_SAWTOOTH_UP , SHAPE_SAWTOOTH_DOWN , SHAPE_SINC , SHAPE_GAUSSIAN , SHAPE_LORENTZ , SHAPE_HALF_SINE , SHAPE_PRBS_NONSTANDARD , SHAPE_EXPONENTIAL_RISE , SHAPE_EXPONENTIAL_DECAY , SHAPE_HAVERSINE , SHAPE_CARDIAC , SHAPE_STAIRCASE_UP , SHAPE_STAIRCASE_DOWN , SHAPE_STAIRCASE_UP_DOWN , SHAPE_NEGATIVE_PULSE , SHAPE_LOG_RISE , SHAPE_LOG_DECAY , SHAPE_SQUARE_ROOT , SHAPE_CUBE_ROOT , SHAPE_QUADRATIC , SHAPE_CUBIC , SHAPE_DLORENTZ , SHAPE_GAUSSIAN_PULSE , SHAPE_HAMMING , SHAPE_HANNING , SHAPE_KAISER , SHAPE_BLACKMAN , SHAPE_GAUSSIAN_WINDOW , SHAPE_HARRIS , SHAPE_BARTLETT , SHAPE_TAN , SHAPE_COT , SHAPE_SEC , SHAPE_CSC , SHAPE_ASIN , SHAPE_ACOS , SHAPE_ATAN , SHAPE_ACOT , SHAPE_ARB }
	Predefined waveform shapes.

enum	OutputImpedance { IMPEDANCE_HIGH_Z , IMPEDANCE_50_OHM }
	Nominal output impedance for a function generator channel. More...

Public Types inherited from Instrument
enum	InstrumentTypes { INST_OSCILLOSCOPE = 0x01 , INST_DMM = 0x02 , INST_PSU = 0x04 , INST_FUNCTION = 0x08 , INST_RF_GEN = 0x10 , INST_LOAD = 0x20 , INST_BERT = 0x40 , INST_MISC = 0x80 , INST_SWITCH_MATRIX = 0x100 }

Public Types inherited from SCPIInstrument
typedef std::vector< SCPIInstrumentModel >(*	GetTransportsProcType) ()

Public Attributes inherited from Instrument
std::string	m_nickname
	Optional user-selected nickname of the instrument.

Protected Types inherited from SCPIFunctionGenerator
typedef std::map< std::string, GeneratorCreateProcType >	GeneratorCreateMapType

Protected Types inherited from SCPIInstrument
typedef std::map< std::string, GetTransportsProcType >	GetTransportMapType

Protected Member Functions inherited from FunctionGenerator
void	DoSerializeConfiguration (YAML::Node &node, IDTable &table)
	Serializes this instrument's configuration to a YAML node.

void	DoLoadConfiguration (int version, const YAML::Node &node, IDTable &idmap)
	Load instrument and channel configuration from a save file.

void	DoPreLoadConfiguration (int version, const YAML::Node &node, IDTable &idmap, ConfigWarningList &list)
	Validate instrument and channel configuration from a save file.

Protected Member Functions inherited from SCPIInstrument
void	DoSerializeConfiguration (YAML::Node &node, IDTable &table)

Static Protected Attributes inherited from SCPIFunctionGenerator
static GeneratorCreateMapType	m_gencreateprocs

Static Protected Attributes inherited from SCPIInstrument
static GetTransportMapType	m_getTransportProcs

Member Function Documentation

◆ AcquireData()

bool RigolFunctionGenerator::AcquireData ( )

overridevirtual

Pull data from the instrument.

Returns: True if waveform was acquired, false if connection lost or other serious error

Reimplemented from FunctionGenerator.

◆ GetAvailableWaveformShapes()

vector< FunctionGenerator::WaveShape > RigolFunctionGenerator::GetAvailableWaveformShapes ( int chan )

overridevirtual

Query the set of available pre-defined waveforms for this generator.

Parameters

chan	Channel index

Returns: Vector of supported WaveShape's

Implements FunctionGenerator.

◆ GetFunctionChannelActive()

bool RigolFunctionGenerator::GetFunctionChannelActive ( int chan )

overridevirtual

Returns true if the function generator channel's output is enabled.

Parameters

chan	Channel index

Implements FunctionGenerator.

◆ GetFunctionChannelAmplitude()

float RigolFunctionGenerator::GetFunctionChannelAmplitude ( int chan )

overridevirtual

Gets the amplitude for a function generator output.

Parameters

chan	Channel index

Returns: Amplitude, in Vpp

Implements FunctionGenerator.

◆ GetFunctionChannelDutyCycle()

float RigolFunctionGenerator::GetFunctionChannelDutyCycle ( int chan )

overridevirtual

Gets the duty cycle for a function generator output.

Parameters

chan	Channel index

Returns: Duty cycle, in range [0, 1]

Reimplemented from FunctionGenerator.

◆ GetFunctionChannelFrequency()

float RigolFunctionGenerator::GetFunctionChannelFrequency ( int chan )

overridevirtual

Gets the frequency for a function generator output.

Parameters

chan	Channel index

Returns: Frequency, in Hz

Implements FunctionGenerator.

◆ GetFunctionChannelOffset()

float RigolFunctionGenerator::GetFunctionChannelOffset ( int chan )

overridevirtual

Gets the DC offset for a function generator output.

Parameters

chan	Channel index

Returns: Offset, in volts

Implements FunctionGenerator.

◆ GetFunctionChannelOutputImpedance()

FunctionGenerator::OutputImpedance RigolFunctionGenerator::GetFunctionChannelOutputImpedance ( int chan )

overridevirtual

Gets the currently selected output impedance for a function generator output (if supported)

Parameters

chan	Channel index

Returns: Output impedance

Reimplemented from FunctionGenerator.

◆ GetFunctionChannelShape()

FunctionGenerator::WaveShape RigolFunctionGenerator::GetFunctionChannelShape ( int chan )

overridevirtual

Gets the waveform shape for a function generator output.

Parameters

chan	Channel index

Returns: Waveform shape

Implements FunctionGenerator.

◆ GetInstrumentTypes()

unsigned int RigolFunctionGenerator::GetInstrumentTypes ( ) const

overridevirtual

Returns a bitfield describing the set of instrument types that this instrument supports.

Not all types may be available on a given channel.

Implements Instrument.

◆ GetInstrumentTypesForChannel()

uint32_t RigolFunctionGenerator::GetInstrumentTypesForChannel ( size_t i ) const

overridevirtual

Returns a bitfield describing the set of instrument types that a given channel supports.

Parameters

i	Channel index

Implements Instrument.

◆ HasFunctionRiseFallTimeControls()

bool RigolFunctionGenerator::HasFunctionRiseFallTimeControls ( int chan )

overridevirtual

Determines if the function generator allows control over rise/fall times.

If this function returns false, GetFunctionChannelRiseTime() and GetFunctionChannelFallTime() will always return 0, and SetFunctionChannelRiseTime() and SetFunctionChannelFallTime() are no-ops.

Parameters

chan	Channel index

Returns: True if rise/fall time control is available, false if unavailable

Implements FunctionGenerator.

◆ SetFunctionChannelActive()

void RigolFunctionGenerator::SetFunctionChannelActive	(	int	chan,
		bool	on
	)

overridevirtual

Turns a function generator channel on or off.

Parameters

chan	Channel index
on	True to enable output, false to disable

Implements FunctionGenerator.

◆ SetFunctionChannelAmplitude()

void RigolFunctionGenerator::SetFunctionChannelAmplitude	(	int	chan,
		float	amplitude
	)

overridevirtual

Sets the amplitude for a function generator output.

Parameters

chan	Channel index
amplitude	Output amplitude, in Vpp

Implements FunctionGenerator.

◆ SetFunctionChannelDutyCycle()

void RigolFunctionGenerator::SetFunctionChannelDutyCycle	(	int	chan,
		float	duty
	)

overridevirtual

Sets the duty cycle for a function generator output.

Parameters

chan	Channel index
duty	Duty cycle, in range [0, 1]

Reimplemented from FunctionGenerator.

◆ SetFunctionChannelFrequency()

void RigolFunctionGenerator::SetFunctionChannelFrequency	(	int	chan,
		float	hz
	)

overridevirtual

Sets the frequency for a function generator output.

Parameters

chan	Channel index
hz	Frequency, in Hz

Implements FunctionGenerator.

◆ SetFunctionChannelOffset()

void RigolFunctionGenerator::SetFunctionChannelOffset	(	int	chan,
		float	offset
	)

overridevirtual

Sets the DC offset for a function generator output.

Parameters

chan	Channel index
amplitude	Offset, in volts

Implements FunctionGenerator.

◆ SetFunctionChannelOutputImpedance()

void RigolFunctionGenerator::SetFunctionChannelOutputImpedance	(	int	chan,
		FunctionGenerator::OutputImpedance	z
	)

overridevirtual

Sets the currently selected output impedance for a function generator output (if supported)

Parameters

chan	Channel index
z	Output impedance

Reimplemented from FunctionGenerator.

◆ SetFunctionChannelShape()

void RigolFunctionGenerator::SetFunctionChannelShape	(	int	chan,
		WaveShape	shape
	)

overridevirtual

Sets the waveform shape for a function generator output.

Parameters

chan	Channel index
shape	Desired output waveform

Implements FunctionGenerator.

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

lib/scopehal/RigolFunctionGenerator.h
lib/scopehal/RigolFunctionGenerator.cpp

Public Member Functions

Static Public Member Functions

Protected Attributes

Additional Inherited Members

Member Function Documentation

◆ AcquireData()

◆ GetAvailableWaveformShapes()

◆ GetFunctionChannelActive()

◆ GetFunctionChannelAmplitude()

◆ GetFunctionChannelDutyCycle()

◆ GetFunctionChannelFrequency()

◆ GetFunctionChannelOffset()

◆ GetFunctionChannelOutputImpedance()

◆ GetFunctionChannelShape()

◆ GetInstrumentTypes()

◆ GetInstrumentTypesForChannel()

◆ HasFunctionRiseFallTimeControls()

◆ SetFunctionChannelActive()

◆ SetFunctionChannelAmplitude()

◆ SetFunctionChannelDutyCycle()

◆ SetFunctionChannelFrequency()

◆ SetFunctionChannelOffset()

◆ SetFunctionChannelOutputImpedance()

◆ SetFunctionChannelShape()