ValueMotion to NI-Motion Conversion
To aid in converting a ValueMotion application to NI-Motion, the following table lists each function in the ValueMotion API and gives the nearest NI-Motion function. Some ValueMotion functions are related to two NI-Motion functions. In these cases, the first function is the closest match to the ValueMotion function, but the second NI-Motion function, in combination with the first, is required to completely mimic the functionality of the original ValueMotion function.
Refer to the individual functions in both the ValueMotion and NI-Motion function online help for detailed information about the functional and syntactic differences.
| Original ValueMotion Function |
Equivalent NI-Motion Function |
Descriptive Function Name |
| acquire_sample | flex_acquire_trajectory_data | Acquire Trajectory Data |
| begin_prestore | flex_begin_store | Begin Program Storage |
| communicate | flex_communicate | Communicate |
| enable_brk | flex_enable_breakpoint | Enable Breakpoint Output |
| flex_configure_breakpoint | Configure Breakpoint | |
| enable_io_trig | flex_wait_on_event | Wait on Event |
| enable_limits | flex_enable_axis_limit | Enable Axis Limits |
| flex_enable_home_inputs | Enable Home Inputs | |
| enable_pos_trig | flex_jump_on_event | Jump on Event |
| end_prestore | flex_end_store | End Program Storage |
| find_home | flex_find_reference | Find Reference |
| find_index | flex_find_reference | Find Reference |
| find_index_rdb | Not Supported | — |
| flush_rdb | flex_flush_rdb | Flush Return Data Buffer |
| get_board_type | flex_get_motion_board_info | Get Motion Board Information |
| get_motion_board_info | flex_get_motion_board_info | Get Motion Board Information |
| get_motion_board_name | flex_get_motion_board_name | Get Motion Board Name |
| in_pos | flex_check_move_complete_status | Check Move Complete Status |
| flex_config_mc_criteria | Configure Move Complete Criteria | |
| initialize_controller | flex_initialize_controller | Initialize Controller |
| kill_motion | flex_stop_motion | Stop Motion |
| load_accel | flex_load_acceleration | Load Acceleration/Deceleration |
| load_accel_fact | Not Supported | — |
| load_break_mod | flex_load_bp_modulus | Load Breakpoint Modulus |
| load_deriv_gain | flex_load_single_pid_parameter | Load Single PID Parameter |
| load_deriv_per | flex_load_single_pid_parameter | Load Single PID Parameter |
| load_fol_err | flex_load_follow_err | Load Following Error |
| load_intg_gain | flex_load_single_pid_parameter | Load Single PID Parameter |
| load_intg_lim | flex_load_single_pid_parameter | Load Single PID Parameter |
| load_pos_brk | flex_load_pos_bp | Load Breakpoint Position |
| load_pos_ref | flex_config_gear_master (Note 1) | Configure Gear Master |
| load_pos_scale | flex_load_gear_ratio (Note 2) | Load Gear Ratio |
| load_prop_gain | flex_load_single_pid_parameter | Load Single PID Parameter |
| load_rot_counts | flex_load_pos_modulus | Load Position Modulus |
| load_rpm | flex_load_rpm | Load Velocity in RPM |
| load_rpsps | flex_load_rpsps | Load Accel/Decel in RPS/sec |
| load_steps_lines | flex_load_counts_steps_rev | Load Counts/Steps per Revolution |
| load_target_pos | flex_load_target_pos | Load Target Position |
| load_time_brk | Not Supported | — |
| load_vel | flex_load_velocity | Load Velocity |
| load_vel_change | flex_load_velocity_override (Note 3) | Load Velocity Override |
| master_slave_cfg | flex_config_gear_master | Configure Gear Master |
| flex_enable_gearing | Enable Gearing | |
| multi_start | flex_start | Start Motion |
| read_adc | flex_read_adc16_rtn | Read ADC |
| read_axis_stat | flex_read_axis_status_rtn | Read per Axis Status |
| read_axis_stat_rdb | flex_read_axis_status | Read per Axis Status |
| read_csr | flex_read_csr_rtn | Read Communication Status |
| flex_read_axis_status_rtn | Read per Axis Status | |
| read_encoder | flex_read_encoder_rtn | Read Encoder Position |
| read_encoder_rdb | flex_read_encoder | Read Encoder Position |
| read_gpio | flex_read_port_rtn | Read I/O Port |
| read_gpio_rdb | flex_read_port | Read I/O Port |
| read_io_port | flex_read_hs_cap_status_rtn | Read High-Speed Capture Status |
| read_io_port_rdb | flex_read_hs_cap_status | Read High-Speed Capture Status |
| read_lim_stat | flex_read_axis_limit_status_rtn | Read Axis Limit Status Return |
| flex_read_home_input_status_rtn | Read Home Input Status | |
| read_lim_stat_rdb | flex_read_axis_limit_status | Read Axis Limit Status |
| flex_read_home_input_status | Read Home Input Status | |
| read_pos | flex_read_pos_rtn | Read Position |
| read_pos_rdb | flex_read_pos | Read Position |
| read_rdb | flex_communicate | Communicate |
| read_rpm | flex_read_rpm_rtn | Read Velocity in RPM |
| read_steps_vel | flex_read_velocity_rtn | Read Velocity |
| read_vel | flex_read_velocity_rtn | Read Velocity |
| read_vel_rdb | flex_read_velocity | Read Velocity |
| reset_pos | flex_reset_pos | Reset Position |
| send_command | flex_communicate | Communicate |
| set_base_vel | flex_load_base_vel | Load Base Velocity |
| set_direction | flex_set_port_direction | Set I/O Port Direction |
| set_gpio | flex_set_port | Set I/O Port MOMO |
| set_io_output | flex_set_inhibit_output_momo | Set Inhibit Output MOMO |
| set_io_pol | flex_configure_hs_capture | Configure High-Speed Capture |
| set_lim_pol | flex_set_limit_input_polarity | Set Limit Input Polarity |
| flex_set_home_polarity | Set Home Input Polarity | |
| set_loop_mode | flex_set_stepper_loop_mode | Set Stepper Loop Mode |
| set_portc_dir | flex_set_port_direction | Set I/O Port Direction |
| set_pos_mode | flex_set_op_mode | Set Operation Mode |
| set_rs_pulse | flex_config_mc_criteria | Configure Move Complete Criteria |
| set_scale_seq | flex_load_gear_ratio (Note 2) | Load Gear Ratio |
| flex_configure_inhibit_output | Configure Inhibit Outputs | |
| set_stop_mode | flex_stop_motion | Stop Motion |
| start_motion | flex_start | Start Motion |
| stop_motion | flex_stop_motion | Stop Motion |
| store_elc | flex_load_counts_steps_rev | Load Counts/Steps per Revolution |
| store_steps_rev | flex_load_counts_steps_rev | Load Counts/Steps per Revolution |
| trig_buff_delim | flex_wait_on_event | Wait on Event |
| trigger_io | flex_run_prog | Run Program |
Load_pos_ref applies not only to gearing but to normal movement as well. The same functionality for normal movement can be achieved using relative moves.
To set the gear ratio with ValueMotion you would use load_pos_scale and set_scale_seq; these relate to Load Gear Ratio in NI-Motion. Load_pos_scale and set_scale_seq apply not only to gearing but to normal movement as well. There is no equivalent in NI-Motion.
The ValueMotion function Load_vel_change uses a delta change, but the NI-Motion function Load Velocity Override uses a percentage change.