1 /*
2  * Copyright (c) 2019-2023, ARM Limited. All rights reserved.
3  *
4  * SPDX-License-Identifier: BSD-3-Clause
5  */
6 
7 #ifndef GIC600_MULTICHIP_PRIVATE_H
8 #define GIC600_MULTICHIP_PRIVATE_H
9 
10 #include <drivers/arm/gic600_multichip.h>
11 
12 #include "gicv3_private.h"
13 
14 /* GIC600 GICD multichip related offsets */
15 #define GICD_CHIPSR			U(0xC000)
16 #define GICD_DCHIPR			U(0xC004)
17 #define GICD_CHIPR			U(0xC008)
18 
19 /* GIC600 GICD multichip related masks */
20 #define GICD_CHIPRx_PUP_BIT		BIT_64(1)
21 #define GICD_CHIPRx_SOCKET_STATE	BIT_64(0)
22 #define GICD_DCHIPR_PUP_BIT		BIT_32(0)
23 #define GICD_CHIPSR_RTS_MASK		(BIT_32(4) | BIT_32(5))
24 
25 /* GIC600 GICD multichip related shifts */
26 #define GICD_CHIPRx_ADDR_SHIFT		16
27 #define GICD_CHIPSR_RTS_SHIFT		4
28 #define GICD_DCHIPR_RT_OWNER_SHIFT	4
29 
30 /* Other shifts and masks remain the same between GIC-600 and GIC-700. */
31 #define GIC_700_SPI_BLOCK_MIN_SHIFT	9
32 #define GIC_700_SPI_BLOCKS_SHIFT	3
33 #define GIC_600_SPI_BLOCK_MIN_SHIFT	10
34 #define GIC_600_SPI_BLOCKS_SHIFT	5
35 
36 #define GICD_CHIPSR_RTS_STATE_DISCONNECTED	U(0)
37 #define GICD_CHIPSR_RTS_STATE_UPDATING		U(1)
38 #define GICD_CHIPSR_RTS_STATE_CONSISTENT	U(2)
39 
40 /* SPI interrupt id minimum and maximum range */
41 #define GIC600_SPI_ID_MIN		32
42 #define GIC600_SPI_ID_MAX		991
43 
44 #define GIC700_SPI_ID_MIN		32
45 #define GIC700_SPI_ID_MAX		991
46 #define GIC700_ESPI_ID_MIN		4096
47 #define GIC700_ESPI_ID_MAX		5119
48 
49 /* Number of retries for PUP update */
50 #define GICD_PUP_UPDATE_RETRIES		10000
51 
52 #define SPI_BLOCK_MIN_VALUE(spi_id_min) \
53 			(((spi_id_min) - GIC600_SPI_ID_MIN) / \
54 			GIC600_SPI_ID_MIN)
55 #define SPI_BLOCKS_VALUE(spi_id_min, spi_id_max) \
56 			(((spi_id_max) - (spi_id_min) + 1) / \
57 			GIC600_SPI_ID_MIN)
58 #define ESPI_BLOCK_MIN_VALUE(spi_id_min) \
59 			(((spi_id_min) - GIC700_ESPI_ID_MIN + 1) / \
60 			GIC700_SPI_ID_MIN)
61 #define GICD_CHIPR_VALUE_GIC_700(chip_addr, spi_block_min, spi_blocks) \
62 			(((chip_addr) << GICD_CHIPRx_ADDR_SHIFT) | \
63 			((spi_block_min) << GIC_700_SPI_BLOCK_MIN_SHIFT) | \
64 			((spi_blocks) << GIC_700_SPI_BLOCKS_SHIFT))
65 #define GICD_CHIPR_VALUE_GIC_600(chip_addr, spi_block_min, spi_blocks) \
66 			(((chip_addr) << GICD_CHIPRx_ADDR_SHIFT) | \
67 			((spi_block_min) << GIC_600_SPI_BLOCK_MIN_SHIFT) | \
68 			((spi_blocks) << GIC_600_SPI_BLOCKS_SHIFT))
69 
70 /*
71  * Multichip data assertion macros
72  */
73 /* Set bits from 0 to ((spi_id_max + 1) / 32) */
74 #define SPI_BLOCKS_TILL_MAX(spi_id_max) \
75 			((1ULL << (((spi_id_max) + 1) >> 5)) - 1)
76 /* Set bits from 0 to (spi_id_min / 32) */
77 #define SPI_BLOCKS_TILL_MIN(spi_id_min)	((1 << ((spi_id_min) >> 5)) - 1)
78 /* Set bits from (spi_id_min / 32) to ((spi_id_max + 1) / 32) */
79 #define BLOCKS_OF_32(spi_id_min, spi_id_max) \
80 					SPI_BLOCKS_TILL_MAX(spi_id_max) ^ \
81 					SPI_BLOCKS_TILL_MIN(spi_id_min)
82 
83 /*******************************************************************************
84  * GIC-600 multichip operation related helper functions
85  ******************************************************************************/
read_gicd_dchipr(uintptr_t base)86 static inline uint32_t read_gicd_dchipr(uintptr_t base)
87 {
88 	return mmio_read_32(base + GICD_DCHIPR);
89 }
90 
read_gicd_chipr_n(uintptr_t base,uint8_t n)91 static inline uint64_t read_gicd_chipr_n(uintptr_t base, uint8_t n)
92 {
93 	return mmio_read_64(base + (GICD_CHIPR + (8U * n)));
94 }
95 
read_gicd_chipsr(uintptr_t base)96 static inline uint32_t read_gicd_chipsr(uintptr_t base)
97 {
98 	return mmio_read_32(base + GICD_CHIPSR);
99 }
100 
write_gicd_dchipr(uintptr_t base,uint32_t val)101 static inline void write_gicd_dchipr(uintptr_t base, uint32_t val)
102 {
103 	mmio_write_32(base + GICD_DCHIPR, val);
104 }
105 
write_gicd_chipr_n(uintptr_t base,uint8_t n,uint64_t val)106 static inline void write_gicd_chipr_n(uintptr_t base, uint8_t n, uint64_t val)
107 {
108 	mmio_write_64(base + (GICD_CHIPR + (8U * n)), val);
109 }
110 
111 #endif /* GIC600_MULTICHIP_PRIVATE_H */
112