• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1 /* SPDX-License-Identifier: GPL-2.0 */
2 /*
3  * pcicfg.h: PCI configuration constants and structures.
4  *
5  * Copyright (C) 1999-2019, Broadcom.
6  *
7  *      Unless you and Broadcom execute a separate written software license
8  * agreement governing use of this software, this software is licensed to you
9  * under the terms of the GNU General Public License version 2 (the "GPL"),
10  * available at http://www.broadcom.com/licenses/GPLv2.php, with the
11  * following added to such license:
12  *
13  *      As a special exception, the copyright holders of this software give you
14  * permission to link this software with independent modules, and to copy and
15  * distribute the resulting executable under terms of your choice, provided that
16  * you also meet, for each linked independent module, the terms and conditions of
17  * the license of that module.  An independent module is a module which is not
18  * derived from this software.  The special exception does not apply to any
19  * modifications of the software.
20  *
21  *      Notwithstanding the above, under no circumstances may you combine this
22  * software in any way with any other Broadcom software provided under a license
23  * other than the GPL, without Broadcom's express prior written consent.
24  *
25  *
26  * <<Broadcom-WL-IPTag/Open:>>
27  *
28  * $Id: pcicfg.h 795237 2018-12-18 03:26:49Z $
29  */
30 
31 #ifndef	_h_pcicfg_
32 #define	_h_pcicfg_
33 
34 /* pci config status reg has a bit to indicate that capability ptr is present */
35 
36 #define PCI_CAPPTR_PRESENT	0x0010
37 
38 /* A structure for the config registers is nice, but in most
39  * systems the config space is not memory mapped, so we need
40  * field offsetts. :-(
41  */
42 #define	PCI_CFG_VID		0
43 #define	PCI_CFG_DID		2
44 #define	PCI_CFG_CMD		4
45 #define	PCI_CFG_STAT		6
46 #define	PCI_CFG_REV		8
47 #define	PCI_CFG_PROGIF		9
48 #define	PCI_CFG_SUBCL		0xa
49 #define	PCI_CFG_BASECL		0xb
50 #define	PCI_CFG_CLSZ		0xc
51 #define	PCI_CFG_LATTIM		0xd
52 #define	PCI_CFG_HDR		0xe
53 #define	PCI_CFG_BIST		0xf
54 #define	PCI_CFG_BAR0		0x10
55 /*
56 * TODO: PCI_CFG_BAR1 is wrongly defined to be 0x14 whereas it should be
57 * 0x18 as per the PCIe full dongle spec. Need to modify the values below
58 * correctly at a later point of time
59 */
60 #define	PCI_CFG_BAR1		0x14
61 #define	PCI_CFG_BAR2		0x18
62 #define	PCI_CFG_BAR3		0x1c
63 #define	PCI_CFG_BAR4		0x20
64 #define	PCI_CFG_BAR5		0x24
65 #define	PCI_CFG_CIS		0x28
66 #define	PCI_CFG_SVID		0x2c
67 #define	PCI_CFG_SSID		0x2e
68 #define	PCI_CFG_ROMBAR		0x30
69 #define PCI_CFG_CAPPTR		0x34
70 #define	PCI_CFG_INT		0x3c
71 #define	PCI_CFG_PIN		0x3d
72 #define	PCI_CFG_MINGNT		0x3e
73 #define	PCI_CFG_MAXLAT		0x3f
74 #define	PCI_CFG_DEVCTRL		0xd8
75 #define PCI_CFG_TLCNTRL_5	0x814
76 
77 /* PCI CAPABILITY DEFINES */
78 #define PCI_CAP_POWERMGMTCAP_ID		0x01
79 #define PCI_CAP_MSICAP_ID		0x05
80 #define PCI_CAP_VENDSPEC_ID		0x09
81 #define PCI_CAP_PCIECAP_ID		0x10
82 #define PCI_CAP_MSIXCAP_ID		0x11
83 
84 /* Data structure to define the Message Signalled Interrupt facility
85  * Valid for PCI and PCIE configurations
86  */
87 typedef struct _pciconfig_cap_msi {
88 	uint8	capID;
89 	uint8	nextptr;
90 	uint16	msgctrl;
91 	uint32	msgaddr;
92 } pciconfig_cap_msi;
93 #define MSI_ENABLE	0x1		/* bit 0 of msgctrl */
94 
95 /* Data structure to define the Power managment facility
96  * Valid for PCI and PCIE configurations
97  */
98 typedef struct _pciconfig_cap_pwrmgmt {
99 	uint8	capID;
100 	uint8	nextptr;
101 	uint16	pme_cap;
102 	uint16	pme_sts_ctrl;
103 	uint8	pme_bridge_ext;
104 	uint8	data;
105 } pciconfig_cap_pwrmgmt;
106 
107 #define PME_CAP_PM_STATES (0x1f << 27)	/* Bits 31:27 states that can generate PME */
108 #define PME_CSR_OFFSET	    0x4		/* 4-bytes offset */
109 #define PME_CSR_PME_EN	  (1 << 8)	/* Bit 8 Enable generating of PME */
110 #define PME_CSR_PME_STAT  (1 << 15)	/* Bit 15 PME got asserted */
111 
112 /* Data structure to define the PCIE capability */
113 typedef struct _pciconfig_cap_pcie {
114 	uint8	capID;
115 	uint8	nextptr;
116 	uint16	pcie_cap;
117 	uint32	dev_cap;
118 	uint16	dev_ctrl;
119 	uint16	dev_status;
120 	uint32	link_cap;
121 	uint16	link_ctrl;
122 	uint16	link_status;
123 	uint32	slot_cap;
124 	uint16	slot_ctrl;
125 	uint16	slot_status;
126 	uint16	root_ctrl;
127 	uint16	root_cap;
128 	uint32	root_status;
129 } pciconfig_cap_pcie;
130 
131 /* PCIE Enhanced CAPABILITY DEFINES */
132 #define PCIE_EXTCFG_OFFSET	0x100
133 #define PCIE_ADVERRREP_CAPID	0x0001
134 #define PCIE_VC_CAPID		0x0002
135 #define PCIE_DEVSNUM_CAPID	0x0003
136 #define PCIE_PWRBUDGET_CAPID	0x0004
137 
138 /* PCIE Extended configuration */
139 #define PCIE_ADV_CORR_ERR_MASK	0x114
140 #define PCIE_ADV_CORR_ERR_MASK_OFFSET	0x14
141 #define CORR_ERR_RE	(1 << 0) /* Receiver  */
142 #define CORR_ERR_BT	(1 << 6) /* Bad TLP  */
143 #define CORR_ERR_BD	(1 << 7) /* Bad DLLP */
144 #define CORR_ERR_RR	(1 << 8) /* REPLAY_NUM rollover */
145 #define CORR_ERR_RT	(1 << 12) /* Reply timer timeout */
146 #define CORR_ERR_AE	(1 << 13) /* Adviosry Non-Fital Error Mask */
147 #define ALL_CORR_ERRORS (CORR_ERR_RE | CORR_ERR_BT | CORR_ERR_BD | \
148 			 CORR_ERR_RR | CORR_ERR_RT)
149 
150 /* PCIE Root Control Register bits (Host mode only) */
151 #define	PCIE_RC_CORR_SERR_EN		0x0001
152 #define	PCIE_RC_NONFATAL_SERR_EN	0x0002
153 #define	PCIE_RC_FATAL_SERR_EN		0x0004
154 #define	PCIE_RC_PME_INT_EN		0x0008
155 #define	PCIE_RC_CRS_EN			0x0010
156 
157 /* PCIE Root Capability Register bits (Host mode only) */
158 #define	PCIE_RC_CRS_VISIBILITY		0x0001
159 
160 /* PCIe PMCSR Register bits */
161 #define PCIE_PMCSR_PMESTAT		0x8000
162 
163 /* Header to define the PCIE specific capabilities in the extended config space */
164 typedef struct _pcie_enhanced_caphdr {
165 	uint16	capID;
166 	uint16	cap_ver : 4;
167 	uint16	next_ptr : 12;
168 } pcie_enhanced_caphdr;
169 
170 #define PCIE_CFG_PMCSR		0x4C
171 #define	PCI_BAR0_WIN		0x80	/* backplane addres space accessed by BAR0 */
172 #define	PCI_BAR1_WIN		0x84	/* backplane addres space accessed by BAR1 */
173 #define	PCI_SPROM_CONTROL	0x88	/* sprom property control */
174 #define	PCIE_CFG_SUBSYSTEM_CONTROL	0x88	/* used as subsystem control in PCIE devices */
175 #define	PCI_BAR1_CONTROL	0x8c	/* BAR1 region burst control */
176 #define	PCI_INT_STATUS		0x90	/* PCI and other cores interrupts */
177 #define	PCI_INT_MASK		0x94	/* mask of PCI and other cores interrupts */
178 #define PCI_TO_SB_MB		0x98	/* signal backplane interrupts */
179 #define PCI_BACKPLANE_ADDR	0xa0	/* address an arbitrary location on the system backplane */
180 #define PCI_BACKPLANE_DATA	0xa4	/* data at the location specified by above address */
181 #define	PCI_CLK_CTL_ST		0xa8	/* pci config space clock control/status (>=rev14) */
182 #define	PCI_BAR0_WIN2		0xac	/* backplane addres space accessed by second 4KB of BAR0 */
183 #define	PCI_GPIO_IN		0xb0	/* pci config space gpio input (>=rev3) */
184 #define	PCIE_CFG_DEVICE_CAPABILITY	0xb0	/* used as device capability in PCIE devices */
185 #define	PCI_GPIO_OUT		0xb4	/* pci config space gpio output (>=rev3) */
186 #define PCIE_CFG_DEVICE_CONTROL 0xb4    /* 0xb4 is used as device control in PCIE devices */
187 #define PCIE_DC_AER_CORR_EN		(1u << 0u)
188 #define PCIE_DC_AER_NON_FATAL_EN	(1u << 1u)
189 #define PCIE_DC_AER_FATAL_EN		(1u << 2u)
190 #define PCIE_DC_AER_UNSUP_EN		(1u << 3u)
191 
192 #define PCI_BAR0_WIN2_OFFSET		0x1000u
193 #define PCIE2_BAR0_CORE2_WIN2_OFFSET	0x5000u
194 
195 #define	PCI_GPIO_OUTEN		0xb8	/* pci config space gpio output enable (>=rev3) */
196 #define	PCI_L1SS_CTRL2		0x24c	/* The L1 PM Substates Control register */
197 
198 /* Private Registers */
199 #define	PCI_STAT_CTRL		0xa80
200 #define	PCI_L0_EVENTCNT		0xa84
201 #define	PCI_L0_STATETMR		0xa88
202 #define	PCI_L1_EVENTCNT		0xa8c
203 #define	PCI_L1_STATETMR		0xa90
204 #define	PCI_L1_1_EVENTCNT	0xa94
205 #define	PCI_L1_1_STATETMR	0xa98
206 #define	PCI_L1_2_EVENTCNT	0xa9c
207 #define	PCI_L1_2_STATETMR	0xaa0
208 #define	PCI_L2_EVENTCNT		0xaa4
209 #define	PCI_L2_STATETMR		0xaa8
210 
211 #define	PCI_LINK_STATUS		0x4dc
212 #define	PCI_LINK_SPEED_MASK	(15u << 0u)
213 #define	PCI_LINK_SPEED_SHIFT	(0)
214 #define PCIE_LNK_SPEED_GEN1		0x1
215 #define PCIE_LNK_SPEED_GEN2		0x2
216 #define PCIE_LNK_SPEED_GEN3		0x3
217 
218 #define	PCI_PL_SPARE	0x1808	/* Config to Increase external clkreq deasserted minimum time */
219 #define	PCI_CONFIG_EXT_CLK_MIN_TIME_MASK	(1u << 31u)
220 #define	PCI_CONFIG_EXT_CLK_MIN_TIME_SHIFT	(31)
221 
222 #define PCI_ADV_ERR_CAP			0x100
223 #define	PCI_UC_ERR_STATUS		0x104
224 #define	PCI_UNCORR_ERR_MASK		0x108
225 #define PCI_UCORR_ERR_SEVR		0x10c
226 #define	PCI_CORR_ERR_STATUS		0x110
227 #define	PCI_CORR_ERR_MASK		0x114
228 #define	PCI_ERR_CAP_CTRL		0x118
229 #define	PCI_TLP_HDR_LOG1		0x11c
230 #define	PCI_TLP_HDR_LOG2		0x120
231 #define	PCI_TLP_HDR_LOG3		0x124
232 #define	PCI_TLP_HDR_LOG4		0x128
233 #define	PCI_TL_CTRL_5			0x814
234 #define	PCI_TL_HDR_FC_ST		0x980
235 #define	PCI_TL_TGT_CRDT_ST		0x990
236 #define	PCI_TL_SMLOGIC_ST		0x998
237 #define	PCI_DL_ATTN_VEC			0x1040
238 #define	PCI_DL_STATUS			0x1048
239 
240 #define	PCI_PHY_CTL_0			0x1800
241 #define	PCI_SLOW_PMCLK_EXT_RLOCK	(1 << 7)
242 
243 #define	PCI_LINK_STATE_DEBUG	0x1c24
244 #define PCI_RECOVERY_HIST		0x1ce4
245 #define PCI_PHY_LTSSM_HIST_0	0x1cec
246 #define PCI_PHY_LTSSM_HIST_1	0x1cf0
247 #define PCI_PHY_LTSSM_HIST_2	0x1cf4
248 #define PCI_PHY_LTSSM_HIST_3	0x1cf8
249 #define PCI_PHY_DBG_CLKREG_0	0x1e10
250 #define PCI_PHY_DBG_CLKREG_1	0x1e14
251 #define PCI_PHY_DBG_CLKREG_2	0x1e18
252 #define PCI_PHY_DBG_CLKREG_3	0x1e1c
253 
254 /* Bit settings for PCIE_CFG_SUBSYSTEM_CONTROL register */
255 #define PCIE_BAR1COHERENTACCEN_BIT	8
256 #define PCIE_BAR2COHERENTACCEN_BIT	9
257 #define PCIE_SSRESET_STATUS_BIT		13
258 #define PCIE_SSRESET_DISABLE_BIT	14
259 #define PCIE_SSRESET_DIS_ENUM_RST_BIT		15
260 
261 #define PCIE_BARCOHERENTACCEN_MASK	0x300
262 
263 /* Bit settings for PCI_UC_ERR_STATUS register */
264 #define PCI_UC_ERR_URES			(1 << 20)	/* Unsupported Request Error Status */
265 #define PCI_UC_ERR_ECRCS		(1 << 19)	/* ECRC Error Status */
266 #define PCI_UC_ERR_MTLPS		(1 << 18)	/* Malformed TLP Status */
267 #define PCI_UC_ERR_ROS			(1 << 17)	/* Receiver Overflow Status */
268 #define PCI_UC_ERR_UCS			(1 << 16)	/* Unexpected Completion Status */
269 #define PCI_UC_ERR_CAS			(1 << 15)	/* Completer Abort Status */
270 #define PCI_UC_ERR_CTS			(1 << 14)	/* Completer Timeout Status */
271 #define PCI_UC_ERR_FCPES		(1 << 13)	/* Flow Control Protocol Error Status */
272 #define PCI_UC_ERR_PTLPS		(1 << 12)	/* Poisoned TLP Status */
273 #define PCI_UC_ERR_DLPES		(1 << 4)	/* Data Link Protocol Error Status */
274 
275 #define PCI_DL_STATUS_PHY_LINKUP    (1 << 13) /* Status of LINK */
276 
277 #define	PCI_PMCR_REFUP		0x1814	/* Trefup time */
278 #define PCI_PMCR_TREFUP_LO_MASK		0x3f
279 #define PCI_PMCR_TREFUP_LO_SHIFT	24
280 #define PCI_PMCR_TREFUP_LO_BITS		6
281 #define PCI_PMCR_TREFUP_HI_MASK		0xf
282 #define PCI_PMCR_TREFUP_HI_SHIFT	5
283 #define PCI_PMCR_TREFUP_HI_BITS		4
284 #define PCI_PMCR_TREFUP_MAX			0x400
285 #define PCI_PMCR_TREFUP_MAX_SCALE	0x2000
286 
287 #define	PCI_PMCR_REFUP_EXT	0x1818	/* Trefup extend Max */
288 #define PCI_PMCR_TREFUP_EXT_SHIFT	22
289 #define PCI_PMCR_TREFUP_EXT_SCALE	3
290 #define PCI_PMCR_TREFUP_EXT_ON		1
291 #define PCI_PMCR_TREFUP_EXT_OFF		0
292 
293 #define PCI_TPOWER_SCALE_MASK 0x3
294 #define PCI_TPOWER_SCALE_SHIFT 3 /* 0:1 is scale and 2 is rsvd */
295 
296 #define	PCI_BAR0_SHADOW_OFFSET	(2 * 1024)	/* bar0 + 2K accesses sprom shadow (in pci core) */
297 #define	PCI_BAR0_SPROM_OFFSET	(4 * 1024)	/* bar0 + 4K accesses external sprom */
298 #define	PCI_BAR0_PCIREGS_OFFSET	(6 * 1024)	/* bar0 + 6K accesses pci core registers */
299 #define	PCI_BAR0_PCISBR_OFFSET	(4 * 1024)	/* pci core SB registers are at the end of the
300 						 * 8KB window, so their address is the "regular"
301 						 * address plus 4K
302 						 */
303 /*
304  * PCIE GEN2 changed some of the above locations for
305  * Bar0WrapperBase, SecondaryBAR0Window and SecondaryBAR0WrapperBase
306  * BAR0 maps 32K of register space
307 */
308 #define PCIE2_BAR0_WIN2		0x70 /* backplane addres space accessed by second 4KB of BAR0 */
309 #define PCIE2_BAR0_CORE2_WIN	0x74 /* backplane addres space accessed by second 4KB of BAR0 */
310 #define PCIE2_BAR0_CORE2_WIN2	0x78 /* backplane addres space accessed by second 4KB of BAR0 */
311 #define PCIE2_BAR0_WINSZ	0x8000
312 
313 #define PCI_BAR0_WIN2_OFFSET		0x1000u
314 #define PCI_CORE_ENUM_OFFSET		0x2000u
315 #define PCI_CC_CORE_ENUM_OFFSET		0x3000u
316 #define PCI_SEC_BAR0_WIN_OFFSET		0x4000u
317 #define PCI_SEC_BAR0_WRAP_OFFSET	0x5000u
318 #define PCI_CORE_ENUM2_OFFSET		0x6000u
319 #define PCI_CC_CORE_ENUM2_OFFSET	0x7000u
320 #define PCI_LAST_OFFSET			0x8000u
321 
322 #define PCI_BAR0_WINSZ		(16 * 1024)	/* bar0 window size Match with corerev 13 */
323 /* On pci corerev >= 13 and all pcie, the bar0 is now 16KB and it maps: */
324 #define	PCI_16KB0_PCIREGS_OFFSET (8 * 1024)	/* bar0 + 8K accesses pci/pcie core registers */
325 #define	PCI_16KB0_CCREGS_OFFSET	(12 * 1024)	/* bar0 + 12K accesses chipc core registers */
326 #define PCI_16KBB0_WINSZ	(16 * 1024)	/* bar0 window size */
327 #define PCI_SECOND_BAR0_OFFSET	(16 * 1024)	/* secondary  bar 0 window */
328 
329 /* On AI chips we have a second window to map DMP regs are mapped: */
330 #define	PCI_16KB0_WIN2_OFFSET	(4 * 1024)	/* bar0 + 4K is "Window 2" */
331 
332 /* PCI_INT_STATUS */
333 #define	PCI_SBIM_STATUS_SERR	0x4	/* backplane SBErr interrupt status */
334 
335 /* PCI_INT_MASK */
336 #define	PCI_SBIM_SHIFT		8	/* backplane core interrupt mask bits offset */
337 #define	PCI_SBIM_MASK		0xff00	/* backplane core interrupt mask */
338 #define	PCI_SBIM_MASK_SERR	0x4	/* backplane SBErr interrupt mask */
339 #define	PCI_CTO_INT_SHIFT	16	/* backplane SBErr interrupt mask */
340 #define	PCI_CTO_INT_MASK	(1 << PCI_CTO_INT_SHIFT)	/* backplane SBErr interrupt mask */
341 
342 /* PCI_SPROM_CONTROL */
343 #define SPROM_SZ_MSK		0x02	/* SPROM Size Mask */
344 #define SPROM_LOCKED		0x08	/* SPROM Locked */
345 #define	SPROM_BLANK		0x04	/* indicating a blank SPROM */
346 #define SPROM_WRITEEN		0x10	/* SPROM write enable */
347 #define SPROM_BOOTROM_WE	0x20	/* external bootrom write enable */
348 #define SPROM_BACKPLANE_EN	0x40	/* Enable indirect backplane access */
349 #define SPROM_OTPIN_USE		0x80	/* device OTP In use */
350 #define SPROM_CFG_TO_SB_RST	0x400	/* backplane reset */
351 
352 /* Bits in PCI command and status regs */
353 #define PCI_CMD_IO		0x00000001	/* I/O enable */
354 #define PCI_CMD_MEMORY		0x00000002	/* Memory enable */
355 #define PCI_CMD_MASTER		0x00000004	/* Master enable */
356 #define PCI_CMD_SPECIAL		0x00000008	/* Special cycles enable */
357 #define PCI_CMD_INVALIDATE	0x00000010	/* Invalidate? */
358 #define PCI_CMD_VGA_PAL		0x00000040	/* VGA Palate */
359 #define PCI_STAT_TA		0x08000000	/* target abort status */
360 
361 /* Header types */
362 #define	PCI_HEADER_MULTI	0x80
363 #define	PCI_HEADER_MASK		0x7f
364 typedef enum {
365 	PCI_HEADER_NORMAL,
366 	PCI_HEADER_BRIDGE,
367 	PCI_HEADER_CARDBUS
368 } pci_header_types;
369 
370 #define PCI_CONFIG_SPACE_SIZE	256
371 
372 #define DWORD_ALIGN(x)  (x & ~(0x03))
373 #define BYTE_POS(x) (x & 0x3)
374 #define WORD_POS(x) (x & 0x1)
375 
376 #define BYTE_SHIFT(x)  (8 * BYTE_POS(x))
377 #define WORD_SHIFT(x)  (16 * WORD_POS(x))
378 
379 #define BYTE_VAL(a, x) ((a >> BYTE_SHIFT(x)) & 0xFF)
380 #define WORD_VAL(a, x) ((a >> WORD_SHIFT(x)) & 0xFFFF)
381 
382 #define read_pci_cfg_byte(a) \
383 	(BYTE_VAL(OSL_PCI_READ_CONFIG(osh, DWORD_ALIGN(a), 4), a) & 0xff)
384 
385 #define read_pci_cfg_word(a) \
386 	(WORD_VAL(OSL_PCI_READ_CONFIG(osh, DWORD_ALIGN(a), 4), a) & 0xffff)
387 
388 #define write_pci_cfg_byte(a, val) do { \
389 	uint32 tmpval; \
390 	tmpval = (OSL_PCI_READ_CONFIG(osh, DWORD_ALIGN(a), 4) & ~0xFF << BYTE_POS(a)) | \
391 	        val << BYTE_POS(a); \
392 	OSL_PCI_WRITE_CONFIG(osh, DWORD_ALIGN(a), 4, tmpval); \
393 	} while (0)
394 
395 #define write_pci_cfg_word(a, val) do { \
396 	uint32 tmpval; \
397 	tmpval = (OSL_PCI_READ_CONFIG(osh, DWORD_ALIGN(a), 4) & ~0xFFFF << WORD_POS(a)) | \
398 	        val << WORD_POS(a); \
399 	OSL_PCI_WRITE_CONFIG(osh, DWORD_ALIGN(a), 4, tmpval); \
400 	} while (0)
401 
402 #endif	/* _h_pcicfg_ */
403