From patchwork Mon Mar 13 05:54:22 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Kuninori Morimoto X-Patchwork-Id: 9619799 Return-Path: Received: from mail.wl.linuxfoundation.org (pdx-wl-mail.web.codeaurora.org [172.30.200.125]) by pdx-korg-patchwork.web.codeaurora.org (Postfix) with ESMTP id 0644960244 for ; Mon, 13 Mar 2017 05:55:29 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id E823528423 for ; Mon, 13 Mar 2017 05:55:28 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id DBDF028451; Mon, 13 Mar 2017 05:55:28 +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=-1.8 required=2.0 tests=BAD_ENC_HEADER,BAYES_00, DKIM_SIGNED, RCVD_IN_DNSWL_NONE, T_DKIM_INVALID autolearn=no version=3.3.1 Received: from alsa0.perex.cz (alsa0.perex.cz [77.48.224.243]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 2AC8428423 for ; Mon, 13 Mar 2017 05:55:27 +0000 (UTC) Received: from alsa0.perex.cz (localhost [127.0.0.1]) by alsa0.perex.cz (Postfix) with ESMTP id ACC37266C72; Mon, 13 Mar 2017 06:55:25 +0100 (CET) X-Original-To: alsa-devel@alsa-project.org Delivered-To: alsa-devel@alsa-project.org Received: by alsa0.perex.cz (Postfix, from userid 1000) id BADB8266D1A; Mon, 13 Mar 2017 06:55:24 +0100 (CET) Received: from relmlie3.idc.renesas.com (relmlor4.renesas.com [210.160.252.174]) by alsa0.perex.cz (Postfix) with ESMTP id EC3FC266CBB for ; Mon, 13 Mar 2017 06:54:25 +0100 (CET) Received: from unknown (HELO relmlir2.idc.renesas.com) ([10.200.68.152]) by relmlie3.idc.renesas.com with ESMTP; 13 Mar 2017 14:54:24 +0900 Received: from relmlac1.idc.renesas.com (relmlac1.idc.renesas.com [10.200.69.21]) by relmlir2.idc.renesas.com (Postfix) with ESMTP id 7419064302; Mon, 13 Mar 2017 14:54:24 +0900 (JST) Received: by relmlac1.idc.renesas.com (Postfix, from userid 0) id 57B4780030; Mon, 13 Mar 2017 14:54:24 +0900 (JST) Received: from relmlac1.idc.renesas.com (localhost [127.0.0.1]) by relmlac1.idc.renesas.com (Postfix) with ESMTP id 516988002F; Mon, 13 Mar 2017 14:54:24 +0900 (JST) Received: from relmlii1.idc.renesas.com [10.200.68.65] by relmlac1.idc.renesas.com with ESMTP id QAP16874; Mon, 13 Mar 2017 14:54:24 +0900 X-IronPort-AV: E=Sophos;i="5.36,157,1486393200"; d="scan'208";a="236491967" Received: from mail-pu1apc01lp0018.outbound.protection.outlook.com (HELO APC01-PU1-obe.outbound.protection.outlook.com) ([65.55.88.18]) by relmlii1.idc.renesas.com with ESMTP/TLS/AES256-SHA256; 13 Mar 2017 14:54:23 +0900 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=renesasgroup.onmicrosoft.com; s=selector1-renesas-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version; bh=RPnsVLATRAegUi+n4UJ9oct99TtILPz8d9v4VE8XGhQ=; b=GHHZ/DRupYH+MMih+2edk1Xc5knkfzuJz2/AGskzXBn2I9Bkso2VLDH6JtwLqOTIPPs/kSei0s95MBeHrx7GU9WULCK5WfUhKhlPTtQIWLH4e74YcJBumCQjaviof5WYa+X+1FQng2JIfoLpN+Lcal4tLmWv2xPzLtsWQY1PBJs= Authentication-Results: kernel.org; dkim=none (message not signed) header.d=none; kernel.org; dmarc=none action=none header.from=renesas.com; Received: from morimoto-PC.renesas.com (211.11.155.144) by SG2PR0601MB1934.apcprd06.prod.outlook.com (10.170.133.148) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384_P384) id 15.1.947.12; Mon, 13 Mar 2017 05:54:22 +0000 Message-ID: <87tw6xhghs.wl%kuninori.morimoto.gx@renesas.com> From: Kuninori Morimoto User-Agent: Wanderlust/2.15.9 Emacs/24.3 Mule/6.0 MIME-Version: 1.0 (generated by SEMI-EPG 1.14.7 - "Harue") To: Mark Brown , Rob Herring In-Reply-To: <8760jdivfm.wl%kuninori.morimoto.gx@renesas.com> References: <8760jdivfm.wl%kuninori.morimoto.gx@renesas.com> Date: Mon, 13 Mar 2017 05:54:22 +0000 X-Originating-IP: [211.11.155.144] X-ClientProxiedBy: OSXPR01CA0081.jpnprd01.prod.outlook.com (10.167.144.49) To SG2PR0601MB1934.apcprd06.prod.outlook.com (10.170.133.148) X-MS-Office365-Filtering-Correlation-Id: eaa112aa-a266-453c-c532-08d469d56608 X-MS-Office365-Filtering-HT: Tenant X-Microsoft-Antispam: UriScan:; BCL:0; PCL:0; RULEID:(22001)(48565401081); SRVR:SG2PR0601MB1934; X-Microsoft-Exchange-Diagnostics: 1; SG2PR0601MB1934; 3:+4OtlnXDG7tix2RyZU9kfGow0wiDol1qulTG0LQDycO0Oz871AEn0l/Dv2RY2vgrfk4i6lojraRPMy3kZ7vMOaTyfxz35+cG/jiM0aFd8uSOl1nBsO/6BJOfmpgyIJh1DO75Eyxu1xpstp9UkBed9nbfEzHCtHUGIC+1YnFQ4fi8aNdJadpcw0qVEHhwYSgyfDafT1ylTK9reqBXq+3YH3f8BWVbl2yCx18uWBkgsz43EZEwFOJ3JYyLtyNOMyEPdzw9ek3d2UWnhBpPriBPeR6Qlq3imew14kgS/BUnGAM=; 25:omrEu8zAM0msX8/WWrznQO1ynraPp0nXmwN/3j9jJ+J22LhV7z+lK/jRXgH+sWp8i1OXixZ+9WadpI1THuKCK+gvnvTn+U/AdxCZpiGNKLfTD6Tt2TUzy1dCKfq7Jj1823kZLOjAhqqLo+MWpP79QJQyigFbk2of5svyrgISLcNtKv9QzLVOqIGGRbNnSPfcIS/UhgT2ZKSsWi2rDeqvzA5AjiKI1KocbMK5AyRw7vzfRbST5SAeL7mxEUoUgHCfoRAwocUAjc1xiWUyaQfJpWdehR6AH3w589z0kNHAcMMC5is/54eTZQgEHbomgBhbp3vZ4pGUgy/p0YrYlSLNDBwQhtFHSIMKw53GG11oFnJLWpvAEcvJcK2WuQKrA3HzHkQ5zloHdXTlU1dT+569QAXn66wOnlgW3O+67CZTSrEyi3xVhZl5BZJtdBzY+xCH73r3qglSYSB4D9kxBOiDAw== X-Microsoft-Exchange-Diagnostics: 1; SG2PR0601MB1934; 31:TZiRKDPJ350Tonod5CvRi7D/MSmtj2+boM3K8k909J+xAxs86g1G4KqGy/YGuAJPndAB/IcNWbDe2hSLmBtgwC0wVHy9mYZU3cYJp7N8kR/nRAdHF9bQxPL6fOuXVlI3l4evFiycg0zRTVHJDmxpjLH29K4scOo9YpmFQlDrfHkuhdkRM17doFY2xNlPQX92icI9ILYKraAx99xfziH5DdaEwsVInbxAkwc8+p0TZJWp5N+XI3UygaM6zPfJCYOumJ9sOZG4JwCe+rsJIw3QBw==; 20:Dk2EiLGyei1xhznQe7qT6pc4PWZRyg+gqO7gJyBVZ6g6tIFIzf1eBeqWE6W2+epLWBe0t7ILQtmHt3HOevx369f75DH4FFckYBrfhHsFY5o0edFvJ/JrzOfkA1r6rv/gGufNZaUkUKWnP6+BHGWsI/htyz/x8JUswwI94MT7qeChzL+jWd+gdEkTxXBU2yJLsipULuMiX95WaUgcF1MCjlh2JGn7ryhZn6/oZKMd80RkY6McmU7eDAUFI6VldJhO2egMxRbZ+TrtD5pFCzvpTqnImck7m/ZgfyKJdsHBnu3/HV2VnpD9/bFeCnJ/3RPdmbR4BdAUuwETIMySPGDAH2gDwySKtov2Eiwy7zhMHwkBGF5Ey+9P2C4aIygXspDuayWOBQw18n5WnOPUlpKk6qeVDVERk/hjAjtdtnBb1nMU8J14tV2fnGZwNBZlj2gEY/NtdDVxsQpYYS3lIH5kK/aLSI+QmejYT66pNv56X9Y1S0jCEf3Er3/6lBMTDTYc X-Microsoft-Antispam-PRVS: X-Exchange-Antispam-Report-Test: UriScan:; X-Exchange-Antispam-Report-CFA-Test: BCL:0; PCL:0; RULEID:(6040375)(601004)(2401047)(8121501046)(5005006)(3002001)(10201501046)(6055026)(6041248)(20161123560025)(20161123562025)(20161123555025)(20161123564025)(20161123558025)(6072148); SRVR:SG2PR0601MB1934; BCL:0; PCL:0; RULEID:; SRVR:SG2PR0601MB1934; X-Microsoft-Exchange-Diagnostics: 1; SG2PR0601MB1934; 4:+cOkpl7OhnWuvWqoPIec2AesarktwJA7frhRTN9RC6JtfNtBOgyKDyNbJm/ntMWuyQFu6g12tkPuUfuvOv6w106leosUDVMZpF6cvtv2PYKp1R/WV6p42+CFO+Hf00HCGuijHxc9FM3hlQ0u6jIaQbgmfkJgr6PGcNovaZEPzNqlkugeN8+AvQpfSr7Q16c5N2wKUpl5R3go9lchqcDayjcMtJXxu14kkP0F5XbctSaxw8ZKZoF5IPNEyBWZWXazMZr8FM+gBRMobfipC9JOAIe0A4SqvVNHw/GySONrXhj6nZk/v7lB0Rti+5qdggzhlQvGei6jiEJEyifWUeu8OJJrCiL1W4igd3g7Ap6JQ1CIykqFufzE36c7p+eUuHNz+28fuBgtJEZBVXoysexN+h3U6NiReD2cQrzV5qcZfKOxwldtsqq3lyiFzk7g96C4/R+UNoWIhDXno2JCTvYic5tfTX/HvJNrkDMoIod5JhqwNsWUeknce/MexZ4K0Q6c5Ve7n8hP+atJq+beMO4kxteD4OO6YZFHOhp0SWnoB/ru9G11UQuDRGui8qGezw3OI9gBRMt9jklfdFSSc8khopNakQcgst8aC9p7FiXSvst2JjmisfLLEVvDn0pYhjoD X-Forefront-PRVS: 0245702D7B X-Forefront-Antispam-Report: SFV:NSPM; SFS:(10019020)(4630300001)(6009001)(39860400002)(39840400002)(39450400003)(39410400002)(39850400002)(50986999)(5660300001)(305945005)(4001350100001)(33646002)(2950100002)(47776003)(54356999)(6116002)(50466002)(36756003)(23726003)(7736002)(3846002)(66066001)(86362001)(76176999)(53936002)(54906002)(230783001)(53416004)(4326008)(46406003)(189998001)(42186005)(38730400002)(8676002)(6486002)(2906002)(81166006)(25786008)(83506001)(16060500001); DIR:OUT; SFP:1102; SCL:1; SRVR:SG2PR0601MB1934; H:morimoto-PC.renesas.com; FPR:; SPF:None; MLV:sfv; LANG:en; X-Microsoft-Exchange-Diagnostics: =?us-ascii?Q?1; SG2PR0601MB1934; 23:CQbTYuV2UcFMUq/Iv2MK9X1SX0BJvUK+bdZ4czz?= =?us-ascii?Q?Y2aC3MdaUmwz+OZW17uHZkBH0+Fuy7PNEBr4LL4uj4PkATP6xyhhw83aDwxM?= =?us-ascii?Q?EQ6Sj9QaNYBtcrZwNN0fem7p2l+I7pAbYfzwzFrQISNFwAlL10/JokuTNEIp?= =?us-ascii?Q?2T9EeXDe3F2FLkZrQy1dG5BM9nYVdNR1xgTr5cgAkBH9Hk9KDabKIbgjXrjW?= =?us-ascii?Q?ggXw5YHPsZ2G9oDBv9P8cqvej+tLlJhokVExm7C92PdXJtAZPOcNFRq1Mvq2?= =?us-ascii?Q?rWySj5mWZhHB/UDMCWuu5yuFo6gvTOzqO6YkogJWa8YvZDVrY0HiccFsFTZE?= =?us-ascii?Q?A48Oqyy/XmblHu/p4vDPhT1rw7FiuZwlXwNJ+FTHASiPrKyOTxmoRrQlPrpu?= =?us-ascii?Q?axDmbHep19meflrXN/vPpPKFn9C1q5hKzAa2OxHAkZ7J2NWFBvtKKKnN03UF?= =?us-ascii?Q?8XpI9frDuIGqce9Qp+s2dbRE4BYs5WqY/Jt/AKVGT+f1vxxdzhxabvf/2RoW?= =?us-ascii?Q?sQvkNNBT7VLuJL+S+UvfwVb6YoQmS8o5Q30uDf/acYmnw+KCIpHDNW3sCl7B?= =?us-ascii?Q?hMbfyY/sV6qwmmSvFpbnOV16uMMD8yMqQvq7teSgFc8o3TNhP/5+BytcW+UJ?= =?us-ascii?Q?1tXv2YRuGmdaXs5TwRxXvX3C4hLLg8RHC78nK+R5VdRAZqBR3gyaNXSwS3CB?= =?us-ascii?Q?H26r7I5dkfCrXW1zEdAy0mtx/mmTiDzezP+2n+pzkB9zQKl+102tayshbi3b?= =?us-ascii?Q?/8iZAZOb+st7uk3nDur5f90pxfhANhmzHYDnhnAwoFBFjuUKoogjl5SJe6Ab?= =?us-ascii?Q?Nzm71XaPfqXbPlx6x/OqrR9PoUmu6U6jtcWvA9QP7r+SCCVKW/CX4nuSTt2b?= =?us-ascii?Q?6MtLTsHUzhlaIdjY94sxG5Sy0z+5JjsXn79hOGxMY4RAVOkIO9nJi44M3kMy?= =?us-ascii?Q?4evAr/jtksJ8p6gEodWX7QbkVIyeUDCH14M3zgsh7xQrvYhIUEa2VgeFI4kr?= =?us-ascii?Q?ltfKScVvXmI1v6JJvkTYYWx5bYbIflilB7JjiCVwuvqVIgQ=3D=3D?= X-Microsoft-Exchange-Diagnostics: 1; SG2PR0601MB1934; 6:XObYZzWv7VCl1h1slhqlrXTi25IGxBUJKEEh5tSW+q/x3G2qPKMJWvMlJLXRpE5oH6yjSR9ZcwMptn3bPZ1xe+cqxTLXkVGuQKs6IkyjmFtKL4dW3QqrjPc738hu7QEIy+q2zhJ39g6GtPHm32r3oFY1RESxYe0wRaLGFoxYflEpY6WneelTECtTQgjEItbqYJksHIsToRq9NmP1VFpf55vjpnfyCkj/SvCZpP5wwBZB+nO7cOTkanGUVLyoGG1F2CXJB8fM/BILPyl23Ow/PPEtJVO/9iaYYKka5kOBqiuNBNdYPHWzeyRmtcJWGASoJfHGfYPz7SxSvFMUaQLs56wyVYa+UHCWiq41zJeV7VloPgkWP27cgvwGWZjTOIreUVs8Nt0349ZNfT3i67NVV1GlJauIjLmIKELPA9e+buk=; 5:w/kG8rmJIrzgD+XefnVYp4U7U7X9mkcfXsPgUo9v6acs5HWD23zYATP1YH/lBgeSKB4gZCdp5BWvTGu6FKWruOm2heTCC0t0GtnhubqOuhejFILsowlDJiNN1whUshqTJhBo9IfF+xLQLgIacWYsrQ==; 24:TxNKt/2p/27uAtv2OOTXlTeujDygnocMFUf8D2UVvEDcDtV7D247hc0YzjGxf4yU7Dz5PkXBddlzE2PQRstxa8M7fUUSRmxqCZDqCdQjtw4= SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-Microsoft-Exchange-Diagnostics: 1; SG2PR0601MB1934; 7:vS1yosAmq7bVxoMM8XnIwe9wQkc6jQTqIaq8scGtxr6qcTM0ilKFevQCpdIKQODuoEKTJVrDIl/teHxTrS53wgJb5xWdYQD3KiPlJ70axAArSPRyvde4VZqhoabe/GO9OkjostlJGILudDTobBV8kMl+8dqC3gE50wtZseO6WLMhDtlodFuoMqIWzwmeQ/nkE0rq8BCymjuwxtJEsq6LesLePSX/g2Me4IOOodNEwKjBbR1oVJs2qFmHFNGDRqu91HGEysJiRbIJnrzaeoUjkRUvYqAsZJTXwcTfIFADP+w65WCRglirirXbuKstP4MayQ3yOqXpSfQPzkhn8Sm4KQ==; 20:tpyhs1YZL4678BavP+ECCpfTfu6ffNisgsE8s5ANP1wh+lCR9YsjcfuhVrjpWstA9yLsfbQ1U5tJbNxWeHQGpSHm/NvaEj5Cm5F5GK555rnTdK4afezsOSgzxgJy92j/tRoKtapACoNeZDgfA/RfQsF0dbv1Ejr+Co7D9DpwT0Q= X-OriginatorOrg: renesas.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 13 Mar 2017 05:54:22.0321 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-Transport-CrossTenantHeadersStamped: SG2PR0601MB1934 Cc: Linux-DT , Linux-ALSA , Simon Subject: [alsa-devel] [PATCH v4 8/9] ASoC: add audio-graph-card document X-BeenThere: alsa-devel@alsa-project.org X-Mailman-Version: 2.1.14 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-bounces@alsa-project.org X-Virus-Scanned: ClamAV using ClamSMTP From: Kuninori Morimoto "Audio Graph Card" = "Simple Card" + "OF-graph" Signed-off-by: Kuninori Morimoto Reviewed-by: Rob Herring --- v3 -> v4 - remove prefix - asoc-audio-graph-card -> audio-graph-card - dai-controller -> audio-codec .../devicetree/bindings/sound/audio-graph-card.txt | 124 +++++++++++++++++++++ 1 file changed, 124 insertions(+) create mode 100644 Documentation/devicetree/bindings/sound/audio-graph-card.txt diff --git a/Documentation/devicetree/bindings/sound/audio-graph-card.txt b/Documentation/devicetree/bindings/sound/audio-graph-card.txt new file mode 100644 index 0000000..bac4b1b --- /dev/null +++ b/Documentation/devicetree/bindings/sound/audio-graph-card.txt @@ -0,0 +1,124 @@ +Audio Graph Card: + +Audio Graph Card specifies audio DAI connections of SoC <-> codec. +It is based on common bindings for device graphs. +see ${LINUX}/Documentation/devicetree/bindings/graph.txt + +Basically, Audio Graph Card property is same as Simple Card. +see ${LINUX}/Documentation/devicetree/bindings/sound/simple-card.txt + +Below are same as Simple-Card. + +- label +- dai-format +- frame-master +- bitclock-master +- bitclock-inversion +- frame-inversion +- dai-tdm-slot-num +- dai-tdm-slot-width +- clocks / system-clock-frequency + +Required properties: + +- compatible : "audio-graph-card"; +- dais : list of CPU DAI port{s} + +Example: Single DAI case + + sound_card { + compatible = "audio-graph-card"; + + dais = <&cpu_port>; + }; + + dai-controller { + ... + cpu_port: port { + cpu_endpoint: endpoint { + remote-endpoint = <&codec_endpoint>; + + dai-format = "left_j"; + ... + }; + }; + }; + + audio-codec { + ... + port { + codec_endpoint: endpoint { + remote-endpoint = <&cpu_endpoint>; + }; + }; + }; + +Example: Multi DAI case + + sound-card { + compatible = "audio-graph-card"; + + label = "sound-card"; + + dais = <&cpu_port0 + &cpu_port1 + &cpu_port2>; + }; + + audio-codec@0 { + ... + port { + codec0_endpoint: endpoint { + remote-endpoint = <&cpu_endpoint0>; + }; + }; + }; + + audio-codec@1 { + ... + port { + codec1_endpoint: endpoint { + remote-endpoint = <&cpu_endpoint1>; + }; + }; + }; + + audio-codec@2 { + ... + port { + codec2_endpoint: endpoint { + remote-endpoint = <&cpu_endpoint2>; + }; + }; + }; + + dai-controller { + ... + ports { + cpu_port0: port@0 { + cpu_endpoint0: endpoint { + remote-endpoint = <&codec0_endpoint>; + + dai-format = "left_j"; + ... + }; + }; + cpu_port1: port@1 { + cpu_endpoint1: endpoint { + remote-endpoint = <&codec1_endpoint>; + + dai-format = "i2s"; + ... + }; + }; + cpu_port2: port@2 { + cpu_endpoint2: endpoint { + remote-endpoint = <&codec2_endpoint>; + + dai-format = "i2s"; + ... + }; + }; + }; + }; +