Interface to the main class of the software-based GigE Vision Device. More...

#include <PvSoftDeviceGEVInterfaces.h>

Public Member Functions
virtual	~IPvSoftDeviceGEV ()
	Virtual destructor.

virtual PvResult	AddStream (IPvStreamingChannelSource *aSource)=0
	Adds a new stream to the PvSoftDeviceGEV. More...

virtual PvResult	SetUserSetCount (uint32_t aCount)=0
	Sets the number of user-sets supported by the PvSoftDeviceGEV. More...

virtual PvResult	SetUserSetNotify (IPvUserSetNotify *aUserSetNotify)=0
	Binds in a class which will contain a callback which will be called when the state of a UsersetLoad/Save changes. More...

virtual PvResult	SetTCPTransportEnabled (bool aEnabled)=0
	Enables experimental TCP transport. More...

virtual PvResult	SetRTPProtocolEnabled (bool aEnabled)=0
	Enables the option of using RTP for streaming. More...

virtual PvResult	SetActionHandler (PvVirtualDeviceLib::IActionHandler *aActionHandler)=0

virtual PvResult	RegisterEventSink (IPvSoftDeviceGEVEventSink *aEventSink)=0
	Registers an event sink to receive notifications from the PvSoftDeviceGEV. More...

virtual PvResult	UnregisterEventSink (IPvSoftDeviceGEVEventSink *aEventSink)=0
	Unregisters a previously registered event sink. More...

virtual PvResult	Start (const PvString &aIpAddress)=0
	Starts the PvSoftDeviceGEV. More...

virtual PvResult	Stop ()=0
	Stops the PvSoftDeviceGEV. More...

virtual IPvSoftDeviceGEVInfo *	GetInfo ()=0
	Obtains the information interface of the PvSoftDeviceGEV. More...

virtual IPvRegisterMap *	GetRegisterMap ()=0
	Obtains the register map interface of the PvSoftDeviceGEV. More...

virtual IPvSoftDeviceGEVStatistics *	GetStatistics ()=0
	Obtains the statistics interface of the PvSoftDeviceGEV. More...

virtual IPvMessageChannel *	GetMessagingChannel ()=0
	Obtains the messaging channel interface of the PvSoftDeviceGEV. More...

virtual PvResult	GetGenICamXMLFile (PvString &aString) const =0
	Returns the GenICam XML file of the device. More...

Detailed Description

Interface to the main class of the software-based GigE Vision Device.

Member Function Documentation

◆ AddStream()

virtual PvResult IPvSoftDeviceGEV::AddStream ( IPvStreamingChannelSource * aSource )

pure virtual

Adds a new stream to the PvSoftDeviceGEV.

All streams must be added before starting the PvSoftDeviceGEV.

Parameters

[in] aSource Interface to a user-provided source.

Returns

Includes:

PvResult::Code::OK on success.
PvResult::Code::INVALID_PARAMETER if aSource is NULL.
PvResult::Code::STATE_ERROR if the PvSoftDeviceGEV is already running.
PvResult::Code::NOT_SUPPORTED if the maximum stream count has already been reached.

Implemented in PvSoftDeviceGEV.

◆ GetGenICamXMLFile()

virtual PvResult IPvSoftDeviceGEV::GetGenICamXMLFile ( PvString & aString ) const

pure virtual

Returns the GenICam XML file of the device.

Can be used to retrieve the GenICam XML file of the device after the Start method has been called. Can be used on success or failure of the Start method.

Parameters

aString [out] String where the XML file is copied.

Returns

Includes:

PvResult::Code::OK on success
PvResult::Code::STATE_ERROR if the GenICam XML file is not available (likely Start has not been called yet)

Implemented in PvSoftDeviceGEV.

◆ GetInfo()

virtual IPvSoftDeviceGEVInfo* IPvSoftDeviceGEV::GetInfo ( )

pure virtual

Obtains the information interface of the PvSoftDeviceGEV.

Only available after the PvSoftDeviceGEV has been started.

IPvSoftDeviceGEVInfo is used to set the information strings in the read-only bootstrap registers of the PvSoftDeviceGEV, such as Model Name, Vendor Name, etc.

Returns: Information interface of the PvSoftDeviceGEV or NULL if the device is not running.

Implemented in PvSoftDeviceGEV.

◆ GetMessagingChannel()

virtual IPvMessageChannel* IPvSoftDeviceGEV::GetMessagingChannel ( )

pure virtual

Obtains the messaging channel interface of the PvSoftDeviceGEV.

The IPvMessageChannel interface can be used to send events on the messaging channel when a GigE Vision controller is connected to the PvSoftDeviceGEV and has properly set up a destination for messaging channel events.

See also: IPvMessageChannel

Only available after the PvSoftDeviceGEV has been started.

