From patchwork Fri Jan 5 15:28:26 2018 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Alexandru Ardelean X-Patchwork-Id: 10146681 Return-Path: Received: from mail.wl.linuxfoundation.org (pdx-wl-mail.web.codeaurora.org [172.30.200.125]) by pdx-korg-patchwork.web.codeaurora.org (Postfix) with ESMTP id 548AB60244 for ; Fri, 5 Jan 2018 15:28:48 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 3F62127D4A for ; Fri, 5 Jan 2018 15:28:48 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id 33CFA28567; Fri, 5 Jan 2018 15:28:48 +0000 (UTC) X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on pdx-wl-mail.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-6.8 required=2.0 tests=BAYES_00,DKIM_SIGNED, RCVD_IN_DNSWL_HI,T_DKIM_INVALID autolearn=ham version=3.3.1 Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 8B89127D4A for ; Fri, 5 Jan 2018 15:28:47 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1751888AbeAEP2r (ORCPT ); Fri, 5 Jan 2018 10:28:47 -0500 Received: from mail-by2nam03on0054.outbound.protection.outlook.com ([104.47.42.54]:6833 "EHLO NAM03-BY2-obe.outbound.protection.outlook.com" rhost-flags-OK-OK-OK-FAIL) by vger.kernel.org with ESMTP id S1751514AbeAEP2q (ORCPT ); Fri, 5 Jan 2018 10:28:46 -0500 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=analog.onmicrosoft.com; s=selector1-analog-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version; bh=Ns89cQbagkNI3YkYYLdttnP7a21tbnP7aN25UyFW5ns=; b=sFDPnoqNoHF3Pb1onWSMXjWv7yWwKxbHX+F93CiR6ebSzQBWJDOrI9h4WTdve0RGu7w8Z6/PVWY0rSMfKVgCRV9oWB/yQOgFREHLZOaP1zzaj5Kdi4rac1X8Llo+8+GyqwG3BOErxsw7s+Taq9+/McRjv9UmTin3oASndDaeK4k= Received: from MWHPR03CA0058.namprd03.prod.outlook.com (10.174.173.175) by CY1PR0301MB2060.namprd03.prod.outlook.com (10.164.2.142) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384_P256) id 15.20.386.5; Fri, 5 Jan 2018 15:28:44 +0000 Received: from BN1AFFO11FD045.protection.gbl (2a01:111:f400:7c10::109) by MWHPR03CA0058.outlook.office365.com (2603:10b6:301:3b::47) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384) id 15.20.386.5 via Frontend Transport; Fri, 5 Jan 2018 15:28:44 +0000 Authentication-Results: spf=pass (sender IP is 137.71.25.55) smtp.mailfrom=analog.com; vger.kernel.org; dkim=none (message not signed) header.d=none;vger.kernel.org; dmarc=bestguesspass action=none header.from=analog.com; Received-SPF: Pass (protection.outlook.com: domain of analog.com designates 137.71.25.55 as permitted sender) receiver=protection.outlook.com; client-ip=137.71.25.55; helo=nwd2mta1.analog.com; Received: from nwd2mta1.analog.com (137.71.25.55) by BN1AFFO11FD045.mail.protection.outlook.com (10.58.53.60) with Microsoft SMTP Server (version=TLS1_0, cipher=TLS_RSA_WITH_AES_256_CBC_SHA) id 15.20.345.12 via Frontend Transport; Fri, 5 Jan 2018 15:28:16 +0000 Received: from NWD2HUBCAS9.ad.analog.com (nwd2hubcas9.ad.analog.com [10.64.69.109]) by nwd2mta1.analog.com (8.13.8/8.13.8) with ESMTP id w05FSg0e016590 (version=TLSv1/SSLv3 cipher=AES128-SHA bits=128 verify=FAIL) for ; Fri, 5 Jan 2018 07:28:42 -0800 Received: from zeus.spd.analog.com (10.64.82.11) by NWD2HUBCAS9.ad.analog.com (10.64.69.109) with Microsoft SMTP Server id 14.3.210.2; Fri, 5 Jan 2018 10:28:43 -0500 Received: from saturn.analog.com ([10.50.1.244]) by zeus.spd.analog.com (8.15.1/8.15.1) with ESMTP id w05FSeB9027857; Fri, 5 Jan 2018 10:28:41 -0500 From: To: CC: , Alexandru Ardelean Subject: [PATCH 2/2][V2] staging:iio:docs: add ad7192 doc to detail dt usage Date: Fri, 5 Jan 2018 17:28:26 +0200 Message-ID: <20180105152826.12076-1-alexandru.ardelean@analog.com> X-Mailer: git-send-email 2.14.1 MIME-Version: 1.0 X-EOPAttributedMessage: 0 X-MS-Office365-Filtering-HT: Tenant X-Forefront-Antispam-Report: CIP:137.71.25.55; IPV:NLI; CTRY:US; EFV:NLI; SFV:NSPM; SFS:(10009020)(396003)(346002)(39380400002)(376002)(39860400002)(2980300002)(438002)(199004)(189003)(53416004)(106466001)(54906003)(316002)(2351001)(8676002)(16586007)(50226002)(8936002)(86362001)(106002)(59450400001)(6666003)(305945005)(478600001)(1076002)(356003)(575784001)(48376002)(246002)(2876002)(77096006)(86152003)(7636002)(50466002)(107886003)(6916009)(47776003)(5660300001)(2906002)(7696005)(51416003)(4326008)(36756003)(21314002); DIR:OUT; SFP:1101; SCL:1; SRVR:CY1PR0301MB2060; H:nwd2mta1.analog.com; FPR:; SPF:Pass; PTR:nwd2mail10.analog.com; A:1; MX:1; LANG:en; X-Microsoft-Exchange-Diagnostics: 1; BN1AFFO11FD045; 1:fMLB3c38YU0Bthers+be6tbos9fZy4xj5DoWDWJbrzyvLTUQlZ03+QdBJjeK9rUcC26HB1nqZXHDyZ4qvd2eWqdzlGiZBFC7pNsgb+q6CRzyUUeAnNQXuXHn8591XLQf X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: 0e60aa42-9135-4394-1715-08d55450f1a7 X-Microsoft-Antispam: UriScan:; BCL:0; PCL:0; RULEID:(4534020)(4602075)(4627115)(201703031133081)(201702281549075)(5600026)(4604075)(4608076)(2017052603307)(7153060); SRVR:CY1PR0301MB2060; X-Microsoft-Exchange-Diagnostics: 1; CY1PR0301MB2060; 3:8Ed39xA1E9lGZjlNVCLamBfVA+Qt45ZIZ3tnCVKN1gXzFs1YpgXKdsMQuVy02/cwQSPmMNDUcRbjrQmWLr1b70ikBKMYbCF10xrdAUxShMKDXRP3BcDrCuv9IRpjjk1DtAIGCF3Hdd7ZgWzIcdncABffhyNbbRrtoIBA/MkUw6uqwSJo0qBwSN41OM65FC++NqJCnyq5mr8BVgN8GxhvckDHTa09T3ScIqqlKW+b6bTu1uPMzLDcgD2w8tmRGfoSPyxSwc7uTa/yoSf8H4MwXXKwpm2uH6Iw0mYT/rLKmP68XSVkD32C2wMXcPOA1mXRGeHO7RIvavuBfTG2jEqrTw==; 25:s8ANEt5FAeJK9shz4VRmPgC6S8ZP12U654/OpZhPlY72w6+vc8gDE2eOn3ze2SV+wC85Qc6e9M5lNHp5bNBHUj+6AFbrjyNjTtP0s03saOmw9xRBr4hdPN2S6gzYIKuM/XxbuLzRr/Wy7fL8Q/HYpp3mn26FHSRCWpcVmWNBqUYzA9mMfp1eF0a/AGlecKprEuCy3qvJKUAkwu7LAAGHi7TE6ZBisckTnrZVzTf+3Er7+g7FzaHrhGv7JVv1XJGDMHZG4FK+n56Tq2HHbdZZXv8jVqH6mPVZ4Y1cqDfiRwWcBAwkYu71dK1ZD6tX041yZtx7b1ADjs62okeeC/bYjQ==; 31:ElH3eBf8BJNo/5K8gI/qBi1zkEgr9mT0Inu0iw3sKb1nmiDfcVvvrBuBCHtewuPgfb5NCrRbzKGXKzCY9OQVk4wH9s8HWbp5vfsxZ5DXcQd/Cm/XAP4vbql2o2FxXluEAygmHvGiR4B3Xr/b3+ejmZtYgs98wCcOvMfe/W1BZLeTWDPZ27hy1a7x7k3d+jzeiphwSFMTd+c+VO9MJfXFdf4ozGSeizpBTUlaeWdlJQY= X-MS-TrafficTypeDiagnostic: CY1PR0301MB2060: X-Microsoft-Exchange-Diagnostics: 1; CY1PR0301MB2060; 20:P8BOMi6xvhzEpgBf6qxBRGOp9tkWl7XLmLDXo7Nzx1C/cIBGl8LpkmgAMG6RWBjW4ajBQrWIx5rNhFvSaHL3ZKH/+7bfEl6J+Vk7m94jqOUg/hcUDnVNHiyRYd1KmlT7Z/cAjB1rvABhNcf4+KJ/6jO1walZZ/yRxJXt4FUfkfRpBOeipF3LPE51C+iZn8ofSGC5wuh/bnK3zXccKbHo/RwgtTKrE8xhwZRq3PRutoMg9VVneB0474kmZfG2mjnpydropoLELko8RzKYhQ25TYoeZg0NXo20+trEa1T4Ys2fUMg2FrCVHi0X/MvAD6PsoBuOjTzyxLNFY/Jppm1rcSwlP07JS2tfcWAlQw/ZBl+0IOS6nA3xDbKwXR1tTk44/kTv+nyHATi2kcG6gL+wF+3Xaa8g8YnMjXIzYpVZFqhMKcY3eANaF7LiWkUnsr8chxUEpK8H31NUUEVd5pHiMK93T3Z2K432+kdoAgEKeFL2J/FwOH7/QJUg1rw1s55/; 4:73/l8nz8OO+3qJcKyQZnwpb12r5iMX+nb3w4RoI36XfkjSQSSeXYGDgOXFNINc3lIoxNUgG4wbLw44XLzQvEA2t1xz2WGEM5vRZJkkKIWrM0joLs8zWWMcfLEhN7TmFIZfPY1golJuqzOgPFMSllTpznK7jes2WphjxFcUSjN5kYTOqQ6h600gLQksWLOOQjOzDSReT79eWJ0uDUEihRF/ocoMcutXOm0Xp2DlgRFGKK79K5IsnSgwXJjTM1LoFIJKQHPJ9UY09HYe9Rv2EOpHXp8EUWUBeeMTFtCnbtQfIVTCieXra+NewiXpqPWw3TL5D8EaKEbVklUXr4VUntcA== X-Microsoft-Antispam-PRVS: X-Exchange-Antispam-Report-Test: UriScan:(232431446821674)(788757137089); X-Exchange-Antispam-Report-CFA-Test: BCL:0; PCL:0; RULEID:(6040470)(2401047)(8121501046)(5005006)(3231023)(944501075)(3002001)(10201501046)(93006095)(93004095)(6055026)(6041268)(201703131423095)(201702281528075)(20161123555045)(201703061421075)(201703061406153)(20161123560045)(20161123564045)(20161123558120)(20161123562045)(6072148)(201708071742011); SRVR:CY1PR0301MB2060; BCL:0; PCL:0; RULEID:(100000803101)(100110400095); SRVR:CY1PR0301MB2060; X-Forefront-PRVS: 05437568AA X-Microsoft-Exchange-Diagnostics: =?us-ascii?Q?1; CY1PR0301MB2060; 23:lGh4MAtkRIiquu6NRhNE+IXCaSQKAhCAMiLb8Vy?= =?us-ascii?Q?j9VvhCyiTOTQDaXsFHjSuIWjhj60k7q1Vhe7pJCFH7BKTALHQYUm9oTpgsH4?= =?us-ascii?Q?5pkFyQwMvb9UKr9jjgSQt69HFVQHo3GwVSoo8fH1oK/7H3TMOqyUebrQRYQZ?= =?us-ascii?Q?4vV7haxlFj0h32Qam3+E3F5tpPI0g50i+W0c/m2aurgMhzRT/wlfvM1o7D6/?= =?us-ascii?Q?0jGLAedgV8Fb8b0FiMv6q3u/XTM7MIPWp+638oorBgTXCF9vNfqPfW8gPV9i?= =?us-ascii?Q?VOXorx9FSBZ8P7OZjFezdHrR/giIA455N3FMPF1761aI9c1TpmuqC/oFklEc?= =?us-ascii?Q?bC1W26Zy5RxU8nkFBxmvp19Gd0JO8D5hiscgUZ046FtSRGjAvEEc1Ldboyr5?= =?us-ascii?Q?mmkqpqxsFHvyx4NtUm7eMWEquANd63lOs9/cVRXSNFUDkqXLB1jFbWZxKDNZ?= =?us-ascii?Q?D8hHwkhSB0Jtb5kBCKiMde6JY8RSqEz01uAjTP3jvc8pkOeU9CjZ3BkAQUHY?= =?us-ascii?Q?B604401iJXSPPWfvF9F8T7dXR0QB+4+8/b/xO27kS/BMD2+QwsUmpwtr+VsO?= =?us-ascii?Q?+eaC/Ei3vufsNQQb8v3tlciiN0KZXHAMtwDymrH7xHpCANkutr9UWUgPyq7Y?= =?us-ascii?Q?C5vI2GmroT4Dda9rmkG1JpCldPsp3HuHpJ0yXvKHHY29+WHSf/hQiPBCgBKK?= =?us-ascii?Q?RRrcgOukk2vLupD2G12Lpc60ENejVDTXhuWanL+a79KUjG1fEzJ8bCsxc8WG?= =?us-ascii?Q?1ovnSXfht8sVwQ7t0dm3RcBY0m9gS4pYGfH+5yGzsPtTzgZKFdLT4FFrVhDU?= =?us-ascii?Q?a878WtW9BoBXC+uCVb494BMSilYLlYIAo6zIymBPM3XLi1ylDKd7V4tNTm/9?= =?us-ascii?Q?B+M6pbbVuc6WrJocBhL9tybkZcUsTOuV9DE94QsrF1gg2t4C+auYTM0yrZP+?= =?us-ascii?Q?rlr1gdGdYQLjxVrrJbTSwatFYDALRj/JgnPeYez8o3mjwARqde75xpjHiP3E?= =?us-ascii?Q?WMRD2ykaYPP5Pt0lA3iRJI0G7IGkVCC1gKYhO8Gcv/DTvFw=3D=3D?= X-Microsoft-Exchange-Diagnostics: 1; CY1PR0301MB2060; 6:KCfJBw58db2eOe7eNUKj9UgFtw5/DiBCx79L9iIkwrO5RWpKUqBqEFqEIMPMLOyC1PZGuxmhdsd87plJ0UuST/YuZe31mOCXbb75OWndAMoRFnmDiM8+P5NSOd4ynX+CctDEhKLOwN19wObyGeCnuqZ1U7prC6X5LhnB7WbC4TP83p7DUPA89W73/3Sf2txIWpV/6eaYFeskV2HD8/zvist9zlEnpJrKSGRTw3kkF20S8w2//8PPieOT5ht9nZFk3z2/tdvpFIIkNaj016nSNP1R1EUlNxwzWNf4wkza7qTWIqorqqsTczRauh1r4SD3sYBZwxqIYCUBRewWQSeBhLO6iFYlLWWXf1jDaY5jPfg=; 5:/2m7OYuc4/DsAzHvhrMk0hYP5Tsy87jtx4IDxHvflBVZqfpr95drUFVNtK9gNWQzKlGjk7HqUvsrw2tX/S1AOsGf0MM40In2g3IofRZsde/j//tIsST9RB2tcV6d+qeEN7+vIgNnd0nmPsn2gTZKSA6Wey4Lb1Q+khsVqj0Oy4A=; 24:JbUf+Lb7vs1S5TUxQkWWKuCD2DcMGmlbDvJMBO6ML2WtEML9AkK08xg0KhhA7VvH7hQzVQWiR6f1JTCixSAjCxES8Nako3gdApPK/RNArJ8=; 7:SB6HYvSqFnFub1xPy0xxzg7vNEcc9LU8gOU2F+Hfn2YFkWWGqW7Lxs6PIhS5MKIOdrRABdaTpqMnj6dP8W2XsIulB8iq1T+KjqolV8eN1Lc97xstO4eevvRxz+v/HBn64t5BZ3iSehefNt6nA/Bi/KvTyyRdJRTzFmh9AhVmCuxRlUF+jAQ5tfeeRfV8Ba9lQ5qAXpfn5RGLdeZie83TaFlRsoB7V65nMI/BO7wcsoVwAWGsmS/OnZlOxp1J+9vp SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-OriginatorOrg: analog.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 05 Jan 2018 15:28:16.6489 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: 0e60aa42-9135-4394-1715-08d55450f1a7 X-MS-Exchange-CrossTenant-Id: eaa689b4-8f87-40e0-9c6f-7228de4d754a X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp: TenantId=eaa689b4-8f87-40e0-9c6f-7228de4d754a; Ip=[137.71.25.55]; Helo=[nwd2mta1.analog.com] X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: CY1PR0301MB2060 Sender: linux-iio-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-iio@vger.kernel.org X-Virus-Scanned: ClamAV using ClamSMTP From: Alexandru Ardelean Signed-off-by: Alexandru Ardelean --- drivers/staging/iio/Documentation/adc/ad7192.txt | 60 ++++++++++++++++++++++++ 1 file changed, 60 insertions(+) create mode 100644 drivers/staging/iio/Documentation/adc/ad7192.txt diff --git a/drivers/staging/iio/Documentation/adc/ad7192.txt b/drivers/staging/iio/Documentation/adc/ad7192.txt new file mode 100644 index 000000000000..19efc0a9411c --- /dev/null +++ b/drivers/staging/iio/Documentation/adc/ad7192.txt @@ -0,0 +1,60 @@ +Analog Devices AD719x ADC Driver + +1. Overview + +The driver is intended to work with all AD719x ADC chips +from Analog Devices (AD7190, AD7192, AD7193, AD7195). + +It's based on top of the AD Sigma Delta driver + +2. Device Tree Configuration + +Example for use on a Raspberry Pi with interrupt line +connected to PIN 25 on the GPIO: + + adc_vref: fixedregulator@0 { + reg = <0>; + + compatible = "regulator-fixed"; + regulator-name = "fixed-supply"; + regulator-min-microvolt = <3300000>; + regulator-max-microvolt = <3300000>; + regulator-boot-on; + }; + + ad7190@0 { + compatible = "ad7190"; + reg = <0>; + spi-max-frequency = <1000000>; + spi-cpol; + spi-cpha; + + #interrupt-cells = <2>; + interrupts = <25 0x2>; + interrupt-parent = <&gpio>; + avdd-supply = <&adc_vref>; + + adi,clock-source-select = /bits/ 8 <0>; + adi,reference-voltage-mv = /bits/ 16 <3300>; + + adi,refin2-pins-enable; + adi,rejection-60-Hz-enable; + adi,chop-enable; + adi,buffer-enable; + adi,burnout-currents-enable; + adi,sinc3-filter-enable; + adi,unipolar-enable; + }; + +Notes (about this example): +* be sure to replace `compatible = "ad7190";` with + your actual chip model (ad7190, ad7192, ad7193, ad7195) + in order to make sure it works correctly +* PIN 25 must also be connected also to the DOUT pin + of the ADC (or MISO on the host) +* be sure to add the "/bits/" specifiers ; newer dtc versions + specify the property type/size using this field, + and the driver may not be able to find the property +* not all "adi,xxx" parameters are required ; + see the datasheet to get an idea of what you need +