esa(4): Use config_detach_children.

Clean get_props().
- Make get_props() return AUDIO_PROP_{PLAYBACK,CAPTURE} properly.
This eliminates need for audio.c to take care of such (old)
drivers which don't return both of PLAYBACK and CAPTURE.
- All get_props() doesn't need to return AUDIO_PROP_MMAP.
It is handled in the audio layer now.

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.63.2;
Use C99 style struct initializer to audio_hw_if.

use pci_intr_establish_xname() everywhere

branches: 1.61.8; 1.61.10;
remove checks for failure after memory allocation calls that cannot fail:

kmem_alloc() with KM_SLEEP
kmem_zalloc() with KM_SLEEP
percpu_alloc()
pserialize_create()
psref_class_create()

all of these paths include an assertion that the allocation has not failed,
so callers should not assert that again.

branches: 1.60.6;
make pci_intr_string and eisa_intr_string take a buffer and a length
instead of relying in local static storage.

- use proper types (uint16_t instead of uint32_t)
- don't index past the end of arrays
- use __arraycount() consistently instead of manual cruft.
- remove useless cast

branches: 1.58.6; 1.58.10;
Use pci_aprint_devinfo(9) instead of pci_devinfo+aprint_{normal,naive}
where it looks straightforward, and pci_aprint_devinfo_fancy in a few
others where drivers want to supply their own device names instead
of the pcidevs generated one. More complicated cases, where names
are composed at runtime, are left alone for now. It certainly makes
sense to simplify the drivers here rather than inventing a catch-all API.
This should serve as as example for new drivers, and also ensure
consistent output in the AB_QUIET ("boot -q") case. Also, it avoids
excessive stack usage where drivers attach child devices because the
buffer for the device name is not kept on the local stack anymore.

branches: 1.57.2;
the argument of esa_get_locks() is struct esa_voice *, not struct esa_softc *.

ok by mrg@ jmcneill@

put back IPL_AUDIO and splaudio(), at the request of rmind. they are
aliases and now we can easily revert audio to IPL_VM if necessary,
without having to revert the whole branch.

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.54.10; 1.54.12;
A pointer typedef entails trading too much flexibility to declare const
and non-const types, and the kernel uses both const and non-const
PMF qualifiers and device suspensors, so change the pmf_qual_t and
device_suspensor_t typedefs from "pointers to const" to non-pointer,
non-const types.

branches: 1.53.2;
Expand PMF_FN_* macros.

Cleanup interrupt establish error messages. Do not mix
aprint_error/aprint_normal/printf calls for a single line.

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

branches: 1.50.8; 1.50.10;
Fix a couple of mistakes in the device_t/softc split that cause
machines such as my HP Pavilion N3270 to freeze at boot. This
should fix PR kern/38815, too.

branches: 1.49.2;
Hook hardware volume buttons into pmf.

branches: 1.48.2; 1.48.4; 1.48.6;
Split device_t and softc

Use aprint_*_dev() instead of accessing struct device member dv_xname
directly.

pci_activate() expects for its void * argument to be a device_t,
so change the type of the argument to device_t. Update each use
of pci_activate().

Use device_t and accessors. Use aprint_*_dev().

Add methods for detaching self and for detaching children.

Use device_t and accessors. Use aprint_*_dev().

branches: 1.44.2; 1.44.6;
On resume, ensure that esa is powered up, and ensure we power the
AC97 codec once the host controller is up and running.

Merge jmcneill-pm branch.

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

branches: 1.41.2; 1.41.14; 1.41.16; 1.41.20;
Kill caddr_t; there will be some MI fallout, but it will be fixed shortly.

branches: 1.40.4; 1.40.6;
__unused removal on arguments; approved by core.

- sprinkle __unused on function decls.
- fix a couple of unused bugs
- no more -Wno-unused for i386

No need to call pci_set_powerstate from our powerhook, the bus handles this
for us now.

PR# 23620: channels are swapped

Add "name" parameter to powerhook_establish, to aid debugging. No objections
on tech-kern@

Formatting fixups, remove commented out code that should not have been here,
and remove a few unnecessary XXX comments.

branches: 1.34.2; 1.34.4;
missing comma

fix incomplete initializers

re-factor the pci powestate api. reviewed by gimpy

branches: 1.31.4; 1.31.8; 1.31.14; 1.31.16;
merge ktrace-lwp.

Wow, this is clearly wrong (found in esa_set_params):
if (p->channels < 1 && p->channels > 2)
return EINVAL;
Change the 'and' to an 'or' so the check actually does something.

branches: 1.29.2; 1.29.4;
Use ANSI function decls and static.

ansify and KNF

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.26.2;
constify audio_hw_if, midi_hw_if, and radio_hw_if.

