Received-SPF: pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) client-ip=209.132.180.67;
From:   Viorel Suman <viorel.suman@nxp.com>
To:     Liam Girdwood <lgirdwood@gmail.com>,
        Mark Brown <broonie@kernel.org>,
        Rob Herring <robh+dt@kernel.org>,
        Mark Rutland <mark.rutland@arm.com>,
        Jaroslav Kysela <perex@perex.cz>,
        Takashi Iwai <tiwai@suse.com>, Timur Tabi <timur@kernel.org>,
        Nicolin Chen <nicoleotsuka@gmail.com>,
        Xiubo Li <Xiubo.Lee@gmail.com>,
        Fabio Estevam <fabio.estevam@nxp.com>,
        Viorel Suman <viorel.suman@nxp.com>,
        "S.j. Wang" <shengjiu.wang@nxp.com>,
        Daniel Baluta <daniel.baluta@nxp.com>,
        Cosmin Samoila <cosmin.samoila@nxp.com>
CC:     "alsa-devel@alsa-project.org" <alsa-devel@alsa-project.org>,
        "devicetree@vger.kernel.org" <devicetree@vger.kernel.org>,
        "linux-kernel@vger.kernel.org" <linux-kernel@vger.kernel.org>,
        "linuxppc-dev@lists.ozlabs.org" <linuxppc-dev@lists.ozlabs.org>,
        dl-linux-imx <linux-imx@nxp.com>,
        Viorel Suman <viorel.suman@gmail.com>
Subject: [PATCH v5 2/3] ASoC: add fsl_audmix DT binding documentation
Thread-Topic: [PATCH v5 2/3] ASoC: add fsl_audmix DT binding documentation
Thread-Index: AQHUxTb29jU2YVCmtUqPKCgK+dTP8w==
Date:   Fri, 15 Feb 2019 14:01:36 +0000
Message-ID: <1550239285-12587-3-git-send-email-viorel.suman@nxp.com>
References: <1550239285-12587-1-git-send-email-viorel.suman@nxp.com>
In-Reply-To: <1550239285-12587-1-git-send-email-viorel.suman@nxp.com>
Accept-Language: en-US
Content-Language: en-US
x-ms-exchange-messagesentrepresentingtype: 1
x-mailer: git-send-email 2.7.4
x-originating-ip: [95.76.156.53]
x-ms-publictraffictype: Email
x-ms-office365-filtering-correlation-id: 0c8806c3-83e8-46e3-26d5-08d6934e1939
x-ms-office365-filtering-ht: Tenant
x-microsoft-antispam: BCL:0;PCL:0;RULEID:(2390118)(7020095)(4652040)(8989299)(4534185)(4627221)(201703031133081)(201702281549075)(8990200)(5600110)(711020)(4605077)(4618075)(2017052603328)(7153060)(7193020);SRVR:VI1PR04MB1614;
x-ms-traffictypediagnostic: VI1PR04MB1614:
x-microsoft-exchange-diagnostics: =?iso-8859-1?Q?1;VI1PR04MB1614;23:o6UKgjPAXGFPeoYvbgD4rwaaIirZzznm0N/ZbrX?=
 =?iso-8859-1?Q?10rrgjEz5F4iinaALn4jYPefRGVbk/c/4FVvE6PetsRlaUAvu9Mod9cN2x?=
 =?iso-8859-1?Q?hKyPNgfqb39SthYPrPSclAg1FPhizLlrNYSo+ZDQmLZ3myNK2lYyW/3HD0?=
 =?iso-8859-1?Q?WNHXyEUA21/S2jZWSagiNttx4f12vTN9sYmOaDGrM392utzRHA/a0UaKJZ?=
 =?iso-8859-1?Q?IhEyWPOI9IvydolnfsyvX/NeoX/Ptp2prxOvmzZnUmpVBuHPm/lUdTs/kw?=
 =?iso-8859-1?Q?OvoDZ7wjlbuLRV+jn4kfug7pOlq1Jmz7NP9k7djVufzmNVZURd8sXF81Ei?=
 =?iso-8859-1?Q?FvSljeaFlcuOoRnkaqXwNaCuaVggNRnPFCF6LeUyRpHqvNSYYro46lKBaK?=
 =?iso-8859-1?Q?hqYT3LF55M+CqvXraAz7H+L7jDy/vAUCk5+irm5lUzHIXYZfwDAPocErIM?=
 =?iso-8859-1?Q?vsNzjAaxQTGWVXUQuEhyN3boBpqkrmjoOibtvoVaQHV74NeHG06bhyZwcQ?=
 =?iso-8859-1?Q?5a0c63ovDiVdmSy7hfQE0KMh7ik0Az7X0guyuL3mVG45VKz185VOKUQ0nV?=
 =?iso-8859-1?Q?uW14d/9hWVLEIpouh0L5uuL8l0w2E8l2pafIT/dOLCkkQPGO4s0HyODv9X?=
 =?iso-8859-1?Q?3vIKjrshiid9sewyqx9mEFmWebj9kWO17+lyV4De2U+vHvUG9r9nqD1KvC?=
 =?iso-8859-1?Q?AT7hlDXMg5/NZnkrxaFGavKRIuQFIcrOB9uC5dMPU/ADVIyhUWx46J7Pq2?=
 =?iso-8859-1?Q?CjGXS2MZzRQUEbXdTDqneL3Z7mKp6rBN7Rp169CYGMk9h9TsN6CDguFSP8?=
 =?iso-8859-1?Q?iUl9Ofcl6aIP9vp495d7PqoKEfN+SpbfOxhPCntK8Rg0Z5KV9YRsvxDm1V?=
 =?iso-8859-1?Q?pFbq9Oz0sOG+ads2lxLJaOQEHYTpTrj8njmiHDqFeou+VLWrUrEsoDfPmY?=
 =?iso-8859-1?Q?PnqdiuYDYqJ0at/P5ctGvvfTSb21u3YiCjiYh39G0aX9N2GVy2yj6GT+zG?=
 =?iso-8859-1?Q?yJUmwmQzJedRpYrbkTQEg2a+Xad00fG872/RoUUNh4wD1nlay0XfG+Owcw?=
 =?iso-8859-1?Q?n5Mk5AhSDCnVprFepUPXNLSCXqSwlYVUs3kCZEI2tLT5kw2Dgq6FfG1ypm?=
 =?iso-8859-1?Q?I9/0wuNTLo6FksIQNOjiAi+vo7nlAAI8TddZU94ugNeIrxO02T5FzxAsRI?=
 =?iso-8859-1?Q?dm+i5cl77y7/fjlhv9CHoCIjXUSwUanXwdOKTcifmmKW9cS5b5K260nIN4?=
 =?iso-8859-1?Q?Nh51ThAn443MFZzclgNTQ5XQS88xKlimMZYPtfYipKTw6zxfa6miEyMffD?=
 =?iso-8859-1?Q?+qo6DwJiQ9SBycWHXzgvz34?=
