uapi/linux/psci.h

1 /* SPDX-License-Identifier: GPL-2.0 WITH Linux-syscall-note */
3  * ARM Power State and Coordination Interface (PSCI) header
5  * This header holds common PSCI defines and macros shared
16  * PSCI v0.1 interface
18  * The PSCI v0.1 function numbers are implementation defined.
20  * Only PSCI return values such as: SUCCESS, NOT_SUPPORTED,
22  * to PSCI v0.1.
25 /* PSCI v0.2 interface */
26 #define PSCI_0_2_FN_BASE			0x84000000
28 #define PSCI_0_2_64BIT				0x40000000
33 #define PSCI_0_2_FN_PSCI_VERSION		PSCI_0_2_FN(0)
58 /* PSCI v0.2 power state encoding for CPU_SUSPEND function */
59 #define PSCI_0_2_POWER_STATE_ID_MASK		0xffff
60 #define PSCI_0_2_POWER_STATE_ID_SHIFT		0
63 				(0x1 << PSCI_0_2_POWER_STATE_TYPE_SHIFT)
66 				(0x3 << PSCI_0_2_POWER_STATE_AFFL_SHIFT)
68 /* PSCI extended power state encoding for CPU_SUSPEND function */
69 #define PSCI_1_0_EXT_POWER_STATE_ID_MASK	0xfffffff
70 #define PSCI_1_0_EXT_POWER_STATE_ID_SHIFT	0
73 				(0x1 << PSCI_1_0_EXT_POWER_STATE_TYPE_SHIFT)
75 /* PSCI v0.2 affinity level state returned by AFFINITY_INFO */
76 #define PSCI_0_2_AFFINITY_LEVEL_ON		0
80 /* PSCI v0.2 multicore support in Trusted OS returned by MIGRATE_INFO_TYPE */
81 #define PSCI_0_2_TOS_UP_MIGRATE			0
85 /* PSCI version decoding (independent of PSCI version) */
88 		((1U << PSCI_VERSION_MAJOR_SHIFT) - 1)
98 /* PSCI features decoding (>=1.0) */
101 			(0x1 << PSCI_1_0_FEATURES_CPU_SUSPEND_PF_SHIFT)
103 #define PSCI_1_0_OS_INITIATED			BIT(0)
104 #define PSCI_1_0_SUSPEND_MODE_PC		0
107 /* PSCI return values (inclusive of all PSCI versions) */
108 #define PSCI_RET_SUCCESS			0
109 #define PSCI_RET_NOT_SUPPORTED			-1
110 #define PSCI_RET_INVALID_PARAMS			-2
111 #define PSCI_RET_DENIED				-3
112 #define PSCI_RET_ALREADY_ON			-4
113 #define PSCI_RET_ON_PENDING			-5
114 #define PSCI_RET_INTERNAL_FAILURE		-6
115 #define PSCI_RET_NOT_PRESENT			-7
116 #define PSCI_RET_DISABLED			-8
117 #define PSCI_RET_INVALID_ADDRESS		-9