Liam Girdwood | eb1a6af | 2006-10-06 18:34:51 +0200 | [diff] [blame] | 1 | ASoC Machine Driver |
| 2 | =================== |
| 3 | |
| 4 | The ASoC machine (or board) driver is the code that glues together the platform |
| 5 | and codec drivers. |
| 6 | |
| 7 | The machine driver can contain codec and platform specific code. It registers |
| 8 | the audio subsystem with the kernel as a platform device and is represented by |
| 9 | the following struct:- |
| 10 | |
| 11 | /* SoC machine */ |
Mark Brown | 4f90473 | 2008-11-21 15:08:23 +0000 | [diff] [blame^] | 12 | struct snd_soc_card { |
Liam Girdwood | eb1a6af | 2006-10-06 18:34:51 +0200 | [diff] [blame] | 13 | char *name; |
| 14 | |
| 15 | int (*probe)(struct platform_device *pdev); |
| 16 | int (*remove)(struct platform_device *pdev); |
| 17 | |
| 18 | /* the pre and post PM functions are used to do any PM work before and |
Mark Brown | 7c4dbbd | 2008-01-23 08:41:46 +0100 | [diff] [blame] | 19 | * after the codec and DAIs do any PM work. */ |
Liam Girdwood | eb1a6af | 2006-10-06 18:34:51 +0200 | [diff] [blame] | 20 | int (*suspend_pre)(struct platform_device *pdev, pm_message_t state); |
| 21 | int (*suspend_post)(struct platform_device *pdev, pm_message_t state); |
| 22 | int (*resume_pre)(struct platform_device *pdev); |
| 23 | int (*resume_post)(struct platform_device *pdev); |
| 24 | |
| 25 | /* machine stream operations */ |
| 26 | struct snd_soc_ops *ops; |
| 27 | |
| 28 | /* CPU <--> Codec DAI links */ |
| 29 | struct snd_soc_dai_link *dai_link; |
| 30 | int num_links; |
| 31 | }; |
| 32 | |
| 33 | probe()/remove() |
| 34 | ---------------- |
| 35 | probe/remove are optional. Do any machine specific probe here. |
| 36 | |
| 37 | |
| 38 | suspend()/resume() |
| 39 | ------------------ |
| 40 | The machine driver has pre and post versions of suspend and resume to take care |
Mark Brown | 7c4dbbd | 2008-01-23 08:41:46 +0100 | [diff] [blame] | 41 | of any machine audio tasks that have to be done before or after the codec, DAIs |
Liam Girdwood | eb1a6af | 2006-10-06 18:34:51 +0200 | [diff] [blame] | 42 | and DMA is suspended and resumed. Optional. |
| 43 | |
| 44 | |
| 45 | Machine operations |
| 46 | ------------------ |
| 47 | The machine specific audio operations can be set here. Again this is optional. |
| 48 | |
| 49 | |
| 50 | Machine DAI Configuration |
| 51 | ------------------------- |
Mark Brown | 7c4dbbd | 2008-01-23 08:41:46 +0100 | [diff] [blame] | 52 | The machine DAI configuration glues all the codec and CPU DAIs together. It can |
Liam Girdwood | eb1a6af | 2006-10-06 18:34:51 +0200 | [diff] [blame] | 53 | also be used to set up the DAI system clock and for any machine related DAI |
| 54 | initialisation e.g. the machine audio map can be connected to the codec audio |
Mark Brown | 7c4dbbd | 2008-01-23 08:41:46 +0100 | [diff] [blame] | 55 | map, unconnected codec pins can be set as such. Please see corgi.c, spitz.c |
Liam Girdwood | eb1a6af | 2006-10-06 18:34:51 +0200 | [diff] [blame] | 56 | for examples. |
| 57 | |
| 58 | struct snd_soc_dai_link is used to set up each DAI in your machine. e.g. |
| 59 | |
| 60 | /* corgi digital audio interface glue - connects codec <--> CPU */ |
| 61 | static struct snd_soc_dai_link corgi_dai = { |
| 62 | .name = "WM8731", |
| 63 | .stream_name = "WM8731", |
| 64 | .cpu_dai = &pxa_i2s_dai, |
| 65 | .codec_dai = &wm8731_dai, |
| 66 | .init = corgi_wm8731_init, |
Liam Girdwood | 10b9852 | 2007-02-08 17:06:09 +0100 | [diff] [blame] | 67 | .ops = &corgi_ops, |
Liam Girdwood | eb1a6af | 2006-10-06 18:34:51 +0200 | [diff] [blame] | 68 | }; |
| 69 | |
Mark Brown | 8750654 | 2008-11-18 20:50:34 +0000 | [diff] [blame] | 70 | struct snd_soc_card then sets up the machine with it's DAIs. e.g. |
Liam Girdwood | eb1a6af | 2006-10-06 18:34:51 +0200 | [diff] [blame] | 71 | |
| 72 | /* corgi audio machine driver */ |
Mark Brown | 8750654 | 2008-11-18 20:50:34 +0000 | [diff] [blame] | 73 | static struct snd_soc_card snd_soc_corgi = { |
Liam Girdwood | eb1a6af | 2006-10-06 18:34:51 +0200 | [diff] [blame] | 74 | .name = "Corgi", |
| 75 | .dai_link = &corgi_dai, |
| 76 | .num_links = 1, |
Liam Girdwood | eb1a6af | 2006-10-06 18:34:51 +0200 | [diff] [blame] | 77 | }; |
| 78 | |
| 79 | |
| 80 | Machine Audio Subsystem |
| 81 | ----------------------- |
| 82 | |
| 83 | The machine soc device glues the platform, machine and codec driver together. |
| 84 | Private data can also be set here. e.g. |
| 85 | |
| 86 | /* corgi audio private data */ |
| 87 | static struct wm8731_setup_data corgi_wm8731_setup = { |
| 88 | .i2c_address = 0x1b, |
| 89 | }; |
| 90 | |
| 91 | /* corgi audio subsystem */ |
| 92 | static struct snd_soc_device corgi_snd_devdata = { |
Mark Brown | 8750654 | 2008-11-18 20:50:34 +0000 | [diff] [blame] | 93 | .machine = &snd_soc_corgi, |
Liam Girdwood | eb1a6af | 2006-10-06 18:34:51 +0200 | [diff] [blame] | 94 | .platform = &pxa2xx_soc_platform, |
| 95 | .codec_dev = &soc_codec_dev_wm8731, |
| 96 | .codec_data = &corgi_wm8731_setup, |
| 97 | }; |
| 98 | |
| 99 | |
| 100 | Machine Power Map |
| 101 | ----------------- |
| 102 | |
| 103 | The machine driver can optionally extend the codec power map and to become an |
| 104 | audio power map of the audio subsystem. This allows for automatic power up/down |
| 105 | of speaker/HP amplifiers, etc. Codec pins can be connected to the machines jack |
| 106 | sockets in the machine init function. See soc/pxa/spitz.c and dapm.txt for |
| 107 | details. |
| 108 | |
| 109 | |
| 110 | Machine Controls |
| 111 | ---------------- |
| 112 | |
Mark Brown | 7c4dbbd | 2008-01-23 08:41:46 +0100 | [diff] [blame] | 113 | Machine specific audio mixer controls can be added in the DAI init function. |