Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Section

Variables

RT3.13 includes the addition of a number of new system variables:

Tablewidth
tablewidth800px
width2700px
width1100px


"Px"

Current Position

Unit: Pulses

Read/Write

While the Px variable did exist in RT3.12, it has been changed to now be read/write.

You can now write to a variable assigned to Px within a program, to assign the motor's current position.

While this variable can be written to while in motion, caution should be taken to not change the position too drastically while running, to avoid any faults or alarms.



Tablewidth
tablewidth800px
width2700px
width1100px


"TMR"

Timer

Unit: milliseconds

Read/Write

When a variable is assigned as "TMR"  you can write a value to it which will begin to count down to 0.

This can be used by writing a time to the variable, and then using an if statement to begin some process when the timer counts down to 0.



Tablewidth
tablewidth800px
width2700px
width1100px


"CX"

Timer

Unit: N/A

Read/Write

The "Cx" counter variable was also present in RT3.12, but is now read/write.

You can now write a value to the "Cx" variable to reset or change the value of the counter.



Tablewidth
tablewidth800px800
width2700px700
width1100px

"PTMR"

Push Timer

Unit: milliseconds

Read/Write

The "PTMR" variable is used to dynamically change the push time, when using a push move.

This value will perform the same function and override the push time value in K61. Unlike K61, this variable can be changed dynamically through a program.

Tablewidth
tablewidth800px
width2700px
width1100px100


"Pval"

Push Value

Unit: -


Read/Write

The "PVal" variable is used to adjust the force of a push move. This can be used to change the push force dynamically.

This variable performs the same function of K60, but in a slightly different way. K60 is a percentage of the motor's torque whereas "PVal" is

a unitless quantity from 0 to the motor's peak torque setting.

The max value for each motor is:

17S - 60

17L - 110

23S - 176

23L - 180


This gives us better torque resolution in the larger motors, as well as allowing the push value to be changed on the fly.



Tablewidth
tablewidth800px
width2700px
width1100px


"PTMR"

Push Timer

Unit: milliseconds

Read/Write

The "PTMR" variable is used to dynamically change the push time, when using a push move.

This value will perform the same function and override the push time value in K61. Unlike K61, this variable can be changed dynamically through a program.



Tablewidth
tablewidth800px
width2700px
width1100px


"CNT"

Count up Timer

Unit: milliseconds

Read/Write

This variable will continue to count up in milliseconds. This can be used to time a process, or wait a specific amount of time before continuing with a program.

For example, 0 can be written to the variable and then it can be read when the process finishes to give a time in milliseconds.



Tablewidth
tablewidth800px
width2700px
width1100px


"Tx"

Target Torque

Unit: milliseconds

Read only

When read, the "Tx" variable will return the instantaneous target torque value. This is a unitless value directly related to the motor's peak torque.

The max value for each motor is:

17S - 60

17L - 110

23S - 176

23L - 180




Tablewidth
tablewidth800px
width2700px
width1100px


"Ex"

Error Status

Unit: -

Read only

This variable is similar to the "Ux" status variable but this will return only an error status. This variable will return 0 for non-error statuses: In position, Manually Disabled, running, etc. The variable will return the error status if there is an error, e.g. 2=Over Speed, 4=Over Torque, etc.



Tablewidth
tablewidth800px
width2700px
width1100px


"EEP1"

Non-Volatile EEPROM Value

Unit: -

Read/Write

Using the "EEP1" variable, you can have a value saved from a program to non-volatile memory, so that it is not lost in the event of power loss. This variable will only write if the value changes. This can also be written to directly using K1996.

Warning

These values written to non-volatile memory have a 100,000 write limit. Care should be taken not to overwrite this value too often or the value may not be saved anymore.




Tablewidth
tablewidth800px
width2700px
width1100px


"EEP2"

Non-Volatile EEPROM Value

Unit: -

Read/Write

Using the "EEP2" variable, you can have a value saved from a program to non-volatile memory, so that it is not lost in the event of power loss. This variable will only write if the value changes. This can also be written to directly using K1998.

Warning

These values written to non-volatile memory have a 100,000 write limit. Care should be taken not to overwrite this value too often or the value may not be saved anymore.




Tablewidth
tablewidth800px
width2700px
width1100px


"DPOS"

Dynamic Positioning

Unit: -

Read/Write

Dynamic positioning allows you to send position values to the motor and have it instantly respond targeting that position.




...