From patchwork Thu Apr 20 01:35:41 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Kuninori Morimoto X-Patchwork-Id: 9689245 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 1ED6D6037F for ; Thu, 20 Apr 2017 01:36:01 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 0FCA528178 for ; Thu, 20 Apr 2017 01:36:01 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id 029D728447; Thu, 20 Apr 2017 01:36:00 +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 91E8228178 for ; Thu, 20 Apr 2017 01:35:59 +0000 (UTC) Received: from alsa0.perex.cz (localhost [127.0.0.1]) by alsa0.perex.cz (Postfix) with ESMTP id 3AEF7266FD1; Thu, 20 Apr 2017 03:35:57 +0200 (CEST) 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 37CA3266FA2; Thu, 20 Apr 2017 03:35:55 +0200 (CEST) Received: from relmlie2.idc.renesas.com (relmlor3.renesas.com [210.160.252.173]) by alsa0.perex.cz (Postfix) with ESMTP id 09B87266F93 for ; Thu, 20 Apr 2017 03:35:45 +0200 (CEST) Received: from unknown (HELO relmlir4.idc.renesas.com) ([10.200.68.154]) by relmlie2.idc.renesas.com with ESMTP; 20 Apr 2017 10:35:44 +0900 Received: from relmlii1.idc.renesas.com (relmlii1.idc.renesas.com [10.200.68.65]) by relmlir4.idc.renesas.com (Postfix) with ESMTP id 6C05C5C6E2; Thu, 20 Apr 2017 10:35:44 +0900 (JST) X-IronPort-AV: E=Sophos;i="5.37,223,1488812400"; d="scan'208";a="240224184" Received: from mail-sg2apc01lp0244.outbound.protection.outlook.com (HELO APC01-SG2-obe.outbound.protection.outlook.com) ([65.55.88.244]) by relmlii1.idc.renesas.com with ESMTP/TLS/AES256-SHA256; 20 Apr 2017 10:35:43 +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=BjaAFHXfq7VVy0f/wobwXYu8LB93WzB5DeRG2Yc39uo=; b=Cv2nMzjRgR8g9ItpOGNPSc/2UKEo9jzSH58jFNGu/dWS24dXcWc3BJ0rTSl+87eO7UNrcWGK/lwbApf6bTJTj0YEiTVl/vLp+96bYR14CK61HXc4raZtK5rSuocnkukymSrFc5HlAVxbRzSGIs9XUyDHXrR/Ag2J8nYJOl7oX2A= 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 HK2PR06MB0820.apcprd06.prod.outlook.com (2a01:111:e400:521f::15) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256_P256) id 15.1.1047.13; Thu, 20 Apr 2017 01:35:41 +0000 Message-ID: <874lxjooel.wl%kuninori.morimoto.gx@renesas.com> From: Kuninori Morimoto User-Agent: Wanderlust/2.15.9 Emacs/24.3 Mule/6.0 To: Mark Brown , Rob Herring In-Reply-To: <87fuh3oon8.wl%kuninori.morimoto.gx@renesas.com> References: <87fuh3oon8.wl%kuninori.morimoto.gx@renesas.com> MIME-Version: 1.0 (generated by SEMI-EPG 1.14.7 - "Harue") Date: Thu, 20 Apr 2017 01:35:41 +0000 X-Originating-IP: [211.11.155.144] X-ClientProxiedBy: TY1PR01CA0068.jpnprd01.prod.outlook.com (2603:1096:401:c::28) To HK2PR06MB0820.apcprd06.prod.outlook.com (2a01:111:e400:521f::15) X-MS-Office365-Filtering-Correlation-Id: 9d8d7917-b9b9-4c87-9dd9-08d4878d8eda X-MS-Office365-Filtering-HT: Tenant X-Microsoft-Antispam: UriScan:; BCL:0; PCL:0; RULEID:(22001)(48565401081)(201703131423075)(201703031133081); SRVR:HK2PR06MB0820; X-Microsoft-Exchange-Diagnostics: 1; HK2PR06MB0820; 3:w8erJlta3SPcx9WauL3gf7GudVvMoJbLLa4gErTXBzOgmEpxLyJ2sfXxoBd4ldQMCeL6cXKYuMm8msOKf6hR7sn8/PB4uvCYbu60Qp09WiaKXbTYY4YmU0dC1gznWYALR1WSX2J9wbDbTRlPsRQ7TGbqNobUJoGuiayusKOSJWdeJxGpwTlMGe7EKFU1xswZHqVOibuhNzcSixepD8M5YPHc9Xaf6gtIgS/ZO9M3mpMOgY+w71eXkUePpLGk8hXRS0oafVDEnAfTYeB8BQoOCcMmINTd61V+L4eJxRv6O8iau1ZAXUXjGakiZ0DqsnftpeHHQMo1fHuCm4yDHs5VLFSn4rMVZOvUmq9amg+MR+Y=; 25:TNhxu6FQVljMGtdO9+Yynls+KgC3Ho9mZMr9Fdfr5CCfiVp4ygvjXDMVUFHSWlfNkxBPGE9h7jKJ4Uxc4joREemecNYgDFrYHArQ9v8a/tesapvZxTajeMDFLK5rHqj2hM3GCS9wLiv508nsluSmZrlPLo9r5BNd9JcNR9IRV39BXqE3IodkEiRZRt17U7Acge74WptDOMScHkH1p4RBYGoIFMD5yUGCxlak44qwfefI4A/eqou67Vi7P0tB2RaO9q5RTkMj2puqSeuq63gXKnO+PQ+TPLfTjNmLVzASP1/zsKf058BDDIl1Hy8C0Z4ZHqKf3HXfmhBZ+xOyeO5iAio3qZaQl+0bIfcFT8U9hqjVvqmhgVxTtQPtdakhNkJKpINWzNhFWPziAMoA1CNdpHlVizcEeKIwfU0KGGhOHdId5I2zIPjI9iVuVaGtYXOodLfC7EsWfs7S6lrP8SVcSA== X-Microsoft-Exchange-Diagnostics: 1; HK2PR06MB0820; 31:DV2TzIpsQsIzwyFVawVu7R/0BLi3twD81uXOulEkSMJ895893fFldxDE9bzugiNMiSUIyFBqghq6gSEqYZhBZrfleaKR+buTehbR2tQM4iPfxutWsrGrj32oUMYV0CbeAyv4vBENNUTPMV+pWdpPD3OMmq3ZT3EAJvw65cvXIrqIP2zY9lDU5ogVp8TDCG/10Oj3gtQXAiSw4LNj5xv+RCNwe/M/+7DEgXod41jUgH/Klu0gDrCLEBRpW0CX8We2y2Z/Pn3AQUMNzln/Xl6rjg==; 20:2V+QDK0vQeyALHILjUusuUvg0mzZMK+MOTh0Zx93VbLU254xUPb2MxwS0+xF81Mg+bkXy56TQPb7paR9nihgSbeS3Qc69KcUr/5EuwZWMcHrxAW3y9DEFIvWokX828L78mjgKC9a/cMM8JW/6RZmwLN3Pn5ePorRduwoBezDxAxSxiF5u91a53tyK1I7x3c0/kyRBzMR32RQuc4UjsrCEJSVa2UYXiZ+oO0W+9cXgBCbGiwYF5f0rRtaCeaLEAVMsw0dGDVSVlWZrWDlVFV5029geQPX/DjqHnkhC3YVl3rGnFTJluLTxLEejAJ46QufG3/RVcsnZ802X0sW+ANbi9VGM2q97rJgDeHPAYdYw8AcIOEyijXgLCLWOK7AjneGPUKJD/GPoMj/VUiZJT94QKIdc4Ky6irXbER0CvWV7ZWQZzzpoasLSPrLQi/TN/s29ui/PbVCo6neHz5P1LOjKpeU9ML8nQ9I+Kk6abdL1HENOQoQXbN0KsjpiUAJ+4j4 X-Microsoft-Antispam-PRVS: X-Exchange-Antispam-Report-Test: UriScan:; X-Exchange-Antispam-Report-CFA-Test: BCL:0; PCL:0; RULEID:(6040450)(601004)(2401047)(5005006)(8121501046)(10201501046)(3002001)(93006095)(93001095)(6055026)(6041248)(20161123560025)(201703131423075)(201702281528075)(201703061421075)(20161123555025)(20161123564025)(20161123562025)(6072148); SRVR:HK2PR06MB0820; BCL:0; PCL:0; RULEID:; SRVR:HK2PR06MB0820; X-Microsoft-Exchange-Diagnostics: 1; HK2PR06MB0820; 4:1KcgqknJxs+uuUXCZKVGIKF/VHGHGtGmZL3Rk5Klcxvm59XLfOmapHZ3WouJ/lGXU1VU7wJFEBJXRhKXvCnm/LhMjYxGw4dyyRgkvmki6s7uU1azOKp0FzYnEjlGrHTWpsLwQjwA4IqHB9HDLc+wIIrF63Ql/Scm6gcGKiLqstc/+aID8f4nKvFPKb9QG7A9BH8zxT7FkEtd3yDdl/8hlfmEp04UE+rSi6oydVpDuWeOIqjts/jtDzw3nyuDJkZCV2+L4jAEuHDPUN7OLYq+mfWiKfQzOs4D73aPOJg4c0DGFksDFkQI7dBZZy62CPAk5XVYzO3khXoV+XS1oZtrn8pFSmFpTxpxjmUlouk/TuHX837wfxfqZC2j1dBgbyPFPbxoI8zR5kWdnkRud8KUzrBq8shgm+/pYiC2kCxqhWc1XtX+SbXNoKTIFKcAxZ6RGVf8tO6V0x6qQBrZbj6iDiyCVNuQPbTO1shId0yMbRJjFJhgU6Ta8XvIufo9VT6WDOarhArokajM0MvtWr4SQDFwmpveHAfC//NAAeTayvfXUrdBGc1kVO7GQ5UMJIB8RRzqq0fcqkPvd6nDnqbanaa9uwKmHYt274qG6gPFdy0op5THLwMnGy5MMln6i5qxw32yjQOajN2fB1jyKPc6qn5dZ6gEW+eJCecYlGW1RGkQNLV8A8d6gYKwdcIDzo+xvejfTZNEF5aGJ8lSJ59TneXlJoAhRp7yKYBjX+nkvY4= X-Forefront-PRVS: 02830F0362 X-Forefront-Antispam-Report: SFV:NSPM; SFS:(10019020)(4630300001)(6009001)(39450400003)(39840400002)(39850400002)(39400400002)(39410400002)(39860400002)(46406003)(25786009)(2950100002)(4001350100001)(36756003)(54356999)(76176999)(6116002)(50986999)(3846002)(305945005)(33646002)(38730400002)(23726003)(189998001)(230783001)(7736002)(2906002)(81166006)(4326008)(8676002)(5660300001)(53936002)(54906002)(53416004)(83506001)(42186005)(50466002)(66066001)(86362001)(47776003)(16060500001); DIR:OUT; SFP:1102; SCL:1; SRVR:HK2PR06MB0820; H:morimoto-PC.renesas.com; FPR:; SPF:None; MLV:sfv; LANG:en; X-Microsoft-Exchange-Diagnostics: =?us-ascii?Q?1; HK2PR06MB0820; 23:7BGguBSKasdZLfWwuGSBxMQ4AyDsAXfN/MJFy2A63?= =?us-ascii?Q?+E0XbdCL1WdgZa5QhsQlHbHLCUovS8P2PttGbxXAgiIxsVzQRdXcbUCD6eGg?= =?us-ascii?Q?eQV4t8kg+IN/QjvhxdJgxGSZw3HFHQ1cHcixdbICpPVa8XNjLZEbmR23zhpL?= =?us-ascii?Q?WdydVN3Xbt5xnIikN69GblhhMbDuAOG9hG9XX2X5YumePybJRZOAMA/3yrv8?= =?us-ascii?Q?UReWvxZPO3F4rzAB5gFj2Jhf1y/ZLPf4b/ZSRfSvqPZommJVtOg65CwuuiSw?= =?us-ascii?Q?ZyOkDFXWXIqUcJSqL3ripZEFecA/A0XBVpSP8JgQtBU+kuI+o8SM4KYYtFqd?= =?us-ascii?Q?hUdSfaPTqOe8T3S5lCAL7bKKu76Z0s8zRq1DDjA2EOKcpuJYQpZGqE7LyYbm?= =?us-ascii?Q?w9pJ/I3D8YSe0VFdBfGPIRH/xWTEGSIyb4DH8sBkLUz3hiHFaOXd4/77aFBh?= =?us-ascii?Q?fBKAOPdn9obWPKG9hRLZq8IPzWByoSbrWXZLHeqmSK0MTfSiVXjg+vsFpWCS?= =?us-ascii?Q?FN7W1948LsPT5hjL99Z5USVRDNGWb1m1AXU7f8xdHlIUtKFfIIO3cTFpiuRI?= =?us-ascii?Q?X4KDuTjHmlfMGhM4IbH1ZAT7elh5/GnKGJaVhKl3NDE0tjZkheW30CMCjJks?= =?us-ascii?Q?7IAovAE5YgPQ1loCvbPtQokTqjIHaNUgGvIFft1f6/T9UBx9LEItorReHfdE?= =?us-ascii?Q?2dvfpm75q6Ke+7n6vzmAeiyGDHtFZaeQlKC/9aovqxnNFnVOBznLqBADTW8k?= =?us-ascii?Q?pCr/5E3e6CGdib4vJ2Es89jiYTX70UA0mFrbvaG7GHMFKqEUcOFHLFh3tl+g?= =?us-ascii?Q?QcGDfRKhSd8K6+Xuq1PsAjm8MK9ax6nfWYJYYYTxdAx34fIs/fwS5IWADw3i?= =?us-ascii?Q?nRjP/BV7WDtbyk2HZni35b0t6qI7xg/O0if1KjBkud4Zoqt0kOBIuHKxKmDV?= =?us-ascii?Q?/PHZvzrgJcXsbRoslw90Z/p3d3KAxhb/SzJyisRjWrjwSn7f0s/h30bSJfAP?= =?us-ascii?Q?wjMAe/97/w5HwjsiswIXyALHceB/HMofielIbhYPwnb10c6IXJv9mqcoA7H+?= =?us-ascii?Q?fYNzVk=3D?= X-Microsoft-Exchange-Diagnostics: 1; HK2PR06MB0820; 6:JFyT0TW8W1RaanJeKRkikgrnzYxyztAKA6PURWxNDtImRXfPgT9uptZ0vmb2SZqftWSVe656jMcn02gMh3RzuJIZOPcyGuIFGR+Mc8tRcLw/SaV19syFz1jXyQO4dDN7x6ftUbfR/ejJ7STtFUlLdUTL+2PVkxJTxkijex5IrAhA+MX7gS5c4bN98ZO9B7GyWzFnifQb8H+PzzgnDRpANXQKX098zqIRtSsVVct/xDOq/RJfJrxbT1y+0dXa7gAKfyMo6p6fUHNqTIqVtr9+vWJmXPWly4gnEJh8Nhh+1IjdoYckuiltQu3IK0c7VvrWgtO5fvcTO/3+v1ZG7BPnbw4byJDIyL5ZY0EYfJUYzylydDEEfud5DRcO8NjzcSFP/xWwIDSNkrV1uQ5VMpQ8t9Mx01VCZ425hTe9PdBjb8kwAsCdZvBNnQSHXmKoZftaH90U/WTXMasLtgaQpk0R3easoPl+lGaMV4hPj1/wINQ=; 5:TeOpQsIT3/MqlpM0RQ/euy4QUGclux1Jg0KZUhTkieI6xBLV37Xoy0bmYG2TPg1g0PAJYy+6MPah1plzcRw9pR1B7+LkQ5g99QtLHTaj6Ch9EOnAP6uaAyZEH2d5BZsXIwS9qxaruA2YITdkxrYR9w==; 24:Hi5Oe32A7OVsAgSBkGl8s5bdsHnXpD/XdkJXvHLwzf9eaKN7HH3OU7uezGyrxXn7j1iktP7NJ3p3wzuAQvIJ1v8fK0xiFostnJd/ywlCtRk= SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-Microsoft-Exchange-Diagnostics: 1; HK2PR06MB0820; 7:VK1dQIPbie53XeUolP8Qhxb+G8rVcWO+uJZOUi6V3E4ni4PXkRkLBk0swAl1MPmaVpHgokPU3j8Pgr3PTXnZrGYX0t03YPvRni7EZey4E2dlHpF9JLsyfUx6EpSkOeB4/Irhb3RWaS2cxkT84Js56iVQSf+vL0PUmRBAVVDy4radWA8CP9cwQS47A43G+RktHyku01Pd6/nwOJiFNXqdjZTLeOzPbVg8pNjt4TEdQcxlrbCUXSv+z2RsLRsS4UgYKVOAVvjnotzQzlxkMEgvxGKzLi4YlPS4njUqdhPjsRM0b89QxGKRjTZK2yQfYjRPYyl/9GF8JJIwwVp5FOsP+w==; 20:QeH5Tyy4z3PKOzdymNsL+3zNaX9LH4+v8bXip5pv3+Zl48wobC4bKi4VOSziILdCuKLGpIvEAIJreRtdE2sAWTR3bvNfvSoSLasHVG19d78SSJ3Dm/OZlUDEXxt9c8+j11591ROI2pFj93p9hUuB7Q5bZ31PgREA8NdUJ6kbPkI= X-OriginatorOrg: renesas.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 20 Apr 2017 01:35:41.8381 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-Transport-CrossTenantHeadersStamped: HK2PR06MB0820 Cc: Linux-DT , Linux-ALSA , Simon Subject: [alsa-devel] [PATCH v7 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 --- v6 -> v7 - no change .../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"; + ... + }; + }; + }; + }; +