1/* $NetBSD: pci_machdep.h,v 1.11 2011/06/22 18:06:34 matt Exp $ */
2
3/*-
4 * Copyright (c) 2002,2007 The NetBSD Foundation, Inc.
5 * All rights reserved.
6 *
7 * This code is derived from software contributed to The NetBSD Foundation
8 * by Klaus Klein and Tim Rightnour
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 _PCI_MACHDEP_H_
33#define _PCI_MACHDEP_H_
34
35#include <prop/proplib.h>
36
37/*
38 * Machine-specific definitions for PCI autoconfiguration.
39 */
40
41#define __HAVE_PCI_CONF_HOOK
42
43/*
44 * Types provided to machine-independent PCI code
45 */
46typedef struct genppc_pci_chipset *pci_chipset_tag_t;
47typedef void *pci_msi_handle_t;
48typedef int pcitag_t;
49typedef int pci_intr_handle_t;
50
51/*
52 * Forward declarations.
53 */
54struct pci_attach_args;
55struct pcibus_attach_args;
56
57static inline pci_chipset_tag_t pcibus_attach_args_pc(
58    struct pcibus_attach_args *);
59static inline pci_chipset_tag_t pci_attach_args_pc(
60    const struct pci_attach_args *);
61
62#include <dev/pci/pcireg.h>
63
64#ifdef _KERNEL
65extern struct powerpc_bus_dma_tag pci_bus_dma_tag;
66#endif
67
68
69#if defined(_KERNEL) && (defined(_MODULE) || defined(__PCI_NOINLINE))
70void		pci_attach_hook(device_t, device_t,
71		    struct pcibus_attach_args *);
72
73int		pci_bus_maxdevs(pci_chipset_tag_t, int);
74pcitag_t	pci_make_tag(pci_chipset_tag_t, int, int, int);
75pcireg_t	pci_conf_read(pci_chipset_tag_t, pcitag_t, int);
76void		pci_conf_write(pci_chipset_tag_t, pcitag_t, int, pcireg_t);
77void		pci_decompose_tag(pci_chipset_tag_t, pcitag_t,
78		    int *, int *, int *);
79
80const char *	pci_intr_string(pci_chipset_tag_t, pci_intr_handle_t);
81const struct evcnt *
82		pci_intr_evcnt(pci_chipset_tag_t, pci_intr_handle_t);
83void *		pci_intr_establish(pci_chipset_tag_t, pci_intr_handle_t,
84		    int, int (*)(void *), void *);
85void		pci_intr_disestablish(pci_chipset_tag_t, void *);
86int		pci_intr_map(const struct pci_attach_args *,
87		    pci_intr_handle_t *ihp);
88int		pci_intr_setattr(pci_chipset_tag_t, pci_intr_handle_t *,
89		    int, uint64_t);
90
91int		pci_msi_request(const struct pci_attach_args *,
92		    pci_msi_handle_t *, size_t, int, int);
93int		pci_msi_type(pci_chipset_tag_t, pci_msi_handle_t);
94size_t		pci_msi_available(pci_chipset_tag_t, pci_msi_handle_t);
95const char *	pci_msi_string(pci_chipset_tag_t, pci_msi_handle_t, size_t);
96const struct evcnt *
97		pci_msi_evcnt(pci_chipset_tag_t, pci_msi_handle_t, size_t);
98void *		pci_msi_establish(pci_chipset_tag_t, pci_msi_handle_t, size_t,
99		    int, int (*)(void *), void *);
100void *		pci_msix_establish(pci_chipset_tag_t, pci_msi_handle_t, size_t,
101		    size_t, int, int (*)(void *), void *);
102void		pci_msi_disestablish(pci_chipset_tag_t, void *);
103void		pci_msi_free(pci_chipset_tag_t, pci_msi_handle_t, size_t);
104void		pci_msi_release(pci_chipset_tag_t, pci_msi_handle_t);
105
106void		pci_conf_interrupt(pci_chipset_tag_t, int, int, int,
107		    int, int *);
108int		pci_conf_hook(pci_chipset_tag_t, int, int, int, pcireg_t);
109#endif /* _KERNEL && (_MODULE || __PCI_NOINLINE) */
110
111/* Per bus information structure */
112struct genppc_pci_chipset_businfo {
113	SIMPLEQ_ENTRY(genppc_pci_chipset_businfo) next;
114	prop_dictionary_t	pbi_properties; /* chipset properties */
115};
116
117#if !defined(_MODULE)
118/*
119 * Generic PPC PCI structure and type definitions.
120 * NOT TO BE USED DIRECTLY BY MACHINE INDEPENDENT CODE.
121 */
122struct genppc_pci_chipset {
123	void		*pc_conf_v;
124	void		(*pc_attach_hook)(device_t, device_t,
125			    struct pcibus_attach_args *);
126	int		(*pc_bus_maxdevs)(void *, int);
127	pcitag_t	(*pc_make_tag)(void *, int, int, int);
128	pcireg_t	(*pc_conf_read)(void *, pcitag_t, int);
129	void		(*pc_conf_write)(void *, pcitag_t, int, pcireg_t);
130
131	void		*pc_intr_v;
132	int		(*pc_intr_map)(const struct pci_attach_args *,
133			    pci_intr_handle_t *);
134	const char	*(*pc_intr_string)(void *, pci_intr_handle_t);
135	const struct evcnt *(*pc_intr_evcnt)(void *, pci_intr_handle_t);
136	void		*(*pc_intr_establish)(void *, pci_intr_handle_t,
137			    int, int (*)(void *), void *);
138	void		(*pc_intr_disestablish)(void *, void *);
139	int		(*pc_intr_setattr)(void *, pci_intr_handle_t *,
140			    int, uint64_t);
141
142	void		*pc_msi_v;
143	int		(*pc_msi_request)(const struct pci_attach_args *,
144			    pci_msi_handle_t *, size_t, int, int);
145	int		(*pc_msi_type)(void *, pci_msi_handle_t);
146	size_t		(*pc_msi_available)(void *, pci_msi_handle_t);
147	const char *	(*pc_msi_string)(void *, pci_msi_handle_t, size_t);
148	const struct evcnt *
149			(*pc_msi_evcnt)(void *, pci_msi_handle_t, size_t);
150	void *		(*pc_msi_establish)(void *, pci_msi_handle_t, size_t,
151			    int, int (*)(void *), void *);
152	void *		(*pc_msix_establish)(void *, pci_msi_handle_t, size_t,
153			    size_t, int, int (*)(void *), void *);
154	void		(*pc_msi_disestablish)(void *, void *);
155	void		(*pc_msi_free)(void *, pci_msi_handle_t, size_t);
156	void		(*pc_msi_release)(void *, pci_msi_handle_t);
157
158	void		(*pc_conf_interrupt)(void *, int, int, int, int, int *);
159	void		(*pc_decompose_tag)(void *, pcitag_t, int *,
160			    int *, int *);
161	int		(*pc_conf_hook)(void *, int, int, int, pcireg_t);
162
163	uint32_t	*pc_addr;
164	uint32_t	*pc_data;
165	int		pc_node;
166	int		pc_ihandle;
167	int		pc_bus;
168	bus_space_tag_t	pc_memt;
169	bus_space_tag_t	pc_iot;
170
171	SIMPLEQ_HEAD(, genppc_pci_chipset_businfo) pc_pbi;
172};
173
174#ifdef _KERNEL
175
176#ifdef __PCI_NOINLINE
177#define	__pci_inline
178#else
179#define	__pci_inline	static inline
180#endif
181
182/*
183 * Functions provided to machine-independent PCI code.
184 */
185__pci_inline void
186pci_attach_hook(device_t parent, device_t self, struct pcibus_attach_args *pba)
187{
188	(*pcibus_attach_args_pc(pba)->pc_attach_hook)(parent, self, pba);
189}
190
191__pci_inline int
192pci_bus_maxdevs(pci_chipset_tag_t pc, int busno)
193{
194	return (*pc->pc_bus_maxdevs)(pc->pc_conf_v, busno);
195}
196
197__pci_inline pcitag_t
198pci_make_tag(pci_chipset_tag_t pc, int bus, int device, int function)
199{
200	return (*pc->pc_make_tag)(pc->pc_conf_v, bus, device, function);
201}
202
203__pci_inline pcireg_t
204pci_conf_read(pci_chipset_tag_t pc, pcitag_t tag, int reg)
205{
206	return (*pc->pc_conf_read)(pc->pc_conf_v, tag, reg);
207}
208
209__pci_inline void
210pci_conf_write(pci_chipset_tag_t pc, pcitag_t tag, int reg, pcireg_t val)
211{
212	(*pc->pc_conf_write)(pc->pc_conf_v, tag, reg, val);
213}
214
215__pci_inline void
216pci_decompose_tag(pci_chipset_tag_t pc, pcitag_t tag, int *bp, int *dp, int *fp)
217{
218	(*pc->pc_decompose_tag)(pc->pc_conf_v, tag, bp, dp, fp);
219}
220
221__pci_inline int
222pci_intr_map(const struct pci_attach_args *pa, pci_intr_handle_t *ihp)
223{
224	return (*pci_attach_args_pc(pa)->pc_intr_map)(pa, ihp);
225}
226
227__pci_inline const char	*
228pci_intr_string(pci_chipset_tag_t pc, pci_intr_handle_t ih)
229{
230	return (*pc->pc_intr_string)(pc->pc_intr_v, ih);
231}
232
233__pci_inline const struct evcnt *
234pci_intr_evcnt(pci_chipset_tag_t pc, pci_intr_handle_t ih)
235{
236	return (*pc->pc_intr_evcnt)(pc->pc_intr_v, ih);
237}
238
239__pci_inline void *
240pci_intr_establish(pci_chipset_tag_t pc, pci_intr_handle_t ih, int ipl,
241    int (*handler)(void *), void *arg)
242{
243	return (*pc->pc_intr_establish)(pc->pc_intr_v, ih, ipl, handler, arg);
244}
245
246__pci_inline void
247pci_intr_disestablish(pci_chipset_tag_t pc, void *cookie)
248{
249	(*pc->pc_intr_disestablish)(pc->pc_intr_v, cookie);
250}
251
252__pci_inline int
253pci_intr_setattr(pci_chipset_tag_t pc, pci_intr_handle_t *ihp, int attr,
254    uint64_t data)
255{
256	return (*pc->pc_intr_setattr)(pc->pc_intr_v, ihp, attr, data);
257}
258
259
260__pci_inline void
261pci_conf_interrupt(pci_chipset_tag_t pc, int bus, int device, int pin,
262    int swiz, int *iline)
263{
264	(*pc->pc_conf_interrupt)(pc->pc_conf_v, bus, device, pin, swiz, iline);
265}
266
267__pci_inline int
268pci_conf_hook(pci_chipset_tag_t pc, int bus, int device, int function,
269    pcireg_t id)
270{
271	return (*pc->pc_conf_hook)(pc->pc_conf_v, bus, device, function, id);
272}
273
274__pci_inline int
275pci_msi_request(const struct pci_attach_args *pa, pci_msi_handle_t *msihp,
276    size_t nmsi, int ipl, int capid)
277{
278	return (*pci_attach_args_pc(pa)->pc_msi_request)(pa, msihp, nmsi,
279	    ipl, capid);
280}
281
282__pci_inline int
283pci_msi_type(pci_chipset_tag_t pc, pci_msi_handle_t msih)
284{
285	return (*pc->pc_msi_type)(pc->pc_msi_v, msih);
286}
287
288__pci_inline size_t
289pci_msi_available(pci_chipset_tag_t pc, pci_msi_handle_t msih)
290{
291	return (*pc->pc_msi_available)(pc->pc_msi_v, msih);
292}
293
294__pci_inline const char *
295pci_msi_string(pci_chipset_tag_t pc, pci_msi_handle_t msih, size_t msirq)
296{
297	return (*pc->pc_msi_string)(pc->pc_msi_v, msih, msirq);
298}
299
300__pci_inline const struct evcnt *
301pci_msi_evcnt(pci_chipset_tag_t pc, pci_msi_handle_t msih, size_t msirq)
302{
303	return (*pc->pc_msi_evcnt)(pc->pc_msi_v, msih, msirq);
304}
305
306__pci_inline void *
307pci_msi_establish(pci_chipset_tag_t pc, pci_msi_handle_t msih, size_t msirq,
308	int ipl, int (*func)(void *), void *arg)
309{
310	return (*pc->pc_msi_establish)(pc->pc_msi_v, msih, msirq, ipl,
311	    func, arg);
312}
313
314__pci_inline void *
315pci_msix_establish(pci_chipset_tag_t pc, pci_msi_handle_t msih, size_t vec,
316	size_t msirq, int ipl, int (*func)(void *), void *arg)
317{
318	return (*pc->pc_msix_establish)(pc->pc_msi_v, msih, vec, msirq, ipl,
319	    func, arg);
320}
321
322__pci_inline void
323pci_msi_disestablish(pci_chipset_tag_t pc, void *ih)
324{
325	(*pc->pc_msi_disestablish)(pc->pc_msi_v, ih);
326}
327
328__pci_inline void
329pci_msi_free(pci_chipset_tag_t pc, pci_msi_handle_t msih, size_t msirq)
330{
331	(*pc->pc_msi_free)(pc->pc_msi_v, msih, msirq);
332}
333
334__pci_inline void
335pci_msi_release(pci_chipset_tag_t pc, pci_msi_handle_t msih)
336{
337	(*pc->pc_msi_release)(pc->pc_msi_v, msih);
338}
339
340#undef	__pci_inline
341
342/*
343 * Generic PowerPC PCI functions.  Override if necc.
344 */
345
346int genppc_pci_bus_maxdevs(void *, int);
347
348int genppc_pci_intr_map(const struct pci_attach_args *,
349    pci_intr_handle_t *);
350const char *genppc_pci_intr_string(void *, pci_intr_handle_t);
351const struct evcnt *genppc_pci_intr_evcnt(void *, pci_intr_handle_t);
352void *genppc_pci_intr_establish(void *, pci_intr_handle_t, int, int (*)(void *),
353    void *);
354void genppc_pci_intr_disestablish(void *, void *);
355int genppc_pci_intr_setattr(void *, pci_intr_handle_t *, int, uint64_t);
356
357int genppc_pci_msi_request(const struct pci_attach_args *, pci_msi_handle_t *,
358    size_t, int, int);
359int genppc_pci_msi_type(void *, pci_msi_handle_t);
360size_t genppc_pci_msi_available(void *, pci_msi_handle_t);
361const struct evcnt *genppc_pci_msi_evcnt(void *, pci_msi_handle_t, size_t);
362const char *genppc_pci_msi_string(void *, pci_msi_handle_t, size_t);
363void *genppc_pci_msi_establish(void *, pci_msi_handle_t, size_t,
364    int, int (*)(void *), void *);
365void *genppc_pci_msix_establish(void *, pci_msi_handle_t, size_t,
366    size_t, int, int (*)(void *), void *);
367void genppc_pci_msi_disestablish(void *, void *);
368void genppc_pci_msi_free(void *, pci_msi_handle_t, size_t);
369void genppc_pci_msi_release(void *, pci_msi_handle_t);
370void genppc_pci_chipset_msi_init(pci_chipset_tag_t);
371
372#define GENPPC_PCI_MSI_INITIALIZER \
373	.pc_msi_request = genppc_pci_msi_request, \
374	.pc_msi_type = genppc_pci_msi_type, \
375	.pc_msi_available = genppc_pci_msi_available, \
376	.pc_msi_evcnt = genppc_pci_msi_evcnt, \
377	.pc_msi_string = genppc_pci_msi_string, \
378	.pc_msi_establish = genppc_pci_msi_establish, \
379	.pc_msix_establish = genppc_pci_msix_establish, \
380	.pc_msi_disestablish = genppc_pci_msi_disestablish, \
381	.pc_msi_free = genppc_pci_msi_free, \
382	.pc_msi_release = genppc_pci_msi_release
383
384void genppc_pci_conf_interrupt(void *, int, int, int, int, int *);
385int genppc_pci_conf_hook(void *, int, int, int, pcireg_t);
386
387/* generic indirect PCI functions */
388void genppc_pci_indirect_attach_hook(device_t, device_t,
389    struct pcibus_attach_args *);
390pcitag_t genppc_pci_indirect_make_tag(void *, int, int, int);
391pcireg_t genppc_pci_indirect_conf_read(void *, pcitag_t, int);
392void genppc_pci_indirect_conf_write(void *, pcitag_t, int, pcireg_t);
393void genppc_pci_indirect_decompose_tag(void *, pcitag_t, int *, int *, int *);
394
395/* generic OFW method PCI functions */
396void genppc_pci_ofmethod_attach_hook(device_t, device_t,
397    struct pcibus_attach_args *);
398pcitag_t genppc_pci_ofmethod_make_tag(void *, int, int, int);
399pcireg_t genppc_pci_ofmethod_conf_read(void *, pcitag_t, int);
400void genppc_pci_ofmethod_conf_write(void *, pcitag_t, int, pcireg_t);
401void genppc_pci_ofmethod_decompose_tag(void *, pcitag_t, int *, int *, int *);
402
403/* Generic OFW PCI functions */
404
405int genofw_find_picnode(int);
406void genofw_find_ofpics(int);
407void genofw_fixup_picnode_offsets(void);
408void genofw_setup_pciintr_map(void *, struct genppc_pci_chipset_businfo *, int);
409int genofw_find_node_by_devfunc(int, int, int, int);
410int genofw_pci_intr_map(const struct pci_attach_args *, pci_intr_handle_t *);
411int genofw_pci_conf_hook(void *, int, int, int, pcireg_t);
412
413/* OFW PCI structures and defines */
414#define PICNODE_TYPE_OPENPIC	1
415#define PICNODE_TYPE_8259	2
416#define PICNODE_TYPE_HEATHROW	3
417#define PICNODE_TYPE_OHARE	4
418#define PICNODE_TYPE_IVR	5
419
420typedef struct _ofw_pic_node_t {
421	int node;
422	int parent;
423	int16_t cells;
424	int16_t intrs;
425	int16_t offset;
426	int16_t type;
427} ofw_pic_node_t;
428
429#endif /* _KERNEL */
430
431#endif /* !_MODULE */
432
433#endif /* _PCI_MACHDEP_H_ */
434