gsmVoLTEEnable (Function)

This function attempts to enable or disable Voice over LTE (VoLTE) on the device. VoLTE support varies by network and configuration.

Use gsmVoLTEStatus() to verify if the operation was successful.

Enabling VoLTE sets it persistently. Therefore, it should typically be configured only once per SIM card and network.

Important: On NX devices, this operation may take some time. On LX devices, a system restart may occur, which will also take time. For LX devices, implement a mechanism to prevent repeated calls to gsmVoLTEEnable() on unsupported networks/SIMs to avoid boot loops.

Input:

enable: BOOL (default: TRUE)

Set to true to try to enable VoLTE.

Returns: INT

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;