ReferenceDomainInfoPtr Class Reference

If set, gives additional information about the reference domain. More...

Inherits ObjectPtr< IReferenceDomainInfo >.

Detailed Description

If set, gives additional information about the reference domain.

Public Member Functions
daq::StringPtr	getReferenceDomainId () const
	Gets the Reference Domain ID. More...
daq::IntegerPtr	getReferenceDomainOffset () const
	Gets the Reference Domain Offset. More...
daq::TimeSource	getReferenceTimeSource () const
	Gets the value that indicates the Reference Time Source. More...
daq::UsesOffset	getUsesOffset () const
	Gets the value that indicates if offset is used. More...

Member Function Documentation

getReferenceDomainId()

daq::StringPtr getReferenceDomainId ( ) const

inline

Gets the Reference Domain ID.

Returns

The Reference Domain ID.

If set, gives the common identifier of one domain group. Signals with the same Reference Domain ID share a common synchronization source (all the signals in a group either come from the same device or are synchronized using a protocol, such as PTP, NTP, IRIG, etc.). Those signals can always be read together, implying that a Multi Reader can be used to read the signals if their sampling rates are compatible.

getReferenceDomainOffset()

daq::IntegerPtr getReferenceDomainOffset ( ) const

inline

Gets the Reference Domain Offset.

Returns

The Reference Domain Offset.

If set, denotes the offset in ticks that must be added to the domain values of the signal for them to be equal to that of the sync source. The sync source will always have an offset of 0. This offset is changed only if the sync source changes and should be kept at 0 otherwise, allowing clients to differentiate between data loss and resync events. Any device can choose to always keep the offset at 0, representing changes in the offset in the domain packet values instead. This implementation prevents clients from differentiating between errors (data loss) and resync events. Additionally, if the offset is not configured, clients have no way of detecting a resync event in the case of asynchronous signals.

getReferenceTimeSource()

daq::TimeSource getReferenceTimeSource ( ) const

inline

Gets the value that indicates the Reference Time Source.

Returns

The value that indicates the Reference Time Source.

If not set to Unknown, the domain quantity is “time”, and the timestamps are absolute according to the chosen time standard. The possible values are Gps, Tai, and Utc. This field is used to determine if two signals with different Domain IDs can be read together. Signals that have configured a Reference Time Source are trusted to have absolute time stamps that correlate to the chosen time standard (eg. two separate PTP networks, both driven through GPS can be read together, as their absolute time is the same).

getUsesOffset()

daq::UsesOffset getUsesOffset ( ) const

inline

Gets the value that indicates if offset is used.

Returns

The value that indicates if offset is used.

If False, a device will contain time jumps due to resync in the domain signal data.