Documentation: sound: add bolero codec documentation for kona

		asoc-codec = <&stub_codec>;

		asoc-codec-names = "msm-stub-codec.1";

	};

* KONA ASoC Machine driver

Required properties:

- compatible : "qcom,kona-asoc-snd".

- qcom,model : The user-visible name of this sound card.

- qcom,audio-routing : A list of the connections between audio components.

- asoc-platform: This is phandle list containing the references to platform device

		 nodes that are used as part of the sound card dai-links.

- asoc-platform-names: This property contains list of platform names. The order of

		       the platform names should match to that of the phandle order

		       given in "asoc-platform".

- asoc-cpu: This is phandle list containing the references to cpu dai device nodes

	    that are used as part of the sound card dai-links.

- asoc-cpu-names: This property contains list of cpu dai names. The order of the

		  cpu dai names should match to that of the phandle order given

		  in "asoc-cpu". The cpu names are in the form of "%s.%d" form,

		  where the id (%d) field represents the back-end AFE port id that

		  this CPU dai is associated with.

- asoc-codec: This is phandle list containing the references to codec dai device

	      nodes that are used as part of the sound card dai-links.

- asoc-codec-names: This property contains list of codec dai names. The order of the

		    codec dai names should match to that of the phandle order given

		    in "asoc-codec".

- qcom,codec-aux-devs: This is phandle list containing the references to Auxilary

		       codec devices.

Optional properties:

- qcom,msm-mi2s-master: This property is used to inform machine driver

  if MSM is the clock master of mi2s. 1 means master and 0 means slave. The

  first entry is primary mi2s; the second entry is secondary mi2s, and so on.

- qcom,msm-mbhc-hphl-swh: This property is used to distinguish headset HPHL

  switch type on target typically the switch type will be normally open or

  normally close, value for this property 0 for normally close and 1 for

  normally open.

- qcom,msm-mbhc-gnd-swh: This property is used to distinguish headset GND

  switch type on target typically the switch type will be normally open or

  normally close, value for this property 0 for normally close and 1 for

  normally open.

- qcom,wsa-max-devs : Maximum number of WSA881x devices present in the target

- qcom,wsa-devs : List of phandles for all possible WSA881x devices supported for the target

- qcom,wsa-aux-dev-prefix : Name prefix with Left/Right configuration for WSA881x device

- qcom,ext-disp-audio-rx: Property to specify if Audio over Display port is supported for the target

- qcom,wcn-btfm : Property to specify if WCN BT/FM chip is used for the target

- qcom,mi2s-audio-intf: Property to specify if MI2S interface is used for the target

- qcom,auxpcm-audio-intf: Property to specify if Aux PCM interface is used for the target

- qcom,cdc-dmic-gpios : phandle for Digital mic clk and data gpios.

- qcom,msm_audio_ssr_devs: List the snd event framework clients

