For information on the latest version, please have a look at GL013301.
tp_get_user_input_response (Manual Mode)
This section explains how to use tp_get_user_input_response during Manual (Teach) operations. This function sends the user-entered text or numeric input back to the robot controller in response to a user input request generated by the Teach Pendant (TP). It is typically paired with set_on_tp_get_user_input to complete the input–response cycle.
Typical usage
Return text or numeric values that the operator entered on the TP.
Automatically respond to TP input prompts from the host application for testing or semi-automated workflows.
Use in interactive teaching or calibration tasks requiring operator-provided data (e.g., part ID, offset, tolerance).
Enable external PC-based logic to validate or substitute user inputs before sending them to the controller.
Note
Input strings exceeding 128 bytes may be truncated by the controller.
Example: Send user input response automatically
#include "DRFLEx.h"
#include <iostream>
#include <thread>
#include <cstring>
using namespace std;
using namespace DRAFramework;
CDRFLEx drfl;
// Callback for TP user input event
void OnTpGetUserInput(LPMESSAGE_INPUT tInput)
{
cout << "-------------------------------------------\n";
cout << "[TP USER INPUT REQUESTED]\n";
cout << "Prompt : " << tInput->_szTitle << "\n";
cout << "Input Type : " << tInput->_iType << "\n";
cout << "-------------------------------------------\n";
// Example 1: Automatically return a part ID for testing
if (strstr(tInput->_szTitle, "Enter part ID") != nullptr)
{
drfl.tp_get_user_input_response("Part-001");
cout << "[Host] Sent TP input response: Part-001\n";
}
// Example 2: Automatically return a numeric offset
else if (strstr(tInput->_szTitle, "Enter offset") != nullptr)
{
drfl.tp_get_user_input_response("25.5");
cout << "[Host] Sent numeric offset: 25.5\n";
}
else
{
cout << "[Host] Waiting for manual input on TP...\n";
}
}
int main()
{
// Preconditions:
// - drfl.open_connection("192.168.137.100");
// - Controller in Manual (Teach) mode
drfl.set_on_tp_get_user_input(OnTpGetUserInput);
cout << "[Teach] TP user input callback registered.\n";
// Keep process alive to handle input events
while (true)
this_thread::sleep_for(chrono::seconds(1));
return 0;
}
In this example, the program listens for user input requests from the Teach Pendant. Depending on the prompt content, the callback automatically sends a suitable response (e.g., part ID or numeric offset) back to the controller using tp_get_user_input_response. This enables semi-automated input handling for testing or repetitive teaching workflows.
Tips
Always validate and sanitize user-entered data before sending it back to the controller.
In semi-automatic teaching, you can prefill known values and only prompt the operator for unknown parameters.
Combine with tp_popup_response for multi-step dialogs (e.g., confirm → input → confirm).
The function can be used for both text and numeric inputs depending on the DRL command’s request type.