Returns: Messaging channel interface of the PvSoftDeviceGEV or NULL if the device is not running.

Implemented in PvSoftDeviceGEV.

◆ GetRegisterMap()

virtual IPvRegisterMap* IPvSoftDeviceGEV::GetRegisterMap ( )

pure virtual

Obtains the register map interface of the PvSoftDeviceGEV.

Only available after the PvSoftDeviceGEV has been started.

IPvRegisterMap can be used to directly access the register map of the PvSoftDeviceGEV. It is also possible to subscribe to register read/write events using IPvSoftDeviceGEVEventSink.

See IPvSoftDeviceGEVEventSink::OnCreateCustomRegisters for information about adding custom registers to a PvSoftDeviceGEV.

Returns: Register map interface of the PvSoftDeviceGEV or NULL if the device is not running.

Implemented in PvSoftDeviceGEV.

◆ GetStatistics()

virtual IPvSoftDeviceGEVStatistics* IPvSoftDeviceGEV::GetStatistics ( )

pure virtual

Obtains the statistics interface of the PvSoftDeviceGEV.

Only available after the PvSoftDeviceGEV has been started.

Returns: Statistics interface of the PvSoftDeviceGEV or NULL if the device is not running.

Implemented in PvSoftDeviceGEV.

◆ RegisterEventSink()

virtual PvResult IPvSoftDeviceGEV::RegisterEventSink ( IPvSoftDeviceGEVEventSink * aEventSink )

pure virtual

Registers an event sink to receive notifications from the PvSoftDeviceGEV.

This method can be called before the PvSoftDeviceGEV is started.

See also: IPvVirtualDeviceEventSink

Parameters

[in] aEventSink Pointer to a PvSoftDeviceGEV event sink.

Returns

Includes:

PvResult::Code::OK on success.
PvResult::Code::INVALID_PARAMETER if aEventSink is NULL or already registered.

Implemented in PvSoftDeviceGEV.

◆ SetActionHandler()

virtual PvResult IPvSoftDeviceGEV::SetActionHandler ( PvVirtualDeviceLib::IActionHandler * aActionHandler )

pure virtual

Returns: PvResult.

Implemented in PvSoftDeviceGEV.

◆ SetRTPProtocolEnabled()

virtual PvResult IPvSoftDeviceGEV::SetRTPProtocolEnabled ( bool aEnabled )

pure virtual

Enables the option of using RTP for streaming.

PvSoftDeviceGEV supports optional RTP protocol for GigE Vision devices.

When RTP is enabled it can be selected as the protocol used to data transmission at the stream channel level of the GenApi interface of the device.

RTP supported is not covered by the GigE Vision specification. A GigE Vision Device actively streaming using RTP goes beyond the bounds covered by the GigE Vision standard.

The RTP implementation is however compliant with the RTP RFCs covering the transport of images (RFC 4175) and H.264 data (RFC 6184).

When a stream transmits using the RTP protocol, the stream is announced on a multicast channel (224.2.127.254:9875) using the SAP protocol with a SDP descriptor as required by the DEFSTAN 0082 specification.

Parameters

[in] aEnabled Toggles RTP support.

Returns: PvResult::Code::OK

Implemented in PvSoftDeviceGEV.

◆ SetTCPTransportEnabled()

virtual PvResult IPvSoftDeviceGEV::SetTCPTransportEnabled ( bool aEnabled )

pure virtual

Enables experimental TCP transport.

PvSoftDeviceGEV supports optional, experimental TCP transport for GigE Vision devices. It affects GVCP control, GVCP messaging channel and GVSP streaming.

When TCP is enabled the device still respond to UDP requests as usual. Additional TCP sockets are opened to optionally accept TCP connections from the host.

As long as TCP is not fully ratified by the GigE Vision specification, enabling TCP could and most likely will break GigE Vision compliance. It also means only the eBUS PvDeviceGEV and PvStreamGEV can be used to interact with the device when using TCP transport.

Parameters

[in] aEnabled Toggles TCP support.

Returns: PvResult::Code::OK

Implemented in PvSoftDeviceGEV.

◆ SetUserSetCount()

virtual PvResult IPvSoftDeviceGEV::SetUserSetCount ( uint32_t aCount )

pure virtual

Sets the number of user-sets supported by the PvSoftDeviceGEV.

The maximum supported user-set count is 256.

Can only be changed before starting the device.

User-sets are all about device-side persistence. The status of the device can be saved or retrieved from some static store on the device. User-sets are first and foremost managed at the register level. The SFNC allowing defines the UserSetFeatureSelector which is populated with feature names. This creates an imperfect but mostly acceptable one-to-one link between Streamable (persistent) GenApi features and the register providing its implementation.

Features marked as Streamable (persistent) when creating the GenICam XML file of the device are used for device-side persistence through user-sets.

