2019-05-27 14:55:05 +08:00
|
|
|
/* SPDX-License-Identifier: GPL-2.0-or-later */
|
2005-04-17 06:20:36 +08:00
|
|
|
#ifndef __SOUND_MPU401_H
|
|
|
|
|
#define __SOUND_MPU401_H
|
|
|
|
|
|
|
|
|
|
/*
|
|
|
|
|
* Header file for MPU-401 and compatible cards
|
2007-10-15 15:50:19 +08:00
|
|
|
* Copyright (c) by Jaroslav Kysela <perex@perex.cz>
|
2005-04-17 06:20:36 +08:00
|
|
|
*/
|
|
|
|
|
|
2012-10-03 01:01:25 +08:00
|
|
|
#include <sound/rawmidi.h>
|
2005-04-17 06:20:36 +08:00
|
|
|
#include <linux/interrupt.h>
|
|
|
|
|
|
|
|
|
|
#define MPU401_HW_MPU401 1 /* native MPU401 */
|
|
|
|
|
#define MPU401_HW_SB 2 /* SoundBlaster MPU-401 UART */
|
|
|
|
|
#define MPU401_HW_ES1688 3 /* AudioDrive ES1688 MPU-401 UART */
|
|
|
|
|
#define MPU401_HW_OPL3SA2 4 /* Yamaha OPL3-SA2 */
|
|
|
|
|
#define MPU401_HW_SONICVIBES 5 /* S3 SonicVibes */
|
|
|
|
|
#define MPU401_HW_CS4232 6 /* CS4232 */
|
|
|
|
|
#define MPU401_HW_ES18XX 7 /* AudioDrive ES18XX MPU-401 UART */
|
|
|
|
|
#define MPU401_HW_FM801 8 /* ForteMedia FM801 */
|
|
|
|
|
#define MPU401_HW_TRID4DWAVE 9 /* Trident 4DWave */
|
|
|
|
|
#define MPU401_HW_AZT2320 10 /* Aztech AZT2320 */
|
|
|
|
|
#define MPU401_HW_ALS100 11 /* Avance Logic ALS100 */
|
|
|
|
|
#define MPU401_HW_ICE1712 12 /* Envy24 */
|
|
|
|
|
#define MPU401_HW_VIA686A 13 /* VIA 82C686A */
|
|
|
|
|
#define MPU401_HW_YMFPCI 14 /* YMF DS-XG PCI */
|
|
|
|
|
#define MPU401_HW_CMIPCI 15 /* CMIPCI MPU-401 UART */
|
|
|
|
|
#define MPU401_HW_ALS4000 16 /* Avance Logic ALS4000 */
|
|
|
|
|
#define MPU401_HW_INTEL8X0 17 /* Intel8x0 driver */
|
|
|
|
|
#define MPU401_HW_PC98II 18 /* Roland PC98II */
|
|
|
|
|
#define MPU401_HW_AUREAL 19 /* Aureal Vortex */
|
|
|
|
|
|
2006-05-23 19:24:30 +08:00
|
|
|
#define MPU401_INFO_INPUT (1 << 0) /* input stream */
|
|
|
|
|
#define MPU401_INFO_OUTPUT (1 << 1) /* output stream */
|
|
|
|
|
#define MPU401_INFO_INTEGRATED (1 << 2) /* integrated h/w port */
|
|
|
|
|
#define MPU401_INFO_MMIO (1 << 3) /* MMIO access */
|
|
|
|
|
#define MPU401_INFO_TX_IRQ (1 << 4) /* independent TX irq */
|
ALSA: mpu401: clean up interrupt specification
The semantics of snd_mpu401_uart_new()'s interrupt parameters are
somewhat counterintuitive: To prevent the function from allocating its
own interrupt, either the irq number must be invalid, or the irq_flags
parameter must be zero. At the same time, the irq parameter being
invalid specifies that the mpu401 code has to work without an interrupt
allocated by the caller. This implies that, if there is an interrupt
and it is allocated by the caller, the irq parameter must be set to
a valid-looking number which then isn't actually used.
With the removal of IRQF_DISABLED, zero becomes a valid irq_flags value,
which forces us to handle the parameters differently.
This patch introduces a new flag MPU401_INFO_IRQ_HOOK for when the
device interrupt is handled by the caller, and makes the allocation of
the interrupt to depend only on the irq parameter. As suggested by
Takashi, the irq_flags parameter was dropped because, when used, it had
the constant value IRQF_DISABLED.
Signed-off-by: Clemens Ladisch <clemens@ladisch.de>
Signed-off-by: Takashi Iwai <tiwai@suse.de>
2011-09-13 17:24:41 +08:00
|
|
|
#define MPU401_INFO_IRQ_HOOK (1 << 5) /* mpu401 irq handler is called
|
|
|
|
|
from driver irq handler */
|
2008-04-25 15:13:45 +08:00
|
|
|
#define MPU401_INFO_NO_ACK (1 << 6) /* No ACK cmd needed */
|
ALSA: mpu401: clean up interrupt specification
The semantics of snd_mpu401_uart_new()'s interrupt parameters are
somewhat counterintuitive: To prevent the function from allocating its
own interrupt, either the irq number must be invalid, or the irq_flags
parameter must be zero. At the same time, the irq parameter being
invalid specifies that the mpu401 code has to work without an interrupt
allocated by the caller. This implies that, if there is an interrupt
and it is allocated by the caller, the irq parameter must be set to
a valid-looking number which then isn't actually used.
With the removal of IRQF_DISABLED, zero becomes a valid irq_flags value,
which forces us to handle the parameters differently.
This patch introduces a new flag MPU401_INFO_IRQ_HOOK for when the
device interrupt is handled by the caller, and makes the allocation of
the interrupt to depend only on the irq parameter. As suggested by
Takashi, the irq_flags parameter was dropped because, when used, it had
the constant value IRQF_DISABLED.
Signed-off-by: Clemens Ladisch <clemens@ladisch.de>
Signed-off-by: Takashi Iwai <tiwai@suse.de>
2011-09-13 17:24:41 +08:00
|
|
|
#define MPU401_INFO_USE_TIMER (1 << 15) /* internal */
|
2006-05-23 19:24:30 +08:00
|
|
|
|
2005-04-17 06:20:36 +08:00
|
|
|
#define MPU401_MODE_BIT_INPUT 0
|
|
|
|
|
#define MPU401_MODE_BIT_OUTPUT 1
|
|
|
|
|
#define MPU401_MODE_BIT_INPUT_TRIGGER 2
|
|
|
|
|
#define MPU401_MODE_BIT_OUTPUT_TRIGGER 3
|
|
|
|
|
|
|
|
|
|
#define MPU401_MODE_INPUT (1<<MPU401_MODE_BIT_INPUT)
|
|
|
|
|
#define MPU401_MODE_OUTPUT (1<<MPU401_MODE_BIT_OUTPUT)
|
|
|
|
|
#define MPU401_MODE_INPUT_TRIGGER (1<<MPU401_MODE_BIT_INPUT_TRIGGER)
|
|
|
|
|
#define MPU401_MODE_OUTPUT_TRIGGER (1<<MPU401_MODE_BIT_OUTPUT_TRIGGER)
|
|
|
|
|
|
|
|
|
|
#define MPU401_MODE_INPUT_TIMER (1<<0)
|
|
|
|
|
#define MPU401_MODE_OUTPUT_TIMER (1<<1)
|
|
|
|
|
|
2005-11-17 21:12:45 +08:00
|
|
|
struct snd_mpu401 {
|
|
|
|
|
struct snd_rawmidi *rmidi;
|
2005-04-17 06:20:36 +08:00
|
|
|
|
|
|
|
|
unsigned short hardware; /* MPU401_HW_XXXX */
|
2006-05-23 19:24:30 +08:00
|
|
|
unsigned int info_flags; /* MPU401_INFO_XXX */
|
2005-04-17 06:20:36 +08:00
|
|
|
unsigned long port; /* base port of MPU-401 chip */
|
|
|
|
|
unsigned long cport; /* port + 1 (usually) */
|
|
|
|
|
struct resource *res; /* port resource */
|
ALSA: mpu401: clean up interrupt specification
The semantics of snd_mpu401_uart_new()'s interrupt parameters are
somewhat counterintuitive: To prevent the function from allocating its
own interrupt, either the irq number must be invalid, or the irq_flags
parameter must be zero. At the same time, the irq parameter being
invalid specifies that the mpu401 code has to work without an interrupt
allocated by the caller. This implies that, if there is an interrupt
and it is allocated by the caller, the irq parameter must be set to
a valid-looking number which then isn't actually used.
With the removal of IRQF_DISABLED, zero becomes a valid irq_flags value,
which forces us to handle the parameters differently.
This patch introduces a new flag MPU401_INFO_IRQ_HOOK for when the
device interrupt is handled by the caller, and makes the allocation of
the interrupt to depend only on the irq parameter. As suggested by
Takashi, the irq_flags parameter was dropped because, when used, it had
the constant value IRQF_DISABLED.
Signed-off-by: Clemens Ladisch <clemens@ladisch.de>
Signed-off-by: Takashi Iwai <tiwai@suse.de>
2011-09-13 17:24:41 +08:00
|
|
|
int irq; /* IRQ number of MPU-401 chip */
|
2005-04-17 06:20:36 +08:00
|
|
|
|
|
|
|
|
unsigned long mode; /* MPU401_MODE_XXXX */
|
|
|
|
|
int timer_invoked;
|
|
|
|
|
|
2005-11-17 21:12:45 +08:00
|
|
|
int (*open_input) (struct snd_mpu401 * mpu);
|
|
|
|
|
void (*close_input) (struct snd_mpu401 * mpu);
|
|
|
|
|
int (*open_output) (struct snd_mpu401 * mpu);
|
|
|
|
|
void (*close_output) (struct snd_mpu401 * mpu);
|
2005-04-17 06:20:36 +08:00
|
|
|
void *private_data;
|
|
|
|
|
|
2005-11-17 21:12:45 +08:00
|
|
|
struct snd_rawmidi_substream *substream_input;
|
|
|
|
|
struct snd_rawmidi_substream *substream_output;
|
2005-04-17 06:20:36 +08:00
|
|
|
|
|
|
|
|
spinlock_t input_lock;
|
|
|
|
|
spinlock_t output_lock;
|
|
|
|
|
spinlock_t timer_lock;
|
|
|
|
|
|
|
|
|
|
struct timer_list timer;
|
|
|
|
|
|
2005-11-17 21:12:45 +08:00
|
|
|
void (*write) (struct snd_mpu401 * mpu, unsigned char data, unsigned long addr);
|
|
|
|
|
unsigned char (*read) (struct snd_mpu401 *mpu, unsigned long addr);
|
2005-04-17 06:20:36 +08:00
|
|
|
};
|
|
|
|
|
|
|
|
|
|
/* I/O ports */
|
|
|
|
|
|
|
|
|
|
#define MPU401C(mpu) (mpu)->cport
|
|
|
|
|
#define MPU401D(mpu) (mpu)->port
|
|
|
|
|
|
2008-04-23 23:47:28 +08:00
|
|
|
/*
|
|
|
|
|
* control register bits
|
|
|
|
|
*/
|
|
|
|
|
/* read MPU401C() */
|
|
|
|
|
#define MPU401_RX_EMPTY 0x80
|
|
|
|
|
#define MPU401_TX_FULL 0x40
|
|
|
|
|
|
|
|
|
|
/* write MPU401C() */
|
|
|
|
|
#define MPU401_RESET 0xff
|
|
|
|
|
#define MPU401_ENTER_UART 0x3f
|
|
|
|
|
|
|
|
|
|
/* read MPU401D() */
|
|
|
|
|
#define MPU401_ACK 0xfe
|
|
|
|
|
|
|
|
|
|
|
2005-04-17 06:20:36 +08:00
|
|
|
/*
|
|
|
|
|
|
|
|
|
|
*/
|
|
|
|
|
|
IRQ: Maintain regs pointer globally rather than passing to IRQ handlers
Maintain a per-CPU global "struct pt_regs *" variable which can be used instead
of passing regs around manually through all ~1800 interrupt handlers in the
Linux kernel.
The regs pointer is used in few places, but it potentially costs both stack
space and code to pass it around. On the FRV arch, removing the regs parameter
from all the genirq function results in a 20% speed up of the IRQ exit path
(ie: from leaving timer_interrupt() to leaving do_IRQ()).
Where appropriate, an arch may override the generic storage facility and do
something different with the variable. On FRV, for instance, the address is
maintained in GR28 at all times inside the kernel as part of general exception
handling.
Having looked over the code, it appears that the parameter may be handed down
through up to twenty or so layers of functions. Consider a USB character
device attached to a USB hub, attached to a USB controller that posts its
interrupts through a cascaded auxiliary interrupt controller. A character
device driver may want to pass regs to the sysrq handler through the input
layer which adds another few layers of parameter passing.
I've build this code with allyesconfig for x86_64 and i386. I've runtested the
main part of the code on FRV and i386, though I can't test most of the drivers.
I've also done partial conversion for powerpc and MIPS - these at least compile
with minimal configurations.
This will affect all archs. Mostly the changes should be relatively easy.
Take do_IRQ(), store the regs pointer at the beginning, saving the old one:
struct pt_regs *old_regs = set_irq_regs(regs);
And put the old one back at the end:
set_irq_regs(old_regs);
Don't pass regs through to generic_handle_irq() or __do_IRQ().
In timer_interrupt(), this sort of change will be necessary:
- update_process_times(user_mode(regs));
- profile_tick(CPU_PROFILING, regs);
+ update_process_times(user_mode(get_irq_regs()));
+ profile_tick(CPU_PROFILING);
I'd like to move update_process_times()'s use of get_irq_regs() into itself,
except that i386, alone of the archs, uses something other than user_mode().
Some notes on the interrupt handling in the drivers:
(*) input_dev() is now gone entirely. The regs pointer is no longer stored in
the input_dev struct.
(*) finish_unlinks() in drivers/usb/host/ohci-q.c needs checking. It does
something different depending on whether it's been supplied with a regs
pointer or not.
(*) Various IRQ handler function pointers have been moved to type
irq_handler_t.
Signed-Off-By: David Howells <dhowells@redhat.com>
(cherry picked from 1b16e7ac850969f38b375e511e3fa2f474a33867 commit)
2006-10-05 21:55:46 +08:00
|
|
|
irqreturn_t snd_mpu401_uart_interrupt(int irq, void *dev_id);
|
|
|
|
|
irqreturn_t snd_mpu401_uart_interrupt_tx(int irq, void *dev_id);
|
2005-04-17 06:20:36 +08:00
|
|
|
|
2005-11-17 21:12:45 +08:00
|
|
|
int snd_mpu401_uart_new(struct snd_card *card,
|
2005-04-17 06:20:36 +08:00
|
|
|
int device,
|
|
|
|
|
unsigned short hardware,
|
|
|
|
|
unsigned long port,
|
2006-05-23 19:24:30 +08:00
|
|
|
unsigned int info_flags,
|
2005-04-17 06:20:36 +08:00
|
|
|
int irq,
|
2005-11-17 21:12:45 +08:00
|
|
|
struct snd_rawmidi ** rrawmidi);
|
2005-04-17 06:20:36 +08:00
|
|
|
|
|
|
|
|
#endif /* __SOUND_MPU401_H */
|