ac97_host_if::reset() returns non-zero value if codec reset fails, and
ac97 is not attached in that case.

PR: kern/26973

- Don't hardcode buffer size and block size in esa_round_buffersize() and
esa_round_blocksize().
- Fix esa_trigger_output() and esa_trigger_input() to initialise the
channel's buffer/block size using the supplied parameters.
- While here, simplify esa_intr().

This gets kphone working on my esa(4)-equipped laptop.

pass string length (= boundary info) to pci_devinfo so that we do not run over
the end of memory region

branches: 1.22.2;
Fix uninitialized variable warnings

add missing __KERNEL_RCSID()

branches: 1.20.2;
Add extensible malloc types, adapted from FreeBSD. This turns
malloc types into a structure, a pointer to which is passed around,
instead of an int constant. Allow the limit to be adjusted when the
malloc type is defined, or with a function call, as suggested by
Jonathan Stone.

Use aprint_*().

Replace magic numbers for power management control with PCI_PMCSR* macros.

XXX Should we use pci_get_powerstate() and pci_set_powerstate() in pci.c?

Add trailing ; to CFATTACH_DECL.

Use CFATTACH_DECL().

Declare all cfattach structures const.

audit bitmask test mistake (s/&&/&/). from openbsd

Fix the mixer controls to work a bit better.

branches: 1.12.2;
Fix suspend/resume. Previously, suspending/resuming while playback was active
would either:

1. Cause the machine to stop responding, or
2. Cause the currently playing voices to stop output.

With this change, voices are stopped on suspend, and continue from where they
left off on resume.

Add multiple voice support to the ESS Allegro-1 / Maestro-3 family of
audio accelerators.

Mixing is done in hardware by the ASSP, but is limited to 4 simultaneous
channels due to the restricted "minisrc" image that we are currently
working with.

Due to limitations in the audio subsystem, I'm currently attaching multiple
'audio' devices to 'esa', one for each voice. Because of this hack, the
default ESA_NUM_VOICES is 1.

Correctly enable/disable the low-pass filter, depending on the sample rate.
This fixes timing issues when playing back at 48kHz (noticable using
pkgsrc/graphics/mplayer and DivX ;-) streams).

in esa_resume, call esa_codec_reset; makes it much more happy after a
suspend on my O500 (snatched from FreeBSD)

branches: 1.8.2;
free memory allocated for suspend save area in detach

Use standard PCI power management definitions from pcireg.h instead
of homegrown ones.

suggested by Soren

Every card I've seen has had their channels swapped with respect
to the mixer. Ie:
$ mixerctl -w outputs.master=0,191
Would result in the _right_ speaker being turned off.

So, we will swap the left and right mixer channels to compensate
for this.

Use malloc's M_ZERO flag instead of malloc/memset.

Add support for the driver to work after suspend/resume. Does nothing
fancy, works for the basic output case, but does not support programs
which use playback while going into suspend.

Sketched after code found in FreeBSD and Linux drivers.

branches: 1.3.2; 1.3.4;
Integrate recording support into the driver. Not very heavily tested yet.

Note that Don Kim wrote the original Linux driver.

Import driver for the ESS Allegro-1 / Maestro-3 based PCI Audio Accelerators.

Clean get_props().
- Make get_props() return AUDIO_PROP_{PLAYBACK,CAPTURE} properly.
This eliminates need for audio.c to take care of such (old)
drivers which don't return both of PLAYBACK and CAPTURE.
- All get_props() doesn't need to return AUDIO_PROP_MMAP.
It is handled in the audio layer now.

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.63.2;
Use C99 style struct initializer to audio_hw_if.

use pci_intr_establish_xname() everywhere

branches: 1.61.8;
remove checks for failure after memory allocation calls that cannot fail:

kmem_alloc() with KM_SLEEP
kmem_zalloc() with KM_SLEEP
percpu_alloc()
pserialize_create()
psref_class_create()

all of these paths include an assertion that the allocation has not failed,
so callers should not assert that again.

branches: 1.60.6;
make pci_intr_string and eisa_intr_string take a buffer and a length
instead of relying in local static storage.

- use proper types (uint16_t instead of uint32_t)
- don't index past the end of arrays
- use __arraycount() consistently instead of manual cruft.
- remove useless cast

branches: 1.58.6; 1.58.10;
Use pci_aprint_devinfo(9) instead of pci_devinfo+aprint_{normal,naive}
where it looks straightforward, and pci_aprint_devinfo_fancy in a few
others where drivers want to supply their own device names instead
of the pcidevs generated one. More complicated cases, where names
are composed at runtime, are left alone for now. It certainly makes
sense to simplify the drivers here rather than inventing a catch-all API.
This should serve as as example for new drivers, and also ensure
consistent output in the AB_QUIET ("boot -q") case. Also, it avoids
excessive stack usage where drivers attach child devices because the
buffer for the device name is not kept on the local stack anymore.