x-microsoft-antispam-prvs: <VI1PR04MB1614F541CB89D96F9E720C7492600@VI1PR04MB1614.eurprd04.prod.outlook.com>
x-forefront-prvs: 09497C15EB
x-forefront-antispam-report: SFV:NSPM;SFS:(10009020)(376002)(366004)(136003)(39860400002)(346002)(396003)(199004)(189003)(50226002)(486006)(14444005)(54906003)(76176011)(52116002)(99286004)(256004)(86362001)(11346002)(97736004)(446003)(478600001)(71200400001)(6486002)(71190400001)(2906002)(6636002)(25786009)(66066001)(110136005)(36756003)(6436002)(6116002)(26005)(4326008)(305945005)(8676002)(7736002)(8936002)(81166006)(81156014)(44832011)(476003)(386003)(6512007)(2616005)(106356001)(6506007)(105586002)(14454004)(186003)(3846002)(53936002)(7416002)(316002)(102836004)(68736007)(921003)(1121003);DIR:OUT;SFP:1101;SCL:1;SRVR:VI1PR04MB1614;H:VI1PR04MB4704.eurprd04.prod.outlook.com;FPR:;SPF:None;LANG:en;PTR:InfoNoRecords;A:1;MX:1;
received-spf: None (protection.outlook.com: nxp.com does not designate
 permitted sender hosts)
