Base class for triggers involving hardware clock/data recovery pattern matching. More...

#include <CDRTrigger.h>

Inheritance diagram for CDRTrigger:

[legend]

Collaboration diagram for CDRTrigger:

[legend]

Public Types
enum	LeCroyEqualizerMode { LECROY_EQ_NONE , LECROY_EQ_LOW , LECROY_EQ_MEDIUM , LECROY_EQ_HIGH }
	RX equalizer settings for LeCroy SDA 8Zi GTX trigger board. More...

enum	TriggerPosition { POSITION_END , POSITION_START }
	Where to position the reported trigger point, relative to the serial bit pattern. More...

enum	Polarity { POLARITY_NORMAL , POLARITY_INVERTED }
	Polarity inversion for the input. More...

Public Types inherited from Trigger
enum	Condition { CONDITION_EQUAL , CONDITION_NOT_EQUAL , CONDITION_LESS , CONDITION_LESS_OR_EQUAL , CONDITION_GREATER , CONDITION_GREATER_OR_EQUAL , CONDITION_BETWEEN , CONDITION_NOT_BETWEEN , CONDITION_ANY }
	Conditions for triggers that perform logical comparisons of values. More...

typedef Trigger (	CreateProcType) (Oscilloscope *)

Public Types inherited from FlowGraphNode
enum	DataLocation { LOC_CPU , LOC_GPU , LOC_DONTCARE }

typedef std::map< std::string, FilterParameter >	ParameterMapType
	Short name for a map of strings to parameters.

Public Member Functions
	CDRTrigger (Oscilloscope *scope)
	Creates a new CDR trigger. More...

virtual bool	ValidateChannel (size_t i, StreamDescriptor stream)

void	SetBitRate (int64_t rate)
	Sets the nominal baud rate the PLL should attempt to lock to. More...

int64_t	GetBitRate ()
	Returns the nominal CDR PLL data rate.

void	CalculateBitRate ()
	Automatically calculates the bit rate of the incoming signal, if possible.

sigc::signal< void()>	signal_calculateBitRate ()
	Signal emitted every time autobaud is requested.

bool	IsAutomaticBitRateCalculationAvailable ()
	Checks if automatic bit rate calculation is available. More...

bool	IsCDRLocked ()
	Queries hardware PLL lock status. More...

const std::string	GetBitRateName ()
	Gets the name of the bit rate parameter.

TriggerPosition	GetTriggerPosition ()
	Gets the position of the trigger, relative to the serial bit pattern.

void	SetTriggerPosition (TriggerPosition p)
	Sets the position of the trigger, relative to the serial bit pattern. More...

LeCroyEqualizerMode	GetEqualizerMode ()
	Gets the RX equalizer mode. More...

void	SetEqualizerMode (LeCroyEqualizerMode mode)
	Sets the RX equalizer mode. More...

Polarity	GetPolarity ()
	Gets the polarity inversion.

void	SetPolarity (Polarity mode)
	Gets the polarity inversion. More...

Public Member Functions inherited from Trigger
	Trigger (Oscilloscope *scope)
	Initialize a new trigger. More...

float	GetLevel ()
	Get the trigger level.

void	SetLevel (float level)
	Sets the trigger level. More...

Oscilloscope *	GetScope ()
	Gets the scope this trigger is attached to.

virtual std::string	GetTriggerDisplayName ()=0

virtual YAML::Node	SerializeConfiguration (IDTable &table) override
	Serializes this trigger's configuration to a YAML string. More...

Public Member Functions inherited from FlowGraphNode
void	DetachInputs ()
	Disconnects all inputs from the node without releasing them. More...

size_t	GetInputCount ()

std::string	GetInputName (size_t i)

void	SetInput (size_t i, StreamDescriptor stream, bool force=false)
	Connects a stream to the input of this node. More...

void	SetInput (const std::string &name, StreamDescriptor stream, bool force=false)

virtual bool	ValidateChannel (size_t i, StreamDescriptor stream)

