kernel_samsung_msm8974/Documentation/devicetree/bindings/sound/taiko_codec.txt

taiko audio CODEC

Required properties:

 - compatible : "qcom,taiko-slim-pgd"
 - elemental-addr: codec slimbus slave PGD enumeration address.(48 bits)

 - qcom,cdc-reset-gpio: gpio used for codec SOC reset.

 - cdc-vdd-buck-supply: phandle of buck supply's regulator device tree node.
 - qcom,cdc-vdd-buck-voltage: buck supply's voltage level min and max in mV.
 - qcom,cdc-vdd-buck-current: buck supply's max current in mA.

 - cdc-vdd-tx-h-supply: phandle of tx-h supply's regulator device tree node.
 - qcom,cdc-vdd-tx-h-voltage: tx-h supply's voltage level min and max in mV.
 - qcom,cdc-vdd-tx-h-current: tx-h supply's max current in mA.

 - cdc-vdd-rx-h-supply: phandle of rx-h supply's regulator device tree node.
 - qcom,cdc-vdd-rx-h-voltage: rx-h supply's voltage level min and max in mV.
 - qcom,cdc-vdd-rx-h-current: rx-h supply's max current in mA.

 - cdc-vddpx-1-supply: phandle of px-1 supply's regulator device tree node.
 - qcom,cdc-vddpx-1-voltage: px-1 supply's voltage level min and max in mV.
 - qcom,cdc-vddpx-1-current: px-1 supply's max current in mA.

 - cdc-vdd-a-1p2v-supply: phandle of 1.2v supply's regulator device tree node.
 - qcom,cdc-vdd-a-1p2v-voltage: 1.2v supply's voltage level min and max in mV.
 - qcom,cdc-vdd-a-1p2v-current: 1.2v supply's max current in mA.

 - cdc-vddcx-1-supply: phandle of cx-1 supply's regulator device tree node.
 - qcom,cdc-vddcx-1-voltage: cx-1 supply's voltage level min and max in mV.
 - qcom,cdc-vddcx-1-current: cx-1 supply's max current in mA.

 - cdc-vddcx-2-supply: phandle of cx-2 supply's regulator device tree node.
 - qcom,cdc-vddcx-2-voltage: cx-2 supply's voltage level min and max in mV.
 - qcom,cdc-vddcx-2-current: cx-2 supply's max current in mA.

 - cdc-vdd-buckhelper-supply: phandle of helper regulator supply's
				device tree node. This supply is a helper regulator for
				cdc-vdd-buck-supply regulator.
 - cdc-vdd-buckhelper-voltage: helper supply's voltage level min and max in mV.
 - qcom,cdc-vdd-buckhelper-current: helper supply's max current in mA.

 - qcom,cdc-static-supplies: List of supplies to be enabled prior to codec
			     hardware probe.  Supplies in this list will be
			     stay enabled.

 - qcom,cdc-micbias-ldoh-v - LDOH output in volts (should be 1.95 V and 3.00 V).

 - qcom,cdc-micbias-cfilt1-mv - cfilt1 output voltage in milli volts.
 - qcom,cdc-micbias-cfilt2-mv - cfilt2 output voltage in milli volts.
 - qcom,cdc-micbias-cfilt3-mv - cfilt3 output voltage in milli volts.
   cfilt voltage can be set to max of qcom,cdc-micbias-ldoh-v - 0.15V.

 - qcom,cdc-micbias1-cfilt-sel = cfilt to use for micbias1
				 (should be from 1 to 3).
 - qcom,cdc-micbias2-cfilt-sel = cfilt to use for micbias2
				 (should be from 1 to 3).
 - qcom,cdc-micbias3-cfilt-sel = cfilt to use for micbias3
				 (should be from 1 to 3).
 - qcom,cdc-micbias4-cfilt-sel = cfilt to use for micbias4
				 (should be from 1 to 3).
   This value represents the connected CFLIT to MIC Bias.

 - qcom,cdc-micbias1-ext-cap: Boolean. Enable micbias 1 external capacitor mode.
 - qcom,cdc-micbias2-ext-cap: Boolean. Enable micbias 2 external capacitor mode.
 - qcom,cdc-micbias3-ext-cap: Boolean. Enable micbias 3 external capacitor mode.
 - qcom,cdc-micbias4-ext-cap: Boolean. Enable micbias 4 external capacitor mode.
 - qcom,cdc-mclk-clk-rate - Specifies the master clock rate in Hz required for
			    codec.
 - qcom,cdc-slim-ifd-dev - namme of the codec slim interface device.
 - qcom,cdc-slim-ifd-elemental-addr - codec slimbus slave interface device
				     enumeration address.

