xref: /netbsd-src/sys/arch/x68k/dev/dmacvar.h (revision aaf4ece63a859a04e37cf3a7229b5fab0157cc06)
1 /*	$NetBSD: dmacvar.h,v 1.7 2005/12/11 12:19:37 christos Exp $	*/
2 
3 /*-
4  * Copyright (c) 1997, 1998 The NetBSD Foundation, Inc.
5  * All rights reserved.
6  *
7  * This code is derived from software contributed to The NetBSD Foundation
8  * by Minoura Makoto.
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 /*
40  * Hitachi HD63450 (= Motorola MC68450) DMAC driver for x68k.
41  */
42 
43 #include <dev/ic/mc68450reg.h>
44 #include <machine/bus.h>
45 
46 #define DMAC_MAPSIZE 64
47 
48 typedef int (*dmac_intr_handler_t)(void *);
49 
50 /*
51  * Structure that describes a single transfer.
52  */
53 struct dmac_channel_stat;
54 struct dmac_dma_xfer {
55 	struct dmac_channel_stat *dx_channel;
56 	bus_dmamap_t	dx_dmamap;	/* dmamap tag */
57 	bus_dma_tag_t	dx_tag;		/* dma tag for the transfer */
58 	int		dx_ocr;		/* direction */
59 	int		dx_scr;		/* SCR value */
60 	void		*dx_device;	/* (initial) device address */
61 #ifdef DMAC_ARRAYCHAIN
62 	struct dmac_sg_array *dx_array;	/* DMAC array chain */
63 	int		dx_done;
64 #endif
65 	int		dx_nextoff;	/* for continued operation */
66 	int		dx_nextsize;
67 };
68 
69 /*
70  * Struct that holds the channel status.
71  * Embedded in the device softc for each channel.
72  */
73 struct dmac_channel_stat {
74 	int			ch_channel; /* channel number */
75 	char			ch_name[8]; /* user device name */
76 	bus_space_handle_t	ch_bht;	/* bus_space handle */
77 	int			ch_dcr;	/* device description */
78 	int			ch_ocr;	/* operation size, request mode */
79 	int			ch_normalv; /* normal interrupt vector */
80 	int			ch_errorv; /* error interrupt vector */
81 	dmac_intr_handler_t	ch_normal; /* normal interrupt handler */
82 	dmac_intr_handler_t	ch_error; /* error interrupt handler */
83 	void			*ch_normalarg;
84 	void			*ch_errorarg;
85 	struct dmac_dma_xfer	ch_xfer;
86 	struct dmac_sg_array	*ch_map; /* transfer map for arraychain mode */
87 	bus_dma_segment_t	ch_seg[1];
88 	struct device		*ch_softc; /* device softc link */
89 };
90 
91 /*
92  * DMAC softc
93  */
94 struct dmac_softc {
95 	struct device		sc_dev;
96 
97 	bus_space_tag_t		sc_bst;
98 	bus_space_handle_t	sc_bht;
99 
100 	struct dmac_channel_stat sc_channels[DMAC_NCHAN];
101 };
102 
103 
104 #define DMAC_ADDR	0xe84000
105 
106 #define DMAC_MAXSEGSZ	0xff00
107 #define DMAC_BOUNDARY	0
108 
109 struct dmac_channel_stat *dmac_alloc_channel(struct device *, int, const char *,
110 	int, dmac_intr_handler_t, void *, int, dmac_intr_handler_t, void *);
111 		/* ch, name, normalv, normal, errorv, error */
112 int dmac_free_channel(struct device *, int, void *);
113 		/* ch, channel */
114 struct dmac_dma_xfer *dmac_alloc_xfer(struct dmac_channel_stat *,
115 	bus_dma_tag_t, bus_dmamap_t);
116 int dmac_load_xfer(struct device *, struct dmac_dma_xfer *);
117 
118 int dmac_start_xfer(struct device *, struct dmac_dma_xfer *);
119 int dmac_start_xfer_offset(struct device *, struct dmac_dma_xfer *,
120 	u_int, u_int);
121 int dmac_abort_xfer(struct device *, struct dmac_dma_xfer *);
122 /* Compatibility function: alloc, fill defaults, load */
123 struct dmac_dma_xfer *dmac_prepare_xfer(struct dmac_channel_stat *,
124 	bus_dma_tag_t, bus_dmamap_t, int, int, void *);
125 	/* chan, dmat, map, dir, sequence, dar */
126