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/bitops.h>
15#include <linux/errno.h>
16
17/* The base address of the CM GCR block */
18extern void __iomem *mips_gcr_base;
19
20/* The base address of the CM L2-only sync region */
21extern void __iomem *mips_cm_l2sync_base;
22
23/**
24 * __mips_cm_phys_base - retrieve the physical base address of the CM
25 *
26 * This function returns the physical base address of the Coherence Manager
27 * global control block, or 0 if no Coherence Manager is present. It provides
28 * a default implementation which reads the CMGCRBase register where available,
29 * and may be overridden by platforms which determine this address in a
30 * different way by defining a function with the same prototype except for the
31 * name mips_cm_phys_base (without underscores).
32 */
33extern phys_addr_t __mips_cm_phys_base(void);
34
35/*
36 * mips_cm_is64 - determine CM register width
37 *
38 * The CM register width is determined by the version of the CM, with CM3
39 * introducing 64 bit GCRs and all prior CM versions having 32 bit GCRs.
40 * However we may run a kernel built for MIPS32 on a system with 64 bit GCRs,
41 * or vice-versa. This variable indicates the width of the memory accesses
42 * that the kernel will perform to GCRs, which may differ from the actual
43 * width of the GCRs.
44 *
45 * It's set to 0 for 32-bit accesses and 1 for 64-bit accesses.
46 */
47extern int mips_cm_is64;
48
49/**
50 * mips_cm_error_report - Report CM cache errors
51 */
52#ifdef CONFIG_MIPS_CM
53extern void mips_cm_error_report(void);
54#else
55static inline void mips_cm_error_report(void) {}
56#endif
57
58/**
59 * mips_cm_probe - probe for a Coherence Manager
60 *
61 * Attempt to detect the presence of a Coherence Manager. Returns 0 if a CM
62 * is successfully detected, else -errno.
63 */
64#ifdef CONFIG_MIPS_CM
65extern int mips_cm_probe(void);
66#else
67static inline int mips_cm_probe(void)
68{
69 return -ENODEV;
70}
71#endif
72
73/**
74 * mips_cm_present - determine whether a Coherence Manager is present
75 *
76 * Returns true if a CM is present in the system, else false.
77 */
78static inline bool mips_cm_present(void)
79{
80#ifdef CONFIG_MIPS_CM
81 return mips_gcr_base != NULL;
82#else
83 return false;
84#endif
85}
86
87/**
88 * mips_cm_has_l2sync - determine whether an L2-only sync region is present
89 *
90 * Returns true if the system implements an L2-only sync region, else false.
91 */
92static inline bool mips_cm_has_l2sync(void)
93{
94#ifdef CONFIG_MIPS_CM
95 return mips_cm_l2sync_base != NULL;
96#else
97 return false;
98#endif
99}
100
101/* Offsets to register blocks from the CM base address */
102#define MIPS_CM_GCB_OFS 0x0000 /* Global Control Block */
103#define MIPS_CM_CLCB_OFS 0x2000 /* Core Local Control Block */
104#define MIPS_CM_COCB_OFS 0x4000 /* Core Other Control Block */
105#define MIPS_CM_GDB_OFS 0x6000 /* Global Debug Block */
106
107/* Total size of the CM memory mapped registers */
108#define MIPS_CM_GCR_SIZE 0x8000
109
110/* Size of the L2-only sync region */
111#define MIPS_CM_L2SYNC_SIZE 0x1000
112
113#define GCR_ACCESSOR_RO(sz, off, name) \
114 CPS_ACCESSOR_RO(gcr, sz, MIPS_CM_GCB_OFS + off, name) \
115 CPS_ACCESSOR_RO(gcr, sz, MIPS_CM_COCB_OFS + off, redir_##name)
116
117#define GCR_ACCESSOR_RW(sz, off, name) \
118 CPS_ACCESSOR_RW(gcr, sz, MIPS_CM_GCB_OFS + off, name) \
119 CPS_ACCESSOR_RW(gcr, sz, MIPS_CM_COCB_OFS + off, redir_##name)
120
121#define GCR_CX_ACCESSOR_RO(sz, off, name) \
122 CPS_ACCESSOR_RO(gcr, sz, MIPS_CM_CLCB_OFS + off, cl_##name) \
123 CPS_ACCESSOR_RO(gcr, sz, MIPS_CM_COCB_OFS + off, co_##name)
124
125#define GCR_CX_ACCESSOR_RW(sz, off, name) \
126 CPS_ACCESSOR_RW(gcr, sz, MIPS_CM_CLCB_OFS + off, cl_##name) \
127 CPS_ACCESSOR_RW(gcr, sz, MIPS_CM_COCB_OFS + off, co_##name)
128
129/* GCR_CONFIG - Information about the system */
130GCR_ACCESSOR_RO(64, 0x000, config)
131#define CM_GCR_CONFIG_CLUSTER_COH_CAPABLE BIT_ULL(43)
132#define CM_GCR_CONFIG_CLUSTER_ID GENMASK_ULL(39, 32)
133#define CM_GCR_CONFIG_NUM_CLUSTERS GENMASK(29, 23)
134#define CM_GCR_CONFIG_NUMIOCU GENMASK(15, 8)
135#define CM_GCR_CONFIG_PCORES GENMASK(7, 0)
136
137/* GCR_BASE - Base address of the Global Configuration Registers (GCRs) */
138GCR_ACCESSOR_RW(64, 0x008, base)
139#define CM_GCR_BASE_GCRBASE GENMASK_ULL(47, 15)
140#define CM_GCR_BASE_CMDEFTGT GENMASK(1, 0)
141#define CM_GCR_BASE_CMDEFTGT_MEM 0
142#define CM_GCR_BASE_CMDEFTGT_RESERVED 1
143#define CM_GCR_BASE_CMDEFTGT_IOCU0 2
144#define CM_GCR_BASE_CMDEFTGT_IOCU1 3
145
146/* GCR_ACCESS - Controls core/IOCU access to GCRs */
147GCR_ACCESSOR_RW(32, 0x020, access)
148#define CM_GCR_ACCESS_ACCESSEN GENMASK(7, 0)
149
150/* GCR_REV - Indicates the Coherence Manager revision */
151GCR_ACCESSOR_RO(32, 0x030, rev)
152#define CM_GCR_REV_MAJOR GENMASK(15, 8)
153#define CM_GCR_REV_MINOR GENMASK(7, 0)
154
155#define CM_ENCODE_REV(major, minor) \
156 (((major) << __ffs(CM_GCR_REV_MAJOR)) | \
157 ((minor) << __ffs(CM_GCR_REV_MINOR)))
158
159#define CM_REV_CM2 CM_ENCODE_REV(6, 0)
160#define CM_REV_CM2_5 CM_ENCODE_REV(7, 0)
161#define CM_REV_CM3 CM_ENCODE_REV(8, 0)
162#define CM_REV_CM3_5 CM_ENCODE_REV(9, 0)
163
164/* GCR_ERR_CONTROL - Control error checking logic */
165GCR_ACCESSOR_RW(32, 0x038, err_control)
166#define CM_GCR_ERR_CONTROL_L2_ECC_EN BIT(1)
167#define CM_GCR_ERR_CONTROL_L2_ECC_SUPPORT BIT(0)
168
169/* GCR_ERR_MASK - Control which errors are reported as interrupts */
170GCR_ACCESSOR_RW(64, 0x040, error_mask)
171
172/* GCR_ERR_CAUSE - Indicates the type of error that occurred */
173GCR_ACCESSOR_RW(64, 0x048, error_cause)
174#define CM_GCR_ERROR_CAUSE_ERRTYPE GENMASK(31, 27)
175#define CM3_GCR_ERROR_CAUSE_ERRTYPE GENMASK_ULL(63, 58)
176#define CM_GCR_ERROR_CAUSE_ERRINFO GENMASK(26, 0)
177
178/* GCR_ERR_ADDR - Indicates the address associated with an error */
179GCR_ACCESSOR_RW(64, 0x050, error_addr)
180
181/* GCR_ERR_MULT - Indicates when multiple errors have occurred */
182GCR_ACCESSOR_RW(64, 0x058, error_mult)
183#define CM_GCR_ERROR_MULT_ERR2ND GENMASK(4, 0)
184
185/* GCR_L2_ONLY_SYNC_BASE - Base address of the L2 cache-only sync region */
186GCR_ACCESSOR_RW(64, 0x070, l2_only_sync_base)
187#define CM_GCR_L2_ONLY_SYNC_BASE_SYNCBASE GENMASK(31, 12)
188#define CM_GCR_L2_ONLY_SYNC_BASE_SYNCEN BIT(0)
189
190/* GCR_GIC_BASE - Base address of the Global Interrupt Controller (GIC) */
191GCR_ACCESSOR_RW(64, 0x080, gic_base)
192#define CM_GCR_GIC_BASE_GICBASE GENMASK(31, 17)
193#define CM_GCR_GIC_BASE_GICEN BIT(0)
194
195/* GCR_CPC_BASE - Base address of the Cluster Power Controller (CPC) */
196GCR_ACCESSOR_RW(64, 0x088, cpc_base)
197#define CM_GCR_CPC_BASE_CPCBASE GENMASK(31, 15)
198#define CM_GCR_CPC_BASE_CPCEN BIT(0)
199
200/* GCR_REGn_BASE - Base addresses of CM address regions */
201GCR_ACCESSOR_RW(64, 0x090, reg0_base)
202GCR_ACCESSOR_RW(64, 0x0a0, reg1_base)
203GCR_ACCESSOR_RW(64, 0x0b0, reg2_base)
204GCR_ACCESSOR_RW(64, 0x0c0, reg3_base)
205#define CM_GCR_REGn_BASE_BASEADDR GENMASK(31, 16)
206
207/* GCR_REGn_MASK - Size & destination of CM address regions */
208GCR_ACCESSOR_RW(64, 0x098, reg0_mask)
209GCR_ACCESSOR_RW(64, 0x0a8, reg1_mask)
210GCR_ACCESSOR_RW(64, 0x0b8, reg2_mask)
211GCR_ACCESSOR_RW(64, 0x0c8, reg3_mask)
212#define CM_GCR_REGn_MASK_ADDRMASK GENMASK(31, 16)
213#define CM_GCR_REGn_MASK_CCAOVR GENMASK(7, 5)
214#define CM_GCR_REGn_MASK_CCAOVREN BIT(4)
215#define CM_GCR_REGn_MASK_DROPL2 BIT(2)
216#define CM_GCR_REGn_MASK_CMTGT GENMASK(1, 0)
217#define CM_GCR_REGn_MASK_CMTGT_DISABLED 0x0
218#define CM_GCR_REGn_MASK_CMTGT_MEM 0x1
219#define CM_GCR_REGn_MASK_CMTGT_IOCU0 0x2
220#define CM_GCR_REGn_MASK_CMTGT_IOCU1 0x3
221
222/* GCR_GIC_STATUS - Indicates presence of a Global Interrupt Controller (GIC) */
223GCR_ACCESSOR_RO(32, 0x0d0, gic_status)
224#define CM_GCR_GIC_STATUS_EX BIT(0)
225
226/* GCR_CPC_STATUS - Indicates presence of a Cluster Power Controller (CPC) */
227GCR_ACCESSOR_RO(32, 0x0f0, cpc_status)
228#define CM_GCR_CPC_STATUS_EX BIT(0)
229
230/* GCR_L2_CONFIG - Indicates L2 cache configuration when Config5.L2C=1 */
231GCR_ACCESSOR_RW(32, 0x130, l2_config)
232#define CM_GCR_L2_CONFIG_BYPASS BIT(20)
233#define CM_GCR_L2_CONFIG_SET_SIZE GENMASK(15, 12)
234#define CM_GCR_L2_CONFIG_LINE_SIZE GENMASK(11, 8)
235#define CM_GCR_L2_CONFIG_ASSOC GENMASK(7, 0)
236
237/* GCR_SYS_CONFIG2 - Further information about the system */
238GCR_ACCESSOR_RO(32, 0x150, sys_config2)
239#define CM_GCR_SYS_CONFIG2_MAXVPW GENMASK(3, 0)
240
241/* GCR_L2_PFT_CONTROL - Controls hardware L2 prefetching */
242GCR_ACCESSOR_RW(32, 0x300, l2_pft_control)
243#define CM_GCR_L2_PFT_CONTROL_PAGEMASK GENMASK(31, 12)
244#define CM_GCR_L2_PFT_CONTROL_PFTEN BIT(8)
245#define CM_GCR_L2_PFT_CONTROL_NPFT GENMASK(7, 0)
246
247/* GCR_L2_PFT_CONTROL_B - Controls hardware L2 prefetching */
248GCR_ACCESSOR_RW(32, 0x308, l2_pft_control_b)
249#define CM_GCR_L2_PFT_CONTROL_B_CEN BIT(8)
250#define CM_GCR_L2_PFT_CONTROL_B_PORTID GENMASK(7, 0)
251
252/* GCR_L2SM_COP - L2 cache op state machine control */
253GCR_ACCESSOR_RW(32, 0x620, l2sm_cop)
254#define CM_GCR_L2SM_COP_PRESENT BIT(31)
255#define CM_GCR_L2SM_COP_RESULT GENMASK(8, 6)
256#define CM_GCR_L2SM_COP_RESULT_DONTCARE 0
257#define CM_GCR_L2SM_COP_RESULT_DONE_OK 1
258#define CM_GCR_L2SM_COP_RESULT_DONE_ERROR 2
259#define CM_GCR_L2SM_COP_RESULT_ABORT_OK 3
260#define CM_GCR_L2SM_COP_RESULT_ABORT_ERROR 4
261#define CM_GCR_L2SM_COP_RUNNING BIT(5)
262#define CM_GCR_L2SM_COP_TYPE GENMASK(4, 2)
263#define CM_GCR_L2SM_COP_TYPE_IDX_WBINV 0
264#define CM_GCR_L2SM_COP_TYPE_IDX_STORETAG 1
265#define CM_GCR_L2SM_COP_TYPE_IDX_STORETAGDATA 2
266#define CM_GCR_L2SM_COP_TYPE_HIT_INV 4
267#define CM_GCR_L2SM_COP_TYPE_HIT_WBINV 5
268#define CM_GCR_L2SM_COP_TYPE_HIT_WB 6
269#define CM_GCR_L2SM_COP_TYPE_FETCHLOCK 7
270#define CM_GCR_L2SM_COP_CMD GENMASK(1, 0)
271#define CM_GCR_L2SM_COP_CMD_START 1 /* only when idle */
272#define CM_GCR_L2SM_COP_CMD_ABORT 3 /* only when running */
273
274/* GCR_L2SM_TAG_ADDR_COP - L2 cache op state machine address control */
275GCR_ACCESSOR_RW(64, 0x628, l2sm_tag_addr_cop)
276#define CM_GCR_L2SM_TAG_ADDR_COP_NUM_LINES GENMASK_ULL(63, 48)
277#define CM_GCR_L2SM_TAG_ADDR_COP_START_TAG GENMASK_ULL(47, 6)
278
279/* GCR_BEV_BASE - Controls the location of the BEV for powered up cores */
280GCR_ACCESSOR_RW(64, 0x680, bev_base)
281
282/* GCR_Cx_RESET_RELEASE - Controls core reset for CM 1.x */
283GCR_CX_ACCESSOR_RW(32, 0x000, reset_release)
284
285/* GCR_Cx_COHERENCE - Controls core coherence */
286GCR_CX_ACCESSOR_RW(32, 0x008, coherence)
287#define CM_GCR_Cx_COHERENCE_COHDOMAINEN GENMASK(7, 0)
288#define CM3_GCR_Cx_COHERENCE_COHEN BIT(0)
289
290/* GCR_Cx_CONFIG - Information about a core's configuration */
291GCR_CX_ACCESSOR_RO(32, 0x010, config)
292#define CM_GCR_Cx_CONFIG_IOCUTYPE GENMASK(11, 10)
293#define CM_GCR_Cx_CONFIG_PVPE GENMASK(9, 0)
294
295/* GCR_Cx_OTHER - Configure the core-other/redirect GCR block */
296GCR_CX_ACCESSOR_RW(32, 0x018, other)
297#define CM_GCR_Cx_OTHER_CORENUM GENMASK(31, 16) /* CM < 3 */
298#define CM_GCR_Cx_OTHER_CLUSTER_EN BIT(31) /* CM >= 3.5 */
299#define CM_GCR_Cx_OTHER_GIC_EN BIT(30) /* CM >= 3.5 */
300#define CM_GCR_Cx_OTHER_BLOCK GENMASK(25, 24) /* CM >= 3.5 */
301#define CM_GCR_Cx_OTHER_BLOCK_LOCAL 0
302#define CM_GCR_Cx_OTHER_BLOCK_GLOBAL 1
303#define CM_GCR_Cx_OTHER_BLOCK_USER 2
304#define CM_GCR_Cx_OTHER_BLOCK_GLOBAL_HIGH 3
305#define CM_GCR_Cx_OTHER_CLUSTER GENMASK(21, 16) /* CM >= 3.5 */
306#define CM3_GCR_Cx_OTHER_CORE GENMASK(13, 8) /* CM >= 3 */
307#define CM_GCR_Cx_OTHER_CORE_CM 32
308#define CM3_GCR_Cx_OTHER_VP GENMASK(2, 0) /* CM >= 3 */
309
310/* GCR_Cx_RESET_BASE - Configure where powered up cores will fetch from */
311GCR_CX_ACCESSOR_RW(32, 0x020, reset_base)
312#define CM_GCR_Cx_RESET_BASE_BEVEXCBASE GENMASK(31, 12)
313
314/* GCR_Cx_ID - Identify the current core */
315GCR_CX_ACCESSOR_RO(32, 0x028, id)
316#define CM_GCR_Cx_ID_CLUSTER GENMASK(15, 8)
317#define CM_GCR_Cx_ID_CORE GENMASK(7, 0)
318
319/* GCR_Cx_RESET_EXT_BASE - Configure behaviour when cores reset or power up */
320GCR_CX_ACCESSOR_RW(32, 0x030, reset_ext_base)
321#define CM_GCR_Cx_RESET_EXT_BASE_EVARESET BIT(31)
322#define CM_GCR_Cx_RESET_EXT_BASE_UEB BIT(30)
323#define CM_GCR_Cx_RESET_EXT_BASE_BEVEXCMASK GENMASK(27, 20)
324#define CM_GCR_Cx_RESET_EXT_BASE_BEVEXCPA GENMASK(7, 1)
325#define CM_GCR_Cx_RESET_EXT_BASE_PRESENT BIT(0)
326
327/**
328 * mips_cm_l2sync - perform an L2-only sync operation
329 *
330 * If an L2-only sync region is present in the system then this function
331 * performs and L2-only sync and returns zero. Otherwise it returns -ENODEV.
332 */
333static inline int mips_cm_l2sync(void)
334{
335 if (!mips_cm_has_l2sync())
336 return -ENODEV;
337
338 writel(0, mips_cm_l2sync_base);
339 return 0;
340}
341
342/**
343 * mips_cm_revision() - return CM revision
344 *
345 * Return: The revision of the CM, from GCR_REV, or 0 if no CM is present. The
346 * return value should be checked against the CM_REV_* macros.
347 */
348static inline int mips_cm_revision(void)
349{
350 if (!mips_cm_present())
351 return 0;
352
353 return read_gcr_rev();
354}
355
356/**
357 * mips_cm_max_vp_width() - return the width in bits of VP indices
358 *
359 * Return: the width, in bits, of VP indices in fields that combine core & VP
360 * indices.
361 */
362static inline unsigned int mips_cm_max_vp_width(void)
363{
364 extern int smp_num_siblings;
365 uint32_t cfg;
366
367 if (mips_cm_revision() >= CM_REV_CM3)
368 return read_gcr_sys_config2() & CM_GCR_SYS_CONFIG2_MAXVPW;
369
370 if (mips_cm_present()) {
371 /*
372 * We presume that all cores in the system will have the same
373 * number of VP(E)s, and if that ever changes then this will
374 * need revisiting.
375 */
376 cfg = read_gcr_cl_config() & CM_GCR_Cx_CONFIG_PVPE;
377 return (cfg >> __ffs(CM_GCR_Cx_CONFIG_PVPE)) + 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/*
2 * Copyright (C) 2013 Imagination Technologies
3 * Author: Paul Burton <paul.burton@imgtec.com>
4 *
5 * This program is free software; you can redistribute it and/or modify it
6 * under the terms of the GNU General Public License as published by the
7 * Free Software Foundation; either version 2 of the License, or (at your
8 * option) any later version.
9 */
10
11#ifndef __MIPS_ASM_MIPS_CM_H__
12#define __MIPS_ASM_MIPS_CM_H__
13
14#include <linux/bitops.h>
15#include <linux/errno.h>
16#include <linux/io.h>
17#include <linux/types.h>
18
19/* The base address of the CM GCR block */
20extern void __iomem *mips_cm_base;
21
22/* The base address of the CM L2-only sync region */
23extern void __iomem *mips_cm_l2sync_base;
24
25/**
26 * __mips_cm_phys_base - retrieve the physical base address of the CM
27 *
28 * This function returns the physical base address of the Coherence Manager
29 * global control block, or 0 if no Coherence Manager is present. It provides
30 * a default implementation which reads the CMGCRBase register where available,
31 * and may be overridden by platforms which determine this address in a
32 * different way by defining a function with the same prototype except for the
33 * name mips_cm_phys_base (without underscores).
34 */
35extern phys_addr_t __mips_cm_phys_base(void);
36
37/*
38 * mips_cm_is64 - determine CM register width
39 *
40 * The CM register width is determined by the version of the CM, with CM3
41 * introducing 64 bit GCRs and all prior CM versions having 32 bit GCRs.
42 * However we may run a kernel built for MIPS32 on a system with 64 bit GCRs,
43 * or vice-versa. This variable indicates the width of the memory accesses
44 * that the kernel will perform to GCRs, which may differ from the actual
45 * width of the GCRs.
46 *
47 * It's set to 0 for 32-bit accesses and 1 for 64-bit accesses.
48 */
49extern int mips_cm_is64;
50
51/**
52 * mips_cm_error_report - Report CM cache errors
53 */
54#ifdef CONFIG_MIPS_CM
55extern void mips_cm_error_report(void);
56#else
57static inline void mips_cm_error_report(void) {}
58#endif
59
60/**
61 * mips_cm_probe - probe for a Coherence Manager
62 *
63 * Attempt to detect the presence of a Coherence Manager. Returns 0 if a CM
64 * is successfully detected, else -errno.
65 */
66#ifdef CONFIG_MIPS_CM
67extern int mips_cm_probe(void);
68#else
69static inline int mips_cm_probe(void)
70{
71 return -ENODEV;
72}
73#endif
74
75/**
76 * mips_cm_present - determine whether a Coherence Manager is present
77 *
78 * Returns true if a CM is present in the system, else false.
79 */
80static inline bool mips_cm_present(void)
81{
82#ifdef CONFIG_MIPS_CM
83 return mips_cm_base != NULL;
84#else
85 return false;
86#endif
87}
88
89/**
90 * mips_cm_has_l2sync - determine whether an L2-only sync region is present
91 *
92 * Returns true if the system implements an L2-only sync region, else false.
93 */
94static inline bool mips_cm_has_l2sync(void)
95{
96#ifdef CONFIG_MIPS_CM
97 return mips_cm_l2sync_base != NULL;
98#else
99 return false;
100#endif
101}
102
103/* Offsets to register blocks from the CM base address */
104#define MIPS_CM_GCB_OFS 0x0000 /* Global Control Block */
105#define MIPS_CM_CLCB_OFS 0x2000 /* Core Local Control Block */
106#define MIPS_CM_COCB_OFS 0x4000 /* Core Other Control Block */
107#define MIPS_CM_GDB_OFS 0x6000 /* Global Debug Block */
108
109/* Total size of the CM memory mapped registers */
110#define MIPS_CM_GCR_SIZE 0x8000
111
112/* Size of the L2-only sync region */
113#define MIPS_CM_L2SYNC_SIZE 0x1000
114
115/* Macros to ease the creation of register access functions */
116#define BUILD_CM_R_(name, off) \
117static inline unsigned long __iomem *addr_gcr_##name(void) \
118{ \
119 return (unsigned long __iomem *)(mips_cm_base + (off)); \
120} \
121 \
122static inline u32 read32_gcr_##name(void) \
123{ \
124 return __raw_readl(addr_gcr_##name()); \
125} \
126 \
127static inline u64 read64_gcr_##name(void) \
128{ \
129 void __iomem *addr = addr_gcr_##name(); \
130 u64 ret; \
131 \
132 if (mips_cm_is64) { \
133 ret = __raw_readq(addr); \
134 } else { \
135 ret = __raw_readl(addr); \
136 ret |= (u64)__raw_readl(addr + 0x4) << 32; \
137 } \
138 \
139 return ret; \
140} \
141 \
142static inline unsigned long read_gcr_##name(void) \
143{ \
144 if (mips_cm_is64) \
145 return read64_gcr_##name(); \
146 else \
147 return read32_gcr_##name(); \
148}
149
150#define BUILD_CM__W(name, off) \
151static inline void write32_gcr_##name(u32 value) \
152{ \
153 __raw_writel(value, addr_gcr_##name()); \
154} \
155 \
156static inline void write64_gcr_##name(u64 value) \
157{ \
158 __raw_writeq(value, addr_gcr_##name()); \
159} \
160 \
161static inline void write_gcr_##name(unsigned long value) \
162{ \
163 if (mips_cm_is64) \
164 write64_gcr_##name(value); \
165 else \
166 write32_gcr_##name(value); \
167}
168
169#define BUILD_CM_RW(name, off) \
170 BUILD_CM_R_(name, off) \
171 BUILD_CM__W(name, off)
172
173#define BUILD_CM_Cx_R_(name, off) \
174 BUILD_CM_R_(cl_##name, MIPS_CM_CLCB_OFS + (off)) \
175 BUILD_CM_R_(co_##name, MIPS_CM_COCB_OFS + (off))
176
177#define BUILD_CM_Cx__W(name, off) \
178 BUILD_CM__W(cl_##name, MIPS_CM_CLCB_OFS + (off)) \
179 BUILD_CM__W(co_##name, MIPS_CM_COCB_OFS + (off))
180
181#define BUILD_CM_Cx_RW(name, off) \
182 BUILD_CM_Cx_R_(name, off) \
183 BUILD_CM_Cx__W(name, off)
184
185/* GCB register accessor functions */
186BUILD_CM_R_(config, MIPS_CM_GCB_OFS + 0x00)
187BUILD_CM_RW(base, MIPS_CM_GCB_OFS + 0x08)
188BUILD_CM_RW(access, MIPS_CM_GCB_OFS + 0x20)
189BUILD_CM_R_(rev, MIPS_CM_GCB_OFS + 0x30)
190BUILD_CM_RW(error_mask, MIPS_CM_GCB_OFS + 0x40)
191BUILD_CM_RW(error_cause, MIPS_CM_GCB_OFS + 0x48)
192BUILD_CM_RW(error_addr, MIPS_CM_GCB_OFS + 0x50)
193BUILD_CM_RW(error_mult, MIPS_CM_GCB_OFS + 0x58)
194BUILD_CM_RW(l2_only_sync_base, MIPS_CM_GCB_OFS + 0x70)
195BUILD_CM_RW(gic_base, MIPS_CM_GCB_OFS + 0x80)
196BUILD_CM_RW(cpc_base, MIPS_CM_GCB_OFS + 0x88)
197BUILD_CM_RW(reg0_base, MIPS_CM_GCB_OFS + 0x90)
198BUILD_CM_RW(reg0_mask, MIPS_CM_GCB_OFS + 0x98)
199BUILD_CM_RW(reg1_base, MIPS_CM_GCB_OFS + 0xa0)
200BUILD_CM_RW(reg1_mask, MIPS_CM_GCB_OFS + 0xa8)
201BUILD_CM_RW(reg2_base, MIPS_CM_GCB_OFS + 0xb0)
202BUILD_CM_RW(reg2_mask, MIPS_CM_GCB_OFS + 0xb8)
203BUILD_CM_RW(reg3_base, MIPS_CM_GCB_OFS + 0xc0)
204BUILD_CM_RW(reg3_mask, MIPS_CM_GCB_OFS + 0xc8)
205BUILD_CM_R_(gic_status, MIPS_CM_GCB_OFS + 0xd0)
206BUILD_CM_R_(cpc_status, MIPS_CM_GCB_OFS + 0xf0)
207BUILD_CM_RW(l2_config, MIPS_CM_GCB_OFS + 0x130)
208BUILD_CM_RW(sys_config2, MIPS_CM_GCB_OFS + 0x150)
209BUILD_CM_RW(l2_pft_control, MIPS_CM_GCB_OFS + 0x300)
210BUILD_CM_RW(l2_pft_control_b, MIPS_CM_GCB_OFS + 0x308)
211
212/* Core Local & Core Other register accessor functions */
213BUILD_CM_Cx_RW(reset_release, 0x00)
214BUILD_CM_Cx_RW(coherence, 0x08)
215BUILD_CM_Cx_R_(config, 0x10)
216BUILD_CM_Cx_RW(other, 0x18)
217BUILD_CM_Cx_RW(reset_base, 0x20)
218BUILD_CM_Cx_R_(id, 0x28)
219BUILD_CM_Cx_RW(reset_ext_base, 0x30)
220BUILD_CM_Cx_R_(tcid_0_priority, 0x40)
221BUILD_CM_Cx_R_(tcid_1_priority, 0x48)
222BUILD_CM_Cx_R_(tcid_2_priority, 0x50)
223BUILD_CM_Cx_R_(tcid_3_priority, 0x58)
224BUILD_CM_Cx_R_(tcid_4_priority, 0x60)
225BUILD_CM_Cx_R_(tcid_5_priority, 0x68)
226BUILD_CM_Cx_R_(tcid_6_priority, 0x70)
227BUILD_CM_Cx_R_(tcid_7_priority, 0x78)
228BUILD_CM_Cx_R_(tcid_8_priority, 0x80)
229
230/* GCR_CONFIG register fields */
231#define CM_GCR_CONFIG_NUMIOCU_SHF 8
232#define CM_GCR_CONFIG_NUMIOCU_MSK (_ULCAST_(0xf) << 8)
233#define CM_GCR_CONFIG_PCORES_SHF 0
234#define CM_GCR_CONFIG_PCORES_MSK (_ULCAST_(0xff) << 0)
235
236/* GCR_BASE register fields */
237#define CM_GCR_BASE_GCRBASE_SHF 15
238#define CM_GCR_BASE_GCRBASE_MSK (_ULCAST_(0x1ffff) << 15)
239#define CM_GCR_BASE_CMDEFTGT_SHF 0
240#define CM_GCR_BASE_CMDEFTGT_MSK (_ULCAST_(0x3) << 0)
241#define CM_GCR_BASE_CMDEFTGT_DISABLED 0
242#define CM_GCR_BASE_CMDEFTGT_MEM 1
243#define CM_GCR_BASE_CMDEFTGT_IOCU0 2
244#define CM_GCR_BASE_CMDEFTGT_IOCU1 3
245
246/* GCR_RESET_EXT_BASE register fields */
247#define CM_GCR_RESET_EXT_BASE_EVARESET BIT(31)
248#define CM_GCR_RESET_EXT_BASE_UEB BIT(30)
249
250/* GCR_ACCESS register fields */
251#define CM_GCR_ACCESS_ACCESSEN_SHF 0
252#define CM_GCR_ACCESS_ACCESSEN_MSK (_ULCAST_(0xff) << 0)
253
254/* GCR_REV register fields */
255#define CM_GCR_REV_MAJOR_SHF 8
256#define CM_GCR_REV_MAJOR_MSK (_ULCAST_(0xff) << 8)
257#define CM_GCR_REV_MINOR_SHF 0
258#define CM_GCR_REV_MINOR_MSK (_ULCAST_(0xff) << 0)
259
260#define CM_ENCODE_REV(major, minor) \
261 (((major) << CM_GCR_REV_MAJOR_SHF) | \
262 ((minor) << CM_GCR_REV_MINOR_SHF))
263
264#define CM_REV_CM2 CM_ENCODE_REV(6, 0)
265#define CM_REV_CM2_5 CM_ENCODE_REV(7, 0)
266#define CM_REV_CM3 CM_ENCODE_REV(8, 0)
267
268/* GCR_ERROR_CAUSE register fields */
269#define CM_GCR_ERROR_CAUSE_ERRTYPE_SHF 27
270#define CM_GCR_ERROR_CAUSE_ERRTYPE_MSK (_ULCAST_(0x1f) << 27)
271#define CM3_GCR_ERROR_CAUSE_ERRTYPE_SHF 58
272#define CM3_GCR_ERROR_CAUSE_ERRTYPE_MSK GENMASK_ULL(63, 58)
273#define CM_GCR_ERROR_CAUSE_ERRINFO_SHF 0
274#define CM_GCR_ERROR_CAUSE_ERRINGO_MSK (_ULCAST_(0x7ffffff) << 0)
275
276/* GCR_ERROR_MULT register fields */
277#define CM_GCR_ERROR_MULT_ERR2ND_SHF 0
278#define CM_GCR_ERROR_MULT_ERR2ND_MSK (_ULCAST_(0x1f) << 0)
279
280/* GCR_L2_ONLY_SYNC_BASE register fields */
281#define CM_GCR_L2_ONLY_SYNC_BASE_SYNCBASE_SHF 12
282#define CM_GCR_L2_ONLY_SYNC_BASE_SYNCBASE_MSK (_ULCAST_(0xfffff) << 12)
283#define CM_GCR_L2_ONLY_SYNC_BASE_SYNCEN_SHF 0
284#define CM_GCR_L2_ONLY_SYNC_BASE_SYNCEN_MSK (_ULCAST_(0x1) << 0)
285
286/* GCR_GIC_BASE register fields */
287#define CM_GCR_GIC_BASE_GICBASE_SHF 17
288#define CM_GCR_GIC_BASE_GICBASE_MSK (_ULCAST_(0x7fff) << 17)
289#define CM_GCR_GIC_BASE_GICEN_SHF 0
290#define CM_GCR_GIC_BASE_GICEN_MSK (_ULCAST_(0x1) << 0)
291
292/* GCR_CPC_BASE register fields */
293#define CM_GCR_CPC_BASE_CPCBASE_SHF 17
294#define CM_GCR_CPC_BASE_CPCBASE_MSK (_ULCAST_(0x7fff) << 17)
295#define CM_GCR_CPC_BASE_CPCEN_SHF 0
296#define CM_GCR_CPC_BASE_CPCEN_MSK (_ULCAST_(0x1) << 0)
297
298/* GCR_GIC_STATUS register fields */
299#define CM_GCR_GIC_STATUS_GICEX_SHF 0
300#define CM_GCR_GIC_STATUS_GICEX_MSK (_ULCAST_(0x1) << 0)
301
302/* GCR_REGn_BASE register fields */
303#define CM_GCR_REGn_BASE_BASEADDR_SHF 16
304#define CM_GCR_REGn_BASE_BASEADDR_MSK (_ULCAST_(0xffff) << 16)
305
306/* GCR_REGn_MASK register fields */
307#define CM_GCR_REGn_MASK_ADDRMASK_SHF 16
308#define CM_GCR_REGn_MASK_ADDRMASK_MSK (_ULCAST_(0xffff) << 16)
309#define CM_GCR_REGn_MASK_CCAOVR_SHF 5
310#define CM_GCR_REGn_MASK_CCAOVR_MSK (_ULCAST_(0x3) << 5)
311#define CM_GCR_REGn_MASK_CCAOVREN_SHF 4
312#define CM_GCR_REGn_MASK_CCAOVREN_MSK (_ULCAST_(0x1) << 4)
313#define CM_GCR_REGn_MASK_DROPL2_SHF 2
314#define CM_GCR_REGn_MASK_DROPL2_MSK (_ULCAST_(0x1) << 2)
315#define CM_GCR_REGn_MASK_CMTGT_SHF 0
316#define CM_GCR_REGn_MASK_CMTGT_MSK (_ULCAST_(0x3) << 0)
317#define CM_GCR_REGn_MASK_CMTGT_DISABLED (_ULCAST_(0x0) << 0)
318#define CM_GCR_REGn_MASK_CMTGT_MEM (_ULCAST_(0x1) << 0)
319#define CM_GCR_REGn_MASK_CMTGT_IOCU0 (_ULCAST_(0x2) << 0)
320#define CM_GCR_REGn_MASK_CMTGT_IOCU1 (_ULCAST_(0x3) << 0)
321
322/* GCR_GIC_STATUS register fields */
323#define CM_GCR_GIC_STATUS_EX_SHF 0
324#define CM_GCR_GIC_STATUS_EX_MSK (_ULCAST_(0x1) << 0)
325
326/* GCR_CPC_STATUS register fields */
327#define CM_GCR_CPC_STATUS_EX_SHF 0
328#define CM_GCR_CPC_STATUS_EX_MSK (_ULCAST_(0x1) << 0)
329
330/* GCR_L2_CONFIG register fields */
331#define CM_GCR_L2_CONFIG_BYPASS_SHF 20
332#define CM_GCR_L2_CONFIG_BYPASS_MSK (_ULCAST_(0x1) << 20)
333#define CM_GCR_L2_CONFIG_SET_SIZE_SHF 12
334#define CM_GCR_L2_CONFIG_SET_SIZE_MSK (_ULCAST_(0xf) << 12)
335#define CM_GCR_L2_CONFIG_LINE_SIZE_SHF 8
336#define CM_GCR_L2_CONFIG_LINE_SIZE_MSK (_ULCAST_(0xf) << 8)
337#define CM_GCR_L2_CONFIG_ASSOC_SHF 0
338#define CM_GCR_L2_CONFIG_ASSOC_MSK (_ULCAST_(0xff) << 0)
339
340/* GCR_SYS_CONFIG2 register fields */
341#define CM_GCR_SYS_CONFIG2_MAXVPW_SHF 0
342#define CM_GCR_SYS_CONFIG2_MAXVPW_MSK (_ULCAST_(0xf) << 0)
343
344/* GCR_L2_PFT_CONTROL register fields */
345#define CM_GCR_L2_PFT_CONTROL_PAGEMASK_SHF 12
346#define CM_GCR_L2_PFT_CONTROL_PAGEMASK_MSK (_ULCAST_(0xfffff) << 12)
347#define CM_GCR_L2_PFT_CONTROL_PFTEN_SHF 8
348#define CM_GCR_L2_PFT_CONTROL_PFTEN_MSK (_ULCAST_(0x1) << 8)
349#define CM_GCR_L2_PFT_CONTROL_NPFT_SHF 0
350#define CM_GCR_L2_PFT_CONTROL_NPFT_MSK (_ULCAST_(0xff) << 0)
351
352/* GCR_L2_PFT_CONTROL_B register fields */
353#define CM_GCR_L2_PFT_CONTROL_B_CEN_SHF 8
354#define CM_GCR_L2_PFT_CONTROL_B_CEN_MSK (_ULCAST_(0x1) << 8)
355#define CM_GCR_L2_PFT_CONTROL_B_PORTID_SHF 0
356#define CM_GCR_L2_PFT_CONTROL_B_PORTID_MSK (_ULCAST_(0xff) << 0)
357
358/* GCR_Cx_COHERENCE register fields */
359#define CM_GCR_Cx_COHERENCE_COHDOMAINEN_SHF 0
360#define CM_GCR_Cx_COHERENCE_COHDOMAINEN_MSK (_ULCAST_(0xff) << 0)
361
362/* GCR_Cx_CONFIG register fields */
363#define CM_GCR_Cx_CONFIG_IOCUTYPE_SHF 10
364#define CM_GCR_Cx_CONFIG_IOCUTYPE_MSK (_ULCAST_(0x3) << 10)
365#define CM_GCR_Cx_CONFIG_PVPE_SHF 0
366#define CM_GCR_Cx_CONFIG_PVPE_MSK (_ULCAST_(0x3ff) << 0)
367
368/* GCR_Cx_OTHER register fields */
369#define CM_GCR_Cx_OTHER_CORENUM_SHF 16
370#define CM_GCR_Cx_OTHER_CORENUM_MSK (_ULCAST_(0xffff) << 16)
371#define CM3_GCR_Cx_OTHER_CORE_SHF 8
372#define CM3_GCR_Cx_OTHER_CORE_MSK (_ULCAST_(0x3f) << 8)
373#define CM3_GCR_Cx_OTHER_VP_SHF 0
374#define CM3_GCR_Cx_OTHER_VP_MSK (_ULCAST_(0x7) << 0)
375
376/* GCR_Cx_RESET_BASE register fields */
377#define CM_GCR_Cx_RESET_BASE_BEVEXCBASE_SHF 12
378#define CM_GCR_Cx_RESET_BASE_BEVEXCBASE_MSK (_ULCAST_(0xfffff) << 12)
379
380/* GCR_Cx_RESET_EXT_BASE register fields */
381#define CM_GCR_Cx_RESET_EXT_BASE_EVARESET_SHF 31
382#define CM_GCR_Cx_RESET_EXT_BASE_EVARESET_MSK (_ULCAST_(0x1) << 31)
383#define CM_GCR_Cx_RESET_EXT_BASE_UEB_SHF 30
384#define CM_GCR_Cx_RESET_EXT_BASE_UEB_MSK (_ULCAST_(0x1) << 30)
385#define CM_GCR_Cx_RESET_EXT_BASE_BEVEXCMASK_SHF 20
386#define CM_GCR_Cx_RESET_EXT_BASE_BEVEXCMASK_MSK (_ULCAST_(0xff) << 20)
387#define CM_GCR_Cx_RESET_EXT_BASE_BEVEXCPA_SHF 1
388#define CM_GCR_Cx_RESET_EXT_BASE_BEVEXCPA_MSK (_ULCAST_(0x7f) << 1)
389#define CM_GCR_Cx_RESET_EXT_BASE_PRESENT_SHF 0
390#define CM_GCR_Cx_RESET_EXT_BASE_PRESENT_MSK (_ULCAST_(0x1) << 0)
391
392/**
393 * mips_cm_numcores - return the number of cores present in the system
394 *
395 * Returns the value of the PCORES field of the GCR_CONFIG register plus 1, or
396 * zero if no Coherence Manager is present.
397 */
398static inline unsigned mips_cm_numcores(void)
399{
400 if (!mips_cm_present())
401 return 0;
402
403 return ((read_gcr_config() & CM_GCR_CONFIG_PCORES_MSK)
404 >> CM_GCR_CONFIG_PCORES_SHF) + 1;
405}
406
407/**
408 * mips_cm_numiocu - return the number of IOCUs present in the system
409 *
410 * Returns the value of the NUMIOCU field of the GCR_CONFIG register, or zero
411 * if no Coherence Manager is present.
412 */
413static inline unsigned mips_cm_numiocu(void)
414{
415 if (!mips_cm_present())
416 return 0;
417
418 return (read_gcr_config() & CM_GCR_CONFIG_NUMIOCU_MSK)
419 >> CM_GCR_CONFIG_NUMIOCU_SHF;
420}
421
422/**
423 * mips_cm_l2sync - perform an L2-only sync operation
424 *
425 * If an L2-only sync region is present in the system then this function
426 * performs and L2-only sync and returns zero. Otherwise it returns -ENODEV.
427 */
428static inline int mips_cm_l2sync(void)
429{
430 if (!mips_cm_has_l2sync())
431 return -ENODEV;
432
433 writel(0, mips_cm_l2sync_base);
434 return 0;
435}
436
437/**
438 * mips_cm_revision() - return CM revision
439 *
440 * Return: The revision of the CM, from GCR_REV, or 0 if no CM is present. The
441 * return value should be checked against the CM_REV_* macros.
442 */
443static inline int mips_cm_revision(void)
444{
445 if (!mips_cm_present())
446 return 0;
447
448 return read_gcr_rev();
449}
450
451/**
452 * mips_cm_max_vp_width() - return the width in bits of VP indices
453 *
454 * Return: the width, in bits, of VP indices in fields that combine core & VP
455 * indices.
456 */
457static inline unsigned int mips_cm_max_vp_width(void)
458{
459 extern int smp_num_siblings;
460
461 if (mips_cm_revision() >= CM_REV_CM3)
462 return read_gcr_sys_config2() & CM_GCR_SYS_CONFIG2_MAXVPW_MSK;
463
464 return smp_num_siblings;
465}
466
467/**
468 * mips_cm_vp_id() - calculate the hardware VP ID for a CPU
469 * @cpu: the CPU whose VP ID to calculate
470 *
471 * Hardware such as the GIC uses identifiers for VPs which may not match the
472 * CPU numbers used by Linux. This function calculates the hardware VP
473 * identifier corresponding to a given CPU.
474 *
475 * Return: the VP ID for the CPU.
476 */
477static inline unsigned int mips_cm_vp_id(unsigned int cpu)
478{
479 unsigned int core = cpu_data[cpu].core;
480 unsigned int vp = cpu_vpe_id(&cpu_data[cpu]);
481
482 return (core * mips_cm_max_vp_width()) + vp;
483}
484
485#ifdef CONFIG_MIPS_CM
486
487/**
488 * mips_cm_lock_other - lock access to another core
489 * @core: the other core to be accessed
490 * @vp: the VP within the other core to be accessed
491 *
492 * Call before operating upon a core via the 'other' register region in
493 * order to prevent the region being moved during access. Must be followed
494 * by a call to mips_cm_unlock_other.
495 */
496extern void mips_cm_lock_other(unsigned int core, unsigned int vp);
497
498/**
499 * mips_cm_unlock_other - unlock access to another core
500 *
501 * Call after operating upon another core via the 'other' register region.
502 * Must be called after mips_cm_lock_other.
503 */
504extern void mips_cm_unlock_other(void);
505
506#else /* !CONFIG_MIPS_CM */
507
508static inline void mips_cm_lock_other(unsigned int core) { }
509static inline void mips_cm_unlock_other(void) { }
510
511#endif /* !CONFIG_MIPS_CM */
512
513#endif /* __MIPS_ASM_MIPS_CM_H__ */