get_output_register_bit

This function reads a single bit from the controller output register using the specified register address. It is typically used for PLC I/O register monitoring in Ethernet-based environments.

Definition
DRFLEx.h within class CDRFLEx, public section

bool get_output_register_bit(unsigned short address, int& out_val, int timeout_ms = 300) {
    return _get_output_register_bit(_rbtCtrl, address, &out_val, timeout_ms);
};

Parameter

Parameter Name

Data Type

Default Value

Description

address

unsigned short

Output register address (bit index, 0~63)

out_val

int&

Output bit value to read
0 : OFF
1 : ON

timeout_ms

int

300

Timeout in milliseconds

Return

Value

Description

0

Error: failed to read output register bit

1

Success: output register bit read

Example

#include "DRFLEx.h"
#include <iostream>

using namespace DRAFramework;

int main() {
    CDRFLEx robot;

    const char* ip = "192.168.137.100";
    if (!robot.open_connection(ip)) {
        std::cout << "Failed to connect: " << ip << std::endl;
        return 1;
    }

    // Write bit and read back (timeout 300 ms)
    // Initialize to -1 to indicate “not read yet” if the call fails.
    int out_bit = -1;
    robot.set_output_register_bit(0, 1);
    robot.get_output_register_bit(0, out_bit, 300);
    std::cout << "addr=0, out_bit=" << out_bit << std::endl;

    robot.close_connection();
    return 0;
}

This example sets the output register bit at address 0 (Bit_Output_Register[0]) to ON and reads it back.