StreamDescriptor	GetInput (size_t i)
	Gets the descriptor for one of our inputs.

FilterParameter &	GetParameter (std::string s)

bool	HasParameter (std::string s)
	Checks if we have a parameter with a given name. More...

ParameterMapType::iterator	GetParamBegin ()
	Returns an iterator to the beginning of our parameter map.

ParameterMapType::iterator	GetParamEnd ()
	Returns an iterator to the end of our parameter map.

size_t	GetParamCount ()
	Returns the number of parameter we have.

virtual YAML::Node	SerializeConfiguration (IDTable &table)
	Serializes this trigger's configuration to a YAML string. More...

virtual void	LoadParameters (const YAML::Node &node, IDTable &table)
	Load configuration from a save file. More...

virtual void	LoadInputs (const YAML::Node &node, IDTable &table)

bool	IsDownstreamOf (std::set< FlowGraphNode * > nodes)
	Determines if this node is downstream of any of the specified other nodes. More...

virtual DataLocation	GetInputLocation ()
	Gets the desired location of the nodes's input data. More...

virtual void	Refresh ()
	Evaluates a filter graph node. More...

virtual void	Refresh (vk::raii::CommandBuffer &cmdBuf, std::shared_ptr< QueueHandle > queue)

sigc::signal< void()>	signal_parametersChanged ()

sigc::signal< void()>	signal_inputsChanged ()

Protected Attributes
std::string	m_bitRateName
	Name of the bit rate parameter.

std::string	m_positionName
	Name of the trigger position parameter.

std::string	m_lecroyEqName
	Name of the equalizer mode parameter.

std::string	m_polarityName
	Name of the polarity inversion parameter.

sigc::signal< void()>	m_calculateBitRateSignal
	Signal requesting an auto-baud calculation.

Protected Attributes inherited from Trigger
Oscilloscope *	m_scope
	The scope this trigger is part of.

FilterParameter &	m_level
	"Trigger level" parameter

Protected Attributes inherited from FlowGraphNode
std::vector< std::string >	m_signalNames
	Names of signals we take as input.

std::vector< StreamDescriptor >	m_inputs
	The channel (if any) connected to each of our inputs.

ParameterMapType	m_parameters

sigc::signal< void()>	m_parametersChangedSignal
	Signal emitted when the set of parameters changes.

sigc::signal< void()>	m_inputsChangedSignal
	Signal emitted when the set of inputs changes.

Additional Inherited Members
Static Public Member Functions inherited from Trigger
static void	DoAddTriggerClass (std::string name, CreateProcType proc)
	Register a new trigger class for dynamic creation. More...

static void	EnumTriggers (std::vector< std::string > &names)
	Gets a list of all registered trigger types. More...

static Trigger *	CreateTrigger (std::string name, Oscilloscope *scope)
	Creates a new trigger for an oscilloscope. More...

Protected Types inherited from Trigger
typedef std::map< std::string, CreateProcType >	CreateMapType
	Helper typedef for m_createprocs.

Protected Member Functions inherited from FlowGraphNode
virtual void	OnInputChanged (size_t i)
	Called when a new input is connected to the node. More...

WaveformBase *	GetInputWaveform (size_t i)
	Gets the waveform attached to the specified input. More...

SparseAnalogWaveform *	GetSparseAnalogInputWaveform (size_t i)
	Gets the analog waveform attached to the specified input.

UniformAnalogWaveform *	GetUniformAnalogInputWaveform (size_t i)
	Gets the analog waveform attached to the specified input.

SparseDigitalWaveform *	GetSparseDigitalInputWaveform (size_t i)
	Gets the digital waveform attached to the specified input.

UniformDigitalWaveform *	GetUniformDigitalInputWaveform (size_t i)
	Gets the digital waveform attached to the specified input.

SparseDigitalBusWaveform *	GetSparseDigitalBusInputWaveform (size_t i)
	Gets the digital bus waveform attached to the specified input.

void	CreateInput (const std::string &name)
	Creates and names an input signal.

