1 /* 2 * Copyright (c) 2015-2024, Arm Limited and Contributors. All rights reserved. 3 * 4 * SPDX-License-Identifier: BSD-3-Clause 5 */ 6 7 #ifndef GICV3_H 8 #define GICV3_H 9 10 /******************************************************************************* 11 * GICv3 and 3.1 miscellaneous definitions 12 ******************************************************************************/ 13 /* Interrupt group definitions */ 14 #define INTR_GROUP1S U(0) 15 #define INTR_GROUP0 U(1) 16 #define INTR_GROUP1NS U(2) 17 18 /* Interrupt IDs reported by the HPPIR and IAR registers */ 19 #define PENDING_G1S_INTID U(1020) 20 #define PENDING_G1NS_INTID U(1021) 21 22 /* Constant to categorize LPI interrupt */ 23 #define MIN_LPI_ID U(8192) 24 25 /* GICv3 can only target up to 16 PEs with SGI */ 26 #define GICV3_MAX_SGI_TARGETS U(16) 27 28 /* PPIs INTIDs 16-31 */ 29 #define MAX_PPI_ID U(31) 30 31 #if GIC_EXT_INTID 32 33 /* GICv3.1 extended PPIs INTIDs 1056-1119 */ 34 #define MIN_EPPI_ID U(1056) 35 #define MAX_EPPI_ID U(1119) 36 37 /* Total number of GICv3.1 EPPIs */ 38 #define TOTAL_EPPI_INTR_NUM (MAX_EPPI_ID - MIN_EPPI_ID + U(1)) 39 40 /* Total number of GICv3.1 PPIs and EPPIs */ 41 #define TOTAL_PRIVATE_INTR_NUM (TOTAL_PCPU_INTR_NUM + TOTAL_EPPI_INTR_NUM) 42 43 /* GICv3.1 extended SPIs INTIDs 4096 - 5119 */ 44 #define MIN_ESPI_ID U(4096) 45 #define MAX_ESPI_ID U(5119) 46 47 /* Total number of GICv3.1 ESPIs */ 48 #define TOTAL_ESPI_INTR_NUM (MAX_ESPI_ID - MIN_ESPI_ID + U(1)) 49 50 /* Total number of GICv3.1 SPIs and ESPIs */ 51 #define TOTAL_SHARED_INTR_NUM (TOTAL_SPI_INTR_NUM + TOTAL_ESPI_INTR_NUM) 52 53 /* SGIs: 0-15, PPIs: 16-31, EPPIs: 1056-1119 */ 54 #define IS_SGI_PPI(id) (((id) <= MAX_PPI_ID) || \ 55 (((id) >= MIN_EPPI_ID) && \ 56 ((id) <= MAX_EPPI_ID))) 57 58 /* SPIs: 32-1019, ESPIs: 4096-5119 */ 59 #define IS_SPI(id) ((((id) >= MIN_SPI_ID) && \ 60 ((id) <= MAX_SPI_ID)) || \ 61 (((id) >= MIN_ESPI_ID) && \ 62 ((id) <= MAX_ESPI_ID))) 63 #else /* GICv3 */ 64 65 /* Total number of GICv3 PPIs */ 66 #define TOTAL_PRIVATE_INTR_NUM TOTAL_PCPU_INTR_NUM 67 68 /* Total number of GICv3 SPIs */ 69 #define TOTAL_SHARED_INTR_NUM TOTAL_SPI_INTR_NUM 70 71 /* SGIs: 0-15, PPIs: 16-31 */ 72 #define IS_SGI_PPI(id) ((id) <= MAX_PPI_ID) 73 74 /* SPIs: 32-1019 */ 75 #define IS_SPI(id) (((id) >= MIN_SPI_ID) && ((id) <= MAX_SPI_ID)) 76 77 #endif /* GIC_EXT_INTID */ 78 79 #define GIC_REV(r, p) ((r << 4) | p) 80 81 /******************************************************************************* 82 * GICv3 and 3.1 specific Distributor interface register offsets and constants 83 ******************************************************************************/ 84 #define GICD_TYPER2 U(0x0c) 85 #define GICD_STATUSR U(0x10) 86 #define GICD_SETSPI_NSR U(0x40) 87 #define GICD_CLRSPI_NSR U(0x48) 88 #define GICD_SETSPI_SR U(0x50) 89 #define GICD_CLRSPI_SR U(0x58) 90 #define GICD_IGRPMODR U(0xd00) 91 #define GICD_IGROUPRE U(0x1000) 92 #define GICD_ISENABLERE U(0x1200) 93 #define GICD_ICENABLERE U(0x1400) 94 #define GICD_ISPENDRE U(0x1600) 95 #define GICD_ICPENDRE U(0x1800) 96 #define GICD_ISACTIVERE U(0x1a00) 97 #define GICD_ICACTIVERE U(0x1c00) 98 #define GICD_IPRIORITYRE U(0x2000) 99 #define GICD_ICFGRE U(0x3000) 100 #define GICD_IGRPMODRE U(0x3400) 101 #define GICD_NSACRE U(0x3600) 102 /* 103 * GICD_IROUTER<n> register is at 0x6000 + 8n, where n is the interrupt ID 104 * and n >= 32, making the effective offset as 0x6100 105 */ 106 #define GICD_IROUTER U(0x6000) 107 #define GICD_IROUTERE U(0x8000) 108 109 #define GICD_PIDR0_GICV3 U(0xffe0) 110 #define GICD_PIDR1_GICV3 U(0xffe4) 111 #define GICD_PIDR2_GICV3 U(0xffe8) 112 113 #define IGRPMODR_SHIFT 5 114 115 /* GICD_CTLR bit definitions */ 116 #define CTLR_ENABLE_G1NS_SHIFT 1 117 #define CTLR_ENABLE_G1S_SHIFT 2 118 #define CTLR_ARE_S_SHIFT 4 119 #define CTLR_ARE_NS_SHIFT 5 120 #define CTLR_DS_SHIFT 6 121 #define CTLR_E1NWF_SHIFT 7 122 #define GICD_CTLR_RWP_SHIFT 31 123 124 #define CTLR_ENABLE_G1NS_MASK U(0x1) 125 #define CTLR_ENABLE_G1S_MASK U(0x1) 126 #define CTLR_ARE_S_MASK U(0x1) 127 #define CTLR_ARE_NS_MASK U(0x1) 128 #define CTLR_DS_MASK U(0x1) 129 #define CTLR_E1NWF_MASK U(0x1) 130 #define GICD_CTLR_RWP_MASK U(0x1) 131 132 #define CTLR_ENABLE_G1NS_BIT BIT_32(CTLR_ENABLE_G1NS_SHIFT) 133 #define CTLR_ENABLE_G1S_BIT BIT_32(CTLR_ENABLE_G1S_SHIFT) 134 #define CTLR_ARE_S_BIT BIT_32(CTLR_ARE_S_SHIFT) 135 #define CTLR_ARE_NS_BIT BIT_32(CTLR_ARE_NS_SHIFT) 136 #define CTLR_DS_BIT BIT_32(CTLR_DS_SHIFT) 137 #define CTLR_E1NWF_BIT BIT_32(CTLR_E1NWF_SHIFT) 138 #define GICD_CTLR_RWP_BIT BIT_32(GICD_CTLR_RWP_SHIFT) 139 140 /* GICD_IROUTER shifts and masks */ 141 #define IROUTER_SHIFT 0 142 #define IROUTER_IRM_SHIFT 31 143 #define IROUTER_IRM_MASK U(0x1) 144 145 #define GICV3_IRM_PE U(0) 146 #define GICV3_IRM_ANY U(1) 147 148 #define NUM_OF_DIST_REGS 30 149 150 /* GICD_TYPER shifts and masks */ 151 #define TYPER_ESPI U(1 << 8) 152 #define TYPER_DVIS U(1 << 18) 153 #define TYPER_LPIS U(1 << 17) 154 #define TYPER_ESPI_RANGE_MASK U(0x1f) 155 #define TYPER_ESPI_RANGE_SHIFT U(27) 156 #define TYPER_ESPI_RANGE U(TYPER_ESPI_MASK << TYPER_ESPI_SHIFT) 157 158 /******************************************************************************* 159 * Common GIC Redistributor interface registers & constants 160 ******************************************************************************/ 161 #define GICR_V4_PCPUBASE_SHIFT 0x12 162 #define GICR_V3_PCPUBASE_SHIFT 0x11 163 #define GICR_SGIBASE_OFFSET U(65536) /* 64 KB */ 164 #define GICR_CTLR U(0x0) 165 #define GICR_IIDR U(0x04) 166 #define GICR_TYPER U(0x08) 167 #define GICR_STATUSR U(0x10) 168 #define GICR_WAKER U(0x14) 169 #define GICR_PROPBASER U(0x70) 170 #define GICR_PENDBASER U(0x78) 171 #define GICR_IGROUPR0 (GICR_SGIBASE_OFFSET + U(0x80)) 172 #define GICR_ISENABLER0 (GICR_SGIBASE_OFFSET + U(0x100)) 173 #define GICR_ICENABLER0 (GICR_SGIBASE_OFFSET + U(0x180)) 174 #define GICR_ISPENDR0 (GICR_SGIBASE_OFFSET + U(0x200)) 175 #define GICR_ICPENDR0 (GICR_SGIBASE_OFFSET + U(0x280)) 176 #define GICR_ISACTIVER0 (GICR_SGIBASE_OFFSET + U(0x300)) 177 #define GICR_ICACTIVER0 (GICR_SGIBASE_OFFSET + U(0x380)) 178 #define GICR_IPRIORITYR (GICR_SGIBASE_OFFSET + U(0x400)) 179 #define GICR_ICFGR0 (GICR_SGIBASE_OFFSET + U(0xc00)) 180 #define GICR_ICFGR1 (GICR_SGIBASE_OFFSET + U(0xc04)) 181 #define GICR_IGRPMODR0 (GICR_SGIBASE_OFFSET + U(0xd00)) 182 #define GICR_NSACR (GICR_SGIBASE_OFFSET + U(0xe00)) 183 184 #define GICR_IGROUPR GICR_IGROUPR0 185 #define GICR_ISENABLER GICR_ISENABLER0 186 #define GICR_ICENABLER GICR_ICENABLER0 187 #define GICR_ISPENDR GICR_ISPENDR0 188 #define GICR_ICPENDR GICR_ICPENDR0 189 #define GICR_ISACTIVER GICR_ISACTIVER0 190 #define GICR_ICACTIVER GICR_ICACTIVER0 191 #define GICR_ICFGR GICR_ICFGR0 192 #define GICR_IGRPMODR GICR_IGRPMODR0 193 194 /* GICR_CTLR bit definitions */ 195 #define GICR_CTLR_UWP_SHIFT 31 196 #define GICR_CTLR_UWP_MASK U(0x1) 197 #define GICR_CTLR_UWP_BIT BIT_32(GICR_CTLR_UWP_SHIFT) 198 #define GICR_CTLR_DPG1S_SHIFT 26 199 #define GICR_CTLR_DPG1S_MASK U(0x1) 200 #define GICR_CTLR_DPG1S_BIT BIT_32(GICR_CTLR_DPG1S_SHIFT) 201 #define GICR_CTLR_DPG1NS_SHIFT 25 202 #define GICR_CTLR_DPG1NS_MASK U(0x1) 203 #define GICR_CTLR_DPG1NS_BIT BIT_32(GICR_CTLR_DPG1NS_SHIFT) 204 #define GICR_CTLR_DPG0_SHIFT 24 205 #define GICR_CTLR_DPG0_MASK U(0x1) 206 #define GICR_CTLR_DPG0_BIT BIT_32(GICR_CTLR_DPG0_SHIFT) 207 #define GICR_CTLR_RWP_SHIFT 3 208 #define GICR_CTLR_RWP_MASK U(0x1) 209 #define GICR_CTLR_RWP_BIT BIT_32(GICR_CTLR_RWP_SHIFT) 210 #define GICR_CTLR_EN_LPIS_BIT BIT_32(0) 211 212 /* GICR_WAKER bit definitions */ 213 #define WAKER_CA_SHIFT 2 214 #define WAKER_PS_SHIFT 1 215 216 #define WAKER_CA_MASK U(0x1) 217 #define WAKER_PS_MASK U(0x1) 218 219 #define WAKER_CA_BIT BIT_32(WAKER_CA_SHIFT) 220 #define WAKER_PS_BIT BIT_32(WAKER_PS_SHIFT) 221 222 /* GICR_TYPER bit definitions */ 223 #define TYPER_AFF_VAL_SHIFT 32 224 #define TYPER_PROC_NUM_SHIFT 8 225 #define TYPER_LAST_SHIFT 4 226 #define TYPER_VLPI_SHIFT 1 227 228 #define TYPER_AFF_VAL_MASK U(0xffffffff) 229 #define TYPER_PROC_NUM_MASK UL(0xffff) 230 #define TYPER_LAST_MASK U(0x1) 231 232 #define TYPER_LAST_BIT BIT_32(TYPER_LAST_SHIFT) 233 #define TYPER_VLPI_BIT BIT_32(TYPER_VLPI_SHIFT) 234 235 #define TYPER_PPI_NUM_SHIFT U(27) 236 #define TYPER_PPI_NUM_MASK U(0x1f) 237 238 /* GICR_IIDR bit definitions */ 239 #define IIDR_PRODUCT_ID_MASK U(0xff) 240 #define IIDR_VARIANT_MASK U(0xf) 241 #define IIDR_REV_MASK U(0xf) 242 #define IIDR_IMPLEMENTER_MASK U(0xfff) 243 #define IIDR_PRODUCT_ID_SHIFT 24 244 #define IIDR_VARIANT_SHIFT 16 245 #define IIDR_REV_SHIFT 12 246 #define IIDR_IMPLEMENTER_SHIFT 0 247 #define IIDR_PRODUCT_ID_BIT BIT_32(IIDR_PRODUCT_ID_SHIFT) 248 #define IIDR_VARIANT_BIT BIT_32(IIDR_VARIANT_SHIFT) 249 #define IIDR_REV_BIT BIT_32(IIDR_REVISION_SHIFT) 250 #define IIDR_IMPLEMENTER_BIT BIT_32(IIDR_IMPLEMENTER_SHIFT) 251 252 #define IIDR_MODEL_MASK (IIDR_PRODUCT_ID_MASK << IIDR_PRODUCT_ID_SHIFT | \ 253 IIDR_IMPLEMENTER_MASK << IIDR_IMPLEMENTER_SHIFT) 254 255 #define GIC_PRODUCT_ID_GIC600 U(0x2) 256 #define GIC_PRODUCT_ID_GIC600AE U(0x3) 257 #define GIC_PRODUCT_ID_GIC700 U(0x4) 258 259 /* 260 * Note that below revisions and variants definations are as per GIC600/GIC600AE 261 * specification. 262 */ 263 #define GIC_REV_P0 U(0x1) 264 #define GIC_REV_P1 U(0x3) 265 #define GIC_REV_P2 U(0x4) 266 #define GIC_REV_P3 U(0x5) 267 #define GIC_REV_P4 U(0x6) 268 #define GIC_REV_P6 U(0x7) 269 270 #define GIC_VARIANT_R0 U(0x0) 271 #define GIC_VARIANT_R1 U(0x1) 272 #define GIC_VARIANT_R2 U(0x2) 273 274 /******************************************************************************* 275 * GICv3 and 3.1 CPU interface registers & constants 276 ******************************************************************************/ 277 /* ICC_SRE bit definitions */ 278 #define ICC_SRE_EN_BIT BIT_32(3) 279 #define ICC_SRE_DIB_BIT BIT_32(2) 280 #define ICC_SRE_DFB_BIT BIT_32(1) 281 #define ICC_SRE_SRE_BIT BIT_32(0) 282 283 /* ICC_IGRPEN1_EL3 bit definitions */ 284 #define IGRPEN1_EL3_ENABLE_G1NS_SHIFT 0 285 #define IGRPEN1_EL3_ENABLE_G1S_SHIFT 1 286 287 #define IGRPEN1_EL3_ENABLE_G1NS_BIT BIT_32(IGRPEN1_EL3_ENABLE_G1NS_SHIFT) 288 #define IGRPEN1_EL3_ENABLE_G1S_BIT BIT_32(IGRPEN1_EL3_ENABLE_G1S_SHIFT) 289 290 /* ICC_IGRPEN0_EL1 bit definitions */ 291 #define IGRPEN1_EL1_ENABLE_G0_SHIFT 0 292 #define IGRPEN1_EL1_ENABLE_G0_BIT BIT_32(IGRPEN1_EL1_ENABLE_G0_SHIFT) 293 294 /* ICC_HPPIR0_EL1 bit definitions */ 295 #define HPPIR0_EL1_INTID_SHIFT 0 296 #define HPPIR0_EL1_INTID_MASK U(0xffffff) 297 298 /* ICC_HPPIR1_EL1 bit definitions */ 299 #define HPPIR1_EL1_INTID_SHIFT 0 300 #define HPPIR1_EL1_INTID_MASK U(0xffffff) 301 302 /* ICC_IAR0_EL1 bit definitions */ 303 #define IAR0_EL1_INTID_SHIFT 0 304 #define IAR0_EL1_INTID_MASK U(0xffffff) 305 306 /* ICC_IAR1_EL1 bit definitions */ 307 #define IAR1_EL1_INTID_SHIFT 0 308 #define IAR1_EL1_INTID_MASK U(0xffffff) 309 310 /* ICC SGI macros */ 311 #define SGIR_TGT_MASK ULL(0xffff) 312 #define SGIR_AFF1_SHIFT 16 313 #define SGIR_INTID_SHIFT 24 314 #define SGIR_INTID_MASK ULL(0xf) 315 #define SGIR_AFF2_SHIFT 32 316 #define SGIR_IRM_SHIFT 40 317 #define SGIR_IRM_MASK ULL(0x1) 318 #define SGIR_AFF3_SHIFT 48 319 #define SGIR_AFF_MASK ULL(0xff) 320 321 #define SGIR_IRM_TO_AFF U(0) 322 323 #define GICV3_SGIR_VALUE(_aff3, _aff2, _aff1, _intid, _irm, _tgt) \ 324 ((((uint64_t) (_aff3) & SGIR_AFF_MASK) << SGIR_AFF3_SHIFT) | \ 325 (((uint64_t) (_irm) & SGIR_IRM_MASK) << SGIR_IRM_SHIFT) | \ 326 (((uint64_t) (_aff2) & SGIR_AFF_MASK) << SGIR_AFF2_SHIFT) | \ 327 (((_intid) & SGIR_INTID_MASK) << SGIR_INTID_SHIFT) | \ 328 (((_aff1) & SGIR_AFF_MASK) << SGIR_AFF1_SHIFT) | \ 329 ((_tgt) & SGIR_TGT_MASK)) 330 331 /***************************************************************************** 332 * GICv3 and 3.1 ITS registers and constants 333 *****************************************************************************/ 334 #define GITS_CTLR U(0x0) 335 #define GITS_IIDR U(0x4) 336 #define GITS_TYPER U(0x8) 337 #define GITS_CBASER U(0x80) 338 #define GITS_CWRITER U(0x88) 339 #define GITS_CREADR U(0x90) 340 #define GITS_BASER U(0x100) 341 342 /* GITS_CTLR bit definitions */ 343 #define GITS_CTLR_ENABLED_BIT BIT_32(0) 344 #define GITS_CTLR_QUIESCENT_BIT BIT_32(31) 345 346 #define GITS_TYPER_VSGI BIT_64(39) 347 348 #ifndef __ASSEMBLER__ 349 350 #include <stdbool.h> 351 #include <stdint.h> 352 353 #include <arch_helpers.h> 354 #include <common/interrupt_props.h> 355 #include <drivers/arm/gic_common.h> 356 #include <lib/utils_def.h> 357 358 typedef enum { 359 GICV3_G1S, 360 GICV3_G1NS, 361 GICV3_G0 362 } gicv3_irq_group_t; 363 364 static inline uintptr_t gicv3_redist_size(uint64_t typer_val) 365 { 366 #if GIC_ENABLE_V4_EXTN 367 if ((typer_val & TYPER_VLPI_BIT) != 0U) { 368 return 1U << GICR_V4_PCPUBASE_SHIFT; 369 } else { 370 return 1U << GICR_V3_PCPUBASE_SHIFT; 371 } 372 #else 373 return 1U << GICR_V3_PCPUBASE_SHIFT; 374 #endif 375 } 376 377 unsigned int gicv3_get_component_partnum(const uintptr_t gic_frame); 378 379 static inline bool gicv3_is_intr_id_special_identifier(unsigned int id) 380 { 381 return (id >= PENDING_G1S_INTID) && (id <= GIC_SPURIOUS_INTERRUPT); 382 } 383 384 /******************************************************************************* 385 * Helper GICv3 and 3.1 macros for SEL1 386 ******************************************************************************/ 387 static inline uint32_t gicv3_acknowledge_interrupt_sel1(void) 388 { 389 return (uint32_t)read_icc_iar1_el1() & IAR1_EL1_INTID_MASK; 390 } 391 392 static inline uint32_t gicv3_get_pending_interrupt_id_sel1(void) 393 { 394 return (uint32_t)read_icc_hppir1_el1() & HPPIR1_EL1_INTID_MASK; 395 } 396 397 static inline void gicv3_end_of_interrupt_sel1(unsigned int id) 398 { 399 /* 400 * Interrupt request deassertion from peripheral to GIC happens 401 * by clearing interrupt condition by a write to the peripheral 402 * register. It is desired that the write transfer is complete 403 * before the core tries to change GIC state from 'AP/Active' to 404 * a new state on seeing 'EOI write'. 405 * Since ICC interface writes are not ordered against Device 406 * memory writes, a barrier is required to ensure the ordering. 407 * The dsb will also ensure *completion* of previous writes with 408 * DEVICE nGnRnE attribute. 409 */ 410 dsbishst(); 411 write_icc_eoir1_el1(id); 412 } 413 414 /******************************************************************************* 415 * Helper GICv3 macros for EL3 416 ******************************************************************************/ 417 static inline uint32_t gicv3_acknowledge_interrupt(void) 418 { 419 return (uint32_t)read_icc_iar0_el1() & IAR0_EL1_INTID_MASK; 420 } 421 422 static inline void gicv3_end_of_interrupt(unsigned int id) 423 { 424 /* 425 * Interrupt request deassertion from peripheral to GIC happens 426 * by clearing interrupt condition by a write to the peripheral 427 * register. It is desired that the write transfer is complete 428 * before the core tries to change GIC state from 'AP/Active' to 429 * a new state on seeing 'EOI write'. 430 * Since ICC interface writes are not ordered against Device 431 * memory writes, a barrier is required to ensure the ordering. 432 * The dsb will also ensure *completion* of previous writes with 433 * DEVICE nGnRnE attribute. 434 */ 435 dsbishst(); 436 return write_icc_eoir0_el1(id); 437 } 438 439 /* 440 * This macro returns the total number of GICD/GICR registers corresponding to 441 * the register name 442 */ 443 #define GICD_NUM_REGS(reg_name) \ 444 DIV_ROUND_UP_2EVAL(TOTAL_SHARED_INTR_NUM, (1 << reg_name##_SHIFT)) 445 446 #define GICR_NUM_REGS(reg_name) \ 447 DIV_ROUND_UP_2EVAL(TOTAL_PRIVATE_INTR_NUM, (1 << reg_name##_SHIFT)) 448 449 /* Interrupt ID mask for HPPIR, AHPPIR, IAR and AIAR CPU Interface registers */ 450 #define INT_ID_MASK U(0xffffff) 451 452 /******************************************************************************* 453 * This structure describes some of the implementation defined attributes of the 454 * GICv3 IP. It is used by the platform port to specify these attributes in order 455 * to initialise the GICV3 driver. The attributes are described below. 456 * 457 * The 'gicd_base' field contains the base address of the Distributor interface 458 * programmer's view. 459 * 460 * The 'gicr_base' field contains the base address of the Re-distributor 461 * interface programmer's view. 462 * 463 * The 'interrupt_props' field is a pointer to an array that enumerates secure 464 * interrupts and their properties. If this field is not NULL, both 465 * 'g0_interrupt_array' and 'g1s_interrupt_array' fields are ignored. 466 * 467 * The 'interrupt_props_num' field contains the number of entries in the 468 * 'interrupt_props' array. If this field is non-zero, both 'g0_interrupt_num' 469 * and 'g1s_interrupt_num' are ignored. 470 * 471 * The 'rdistif_num' field contains the number of Redistributor interfaces the 472 * GIC implements. This is equal to the number of CPUs or CPU interfaces 473 * instantiated in the GIC. 474 * 475 * The 'rdistif_base_addrs' field is a pointer to an array that has an entry for 476 * storing the base address of the Redistributor interface frame of each CPU in 477 * the system. The size of the array = 'rdistif_num'. The base addresses are 478 * detected during driver initialisation. 479 * 480 * The 'mpidr_to_core_pos' field is a pointer to a hash function which the 481 * driver will use to convert an MPIDR value to a linear core index. This index 482 * will be used for accessing the 'rdistif_base_addrs' array. This is an 483 * optional field. A GICv3 implementation maps each MPIDR to a linear core index 484 * as well. This mapping can be found by reading the "Affinity Value" and 485 * "Processor Number" fields in the GICR_TYPER. It is IMP. DEF. if the 486 * "Processor Numbers" are suitable to index into an array to access core 487 * specific information. If this not the case, the platform port must provide a 488 * hash function. Otherwise, the "Processor Number" field will be used to access 489 * the array elements. 490 ******************************************************************************/ 491 typedef unsigned int (*mpidr_hash_fn)(u_register_t mpidr); 492 493 typedef struct gicv3_driver_data { 494 uintptr_t gicd_base; 495 uintptr_t gicr_base; 496 const interrupt_prop_t *interrupt_props; 497 unsigned int interrupt_props_num; 498 unsigned int rdistif_num; 499 uintptr_t *rdistif_base_addrs; 500 mpidr_hash_fn mpidr_to_core_pos; 501 } gicv3_driver_data_t; 502 503 typedef struct gicv3_redist_ctx { 504 /* 64 bits registers */ 505 uint64_t gicr_propbaser; 506 uint64_t gicr_pendbaser; 507 508 /* 32 bits registers */ 509 uint32_t gicr_ctlr; 510 uint32_t gicr_igroupr[GICR_NUM_REGS(IGROUPR)]; 511 uint32_t gicr_isenabler[GICR_NUM_REGS(ISENABLER)]; 512 uint32_t gicr_ispendr[GICR_NUM_REGS(ISPENDR)]; 513 uint32_t gicr_isactiver[GICR_NUM_REGS(ISACTIVER)]; 514 uint32_t gicr_ipriorityr[GICR_NUM_REGS(IPRIORITYR)]; 515 uint32_t gicr_icfgr[GICR_NUM_REGS(ICFGR)]; 516 uint32_t gicr_igrpmodr[GICR_NUM_REGS(IGRPMODR)]; 517 uint32_t gicr_nsacr; 518 } gicv3_redist_ctx_t; 519 520 typedef struct gicv3_dist_ctx { 521 /* 64 bits registers */ 522 uint64_t gicd_irouter[TOTAL_SHARED_INTR_NUM]; 523 524 /* 32 bits registers */ 525 uint32_t gicd_ctlr; 526 uint32_t gicd_igroupr[GICD_NUM_REGS(IGROUPR)]; 527 uint32_t gicd_isenabler[GICD_NUM_REGS(ISENABLER)]; 528 uint32_t gicd_ispendr[GICD_NUM_REGS(ISPENDR)]; 529 uint32_t gicd_isactiver[GICD_NUM_REGS(ISACTIVER)]; 530 uint32_t gicd_ipriorityr[GICD_NUM_REGS(IPRIORITYR)]; 531 uint32_t gicd_icfgr[GICD_NUM_REGS(ICFGR)]; 532 uint32_t gicd_igrpmodr[GICD_NUM_REGS(IGRPMODR)]; 533 uint32_t gicd_nsacr[GICD_NUM_REGS(NSACR)]; 534 } gicv3_dist_ctx_t; 535 536 typedef struct gicv3_its_ctx { 537 /* 64 bits registers */ 538 uint64_t gits_cbaser; 539 uint64_t gits_cwriter; 540 uint64_t gits_baser[8]; 541 542 /* 32 bits registers */ 543 uint32_t gits_ctlr; 544 } gicv3_its_ctx_t; 545 546 /******************************************************************************* 547 * GICv3 EL3 driver API 548 ******************************************************************************/ 549 void gicv3_driver_init(const gicv3_driver_data_t *plat_driver_data); 550 int gicv3_rdistif_probe(const uintptr_t gicr_frame); 551 void gicv3_distif_init(void); 552 void gicv3_rdistif_init(unsigned int proc_num); 553 void gicv3_rdistif_on(unsigned int proc_num); 554 void gicv3_rdistif_off(unsigned int proc_num); 555 unsigned int gicv3_rdistif_get_number_frames(const uintptr_t gicr_frame); 556 void gicv3_cpuif_enable(unsigned int proc_num); 557 void gicv3_cpuif_disable(unsigned int proc_num); 558 unsigned int gicv3_get_pending_interrupt_type(void); 559 unsigned int gicv3_get_pending_interrupt_id(void); 560 unsigned int gicv3_get_interrupt_group(unsigned int id, 561 unsigned int proc_num); 562 void gicv3_distif_init_restore(const gicv3_dist_ctx_t * const dist_ctx); 563 void gicv3_distif_save(gicv3_dist_ctx_t * const dist_ctx); 564 /* 565 * gicv3_distif_post_restore and gicv3_distif_pre_save must be implemented if 566 * gicv3_distif_save and gicv3_rdistif_init_restore are used. If no 567 * implementation-defined sequence is needed at these steps, an empty function 568 * can be provided. 569 */ 570 void gicv3_distif_post_restore(unsigned int proc_num); 571 void gicv3_distif_pre_save(unsigned int proc_num); 572 void gicv3_rdistif_init_restore(unsigned int proc_num, const gicv3_redist_ctx_t * const rdist_ctx); 573 void gicv3_rdistif_save(unsigned int proc_num, gicv3_redist_ctx_t * const rdist_ctx); 574 void gicv3_its_save_disable(uintptr_t gits_base, gicv3_its_ctx_t * const its_ctx); 575 void gicv3_its_restore(uintptr_t gits_base, const gicv3_its_ctx_t * const its_ctx); 576 577 unsigned int gicv3_get_running_priority(void); 578 unsigned int gicv3_get_interrupt_active(unsigned int id, unsigned int proc_num); 579 void gicv3_enable_interrupt(unsigned int id, unsigned int proc_num); 580 void gicv3_disable_interrupt(unsigned int id, unsigned int proc_num); 581 void gicv3_set_interrupt_priority(unsigned int id, unsigned int proc_num, 582 unsigned int priority); 583 void gicv3_set_interrupt_group(unsigned int id, unsigned int proc_num, 584 unsigned int group); 585 void gicv3_raise_sgi(unsigned int sgi_num, gicv3_irq_group_t group, 586 u_register_t target); 587 void gicv3_set_spi_routing(unsigned int id, unsigned int irm, 588 u_register_t mpidr); 589 void gicv3_set_interrupt_pending(unsigned int id, unsigned int proc_num); 590 void gicv3_clear_interrupt_pending(unsigned int id, unsigned int proc_num); 591 unsigned int gicv3_set_pmr(unsigned int mask); 592 unsigned int gicv3_deactivate_priority(unsigned int mask); 593 594 void gicv3_get_component_prodid_rev(const uintptr_t gicd_base, 595 unsigned int *gic_prod_id, 596 uint8_t *gic_rev); 597 void gicv3_check_erratas_applies(const uintptr_t gicd_base); 598 #if GIC600_ERRATA_WA_2384374 599 void gicv3_apply_errata_wa_2384374(const uintptr_t gicr_base); 600 #else 601 static inline void gicv3_apply_errata_wa_2384374(const uintptr_t gicr_base) 602 { 603 } 604 #endif /* GIC600_ERRATA_WA_2384374 */ 605 606 #endif /* __ASSEMBLER__ */ 607 #endif /* GICV3_H */ 608