2 * arizona.c - Wolfson Arizona class device shared support
4 * Copyright 2012 Wolfson Microelectronics plc
6 * Author: Mark Brown <broonie@opensource.wolfsonmicro.com>
8 * This program is free software; you can redistribute it and/or modify
9 * it under the terms of the GNU General Public License version 2 as
10 * published by the Free Software Foundation.
13 #include <linux/delay.h>
14 #include <linux/gcd.h>
15 #include <linux/module.h>
16 #include <linux/pm_runtime.h>
17 #include <sound/pcm.h>
18 #include <sound/pcm_params.h>
19 #include <sound/tlv.h>
21 #include <linux/mfd/arizona/core.h>
22 #include <linux/mfd/arizona/gpio.h>
23 #include <linux/mfd/arizona/registers.h>
27 #define ARIZONA_AIF_BCLK_CTRL 0x00
28 #define ARIZONA_AIF_TX_PIN_CTRL 0x01
29 #define ARIZONA_AIF_RX_PIN_CTRL 0x02
30 #define ARIZONA_AIF_RATE_CTRL 0x03
31 #define ARIZONA_AIF_FORMAT 0x04
32 #define ARIZONA_AIF_TX_BCLK_RATE 0x05
33 #define ARIZONA_AIF_RX_BCLK_RATE 0x06
34 #define ARIZONA_AIF_FRAME_CTRL_1 0x07
35 #define ARIZONA_AIF_FRAME_CTRL_2 0x08
36 #define ARIZONA_AIF_FRAME_CTRL_3 0x09
37 #define ARIZONA_AIF_FRAME_CTRL_4 0x0A
38 #define ARIZONA_AIF_FRAME_CTRL_5 0x0B
39 #define ARIZONA_AIF_FRAME_CTRL_6 0x0C
40 #define ARIZONA_AIF_FRAME_CTRL_7 0x0D
41 #define ARIZONA_AIF_FRAME_CTRL_8 0x0E
42 #define ARIZONA_AIF_FRAME_CTRL_9 0x0F
43 #define ARIZONA_AIF_FRAME_CTRL_10 0x10
44 #define ARIZONA_AIF_FRAME_CTRL_11 0x11
45 #define ARIZONA_AIF_FRAME_CTRL_12 0x12
46 #define ARIZONA_AIF_FRAME_CTRL_13 0x13
47 #define ARIZONA_AIF_FRAME_CTRL_14 0x14
48 #define ARIZONA_AIF_FRAME_CTRL_15 0x15
49 #define ARIZONA_AIF_FRAME_CTRL_16 0x16
50 #define ARIZONA_AIF_FRAME_CTRL_17 0x17
51 #define ARIZONA_AIF_FRAME_CTRL_18 0x18
52 #define ARIZONA_AIF_TX_ENABLES 0x19
53 #define ARIZONA_AIF_RX_ENABLES 0x1A
54 #define ARIZONA_AIF_FORCE_WRITE 0x1B
56 #define arizona_fll_err(_fll, fmt, ...) \
57 dev_err(_fll->arizona->dev, "FLL%d: " fmt, _fll->id, ##__VA_ARGS__)
58 #define arizona_fll_warn(_fll, fmt, ...) \
59 dev_warn(_fll->arizona->dev, "FLL%d: " fmt, _fll->id, ##__VA_ARGS__)
60 #define arizona_fll_dbg(_fll, fmt, ...) \
61 dev_dbg(_fll->arizona->dev, "FLL%d: " fmt, _fll->id, ##__VA_ARGS__)
63 #define arizona_aif_err(_dai, fmt, ...) \
64 dev_err(_dai->dev, "AIF%d: " fmt, _dai->id, ##__VA_ARGS__)
65 #define arizona_aif_warn(_dai, fmt, ...) \
66 dev_warn(_dai->dev, "AIF%d: " fmt, _dai->id, ##__VA_ARGS__)
67 #define arizona_aif_dbg(_dai, fmt, ...) \
68 dev_dbg(_dai->dev, "AIF%d: " fmt, _dai->id, ##__VA_ARGS__)
70 static int arizona_spk_ev(struct snd_soc_dapm_widget *w,
71 struct snd_kcontrol *kcontrol,
74 struct snd_soc_codec *codec = w->codec;
75 struct arizona *arizona = dev_get_drvdata(codec->dev->parent);
76 struct arizona_priv *priv = snd_soc_codec_get_drvdata(codec);
77 bool manual_ena = false;
80 switch (arizona->type) {
82 switch (arizona->rev) {
94 case SND_SOC_DAPM_PRE_PMU:
95 if (!priv->spk_ena && manual_ena) {
96 snd_soc_write(codec, 0x4f5, 0x25a);
97 priv->spk_ena_pending = true;
100 case SND_SOC_DAPM_POST_PMU:
101 val = snd_soc_read(codec, ARIZONA_INTERRUPT_RAW_STATUS_3);
102 if (val & ARIZONA_SPK_SHUTDOWN_STS) {
103 dev_crit(arizona->dev,
104 "Speaker not enabled due to temperature\n");
108 snd_soc_update_bits(codec, ARIZONA_OUTPUT_ENABLES_1,
109 1 << w->shift, 1 << w->shift);
111 if (priv->spk_ena_pending) {
113 snd_soc_write(codec, 0x4f5, 0xda);
114 priv->spk_ena_pending = false;
118 case SND_SOC_DAPM_PRE_PMD:
122 snd_soc_write(codec, 0x4f5, 0x25a);
125 snd_soc_update_bits(codec, ARIZONA_OUTPUT_ENABLES_1,
128 case SND_SOC_DAPM_POST_PMD:
131 snd_soc_write(codec, 0x4f5, 0x0da);
139 static irqreturn_t arizona_thermal_warn(int irq, void *data)
141 struct arizona *arizona = data;
145 ret = regmap_read(arizona->regmap, ARIZONA_INTERRUPT_RAW_STATUS_3,
148 dev_err(arizona->dev, "Failed to read thermal status: %d\n",
150 } else if (val & ARIZONA_SPK_SHUTDOWN_WARN_STS) {
151 dev_crit(arizona->dev, "Thermal warning\n");
157 static irqreturn_t arizona_thermal_shutdown(int irq, void *data)
159 struct arizona *arizona = data;
163 ret = regmap_read(arizona->regmap, ARIZONA_INTERRUPT_RAW_STATUS_3,
166 dev_err(arizona->dev, "Failed to read thermal status: %d\n",
168 } else if (val & ARIZONA_SPK_SHUTDOWN_STS) {
169 dev_crit(arizona->dev, "Thermal shutdown\n");
170 ret = regmap_update_bits(arizona->regmap,
171 ARIZONA_OUTPUT_ENABLES_1,
173 ARIZONA_OUT4R_ENA, 0);
175 dev_crit(arizona->dev,
176 "Failed to disable speaker outputs: %d\n",
183 static const struct snd_soc_dapm_widget arizona_spkl =
184 SND_SOC_DAPM_PGA_E("OUT4L", SND_SOC_NOPM,
185 ARIZONA_OUT4L_ENA_SHIFT, 0, NULL, 0, arizona_spk_ev,
186 SND_SOC_DAPM_PRE_PMD | SND_SOC_DAPM_POST_PMU);
188 static const struct snd_soc_dapm_widget arizona_spkr =
189 SND_SOC_DAPM_PGA_E("OUT4R", SND_SOC_NOPM,
190 ARIZONA_OUT4R_ENA_SHIFT, 0, NULL, 0, arizona_spk_ev,
191 SND_SOC_DAPM_PRE_PMD | SND_SOC_DAPM_POST_PMU);
193 int arizona_init_spk(struct snd_soc_codec *codec)
195 struct arizona_priv *priv = snd_soc_codec_get_drvdata(codec);
196 struct arizona *arizona = priv->arizona;
199 ret = snd_soc_dapm_new_controls(&codec->dapm, &arizona_spkl, 1);
203 switch (arizona->type) {
207 ret = snd_soc_dapm_new_controls(&codec->dapm,
214 ret = arizona_request_irq(arizona, ARIZONA_IRQ_SPK_SHUTDOWN_WARN,
215 "Thermal warning", arizona_thermal_warn,
218 dev_err(arizona->dev,
219 "Failed to get thermal warning IRQ: %d\n",
222 ret = arizona_request_irq(arizona, ARIZONA_IRQ_SPK_SHUTDOWN,
223 "Thermal shutdown", arizona_thermal_shutdown,
226 dev_err(arizona->dev,
227 "Failed to get thermal shutdown IRQ: %d\n",
232 EXPORT_SYMBOL_GPL(arizona_init_spk);
234 int arizona_init_gpio(struct snd_soc_codec *codec)
236 struct arizona_priv *priv = snd_soc_codec_get_drvdata(codec);
237 struct arizona *arizona = priv->arizona;
240 switch (arizona->type) {
242 snd_soc_dapm_disable_pin(&codec->dapm, "DRC2 Signal Activity");
248 snd_soc_dapm_disable_pin(&codec->dapm, "DRC1 Signal Activity");
250 for (i = 0; i < ARRAY_SIZE(arizona->pdata.gpio_defaults); i++) {
251 switch (arizona->pdata.gpio_defaults[i] & ARIZONA_GPN_FN_MASK) {
252 case ARIZONA_GP_FN_DRC1_SIGNAL_DETECT:
253 snd_soc_dapm_enable_pin(&codec->dapm,
254 "DRC1 Signal Activity");
256 case ARIZONA_GP_FN_DRC2_SIGNAL_DETECT:
257 snd_soc_dapm_enable_pin(&codec->dapm,
258 "DRC2 Signal Activity");
267 EXPORT_SYMBOL_GPL(arizona_init_gpio);
269 const char *arizona_mixer_texts[ARIZONA_NUM_MIXER_INPUTS] = {
374 EXPORT_SYMBOL_GPL(arizona_mixer_texts);
376 int arizona_mixer_values[ARIZONA_NUM_MIXER_INPUTS] = {
382 0x0c, /* Noise mixer */
383 0x0d, /* Comfort noise */
456 0xa0, /* ISRC1INT1 */
460 0xa4, /* ISRC1DEC1 */
464 0xa8, /* ISRC2DEC1 */
468 0xac, /* ISRC2INT1 */
472 0xb0, /* ISRC3DEC1 */
476 0xb4, /* ISRC3INT1 */
481 EXPORT_SYMBOL_GPL(arizona_mixer_values);
483 const DECLARE_TLV_DB_SCALE(arizona_mixer_tlv, -3200, 100, 0);
484 EXPORT_SYMBOL_GPL(arizona_mixer_tlv);
486 const char *arizona_rate_text[ARIZONA_RATE_ENUM_SIZE] = {
487 "SYNCCLK rate", "8kHz", "16kHz", "ASYNCCLK rate",
489 EXPORT_SYMBOL_GPL(arizona_rate_text);
491 const int arizona_rate_val[ARIZONA_RATE_ENUM_SIZE] = {
494 EXPORT_SYMBOL_GPL(arizona_rate_val);
497 const struct soc_enum arizona_isrc_fsl[] = {
498 SOC_VALUE_ENUM_SINGLE(ARIZONA_ISRC_1_CTRL_2,
499 ARIZONA_ISRC1_FSL_SHIFT, 0xf,
500 ARIZONA_RATE_ENUM_SIZE,
501 arizona_rate_text, arizona_rate_val),
502 SOC_VALUE_ENUM_SINGLE(ARIZONA_ISRC_2_CTRL_2,
503 ARIZONA_ISRC2_FSL_SHIFT, 0xf,
504 ARIZONA_RATE_ENUM_SIZE,
505 arizona_rate_text, arizona_rate_val),
506 SOC_VALUE_ENUM_SINGLE(ARIZONA_ISRC_3_CTRL_2,
507 ARIZONA_ISRC3_FSL_SHIFT, 0xf,
508 ARIZONA_RATE_ENUM_SIZE,
509 arizona_rate_text, arizona_rate_val),
511 EXPORT_SYMBOL_GPL(arizona_isrc_fsl);
513 static const char *arizona_vol_ramp_text[] = {
514 "0ms/6dB", "0.5ms/6dB", "1ms/6dB", "2ms/6dB", "4ms/6dB", "8ms/6dB",
515 "15ms/6dB", "30ms/6dB",
518 const struct soc_enum arizona_in_vd_ramp =
519 SOC_ENUM_SINGLE(ARIZONA_INPUT_VOLUME_RAMP,
520 ARIZONA_IN_VD_RAMP_SHIFT, 7, arizona_vol_ramp_text);
521 EXPORT_SYMBOL_GPL(arizona_in_vd_ramp);
523 const struct soc_enum arizona_in_vi_ramp =
524 SOC_ENUM_SINGLE(ARIZONA_INPUT_VOLUME_RAMP,
525 ARIZONA_IN_VI_RAMP_SHIFT, 7, arizona_vol_ramp_text);
526 EXPORT_SYMBOL_GPL(arizona_in_vi_ramp);
528 const struct soc_enum arizona_out_vd_ramp =
529 SOC_ENUM_SINGLE(ARIZONA_OUTPUT_VOLUME_RAMP,
530 ARIZONA_OUT_VD_RAMP_SHIFT, 7, arizona_vol_ramp_text);
531 EXPORT_SYMBOL_GPL(arizona_out_vd_ramp);
533 const struct soc_enum arizona_out_vi_ramp =
534 SOC_ENUM_SINGLE(ARIZONA_OUTPUT_VOLUME_RAMP,
535 ARIZONA_OUT_VI_RAMP_SHIFT, 7, arizona_vol_ramp_text);
536 EXPORT_SYMBOL_GPL(arizona_out_vi_ramp);
538 static const char *arizona_lhpf_mode_text[] = {
539 "Low-pass", "High-pass"
542 const struct soc_enum arizona_lhpf1_mode =
543 SOC_ENUM_SINGLE(ARIZONA_HPLPF1_1, ARIZONA_LHPF1_MODE_SHIFT, 2,
544 arizona_lhpf_mode_text);
545 EXPORT_SYMBOL_GPL(arizona_lhpf1_mode);
547 const struct soc_enum arizona_lhpf2_mode =
548 SOC_ENUM_SINGLE(ARIZONA_HPLPF2_1, ARIZONA_LHPF2_MODE_SHIFT, 2,
549 arizona_lhpf_mode_text);
550 EXPORT_SYMBOL_GPL(arizona_lhpf2_mode);
552 const struct soc_enum arizona_lhpf3_mode =
553 SOC_ENUM_SINGLE(ARIZONA_HPLPF3_1, ARIZONA_LHPF3_MODE_SHIFT, 2,
554 arizona_lhpf_mode_text);
555 EXPORT_SYMBOL_GPL(arizona_lhpf3_mode);
557 const struct soc_enum arizona_lhpf4_mode =
558 SOC_ENUM_SINGLE(ARIZONA_HPLPF4_1, ARIZONA_LHPF4_MODE_SHIFT, 2,
559 arizona_lhpf_mode_text);
560 EXPORT_SYMBOL_GPL(arizona_lhpf4_mode);
562 static const char *arizona_ng_hold_text[] = {
563 "30ms", "120ms", "250ms", "500ms",
566 const struct soc_enum arizona_ng_hold =
567 SOC_ENUM_SINGLE(ARIZONA_NOISE_GATE_CONTROL, ARIZONA_NGATE_HOLD_SHIFT,
568 4, arizona_ng_hold_text);
569 EXPORT_SYMBOL_GPL(arizona_ng_hold);
571 static const char * const arizona_in_hpf_cut_text[] = {
572 "2.5Hz", "5Hz", "10Hz", "20Hz", "40Hz"
575 const struct soc_enum arizona_in_hpf_cut_enum =
576 SOC_ENUM_SINGLE(ARIZONA_HPF_CONTROL, ARIZONA_IN_HPF_CUT_SHIFT,
577 ARRAY_SIZE(arizona_in_hpf_cut_text),
578 arizona_in_hpf_cut_text);
579 EXPORT_SYMBOL_GPL(arizona_in_hpf_cut_enum);
581 static const char * const arizona_in_dmic_osr_text[] = {
582 "1.536MHz", "3.072MHz", "6.144MHz",
585 const struct soc_enum arizona_in_dmic_osr[] = {
586 SOC_ENUM_SINGLE(ARIZONA_IN1L_CONTROL, ARIZONA_IN1_OSR_SHIFT,
587 ARRAY_SIZE(arizona_in_dmic_osr_text),
588 arizona_in_dmic_osr_text),
589 SOC_ENUM_SINGLE(ARIZONA_IN2L_CONTROL, ARIZONA_IN2_OSR_SHIFT,
590 ARRAY_SIZE(arizona_in_dmic_osr_text),
591 arizona_in_dmic_osr_text),
592 SOC_ENUM_SINGLE(ARIZONA_IN3L_CONTROL, ARIZONA_IN3_OSR_SHIFT,
593 ARRAY_SIZE(arizona_in_dmic_osr_text),
594 arizona_in_dmic_osr_text),
595 SOC_ENUM_SINGLE(ARIZONA_IN4L_CONTROL, ARIZONA_IN4_OSR_SHIFT,
596 ARRAY_SIZE(arizona_in_dmic_osr_text),
597 arizona_in_dmic_osr_text),
599 EXPORT_SYMBOL_GPL(arizona_in_dmic_osr);
601 static void arizona_in_set_vu(struct snd_soc_codec *codec, int ena)
603 struct arizona_priv *priv = snd_soc_codec_get_drvdata(codec);
612 for (i = 0; i < priv->num_inputs; i++)
613 snd_soc_update_bits(codec,
614 ARIZONA_ADC_DIGITAL_VOLUME_1L + (i * 4),
618 int arizona_in_ev(struct snd_soc_dapm_widget *w, struct snd_kcontrol *kcontrol,
621 struct arizona_priv *priv = snd_soc_codec_get_drvdata(w->codec);
625 reg = ARIZONA_ADC_DIGITAL_VOLUME_1L + ((w->shift / 2) * 8);
627 reg = ARIZONA_ADC_DIGITAL_VOLUME_1R + ((w->shift / 2) * 8);
630 case SND_SOC_DAPM_PRE_PMU:
633 case SND_SOC_DAPM_POST_PMU:
634 snd_soc_update_bits(w->codec, reg, ARIZONA_IN1L_MUTE, 0);
636 /* If this is the last input pending then allow VU */
638 if (priv->in_pending == 0) {
640 arizona_in_set_vu(w->codec, 1);
643 case SND_SOC_DAPM_PRE_PMD:
644 snd_soc_update_bits(w->codec, reg,
645 ARIZONA_IN1L_MUTE | ARIZONA_IN_VU,
646 ARIZONA_IN1L_MUTE | ARIZONA_IN_VU);
648 case SND_SOC_DAPM_POST_PMD:
649 /* Disable volume updates if no inputs are enabled */
650 reg = snd_soc_read(w->codec, ARIZONA_INPUT_ENABLES);
652 arizona_in_set_vu(w->codec, 0);
657 EXPORT_SYMBOL_GPL(arizona_in_ev);
659 int arizona_out_ev(struct snd_soc_dapm_widget *w,
660 struct snd_kcontrol *kcontrol,
664 case SND_SOC_DAPM_POST_PMU:
666 case ARIZONA_OUT1L_ENA_SHIFT:
667 case ARIZONA_OUT1R_ENA_SHIFT:
668 case ARIZONA_OUT2L_ENA_SHIFT:
669 case ARIZONA_OUT2R_ENA_SHIFT:
670 case ARIZONA_OUT3L_ENA_SHIFT:
671 case ARIZONA_OUT3R_ENA_SHIFT:
683 EXPORT_SYMBOL_GPL(arizona_out_ev);
685 int arizona_hp_ev(struct snd_soc_dapm_widget *w,
686 struct snd_kcontrol *kcontrol,
689 struct arizona_priv *priv = snd_soc_codec_get_drvdata(w->codec);
690 unsigned int mask = 1 << w->shift;
694 case SND_SOC_DAPM_POST_PMU:
697 case SND_SOC_DAPM_PRE_PMD:
704 /* Store the desired state for the HP outputs */
705 priv->arizona->hp_ena &= ~mask;
706 priv->arizona->hp_ena |= val;
708 /* Force off if HPDET magic is active */
709 if (priv->arizona->hpdet_magic)
712 snd_soc_update_bits(w->codec, ARIZONA_OUTPUT_ENABLES_1, mask, val);
714 return arizona_out_ev(w, kcontrol, event);
716 EXPORT_SYMBOL_GPL(arizona_hp_ev);
718 static unsigned int arizona_sysclk_48k_rates[] = {
728 static unsigned int arizona_sysclk_44k1_rates[] = {
738 static int arizona_set_opclk(struct snd_soc_codec *codec, unsigned int clk,
741 struct arizona_priv *priv = snd_soc_codec_get_drvdata(codec);
744 int ref, div, refclk;
747 case ARIZONA_CLK_OPCLK:
748 reg = ARIZONA_OUTPUT_SYSTEM_CLOCK;
749 refclk = priv->sysclk;
751 case ARIZONA_CLK_ASYNC_OPCLK:
752 reg = ARIZONA_OUTPUT_ASYNC_CLOCK;
753 refclk = priv->asyncclk;
760 rates = arizona_sysclk_44k1_rates;
762 rates = arizona_sysclk_48k_rates;
764 for (ref = 0; ref < ARRAY_SIZE(arizona_sysclk_48k_rates) &&
765 rates[ref] <= refclk; ref++) {
767 while (rates[ref] / div >= freq && div < 32) {
768 if (rates[ref] / div == freq) {
769 dev_dbg(codec->dev, "Configured %dHz OPCLK\n",
771 snd_soc_update_bits(codec, reg,
772 ARIZONA_OPCLK_DIV_MASK |
773 ARIZONA_OPCLK_SEL_MASK,
775 ARIZONA_OPCLK_DIV_SHIFT) |
783 dev_err(codec->dev, "Unable to generate %dHz OPCLK\n", freq);
787 int arizona_set_sysclk(struct snd_soc_codec *codec, int clk_id,
788 int source, unsigned int freq, int dir)
790 struct arizona_priv *priv = snd_soc_codec_get_drvdata(codec);
791 struct arizona *arizona = priv->arizona;
794 unsigned int mask = ARIZONA_SYSCLK_FREQ_MASK | ARIZONA_SYSCLK_SRC_MASK;
795 unsigned int val = source << ARIZONA_SYSCLK_SRC_SHIFT;
799 case ARIZONA_CLK_SYSCLK:
801 reg = ARIZONA_SYSTEM_CLOCK_1;
803 mask |= ARIZONA_SYSCLK_FRAC;
805 case ARIZONA_CLK_ASYNCCLK:
807 reg = ARIZONA_ASYNC_CLOCK_1;
808 clk = &priv->asyncclk;
810 case ARIZONA_CLK_OPCLK:
811 case ARIZONA_CLK_ASYNC_OPCLK:
812 return arizona_set_opclk(codec, clk_id, freq);
823 val |= ARIZONA_CLK_12MHZ << ARIZONA_SYSCLK_FREQ_SHIFT;
827 val |= ARIZONA_CLK_24MHZ << ARIZONA_SYSCLK_FREQ_SHIFT;
831 val |= ARIZONA_CLK_49MHZ << ARIZONA_SYSCLK_FREQ_SHIFT;
835 val |= ARIZONA_CLK_73MHZ << ARIZONA_SYSCLK_FREQ_SHIFT;
839 val |= ARIZONA_CLK_98MHZ << ARIZONA_SYSCLK_FREQ_SHIFT;
843 val |= ARIZONA_CLK_147MHZ << ARIZONA_SYSCLK_FREQ_SHIFT;
846 dev_dbg(arizona->dev, "%s cleared\n", name);
856 val |= ARIZONA_SYSCLK_FRAC;
858 dev_dbg(arizona->dev, "%s set to %uHz", name, freq);
860 return regmap_update_bits(arizona->regmap, reg, mask, val);
862 EXPORT_SYMBOL_GPL(arizona_set_sysclk);
864 static int arizona_set_fmt(struct snd_soc_dai *dai, unsigned int fmt)
866 struct snd_soc_codec *codec = dai->codec;
867 int lrclk, bclk, mode, base;
869 base = dai->driver->base;
874 switch (fmt & SND_SOC_DAIFMT_FORMAT_MASK) {
875 case SND_SOC_DAIFMT_DSP_A:
878 case SND_SOC_DAIFMT_I2S:
882 arizona_aif_err(dai, "Unsupported DAI format %d\n",
883 fmt & SND_SOC_DAIFMT_FORMAT_MASK);
887 switch (fmt & SND_SOC_DAIFMT_MASTER_MASK) {
888 case SND_SOC_DAIFMT_CBS_CFS:
890 case SND_SOC_DAIFMT_CBS_CFM:
891 lrclk |= ARIZONA_AIF1TX_LRCLK_MSTR;
893 case SND_SOC_DAIFMT_CBM_CFS:
894 bclk |= ARIZONA_AIF1_BCLK_MSTR;
896 case SND_SOC_DAIFMT_CBM_CFM:
897 bclk |= ARIZONA_AIF1_BCLK_MSTR;
898 lrclk |= ARIZONA_AIF1TX_LRCLK_MSTR;
901 arizona_aif_err(dai, "Unsupported master mode %d\n",
902 fmt & SND_SOC_DAIFMT_MASTER_MASK);
906 switch (fmt & SND_SOC_DAIFMT_INV_MASK) {
907 case SND_SOC_DAIFMT_NB_NF:
909 case SND_SOC_DAIFMT_IB_IF:
910 bclk |= ARIZONA_AIF1_BCLK_INV;
911 lrclk |= ARIZONA_AIF1TX_LRCLK_INV;
913 case SND_SOC_DAIFMT_IB_NF:
914 bclk |= ARIZONA_AIF1_BCLK_INV;
916 case SND_SOC_DAIFMT_NB_IF:
917 lrclk |= ARIZONA_AIF1TX_LRCLK_INV;
923 snd_soc_update_bits(codec, base + ARIZONA_AIF_BCLK_CTRL,
924 ARIZONA_AIF1_BCLK_INV | ARIZONA_AIF1_BCLK_MSTR,
926 snd_soc_update_bits(codec, base + ARIZONA_AIF_TX_PIN_CTRL,
927 ARIZONA_AIF1TX_LRCLK_INV |
928 ARIZONA_AIF1TX_LRCLK_MSTR, lrclk);
929 snd_soc_update_bits(codec, base + ARIZONA_AIF_RX_PIN_CTRL,
930 ARIZONA_AIF1RX_LRCLK_INV |
931 ARIZONA_AIF1RX_LRCLK_MSTR, lrclk);
932 snd_soc_update_bits(codec, base + ARIZONA_AIF_FORMAT,
933 ARIZONA_AIF1_FMT_MASK, mode);
938 static const int arizona_48k_bclk_rates[] = {
960 static const unsigned int arizona_48k_rates[] = {
978 static const struct snd_pcm_hw_constraint_list arizona_48k_constraint = {
979 .count = ARRAY_SIZE(arizona_48k_rates),
980 .list = arizona_48k_rates,
983 static const int arizona_44k1_bclk_rates[] = {
1005 static const unsigned int arizona_44k1_rates[] = {
1015 static const struct snd_pcm_hw_constraint_list arizona_44k1_constraint = {
1016 .count = ARRAY_SIZE(arizona_44k1_rates),
1017 .list = arizona_44k1_rates,
1020 static int arizona_sr_vals[] = {
1047 static int arizona_startup(struct snd_pcm_substream *substream,
1048 struct snd_soc_dai *dai)
1050 struct snd_soc_codec *codec = dai->codec;
1051 struct arizona_priv *priv = snd_soc_codec_get_drvdata(codec);
1052 struct arizona_dai_priv *dai_priv = &priv->dai[dai->id - 1];
1053 const struct snd_pcm_hw_constraint_list *constraint;
1054 unsigned int base_rate;
1056 switch (dai_priv->clk) {
1057 case ARIZONA_CLK_SYSCLK:
1058 base_rate = priv->sysclk;
1060 case ARIZONA_CLK_ASYNCCLK:
1061 base_rate = priv->asyncclk;
1070 if (base_rate % 8000)
1071 constraint = &arizona_44k1_constraint;
1073 constraint = &arizona_48k_constraint;
1075 return snd_pcm_hw_constraint_list(substream->runtime, 0,
1076 SNDRV_PCM_HW_PARAM_RATE,
1080 static int arizona_hw_params_rate(struct snd_pcm_substream *substream,
1081 struct snd_pcm_hw_params *params,
1082 struct snd_soc_dai *dai)
1084 struct snd_soc_codec *codec = dai->codec;
1085 struct arizona_priv *priv = snd_soc_codec_get_drvdata(codec);
1086 struct arizona_dai_priv *dai_priv = &priv->dai[dai->id - 1];
1087 int base = dai->driver->base;
1091 * We will need to be more flexible than this in future,
1092 * currently we use a single sample rate for SYSCLK.
1094 for (i = 0; i < ARRAY_SIZE(arizona_sr_vals); i++)
1095 if (arizona_sr_vals[i] == params_rate(params))
1097 if (i == ARRAY_SIZE(arizona_sr_vals)) {
1098 arizona_aif_err(dai, "Unsupported sample rate %dHz\n",
1099 params_rate(params));
1104 switch (dai_priv->clk) {
1105 case ARIZONA_CLK_SYSCLK:
1106 snd_soc_update_bits(codec, ARIZONA_SAMPLE_RATE_1,
1107 ARIZONA_SAMPLE_RATE_1_MASK, sr_val);
1109 snd_soc_update_bits(codec, base + ARIZONA_AIF_RATE_CTRL,
1110 ARIZONA_AIF1_RATE_MASK, 0);
1112 case ARIZONA_CLK_ASYNCCLK:
1113 snd_soc_update_bits(codec, ARIZONA_ASYNC_SAMPLE_RATE_1,
1114 ARIZONA_ASYNC_SAMPLE_RATE_MASK, sr_val);
1116 snd_soc_update_bits(codec, base + ARIZONA_AIF_RATE_CTRL,
1117 ARIZONA_AIF1_RATE_MASK,
1118 8 << ARIZONA_AIF1_RATE_SHIFT);
1121 arizona_aif_err(dai, "Invalid clock %d\n", dai_priv->clk);
1128 static int arizona_hw_params(struct snd_pcm_substream *substream,
1129 struct snd_pcm_hw_params *params,
1130 struct snd_soc_dai *dai)
1132 struct snd_soc_codec *codec = dai->codec;
1133 struct arizona_priv *priv = snd_soc_codec_get_drvdata(codec);
1134 struct arizona *arizona = priv->arizona;
1135 int base = dai->driver->base;
1138 int chan_limit = arizona->pdata.max_channels_clocked[dai->id - 1];
1139 int bclk, lrclk, wl, frame, bclk_target;
1141 if (params_rate(params) % 8000)
1142 rates = &arizona_44k1_bclk_rates[0];
1144 rates = &arizona_48k_bclk_rates[0];
1146 bclk_target = snd_soc_params_to_bclk(params);
1147 if (chan_limit && chan_limit < params_channels(params)) {
1148 arizona_aif_dbg(dai, "Limiting to %d channels\n", chan_limit);
1149 bclk_target /= params_channels(params);
1150 bclk_target *= chan_limit;
1153 /* Force stereo for I2S mode */
1154 val = snd_soc_read(codec, base + ARIZONA_AIF_FORMAT);
1155 if (params_channels(params) == 1 && (val & ARIZONA_AIF1_FMT_MASK)) {
1156 arizona_aif_dbg(dai, "Forcing stereo mode\n");
1160 for (i = 0; i < ARRAY_SIZE(arizona_44k1_bclk_rates); i++) {
1161 if (rates[i] >= bclk_target &&
1162 rates[i] % params_rate(params) == 0) {
1167 if (i == ARRAY_SIZE(arizona_44k1_bclk_rates)) {
1168 arizona_aif_err(dai, "Unsupported sample rate %dHz\n",
1169 params_rate(params));
1173 lrclk = rates[bclk] / params_rate(params);
1175 arizona_aif_dbg(dai, "BCLK %dHz LRCLK %dHz\n",
1176 rates[bclk], rates[bclk] / lrclk);
1178 wl = snd_pcm_format_width(params_format(params));
1179 frame = wl << ARIZONA_AIF1TX_WL_SHIFT | wl;
1181 ret = arizona_hw_params_rate(substream, params, dai);
1185 snd_soc_update_bits(codec, base + ARIZONA_AIF_BCLK_CTRL,
1186 ARIZONA_AIF1_BCLK_FREQ_MASK, bclk);
1187 snd_soc_update_bits(codec, base + ARIZONA_AIF_TX_BCLK_RATE,
1188 ARIZONA_AIF1TX_BCPF_MASK, lrclk);
1189 snd_soc_update_bits(codec, base + ARIZONA_AIF_RX_BCLK_RATE,
1190 ARIZONA_AIF1RX_BCPF_MASK, lrclk);
1191 snd_soc_update_bits(codec, base + ARIZONA_AIF_FRAME_CTRL_1,
1192 ARIZONA_AIF1TX_WL_MASK |
1193 ARIZONA_AIF1TX_SLOT_LEN_MASK, frame);
1194 snd_soc_update_bits(codec, base + ARIZONA_AIF_FRAME_CTRL_2,
1195 ARIZONA_AIF1RX_WL_MASK |
1196 ARIZONA_AIF1RX_SLOT_LEN_MASK, frame);
1201 static const char *arizona_dai_clk_str(int clk_id)
1204 case ARIZONA_CLK_SYSCLK:
1206 case ARIZONA_CLK_ASYNCCLK:
1209 return "Unknown clock";
1213 static int arizona_dai_set_sysclk(struct snd_soc_dai *dai,
1214 int clk_id, unsigned int freq, int dir)
1216 struct snd_soc_codec *codec = dai->codec;
1217 struct arizona_priv *priv = snd_soc_codec_get_drvdata(codec);
1218 struct arizona_dai_priv *dai_priv = &priv->dai[dai->id - 1];
1219 struct snd_soc_dapm_route routes[2];
1222 case ARIZONA_CLK_SYSCLK:
1223 case ARIZONA_CLK_ASYNCCLK:
1229 if (clk_id == dai_priv->clk)
1233 dev_err(codec->dev, "Can't change clock on active DAI %d\n",
1238 dev_dbg(codec->dev, "Setting AIF%d to %s\n", dai->id + 1,
1239 arizona_dai_clk_str(clk_id));
1241 memset(&routes, 0, sizeof(routes));
1242 routes[0].sink = dai->driver->capture.stream_name;
1243 routes[1].sink = dai->driver->playback.stream_name;
1245 routes[0].source = arizona_dai_clk_str(dai_priv->clk);
1246 routes[1].source = arizona_dai_clk_str(dai_priv->clk);
1247 snd_soc_dapm_del_routes(&codec->dapm, routes, ARRAY_SIZE(routes));
1249 routes[0].source = arizona_dai_clk_str(clk_id);
1250 routes[1].source = arizona_dai_clk_str(clk_id);
1251 snd_soc_dapm_add_routes(&codec->dapm, routes, ARRAY_SIZE(routes));
1253 dai_priv->clk = clk_id;
1255 return snd_soc_dapm_sync(&codec->dapm);
1258 static int arizona_set_tristate(struct snd_soc_dai *dai, int tristate)
1260 struct snd_soc_codec *codec = dai->codec;
1261 int base = dai->driver->base;
1265 reg = ARIZONA_AIF1_TRI;
1269 return snd_soc_update_bits(codec, base + ARIZONA_AIF_RATE_CTRL,
1270 ARIZONA_AIF1_TRI, reg);
1273 const struct snd_soc_dai_ops arizona_dai_ops = {
1274 .startup = arizona_startup,
1275 .set_fmt = arizona_set_fmt,
1276 .hw_params = arizona_hw_params,
1277 .set_sysclk = arizona_dai_set_sysclk,
1278 .set_tristate = arizona_set_tristate,
1280 EXPORT_SYMBOL_GPL(arizona_dai_ops);
1282 const struct snd_soc_dai_ops arizona_simple_dai_ops = {
1283 .startup = arizona_startup,
1284 .hw_params = arizona_hw_params_rate,
1285 .set_sysclk = arizona_dai_set_sysclk,
1287 EXPORT_SYMBOL_GPL(arizona_simple_dai_ops);
1289 int arizona_init_dai(struct arizona_priv *priv, int id)
1291 struct arizona_dai_priv *dai_priv = &priv->dai[id];
1293 dai_priv->clk = ARIZONA_CLK_SYSCLK;
1297 EXPORT_SYMBOL_GPL(arizona_init_dai);
1299 static irqreturn_t arizona_fll_clock_ok(int irq, void *data)
1301 struct arizona_fll *fll = data;
1303 arizona_fll_dbg(fll, "clock OK\n");
1316 { 0, 64000, 4, 16 },
1317 { 64000, 128000, 3, 8 },
1318 { 128000, 256000, 2, 4 },
1319 { 256000, 1000000, 1, 2 },
1320 { 1000000, 13500000, 0, 1 },
1329 { 256000, 1000000, 2 },
1330 { 1000000, 13500000, 4 },
1333 struct arizona_fll_cfg {
1343 static int arizona_calc_fll(struct arizona_fll *fll,
1344 struct arizona_fll_cfg *cfg,
1348 unsigned int target, div, gcd_fll;
1351 arizona_fll_dbg(fll, "Fref=%u Fout=%u\n", Fref, Fout);
1353 /* Fref must be <=13.5MHz */
1356 while ((Fref / div) > 13500000) {
1361 arizona_fll_err(fll,
1362 "Can't scale %dMHz in to <=13.5MHz\n",
1368 /* Apply the division for our remaining calculations */
1371 /* Fvco should be over the targt; don't check the upper bound */
1373 while (Fout * div < 90000000 * fll->vco_mult) {
1376 arizona_fll_err(fll, "No FLL_OUTDIV for Fout=%uHz\n",
1381 target = Fout * div / fll->vco_mult;
1384 arizona_fll_dbg(fll, "Fvco=%dHz\n", target);
1386 /* Find an appropraite FLL_FRATIO and factor it out of the target */
1387 for (i = 0; i < ARRAY_SIZE(fll_fratios); i++) {
1388 if (fll_fratios[i].min <= Fref && Fref <= fll_fratios[i].max) {
1389 cfg->fratio = fll_fratios[i].fratio;
1390 ratio = fll_fratios[i].ratio;
1394 if (i == ARRAY_SIZE(fll_fratios)) {
1395 arizona_fll_err(fll, "Unable to find FRATIO for Fref=%uHz\n",
1400 for (i = 0; i < ARRAY_SIZE(fll_gains); i++) {
1401 if (fll_gains[i].min <= Fref && Fref <= fll_gains[i].max) {
1402 cfg->gain = fll_gains[i].gain;
1406 if (i == ARRAY_SIZE(fll_gains)) {
1407 arizona_fll_err(fll, "Unable to find gain for Fref=%uHz\n",
1412 cfg->n = target / (ratio * Fref);
1414 if (target % (ratio * Fref)) {
1415 gcd_fll = gcd(target, ratio * Fref);
1416 arizona_fll_dbg(fll, "GCD=%u\n", gcd_fll);
1418 cfg->theta = (target - (cfg->n * ratio * Fref))
1420 cfg->lambda = (ratio * Fref) / gcd_fll;
1426 /* Round down to 16bit range with cost of accuracy lost.
1427 * Denominator must be bigger than numerator so we only
1430 while (cfg->lambda >= (1 << 16)) {
1435 arizona_fll_dbg(fll, "N=%x THETA=%x LAMBDA=%x\n",
1436 cfg->n, cfg->theta, cfg->lambda);
1437 arizona_fll_dbg(fll, "FRATIO=%x(%d) OUTDIV=%x REFCLK_DIV=%x\n",
1438 cfg->fratio, cfg->fratio, cfg->outdiv, cfg->refdiv);
1439 arizona_fll_dbg(fll, "GAIN=%d\n", cfg->gain);
1445 static void arizona_apply_fll(struct arizona *arizona, unsigned int base,
1446 struct arizona_fll_cfg *cfg, int source,
1449 regmap_update_bits(arizona->regmap, base + 3,
1450 ARIZONA_FLL1_THETA_MASK, cfg->theta);
1451 regmap_update_bits(arizona->regmap, base + 4,
1452 ARIZONA_FLL1_LAMBDA_MASK, cfg->lambda);
1453 regmap_update_bits(arizona->regmap, base + 5,
1454 ARIZONA_FLL1_FRATIO_MASK,
1455 cfg->fratio << ARIZONA_FLL1_FRATIO_SHIFT);
1456 regmap_update_bits(arizona->regmap, base + 6,
1457 ARIZONA_FLL1_CLK_REF_DIV_MASK |
1458 ARIZONA_FLL1_CLK_REF_SRC_MASK,
1459 cfg->refdiv << ARIZONA_FLL1_CLK_REF_DIV_SHIFT |
1460 source << ARIZONA_FLL1_CLK_REF_SRC_SHIFT);
1463 regmap_update_bits(arizona->regmap, base + 0x7,
1464 ARIZONA_FLL1_GAIN_MASK,
1465 cfg->gain << ARIZONA_FLL1_GAIN_SHIFT);
1467 regmap_update_bits(arizona->regmap, base + 0x9,
1468 ARIZONA_FLL1_GAIN_MASK,
1469 cfg->gain << ARIZONA_FLL1_GAIN_SHIFT);
1471 regmap_update_bits(arizona->regmap, base + 2,
1472 ARIZONA_FLL1_CTRL_UPD | ARIZONA_FLL1_N_MASK,
1473 ARIZONA_FLL1_CTRL_UPD | cfg->n);
1476 static bool arizona_is_enabled_fll(struct arizona_fll *fll)
1478 struct arizona *arizona = fll->arizona;
1482 ret = regmap_read(arizona->regmap, fll->base + 1, ®);
1484 arizona_fll_err(fll, "Failed to read current state: %d\n",
1489 return reg & ARIZONA_FLL1_ENA;
1492 static void arizona_enable_fll(struct arizona_fll *fll,
1493 struct arizona_fll_cfg *ref,
1494 struct arizona_fll_cfg *sync)
1496 struct arizona *arizona = fll->arizona;
1498 bool use_sync = false;
1501 * If we have both REFCLK and SYNCCLK then enable both,
1502 * otherwise apply the SYNCCLK settings to REFCLK.
1504 if (fll->ref_src >= 0 && fll->ref_freq &&
1505 fll->ref_src != fll->sync_src) {
1506 regmap_update_bits(arizona->regmap, fll->base + 5,
1507 ARIZONA_FLL1_OUTDIV_MASK,
1508 ref->outdiv << ARIZONA_FLL1_OUTDIV_SHIFT);
1510 arizona_apply_fll(arizona, fll->base, ref, fll->ref_src,
1512 if (fll->sync_src >= 0) {
1513 arizona_apply_fll(arizona, fll->base + 0x10, sync,
1514 fll->sync_src, true);
1517 } else if (fll->sync_src >= 0) {
1518 regmap_update_bits(arizona->regmap, fll->base + 5,
1519 ARIZONA_FLL1_OUTDIV_MASK,
1520 sync->outdiv << ARIZONA_FLL1_OUTDIV_SHIFT);
1522 arizona_apply_fll(arizona, fll->base, sync,
1523 fll->sync_src, false);
1525 regmap_update_bits(arizona->regmap, fll->base + 0x11,
1526 ARIZONA_FLL1_SYNC_ENA, 0);
1528 arizona_fll_err(fll, "No clocks provided\n");
1533 * Increase the bandwidth if we're not using a low frequency
1536 if (use_sync && fll->sync_freq > 100000)
1537 regmap_update_bits(arizona->regmap, fll->base + 0x17,
1538 ARIZONA_FLL1_SYNC_BW, 0);
1540 regmap_update_bits(arizona->regmap, fll->base + 0x17,
1541 ARIZONA_FLL1_SYNC_BW, ARIZONA_FLL1_SYNC_BW);
1543 if (!arizona_is_enabled_fll(fll))
1544 pm_runtime_get(arizona->dev);
1546 /* Clear any pending completions */
1547 try_wait_for_completion(&fll->ok);
1549 regmap_update_bits(arizona->regmap, fll->base + 1,
1550 ARIZONA_FLL1_FREERUN, 0);
1551 regmap_update_bits(arizona->regmap, fll->base + 1,
1552 ARIZONA_FLL1_ENA, ARIZONA_FLL1_ENA);
1554 regmap_update_bits(arizona->regmap, fll->base + 0x11,
1555 ARIZONA_FLL1_SYNC_ENA,
1556 ARIZONA_FLL1_SYNC_ENA);
1558 ret = wait_for_completion_timeout(&fll->ok,
1559 msecs_to_jiffies(250));
1561 arizona_fll_warn(fll, "Timed out waiting for lock\n");
1564 static void arizona_disable_fll(struct arizona_fll *fll)
1566 struct arizona *arizona = fll->arizona;
1569 regmap_update_bits(arizona->regmap, fll->base + 1,
1570 ARIZONA_FLL1_FREERUN, ARIZONA_FLL1_FREERUN);
1571 regmap_update_bits_check(arizona->regmap, fll->base + 1,
1572 ARIZONA_FLL1_ENA, 0, &change);
1573 regmap_update_bits(arizona->regmap, fll->base + 0x11,
1574 ARIZONA_FLL1_SYNC_ENA, 0);
1577 pm_runtime_put_autosuspend(arizona->dev);
1580 int arizona_set_fll_refclk(struct arizona_fll *fll, int source,
1581 unsigned int Fref, unsigned int Fout)
1583 struct arizona_fll_cfg ref, sync;
1586 if (fll->ref_src == source && fll->ref_freq == Fref)
1591 ret = arizona_calc_fll(fll, &ref, Fref, fll->fout);
1596 if (fll->sync_src >= 0) {
1597 ret = arizona_calc_fll(fll, &sync, fll->sync_freq,
1604 fll->ref_src = source;
1605 fll->ref_freq = Fref;
1607 if (fll->fout && Fref > 0) {
1608 arizona_enable_fll(fll, &ref, &sync);
1613 EXPORT_SYMBOL_GPL(arizona_set_fll_refclk);
1615 int arizona_set_fll(struct arizona_fll *fll, int source,
1616 unsigned int Fref, unsigned int Fout)
1618 struct arizona_fll_cfg ref, sync;
1621 if (fll->sync_src == source &&
1622 fll->sync_freq == Fref && fll->fout == Fout)
1626 if (fll->ref_src >= 0) {
1627 ret = arizona_calc_fll(fll, &ref, fll->ref_freq,
1633 ret = arizona_calc_fll(fll, &sync, Fref, Fout);
1638 fll->sync_src = source;
1639 fll->sync_freq = Fref;
1643 arizona_enable_fll(fll, &ref, &sync);
1645 arizona_disable_fll(fll);
1650 EXPORT_SYMBOL_GPL(arizona_set_fll);
1652 int arizona_init_fll(struct arizona *arizona, int id, int base, int lock_irq,
1653 int ok_irq, struct arizona_fll *fll)
1658 init_completion(&fll->ok);
1662 fll->arizona = arizona;
1663 fll->sync_src = ARIZONA_FLL_SRC_NONE;
1665 /* Configure default refclk to 32kHz if we have one */
1666 regmap_read(arizona->regmap, ARIZONA_CLOCK_32K_1, &val);
1667 switch (val & ARIZONA_CLK_32K_SRC_MASK) {
1668 case ARIZONA_CLK_SRC_MCLK1:
1669 case ARIZONA_CLK_SRC_MCLK2:
1670 fll->ref_src = val & ARIZONA_CLK_32K_SRC_MASK;
1673 fll->ref_src = ARIZONA_FLL_SRC_NONE;
1675 fll->ref_freq = 32768;
1677 snprintf(fll->lock_name, sizeof(fll->lock_name), "FLL%d lock", id);
1678 snprintf(fll->clock_ok_name, sizeof(fll->clock_ok_name),
1679 "FLL%d clock OK", id);
1681 ret = arizona_request_irq(arizona, ok_irq, fll->clock_ok_name,
1682 arizona_fll_clock_ok, fll);
1684 dev_err(arizona->dev, "Failed to get FLL%d clock OK IRQ: %d\n",
1688 regmap_update_bits(arizona->regmap, fll->base + 1,
1689 ARIZONA_FLL1_FREERUN, 0);
1693 EXPORT_SYMBOL_GPL(arizona_init_fll);
1696 * arizona_set_output_mode - Set the mode of the specified output
1698 * @codec: Device to configure
1699 * @output: Output number
1700 * @diff: True to set the output to differential mode
1702 * Some systems use external analogue switches to connect more
1703 * analogue devices to the CODEC than are supported by the device. In
1704 * some systems this requires changing the switched output from single
1705 * ended to differential mode dynamically at runtime, an operation
1706 * supported using this function.
1708 * Most systems have a single static configuration and should use
1709 * platform data instead.
1711 int arizona_set_output_mode(struct snd_soc_codec *codec, int output, bool diff)
1713 unsigned int reg, val;
1715 if (output < 1 || output > 6)
1718 reg = ARIZONA_OUTPUT_PATH_CONFIG_1L + (output - 1) * 8;
1721 val = ARIZONA_OUT1_MONO;
1725 return snd_soc_update_bits(codec, reg, ARIZONA_OUT1_MONO, val);
1727 EXPORT_SYMBOL_GPL(arizona_set_output_mode);
1729 MODULE_DESCRIPTION("ASoC Wolfson Arizona class device support");
1730 MODULE_AUTHOR("Mark Brown <broonie@opensource.wolfsonmicro.com>");
1731 MODULE_LICENSE("GPL");