branches: 1.57.2;
the argument of esa_get_locks() is struct esa_voice *, not struct esa_softc *.

ok by mrg@ jmcneill@

put back IPL_AUDIO and splaudio(), at the request of rmind. they are
aliases and now we can easily revert audio to IPL_VM if necessary,
without having to revert the whole branch.

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.54.10; 1.54.12;
A pointer typedef entails trading too much flexibility to declare const
and non-const types, and the kernel uses both const and non-const
PMF qualifiers and device suspensors, so change the pmf_qual_t and
device_suspensor_t typedefs from "pointers to const" to non-pointer,
non-const types.

branches: 1.53.2;
Expand PMF_FN_* macros.

Cleanup interrupt establish error messages. Do not mix
aprint_error/aprint_normal/printf calls for a single line.

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

branches: 1.50.8; 1.50.10;
Fix a couple of mistakes in the device_t/softc split that cause
machines such as my HP Pavilion N3270 to freeze at boot. This
should fix PR kern/38815, too.

branches: 1.49.2;
Hook hardware volume buttons into pmf.

branches: 1.48.2; 1.48.4; 1.48.6;
Split device_t and softc

Use aprint_*_dev() instead of accessing struct device member dv_xname
directly.

pci_activate() expects for its void * argument to be a device_t,
so change the type of the argument to device_t. Update each use
of pci_activate().

Use device_t and accessors. Use aprint_*_dev().

Add methods for detaching self and for detaching children.

Use device_t and accessors. Use aprint_*_dev().

branches: 1.44.2; 1.44.6;
On resume, ensure that esa is powered up, and ensure we power the
AC97 codec once the host controller is up and running.

Merge jmcneill-pm branch.

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

branches: 1.41.2; 1.41.14; 1.41.16; 1.41.20;
Kill caddr_t; there will be some MI fallout, but it will be fixed shortly.

branches: 1.40.4; 1.40.6;
__unused removal on arguments; approved by core.

- sprinkle __unused on function decls.
- fix a couple of unused bugs
- no more -Wno-unused for i386

No need to call pci_set_powerstate from our powerhook, the bus handles this
for us now.

PR# 23620: channels are swapped

Add "name" parameter to powerhook_establish, to aid debugging. No objections
on tech-kern@

Formatting fixups, remove commented out code that should not have been here,
and remove a few unnecessary XXX comments.

branches: 1.34.2; 1.34.4;
missing comma

fix incomplete initializers

re-factor the pci powestate api. reviewed by gimpy

branches: 1.31.4; 1.31.8; 1.31.14; 1.31.16;
merge ktrace-lwp.

Wow, this is clearly wrong (found in esa_set_params):
if (p->channels < 1 && p->channels > 2)
return EINVAL;
Change the 'and' to an 'or' so the check actually does something.

branches: 1.29.2; 1.29.4;
Use ANSI function decls and static.

ansify and KNF

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.26.2;
constify audio_hw_if, midi_hw_if, and radio_hw_if.

ac97_host_if::reset() returns non-zero value if codec reset fails, and
ac97 is not attached in that case.

PR: kern/26973

- Don't hardcode buffer size and block size in esa_round_buffersize() and
esa_round_blocksize().
- Fix esa_trigger_output() and esa_trigger_input() to initialise the
channel's buffer/block size using the supplied parameters.
- While here, simplify esa_intr().

This gets kphone working on my esa(4)-equipped laptop.

pass string length (= boundary info) to pci_devinfo so that we do not run over
the end of memory region

branches: 1.22.2;
Fix uninitialized variable warnings

add missing __KERNEL_RCSID()

branches: 1.20.2;
Add extensible malloc types, adapted from FreeBSD. This turns
malloc types into a structure, a pointer to which is passed around,
instead of an int constant. Allow the limit to be adjusted when the
malloc type is defined, or with a function call, as suggested by
Jonathan Stone.

Use aprint_*().

Replace magic numbers for power management control with PCI_PMCSR* macros.

XXX Should we use pci_get_powerstate() and pci_set_powerstate() in pci.c?

Add trailing ; to CFATTACH_DECL.

Use CFATTACH_DECL().

Declare all cfattach structures const.

audit bitmask test mistake (s/&&/&/). from openbsd

Fix the mixer controls to work a bit better.

branches: 1.12.2;
Fix suspend/resume. Previously, suspending/resuming while playback was active
would either:

1. Cause the machine to stop responding, or
2. Cause the currently playing voices to stop output.

With this change, voices are stopped on suspend, and continue from where they
left off on resume.

Add multiple voice support to the ESS Allegro-1 / Maestro-3 family of
audio accelerators.

