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.

TOnMonitoringDigitalWeldingDataCB

This callback function is used to monitor 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.

See Rules for callback functions.

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>
#include <thread>
#include <chrono>
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->_iStatus ? "Active" : "Inactive") << endl;

    // Example: Checking if any errors are reported
    cout << "Error flag: " << (pDigitalWeld->_iError ? "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 the welding process
  

• 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.
  

• Each callback receives the most recent data. If the callback takes longer than the data period (100 ms before DRCF 3.5, 20 ms from DRCF 3.5), intermediate samples are not delivered. Do not rely on receiving every sample (for example for integration or differentiation).