gsmSetAntennaMode (Function)

This function switches between the on-board internal or an optional external GSM antenna.

The selection made by calling this function will remain in effect (persistent through reset/power down) until changed explicitly by a new call to gsmSetAntennaMode.

The gsmGetAntennaMode function can be used to determine which antenna is used.

Input:

mode : SINT

Returns: INT

Declaration:

FUNCTION gsmSetAntennaMode : INT;
VAR_INPUT
  mode : SINT;
END_VAR;

Example:

INCLUDE rtcu.inc
 
PROGRAM test;
 
// Switch to external antenna. Only required to be set once.
gsmSetAntennaMode(mode := 2);
 
BEGIN
  ...
END;
 
END_PROGRAM;