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] = {
370 EXPORT_SYMBOL_GPL(arizona_mixer_texts);
372 int arizona_mixer_values[ARIZONA_NUM_MIXER_INPUTS] = {
378 0x0c, /* Noise mixer */
379 0x0d, /* Comfort noise */
448 0xa0, /* ISRC1INT1 */
452 0xa4, /* ISRC1DEC1 */
456 0xa8, /* ISRC2DEC1 */
460 0xac, /* ISRC2INT1 */
464 0xb0, /* ISRC3DEC1 */
468 0xb4, /* ISRC3INT1 */
473 EXPORT_SYMBOL_GPL(arizona_mixer_values);
475 const DECLARE_TLV_DB_SCALE(arizona_mixer_tlv, -3200, 100, 0);
476 EXPORT_SYMBOL_GPL(arizona_mixer_tlv);
478 const char *arizona_rate_text[ARIZONA_RATE_ENUM_SIZE] = {
479 "SYNCCLK rate", "8kHz", "16kHz", "ASYNCCLK rate",
481 EXPORT_SYMBOL_GPL(arizona_rate_text);
483 const int arizona_rate_val[ARIZONA_RATE_ENUM_SIZE] = {
486 EXPORT_SYMBOL_GPL(arizona_rate_val);
489 const struct soc_enum arizona_isrc_fsl[] = {
490 SOC_VALUE_ENUM_SINGLE(ARIZONA_ISRC_1_CTRL_2,
491 ARIZONA_ISRC1_FSL_SHIFT, 0xf,
492 ARIZONA_RATE_ENUM_SIZE,
493 arizona_rate_text, arizona_rate_val),
494 SOC_VALUE_ENUM_SINGLE(ARIZONA_ISRC_2_CTRL_2,
495 ARIZONA_ISRC2_FSL_SHIFT, 0xf,
496 ARIZONA_RATE_ENUM_SIZE,
497 arizona_rate_text, arizona_rate_val),
498 SOC_VALUE_ENUM_SINGLE(ARIZONA_ISRC_3_CTRL_2,
499 ARIZONA_ISRC3_FSL_SHIFT, 0xf,
500 ARIZONA_RATE_ENUM_SIZE,
501 arizona_rate_text, arizona_rate_val),
503 EXPORT_SYMBOL_GPL(arizona_isrc_fsl);
505 static const char *arizona_vol_ramp_text[] = {
506 "0ms/6dB", "0.5ms/6dB", "1ms/6dB", "2ms/6dB", "4ms/6dB", "8ms/6dB",
507 "15ms/6dB", "30ms/6dB",
510 const struct soc_enum arizona_in_vd_ramp =
511 SOC_ENUM_SINGLE(ARIZONA_INPUT_VOLUME_RAMP,
512 ARIZONA_IN_VD_RAMP_SHIFT, 7, arizona_vol_ramp_text);
513 EXPORT_SYMBOL_GPL(arizona_in_vd_ramp);
515 const struct soc_enum arizona_in_vi_ramp =
516 SOC_ENUM_SINGLE(ARIZONA_INPUT_VOLUME_RAMP,
517 ARIZONA_IN_VI_RAMP_SHIFT, 7, arizona_vol_ramp_text);
518 EXPORT_SYMBOL_GPL(arizona_in_vi_ramp);
520 const struct soc_enum arizona_out_vd_ramp =
521 SOC_ENUM_SINGLE(ARIZONA_OUTPUT_VOLUME_RAMP,
522 ARIZONA_OUT_VD_RAMP_SHIFT, 7, arizona_vol_ramp_text);
523 EXPORT_SYMBOL_GPL(arizona_out_vd_ramp);
525 const struct soc_enum arizona_out_vi_ramp =
526 SOC_ENUM_SINGLE(ARIZONA_OUTPUT_VOLUME_RAMP,
527 ARIZONA_OUT_VI_RAMP_SHIFT, 7, arizona_vol_ramp_text);
528 EXPORT_SYMBOL_GPL(arizona_out_vi_ramp);
530 static const char *arizona_lhpf_mode_text[] = {
531 "Low-pass", "High-pass"
534 const struct soc_enum arizona_lhpf1_mode =
535 SOC_ENUM_SINGLE(ARIZONA_HPLPF1_1, ARIZONA_LHPF1_MODE_SHIFT, 2,
536 arizona_lhpf_mode_text);
537 EXPORT_SYMBOL_GPL(arizona_lhpf1_mode);
539 const struct soc_enum arizona_lhpf2_mode =
540 SOC_ENUM_SINGLE(ARIZONA_HPLPF2_1, ARIZONA_LHPF2_MODE_SHIFT, 2,
541 arizona_lhpf_mode_text);
542 EXPORT_SYMBOL_GPL(arizona_lhpf2_mode);
544 const struct soc_enum arizona_lhpf3_mode =
545 SOC_ENUM_SINGLE(ARIZONA_HPLPF3_1, ARIZONA_LHPF3_MODE_SHIFT, 2,
546 arizona_lhpf_mode_text);
547 EXPORT_SYMBOL_GPL(arizona_lhpf3_mode);
549 const struct soc_enum arizona_lhpf4_mode =
550 SOC_ENUM_SINGLE(ARIZONA_HPLPF4_1, ARIZONA_LHPF4_MODE_SHIFT, 2,
551 arizona_lhpf_mode_text);
552 EXPORT_SYMBOL_GPL(arizona_lhpf4_mode);
554 static const char *arizona_ng_hold_text[] = {
555 "30ms", "120ms", "250ms", "500ms",
558 const struct soc_enum arizona_ng_hold =
559 SOC_ENUM_SINGLE(ARIZONA_NOISE_GATE_CONTROL, ARIZONA_NGATE_HOLD_SHIFT,
560 4, arizona_ng_hold_text);
561 EXPORT_SYMBOL_GPL(arizona_ng_hold);
563 static const char * const arizona_in_hpf_cut_text[] = {
564 "2.5Hz", "5Hz", "10Hz", "20Hz", "40Hz"
567 const struct soc_enum arizona_in_hpf_cut_enum =
568 SOC_ENUM_SINGLE(ARIZONA_HPF_CONTROL, ARIZONA_IN_HPF_CUT_SHIFT,
569 ARRAY_SIZE(arizona_in_hpf_cut_text),
570 arizona_in_hpf_cut_text);
571 EXPORT_SYMBOL_GPL(arizona_in_hpf_cut_enum);
573 static const char * const arizona_in_dmic_osr_text[] = {
574 "1.536MHz", "3.072MHz", "6.144MHz",
577 const struct soc_enum arizona_in_dmic_osr[] = {
578 SOC_ENUM_SINGLE(ARIZONA_IN1L_CONTROL, ARIZONA_IN1_OSR_SHIFT,
579 ARRAY_SIZE(arizona_in_dmic_osr_text),
580 arizona_in_dmic_osr_text),
581 SOC_ENUM_SINGLE(ARIZONA_IN2L_CONTROL, ARIZONA_IN2_OSR_SHIFT,
582 ARRAY_SIZE(arizona_in_dmic_osr_text),
583 arizona_in_dmic_osr_text),
584 SOC_ENUM_SINGLE(ARIZONA_IN3L_CONTROL, ARIZONA_IN3_OSR_SHIFT,
585 ARRAY_SIZE(arizona_in_dmic_osr_text),
586 arizona_in_dmic_osr_text),
587 SOC_ENUM_SINGLE(ARIZONA_IN4L_CONTROL, ARIZONA_IN4_OSR_SHIFT,
588 ARRAY_SIZE(arizona_in_dmic_osr_text),
589 arizona_in_dmic_osr_text),
591 EXPORT_SYMBOL_GPL(arizona_in_dmic_osr);
593 static void arizona_in_set_vu(struct snd_soc_codec *codec, int ena)
595 struct arizona_priv *priv = snd_soc_codec_get_drvdata(codec);
604 for (i = 0; i < priv->num_inputs; i++)
605 snd_soc_update_bits(codec,
606 ARIZONA_ADC_DIGITAL_VOLUME_1L + (i * 4),
610 int arizona_in_ev(struct snd_soc_dapm_widget *w, struct snd_kcontrol *kcontrol,
613 struct arizona_priv *priv = snd_soc_codec_get_drvdata(w->codec);
617 reg = ARIZONA_ADC_DIGITAL_VOLUME_1L + ((w->shift / 2) * 8);
619 reg = ARIZONA_ADC_DIGITAL_VOLUME_1R + ((w->shift / 2) * 8);
622 case SND_SOC_DAPM_PRE_PMU:
625 case SND_SOC_DAPM_POST_PMU:
626 snd_soc_update_bits(w->codec, reg, ARIZONA_IN1L_MUTE, 0);
628 /* If this is the last input pending then allow VU */
630 if (priv->in_pending == 0) {
632 arizona_in_set_vu(w->codec, 1);
635 case SND_SOC_DAPM_PRE_PMD:
636 snd_soc_update_bits(w->codec, reg,
637 ARIZONA_IN1L_MUTE | ARIZONA_IN_VU,
638 ARIZONA_IN1L_MUTE | ARIZONA_IN_VU);
640 case SND_SOC_DAPM_POST_PMD:
641 /* Disable volume updates if no inputs are enabled */
642 reg = snd_soc_read(w->codec, ARIZONA_INPUT_ENABLES);
644 arizona_in_set_vu(w->codec, 0);
649 EXPORT_SYMBOL_GPL(arizona_in_ev);
651 int arizona_out_ev(struct snd_soc_dapm_widget *w,
652 struct snd_kcontrol *kcontrol,
656 case SND_SOC_DAPM_POST_PMU:
658 case ARIZONA_OUT1L_ENA_SHIFT:
659 case ARIZONA_OUT1R_ENA_SHIFT:
660 case ARIZONA_OUT2L_ENA_SHIFT:
661 case ARIZONA_OUT2R_ENA_SHIFT:
662 case ARIZONA_OUT3L_ENA_SHIFT:
663 case ARIZONA_OUT3R_ENA_SHIFT:
675 EXPORT_SYMBOL_GPL(arizona_out_ev);
677 int arizona_hp_ev(struct snd_soc_dapm_widget *w,
678 struct snd_kcontrol *kcontrol,
681 struct arizona_priv *priv = snd_soc_codec_get_drvdata(w->codec);
682 unsigned int mask = 1 << w->shift;
686 case SND_SOC_DAPM_POST_PMU:
689 case SND_SOC_DAPM_PRE_PMD:
696 /* Store the desired state for the HP outputs */
697 priv->arizona->hp_ena &= ~mask;
698 priv->arizona->hp_ena |= val;
700 /* Force off if HPDET magic is active */
701 if (priv->arizona->hpdet_magic)
704 snd_soc_update_bits(w->codec, ARIZONA_OUTPUT_ENABLES_1, mask, val);
706 return arizona_out_ev(w, kcontrol, event);
708 EXPORT_SYMBOL_GPL(arizona_hp_ev);
710 static unsigned int arizona_sysclk_48k_rates[] = {
720 static unsigned int arizona_sysclk_44k1_rates[] = {
730 static int arizona_set_opclk(struct snd_soc_codec *codec, unsigned int clk,
733 struct arizona_priv *priv = snd_soc_codec_get_drvdata(codec);
736 int ref, div, refclk;
739 case ARIZONA_CLK_OPCLK:
740 reg = ARIZONA_OUTPUT_SYSTEM_CLOCK;
741 refclk = priv->sysclk;
743 case ARIZONA_CLK_ASYNC_OPCLK:
744 reg = ARIZONA_OUTPUT_ASYNC_CLOCK;
745 refclk = priv->asyncclk;
752 rates = arizona_sysclk_44k1_rates;
754 rates = arizona_sysclk_48k_rates;
756 for (ref = 0; ref < ARRAY_SIZE(arizona_sysclk_48k_rates) &&
757 rates[ref] <= refclk; ref++) {
759 while (rates[ref] / div >= freq && div < 32) {
760 if (rates[ref] / div == freq) {
761 dev_dbg(codec->dev, "Configured %dHz OPCLK\n",
763 snd_soc_update_bits(codec, reg,
764 ARIZONA_OPCLK_DIV_MASK |
765 ARIZONA_OPCLK_SEL_MASK,
767 ARIZONA_OPCLK_DIV_SHIFT) |
775 dev_err(codec->dev, "Unable to generate %dHz OPCLK\n", freq);
779 int arizona_set_sysclk(struct snd_soc_codec *codec, int clk_id,
780 int source, unsigned int freq, int dir)
782 struct arizona_priv *priv = snd_soc_codec_get_drvdata(codec);
783 struct arizona *arizona = priv->arizona;
786 unsigned int mask = ARIZONA_SYSCLK_FREQ_MASK | ARIZONA_SYSCLK_SRC_MASK;
787 unsigned int val = source << ARIZONA_SYSCLK_SRC_SHIFT;
791 case ARIZONA_CLK_SYSCLK:
793 reg = ARIZONA_SYSTEM_CLOCK_1;
795 mask |= ARIZONA_SYSCLK_FRAC;
797 case ARIZONA_CLK_ASYNCCLK:
799 reg = ARIZONA_ASYNC_CLOCK_1;
800 clk = &priv->asyncclk;
802 case ARIZONA_CLK_OPCLK:
803 case ARIZONA_CLK_ASYNC_OPCLK:
804 return arizona_set_opclk(codec, clk_id, freq);
815 val |= ARIZONA_CLK_12MHZ << ARIZONA_SYSCLK_FREQ_SHIFT;
819 val |= ARIZONA_CLK_24MHZ << ARIZONA_SYSCLK_FREQ_SHIFT;
823 val |= ARIZONA_CLK_49MHZ << ARIZONA_SYSCLK_FREQ_SHIFT;
827 val |= ARIZONA_CLK_73MHZ << ARIZONA_SYSCLK_FREQ_SHIFT;
831 val |= ARIZONA_CLK_98MHZ << ARIZONA_SYSCLK_FREQ_SHIFT;
835 val |= ARIZONA_CLK_147MHZ << ARIZONA_SYSCLK_FREQ_SHIFT;
838 dev_dbg(arizona->dev, "%s cleared\n", name);
848 val |= ARIZONA_SYSCLK_FRAC;
850 dev_dbg(arizona->dev, "%s set to %uHz", name, freq);
852 return regmap_update_bits(arizona->regmap, reg, mask, val);
854 EXPORT_SYMBOL_GPL(arizona_set_sysclk);
856 static int arizona_set_fmt(struct snd_soc_dai *dai, unsigned int fmt)
858 struct snd_soc_codec *codec = dai->codec;
859 int lrclk, bclk, mode, base;
861 base = dai->driver->base;
866 switch (fmt & SND_SOC_DAIFMT_FORMAT_MASK) {
867 case SND_SOC_DAIFMT_DSP_A:
870 case SND_SOC_DAIFMT_I2S:
874 arizona_aif_err(dai, "Unsupported DAI format %d\n",
875 fmt & SND_SOC_DAIFMT_FORMAT_MASK);
879 switch (fmt & SND_SOC_DAIFMT_MASTER_MASK) {
880 case SND_SOC_DAIFMT_CBS_CFS:
882 case SND_SOC_DAIFMT_CBS_CFM:
883 lrclk |= ARIZONA_AIF1TX_LRCLK_MSTR;
885 case SND_SOC_DAIFMT_CBM_CFS:
886 bclk |= ARIZONA_AIF1_BCLK_MSTR;
888 case SND_SOC_DAIFMT_CBM_CFM:
889 bclk |= ARIZONA_AIF1_BCLK_MSTR;
890 lrclk |= ARIZONA_AIF1TX_LRCLK_MSTR;
893 arizona_aif_err(dai, "Unsupported master mode %d\n",
894 fmt & SND_SOC_DAIFMT_MASTER_MASK);
898 switch (fmt & SND_SOC_DAIFMT_INV_MASK) {
899 case SND_SOC_DAIFMT_NB_NF:
901 case SND_SOC_DAIFMT_IB_IF:
902 bclk |= ARIZONA_AIF1_BCLK_INV;
903 lrclk |= ARIZONA_AIF1TX_LRCLK_INV;
905 case SND_SOC_DAIFMT_IB_NF:
906 bclk |= ARIZONA_AIF1_BCLK_INV;
908 case SND_SOC_DAIFMT_NB_IF:
909 lrclk |= ARIZONA_AIF1TX_LRCLK_INV;
915 snd_soc_update_bits(codec, base + ARIZONA_AIF_BCLK_CTRL,
916 ARIZONA_AIF1_BCLK_INV | ARIZONA_AIF1_BCLK_MSTR,
918 snd_soc_update_bits(codec, base + ARIZONA_AIF_TX_PIN_CTRL,
919 ARIZONA_AIF1TX_LRCLK_INV |
920 ARIZONA_AIF1TX_LRCLK_MSTR, lrclk);
921 snd_soc_update_bits(codec, base + ARIZONA_AIF_RX_PIN_CTRL,
922 ARIZONA_AIF1RX_LRCLK_INV |
923 ARIZONA_AIF1RX_LRCLK_MSTR, lrclk);
924 snd_soc_update_bits(codec, base + ARIZONA_AIF_FORMAT,
925 ARIZONA_AIF1_FMT_MASK, mode);
930 static const int arizona_48k_bclk_rates[] = {
952 static const unsigned int arizona_48k_rates[] = {
970 static const struct snd_pcm_hw_constraint_list arizona_48k_constraint = {
971 .count = ARRAY_SIZE(arizona_48k_rates),
972 .list = arizona_48k_rates,
975 static const int arizona_44k1_bclk_rates[] = {
997 static const unsigned int arizona_44k1_rates[] = {
1007 static const struct snd_pcm_hw_constraint_list arizona_44k1_constraint = {
1008 .count = ARRAY_SIZE(arizona_44k1_rates),
1009 .list = arizona_44k1_rates,
1012 static int arizona_sr_vals[] = {
1039 static int arizona_startup(struct snd_pcm_substream *substream,
1040 struct snd_soc_dai *dai)
1042 struct snd_soc_codec *codec = dai->codec;
1043 struct arizona_priv *priv = snd_soc_codec_get_drvdata(codec);
1044 struct arizona_dai_priv *dai_priv = &priv->dai[dai->id - 1];
1045 const struct snd_pcm_hw_constraint_list *constraint;
1046 unsigned int base_rate;
1048 switch (dai_priv->clk) {
1049 case ARIZONA_CLK_SYSCLK:
1050 base_rate = priv->sysclk;
1052 case ARIZONA_CLK_ASYNCCLK:
1053 base_rate = priv->asyncclk;
1062 if (base_rate % 8000)
1063 constraint = &arizona_44k1_constraint;
1065 constraint = &arizona_48k_constraint;
1067 return snd_pcm_hw_constraint_list(substream->runtime, 0,
1068 SNDRV_PCM_HW_PARAM_RATE,
1072 static int arizona_hw_params_rate(struct snd_pcm_substream *substream,
1073 struct snd_pcm_hw_params *params,
1074 struct snd_soc_dai *dai)
1076 struct snd_soc_codec *codec = dai->codec;
1077 struct arizona_priv *priv = snd_soc_codec_get_drvdata(codec);
1078 struct arizona_dai_priv *dai_priv = &priv->dai[dai->id - 1];
1079 int base = dai->driver->base;
1083 * We will need to be more flexible than this in future,
1084 * currently we use a single sample rate for SYSCLK.
1086 for (i = 0; i < ARRAY_SIZE(arizona_sr_vals); i++)
1087 if (arizona_sr_vals[i] == params_rate(params))
1089 if (i == ARRAY_SIZE(arizona_sr_vals)) {
1090 arizona_aif_err(dai, "Unsupported sample rate %dHz\n",
1091 params_rate(params));
1096 switch (dai_priv->clk) {
1097 case ARIZONA_CLK_SYSCLK:
1098 snd_soc_update_bits(codec, ARIZONA_SAMPLE_RATE_1,
1099 ARIZONA_SAMPLE_RATE_1_MASK, sr_val);
1101 snd_soc_update_bits(codec, base + ARIZONA_AIF_RATE_CTRL,
1102 ARIZONA_AIF1_RATE_MASK, 0);
1104 case ARIZONA_CLK_ASYNCCLK:
1105 snd_soc_update_bits(codec, ARIZONA_ASYNC_SAMPLE_RATE_1,
1106 ARIZONA_ASYNC_SAMPLE_RATE_MASK, sr_val);
1108 snd_soc_update_bits(codec, base + ARIZONA_AIF_RATE_CTRL,
1109 ARIZONA_AIF1_RATE_MASK,
1110 8 << ARIZONA_AIF1_RATE_SHIFT);
1113 arizona_aif_err(dai, "Invalid clock %d\n", dai_priv->clk);
1120 static int arizona_hw_params(struct snd_pcm_substream *substream,
1121 struct snd_pcm_hw_params *params,
1122 struct snd_soc_dai *dai)
1124 struct snd_soc_codec *codec = dai->codec;
1125 struct arizona_priv *priv = snd_soc_codec_get_drvdata(codec);
1126 struct arizona *arizona = priv->arizona;
1127 int base = dai->driver->base;
1130 int chan_limit = arizona->pdata.max_channels_clocked[dai->id - 1];
1131 int bclk, lrclk, wl, frame, bclk_target;
1133 if (params_rate(params) % 8000)
1134 rates = &arizona_44k1_bclk_rates[0];
1136 rates = &arizona_48k_bclk_rates[0];
1138 bclk_target = snd_soc_params_to_bclk(params);
1139 if (chan_limit && chan_limit < params_channels(params)) {
1140 arizona_aif_dbg(dai, "Limiting to %d channels\n", chan_limit);
1141 bclk_target /= params_channels(params);
1142 bclk_target *= chan_limit;
1145 /* Force stereo for I2S mode */
1146 val = snd_soc_read(codec, base + ARIZONA_AIF_FORMAT);
1147 if (params_channels(params) == 1 && (val & ARIZONA_AIF1_FMT_MASK)) {
1148 arizona_aif_dbg(dai, "Forcing stereo mode\n");
1152 for (i = 0; i < ARRAY_SIZE(arizona_44k1_bclk_rates); i++) {
1153 if (rates[i] >= bclk_target &&
1154 rates[i] % params_rate(params) == 0) {
1159 if (i == ARRAY_SIZE(arizona_44k1_bclk_rates)) {
1160 arizona_aif_err(dai, "Unsupported sample rate %dHz\n",
1161 params_rate(params));
1165 lrclk = rates[bclk] / params_rate(params);
1167 arizona_aif_dbg(dai, "BCLK %dHz LRCLK %dHz\n",
1168 rates[bclk], rates[bclk] / lrclk);
1170 wl = snd_pcm_format_width(params_format(params));
1171 frame = wl << ARIZONA_AIF1TX_WL_SHIFT | wl;
1173 ret = arizona_hw_params_rate(substream, params, dai);
1177 snd_soc_update_bits(codec, base + ARIZONA_AIF_BCLK_CTRL,
1178 ARIZONA_AIF1_BCLK_FREQ_MASK, bclk);
1179 snd_soc_update_bits(codec, base + ARIZONA_AIF_TX_BCLK_RATE,
1180 ARIZONA_AIF1TX_BCPF_MASK, lrclk);
1181 snd_soc_update_bits(codec, base + ARIZONA_AIF_RX_BCLK_RATE,
1182 ARIZONA_AIF1RX_BCPF_MASK, lrclk);
1183 snd_soc_update_bits(codec, base + ARIZONA_AIF_FRAME_CTRL_1,
1184 ARIZONA_AIF1TX_WL_MASK |
1185 ARIZONA_AIF1TX_SLOT_LEN_MASK, frame);
1186 snd_soc_update_bits(codec, base + ARIZONA_AIF_FRAME_CTRL_2,
1187 ARIZONA_AIF1RX_WL_MASK |
1188 ARIZONA_AIF1RX_SLOT_LEN_MASK, frame);
1193 static const char *arizona_dai_clk_str(int clk_id)
1196 case ARIZONA_CLK_SYSCLK:
1198 case ARIZONA_CLK_ASYNCCLK:
1201 return "Unknown clock";
1205 static int arizona_dai_set_sysclk(struct snd_soc_dai *dai,
1206 int clk_id, unsigned int freq, int dir)
1208 struct snd_soc_codec *codec = dai->codec;
1209 struct arizona_priv *priv = snd_soc_codec_get_drvdata(codec);
1210 struct arizona_dai_priv *dai_priv = &priv->dai[dai->id - 1];
1211 struct snd_soc_dapm_route routes[2];
1214 case ARIZONA_CLK_SYSCLK:
1215 case ARIZONA_CLK_ASYNCCLK:
1221 if (clk_id == dai_priv->clk)
1225 dev_err(codec->dev, "Can't change clock on active DAI %d\n",
1230 dev_dbg(codec->dev, "Setting AIF%d to %s\n", dai->id + 1,
1231 arizona_dai_clk_str(clk_id));
1233 memset(&routes, 0, sizeof(routes));
1234 routes[0].sink = dai->driver->capture.stream_name;
1235 routes[1].sink = dai->driver->playback.stream_name;
1237 routes[0].source = arizona_dai_clk_str(dai_priv->clk);
1238 routes[1].source = arizona_dai_clk_str(dai_priv->clk);
1239 snd_soc_dapm_del_routes(&codec->dapm, routes, ARRAY_SIZE(routes));
1241 routes[0].source = arizona_dai_clk_str(clk_id);
1242 routes[1].source = arizona_dai_clk_str(clk_id);
1243 snd_soc_dapm_add_routes(&codec->dapm, routes, ARRAY_SIZE(routes));
1245 dai_priv->clk = clk_id;
1247 return snd_soc_dapm_sync(&codec->dapm);
1250 static int arizona_set_tristate(struct snd_soc_dai *dai, int tristate)
1252 struct snd_soc_codec *codec = dai->codec;
1253 int base = dai->driver->base;
1257 reg = ARIZONA_AIF1_TRI;
1261 return snd_soc_update_bits(codec, base + ARIZONA_AIF_RATE_CTRL,
1262 ARIZONA_AIF1_TRI, reg);
1265 const struct snd_soc_dai_ops arizona_dai_ops = {
1266 .startup = arizona_startup,
1267 .set_fmt = arizona_set_fmt,
1268 .hw_params = arizona_hw_params,
1269 .set_sysclk = arizona_dai_set_sysclk,
1270 .set_tristate = arizona_set_tristate,
1272 EXPORT_SYMBOL_GPL(arizona_dai_ops);
1274 const struct snd_soc_dai_ops arizona_simple_dai_ops = {
1275 .startup = arizona_startup,
1276 .hw_params = arizona_hw_params_rate,
1277 .set_sysclk = arizona_dai_set_sysclk,
1279 EXPORT_SYMBOL_GPL(arizona_simple_dai_ops);
1281 int arizona_init_dai(struct arizona_priv *priv, int id)
1283 struct arizona_dai_priv *dai_priv = &priv->dai[id];
1285 dai_priv->clk = ARIZONA_CLK_SYSCLK;
1289 EXPORT_SYMBOL_GPL(arizona_init_dai);
1291 static irqreturn_t arizona_fll_clock_ok(int irq, void *data)
1293 struct arizona_fll *fll = data;
1295 arizona_fll_dbg(fll, "clock OK\n");
1308 { 0, 64000, 4, 16 },
1309 { 64000, 128000, 3, 8 },
1310 { 128000, 256000, 2, 4 },
1311 { 256000, 1000000, 1, 2 },
1312 { 1000000, 13500000, 0, 1 },
1321 { 256000, 1000000, 2 },
1322 { 1000000, 13500000, 4 },
1325 struct arizona_fll_cfg {
1335 static int arizona_calc_fll(struct arizona_fll *fll,
1336 struct arizona_fll_cfg *cfg,
1340 unsigned int target, div, gcd_fll;
1343 arizona_fll_dbg(fll, "Fref=%u Fout=%u\n", Fref, Fout);
1345 /* Fref must be <=13.5MHz */
1348 while ((Fref / div) > 13500000) {
1353 arizona_fll_err(fll,
1354 "Can't scale %dMHz in to <=13.5MHz\n",
1360 /* Apply the division for our remaining calculations */
1363 /* Fvco should be over the targt; don't check the upper bound */
1365 while (Fout * div < 90000000 * fll->vco_mult) {
1368 arizona_fll_err(fll, "No FLL_OUTDIV for Fout=%uHz\n",
1373 target = Fout * div / fll->vco_mult;
1376 arizona_fll_dbg(fll, "Fvco=%dHz\n", target);
1378 /* Find an appropraite FLL_FRATIO and factor it out of the target */
1379 for (i = 0; i < ARRAY_SIZE(fll_fratios); i++) {
1380 if (fll_fratios[i].min <= Fref && Fref <= fll_fratios[i].max) {
1381 cfg->fratio = fll_fratios[i].fratio;
1382 ratio = fll_fratios[i].ratio;
1386 if (i == ARRAY_SIZE(fll_fratios)) {
1387 arizona_fll_err(fll, "Unable to find FRATIO for Fref=%uHz\n",
1392 for (i = 0; i < ARRAY_SIZE(fll_gains); i++) {
1393 if (fll_gains[i].min <= Fref && Fref <= fll_gains[i].max) {
1394 cfg->gain = fll_gains[i].gain;
1398 if (i == ARRAY_SIZE(fll_gains)) {
1399 arizona_fll_err(fll, "Unable to find gain for Fref=%uHz\n",
1404 cfg->n = target / (ratio * Fref);
1406 if (target % (ratio * Fref)) {
1407 gcd_fll = gcd(target, ratio * Fref);
1408 arizona_fll_dbg(fll, "GCD=%u\n", gcd_fll);
1410 cfg->theta = (target - (cfg->n * ratio * Fref))
1412 cfg->lambda = (ratio * Fref) / gcd_fll;
1418 /* Round down to 16bit range with cost of accuracy lost.
1419 * Denominator must be bigger than numerator so we only
1422 while (cfg->lambda >= (1 << 16)) {
1427 arizona_fll_dbg(fll, "N=%x THETA=%x LAMBDA=%x\n",
1428 cfg->n, cfg->theta, cfg->lambda);
1429 arizona_fll_dbg(fll, "FRATIO=%x(%d) OUTDIV=%x REFCLK_DIV=%x\n",
1430 cfg->fratio, cfg->fratio, cfg->outdiv, cfg->refdiv);
1431 arizona_fll_dbg(fll, "GAIN=%d\n", cfg->gain);
1437 static void arizona_apply_fll(struct arizona *arizona, unsigned int base,
1438 struct arizona_fll_cfg *cfg, int source,
1441 regmap_update_bits(arizona->regmap, base + 3,
1442 ARIZONA_FLL1_THETA_MASK, cfg->theta);
1443 regmap_update_bits(arizona->regmap, base + 4,
1444 ARIZONA_FLL1_LAMBDA_MASK, cfg->lambda);
1445 regmap_update_bits(arizona->regmap, base + 5,
1446 ARIZONA_FLL1_FRATIO_MASK,
1447 cfg->fratio << ARIZONA_FLL1_FRATIO_SHIFT);
1448 regmap_update_bits(arizona->regmap, base + 6,
1449 ARIZONA_FLL1_CLK_REF_DIV_MASK |
1450 ARIZONA_FLL1_CLK_REF_SRC_MASK,
1451 cfg->refdiv << ARIZONA_FLL1_CLK_REF_DIV_SHIFT |
1452 source << ARIZONA_FLL1_CLK_REF_SRC_SHIFT);
1455 regmap_update_bits(arizona->regmap, base + 0x7,
1456 ARIZONA_FLL1_GAIN_MASK,
1457 cfg->gain << ARIZONA_FLL1_GAIN_SHIFT);
1459 regmap_update_bits(arizona->regmap, base + 0x9,
1460 ARIZONA_FLL1_GAIN_MASK,
1461 cfg->gain << ARIZONA_FLL1_GAIN_SHIFT);
1463 regmap_update_bits(arizona->regmap, base + 2,
1464 ARIZONA_FLL1_CTRL_UPD | ARIZONA_FLL1_N_MASK,
1465 ARIZONA_FLL1_CTRL_UPD | cfg->n);
1468 static bool arizona_is_enabled_fll(struct arizona_fll *fll)
1470 struct arizona *arizona = fll->arizona;
1474 ret = regmap_read(arizona->regmap, fll->base + 1, ®);
1476 arizona_fll_err(fll, "Failed to read current state: %d\n",
1481 return reg & ARIZONA_FLL1_ENA;
1484 static void arizona_enable_fll(struct arizona_fll *fll,
1485 struct arizona_fll_cfg *ref,
1486 struct arizona_fll_cfg *sync)
1488 struct arizona *arizona = fll->arizona;
1490 bool use_sync = false;
1493 * If we have both REFCLK and SYNCCLK then enable both,
1494 * otherwise apply the SYNCCLK settings to REFCLK.
1496 if (fll->ref_src >= 0 && fll->ref_freq &&
1497 fll->ref_src != fll->sync_src) {
1498 regmap_update_bits(arizona->regmap, fll->base + 5,
1499 ARIZONA_FLL1_OUTDIV_MASK,
1500 ref->outdiv << ARIZONA_FLL1_OUTDIV_SHIFT);
1502 arizona_apply_fll(arizona, fll->base, ref, fll->ref_src,
1504 if (fll->sync_src >= 0) {
1505 arizona_apply_fll(arizona, fll->base + 0x10, sync,
1506 fll->sync_src, true);
1509 } else if (fll->sync_src >= 0) {
1510 regmap_update_bits(arizona->regmap, fll->base + 5,
1511 ARIZONA_FLL1_OUTDIV_MASK,
1512 sync->outdiv << ARIZONA_FLL1_OUTDIV_SHIFT);
1514 arizona_apply_fll(arizona, fll->base, sync,
1515 fll->sync_src, false);
1517 regmap_update_bits(arizona->regmap, fll->base + 0x11,
1518 ARIZONA_FLL1_SYNC_ENA, 0);
1520 arizona_fll_err(fll, "No clocks provided\n");
1525 * Increase the bandwidth if we're not using a low frequency
1528 if (use_sync && fll->sync_freq > 100000)
1529 regmap_update_bits(arizona->regmap, fll->base + 0x17,
1530 ARIZONA_FLL1_SYNC_BW, 0);
1532 regmap_update_bits(arizona->regmap, fll->base + 0x17,
1533 ARIZONA_FLL1_SYNC_BW, ARIZONA_FLL1_SYNC_BW);
1535 if (!arizona_is_enabled_fll(fll))
1536 pm_runtime_get(arizona->dev);
1538 /* Clear any pending completions */
1539 try_wait_for_completion(&fll->ok);
1541 regmap_update_bits(arizona->regmap, fll->base + 1,
1542 ARIZONA_FLL1_FREERUN, 0);
1543 regmap_update_bits(arizona->regmap, fll->base + 1,
1544 ARIZONA_FLL1_ENA, ARIZONA_FLL1_ENA);
1546 regmap_update_bits(arizona->regmap, fll->base + 0x11,
1547 ARIZONA_FLL1_SYNC_ENA,
1548 ARIZONA_FLL1_SYNC_ENA);
1550 ret = wait_for_completion_timeout(&fll->ok,
1551 msecs_to_jiffies(250));
1553 arizona_fll_warn(fll, "Timed out waiting for lock\n");
1556 static void arizona_disable_fll(struct arizona_fll *fll)
1558 struct arizona *arizona = fll->arizona;
1561 regmap_update_bits(arizona->regmap, fll->base + 1,
1562 ARIZONA_FLL1_FREERUN, ARIZONA_FLL1_FREERUN);
1563 regmap_update_bits_check(arizona->regmap, fll->base + 1,
1564 ARIZONA_FLL1_ENA, 0, &change);
1565 regmap_update_bits(arizona->regmap, fll->base + 0x11,
1566 ARIZONA_FLL1_SYNC_ENA, 0);
1569 pm_runtime_put_autosuspend(arizona->dev);
1572 int arizona_set_fll_refclk(struct arizona_fll *fll, int source,
1573 unsigned int Fref, unsigned int Fout)
1575 struct arizona_fll_cfg ref, sync;
1578 if (fll->ref_src == source && fll->ref_freq == Fref)
1583 ret = arizona_calc_fll(fll, &ref, Fref, fll->fout);
1588 if (fll->sync_src >= 0) {
1589 ret = arizona_calc_fll(fll, &sync, fll->sync_freq,
1596 fll->ref_src = source;
1597 fll->ref_freq = Fref;
1599 if (fll->fout && Fref > 0) {
1600 arizona_enable_fll(fll, &ref, &sync);
1605 EXPORT_SYMBOL_GPL(arizona_set_fll_refclk);
1607 int arizona_set_fll(struct arizona_fll *fll, int source,
1608 unsigned int Fref, unsigned int Fout)
1610 struct arizona_fll_cfg ref, sync;
1613 if (fll->sync_src == source &&
1614 fll->sync_freq == Fref && fll->fout == Fout)
1618 if (fll->ref_src >= 0) {
1619 ret = arizona_calc_fll(fll, &ref, fll->ref_freq,
1625 ret = arizona_calc_fll(fll, &sync, Fref, Fout);
1630 fll->sync_src = source;
1631 fll->sync_freq = Fref;
1635 arizona_enable_fll(fll, &ref, &sync);
1637 arizona_disable_fll(fll);
1642 EXPORT_SYMBOL_GPL(arizona_set_fll);
1644 int arizona_init_fll(struct arizona *arizona, int id, int base, int lock_irq,
1645 int ok_irq, struct arizona_fll *fll)
1650 init_completion(&fll->ok);
1654 fll->arizona = arizona;
1655 fll->sync_src = ARIZONA_FLL_SRC_NONE;
1657 /* Configure default refclk to 32kHz if we have one */
1658 regmap_read(arizona->regmap, ARIZONA_CLOCK_32K_1, &val);
1659 switch (val & ARIZONA_CLK_32K_SRC_MASK) {
1660 case ARIZONA_CLK_SRC_MCLK1:
1661 case ARIZONA_CLK_SRC_MCLK2:
1662 fll->ref_src = val & ARIZONA_CLK_32K_SRC_MASK;
1665 fll->ref_src = ARIZONA_FLL_SRC_NONE;
1667 fll->ref_freq = 32768;
1669 snprintf(fll->lock_name, sizeof(fll->lock_name), "FLL%d lock", id);
1670 snprintf(fll->clock_ok_name, sizeof(fll->clock_ok_name),
1671 "FLL%d clock OK", id);
1673 ret = arizona_request_irq(arizona, ok_irq, fll->clock_ok_name,
1674 arizona_fll_clock_ok, fll);
1676 dev_err(arizona->dev, "Failed to get FLL%d clock OK IRQ: %d\n",
1680 regmap_update_bits(arizona->regmap, fll->base + 1,
1681 ARIZONA_FLL1_FREERUN, 0);
1685 EXPORT_SYMBOL_GPL(arizona_init_fll);
1688 * arizona_set_output_mode - Set the mode of the specified output
1690 * @codec: Device to configure
1691 * @output: Output number
1692 * @diff: True to set the output to differential mode
1694 * Some systems use external analogue switches to connect more
1695 * analogue devices to the CODEC than are supported by the device. In
1696 * some systems this requires changing the switched output from single
1697 * ended to differential mode dynamically at runtime, an operation
1698 * supported using this function.
1700 * Most systems have a single static configuration and should use
1701 * platform data instead.
1703 int arizona_set_output_mode(struct snd_soc_codec *codec, int output, bool diff)
1705 unsigned int reg, val;
1707 if (output < 1 || output > 6)
1710 reg = ARIZONA_OUTPUT_PATH_CONFIG_1L + (output - 1) * 8;
1713 val = ARIZONA_OUT1_MONO;
1717 return snd_soc_update_bits(codec, reg, ARIZONA_OUT1_MONO, val);
1719 EXPORT_SYMBOL_GPL(arizona_set_output_mode);
1721 MODULE_DESCRIPTION("ASoC Wolfson Arizona class device support");
1722 MODULE_AUTHOR("Mark Brown <broonie@opensource.wolfsonmicro.com>");
1723 MODULE_LICENSE("GPL");