xref: /netbsd-src/sys/dev/ic/cs4231var.h (revision 23c8222edbfb0f0932d88a8351d3a0cf817dfb9e)
1 /*	$NetBSD: cs4231var.h,v 1.5 2004/07/09 02:08:33 mycroft Exp $	*/
2 
3 /*-
4  * Copyright (c) 1998, 1999 The NetBSD Foundation, Inc.
5  * All rights reserved.
6  *
7  * This code is derived from software contributed to The NetBSD Foundation
8  * by Paul Kranenburg.
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 _DEV_IC_CS4231VAR_H_
40 #define _DEV_IC_CS4231VAR_H_
41 
42 #define AUDIOCS_PROM_NAME	"SUNW,CS4231"
43 
44 /*
45  * List of device memory allocations (see cs4231_malloc/cs4231_free).
46  */
47 struct cs_dma {
48 	struct	cs_dma	*next;
49 	caddr_t		addr;
50 	bus_dmamap_t	dmamap;
51 	bus_dma_segment_t segs[1];
52 	int		nsegs;
53 	size_t		size;
54 };
55 
56 
57 /*
58  * DMA transfer to/from CS4231.
59  */
60 struct cs_transfer {
61 	int t_active;		/* this transfer is currently active */
62 	struct cs_dma *t_dma;	/* dma memory to transfer from/to */
63 	vsize_t t_segsz;	/* size of the segment */
64 	vsize_t t_blksz;	/* call audio(9) after this many bytes */
65 	vsize_t t_cnt;		/* how far are we into the segment */
66 
67 	void (*t_intr)(void*);	/* audio(9) callback */
68 	void *t_arg;
69 
70 	const char *t_name;	/* for error/debug messages */
71 
72 	struct evcnt t_intrcnt;
73 	struct evcnt t_ierrcnt;
74 };
75 
76 
77 /*
78  * Software state, per CS4231 audio chip.
79  */
80 struct cs4231_softc {
81 	struct ad1848_softc sc_ad1848;	/* base device */
82 
83 	bus_space_tag_t	sc_bustag;
84 	bus_dma_tag_t sc_dmatag;
85 
86 	struct cs_dma *sc_dmas;		/* allocated dma resources */
87 
88 	struct evcnt sc_intrcnt;	/* parent counter */
89 
90 	struct cs_transfer sc_playback;
91 	struct cs_transfer sc_capture;
92 };
93 
94 
95 /*
96  * Bus independent code shared by sbus and ebus attachments.
97  */
98 void	cs4231_common_attach(struct cs4231_softc *, bus_space_handle_t);
99 int	cs4231_transfer_init(struct cs4231_softc *, struct cs_transfer *,
100 			     bus_addr_t *, bus_size_t *,
101 			     void *, void *, int, void (*)(void *), void *);
102 void	cs4231_transfer_advance(struct cs_transfer *,
103 				bus_addr_t *, bus_size_t *);
104 
105 
106 /*
107  * Bus independent audio(9) methods.
108  */
109 int	cs4231_open(void *, int);
110 void	cs4231_close(void *);
111 int	cs4231_getdev(void *, struct audio_device *);
112 int	cs4231_set_port(void *, mixer_ctrl_t *);
113 int	cs4231_get_port(void *, mixer_ctrl_t *);
114 int	cs4231_query_devinfo(void *, mixer_devinfo_t *);
115 int	cs4231_get_props(void *);
116 
117 void	*cs4231_malloc(void *, int, size_t, struct malloc_type *, int);
118 void	cs4231_free(void *, void *, struct malloc_type *);
119 
120 #endif /* _DEV_IC_CS4231VAR_H_ */
121