Mixing is done in hardware by the ASSP, but is limited to 4 simultaneous
channels due to the restricted "minisrc" image that we are currently
working with.

Due to limitations in the audio subsystem, I'm currently attaching multiple
'audio' devices to 'esa', one for each voice. Because of this hack, the
default ESA_NUM_VOICES is 1.

Correctly enable/disable the low-pass filter, depending on the sample rate.
This fixes timing issues when playing back at 48kHz (noticable using
pkgsrc/graphics/mplayer and DivX ;-) streams).

in esa_resume, call esa_codec_reset; makes it much more happy after a
suspend on my O500 (snatched from FreeBSD)

branches: 1.8.2;
free memory allocated for suspend save area in detach

Use standard PCI power management definitions from pcireg.h instead
of homegrown ones.

suggested by Soren

Every card I've seen has had their channels swapped with respect
to the mixer. Ie:
$ mixerctl -w outputs.master=0,191
Would result in the _right_ speaker being turned off.

So, we will swap the left and right mixer channels to compensate
for this.

Use malloc's M_ZERO flag instead of malloc/memset.

Add support for the driver to work after suspend/resume. Does nothing
fancy, works for the basic output case, but does not support programs
which use playback while going into suspend.

Sketched after code found in FreeBSD and Linux drivers.

branches: 1.3.2; 1.3.4;
Integrate recording support into the driver. Not very heavily tested yet.

Note that Don Kim wrote the original Linux driver.

Import driver for the ESS Allegro-1 / Maestro-3 based PCI Audio Accelerators.

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.63.2;
Use C99 style struct initializer to audio_hw_if.

use pci_intr_establish_xname() everywhere

branches: 1.61.8;
remove checks for failure after memory allocation calls that cannot fail:

kmem_alloc() with KM_SLEEP
kmem_zalloc() with KM_SLEEP
percpu_alloc()
pserialize_create()
psref_class_create()

all of these paths include an assertion that the allocation has not failed,
so callers should not assert that again.

branches: 1.60.6;
make pci_intr_string and eisa_intr_string take a buffer and a length
instead of relying in local static storage.

- use proper types (uint16_t instead of uint32_t)
- don't index past the end of arrays
- use __arraycount() consistently instead of manual cruft.
- remove useless cast

branches: 1.58.6; 1.58.10;
Use pci_aprint_devinfo(9) instead of pci_devinfo+aprint_{normal,naive}
where it looks straightforward, and pci_aprint_devinfo_fancy in a few
others where drivers want to supply their own device names instead
of the pcidevs generated one. More complicated cases, where names
are composed at runtime, are left alone for now. It certainly makes
sense to simplify the drivers here rather than inventing a catch-all API.
This should serve as as example for new drivers, and also ensure
consistent output in the AB_QUIET ("boot -q") case. Also, it avoids
excessive stack usage where drivers attach child devices because the
buffer for the device name is not kept on the local stack anymore.

branches: 1.57.2;
the argument of esa_get_locks() is struct esa_voice *, not struct esa_softc *.

ok by mrg@ jmcneill@

put back IPL_AUDIO and splaudio(), at the request of rmind. they are
aliases and now we can easily revert audio to IPL_VM if necessary,
without having to revert the whole branch.

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.54.10; 1.54.12;
A pointer typedef entails trading too much flexibility to declare const
and non-const types, and the kernel uses both const and non-const
PMF qualifiers and device suspensors, so change the pmf_qual_t and
device_suspensor_t typedefs from "pointers to const" to non-pointer,
non-const types.

branches: 1.53.2;
Expand PMF_FN_* macros.

Cleanup interrupt establish error messages. Do not mix
aprint_error/aprint_normal/printf calls for a single line.

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

branches: 1.50.8; 1.50.10;
Fix a couple of mistakes in the device_t/softc split that cause
machines such as my HP Pavilion N3270 to freeze at boot. This
should fix PR kern/38815, too.

branches: 1.49.2;
Hook hardware volume buttons into pmf.

branches: 1.48.2; 1.48.4; 1.48.6;
Split device_t and softc

Use aprint_*_dev() instead of accessing struct device member dv_xname
directly.

pci_activate() expects for its void * argument to be a device_t,
so change the type of the argument to device_t. Update each use
of pci_activate().

Use device_t and accessors. Use aprint_*_dev().

Add methods for detaching self and for detaching children.

Use device_t and accessors. Use aprint_*_dev().

branches: 1.44.2; 1.44.6;
On resume, ensure that esa is powered up, and ensure we power the
AC97 codec once the host controller is up and running.

Merge jmcneill-pm branch.

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

branches: 1.41.2; 1.41.14; 1.41.16; 1.41.20;
Kill caddr_t; there will be some MI fallout, but it will be fixed shortly.

branches: 1.40.4; 1.40.6;
__unused removal on arguments; approved by core.

