1 /* SPDX-License-Identifier: GPL-2.0-or-later */
8 # error Please include asm/mips-cps.h rather than asm/mips-cm.h
18 /* The base address of the CM GCR block */
21 /* The base address of the CM L2-only sync region */
25  * __mips_cm_phys_base - retrieve the physical base address of the CM
32  * name mips_cm_phys_base (without underscores).
37  * mips_cm_is64 - determine CM register width
39  * The CM register width is determined by the version of the CM, with CM3
40  * introducing 64 bit GCRs and all prior CM versions having 32 bit GCRs.
42  * or vice-versa. This variable indicates the width of the memory accesses
46  * It's set to 0 for 32-bit accesses and 1 for 64-bit accesses.
51  * mips_cm_error_report - Report CM cache errors
60  * mips_cm_probe - probe for a Coherence Manager
62  * Attempt to detect the presence of a Coherence Manager. Returns 0 if a CM
63  * is successfully detected, else -errno.
70 	return -ENODEV;  in mips_cm_probe()
75  * mips_cm_present - determine whether a Coherence Manager is present
77  * Returns true if a CM is present in the system, else false.
89  * mips_cm_has_l2sync - determine whether an L2-only sync region is present
91  * Returns true if the system implements an L2-only sync region, else false.
102 /* Offsets to register blocks from the CM base address */
108 /* Total size of the CM memory mapped registers */
111 /* Size of the L2-only sync region */
114 #define GCR_ACCESSOR_RO(sz, off, name)					\  argument
115 	CPS_ACCESSOR_RO(gcr, sz, MIPS_CM_GCB_OFS + off, name)		\
116 	CPS_ACCESSOR_RO(gcr, sz, MIPS_CM_COCB_OFS + off, redir_##name)
118 #define GCR_ACCESSOR_RW(sz, off, name)					\  argument
119 	CPS_ACCESSOR_RW(gcr, sz, MIPS_CM_GCB_OFS + off, name)		\
120 	CPS_ACCESSOR_RW(gcr, sz, MIPS_CM_COCB_OFS + off, redir_##name)
122 #define GCR_CX_ACCESSOR_RO(sz, off, name)				\  argument
123 	CPS_ACCESSOR_RO(gcr, sz, MIPS_CM_CLCB_OFS + off, cl_##name)	\
124 	CPS_ACCESSOR_RO(gcr, sz, MIPS_CM_COCB_OFS + off, co_##name)
126 #define GCR_CX_ACCESSOR_RW(sz, off, name)				\  argument
127 	CPS_ACCESSOR_RW(gcr, sz, MIPS_CM_CLCB_OFS + off, cl_##name)	\
128 	CPS_ACCESSOR_RW(gcr, sz, MIPS_CM_COCB_OFS + off, co_##name)
130 /* GCR_CONFIG - Information about the system */
138 /* GCR_BASE - Base address of the Global Configuration Registers (GCRs) */
147 /* GCR_ACCESS - Controls core/IOCU access to GCRs */
151 /* GCR_REV - Indicates the Coherence Manager revision */
165 /* GCR_ERR_CONTROL - Control error checking logic */
170 /* GCR_ERR_MASK - Control which errors are reported as interrupts */
173 /* GCR_ERR_CAUSE - Indicates the type of error that occurred */
179 /* GCR_ERR_ADDR - Indicates the address associated with an error */
182 /* GCR_ERR_MULT - Indicates when multiple errors have occurred */
186 /* GCR_L2_ONLY_SYNC_BASE - Base address of the L2 cache-only sync region */
191 /* GCR_GIC_BASE - Base address of the Global Interrupt Controller (GIC) */
196 /* GCR_CPC_BASE - Base address of the Cluster Power Controller (CPC) */
201 /* GCR_REGn_BASE - Base addresses of CM address regions */
208 /* GCR_REGn_MASK - Size & destination of CM address regions */
223 /* GCR_GIC_STATUS - Indicates presence of a Global Interrupt Controller (GIC) */
227 /* GCR_CPC_STATUS - Indicates presence of a Cluster Power Controller (CPC) */
231 /* GCR_L2_CONFIG - Indicates L2 cache configuration when Config5.L2C=1 */
238 /* GCR_SYS_CONFIG2 - Further information about the system */
242 /* GCR_L2_PFT_CONTROL - Controls hardware L2 prefetching */
248 /* GCR_L2_PFT_CONTROL_B - Controls hardware L2 prefetching */
253 /* GCR_L2SM_COP - L2 cache op state machine control */
275 /* GCR_L2SM_TAG_ADDR_COP - L2 cache op state machine address control */
280 /* GCR_BEV_BASE - Controls the location of the BEV for powered up cores */
283 /* GCR_Cx_RESET_RELEASE - Controls core reset for CM 1.x */
286 /* GCR_Cx_COHERENCE - Controls core coherence */
291 /* GCR_Cx_CONFIG - Information about a core's configuration */
296 /* GCR_Cx_OTHER - Configure the core-other/redirect GCR block */
298 #define CM_GCR_Cx_OTHER_CORENUM			GENMASK(31, 16)	/* CM < 3 */
299 #define CM_GCR_Cx_OTHER_CLUSTER_EN		BIT(31)		/* CM >= 3.5 */
300 #define CM_GCR_Cx_OTHER_GIC_EN			BIT(30)		/* CM >= 3.5 */
301 #define CM_GCR_Cx_OTHER_BLOCK			GENMASK(25, 24)	/* CM >= 3.5 */
306 #define CM_GCR_Cx_OTHER_CLUSTER			GENMASK(21, 16)	/* CM >= 3.5 */
307 #define CM3_GCR_Cx_OTHER_CORE			GENMASK(13, 8)	/* CM >= 3 */
309 #define CM3_GCR_Cx_OTHER_VP			GENMASK(2, 0)	/* CM >= 3 */
311 /* GCR_Cx_RESET_BASE - Configure where powered up cores will fetch from */
315 /* GCR_Cx_ID - Identify the current core */
320 /* GCR_Cx_RESET_EXT_BASE - Configure behaviour when cores reset or power up */
329  * mips_cm_l2sync - perform an L2-only sync operation
331  * If an L2-only sync region is present in the system then this function
332  * performs and L2-only sync and returns zero. Otherwise it returns -ENODEV.
337 		return -ENODEV;  in mips_cm_l2sync()
344  * mips_cm_revision() - return CM revision
346  * Return: The revision of the CM, from GCR_REV, or 0 if no CM is present. The
358  * mips_cm_max_vp_width() - return the width in bits of VP indices
387  * mips_cm_vp_id() - calculate the hardware VP ID for a CPU
407  * mips_cm_lock_other - lock access to redirect/other region
414  * the CM revision) to target the specified @cluster, @core, @vp & register
420  * mips_cm_unlock_other() calls cannot be pre-empted by anything which may
428  * mips_cm_unlock_other - unlock access to redirect/other region
444  * mips_cm_lock_other_cpu - lock access to redirect/other region
448  * the CM revision) to target the specified @cpu & register @block. This is