1 /* 2 * Copyright (c) 2018-2020, Arm Limited and Contributors. All rights reserved. 3 * Copyright (c) 2022-2025, Advanced Micro Devices, Inc. All rights reserved. 4 * 5 * SPDX-License-Identifier: BSD-3-Clause 6 */ 7 8 /* 9 * ZynqMP system level PM-API functions for clock control. 10 */ 11 12 #ifndef PM_API_CLOCK_H 13 #define PM_API_CLOCK_H 14 15 #include <lib/utils_def.h> 16 17 #include "pm_common.h" 18 19 #define CLK_NAME_LEN (16U) 20 #define MAX_PARENTS (100U) 21 #define CLK_NA_PARENT -1 22 #define CLK_DUMMY_PARENT -2 23 24 /* Flags for parent id */ 25 #define PARENT_CLK_SELF (0U) 26 #define PARENT_CLK_NODE1 (1U) 27 #define PARENT_CLK_NODE2 (2U) 28 #define PARENT_CLK_NODE3 (3U) 29 #define PARENT_CLK_NODE4 (4U) 30 #define PARENT_CLK_EXTERNAL (5U) 31 #define PARENT_CLK_MIO0_MIO77 (6U) 32 33 #define CLK_SET_RATE_GATE BIT(0) /* must be gated across rate change */ 34 #define CLK_SET_PARENT_GATE BIT(1) /* must be gated across re-parent */ 35 #define CLK_SET_RATE_PARENT BIT(2) /* propagate rate change up one level */ 36 #define CLK_IGNORE_UNUSED BIT(3) /* do not gate even if unused */ 37 /* unused */ 38 #define CLK_IS_BASIC BIT(5) /* Basic clk, can't do a to_clk_foo() */ 39 #define CLK_GET_RATE_NOCACHE BIT(6) /* do not use the cached clk rate */ 40 #define CLK_SET_RATE_NO_REPARENT BIT(7) /* don't re-parent on rate change */ 41 #define CLK_GET_ACCURACY_NOCACHE BIT(8) /* do not use the cached clk accuracy */ 42 #define CLK_RECALC_NEW_RATES BIT(9) /* recalc rates after notifications */ 43 #define CLK_SET_RATE_UNGATE BIT(10) /* clock needs to run to set rate */ 44 #define CLK_IS_CRITICAL BIT(11) /* do not gate, ever */ 45 /* parents need enable during gate/ungate, set rate and re-parent */ 46 #define CLK_OPS_PARENT_ENABLE BIT(12) 47 48 #define CLK_DIVIDER_ONE_BASED BIT(0) 49 #define CLK_DIVIDER_POWER_OF_TWO BIT(1) 50 #define CLK_DIVIDER_ALLOW_ZERO BIT(2) 51 #define CLK_DIVIDER_HIWORD_MASK BIT(3) 52 #define CLK_DIVIDER_ROUND_CLOSEST BIT(4) 53 #define CLK_DIVIDER_READ_ONLY BIT(5) 54 #define CLK_DIVIDER_MAX_AT_ZERO BIT(6) 55 #define CLK_FRAC BIT(8) 56 57 #define END_OF_CLK "END_OF_CLK" 58 59 //CLock Ids 60 enum clock_id { 61 CLK_IOPLL = (0U), 62 CLK_RPLL = (1U), 63 CLK_APLL = (2U), 64 CLK_DPLL = (3U), 65 CLK_VPLL = (4U), 66 CLK_IOPLL_TO_FPD = (5U), 67 CLK_RPLL_TO_FPD = (6U), 68 CLK_APLL_TO_LPD = (7U), 69 CLK_DPLL_TO_LPD = (8U), 70 CLK_VPLL_TO_LPD = (9U), 71 CLK_ACPU = (10U), 72 CLK_ACPU_HALF = (11U), 73 CLK_DBG_FPD = (12U), 74 CLK_DBG_LPD = (13U), 75 CLK_DBG_TRACE = (14U), 76 CLK_DBG_TSTMP = (15U), 77 CLK_DP_VIDEO_REF = (16U), 78 CLK_DP_AUDIO_REF = (17U), 79 CLK_DP_STC_REF = (18U), 80 CLK_GDMA_REF = (19U), 81 CLK_DPDMA_REF = (20U), 82 CLK_DDR_REF = (21U), 83 CLK_SATA_REF = (22U), 84 CLK_PCIE_REF = (23U), 85 CLK_GPU_REF = (24U), 86 CLK_GPU_PP0_REF = (25U), 87 CLK_GPU_PP1_REF = (26U), 88 CLK_TOPSW_MAIN = (27U), 89 CLK_TOPSW_LSBUS = (28U), 90 CLK_GTGREF0_REF = (29U), 91 CLK_LPD_SWITCH = (30U), 92 CLK_LPD_LSBUS = (31U), 93 CLK_USB0_BUS_REF = (32U), 94 CLK_USB1_BUS_REF = (33U), 95 CLK_USB3_DUAL_REF = (34U), 96 CLK_USB0 = (35U), 97 CLK_USB1 = (36U), 98 CLK_CPU_R5 = (37U), 99 CLK_CPU_R5_CORE = (38U), 100 CLK_CSU_SPB = (39U), 101 CLK_CSU_PLL = (40U), 102 CLK_PCAP = (41U), 103 CLK_IOU_SWITCH = (42U), 104 CLK_GEM_TSU_REF = (43U), 105 CLK_GEM_TSU = (44U), 106 CLK_GEM0_TX = (45U), 107 CLK_GEM1_TX = (46U), 108 CLK_GEM2_TX = (47U), 109 CLK_GEM3_TX = (48U), 110 CLK_GEM0_RX = (49U), 111 CLK_GEM1_RX = (50U), 112 CLK_GEM2_RX = (51U), 113 CLK_GEM3_RX = (52U), 114 CLK_QSPI_REF = (53U), 115 CLK_SDIO0_REF = (54U), 116 CLK_SDIO1_REF = (55U), 117 CLK_UART0_REF = (56U), 118 CLK_UART1_REF = (57U), 119 CLK_SPI0_REF = (58U), 120 CLK_SPI1_REF = (59U), 121 CLK_NAND_REF = (60U), 122 CLK_I2C0_REF = (61U), 123 CLK_I2C1_REF = (62U), 124 CLK_CAN0_REF = (63U), 125 CLK_CAN1_REF = (64U), 126 CLK_CAN0 = (65U), 127 CLK_CAN1 = (66U), 128 CLK_DLL_REF = (67U), 129 CLK_ADMA_REF = (68U), 130 CLK_TIMESTAMP_REF = (69U), 131 CLK_AMS_REF = (70U), 132 CLK_PL0_REF = (71U), 133 CLK_PL1_REF = (72U), 134 CLK_PL2_REF = (73U), 135 CLK_PL3_REF = (74U), 136 CLK_FPD_WDT = (75U), 137 CLK_IOPLL_INT = (76U), 138 CLK_IOPLL_PRE_SRC = (77U), 139 CLK_IOPLL_HALF = (78U), 140 CLK_IOPLL_INT_MUX = (79U), 141 CLK_IOPLL_POST_SRC = (80U), 142 CLK_RPLL_INT = (81U), 143 CLK_RPLL_PRE_SRC = (82U), 144 CLK_RPLL_HALF = (83U), 145 CLK_RPLL_INT_MUX = (84U), 146 CLK_RPLL_POST_SRC = (85U), 147 CLK_APLL_INT = (86U), 148 CLK_APLL_PRE_SRC = (87U), 149 CLK_APLL_HALF = (88U), 150 CLK_APLL_INT_MUX = (89U), 151 CLK_APLL_POST_SRC = (90U), 152 CLK_DPLL_INT = (91U), 153 CLK_DPLL_PRE_SRC = (92U), 154 CLK_DPLL_HALF = (93U), 155 CLK_DPLL_INT_MUX = (94U), 156 CLK_DPLL_POST_SRC = (95U), 157 CLK_VPLL_INT = (96U), 158 CLK_VPLL_PRE_SRC = (97U), 159 CLK_VPLL_HALF = (98U), 160 CLK_VPLL_INT_MUX = (99U), 161 CLK_VPLL_POST_SRC = (100U), 162 CLK_CAN0_MIO = (101U), 163 CLK_CAN1_MIO = (102U), 164 CLK_ACPU_FULL = (103U), 165 CLK_GEM0_REF = (104U), 166 CLK_GEM1_REF = (105U), 167 CLK_GEM2_REF = (106U), 168 CLK_GEM3_REF = (107U), 169 CLK_GEM0_REF_UNGATED = (108U), 170 CLK_GEM1_REF_UNGATED = (109U), 171 CLK_GEM2_REF_UNGATED = (110U), 172 CLK_GEM3_REF_UNGATED = (111U), 173 CLK_LPD_WDT = (112U), 174 END_OF_OUTPUT_CLKS = (113U), 175 }; 176 177 #define CLK_MAX_OUTPUT_CLK END_OF_OUTPUT_CLKS 178 179 //External clock ids 180 enum { 181 EXT_CLK_PSS_REF = END_OF_OUTPUT_CLKS, 182 EXT_CLK_VIDEO = (114U), 183 EXT_CLK_PSS_ALT_REF = (115U), 184 EXT_CLK_AUX_REF = (116U), 185 EXT_CLK_GT_CRX_REF = (117U), 186 EXT_CLK_SWDT0 = (118U), 187 EXT_CLK_SWDT1 = (119U), 188 EXT_CLK_GEM0_TX_EMIO = (120U), 189 EXT_CLK_GEM1_TX_EMIO = (121U), 190 EXT_CLK_GEM2_TX_EMIO = (122U), 191 EXT_CLK_GEM3_TX_EMIO = (123U), 192 EXT_CLK_GEM0_RX_EMIO = (124U), 193 EXT_CLK_GEM1_RX_EMIO = (125U), 194 EXT_CLK_GEM2_RX_EMIO = (126U), 195 EXT_CLK_GEM3_RX_EMIO = (127U), 196 EXT_CLK_MIO50_OR_MIO51 = (128U), 197 EXT_CLK_MIO0 = (129U), 198 EXT_CLK_MIO1 = (130U), 199 EXT_CLK_MIO2 = (131U), 200 EXT_CLK_MIO3 = (132U), 201 EXT_CLK_MIO4 = (133U), 202 EXT_CLK_MIO5 = (134U), 203 EXT_CLK_MIO6 = (135U), 204 EXT_CLK_MIO7 = (136U), 205 EXT_CLK_MIO8 = (137U), 206 EXT_CLK_MIO9 = (138U), 207 EXT_CLK_MIO10 = (139U), 208 EXT_CLK_MIO11 = (140U), 209 EXT_CLK_MIO12 = (141U), 210 EXT_CLK_MIO13 = (142U), 211 EXT_CLK_MIO14 = (143U), 212 EXT_CLK_MIO15 = (144U), 213 EXT_CLK_MIO16 = (145U), 214 EXT_CLK_MIO17 = (146U), 215 EXT_CLK_MIO18 = (147U), 216 EXT_CLK_MIO19 = (148U), 217 EXT_CLK_MIO20 = (149U), 218 EXT_CLK_MIO21 = (150U), 219 EXT_CLK_MIO22 = (151U), 220 EXT_CLK_MIO23 = (152U), 221 EXT_CLK_MIO24 = (153U), 222 EXT_CLK_MIO25 = (154U), 223 EXT_CLK_MIO26 = (155U), 224 EXT_CLK_MIO27 = (156U), 225 EXT_CLK_MIO28 = (157U), 226 EXT_CLK_MIO29 = (158U), 227 EXT_CLK_MIO30 = (159U), 228 EXT_CLK_MIO31 = (160U), 229 EXT_CLK_MIO32 = (161U), 230 EXT_CLK_MIO33 = (162U), 231 EXT_CLK_MIO34 = (163U), 232 EXT_CLK_MIO35 = (164U), 233 EXT_CLK_MIO36 = (165U), 234 EXT_CLK_MIO37 = (166U), 235 EXT_CLK_MIO38 = (167U), 236 EXT_CLK_MIO39 = (168U), 237 EXT_CLK_MIO40 = (169U), 238 EXT_CLK_MIO41 = (170U), 239 EXT_CLK_MIO42 = (171U), 240 EXT_CLK_MIO43 = (172U), 241 EXT_CLK_MIO44 = (173U), 242 EXT_CLK_MIO45 = (174U), 243 EXT_CLK_MIO46 = (175U), 244 EXT_CLK_MIO47 = (176U), 245 EXT_CLK_MIO48 = (177U), 246 EXT_CLK_MIO49 = (178U), 247 EXT_CLK_MIO50 = (179U), 248 EXT_CLK_MIO51 = (180U), 249 EXT_CLK_MIO52 = (181U), 250 EXT_CLK_MIO53 = (182U), 251 EXT_CLK_MIO54 = (183U), 252 EXT_CLK_MIO55 = (184U), 253 EXT_CLK_MIO56 = (185U), 254 EXT_CLK_MIO57 = (186U), 255 EXT_CLK_MIO58 = (187U), 256 EXT_CLK_MIO59 = (188U), 257 EXT_CLK_MIO60 = (189U), 258 EXT_CLK_MIO61 = (190U), 259 EXT_CLK_MIO62 = (191U), 260 EXT_CLK_MIO63 = (192U), 261 EXT_CLK_MIO64 = (193U), 262 EXT_CLK_MIO65 = (194U), 263 EXT_CLK_MIO66 = (195U), 264 EXT_CLK_MIO67 = (196U), 265 EXT_CLK_MIO68 = (197U), 266 EXT_CLK_MIO69 = (198U), 267 EXT_CLK_MIO70 = (199U), 268 EXT_CLK_MIO71 = (200U), 269 EXT_CLK_MIO72 = (201U), 270 EXT_CLK_MIO73 = (202U), 271 EXT_CLK_MIO74 = (203U), 272 EXT_CLK_MIO75 = (204U), 273 EXT_CLK_MIO76 = (205U), 274 EXT_CLK_MIO77 = (206U), 275 END_OF_CLKS = (207U), 276 }; 277 278 #define CLK_MAX END_OF_CLKS 279 280 //CLock types 281 #define CLK_TYPE_OUTPUT 0U 282 #define CLK_TYPE_EXTERNAL 1U 283 284 //Topology types 285 #define TYPE_INVALID 0U 286 #define TYPE_MUX 1U 287 #define TYPE_PLL 2U 288 #define TYPE_FIXEDFACTOR 3U 289 #define TYPE_DIV1 4U 290 #define TYPE_DIV2 5U 291 #define TYPE_GATE 6U 292 293 struct pm_pll; 294 struct pm_pll *pm_clock_get_pll(enum clock_id clock_id); 295 struct pm_pll *pm_clock_get_pll_by_related_clk(enum clock_id clock_id); 296 uint8_t pm_clock_has_div(uint32_t clock_id, enum pm_clock_div_id div_id); 297 298 void pm_api_clock_get_name(uint32_t clock_id, char *name); 299 enum pm_ret_status pm_api_clock_get_num_clocks(uint32_t *nclocks); 300 enum pm_ret_status pm_api_clock_get_topology(uint32_t clock_id, 301 uint32_t index, 302 uint32_t *topology); 303 enum pm_ret_status pm_api_clock_get_fixedfactor_params(uint32_t clock_id, 304 uint32_t *mul, 305 uint32_t *div); 306 enum pm_ret_status pm_api_clock_get_parents(uint32_t clock_id, 307 uint32_t index, 308 uint32_t *parents); 309 enum pm_ret_status pm_api_clock_get_attributes(uint32_t clock_id, 310 uint32_t *attr); 311 enum pm_ret_status pm_api_clock_get_max_divisor(enum clock_id clock_id, 312 uint8_t div_type, 313 uint32_t *max_div); 314 315 enum pm_ret_status pm_clock_get_pll_node_id(enum clock_id clock_id, 316 enum pm_node_id *node_id); 317 enum pm_ret_status pm_clock_id_is_valid(uint32_t clock_id); 318 319 enum pm_ret_status pm_clock_pll_enable(struct pm_pll *pll, uint32_t flag); 320 enum pm_ret_status pm_clock_pll_disable(struct pm_pll *pll, uint32_t flag); 321 enum pm_ret_status pm_clock_pll_get_state(struct pm_pll *pll, 322 uint32_t *state, 323 uint32_t flag); 324 enum pm_ret_status pm_clock_pll_set_parent(struct pm_pll *pll, 325 enum clock_id clock_id, 326 uint32_t parent_index, 327 uint32_t flag); 328 enum pm_ret_status pm_clock_pll_get_parent(struct pm_pll *pll, 329 enum clock_id clock_id, 330 uint32_t *parent_index, 331 uint32_t flag); 332 enum pm_ret_status pm_clock_set_pll_mode(enum clock_id clock_id, 333 uint32_t mode); 334 enum pm_ret_status pm_clock_get_pll_mode(enum clock_id clock_id, 335 uint32_t *mode); 336 337 #endif /* PM_API_CLOCK_H */ 338