xref: /openbmc/linux/include/sound/mpu401.h (revision b415ed45)
1 #ifndef __SOUND_MPU401_H
2 #define __SOUND_MPU401_H
3 
4 /*
5  *  Header file for MPU-401 and compatible cards
6  *  Copyright (c) by Jaroslav Kysela <perex@perex.cz>
7  *
8  *
9  *   This program is free software; you can redistribute it and/or modify
10  *   it under the terms of the GNU General Public License as published by
11  *   the Free Software Foundation; either version 2 of the License, or
12  *   (at your option) any later version.
13  *
14  *   This program is distributed in the hope that it will be useful,
15  *   but WITHOUT ANY WARRANTY; without even the implied warranty of
16  *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
17  *   GNU General Public License for more details.
18  *
19  *   You should have received a copy of the GNU General Public License
20  *   along with this program; if not, write to the Free Software
21  *   Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307 USA
22  *
23  */
24 
25 #include "rawmidi.h"
26 #include <linux/interrupt.h>
27 
28 #define MPU401_HW_MPU401		1	/* native MPU401 */
29 #define MPU401_HW_SB			2	/* SoundBlaster MPU-401 UART */
30 #define MPU401_HW_ES1688		3	/* AudioDrive ES1688 MPU-401 UART */
31 #define MPU401_HW_OPL3SA2		4	/* Yamaha OPL3-SA2 */
32 #define MPU401_HW_SONICVIBES		5	/* S3 SonicVibes */
33 #define MPU401_HW_CS4232		6	/* CS4232 */
34 #define MPU401_HW_ES18XX		7	/* AudioDrive ES18XX MPU-401 UART */
35 #define MPU401_HW_FM801			8	/* ForteMedia FM801 */
36 #define MPU401_HW_TRID4DWAVE		9	/* Trident 4DWave */
37 #define MPU401_HW_AZT2320		10	/* Aztech AZT2320 */
38 #define MPU401_HW_ALS100		11	/* Avance Logic ALS100 */
39 #define MPU401_HW_ICE1712		12	/* Envy24 */
40 #define MPU401_HW_VIA686A		13	/* VIA 82C686A */
41 #define MPU401_HW_YMFPCI		14	/* YMF DS-XG PCI */
42 #define MPU401_HW_CMIPCI		15	/* CMIPCI MPU-401 UART */
43 #define MPU401_HW_ALS4000		16	/* Avance Logic ALS4000 */
44 #define MPU401_HW_INTEL8X0		17	/* Intel8x0 driver */
45 #define MPU401_HW_PC98II		18	/* Roland PC98II */
46 #define MPU401_HW_AUREAL		19	/* Aureal Vortex */
47 
48 #define MPU401_INFO_INPUT	(1 << 0)	/* input stream */
49 #define MPU401_INFO_OUTPUT	(1 << 1)	/* output stream */
50 #define MPU401_INFO_INTEGRATED	(1 << 2)	/* integrated h/w port */
51 #define MPU401_INFO_MMIO	(1 << 3)	/* MMIO access */
52 #define MPU401_INFO_TX_IRQ	(1 << 4)	/* independent TX irq */
53 
54 #define MPU401_MODE_BIT_INPUT		0
55 #define MPU401_MODE_BIT_OUTPUT		1
56 #define MPU401_MODE_BIT_INPUT_TRIGGER	2
57 #define MPU401_MODE_BIT_OUTPUT_TRIGGER	3
58 
59 #define MPU401_MODE_INPUT		(1<<MPU401_MODE_BIT_INPUT)
60 #define MPU401_MODE_OUTPUT		(1<<MPU401_MODE_BIT_OUTPUT)
61 #define MPU401_MODE_INPUT_TRIGGER	(1<<MPU401_MODE_BIT_INPUT_TRIGGER)
62 #define MPU401_MODE_OUTPUT_TRIGGER	(1<<MPU401_MODE_BIT_OUTPUT_TRIGGER)
63 
64 #define MPU401_MODE_INPUT_TIMER		(1<<0)
65 #define MPU401_MODE_OUTPUT_TIMER	(1<<1)
66 
67 struct snd_mpu401 {
68 	struct snd_rawmidi *rmidi;
69 
70 	unsigned short hardware;	/* MPU401_HW_XXXX */
71 	unsigned int info_flags;	/* MPU401_INFO_XXX */
72 	unsigned long port;		/* base port of MPU-401 chip */
73 	unsigned long cport;		/* port + 1 (usually) */
74 	struct resource *res;		/* port resource */
75 	int irq;			/* IRQ number of MPU-401 chip (-1 = poll) */
76 	int irq_flags;
77 
78 	unsigned long mode;		/* MPU401_MODE_XXXX */
79 	int timer_invoked;
80 
81 	int (*open_input) (struct snd_mpu401 * mpu);
82 	void (*close_input) (struct snd_mpu401 * mpu);
83 	int (*open_output) (struct snd_mpu401 * mpu);
84 	void (*close_output) (struct snd_mpu401 * mpu);
85 	void *private_data;
86 
87 	struct snd_rawmidi_substream *substream_input;
88 	struct snd_rawmidi_substream *substream_output;
89 
90 	spinlock_t input_lock;
91 	spinlock_t output_lock;
92 	spinlock_t timer_lock;
93 
94 	struct timer_list timer;
95 
96 	void (*write) (struct snd_mpu401 * mpu, unsigned char data, unsigned long addr);
97 	unsigned char (*read) (struct snd_mpu401 *mpu, unsigned long addr);
98 };
99 
100 /* I/O ports */
101 
102 #define MPU401C(mpu) (mpu)->cport
103 #define MPU401D(mpu) (mpu)->port
104 
105 /*
106  * control register bits
107  */
108 /* read MPU401C() */
109 #define MPU401_RX_EMPTY		0x80
110 #define MPU401_TX_FULL		0x40
111 
112 /* write MPU401C() */
113 #define MPU401_RESET		0xff
114 #define MPU401_ENTER_UART	0x3f
115 
116 /* read MPU401D() */
117 #define MPU401_ACK		0xfe
118 
119 
120 /*
121 
122  */
123 
124 irqreturn_t snd_mpu401_uart_interrupt(int irq, void *dev_id);
125 irqreturn_t snd_mpu401_uart_interrupt_tx(int irq, void *dev_id);
126 
127 int snd_mpu401_uart_new(struct snd_card *card,
128 			int device,
129 			unsigned short hardware,
130 			unsigned long port,
131 			unsigned int info_flags,
132 			int irq,
133 			int irq_flags,
134 			struct snd_rawmidi ** rrawmidi);
135 
136 #endif /* __SOUND_MPU401_H */
137