Example:

	kona_snd: sound {

		status = "okay";

		compatible = "qcom,kona-asoc-snd";

		qcom,ext-disp-audio-rx = <1>;

		qcom,wcn-btfm = <1>;

		qcom,mi2s-audio-intf = <1>;

		qcom,auxpcm-audio-intf = <1>;

		asoc-platform = <&pcm0>, <&pcm1>, <&pcm2>, <&voip>, <&voice>,

				<&loopback>, <&compress>, <&hostless>,

				<&afe>, <&lsm>, <&routing>, <&compr>,

				<&pcm_noirq>;

		asoc-platform-names = "msm-pcm-dsp.0", "msm-pcm-dsp.1",

				"msm-pcm-dsp.2", "msm-voip-dsp",

				"msm-pcm-voice", "msm-pcm-loopback",

				"msm-compress-dsp", "msm-pcm-hostless",

				"msm-pcm-afe", "msm-lsm-client",

				"msm-pcm-routing", "msm-compr-dsp",

				"msm-pcm-dsp-noirq";

		asoc-cpu = <&dai_dp>,

				<&dai_mi2s0>, <&dai_mi2s1>,

				<&dai_mi2s2>, <&dai_mi2s3>,

				<&dai_mi2s4>, <&dai_pri_auxpcm>,

				<&dai_sec_auxpcm>, <&dai_tert_auxpcm>,

				<&dai_quat_auxpcm>, <&dai_quin_auxpcm>,

				<&afe_pcm_rx>, <&afe_pcm_tx>, <&afe_proxy_rx>,

				<&afe_proxy_tx>, <&incall_record_rx>,

				<&incall_record_tx>, <&incall_music_rx>,

				<&incall_music_2_rx>,

				<&usb_audio_rx>, <&usb_audio_tx>,

				<&dai_pri_tdm_rx_0>, <&dai_pri_tdm_tx_0>,

				<&dai_sec_tdm_rx_0>, <&dai_sec_tdm_tx_0>,

				<&dai_tert_tdm_rx_0>, <&dai_tert_tdm_tx_0>,

				<&dai_quat_tdm_rx_0>, <&dai_quat_tdm_tx_0>,

				<&dai_quin_tdm_rx_0>, <&dai_quin_tdm_tx_0>,

				<&wsa_cdc_dma_0_rx>, <&wsa_cdc_dma_0_tx>,

				<&wsa_cdc_dma_1_rx>, <&wsa_cdc_dma_1_tx>,

				<&wsa_cdc_dma_2_tx>,

				<&va_cdc_dma_0_tx>, <&va_cdc_dma_1_tx>,

				<&rx_cdc_dma_0_rx>, <&tx_cdc_dma_0_tx>,

				<&rx_cdc_dma_1_rx>, <&tx_cdc_dma_1_tx>,

				<&rx_cdc_dma_2_rx>, <&tx_cdc_dma_2_tx>,

				<&rx_cdc_dma_3_rx>, <&tx_cdc_dma_3_tx>,

				<&rx_cdc_dma_4_rx>, <&tx_cdc_dma_4_tx>,

				<&rx_cdc_dma_5_rx>, <&tx_cdc_dma_5_tx>,

				<&tx_cdc_dma_6_tx>, <&tx_cdc_dma_7_tx>;

		asoc-cpu-names = "msm-dai-q6-dp.24608",

				"msm-dai-q6-mi2s.0", "msm-dai-q6-mi2s.1",

				"msm-dai-q6-mi2s.2", "msm-dai-q6-mi2s.3",

				"msm-dai-q6-mi2s.4", "msm-dai-q6-auxpcm.1",

				"msm-dai-q6-auxpcm.2", "msm-dai-q6-auxpcm.3",

				"msm-dai-q6-auxpcm.4", "msm-dai-q6-auxpcm.5",

				"msm-dai-q6-dev.224",

				"msm-dai-q6-dev.225", "msm-dai-q6-dev.241",

				"msm-dai-q6-dev.240", "msm-dai-q6-dev.32771",

				"msm-dai-q6-dev.32772", "msm-dai-q6-dev.32773",

				"msm-dai-q6-dev.32770", "msm-dai-q6-dev.16398",

				"msm-dai-q6-dev.16399", "msm-dai-q6-dev.16401",

				"msm-dai-q6-dev.16400",

				"msm-dai-q6-dev.28672", "msm-dai-q6-dev.28673",

				"msm-dai-q6-tdm.36864", "msm-dai-q6-tdm.36865",

				"msm-dai-q6-tdm.36880", "msm-dai-q6-tdm.36881",

				"msm-dai-q6-tdm.36896", "msm-dai-q6-tdm.36897",

				"msm-dai-q6-tdm.36912", "msm-dai-q6-tdm.36913",

				"msm-dai-q6-tdm.36928", "msm-dai-q6-tdm.36929",

				"msm-dai-cdc-dma-dev.45056",

				"msm-dai-cdc-dma-dev.45057",

				"msm-dai-cdc-dma-dev.45058",

				"msm-dai-cdc-dma-dev.45059",

				"msm-dai-cdc-dma-dev.45061",

				"msm-dai-cdc-dma-dev.45089",

				"msm-dai-cdc-dma-dev.45091",

				"msm-dai-cdc-dma-dev.45120",

				"msm-dai-cdc-dma-dev.45121",

				"msm-dai-cdc-dma-dev.45122",

				"msm-dai-cdc-dma-dev.45123",

				"msm-dai-cdc-dma-dev.45124",

				"msm-dai-cdc-dma-dev.45125",

				"msm-dai-cdc-dma-dev.45126",

				"msm-dai-cdc-dma-dev.45127",

				"msm-dai-cdc-dma-dev.45128",

				"msm-dai-cdc-dma-dev.45129",

				"msm-dai-cdc-dma-dev.45130",

				"msm-dai-cdc-dma-dev.45131",

				"msm-dai-cdc-dma-dev.45133",

				"msm-dai-cdc-dma-dev.45135";

		qcom,msm-mi2s-master = <1>, <1>, <1>, <1>, <1>;

		qcom,msm-mbhc-hphl-swh = <1>;

		qcom,msm-mbhc-gnd-swh = <1>;

		qcom,cdc-dmic-gpios = <&cdc_dmic12_gpios>, <&cdc_dmic34_gpios>;

		asoc-codec  = <&stub_codec>, <&bolero>,

			      <&ext_disp_audio_codec>;

		asoc-codec-names = "msm-stub-codec.1", "bolero-codec",

				   "msm-ext-disp-audio-codec-rx";

		qcom,wsa-max-devs = <2>;

		qcom,wsa-devs = <&wsa881x_0211>, <&wsa881x_0212>,

				<&wsa881x_0213>, <&wsa881x_0214>;

		qcom,wsa-aux-dev-prefix = "SpkrLeft", "SpkrRight",

					  "SpkrLeft", "SpkrRight";

		qcom,codec-aux-devs = <&wcd937x_codec>;

		qcom,msm_audio_ssr_devs = <&audio_apr>, <&q6core>;

	};

};

