InputOverRangeFcn (Data Acquisition Toolbox)

Specify the M-file callback function to execute when acquired data exceeds the valid hardware range

Description

An input overrange event is generated immediately after an overrange condition is detected for any channel group member. This event executes the callback function specified for InputOverRangeFcn.

An overrange condition occurs when an input signal exceeds the range specified by the InputRange property. Overrange detection is enabled only if the analog input object is running and a callback function is specified for InputOverRangeFcn.

Input overrange event information is stored in the Type and Data fields of the EventLog property. The Type field value is OverRange. The Data field values are given below.

Data Field Value
Description

RelSample
The acquired sample number when the event occurred.

Channel
The index of the channel that experienced an overrange signal.

OverRange
Indicates if the channel went from overrange to in range, or from in range to overrange.

Data Field Value	Description
`RelSample`	The acquired sample number when the event occurred.
`Channel`	The index of the channel that experienced an overrange signal.
`OverRange`	Indicates if the channel went from overrange to in range, or from in range to overrange.

Characteristics

Usage
AI, Common

Access
Read/write

Data type
String

Read-only when running
No

Usage	AI, Common
Access	Read/write
Data type	String
Read-only when running	No

Values

The default value is an empty string.

See Also

Properties

EventLog, InputRange

InitialTriggerTime InputRange