Optional properties:
 - cdc-dmic-sample-rate: Specifies the sample rate of digital mic in HZ. The
			 values for 9.6MHZ mclk can be 2400000 Hz, 3200000 Hz
			 and 4800000 Hz.  The values for 12.288MHz mclk can be
			 3072200 Hz, 4096000 Hz and 6144000 Hz.

 - qcom,cdc-on-demand-supplies: List of supplies which can be enabled
				dynamically.
				Supplies in this list are off by default.

- qcom,cdc-cp-supplies: List of supplies required for codec chargepump enable
				Supplies in this list can be enabled/disabled dynamically and
				are off by default.

 - qcom,cdc-micbias2-headset-only: Boolean. Allow micbias 2 only to headset mic.

Example:

taiko_codec {
	compatible = "qcom,taiko-slim-pgd";
	elemental-addr = [00 01 A0 00 17 02];

	qcom,cdc-reset-gpio = <&msmgpio 63 0>;

	cdc-vdd-buck-supply = <&pm8941_s2>;
	qcom,cdc-vdd-buck-voltage = <2150000 2150000>;
	qcom,cdc-vdd-buck-current = <500000>;

	cdc-vdd-tx-h-supply = <&pm8941_s3>;
	qcom,cdc-vdd-tx-h-voltage = <1800000 1800000>;
	qcom,cdc-vdd-tx-h-current = <200000>;

	cdc-vdd-rx-h-supply = <&pm8941_s3>;
	qcom,cdc-vdd-rx-h-voltage = <1800000 1800000>;
	qcom,cdc-vdd-rx-h-current = <200000>;

	cdc-vddpx-1-supply = <&pm8941_s3>;
	qcom,cdc-vddpx-1-voltage = <1800000 1800000>;
	qcom,cdc-vddpx-1-current = <5000>;

	cdc-vdd-a-1p2v-supply = <&pm8941_l1>;
	qcom,cdc-vdd-a-1p2v-voltage = <1225000 1225000>;
	qcom,cdc-vdd-a-1p2v-current = <5000>;

	cdc-vddcx-1-supply = <&pm8941_l1>;
	qcom,cdc-vddcx-1-voltage = <1225000 1225000>;
	qcom,cdc-vddcx-1-current = <5000>;

	cdc-vddcx-2-supply = <&pm8941_l1>;
	qcom,cdc-vddcx-2-voltage = <1225000 1225000>;
	qcom,cdc-vddcx-2-current = <5000>;

	qcom,cdc-static-supplies = "cdc-vdd-buck",
				   "cdc-vdd-tx-h",
				   "cdc-vdd-rx-h",
				   "cdc-vddpx-1",
				   "cdc-vdd-a-1p2v",
				   "cdc-vddcx-1",
				   "cdc-vddcx-2";

	com,cdc-on-demand-supplies = "cdc-vdd-spkdrv";

	qcom,cdc-micbias-ldoh-v = <0x3>;
	qcom,cdc-micbias-cfilt1-mv = <1800>;
	qcom,cdc-micbias-cfilt2-mv = <2700>;
	qcom,cdc-micbias-cfilt3-mv = <1800>;
	qcom,cdc-micbias1-cfilt-sel = <0x0>;
	qcom,cdc-micbias2-cfilt-sel = <0x1>;
	qcom,cdc-micbias3-cfilt-sel = <0x2>;
	qcom,cdc-micbias4-cfilt-sel = <0x2>;
	qcom,cdc-micbias1-ext-cap;
	qcom,cdc-micbias2-ext-cap;
	qcom,cdc-micbias3-ext-cap;
	qcom,cdc-micbias4-ext-cap;
	qcom,cdc-mclk-clk-rate = <9600000>;
	qcom,cdc-slim-ifd = "taiko-slim-ifd";
	qcom,cdc-slim-ifd-elemental-addr = [00 00 A0 00 17 02];
	qcom,cdc-dmic-sample-rate = <4800000>;
	qcom,cdc-micbias2-headset-only;
};

