From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1753284AbcK2K07 (ORCPT ); Tue, 29 Nov 2016 05:26:59 -0500 Received: from mail-db5eur01on0108.outbound.protection.outlook.com ([104.47.2.108]:56669 "EHLO EUR01-DB5-obe.outbound.protection.outlook.com" rhost-flags-OK-OK-OK-FAIL) by vger.kernel.org with ESMTP id S1750795AbcK2K0g (ORCPT ); Tue, 29 Nov 2016 05:26:36 -0500 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 , "Jonathan Cameron" , Hartmut Knaack , "Lars-Peter Clausen" , Peter Meerwald-Stadler , Jonathan Corbet , Arnd Bergmann , "Greg Kroah-Hartman" , , , , Subject: [PATCH v5 6/9] dt-bindings: i2c: i2c-mux-simple: document i2c-mux-simple bindings Date: Tue, 29 Nov 2016 11:10:42 +0100 Message-ID: <1480414245-14034-7-git-send-email-peda@axentia.se> X-Mailer: git-send-email 2.1.4 In-Reply-To: <1480414245-14034-1-git-send-email-peda@axentia.se> References: <1480414245-14034-1-git-send-email-peda@axentia.se> MIME-Version: 1.0 Content-Type: text/plain X-Originating-IP: [217.210.101.82] X-ClientProxiedBy: HE1PR06CA0051.eurprd06.prod.outlook.com (10.164.28.147) To AM5PR0201MB2308.eurprd02.prod.outlook.com (10.169.243.7) X-MS-Office365-Filtering-Correlation-Id: 431e75d9-5b3f-4762-1569-08d41840247e X-Microsoft-Antispam: UriScan:;BCL:0;PCL:0;RULEID:(22001);SRVR:AM5PR0201MB2308; X-Microsoft-Exchange-Diagnostics: 1;AM5PR0201MB2308;3:94bbLqlNwdlpwjeOOIFc4IcfMV2LWyFngjjpvup86UC39PnAcmPlAuCa31FS+jWMGtCmlfihk0FAaEeNMs1llSAwjsWVNH1MK15QHGZN9wf1/nxgQahCPrz4unwWy3PaNojfNjTi0YO+GzFw5PnWpwlk7kHP+pBqMdziWT1is9GMUqr9grfjVz/j3QBvz1S9sAJhwLWjs2N7FlbYOBdQA/XgSgAjsnfrLapM1FTHw1I+TyQ6BaNOaKtJpbiGBYtlSBe8OhEBi9LPfBgEjp4mlw== X-Microsoft-Exchange-Diagnostics: 1;AM5PR0201MB2308;25:L7bKoDcN1e+JgCyX2X9kXEwrkWDuJSboMDbw6bTHfDg83e6jWxal/8jMsmboHeyYLHujLfkIBjjxVR0m4KbApKJkF23CIlIdOG/n/cWonPd2OLpo2tH5sL2EYSGbRBlryPOgfQ01BWGGih3ONFgpUdcBTUTSpxmnof4moOmBUGDe0UbqPLDQNHQANMrnYzFMCHoyX7HFXxw+R7Z/hiWjTQ4Pls46BGtQNE6HhIl9IEGPh+tkrUzHFcI+hunMDMDV/DvXksEpiJ7UIq2U7zCrFjRUuC2c2KZUlFzYwik0De0v4/3KHQhNImZxpOQ7GzmazdYCY6aXjzfxH+8ol/S++WPMkXuaTWFyDakiXmziZaPU38WY0j38KLO9oZVSH9u9EyakfTKBcd/jEqOPxmwhVObgJBmjg4AnjqKk7iN8RRAhGoi//jo4CoEyMmJxR7G1YyO2kPSqY+hGj0kwCXW3IEriTlF+Z3KnIKLtFK4i6H8M5LTcDdRzPsRmYgCjkER5Lxy1BoNs0gwLipBCl1E9LOh1c1bYeYVjwZPgWUveh0a8G0B86pR+eNNJ+BKqcYOiNHowd4dgvU+1h8et6IZbOK91Dy74/ni/VWDcx9J7u0nDwvUx54KAvcPNFpQnDqd5mBTCxYUuGSXeHfPIcp406/xqRzWF3dur+xFEWOLfHNJfaGdkAeargmL7qdvoFrfHtBJXQGSamve0R+SFQ3G5MZsHiJMEg4aa3VqwqH9+GnekEbTVcMjSM1XhFFHz7dRRcsOB96dBcqixe0lH/QW+eA== X-Microsoft-Exchange-Diagnostics: 1;AM5PR0201MB2308;31:8RIzcuTyqt2SSIqDCHkHhK/7KJ/1bIg0lyQkIPZnMik3fqLSHkfk9u9aXyT2lTXLr0E/FoFaurTgqXPuHGRhvo04Uj1nwyb7tdxpLo7G8F4pWlS+CuQznZHxobJL538QEF1hbDPhmJ4d+LviQsf3ybTHFE/OqEC9kP+xWMaHkNZpuOujRtyaHC0ppAvJMB5zo8Uo/THF+neTuKJ39EacBUQ+yemonKx1GZstrPshQptf9GU4LnS2MVc3nVXDYN9t0Uzg/z4/xPxmYwzHa+Gq5g== X-Microsoft-Antispam-PRVS: X-Exchange-Antispam-Report-Test: UriScan:; X-Exchange-Antispam-Report-CFA-Test: BCL:0;PCL:0;RULEID:(6060326)(6040361)(6045199)(601004)(2401047)(5005006)(8121501046)(3002001)(10201501046)(6061324)(6041248)(20161123562025)(20161123555025)(20161123560025)(20161123564025)(2016111802025)(6043046);SRVR:AM5PR0201MB2308;BCL:0;PCL:0;RULEID:;SRVR:AM5PR0201MB2308; X-Microsoft-Exchange-Diagnostics: 1;AM5PR0201MB2308;4:UMw+OPLVTlPWke8bkXDIrdiINM7fgDrK80BOTs7/CckpoXdMY7Hq3xlE6dNCjjQthXlXiiPNSEN9nOER/I3wRwnHEYXkAA3STTaoQLFh9tSrlSyBbsTHMaxh9+Vhi2hOQj3NTKG7I+MkLXBBe37IGeBzwSZsvapbYI1uhkaEzUJFoc9CF1yY7VJXzVnOg6obMeh3eaV9QOKe1BV1R7l8QOKKetG47llod966GQryauQbCgItybk7305QhT2DZHdrPkY8+mI+3Pi9lXDLwSw090wQQQNoLk/k1jjmJOAbh3IDh8arTSAwKotCw0b26wnnIhZBlKnzL7eeTkAG/n1OcWG0tjS4FK3/dos6AHFIZ/tAFHw67yowqTXOwYc1Q9uD1cR6cZ6TKt17e2CwHuOqvrfo43/DzdyYtxcMQBZopbcd+oBTnpE72gh7RN4Dwwj2GYFm99aRpZyA5yMZX7BVegDXyfVrizVIxSHUd4aAM17O1kUlGh2y7NLP5VdEzOpk/qd7cz6z2K8BFfmOC2ABBc7zBLTplNkuEZ3QEjOPINYKcirf2DVBYZ2xk+WBfa6htXeL+7Nl1Jhe+PN35nujweBVcoTjDkT7FFivyO8f8ZJBg3HiknTi5OieGoksFyoHl+C0Wa2L/cHsBvzmRmSyCJyz+zBII5icwFiMmZm6v+w= X-Forefront-PRVS: 01415BB535 X-Forefront-Antispam-Report: SFV:NSPM;SFS:(10019020)(4630300001)(6069001)(6009001)(7916002)(199003)(189002)(39450400002)(74482002)(39400400001)(39410400001)(8676002)(7416002)(39380400001)(106356001)(86362001)(42186005)(50466002)(48376002)(101416001)(6666003)(105586002)(6486002)(733004)(6916009)(5003940100001)(50986999)(2351001)(81166006)(81156014)(8666005)(97736004)(92566002)(6116002)(36756003)(76176999)(2950100002)(7736002)(189998001)(4326007)(5660300001)(66066001)(68736007)(230783001)(50226002)(2906002)(110136003)(47776003)(33646002)(7846002)(38730400001)(3846002)(305945005)(7059030)(42262002);DIR:OUT;SFP:1102;SCL:1;SRVR:AM5PR0201MB2308;H:localhost.localdomain;FPR:;SPF:None;PTR:InfoNoRecords;A:1;MX:1;LANG:en; X-Microsoft-Exchange-Diagnostics: =?us-ascii?Q?1;AM5PR0201MB2308;23:HUXmrERyPwrFeZKE72HYKIHHJC5uYj1MibTJmC9?= =?us-ascii?Q?n/yEWfywdeAd3mbPANmNjidPwO3z+InL6z6vjTZDwB53s5WBvrIK0jw/E2U1?= =?us-ascii?Q?gBXyTCWJr61kLHHsA8p2zAQCilX7GdoXbRh+AOFsUvj1eBIgusmaDsCme9Rd?= =?us-ascii?Q?bbhvKG3LLhtHoe+Yu69d4E1K5eusIsc58grefycTNvmxN+N9tt6mPdqkmYo1?= =?us-ascii?Q?SgBj1fKssMhLWJeHqG85ss72qWZiYEbHkYyr2hW5n0ijbBwKVXrxWAVIhSxk?= =?us-ascii?Q?sgEVSsNV9JLJ4KUWWA3SFJLFHnApx5GdK5HhceQXavYfF6JUYf+1IclTNz5I?= =?us-ascii?Q?BI5frypcdNXniKpnRzKtUD6OceEg6d5tlba2yDpabUvkkZ1KooE7iovxvnU4?= =?us-ascii?Q?QVDZx9f0MTXJsuUoPGu12lLFWsykSxIwm3QLTR9+iovDJXZIN+gm/oA2O5vU?= =?us-ascii?Q?RAM8/uIEouaTw93ustcHQ4aZxsLVIFq6qDxUtE2eb0yxmyUPyaFpUVUX7WIJ?= =?us-ascii?Q?5BpurNFdvObG2fx8nyBgHeytMslusGvS6PnicsGVkKiQR9oFiXYdRSm/iFK1?= =?us-ascii?Q?yhOjDzzIU/dmPOpxe7TOGJc0zN/NKd7m4DKRwtZeIL3evvX8imB8DNfv/sc1?= =?us-ascii?Q?gNFFL66y+wmR9HNt5s17o3e/33W28Gd3bRs6p5Q2S5sOi4/+WJvpKplgrx03?= =?us-ascii?Q?4OeLa0YdN3tPVKxYRs1mfgiD9jovdmSlgQQpLBAZxwnacEICEOQgXp3tHWmx?= =?us-ascii?Q?Oxsou6aYmN2UD+OxKlbWZD8Sfx5IDdljDtnuEBnrTt25+C2zwwnisWGNz1I+?= =?us-ascii?Q?eQfISd0WfIi9GKyC1VtI/mH6NGWEdi/cpyAk+PwVyP2qTuUmr6jZXhAO0sJq?= =?us-ascii?Q?LzdlQVAMURUux8PsUuTw0jJkAVEEoRP+3rPrmPUTA+HyJCdixQ3yxDfu2efp?= =?us-ascii?Q?h//uvQqtdoKrwbUTAyh+JLMujAAgjXvTv5nBMuu78HKCZG/oV9xZLqdQH6Qy?= =?us-ascii?Q?KRxNQCqkLj2a65fPBJPlBpnyIKxFKDNRR1YVRxuZI3anQCn83feP3gtIbBVP?= =?us-ascii?Q?HBUBbZfi3mZhnFtC1KEQbBtQYCfaoVS7xyaixf/hANldIGaU8prU16TkasRw?= =?us-ascii?Q?gmNm9R7UOcAGP3+6v/V0xHJOkYN5sO5y0mIMchfpZgN+tsUiRr7BTHfKEjY7?= =?us-ascii?Q?50BXuT9fgdvlpUz+wp9sCG4c8oc6/wCVRWhuRD6KOlROERvfJ6ifx0MaZnNp?= =?us-ascii?Q?JsW0LK/8MwW26fAe46Cq93UsleEJ96LNK5RQ+0B2HeWBt88zb6Loo6nQR5oA?= =?us-ascii?Q?okg=3D=3D?= X-Microsoft-Exchange-Diagnostics: 1;AM5PR0201MB2308;6:GN6MKKp+dLPwnS6EhlIpPUTgArQJ8ad05JuX4se7D+S0VilYYX+LJkso/5ivtnXUnjPrpZsZNcnMML80MqmUK9cJPEwsGCiCNlGv6YHkena9DISZgubCKLnOrNir83ogO+TRPFHh1lqgzap9mHRHLutvAhKfR7/HjcuMr93WOcQYi7dsTQ54JKzsCKoTP2FUptS79Oiuk/mNM3Z3+8FWkp3oMZXQMoLCeW7JdiC2cweEZkYnUn4ZSRBUX9+ZH0e65aKkgP7MBq1g9fY1MVMURa6w6r5JETvnkJ7/JwKtrT5eKQT9oT3A/ZVwzkM0iZZY9qxI5aN8CNk3uai9PoA+Exd7AxgZZ15wAJesJ2sNM4a7xk6tiCgoMfCIe2/Av/P1AfDkahPN4Bi2bgXn9Dfc3XbQb6XpogIztxEcPjmUrl/PCj8eUoH4xgann2pWAwBTsCoH36BfheUYYovdUNtdZq8+6F4AEjqml4U8eqbYM0g=;5:UYR9TCRavgAPPPiIWzaJ5IS1n9hIKivc7En1zIdZY9hezg6Wt6MiA0lus1UwK0c/91HzDPMr2v0GzPhc1iszHLK6nI5rENavLCnFUKc1q8yFFpuyQMOxlvO2PxoHGcnWdpSqEdcl4stKC8LNipP9SQ==;24:kmqgA1dXFj8OfTO6FHtZme51ofh8t2rF+TgkfnBNd4syS+dJHWJtX0EOa3jjnJTJIdS7oVQmvwJOlvwTvMcDK65RC+lNTXH+QOg3gbvQTwQ= SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-Microsoft-Exchange-Diagnostics: 1;AM5PR0201MB2308;7:19PgEIN6BGApXoZQfweY3BPXxvLpzBtOeuh8qmUeyRt84RlSlsbEMV1AQ1aKDupvPgOLPc0+pUsl61d+3ZF1hJwqu7wUUG+7tgnOKQcrED2gCNEaPRD9SensHtodehWIFmuwPp+elBz2JV9TsFByuVmzxC6MRgUArbgHZ+696x2CAQ1X664m+NxAC2SgrE55NGLNyeXjyfPvl4nbtBw6Bhcp9SuG6dzNjSMJI/X/6MUccL2szOOU+KJk4F6HjhLIiZUK5Sacm6huB8y/iQsSJKS9yMTBsK2dCSUJdHWWnX4B5BsyxAG1bLDueKB5twftf9sOZs1NmdiCohyrINTOBehwvzUNVdIItlQEm2+0/u9tLHagptl+LTouB1LlARk3c+y0jVbsbOp5Nhvqx3iyuvANSOsncVFH3fsVBpuRpZyDHIZ8zghria4m08IViVpT9pKvXxZjB6iKhvFcZQckIw== X-OriginatorOrg: axentia.se X-MS-Exchange-CrossTenant-OriginalArrivalTime: 29 Nov 2016 10:11:51.8314 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-Transport-CrossTenantHeadersStamped: AM5PR0201MB2308 Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@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..18e023d52933 --- /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>; + + #address-cells = <1>; + #size-cells = <0>; + + mux-controls = <&mux>; + + 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>; + }; + }; + }; -- 2.1.4