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