From patchwork Sat Jul 16 00:18:22 2016 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Joshua Clayton X-Patchwork-Id: 9232933 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 12CFD60868 for ; Sat, 16 Jul 2016 00:19:30 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 0573122376 for ; Sat, 16 Jul 2016 00:19:30 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id EBF67212DB; Sat, 16 Jul 2016 00:19:29 +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_ADSP_CUSTOM_MED, DKIM_SIGNED,FREEMAIL_FROM,RCVD_IN_DNSWL_HI,T_DKIM_INVALID autolearn=unavailable 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 86DB2212DB for ; Sat, 16 Jul 2016 00:19:29 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1752159AbcGPAS6 (ORCPT ); Fri, 15 Jul 2016 20:18:58 -0400 Received: from mail-pf0-f193.google.com ([209.85.192.193]:36386 "EHLO mail-pf0-f193.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1752100AbcGPASl (ORCPT ); Fri, 15 Jul 2016 20:18:41 -0400 Received: by mail-pf0-f193.google.com with SMTP id y134so2930728pfg.3; Fri, 15 Jul 2016 17:18:40 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=from:to:cc:subject:date:message-id:in-reply-to:references :in-reply-to:references; bh=X/ibknEk093VUvC9LBuaNpKDwEt4X7TL/eoILy0jquQ=; b=ikwa86LQ0ZR+Jhzpnbpn99IyEGcciLweQjIhyWjATfvQGyrjp7ojZpJgfR2Q3o1UuF zlygxkCsDtOtrs6KxyF4PAbBaNOAfPqRe5Oe9EZfbEjDX703LpzjpZJK1TnpJBdbKAs0 A9wNf3gn83fuNT1C+C5lEqe00ntEsHjUV63TF1pESYddG+nZ/YBop10xc//NVVUOvf9U V85Bzdnpi9SYtnGcXgmPoF7eOYOaO/LxaNUJhXxJ9evXcM2OCIz4mDZZbV5I3BKMCpMc yNrNWe1O+X56x5/4q/wa7Lc2EPPvFczpK6zt54+kECizKt0XoAM1QIVkwcPpK32CjdYz s3BA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references:in-reply-to:references; bh=X/ibknEk093VUvC9LBuaNpKDwEt4X7TL/eoILy0jquQ=; b=HSJtp8QVehwot1YTb25TH3zFyabSOaSG2qnBWreFrt5UTmz0MfEUynMRJSNRobX07+ USemJmNnON9VOfMZ2OXPydiA6B4kfTcGk5DbkaBQk6lBvzd28BKGsWMwdzKcncJWyyKL xu/ybjPrP/1B9jL4hhlJpU17u1ArbjEbXX8jqkous1CLJ7dGjMJH4pmK4KnY0PyAEeFM eFw9IuT8ziv+YCFY0L9hojKsR5O1uchzsNVz4hkBQX3A+NH7nTVtH4iW7SQIo0KcZjrk Xr3YvbHYt5cDNGKRgazz4QyXL2B+d818lrxYkViF3VJwBFOqoxrJEt2gDKmrQRHsUYbO jAQg== X-Gm-Message-State: ALyK8tJABEQT7HmZCpVmalpZpLnZtBP8MQy+KfnEvsmvYSquwFz0RoHp7rPOPi1MPeHzuQ== X-Received: by 10.98.104.71 with SMTP id d68mr15400120pfc.163.1468628319728; Fri, 15 Jul 2016 17:18:39 -0700 (PDT) Received: from localhost.localdomain (68-185-59-186.static.knwc.wa.charter.com. [68.185.59.186]) by smtp.gmail.com with ESMTPSA id d1sm7077531pas.48.2016.07.15.17.18.38 (version=TLS1_2 cipher=ECDHE-RSA-AES128-SHA bits=128/128); Fri, 15 Jul 2016 17:18:38 -0700 (PDT) From: Joshua Clayton To: Rob Herring , Mark Rutland , Shawn Guo , Sascha Hauer , Fabio Estevam , Russell King , Jean Delvare , Guenter Roeck , devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, linux-arm-kernel@lists.infradead.org, linux-hwmon@vger.kernel.org Cc: Joshua Clayton Subject: [RCF 2/3] hwmon: Document bindings for ads1118 adc driver Date: Fri, 15 Jul 2016 17:18:22 -0700 Message-Id: <49eddbb75c677db62701e229330f0f5c35983130.1468626668.git.stillcompiling@gmail.com> X-Mailer: git-send-email 2.7.4 In-Reply-To: References: In-Reply-To: References: Sender: linux-hwmon-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-hwmon@vger.kernel.org X-Virus-Scanned: ClamAV using ClamSMTP ads1118 is a 4 input 16 bit adc with a buit-in temperature gauge Signed-off-by: Joshua Clayton --- .../devicetree/bindings/hwmon/ads1118.txt | 81 ++++++++++++++++++++++ 1 file changed, 81 insertions(+) create mode 100644 Documentation/devicetree/bindings/hwmon/ads1118.txt diff --git a/Documentation/devicetree/bindings/hwmon/ads1118.txt b/Documentation/devicetree/bindings/hwmon/ads1118.txt new file mode 100644 index 0000000..41c66dc --- /dev/null +++ b/Documentation/devicetree/bindings/hwmon/ads1118.txt @@ -0,0 +1,81 @@ +ADS1118 (SPI) + +The ADS1118 is 16-bit analog to digital converter with 4 inputs and a +temperature sensor. +The ADS1018 is a 12-bit version of the chip. + +The inputs can be single ended or differential pair combinations. + +Each channel, 0 - 4 may be configured as a single ended adc input. +Channel 0 may be configured differentially with channel 1. +Channels 0, 1, or 2 may be configured differentially with channel 3. + +To set up a differential pair, the lower channel should be have +the ti,differential-endpoint property set to the higher channel in the pair. + +Each channel can be configured individually: + - fullscale voltage range values are +/- microvolts + 6144000, 4096000, 2048000, 1024000, 512000, or 256000 + + - data_rate in samples per second + - for the ads1018: + 128, 250, 490, 920, 1600, 2400, or 3300 + - for the ads1118: + 8, 16, 32, 64, 128, 250, or 860 + +The sensor contains an internal pullup register to keep the data output +high when not in use. This may be disabled, but is enabled by default. + +1) The /ads1118 node + + Required properties: + + - compatible : must be "ti,ads1018" or "ti,ads1118" + - spi-cpha : spi phase set to 1 (spi polarity is 0) + - reg : the spi chipselect address + - #address-cells : must be <1> + - #size-cells : must be <0> + + Optional properties: + + - ti,tempsensor: enable the temperature sensor + - ti,pullup-disable: disable the internal pullup resistor + + The node contains child nodes for each channel that the platform uses. + +2) channel nodes + + Required properties: + + - reg : the channel number (0, 1, 2, or 3) + + Optional properties: + + - ti,differential-endpoint: differential second endpoint. + - ti,fullscale: fullscale range in +/- microvolts + - ti,datarate : the converter data rate in samples / second + + Example ADS1118 node: + + ads1118@0 { + compatible = "ti,ads1118"; + spi-max-frequency = <2450000>; + reg = <0>; + #address-cells = <1>; + #size-cells = <0>; + ti,tempsensor; + voltage0@0 { + reg = <0>; + ti,fullscale = <6144000>; + ti,datarate = <860>; + ti,differential-endpoint = <1>; + }; + voltage1@3 { + reg = <3>; + ti,fullscale = <6144000>; + ti,datarate = <475>; + }; + }; + +For the above example, The temperature sensor is enabled as well as +channels 0 and 1 in differential mode, and channel 3 single ended.