Configures a new watchdog object with a timeout and expiration actions.

Note Configuring a watchdog object does not start the watchdog counter. Use the Watchdog Start VI or the Watchdog Whack VI to start the watchdog counter.


icon

Inputs/Outputs

  • cdbl.png timeout (1 sec) —

    timeout specifies the time, in seconds, that the function waits before the watchdog timer expires.

    The timeout period is coerced to a value determined from the available timebase and initial count values. The default is 1 second.

  • ccclst.png expiration actions —

    expiration actions specifies which actions to take when the watchdog timer expires. You can use any combination of actions. However, not all targets support all actions. Refer to the specific RT target hardware documentation for information about supported actions.

  • cbool.png reset system —

    reset system reboots the PXI controller.

  • cbool.png restart LabVIEW Runtime —

    restart LabVIEW Runtime restarts only the LabVIEW Real-Time Runtime. When restart LabVIEW Runtime is TRUE, NI recommends that you avoid running timed structures or time-critical VIs on CPU 0. Otherwise, if a LabVIEW application hangs, the watchdog timer may not restart the LabVIEW Run-Time Engine in a timely manner.

    Refer to Configuring Settings of a Timed Structure for more information about assigning a processor to a timed structure.

  • cbool.png occurrence —

    occurrence sets the occurrence when the watchdog timer expires.

  • cenum.png trigger protocol —

    trigger protocol is the protocol used for trigger action on the PXI bus when the watchdog timer expires.

    0Sets the trigger action to be active when the line is high.
    0Sets the trigger action to be active when the line is low.
    0Sets the trigger action to operate as an open collector output.
  • cenum.png trigger line —

    trigger line is the trigger line on the PXI bus to be asserted when the watchdog timer expires.

    Refer to the specific RT target hardware documentation for information about supported trigger lines.

  • cbool.png disable watchdog on VI exit —

    disable watchdog on VI exit specifies whether this VI disables the watchdog object when the VI stops running.

  • cerrcodeclst.png error in (no error) —

    error in describes error conditions that occur before this node runs. This input provides standard error in functionality.

  • iu64.png watchdogID —

    watchdogID identifies the watchdog object.

  • idbl.png timeout value returned (sec) —

    timeout value returned specifies the time, in seconds, for the watchdog timer. The timeout period specifies the amount of time that must elapse before the watchdog timer expires. The timeout period is coerced to a value determined from the available timebase and initial count values. The default is 1.

  • iocrn.png occurrence —

    occurrence is the occurrence associated with the interrupt action that asserts when the watchdog timer expires.

  • ierrcodeclst.png error out —

    error out contains error information. This output provides standard error out functionality.

    • Supported timeout values vary by target. This VI coerces timeout up to the next supported value and returns the actual value as timeout value returned (sec). The value of timeout value returned (sec) is always greater than or equal to the timeout value you specify. The occurrence output of this VI returns a reference to the occurrence action you specify using the expiration actions input.

    This VI does not reserve trigger lines, nor does it discriminate between reserved and unreserved trigger lines. If you specify a trigger line that has been reserved elsewhere, the watchdog object overwrites the existing value on the trigger line when the timer expires.

    Examples

    Refer to the following example files included with LabVIEW Real-Time Module.

    • labview\examples\Real-Time Module\NI Watchdog\Watchdog - RT Engine.lvproj