Save Default Parameters

NI-Motion VI

Save Default Parameters

Saves the current operating parameters as defaults.

Details     Remarks

Device Compatibility

DeviceCompatibility
7330
Y
7340
Y
7344
Y
7350
Y
7390
Y
NI SoftMotion Controller for CANopen—Accelnet
Y
NI SoftMotion Controller for CANopen—Xenus
Y
Board ID is a unique number assigned by Measurement & Automation Explorer (MAX) used to send and receive commands and data to or from a specific NI motion controller.
error in (no error) describes error conditions that occur before this VI runs. The default input of this cluster is no error. If an error already occurred, this VI returns the value of error in in error out. The VI runs normally only if no incoming error exists. Otherwise, the VI passes the error in value to error out. The error in cluster contains the following parameters:
status is TRUE if an error occurred before this VI was called, or FALSE if not. If status is TRUE, code is a nonzero error code. If status is FALSE, code is zero or a warning code.
code is a number identifying an error or warning. If status is TRUE, code is a nonzero error code. If status is FALSE, code is zero or a warning code. Use the error handler VIs to look up the meaning of this code and display the corresponding error message.
source is a string that indicates the origin of the error, if any. Typically, source is the name of the VI in which the error occurred.
Bd ID Out is provided for flow control. You can string together NI-Motion VIs by wiring the Bd ID Out terminal of one VI to the Board ID terminal of the next VI.
error out contains error information. If error in indicates an error, error out contains the same error information. Otherwise, it describes the error status that this VI produces.
status is TRUE if an error occurred, or FALSE if not. If status is TRUE, code is a nonzero error code. If status is FALSE, code is zero or a warning code.
code is a number identifying an error or warning. If status is TRUE, code is a nonzero error code. If status is FALSE, code is zero or a warning code. Use the error handler VIs to look up the meaning of this code and display the corresponding error message.
source is a string that indicates the origin of the error, if any. Typically, source is the name of the VI in which the error occurred.

Using This VI

The Save Default Parameters VI saves all important configuration, initialization, and trajectory parameters for use after subsequent power-up resets. When you execute this VI, all parameters are saved to nonvolatile flash memory and become the power-up defaults.

If necessary, you can reinstate the factory-default parameters as the power-up defaults with the Reset Default Parameters VI.

This VI does not perform a complete state save. For proper and safe operation after power-up, certain parameters are always reset to their factory defaults to bring the controller back to a known safe state. Parameters not stored are left out by design and are typically reset to zero at power-up.

Note  If you want to remember a parameter that is not included in this list, you can copy that parameter to a general-purpose variable and it is saved with this VI. You can then reset the parameter to the saved value with a program designed for this purpose.

Remarks

This section includes information about how the behavior of this VI differs among the controllers that support it.

NI 73xx Controller Considerations

The following list includes considerations you must make when you are using this VI with a 73xx motion controller:

  • This VI may take longer than 62 ms to process on 73xx controllers. This VI is not guaranteed to execute in real time as it performs memory allocation.
  • When the controller is powered up, the defaults are automatically applied. There is some time, however, between the controller powering up and the application of defaults.

    The defaults on the step, direction, breakpoint, and analog output signals do not take effect until the power up reset state is cleared. Use the Clear Power Up Status VI to clear the power up reset state.

NI SoftMotion Controller Considerations

The following list includes considerations you must make when you are using this VI with the NI SoftMotion Controller:

  • User defaults are not applied until the power up reset state is cleared. Use the Clear Power Up Status VI to clear the power up reset state. Refer to the documentation for your drive for the initial power on state of the drive.