From patchwork Mon Nov 21 13:17:14 2016 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Peter Rosin X-Patchwork-Id: 697248 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by ozlabs.org (Postfix) with ESMTP id 3tMqMP20Bvz9sCg for ; Tue, 22 Nov 2016 00:34:25 +1100 (AEDT) Authentication-Results: ozlabs.org; dkim=fail reason="signature verification failed" (1024-bit key; unprotected) header.d=axentiatech.onmicrosoft.com header.i=@axentiatech.onmicrosoft.com header.b="UzROKlMu"; dkim-atps=neutral Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S932417AbcKUNdi (ORCPT ); Mon, 21 Nov 2016 08:33:38 -0500 Received: from mail-db5eur01on0106.outbound.protection.outlook.com ([104.47.2.106]:4416 "EHLO EUR01-DB5-obe.outbound.protection.outlook.com" rhost-flags-OK-OK-OK-FAIL) by vger.kernel.org with ESMTP id S932301AbcKUNde (ORCPT ); Mon, 21 Nov 2016 08:33:34 -0500 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=axentiatech.onmicrosoft.com; s=selector1-axentia-se; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version; bh=5F88r2LcMBh0xllDAHvLwRsnaxsHDzwj90pjd0teEKg=; b=UzROKlMuEwhiAWgOq4qjWtC9/LOvyDgw54HCtwAiHYOMI0y6sXYfrYsuUw6c3vRdJHJZFkKfNSLr6/uRHGLHbA06+ERUenBl/3omh4nTm1sxj/vpClrFfr6kaZ0qo03M43Rw1DcrEeLVXHod4pOhC39ZXOLGvmTeumtMvN9mhU8= Authentication-Results: spf=none (sender IP is ) smtp.mailfrom=peda@axentia.se; Received: from localhost.localdomain (217.210.101.82) by DB6PR0201MB2311.eurprd02.prod.outlook.com (10.169.222.150) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384_P384) id 15.1.734.8; Mon, 21 Nov 2016 13:18:00 +0000 From: Peter Rosin To: CC: Peter Rosin , Wolfram Sang , "Rob Herring" , Mark Rutland , "Jonathan Cameron" , Hartmut Knaack , "Lars-Peter Clausen" , Peter Meerwald-Stadler , Jonathan Corbet , Arnd Bergmann , "Greg Kroah-Hartman" , , , , Subject: [PATCH v3 6/7] dt-bindings: i2c: i2c-mux-simple: document i2c-mux-simple bindings Date: Mon, 21 Nov 2016 14:17:14 +0100 Message-ID: <1479734235-18837-7-git-send-email-peda@axentia.se> X-Mailer: git-send-email 2.1.4 In-Reply-To: <1479734235-18837-1-git-send-email-peda@axentia.se> References: <1479734235-18837-1-git-send-email-peda@axentia.se> MIME-Version: 1.0 X-Originating-IP: [217.210.101.82] X-ClientProxiedBy: HE1PR0701CA0062.eurprd07.prod.outlook.com (10.168.191.30) To DB6PR0201MB2311.eurprd02.prod.outlook.com (10.169.222.150) X-Microsoft-Exchange-Diagnostics: 1; DB6PR0201MB2311; 2:qCjyezDCnuMt2xO6bplV+cZiwfCLDPhYaEfSen90LcZp5BXWKSwZh0gHJy1UZf9GovzpIoYcJgY0bZxcI3XSr+SbQ/F9eBR3bwogdby9H3igthFg2PiBSo/We2JjYHp8fQDYv98JhMQsvbbDj5vUT33TPpljf2Moqe/+vlI18co=; 3:xa0fATcajqBD5cSCGASky9neyGbk/OeM/kcXVi/W129awp6V2R8kDWOkYG6lRAsUd8VmMZKcO6AFWsOgo0RJWRk19bwCCMbFttWQ5ivhW91hT17/WtHb1KsE93f78PYpwjeqYsk67Rk5u81zeGbj4z2IEFgAP/pAJ+vL4UqyMxM=; 25:lUExbZtFWQcDpmK/sUHuHNHe5MmiBIHo3IVxeakMDE0/KCyNs7Ma0PxYXe/QrzsMlk1cRP7IDTEmGX1nxNVo0YhqACt8T4c+EPxo7c9bVCYJG/QO4CO8XQAN0QhdtpurJnCN8XC2FA7ARetyXMgXkAH3r9Fp6vhgYM2iKgljjF4x0Hz4GkNboMYKl1EGdLaHTN1CuycsDJdSVofVBGRDMCMSyv+nsiNnvloQPMeCxiphugEHR1WlQ6YF2Vx/ATPkFYuMTIDNIZXomrwWK1RNFIFV8jWHMP+Z4tD+cISD7WTwekqKPfCzW6nR3I4QSJEimQsquP975L8GPySCzKFzjwTI92M6/NvJAA+4kHoA68IwMjEFjP0ezOf2qkWJfofHNW7vQc7RIhfVCMzOUCfA2+vnZcboeMgFiV47YZaY8iPTnSImCfnh6qmXuIC41aKjSO7W2XzDhRw6QOv9N5IEbA== X-MS-Office365-Filtering-Correlation-Id: 58b2667d-405f-4bc7-243c-08d41210d248 X-Microsoft-Antispam: UriScan:; BCL:0; PCL:0; RULEID:(22001); SRVR:DB6PR0201MB2311; X-Microsoft-Exchange-Diagnostics: 1; DB6PR0201MB2311; 31:IGeK2HvSOIsdUIbbe7wkNA+flMOB8leNaPdxBzMtDkjjqrQ5NF8fPsGkUopJv8tbVBNrfXQYhkzI+I0cUtTWffpYAbqzCDlVsijvezE+Rl67aEw3LJOAvJV0Je8a75RCq8SbpQwlocRWiGV41yitzSiNAVQq9e/5YEIgqWj2It8hWUSIkOQdh9nZk92tvRa4FaYEoBglWNO27JU7gQuHxII453nL8V8dseU3ucZ5BL4GOOXSOjESAR/qL5CU3CM39Z0+N79oIbsqbd1nax32ijrddOSIFLuFmla01jqtiTw=; 4:qDYUKpwMEr5stK1SDBmjxxLoTJaZgDvSU25bXQZig0uwESrs2mIwQrs3oMETAyo7g41unDHDvjHGxZvvNSJxES4+or5Xk441KlKPWK4jGFB9q+5NUWVUXLdXSwxGvskxtUWFdlC7Nq726on27nQvsfoZpj0y6rHIYcjeDQVsHmT7V2YSznbPGlUjTz+iM0M59K86dHN6joqej0WL66qd1FFgiKGsbxLQiIbvokvTlffE70a31NMAHepiUAEye5IWllGPXcryAKEQsHlnplVVrfJgf01u3nWPWqGw3FR5MQejSqyJEcMk9Qil99ZlBo7isU4LqDLyAfkW5qjKHxBm/GdypiHMxwL2Ih9B4tfzuXakq5Z9EcKJ180mxFUdnJZz5HhCSOsPrIcI1zhYp0yOrOCuGVHtJNhZtG/2H8DoGhjY1yL8J+BmiH75FbFKYlQF+IEB3jomT97ExWdUbjbzl0FvqPbvt1NMgiPL60IHRq8u4aatEndveN/l4pWbVW2QQipPF5lBs83grZ9n8JCW6A== X-Microsoft-Antispam-PRVS: X-Exchange-Antispam-Report-Test: UriScan:; X-Exchange-Antispam-Report-CFA-Test: BCL:0; PCL:0; RULEID:(6045199)(6040307)(6060326)(601004)(2401047)(5005006)(8121501046)(3002001)(10201501046)(6041248)(6061324)(2016111802025)(6043046); SRVR:DB6PR0201MB2311; BCL:0; PCL:0; RULEID:; SRVR:DB6PR0201MB2311; X-Forefront-PRVS: 01334458E5 X-Forefront-Antispam-Report: SFV:NSPM; SFS:(10019020)(4630300001)(6069001)(6009001)(7916002)(199003)(189002)(4326007)(106356001)(305945005)(3846002)(2906002)(230783001)(47776003)(6116002)(7736002)(2950100002)(6916009)(2351001)(6666003)(105586002)(33646002)(189998001)(5003940100001)(74482002)(97736004)(8666005)(66066001)(92566002)(7846002)(38730400001)(36756003)(81166006)(50986999)(76176999)(8676002)(68736007)(50226002)(50466002)(48376002)(86362001)(101416001)(7416002)(77096005)(81156014)(5660300001)(110136003)(42186005)(7059030)(42262002); DIR:OUT; SFP:1102; SCL:1; SRVR:DB6PR0201MB2311; H:localhost.localdomain; FPR:; SPF:None; PTR:InfoNoRecords; A:1; MX:1; LANG:en; Received-SPF: None (protection.outlook.com: axentia.se does not designate permitted sender hosts) X-Microsoft-Exchange-Diagnostics: =?us-ascii?Q?1; DB6PR0201MB2311; 23:qY+YaBNExSYq4wkJ7Beoc3HkfUUMPADLj2ShlDh?= =?us-ascii?Q?PDPdV6m6O5o5ABDNe39eKWQu/YgsMh7ojDfIUjXclVViBZKdIPuufWGQ/Lp7?= =?us-ascii?Q?Ga4wCm3wT/KQGu9Y4rHYIUFFTat1Du6fxW0Wcxl7aN5e4kqDQ+iq8i/EAr+4?= =?us-ascii?Q?ExFuN3LV/EftrD4zJ1MGqYO2uJcFNIeZuge3TSW5lRH8FkCdOQssdOXJMGou?= =?us-ascii?Q?dGpYP7yUFfYZTfdx9YDP84DF3aMms+5nGNzUGWwKqkopmEGhn26qeDcWkbrC?= =?us-ascii?Q?6zR4rB0BVgFrvGnGW+khQAO0qo5Q2mfD+E+USjJx5QQYtaDHWJ55c8YI2Cyq?= =?us-ascii?Q?RPk4NpG2j4rAAn9l+I4WSTbXDW+Z566MYN6cryLGJBXqU/NI2k9UQGFFYrMB?= =?us-ascii?Q?8b6gvmDQ5CIbeBBDAhiuDj0NTsUoBWJHjM8Cm11pRJhNl+nOUyibcOygPVFt?= =?us-ascii?Q?FU+psGNnyATFXtC7ouk1H/jrLY8ydv06giJ7vcDPALWv0lCBikte/jSjN9ff?= =?us-ascii?Q?JuqwnFQCB8lvumFmLS5mp+w3ea1RrmINCIIDYRbkxEFljmRkNSpAKu1RHeGx?= =?us-ascii?Q?I0YdfyeFwrDzH0gNWQNEBZFUekYK8gk2le/hBZ53q89t5mVdYSrS5RWwulJ4?= =?us-ascii?Q?vjfvn+2lECnas9tjT9ZaXZttqUAvtarei2JzYO/3+BfIeT6ruAVyZoZkpRVg?= =?us-ascii?Q?Gwwk6N00KrxjLOmIKw+10G8mC2PKA/uj0AwI3oyN4r2DSi/OhHwJ65BSGb+V?= =?us-ascii?Q?sX0a85/n3f6J9xxC+EWc7SKyoX0XGgyACx+jZ7oC5kkjjLAVxuMXB2iSAFwL?= =?us-ascii?Q?hUPtyI7dOm+cWWHkhQ/yp4LJDkDGco6QwFzN8Dr2PIYLXpboTPOTkzDWe2lM?= =?us-ascii?Q?+ArHnXtczjJyuifUwrpKYSk5ums2U5FX39uxpmcGCjXTk+yicR3TtLm6gQn9?= =?us-ascii?Q?TL3+TYq8eM+m/5R+E8U8V+bZLpgRu5GFg9EZfco2TimynH8dL50TESkSCoFp?= =?us-ascii?Q?7bo2nYSoZ+50PwQsMUsmvfEjhd+rf6eUqXcTalI4nuOiFCX4O9DTifT6VzJy?= =?us-ascii?Q?uNGqjhhMOuIkO73fJD0YTZTSvhXDgEnDGGKagMDfKFLiqBVXiruUCH4HgnEV?= =?us-ascii?Q?Y3qmfFXazOUUvklAfU0s2/J/ken0jRaQr3JLcRKWbLSpm47ZXuz+MCg=3D?= =?us-ascii?Q?=3D?= X-Microsoft-Exchange-Diagnostics: 1; DB6PR0201MB2311; 6:pDZGJzjmM+DAlOjF4R6NUATczMSuFRKLNHnO3CDaeB1dnV4VjCkq4L2U8MjI3nqmnipI6N03oyzuxY6JaiFWgj18i4UOcGUVw8p5s87FJowsUBVgDt5cCidPtnealXuDTqBIi8ajXS0y1fWFQ5a1w/X0KKexUbp1Oo4gtLchzcWQrB55wwkfhamIgxb1BAO6xnZ6CA4usOcw2cUqS7bljL8Zf+pJzfBlPQlJuBY0fcqmEZjWtR6VBL9NAj6tRxWUdYV8i3MKZ0BHrPmXZEGfYwpEAw8e809oVcR9AwfH209TTfCZ9/sCa8Od1T5EXaSjUCr9IUzQY1MdA2xj5jYA7dG3sH4jAMlpCh4xY/foGUc=; 5:0ERAyh1I9xNlWCs7kyBAglS+8RpoMdEdmOes0j6XRhqWUNjeyzU4eRfdxAA/TksZcw3Vp8vmTozjJmZXDPRR7vVbx+/GuCAxHapO7/R4FRM8OwXurOvRvi2+lU+HHNXdKOfCJn2s4fR3NZax+uSZrA==; 24:LYlrN8hwl7HqrQqNYl8giMQPPw5qQqsAJ02sD3Ur/1NcQzhsKlnYKAagldiGml/Z8ikG39CbVrVIV3FVSvMMhjtdDf7bVyf6apXCZZnHDmw= SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-Microsoft-Exchange-Diagnostics: 1; DB6PR0201MB2311; 7:KWuhYdGLuboJnRUJ561xwgsyJL4W9AfZWKDV91HYeUaE7p2mPjqRBUdFBRcwaEvBhBEQ3V5hOphCP+y3KLCzGf+YErf7t6kVtSg3cEa53la44SxFQ9nGtuFT7Bqw8nv3xXPOxBsHpbKkV3mumrRi4wLo3xxmYrLE/iIGGmuBi4KX6St7OPjD6wkCD6mllPuMW+EFoD62dbFWQqeNhjznf5nAPAbXA0hCv79xfoUIF/Dgjg6OVWNpvwg/sEyIiNMatHTGlDFPiMZdEcbKiTZsR0wMNeo6WxEweeeljDGuVL7SpaxmfBBJ9s8MVyFVdvb+Hpxhq03TEXFy4DNeXGIeaZPRiisH2S8+kKNTgNCmO6c= X-OriginatorOrg: axentia.se X-MS-Exchange-CrossTenant-OriginalArrivalTime: 21 Nov 2016 13:18:00.2625 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-Transport-CrossTenantHeadersStamped: DB6PR0201MB2311 Sender: linux-i2c-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-i2c@vger.kernel.org Signed-off-by: Peter Rosin --- .../devicetree/bindings/i2c/i2c-mux-simple.txt | 76 ++++++++++++++++++++++ 1 file changed, 76 insertions(+) create mode 100644 Documentation/devicetree/bindings/i2c/i2c-mux-simple.txt diff --git a/Documentation/devicetree/bindings/i2c/i2c-mux-simple.txt b/Documentation/devicetree/bindings/i2c/i2c-mux-simple.txt new file mode 100644 index 000000000000..decfd742b297 --- /dev/null +++ b/Documentation/devicetree/bindings/i2c/i2c-mux-simple.txt @@ -0,0 +1,76 @@ +Simple I2C Bus Mux + +This binding describes an I2C bus multiplexer that uses a mux controller +from the mux subsystem to route the I2C signals. + + .-----. .-----. + | dev | | dev | + .------------. '-----' '-----' + | SoC | | | + | | .--------+--------' + | .------. | .------+ child bus A, on MUX value set to 0 + | | I2C |-|--| Mux | + | '------' | '--+---+ child bus B, on MUX value set to 1 + | .------. | | '----------+--------+--------. + | | MUX- | | | | | | + | | Ctrl |-|-----+ .-----. .-----. .-----. + | '------' | | dev | | dev | | dev | + '------------' '-----' '-----' '-----' + +Required properties: +- compatible: i2c-mux-simple,mux-locked or i2c-mux-simple,parent-locked +- i2c-parent: The phandle of the I2C bus that this multiplexer's master-side + port is connected to. +* Standard I2C mux properties. See i2c-mux.txt in this directory. +* I2C child bus nodes. See i2c-mux.txt in this directory. The sub-bus number + is also the mux-controller state described in ../misc/mux-controller.txt + +For each i2c child node, an I2C child bus will be created. They will +be numbered based on their order in the device tree. + +Whenever an access is made to a device on a child bus, the value set +in the relevant node's reg property will be set as the state in the +mux controller. + +Example: + mux { + compatible = "mux-gpio"; + + mux-gpios = <&pioA 0 GPIO_ACTIVE_HIGH>, + <&pioA 1 GPIO_ACTIVE_HIGH>; + + i2c-mux { + compatible = "i2c-mux-simple,mux-locked"; + i2c-parent = <&i2c1>; + + #address-cells = <1>; + #size-cells = <0>; + + i2c@1 { + reg = <1>; + #address-cells = <1>; + #size-cells = <0>; + + ssd1307: oled@3c { + compatible = "solomon,ssd1307fb-i2c"; + reg = <0x3c>; + pwms = <&pwm 4 3000>; + reset-gpios = <&gpio2 7 1>; + reset-active-low; + }; + }; + + i2c@3 { + reg = <3>; + #address-cells = <1>; + #size-cells = <0>; + + pca9555: pca9555@20 { + compatible = "nxp,pca9555"; + gpio-controller; + #gpio-cells = <2>; + reg = <0x20>; + }; + }; + }; + };