From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S936573AbcKPCWB (ORCPT ); Tue, 15 Nov 2016 21:22:01 -0500 Received: from relmlor1.renesas.com ([210.160.252.171]:22799 "EHLO relmlie4.idc.renesas.com" rhost-flags-OK-OK-OK-FAIL) by vger.kernel.org with ESMTP id S936347AbcKPCV6 (ORCPT ); Tue, 15 Nov 2016 21:21:58 -0500 X-IronPort-AV: E=Sophos;i="5.31,497,1473087600"; d="scan'";a="226094862" Authentication-Results: spf=none (sender IP is ) smtp.mailfrom=kuninori.morimoto.gx@renesas.com; Message-ID: <87d1hww4g6.wl%kuninori.morimoto.gx@renesas.com> From: Kuninori Morimoto Subject: [PATCH v4 09/12] ASoC: add simple-graph-card document 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: Rob Herring , Mark Brown CC: Linux-ALSA , Liam Girdwood , Simon , Laurent , Guennadi , Grant Likely , Frank Rowand , Linux-DT , Linux-Kernel In-Reply-To: <87polww4o2.wl%kuninori.morimoto.gx@renesas.com> References: <87polww4o2.wl%kuninori.morimoto.gx@renesas.com> Content-Type: text/plain; charset="US-ASCII" Date: Wed, 16 Nov 2016 02:21:41 +0000 X-Originating-IP: [211.11.155.144] X-ClientProxiedBy: TY1PR01CA0077.jpnprd01.prod.outlook.com (10.167.153.165) To SG2PR0601MB1455.apcprd06.prod.outlook.com (10.169.106.21) X-Microsoft-Exchange-Diagnostics: 1;SG2PR0601MB1455;2:YfurSw+5mF1EKECJyqy7cdYjmHXQ66Y7uzSRqZNHVUlfKj9YDuDl37akjEvxEWkk4EOw+943bp782miEeTk76P+AmYv3CI8B3nmjaKPxdB4uLa4JKz0m1KnWQZQsT5pvfc2tKuQccYh7zLRCj+YwMwWK5jjXpa/Am+gzalsZuyE=;3:q+h4J/ISENekTO4kI+YkNO7Jme2Bsk+1EQLgIIHTY1qUj+P9u8BtVK6Nvew1xpvgYACRRgmKfZlxHOKhI9tyhxsj/LfJP2HzfrnI8XbZaPR237phqpC0HXIHPRikRwOkP4lV0Ip0u4j+NZqWgt72MfbtW82nrKWDbdHezHNjLXc= X-MS-Office365-Filtering-Correlation-Id: 509e8b8b-63af-42b9-af5d-08d40dc74ed8 X-Microsoft-Antispam: UriScan:;BCL:0;PCL:0;RULEID:(22001);SRVR:SG2PR0601MB1455; X-Microsoft-Exchange-Diagnostics: 1;SG2PR0601MB1455;25:9C8PoN1htn7U++bqKZJVeo2uH4lOm9GfTgHsBwUmLHOgGjopYFe89hd2iRPHsY2wyVxi7bEztAFJqDB9mP865R0pHaBbYDaQuOdJD4Hdy0jVxp/hXipBemISsGyuvkx1+fJj4OxWqq/xJxbhtuU/1g7tXhAEdBTobLFTiqvK7VeJAWHplQmEykiDBxOKwhjDqr34q41wnl5SeFyKevSdc3SDwpTfw5zQIP3qdI3AzmaCXkQfy+DoeQXRu9FqfZ3UDSepAeKS87Kh07TWmVawxBKG0aiPqsSihHKDKTo06fH4bd38agHvd9fXt5BZELrRJQavCn+vxQN8FS41X5GGDSMu2IwJJkgewp1HgNayuSBBZwsRWe48g0SXJJCccqqigr7nhFTtIsuTEoL3Q4W5YVlRQH/pv676OuBm81/0GWQmqVMmbIpEv/1zEEGTp4X66X6DMyhNDjDBh/IrHKChSTW6WOlHETQo6PT7M1HU3aYYiDrzLQzoPEkCwEIyVqe1wuE5dfWfd6BlhchTdYVEpMF9O+w20KW37C0+IMgegnmjYLcXM2pKb5g83YJjQi2VWtaUlFmQ+w7xAfTeFfU/j3lIUUEUhCCnly6nkqjm473rnSYJCT7lE5pSENeINS1BoZs7/455Z5XRLtJGb7aYgASK57Hp6dUeBb5YxaFCpyiFMdGGwbDU3tRzpzj5Ry2GnQQr9i14szIgn2EikgbZARtIaNRhC5X0/ewq5g3Nbjavgdmc+Z1DuoDp98Dsj31M X-Microsoft-Exchange-Diagnostics: 1;SG2PR0601MB1455;31:nQkvc+a+VlCz3yOdq7qnyJJybxUzpMkhG2/brRlE29yYkX8yJGdXSPiTqdEfL5LBrRl1P4nUPPHDYXtTILrxFv3Cb6AkzZ4WMKEVuSQMFAI02MpOEeuwcNODKxmwGuSNqIXAhAflD8LqYl5UBr3eWij5TaUCt+cPFoRYPOSyDb4vH1xIC+qAFNYzKTT62IPf2NUeMRloBBXnPmIbHGECPeFp3aXQarMyB9tR1TzGermYhodMqd6Z6jZc7gsDd92ZWqnMt563dLiGTpzp934NrJW14vqC4DNDQMSwDvDBY+E=;20:7GBxkiZ6GLAo2JqBcJpU2IYZNppDeSHlTsBztPxHCyxf8LOHQ3XnMTZ5GGoQnEsK4dCdJAik1FCIVPPmjNqLqYj9gDVNyk8QOeqjl9c074KnnyN/QuLkke3lVlod0oUrlxoeWGprbY8WTZVOhr5Bu5HAlUzzmZanZermirq8iiS79GXODfrwt5pncTViJFevh2nkxZmrUyHXjoW5myshpQZ3K2QBSG2xg7wshglbpexQbsR5dPkh0IpenQSYY9r7Vvb9DRsmXBpYVFcWCXQIoLp1TBjDHo5qcqevIpbSdMG53DhTeTsOcB+J6YOBaYEHUxkXTKerLT53ezNBaJ/YtZ5fT8tUUpWXFQ/qYoxV4hxpWPRxy93QwoJdyVE5udJHUsLIpclbQfAsQ+9LMu/PvS0tfuk5ZASB6+vMh4FK7PLQLAKfkOS2MgZ3Nuwcf9Fib1JiXuIh5pOd2Bfoazyb696f3JTNyUqbcvga6rNBr7vM1DHDW3y7mMn8vNRcrG9A X-Microsoft-Antispam-PRVS: X-Exchange-Antispam-Report-Test: UriScan:; X-Exchange-Antispam-Report-CFA-Test: BCL:0;PCL:0;RULEID:(6060326)(601004)(2401047)(5005006)(8121501046)(10201501046)(3002001)(6055026)(6061324);SRVR:SG2PR0601MB1455;BCL:0;PCL:0;RULEID:;SRVR:SG2PR0601MB1455; X-Microsoft-Exchange-Diagnostics: 1;SG2PR0601MB1455;4:LmUj8/PAfj5Q5Ykw8kzEFYr2XnqvJXBEVuVUvxlpheHTGMF71R301qLOvW0+BUyv1xl5cep4MURMJvSkgBHbmpnwkGagKV+PuBUWA8rf8K79Ow6AYoHUbEOnM23EuqDig6JTLeUpA+w01pV0LBDCup0rM/bDhQIrTbBc4RFhFvfeL+r3lpFHy8A7yU/6xCJBHDuG1vF2LO3+Z9nZWmGgMoXs4+OaAzGQOCJhJ9a+oftSudtSF1BygtPLh1ZcSIknB9uQuw74MFO3Rha4XgZoUk1iq2WSbZUngJEfkZbtaCka6Qww0dSWBMNbM3an4Z4gCF9h1RXftkr6+M0O8lwIj9izNPEF0xjbdEaj0X10xgc8/8j2+8HII+MuTaSHhSf0UH37IwPgIOY3sDj6jtQ0G6E6+aCMDiCHVtmIBSwJiiMlXr33a27pmlDURAIInlBb X-Forefront-PRVS: 01283822F8 X-Forefront-Antispam-Report: SFV:NSPM;SFS:(10019020)(4630300001)(6009001)(7916002)(189002)(199003)(7416002)(33646002)(5660300001)(230783001)(68736007)(97736004)(5001770100001)(54356999)(36756003)(83506001)(76176999)(50986999)(69596002)(92566002)(2950100002)(77096005)(4001350100001)(50466002)(53416004)(46406003)(101416001)(86362001)(106356001)(105586002)(47776003)(66066001)(42186005)(81166006)(8676002)(7736002)(189998001)(81156014)(305945005)(4326007)(8666005)(2906002)(7846002)(3846002)(6116002)(23726003)(7059030)(16060500001);DIR:OUT;SFP:1102;SCL:1;SRVR:SG2PR0601MB1455;H:morimoto-PC.renesas.com;FPR:;SPF:None;PTR:InfoNoRecords;MX:1;A:1;LANG:en; X-Microsoft-Exchange-Diagnostics: =?us-ascii?Q?1;SG2PR0601MB1455;23:+teQSShWcM7eLH1X0Z6TVfTpemfMo9L3cQEHbb2?= =?us-ascii?Q?KYNOI2YZ5shgOA/eIAsMIOLLlhZJtedQ4YR9zdXSp3ZnBVTohuhLRw6TtK1H?= =?us-ascii?Q?5EUpm0pU25BUkaGQWjMdfXgA4zjTUU3FAF2qiw9dW+RZYPWPrDaBl4RBxYlK?= =?us-ascii?Q?iSkrbVr91OJRC7wccR0AG58DwhW16AqsJznKgSKdeLWjcaz6lX038orT2Q0r?= =?us-ascii?Q?eIKMFLncFoZ+y4U/b2KD5dZL6itI4GYWYgOPxjRJztlYJHHtsDF73WolMjuV?= =?us-ascii?Q?AuvJAMQ0bdWb3W6DH+RPGzss3xlXXvwVnfKXAvB5Ad3YafWwA4owfWhKFSnT?= =?us-ascii?Q?tavrgPkMM2IUmrs5307Kh00JDOIIZbyMHy08J2k/HHgTZMawrYjgKtNULOWt?= =?us-ascii?Q?/hYezz8U7P/+19xoCIXun+JpBAEoe/BfI9L1yk3YXRCkJ1H4G/9ljpZrFWkL?= =?us-ascii?Q?FsfiNfi1COXLfirpCmwZn0G7TjE9Db2Z/gCeWfyLdo30cIeWxguZFB8ozSoD?= =?us-ascii?Q?iFd5COl0VjucJe5vtB/lbDQr0k+QFx2bB3c5lUZbvf2G7LkUHeYxuey5hrZL?= =?us-ascii?Q?+8OVzqeOslX2Z8+9bgDjZ9YMN9IX8zCFELQ58Rc4fke0BD5PHaTdPa2VXscP?= =?us-ascii?Q?ECeMoVH/aGxX3ZGg2NAIflUf81mIXgKv+SyJy9cX731KV0aLP3JGRJRW/9t3?= =?us-ascii?Q?Ogaa0coqIHoBIvZZwIRV8VbiqiCq3lMgloebd8Z+EjRwpiQrIRzLl+F68PCF?= =?us-ascii?Q?QJx80RfGXpuoJmSoUTKFML91hQrYbsCBSGV5REthwIWPivqHh5TsLUEhGpV5?= =?us-ascii?Q?+S1+4adTdcFdh4joRq4AnCqun4aZ70NU2Ph8AMcNwroIV1+eKlTnp4iJyvM3?= =?us-ascii?Q?Z7geZP2BpkjjX8hK1gZe0pfdaR5+F3ftAMpxakUeeOV2c0xTctN+qfp4o+DZ?= =?us-ascii?Q?Ubq3w+8MuYJN3vEa0sODsBs5UPyHmUV3/6nEL0NkrCrSwhw3n4Gzr5oYHP/i?= =?us-ascii?Q?Zt/ikJw7Px6BA2TNeG5+aXGsw6O/cx7hBIqnNP4DaWqe4iPIXT1B39X80Tjn?= =?us-ascii?Q?PBwXCDz3U4NzDQKPso+T14aAsfr0h9d3V53FqFqlVWi1YD9rEJ6LClRNoXg1?= =?us-ascii?Q?SUeXm0OG21LDlwdaPqV16DH2w9PDNiHTauHg1IVQkPANZfWmnpOt2T7yalf7?= =?us-ascii?Q?W+zVLiWxoTjSbmBo=3D?= X-Microsoft-Exchange-Diagnostics: 1;SG2PR0601MB1455;6:lURrHkxSqHTvxWJA4/kWc/OKxqzEPCo4XdOqGjlFD2Nr6qvvDtXnHDU+zW2lAESk9yGnk5Lez63dt8C3rEDrlyUH2v78ZQ3F/vi4i8okVchtLQ6BrAov+HlU4gqCUwz5F0kui4BlgDDlChibyVTv/f+grMgcWG6Z7xXNQtGXUJtqolT5UTYIvuZEroQWRMmo1iSpqP/oGLvfnRoQ/V94wBaY2Rw5lvdlu3mPHgwzvxYdUGuPe3M6Pl4CB7VOwlDp9tfdfXlyM6lqs+tZSuVCq3dYwywWm8W1d5b2Uoz8KUCOjRHrIRTzX4KSvqOvNlWYy5R2XMEEszKF0CmziGFRzDptpxtRpHDBsoa5QlpvDJS8bbblYmm1XvDTxTWo1slj;5:YuDamtYvUXqgVG8Nq77HeHCDOQQJW43tGbWdiAZAGLUHs0Cxwpr5/K13jzueL2jC0A4L/VNIXkjZmIVdF2FccoA+Cw1kE8f0xelXGT20ebwS/mbkaB1NSYoHejMaHqphhMXCxg01x9EnaQdO50kM5w==;24:RMgtGdr77ssCCAEKhDJBADa2w4Ae1na0dxtsJ4w/U0wwj97fchdrQ5qDm8K3Tlz18Xj7GIyvxlWo/PSdwdIrItlIJqn8sreWIumk8nC0iQM= SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-Microsoft-Exchange-Diagnostics: 1;SG2PR0601MB1455;7:liUkPA/3ySnmp82rJrbJ0Csv05gznA8pu02+GMxYfPL4agn3CecSEgpgDj3ambG4Ygm2jQOgCvoxc09lLnPjCpRmUri4gcqV4WvTzRlRJamwlBm2vo4DEVu55NXedKxBdgAqBM4KempsQvazm55yiB5Af1Syi4FmtXC9nAT2udtwJmGs5W8xZ2SkH3E66kZJ/nXV7yUcAOiO1freKcK1ejU3e1WAE0A24htNDuL/K5l0nd1l77yRxBRlxybF6HVgPcT4rLTcwt8fuZHcQmEXvVTl63WlF4t/1mhWyJEJD3HKyA402rkFm07e7xXjLqxxKjuDxB/TWoM98whq2+678hlDp3MwWVbX7hALJ1mH4qk=;20:YfRxFet35E+XgL/zjLj+EQSixYQZ3SQoZriJRdtjEd5AzGxo/8/YipQ5HBwpw7kkZCOOo/7npqP+fGdIDsxaIm12tVJfrL8/kO6GjEAmYNCjIBpa8sN/7kBSfTcZViq0647Q8i4b6A5YIorGTtCZwWObDl4PPXgvXcCO2eY0OkI= X-OriginatorOrg: renesas.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 16 Nov 2016 02:21:41.1927 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-Transport-CrossTenantHeadersStamped: SG2PR0601MB1455 Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org From: Kuninori Morimoto Signed-off-by: Kuninori Morimoto --- v3 -> v4 - no change .../bindings/sound/simple-graph-card.txt | 65 ++++++++++++++++++++++ 1 file changed, 65 insertions(+) create mode 100644 Documentation/devicetree/bindings/sound/simple-graph-card.txt diff --git a/Documentation/devicetree/bindings/sound/simple-graph-card.txt b/Documentation/devicetree/bindings/sound/simple-graph-card.txt new file mode 100644 index 0000000..11823b0 --- /dev/null +++ b/Documentation/devicetree/bindings/sound/simple-graph-card.txt @@ -0,0 +1,65 @@ +Simple-Graph-Card: + +Simple-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, Simple-Graph-Card property is same as Simple-Card. +see ${LINUX}/Documentation/devicetree/bindings/sound/simple-card.txt + +Below are same as Simple-Card. + +- simple-audio-card,name +- simple-audio-card,widgets +- simple-audio-card,routing +- simple-audio-card,mclk-fs +- simple-audio-card,hp-det-gpio +- simple-audio-card,mic-det-gpio +- simple-audio-card,format +- simple-audio-card,frame-master +- simple-audio-card,bitclock-master +- simple-audio-card,bitclock-inversion +- simple-audio-card,frame-inversion +- simple-audio-card,mclk-fs +- simple-audio-card,dai-tdm-slot-num +- simple-audio-card,dai-tdm-slot-width +- clocks / system-clock-frequency + +In Simple-Graph-Card, above properties need in CPU side port on DT. +And it needs to have "compatible" property too. +In addition, CPU side driver needs to call asoc_simple_card_try_to_probe_graph_card(). +It will probe specified Card driver if it could find "compatible" property on port. +Otherwise, it will do nothing. + +Required properties: + +- compatible : "asoc-simple-graph-card"; + +Example + +ak4643: codec@12 { + compatible = "asahi-kasei,ak4643"; + ... + port { + ak4643_port: endpoint { + remote-endpoint = <&rcar_ak4643_port>; + clocks = <&audio_clock>; + }; + }; +}; + +rcar_sound { + ... + port { + compatible = "asoc-simple-graph-card"; + + simple-audio-card,format = "left_j"; + simple-audio-card,bitclock-master = <&ak4643_port>; + simple-audio-card,frame-master = <&ak4643_port>; + + rcar_ak4643_port: endpoint { + remote-endpoint = <&ak4643_port>; + ... + }; + }; +}; -- 1.9.1