NI System Configuration API Reference

Self-Test (VI)

  • Updated2023-02-21
  • 3 minute(s) read
Installed With: NI System Configuration

Verifies that system devices can perform basic I/O functions. Ensure that no other tasks are running on the system while the self-test executes because the driver may need exclusive access to some device resources.

You can select from three modes that provide different levels of self-test functionality. The mode you select might require you to disconnect cables from the device. For details about each mode, refer to the description for the Self-Test Mode input.

Self-Test

crn.gif

Resource in is the resource object refnum returned from the Find Hardware VI.

cerrcodeclst.gif

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

cu32.gif

Remote Timeout specifies the time in milliseconds that this VI waits before it times out. The default amount of time that the VI waits for a response on the network before timing out is 5 minutes. In some cases, the operation may take longer to complete. This timeout is for remote systems only.

ci32.gif

Self-Test Mode specifies the type of self-test to perform. For hardware without intermediate or full self-test functionality, this VI executes a basic self-test regardless of the requested mode.

basic (0)

(default) A basic self-test should complete in under 3 seconds and does not require you to disconnect devices from external equipment because the states of I/O lines are maintained throughout the test. At minimum, a basic self-test verifies host-device communication (for example: validation of device registers).

intermediate (1)

An intermediate self-test should complete in under 30 seconds and try to verify as much I/O as possible using internal loop-backs. This does not require you to disconnect devices from external equipment because the states of I/O lines are maintained throughout the test.

full (2)

A full self-test verifies as much I/O as possible and takes longer to complete. This advanced test is used to perform the most exhaustive diagnostic possible. This mode requires you to disconnect external I/O signals before starting the operation.

cbool.gif

If TRUE, Prompt if Full Mode will show a dialog box prompting the user to disconnect the device from external signals before beginning a full self-test. If the mode is basic or intermediate , this input is ignored.

irn.gif

Resource out returns basic information about the system resource.

istr.gif

Detailed Result returns a string containing results of any errors that may have occurred during the VI execution. This parameter also may return additional information about the results of the VI execution.

ierrcodeclst.gif

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

Log in to get a better experience