Utility Functions

niDigital_reset

Resets a digital pattern instrument to a known state.

This function performs the following actions:

Aborts pattern execution.
Clears pin maps, time sets, source and capture waveforms, and patterns.
Resets all properties to default values, including the niDigital Selected Function property that is set to Disconnect, causing the I/O switches to open.
Stops exporting all external signals and events.

C Function Prototype: ViStatus niDigital_reset (ViSession vi)

Parameter	Description
vi	The specified instrument session the niDigital_init or niDigital_InitWithOptions function returns.

Return value: Reports the status of the operation.

Returns a digital pattern instrument to a known state.

This function performs the following actions:

Aborts pattern execution.
Clears pin maps, time sets, source and capture waveforms, and patterns.
Resets all properties to default values, including the niDigital Selected Function property that is set to Disconnect, causing the I/O switches to open.
Stops export of all external signals and events.
Clears over-temperature and over-power conditions.

C Function Prototype: ViStatus niDigital_ResetDevice (ViSession vi)

Parameter	Description
vi	The specified instrument session the niDigital_init or niDigital_InitWithOptions function returns.

Return value: Reports the status of the operation.

Returns self test results from a digital pattern instrument. This test requires several minutes to execute.

C Function Prototype: ViStatus niDigital_self_test (ViSession vi, ViInt16* testResult, ViChar[] testMessage)

Parameter	Description
vi	The specified instrument session the niDigital_init or niDigital_InitWithOptions function returns.
Output
testResult	A parameter that indicates if the self test passed (0) or failed (!=0).
testMessage	The returned self test status message. The array must contain at least 256 characters.

Return value: Reports the status of the operation.