From patchwork Wed Jan 18 15:57:08 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Peter Rosin X-Patchwork-Id: 716719 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 3v3XC745F5z9ssP for ; Thu, 19 Jan 2017 03:16:03 +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="h7Sp7yIs"; dkim-atps=neutral Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1753808AbdARQPr (ORCPT ); Wed, 18 Jan 2017 11:15:47 -0500 Received: from mail-ve1eur01on0139.outbound.protection.outlook.com ([104.47.1.139]:9152 "EHLO EUR01-VE1-obe.outbound.protection.outlook.com" rhost-flags-OK-OK-OK-FAIL) by vger.kernel.org with ESMTP id S1752232AbdARQP3 (ORCPT ); Wed, 18 Jan 2017 11:15:29 -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=0SFjJjxEZbEqxBX04I93bshV89U7uhxP3qgfgLprikw=; b=h7Sp7yIsvXw4kjH22sJxkMvNNeKqO79HnzjXbTeRkirJK38+SQr0+4ATilbGIeF7x6zznk3AmHz51RgW/fBq1VYmcTNSv+gKXDPOQNd/xAAuCXVkHg+D08LcFZzJKmF4NSmBclD8SNy5BUHCkQPOFHsfGuH+my98LXjvWHm8Qe8= Authentication-Results: spf=none (sender IP is ) smtp.mailfrom=peda@axentia.se; Received: from localhost.localdomain (217.210.101.82) by VI1PR0202MB2558.eurprd02.prod.outlook.com (10.173.79.137) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384_P384) id 15.1.845.12; Wed, 18 Jan 2017 15:58:34 +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 , Andrew Morton , , , , Subject: [PATCH v8 05/12] dt-bindings: iio: io-channel-mux: document io-channel-mux bindings Date: Wed, 18 Jan 2017 16:57:08 +0100 Message-ID: <1484755035-25927-6-git-send-email-peda@axentia.se> X-Mailer: git-send-email 2.1.4 In-Reply-To: <1484755035-25927-1-git-send-email-peda@axentia.se> References: <1484755035-25927-1-git-send-email-peda@axentia.se> MIME-Version: 1.0 X-Originating-IP: [217.210.101.82] X-ClientProxiedBy: HE1PR0801CA0032.eurprd08.prod.outlook.com (10.167.184.42) To VI1PR0202MB2558.eurprd02.prod.outlook.com (10.173.79.137) X-MS-Office365-Filtering-Correlation-Id: 912c43bc-c2c8-40ae-295d-08d43fbadc3c X-Microsoft-Antispam: UriScan:; BCL:0; PCL:0; RULEID:(22001); SRVR:VI1PR0202MB2558; X-Microsoft-Exchange-Diagnostics: 1; VI1PR0202MB2558; 3:NUEOCx6FVA+Oo69g4ZXC7xhcHSCUHFiXVjHLrb7/fQ/rNC0ATIxgTWzB7V1MsyN7kh6mgtfSPAf2wpCLV/z7odFmbDy+HJK+hQN8I06dj8N9OV/S7iwRqF6j+4BgX6OAOvduNd3erbTpgR5xfvaM3sUPgHRpnSQ87lUYees6JKDPABJxPg6V8RBka+fsbuRx3wG3/Ui8Lu6TIxDOZs7vBAk0UQnLKcngSi9tTMxp3ZMBD4UtJuHXZSX60zlzXMhsn2aHhn2V2lDs56m6xEdZKw==; 25:kiGaShx0OFLVKkZbps81V1hbxiYIfqm4C0IKZrQVcsQo/7y5EHqX0jLSO0i2w5oE/HzpPP3AqSbFgtL2JjCeWG86pAtW+1uH0H9kJgqJLiK1HcVbOESnZgbACItmfJ5eAqXBLNvwI+DCanD8r1mobSQqEZUr9js0d2Z2vv1hc2urkTiLqcqeXcgp4LmFWG0RNrEzkykHjXE3tQsWeDMlS3VQ2w28ZtvlLsy/8gA3TU0mM+SjiyMWWXN8BMtHx3xOp+4xkgQ5W2br/qaH1HGhIFmCnaGiv3ZgiWUW6qrahpmtV0PFjYzkr0trp0jT65M6Dia37uhmqGWi6aMWnFkJuyYKqk5JVTWIgCf2TEa9Z08qcYLzAMMemJbbpIYNsOtaxqnJsD7aRNmbPDNLc0q9iZfjOxVihHo3Wo1/yyjm/dw6sXAwqpIf2pBfdTbIbzb6 X-Microsoft-Exchange-Diagnostics: 1; VI1PR0202MB2558; 31:XbT1aS3uuhrSxR5Bk/bwMW16TdxDqz1akihzYIPs5gVOFjDS+nItLOR1hn8VXcIiTEnVVSt02p2zVwvS6whqvhHyL6J7A9/qGtuRxob5nUmmODb2wIjVxCa+GwVHP4s0dj4uAab3L8pp4dvzAUXvSELrKueAh5vh8yKitLRph74U5PMgug4VBXIgSoBFkzsWlEwk92M3bogk1Je7eUodGN3cgj3Z6hNAwr0FZJlBNXicq/7FyQuUACUXvGpyA6rK X-Microsoft-Antispam-PRVS: X-Exchange-Antispam-Report-Test: UriScan:(26323138287068)(9452136761055); X-Exchange-Antispam-Report-CFA-Test: BCL:0; PCL:0; RULEID:(6040375)(601004)(2401047)(8121501046)(5005006)(10201501046)(3002001)(6041248)(2016111802025)(20161123555025)(20161123564025)(20161123562025)(20161123560025)(6072148)(6043046); SRVR:VI1PR0202MB2558; BCL:0; PCL:0; RULEID:; SRVR:VI1PR0202MB2558; X-Microsoft-Exchange-Diagnostics: 1; VI1PR0202MB2558; 4:Y17IcD8E8AI3DsAn6h6QPSPMRQnxMZh5sjYkdvLHpAA0N3wOXf1P2ycrukd8cBz+9mO5g+ol+lYRKAtJOZBIdmBqkCxKY25xGTiwbTBPQv36vFK3DJz8i1y5/ywIVFzcYlZWRs9ClKqeRAW9LLbFNBKMqVxvZDkd1TAB0ap5KhLNa7rx+ZhT8Y8/GUYk/521oqP1zbVZbXM0rvopQvY9tQ/IuzkLlYjS62WofB8xd5oUqIHxtw38ZPr0+1XJDy2WQ5QUfrgNlqP1x6kIJ8OXnrzGlbVrEcB8zQX2hUB3kcLnZF/p5SVSGjyFfYH9khom0PXKmJ+EclnK6wsRGceS/FM/bFGuwmiPEvGFJgljEyZ+9/hVA+oFcCJge/jF2D0E0/P+UcV84mI3mJtFCZ4QZvnRF+EjzCvKMW0QQcUegLYn9b0Dse43JcJoZ/NU1scMCDtf3pY8YkdlvZsq5RYUze9dYqzkqkCpedOMG8lZ9av5SgirBEOTXHxa9D203mIp4dXiulHNoLP6n0oM2lyZV2Ay9h5O8Xk0BhGHCxclBs/z29avQAgqlvrys9sUEXtJdTAhW8BYcRuMB7Kz+5EU+Dk/COQo47ClgKbKMFiKBTD2TW84sShTvEH9K29laSArKRaK9l4gXYJjpTBS1scfQjaXoyb8l5XWsUiMhtFMNnGHVeCgxCPPSiTFb6Pj659w X-Forefront-PRVS: 01917B1794 X-Forefront-Antispam-Report: SFV:NSPM; SFS:(10019020)(4630300001)(6009001)(6069001)(7916002)(39830400002)(39450400003)(39410400002)(189002)(199003)(3846002)(38730400001)(6512007)(5660300001)(50466002)(101416001)(47776003)(48376002)(54906002)(97736004)(76176999)(53936002)(189998001)(50986999)(305945005)(7416002)(4326007)(74482002)(106356001)(2950100002)(6666003)(86362001)(6116002)(81166006)(6916009)(68736007)(5003940100001)(36756003)(7736002)(2906002)(575784001)(25786008)(8666007)(42186005)(2351001)(81156014)(33646002)(6486002)(110136003)(6506006)(66066001)(92566002)(105586002)(50226002)(8676002)(230783001)(42262002); DIR:OUT; SFP:1102; SCL:1; SRVR:VI1PR0202MB2558; 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; VI1PR0202MB2558; 23:uEUFtdG1hFWWwfzDnTVOQ4+fDdXnw2xVq2Rd/Eb?= =?us-ascii?Q?kYVxt/frgbmtG3neM2nC0BxQaF3HS9t7+dXjDbQ0JZhTs+MNWbT4MmfIE4xK?= =?us-ascii?Q?weK6rW7mVPYL8dxp7HboLFRGvkV/FBf54RY7On3XnYtFlTvYHh3A0gRxel16?= =?us-ascii?Q?F0D++Q6iYWWCZjn2T4uVV9BeBetA5J+PqZ6oaFfqmmeGl1hROzISxAXKQ4zd?= =?us-ascii?Q?9MNm1NK6CUNOL+pptP+EBrAiMG2aCSt38aTWmmcsE2aqMMaXPcGFRcrMvKeM?= =?us-ascii?Q?6pgnOYMI28R3f0+/+gMItQYU8boxZ9deqMGcUICZM5yvhICYHq1ex/lfZrMb?= =?us-ascii?Q?IxJkB/1KT6GeA5fqFxVnCZ9Wy8+vhOc0zaPIWXWXxk/JIiLWge7DIaiQLBi6?= =?us-ascii?Q?MCXtpwzVjGUs+qoWsakkCNqlkaTpx1aF1pTmqd0uAjVCydOPhS3JNWaIR3gz?= =?us-ascii?Q?rtT6Y7OCCWKtq2BhBJsSCNcXOqC4BKelnoY1+dQO0qTZ9zl8EBlTnRPXEkbN?= =?us-ascii?Q?mdJPVClF+IqUGPnmltpdDTsk+fiNlA6E9ppnTNcDpK6uE8LJCNTKzr5CJ+vi?= =?us-ascii?Q?aDdEuTWhUuiRRI5RmEKIWkHYHjieVIfWnnDVmB2pJCsB6L4e0VRMCTwrb/7a?= =?us-ascii?Q?EkCSV+ekNFxGzM43rTTIlKhAhtIWZsxgyWrfkys189M7D3R+SDGz2pCDo4hI?= =?us-ascii?Q?MeVQO50h3b/Li/sWgS6Zj49StseaJ6zhq/BGKWVBMDh6LvIT5jcV4zla0f1q?= =?us-ascii?Q?F+kAxE0PL/1D8awa7+4vog8BRVfihZWnp+APA58Ck5HTRnQzUj8aMZfU2ybu?= =?us-ascii?Q?+3m+z+M4NryfwzYvH9uzulJGN+pp/lZYcB1TtcPqYeaPeAtj1aHrJsh3hYWz?= =?us-ascii?Q?aL9kTD6Q6izZBo80ckIjyIeC2RT4OUemRa5VTXwKn5z9gtpXFolSqFnsfYbd?= =?us-ascii?Q?q67VfJ8/fOI9wmUXWYGS+XnWYQ/s4BhyQ5GtI7Cy6TWgea313TdQhdpRk73E?= =?us-ascii?Q?Z+CPW3/B02VGnU8YpXJzFn81K5FwInPEqOAX8FCZOFnGCW+Ktm2MTPt3j4DX?= =?us-ascii?Q?kNIkzuuLaS5qKVG5neRzCXNiIJGTWGnxXZNALtcpc0a0g5mqEj0kjEN+CJOf?= =?us-ascii?Q?0UikJBcHygkNlYcdiaOXpoL0+49BCAEbydVPwmMB0drZaeMfGCtiZ4ymVtx1?= =?us-ascii?Q?Mwdg8TJsICKOaFS4N9l0PFFLjkivKG5rnFxowUaHbSBF7TXEo9+i0BLoK1Zi?= =?us-ascii?Q?4BAAqpdfsQdnO/9sQa4jHxnokK9LtDPOZ8rzqn4dBBmu1VmdTV7257PU8z8n?= =?us-ascii?Q?6kMPU4prijEIrhaSTj70HVOGXcAqPOVbeWfYwhGYOofDa?= X-Microsoft-Exchange-Diagnostics: 1; VI1PR0202MB2558; 6:Z1cvYAiirBE7kIVqGGPSdBHypu/uY7HUpIGxKDq31c1tUnEUG5wFEpEDEpYlZN/xNXWIIqn67QKa2KprLB7c4pzbLjKRlWQWEaS5VepRG35lC4RourEYZQKxPjC/HfjJmL0xTHLZUb06QryWMz2AyXNgbzvwqwTWNUkJtqF5lEKLsnJBRYe1u6ZX3B8uAGXQdGdkCSlJqVQPj17xiGGNkJM8Wg0E/0B1YgfEkwwGIaYtniTiDwNfN3HiiCbhe6RtcalrubaIfQMiuY+yXbC6iQvR94xUx5kvKQGP0n8sxNhvCtwSK+Adc9zqiBi1HPSa3LCawzaxHpPJa0spLFrd5wHpdxQYr33nt2v92e8/G/hu1C890HmiKC5dLrJgq/e3azSGWwhzkE8zVsc5gXUNdOXeM71F6NM4vKrRAAhVz7o4j4E3SVq70eAekmcnVlIu; 5:qplQtV2xghGsO/83l/Ztb6OTldyZn81VkR+9jRArhecSFUJYCBFj5iplYAeH8b3j5j06nVDinTPkSo79pccRe06Z7dX7o8rPHSReVeG6uUQwB7B2XhoVOS0hbQP+adf8N357sPiDblhfAP3CsiOexw==; 24:ZBwMcXgPEEjeL8dJIrffWEwTlLExWpd34DrUE39EzCPwi8xw2NopYaPqlwBi2WH+bpiTdYrfFeDHTBApIh9PZEql7DhupnMp+ObTlLPo/xc= SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-Microsoft-Exchange-Diagnostics: 1; VI1PR0202MB2558; 7:RQ/NJpJJydCqf0rSKTsSfYN/BsLGJSLMzf8YCK/Mc6rKhkgIxvrxUw4gAzhmIyFJbl6kxyUHBKs6OuYLbVLW0yYlOGu61neKPvxg9vpima9pZViDqZxWk5+Qf2oLmWT8/CWJVYhWkQrvED/rrGijKFnXIvyg0mkw9YYmBJZ7QSteSN7MaCiJHicdr86BjD6Mja+ffLrjRF7dJvVu60ouecXH+ZObJHMg60BpgwVnuAb3ybeIRtlM7sh52ii7VI8oQhXeje3QyEr3k8eNj2LjGRnjhcnB3iKx6hE8Ebpxp4cCqrZsjbQJeYk02E4/CatS8LYOD6QzLkGjuP9sbhEWoLC2FsE/XwbcAX7sfRANStyzbA/zO6OnsVGHLv/sFumHNo5O3d9a1FzabAqPzOhw2Qn7Q14RTf9QTfucMylc/swyQrd8LPrDaL5026fa65aQB3gBihefjUrdINsbudYCNQ== X-OriginatorOrg: axentia.se X-MS-Exchange-CrossTenant-OriginalArrivalTime: 18 Jan 2017 15:58:34.0385 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-Transport-CrossTenantHeadersStamped: VI1PR0202MB2558 Sender: linux-i2c-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-i2c@vger.kernel.org Describe how a multiplexer can be used to select which signal is fed to an io-channel. Acked-by: Jonathan Cameron Signed-off-by: Peter Rosin Acked-by: Rob Herring --- .../bindings/iio/multiplexer/io-channel-mux.txt | 39 ++++++++++++++++++++++ MAINTAINERS | 6 ++++ 2 files changed, 45 insertions(+) create mode 100644 Documentation/devicetree/bindings/iio/multiplexer/io-channel-mux.txt diff --git a/Documentation/devicetree/bindings/iio/multiplexer/io-channel-mux.txt b/Documentation/devicetree/bindings/iio/multiplexer/io-channel-mux.txt new file mode 100644 index 000000000000..c82794002595 --- /dev/null +++ b/Documentation/devicetree/bindings/iio/multiplexer/io-channel-mux.txt @@ -0,0 +1,39 @@ +I/O channel multiplexer bindings + +If a multiplexer is used to select which hardware signal is fed to +e.g. an ADC channel, these bindings describe that situation. + +Required properties: +- compatible : "io-channel-mux" +- io-channels : Channel node of the parent channel that has multiplexed + input. +- io-channel-names : Should be "parent". +- #address-cells = <1>; +- #size-cells = <0>; +- mux-controls : Mux controller node to use for operating the mux +- channels : List of strings, labeling the mux controller states. + +For each non-empty string in the channels property, an io-channel will +be created. The number of this io-channel is the same as the index into +the list of strings in the channels property, and also matches the mux +controller state. The mux controller state is described in +../mux/mux-controller.txt + +Example: + mux: mux-controller { + compatible = "mux-gpio"; + #mux-control-cells = <0>; + + mux-gpios = <&pioA 0 GPIO_ACTIVE_HIGH>, + <&pioA 1 GPIO_ACTIVE_HIGH>; + }; + + adc-mux { + compatible = "io-channel-mux"; + io-channels = <&adc 0>; + io-channel-names = "parent"; + + mux-controls = <&mux>; + + channels = "sync", "in", "system-regulator"; + }; diff --git a/MAINTAINERS b/MAINTAINERS index e4fac17e0fa4..35325a3d9ca4 100644 --- a/MAINTAINERS +++ b/MAINTAINERS @@ -6289,6 +6289,12 @@ F: Documentation/ABI/testing/sysfs-bus-iio-adc-envelope-detector F: Documentation/devicetree/bindings/iio/adc/envelope-detector.txt F: drivers/iio/adc/envelope-detector.c +IIO MULTIPLEXER +M: Peter Rosin +L: linux-iio@vger.kernel.org +S: Maintained +F: Documentation/devicetree/bindings/iio/multiplexer/iio-mux.txt + IIO SUBSYSTEM AND DRIVERS M: Jonathan Cameron R: Hartmut Knaack