From patchwork Wed Nov 30 08:17:00 2016 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Peter Rosin X-Patchwork-Id: 700925 Return-Path: X-Original-To: incoming-dt@patchwork.ozlabs.org Delivered-To: patchwork-incoming-dt@bilbo.ozlabs.org Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by ozlabs.org (Postfix) with ESMTP id 3tTG1L61rZz9t2N for ; Wed, 30 Nov 2016 20:52:38 +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="Jz3vh7it"; dkim-atps=neutral Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S933539AbcK3JwK (ORCPT ); Wed, 30 Nov 2016 04:52:10 -0500 Received: from mail-db5eur01on0134.outbound.protection.outlook.com ([104.47.2.134]:41408 "EHLO EUR01-DB5-obe.outbound.protection.outlook.com" rhost-flags-OK-OK-OK-FAIL) by vger.kernel.org with ESMTP id S1756109AbcK3Ju0 (ORCPT ); Wed, 30 Nov 2016 04:50:26 -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=AFZu+E47JFOdbh5KI5dGgS4jzWWqnelX4pJ7jfkjK74=; b=Jz3vh7itmBH+aUKe3qHJJyl5/u11ZbL3X2QjmkoeEUgtwOLjlZgmyLKFniLh7FtlDS0C+AsKutzyZMBhanRFUSbsQr2wiHmv2EF6XN0QP7nympRPnUq3qXAik6zEJIZ8pq9IZB6vT9FCBjGIGpGFr/hjHtrFvFpsxKKDY44BcoY= Authentication-Results: spf=none (sender IP is ) smtp.mailfrom=peda@axentia.se; Received: from localhost.localdomain (217.210.101.82) by AM5PR0201MB2308.eurprd02.prod.outlook.com (10.169.243.7) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384_P384) id 15.1.747.13; Wed, 30 Nov 2016 08:17:49 +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 v6 6/9] dt-bindings: i2c: i2c-mux-simple: document i2c-mux-simple bindings Date: Wed, 30 Nov 2016 09:17:00 +0100 Message-ID: <1480493823-21462-7-git-send-email-peda@axentia.se> X-Mailer: git-send-email 2.1.4 In-Reply-To: <1480493823-21462-1-git-send-email-peda@axentia.se> References: <1480493823-21462-1-git-send-email-peda@axentia.se> MIME-Version: 1.0 X-Originating-IP: [217.210.101.82] X-ClientProxiedBy: AM4PR0902CA0023.eurprd09.prod.outlook.com (10.171.89.33) To AM5PR0201MB2308.eurprd02.prod.outlook.com (10.169.243.7) X-MS-Office365-Filtering-Correlation-Id: cebb80f0-1eb3-49aa-d7d2-08d418f9602f X-Microsoft-Antispam: UriScan:; BCL:0; PCL:0; RULEID:(22001); SRVR:AM5PR0201MB2308; X-Microsoft-Exchange-Diagnostics: 1; AM5PR0201MB2308; 3:JFTL3yKsLRigkQeegLJXny05UVnqEjuXgQS6mIhq0uBR1HtxmlWFVhyzprVG/thlBPCk6rWnmh8T5OYLewLRb2kEk0HTvl1wIghyQon4rmCVz0GL5Ayqu57DHFdlZStTO6tMXy/IY+rrgWKPl74eYF4vlI16WCeuUy8ArClPnwi8EZEimWeRos8z6KXUeNhsKqc7hTGwsmvDJSBaAESxaAFPeYkaSNMnLQ1tWhzAL9/a3gayJIz+JnZDFnkDshi62Aiff00ALwtO8mW8xW5F7g== X-Microsoft-Exchange-Diagnostics: 1; AM5PR0201MB2308; 25:10+cEsh70VF23GpjAlmjr8s1xxkYEKjbWTeOdw9QrpWQeoZVcQNyZ++WNVWewltbdo6NyW5uP/0DcqRy1db2jEpllnAF73KQ77fUnYdm68u6+4TmScoESa+TdUROb8ma6toeSXzZvW2Q/9NlBV3X4GsjYlt+E6AnxaJlnKd8qcJcFlnUj1uGl4JlKs8yI8LX9i0LgfFa5L4i7DBjmaN0am6Xb+ORlsurSbxfgPqx21X7vVE4JAfx/ZtzZYMFTcjHi6WZ7M7X4OBv7wpgYPvA2gNR74D88u6X/YE7OAxDI048SGoKT+STK/1uCaOz/ZsOB8555A4IWvdMv0KDYTPrB5UBT1+yw2jDjzQu55NTGzgTOS7Y7onaFZASMsmjt6yEQh9aYR6fdEWGhOuTzfzbhKHXue5Tz/tkTCKK41PiprUghcjY13w7OLQ+Bq3eKhm2ggOPtZ7PdvkJdkxBclmi/1GDoZdm6ODaL2AWmrPusOPLMvA19IzV5wnR8LxGfeSQKZ0jDaK9lyI08CBlVcXgGO1MV6VK4pThw4tu8NHNTX1nD6Xfo8fY3whtJUztksCN5OOfiC3ayFDIuGnLCTfLkHZO4gFyKm7b5OjnYnBDuF8n0vuuWfnm9196YEFCSSQH8pSL0EkhRLRaOi9ZTV6iMX7ryt0Mrm09GyFm/pgRBSbUczVyGAaseAx+RysRk89b8EL7BKQykZ0mISP6v+ygJOIS9y/IjTtuy77oX1rIKIO2Qm/vJ2MRn3XaN0VJd3dNvdp0Qntt1eO2dnhZAjDd7Q== X-Microsoft-Exchange-Diagnostics: 1; AM5PR0201MB2308; 31:r2sNXruliz9D03I+p7whNFAmJ5xAiXqcZ6qXJyfNZXtSCZGST/zZfLpAcoQB1tpBW44AvJ35Tk+/GrWJMW5MIuwHA13qDoeBTgQK0wPObC9K0pyXQGgiyMnFWmBwMG/DGsO16PADoaUiJiHNWo5gS/0Zlhb5qldHecjJD8mMwYXXH0muNh1orwqtz2+WRbVGzCP4KNaWV3DqnU8zMgaclhdJp1ZDdOTGtUkvithgEXc+FEbQ0WmdBq2pHBDFXWd4FgL75IaJVz604faM355FPIAeCYnH/it1vAUziMp2iFS8dU5NAJ9tANyWADGN0ECV 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)(6041248)(20161123560025)(20161123555025)(20161123564025)(2016111802025)(20161123562025)(6043046)(6072148); SRVR:AM5PR0201MB2308; BCL:0; PCL:0; RULEID:; SRVR:AM5PR0201MB2308; X-Microsoft-Exchange-Diagnostics: 1; AM5PR0201MB2308; 4:H4wZkdOjpinqEj3KdiG2K1dlM3gVA7xZX+SnraRk62j1yZtGFOeXZ5I/2tWkrVHt4GPZT1jktp64KIeUKinguo5WQNzjLBEj+Gik+bR2oIC9LSnQl4GQNnKe1+CMCb/6kB3+bNMWB0voPjMC9QxqSqJ0qtNVV0VYi8ivzy7rduiHwaa3+yJPOPJadaCpQfS8RCj7Zn64OnoxgOdoREvhzxxiSnpWA5Nepz1G/WgCOsuhc5AGmfqa1XoDk3v9Qz8fiRJ+VEEnhXBIOkQelGUhAwGIBXbSZY9IX1uKiM5eTwU825jGHuRm0hR6UTfjWXNs5+1R1houVx2Nxv7tS5ce7j9BoUqp1VM0091Npo+AEOGqb7Eb71wY5DoEwnFWFgvaSIqWPeNUrmPhonCVdSzKV0ougC3mLzr8Qf3CRZKPrxCvJM+NqUyGXcW5lPia+phKEt8yxRWzp3wyRi3C1QH861h2GW5vXJ3WdN0oD3zkDBJY4ovE5kciGJ7sdK39oyVUCDnP+bZn09IPC03iKeJZiL55zi4Pb9bU+WS7Z9Rv77WhEcUQMctIL6PhRWTkNFVF05vt35vR9C3pcSThD1ki0xGfBOdbGSybHjt3PxaczTDiyeklAMes9k1eTlh8pl+4 X-Forefront-PRVS: 0142F22657 X-Forefront-Antispam-Report: SFV:NSPM; SFS:(10019020)(4630300001)(6069001)(6009001)(7916002)(189002)(199003)(74482002)(8676002)(39410400001)(39450400002)(7416002)(106356001)(86362001)(42186005)(50466002)(105586002)(101416001)(6666003)(48376002)(6486002)(733004)(2950100002)(36756003)(8666005)(5003940100001)(50986999)(81156014)(81166006)(76176999)(97736004)(92566002)(6116002)(7736002)(2351001)(6916009)(4326007)(66066001)(50226002)(33646002)(189998001)(230783001)(5660300001)(2906002)(110136003)(7846002)(3846002)(47776003)(305945005)(38730400001)(68736007)(7059030)(42262002); DIR:OUT; SFP:1102; SCL:1; SRVR:AM5PR0201MB2308; H:localhost.localdomain; FPR:; SPF:None; PTR:InfoNoRecords; MX:1; A: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; AM5PR0201MB2308; 23:RjKbtgRAOoHswG8Ff6YDCz/S8X0Ccxjji5cE+hF?= =?us-ascii?Q?plgIn0BQysRbAtCNKGmMyVthnK+1UQFq52gq1326G5LvYPLDA6vc0jhqioa7?= =?us-ascii?Q?xXuJtWiuUu9m+7mg6it2r96q4nSc0SjhbPPa901CcHPWlLEh3R/0nFWMhkEl?= =?us-ascii?Q?uakKNP0qmQFbJYGmvXk8OmwNsjxS+ucNiKTBrhsusBMZzMo0ap4ZC27QwKdC?= =?us-ascii?Q?3JyVk8RQ8sW0qwkcI6tS6r2tJ8EIdxx8zrJGGlHSKQ5Tu4j2ufsXcVbv0eGB?= =?us-ascii?Q?sYKbQiN4zmnmQwTWHZwRPfWLJV+tHOKG9w9D5B+RaunVfQlkYoIlUDH3nEZT?= =?us-ascii?Q?y472GBLrSZfk8urLAxZ8z1n2lrmpHWxPECJMysl9bQZXJZknxX88YsNJKiAJ?= =?us-ascii?Q?2ZhTky857nMiHn+5/PXKu68a754cvcxVjugPfWcJxa/aH3O8V95cZ0mTKXgH?= =?us-ascii?Q?q0pub2mrH020oujS4TcN3c5HaVG1x8+CA/3IZI+CMmcqkxfsQ1Hdecpy9ES5?= =?us-ascii?Q?6+y8J6szBNwhNelew6+0vO2N9Y+Nq1tFx0JVqSiaYN3bNEJFZUMDSWra5d1z?= =?us-ascii?Q?5BRhaYrCwnvljWsfIMIDaXzOZqxLLciWFSflwLh5pnzpYjS4IAGB6JQssgKg?= =?us-ascii?Q?gh0/3u2G0VV/hd11aT4PFYjU8HIU1VXvaBSZaEEQkOKTIkU6IX+Vlq5SoRje?= =?us-ascii?Q?0BN/HrI/SkfcyO1ZyDQSbPwoQFQLJig649NKuqfQRgSaX4x8J0uNZTY+yt8K?= =?us-ascii?Q?z1NfT91ZTzTkZDUV+MWc7dbGchZAZNRjpXyPUSu0qQdKumPvtGUZWmLpJCFW?= =?us-ascii?Q?fdnl6xv/UAYSF/GE6ce+7dnkzpS+ltfY7g3IhL/TCbCYAmY8rHH6w6Vre7BD?= =?us-ascii?Q?ARit08oQLtKxGB2ptZ26Rf/hCQCQUaIrg60tKBEzE+DQh6xQZkMM7lZ6OLYu?= =?us-ascii?Q?gKitZqoZYI9sDtDLkGFfsMh2Orlhz+yLgMsLj5MxQGVTUyqLBIN7aOTfrfGV?= =?us-ascii?Q?tbyH5Qrv32PTZij24ozUAMRjzVk3wUFTH8xuNd6z/+PQGEvoBeCmhJSMCf/e?= =?us-ascii?Q?JgVZGH7moBigyN59/1VY3vrgEr+WRCkZ1vtxQD4TFGRAP83i0r5MJAOiGg22?= =?us-ascii?Q?LjhyTKxvfp09VZQTQnY/wRz6FWosn5Wwg5b+nSkwIYtQExC8eq+FkpBNuGr4?= =?us-ascii?Q?M2jr88B0HYSPldMZ0pwTo/CDTnIi5iHr3VANWVU1h41DkIPna7v4wVkyaww?= =?us-ascii?Q?=3D=3D?= X-Microsoft-Exchange-Diagnostics: 1; AM5PR0201MB2308; 6:cZG5+Q2hy2XlwY/w34PjAjRWQ6QYObyNp4fKfWLB5XiSnWU+9453hNjIUe0BYAjrWdP0V5HQ4lZpNG9Ka9YLapSPQFb0Uhnv9DN6ebiW8ouYTzIxzXncu0ZE8Pw1uIoutz1xhl8qu9rX8uS3qOhw/KHVhJRPjRnMq3Q4xyxfxKoOqHCHEM7PHPiS1VcvwnbKMUubGgLrkaTS0JzDg3FMy7rH/zo4a4fi8eOTvNej0PTJeBS1kSPXX+xDAltFTHkDMyVcCByLpU7/g5u/lK29CuVjBwA9KsjrVYM0UD8NIZ3TFECAOIppUySfsw/F+X9lJfCyoAtxzycDF84iWbiDxVPNh0B/9xZubrpM2TBAMCXmSBRI59v8WBLViLHUY9E2rp6jfWbmWuAGAosZfdyIs8QCOSxkZTPhHrNV2Cz7kCiIUyKsT+wLVdldg6AyCnQXnQkG8gSn9MuqMMiVQrkZ5blZYI8hSQwSgmdXjnU9rqA=; 5:jF1HMtOVHB01rcM33NUoY4jO4vzalI/gCbkjM3CJXrE/07Nej6bNqYaZOM3BkkthgQ7zKUFeT5/icFQfzKQ0QJrJvWdiQTS3kftP3/sNTYgZQLO4VQJXerV3jlsrn6aWAJLsYoM7WbqCmoXVwM7dSQ==; 24:/rgyHA9jx85h1M9YR5Kq74SHrWBJg6XLEy1HpsgZdOC2mVLQfb6kurSN0QXAa/+lvFb4lkuI1wI3TOIEekh5FStM5pljKvbkymD8WWmNoI0= SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-Microsoft-Exchange-Diagnostics: 1; AM5PR0201MB2308; 7:9Y/0hIFyAj0lZxhv5iVwOxRwLn8bk8BAo7YZUbwMIAqoGPnkU5BsZuiUYaeSj+ccDazrNKB5ui5iJW69l4SAG+X17os+pM+huq401ix/x7kp0HnpGWyv+1/aXgKmQdYBJklL1qxzA1W6GrWRKSLW45Z7fME3sN8H4TIGbbZVn2ahXnPo17xQgiBpJFT8rCYeF0OprMVVs6wxsZaFNDp4v9LWxug++BybGNJu/cUMNndyZ49/SOOV965YsiYhq0Z4W83Z8xEvCBrU62zcaZmvKX2iq8vJ4mH56cATu88RFz11G3JPPH4i3/KKwISvK5/GoODPfKVErmJkF3YrC3ngAkLDHNx2KiL/Gz20WvfK9hxxuQBJSi/myaXYCsS/RdsDBrTnciifCQr1O20hLS/crRzXGPa1vaojkMTaFNFUUr0mgOIvskhHozzlsr4I8yBIthUzP95X7wdjy2Q/xQQxxw== X-OriginatorOrg: axentia.se X-MS-Exchange-CrossTenant-OriginalArrivalTime: 30 Nov 2016 08:17:49.3153 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-Transport-CrossTenantHeadersStamped: AM5PR0201MB2308 Sender: devicetree-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: devicetree@vger.kernel.org Signed-off-by: Peter Rosin --- .../devicetree/bindings/i2c/i2c-mux-simple.txt | 81 ++++++++++++++++++++++ 1 file changed, 81 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..d32ebc9c5639 --- /dev/null +++ b/Documentation/devicetree/bindings/i2c/i2c-mux-simple.txt @@ -0,0 +1,81 @@ +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. +- mux-controls: The phandle of the mux controller to use for operating the + mux. +* 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: mux-controller { + compatible = "mux-gpio"; + #mux-control-cells = <0>; + + mux-gpios = <&pioA 0 GPIO_ACTIVE_HIGH>, + <&pioA 1 GPIO_ACTIVE_HIGH>; + }; + + i2c-mux { + compatible = "i2c-mux-simple,mux-locked"; + i2c-parent = <&i2c1>; + + mux-controls = <&mux>; + + #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>; + }; + }; + };