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
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 polarity | If 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 pulses | This 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 seconds | This 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 overflow | A 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 output | This 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
HSIn | This signal is the input lines. If the port width is larger than one, the signal MSBs are disregarded. |
---|---|
Sync | This signal is the synchronization pulse train. It is generally connected to the ModelSync signal. |
Enable | This enable signal allows the developer to enable/disable the on-time incrementation. |
PulseMinWidth | This 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). |
Polarity | This 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
TOn | This signal is the 14-bit wide Time-On value, corresponding to the total on time, in clock ticks. |
---|---|
Status | This 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. |
Error | This 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:
|
Characteristics and Limitations
This block has no special characteristics.
Direct Feedthrough | N/A |
---|---|
Discrete sample time | N/A |
XHP support | N/A |
Work offline | YES |
OPAL-RT TECHNOLOGIES, Inc. | 1751, rue Richardson, bureau 1060 | Montréal, Québec Canada H3K 1G6 | opal-rt.com | +1 514-935-2323
Follow OPAL-RT: LinkedIn | Facebook | YouTube | X/Twitter