- sprinkle __unused on function decls.
- fix a couple of unused bugs
- no more -Wno-unused for i386

No need to call pci_set_powerstate from our powerhook, the bus handles this
for us now.

PR# 23620: channels are swapped

Add "name" parameter to powerhook_establish, to aid debugging. No objections
on tech-kern@

Formatting fixups, remove commented out code that should not have been here,
and remove a few unnecessary XXX comments.

branches: 1.34.2; 1.34.4;
missing comma

fix incomplete initializers

re-factor the pci powestate api. reviewed by gimpy

branches: 1.31.4; 1.31.8; 1.31.14; 1.31.16;
merge ktrace-lwp.

Wow, this is clearly wrong (found in esa_set_params):
if (p->channels < 1 && p->channels > 2)
return EINVAL;
Change the 'and' to an 'or' so the check actually does something.

branches: 1.29.2; 1.29.4;
Use ANSI function decls and static.

ansify and KNF

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.26.2;
constify audio_hw_if, midi_hw_if, and radio_hw_if.

ac97_host_if::reset() returns non-zero value if codec reset fails, and
ac97 is not attached in that case.

PR: kern/26973

- Don't hardcode buffer size and block size in esa_round_buffersize() and
esa_round_blocksize().
- Fix esa_trigger_output() and esa_trigger_input() to initialise the
channel's buffer/block size using the supplied parameters.
- While here, simplify esa_intr().

This gets kphone working on my esa(4)-equipped laptop.

pass string length (= boundary info) to pci_devinfo so that we do not run over
the end of memory region

branches: 1.22.2;
Fix uninitialized variable warnings

add missing __KERNEL_RCSID()

branches: 1.20.2;
Add extensible malloc types, adapted from FreeBSD. This turns
malloc types into a structure, a pointer to which is passed around,
instead of an int constant. Allow the limit to be adjusted when the
malloc type is defined, or with a function call, as suggested by
Jonathan Stone.

Use aprint_*().

Replace magic numbers for power management control with PCI_PMCSR* macros.

XXX Should we use pci_get_powerstate() and pci_set_powerstate() in pci.c?

Add trailing ; to CFATTACH_DECL.

Use CFATTACH_DECL().

Declare all cfattach structures const.

audit bitmask test mistake (s/&&/&/). from openbsd

Fix the mixer controls to work a bit better.

branches: 1.12.2;
Fix suspend/resume. Previously, suspending/resuming while playback was active
would either:

1. Cause the machine to stop responding, or
2. Cause the currently playing voices to stop output.

With this change, voices are stopped on suspend, and continue from where they
left off on resume.

Add multiple voice support to the ESS Allegro-1 / Maestro-3 family of
audio accelerators.

Mixing is done in hardware by the ASSP, but is limited to 4 simultaneous
channels due to the restricted "minisrc" image that we are currently
working with.

Due to limitations in the audio subsystem, I'm currently attaching multiple
'audio' devices to 'esa', one for each voice. Because of this hack, the
default ESA_NUM_VOICES is 1.

Correctly enable/disable the low-pass filter, depending on the sample rate.
This fixes timing issues when playing back at 48kHz (noticable using
pkgsrc/graphics/mplayer and DivX ;-) streams).

in esa_resume, call esa_codec_reset; makes it much more happy after a
suspend on my O500 (snatched from FreeBSD)

branches: 1.8.2;
free memory allocated for suspend save area in detach

Use standard PCI power management definitions from pcireg.h instead
of homegrown ones.

suggested by Soren

Every card I've seen has had their channels swapped with respect
to the mixer. Ie:
$ mixerctl -w outputs.master=0,191
Would result in the _right_ speaker being turned off.

So, we will swap the left and right mixer channels to compensate
for this.

Use malloc's M_ZERO flag instead of malloc/memset.

Add support for the driver to work after suspend/resume. Does nothing
fancy, works for the basic output case, but does not support programs
which use playback while going into suspend.

Sketched after code found in FreeBSD and Linux drivers.

branches: 1.3.2; 1.3.4;
Integrate recording support into the driver. Not very heavily tested yet.

Note that Don Kim wrote the original Linux driver.

Import driver for the ESS Allegro-1 / Maestro-3 based PCI Audio Accelerators.

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

use pci_intr_establish_xname() everywhere

branches: 1.61.8;
remove checks for failure after memory allocation calls that cannot fail:

kmem_alloc() with KM_SLEEP
kmem_zalloc() with KM_SLEEP
percpu_alloc()
pserialize_create()
psref_class_create()

all of these paths include an assertion that the allocation has not failed,
so callers should not assert that again.

branches: 1.60.6;
make pci_intr_string and eisa_intr_string take a buffer and a length
instead of relying in local static storage.

