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.

app_weld_set_interface_eip_r2m_test

Definition
DRFLEx.h within class CDRFLEx, public section

bool app_weld_set_interface_eip_r2m_test(CONFIG_DIGITAL_WELDING_INTERFACE_TEST pConfigdigitalweldinginterfacetest)
{
    return _app_weld_set_interface_eip_r2m_test(_rbtCtrl, pConfigdigitalweldinginterfacetest);
};

Features

This function configures the EtherNet/IP test signal interface for welders supporting EtherNet/IP communication. It defines the data mapping for test or diagnostic signals transmitted from the robot controller → welder (R2M). This allows the robot to send diagnostic flags or calibration signals used for verifying communication and test cycles.

You can include additional test signal configurations using optional structure fields such as _tTSopt1 and _tTSopt2. Refer to the welder’s communication datasheet for detailed signal mapping and valid byte/bit assignments.

Note

For proper EtherNet/IP welding operation, all 8 communication interfaces should be configured:

• app_weld_set_interface_eip_r2m_process

• app_weld_set_interface_eip_r2m_mode

• app_weld_set_interface_eip_r2m_test ← (this page)

• app_weld_set_interface_eip_r2m_condition

• app_weld_set_interface_eip_r2m_option

• app_weld_set_interface_eip_m2r_process2

• app_weld_set_interface_eip_m2r_monitoring

• app_weld_set_interface_eip_m2r_other

Arguments

Argument Name	Data Type	Default Value	Description
pConfigdigitalweldinginterfacetest	CONFIG_DIGITAL_WELDING_INTERFACE_TEST		Digital welding interface test settings structure

Structure Fields

The following fields define the bit-level mapping for each EtherNet/IP test signal element:

Field Name	Data Type	Default Value	Description
_bEnable	unsigned char	None	Enable flag for the test signal (0: Disabled, 1: Enabled)
_nDataType	unsigned char	None	Data type (0: On/Off, 1: Selection, 2: Value)
_nPositionalNumber	unsigned char	None	Data digit position (0: 1, 1: 0.1, 2: 0.001)
_fMinData	float	None	Minimum threshold value for signal validation
_fMaxData	float	None	Maximum threshold value for signal validation
_nByteOffset	unsigned char	None	Communication byte offset (1-255)
_nBitOffset	unsigned char	None	Communication bit offset (1-255)
_nComnDataType	unsigned char	None	Communication data size 0: 1-bit(Disable Low) 1: 1-bit(Disable High) 2: 2-bit 3: 4-bit 4: 8-bit 5: 15-bit 6: 16-bit(short) 7: 32-bit(int)
_nMaxDigitSize	unsigned char	None	Effective bit-length of the data

Return

Value	Description
0	Error
1	Success

Example

// Example for setting EtherNet/IP test interface signals
CONFIG_DIGITAL_WELDING_INTERFACE_TEST testData;
memset(&testData, 0x00, sizeof(testData));

testData._tGasTest._bEnable = 1;    // Enable signal mapping
testData._tGasTest._nDataType = 0;    // Boolean signal type
testData._tGasTest._nPositionalNumber = 0; // Integer
testData._tGasTest._fMinData = 0.0;
testData._tGasTest._fMaxData = 1.0;
testData._tGasTest._nByteOffset = 5;    // Located at byte 5
testData._tGasTest._nBitOffset = 3;    // Bit 3 in byte 5
testData._tGasTest._nComnDataType = 0;   // 1Bit
testData._tGasTest._nMaxDigitSize = 1;    // Single-bit signal

bool result = Drfl.app_weld_set_interface_eip_r2m_test(testData);

This example maps the gas test signal (_tGasTest) in the EtherNet/IP frame. It assigns the signal to byte position 5, bit 3, using a single-bit Boolean flag. Such test mappings are commonly used to verify digital communication between the robot controller and the connected welder before production welding begins.