wm8960.c 28 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059
  1. /*
  2. * wm8960.c -- WM8960 ALSA SoC Audio driver
  3. *
  4. * Author: Liam Girdwood
  5. *
  6. * This program is free software; you can redistribute it and/or modify
  7. * it under the terms of the GNU General Public License version 2 as
  8. * published by the Free Software Foundation.
  9. */
  10. #include <linux/module.h>
  11. #include <linux/moduleparam.h>
  12. #include <linux/init.h>
  13. #include <linux/delay.h>
  14. #include <linux/pm.h>
  15. #include <linux/i2c.h>
  16. #include <linux/platform_device.h>
  17. #include <linux/slab.h>
  18. #include <sound/core.h>
  19. #include <sound/pcm.h>
  20. #include <sound/pcm_params.h>
  21. #include <sound/soc.h>
  22. #include <sound/soc-dapm.h>
  23. #include <sound/initval.h>
  24. #include <sound/tlv.h>
  25. #include <sound/wm8960.h>
  26. #include "wm8960.h"
  27. #define AUDIO_NAME "wm8960"
  28. struct snd_soc_codec_device soc_codec_dev_wm8960;
  29. /* R25 - Power 1 */
  30. #define WM8960_VMID_MASK 0x180
  31. #define WM8960_VREF 0x40
  32. /* R26 - Power 2 */
  33. #define WM8960_PWR2_LOUT1 0x40
  34. #define WM8960_PWR2_ROUT1 0x20
  35. #define WM8960_PWR2_OUT3 0x02
  36. /* R28 - Anti-pop 1 */
  37. #define WM8960_POBCTRL 0x80
  38. #define WM8960_BUFDCOPEN 0x10
  39. #define WM8960_BUFIOEN 0x08
  40. #define WM8960_SOFT_ST 0x04
  41. #define WM8960_HPSTBY 0x01
  42. /* R29 - Anti-pop 2 */
  43. #define WM8960_DISOP 0x40
  44. #define WM8960_DRES_MASK 0x30
  45. /*
  46. * wm8960 register cache
  47. * We can't read the WM8960 register space when we are
  48. * using 2 wire for device control, so we cache them instead.
  49. */
  50. static const u16 wm8960_reg[WM8960_CACHEREGNUM] = {
  51. 0x0097, 0x0097, 0x0000, 0x0000,
  52. 0x0000, 0x0008, 0x0000, 0x000a,
  53. 0x01c0, 0x0000, 0x00ff, 0x00ff,
  54. 0x0000, 0x0000, 0x0000, 0x0000,
  55. 0x0000, 0x007b, 0x0100, 0x0032,
  56. 0x0000, 0x00c3, 0x00c3, 0x01c0,
  57. 0x0000, 0x0000, 0x0000, 0x0000,
  58. 0x0000, 0x0000, 0x0000, 0x0000,
  59. 0x0100, 0x0100, 0x0050, 0x0050,
  60. 0x0050, 0x0050, 0x0000, 0x0000,
  61. 0x0000, 0x0000, 0x0040, 0x0000,
  62. 0x0000, 0x0050, 0x0050, 0x0000,
  63. 0x0002, 0x0037, 0x004d, 0x0080,
  64. 0x0008, 0x0031, 0x0026, 0x00e9,
  65. };
  66. struct wm8960_priv {
  67. u16 reg_cache[WM8960_CACHEREGNUM];
  68. struct snd_soc_codec codec;
  69. struct snd_soc_dapm_widget *lout1;
  70. struct snd_soc_dapm_widget *rout1;
  71. struct snd_soc_dapm_widget *out3;
  72. };
  73. #define wm8960_reset(c) snd_soc_write(c, WM8960_RESET, 0)
  74. /* enumerated controls */
  75. static const char *wm8960_polarity[] = {"No Inversion", "Left Inverted",
  76. "Right Inverted", "Stereo Inversion"};
  77. static const char *wm8960_3d_upper_cutoff[] = {"High", "Low"};
  78. static const char *wm8960_3d_lower_cutoff[] = {"Low", "High"};
  79. static const char *wm8960_alcfunc[] = {"Off", "Right", "Left", "Stereo"};
  80. static const char *wm8960_alcmode[] = {"ALC", "Limiter"};
  81. static const struct soc_enum wm8960_enum[] = {
  82. SOC_ENUM_SINGLE(WM8960_DACCTL1, 5, 4, wm8960_polarity),
  83. SOC_ENUM_SINGLE(WM8960_DACCTL2, 5, 4, wm8960_polarity),
  84. SOC_ENUM_SINGLE(WM8960_3D, 6, 2, wm8960_3d_upper_cutoff),
  85. SOC_ENUM_SINGLE(WM8960_3D, 5, 2, wm8960_3d_lower_cutoff),
  86. SOC_ENUM_SINGLE(WM8960_ALC1, 7, 4, wm8960_alcfunc),
  87. SOC_ENUM_SINGLE(WM8960_ALC3, 8, 2, wm8960_alcmode),
  88. };
  89. static const DECLARE_TLV_DB_SCALE(adc_tlv, -9700, 50, 0);
  90. static const DECLARE_TLV_DB_SCALE(dac_tlv, -12700, 50, 1);
  91. static const DECLARE_TLV_DB_SCALE(bypass_tlv, -2100, 300, 0);
  92. static const DECLARE_TLV_DB_SCALE(out_tlv, -12100, 100, 1);
  93. static const struct snd_kcontrol_new wm8960_snd_controls[] = {
  94. SOC_DOUBLE_R_TLV("Capture Volume", WM8960_LINVOL, WM8960_RINVOL,
  95. 0, 63, 0, adc_tlv),
  96. SOC_DOUBLE_R("Capture Volume ZC Switch", WM8960_LINVOL, WM8960_RINVOL,
  97. 6, 1, 0),
  98. SOC_DOUBLE_R("Capture Switch", WM8960_LINVOL, WM8960_RINVOL,
  99. 7, 1, 0),
  100. SOC_DOUBLE_R_TLV("Playback Volume", WM8960_LDAC, WM8960_RDAC,
  101. 0, 255, 0, dac_tlv),
  102. SOC_DOUBLE_R_TLV("Headphone Playback Volume", WM8960_LOUT1, WM8960_ROUT1,
  103. 0, 127, 0, out_tlv),
  104. SOC_DOUBLE_R("Headphone Playback ZC Switch", WM8960_LOUT1, WM8960_ROUT1,
  105. 7, 1, 0),
  106. SOC_DOUBLE_R_TLV("Speaker Playback Volume", WM8960_LOUT2, WM8960_ROUT2,
  107. 0, 127, 0, out_tlv),
  108. SOC_DOUBLE_R("Speaker Playback ZC Switch", WM8960_LOUT2, WM8960_ROUT2,
  109. 7, 1, 0),
  110. SOC_SINGLE("Speaker DC Volume", WM8960_CLASSD3, 3, 5, 0),
  111. SOC_SINGLE("Speaker AC Volume", WM8960_CLASSD3, 0, 5, 0),
  112. SOC_SINGLE("PCM Playback -6dB Switch", WM8960_DACCTL1, 7, 1, 0),
  113. SOC_ENUM("ADC Polarity", wm8960_enum[0]),
  114. SOC_SINGLE("ADC High Pass Filter Switch", WM8960_DACCTL1, 0, 1, 0),
  115. SOC_ENUM("DAC Polarity", wm8960_enum[2]),
  116. SOC_ENUM("3D Filter Upper Cut-Off", wm8960_enum[2]),
  117. SOC_ENUM("3D Filter Lower Cut-Off", wm8960_enum[3]),
  118. SOC_SINGLE("3D Volume", WM8960_3D, 1, 15, 0),
  119. SOC_SINGLE("3D Switch", WM8960_3D, 0, 1, 0),
  120. SOC_ENUM("ALC Function", wm8960_enum[4]),
  121. SOC_SINGLE("ALC Max Gain", WM8960_ALC1, 4, 7, 0),
  122. SOC_SINGLE("ALC Target", WM8960_ALC1, 0, 15, 1),
  123. SOC_SINGLE("ALC Min Gain", WM8960_ALC2, 4, 7, 0),
  124. SOC_SINGLE("ALC Hold Time", WM8960_ALC2, 0, 15, 0),
  125. SOC_ENUM("ALC Mode", wm8960_enum[5]),
  126. SOC_SINGLE("ALC Decay", WM8960_ALC3, 4, 15, 0),
  127. SOC_SINGLE("ALC Attack", WM8960_ALC3, 0, 15, 0),
  128. SOC_SINGLE("Noise Gate Threshold", WM8960_NOISEG, 3, 31, 0),
  129. SOC_SINGLE("Noise Gate Switch", WM8960_NOISEG, 0, 1, 0),
  130. SOC_DOUBLE_R("ADC PCM Capture Volume", WM8960_LINPATH, WM8960_RINPATH,
  131. 0, 127, 0),
  132. SOC_SINGLE_TLV("Left Output Mixer Boost Bypass Volume",
  133. WM8960_BYPASS1, 4, 7, 1, bypass_tlv),
  134. SOC_SINGLE_TLV("Left Output Mixer LINPUT3 Volume",
  135. WM8960_LOUTMIX, 4, 7, 1, bypass_tlv),
  136. SOC_SINGLE_TLV("Right Output Mixer Boost Bypass Volume",
  137. WM8960_BYPASS2, 4, 7, 1, bypass_tlv),
  138. SOC_SINGLE_TLV("Right Output Mixer RINPUT3 Volume",
  139. WM8960_ROUTMIX, 4, 7, 1, bypass_tlv),
  140. };
  141. static const struct snd_kcontrol_new wm8960_lin_boost[] = {
  142. SOC_DAPM_SINGLE("LINPUT2 Switch", WM8960_LINPATH, 6, 1, 0),
  143. SOC_DAPM_SINGLE("LINPUT3 Switch", WM8960_LINPATH, 7, 1, 0),
  144. SOC_DAPM_SINGLE("LINPUT1 Switch", WM8960_LINPATH, 8, 1, 0),
  145. };
  146. static const struct snd_kcontrol_new wm8960_lin[] = {
  147. SOC_DAPM_SINGLE("Boost Switch", WM8960_LINPATH, 3, 1, 0),
  148. };
  149. static const struct snd_kcontrol_new wm8960_rin_boost[] = {
  150. SOC_DAPM_SINGLE("RINPUT2 Switch", WM8960_RINPATH, 6, 1, 0),
  151. SOC_DAPM_SINGLE("RINPUT3 Switch", WM8960_RINPATH, 7, 1, 0),
  152. SOC_DAPM_SINGLE("RINPUT1 Switch", WM8960_RINPATH, 8, 1, 0),
  153. };
  154. static const struct snd_kcontrol_new wm8960_rin[] = {
  155. SOC_DAPM_SINGLE("Boost Switch", WM8960_RINPATH, 3, 1, 0),
  156. };
  157. static const struct snd_kcontrol_new wm8960_loutput_mixer[] = {
  158. SOC_DAPM_SINGLE("PCM Playback Switch", WM8960_LOUTMIX, 8, 1, 0),
  159. SOC_DAPM_SINGLE("LINPUT3 Switch", WM8960_LOUTMIX, 7, 1, 0),
  160. SOC_DAPM_SINGLE("Boost Bypass Switch", WM8960_BYPASS1, 7, 1, 0),
  161. };
  162. static const struct snd_kcontrol_new wm8960_routput_mixer[] = {
  163. SOC_DAPM_SINGLE("PCM Playback Switch", WM8960_ROUTMIX, 8, 1, 0),
  164. SOC_DAPM_SINGLE("RINPUT3 Switch", WM8960_ROUTMIX, 7, 1, 0),
  165. SOC_DAPM_SINGLE("Boost Bypass Switch", WM8960_BYPASS2, 7, 1, 0),
  166. };
  167. static const struct snd_kcontrol_new wm8960_mono_out[] = {
  168. SOC_DAPM_SINGLE("Left Switch", WM8960_MONOMIX1, 7, 1, 0),
  169. SOC_DAPM_SINGLE("Right Switch", WM8960_MONOMIX2, 7, 1, 0),
  170. };
  171. static const struct snd_soc_dapm_widget wm8960_dapm_widgets[] = {
  172. SND_SOC_DAPM_INPUT("LINPUT1"),
  173. SND_SOC_DAPM_INPUT("RINPUT1"),
  174. SND_SOC_DAPM_INPUT("LINPUT2"),
  175. SND_SOC_DAPM_INPUT("RINPUT2"),
  176. SND_SOC_DAPM_INPUT("LINPUT3"),
  177. SND_SOC_DAPM_INPUT("RINPUT3"),
  178. SND_SOC_DAPM_MICBIAS("MICB", WM8960_POWER1, 1, 0),
  179. SND_SOC_DAPM_MIXER("Left Boost Mixer", WM8960_POWER1, 5, 0,
  180. wm8960_lin_boost, ARRAY_SIZE(wm8960_lin_boost)),
  181. SND_SOC_DAPM_MIXER("Right Boost Mixer", WM8960_POWER1, 4, 0,
  182. wm8960_rin_boost, ARRAY_SIZE(wm8960_rin_boost)),
  183. SND_SOC_DAPM_MIXER("Left Input Mixer", WM8960_POWER3, 5, 0,
  184. wm8960_lin, ARRAY_SIZE(wm8960_lin)),
  185. SND_SOC_DAPM_MIXER("Right Input Mixer", WM8960_POWER3, 4, 0,
  186. wm8960_rin, ARRAY_SIZE(wm8960_rin)),
  187. SND_SOC_DAPM_ADC("Left ADC", "Capture", WM8960_POWER2, 3, 0),
  188. SND_SOC_DAPM_ADC("Right ADC", "Capture", WM8960_POWER2, 2, 0),
  189. SND_SOC_DAPM_DAC("Left DAC", "Playback", WM8960_POWER2, 8, 0),
  190. SND_SOC_DAPM_DAC("Right DAC", "Playback", WM8960_POWER2, 7, 0),
  191. SND_SOC_DAPM_MIXER("Left Output Mixer", WM8960_POWER3, 3, 0,
  192. &wm8960_loutput_mixer[0],
  193. ARRAY_SIZE(wm8960_loutput_mixer)),
  194. SND_SOC_DAPM_MIXER("Right Output Mixer", WM8960_POWER3, 2, 0,
  195. &wm8960_routput_mixer[0],
  196. ARRAY_SIZE(wm8960_routput_mixer)),
  197. SND_SOC_DAPM_PGA("LOUT1 PGA", WM8960_POWER2, 6, 0, NULL, 0),
  198. SND_SOC_DAPM_PGA("ROUT1 PGA", WM8960_POWER2, 5, 0, NULL, 0),
  199. SND_SOC_DAPM_PGA("Left Speaker PGA", WM8960_POWER2, 4, 0, NULL, 0),
  200. SND_SOC_DAPM_PGA("Right Speaker PGA", WM8960_POWER2, 3, 0, NULL, 0),
  201. SND_SOC_DAPM_PGA("Right Speaker Output", WM8960_CLASSD1, 7, 0, NULL, 0),
  202. SND_SOC_DAPM_PGA("Left Speaker Output", WM8960_CLASSD1, 6, 0, NULL, 0),
  203. SND_SOC_DAPM_OUTPUT("SPK_LP"),
  204. SND_SOC_DAPM_OUTPUT("SPK_LN"),
  205. SND_SOC_DAPM_OUTPUT("HP_L"),
  206. SND_SOC_DAPM_OUTPUT("HP_R"),
  207. SND_SOC_DAPM_OUTPUT("SPK_RP"),
  208. SND_SOC_DAPM_OUTPUT("SPK_RN"),
  209. SND_SOC_DAPM_OUTPUT("OUT3"),
  210. };
  211. static const struct snd_soc_dapm_widget wm8960_dapm_widgets_out3[] = {
  212. SND_SOC_DAPM_MIXER("Mono Output Mixer", WM8960_POWER2, 1, 0,
  213. &wm8960_mono_out[0],
  214. ARRAY_SIZE(wm8960_mono_out)),
  215. };
  216. /* Represent OUT3 as a PGA so that it gets turned on with LOUT1/ROUT1 */
  217. static const struct snd_soc_dapm_widget wm8960_dapm_widgets_capless[] = {
  218. SND_SOC_DAPM_PGA("OUT3 VMID", WM8960_POWER2, 1, 0, NULL, 0),
  219. };
  220. static const struct snd_soc_dapm_route audio_paths[] = {
  221. { "Left Boost Mixer", "LINPUT1 Switch", "LINPUT1" },
  222. { "Left Boost Mixer", "LINPUT2 Switch", "LINPUT2" },
  223. { "Left Boost Mixer", "LINPUT3 Switch", "LINPUT3" },
  224. { "Left Input Mixer", "Boost Switch", "Left Boost Mixer", },
  225. { "Left Input Mixer", NULL, "LINPUT1", }, /* Really Boost Switch */
  226. { "Left Input Mixer", NULL, "LINPUT2" },
  227. { "Left Input Mixer", NULL, "LINPUT3" },
  228. { "Right Boost Mixer", "RINPUT1 Switch", "RINPUT1" },
  229. { "Right Boost Mixer", "RINPUT2 Switch", "RINPUT2" },
  230. { "Right Boost Mixer", "RINPUT3 Switch", "RINPUT3" },
  231. { "Right Input Mixer", "Boost Switch", "Right Boost Mixer", },
  232. { "Right Input Mixer", NULL, "RINPUT1", }, /* Really Boost Switch */
  233. { "Right Input Mixer", NULL, "RINPUT2" },
  234. { "Right Input Mixer", NULL, "LINPUT3" },
  235. { "Left ADC", NULL, "Left Input Mixer" },
  236. { "Right ADC", NULL, "Right Input Mixer" },
  237. { "Left Output Mixer", "LINPUT3 Switch", "LINPUT3" },
  238. { "Left Output Mixer", "Boost Bypass Switch", "Left Boost Mixer"} ,
  239. { "Left Output Mixer", "PCM Playback Switch", "Left DAC" },
  240. { "Right Output Mixer", "RINPUT3 Switch", "RINPUT3" },
  241. { "Right Output Mixer", "Boost Bypass Switch", "Right Boost Mixer" } ,
  242. { "Right Output Mixer", "PCM Playback Switch", "Right DAC" },
  243. { "LOUT1 PGA", NULL, "Left Output Mixer" },
  244. { "ROUT1 PGA", NULL, "Right Output Mixer" },
  245. { "HP_L", NULL, "LOUT1 PGA" },
  246. { "HP_R", NULL, "ROUT1 PGA" },
  247. { "Left Speaker PGA", NULL, "Left Output Mixer" },
  248. { "Right Speaker PGA", NULL, "Right Output Mixer" },
  249. { "Left Speaker Output", NULL, "Left Speaker PGA" },
  250. { "Right Speaker Output", NULL, "Right Speaker PGA" },
  251. { "SPK_LN", NULL, "Left Speaker Output" },
  252. { "SPK_LP", NULL, "Left Speaker Output" },
  253. { "SPK_RN", NULL, "Right Speaker Output" },
  254. { "SPK_RP", NULL, "Right Speaker Output" },
  255. };
  256. static const struct snd_soc_dapm_route audio_paths_out3[] = {
  257. { "Mono Output Mixer", "Left Switch", "Left Output Mixer" },
  258. { "Mono Output Mixer", "Right Switch", "Right Output Mixer" },
  259. { "OUT3", NULL, "Mono Output Mixer", }
  260. };
  261. static const struct snd_soc_dapm_route audio_paths_capless[] = {
  262. { "HP_L", NULL, "OUT3 VMID" },
  263. { "HP_R", NULL, "OUT3 VMID" },
  264. { "OUT3 VMID", NULL, "Left Output Mixer" },
  265. { "OUT3 VMID", NULL, "Right Output Mixer" },
  266. };
  267. static int wm8960_add_widgets(struct snd_soc_codec *codec)
  268. {
  269. struct wm8960_data *pdata = codec->dev->platform_data;
  270. struct wm8960_priv *wm8960 = snd_soc_codec_get_drvdata(codec);
  271. struct snd_soc_dapm_widget *w;
  272. snd_soc_dapm_new_controls(codec, wm8960_dapm_widgets,
  273. ARRAY_SIZE(wm8960_dapm_widgets));
  274. snd_soc_dapm_add_routes(codec, audio_paths, ARRAY_SIZE(audio_paths));
  275. /* In capless mode OUT3 is used to provide VMID for the
  276. * headphone outputs, otherwise it is used as a mono mixer.
  277. */
  278. if (pdata && pdata->capless) {
  279. snd_soc_dapm_new_controls(codec, wm8960_dapm_widgets_capless,
  280. ARRAY_SIZE(wm8960_dapm_widgets_capless));
  281. snd_soc_dapm_add_routes(codec, audio_paths_capless,
  282. ARRAY_SIZE(audio_paths_capless));
  283. } else {
  284. snd_soc_dapm_new_controls(codec, wm8960_dapm_widgets_out3,
  285. ARRAY_SIZE(wm8960_dapm_widgets_out3));
  286. snd_soc_dapm_add_routes(codec, audio_paths_out3,
  287. ARRAY_SIZE(audio_paths_out3));
  288. }
  289. /* We need to power up the headphone output stage out of
  290. * sequence for capless mode. To save scanning the widget
  291. * list each time to find the desired power state do so now
  292. * and save the result.
  293. */
  294. list_for_each_entry(w, &codec->dapm_widgets, list) {
  295. if (strcmp(w->name, "LOUT1 PGA") == 0)
  296. wm8960->lout1 = w;
  297. if (strcmp(w->name, "ROUT1 PGA") == 0)
  298. wm8960->rout1 = w;
  299. if (strcmp(w->name, "OUT3 VMID") == 0)
  300. wm8960->out3 = w;
  301. }
  302. return 0;
  303. }
  304. static int wm8960_set_dai_fmt(struct snd_soc_dai *codec_dai,
  305. unsigned int fmt)
  306. {
  307. struct snd_soc_codec *codec = codec_dai->codec;
  308. u16 iface = 0;
  309. /* set master/slave audio interface */
  310. switch (fmt & SND_SOC_DAIFMT_MASTER_MASK) {
  311. case SND_SOC_DAIFMT_CBM_CFM:
  312. iface |= 0x0040;
  313. break;
  314. case SND_SOC_DAIFMT_CBS_CFS:
  315. break;
  316. default:
  317. return -EINVAL;
  318. }
  319. /* interface format */
  320. switch (fmt & SND_SOC_DAIFMT_FORMAT_MASK) {
  321. case SND_SOC_DAIFMT_I2S:
  322. iface |= 0x0002;
  323. break;
  324. case SND_SOC_DAIFMT_RIGHT_J:
  325. break;
  326. case SND_SOC_DAIFMT_LEFT_J:
  327. iface |= 0x0001;
  328. break;
  329. case SND_SOC_DAIFMT_DSP_A:
  330. iface |= 0x0003;
  331. break;
  332. case SND_SOC_DAIFMT_DSP_B:
  333. iface |= 0x0013;
  334. break;
  335. default:
  336. return -EINVAL;
  337. }
  338. /* clock inversion */
  339. switch (fmt & SND_SOC_DAIFMT_INV_MASK) {
  340. case SND_SOC_DAIFMT_NB_NF:
  341. break;
  342. case SND_SOC_DAIFMT_IB_IF:
  343. iface |= 0x0090;
  344. break;
  345. case SND_SOC_DAIFMT_IB_NF:
  346. iface |= 0x0080;
  347. break;
  348. case SND_SOC_DAIFMT_NB_IF:
  349. iface |= 0x0010;
  350. break;
  351. default:
  352. return -EINVAL;
  353. }
  354. /* set iface */
  355. snd_soc_write(codec, WM8960_IFACE1, iface);
  356. return 0;
  357. }
  358. static int wm8960_hw_params(struct snd_pcm_substream *substream,
  359. struct snd_pcm_hw_params *params,
  360. struct snd_soc_dai *dai)
  361. {
  362. struct snd_soc_pcm_runtime *rtd = substream->private_data;
  363. struct snd_soc_device *socdev = rtd->socdev;
  364. struct snd_soc_codec *codec = socdev->card->codec;
  365. u16 iface = snd_soc_read(codec, WM8960_IFACE1) & 0xfff3;
  366. /* bit size */
  367. switch (params_format(params)) {
  368. case SNDRV_PCM_FORMAT_S16_LE:
  369. break;
  370. case SNDRV_PCM_FORMAT_S20_3LE:
  371. iface |= 0x0004;
  372. break;
  373. case SNDRV_PCM_FORMAT_S24_LE:
  374. iface |= 0x0008;
  375. break;
  376. }
  377. /* set iface */
  378. snd_soc_write(codec, WM8960_IFACE1, iface);
  379. return 0;
  380. }
  381. static int wm8960_mute(struct snd_soc_dai *dai, int mute)
  382. {
  383. struct snd_soc_codec *codec = dai->codec;
  384. u16 mute_reg = snd_soc_read(codec, WM8960_DACCTL1) & 0xfff7;
  385. if (mute)
  386. snd_soc_write(codec, WM8960_DACCTL1, mute_reg | 0x8);
  387. else
  388. snd_soc_write(codec, WM8960_DACCTL1, mute_reg);
  389. return 0;
  390. }
  391. static int wm8960_set_bias_level_out3(struct snd_soc_codec *codec,
  392. enum snd_soc_bias_level level)
  393. {
  394. u16 reg;
  395. switch (level) {
  396. case SND_SOC_BIAS_ON:
  397. break;
  398. case SND_SOC_BIAS_PREPARE:
  399. /* Set VMID to 2x50k */
  400. reg = snd_soc_read(codec, WM8960_POWER1);
  401. reg &= ~0x180;
  402. reg |= 0x80;
  403. snd_soc_write(codec, WM8960_POWER1, reg);
  404. break;
  405. case SND_SOC_BIAS_STANDBY:
  406. if (codec->bias_level == SND_SOC_BIAS_OFF) {
  407. /* Enable anti-pop features */
  408. snd_soc_write(codec, WM8960_APOP1,
  409. WM8960_POBCTRL | WM8960_SOFT_ST |
  410. WM8960_BUFDCOPEN | WM8960_BUFIOEN);
  411. /* Enable & ramp VMID at 2x50k */
  412. reg = snd_soc_read(codec, WM8960_POWER1);
  413. reg |= 0x80;
  414. snd_soc_write(codec, WM8960_POWER1, reg);
  415. msleep(100);
  416. /* Enable VREF */
  417. snd_soc_write(codec, WM8960_POWER1, reg | WM8960_VREF);
  418. /* Disable anti-pop features */
  419. snd_soc_write(codec, WM8960_APOP1, WM8960_BUFIOEN);
  420. }
  421. /* Set VMID to 2x250k */
  422. reg = snd_soc_read(codec, WM8960_POWER1);
  423. reg &= ~0x180;
  424. reg |= 0x100;
  425. snd_soc_write(codec, WM8960_POWER1, reg);
  426. break;
  427. case SND_SOC_BIAS_OFF:
  428. /* Enable anti-pop features */
  429. snd_soc_write(codec, WM8960_APOP1,
  430. WM8960_POBCTRL | WM8960_SOFT_ST |
  431. WM8960_BUFDCOPEN | WM8960_BUFIOEN);
  432. /* Disable VMID and VREF, let them discharge */
  433. snd_soc_write(codec, WM8960_POWER1, 0);
  434. msleep(600);
  435. break;
  436. }
  437. codec->bias_level = level;
  438. return 0;
  439. }
  440. static int wm8960_set_bias_level_capless(struct snd_soc_codec *codec,
  441. enum snd_soc_bias_level level)
  442. {
  443. struct wm8960_priv *wm8960 = snd_soc_codec_get_drvdata(codec);
  444. int reg;
  445. switch (level) {
  446. case SND_SOC_BIAS_ON:
  447. break;
  448. case SND_SOC_BIAS_PREPARE:
  449. switch (codec->bias_level) {
  450. case SND_SOC_BIAS_STANDBY:
  451. /* Enable anti pop mode */
  452. snd_soc_update_bits(codec, WM8960_APOP1,
  453. WM8960_POBCTRL | WM8960_SOFT_ST |
  454. WM8960_BUFDCOPEN,
  455. WM8960_POBCTRL | WM8960_SOFT_ST |
  456. WM8960_BUFDCOPEN);
  457. /* Enable LOUT1, ROUT1 and OUT3 if they're enabled */
  458. reg = 0;
  459. if (wm8960->lout1 && wm8960->lout1->power)
  460. reg |= WM8960_PWR2_LOUT1;
  461. if (wm8960->rout1 && wm8960->rout1->power)
  462. reg |= WM8960_PWR2_ROUT1;
  463. if (wm8960->out3 && wm8960->out3->power)
  464. reg |= WM8960_PWR2_OUT3;
  465. snd_soc_update_bits(codec, WM8960_POWER2,
  466. WM8960_PWR2_LOUT1 |
  467. WM8960_PWR2_ROUT1 |
  468. WM8960_PWR2_OUT3, reg);
  469. /* Enable VMID at 2*50k */
  470. snd_soc_update_bits(codec, WM8960_POWER1,
  471. WM8960_VMID_MASK, 0x80);
  472. /* Ramp */
  473. msleep(100);
  474. /* Enable VREF */
  475. snd_soc_update_bits(codec, WM8960_POWER1,
  476. WM8960_VREF, WM8960_VREF);
  477. msleep(100);
  478. break;
  479. case SND_SOC_BIAS_ON:
  480. /* Enable anti-pop mode */
  481. snd_soc_update_bits(codec, WM8960_APOP1,
  482. WM8960_POBCTRL | WM8960_SOFT_ST |
  483. WM8960_BUFDCOPEN,
  484. WM8960_POBCTRL | WM8960_SOFT_ST |
  485. WM8960_BUFDCOPEN);
  486. /* Disable VMID and VREF */
  487. snd_soc_update_bits(codec, WM8960_POWER1,
  488. WM8960_VREF | WM8960_VMID_MASK, 0);
  489. break;
  490. default:
  491. break;
  492. }
  493. break;
  494. case SND_SOC_BIAS_STANDBY:
  495. switch (codec->bias_level) {
  496. case SND_SOC_BIAS_PREPARE:
  497. /* Disable HP discharge */
  498. snd_soc_update_bits(codec, WM8960_APOP2,
  499. WM8960_DISOP | WM8960_DRES_MASK,
  500. 0);
  501. /* Disable anti-pop features */
  502. snd_soc_update_bits(codec, WM8960_APOP1,
  503. WM8960_POBCTRL | WM8960_SOFT_ST |
  504. WM8960_BUFDCOPEN,
  505. WM8960_POBCTRL | WM8960_SOFT_ST |
  506. WM8960_BUFDCOPEN);
  507. break;
  508. default:
  509. break;
  510. }
  511. break;
  512. case SND_SOC_BIAS_OFF:
  513. break;
  514. }
  515. codec->bias_level = level;
  516. return 0;
  517. }
  518. /* PLL divisors */
  519. struct _pll_div {
  520. u32 pre_div:1;
  521. u32 n:4;
  522. u32 k:24;
  523. };
  524. /* The size in bits of the pll divide multiplied by 10
  525. * to allow rounding later */
  526. #define FIXED_PLL_SIZE ((1 << 24) * 10)
  527. static int pll_factors(unsigned int source, unsigned int target,
  528. struct _pll_div *pll_div)
  529. {
  530. unsigned long long Kpart;
  531. unsigned int K, Ndiv, Nmod;
  532. pr_debug("WM8960 PLL: setting %dHz->%dHz\n", source, target);
  533. /* Scale up target to PLL operating frequency */
  534. target *= 4;
  535. Ndiv = target / source;
  536. if (Ndiv < 6) {
  537. source >>= 1;
  538. pll_div->pre_div = 1;
  539. Ndiv = target / source;
  540. } else
  541. pll_div->pre_div = 0;
  542. if ((Ndiv < 6) || (Ndiv > 12)) {
  543. pr_err("WM8960 PLL: Unsupported N=%d\n", Ndiv);
  544. return -EINVAL;
  545. }
  546. pll_div->n = Ndiv;
  547. Nmod = target % source;
  548. Kpart = FIXED_PLL_SIZE * (long long)Nmod;
  549. do_div(Kpart, source);
  550. K = Kpart & 0xFFFFFFFF;
  551. /* Check if we need to round */
  552. if ((K % 10) >= 5)
  553. K += 5;
  554. /* Move down to proper range now rounding is done */
  555. K /= 10;
  556. pll_div->k = K;
  557. pr_debug("WM8960 PLL: N=%x K=%x pre_div=%d\n",
  558. pll_div->n, pll_div->k, pll_div->pre_div);
  559. return 0;
  560. }
  561. static int wm8960_set_dai_pll(struct snd_soc_dai *codec_dai, int pll_id,
  562. int source, unsigned int freq_in, unsigned int freq_out)
  563. {
  564. struct snd_soc_codec *codec = codec_dai->codec;
  565. u16 reg;
  566. static struct _pll_div pll_div;
  567. int ret;
  568. if (freq_in && freq_out) {
  569. ret = pll_factors(freq_in, freq_out, &pll_div);
  570. if (ret != 0)
  571. return ret;
  572. }
  573. /* Disable the PLL: even if we are changing the frequency the
  574. * PLL needs to be disabled while we do so. */
  575. snd_soc_write(codec, WM8960_CLOCK1,
  576. snd_soc_read(codec, WM8960_CLOCK1) & ~1);
  577. snd_soc_write(codec, WM8960_POWER2,
  578. snd_soc_read(codec, WM8960_POWER2) & ~1);
  579. if (!freq_in || !freq_out)
  580. return 0;
  581. reg = snd_soc_read(codec, WM8960_PLL1) & ~0x3f;
  582. reg |= pll_div.pre_div << 4;
  583. reg |= pll_div.n;
  584. if (pll_div.k) {
  585. reg |= 0x20;
  586. snd_soc_write(codec, WM8960_PLL2, (pll_div.k >> 18) & 0x3f);
  587. snd_soc_write(codec, WM8960_PLL3, (pll_div.k >> 9) & 0x1ff);
  588. snd_soc_write(codec, WM8960_PLL4, pll_div.k & 0x1ff);
  589. }
  590. snd_soc_write(codec, WM8960_PLL1, reg);
  591. /* Turn it on */
  592. snd_soc_write(codec, WM8960_POWER2,
  593. snd_soc_read(codec, WM8960_POWER2) | 1);
  594. msleep(250);
  595. snd_soc_write(codec, WM8960_CLOCK1,
  596. snd_soc_read(codec, WM8960_CLOCK1) | 1);
  597. return 0;
  598. }
  599. static int wm8960_set_dai_clkdiv(struct snd_soc_dai *codec_dai,
  600. int div_id, int div)
  601. {
  602. struct snd_soc_codec *codec = codec_dai->codec;
  603. u16 reg;
  604. switch (div_id) {
  605. case WM8960_SYSCLKDIV:
  606. reg = snd_soc_read(codec, WM8960_CLOCK1) & 0x1f9;
  607. snd_soc_write(codec, WM8960_CLOCK1, reg | div);
  608. break;
  609. case WM8960_DACDIV:
  610. reg = snd_soc_read(codec, WM8960_CLOCK1) & 0x1c7;
  611. snd_soc_write(codec, WM8960_CLOCK1, reg | div);
  612. break;
  613. case WM8960_OPCLKDIV:
  614. reg = snd_soc_read(codec, WM8960_PLL1) & 0x03f;
  615. snd_soc_write(codec, WM8960_PLL1, reg | div);
  616. break;
  617. case WM8960_DCLKDIV:
  618. reg = snd_soc_read(codec, WM8960_CLOCK2) & 0x03f;
  619. snd_soc_write(codec, WM8960_CLOCK2, reg | div);
  620. break;
  621. case WM8960_TOCLKSEL:
  622. reg = snd_soc_read(codec, WM8960_ADDCTL1) & 0x1fd;
  623. snd_soc_write(codec, WM8960_ADDCTL1, reg | div);
  624. break;
  625. default:
  626. return -EINVAL;
  627. }
  628. return 0;
  629. }
  630. #define WM8960_RATES SNDRV_PCM_RATE_8000_48000
  631. #define WM8960_FORMATS \
  632. (SNDRV_PCM_FMTBIT_S16_LE | SNDRV_PCM_FMTBIT_S20_3LE | \
  633. SNDRV_PCM_FMTBIT_S24_LE)
  634. static struct snd_soc_dai_ops wm8960_dai_ops = {
  635. .hw_params = wm8960_hw_params,
  636. .digital_mute = wm8960_mute,
  637. .set_fmt = wm8960_set_dai_fmt,
  638. .set_clkdiv = wm8960_set_dai_clkdiv,
  639. .set_pll = wm8960_set_dai_pll,
  640. };
  641. struct snd_soc_dai wm8960_dai = {
  642. .name = "WM8960",
  643. .playback = {
  644. .stream_name = "Playback",
  645. .channels_min = 1,
  646. .channels_max = 2,
  647. .rates = WM8960_RATES,
  648. .formats = WM8960_FORMATS,},
  649. .capture = {
  650. .stream_name = "Capture",
  651. .channels_min = 1,
  652. .channels_max = 2,
  653. .rates = WM8960_RATES,
  654. .formats = WM8960_FORMATS,},
  655. .ops = &wm8960_dai_ops,
  656. .symmetric_rates = 1,
  657. };
  658. EXPORT_SYMBOL_GPL(wm8960_dai);
  659. static int wm8960_suspend(struct platform_device *pdev, pm_message_t state)
  660. {
  661. struct snd_soc_device *socdev = platform_get_drvdata(pdev);
  662. struct snd_soc_codec *codec = socdev->card->codec;
  663. codec->set_bias_level(codec, SND_SOC_BIAS_OFF);
  664. return 0;
  665. }
  666. static int wm8960_resume(struct platform_device *pdev)
  667. {
  668. struct snd_soc_device *socdev = platform_get_drvdata(pdev);
  669. struct snd_soc_codec *codec = socdev->card->codec;
  670. int i;
  671. u8 data[2];
  672. u16 *cache = codec->reg_cache;
  673. /* Sync reg_cache with the hardware */
  674. for (i = 0; i < ARRAY_SIZE(wm8960_reg); i++) {
  675. data[0] = (i << 1) | ((cache[i] >> 8) & 0x0001);
  676. data[1] = cache[i] & 0x00ff;
  677. codec->hw_write(codec->control_data, data, 2);
  678. }
  679. codec->set_bias_level(codec, SND_SOC_BIAS_STANDBY);
  680. return 0;
  681. }
  682. static struct snd_soc_codec *wm8960_codec;
  683. static int wm8960_probe(struct platform_device *pdev)
  684. {
  685. struct snd_soc_device *socdev = platform_get_drvdata(pdev);
  686. struct snd_soc_codec *codec;
  687. int ret = 0;
  688. if (wm8960_codec == NULL) {
  689. dev_err(&pdev->dev, "Codec device not registered\n");
  690. return -ENODEV;
  691. }
  692. socdev->card->codec = wm8960_codec;
  693. codec = wm8960_codec;
  694. /* register pcms */
  695. ret = snd_soc_new_pcms(socdev, SNDRV_DEFAULT_IDX1, SNDRV_DEFAULT_STR1);
  696. if (ret < 0) {
  697. dev_err(codec->dev, "failed to create pcms: %d\n", ret);
  698. goto pcm_err;
  699. }
  700. snd_soc_add_controls(codec, wm8960_snd_controls,
  701. ARRAY_SIZE(wm8960_snd_controls));
  702. wm8960_add_widgets(codec);
  703. return ret;
  704. pcm_err:
  705. return ret;
  706. }
  707. /* power down chip */
  708. static int wm8960_remove(struct platform_device *pdev)
  709. {
  710. struct snd_soc_device *socdev = platform_get_drvdata(pdev);
  711. snd_soc_free_pcms(socdev);
  712. snd_soc_dapm_free(socdev);
  713. return 0;
  714. }
  715. struct snd_soc_codec_device soc_codec_dev_wm8960 = {
  716. .probe = wm8960_probe,
  717. .remove = wm8960_remove,
  718. .suspend = wm8960_suspend,
  719. .resume = wm8960_resume,
  720. };
  721. EXPORT_SYMBOL_GPL(soc_codec_dev_wm8960);
  722. static int wm8960_register(struct wm8960_priv *wm8960,
  723. enum snd_soc_control_type control)
  724. {
  725. struct wm8960_data *pdata = wm8960->codec.dev->platform_data;
  726. struct snd_soc_codec *codec = &wm8960->codec;
  727. int ret;
  728. u16 reg;
  729. if (wm8960_codec) {
  730. dev_err(codec->dev, "Another WM8960 is registered\n");
  731. ret = -EINVAL;
  732. goto err;
  733. }
  734. codec->set_bias_level = wm8960_set_bias_level_out3;
  735. if (!pdata) {
  736. dev_warn(codec->dev, "No platform data supplied\n");
  737. } else {
  738. if (pdata->dres > WM8960_DRES_MAX) {
  739. dev_err(codec->dev, "Invalid DRES: %d\n", pdata->dres);
  740. pdata->dres = 0;
  741. }
  742. if (pdata->capless)
  743. codec->set_bias_level = wm8960_set_bias_level_capless;
  744. }
  745. mutex_init(&codec->mutex);
  746. INIT_LIST_HEAD(&codec->dapm_widgets);
  747. INIT_LIST_HEAD(&codec->dapm_paths);
  748. snd_soc_codec_set_drvdata(codec, wm8960);
  749. codec->name = "WM8960";
  750. codec->owner = THIS_MODULE;
  751. codec->bias_level = SND_SOC_BIAS_OFF;
  752. codec->dai = &wm8960_dai;
  753. codec->num_dai = 1;
  754. codec->reg_cache_size = WM8960_CACHEREGNUM;
  755. codec->reg_cache = &wm8960->reg_cache;
  756. memcpy(codec->reg_cache, wm8960_reg, sizeof(wm8960_reg));
  757. ret = snd_soc_codec_set_cache_io(codec, 7, 9, control);
  758. if (ret < 0) {
  759. dev_err(codec->dev, "Failed to set cache I/O: %d\n", ret);
  760. goto err;
  761. }
  762. ret = wm8960_reset(codec);
  763. if (ret < 0) {
  764. dev_err(codec->dev, "Failed to issue reset\n");
  765. goto err;
  766. }
  767. wm8960_dai.dev = codec->dev;
  768. codec->set_bias_level(codec, SND_SOC_BIAS_STANDBY);
  769. /* Latch the update bits */
  770. reg = snd_soc_read(codec, WM8960_LINVOL);
  771. snd_soc_write(codec, WM8960_LINVOL, reg | 0x100);
  772. reg = snd_soc_read(codec, WM8960_RINVOL);
  773. snd_soc_write(codec, WM8960_RINVOL, reg | 0x100);
  774. reg = snd_soc_read(codec, WM8960_LADC);
  775. snd_soc_write(codec, WM8960_LADC, reg | 0x100);
  776. reg = snd_soc_read(codec, WM8960_RADC);
  777. snd_soc_write(codec, WM8960_RADC, reg | 0x100);
  778. reg = snd_soc_read(codec, WM8960_LDAC);
  779. snd_soc_write(codec, WM8960_LDAC, reg | 0x100);
  780. reg = snd_soc_read(codec, WM8960_RDAC);
  781. snd_soc_write(codec, WM8960_RDAC, reg | 0x100);
  782. reg = snd_soc_read(codec, WM8960_LOUT1);
  783. snd_soc_write(codec, WM8960_LOUT1, reg | 0x100);
  784. reg = snd_soc_read(codec, WM8960_ROUT1);
  785. snd_soc_write(codec, WM8960_ROUT1, reg | 0x100);
  786. reg = snd_soc_read(codec, WM8960_LOUT2);
  787. snd_soc_write(codec, WM8960_LOUT2, reg | 0x100);
  788. reg = snd_soc_read(codec, WM8960_ROUT2);
  789. snd_soc_write(codec, WM8960_ROUT2, reg | 0x100);
  790. wm8960_codec = codec;
  791. ret = snd_soc_register_codec(codec);
  792. if (ret != 0) {
  793. dev_err(codec->dev, "Failed to register codec: %d\n", ret);
  794. goto err;
  795. }
  796. ret = snd_soc_register_dai(&wm8960_dai);
  797. if (ret != 0) {
  798. dev_err(codec->dev, "Failed to register DAI: %d\n", ret);
  799. goto err_codec;
  800. }
  801. return 0;
  802. err_codec:
  803. snd_soc_unregister_codec(codec);
  804. err:
  805. kfree(wm8960);
  806. return ret;
  807. }
  808. static void wm8960_unregister(struct wm8960_priv *wm8960)
  809. {
  810. wm8960->codec.set_bias_level(&wm8960->codec, SND_SOC_BIAS_OFF);
  811. snd_soc_unregister_dai(&wm8960_dai);
  812. snd_soc_unregister_codec(&wm8960->codec);
  813. kfree(wm8960);
  814. wm8960_codec = NULL;
  815. }
  816. static __devinit int wm8960_i2c_probe(struct i2c_client *i2c,
  817. const struct i2c_device_id *id)
  818. {
  819. struct wm8960_priv *wm8960;
  820. struct snd_soc_codec *codec;
  821. wm8960 = kzalloc(sizeof(struct wm8960_priv), GFP_KERNEL);
  822. if (wm8960 == NULL)
  823. return -ENOMEM;
  824. codec = &wm8960->codec;
  825. i2c_set_clientdata(i2c, wm8960);
  826. codec->control_data = i2c;
  827. codec->dev = &i2c->dev;
  828. return wm8960_register(wm8960, SND_SOC_I2C);
  829. }
  830. static __devexit int wm8960_i2c_remove(struct i2c_client *client)
  831. {
  832. struct wm8960_priv *wm8960 = i2c_get_clientdata(client);
  833. wm8960_unregister(wm8960);
  834. return 0;
  835. }
  836. static const struct i2c_device_id wm8960_i2c_id[] = {
  837. { "wm8960", 0 },
  838. { }
  839. };
  840. MODULE_DEVICE_TABLE(i2c, wm8960_i2c_id);
  841. static struct i2c_driver wm8960_i2c_driver = {
  842. .driver = {
  843. .name = "wm8960",
  844. .owner = THIS_MODULE,
  845. },
  846. .probe = wm8960_i2c_probe,
  847. .remove = __devexit_p(wm8960_i2c_remove),
  848. .id_table = wm8960_i2c_id,
  849. };
  850. static int __init wm8960_modinit(void)
  851. {
  852. int ret;
  853. ret = i2c_add_driver(&wm8960_i2c_driver);
  854. if (ret != 0) {
  855. printk(KERN_ERR "Failed to register WM8960 I2C driver: %d\n",
  856. ret);
  857. }
  858. return ret;
  859. }
  860. module_init(wm8960_modinit);
  861. static void __exit wm8960_exit(void)
  862. {
  863. i2c_del_driver(&wm8960_i2c_driver);
  864. }
  865. module_exit(wm8960_exit);
  866. MODULE_DESCRIPTION("ASoC WM8960 driver");
  867. MODULE_AUTHOR("Liam Girdwood");
  868. MODULE_LICENSE("GPL");