1/*
2 * join_domain.S
3 *
4 *  Created on: Jan 13, 2011
5 *  Author: MIPS TECHNOLOGIES, INC
6 *  For CPS cores join processing domain
7*/
8/*
9Unpublished work (c) MIPS Technologies, Inc.  All rights reserved.  Unpublished rights reserved
10under the copyright laws of the United States of America and other countries.
11
12This code is confidential and proprietary to MIPS Technologies, Inc. ("MIPS Technologies") and
13may be disclosed only as permitted in writing by MIPS Technologies or an authorized third party.
14Any copying, reproducing, modifying, use or disclosure of this code (in whole or in part) that is
15not expressly permitted in writing by MIPS Technologies or an authorized third party is strictly
16prohibited. At a minimum, this code is protected under trade secret, unfair competition, and
17copyright laws. Violations thereof may result in criminal penalties and fines.
18
19MIPS Technologies reserves the right to change this code to improve function, design or
20otherwise. MIPS Technologies does not assume any liability arising out of the application or use
21of this code, or of any error or omission in such code.  Any warranties, whether express, statutory,
22implied or otherwise, including but not limited to the implied warranties of merchantability or
23fitness for a particular purpose, are excluded.  Except as expressly provided in any written license
24agreement from MIPS Technologies or an authorized third party, the furnishing of this code does
25not give recipient any license to any intellectual property rights, including any patent rights, that
26cover this code.
27
28This code shall not be exported, reexported, transferred, or released, directly or indirectly, in
29violation of the law of any country or international law, regulation, treaty, Executive Order,
30statute, amendments or supplements thereto.  Should a conflict arise regarding the export,
31reexport, transfer, or release of this code, the laws of the United States of America shall be
32the governing law.
33
34This code may only be disclosed to the United States government ("Government"), or to
35Government users, with prior written consent from MIPS Technologies or an authorized third
36party.  This code constitutes one or more of the following: commercial computer software,
37commercial computer software documentation or other commercial items.  If the user of this
38code, or any related documentation of any kind, including related technical data or manuals, is an
39agency, department, or other entity of the Government, the use, duplication, reproduction, release,
40modification, disclosure, or transfer of this code, or any related documentation of any kind, is
41restricted in accordance with Federal Acquisition Regulation 12.212 for civilian agencies and
42Defense Federal Acquisition Regulation Supplement 227.7202 for military agencies.  The use of
43this code by the Government is further restricted in accordance with the terms of the license
44agreement(s) and/or applicable contract terms and conditions covering this code from MIPS
45Technologies or an authorized third party.
46*/
47
48#include <boot.h>
49#include <regdef.h>
50#include <cps.h>
51
52	.set	noreorder           // Don't allow the assembler to reorder instructions.
53	.set	noat                // Don't allow the assembler to use r1(at) for synthetic instr.
54
55/**************************************************************************************
56**************************************************************************************/
57LEAF(join_domain)
58
59    beqz    r11_is_cps, done_join_domain    // If this is not a CPS then we are done.
60    nop
61
62	// Enable coherence and allow interventions from all other cores.
63	// (Write access enabled via GCR_ACCESS by core 0.)
64	li	    a0, 0x0f					   // Set Coherent domain enable for 4 cores
65	sw	    a0, (CORE_LOCAL_CONTROL_BLOCK | GCR_CL_COHERENCE)(r22_gcr_addr)	// GCR_CL_COHERENCE
66	ehb
67
68	// Cores other than core 0 can relinquish write access to CM regs here.
69
70    move    a3, zero
71
72next_coherent_core:
73    sll     a0, a3, 16
74    sw      a0, (CORE_LOCAL_CONTROL_BLOCK | GCR_CL_OTHER)(r22_gcr_addr) // GCR_CL_OTHER[CoreNum]
75
76busy_wait_coherent_core:
77    lw      a0, (CORE_OTHER_CONTROL_BLOCK | GCR_CO_COHERENCE)(r22_gcr_addr) // GCR_CO_COHERENCE
78    beqz    a0, busy_wait_coherent_core   // Busy wait on cores joining.
79    nop
80
81    bne     a3, r19_more_cores, next_coherent_core
82    addiu   a3, 1
83
84done_join_domain:
85	jr      ra
86	nop
87END(join_domain)
88