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