Qualcomm Technologies, Inc. WCD audio CODEC

WSA macro in Bolero codec

Required properties:

 - compatible = "qcom,wsa-macro";

 - reg: Specifies the WSA macro base address for Bolero

	soundwire core registers.

 - clock-names : clock names defined for WSA macro

 - clocks : clock handles defined for WSA  macro

 - qcom,wsa-swr-gpios: phandle for SWR data and clock GPIOs of WSA macro

 - qcom,wsa-bcl-pmic-params: u8 array of PMIC ID, SID and PPID in same order

			 required to be configured to receive interrupts

			 in BCL block of WSA macro

Example:

&bolero {

	wsa_macro: wsa-macro {

		compatible = "qcom,wsa-macro";

		reg = <0x0C2C0000 0x0>;

		clock-names = "wsa_core_clk", "wsa_npl_clk";

		clocks = <&clock_audio_wsa_1 0>,

		<&clock_audio_wsa_2 0>;

		qcom,wsa-swr-gpios = &wsa_swr_gpios;

		qcom,wsa-bcl-pmic-params = /bits/ 8 <0x00 0x00 0x1E>;

		swr_0: wsa_swr_master {

			compatible = "qcom,swr-mstr";

			wsa881x_1: wsa881x@20170212 {

				compatible = "qcom,wsa881x";

				reg = <0x00 0x20170212>;

				qcom,spkr-sd-n-gpio = <&tlmm 80 0>;

			};

		};

	};

};

VA macro in bolero codec

Required properties:

 - compatible = "qcom,va-macro";

 - reg: Specifies the VA macro base address for Bolero

	soundwire core registers.

 - clock-names : clock names defined for WSA macro

 - clocks : clock handles defined for WSA  macro

Example:

&bolero {

	va_macro: va-macro {

		compatible = "qcom,va-macro";

		reg = <0x0C490000 0x0>;

		clock-names = "va_core_clk";

		clocks = <&clock_audio_va 0>;

	};

};

RX macro in bolero codec

Required properties:

 - compatible = "qcom,rx-macro";

 - reg: Specifies the Rx macro base address for Bolero

	soundwire core registers.

 - clock-names : clock names defined for RX macro

 - clocks : clock handles defined for RX macro

 - qcom,rx-swr-gpios: phandle for SWR data and clock GPIOs of RX macro

 - qcom,rx_mclk_mode_muxsel: register address for RX macro MCLK mode mux select

 - qcom,rx-bcl-pmic-params: u8 array of PMIC ID, SID and PPID in same order

			 required to be configured to receive interrupts

			 in BCL block of WSA macro

Example:

&bolero {

	rx_macro: rx-macro {

		compatible = "qcom,rx-macro";

		reg = <0x62EE0000 0x0>;

		clock-names = "rx_core_clk", "rx_npl_clk";

		clocks = <&clock_audio_rx_1 0>,

			 <&clock_audio_rx_2 0>;

		qcom,rx-swr-gpios = <&rx_swr_gpios>;

		qcom,rx_mclk_mode_muxsel = <0x62C25020>;

		qcom,rx-bcl-pmic-params = /bits/ 8 <0x00 0x00 0x1E>;

		swr_1: rx_swr_master {

			compatible = "qcom,swr-mstr";

			wcd938x_rx_slave: wcd938x-rx-slave {

				compatible = "qcom,wcd938x-slave";

			};

		};

	};

};

TX macro in bolero codec

Required properties:

 - compatible = "qcom,tx-macro";

 - reg: Specifies the Tx macro base address for Bolero

	soundwire core registers.

 - clock-names : clock names defined for TX macro

 - clocks : clock handles defined for TX macro

 - qcom,tx-swr-gpios: phandle for SWR data and clock GPIOs of TX macro

 - qcom,tx-dmic-sample-rate: Sample rate defined for DMICs connected to TX macro

Example:

