XPm_ForcePowerDown - XPm_ForcePowerDown - 2025.2 English - UG643

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

Document ID
UG643
Release Date
2025-11-20
Version
2025.2 English

This function is used by PU to request a forced poweroff of another PU, power island, or power domain. This can be used for killing an unresponsive PU, in which case all resources of that PU is automatically released.

Note: Force power down may not be requested by a PU for itself.

Prototype

XStatus XPm_ForcePowerDown(const u32 TargetDevId, const u32 Ack);

Parameters

The following table lists the XPm_ForcePowerDown function arguments.

Table 1. XPm_ForcePowerDown Arguments
Type Name Description
const u32 TargetDevId Device ID of the PU node to be forced powered down.
const u32 Ack Requested acknowledge type

Returns

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