std::string	GetInputDisplayName (size_t i)
	Gets the display name for one of our inputs. More...

Static Protected Attributes inherited from Trigger
static CreateMapType	m_createprocs
	Map of trigger type names to factory methods.

Detailed Description

Base class for triggers involving hardware clock/data recovery pattern matching.

Member Enumeration Documentation

◆ LeCroyEqualizerMode

enum CDRTrigger::LeCroyEqualizerMode

RX equalizer settings for LeCroy SDA 8Zi GTX trigger board.

TODO: we should refactor this to be more generic

Enumerator
LECROY_EQ_NONE	No equalization.
LECROY_EQ_LOW	2 dB boost
LECROY_EQ_MEDIUM	5 dB boost
LECROY_EQ_HIGH	9 dB boost

◆ Polarity

enum CDRTrigger::Polarity

Polarity inversion for the input.

Enumerator

POLARITY_NORMAL

Parameters

Input signal is positive polarity

POLARITY_INVERTED

Parameters

Input signal is negated

◆ TriggerPosition

enum CDRTrigger::TriggerPosition

Where to position the reported trigger point, relative to the serial bit pattern.

Enumerator
POSITION_END	Trigger is reported at the end of the pattern.
POSITION_START	Trigger is reported at the start of the pattern.

Constructor & Destructor Documentation

◆ CDRTrigger()

CDRTrigger::CDRTrigger ( Oscilloscope * scope )

Creates a new CDR trigger.

Parameters

scope The scope the trigger is to be created for

Member Function Documentation

◆ GetEqualizerMode()

LeCroyEqualizerMode CDRTrigger::GetEqualizerMode ( )

inline

Gets the RX equalizer mode.

TODO: we should refactor this to be more generic

◆ IsAutomaticBitRateCalculationAvailable()

bool CDRTrigger::IsAutomaticBitRateCalculationAvailable ( )

Checks if automatic bit rate calculation is available.

Checks whether automatic bit rate calculation is available on this trigger.

The current implementation assumes any LeCroyOscilloscope with a CDR trigger board has auto-baud capability, and nothing else does.

◆ IsCDRLocked()

bool CDRTrigger::IsCDRLocked ( )

Queries hardware PLL lock status.

Checks whether the hardware clock recovery PLL is locked.

◆ SetBitRate()

void CDRTrigger::SetBitRate ( int64_t rate )

inline

Sets the nominal baud rate the PLL should attempt to lock to.

Parameters

rate	The baud rate, in Hz

◆ SetEqualizerMode()

void CDRTrigger::SetEqualizerMode ( LeCroyEqualizerMode mode )

inline

Sets the RX equalizer mode.

TODO: we should refactor this to be more generic

◆ SetPolarity()

void CDRTrigger::SetPolarity ( Polarity mode )

inline

Gets the polarity inversion.

Parameters

mode	Polarity inversion mode

◆ SetTriggerPosition()

void CDRTrigger::SetTriggerPosition ( TriggerPosition p )

inline

Sets the position of the trigger, relative to the serial bit pattern.

Parameters

p	Desired trigger position (start or end)

◆ ValidateChannel()

bool CDRTrigger::ValidateChannel	(	size_t	i,
		StreamDescriptor	stream
	)

virtual

Reimplemented from FlowGraphNode.

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

lib/scopehal/CDRTrigger.h
lib/scopehal/CDRTrigger.cpp

Public Types

Public Member Functions

Protected Attributes

Additional Inherited Members

Detailed Description

Member Enumeration Documentation

◆ LeCroyEqualizerMode

◆ Polarity

◆ TriggerPosition

Constructor & Destructor Documentation

◆ CDRTrigger()

Member Function Documentation

◆ GetEqualizerMode()

◆ IsAutomaticBitRateCalculationAvailable()

◆ IsCDRLocked()

◆ SetBitRate()

◆ SetEqualizerMode()

◆ SetPolarity()

◆ SetTriggerPosition()

◆ ValidateChannel()