&bolero {

	tx_macro: tx-macro {

		compatible = "qcom,tx-macro";

		reg = <0x62EC0000 0x0>;

		clock-names = "tx_core_clk", "tx_npl_clk";

		clocks = <&clock_audio_tx_1 0>

			 <&clock_audio_tx_2 0>;

		qcom,tx-swr-gpios = <&tx_swr_gpios>;

		qcom,tx-dmic-sample-rate = <4800000>;

		swr_2: tx_swr_master {

			compatible = "qcom,swr-mstr";

			wcd938x_tx_slave: wcd938x-tx-slave {

				compatible = "qcom,wcd938x-slave";

			};

		};

	};

};

Traverso Codec

Required properties:

 - compatible: "qcom,wcd938x-codec";

 - qcom,rx_swr_ch_map: mapping of swr rx slave port configuration to port_type and also

		corresponding master port type it need to attach.

		format: <port_id, slave_port_type, ch_mask, ch_rate, master_port_type>

		same port_id configurations have to be grouped, and in ascending order.

 - qcom,tx_swr_ch_map: mapping of swr tx slave port configuration to port_type and also

		corresponding master port type it need to attach.

		format: <port_id,slave_port_type, ch_mask, ch_rate, master_port_type>

		same port_id configurations have to be grouped, and in ascending order.

 - qcom,wcd-rst-gpio-node: Phandle reference to the DT node having codec reset gpio

                        configuration. If this property is not defined, it is

                        expected to atleast define "qcom,cdc-reset-gpio" property.

 - qcom,rx-slave: phandle reference of Soundwire Rx slave device.

 - qcom,tx-slave: phandle reference of Soundwire Tx slave device.

Optional properties:

 - cdc-vdd-rxtx-supply: phandle of rxtx supply's regulator device tree node.

 - qcom,cdc-vdd-rxtx-voltage: rxtx supply's voltage level min and max in mV.

 - qcom,cdc-vdd-rxtx-current: rxtx supply's max current in mA.

 - cdc-vddio-supply: phandle of io supply's regulator device tree node.

 - qcom,cdc-vddio-voltage: io supply's voltage level min and max in mV.

 - qcom,cdc-vddio-current: io supply's max current in mA.

 - 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-mic-bias-supply: phandle of mic bias supply's regulator device tree node.

 - qcom,cdc-vdd-mic-bias-voltage: mic bias supply's voltage level min and max in mV.

 - qcom,cdc-vdd-mic-bias-current: mic bias 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-on-demand-supplies: List of supplies which can be enabled

				dynamically.

				Supplies in this list are off by default.

Example:

wcd938x_codec: wcd938x-codec {

	compatible = "qcom,wcd938x-codec";

	qcom,rx_swr_ch_map = <0 HPH_L 0x1 0 HPH_L>,

		<0 HPH_R 0x2 0 HPH_R>, <1 CLSH 0x3 0 CLSH>,

		<2 COMP_L 0x1 0 COMP_L>, <2 COMP_R 0x2 0 COMP_R>,

		<3 LO 0x1 0 LO>, <4 DSD_L 0x1 0 DSD_L>,

		<4 DSD_R 0x2 0 DSD_R>;

	qcom,tx_swr_ch_map = <0 ADC1 0x1 0 ADC1>,

		<1 ADC2 0x1 0 ADC3>, <1 ADC3 0x2 0 ADC4>,

		<2 DMIC0 0x1 0 DMIC0>, <2 DMIC1 0x2 0 DMIC1>,

		<2 MBHC 0x4 0 DMIC2>, <3 DMIC2 0x1 0 DMIC4>,

		<3 DMIC3 0x2 0 DMIC5>, <3 DMIC4 0x4 0 DMIC6>,

		<3 DMIC5 0x8 0 DMIC7>;

	qcom,wcd-rst-gpio-node = <&wcd938x_rst_gpio>;

	qcom,rx-slave = <&wcd938x_rx_slave>;

	qcom,tx-slave = <&wcd938x_tx_slave>;

	cdc-vdd-buck-supply = <&S4A>;

	qcom,cdc-vdd-buck-voltage = <1800000 1800000>;

	qcom,cdc-vdd-buck-current = <650000>;

	cdc-vdd-rxtx-supply = <&S4A>;

	qcom,cdc-vdd-rxtx-voltage = <1800000 1800000>;

	qcom,cdc-vdd-rxtx-current = <30000>;

	cdc-vddio-supply = <&S4A>;

	qcom,cdc-vddio-voltage = <1800000 1800000>;

	qcom,cdc-vddio-current = <30000>;

	cdc-vdd-mic-bias-supply = <&BOB>;

	qcom,cdc-vdd-mic-bias-voltage = <3296000 3296000>;

	qcom,cdc-vdd-mic-bias-current = <30000>;

	qcom,cdc-static-supplies = "cdc-vdd-rxtx",

				   "cdc-vddio";

	qcom,cdc-on-demand-supplies = "cdc-vdd-buck",

				      "cdc-vdd-mic-bias";

};