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