gsmGetAntennaMode (Function)

Architecture:	X32 / NX32
Firmware version:	4.40

This function returns which antenna is used, and the current selection mode set by the gsmSetAntennaMode function.

Compatibility: RTCU AX9 turbo/encore only.

Input:

None.

Output:

mode : SINT

1	The internal antenna is selected.
2	The external antenna is selected.
3	The active antenna is determined by DIP-switch 4.

active : SINT

1	The internal antenna is active.
2	The external antenna is active.

Returns: INT

0	Not supported
1	Successful.

Declaration:

FUNCTION gsmGetAntennaMode : INT;
VAR_INPUT
mode : ACCESS SINT;
active : ACCESS SINT;
END_VAR;

Example:

INCLUDE rtcu.inc

PROGRAM test;
VAR
mode : SINT;
used : SINT;

str : STRING;
END_VAR;

BEGIN
...

IF gsmGetAntennaMode(mode := mode, active := used) = 0 THEN

str := "GSM Antenna: Not supported";

ELSE

str := "GSM Antenna: ";

CASE mode OF

1: str := str + "mode=Internal";

2: str := str + "mode=External";

3: str := str + "mode=Dip switch";

END_CASE;

CASE used OF

1: str := str + ", used=Internal";

2: str := str + ", used=External";

END_CASE;

END_IF;

DebugMsg(message := str);

...
END;
END_PROGRAM;