rchConnected (Function)

This returns information about whether the device is connected to the RTCU Communication Hub.

The rchConnected function is functionally identical to and interchangeable with the gwConnected function.

Input:        

None.

Returns: BOOL

True if connection is established, false if not.

Declaration:

FUNCTION rchConnected : 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 connection
   timer();
   IF timer.q THEN
      IF NOT rchIsOpen() THEN
         DebugMsg(message := "Starting connection");
         rc := rchOpen();
         IF rc < 1 THEN
            DebugFmt(message := "  rchOpen=\1", v1 := rc);
         END_IF;
      END_IF;
   ELSE
      IF rchIsOpen() THEN
         DebugMsg(message := "Stopping connection");
         rc := rchClose();
         IF rc < 1 THEN
            DebugFmt(message := "  rchClose=\1", v1 := rc);
         END_IF;
      END_IF;
   END_IF;

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