1  /* SPDX-License-Identifier: GPL-2.0 */
2  /*
3   * bbc.h: Defines for BootBus Controller found on UltraSPARC-III
4   *        systems.
5   *
6   * Copyright (C) 2000 David S. Miller (davem@redhat.com)
7   */
8  
9  #ifndef _SPARC64_BBC_H
10  #define _SPARC64_BBC_H
11  
12  /* Register sizes are indicated by "B" (Byte, 1-byte),
13   * "H" (Half-word, 2 bytes), "W" (Word, 4 bytes) or
14   * "Q" (Quad, 8 bytes) inside brackets.
15   */
16  
17  #define BBC_AID		0x00	/* [B] Agent ID			*/
18  #define BBC_DEVP	0x01	/* [B] Device Present		*/
19  #define BBC_ARB		0x02	/* [B] Arbitration		*/
20  #define BBC_QUIESCE	0x03	/* [B] Quiesce			*/
21  #define BBC_WDACTION	0x04	/* [B] Watchdog Action		*/
22  #define BBC_SPG		0x06	/* [B] Soft POR Gen		*/
23  #define BBC_SXG		0x07	/* [B] Soft XIR Gen		*/
24  #define BBC_PSRC	0x08	/* [W] POR Source		*/
25  #define BBC_XSRC	0x0c	/* [B] XIR Source		*/
26  #define BBC_CSC		0x0d	/* [B] Clock Synthesizers Control*/
27  #define BBC_ES_CTRL	0x0e	/* [H] Energy Star Control	*/
28  #define BBC_ES_ACT	0x10	/* [W] E* Assert Change Time	*/
29  #define BBC_ES_DACT	0x14	/* [B] E* De-Assert Change Time	*/
30  #define BBC_ES_DABT	0x15	/* [B] E* De-Assert Bypass Time	*/
31  #define BBC_ES_ABT	0x16	/* [H] E* Assert Bypass Time	*/
32  #define BBC_ES_PST	0x18	/* [W] E* PLL Settle Time	*/
33  #define BBC_ES_FSL	0x1c	/* [W] E* Frequency Switch Latency*/
34  #define BBC_EBUST	0x20	/* [Q] EBUS Timing		*/
35  #define BBC_JTAG_CMD	0x28	/* [W] JTAG+ Command		*/
36  #define BBC_JTAG_CTRL	0x2c	/* [B] JTAG+ Control		*/
37  #define BBC_I2C_SEL	0x2d	/* [B] I2C Selection		*/
38  #define BBC_I2C_0_S1	0x2e	/* [B] I2C ctrlr-0 reg S1	*/
39  #define BBC_I2C_0_S0	0x2f	/* [B] I2C ctrlr-0 regs S0,S0',S2,S3*/
40  #define BBC_I2C_1_S1	0x30	/* [B] I2C ctrlr-1 reg S1	*/
41  #define BBC_I2C_1_S0	0x31	/* [B] I2C ctrlr-1 regs S0,S0',S2,S3*/
42  #define BBC_KBD_BEEP	0x32	/* [B] Keyboard Beep		*/
43  #define BBC_KBD_BCNT	0x34	/* [W] Keyboard Beep Counter	*/
44  
45  #define BBC_REGS_SIZE	0x40
46  
47  /* There is a 2K scratch ram area at offset 0x80000 but I doubt
48   * we will use it for anything.
49   */
50  
51  /* Agent ID register.  This register shows the Safari Agent ID
52   * for the processors.  The value returned depends upon which
53   * cpu is reading the register.
54   */
55  #define BBC_AID_ID	0x07	/* Safari ID		*/
56  #define BBC_AID_RESV	0xf8	/* Reserved		*/
57  
58  /* Device Present register.  One can determine which cpus are actually
59   * present in the machine by interrogating this register.
60   */
61  #define BBC_DEVP_CPU0	0x01	/* Processor 0 present	*/
62  #define BBC_DEVP_CPU1	0x02	/* Processor 1 present	*/
63  #define BBC_DEVP_CPU2	0x04	/* Processor 2 present	*/
64  #define BBC_DEVP_CPU3	0x08	/* Processor 3 present	*/
65  #define BBC_DEVP_RESV	0xf0	/* Reserved		*/
66  
67  /* Arbitration register.  This register is used to block access to
68   * the BBC from a particular cpu.
69   */
70  #define BBC_ARB_CPU0	0x01	/* Enable cpu 0 BBC arbitratrion */
71  #define BBC_ARB_CPU1	0x02	/* Enable cpu 1 BBC arbitratrion */
72  #define BBC_ARB_CPU2	0x04	/* Enable cpu 2 BBC arbitratrion */
73  #define BBC_ARB_CPU3	0x08	/* Enable cpu 3 BBC arbitratrion */
74  #define BBC_ARB_RESV	0xf0	/* Reserved			 */
75  
76  /* Quiesce register.  Bus and BBC segments for cpus can be disabled
77   * with this register, ie. for hot plugging.
78   */
79  #define BBC_QUIESCE_S02	0x01	/* Quiesce Safari segment for cpu 0 and 2 */
80  #define BBC_QUIESCE_S13	0x02	/* Quiesce Safari segment for cpu 1 and 3 */
81  #define BBC_QUIESCE_B02	0x04	/* Quiesce BBC segment for cpu 0 and 2    */
82  #define BBC_QUIESCE_B13	0x08	/* Quiesce BBC segment for cpu 1 and 3    */
83  #define BBC_QUIESCE_FD0 0x10	/* Disable Fatal_Error[0] reporting	  */
84  #define BBC_QUIESCE_FD1 0x20	/* Disable Fatal_Error[1] reporting	  */
85  #define BBC_QUIESCE_FD2 0x40	/* Disable Fatal_Error[2] reporting	  */
86  #define BBC_QUIESCE_FD3 0x80	/* Disable Fatal_Error[3] reporting	  */
87  
88  /* Watchdog Action register.  When the watchdog device timer expires
89   * a line is enabled to the BBC.  The action BBC takes when this line
90   * is asserted can be controlled by this regiser.
91   */
92  #define BBC_WDACTION_RST  0x01	/* When set, watchdog causes system reset.
93  				 * When clear, BBC ignores watchdog signal.
94  				 */
95  #define BBC_WDACTION_RESV 0xfe	/* Reserved */
96  
97  /* Soft_POR_GEN register.  The POR (Power On Reset) signal may be asserted
98   * for specific processors or all processors via this register.
99   */
100  #define BBC_SPG_CPU0	0x01 /* Assert POR for processor 0	*/
101  #define BBC_SPG_CPU1	0x02 /* Assert POR for processor 1	*/
102  #define BBC_SPG_CPU2	0x04 /* Assert POR for processor 2	*/
103  #define BBC_SPG_CPU3	0x08 /* Assert POR for processor 3	*/
104  #define BBC_SPG_CPUALL	0x10 /* Reset all processors and reset
105  			      * the entire system.
106  			      */
107  #define BBC_SPG_RESV	0xe0 /* Reserved			*/
108  
109  /* Soft_XIR_GEN register.  The XIR (eXternally Initiated Reset) signal
110   * may be asserted to specific processors via this register.
111   */
112  #define BBC_SXG_CPU0	0x01 /* Assert XIR for processor 0	*/
113  #define BBC_SXG_CPU1	0x02 /* Assert XIR for processor 1	*/
114  #define BBC_SXG_CPU2	0x04 /* Assert XIR for processor 2	*/
115  #define BBC_SXG_CPU3	0x08 /* Assert XIR for processor 3	*/
116  #define BBC_SXG_RESV	0xf0 /* Reserved			*/
117  
118  /* POR Source register.  One may identify the cause of the most recent
119   * reset by reading this register.
120   */
121  #define BBC_PSRC_SPG0	0x0001 /* CPU 0 reset via BBC_SPG register	*/
122  #define BBC_PSRC_SPG1	0x0002 /* CPU 1 reset via BBC_SPG register	*/
123  #define BBC_PSRC_SPG2	0x0004 /* CPU 2 reset via BBC_SPG register	*/
124  #define BBC_PSRC_SPG3	0x0008 /* CPU 3 reset via BBC_SPG register	*/
125  #define BBC_PSRC_SPGSYS	0x0010 /* System reset via BBC_SPG register	*/
126  #define BBC_PSRC_JTAG	0x0020 /* System reset via JTAG+		*/
127  #define BBC_PSRC_BUTTON	0x0040 /* System reset via push-button dongle	*/
128  #define BBC_PSRC_PWRUP	0x0080 /* System reset via power-up		*/
129  #define BBC_PSRC_FE0	0x0100 /* CPU 0 reported Fatal_Error		*/
130  #define BBC_PSRC_FE1	0x0200 /* CPU 1 reported Fatal_Error		*/
131  #define BBC_PSRC_FE2	0x0400 /* CPU 2 reported Fatal_Error		*/
132  #define BBC_PSRC_FE3	0x0800 /* CPU 3 reported Fatal_Error		*/
133  #define BBC_PSRC_FE4	0x1000 /* Schizo reported Fatal_Error		*/
134  #define BBC_PSRC_FE5	0x2000 /* Safari device 5 reported Fatal_Error	*/
135  #define BBC_PSRC_FE6	0x4000 /* CPMS reported Fatal_Error		*/
136  #define BBC_PSRC_SYNTH	0x8000 /* System reset when on-board clock synthesizers
137  				* were updated.
138  				*/
139  #define BBC_PSRC_WDT   0x10000 /* System reset via Super I/O watchdog	*/
140  #define BBC_PSRC_RSC   0x20000 /* System reset via RSC remote monitoring
141  				* device
142  				*/
143  
144  /* XIR Source register.  The source of an XIR event sent to a processor may
145   * be determined via this register.
146   */
147  #define BBC_XSRC_SXG0	0x01	/* CPU 0 received XIR via Soft_XIR_GEN reg */
148  #define BBC_XSRC_SXG1	0x02	/* CPU 1 received XIR via Soft_XIR_GEN reg */
149  #define BBC_XSRC_SXG2	0x04	/* CPU 2 received XIR via Soft_XIR_GEN reg */
150  #define BBC_XSRC_SXG3	0x08	/* CPU 3 received XIR via Soft_XIR_GEN reg */
151  #define BBC_XSRC_JTAG	0x10	/* All CPUs received XIR via JTAG+         */
152  #define BBC_XSRC_W_OR_B	0x20	/* All CPUs received XIR either because:
153  				 * a) Super I/O watchdog fired, or
154  				 * b) XIR push button was activated
155  				 */
156  #define BBC_XSRC_RESV	0xc0	/* Reserved				   */
157  
158  /* Clock Synthesizers Control register.  This register provides the big-bang
159   * programming interface to the two clock synthesizers of the machine.
160   */
161  #define BBC_CSC_SLOAD	0x01	/* Directly connected to S_LOAD pins	*/
162  #define BBC_CSC_SDATA	0x02	/* Directly connected to S_DATA pins	*/
163  #define BBC_CSC_SCLOCK	0x04	/* Directly connected to S_CLOCK pins	*/
164  #define BBC_CSC_RESV	0x78	/* Reserved				*/
165  #define BBC_CSC_RST	0x80	/* Generate system reset when S_LOAD==1	*/
166  
167  /* Energy Star Control register.  This register is used to generate the
168   * clock frequency change trigger to the main system devices (Schizo and
169   * the processors).  The transition occurs when bits in this register
170   * go from 0 to 1, only one bit must be set at once else no action
171   * occurs.  Basically the sequence of events is:
172   * a) Choose new frequency: full, 1/2 or 1/32
173   * b) Program this desired frequency into the cpus and Schizo.
174   * c) Set the same value in this register.
175   * d) 16 system clocks later, clear this register.
176   */
177  #define BBC_ES_CTRL_1_1		0x01	/* Full frequency	*/
178  #define BBC_ES_CTRL_1_2		0x02	/* 1/2 frequency	*/
179  #define BBC_ES_CTRL_1_32	0x20	/* 1/32 frequency	*/
180  #define BBC_ES_RESV		0xdc	/* Reserved		*/
181  
182  /* Energy Star Assert Change Time register.  This determines the number
183   * of BBC clock cycles (which is half the system frequency) between
184   * the detection of FREEZE_ACK being asserted and the assertion of
185   * the CLK_CHANGE_L[2:0] signals.
186   */
187  #define BBC_ES_ACT_VAL	0xff
188  
189  /* Energy Star Assert Bypass Time register.  This determines the number
190   * of BBC clock cycles (which is half the system frequency) between
191   * the assertion of the CLK_CHANGE_L[2:0] signals and the assertion of
192   * the ESTAR_PLL_BYPASS signal.
193   */
194  #define BBC_ES_ABT_VAL	0xffff
195  
196  /* Energy Star PLL Settle Time register.  This determines the number of
197   * BBC clock cycles (which is half the system frequency) between the
198   * de-assertion of CLK_CHANGE_L[2:0] and the de-assertion of the FREEZE_L
199   * signal.
200   */
201  #define BBC_ES_PST_VAL	0xffffffff
202  
203  /* Energy Star Frequency Switch Latency register.  This is the number of
204   * BBC clocks between the de-assertion of CLK_CHANGE_L[2:0] and the first
205   * edge of the Safari clock at the new frequency.
206   */
207  #define BBC_ES_FSL_VAL	0xffffffff
208  
209  /* Keyboard Beep control register.  This is a simple enabler for the audio
210   * beep sound.
211   */
212  #define BBC_KBD_BEEP_ENABLE	0x01 /* Enable beep	*/
213  #define BBC_KBD_BEEP_RESV	0xfe /* Reserved	*/
214  
215  /* Keyboard Beep Counter register.  There is a free-running counter inside
216   * the BBC which runs at half the system clock.  The bit set in this register
217   * determines when the audio sound is generated.  So for example if bit
218   * 10 is set, the audio beep will oscillate at 1/(2**12).  The keyboard beep
219   * generator automatically selects a different bit to use if the system clock
220   * is changed via Energy Star.
221   */
222  #define BBC_KBD_BCNT_BITS	0x0007fc00
223  #define BBC_KBC_BCNT_RESV	0xfff803ff
224  
225  #endif /* _SPARC64_BBC_H */
226  
227