Documentation Home Page RT-XSG Toolbox Home Page
Pour la documentation en FRANÇAIS, utilisez l'outil de traduction de votre navigateur Chrome, Edge ou Safari. Voir un exemple.

TOM

Block

Block

Mask

Mask

Description

The Averaged time-on digital input block computes the total on time of a digital signal between two synchronization pulses. The user can specify the polarity of the signal and can add a filter to disregard pulses narrower than a specific threshold.

Parameters

Signal polarityIf the developer chose to specify the polarity as a block parameter, this entry is made available. The value entered should be a binary number that corresponds to the polarity of the input lines. A 0 for this parameter means that the signal is active-low, which means that a Low output voltage is generated for a 1 and a High input voltage is generated for 0. A 1 for this parameter means that the signal is active-high (default), which means that a Low input voltage is generated for a 0 and a High input voltage is generated for a 1.
Enable digital filtering of pulsesThis parameter is used by the developer to enable (default) or disable digital filtering of narrow pulses on the input lines. The digital filter annihilates the effect of glitches on the line but induces a delay equal to the pulse minimum width.
Pulse minimum width is set...This parameter is available only if the digital filtering of narrow pulses is activated. It determines the mean by which the pulse minimum width is provided to the digital filters. It can be furnished either from a block input port of by a block parameter.
Pulse minimum width, in secondsThis parameter is available only if the digital filtering of narrow pulses is activated and the developer has chosen to provide the pulse minimum width by a block parameter. The value corresponds to the pulse minimum width, in seconds (e.g. 100e-9 = 100 nanoseconds, i.e. 10 clock cycles), between 0 and 10.23e-6 seconds.
Generate error on time-on overflowA time-on overflow occurs if the on-time exceeds the capacity of a counter under the mask of this block. This capacity has been set to 160 microseconds.
Add the digital input logic level as a Status outputThis option, when selected, adds an output port to the block that gives the logic level of the input at the end of the preceding time step.

Inputs

HSInThis signal is the input lines. If the port width is larger than one, the signal MSBs are disregarded.
SyncThis signal is the synchronization pulse train. It is generally connected to the ModelSync signal.
EnableThis enable signal allows the developer to enable/disable the on-time incrementation.
PulseMinWidthThis port is available only if the digital filtering of the pulses is enabled and if the developer has chosen to provide the pulse minimum width from a block input port. The number should be set as an integer number of 10-ns clock periods, between 0 and 1023).
PolarityThis port is available only if the developer has chosen to provide the signal polarity from a block input port. The value corresponds to the polarity of the input lines. A 0 for this parameter means that the signal is active-low, which means that a Low input voltage is interpreted as a 1 and a High input voltage is interpreted as a 0. A 1 for this parameter means that the signal is active-high (default), which means that a Low input voltage is interpreted as a 0 and a High input voltage is interpreted as a 1.

Outputs

TOnThis signal is the 14-bit wide Time-On value, corresponding to the total on time, in clock ticks.
StatusThis output port gives the logic level of the input at the end of the preceding time step and is available only if the corresponding option is selected in the mask parameter window.
ErrorThis output port is the error flag and is available only upon request from the corresponding mask parameter.
ErrorCode

This output port gives the error code associated with any error signaled by the Error output port. The codes are the following: 

  • Error code 1
  • Description Time-on overflow

Characteristics and Limitations

This block has no special characteristics.

Direct FeedthroughN/A
Discrete sample timeN/A
XHP supportN/A
Work offlineYES

OPAL-RT TECHNOLOGIES, Inc. | 1751, rue Richardson, bureau 1060 | Montréal, Québec Canada H3K 1G6 | opal-rt.com | +1 514-935-2323