NI DIGITAL PATTERN DRIVER Utility Functions

Utility Functions

• niDigital_reset
• niDigital_ResetDevice
• niDigital_self_test

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.

niDigital_ResetDevice

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.

niDigital_self_test

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.