# Managed Power Management Service

- [API reference](https://docs.qualcomm.com/doc/80-41102-2/topic/_doxygen_rst_file__doxygen_sources_taf_mngdPm_interface_h.html#file-taf-mngdpm-interface-h)

[HAL APIs](https://docs.qualcomm.com/doc/80-41102-2/topic/_doxygen_rst_file__doxygen_sources_include_vhal_tafHalPM_h.html#file-tafhalpm-h)

The Managed Power Management service APIs help to manage power on the NAD/TCU.

## IPC interfaces binding

The following example illustrates how to bind to the Managed Power Management service.

bindings:
      {
          clientExe.clientComponent.taf_mngdPm -> tafMngdPMSvc.taf_mngdPm
      }
    Copy to clipboard

## Configuration

Before starting the service, the user should place a JSON file named tafMngdPMSvc.json into /data/ManagedServices directory. This JSON file contains the configurations for bootup system awake time, whether PM HAL is enabled, timeout length for hal responses.

The default configuration file is available at /legato/systems/current/appsWriteable/tafMngdPMSvc/tafMngdPMSvc.json

## Shutdown the system forcefully

TelAF Power Management Service’s client calls [taf\_mngdPm\_ShutdownReqAsync()](https://docs.qualcomm.com/doc/80-41102-2/topic/function_a00581_1ad6a37aef46c67bfa031b7e89e8545a67.html#Documentationa00581_1ad6a37aef46c67bfa031b7e89e8545a67) to shut down the system forcefully. This function returns le\_result\_t and updates the results through callback function reference provided in the function call. This API will collaborate with the PM VHAL.

void ForcedSystemShutdownCallBack(taf_mngdPm_ShutdownMode_t mode,
           taf_mngdPm_ResponseMode_t ResponseMode, le_result_t result, void* contextPtr)
       {
           LE_INFO("ForcedSystemShutdownCallBack ");
       }
    
       void ForcedSystemShutdown()
       {
           le_result_t result = taf_mngdPm_ShutdownReqAsync(TAF_MNGDPM_SYSTEM_FORCEFUL_SHUTDOWN,
                   ForcedSystemShutdownCallBack, NULL);
    
           if(result == LE_OK) {
               LE_INFO("Forcefull shutdown request sent successfully");
           }
       }
    Copy to clipboard

## Restart the system forcefully

TelAF Power Management Service’s client calls [taf\_mngdPm\_RestartReqAsync()](https://docs.qualcomm.com/doc/80-41102-2/topic/function_a00581_1a07b2e8d49b32c10b597d5d467449048a.html#Documentationa00581_1a07b2e8d49b32c10b597d5d467449048a) to restart the system forcefully. This function returns le\_result\_t and updates the results through callback function reference provided in the function call. This function also provides the ability to shut down the NAD on receiving this restart request in case customer wants to wake up the NAD after power off. This API will collaborate with the PM VHAL.

void RestartCallback(taf_mngdPm_RestartMode_t mode, taf_mngdPm_ResponseMode_t rspmode,
               le_result_t result, void* contextPtr)
       {
           LE_INFO(" RestartCallback ");
       }
    
       void RestartSystem()
       {
           le_result_t res = taf_mngdPm_RestartReqAsync(TAF_MNGDPM_RESTART_SYSTEM_OFF_ON,
                   RestartCallback, NULL);
           if(res == LE_OK) {
               LE_INFO("Forcefull restart request sent successfully");
           }
       }
    Copy to clipboard

## Set the targeted power mode to the node

TelAF Power Management Service’s client calls [taf\_mngdPm\_SetNodeTargetedPowerMode()](https://docs.qualcomm.com/doc/80-41102-2/topic/function_a00581_1a3e8fb090992799fdf97cbce8e2afa6d4.html#Documentationa00581_1a3e8fb090992799fdf97cbce8e2afa6d4) to set the power mode of the node. This function returns le\_result\_t and sets the targeted power mode of the node requested once all the wake sources are released. This API will collaborate with the PM VHAL.

// To set the targeted power mode of NAD to SHUT DOWN.
       void SetTargetedPowerMode()
       {
           result = taf_mngdPm_SetNodeTargetedPowerMode(0,TAF_MNGDPM_SHUTDOWN);
           if(result == LE_OK)
               LE_INFO("taf_mngdPm_GracefulSysShutdownWakeLock triggered successfully");
       }
    Copy to clipboard

## Modem wake source configuration

TelAF Managed Power Management Service’s client calls [taf\_mngdPm\_SetNodeModemWakeupSel()](https://docs.qualcomm.com/doc/80-41102-2/topic/function_a00581_1a791ffd1c868dff3033d1211729035efc.html#Documentationa00581_1a791ffd1c868dff3033d1211729035efc) to set the whitelisted modem wake sources within modem services of SMS, SIM and voice call. By default, there’s no whitelist control for modem wake sources from TelAF Managed Power Management Service if there’s no client calling the API.

Supported modem wake sources control are defined with NodeModemWsBitMask:

— SMS: Modem wake up due to incoming SMS.

— VOICE\_CALL: Modem wake up due to incoming voice call.

— REMOTE\_SIM\_PROFILE\_SWAP: Modem wake up due to remote SIM profile swap.

[taf\_mngdPm\_GetNodeModemWakeupSel()](https://docs.qualcomm.com/doc/80-41102-2/topic/function_a00581_1a5696a9571ed07ac0d409c927c1b56ca6.html#Documentationa00581_1a5696a9571ed07ac0d409c927c1b56ca6) is used to query the configured whitelisted modem wake sources by [taf\_mngdPm\_SetNodeModemWakeupSel()](https://docs.qualcomm.com/doc/80-41102-2/topic/function_a00581_1a791ffd1c868dff3033d1211729035efc.html#Documentationa00581_1a791ffd1c868dff3033d1211729035efc).

When there is a NAD wakeup triggered due to the supported modem wake sources, the API of [taf\_mngdPm\_GetNodeModemAwakeReason()](https://docs.qualcomm.com/doc/80-41102-2/topic/function_a00581_1a406b694a034da0d6957482b17f4fc6c3.html#Documentationa00581_1a406b694a034da0d6957482b17f4fc6c3) is used to query it. If there are clients registering for the wake up event by [taf\_mngdPm\_AddNodeModemAwakeHandler()](https://docs.qualcomm.com/doc/80-41102-2/topic/function_a00581_1aab6f6e6a19c012ed7a199156a789b68f.html#Documentationa00581_1aab6f6e6a19c012ed7a199156a789b68f), the wake up event will be sent to the clients with node ID and wake up reason.

## Acquire a wake source

TelAF Managed Power Management Service’s client calls [taf\_mngdPm\_CreateWakeupSource()](https://docs.qualcomm.com/doc/80-41102-2/topic/function_a00581_1a53af0135735600bc4622af6fa5a4b883.html#Documentationa00581_1a53af0135735600bc4622af6fa5a4b883) and [taf\_mngdPm\_StayAwake()](https://docs.qualcomm.com/doc/80-41102-2/topic/function_a00581_1abe7ab7c0145589ce20c49127f45f7705.html#Documentationa00581_1abe7ab7c0145589ce20c49127f45f7705) to acquire a wake source to keep the system awake. The reason parameter in [taf\_mngdPm\_CreateWakeupSource()](https://docs.qualcomm.com/doc/80-41102-2/topic/function_a00581_1a53af0135735600bc4622af6fa5a4b883.html#Documentationa00581_1a53af0135735600bc4622af6fa5a4b883) is authenticated based on the mask given by [taf\_mngdPm\_AuthorizeStayAwakeReason()](https://docs.qualcomm.com/doc/80-41102-2/topic/function_a00581_1ade48be347cb44657773571a572abb546.html#Documentationa00581_1ade48be347cb44657773571a572abb546) and passed to VHAL. The authorized wake source keeps the system awake when [taf\_mngdPm\_StayAwake()](https://docs.qualcomm.com/doc/80-41102-2/topic/function_a00581_1abe7ab7c0145589ce20c49127f45f7705.html#Documentationa00581_1abe7ab7c0145589ce20c49127f45f7705) is called. By default, all the stake awake reasons are authorized.

void CreateWakeupSource()
       {
           const char* wsTag = "OEM_Normal";
           taf_mngdPm_wsRef_t ref = taf_mngdPm_CreateWakeupSource(
                          TAF_MNGDPM_STAY_AWAKE_REASON_NORMAL,
                          TAF_MNGDPM_WS_OPT_DEFAULT, wsTag
                          );
           if(ref != NULL)
               LE_INFO("taf_mngdPm_CreateWakeupSource created a wake source successfully");
       }
       void StayAwake()
       {
           le_result_t result = taf_mngdPm_StayAwake(ref);
           if(result == LE_OK)
               LE_INFO("taf_mngdPm_StayAwake successfully acquire a wake source to keep the system awake");
       }
    Copy to clipboard

## Release an acquired wake source

TelAF Managed Power Management Service’s client calls [taf\_mngdPm\_Relax()](https://docs.qualcomm.com/doc/80-41102-2/topic/function_a00581_1a32b06b7baa81e4163a5083ac5c6ac2b9.html#Documentationa00581_1a32b06b7baa81e4163a5083ac5c6ac2b9) to request MPMS to release the acquired wake lock. This function returns le\_result\_t.

void Relax()
       {
           le_result_t result = taf_mngdPm_Relax(ref);
           if(result == LE_OK)
               LE_INFO("taf_mngdPm_Relax successfully released a acquired wake lock");
       }
    Copy to clipboard

## Wake up the vehicle

TelAF Managed Power Management Service’s client calls [taf\_mngdPm\_WakeupVehicleReqAsync()](https://docs.qualcomm.com/doc/80-41102-2/topic/function_a00581_1a13c30784b00bec10186c3c42cfb4d2c7.html#Documentationa00581_1a13c30784b00bec10186c3c42cfb4d2c7) to request MPMS to wake up the vehicle. This function returns le\_result\_t.

void wakeupVehicleCB(taf_mngdPm_RestartMode_t mode, taf_mngdPm_ResponseMode_t rspmode,
               le_result_t result, void* contextPtr)
       {
           LE_INFO(" wakeupVehicleCB ");
       }
    
       void WakeupVehicleReqAsync()
       {
           le_result_t result = taf_mngdPm_WakeupVehicleReqAsync(VEHICLE_WAKEUP_REASON_DEFAULT,
                    wakeupVehicleCB,NULL);
           if(result == LE_OK) {
               LE_INFO("WakeupVehicleReqAsync request sent successfully");
           }
       }
    Copy to clipboard

## Typical application call flow

**Forced system shutdown**

![../_images/mpms_forced_shutdown.jpeg](data:image/jpeg;base64,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)

The forced system shutdown is triggered from the OEM application depending on MPMS. MPMS coordinates with PM VHAL to achieve the TCU level system shutdown.

#1 — Client requests forceful TCU shutdown. MPMS requests VHAL to confirm whether the shutdown can be accepted or not.

#2 — VHAL will respond if it is ready or not, or if the request is invalid. In a successful forceful shutdown scenario, VHAL will respond in the callback with READY.

#3 — MPMS responds to the client on the confirmation result via the asynchronous callback.

#4 — MPMS notifies PM VHAL to prepare for shutdown which does not require acknowledgement.

#5 — MPMS notifies the OEM client application to prepare for shutdown which requires acknowledgement.

#6 — OEM client application acknowledges that it is prepared to shut down.

#7 — MPMS notifies VHAL for NAD shutdown execution after detecting all notifications are ACKed and VHAL will respond via a callback.

#8 — MPMS executes the NAD Linux shutdown.

Last Published: Jun 09, 2026