flex_save_defaults

NI-Motion Functions

flex_save_defaults

Device Compatibility

Device Compatibility
7330
Y
7340
Y
7344
Y
7350
Y
7390
Y
NI SoftMotion Controller for CANopen—Xenus
Y
NI SoftMotion Controller for CANopen—Accelnet
Y

Save Default Parameters

Usage

status = flex_save_defaults(u8 boardID)

Purpose

Saves the current operating parameters as defaults.

Tip  Refer to the Remarks section for information about how the behavior of this function differs between controllers.

Parameters

Name Type Description
boardID u8 assigned by Measurement & Automation Explorer (MAX)

Using This Function

This function saves all important configuration, initialization, and trajectory parameters for use after subsequent power-up resets. When you execute this function, 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 function.

This function 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 function. 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 function differs among the controllers that support it.

NI 73xx Controller Considerations

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

  • This function may take longer than 62 ms to process on 73xx controllers. This function is not guaranteed to execute in real time as it performs memory allocation.
  • When the controller is powered up and the onboard processors boot, 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 function to clear the power up reset state.

NI SoftMotion Controller Considerations

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

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