Wcd9xxx audio CODEC in I2C mode

 - compatible = "qcom,wcd9xxx-i2c-device";
 - reg: represents the slave address provided to the I2C driver.
 - qcom,cdc-reset-gpio: gpio used for codec SOC reset.

 - cdc-vdd-buck-supply: phandle of buck supply's regulator device tree node.
 - qcom,cdc-vdd-buck-voltage: buck supply's voltage level min and max in mV.
 - qcom,cdc-vdd-buck-current: buck supply's max current in mA.

 - cdc-vdd-tx-h-supply: phandle of tx-h supply's regulator device tree node.
 - qcom,cdc-vdd-tx-h-voltage: tx-h supply's voltage level min and max in mV.
 - qcom,cdc-vdd-tx-h-current: tx-h supply's max current in mA.

 - cdc-vdd-rx-h-supply: phandle of rx-h supply's regulator device tree node.
 - qcom,cdc-vdd-rx-h-voltage: rx-h supply's voltage level min and max in mV.
 - qcom,cdc-vdd-rx-h-current: rx-h supply's max current in mA.

 - cdc-vddpx-1-supply: phandle of px-1 supply's regulator device tree node.
 - qcom,cdc-vddpx-1-voltage: px-1 supply's voltage level min and max in mV.
 - qcom,cdc-vddpx-1-current: px-1 supply's max current in mA.

 - cdc-vdd-a-1p2v-supply: phandle of 1.2v supply's regulator device tree node.
 - qcom,cdc-vdd-a-1p2v-voltage: 1.2v supply's voltage level min and max in mV.
 - qcom,cdc-vdd-a-1p2v-current: 1.2v supply's max current in mA.

 - cdc-vddcx-1-supply: phandle of cx-1 supply's regulator device tree node.
 - qcom,cdc-vddcx-1-voltage: cx-1 supply's voltage level min and max in mV.
 - qcom,cdc-vddcx-1-current: cx-1 supply's max current in mA.

 - cdc-vddcx-2-supply: phandle of cx-2 supply's regulator device tree node.
 - qcom,cdc-vddcx-2-voltage: cx-2 supply's voltage level min and max in mV.
 - qcom,cdc-vddcx-2-current: cx-2 supply's max current in mA.

 - qcom,cdc-static-supplies: List of supplies to be enabled prior to codec
			     hardware probe.  Supplies in this list will be
			     stay enabled.

 - qcom,cdc-micbias-ldoh-v - LDOH output in volts (should be 1.95 V and 3.00 V).

 - qcom,cdc-micbias-cfilt1-mv - cfilt1 output voltage in milli volts.
 - qcom,cdc-micbias-cfilt2-mv - cfilt2 output voltage in milli volts.
 - qcom,cdc-micbias-cfilt3-mv - cfilt3 output voltage in milli volts.
   cfilt voltage can be set to max of qcom,cdc-micbias-ldoh-v - 0.15V.

 - qcom,cdc-micbias1-cfilt-sel = cfilt to use for micbias1
				 (should be from 1 to 3).
 - qcom,cdc-micbias2-cfilt-sel = cfilt to use for micbias2
				 (should be from 1 to 3).
 - qcom,cdc-micbias3-cfilt-sel = cfilt to use for micbias3
				 (should be from 1 to 3).
 - qcom,cdc-micbias4-cfilt-sel = cfilt to use for micbias4
				 (should be from 1 to 3).
   This value represents the connected CFLIT to MIC Bias.

 - qcom,cdc-micbias1-ext-cap: Boolean. Enable micbias 1 external capacitor mode.
 - qcom,cdc-micbias2-ext-cap: Boolean. Enable micbias 2 external capacitor mode.
 - qcom,cdc-micbias3-ext-cap: Boolean. Enable micbias 3 external capacitor mode.
 - qcom,cdc-micbias4-ext-cap: Boolean. Enable micbias 4 external capacitor mode.
 - qcom,cdc-mclk-clk-rate - Specifies the master clock rate in Hz required for
			    codec.

