You're reading the documentation for an older, but still supported version (1.33.4).
For information on the latest version, please have a look at 1.33.5.

set_auto_servo_off

This function enables or disables the automatic servo-off transition feature in the robot controller. When enabled, the controller will automatically turn off the servo power if the robot remains idle for a specified duration.

This feature is useful for improving safety and energy efficiency, especially when the robot is not in continuous operation.

Definition
DRFLEx.h within class CDRFLEx, public section

bool set_auto_servo_off(bool bFuncEnable, float fElapseTime) {
    return _set_auto_servo_off(_rbtCtrl, bFuncEnable, fElapseTime);
};

Parameter

Parameter Name

Data Type

Default Value

Description

bFuncEnable

bool

Enables or disables the auto servo-off feature
false (0): Disable auto servo-off
true (1): Enable auto servo-off

fElapseTime

float

Duration (in minutes) of inactivity before servo power is turned off.

Return

Value

Description

0

Error — failed to configure the auto servo-off setting

1

Success — setting successfully applied

Example

// Enable the auto servo-off function after 3 minutes of inactivity
if (Drfl.set_auto_servo_off(true, 3.0f))
    printf("Auto servo-off enabled (timeout: 3 minutes)\n");
else
    printf("Failed to set auto servo-off behavior.\n");

// Later, disable the function to keep servo always active
Drfl.set_auto_servo_off(false, 0.0f);

This example enables the auto servo-off function, causing the robot’s servo power to shut down automatically after 3 minutes of inactivity. The feature can later be disabled by calling the function again with bFuncEnable = false.