xref: /freebsd/sys/dev/bhnd/siba/sibareg.h (revision d0b2dbfa0ecf2bbc9709efc5e20baf8e4b44bbbf)
1 /*-
2  * Copyright (c) 2015 Landon Fuller <landon@landonf.org>
3  * Copyright (c) 2010 Broadcom Corporation
4  *
5  * This file was derived from the sbconfig.h header distributed with
6  * Broadcom's initial brcm80211 Linux driver release, as
7  * contributed to the Linux staging repository.
8  *
9  * Permission to use, copy, modify, and/or distribute this software for any
10  * purpose with or without fee is hereby granted, provided that the above
11  * copyright notice and this permission notice appear in all copies.
12  *
13  * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
14  * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
15  * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY
16  * SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
17  * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION
18  * OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN
19  * CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
20  *
21  */
22 
23 #ifndef _BHND_SIBA_SIBAREG_
24 #define _BHND_SIBA_SIBAREG_
25 
26 #include <dev/bhnd/bhndreg.h>
27 
28 /*
29  * Broadcom SIBA Configuration Space Registers.
30  *
31  * Backplane configuration registers common to siba(4) core register
32  * blocks.
33  */
34 
35 /**
36  * Extract a config attribute by applying _MASK and _SHIFT defines.
37  *
38  * @param _reg The register value containing the desired attribute
39  * @param _attr The BCMA EROM attribute name (e.g. ENTRY_ISVALID), to be
40  * concatenated with the `SB` prefix and `_MASK`/`_SHIFT` suffixes.
41  */
42 #define	SIBA_REG_GET(_entry, _attr)			\
43 	((_entry & SIBA_ ## _attr ## _MASK)	\
44 	>> SIBA_ ## _attr ## _SHIFT)
45 
46 #define	SIBA_ENUM_ADDR		BHND_DEFAULT_CHIPC_ADDR	/**< enumeration space */
47 #define	SIBA_ENUM_SIZE		0x00100000		/**< size of the enumeration space */
48 #define	SIBA_CORE_SIZE		BHND_DEFAULT_CORE_SIZE	/**< per-core register block size */
49 #define	SIBA_MAX_INTR		32			/**< maximum number of backplane interrupt vectors */
50 #define	SIBA_MAX_CORES	\
51     (SIBA_ENUM_SIZE/SIBA_CORE_SIZE)			/**< Maximum number of cores */
52 
53 /** Evaluates to the bus address offset of the @p idx core register block */
54 #define	SIBA_CORE_OFFSET(idx)	((idx) * SIBA_CORE_SIZE)
55 
56 /** Evaluates to the bus address of the @p idx core register block */
57 #define	SIBA_CORE_ADDR(idx)	(SIBA_ENUM_ADDR + SIBA_CORE_OFFSET(idx))
58 
59 /*
60  * Sonics configuration registers are mapped to each core's enumeration
61  * space, at the end of the 4kb device register block, in reverse
62  * order:
63  *
64  * [0x0000-0x0dff]	core registers
65  * [0x0e00-0x0eff]	SIBA_R1 registers	(sonics >= 2.3)
66  * [0x0f00-0x0fff]	SIBA_R0 registers
67  */
68 
69 #define	SIBA_CFG0_OFFSET	0xf00	/**< first configuration block */
70 #define	SIBA_CFG1_OFFSET	0xe00	/**< second configuration block (sonics >= 2.3) */
71 #define	SIBA_CFG_SIZE		0x100	/**< cfg register block size */
72 
73 /* Return the SIBA_CORE_ADDR-relative offset for the given siba configuration
74  * register block; configuration blocks are allocated starting at
75  * SIBA_CFG0_OFFSET, growing downwards. */
76 #define	SIBA_CFG_OFFSET(_n)	(SIBA_CFG0_OFFSET - ((_n) * SIBA_CFG_SIZE))
77 
78 /* Return the SIBA_CORE_ADDR-relative offset for a SIBA_CFG* register. */
79 #define	SB0_REG_ABS(off)	((off) + SIBA_CFG0_OFFSET)
80 #define	SB1_REG_ABS(off)	((off) + SIBA_CFG1_OFFSET)
81 
82 /* SIBA_CFG0 registers */
83 #define	SIBA_CFG0_IPSFLAG	0x08	/**< initiator port ocp slave flag */
84 #define	SIBA_CFG0_TPSFLAG	0x18	/**< target port ocp slave flag */
85 #define	SIBA_CFG0_TMERRLOGA	0x48	/**< sonics >= 2.3 */
86 #define	SIBA_CFG0_TMERRLOG	0x50	/**< sonics >= 2.3 */
87 #define	SIBA_CFG0_ADMATCH3	0x60	/**< address match3 */
88 #define	SIBA_CFG0_ADMATCH2	0x68	/**< address match2 */
89 #define	SIBA_CFG0_ADMATCH1	0x70	/**< address match1 */
90 #define	SIBA_CFG0_IMSTATE	0x90	/**< initiator agent state */
91 #define	SIBA_CFG0_INTVEC	0x94	/**< interrupt mask */
92 #define	SIBA_CFG0_TMSTATELOW	0x98	/**< target state */
93 #define	SIBA_CFG0_TMSTATEHIGH	0x9c	/**< target state */
94 #define	SIBA_CFG0_BWA0		0xa0	/**< bandwidth allocation table0 */
95 #define	SIBA_CFG0_IMCONFIGLOW	0xa8	/**< initiator configuration */
96 #define	SIBA_CFG0_IMCONFIGHIGH	0xac	/**< initiator configuration */
97 #define	SIBA_CFG0_ADMATCH0	0xb0	/**< address match0 */
98 #define	SIBA_CFG0_TMCONFIGLOW	0xb8	/**< target configuration */
99 #define	SIBA_CFG0_TMCONFIGHIGH	0xbc	/**< target configuration */
100 #define	SIBA_CFG0_BCONFIG	0xc0	/**< broadcast configuration */
101 #define	SIBA_CFG0_BSTATE	0xc8	/**< broadcast state */
102 #define	SIBA_CFG0_ACTCNFG	0xd8	/**< activate configuration */
103 #define	SIBA_CFG0_FLAGST	0xe8	/**< current sbflags */
104 #define	SIBA_CFG0_IDLOW		0xf8	/**< identification */
105 #define	SIBA_CFG0_IDHIGH	0xfc	/**< identification */
106 
107 /* SIBA_CFG1 registers (sonics >= 2.3) */
108 #define	SIBA_CFG1_IMERRLOGA	0xa8	/**< (sonics >= 2.3) */
109 #define	SIBA_CFG1_IMERRLOG	0xb0	/**< sbtmerrlog (sonics >= 2.3) */
110 #define	SIBA_CFG1_TMPORTCONNID0	0xd8	/**< sonics >= 2.3 */
111 #define	SIBA_CFG1_TMPORTLOCK0	0xf8	/**< sonics >= 2.3 */
112 
113 /* sbipsflag */
114 #define	SIBA_IPS_INT1_MASK	0x3f		/* which sbflags get routed to mips interrupt 1 */
115 #define	SIBA_IPS_INT1_SHIFT	0
116 #define	SIBA_IPS_INT2_MASK	0x3f00		/* which sbflags get routed to mips interrupt 2 */
117 #define	SIBA_IPS_INT2_SHIFT	8
118 #define	SIBA_IPS_INT3_MASK	0x3f0000	/* which sbflags get routed to mips interrupt 3 */
119 #define	SIBA_IPS_INT3_SHIFT	16
120 #define	SIBA_IPS_INT4_MASK	0x3f000000	/* which sbflags get routed to mips interrupt 4 */
121 #define	SIBA_IPS_INT4_SHIFT	24
122 
123 #define	SIBA_IPS_INT_SHIFT(_i)	((_i - 1) * 8)
124 #define	SIBA_IPS_INT_MASK(_i)	(SIBA_IPS_INT1_MASK << SIBA_IPS_INT_SHIFT(_i))
125 
126 /* sbtpsflag */
127 #define	SIBA_TPS_NUM0_MASK	0x3f		/* interrupt sbFlag # generated by this core */
128 #define	SIBA_TPS_NUM0_SHIFT	0
129 #define	SIBA_TPS_F0EN0		0x40		/* interrupt is always sent on the backplane */
130 
131 /* sbtmerrlog */
132 #define	SIBA_TMEL_CM		0x00000007	/* command */
133 #define	SIBA_TMEL_CI		0x0000ff00	/* connection id */
134 #define	SIBA_TMEL_EC		0x0f000000	/* error code */
135 #define	SIBA_TMEL_ME		0x80000000	/* multiple error */
136 
137 /* sbimstate */
138 #define	SIBA_IM_PC		0xf		/* pipecount */
139 #define	SIBA_IM_AP_MASK		0x30		/* arbitration policy */
140 #define	SIBA_IM_AP_BOTH		0x00		/* use both timeslaces and token */
141 #define	SIBA_IM_AP_TS		0x10		/* use timesliaces only */
142 #define	SIBA_IM_AP_TK		0x20		/* use token only */
143 #define	SIBA_IM_AP_RSV		0x30		/* reserved */
144 #define	SIBA_IM_IBE		0x20000		/* inbanderror */
145 #define	SIBA_IM_TO		0x40000		/* timeout */
146 #define	SIBA_IM_BY		0x01800000	/* busy (sonics >= 2.3) */
147 #define	SIBA_IM_RJ		0x02000000	/* reject (sonics >= 2.3) */
148 
149 /* sbtmstatelow */
150 #define	SIBA_TML_RESET		0x0001		/* reset */
151 #define	SIBA_TML_REJ_MASK	0x0006		/* reject field */
152 #define	SIBA_TML_REJ		0x0002		/* reject */
153 #define	SIBA_TML_TMPREJ		0x0004		/* temporary reject, for error recovery */
154 #define	SIBA_TML_SICF_MASK	0xFFFF0000	/* core IOCTL flags */
155 #define	SIBA_TML_SICF_SHIFT	16
156 
157 /* sbtmstatehigh */
158 #define	SIBA_TMH_SERR		0x0001		/* serror */
159 #define	SIBA_TMH_INT		0x0002		/* interrupt */
160 #define	SIBA_TMH_BUSY		0x0004		/* busy */
161 #define	SIBA_TMH_TO		0x0020		/* timeout (sonics >= 2.3) */
162 #define	SIBA_TMH_SISF_MASK	0xFFFF0000	/* core IOST flags */
163 #define	SIBA_TMH_SISF_SHIFT	16
164 
165 /* sbbwa0 */
166 #define	SIBA_BWA_TAB0_MASK	0xffff		/* lookup table 0 */
167 #define	SIBA_BWA_TAB1_MASK	0xffff		/* lookup table 1 */
168 #define	SIBA_BWA_TAB1_SHIFT	16
169 
170 /* sbimconfiglow */
171 #define	SIBA_IMCL_STO_MASK	0x7		/* service timeout */
172 #define	SIBA_IMCL_RTO_MASK	0x70		/* request timeout */
173 #define	SIBA_IMCL_RTO_SHIFT	4
174 #define	SIBA_IMCL_CID_MASK	0xff0000	/* connection id */
175 #define	SIBA_IMCL_CID_SHIFT	16
176 
177 /* sbimconfighigh */
178 #define	SIBA_IMCH_IEM_MASK	0xc		/* inband error mode */
179 #define	SIBA_IMCH_TEM_MASK	0x30		/* timeout error mode */
180 #define	SIBA_IMCH_TEM_SHIFT	4
181 #define	SIBA_IMCH_BEM_MASK	0xc0		/* bus error mode */
182 #define	SIBA_IMCH_BEM_SHIFT	6
183 
184 /* sbadmatch0-4 */
185 #define	SIBA_AM_TYPE_MASK	0x3		/* address type */
186 #define	SIBA_AM_TYPE_SHIFT	0x0
187 #define	SIBA_AM_AD64		0x4		/* reserved */
188 #define	SIBA_AM_ADINT0_MASK	0xf8		/* type0 size */
189 #define	SIBA_AM_ADINT0_SHIFT	3
190 #define	SIBA_AM_ADINT1_MASK	0x1f8		/* type1 size */
191 #define	SIBA_AM_ADINT1_SHIFT	3
192 #define	SIBA_AM_ADINT2_MASK	0x1f8		/* type2 size */
193 #define	SIBA_AM_ADINT2_SHIFT	3
194 #define	SIBA_AM_ADEN		0x400		/* enable */
195 #define	SIBA_AM_ADNEG		0x800		/* negative decode */
196 #define	SIBA_AM_BASE0_MASK	0xffffff00	/* type0 base address */
197 #define	SIBA_AM_BASE0_SHIFT	8
198 #define	SIBA_AM_BASE1_MASK	0xfffff000	/* type1 base address for the core */
199 #define	SIBA_AM_BASE1_SHIFT	12
200 #define	SIBA_AM_BASE2_MASK	0xffff0000	/* type2 base address for the core */
201 #define	SIBA_AM_BASE2_SHIFT	16
202 
203 /* sbtmconfiglow */
204 #define	SIBA_TMCL_CD_MASK	0xff		/* clock divide */
205 #define	SIBA_TMCL_CO_MASK	0xf800		/* clock offset */
206 #define	SIBA_TMCL_CO_SHIFT	11
207 #define	SIBA_TMCL_IF_MASK	0xfc0000	/* interrupt flags */
208 #define	SIBA_TMCL_IF_SHIFT	18
209 #define	SIBA_TMCL_IM_MASK	0x3000000	/* interrupt mode */
210 #define	SIBA_TMCL_IM_SHIFT	24
211 
212 /* sbtmconfighigh */
213 #define	SIBA_TMCH_BM_MASK	0x3		/* busy mode */
214 #define	SIBA_TMCH_RM_MASK	0x3		/* retry mode */
215 #define	SIBA_TMCH_RM_SHIFT	2
216 #define	SIBA_TMCH_SM_MASK	0x30		/* stop mode */
217 #define	SIBA_TMCH_SM_SHIFT	4
218 #define	SIBA_TMCH_EM_MASK	0x300		/* sb error mode */
219 #define	SIBA_TMCH_EM_SHIFT	8
220 #define	SIBA_TMCH_IM_MASK	0xc00		/* int mode */
221 #define	SIBA_TMCH_IM_SHIFT	10
222 
223 /* sbbconfig */
224 #define	SIBA_BC_LAT_MASK	0x3		/* sb latency */
225 #define	SIBA_BC_MAX0_MASK	0xf0000		/* maxccntr0 */
226 #define	SIBA_BC_MAX0_SHIFT	16
227 #define	SIBA_BC_MAX1_MASK	0xf00000	/* maxccntr1 */
228 #define	SIBA_BC_MAX1_SHIFT	20
229 
230 /* sbbstate */
231 #define	SIBA_BS_SRD		0x1		/* st reg disable */
232 #define	SIBA_BS_HRD		0x2		/* hold reg disable */
233 
234 /* sbidlow */
235 #define	SIBA_IDL_CS_MASK	0x3		/* config space */
236 #define	SIBA_IDL_CS_SHIFT	0
237 #define	SIBA_IDL_NRADDR_MASK	0x38		/* # address ranges supported */
238 #define	SIBA_IDL_NRADDR_SHIFT	3
239 #define	SIBA_IDL_SYNCH		0x40		/* sync */
240 #define	SIBA_IDL_INIT		0x80		/* initiator */
241 #define	SIBA_IDL_MINLAT_MASK	0xf00		/* minimum backplane latency */
242 #define	SIBA_IDL_MINLAT_SHIFT	8
243 #define	SIBA_IDL_MAXLAT_MASK	0xf000		/* maximum backplane latency */
244 #define	SIBA_IDL_MAXLAT_SHIFT	12
245 #define	SIBA_IDL_FIRST_MASK	0x10000		/* this initiator is first */
246 #define	SIBA_IDL_FIRST_SHIFT	16
247 #define	SIBA_IDL_CW_MASK	0xc0000		/* cycle counter width */
248 #define	SIBA_IDL_CW_SHIFT	18
249 #define	SIBA_IDL_TP_MASK	0xf00000	/* target ports */
250 #define	SIBA_IDL_TP_SHIFT	20
251 #define	SIBA_IDL_IP_MASK	0xf000000	/* initiator ports */
252 #define	SIBA_IDL_IP_SHIFT	24
253 #define	SIBA_IDL_SBREV_MASK	0xf0000000	/* sonics backplane revision code */
254 #define	SIBA_IDL_SBREV_SHIFT	28
255 #define	SIBA_IDL_SBREV_2_2	0x0		/* version 2.2 or earlier */
256 #define	SIBA_IDL_SBREV_2_3	0x1		/* version 2.3 */
257 
258 /* sbidhigh */
259 #define	SIBA_IDH_RC_MASK	0x000f		/* revision code */
260 #define	SIBA_IDH_RCE_MASK	0x7000		/* revision code extension field */
261 #define	SIBA_IDH_RCE_SHIFT	8
262 #define	SIBA_IDH_DEVICE_MASK	0x8ff0		/* core code */
263 #define	SIBA_IDH_DEVICE_SHIFT	4
264 #define	SIBA_IDH_VENDOR_MASK	0xffff0000	/* vendor code */
265 #define	SIBA_IDH_VENDOR_SHIFT	16
266 
267 #define	SIBA_IDH_CORE_REV(sbidh) \
268 	(SIBA_REG_GET((sbidh), IDH_RCE) | ((sbidh) & SIBA_IDH_RC_MASK))
269 
270 #define	SIBA_COMMIT		0xfd8		/* update buffered registers value */
271 
272 #endif /* _BHND_SIBA_SIBAREG_ */
273