plat/xilinx/common/include/pm_common.h

/*
 * Copyright (c) 2013-2018, Arm Limited and Contributors. All rights reserved.
 * Copyright (c) 2022-2025, Advanced Micro Devices, Inc. All rights reserved.
 *
 * SPDX-License-Identifier: BSD-3-Clause
 */

/*
 * Contains definitions of commonly used macros and data types needed
 * for PU Power Management. This file should be common for all PU's.
 */

#ifndef PM_COMMON_H
#define PM_COMMON_H

#include <stdint.h>
#include <plat_pm_common.h>

#if IPI_CRC_CHECK
#define PAYLOAD_ARG_CNT         8U
#define IPI_W0_TO_W6_SIZE       28U
#define PAYLOAD_CRC_POS         7U
#define CRC_INIT_VALUE          0x4F4EU
#define CRC_ORDER               16U
#define CRC_POLYNOM             0x8005U
#else
#define PAYLOAD_ARG_CNT		7U
#endif
#define RET_PAYLOAD_ARG_CNT	6U
#define PAYLOAD_ARG_SIZE	4U	/* size in bytes */

#define TZ_VERSION_MAJOR	1U
#define TZ_VERSION_MINOR	0U
#define TZ_VERSION		(((uint32_t)TZ_VERSION_MAJOR << 16U) | \
				 TZ_VERSION_MINOR)

/**
 * struct pm_ipi - struct for capturing IPI-channel specific info.
 * @local_ipi_id: Local IPI agent ID.
 * @remote_ipi_id: Remote IPI Agent ID.
 * @buffer_base: base address for payload buffer.
 *
 */
struct pm_ipi {
	const uint32_t local_ipi_id;
	const uint32_t remote_ipi_id;
	const uintptr_t buffer_base;
};

/**
 * struct pm_proc - struct for capturing processor related info.
 * @node_id: node-ID of the processor.
 * @pwrdn_mask: cpu-specific mask to be used for power control register.
 * @ipi: pointer to IPI channel structure.
 *       (in APU all processors share one IPI channel)
 *
 */
struct pm_proc {
	const uint32_t node_id;
	const uint32_t pwrdn_mask;
	const struct pm_ipi *ipi;
};

const struct pm_proc *pm_get_proc(uint32_t cpuid);

#endif /* PM_COMMON_H */