Optional properties:

 - cdc-vdd-spkdrv-supply: phandle of spkdrv supply's regulator device tree node.
 - qcom,cdc-vdd-spkdrv-voltage: spkdrv supply voltage level min and max in mV.
 - qcom,cdc-vdd-spkdrv-current: spkdrv supply max current in mA.

 - cdc-vdd-spkdrv-supply: phandle of spkdrv supply's regulator device tree node.
 - qcom,cdc-vdd-spkdrv-voltage: spkdrv supply voltage level min and max in mV.
 - qcom,cdc-vdd-spkdrv-current: spkdrv supply max current in mA.

 - qcom,cdc-on-demand-supplies: List of supplies which can be enabled
				dynamically.
				Supplies in this list are off by default.

Example:
i2c@f9925000 {
	cell-index = <3>;
	compatible = "qcom,i2c-qup";
	reg = <0xf9925000 0x1000>;
	#address-cells = <1>;
	#size-cells = <0>;
	reg-names = "qup_phys_addr";
	interrupts = <0 97 0>;
	interrupt-names = "qup_err_intr";
	qcom,i2c-bus-freq = <100000>;
	qcom,i2c-src-freq = <24000000>;

	wcd9xxx_codec@0d{
		compatible = "qcom,wcd9xxx-i2c";
		reg = <0x0d>;
		qcom,cdc-reset-gpio = <&msmgpio 22 0>;
		interrupt-parent = <&wcd9xxx_intc>;
		interrupts = <0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19
			      20 21 22 23 24 25 26 27 28>;

		cdc-vdd-buck-supply = <&pm8019_l11>;
		qcom,cdc-vdd-buck-voltage = <1800000 1800000>;
		qcom,cdc-vdd-buck-current = <25000>;

		cdc-vdd-tx-h-supply = <&pm8019_l11>;
		qcom,cdc-vdd-tx-h-voltage = <1800000 1800000>;
		qcom,cdc-vdd-tx-h-current = <25000>;

		cdc-vdd-rx-h-supply = <&pm8019_l11>;
		qcom,cdc-vdd-rx-h-voltage = <1800000 1800000>;
		qcom,cdc-vdd-rx-h-current = <25000>;

		cdc-vddpx-1-supply = <&pm8019_l11>;
		qcom,cdc-vddpx-1-voltage = <1800000 1800000>;
		qcom,cdc-vddpx-1-current = <10000>;

		cdc-vdd-a-1p2v-supply = <&pm8019_l9>;
		qcom,cdc-vdd-a-1p2v-voltage = <1200000 1200000>;
		qcom,cdc-vdd-a-1p2v-current = <10000>;

		cdc-vddcx-1-supply = <&pm8019_l9>;
		qcom,cdc-vddcx-1-voltage = <1200000 1200000>;
		qcom,cdc-vddcx-1-current = <10000>;

		cdc-vddcx-2-supply = <&pm8019_l9>;
		qcom,cdc-vddcx-2-voltage = <1200000 1200000>;
		qcom,cdc-vddcx-2-current = <10000>;

		qcom,cdc-static-supplies = "cdc-vdd-buck",
					   "cdc-vdd-tx-h",
					   "cdc-vdd-rx-h",
					   "cdc-vddpx-1",
					   "cdc-vdd-a-1p2v",
					   "cdc-vddcx-1",
					   "cdc-vddcx-2";

		com,cdc-on-demand-supplies = "cdc-vdd-spkdrv";

		qcom,cdc-micbias-ldoh-v = <0x3>;
		qcom,cdc-micbias-cfilt1-mv = <1800>;
		qcom,cdc-micbias-cfilt2-mv = <2700>;
		qcom,cdc-micbias-cfilt3-mv = <1800>;
		qcom,cdc-micbias1-cfilt-sel = <0x0>;
		qcom,cdc-micbias2-cfilt-sel = <0x1>;
		qcom,cdc-micbias3-cfilt-sel = <0x2>;
		qcom,cdc-micbias4-cfilt-sel = <0x2>;
		qcom,cdc-mclk-clk-rate = <12288000>;
	};

	wcd9xxx_codec@77{
		compatible = "qcom,wcd9xxx-i2c";
		reg = <0x77>;
	};

	wcd9xxx_codec@66{
		compatible = "qcom,wcd9xxx-i2c";
		reg = <0x66>;
	};
	wcd9xxx_codec@55{
		compatible = "qcom,wcd9xxx-i2c";
		reg = <0x55>;
	};
};