Loading...
1/* SPDX-License-Identifier: GPL-2.0-or-later */
2/*
3 * Copyright (C) 2013 Imagination Technologies
4 * Author: Paul Burton <paul.burton@mips.com>
5 */
6
7#ifndef __MIPS_ASM_MIPS_CPS_H__
8# error Please include asm/mips-cps.h rather than asm/mips-cm.h
9#endif
10
11#ifndef __MIPS_ASM_MIPS_CM_H__
12#define __MIPS_ASM_MIPS_CM_H__
13
14#include <linux/bitfield.h>
15#include <linux/bitops.h>
16#include <linux/errno.h>
17
18/* The base address of the CM GCR block */
19extern void __iomem *mips_gcr_base;
20
21/* The base address of the CM L2-only sync region */
22extern void __iomem *mips_cm_l2sync_base;
23
24/**
25 * __mips_cm_phys_base - retrieve the physical base address of the CM
26 *
27 * This function returns the physical base address of the Coherence Manager
28 * global control block, or 0 if no Coherence Manager is present. It provides
29 * a default implementation which reads the CMGCRBase register where available,
30 * and may be overridden by platforms which determine this address in a
31 * different way by defining a function with the same prototype except for the
32 * name mips_cm_phys_base (without underscores).
33 */
34extern phys_addr_t __mips_cm_phys_base(void);
35
36/*
37 * mips_cm_is64 - determine CM register width
38 *
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.
41 * However we may run a kernel built for MIPS32 on a system with 64 bit GCRs,
42 * or vice-versa. This variable indicates the width of the memory accesses
43 * that the kernel will perform to GCRs, which may differ from the actual
44 * width of the GCRs.
45 *
46 * It's set to 0 for 32-bit accesses and 1 for 64-bit accesses.
47 */
48extern int mips_cm_is64;
49
50/**
51 * mips_cm_error_report - Report CM cache errors
52 */
53#ifdef CONFIG_MIPS_CM
54extern void mips_cm_error_report(void);
55#else
56static inline void mips_cm_error_report(void) {}
57#endif
58
59/**
60 * mips_cm_probe - probe for a Coherence Manager
61 *
62 * Attempt to detect the presence of a Coherence Manager. Returns 0 if a CM
63 * is successfully detected, else -errno.
64 */
65#ifdef CONFIG_MIPS_CM
66extern int mips_cm_probe(void);
67#else
68static inline int mips_cm_probe(void)
69{
70 return -ENODEV;
71}
72#endif
73
74/**
75 * mips_cm_present - determine whether a Coherence Manager is present
76 *
77 * Returns true if a CM is present in the system, else false.
78 */
79static inline bool mips_cm_present(void)
80{
81#ifdef CONFIG_MIPS_CM
82 return mips_gcr_base != NULL;
83#else
84 return false;
85#endif
86}
87
88/**
89 * mips_cm_has_l2sync - determine whether an L2-only sync region is present
90 *
91 * Returns true if the system implements an L2-only sync region, else false.
92 */
93static inline bool mips_cm_has_l2sync(void)
94{
95#ifdef CONFIG_MIPS_CM
96 return mips_cm_l2sync_base != NULL;
97#else
98 return false;
99#endif
100}
101
102/* Offsets to register blocks from the CM base address */
103#define MIPS_CM_GCB_OFS 0x0000 /* Global Control Block */
104#define MIPS_CM_CLCB_OFS 0x2000 /* Core Local Control Block */
105#define MIPS_CM_COCB_OFS 0x4000 /* Core Other Control Block */
106#define MIPS_CM_GDB_OFS 0x6000 /* Global Debug Block */
107
108/* Total size of the CM memory mapped registers */
109#define MIPS_CM_GCR_SIZE 0x8000
110
111/* Size of the L2-only sync region */
112#define MIPS_CM_L2SYNC_SIZE 0x1000
113
114#define GCR_ACCESSOR_RO(sz, off, name) \
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)
117
118#define GCR_ACCESSOR_RW(sz, off, name) \
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)
121
122#define GCR_CX_ACCESSOR_RO(sz, off, name) \
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)
125
126#define GCR_CX_ACCESSOR_RW(sz, off, name) \
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)
129
130/* GCR_CONFIG - Information about the system */
131GCR_ACCESSOR_RO(64, 0x000, config)
132#define CM_GCR_CONFIG_CLUSTER_COH_CAPABLE BIT_ULL(43)
133#define CM_GCR_CONFIG_CLUSTER_ID GENMASK_ULL(39, 32)
134#define CM_GCR_CONFIG_NUM_CLUSTERS GENMASK(29, 23)
135#define CM_GCR_CONFIG_NUMIOCU GENMASK(15, 8)
136#define CM_GCR_CONFIG_PCORES GENMASK(7, 0)
137
138/* GCR_BASE - Base address of the Global Configuration Registers (GCRs) */
139GCR_ACCESSOR_RW(64, 0x008, base)
140#define CM_GCR_BASE_GCRBASE GENMASK_ULL(47, 15)
141#define CM_GCR_BASE_CMDEFTGT GENMASK(1, 0)
142#define CM_GCR_BASE_CMDEFTGT_MEM 0
143#define CM_GCR_BASE_CMDEFTGT_RESERVED 1
144#define CM_GCR_BASE_CMDEFTGT_IOCU0 2
145#define CM_GCR_BASE_CMDEFTGT_IOCU1 3
146
147/* GCR_ACCESS - Controls core/IOCU access to GCRs */
148GCR_ACCESSOR_RW(32, 0x020, access)
149#define CM_GCR_ACCESS_ACCESSEN GENMASK(7, 0)
150
151/* GCR_REV - Indicates the Coherence Manager revision */
152GCR_ACCESSOR_RO(32, 0x030, rev)
153#define CM_GCR_REV_MAJOR GENMASK(15, 8)
154#define CM_GCR_REV_MINOR GENMASK(7, 0)
155
156#define CM_ENCODE_REV(major, minor) \
157 (FIELD_PREP(CM_GCR_REV_MAJOR, major) | \
158 FIELD_PREP(CM_GCR_REV_MINOR, minor))
159
160#define CM_REV_CM2 CM_ENCODE_REV(6, 0)
161#define CM_REV_CM2_5 CM_ENCODE_REV(7, 0)
162#define CM_REV_CM3 CM_ENCODE_REV(8, 0)
163#define CM_REV_CM3_5 CM_ENCODE_REV(9, 0)
164
165/* GCR_ERR_CONTROL - Control error checking logic */
166GCR_ACCESSOR_RW(32, 0x038, err_control)
167#define CM_GCR_ERR_CONTROL_L2_ECC_EN BIT(1)
168#define CM_GCR_ERR_CONTROL_L2_ECC_SUPPORT BIT(0)
169
170/* GCR_ERR_MASK - Control which errors are reported as interrupts */
171GCR_ACCESSOR_RW(64, 0x040, error_mask)
172
173/* GCR_ERR_CAUSE - Indicates the type of error that occurred */
174GCR_ACCESSOR_RW(64, 0x048, error_cause)
175#define CM_GCR_ERROR_CAUSE_ERRTYPE GENMASK(31, 27)
176#define CM3_GCR_ERROR_CAUSE_ERRTYPE GENMASK_ULL(63, 58)
177#define CM_GCR_ERROR_CAUSE_ERRINFO GENMASK(26, 0)
178
179/* GCR_ERR_ADDR - Indicates the address associated with an error */
180GCR_ACCESSOR_RW(64, 0x050, error_addr)
181
182/* GCR_ERR_MULT - Indicates when multiple errors have occurred */
183GCR_ACCESSOR_RW(64, 0x058, error_mult)
184#define CM_GCR_ERROR_MULT_ERR2ND GENMASK(4, 0)
185
186/* GCR_L2_ONLY_SYNC_BASE - Base address of the L2 cache-only sync region */
187GCR_ACCESSOR_RW(64, 0x070, l2_only_sync_base)
188#define CM_GCR_L2_ONLY_SYNC_BASE_SYNCBASE GENMASK(31, 12)
189#define CM_GCR_L2_ONLY_SYNC_BASE_SYNCEN BIT(0)
190
191/* GCR_GIC_BASE - Base address of the Global Interrupt Controller (GIC) */
192GCR_ACCESSOR_RW(64, 0x080, gic_base)
193#define CM_GCR_GIC_BASE_GICBASE GENMASK(31, 17)
194#define CM_GCR_GIC_BASE_GICEN BIT(0)
195
196/* GCR_CPC_BASE - Base address of the Cluster Power Controller (CPC) */
197GCR_ACCESSOR_RW(64, 0x088, cpc_base)
198#define CM_GCR_CPC_BASE_CPCBASE GENMASK(31, 15)
199#define CM_GCR_CPC_BASE_CPCEN BIT(0)
200
201/* GCR_REGn_BASE - Base addresses of CM address regions */
202GCR_ACCESSOR_RW(64, 0x090, reg0_base)
203GCR_ACCESSOR_RW(64, 0x0a0, reg1_base)
204GCR_ACCESSOR_RW(64, 0x0b0, reg2_base)
205GCR_ACCESSOR_RW(64, 0x0c0, reg3_base)
206#define CM_GCR_REGn_BASE_BASEADDR GENMASK(31, 16)
207
208/* GCR_REGn_MASK - Size & destination of CM address regions */
209GCR_ACCESSOR_RW(64, 0x098, reg0_mask)
210GCR_ACCESSOR_RW(64, 0x0a8, reg1_mask)
211GCR_ACCESSOR_RW(64, 0x0b8, reg2_mask)
212GCR_ACCESSOR_RW(64, 0x0c8, reg3_mask)
213#define CM_GCR_REGn_MASK_ADDRMASK GENMASK(31, 16)
214#define CM_GCR_REGn_MASK_CCAOVR GENMASK(7, 5)
215#define CM_GCR_REGn_MASK_CCAOVREN BIT(4)
216#define CM_GCR_REGn_MASK_DROPL2 BIT(2)
217#define CM_GCR_REGn_MASK_CMTGT GENMASK(1, 0)
218#define CM_GCR_REGn_MASK_CMTGT_DISABLED 0x0
219#define CM_GCR_REGn_MASK_CMTGT_MEM 0x1
220#define CM_GCR_REGn_MASK_CMTGT_IOCU0 0x2
221#define CM_GCR_REGn_MASK_CMTGT_IOCU1 0x3
222
223/* GCR_GIC_STATUS - Indicates presence of a Global Interrupt Controller (GIC) */
224GCR_ACCESSOR_RO(32, 0x0d0, gic_status)
225#define CM_GCR_GIC_STATUS_EX BIT(0)
226
227/* GCR_CPC_STATUS - Indicates presence of a Cluster Power Controller (CPC) */
228GCR_ACCESSOR_RO(32, 0x0f0, cpc_status)
229#define CM_GCR_CPC_STATUS_EX BIT(0)
230
231/* GCR_L2_CONFIG - Indicates L2 cache configuration when Config5.L2C=1 */
232GCR_ACCESSOR_RW(32, 0x130, l2_config)
233#define CM_GCR_L2_CONFIG_BYPASS BIT(20)
234#define CM_GCR_L2_CONFIG_SET_SIZE GENMASK(15, 12)
235#define CM_GCR_L2_CONFIG_LINE_SIZE GENMASK(11, 8)
236#define CM_GCR_L2_CONFIG_ASSOC GENMASK(7, 0)
237
238/* GCR_SYS_CONFIG2 - Further information about the system */
239GCR_ACCESSOR_RO(32, 0x150, sys_config2)
240#define CM_GCR_SYS_CONFIG2_MAXVPW GENMASK(3, 0)
241
242/* GCR_L2_PFT_CONTROL - Controls hardware L2 prefetching */
243GCR_ACCESSOR_RW(32, 0x300, l2_pft_control)
244#define CM_GCR_L2_PFT_CONTROL_PAGEMASK GENMASK(31, 12)
245#define CM_GCR_L2_PFT_CONTROL_PFTEN BIT(8)
246#define CM_GCR_L2_PFT_CONTROL_NPFT GENMASK(7, 0)
247
248/* GCR_L2_PFT_CONTROL_B - Controls hardware L2 prefetching */
249GCR_ACCESSOR_RW(32, 0x308, l2_pft_control_b)
250#define CM_GCR_L2_PFT_CONTROL_B_CEN BIT(8)
251#define CM_GCR_L2_PFT_CONTROL_B_PORTID GENMASK(7, 0)
252
253/* GCR_L2SM_COP - L2 cache op state machine control */
254GCR_ACCESSOR_RW(32, 0x620, l2sm_cop)
255#define CM_GCR_L2SM_COP_PRESENT BIT(31)
256#define CM_GCR_L2SM_COP_RESULT GENMASK(8, 6)
257#define CM_GCR_L2SM_COP_RESULT_DONTCARE 0
258#define CM_GCR_L2SM_COP_RESULT_DONE_OK 1
259#define CM_GCR_L2SM_COP_RESULT_DONE_ERROR 2
260#define CM_GCR_L2SM_COP_RESULT_ABORT_OK 3
261#define CM_GCR_L2SM_COP_RESULT_ABORT_ERROR 4
262#define CM_GCR_L2SM_COP_RUNNING BIT(5)
263#define CM_GCR_L2SM_COP_TYPE GENMASK(4, 2)
264#define CM_GCR_L2SM_COP_TYPE_IDX_WBINV 0
265#define CM_GCR_L2SM_COP_TYPE_IDX_STORETAG 1
266#define CM_GCR_L2SM_COP_TYPE_IDX_STORETAGDATA 2
267#define CM_GCR_L2SM_COP_TYPE_HIT_INV 4
268#define CM_GCR_L2SM_COP_TYPE_HIT_WBINV 5
269#define CM_GCR_L2SM_COP_TYPE_HIT_WB 6
270#define CM_GCR_L2SM_COP_TYPE_FETCHLOCK 7
271#define CM_GCR_L2SM_COP_CMD GENMASK(1, 0)
272#define CM_GCR_L2SM_COP_CMD_START 1 /* only when idle */
273#define CM_GCR_L2SM_COP_CMD_ABORT 3 /* only when running */
274
275/* GCR_L2SM_TAG_ADDR_COP - L2 cache op state machine address control */
276GCR_ACCESSOR_RW(64, 0x628, l2sm_tag_addr_cop)
277#define CM_GCR_L2SM_TAG_ADDR_COP_NUM_LINES GENMASK_ULL(63, 48)
278#define CM_GCR_L2SM_TAG_ADDR_COP_START_TAG GENMASK_ULL(47, 6)
279
280/* GCR_BEV_BASE - Controls the location of the BEV for powered up cores */
281GCR_ACCESSOR_RW(64, 0x680, bev_base)
282
283/* GCR_Cx_RESET_RELEASE - Controls core reset for CM 1.x */
284GCR_CX_ACCESSOR_RW(32, 0x000, reset_release)
285
286/* GCR_Cx_COHERENCE - Controls core coherence */
287GCR_CX_ACCESSOR_RW(32, 0x008, coherence)
288#define CM_GCR_Cx_COHERENCE_COHDOMAINEN GENMASK(7, 0)
289#define CM3_GCR_Cx_COHERENCE_COHEN BIT(0)
290
291/* GCR_Cx_CONFIG - Information about a core's configuration */
292GCR_CX_ACCESSOR_RO(32, 0x010, config)
293#define CM_GCR_Cx_CONFIG_IOCUTYPE GENMASK(11, 10)
294#define CM_GCR_Cx_CONFIG_PVPE GENMASK(9, 0)
295
296/* GCR_Cx_OTHER - Configure the core-other/redirect GCR block */
297GCR_CX_ACCESSOR_RW(32, 0x018, other)
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 */
302#define CM_GCR_Cx_OTHER_BLOCK_LOCAL 0
303#define CM_GCR_Cx_OTHER_BLOCK_GLOBAL 1
304#define CM_GCR_Cx_OTHER_BLOCK_USER 2
305#define CM_GCR_Cx_OTHER_BLOCK_GLOBAL_HIGH 3
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 */
308#define CM_GCR_Cx_OTHER_CORE_CM 32
309#define CM3_GCR_Cx_OTHER_VP GENMASK(2, 0) /* CM >= 3 */
310
311/* GCR_Cx_RESET_BASE - Configure where powered up cores will fetch from */
312GCR_CX_ACCESSOR_RW(32, 0x020, reset_base)
313#define CM_GCR_Cx_RESET_BASE_BEVEXCBASE GENMASK(31, 12)
314
315/* GCR_Cx_ID - Identify the current core */
316GCR_CX_ACCESSOR_RO(32, 0x028, id)
317#define CM_GCR_Cx_ID_CLUSTER GENMASK(15, 8)
318#define CM_GCR_Cx_ID_CORE GENMASK(7, 0)
319
320/* GCR_Cx_RESET_EXT_BASE - Configure behaviour when cores reset or power up */
321GCR_CX_ACCESSOR_RW(32, 0x030, reset_ext_base)
322#define CM_GCR_Cx_RESET_EXT_BASE_EVARESET BIT(31)
323#define CM_GCR_Cx_RESET_EXT_BASE_UEB BIT(30)
324#define CM_GCR_Cx_RESET_EXT_BASE_BEVEXCMASK GENMASK(27, 20)
325#define CM_GCR_Cx_RESET_EXT_BASE_BEVEXCPA GENMASK(7, 1)
326#define CM_GCR_Cx_RESET_EXT_BASE_PRESENT BIT(0)
327
328/**
329 * mips_cm_l2sync - perform an L2-only sync operation
330 *
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.
333 */
334static inline int mips_cm_l2sync(void)
335{
336 if (!mips_cm_has_l2sync())
337 return -ENODEV;
338
339 writel(0, mips_cm_l2sync_base);
340 return 0;
341}
342
343/**
344 * mips_cm_revision() - return CM revision
345 *
346 * Return: The revision of the CM, from GCR_REV, or 0 if no CM is present. The
347 * return value should be checked against the CM_REV_* macros.
348 */
349static inline int mips_cm_revision(void)
350{
351 if (!mips_cm_present())
352 return 0;
353
354 return read_gcr_rev();
355}
356
357/**
358 * mips_cm_max_vp_width() - return the width in bits of VP indices
359 *
360 * Return: the width, in bits, of VP indices in fields that combine core & VP
361 * indices.
362 */
363static inline unsigned int mips_cm_max_vp_width(void)
364{
365 extern int smp_num_siblings;
366
367 if (mips_cm_revision() >= CM_REV_CM3)
368 return FIELD_GET(CM_GCR_SYS_CONFIG2_MAXVPW,
369 read_gcr_sys_config2());
370
371 if (mips_cm_present()) {
372 /*
373 * We presume that all cores in the system will have the same
374 * number of VP(E)s, and if that ever changes then this will
375 * need revisiting.
376 */
377 return FIELD_GET(CM_GCR_Cx_CONFIG_PVPE, read_gcr_cl_config()) + 1;
378 }
379
380 if (IS_ENABLED(CONFIG_SMP))
381 return smp_num_siblings;
382
383 return 1;
384}
385
386/**
387 * mips_cm_vp_id() - calculate the hardware VP ID for a CPU
388 * @cpu: the CPU whose VP ID to calculate
389 *
390 * Hardware such as the GIC uses identifiers for VPs which may not match the
391 * CPU numbers used by Linux. This function calculates the hardware VP
392 * identifier corresponding to a given CPU.
393 *
394 * Return: the VP ID for the CPU.
395 */
396static inline unsigned int mips_cm_vp_id(unsigned int cpu)
397{
398 unsigned int core = cpu_core(&cpu_data[cpu]);
399 unsigned int vp = cpu_vpe_id(&cpu_data[cpu]);
400
401 return (core * mips_cm_max_vp_width()) + vp;
402}
403
404#ifdef CONFIG_MIPS_CM
405
406/**
407 * mips_cm_lock_other - lock access to redirect/other region
408 * @cluster: the other cluster to be accessed
409 * @core: the other core to be accessed
410 * @vp: the VP within the other core to be accessed
411 * @block: the register block to be accessed
412 *
413 * Configure the redirect/other region for the local core/VP (depending upon
414 * the CM revision) to target the specified @cluster, @core, @vp & register
415 * @block. Must be called before using the redirect/other region, and followed
416 * by a call to mips_cm_unlock_other() when access to the redirect/other region
417 * is complete.
418 *
419 * This function acquires a spinlock such that code between it &
420 * mips_cm_unlock_other() calls cannot be pre-empted by anything which may
421 * reconfigure the redirect/other region, and cannot be interfered with by
422 * another VP in the core. As such calls to this function should not be nested.
423 */
424extern void mips_cm_lock_other(unsigned int cluster, unsigned int core,
425 unsigned int vp, unsigned int block);
426
427/**
428 * mips_cm_unlock_other - unlock access to redirect/other region
429 *
430 * Must be called after mips_cm_lock_other() once all required access to the
431 * redirect/other region has been completed.
432 */
433extern void mips_cm_unlock_other(void);
434
435#else /* !CONFIG_MIPS_CM */
436
437static inline void mips_cm_lock_other(unsigned int cluster, unsigned int core,
438 unsigned int vp, unsigned int block) { }
439static inline void mips_cm_unlock_other(void) { }
440
441#endif /* !CONFIG_MIPS_CM */
442
443/**
444 * mips_cm_lock_other_cpu - lock access to redirect/other region
445 * @cpu: the other CPU whose register we want to access
446 *
447 * Configure the redirect/other region for the local core/VP (depending upon
448 * the CM revision) to target the specified @cpu & register @block. This is
449 * equivalent to calling mips_cm_lock_other() but accepts a Linux CPU number
450 * for convenience.
451 */
452static inline void mips_cm_lock_other_cpu(unsigned int cpu, unsigned int block)
453{
454 struct cpuinfo_mips *d = &cpu_data[cpu];
455
456 mips_cm_lock_other(cpu_cluster(d), cpu_core(d), cpu_vpe_id(d), block);
457}
458
459#endif /* __MIPS_ASM_MIPS_CM_H__ */
1/* SPDX-License-Identifier: GPL-2.0-or-later */
2/*
3 * Copyright (C) 2013 Imagination Technologies
4 * Author: Paul Burton <paul.burton@mips.com>
5 */
6
7#ifndef __MIPS_ASM_MIPS_CPS_H__
8# error Please include asm/mips-cps.h rather than asm/mips-cm.h
9#endif
10
11#ifndef __MIPS_ASM_MIPS_CM_H__
12#define __MIPS_ASM_MIPS_CM_H__
13
14#include <linux/bitfield.h>
15#include <linux/bitops.h>
16#include <linux/errno.h>
17
18/* The base address of the CM GCR block */
19extern void __iomem *mips_gcr_base;
20
21/* The base address of the CM L2-only sync region */
22extern void __iomem *mips_cm_l2sync_base;
23
24/**
25 * mips_cm_phys_base - retrieve the physical base address of the CM
26 *
27 * This function returns the physical base address of the Coherence Manager
28 * global control block, or 0 if no Coherence Manager is present. It provides
29 * a default implementation which reads the CMGCRBase register where available,
30 * and may be overridden by platforms which determine this address in a
31 * different way by defining a function with the same prototype.
32 */
33extern phys_addr_t mips_cm_phys_base(void);
34
35/**
36 * mips_cm_l2sync_phys_base - retrieve the physical base address of the CM
37 * L2-sync region
38 *
39 * This function returns the physical base address of the Coherence Manager
40 * L2-cache only region. It provides a default implementation which reads the
41 * CMGCRL2OnlySyncBase register where available or returns a 4K region just
42 * behind the CM GCR base address. It may be overridden by platforms which
43 * determine this address in a different way by defining a function with the
44 * same prototype.
45 */
46extern phys_addr_t mips_cm_l2sync_phys_base(void);
47
48/*
49 * mips_cm_is64 - determine CM register width
50 *
51 * The CM register width is determined by the version of the CM, with CM3
52 * introducing 64 bit GCRs and all prior CM versions having 32 bit GCRs.
53 * However we may run a kernel built for MIPS32 on a system with 64 bit GCRs,
54 * or vice-versa. This variable indicates the width of the memory accesses
55 * that the kernel will perform to GCRs, which may differ from the actual
56 * width of the GCRs.
57 *
58 * It's set to 0 for 32-bit accesses and 1 for 64-bit accesses.
59 */
60extern int mips_cm_is64;
61
62/**
63 * mips_cm_error_report - Report CM cache errors
64 */
65#ifdef CONFIG_MIPS_CM
66extern void mips_cm_error_report(void);
67#else
68static inline void mips_cm_error_report(void) {}
69#endif
70
71/**
72 * mips_cm_probe - probe for a Coherence Manager
73 *
74 * Attempt to detect the presence of a Coherence Manager. Returns 0 if a CM
75 * is successfully detected, else -errno.
76 */
77#ifdef CONFIG_MIPS_CM
78extern int mips_cm_probe(void);
79#else
80static inline int mips_cm_probe(void)
81{
82 return -ENODEV;
83}
84#endif
85
86/**
87 * mips_cm_present - determine whether a Coherence Manager is present
88 *
89 * Returns true if a CM is present in the system, else false.
90 */
91static inline bool mips_cm_present(void)
92{
93#ifdef CONFIG_MIPS_CM
94 return mips_gcr_base != NULL;
95#else
96 return false;
97#endif
98}
99
100/**
101 * mips_cm_has_l2sync - determine whether an L2-only sync region is present
102 *
103 * Returns true if the system implements an L2-only sync region, else false.
104 */
105static inline bool mips_cm_has_l2sync(void)
106{
107#ifdef CONFIG_MIPS_CM
108 return mips_cm_l2sync_base != NULL;
109#else
110 return false;
111#endif
112}
113
114/* Offsets to register blocks from the CM base address */
115#define MIPS_CM_GCB_OFS 0x0000 /* Global Control Block */
116#define MIPS_CM_CLCB_OFS 0x2000 /* Core Local Control Block */
117#define MIPS_CM_COCB_OFS 0x4000 /* Core Other Control Block */
118#define MIPS_CM_GDB_OFS 0x6000 /* Global Debug Block */
119
120/* Total size of the CM memory mapped registers */
121#define MIPS_CM_GCR_SIZE 0x8000
122
123/* Size of the L2-only sync region */
124#define MIPS_CM_L2SYNC_SIZE 0x1000
125
126#define GCR_ACCESSOR_RO(sz, off, name) \
127 CPS_ACCESSOR_RO(gcr, sz, MIPS_CM_GCB_OFS + off, name) \
128 CPS_ACCESSOR_RO(gcr, sz, MIPS_CM_COCB_OFS + off, redir_##name)
129
130#define GCR_ACCESSOR_RW(sz, off, name) \
131 CPS_ACCESSOR_RW(gcr, sz, MIPS_CM_GCB_OFS + off, name) \
132 CPS_ACCESSOR_RW(gcr, sz, MIPS_CM_COCB_OFS + off, redir_##name)
133
134#define GCR_CX_ACCESSOR_RO(sz, off, name) \
135 CPS_ACCESSOR_RO(gcr, sz, MIPS_CM_CLCB_OFS + off, cl_##name) \
136 CPS_ACCESSOR_RO(gcr, sz, MIPS_CM_COCB_OFS + off, co_##name)
137
138#define GCR_CX_ACCESSOR_RW(sz, off, name) \
139 CPS_ACCESSOR_RW(gcr, sz, MIPS_CM_CLCB_OFS + off, cl_##name) \
140 CPS_ACCESSOR_RW(gcr, sz, MIPS_CM_COCB_OFS + off, co_##name)
141
142/* GCR_CONFIG - Information about the system */
143GCR_ACCESSOR_RO(64, 0x000, config)
144#define CM_GCR_CONFIG_CLUSTER_COH_CAPABLE BIT_ULL(43)
145#define CM_GCR_CONFIG_CLUSTER_ID GENMASK_ULL(39, 32)
146#define CM_GCR_CONFIG_NUM_CLUSTERS GENMASK(29, 23)
147#define CM_GCR_CONFIG_NUMIOCU GENMASK(15, 8)
148#define CM_GCR_CONFIG_PCORES GENMASK(7, 0)
149
150/* GCR_BASE - Base address of the Global Configuration Registers (GCRs) */
151GCR_ACCESSOR_RW(64, 0x008, base)
152#define CM_GCR_BASE_GCRBASE GENMASK_ULL(47, 15)
153#define CM_GCR_BASE_CMDEFTGT GENMASK(1, 0)
154#define CM_GCR_BASE_CMDEFTGT_MEM 0
155#define CM_GCR_BASE_CMDEFTGT_RESERVED 1
156#define CM_GCR_BASE_CMDEFTGT_IOCU0 2
157#define CM_GCR_BASE_CMDEFTGT_IOCU1 3
158
159/* GCR_ACCESS - Controls core/IOCU access to GCRs */
160GCR_ACCESSOR_RW(32, 0x020, access)
161#define CM_GCR_ACCESS_ACCESSEN GENMASK(7, 0)
162
163/* GCR_REV - Indicates the Coherence Manager revision */
164GCR_ACCESSOR_RO(32, 0x030, rev)
165#define CM_GCR_REV_MAJOR GENMASK(15, 8)
166#define CM_GCR_REV_MINOR GENMASK(7, 0)
167
168#define CM_ENCODE_REV(major, minor) \
169 (FIELD_PREP(CM_GCR_REV_MAJOR, major) | \
170 FIELD_PREP(CM_GCR_REV_MINOR, minor))
171
172#define CM_REV_CM2 CM_ENCODE_REV(6, 0)
173#define CM_REV_CM2_5 CM_ENCODE_REV(7, 0)
174#define CM_REV_CM3 CM_ENCODE_REV(8, 0)
175#define CM_REV_CM3_5 CM_ENCODE_REV(9, 0)
176
177/* GCR_ERR_CONTROL - Control error checking logic */
178GCR_ACCESSOR_RW(32, 0x038, err_control)
179#define CM_GCR_ERR_CONTROL_L2_ECC_EN BIT(1)
180#define CM_GCR_ERR_CONTROL_L2_ECC_SUPPORT BIT(0)
181
182/* GCR_ERR_MASK - Control which errors are reported as interrupts */
183GCR_ACCESSOR_RW(64, 0x040, error_mask)
184
185/* GCR_ERR_CAUSE - Indicates the type of error that occurred */
186GCR_ACCESSOR_RW(64, 0x048, error_cause)
187#define CM_GCR_ERROR_CAUSE_ERRTYPE GENMASK(31, 27)
188#define CM3_GCR_ERROR_CAUSE_ERRTYPE GENMASK_ULL(63, 58)
189#define CM_GCR_ERROR_CAUSE_ERRINFO GENMASK(26, 0)
190
191/* GCR_ERR_ADDR - Indicates the address associated with an error */
192GCR_ACCESSOR_RW(64, 0x050, error_addr)
193
194/* GCR_ERR_MULT - Indicates when multiple errors have occurred */
195GCR_ACCESSOR_RW(64, 0x058, error_mult)
196#define CM_GCR_ERROR_MULT_ERR2ND GENMASK(4, 0)
197
198/* GCR_L2_ONLY_SYNC_BASE - Base address of the L2 cache-only sync region */
199GCR_ACCESSOR_RW(64, 0x070, l2_only_sync_base)
200#define CM_GCR_L2_ONLY_SYNC_BASE_SYNCBASE GENMASK(31, 12)
201#define CM_GCR_L2_ONLY_SYNC_BASE_SYNCEN BIT(0)
202
203/* GCR_GIC_BASE - Base address of the Global Interrupt Controller (GIC) */
204GCR_ACCESSOR_RW(64, 0x080, gic_base)
205#define CM_GCR_GIC_BASE_GICBASE GENMASK(31, 17)
206#define CM_GCR_GIC_BASE_GICEN BIT(0)
207
208/* GCR_CPC_BASE - Base address of the Cluster Power Controller (CPC) */
209GCR_ACCESSOR_RW(64, 0x088, cpc_base)
210#define CM_GCR_CPC_BASE_CPCBASE GENMASK(31, 15)
211#define CM_GCR_CPC_BASE_CPCEN BIT(0)
212
213/* GCR_REGn_BASE - Base addresses of CM address regions */
214GCR_ACCESSOR_RW(64, 0x090, reg0_base)
215GCR_ACCESSOR_RW(64, 0x0a0, reg1_base)
216GCR_ACCESSOR_RW(64, 0x0b0, reg2_base)
217GCR_ACCESSOR_RW(64, 0x0c0, reg3_base)
218#define CM_GCR_REGn_BASE_BASEADDR GENMASK(31, 16)
219
220/* GCR_REGn_MASK - Size & destination of CM address regions */
221GCR_ACCESSOR_RW(64, 0x098, reg0_mask)
222GCR_ACCESSOR_RW(64, 0x0a8, reg1_mask)
223GCR_ACCESSOR_RW(64, 0x0b8, reg2_mask)
224GCR_ACCESSOR_RW(64, 0x0c8, reg3_mask)
225#define CM_GCR_REGn_MASK_ADDRMASK GENMASK(31, 16)
226#define CM_GCR_REGn_MASK_CCAOVR GENMASK(7, 5)
227#define CM_GCR_REGn_MASK_CCAOVREN BIT(4)
228#define CM_GCR_REGn_MASK_DROPL2 BIT(2)
229#define CM_GCR_REGn_MASK_CMTGT GENMASK(1, 0)
230#define CM_GCR_REGn_MASK_CMTGT_DISABLED 0x0
231#define CM_GCR_REGn_MASK_CMTGT_MEM 0x1
232#define CM_GCR_REGn_MASK_CMTGT_IOCU0 0x2
233#define CM_GCR_REGn_MASK_CMTGT_IOCU1 0x3
234
235/* GCR_GIC_STATUS - Indicates presence of a Global Interrupt Controller (GIC) */
236GCR_ACCESSOR_RO(32, 0x0d0, gic_status)
237#define CM_GCR_GIC_STATUS_EX BIT(0)
238
239/* GCR_CPC_STATUS - Indicates presence of a Cluster Power Controller (CPC) */
240GCR_ACCESSOR_RO(32, 0x0f0, cpc_status)
241#define CM_GCR_CPC_STATUS_EX BIT(0)
242
243/* GCR_L2_CONFIG - Indicates L2 cache configuration when Config5.L2C=1 */
244GCR_ACCESSOR_RW(32, 0x130, l2_config)
245#define CM_GCR_L2_CONFIG_BYPASS BIT(20)
246#define CM_GCR_L2_CONFIG_SET_SIZE GENMASK(15, 12)
247#define CM_GCR_L2_CONFIG_LINE_SIZE GENMASK(11, 8)
248#define CM_GCR_L2_CONFIG_ASSOC GENMASK(7, 0)
249
250/* GCR_SYS_CONFIG2 - Further information about the system */
251GCR_ACCESSOR_RO(32, 0x150, sys_config2)
252#define CM_GCR_SYS_CONFIG2_MAXVPW GENMASK(3, 0)
253
254/* GCR_L2_PFT_CONTROL - Controls hardware L2 prefetching */
255GCR_ACCESSOR_RW(32, 0x300, l2_pft_control)
256#define CM_GCR_L2_PFT_CONTROL_PAGEMASK GENMASK(31, 12)
257#define CM_GCR_L2_PFT_CONTROL_PFTEN BIT(8)
258#define CM_GCR_L2_PFT_CONTROL_NPFT GENMASK(7, 0)
259
260/* GCR_L2_PFT_CONTROL_B - Controls hardware L2 prefetching */
261GCR_ACCESSOR_RW(32, 0x308, l2_pft_control_b)
262#define CM_GCR_L2_PFT_CONTROL_B_CEN BIT(8)
263#define CM_GCR_L2_PFT_CONTROL_B_PORTID GENMASK(7, 0)
264
265/* GCR_L2SM_COP - L2 cache op state machine control */
266GCR_ACCESSOR_RW(32, 0x620, l2sm_cop)
267#define CM_GCR_L2SM_COP_PRESENT BIT(31)
268#define CM_GCR_L2SM_COP_RESULT GENMASK(8, 6)
269#define CM_GCR_L2SM_COP_RESULT_DONTCARE 0
270#define CM_GCR_L2SM_COP_RESULT_DONE_OK 1
271#define CM_GCR_L2SM_COP_RESULT_DONE_ERROR 2
272#define CM_GCR_L2SM_COP_RESULT_ABORT_OK 3
273#define CM_GCR_L2SM_COP_RESULT_ABORT_ERROR 4
274#define CM_GCR_L2SM_COP_RUNNING BIT(5)
275#define CM_GCR_L2SM_COP_TYPE GENMASK(4, 2)
276#define CM_GCR_L2SM_COP_TYPE_IDX_WBINV 0
277#define CM_GCR_L2SM_COP_TYPE_IDX_STORETAG 1
278#define CM_GCR_L2SM_COP_TYPE_IDX_STORETAGDATA 2
279#define CM_GCR_L2SM_COP_TYPE_HIT_INV 4
280#define CM_GCR_L2SM_COP_TYPE_HIT_WBINV 5
281#define CM_GCR_L2SM_COP_TYPE_HIT_WB 6
282#define CM_GCR_L2SM_COP_TYPE_FETCHLOCK 7
283#define CM_GCR_L2SM_COP_CMD GENMASK(1, 0)
284#define CM_GCR_L2SM_COP_CMD_START 1 /* only when idle */
285#define CM_GCR_L2SM_COP_CMD_ABORT 3 /* only when running */
286
287/* GCR_L2SM_TAG_ADDR_COP - L2 cache op state machine address control */
288GCR_ACCESSOR_RW(64, 0x628, l2sm_tag_addr_cop)
289#define CM_GCR_L2SM_TAG_ADDR_COP_NUM_LINES GENMASK_ULL(63, 48)
290#define CM_GCR_L2SM_TAG_ADDR_COP_START_TAG GENMASK_ULL(47, 6)
291
292/* GCR_BEV_BASE - Controls the location of the BEV for powered up cores */
293GCR_ACCESSOR_RW(64, 0x680, bev_base)
294
295/* GCR_Cx_RESET_RELEASE - Controls core reset for CM 1.x */
296GCR_CX_ACCESSOR_RW(32, 0x000, reset_release)
297
298/* GCR_Cx_COHERENCE - Controls core coherence */
299GCR_CX_ACCESSOR_RW(32, 0x008, coherence)
300#define CM_GCR_Cx_COHERENCE_COHDOMAINEN GENMASK(7, 0)
301#define CM3_GCR_Cx_COHERENCE_COHEN BIT(0)
302
303/* GCR_Cx_CONFIG - Information about a core's configuration */
304GCR_CX_ACCESSOR_RO(32, 0x010, config)
305#define CM_GCR_Cx_CONFIG_IOCUTYPE GENMASK(11, 10)
306#define CM_GCR_Cx_CONFIG_PVPE GENMASK(9, 0)
307
308/* GCR_Cx_OTHER - Configure the core-other/redirect GCR block */
309GCR_CX_ACCESSOR_RW(32, 0x018, other)
310#define CM_GCR_Cx_OTHER_CORENUM GENMASK(31, 16) /* CM < 3 */
311#define CM_GCR_Cx_OTHER_CLUSTER_EN BIT(31) /* CM >= 3.5 */
312#define CM_GCR_Cx_OTHER_GIC_EN BIT(30) /* CM >= 3.5 */
313#define CM_GCR_Cx_OTHER_BLOCK GENMASK(25, 24) /* CM >= 3.5 */
314#define CM_GCR_Cx_OTHER_BLOCK_LOCAL 0
315#define CM_GCR_Cx_OTHER_BLOCK_GLOBAL 1
316#define CM_GCR_Cx_OTHER_BLOCK_USER 2
317#define CM_GCR_Cx_OTHER_BLOCK_GLOBAL_HIGH 3
318#define CM_GCR_Cx_OTHER_CLUSTER GENMASK(21, 16) /* CM >= 3.5 */
319#define CM3_GCR_Cx_OTHER_CORE GENMASK(13, 8) /* CM >= 3 */
320#define CM_GCR_Cx_OTHER_CORE_CM 32
321#define CM3_GCR_Cx_OTHER_VP GENMASK(2, 0) /* CM >= 3 */
322
323/* GCR_Cx_RESET_BASE - Configure where powered up cores will fetch from */
324GCR_CX_ACCESSOR_RW(32, 0x020, reset_base)
325#define CM_GCR_Cx_RESET_BASE_BEVEXCBASE GENMASK(31, 12)
326#define CM_GCR_Cx_RESET_BASE_MODE BIT(1)
327
328/* GCR_Cx_ID - Identify the current core */
329GCR_CX_ACCESSOR_RO(32, 0x028, id)
330#define CM_GCR_Cx_ID_CLUSTER GENMASK(15, 8)
331#define CM_GCR_Cx_ID_CORE GENMASK(7, 0)
332
333/* GCR_Cx_RESET_EXT_BASE - Configure behaviour when cores reset or power up */
334GCR_CX_ACCESSOR_RW(32, 0x030, reset_ext_base)
335#define CM_GCR_Cx_RESET_EXT_BASE_EVARESET BIT(31)
336#define CM_GCR_Cx_RESET_EXT_BASE_UEB BIT(30)
337#define CM_GCR_Cx_RESET_EXT_BASE_BEVEXCMASK GENMASK(27, 20)
338#define CM_GCR_Cx_RESET_EXT_BASE_BEVEXCPA GENMASK(7, 1)
339#define CM_GCR_Cx_RESET_EXT_BASE_PRESENT BIT(0)
340
341/**
342 * mips_cm_l2sync - perform an L2-only sync operation
343 *
344 * If an L2-only sync region is present in the system then this function
345 * performs and L2-only sync and returns zero. Otherwise it returns -ENODEV.
346 */
347static inline int mips_cm_l2sync(void)
348{
349 if (!mips_cm_has_l2sync())
350 return -ENODEV;
351
352 writel(0, mips_cm_l2sync_base);
353 return 0;
354}
355
356/**
357 * mips_cm_revision() - return CM revision
358 *
359 * Return: The revision of the CM, from GCR_REV, or 0 if no CM is present. The
360 * return value should be checked against the CM_REV_* macros.
361 */
362static inline int mips_cm_revision(void)
363{
364 if (!mips_cm_present())
365 return 0;
366
367 return read_gcr_rev();
368}
369
370/**
371 * mips_cm_max_vp_width() - return the width in bits of VP indices
372 *
373 * Return: the width, in bits, of VP indices in fields that combine core & VP
374 * indices.
375 */
376static inline unsigned int mips_cm_max_vp_width(void)
377{
378 extern int smp_num_siblings;
379
380 if (mips_cm_revision() >= CM_REV_CM3)
381 return FIELD_GET(CM_GCR_SYS_CONFIG2_MAXVPW,
382 read_gcr_sys_config2());
383
384 if (mips_cm_present()) {
385 /*
386 * We presume that all cores in the system will have the same
387 * number of VP(E)s, and if that ever changes then this will
388 * need revisiting.
389 */
390 return FIELD_GET(CM_GCR_Cx_CONFIG_PVPE, read_gcr_cl_config()) + 1;
391 }
392
393 if (IS_ENABLED(CONFIG_SMP))
394 return smp_num_siblings;
395
396 return 1;
397}
398
399/**
400 * mips_cm_vp_id() - calculate the hardware VP ID for a CPU
401 * @cpu: the CPU whose VP ID to calculate
402 *
403 * Hardware such as the GIC uses identifiers for VPs which may not match the
404 * CPU numbers used by Linux. This function calculates the hardware VP
405 * identifier corresponding to a given CPU.
406 *
407 * Return: the VP ID for the CPU.
408 */
409static inline unsigned int mips_cm_vp_id(unsigned int cpu)
410{
411 unsigned int core = cpu_core(&cpu_data[cpu]);
412 unsigned int vp = cpu_vpe_id(&cpu_data[cpu]);
413
414 return (core * mips_cm_max_vp_width()) + vp;
415}
416
417#ifdef CONFIG_MIPS_CM
418
419/**
420 * mips_cm_lock_other - lock access to redirect/other region
421 * @cluster: the other cluster to be accessed
422 * @core: the other core to be accessed
423 * @vp: the VP within the other core to be accessed
424 * @block: the register block to be accessed
425 *
426 * Configure the redirect/other region for the local core/VP (depending upon
427 * the CM revision) to target the specified @cluster, @core, @vp & register
428 * @block. Must be called before using the redirect/other region, and followed
429 * by a call to mips_cm_unlock_other() when access to the redirect/other region
430 * is complete.
431 *
432 * This function acquires a spinlock such that code between it &
433 * mips_cm_unlock_other() calls cannot be pre-empted by anything which may
434 * reconfigure the redirect/other region, and cannot be interfered with by
435 * another VP in the core. As such calls to this function should not be nested.
436 */
437extern void mips_cm_lock_other(unsigned int cluster, unsigned int core,
438 unsigned int vp, unsigned int block);
439
440/**
441 * mips_cm_unlock_other - unlock access to redirect/other region
442 *
443 * Must be called after mips_cm_lock_other() once all required access to the
444 * redirect/other region has been completed.
445 */
446extern void mips_cm_unlock_other(void);
447
448#else /* !CONFIG_MIPS_CM */
449
450static inline void mips_cm_lock_other(unsigned int cluster, unsigned int core,
451 unsigned int vp, unsigned int block) { }
452static inline void mips_cm_unlock_other(void) { }
453
454#endif /* !CONFIG_MIPS_CM */
455
456/**
457 * mips_cm_lock_other_cpu - lock access to redirect/other region
458 * @cpu: the other CPU whose register we want to access
459 *
460 * Configure the redirect/other region for the local core/VP (depending upon
461 * the CM revision) to target the specified @cpu & register @block. This is
462 * equivalent to calling mips_cm_lock_other() but accepts a Linux CPU number
463 * for convenience.
464 */
465static inline void mips_cm_lock_other_cpu(unsigned int cpu, unsigned int block)
466{
467 struct cpuinfo_mips *d = &cpu_data[cpu];
468
469 mips_cm_lock_other(cpu_cluster(d), cpu_core(d), cpu_vpe_id(d), block);
470}
471
472#endif /* __MIPS_ASM_MIPS_CM_H__ */