gsmVoLTEEnable (Function)

Top  Previous  Next

Architecture:

NX32L

Device support:

All

Firmware version:

2.30.00


This function tries to enable VoLTE(Voice over LTE) on the device. Not all networks and configurations are supported.

 

The final success of this operation can be checked with gsmVoLTEStatus().

 

When VoLTE is enabled it will be stored persistently, so it should only be set once for the specific SIM card / network.

 

On NX devices, the operation takes some time.

On LX devices, the system will restart, and it will also take some time. It is necessary to implement a mechanism to avoid calling gsmVoLTEEnable() on every boot when using a network/sim where VoLTE is not supported, to avoid a boot loop.

 

 

 

Input:

enable: BOOL (default: TRUE)

Set to true to try to enable VoLTE.

 

Returns: INT

1

Success

0

Not supported.

-1

Not an LTE module.

-2

No SIM card present.

-3

No power to the LTE engine.

-4

Could not enable VoLTE.

 

Declaration:

FUNCTION gsmVoLTEEnable : INT;
VAR_INPUT
  enable : BOOL := TRUE;
END_VAR;

 

 

Example:

INCLUDE rtcu.inc
 
PROGRAM test;
 
// Turn on power to the GSM module
gsmPower(power := TRUE);
 
BEGIN
  ...
  // Enable VoLTE
  gsmVoLTEEnable(enable := TRUE);
  ...
END;
 
END_PROGRAM;