Persistent features have the content of the register they directly map to saved to the persistent store of the device. The persistent store is implemented through the Registry on Windows and profile home files on Linux. Hardware implementations could rely on Flash memory to store user-sets.

Most registers are simply persisted as-is: their binary content is simply saved to or loaded from the store.

Some registers have only one address but can contain many values when indexed through device-managed selectors. If those registers are Streamable (persistent) the application must handle the IPvRegisterEventSink::Persist event for the registers and for each possible selector combination call IPvRegisterStore::Persist. For the application the same code is used for both save and load operations, thus the generic "persist" naming.

The SoftDeviceGEV sample shows basic use of user-sets.

The SoftDeviceGEV3d sample shows how to handle complex multi-selector registers in the context of user-sets.*‍/

Selected registers handling in pseudo-code:

Save current selector of interest values
Set selectors to 1st combination
Call IPvRegisterStore::Persist with register and unique name suffix representing selector of interest values
Set selectors to 2nd combination
Call IPvRegisterStore::Persist with register and unique name suffix representing selector of interest values
...
Restore selector values

The IPvRegisterStore::Persist method loads or saves the register content in the store using the feature name and provided suffix.

On startup the default user-set is always updated in the store from the fresh device status. If the UserSetDefault GenApi feature is assigned to a user-set other than Default, the user-set is automatically loaded on device startup.

The UserSetDefault GenApi feature is special: it is not saved to a user-set but is immediately and automatically persistent to the store whenever changed.

User-sets can be saved and loaded explicitly using the UserSetSelector, UserSetSave, and UserSetLoad GenApi features.

The UserSetFeatureSelector and UserSetFeatureEnable GenApi features can be used to control which features are saved to the user-sets. All features defined as Streamable when creating the GenICam XML file of the device should be available under the UserSetFeatureSelector enum feature.

Parameters

[in] aCount Count of user-sets supported, in addition to the default user-set.

Returns

Includes:

PvResult::Code::OK on success.
PvResult::Code::INVALID_PARAMETER if aSource is greather than the maximum user-set count.
PvResult::Code::STATE_ERROR if the PvSoftDeviceGEV is already running.

Implemented in PvSoftDeviceGEV.

◆ SetUserSetNotify()

virtual PvResult IPvSoftDeviceGEV::SetUserSetNotify ( IPvUserSetNotify * aUserSetNotify )

pure virtual

Binds in a class which will contain a callback which will be called when the state of a UsersetLoad/Save changes.

Returns

Includes

PvResult::Code::OK on success

Implemented in PvSoftDeviceGEV.

◆ Start()

virtual PvResult IPvSoftDeviceGEV::Start ( const PvString & aIpAddress )

pure virtual

Starts the PvSoftDeviceGEV.

Both GVCP and GVSP are operated from a background thread. Even though the Start method returns, the device is running in your process until you call Stop or until the object is destroyed.

Parameters

[in] aMACAddress MAC address of the interface to bind the PvSoftDeviceGEV to.

Returns

Includes:

PvResult::Code::OK on success.
PvResult::Code::STATE_ERROR if the PvSoftDeviceGEV is already running.
PvResult::Code::INVALID_PARAMETER if the MAC address is not valid.

Implemented in PvSoftDeviceGEV.

◆ Stop()

virtual PvResult IPvSoftDeviceGEV::Stop ( )

pure virtual

Stops the PvSoftDeviceGEV.

Returns

Includes:

PvResult::Code::OK on success.
PvResult::Code::STATE_ERROR if the PvSoftDeviceGEV is not running.

Implemented in PvSoftDeviceGEV.

◆ UnregisterEventSink()

virtual PvResult IPvSoftDeviceGEV::UnregisterEventSink ( IPvSoftDeviceGEVEventSink * aEventSink )

pure virtual

Unregisters a previously registered event sink.

This method can be called before the PvSoftDeviceGEV is started and after it has been stopped.

Parameters

[in] aEventSink Pointer to a PvSoftDeviceGEV event sink.

Returns

Includes:

PvResult::Code::OK on success.
PvResult::Code::INVALID_PARAMETER if aEventSink is NULL.

Implemented in PvSoftDeviceGEV.

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

PvSoftDeviceGEVInterfaces.h

eBUS SDK v6.4.0.6670 API

Public Member Functions

Detailed Description

Member Function Documentation

◆ AddStream()

◆ GetGenICamXMLFile()

◆ GetInfo()

◆ GetMessagingChannel()

◆ GetRegisterMap()

◆ GetStatistics()

◆ RegisterEventSink()

◆ SetActionHandler()

◆ SetRTPProtocolEnabled()

◆ SetTCPTransportEnabled()

◆ SetUserSetCount()

◆ SetUserSetNotify()

◆ Start()

◆ Stop()

◆ UnregisterEventSink()