From: Joshua Clayton <stillcompiling@gmail.com>
To: Rob Herring <robh+dt@kernel.org>,
Mark Rutland <mark.rutland@arm.com>,
Shawn Guo <shawnguo@kernel.org>,
Sascha Hauer <kernel@pengutronix.de>,
Fabio Estevam <fabio.estevam@nxp.com>,
Russell King <linux@armlinux.org.uk>,
Jean Delvare <jdelvare@suse.com>,
Guenter Roeck <linux@roeck-us.net>,
devicetree@vger.kernel.org, linux-kernel@vger.kernel.org,
linux-arm-kernel@lists.infradead.org,
linux-hwmon@vger.kernel.org
Cc: Joshua Clayton <stillcompiling@gmail.com>
Subject: [RCF 2/3] hwmon: Document bindings for ads1118 adc driver
Date: Fri, 15 Jul 2016 17:18:22 -0700 [thread overview]
Message-ID: <49eddbb75c677db62701e229330f0f5c35983130.1468626668.git.stillcompiling@gmail.com> (raw)
In-Reply-To: <cover.1468626668.git.stillcompiling@gmail.com>
In-Reply-To: <cover.1468626668.git.stillcompiling@gmail.com>
ads1118 is a 4 input 16 bit adc with a buit-in temperature gauge
Signed-off-by: Joshua Clayton <stillcompiling@gmail.com>
---
.../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.
--
2.7.4
next prev parent reply other threads:[~2016-07-16 0:19 UTC|newest]
Thread overview: 12+ messages / expand[flat|nested] mbox.gz Atom feed top
2016-07-16 0:18 [RCF 0/3] hwmon: add driver for TI ADS1118 Joshua Clayton
2016-07-16 0:18 ` [RCF 1/3] hwmon: Add ads1118 driver Joshua Clayton
2016-07-16 1:40 ` Guenter Roeck
2016-07-22 14:39 ` Joshua Clayton
2016-07-23 1:20 ` ADS1118: hwmon or iio ? [was: Re: [RCF 1/3] hwmon: Add ads1118 driver] Guenter Roeck
2016-07-23 5:43 ` Jonathan Cameron
2016-07-23 6:02 ` [RCF 1/3] hwmon: Add ads1118 driver Jonathan Cameron
2016-07-16 17:22 ` kbuild test robot
2016-07-16 0:18 ` Joshua Clayton [this message]
2016-07-17 20:34 ` [RCF 2/3] hwmon: Document bindings for ads1118 adc driver Rob Herring
2016-07-18 12:51 ` Joshua Clayton
2016-07-16 0:18 ` [RCF 3/3] ARM: imx6q-evi: ads ads1118 support Joshua Clayton
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=49eddbb75c677db62701e229330f0f5c35983130.1468626668.git.stillcompiling@gmail.com \
--to=stillcompiling@gmail.com \
--cc=devicetree@vger.kernel.org \
--cc=fabio.estevam@nxp.com \
--cc=jdelvare@suse.com \
--cc=kernel@pengutronix.de \
--cc=linux-arm-kernel@lists.infradead.org \
--cc=linux-hwmon@vger.kernel.org \
--cc=linux-kernel@vger.kernel.org \
--cc=linux@armlinux.org.uk \
--cc=linux@roeck-us.net \
--cc=mark.rutland@arm.com \
--cc=robh+dt@kernel.org \
--cc=shawnguo@kernel.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).