pci.h revision 1.57
1/*	$NetBSD: pci.h,v 1.57 2023/09/30 10:46:46 mrg Exp $	*/
2
3/*-
4 * Copyright (c) 2013 The NetBSD Foundation, Inc.
5 * All rights reserved.
6 *
7 * This code is derived from software contributed to The NetBSD Foundation
8 * by Taylor R. Campbell.
9 *
10 * Redistribution and use in source and binary forms, with or without
11 * modification, are permitted provided that the following conditions
12 * are met:
13 * 1. Redistributions of source code must retain the above copyright
14 *    notice, this list of conditions and the following disclaimer.
15 * 2. Redistributions in binary form must reproduce the above copyright
16 *    notice, this list of conditions and the following disclaimer in the
17 *    documentation and/or other materials provided with the distribution.
18 *
19 * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
20 * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
21 * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
22 * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
23 * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
24 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
25 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
26 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
27 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
28 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
29 * POSSIBILITY OF SUCH DAMAGE.
30 */
31
32#ifndef _LINUX_PCI_H_
33#define _LINUX_PCI_H_
34
35#ifdef _KERNEL_OPT
36#include "acpica.h"
37#endif
38
39#include <sys/types.h>
40#include <sys/param.h>
41#include <sys/bus.h>
42#include <sys/cdefs.h>
43#include <sys/kmem.h>
44#include <sys/systm.h>
45
46#include <machine/limits.h>
47
48#include <dev/pci/pcidevs.h>
49#include <dev/pci/pcireg.h>
50#include <dev/pci/pcivar.h>
51#include <dev/pci/agpvar.h>
52#include <dev/pci/ppbvar.h>
53
54#include <linux/device.h>
55#include <linux/dma-mapping.h>
56#include <linux/errno.h>
57#include <linux/io.h>
58#include <linux/interrupt.h>
59#include <linux/ioport.h>
60#include <linux/kernel.h>
61
62struct acpi_devnode;
63struct pci_driver;
64struct pci_dev;
65struct pci_bus;
66
67struct pci_device_id {
68	uint32_t	vendor;
69	uint32_t	device;
70	uint32_t	subvendor;
71	uint32_t	subdevice;
72	uint32_t	class;
73	uint32_t	class_mask;
74	unsigned long	driver_data;
75};
76
77#define	PCI_DEVICE(VENDOR, DEVICE)					      \
78	.vendor = (VENDOR),						      \
79	.device = (DEVICE)
80
81#define	PCI_ANY_ID		(~0)
82
83#define	PCI_BASE_CLASS_DISPLAY	PCI_CLASS_DISPLAY
84
85#define	PCI_CLASS_DISPLAY_VGA						\
86	((PCI_CLASS_DISPLAY << 8) | PCI_SUBCLASS_DISPLAY_VGA)
87CTASSERT(PCI_CLASS_DISPLAY_VGA == 0x0300);
88
89#define	PCI_CLASS_DISPLAY_OTHER						\
90	((PCI_CLASS_DISPLAY << 8) | PCI_SUBCLASS_DISPLAY_MISC)
91CTASSERT(PCI_CLASS_DISPLAY_OTHER == 0x0380);
92
93#define	PCI_CLASS_BRIDGE_ISA						\
94	((PCI_CLASS_BRIDGE << 8) | PCI_SUBCLASS_BRIDGE_ISA)
95CTASSERT(PCI_CLASS_BRIDGE_ISA == 0x0601);
96
97/* XXX This is getting silly...  */
98#define	PCI_VENDOR_ID_APPLE	PCI_VENDOR_APPLE
99#define	PCI_VENDOR_ID_ASUSTEK	PCI_VENDOR_ASUSTEK
100#define	PCI_VENDOR_ID_ATI	PCI_VENDOR_ATI
101#define	PCI_VENDOR_ID_DELL	PCI_VENDOR_DELL
102#define	PCI_VENDOR_ID_IBM	PCI_VENDOR_IBM
103#define	PCI_VENDOR_ID_HP	PCI_VENDOR_HP
104#define	PCI_VENDOR_ID_INTEL	PCI_VENDOR_INTEL
105#define	PCI_VENDOR_ID_NVIDIA	PCI_VENDOR_NVIDIA
106#define	PCI_VENDOR_ID_SI	PCI_VENDOR_SIS
107#define	PCI_VENDOR_ID_SONY	PCI_VENDOR_SONY
108#define	PCI_VENDOR_ID_VIA	PCI_VENDOR_VIATECH
109
110#define	PCI_SUBVENDOR_ID_REDHAT_QUMRANET	0x1af4
111
112#define	PCI_DEVICE_ID_ATI_RADEON_QY	PCI_PRODUCT_ATI_RADEON_RV100_QY
113
114#define	PCI_SUBDEVICE_ID_QEMU		0x1100
115
116#define	PCI_DEVFN(DEV, FN)						\
117	(__SHIFTIN((DEV), __BITS(3, 7)) | __SHIFTIN((FN), __BITS(0, 2)))
118#define	PCI_SLOT(DEVFN)		((int)__SHIFTOUT((DEVFN), __BITS(3, 7)))
119#define	PCI_FUNC(DEVFN)		((int)__SHIFTOUT((DEVFN), __BITS(0, 2)))
120
121#define	PCI_DEVID(BUS, DEVFN)						      \
122	(__SHIFTIN((BUS), __BITS(15, 8)) | __SHIFTIN((DEVFN), __BITS(7, 0)))
123#define	PCI_BUS_NUM(DEVID)	((int)__SHIFTOUT((DEVID), __BITS(15,8)))
124
125#define	PCI_NUM_RESOURCES	((PCI_MAPREG_END - PCI_MAPREG_START) / 4)
126#define	DEVICE_COUNT_RESOURCE	PCI_NUM_RESOURCES
127
128#define	PCI_CAP_ID_AGP	PCI_CAP_AGP
129
130#define PCI_EXP_LNKCTL			PCIE_LCSR
131#define  PCI_EXP_LNKCTL_HAWD		PCIE_LCSR_HAWD
132#define PCI_EXP_DEVSTA			(PCIE_DCSR + 2)
133#define  PCI_EXP_DEVSTA_TRPND		(PCIE_DCSR_TRANSACTION_PND >> 16)
134#define PCI_EXP_LNKCTL2			PCIE_LCAP2
135#define  PCI_EXP_LNKCTL2_ENTER_COMP	PCIE_LCSR2_ENT_COMPL
136#define  PCI_EXP_LNKCTL2_TX_MARGIN	PCIE_LCSR2_TX_MARGIN
137#define  PCI_EXP_LNKCTL2_TLS		PCIE_LCSR2_TGT_LSPEED
138#define  PCI_EXP_LNKCTL2_TLS_2_5GT	PCIE_LCSR2_TGT_LSPEED_2_5G
139#define  PCI_EXP_LNKCTL2_TLS_5_0GT	PCIE_LCSR2_TGT_LSPEED_5G
140#define  PCI_EXP_LNKCTL2_TLS_8_0GT	PCIE_LCSR2_TGT_LSPEED_8G
141#define PCI_EXP_LNKCAP			PCIE_LCAP
142#define  PCI_EXP_LNKCAP_CLKPM		PCIE_LCAP_CLOCK_PM
143#define PCI_EXP_DEVCAP2_ATOMIC_COMP32	PCIE_DCAP2_32ATOM
144#define PCI_EXP_DEVCAP2_ATOMIC_COMP64	PCIE_DCAP2_64ATOM
145
146
147typedef int pci_power_t;
148
149#define	PCI_D0		0
150#define	PCI_D1		1
151#define	PCI_D2		2
152#define	PCI_D3hot	3
153#define	PCI_D3cold	4
154
155#define	__pci_iomem
156
157struct pci_dev {
158	struct pci_attach_args	pd_pa;
159	int			pd_kludges;	/* Gotta lose 'em...  */
160#define	NBPCI_KLUDGE_GET_MUMBLE	0x01
161#define	NBPCI_KLUDGE_MAP_ROM	0x02
162	bus_space_tag_t		pd_rom_bst;
163	bus_space_handle_t	pd_rom_bsh;
164	bus_size_t		pd_rom_size;
165	bus_space_handle_t	pd_rom_found_bsh;
166	bus_size_t		pd_rom_found_size;
167	void			*pd_rom_vaddr;
168	device_t		pd_dev;
169	void			*pd_drvdata;
170	struct {
171		pcireg_t		type;
172		bus_addr_t		addr;
173		bus_size_t		size;
174		int			flags;
175		bus_space_tag_t		bst;
176		bus_space_handle_t	bsh;
177		void __pci_iomem	*kva;
178		bool			mapped;
179	}			pd_resources[PCI_NUM_RESOURCES];
180	struct pci_conf_state	*pd_saved_state;
181	struct acpi_devnode	*pd_ad;
182	pci_intr_handle_t	*pd_intr_handles;
183	unsigned		pd_enablecnt;
184
185	/* Linx API only below */
186	struct pci_bus		*bus;
187	uint32_t		devfn;
188	uint16_t		vendor;
189	uint16_t		device;
190	uint16_t		subsystem_vendor;
191	uint16_t		subsystem_device;
192	uint8_t			revision;
193	uint32_t		class;
194	bool			msi_enabled;
195	bool			no_64bit_msi;
196};
197
198enum pci_bus_speed {
199	PCI_SPEED_UNKNOWN,
200	PCIE_SPEED_2_5GT,
201	PCIE_SPEED_5_0GT,
202	PCIE_SPEED_8_0GT,
203	PCIE_SPEED_16_0GT,
204	PCIE_SPEED_32_0GT,
205	PCIE_SPEED_64_0GT,
206};
207
208/*
209 * Actually values from the Link Status register, bits 16-19.  Don't use
210 * these as a bit-mask -- these are the only known, valid values.
211 */
212enum pcie_link_width {
213	PCIE_LNK_WIDTH_RESRV   = 0,
214	PCIE_LNK_X1            = __BIT(0),
215	PCIE_LNK_X2            = __BIT(1),
216	PCIE_LNK_X4            = __BIT(2),
217	PCIE_LNK_X8            = __BIT(3),
218	PCIE_LNK_X12           = __BITS(2,3),
219	PCIE_LNK_X16           = __BIT(4),
220	PCIE_LNK_X32           = __BIT(5),
221	PCIE_LNK_WIDTH_UNKNOWN = __BITS(0, 7),
222};
223
224#define	PCIBIOS_MIN_MEM	0x100000	/* XXX bogus x86 kludge bollocks */
225
226#define	__pci_rom_iomem
227
228struct pci_bus {
229	/* NetBSD private members */
230	pci_chipset_tag_t	pb_pc;
231	device_t		pb_dev;
232
233	/* Linux API */
234	u_int			number;
235	enum pci_bus_speed	max_bus_speed;
236
237	struct pci_dev		*self;
238};
239
240/* Namespace.  */
241#define	pci_bus_alloc_resource		linux_pci_bus_alloc_resource
242#define	pci_bus_read_config_byte	linux_pci_bus_read_config_byte
243#define	pci_bus_read_config_dword	linux_pci_bus_read_config_dword
244#define	pci_bus_read_config_word	linux_pci_bus_read_config_word
245#define	pci_bus_write_config_byte	linux_pci_bus_write_config_byte
246#define	pci_bus_write_config_dword	linux_pci_bus_write_config_dword
247#define	pci_bus_write_config_word	linux_pci_bus_write_config_word
248#define	pci_clear_master		linux_pci_clear_master
249#define	pci_dev_dev			linux_pci_dev_dev
250#define	pci_dev_present			linux_pci_dev_present
251#define	pci_dev_put			linux_pci_dev_put
252#define	pci_disable_msi			linux_pci_disable_msi
253#define	pci_disable_rom			linux_pci_disable_rom
254#define	pci_dma_supported		linux_pci_dma_supported
255#define	pci_domain_nr			linux_pci_domain_nr
256#define	pci_enable_msi			linux_pci_enable_msi
257#define	pci_enable_rom			linux_pci_enable_rom
258#define	pci_find_capability		linux_pci_find_capability
259#define	pci_get_class			linux_pci_get_class
260#define	pci_get_domain_bus_and_slot	linux_pci_get_domain_bus_and_slot
261#define	pci_get_drvdata			linux_pci_get_drvdata
262#define	pci_iomap			linux_pci_iomap
263#define	pci_iounmap			linux_pci_iounmap
264#define	pci_is_pcie			linux_pci_is_pcie
265#define	pci_is_root_bus			linux_pci_is_root_bus
266#define	pci_is_thunderbolt_attached	linux_pci_is_thunderbolt_attached
267#define	pci_map_rom			linux_pci_map_rom
268#define	pci_name			linux_pci_name
269#define	pci_platform_rom		linux_pci_platform_rom
270#define	pci_read_config_byte		linux_pci_read_config_byte
271#define	pci_read_config_dword		linux_pci_read_config_dword
272#define	pci_read_config_word		linux_pci_read_config_word
273#define	pci_release_region		linux_pci_release_region
274#define	pci_release_regions		linux_pci_release_regions
275#define	pci_request_region		linux_pci_request_region
276#define	pci_request_regions		linux_pci_request_regions
277#define	pci_resource_end		linux_pci_resource_end
278#define	pci_resource_flags		linux_pci_resource_flags
279#define	pci_resource_len		linux_pci_resource_len
280#define	pci_resource_start		linux_pci_resource_start
281#define	pci_restore_state		linux_pci_restore_state
282#define	pci_save_state			linux_pci_save_state
283#define	pci_set_drvdata			linux_pci_set_drvdata
284#define	pci_set_master			linux_pci_set_master
285#define	pci_unmap_rom			linux_pci_unmap_rom
286#define	pci_write_config_byte		linux_pci_write_config_byte
287#define	pci_write_config_dword		linux_pci_write_config_dword
288#define	pci_write_config_word		linux_pci_write_config_word
289#define	pcibios_align_resource		linux_pcibios_align_resource
290#define	pcie_get_speed_cap		linux_pcie_get_speed_cap
291#define	pcie_bandwidth_available	linux_pcie_bandwidth_available
292#define	pcie_read_config_dword		linux_pcie_capability_read_dword
293#define	pcie_read_config_word		linux_pcie_capability_read_word
294#define	pcie_write_config_dword		linux_pcie_capability_write_dword
295#define	pcie_write_config_word		linux_pcie_capability_write_word
296#define	pci_enable_atomic_ops_to_root	linux_pci_enable_atomic_ops_to_root
297
298/* NetBSD local additions.  */
299void		linux_pci_dev_init(struct pci_dev *, device_t, device_t,
300		    const struct pci_attach_args *, int);
301void		linux_pci_dev_destroy(struct pci_dev *);
302
303/* NetBSD no-renames because use requires review.  */
304int		linux_pci_enable_device(struct pci_dev *);
305void		linux_pci_disable_device(struct pci_dev *);
306
307bool		pci_is_root_bus(struct pci_bus *);
308int		pci_domain_nr(struct pci_bus *);
309
310device_t	pci_dev_dev(struct pci_dev *);
311void		pci_set_drvdata(struct pci_dev *, void *);
312void *		pci_get_drvdata(struct pci_dev *);
313const char *	pci_name(struct pci_dev *);
314
315int		pci_find_capability(struct pci_dev *, int);
316bool		pci_is_pcie(struct pci_dev *);
317bool		pci_dma_supported(struct pci_dev *, uintmax_t);
318bool		pci_is_thunderbolt_attached(struct pci_dev *);
319
320int		pci_read_config_dword(struct pci_dev *, int, uint32_t *);
321int		pci_read_config_word(struct pci_dev *, int, uint16_t *);
322int		pci_read_config_byte(struct pci_dev *, int, uint8_t *);
323int		pci_write_config_dword(struct pci_dev *, int, uint32_t);
324int		pci_write_config_word(struct pci_dev *, int, uint16_t);
325int		pci_write_config_byte(struct pci_dev *, int, uint8_t);
326
327int		pcie_capability_read_dword(struct pci_dev *, int, uint32_t *);
328int		pcie_capability_read_word(struct pci_dev *, int, uint16_t *);
329int		pcie_capability_write_dword(struct pci_dev *, int, uint32_t);
330int		pcie_capability_write_word(struct pci_dev *, int, uint16_t);
331
332int		pci_bus_read_config_dword(struct pci_bus *, unsigned, int,
333		    uint32_t *);
334int		pci_bus_read_config_word(struct pci_bus *, unsigned, int,
335		    uint16_t *);
336int		pci_bus_read_config_byte(struct pci_bus *, unsigned, int,
337		    uint8_t *);
338int		pci_bus_write_config_dword(struct pci_bus *, unsigned, int,
339		    uint32_t);
340int		pci_bus_write_config_word(struct pci_bus *, unsigned, int,
341		    uint16_t);
342int		pci_bus_write_config_byte(struct pci_bus *, unsigned, int,
343		    uint8_t);
344
345int		pci_enable_msi(struct pci_dev *);
346void		pci_disable_msi(struct pci_dev *);
347void		pci_set_master(struct pci_dev *);
348void		pci_clear_master(struct pci_dev *);
349
350int		pcie_get_readrq(struct pci_dev *);
351int		pcie_set_readrq(struct pci_dev *, int);
352
353bus_addr_t	pcibios_align_resource(void *, const struct resource *,
354		    bus_addr_t, bus_size_t);
355int		pci_bus_alloc_resource(struct pci_bus *, struct resource *,
356		    bus_size_t, bus_size_t, bus_addr_t, int,
357		    bus_addr_t (*)(void *, const struct resource *, bus_addr_t,
358			bus_size_t), struct pci_dev *);
359
360/* XXX Kludges only -- do not use without checking the implementation!  */
361struct pci_dev *pci_get_domain_bus_and_slot(int, int, int);
362struct pci_dev *pci_get_class(uint32_t, struct pci_dev *); /* i915 kludge */
363int		pci_dev_present(const struct pci_device_id *);
364void		pci_dev_put(struct pci_dev *);
365
366void __pci_rom_iomem *
367		pci_map_rom(struct pci_dev *, size_t *);
368void __pci_rom_iomem *
369		pci_platform_rom(struct pci_dev *, size_t *);
370void		pci_unmap_rom(struct pci_dev *, void __pci_rom_iomem *);
371int		pci_enable_rom(struct pci_dev *);
372void		pci_disable_rom(struct pci_dev *);
373
374int		pci_request_regions(struct pci_dev *, const char *);
375void		pci_release_regions(struct pci_dev *);
376int		pci_request_region(struct pci_dev *, int, const char *);
377void		pci_release_region(struct pci_dev *, int);
378
379bus_addr_t	pci_resource_start(struct pci_dev *, unsigned);
380bus_size_t	pci_resource_len(struct pci_dev *, unsigned);
381bus_addr_t	pci_resource_end(struct pci_dev *, unsigned);
382int		pci_resource_flags(struct pci_dev *, unsigned);
383
384void __pci_iomem *
385		pci_iomap(struct pci_dev *, unsigned, bus_size_t);
386void		pci_iounmap(struct pci_dev *, void __pci_iomem *);
387
388void		pci_save_state(struct pci_dev *);
389void		pci_restore_state(struct pci_dev *);
390
391enum pci_bus_speed pcie_get_speed_cap(struct pci_dev *dev);
392unsigned	pcie_bandwidth_available(struct pci_dev *dev,
393					 struct pci_dev **limiting_dev,
394					 enum pci_bus_speed *speed,
395					 enum pcie_link_width *width);
396
397static inline bool
398dev_is_pci(struct device *dev)
399{
400	struct device *parent = device_parent(dev);
401
402	return parent && device_is_a(parent, "pci");
403}
404
405static inline int
406pci_enable_atomic_ops_to_root(struct pci_dev *dev, uint32_t cap_mask)
407{
408
409	return -EINVAL;
410}
411
412#endif  /* _LINUX_PCI_H_ */
413