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.

TOnMonitoringDigitalWeldingDataCB

This is a callback function for monitoring digital welding signals (e.g., welding status, error flags, etc.) from the robot controller during welding operations. The callback allows users to track digital feedback, such as welding operation status or safety events.

The function is triggered automatically when the digital welding data is updated, and since it’s called in real-time, it must execute quickly (within 50 msec).

Defined in: DRFLEx.h

// typedef (DRFLEx.h)
typedef void (*TOnMonitoringDigitalWeldingDataCB)(const LPMONITORING_DIGITAL_WELDING);

// internal function definition (real-time)
DRFL_API void _set_on_monitoring_digital_welding_data(LPROBOTCONTROL pCtrl,
                                                        TOnMonitoringDigitalWeldingDataCB pCallbackFunc);

// user-facing function
void set_on_monitoring_digital_welding_data(TOnMonitoringDigitalWeldingDataCB pCallbackFunc)
{
    _set_on_monitoring_digital_welding_data(_rbtCtrl, pCallbackFunc);
};

Parameter

Parameter Name	Data Type	Default Value	Description
pDigitalWeld	MONITORING_DIGITAL_WELDING		Structure that contains digital welding feedback such as status flags, errors, or binary signal states.

Return
None

Example

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

// Digital welding data callback
void OnMonitoringDigitalWeldingDataCB(const LPMONITORING_DIGITAL_WELDING pDigitalWeld)
{
    if (!pDigitalWeld) return;

    cout << "[DIGITAL WELDING DATA UPDATED]" << endl;

    // Display digital status
    cout << "Welding Status: " << (pDigitalWeld->_iWeldingStatus ? "Active" : "Inactive") << endl;

    // Example: Checking if any errors are reported
    cout << "Error flag: " << (pDigitalWeld->_iErrorFlag ? "Error present" : "No error") << endl;
}

int main()
{
#if DRCF_VERSION == 2
    CDRFLEx drfl;

    if (!drfl.open_connection("192.168.137.100")) {
        cout << "Failed to connect to controller." << endl;
        return -1;
    }

    // Register the callback for digital welding monitoring
    drfl.set_on_monitoring_digital_welding_data(OnMonitoringDigitalWeldingDataCB);

    // Keep running to monitor updates
    while (true) std::this_thread::sleep_for(std::chrono::milliseconds(100));

    drfl.close_connection();
#else
    cout << "TOnMonitoringDigitalWeldingDataCB requires DRCF_VERSION == 2." << endl;
#endif
    return 0;
}

Notes

• This callback provides real-time digital welding signals:
  - Welding status (active or inactive)
  - Error flags or alerts during welding
  - Status of other digital signals related to welding process
  

• Keep callback operations fast and non-blocking to avoid real-time interruptions.

• Only available when DRCF_VERSION == 2.

• Common use cases include:
  - Monitoring welding progress and errors.
  - Triggering alarms or corrective actions if errors are detected.
  - Logging digital states for diagnostics and troubleshooting.