For information on the latest version, please have a look at GL013301.
set_on_tp_get_user_input (Manual Mode)
This section explains how to use set_on_tp_get_user_input during Manual (Teach) operations. This function registers a callback function that is triggered when the Teach Pendant (TP) requests user input through a DRL command or manual UI interaction.
It enables the host program to capture operator-entered values (such as text, numbers, or parameters) and use them dynamically in the teaching workflow.
Typical usage
Request operator input (e.g., “Enter part ID”, “Input offset value”) and handle the result inside the callback.
Integrate interactive teach dialogs that require human confirmation or numeric entries.
Store and log operator-provided data during manual teaching for traceability.
Combine with tp_get_user_input_response to send typed values back to the controller.
Note
The callback is triggered whenever a DRL command requests user input through TP.
Callback execution should be non-blocking; process or respond asynchronously if needed.
Always call tp_get_user_input_response to deliver the response back to the controller.
Example: Capture user input from Teach Pendant and respond
#include "DRFLEx.h"
#include <iostream>
#include <thread>
#include <cstring>
using namespace std;
using namespace DRAFramework;
CDRFLEx drfl;
// 1) Define callback for TP user input
void OnTpGetUserInput(LPMESSAGE_INPUT tInput)
{
cout << "-------------------------------------------\n";
cout << "[TP USER INPUT REQUESTED]\n";
cout << "Prompt Message : " << tInput->_szTitle << "\n";
cout << "Data Type : " << tInput->_iType << "\n";
cout << "-------------------------------------------\n";
// Example: automatically respond based on prompt content
if (strstr(tInput->_szTitle, "Enter part ID") != nullptr)
{
drfl.tp_get_user_input_response("Part-A123");
cout << "[Host] Auto-filled Part ID: Part-A123\n";
}
else if (strstr(tInput->_szTitle, "offset") != nullptr)
{
drfl.tp_get_user_input_response("15.5");
cout << "[Host] Sent numeric offset value: 15.5\n";
}
else
{
cout << "[Host] Waiting for operator to enter input manually 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 alive to listen for user input requests
while (true) std::this_thread::sleep_for(std::chrono::seconds(1));
return 0;
}
In this example, the host program automatically reacts to user input prompts generated by the TP. Depending on the request content, the callback either sends a predefined response (e.g., a part ID or numeric offset) or waits for the operator to enter input manually. This pattern is ideal for interactive or semi-automated teaching sequences, where part-specific parameters or calibration values are entered through the TP.
Tips
Use this callback for interactive parameter tuning, such as adjusting approach distances or task thresholds.
The TP automatically pauses program execution until tp_get_user_input_response is sent.
Combine with set_on_tp_popup to build full dialog-based teaching workflows.
For multi-step inputs, chain prompts and responses through sequential callbacks to simulate guided teach routines.