gwSetMedia (Function)

This function temporarily changes the media used to connect to the RTCU Communication Hub.

This function works similarly to rchInterfaceSet.

The default media is Mobile.

In case the device faults, it will try to connect to the RTCU Communication Hub using the media selected by this function.

If a non-fallback server configuration is enabled, this function must be called after gwOpen to work.

Input:

media : SINT (0/1) (Default 0)

Media to use for connecting to the RTCU Communication Hub.

Returns: INT

Declaration:

FUNCTION gwSetMedia : INT;
VAR_INPUT
  media : SINT;
END_VAR;

Example:

INCLUDE rtcu.inc
 
VAR_INPUT
  eth : BOOL;
END_VAR;
 
VAR_OUTPUT
  LED_GPRS : BOOL;
  LED_GW   : BOOL;
END_VAR;
 
PROGRAM EthernetTest;
VAR
  gw_media : SINT;
END_VAR;
 
  // Init GPRS
  gsmPower(power:=ON);
  gprsOpen();
 
  // Init Ethernet
  ethOpen();
 
  DebugMsg(message:="Program running");
 
BEGIN
  LED_GPRS := gprsConnected();
  LED_GW   := gwConnected();
 
  // Change gateway media?
  IF gw_media = 0 AND eth THEN
    // Select media
    gwSetMedia(media:=1); // Use ethernet
    // Set curent media
     gw_media := 1;
  ELSIF gw_media = 1 AND NOT eth THEN
    // Select media
    gwSetMedia(media:=0); // Use GPRS
    // Set curent media
     gw_media := 0;
END_IF;
 
END;
END_PROGRAM;