Received: by 2002:a25:4158:0:0:0:0:0 with SMTP id o85csp4018392yba; Wed, 17 Apr 2019 02:51:01 -0700 (PDT) X-Google-Smtp-Source: APXvYqwOPE0BSeOes9BwjFJ0DN1c5fDofn1KauZD1dL2w+0DLIC6f2DSh7QpuCeTLU/Kj8WdS/DC X-Received: by 2002:a65:500d:: with SMTP id f13mr82584699pgo.250.1555494661637; Wed, 17 Apr 2019 02:51:01 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1555494661; cv=none; d=google.com; s=arc-20160816; b=dljo9wN1PVLYNzXJoJPzvwDAZPEjIGDsM4jmxIf9tEIKB7KVeSSmIIYYK5STV1fu5Z 2IkqI26CAn2zGkBs2tkaVLAavnufcp8R3VeS16GhdLR/QIqgpjol/8nR0O4zL8vITlTl m5uSKhYqvFUlEGBcj8dLmTWcvBRiMkMKL5LAgGMOQJ77Z5FXWECJ8TD+83HgWSVtY1y0 W49xXJk4DbCHxvXVsMMoK40ygdEXQc6cinMeeLKCeENo5pfPACYToXt/rs4lJ/F6W+lY mB/KIOw7ep9JMbpv8gEGEsbgKiA4Io8Rd33Cis02pS2ZY7MPLVThe5R6TjrA7Bphzq2a 9DSw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:sender:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=HBtp3BEM97J+VvxjcyTQ0Rh8cs8lWpfrxcjNLnrN9tA=; b=kQAZQ5m0mxVGDNLaH9ZlVn7iH7AvL2jHxE5kYEBxz1hP8yhW7cqMi4c/Lb57WoFPXo 8Mx+bRIw5ojI1OnjIeLx3+arcllmEiwqUHZaOGKUhXC1lK1Sga2T0jwcEpkideuH/cQt Vrf3llsXcEVEeZ2ZFgIpFOnHoAeluSuUpVwYBchBoaT+rXSYtGAGuOhBn9looe8KMSU+ 2f//zWzrvW3dQghObkqryQXVGw/YWk02f8plG6+WryM//JZIBQRK3n9q3FQsnWg0ks/c M3Beo777yB/luOzgpxYBqFwQOMvgKETs98Gz+VH4i2Bs+aRm5lK8+7k8NL0d4fiGgR8O 5F0w== ARC-Authentication-Results: i=1; mx.google.com; dkim=fail header.i=@infradead.org header.s=bombadil.20170209 header.b=QuB7dVyw; spf=pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=kernel.org Return-Path: Received: from vger.kernel.org (vger.kernel.org. [209.132.180.67]) by mx.google.com with ESMTP id a66si53337100pfb.210.2019.04.17.02.50.47; Wed, 17 Apr 2019 02:51:01 -0700 (PDT) Received-SPF: pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) client-ip=209.132.180.67; Authentication-Results: mx.google.com; dkim=fail header.i=@infradead.org header.s=bombadil.20170209 header.b=QuB7dVyw; spf=pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=kernel.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1731900AbfDQJsI (ORCPT + 99 others); Wed, 17 Apr 2019 05:48:08 -0400 Received: from bombadil.infradead.org ([198.137.202.133]:44958 "EHLO bombadil.infradead.org" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1731705AbfDQJqj (ORCPT ); Wed, 17 Apr 2019 05:46:39 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=infradead.org; s=bombadil.20170209; h=Sender:Content-Transfer-Encoding: MIME-Version:References:In-Reply-To:Message-Id:Date:Subject:Cc:To:From: Reply-To:Content-Type:Content-ID:Content-Description:Resent-Date:Resent-From: Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID:List-Id:List-Help: List-Unsubscribe:List-Subscribe:List-Post:List-Owner:List-Archive; bh=HBtp3BEM97J+VvxjcyTQ0Rh8cs8lWpfrxcjNLnrN9tA=; b=QuB7dVywcb51QyXd2/yU4BZRab KEogfLYvP3CXsGMEU4U9XS+VkPu1K/gIo7EgzoYDiS0BpOXFUoDOkAfPiYvJlHYhNwixNyp/T6IKL BSjXpbEmWjiIpZxYHGarBu1LR37S3w8NL76umpjR4zLb89J+Pr6Ky3Uzag/EtsKVK0PILAbQJr6Ax tsocT4IyWPFWTw8/VKBLB4NYc01ox75f/W94yyNww6u8NBSvnCuDXOaPHertsSv8ILG0j+KVNAolV Iwd/nyWnIvDFc+v733kdmZA03aT/MhfvH5opFabb/6siM7SJ1EqaTlXv6Y3YwvAQnGIv8ndndqN9u bydtP2sw==; Received: from 177.132.233.55.dynamic.adsl.gvt.net.br ([177.132.233.55] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtpsa (Exim 4.90_1 #2 (Red Hat Linux)) id 1hGh9K-0000aF-89; Wed, 17 Apr 2019 09:46:38 +0000 Received: from mchehab by bombadil.infradead.org with local (Exim 4.92) (envelope-from ) id 1hGh9D-0003v4-3U; Wed, 17 Apr 2019 06:46:31 -0300 From: Mauro Carvalho Chehab To: Linux Doc Mailing List Cc: Mauro Carvalho Chehab , Mauro Carvalho Chehab , linux-kernel@vger.kernel.org, Jonathan Corbet , Jean Delvare , Guenter Roeck , linux-hwmon@vger.kernel.org Subject: [PATCH v3 13/21] docs: hwmon: ads1015: convert to ReST format Date: Wed, 17 Apr 2019 06:46:21 -0300 Message-Id: <1a1413f4f87db98026c59f79a278ed5e6cdd78d2.1555494108.git.mchehab+samsung@kernel.org> X-Mailer: git-send-email 2.20.1 In-Reply-To: References: MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Sender: linux-kernel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Convert ads1015 to ReST format, in order to allow it to be parsed by Sphinx. Signed-off-by: Mauro Carvalho Chehab --- Documentation/hwmon/ads1015 | 72 ++++++++++++++++++++++--------------- 1 file changed, 43 insertions(+), 29 deletions(-) diff --git a/Documentation/hwmon/ads1015 b/Documentation/hwmon/ads1015 index 02d2a459385f..e0951c4e57bb 100644 --- a/Documentation/hwmon/ads1015 +++ b/Documentation/hwmon/ads1015 @@ -2,17 +2,25 @@ Kernel driver ads1015 ===================== Supported chips: + * Texas Instruments ADS1015 + Prefix: 'ads1015' - Datasheet: Publicly available at the Texas Instruments website : - http://focus.ti.com/lit/ds/symlink/ads1015.pdf + + Datasheet: Publicly available at the Texas Instruments website: + + http://focus.ti.com/lit/ds/symlink/ads1015.pdf + * Texas Instruments ADS1115 + Prefix: 'ads1115' - Datasheet: Publicly available at the Texas Instruments website : - http://focus.ti.com/lit/ds/symlink/ads1115.pdf + + Datasheet: Publicly available at the Texas Instruments website: + + http://focus.ti.com/lit/ds/symlink/ads1115.pdf Authors: - Dirk Eibach, Guntermann & Drunck GmbH + Dirk Eibach, Guntermann & Drunck GmbH Description ----------- @@ -24,14 +32,15 @@ This device is a 12/16-bit A-D converter with 4 inputs. The inputs can be used single ended or in certain differential combinations. The inputs can be made available by 8 sysfs input files in0_input - in7_input: -in0: Voltage over AIN0 and AIN1. -in1: Voltage over AIN0 and AIN3. -in2: Voltage over AIN1 and AIN3. -in3: Voltage over AIN2 and AIN3. -in4: Voltage over AIN0 and GND. -in5: Voltage over AIN1 and GND. -in6: Voltage over AIN2 and GND. -in7: Voltage over AIN3 and GND. + + - in0: Voltage over AIN0 and AIN1. + - in1: Voltage over AIN0 and AIN3. + - in2: Voltage over AIN1 and AIN3. + - in3: Voltage over AIN2 and AIN3. + - in4: Voltage over AIN0 and GND. + - in5: Voltage over AIN1 and GND. + - in6: Voltage over AIN2 and GND. + - in7: Voltage over AIN3 and GND. Which inputs are available can be configured using platform data or devicetree. @@ -42,29 +51,34 @@ Platform Data In linux/platform_data/ads1015.h platform data is defined, channel_data contains configuration data for the used input combinations: + - pga is the programmable gain amplifier (values are full scale) - 0: +/- 6.144 V - 1: +/- 4.096 V - 2: +/- 2.048 V - 3: +/- 1.024 V - 4: +/- 0.512 V - 5: +/- 0.256 V + + - 0: +/- 6.144 V + - 1: +/- 4.096 V + - 2: +/- 2.048 V + - 3: +/- 1.024 V + - 4: +/- 0.512 V + - 5: +/- 0.256 V + - data_rate in samples per second - 0: 128 - 1: 250 - 2: 490 - 3: 920 - 4: 1600 - 5: 2400 - 6: 3300 -Example: -struct ads1015_platform_data data = { + - 0: 128 + - 1: 250 + - 2: 490 + - 3: 920 + - 4: 1600 + - 5: 2400 + - 6: 3300 + +Example:: + + struct ads1015_platform_data data = { .channel_data = { [2] = { .enabled = true, .pga = 1, .data_rate = 0 }, [4] = { .enabled = true, .pga = 4, .data_rate = 5 }, } -}; + }; In this case only in2_input (FS +/- 4.096 V, 128 SPS) and in4_input (FS +/- 0.512 V, 2400 SPS) would be created. -- 2.20.1