stop(st_mode)
Features
This function stops the currently active motion. stop time is determined by the ‘st_mode’ and robot position does not deviate from the in-progress path.
This command is only used to stop the robot from operating and will not cause stop the program. To stop a program from running, use additionally exit() function. Values DR_QSTOP_STO and DR_QSTOP respond to Stop Category 1 (torque off after maximum deceleration) and 2 (maximum deceleration), but they are not linked with motions, such as torque off, after stopping. DR_SSTOP deceleration time is about 1.5 times longer that the maximum deceleration time. In the case of DR_HOLD, stop immediately with no deceleration time.
Parameters
Parameter Name | Data Type | Default Value | Description |
---|---|---|---|
st_mode | int | - | stop mode
|
Return
Value | Description |
---|---|
0 | Success |
Negative value | Error |
Exception
Exception | Description |
---|---|
DR_Error (DR_ERROR_TYPE) | Parameter data type error occurred |
DR_Error (DR_ERROR_VALUE) | Parameter value is invalid |
DR_Error (DR_ERROR_RUNTIME) | C extension module error occurred |
DR_Error (DR_ERROR_STOP) | Program terminated forcefully |
Example
#1. The motion is terminated with a soft stop 2 seconds after moving to x1
p0 = posj(-148,-33,-54,180,92,32)
movej(p0, v=30, a=30)
x1 = posx(784, 543, 570, 0, 180, 0)
amovel (x1, vel=100, acc=200) # Executes the next command immediately after the motion with x1.
wait(2) # Temporarily suspends the program for 2 seconds.
stop(DR_SSTOP) # Stops the motion with a soft stop.
Related commands
- movej(pos, vel, acc, time, radius, mod, ra, ref)
- movel(pos, vel, acc, time, radius, ref, mod, ra, app_type)
- movejx(pos, vel, acc, time, radius, ref, mod, ra, sol)
- movec(pos, pos2, vel, acc, time, radius, ref, mod, angle, ra, ori, app_type)
- movesj(pos_list, vel, acc, time, mod)
- movesx(pos_list, vel, acc, ref, mod, vel_opt)
- moveb(pos_list, vel, acc, time, ref, mod, app_type)
- move_spiral(rev, rmax, lmax, vel, acc, time, axis, ref)
- move_periodic(amp, period, atime, repeat, ref)
- amovej(pos, vel, acc, time, mod, ra, ref)
- amovel(pos, vel, acc, time, ref, mod, ra, app_type)
- amovejx(pos, vel, acc, time, ref, mod, ra, sol)
- amovec(pos, pos2, vel, acc, time, ref, mod, angle, ra, ori, app_type)
- amovesj(pos_list, vel, acc, time, mod)
- amovesx(pos_list, vel, acc, time, ref, mod, vel_opt)
- amoveb(pos_list, vel, acc, time, ref, mod, app_type)
- amove_spiral(rev, rmax, lmax, vel, acc, time, axis, ref)
- amove_periodic(amp, period, atime, repeat, ref)