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

del_tool (Auto Mode)

This section explains how to use del_tool during Auto (Run) operations or maintenance procedures to remove a previously registered tool configuration from the controller.

This function is mainly used during system setup or when cleaning up unused tool entries, rather than during normal automated production.

Typical usage

  • Delete outdated or unused end-effector configurations.

  • Remove incorrect tool definitions during commissioning.

  • Clean up tool symbols before deploying a new recipe.

  • Maintain consistency across multi-robot workcells.

Note

  • Do not delete a tool that is currently active or used by a running DRL program.

  • Symbol must exactly match a tool registered using add_tool.

  • Best used during system initialization or maintenance, not mid-cycle.

Example: Removing an Unused Tool

#include "DRFLEx.h"
#include <cstdio>
using namespace DRAFramework;

int main() {
    CDRFLEx drfl;

    // Remove a registered tool
    if (!drfl.del_tool("OLD_END_EFFECTOR")) {
        printf("Failed to delete tool: OLD_END_EFFECTOR\n");
        return -1;
    }

    printf("Tool successfully removed.\n");
    return 0;
}

In this example, an unused tool configuration is removed to keep the system clean and prevent symbol conflicts.

Tips

  • Avoid deleting tools during motion or active Auto Mode execution.

  • Only remove tools that are no longer required for recipes or operations.

  • Keep tool naming consistent to avoid accidental deletion.