Builder component of Reference Domain Info objects. Contains setter methods that allow for Reference Domain Info parameter configuration, and a build
method that builds the Reference Domain Info.
More...
Builder component of Reference Domain Info objects. Contains setter methods that allow for Reference Domain Info parameter configuration, and a build
method that builds the Reference Domain Info.
virtual ErrCode INTERFACE_FUNC getReferenceDomainId |
( |
IString ** |
referenceDomainId | ) |
|
|
pure virtual |
Gets the Reference Domain ID.
- Parameters
-
[out] | referenceDomainId | 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.
virtual ErrCode INTERFACE_FUNC getReferenceDomainOffset |
( |
IInteger ** |
referenceDomainOffset | ) |
|
|
pure virtual |
Gets the Reference Domain Offset.
- Parameters
-
[out] | referenceDomainOffset | 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.
virtual ErrCode INTERFACE_FUNC getReferenceTimeSource |
( |
TimeSource * |
referenceTimeSource | ) |
|
|
pure virtual |
Gets the value that indicates the Reference Time Source.
- Parameters
-
[out] | referenceTimeSource | 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).
virtual ErrCode INTERFACE_FUNC setReferenceDomainId |
( |
IString * |
referenceDomainId | ) |
|
|
pure virtual |
Sets the Reference Domain ID.
- Parameters
-
referenceDomainId | 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.
virtual ErrCode INTERFACE_FUNC setReferenceDomainOffset |
( |
IInteger * |
referenceDomainOffset | ) |
|
|
pure virtual |
Sets the Reference Domain Offset.
- Parameters
-
referenceDomainOffset | 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.
virtual ErrCode INTERFACE_FUNC setReferenceTimeSource |
( |
TimeSource |
referenceTimeSource | ) |
|
|
pure virtual |
Sets the value that indicates the Reference Time Source.
- Parameters
-
referenceTimeSource | 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).