From patchwork Mon Mar 4 10:36:26 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Viorel Suman X-Patchwork-Id: 10837579 Return-Path: Received: from mail.wl.linuxfoundation.org (pdx-wl-mail.web.codeaurora.org [172.30.200.125]) by pdx-korg-patchwork-2.web.codeaurora.org (Postfix) with ESMTP id 8B0251515 for ; Mon, 4 Mar 2019 10:38:25 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 73C9D29D35 for ; Mon, 4 Mar 2019 10:38:25 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id 67F6029D5E; Mon, 4 Mar 2019 10:38:25 +0000 (UTC) X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on pdx-wl-mail.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-2.9 required=2.0 tests=BAD_ENC_HEADER,BAYES_00, DKIM_SIGNED,DKIM_VALID,MAILING_LIST_MULTI,RCVD_IN_DNSWL_NONE autolearn=ham version=3.3.1 Received: from alsa0.perex.cz (alsa0.perex.cz [77.48.224.243]) (using TLSv1.2 with cipher DHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.wl.linuxfoundation.org (Postfix) with ESMTPS id 98D9C29D35 for ; Mon, 4 Mar 2019 10:38:24 +0000 (UTC) Received: from alsa1.perex.cz (alsa1.perex.cz [207.180.221.201]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by alsa0.perex.cz (Postfix) with ESMTPS id BA60986D; Mon, 4 Mar 2019 11:37:32 +0100 (CET) DKIM-Filter: OpenDKIM Filter v2.11.0 alsa0.perex.cz BA60986D DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=alsa-project.org; s=default; t=1551695902; bh=89kvR2tP3ExN2gQTaFIU51e/bICnz4RP2xSCf1RsHjY=; h=From:To:Date:References:In-Reply-To:Cc:Subject:List-Id: List-Unsubscribe:List-Archive:List-Post:List-Help:List-Subscribe: From; b=P5oTM5KbpzoZnK8yxdbT8aqavP6diAo3225guJzngDyXgI+p+6c8bCw3bd3XQOlG4 nw2L2kWzHD2Yj8DwoJClRgo25Q47k1m/jeoREY+ysTgsVAJ5q7GldgSIf6N3EYW0YH ScWJExdeCkV+0bLEV00YLpp8fksv9mqvZjVlzofQ= Received: from alsa1.perex.cz (localhost.localdomain [127.0.0.1]) by alsa1.perex.cz (Postfix) with ESMTP id 8A86BF896F5; Mon, 4 Mar 2019 11:36:36 +0100 (CET) X-Original-To: alsa-devel@alsa-project.org Delivered-To: alsa-devel@alsa-project.org Received: by alsa1.perex.cz (Postfix, from userid 50401) id 9CD69F896F1; Mon, 4 Mar 2019 11:36:33 +0100 (CET) Received: from EUR02-VE1-obe.outbound.protection.outlook.com (mail-eopbgr20067.outbound.protection.outlook.com [40.107.2.67]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by alsa1.perex.cz (Postfix) with ESMTPS id ECCE1F896ED for ; Mon, 4 Mar 2019 11:36:29 +0100 (CET) DKIM-Filter: OpenDKIM Filter v2.11.0 alsa1.perex.cz ECCE1F896ED Authentication-Results: alsa1.perex.cz; dkim=pass (1024-bit key) header.d=nxp.com header.i=@nxp.com header.b="oI9kY5v0" DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=nxp.com; s=selector1; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=8fIcGmB7iUpAgAjixrTAxrSEyrlm7/CvszU1+WsO6UY=; b=oI9kY5v000itPQuQ4/5PAk4qqK3wEzNnMDQUvlrtHiFtoxFm9z5+i49ZmbjTEp8gylQDp+uSK3xR8GxbqMjFanxNPqjOhTCWqumxuI151Uu4XH1Xk+2cCqmjT8SLyTgBp9itnFZ/TQ2A7LE6mvywBhoIHeQpsakP9tLHmwdCFqw= Received: from VI1PR04MB4704.eurprd04.prod.outlook.com (20.177.48.157) by VI1PR04MB6270.eurprd04.prod.outlook.com (20.179.26.206) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.1665.19; Mon, 4 Mar 2019 10:36:26 +0000 Received: from VI1PR04MB4704.eurprd04.prod.outlook.com ([fe80::78ad:1f42:aeff:b22e]) by VI1PR04MB4704.eurprd04.prod.outlook.com ([fe80::78ad:1f42:aeff:b22e%4]) with mapi id 15.20.1665.020; Mon, 4 Mar 2019 10:36:26 +0000 From: Viorel Suman To: Liam Girdwood , Mark Brown , Rob Herring , Mark Rutland , Jaroslav Kysela , Takashi Iwai , Timur Tabi , Nicolin Chen , Xiubo Li , Fabio Estevam , Viorel Suman , "S.j. Wang" , Daniel Baluta , Cosmin Samoila Thread-Topic: [PATCH RESEND v5 2/3] ASoC: add fsl_audmix DT binding documentation Thread-Index: AQHU0nYe/M1b8nS0JkW6XgiHhY/M8g== Date: Mon, 4 Mar 2019 10:36:26 +0000 Message-ID: <1551695748-21541-3-git-send-email-viorel.suman@nxp.com> References: <1551695748-21541-1-git-send-email-viorel.suman@nxp.com> In-Reply-To: <1551695748-21541-1-git-send-email-viorel.suman@nxp.com> Accept-Language: en-US Content-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: x-clientproxiedby: AM6PR01CA0067.eurprd01.prod.exchangelabs.com (2603:10a6:20b:e0::44) To VI1PR04MB4704.eurprd04.prod.outlook.com (2603:10a6:803:52::29) authentication-results: spf=none (sender IP is ) smtp.mailfrom=viorel.suman@nxp.com; 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: eb5aa383-31c5-4f0c-f4ed-08d6a08d414d x-ms-office365-filtering-ht: Tenant x-microsoft-antispam: BCL:0; PCL:0; RULEID:(2390118)(7020095)(4652040)(8989299)(4534185)(4627221)(201703031133081)(201702281549075)(8990200)(5600127)(711020)(4605104)(4618075)(2017052603328)(7153060)(7193020); SRVR:VI1PR04MB6270; x-ms-traffictypediagnostic: VI1PR04MB6270: x-microsoft-exchange-diagnostics: =?iso-8859-1?Q?1; VI1PR04MB6270; 23:f/vB+pXztquYs0HEOA1QIK36pQ5yGmR/+kBtJXr?= =?iso-8859-1?q?gsYhbCXhNIA8ZAV?= =?iso-8859-1?q?XeCUZppA477piBSqId8GImwvf8XPGfw+tBjvjybRWJOcItS7+XufpPqeCaCl?= =?iso-8859-1?q?22cmNpZXJrbP+gPi6oDhTBqiZZ5BlKoxuJzP5OAuzmHB+1eZCrPbzdGt53Mp?= =?iso-8859-1?q?Lve9wkPjgrzBMMP/pdK1Dz+rPbdcWC7HH7rl4TF4XQZ/mkgpxiX2kNIk0/L8?= =?iso-8859-1?q?uHgtKzcZhQ/O7Vz72zP61i+AMQwuqrn/D/GC2n9YkuJ4IRa5i8RmlZJjcZzY?= =?iso-8859-1?q?EHiAoVxxmSR5+d4hJvGDzkOFNO8woD5ccRPnam2RaPJlXzAuKe+QHhBtcHeZ?= =?iso-8859-1?q?Nb+y8cHKv3iQqYEJ95uHNEflWXbX5R9GX8NOOnjlmJE6y3Fa7nIwszWDRG8y?= =?iso-8859-1?q?R+y0n9i72MgmF11+cbLE0KhNfyXoPhDpXrVm5fUghSZPh+YHCAE967cXSl/+?= =?iso-8859-1?q?7fHgkVH+xBLUlGhGAd9mgVMUg+N+I4QLWblx2gtKCuFoZRjKnBTglXwZTUtv?= =?iso-8859-1?q?1Ay2p8gQEcVa8PkJ/DfM3Rz/5VMSsKf4/MragyqkU0hldxa8gzmSpJCmjA4U?= =?iso-8859-1?q?0YyVIzw2MhLbNlpciC3EjsBJh35gVDWuVzXopkY8qnSREq6kTMcCgtSgAROJ?= =?iso-8859-1?q?4hfjJOWy38k8/FWe5Zj+ZwEDhrOc5G1NMAMKIuhoPvOMDo2WINAOffhkDNwz?= =?iso-8859-1?q?UTUrOk31qSnPUlwHKI3bZonvU4srU5HZM9hwHlytfEHCwxc9cCvUlY7xEx9/?= =?iso-8859-1?q?3ijZjW2RrDIcQxQCzW3QQTEwNJ36eMaxiOyc9jA9lRfKAdST/xYd7+LINjHP?= =?iso-8859-1?q?6Lti96PdVXfz903vMeJMOcZvLLjQrySYdCdNS/MrZb7g7MAW0+r+r19RTcpX?= =?iso-8859-1?q?zsp/dHsSSTqhom4XRX38y+aRoaFubEYmolZPpFH4RyXBEtIycNdMccTDxEk+?= =?iso-8859-1?q?tjOU3YZRNRnvsuSYQra/ywgdlj/Kj016ZvU0ng5PMbySpaePbMIULO/lxuy4?= =?iso-8859-1?q?UpH2XCir1A3spgUzknf+WJsx/O3Jwm/cjrtkfNkncM4L0dajnYQiC+Gay/Oh?= =?iso-8859-1?q?8VOgR3D05nmoeqSCYpbAHBzq4Rsg8hsR/oEoLqTgTP/o1r5QVgCca4ncPShX?= =?iso-8859-1?q?K7i3RgQGs2/XdWoaMVAdy2wPFEpaviY0pT8H9Kpl1Lv8YFB7mDkmZE2uSUgP?= =?iso-8859-1?q?7aooWnJWBNtuxyx2jCYOApMevUg9wORPRT3T62LToADFUS2LL0xh3M3gPShx?= =?iso-8859-1?q?dELFzXxDYotTapxWufC9TRUANOMGlEWh/8pwMNhhKkGFHHdA=3D=3D?= x-microsoft-antispam-prvs: x-forefront-prvs: 09669DB681 x-forefront-antispam-report: SFV:NSPM; SFS:(10009020)(39860400002)(376002)(366004)(346002)(136003)(396003)(189003)(199004)(186003)(26005)(81156014)(81166006)(76176011)(8676002)(52116002)(102836004)(66066001)(2906002)(105586002)(386003)(6506007)(106356001)(478600001)(86362001)(305945005)(7736002)(99286004)(256004)(446003)(11346002)(2616005)(486006)(44832011)(476003)(316002)(97736004)(14444005)(6116002)(3846002)(36756003)(4326008)(8936002)(50226002)(68736007)(54906003)(110136005)(14454004)(71200400001)(6436002)(6486002)(53936002)(25786009)(6512007)(71190400001)(5660300002)(7416002)(6636002)(921003)(1121003); DIR:OUT; SFP:1101; SCL:1; SRVR:VI1PR04MB6270; H:VI1PR04MB4704.eurprd04.prod.outlook.com; FPR:; SPF:None; LANG:en; PTR:InfoNoRecords; MX:1; A: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: f9JqOntT+gop0f8A/vSSz3vbV8tI47IZEIcs76DgJgT3CgKMc6Xdzza+9pGtvXProK2IP0uWdlF2I43gFuWAAHLRw2PIGRTbQ5vt04WSxCWCEDc2LUpRPR4fe4H861b+Cu4t0QyYWvMPk13drofzWl7dGZGSUp9xK8kTr3+JxQLt/R6dG71YqrFpLErojJuDAu3Sw7n7E0umrB0E9dH+vp7GjavNxIcYnH1p8jDPN31c+OsoHgWik+jLi9EseLNcv4HmHbDUrqyHceBuL2M4SMnJAYATeHxPPNdy42aCM+e6NKdErj5FWvtyUPTsYQ+aa8AGNUHFXDUx9yh6ed24x0Z7jsy4xyHqWZWcL2fLgfCHGUbltMUA+AsHLjVW6OM/T2wITse62+3YDZaEVLlRxr3haO3pJkUl6fXfDB3ueEU= MIME-Version: 1.0 X-OriginatorOrg: nxp.com X-MS-Exchange-CrossTenant-Network-Message-Id: eb5aa383-31c5-4f0c-f4ed-08d6a08d414d X-MS-Exchange-CrossTenant-originalarrivaltime: 04 Mar 2019 10:36:26.8726 (UTC) X-MS-Exchange-CrossTenant-fromentityheader: Hosted X-MS-Exchange-CrossTenant-id: 686ea1d3-bc2b-4c6f-a92c-d99c5c301635 X-MS-Exchange-CrossTenant-mailboxtype: HOSTED X-MS-Exchange-Transport-CrossTenantHeadersStamped: VI1PR04MB6270 Cc: "devicetree@vger.kernel.org" , "alsa-devel@alsa-project.org" , "linux-kernel@vger.kernel.org" , Viorel Suman , dl-linux-imx , "linuxppc-dev@lists.ozlabs.org" Subject: [alsa-devel] [PATCH RESEND v5 2/3] ASoC: add fsl_audmix DT binding documentation X-BeenThere: alsa-devel@alsa-project.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: "Alsa-devel mailing list for ALSA developers - http://www.alsa-project.org" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: alsa-devel-bounces@alsa-project.org Sender: "Alsa-devel" X-Virus-Scanned: ClamAV using ClamSMTP Add the DT binding documentation for NXP Audio Mixer CPU DAI driver. Signed-off-by: Viorel Suman Acked-by: Nicolin Chen Acked-by: Rob Herring --- .../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/Documentation/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 channels +in TDM frame to be eligible for mixing. + +Device driver required properties: +================================= + - 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: +====================================== + audmix: audmix@59840000 { + compatible = "fsl,imx8qm-audmix"; + reg = <0x0 0x59840000 0x0 0x10000>; + clocks = <&clk IMX8QXP_AUD_AUDMIX_IPG>; + clock-names = "ipg"; + power-domains = <&pd_audmix>; + dais = <&sai4>, <&sai5>; + };