Merge isaki-audio2 branch, the overhaul of audio subsystem.
- Interrupt-oriented system rather than thread-oriented.
- Improve stability, quality and performance.
- Split playback and record cleanly. Improve halfduplex support.
- Many bugs are fixed including deadlocks, resource leaks, abuses, etc.
- Simplify audio filter mechanism. The encoding/channels/frequency
conversions are completely handled in the upper layer. So the hard-
ware driver only converts its hardware encoding (if necessary).
- audio_hw_if changes:
- Obsoletes query_encoding and add query_format instead.
- Obsoletes set_params and add set_format instead.
- Remove drain, setfd, mappage.
- The call sequences are changed.
- ioctl AUDIO_GETFD/SETFD, AUDIO_GETCHAN/SETCHAN are obsoleted.
- ioctl AUDIO_{QUERY,GET,SET}FORMAT are introduced.
- cleanup config attributes: au*conv and mulaw.
- All hardware drivers should follow it (I've done as much as possible).

Some file paths are changed:
- dev/audio.c -> dev/audio/audio.c (rewritten)
- dev/audiovar.h -> dev/audio/audiovar.h
- dev/audio_dai.h -> dev/audio/audio_dai.h
- dev/audio_if.h -> dev/audio/audio_if.h
- dev/audiobell.c -> dev/audio/audiobell.c
- dev/audiobellvar.h -> dev/audio/audiobellvar.h
- dev/mulaw.[ch] -> dev/audio/mulaw.[ch] + dev/audio/alaw.c

branches: 1.38.2;
Use C99 style struct initializer to audio_hw_if.

Make it compilable with AUDIODEBUG

branches: 1.36.4;
cs4231_ebus_round_blocksize: never return 0 as blocksize

branches: 1.35.8; 1.35.26; 1.35.30; 1.35.34;
Merge jmcneill-audiomp3 branch, which is derived from ad-audiomp2. From
the original ad-audiomp branch notes:

Add MP locking to the audio drivers.

Making the audio drivers MP safe is necessary before efforts
can be made to make the VM system MP safe.

The are two locks per device instance, an ISR lock and
a character device lock. The ISR lock replaces calls to
splaudio()/splx(), and will be held across calls to device
methods which were called at splaudio() before (e.g.
trigger_output). The character device lock is held across
calls to nearly all of the methods, excluding some only
used for initialization, e.g. get_locks.

Welcome to 5.99.57.

branches: 1.34.2; 1.34.4;
split audiocs

branches: 1.33.4; 1.33.6; 1.33.10;
struct device * -> device_t, no functional changes intended.

struct cfdata * -> cfdata_t, no functional changes intended.

branches: 1.31.2;
Make it attach on JavaStation KRUPS again

use the prom addresses except on MSIIEP.

this probably works on SB2000 now.

make this compile

replace bitmask_snprintf(9) with snprintb(3)

also attach if the "compatible" property matches, as seen on sb2000.

branches: 1.26.6; 1.26.8;
Replicate sbus fixes for PR kern/37540.

branches: 1.25.2; 1.25.4;
use aprint_*_dev and device_xname

branches: 1.24.14;
Interrupt handling changes, in discussion since February:

- Reduce available SPL levels for hardware devices to none, vm, sched, high.
- Acquire kernel_lock only for interrupts at IPL_VM.
- Implement threaded soft interrupts.

branches: 1.23.2;
machine/{bus,cpu,intr}.h -> sys/{bus,cpu,intr}.h

branches: 1.22.6; 1.22.8; 1.22.22; 1.22.24; 1.22.28;
Add missing initializer

branches: 1.21.8; 1.21.10;
integrate kauth.

Use device_private().

branches: 1.19.4; 1.19.6; 1.19.8; 1.19.10; 1.19.12;
merge ktrace-lwp.

branches: 1.18.4;
nuke trailing whitespace

branches: 1.17.2; 1.17.4;
ansify and KNF

fix compilation errors

merge kent-audio1 branch, which introduces audio filter pipeline to the MI
audio framework


Summary of changes:

* struct audio_params
- remove sw_code, factor, factor_denom, hw_sample_rate,
hw_encoding ,hw_precision, and hw_channels. Conversion information
is conveyed by stream_filter_list_t.
- change the type of sample_rate: u_long -> u_int
- add `validbits,' which represents the valid data size in
precision bits. It is required in order to distinguish 24/32bit
from 24/24bit or 32/32bit.

* audio_hw_if
- add two parameters to set_params()
stream_filter_list_t *pfil, stream_filter_list *rfil
A HW driver should set filter recipes for requested formats
- constify audio_params parameters of trigger_output() and
trigger_input(). They represent audio formats for the hardware.
- make open() and close() optional
- add int (AUMODE_PLAY or AUMODE_RECORD) and audio_params_t parameters
to round_blocksize()

* sw_code is replaced with stream_filter_t.
stream_filer_t converts audio data in an input buffer and writes
into another output buffer unlike sw_code, which converts data in
single buffer.
converters in dev/auconv.c, dev/mulaw.c, dev/aurateconv.c,
dev/tc/bba.c, dev/ic/msm6258.c, and arch/arm/iomd/vidcaudio.c are
reimplemented as stream_filter_t

* MI audio
- audiosetinfo() builds filter pipelines from stream_filter_list_t
filled by audio_hw_if::set_params()
- audiosetinfo() returns with EINVAL if mmapped and set_params()
requests filters
- audio_write(), audio_pint(), and audio_rint() invoke a filter
pipeline.
- ioctl() for FIONREAD, AUDIO_WSEEK, AUDIO_GETIOFFS,
AUDIO_GETOOFFS, and audio_prinfo::{seek,samples} for
AUDIO_GETINFO handle values for a buffer nearest to userland.

* add `struct device *' parameter to ac97_attach()

* all of audio HW drivers follow audio_hw_if and ac97 changes

branches: 1.14.2;
constify audio_hw_if, midi_hw_if, and radio_hw_if.

Use EBDMA_BURST_SIZE_16. Introduce EBus specific round_blocksize to
make block size multiple of 16 words. No point in using
round_buffersize that returns the argument unchanged, so just NULL it
in audio_hw_if.

add missing __KERNEL_RCSID()

branches: 1.11.2;
DMA, not dma nor Dma.

Remove the `flags' argument from bus_intr_establish().

Add trailing ; to CFATTACH_DECL.

Use CFATTACH_DECL().

Declare all cfattach structures const.

branches: 1.6.6;
Prettify error message.

branches: 1.5.2;
Fix some handle/tag confusion. This makes it compile on sparc64 again.

Since sparc ignores tag's (/brick sparc) this slipped through when testing
on sparc.

Do not even bother trying to use the mappings provided by the PROM.

Drop BUS_SPACE_MAP_LINEAR and properly bus_space_*-ify this so that it
uses accessors. Requested by eeh.

Fix whitespace nits (oops).

Rework the driver to add EBus DMA support and improve APC DMA support.
Audio-related stuff is left almost intact.

* support audiocs at ebus playback and capture
tested on krups and u5 (thanks, martin)
* make first attempt at supporting audiocs at sbus capture
* nb: full-duplex is not tested
* while here, fix CSAUDIO_MONITOR_MUTE to be of CSAUDIO_MONITOR_CLASS
i.e. outputs.monitor.mute -> monitor.monitor.mute

Ok by pk, eeh.

branches: 1.38.2;
Use C99 style struct initializer to audio_hw_if.

Make it compilable with AUDIODEBUG

branches: 1.36.4;
cs4231_ebus_round_blocksize: never return 0 as blocksize

branches: 1.35.8; 1.35.26; 1.35.30; 1.35.34;
Merge jmcneill-audiomp3 branch, which is derived from ad-audiomp2. From
the original ad-audiomp branch notes:

Add MP locking to the audio drivers.

Making the audio drivers MP safe is necessary before efforts
can be made to make the VM system MP safe.

The are two locks per device instance, an ISR lock and
a character device lock. The ISR lock replaces calls to
splaudio()/splx(), and will be held across calls to device
methods which were called at splaudio() before (e.g.
trigger_output). The character device lock is held across
calls to nearly all of the methods, excluding some only
used for initialization, e.g. get_locks.

Welcome to 5.99.57.

branches: 1.34.2; 1.34.4;
split audiocs

branches: 1.33.4; 1.33.6; 1.33.10;
struct device * -> device_t, no functional changes intended.

struct cfdata * -> cfdata_t, no functional changes intended.

branches: 1.31.2;
Make it attach on JavaStation KRUPS again

use the prom addresses except on MSIIEP.

this probably works on SB2000 now.

make this compile

replace bitmask_snprintf(9) with snprintb(3)

also attach if the "compatible" property matches, as seen on sb2000.

branches: 1.26.6; 1.26.8;
Replicate sbus fixes for PR kern/37540.

branches: 1.25.2; 1.25.4;
use aprint_*_dev and device_xname

branches: 1.24.14;
Interrupt handling changes, in discussion since February:

- Reduce available SPL levels for hardware devices to none, vm, sched, high.
- Acquire kernel_lock only for interrupts at IPL_VM.
- Implement threaded soft interrupts.

branches: 1.23.2;
machine/{bus,cpu,intr}.h -> sys/{bus,cpu,intr}.h

branches: 1.22.6; 1.22.8; 1.22.22; 1.22.24; 1.22.28;
Add missing initializer

branches: 1.21.8; 1.21.10;
integrate kauth.

Use device_private().

branches: 1.19.4; 1.19.6; 1.19.8; 1.19.10; 1.19.12;
merge ktrace-lwp.

branches: 1.18.4;
nuke trailing whitespace

branches: 1.17.2; 1.17.4;
ansify and KNF

fix compilation errors

merge kent-audio1 branch, which introduces audio filter pipeline to the MI
audio framework


Summary of changes:

* struct audio_params
- remove sw_code, factor, factor_denom, hw_sample_rate,
hw_encoding ,hw_precision, and hw_channels. Conversion information
is conveyed by stream_filter_list_t.
- change the type of sample_rate: u_long -> u_int
- add `validbits,' which represents the valid data size in
precision bits. It is required in order to distinguish 24/32bit
from 24/24bit or 32/32bit.

* audio_hw_if
- add two parameters to set_params()
stream_filter_list_t *pfil, stream_filter_list *rfil
A HW driver should set filter recipes for requested formats
- constify audio_params parameters of trigger_output() and
trigger_input(). They represent audio formats for the hardware.
- make open() and close() optional
- add int (AUMODE_PLAY or AUMODE_RECORD) and audio_params_t parameters
to round_blocksize()

* sw_code is replaced with stream_filter_t.
stream_filer_t converts audio data in an input buffer and writes
into another output buffer unlike sw_code, which converts data in
single buffer.
converters in dev/auconv.c, dev/mulaw.c, dev/aurateconv.c,
dev/tc/bba.c, dev/ic/msm6258.c, and arch/arm/iomd/vidcaudio.c are
reimplemented as stream_filter_t

* MI audio
- audiosetinfo() builds filter pipelines from stream_filter_list_t
filled by audio_hw_if::set_params()
- audiosetinfo() returns with EINVAL if mmapped and set_params()
requests filters
- audio_write(), audio_pint(), and audio_rint() invoke a filter
pipeline.
- ioctl() for FIONREAD, AUDIO_WSEEK, AUDIO_GETIOFFS,
AUDIO_GETOOFFS, and audio_prinfo::{seek,samples} for
AUDIO_GETINFO handle values for a buffer nearest to userland.

* add `struct device *' parameter to ac97_attach()

* all of audio HW drivers follow audio_hw_if and ac97 changes

branches: 1.14.2;
constify audio_hw_if, midi_hw_if, and radio_hw_if.

Use EBDMA_BURST_SIZE_16. Introduce EBus specific round_blocksize to
make block size multiple of 16 words. No point in using
round_buffersize that returns the argument unchanged, so just NULL it
in audio_hw_if.

add missing __KERNEL_RCSID()

branches: 1.11.2;
DMA, not dma nor Dma.

Remove the `flags' argument from bus_intr_establish().

Add trailing ; to CFATTACH_DECL.

Use CFATTACH_DECL().

Declare all cfattach structures const.

branches: 1.6.6;
Prettify error message.

branches: 1.5.2;
Fix some handle/tag confusion. This makes it compile on sparc64 again.

Since sparc ignores tag's (/brick sparc) this slipped through when testing
on sparc.

Do not even bother trying to use the mappings provided by the PROM.

Drop BUS_SPACE_MAP_LINEAR and properly bus_space_*-ify this so that it
uses accessors. Requested by eeh.

Fix whitespace nits (oops).

Rework the driver to add EBus DMA support and improve APC DMA support.
Audio-related stuff is left almost intact.

* support audiocs at ebus playback and capture
tested on krups and u5 (thanks, martin)
* make first attempt at supporting audiocs at sbus capture
* nb: full-duplex is not tested
* while here, fix CSAUDIO_MONITOR_MUTE to be of CSAUDIO_MONITOR_CLASS
i.e. outputs.monitor.mute -> monitor.monitor.mute

Ok by pk, eeh.