- use proper types (uint16_t instead of uint32_t)
- don't index past the end of arrays
- use __arraycount() consistently instead of manual cruft.
- remove useless cast

branches: 1.58.6; 1.58.10;
Use pci_aprint_devinfo(9) instead of pci_devinfo+aprint_{normal,naive}
where it looks straightforward, and pci_aprint_devinfo_fancy in a few
others where drivers want to supply their own device names instead
of the pcidevs generated one. More complicated cases, where names
are composed at runtime, are left alone for now. It certainly makes
sense to simplify the drivers here rather than inventing a catch-all API.
This should serve as as example for new drivers, and also ensure
consistent output in the AB_QUIET ("boot -q") case. Also, it avoids
excessive stack usage where drivers attach child devices because the
buffer for the device name is not kept on the local stack anymore.

branches: 1.57.2;
the argument of esa_get_locks() is struct esa_voice *, not struct esa_softc *.

ok by mrg@ jmcneill@

put back IPL_AUDIO and splaudio(), at the request of rmind. they are
aliases and now we can easily revert audio to IPL_VM if necessary,
without having to revert the whole branch.

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.54.10; 1.54.12;
A pointer typedef entails trading too much flexibility to declare const
and non-const types, and the kernel uses both const and non-const
PMF qualifiers and device suspensors, so change the pmf_qual_t and
device_suspensor_t typedefs from "pointers to const" to non-pointer,
non-const types.

branches: 1.53.2;
Expand PMF_FN_* macros.

Cleanup interrupt establish error messages. Do not mix
aprint_error/aprint_normal/printf calls for a single line.

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

branches: 1.50.8; 1.50.10;
Fix a couple of mistakes in the device_t/softc split that cause
machines such as my HP Pavilion N3270 to freeze at boot. This
should fix PR kern/38815, too.

branches: 1.49.2;
Hook hardware volume buttons into pmf.

branches: 1.48.2; 1.48.4; 1.48.6;
Split device_t and softc

Use aprint_*_dev() instead of accessing struct device member dv_xname
directly.

pci_activate() expects for its void * argument to be a device_t,
so change the type of the argument to device_t. Update each use
of pci_activate().

Use device_t and accessors. Use aprint_*_dev().

Add methods for detaching self and for detaching children.

Use device_t and accessors. Use aprint_*_dev().

branches: 1.44.2; 1.44.6;
On resume, ensure that esa is powered up, and ensure we power the
AC97 codec once the host controller is up and running.

Merge jmcneill-pm branch.

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

branches: 1.41.2; 1.41.14; 1.41.16; 1.41.20;
Kill caddr_t; there will be some MI fallout, but it will be fixed shortly.

branches: 1.40.4; 1.40.6;
__unused removal on arguments; approved by core.

- sprinkle __unused on function decls.
- fix a couple of unused bugs
- no more -Wno-unused for i386

No need to call pci_set_powerstate from our powerhook, the bus handles this
for us now.

PR# 23620: channels are swapped

Add "name" parameter to powerhook_establish, to aid debugging. No objections
on tech-kern@

Formatting fixups, remove commented out code that should not have been here,
and remove a few unnecessary XXX comments.

branches: 1.34.2; 1.34.4;
missing comma

fix incomplete initializers

re-factor the pci powestate api. reviewed by gimpy

branches: 1.31.4; 1.31.8; 1.31.14; 1.31.16;
merge ktrace-lwp.

Wow, this is clearly wrong (found in esa_set_params):
if (p->channels < 1 && p->channels > 2)
return EINVAL;
Change the 'and' to an 'or' so the check actually does something.

branches: 1.29.2; 1.29.4;
Use ANSI function decls and static.

ansify and KNF

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.26.2;
constify audio_hw_if, midi_hw_if, and radio_hw_if.

ac97_host_if::reset() returns non-zero value if codec reset fails, and
ac97 is not attached in that case.

PR: kern/26973

- Don't hardcode buffer size and block size in esa_round_buffersize() and
esa_round_blocksize().
- Fix esa_trigger_output() and esa_trigger_input() to initialise the
channel's buffer/block size using the supplied parameters.
- While here, simplify esa_intr().

This gets kphone working on my esa(4)-equipped laptop.

pass string length (= boundary info) to pci_devinfo so that we do not run over
the end of memory region

branches: 1.22.2;
Fix uninitialized variable warnings

add missing __KERNEL_RCSID()

branches: 1.20.2;
Add extensible malloc types, adapted from FreeBSD. This turns
malloc types into a structure, a pointer to which is passed around,
instead of an int constant. Allow the limit to be adjusted when the
malloc type is defined, or with a function call, as suggested by
Jonathan Stone.

Use aprint_*().

Replace magic numbers for power management control with PCI_PMCSR* macros.

