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.

get_robot_system (Manual Mode)

This section explains how to use get_robot_system during Manual (Teach) operations. This function retrieves the current robot system type — whether the controller is connected to a real robot or a virtual robot (simulation). It is particularly useful when developing or verifying teaching programs to ensure the correct operating context before motion execution.

Typical usage

  • Check whether the connected system is a real robot or a virtual (simulated) controller.

  • Prevent physical motion commands from being sent in simulation-only sessions.

  • Dynamically adjust safety parameters or teaching procedures depending on the system type.

  • Use for conditional logic in hybrid testing environments (real + virtual setup).

Note

  • The result is read-only and updated automatically upon connection.

  • Use before motion or calibration commands to prevent unintended behavior on a live robot.

Example: Verify system type before starting manual teaching

// Preconditions:
// - Connection established (open_connection)

ROBOT_SYSTEM sysType = drfl.get_robot_system();

switch (sysType) {
    case ROBOT_SYSTEM_REAL:
        printf("[System] Connected to a REAL robot.\n");
        printf("Proceeding with manual teaching operations.\n");
        break;

    case ROBOT_SYSTEM_VIRTUAL:
        printf("[System] Running on VIRTUAL controller.\n");
        printf("Motion commands will be simulated.\n");
        break;

    default:
        printf("[System] Unknown system type detected.\n");
        break;
}

Tips

  • Always confirm the system type before executing any move commands during teaching.

  • When testing on a PC without a physical robot, expect ROBOT_SYSTEM_VIRTUAL.

  • Combine with get_robot_speed_mode to ensure safe speed limits in real environments.

  • Ideal for hybrid environments where development and verification alternate between virtual and real robots.