1 /* SPDX-License-Identifier: GPL-2.0 */
3 * Xilinx Zynq MPSoC Firmware driver
5 * Copyright (C) 2018-2019 Xilinx, Inc.
8 #ifndef _ZYNQMP_FIRMWARE_H_
9 #define _ZYNQMP_FIRMWARE_H_
12 PM_GET_API_VERSION = 1,
13 PM_SET_CONFIGURATION = 2,
14 PM_GET_NODE_STATUS = 3,
15 PM_GET_OPERATING_CHARACTERISTIC = 4,
16 PM_REGISTER_NOTIFIER = 5,
17 /* API for suspending */
18 PM_REQUEST_SUSPEND = 6,
20 PM_FORCE_POWERDOWN = 8,
22 PM_REQUEST_WAKEUP = 10,
23 PM_SET_WAKEUP_SOURCE = 11,
24 PM_SYSTEM_SHUTDOWN = 12,
27 PM_SET_REQUIREMENT = 15,
28 PM_SET_MAX_LATENCY = 16,
29 /* Direct control API functions: */
31 PM_RESET_GET_STATUS = 18,
34 PM_PM_INIT_FINALIZE = 21,
36 PM_FPGA_GET_STATUS = 23,
38 /* ID 25 is been used by U-boot to process secure boot images */
39 /* Secure library generic API functions */
42 PM_PINCTRL_REQUEST = 28,
43 PM_PINCTRL_RELEASE = 29,
44 PM_PINCTRL_GET_FUNCTION = 30,
45 PM_PINCTRL_SET_FUNCTION = 31,
46 PM_PINCTRL_CONFIG_PARAM_GET = 32,
47 PM_PINCTRL_CONFIG_PARAM_SET = 33,
51 PM_CLOCK_DISABLE = 37,
52 PM_CLOCK_GETSTATE = 38,
53 PM_CLOCK_SETDIVIDER = 39,
54 PM_CLOCK_GETDIVIDER = 40,
55 PM_CLOCK_SETRATE = 41,
56 PM_CLOCK_GETRATE = 42,
57 PM_CLOCK_SETPARENT = 43,
58 PM_CLOCK_GETPARENT = 44,
62 PM_CLOCK_PLL_GETPARAM = 49,
63 /* PM_REGISTER_ACCESS API */
64 PM_REGISTER_ACCESS = 52,
66 PM_FEATURE_CHECK = 63,
152 enum tap_delay_type {
153 PM_TAPDELAY_INPUT = 0,
154 PM_TAPDELAY_OUTPUT = 1,
157 enum dll_reset_type {
158 PM_DLL_RESET_ASSERT = 0,
159 PM_DLL_RESET_RELEASE = 1,
160 PM_DLL_RESET_PULSE = 2,
165 PM_QID_CLOCK_GET_NAME = 1,
166 PM_QID_CLOCK_GET_TOPOLOGY = 2,
167 PM_QID_CLOCK_GET_FIXEDFACTOR_PARAMS = 3,
168 PM_QID_CLOCK_GET_PARENTS = 4,
169 PM_QID_CLOCK_GET_ATTRIBUTES = 5,
170 PM_QID_PINCTRL_GET_NUM_PINS = 6,
171 PM_QID_PINCTRL_GET_NUM_FUNCTIONS = 7,
172 PM_QID_PINCTRL_GET_NUM_FUNCTION_GROUPS = 8,
173 PM_QID_PINCTRL_GET_FUNCTION_NAME = 9,
174 PM_QID_PINCTRL_GET_FUNCTION_GROUPS = 10,
175 PM_QID_PINCTRL_GET_PIN_GROUPS = 11,
176 PM_QID_CLOCK_GET_NUM_CLOCKS = 12,
177 PM_QID_CLOCK_GET_MAX_DIVISOR = 13,
180 enum pm_pinctrl_config_param {
181 PM_PINCTRL_CONFIG_SLEW_RATE = 0,
182 PM_PINCTRL_CONFIG_BIAS_STATUS = 1,
183 PM_PINCTRL_CONFIG_PULL_CTRL = 2,
184 PM_PINCTRL_CONFIG_SCHMITT_CMOS = 3,
185 PM_PINCTRL_CONFIG_DRIVE_STRENGTH = 4,
186 PM_PINCTRL_CONFIG_VOLTAGE_STATUS = 5,
187 PM_PINCTRL_CONFIG_TRI_STATE = 6,
188 PM_PINCTRL_CONFIG_MAX = 7,
191 enum pm_pinctrl_slew_rate {
192 PM_PINCTRL_SLEW_RATE_FAST = 0,
193 PM_PINCTRL_SLEW_RATE_SLOW = 1,
196 enum pm_pinctrl_bias_status {
197 PM_PINCTRL_BIAS_DISABLE = 0,
198 PM_PINCTRL_BIAS_ENABLE = 1,
201 enum pm_pinctrl_pull_ctrl {
202 PM_PINCTRL_BIAS_PULL_DOWN = 0,
203 PM_PINCTRL_BIAS_PULL_UP = 1,
206 enum pm_pinctrl_schmitt_cmos {
207 PM_PINCTRL_INPUT_TYPE_CMOS = 0,
208 PM_PINCTRL_INPUT_TYPE_SCHMITT = 1,
211 enum pm_pinctrl_drive_strength {
212 PM_PINCTRL_DRIVE_STRENGTH_2MA = 0,
213 PM_PINCTRL_DRIVE_STRENGTH_4MA = 1,
214 PM_PINCTRL_DRIVE_STRENGTH_8MA = 2,
215 PM_PINCTRL_DRIVE_STRENGTH_12MA = 3,
218 enum pm_pinctrl_tri_state {
219 PM_PINCTRL_TRI_STATE_DISABLE = 0,
220 PM_PINCTRL_TRI_STATE_ENABLE = 1,
223 enum zynqmp_pm_reset_action {
224 PM_RESET_ACTION_RELEASE = 0,
225 PM_RESET_ACTION_ASSERT = 1,
226 PM_RESET_ACTION_PULSE = 2,
229 enum zynqmp_pm_reset {
230 ZYNQMP_PM_RESET_START = 1000,
231 ZYNQMP_PM_RESET_PCIE_CFG = ZYNQMP_PM_RESET_START,
232 ZYNQMP_PM_RESET_PCIE_BRIDGE = 1001,
233 ZYNQMP_PM_RESET_PCIE_CTRL = 1002,
234 ZYNQMP_PM_RESET_DP = 1003,
235 ZYNQMP_PM_RESET_SWDT_CRF = 1004,
236 ZYNQMP_PM_RESET_AFI_FM5 = 1005,
237 ZYNQMP_PM_RESET_AFI_FM4 = 1006,
238 ZYNQMP_PM_RESET_AFI_FM3 = 1007,
239 ZYNQMP_PM_RESET_AFI_FM2 = 1008,
240 ZYNQMP_PM_RESET_AFI_FM1 = 1009,
241 ZYNQMP_PM_RESET_AFI_FM0 = 1010,
242 ZYNQMP_PM_RESET_GDMA = 1011,
243 ZYNQMP_PM_RESET_GPU_PP1 = 1012,
244 ZYNQMP_PM_RESET_GPU_PP0 = 1013,
245 ZYNQMP_PM_RESET_GPU = 1014,
246 ZYNQMP_PM_RESET_GT = 1015,
247 ZYNQMP_PM_RESET_SATA = 1016,
248 ZYNQMP_PM_RESET_ACPU3_PWRON = 1017,
249 ZYNQMP_PM_RESET_ACPU2_PWRON = 1018,
250 ZYNQMP_PM_RESET_ACPU1_PWRON = 1019,
251 ZYNQMP_PM_RESET_ACPU0_PWRON = 1020,
252 ZYNQMP_PM_RESET_APU_L2 = 1021,
253 ZYNQMP_PM_RESET_ACPU3 = 1022,
254 ZYNQMP_PM_RESET_ACPU2 = 1023,
255 ZYNQMP_PM_RESET_ACPU1 = 1024,
256 ZYNQMP_PM_RESET_ACPU0 = 1025,
257 ZYNQMP_PM_RESET_DDR = 1026,
258 ZYNQMP_PM_RESET_APM_FPD = 1027,
259 ZYNQMP_PM_RESET_SOFT = 1028,
260 ZYNQMP_PM_RESET_GEM0 = 1029,
261 ZYNQMP_PM_RESET_GEM1 = 1030,
262 ZYNQMP_PM_RESET_GEM2 = 1031,
263 ZYNQMP_PM_RESET_GEM3 = 1032,
264 ZYNQMP_PM_RESET_QSPI = 1033,
265 ZYNQMP_PM_RESET_UART0 = 1034,
266 ZYNQMP_PM_RESET_UART1 = 1035,
267 ZYNQMP_PM_RESET_SPI0 = 1036,
268 ZYNQMP_PM_RESET_SPI1 = 1037,
269 ZYNQMP_PM_RESET_SDIO0 = 1038,
270 ZYNQMP_PM_RESET_SDIO1 = 1039,
271 ZYNQMP_PM_RESET_CAN0 = 1040,
272 ZYNQMP_PM_RESET_CAN1 = 1041,
273 ZYNQMP_PM_RESET_I2C0 = 1042,
274 ZYNQMP_PM_RESET_I2C1 = 1043,
275 ZYNQMP_PM_RESET_TTC0 = 1044,
276 ZYNQMP_PM_RESET_TTC1 = 1045,
277 ZYNQMP_PM_RESET_TTC2 = 1046,
278 ZYNQMP_PM_RESET_TTC3 = 1047,
279 ZYNQMP_PM_RESET_SWDT_CRL = 1048,
280 ZYNQMP_PM_RESET_NAND = 1049,
281 ZYNQMP_PM_RESET_ADMA = 1050,
282 ZYNQMP_PM_RESET_GPIO = 1051,
283 ZYNQMP_PM_RESET_IOU_CC = 1052,
284 ZYNQMP_PM_RESET_TIMESTAMP = 1053,
285 ZYNQMP_PM_RESET_RPU_R50 = 1054,
286 ZYNQMP_PM_RESET_RPU_R51 = 1055,
287 ZYNQMP_PM_RESET_RPU_AMBA = 1056,
288 ZYNQMP_PM_RESET_OCM = 1057,
289 ZYNQMP_PM_RESET_RPU_PGE = 1058,
290 ZYNQMP_PM_RESET_USB0_CORERESET = 1059,
291 ZYNQMP_PM_RESET_USB1_CORERESET = 1060,
292 ZYNQMP_PM_RESET_USB0_HIBERRESET = 1061,
293 ZYNQMP_PM_RESET_USB1_HIBERRESET = 1062,
294 ZYNQMP_PM_RESET_USB0_APB = 1063,
295 ZYNQMP_PM_RESET_USB1_APB = 1064,
296 ZYNQMP_PM_RESET_IPI = 1065,
297 ZYNQMP_PM_RESET_APM_LPD = 1066,
298 ZYNQMP_PM_RESET_RTC = 1067,
299 ZYNQMP_PM_RESET_SYSMON = 1068,
300 ZYNQMP_PM_RESET_AFI_FM6 = 1069,
301 ZYNQMP_PM_RESET_LPD_SWDT = 1070,
302 ZYNQMP_PM_RESET_FPD = 1071,
303 ZYNQMP_PM_RESET_RPU_DBG1 = 1072,
304 ZYNQMP_PM_RESET_RPU_DBG0 = 1073,
305 ZYNQMP_PM_RESET_DBG_LPD = 1074,
306 ZYNQMP_PM_RESET_DBG_FPD = 1075,
307 ZYNQMP_PM_RESET_APLL = 1076,
308 ZYNQMP_PM_RESET_DPLL = 1077,
309 ZYNQMP_PM_RESET_VPLL = 1078,
310 ZYNQMP_PM_RESET_IOPLL = 1079,
311 ZYNQMP_PM_RESET_RPLL = 1080,
312 ZYNQMP_PM_RESET_GPO3_PL_0 = 1081,
313 ZYNQMP_PM_RESET_GPO3_PL_1 = 1082,
314 ZYNQMP_PM_RESET_GPO3_PL_2 = 1083,
315 ZYNQMP_PM_RESET_GPO3_PL_3 = 1084,
316 ZYNQMP_PM_RESET_GPO3_PL_4 = 1085,
317 ZYNQMP_PM_RESET_GPO3_PL_5 = 1086,
318 ZYNQMP_PM_RESET_GPO3_PL_6 = 1087,
319 ZYNQMP_PM_RESET_GPO3_PL_7 = 1088,
320 ZYNQMP_PM_RESET_GPO3_PL_8 = 1089,
321 ZYNQMP_PM_RESET_GPO3_PL_9 = 1090,
322 ZYNQMP_PM_RESET_GPO3_PL_10 = 1091,
323 ZYNQMP_PM_RESET_GPO3_PL_11 = 1092,
324 ZYNQMP_PM_RESET_GPO3_PL_12 = 1093,
325 ZYNQMP_PM_RESET_GPO3_PL_13 = 1094,
326 ZYNQMP_PM_RESET_GPO3_PL_14 = 1095,
327 ZYNQMP_PM_RESET_GPO3_PL_15 = 1096,
328 ZYNQMP_PM_RESET_GPO3_PL_16 = 1097,
329 ZYNQMP_PM_RESET_GPO3_PL_17 = 1098,
330 ZYNQMP_PM_RESET_GPO3_PL_18 = 1099,
331 ZYNQMP_PM_RESET_GPO3_PL_19 = 1100,
332 ZYNQMP_PM_RESET_GPO3_PL_20 = 1101,
333 ZYNQMP_PM_RESET_GPO3_PL_21 = 1102,
334 ZYNQMP_PM_RESET_GPO3_PL_22 = 1103,
335 ZYNQMP_PM_RESET_GPO3_PL_23 = 1104,
336 ZYNQMP_PM_RESET_GPO3_PL_24 = 1105,
337 ZYNQMP_PM_RESET_GPO3_PL_25 = 1106,
338 ZYNQMP_PM_RESET_GPO3_PL_26 = 1107,
339 ZYNQMP_PM_RESET_GPO3_PL_27 = 1108,
340 ZYNQMP_PM_RESET_GPO3_PL_28 = 1109,
341 ZYNQMP_PM_RESET_GPO3_PL_29 = 1110,
342 ZYNQMP_PM_RESET_GPO3_PL_30 = 1111,
343 ZYNQMP_PM_RESET_GPO3_PL_31 = 1112,
344 ZYNQMP_PM_RESET_RPU_LS = 1113,
345 ZYNQMP_PM_RESET_PS_ONLY = 1114,
346 ZYNQMP_PM_RESET_PL = 1115,
347 ZYNQMP_PM_RESET_PS_PL0 = 1116,
348 ZYNQMP_PM_RESET_PS_PL1 = 1117,
349 ZYNQMP_PM_RESET_PS_PL2 = 1118,
350 ZYNQMP_PM_RESET_PS_PL3 = 1119,
351 ZYNQMP_PM_RESET_END = ZYNQMP_PM_RESET_PS_PL3
355 IOCTL_GET_RPU_OPER_MODE = 0,
356 IOCTL_SET_RPU_OPER_MODE = 1,
357 IOCTL_RPU_BOOT_ADDR_CONFIG = 2,
358 IOCTL_TCM_COMB_CONFIG = 3,
359 IOCTL_SET_TAPDELAY_BYPASS = 4,
360 IOCTL_SET_SGMII_MODE = 5,
361 IOCTL_SD_DLL_RESET = 6,
362 IOCTL_SET_SD_TAPDELAY = 7,
363 IOCTL_SET_PLL_FRAC_MODE = 8,
364 IOCTL_GET_PLL_FRAC_MODE = 9,
365 IOCTL_SET_PLL_FRAC_DATA = 10,
366 IOCTL_GET_PLL_FRAC_DATA = 11,
367 IOCTL_WRITE_GGS = 12,
369 IOCTL_WRITE_PGGS = 14,
370 IOCTL_READ_PGGS = 15,
371 /* IOCTL for ULPI reset */
372 IOCTL_ULPI_RESET = 16,
373 /* Set healthy bit value*/
374 IOCTL_SET_BOOT_HEALTH_STATUS = 17,
376 /* Probe counter read/write */
377 IOCTL_PROBE_COUNTER_READ = 19,
378 IOCTL_PROBE_COUNTER_WRITE = 20,
379 IOCTL_OSPI_MUX_SELECT = 21,
380 /* IOCTL for USB power request */
381 IOCTL_USB_SET_STATE = 22,
382 /* IOCTL to get last reset reason */
383 IOCTL_GET_LAST_RESET_REASON = 23,
385 IOCTL_AIE_ISR_CLEAR = 24,
386 /* Register SGI to ATF */
387 IOCTL_REGISTER_SGI = 25,
388 /* Runtime feature configuration */
389 IOCTL_SET_FEATURE_CONFIG = 26,
390 IOCTL_GET_FEATURE_CONFIG = 27,
391 /* IOCTL for Secure Read/Write Interface */
393 IOCTL_MASK_WRITE_REG = 29,
394 /* Dynamic SD/GEM/USB configuration */
395 IOCTL_SET_SD_CONFIG = 30,
396 IOCTL_SET_GEM_CONFIG = 31,
397 IOCTL_SET_USB_CONFIG = 32,
398 /* AIE/AIEML Operations */
400 /* IOCTL to get default/current QoS */
404 enum pm_sd_config_type {
405 SD_CONFIG_EMMC_SEL = 1, /* To set SD_EMMC_SEL in CTRL_REG_SD */
406 SD_CONFIG_BASECLK = 2, /* To set SD_BASECLK in SD_CONFIG_REG1 */
407 SD_CONFIG_8BIT = 3, /* To set SD_8BIT in SD_CONFIG_REG2 */
408 SD_CONFIG_FIXED = 4, /* To set fixed config registers */
411 enum pm_gem_config_type {
412 GEM_CONFIG_SGMII_MODE = 1, /* To set GEM_SGMII_MODE in GEM_CLK_CTRL */
413 GEM_CONFIG_FIXED = 2, /* To set fixed config registers */
416 #define PM_SIP_SVC 0xc2000000
418 #define ZYNQMP_PM_VERSION_MAJOR 1
419 #define ZYNQMP_PM_VERSION_MINOR 0
420 #define ZYNQMP_PM_VERSION_MAJOR_SHIFT 16
421 #define ZYNQMP_PM_VERSION_MINOR_MASK 0xFFFF
423 #define ZYNQMP_PM_VERSION \
424 ((ZYNQMP_PM_VERSION_MAJOR << ZYNQMP_PM_VERSION_MAJOR_SHIFT) | \
425 ZYNQMP_PM_VERSION_MINOR)
427 #define ZYNQMP_PM_VERSION_INVALID ~0
429 #define PMUFW_V1_0 ((1 << ZYNQMP_PM_VERSION_MAJOR_SHIFT) | 0)
432 * Return payload size
433 * Not every firmware call expects the same amount of return bytes, however the
434 * firmware driver always copies 5 bytes from RX buffer to the ret_payload
435 * buffer. Therefore allocating with this defined value is recommended to avoid
438 #define PAYLOAD_ARG_CNT 5U
440 unsigned int zynqmp_firmware_version(void);
441 int zynqmp_pmufw_node(u32 id);
442 int zynqmp_pmufw_config_close(void);
443 void zynqmp_pmufw_load_config_object(const void *cfg_obj, size_t size);
444 int xilinx_pm_request(u32 api_id, u32 arg0, u32 arg1, u32 arg2,
445 u32 arg3, u32 *ret_payload);
446 int zynqmp_pm_set_sd_config(u32 node, enum pm_sd_config_type config, u32 value);
447 int zynqmp_pm_set_gem_config(u32 node, enum pm_gem_config_type config,
449 int zynqmp_pm_is_function_supported(const u32 api_id, const u32 id);
451 /* Type of Config Object */
452 #define PM_CONFIG_OBJECT_TYPE_BASE 0x1U
453 #define PM_CONFIG_OBJECT_TYPE_OVERLAY 0x2U
456 #define PM_CONFIG_SLAVE_SECTION_ID 0x102U
457 #define PM_CONFIG_SET_CONFIG_SECTION_ID 0x107U
460 #define PM_SLAVE_FLAG_IS_SHAREABLE 0x1U
461 #define PM_MASTER_USING_SLAVE_MASK 0x2U
463 /* IPI Mask for Master */
464 #define PM_CONFIG_IPI_PSU_CORTEXA53_0_MASK 0x00000001
465 #define PM_CONFIG_IPI_PSU_CORTEXR5_0_MASK 0x00000100
466 #define PM_CONFIG_IPI_PSU_CORTEXR5_1_MASK 0x00000200
468 enum zynqmp_pm_request_ack {
469 ZYNQMP_PM_REQUEST_ACK_NO = 1,
470 ZYNQMP_PM_REQUEST_ACK_BLOCKING = 2,
471 ZYNQMP_PM_REQUEST_ACK_NON_BLOCKING = 3,
474 /* Node capabilities */
475 #define ZYNQMP_PM_CAPABILITY_ACCESS 0x1U
476 #define ZYNQMP_PM_CAPABILITY_CONTEXT 0x2U
477 #define ZYNQMP_PM_CAPABILITY_WAKEUP 0x4U
478 #define ZYNQMP_PM_CAPABILITY_UNUSABLE 0x8U
480 #define ZYNQMP_PM_MAX_QOS 100U
481 /* Firmware feature check version mask */
482 #define FIRMWARE_VERSION_MASK GENMASK(15, 0)
483 /* PM API versions */
484 #define PM_API_VERSION_2 2
486 #endif /* _ZYNQMP_FIRMWARE_H_ */