XXX Should we use pci_get_powerstate() and pci_set_powerstate() in pci.c?

Add trailing ; to CFATTACH_DECL.

Use CFATTACH_DECL().

Declare all cfattach structures const.

audit bitmask test mistake (s/&&/&/). from openbsd

Fix the mixer controls to work a bit better.

branches: 1.12.2;
Fix suspend/resume. Previously, suspending/resuming while playback was active
would either:

1. Cause the machine to stop responding, or
2. Cause the currently playing voices to stop output.

With this change, voices are stopped on suspend, and continue from where they
left off on resume.

Add multiple voice support to the ESS Allegro-1 / Maestro-3 family of
audio accelerators.

Mixing is done in hardware by the ASSP, but is limited to 4 simultaneous
channels due to the restricted "minisrc" image that we are currently
working with.

Due to limitations in the audio subsystem, I'm currently attaching multiple
'audio' devices to 'esa', one for each voice. Because of this hack, the
default ESA_NUM_VOICES is 1.

Correctly enable/disable the low-pass filter, depending on the sample rate.
This fixes timing issues when playing back at 48kHz (noticable using
pkgsrc/graphics/mplayer and DivX ;-) streams).

in esa_resume, call esa_codec_reset; makes it much more happy after a
suspend on my O500 (snatched from FreeBSD)

branches: 1.8.2;
free memory allocated for suspend save area in detach

Use standard PCI power management definitions from pcireg.h instead
of homegrown ones.

suggested by Soren

Every card I've seen has had their channels swapped with respect
to the mixer. Ie:
$ mixerctl -w outputs.master=0,191
Would result in the _right_ speaker being turned off.

So, we will swap the left and right mixer channels to compensate
for this.

Use malloc's M_ZERO flag instead of malloc/memset.

Add support for the driver to work after suspend/resume. Does nothing
fancy, works for the basic output case, but does not support programs
which use playback while going into suspend.

Sketched after code found in FreeBSD and Linux drivers.

branches: 1.3.2; 1.3.4;
Integrate recording support into the driver. Not very heavily tested yet.

Note that Don Kim wrote the original Linux driver.

Import driver for the ESS Allegro-1 / Maestro-3 based PCI Audio Accelerators.

remove checks for failure after memory allocation calls that cannot fail:

kmem_alloc() with KM_SLEEP
kmem_zalloc() with KM_SLEEP
percpu_alloc()
pserialize_create()
psref_class_create()

all of these paths include an assertion that the allocation has not failed,
so callers should not assert that again.

make pci_intr_string and eisa_intr_string take a buffer and a length
instead of relying in local static storage.

- use proper types (uint16_t instead of uint32_t)
- don't index past the end of arrays
- use __arraycount() consistently instead of manual cruft.
- remove useless cast

branches: 1.58.6; 1.58.10;
Use pci_aprint_devinfo(9) instead of pci_devinfo+aprint_{normal,naive}
where it looks straightforward, and pci_aprint_devinfo_fancy in a few
others where drivers want to supply their own device names instead
of the pcidevs generated one. More complicated cases, where names
are composed at runtime, are left alone for now. It certainly makes
sense to simplify the drivers here rather than inventing a catch-all API.
This should serve as as example for new drivers, and also ensure
consistent output in the AB_QUIET ("boot -q") case. Also, it avoids
excessive stack usage where drivers attach child devices because the
buffer for the device name is not kept on the local stack anymore.

branches: 1.57.2;
the argument of esa_get_locks() is struct esa_voice *, not struct esa_softc *.

ok by mrg@ jmcneill@

put back IPL_AUDIO and splaudio(), at the request of rmind. they are
aliases and now we can easily revert audio to IPL_VM if necessary,
without having to revert the whole branch.

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.54.10; 1.54.12;
A pointer typedef entails trading too much flexibility to declare const
and non-const types, and the kernel uses both const and non-const
PMF qualifiers and device suspensors, so change the pmf_qual_t and
device_suspensor_t typedefs from "pointers to const" to non-pointer,
non-const types.

branches: 1.53.2;
Expand PMF_FN_* macros.

Cleanup interrupt establish error messages. Do not mix
aprint_error/aprint_normal/printf calls for a single line.

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

branches: 1.50.8; 1.50.10;
Fix a couple of mistakes in the device_t/softc split that cause
machines such as my HP Pavilion N3270 to freeze at boot. This
should fix PR kern/38815, too.

branches: 1.49.2;
Hook hardware volume buttons into pmf.

branches: 1.48.2; 1.48.4; 1.48.6;
Split device_t and softc

Use aprint_*_dev() instead of accessing struct device member dv_xname
directly.

pci_activate() expects for its void * argument to be a device_t,
so change the type of the argument to device_t. Update each use
of pci_activate().

Use device_t and accessors. Use aprint_*_dev().

