ASoC: docs: Update the Overview document

Update the ASoC overview to bring it up to date with the current code base
and include multi-component.

Signed-off-by: Liam Girdwood <liam.r.girdwood@linux.intel.com>
Signed-off-by: Mark Brown <broonie@linaro.org>
This commit is contained in:
Liam Girdwood 2014-01-07 17:51:41 +00:00 committed by Mark Brown
parent 6ce4eac1f6
commit d9e9ff5a8e

View file

@ -49,18 +49,23 @@ features :-
* Machine specific controls: Allow machines to add controls to the sound card * Machine specific controls: Allow machines to add controls to the sound card
(e.g. volume control for speaker amplifier). (e.g. volume control for speaker amplifier).
To achieve all this, ASoC basically splits an embedded audio system into 3 To achieve all this, ASoC basically splits an embedded audio system into
components :- multiple re-usable component drivers :-
* Codec driver: The codec driver is platform independent and contains audio * Codec class drivers: The codec class driver is platform independent and
controls, audio interface capabilities, codec DAPM definition and codec IO contains audio controls, audio interface capabilities, codec DAPM
functions. definition and codec IO functions. This class extends to BT, FM and MODEM
ICs if required. Codec class drivers should be generic code that can run
on any architecture and machine.
* Platform driver: The platform driver contains the audio DMA engine and audio * Platform class drivers: The platform class driver includes the audio DMA
interface drivers (e.g. I2S, AC97, PCM) for that platform. engine driver, digital audio interface (DAI) drivers (e.g. I2S, AC97, PCM)
and any audio DSP drivers for that platform.
* Machine driver: The machine driver handles any machine specific controls and * Machine class driver: The machine driver class acts as the glue that
audio events (e.g. turning on an amp at start of playback). decribes and binds the other component drivers together to form an ALSA
"sound card device". It handles any machine specific controls and
machine level audio events (e.g. turning on an amp at start of playback).
Documentation Documentation
@ -84,3 +89,7 @@ machine.txt: Machine driver internals.
pop_clicks.txt: How to minimise audio artifacts. pop_clicks.txt: How to minimise audio artifacts.
clocking.txt: ASoC clocking for best power performance. clocking.txt: ASoC clocking for best power performance.
jack.txt: ASoC jack detection.
DPCM.txt: Dynamic PCM - Describes DPCM with DSP examples.