gwIsOpen (Function)

This returns information about whether an RTCU Communication Hub connection is opened in the device. The function will not tell if an actual connection is finally established, to determine this the gwConnected() function must be used.

Input:        

None.

Returns: BOOL

True if connection is opened, false if not.

Declaration:

FUNCTION gwIsOpen : BOOL;

Example:

INCLUDE rtcu.inc
 
PROGRAM test;
VAR
  timer   : clockDayTimer;
  rc       : INT;
END_VAR;

 
  // Initialize
  timer(enable:=ON, start_hour:=12, start_minute:=0, stop_hour:=13, stop_minute:=30);
 
BEGIN
  // Manage RTCU Communication Hub connection
  timer();
  IF timer.q THEN
    IF NOT gwIsOpen() THEN
        DebugMsg(message := "Starting connection");
        rc := gwOpen();
        IF rc < 1 THEN
          DebugFmt(message := "  gwOpen=\1", v1 := rc);
        END_IF;
    END_IF;
  ELSE
    IF gwIsOpen() THEN
        DebugMsg(message := "Stopping connection");
        rc := gwClose();
        IF rc < 1 THEN
          DebugFmt(message := "  gwClose=\1", v1 := rc);
        END_IF;
    END_IF;
  END_IF;

 
  IF gwConnected() THEN
    // Connection is ready for work
  END_IF;
END;
END_PROGRAM;