Add methods for detaching self and for detaching children.

Use device_t and accessors. Use aprint_*_dev().

branches: 1.44.2; 1.44.6;
On resume, ensure that esa is powered up, and ensure we power the
AC97 codec once the host controller is up and running.

Merge jmcneill-pm branch.

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

branches: 1.41.2; 1.41.14; 1.41.16; 1.41.20;
Kill caddr_t; there will be some MI fallout, but it will be fixed shortly.

branches: 1.40.4; 1.40.6;
__unused removal on arguments; approved by core.

- sprinkle __unused on function decls.
- fix a couple of unused bugs
- no more -Wno-unused for i386

No need to call pci_set_powerstate from our powerhook, the bus handles this
for us now.

PR# 23620: channels are swapped

Add "name" parameter to powerhook_establish, to aid debugging. No objections
on tech-kern@

Formatting fixups, remove commented out code that should not have been here,
and remove a few unnecessary XXX comments.

branches: 1.34.2; 1.34.4;
missing comma

fix incomplete initializers

re-factor the pci powestate api. reviewed by gimpy

branches: 1.31.4; 1.31.8; 1.31.14; 1.31.16;
merge ktrace-lwp.

Wow, this is clearly wrong (found in esa_set_params):
if (p->channels < 1 && p->channels > 2)
return EINVAL;
Change the 'and' to an 'or' so the check actually does something.

branches: 1.29.2; 1.29.4;
Use ANSI function decls and static.

ansify and KNF

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.26.2;
constify audio_hw_if, midi_hw_if, and radio_hw_if.

ac97_host_if::reset() returns non-zero value if codec reset fails, and
ac97 is not attached in that case.

PR: kern/26973

- Don't hardcode buffer size and block size in esa_round_buffersize() and
esa_round_blocksize().
- Fix esa_trigger_output() and esa_trigger_input() to initialise the
channel's buffer/block size using the supplied parameters.
- While here, simplify esa_intr().

This gets kphone working on my esa(4)-equipped laptop.

pass string length (= boundary info) to pci_devinfo so that we do not run over
the end of memory region

branches: 1.22.2;
Fix uninitialized variable warnings

add missing __KERNEL_RCSID()

branches: 1.20.2;
Add extensible malloc types, adapted from FreeBSD. This turns
malloc types into a structure, a pointer to which is passed around,
instead of an int constant. Allow the limit to be adjusted when the
malloc type is defined, or with a function call, as suggested by
Jonathan Stone.

Use aprint_*().

Replace magic numbers for power management control with PCI_PMCSR* macros.

XXX Should we use pci_get_powerstate() and pci_set_powerstate() in pci.c?

Add trailing ; to CFATTACH_DECL.

Use CFATTACH_DECL().

Declare all cfattach structures const.

audit bitmask test mistake (s/&&/&/). from openbsd

Fix the mixer controls to work a bit better.

branches: 1.12.2;
Fix suspend/resume. Previously, suspending/resuming while playback was active
would either:

1. Cause the machine to stop responding, or
2. Cause the currently playing voices to stop output.

With this change, voices are stopped on suspend, and continue from where they
left off on resume.

Add multiple voice support to the ESS Allegro-1 / Maestro-3 family of
audio accelerators.

Mixing is done in hardware by the ASSP, but is limited to 4 simultaneous
channels due to the restricted "minisrc" image that we are currently
working with.

Due to limitations in the audio subsystem, I'm currently attaching multiple
'audio' devices to 'esa', one for each voice. Because of this hack, the
default ESA_NUM_VOICES is 1.

Correctly enable/disable the low-pass filter, depending on the sample rate.
This fixes timing issues when playing back at 48kHz (noticable using
pkgsrc/graphics/mplayer and DivX ;-) streams).

in esa_resume, call esa_codec_reset; makes it much more happy after a
suspend on my O500 (snatched from FreeBSD)

branches: 1.8.2;
free memory allocated for suspend save area in detach

Use standard PCI power management definitions from pcireg.h instead
of homegrown ones.

suggested by Soren

Every card I've seen has had their channels swapped with respect
to the mixer. Ie:
$ mixerctl -w outputs.master=0,191
Would result in the _right_ speaker being turned off.

So, we will swap the left and right mixer channels to compensate
for this.

Use malloc's M_ZERO flag instead of malloc/memset.

Add support for the driver to work after suspend/resume. Does nothing
fancy, works for the basic output case, but does not support programs
which use playback while going into suspend.

Sketched after code found in FreeBSD and Linux drivers.

branches: 1.3.2; 1.3.4;
Integrate recording support into the driver. Not very heavily tested yet.

Note that Don Kim wrote the original Linux driver.

Import driver for the ESS Allegro-1 / Maestro-3 based PCI Audio Accelerators.