pmExternalPower (Function)

Turns the external power on and off. This makes it possible to run on battery even though external power is provided.

If battery backup is not enabled or if BatPowerLevel() is at the lowest level, the external power can not be disabled.

Note: This function is not supported on LX4.

Input:

enable: BOOL

Enables/disables the external power.

Returns:

Declaration:

FUNCTION pmExternalPower : INT;
VAR_INPUT
   enable   : BOOL;
END_VAR;

Example:

INCLUDE rtcu.inc
 
PROGRAM test;
 
BEGIN
   ...
   // Turn off external power
   pmExternalPower(enable := FALSE);
   ...
END;
 
END_PROGRAM;