xref: /netbsd/sys/dev/pci/twevar.h (revision bf9ec67e)
1 /*	$NetBSD: twevar.h,v 1.12 2002/05/24 18:10:07 christos Exp $	*/
2 
3 /*-
4  * Copyright (c) 2000, 2001, 2002 The NetBSD Foundation, Inc.
5  * All rights reserved.
6  *
7  * This code is derived from software contributed to The NetBSD Foundation
8  * by Andrew Doran.
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  * 3. All advertising materials mentioning features or use of this software
19  *    must display the following acknowledgement:
20  *        This product includes software developed by the NetBSD
21  *        Foundation, Inc. and its contributors.
22  * 4. Neither the name of The NetBSD Foundation nor the names of its
23  *    contributors may be used to endorse or promote products derived
24  *    from this software without specific prior written permission.
25  *
26  * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
27  * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
28  * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
29  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
30  * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
31  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
32  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
33  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
34  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
35  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
36  * POSSIBILITY OF SUCH DAMAGE.
37  */
38 
39 #ifndef _PCI_TWEVAR_H_
40 #define	_PCI_TWEVAR_H_
41 
42 #include "locators.h"
43 
44 #define	TWE_MAX_QUEUECNT	129
45 
46 /* Per-controller state. */
47 struct twe_softc {
48 	struct device		sc_dv;
49 	bus_space_tag_t		sc_iot;
50 	bus_space_handle_t	sc_ioh;
51 	bus_dma_tag_t		sc_dmat;
52 	bus_dmamap_t		sc_dmamap;
53 	void			*sc_ih;
54 	caddr_t			sc_cmds;
55 	bus_addr_t		sc_cmds_paddr;
56 	int			sc_nccbs;
57 	struct twe_ccb		*sc_ccbs;
58 	SIMPLEQ_HEAD(, twe_ccb)	sc_ccb_queue;
59 	SLIST_HEAD(, twe_ccb)	sc_ccb_freelist;
60 	int			sc_flags;
61 	int			sc_nunits;
62 	u_int			sc_dsize[TWE_MAX_UNITS];
63 };
64 #define	TWEF_AEN	0x01	/* retrieving an AEN */
65 
66 /* Optional per-command context. */
67 struct twe_context {
68 	void	(*tx_handler)(struct twe_ccb *, int);
69 	void 	*tx_context;
70 	struct	device	*tx_dv;
71 };
72 
73 /* Command control block. */
74 struct twe_ccb {
75 	union {
76 		SIMPLEQ_ENTRY(twe_ccb) simpleq;
77 		SLIST_ENTRY(twe_ccb) slist;
78 	} ccb_chain;
79 	struct twe_cmd	*ccb_cmd;
80 	int		ccb_cmdid;
81 	int		ccb_flags;
82 	void		*ccb_data;
83 	int		ccb_datasize;
84 	vaddr_t		ccb_abuf;
85 	bus_dmamap_t	ccb_dmamap_xfer;
86 	struct twe_context ccb_tx;
87 };
88 #define	TWE_CCB_DATA_IN		0x01	/* Map describes inbound xfer */
89 #define	TWE_CCB_DATA_OUT	0x02	/* Map describes outbound xfer */
90 #define	TWE_CCB_COMPLETE	0x04	/* Command completed */
91 #define	TWE_CCB_ACTIVE		0x08	/* Command active */
92 #define	TWE_CCB_PARAM		0x10	/* For parameter retrieval */
93 #define	TWE_CCB_ALLOCED		0x20	/* CCB allocated */
94 
95 struct twe_attach_args {
96 	int		twea_unit;
97 };
98 
99 #define	tweacf_unit	cf_loc[TWECF_UNIT]
100 
101 int	twe_ccb_alloc(struct twe_softc *, struct twe_ccb **, int);
102 void	twe_ccb_enqueue(struct twe_softc *sc, struct twe_ccb *ccb);
103 void	twe_ccb_free(struct twe_softc *sc, struct twe_ccb *);
104 int	twe_ccb_map(struct twe_softc *, struct twe_ccb *);
105 int	twe_ccb_poll(struct twe_softc *, struct twe_ccb *, int);
106 int	twe_ccb_submit(struct twe_softc *, struct twe_ccb *);
107 void	twe_ccb_unmap(struct twe_softc *, struct twe_ccb *);
108 
109 static __inline__ size_t twe_get_maxsegs(void) {
110 	size_t max_segs = ((MAXPHYS + PAGE_SIZE - 1) / PAGE_SIZE) + 1;
111 #ifdef TWE_SG_SIZE
112 	if (TWE_SG_SIZE < max_segs)
113 	    max_segs = TWE_SG_SIZE;
114 #endif
115 	return max_segs;
116 }
117 
118 static __inline__ size_t twe_get_maxxfer(size_t maxsegs) {
119 	return (maxsegs - 1) * PAGE_SIZE;
120 }
121 
122 #endif	/* !_PCI_TWEVAR_H_ */
123