XPm_SelfSuspend - XPm_SelfSuspend - 2026.1 English - UG643

Standalone Library Documentation: BSP and Libraries Document Collection (UG643)

Document ID
UG643
Release Date
2026-06-23
Version
2026.1 English

This function is used by a CPU to declare that it is about to suspend itself. After the PMU processes this call, it waits for the requesting CPU to complete the suspend procedure and is ready to put into a sleep state.

Note: This is a blocking call, it returns only once PMU has responded

Prototype

XStatus XPm_SelfSuspend(const enum XPmNodeId nid, const u32 latency, const u8 state, const u64 address);

Parameters

The following table lists the XPm_SelfSuspend function arguments.

Table 1. XPm_SelfSuspend Arguments
Type Name Description
const enum XPmNodeId nid Node ID of the CPU node to be suspended.
const u32 latency Maximum wake-up latency requirement in us(microsecs)
const u8 state Instead of specifying a maximum latency, a CPU can also explicitly request a certain power state.
const u64 address Address from which to resume when woken up.

Returns

XST_SUCCESS if successful else XST_FAILURE or an error code or a reason code