From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1753208AbcHOTO7 (ORCPT ); Mon, 15 Aug 2016 15:14:59 -0400 Received: from mail-db5eur01on0131.outbound.protection.outlook.com ([104.47.2.131]:26432 "EHLO EUR01-DB5-obe.outbound.protection.outlook.com" rhost-flags-OK-OK-OK-FAIL) by vger.kernel.org with ESMTP id S1752999AbcHOTOz (ORCPT ); Mon, 15 Aug 2016 15:14:55 -0400 Authentication-Results: spf=none (sender IP is ) smtp.mailfrom=peda@axentia.se; From: Peter Rosin To: CC: Peter Rosin , Wolfram Sang , "Rob Herring" , Mark Rutland , "Guenter Roeck" , "David S. Miller" , "Geert Uytterhoeven" , Andrew Morton , Greg Kroah-Hartman , Mauro Carvalho Chehab , , , Crestez Dan Leonard Subject: [PATCH v2 1/8] dt-bindings: i2c: add support for 'i2c-mux' subnode Date: Mon, 15 Aug 2016 15:40:24 +0200 Message-ID: <1471268431-5148-2-git-send-email-peda@axentia.se> X-Mailer: git-send-email 2.1.4 In-Reply-To: <1471268431-5148-1-git-send-email-peda@axentia.se> References: <1471268431-5148-1-git-send-email-peda@axentia.se> MIME-Version: 1.0 Content-Type: text/plain X-Originating-IP: [217.210.101.82] X-ClientProxiedBy: DB4PR02CA0038.eurprd02.prod.outlook.com (10.242.174.166) To DB6PR0201MB2309.eurprd02.prod.outlook.com (10.169.222.148) X-MS-Office365-Filtering-Correlation-Id: ef671bbc-bc23-41f7-44f6-08d3c511cd6a X-Microsoft-Exchange-Diagnostics: 1;DB6PR0201MB2309;2:st46kmr4gm2fz160w0GDCdILCwNSL0D9mdOFpWxQTBjRVifPStc3fLSvDDivGyCHrge4n6cuJTUZXnDA7+2VVx3d5xVJtCt8W2AIPG8SbJPQIjU8gq+Cyue3Ir4YDdGMTV9Hfr1WczmX957qLFqjJF9DGWRm/WQ43ZNy45Ys2EY5bspIvmWLao/xR4VkLuSq;3:SNCn+BpGJs3+Sh4xPmzCgSs7LRMQOx6r/O4IY0MDRr/imCt5FMfehkkvL+OnkjpSV2T3Lp54h9SG0jl4BTvzan/EO4qwsdM9XQXY7rzOSh0LIccUYO/gS+ZSZv3R/KIn X-Microsoft-Antispam: UriScan:;BCL:0;PCL:0;RULEID:;SRVR:DB6PR0201MB2309; X-Microsoft-Exchange-Diagnostics: 1;DB6PR0201MB2309;25:kEFFm61iHfVJjg6lZWdVV0OKikKO8kTCKR4VYVPNIAz09QkcIoM7fnc5Bvqp+OpgCU5dtkloxx76SyH+aDmqz0vVRBMAi2BGK82e5U/8dVICwEf5Er94xAUWQ+ZsHJev2PJ5j0blWTGgD+4JEDAKQLMNvHLde7z9wB9/IbonQBFj6dha5p6rJc/LKkE295fA52wUK41HIsWreNTGPxLEh3EN+jXYrqbmxIz6V4iU87soBoNqKaMkjQtAH2tGybVvb9lN03NCcFYRvBqggg7dYu1cN4Jc91AfbNQvFvlPpyQ3A7S1BVVWbVBCmDtIzSYnruiHv5CiKI+D9rvHfRqlMljYTx4R5fqtGnoE9rdlJzVZ43dpPlfzjc/J3RclVD0SsaMpW65owP+LpF2h0KOu/AB7HZhBd9cQ6C3rhAFHaIt1DLoDOInElaVESGZXBc3DHvHr9hXkM4p+XZml55bx3AsFOQEGJAdTFW4DZWoGcY012iCYsvfP8/ooR6UXyyUsS/UGrPu77J5dX4lUrJb9OuRylpuc62tT94Q6HINu+H/34tapxmVGgpbU+4CCh55Gfxf+DQXWmhV5CnkDA6c/b216dCwd5oeDDAg7V+pUCIO227J8OvI2NRZ8cp7gGRBoPlAZAeWu2m6+ENaCiDs00GIWXu1NsZg7S9XfMLx8P4RWenvyJCOLmBdAH4GLl7lzrjSL1PNRO/ldf/BBpOhte3pbBw1MnMKxGDdQzQEPfE0= X-Microsoft-Exchange-Diagnostics: 1;DB6PR0201MB2309;31:8N6km+XHqcE6LqbplsQZnMwfOMNNua9e3BnflYDGVeCURI1kQ/+qmsRgENs8WZzAqBJE/lE3oBFbuhgN6Re13Vn8OchAo68+7a8rrDFM+sGsK/lQ9SNiBmQGnL//2voAZDHWPYp5osjFnE7k4A7fhPFbm5BTEI+TDevFeQjVzQWoehFEOYv+6LnT6Hi6OxZWIehm322qzP4fk9lU3Jqt1EMdA2b9371hq+QP+k6XQ0Q=;4:dKbCw0JNCAT2Wp0NVElz/4qKpoQOIBFVK0erKEj6PLeuWm0tyXk6+SdGk7FqPgysGqbRhgxC1RQ+Doz17y9bhrIhP76UHEbGs4iEfLOGW7mVlhxJ3OdBQUm8t09xuAxDOW7ITf4LyLrFG7YbD0EdzSKP9OBKLWfldbUPHWx6YfWZaGBIzSkKAoZFE/Unona+j/fN92lCmEYq56nQyi/u8V4xa0HBbjbMdkJYQ5sp9CidqdRLLzL4WdrfPy4XHHhar2mLPGZ7R8TPX+/xUmoV8D+jYkjc/cJaEl6UvZXwC710rpBCy6by5ZCjqKearMiWtC2FEdArVfQhAa0sIYOJb6vxo3w6Mj2ugJ3xsViI+TLhvU9Rv1XyJUyOA9Hdm7NjCt4s4A68Jz9ZCepbWkJvAJGVuB4IMYN8HPr4mESTqzY= X-Microsoft-Antispam-PRVS: X-Exchange-Antispam-Report-Test: UriScan:; X-Exchange-Antispam-Report-CFA-Test: BCL:0;PCL:0;RULEID:(6040176)(601004)(2401047)(8121501046)(5005006)(3002001)(10201501046)(6042046)(6043046);SRVR:DB6PR0201MB2309;BCL:0;PCL:0;RULEID:;SRVR:DB6PR0201MB2309; X-Forefront-PRVS: 0035B15214 X-Forefront-Antispam-Report: SFV:NSPM;SFS:(10019020)(4630300001)(6009001)(6069001)(7916002)(189002)(199003)(19580405001)(50226002)(106356001)(101416001)(3846002)(36756003)(2351001)(77096005)(74482002)(6116002)(229853001)(105586002)(586003)(19580395003)(189998001)(86362001)(42186005)(5003940100001)(8676002)(7416002)(76176999)(66066001)(2950100001)(50986999)(48376002)(68736007)(47776003)(81166006)(7846002)(92566002)(33646002)(97736004)(305945005)(2906002)(4326007)(110136002)(7736002)(81156014)(50466002)(42262002);DIR:OUT;SFP:1102;SCL:1;SRVR:DB6PR0201MB2309;H:localhost.localdomain;FPR:;SPF:None;PTR:InfoNoRecords;MX:1;A:1;LANG:en; X-Microsoft-Exchange-Diagnostics: =?us-ascii?Q?1;DB6PR0201MB2309;23:z4jhAy9/Jdr1pv7oUTOw+UdWPF+WDJjjvH3Bq23?= =?us-ascii?Q?rrgPURVutItyL9qecW9/nVgOJqFwh1cbreFnIf5BXp5sWNBS8iuUQnghhuwD?= =?us-ascii?Q?RXrURDWSDhB44fysA7/PzbgstMXwtaVL2GPdT17xk4e/xgCnIJHUjibQWFLQ?= =?us-ascii?Q?qS45mra8fpgZ+soeYOqv60ZALMgDQmlHB6SvTAHbLHUy+XGs6YtI2pknhHy0?= =?us-ascii?Q?yLR/UchWURXbZNHLsDalMhI1axcCZa/UaGPQu8qhRnJP/W0OH3n8M4jpUtzN?= =?us-ascii?Q?bY0t0J/jc3nhnLb9aPrzybNqalNz7GLrDdedrNdJ2Y0wDK1uyN9MbPm/Kgrz?= =?us-ascii?Q?x6H2T7hoTeTYw5m6L23BMidAL9UWgTvvqOufIIKHQJgVXnM5d6GwkEryjlYN?= =?us-ascii?Q?xRQABzhvPeeZtQjPHCaotF0WxZ1/oJcdY1kIwuFvx5787L2gG4pt2c76LOPm?= =?us-ascii?Q?Ss2HKVn+VleJVh7q+t/u2pfDrX7CI6GQ0+YIMznm3CJx0biHQKNT4OOpws9G?= =?us-ascii?Q?9NzYWUN7kjAkhF75roquACPfnSzHKItTcUF6VfOzXtQCH01IvWiH3aMM0MkU?= =?us-ascii?Q?OPgf6waQPqKJiblSMZqkvCm196mEIR7fnXfF+bf4rlcIFerHELETeknC02g8?= =?us-ascii?Q?DXp3mlLnNIK0h7uMkIam2LeSHmMGHDVz6QPbM+/djzJJeYYvBwo74f+ksQjX?= =?us-ascii?Q?TkmUrnUSfbXkDVn/SudVkDACqrbKLCGMh+66Q9wyE54oLivElUvvJapyzD9Q?= =?us-ascii?Q?SpL/zcjHXa6cxFCYcFKeQpKxEAciWFy/1b6YhjJ913U9TuXb7h4/G2Dynlzi?= =?us-ascii?Q?zbxPgr45fHbwUbGm0Zdmw5sDsVp1GbDfsalhYwXH7vQqTogZwUJ5Kp6LJV03?= =?us-ascii?Q?9SsRAH2twSWbclDAz9hnggjSnoHlbB8KxVpzzmPro/vpxodLLLRa8ErkWUtV?= =?us-ascii?Q?58bt3R1UkWT2nJtjiiLV9o3yPo3GjpLWGvqhjL1yNFZ4SZwGxyTuBopLGeUC?= =?us-ascii?Q?hONDMd3EZvBbhcyRVR1vIAkU71Xq6C4mohcn2U/meoScx54SdC7dZQiOjfnp?= =?us-ascii?Q?m79q+FJY84Glf/G8/lcr+XQujvIGQmTbpCqYVpftlXHnZAaw3zklQyex2FbY?= =?us-ascii?Q?bJKuSOGbKq6EvQdIVeogOtGqZaGoZQF18?= X-Microsoft-Exchange-Diagnostics: 1;DB6PR0201MB2309;6:6UPYm2Sa8JLCUQ8vKw7b75Bt9Dvowyhzsu7ReKq6vVrVmANOYBtu4z9zJ0YTN6nEDLyJ0/mWfhDc2iWxEfZQ9EuUil6mChrMqEOWpMJ9zh5SDgDfG17kydZHOUKNGkC7UFCgEoHYDCRhIQZGX5eHoFNgH8cDXtZ2UeKsuUR4Ly7NZbabRldhQLWfQ7pCHrNxd5y/aS0HSlpOoRrk/Ez5EvjOMYZwF4VQMjGYklL7Bs/3rVH6E9Auca0UJ+cm9OZvyRSLrnM/caGRcpR7rGWU75tltSVxG8jQa1OIV3WbDQvO6TMg4mtJ2b8rKA+P1drD;5:oxWzivddWz7/aubvyATO0SLbER96gY+cBWd39AglPeg7PjP8QQxi3cZStS7hZDnNvIQSCxhxAoUGMLpsZTaU1Uw3XNplIgzyuzsC9dxsznPJAxC6cs5neQkCkxer391q/3rLZIzZ+ZxGjwCHz505vA==;24:6FX1FclHN/j3eMBVuROTJDcgojaa/55TtQ88+LMue8wfz215NU/kurvNbibrEtvUwU0lju2cJD8Kp2KDaEh53mZptCzIn2Kqn+wYIqs5cd8=;7:ZwedsATk+QDt+Bp/T0uFh5m7kPOE+cYyrAReynHCuw7U6a0GW8xx3E2xwE/Cg+jrjggGLcDOUtzO5rBK0lFft+wF9Zu2GgDLQ3JmqJsVVhmS9B2ZtyHD5nPmNTKdEhlEseqi6T2fJRVaj/M0pEAjFjjEkyX7gwom4DjLAbsXAK/W2SIup1fIaoU41lX1QCWEcI7wF+sVuvmS/FZBMoZEPXoIHnHyvDUY2Qmb8EuYkdd1cZjufb/MVwcurQteHyaE SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-OriginatorOrg: axentia.se X-MS-Exchange-CrossTenant-OriginalArrivalTime: 15 Aug 2016 13:41:02.3206 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-Transport-CrossTenantHeadersStamped: DB6PR0201MB2309 Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Similar to the new optional 'i2c-bus' subnode from Jon Hunter, this adds an optional 'i2c-mux' subnode, for similar reasons. I.e. it is bad of the i2c mux core to assume that any subnode of an i2c mux device is a potential (when the 'reg' property matches) i2c-mux child bus, given that i2c mux devices might do more than mux i2c traffic. So, if an 'i2c-mux' subnode is present, dictate that all i2c-mux child buses exist beneath that subnode. Acked-by: Rob Herring Signed-off-by: Peter Rosin --- Documentation/devicetree/bindings/i2c/i2c-mux.txt | 23 ++++++++++++++++++----- 1 file changed, 18 insertions(+), 5 deletions(-) diff --git a/Documentation/devicetree/bindings/i2c/i2c-mux.txt b/Documentation/devicetree/bindings/i2c/i2c-mux.txt index af84cce5cd7b..212e6779dc5c 100644 --- a/Documentation/devicetree/bindings/i2c/i2c-mux.txt +++ b/Documentation/devicetree/bindings/i2c/i2c-mux.txt @@ -2,19 +2,32 @@ Common i2c bus multiplexer/switch properties. An i2c bus multiplexer/switch will have several child busses that are numbered uniquely in a device dependent manner. The nodes for an i2c bus -multiplexer/switch will have one child node for each child -bus. +multiplexer/switch will have one child node for each child bus. -Required properties: +Optional properties: +- #address-cells = <1>; + This property is required is the i2c-mux child node does not exist. + +- #size-cells = <0>; + This property is required is the i2c-mux child node does not exist. + +- i2c-mux + For i2c multiplexers/switches that have child nodes that are a mixture + of both i2c child busses and other child nodes, the 'i2c-mux' subnode + can be used for populating the i2c child busses. If an 'i2c-mux' + subnode is present, only subnodes of this will be considered as i2c + child busses. + +Required properties for the i2c-mux child node: - #address-cells = <1>; - #size-cells = <0>; -Required properties for child nodes: +Required properties for i2c child bus nodes: - #address-cells = <1>; - #size-cells = <0>; - reg : The sub-bus number. -Optional properties for child nodes: +Optional properties for i2c child bus nodes: - Other properties specific to the multiplexer/switch hardware. - Child nodes conforming to i2c bus binding -- 2.1.4