x-ms-exchange-senderadcheck: 1
x-microsoft-antispam-message-info: CogIXBkXhTevRcQZLeYGoO77UrMl3oynSO1gDlZWwJpFmDpR2LARwT32PQEu8vrd+wm6bw+tE3R7OWRS/YjC60YpjF/F/qW7J1/v7OSnEvY+TlpJad0qm3McPHSotvA2niWQXRvLmwgnL+uYMX8FJLreT/UNdkyy3IkkhXgjn/p2oX4/5rNZUOuLNsVF7MC18B6FvuvutCO14WGhX6duipYpeptzTkB0Cqe6TEHCFJT1/lzFIwCZ8fWvDga+pVxuuJ58unPZNqIIkYOyni3pk1Gwl6HTbrJFLsSpipyHlLABMszA7zfz9C2eUG5nJm4NPcPXyoPBVFwN5p3SRB56kbmS1Vq6vDEetDg6tAwi+8m099fmtZqgrOm6y3BgjXi3E02V1AcawNaxiwor7VgsqXhwthXFvKzTjfjmT1ezV10=
Content-Type: text/plain; charset="iso-8859-1"
Content-Transfer-Encoding: quoted-printable
MIME-Version: 1.0
X-OriginatorOrg: nxp.com
X-MS-Exchange-CrossTenant-Network-Message-Id: 0c8806c3-83e8-46e3-26d5-08d6934e1939
X-MS-Exchange-CrossTenant-originalarrivaltime: 15 Feb 2019 14:01:34.6102
 (UTC)
X-MS-Exchange-CrossTenant-fromentityheader: Hosted
X-MS-Exchange-CrossTenant-mailboxtype: HOSTED
X-MS-Exchange-CrossTenant-id: 686ea1d3-bc2b-4c6f-a92c-d99c5c301635
X-MS-Exchange-Transport-CrossTenantHeadersStamped: VI1PR04MB1614
Sender: linux-kernel-owner@vger.kernel.org
Precedence: bulk
List-ID: <linux-kernel.vger.kernel.org>
X-Mailing-List: linux-kernel@vger.kernel.org

Add the DT binding documentation for NXP Audio Mixer
CPU DAI driver.

Signed-off-by: Viorel Suman <viorel.suman@nxp.com>
---
 .../devicetree/bindings/sound/fsl,audmix.txt       | 50 ++++++++++++++++++=
++++
 1 file changed, 50 insertions(+)
 create mode 100644 Documentation/devicetree/bindings/sound/fsl,audmix.txt

diff --git a/Documentation/devicetree/bindings/sound/fsl,audmix.txt b/Docum=
entation/devicetree/bindings/sound/fsl,audmix.txt
new file mode 100644
index 0000000..840b7e0
--- /dev/null
+++ b/Documentation/devicetree/bindings/sound/fsl,audmix.txt
@@ -0,0 +1,50 @@
+NXP Audio Mixer (AUDMIX).
+
+The Audio Mixer is a on-chip functional module that allows mixing of two
+audio streams into a single audio stream. Audio Mixer has two input serial
+audio interfaces. These are driven by two Synchronous Audio interface
+modules (SAI). Each input serial interface carries 8 audio channels in its
+frame in TDM manner. Mixer mixes audio samples of corresponding channels
+from two interfaces into a single sample. Before mixing, audio samples of
+two inputs can be attenuated based on configuration. The output of the
+Audio Mixer is also a serial audio interface. Like input interfaces it has
+the same TDM frame format. This output is used to drive the serial DAC TDM
+interface of audio codec and also sent to the external pins along with the
+receive path of normal audio SAI module for readback by the CPU.
+
+The output of Audio Mixer can be selected from any of the three streams
+ - serial audio input 1
+ - serial audio input 2
+ - mixed audio
+
+Mixing operation is independent of audio sample rate but the two audio
+input streams must have same audio sample rate with same number of channel=
s
+in TDM frame to be eligible for mixing.
+
+Device driver required properties:
+=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D
+  - compatible		: Compatible list, contains "fsl,imx8qm-audmix"
+
+  - reg			: Offset and length of the register set for the device.
+
+  - clocks		: Must contain an entry for each entry in clock-names.
+
+  - clock-names		: Must include the "ipg" for register access.
+
+  - power-domains	: Must contain the phandle to AUDMIX power domain node
+
+  - dais		: Must contain a list of phandles to AUDMIX connected
+			  DAIs. The current implementation requires two phandles
+			  to SAI interfaces to be provided, the first SAI in the
+			  list being used to route the AUDMIX output.
+
+Device driver configuration example:
+=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
+  audmix: audmix@59840000 {
+    compatible =3D "fsl,imx8qm-audmix";
+    reg =3D <0x0 0x59840000 0x0 0x10000>;
+    clocks =3D <&clk IMX8QXP_AUD_AUDMIX_IPG>;
+    clock-names =3D "ipg";
+    power-domains =3D <&pd_audmix>;
+    dais =3D <&sai4>, <&sai5>;
+  };
--=20
2.7.4