Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit 0a767362 authored by Ramprasad Katkam's avatar Ramprasad Katkam
Browse files

Documentation: sound: Add documentation for swr port mapping in wcd937x 



Add Documentation for soundwire Port mapping of swr slaves on wcd937x
codec nodes.

Change-Id: I8e26aa54127b5d77f26b40e5e38bd5437883b522
Signed-off-by: default avatarRamprasad Katkam <katkam@codeaurora.org>
parent e3128932

Documentation/devicetree/bindings/sound/wcd_codec.txt

+19 −0
Original line number Diff line number Diff line
@@ -550,6 +550,14 @@ Tanggu Codec 


Required properties:

 - compatible: "qcom,wcd937x-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.
@@ -585,6 +593,17 @@ Optional properties: 
Example:

wcd937x_codec: wcd937x-codec {

	compatible = "qcom,wcd937x-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 = <&wcd937x_rst_gpio>;

	qcom,rx-slave = <&wcd937x_rx_slave>;

Documentation/devicetree/bindings/soundwire/swr-mstr-ctrl.txt

+4 −0
Original line number Diff line number Diff line
@@ -22,6 +22,9 @@ Required properties: 
	which the swr-devid is <0x0 0x032000> where 0x03 represents

	device Unique_ID, 0x20 represents Part_Id1 and 0x00

	represents part_Id2.

Optional properties:

- mipi-sdw-clock-stop-mode0-supported : should be set to 1 if all

	the slaves under the master supports clock stop mode 0



 Example:
@@ -46,4 +49,5 @@ swr0: swr_master { 
			compatible = "qcom,wsa881x";

			reg = <0x00 0x042000>;

		};

		mipi-sdw-clock-stop-mode0-supported = <0>;

	};