From patchwork Tue Apr 23 22:06:20 2013 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Arnaud Ebalard X-Patchwork-Id: 2481041 Return-Path: X-Original-To: patchwork-linux-arm@patchwork.kernel.org Delivered-To: patchwork-process-083081@patchwork1.kernel.org Received: from casper.infradead.org (casper.infradead.org [85.118.1.10]) by patchwork1.kernel.org (Postfix) with ESMTP id 887A33FCA5 for ; Tue, 23 Apr 2013 22:10:21 +0000 (UTC) Received: from merlin.infradead.org ([2001:4978:20e::2]) by casper.infradead.org with esmtps (Exim 4.80.1 #2 (Red Hat Linux)) id 1UUlPG-0007h8-Cw; Tue, 23 Apr 2013 22:09:48 +0000 Received: from localhost ([::1] helo=merlin.infradead.org) by merlin.infradead.org with esmtp (Exim 4.80.1 #2 (Red Hat Linux)) id 1UUlP2-0004Qj-2C; Tue, 23 Apr 2013 22:09:32 +0000 Received: from mic92-1-81-57-185-249.fbx.proxad.net ([81.57.185.249] helo=smtp.natisbad.org) by merlin.infradead.org with esmtp (Exim 4.80.1 #2 (Red Hat Linux)) id 1UUlP0-0004QQ-4y for linux-arm-kernel@lists.infradead.org; Tue, 23 Apr 2013 22:09:30 +0000 Received: by smtp.natisbad.org (Postfix, from userid 5001) id 189012C0556; Wed, 24 Apr 2013 00:09:28 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=simple/simple; d=natisbad.org; s=mail; t=1366754969; bh=9o6Rrm59uPrNQuxmE3KxQbaGW+NT366+oh5BiOEFTH4=; h=From:To:Cc:Subject:In-Reply-To:References:References:Date; b=0lQoogxvawoetkEaNEIzFlSFC7cHU0h+207Je5GZ+fcc2hU1svZaoluO31kD7Bs96 TkinqX++AyA/Sk4FuOn3VuYOTYE4s3G5g/OkFgzlJsXMqt446lJXPNM39fzRBowVZz tVVwlnJkAVr83VUZ9Jsi0T1hFoya6SrUMmddRGnw= X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on petit X-Spam-Level: X-Spam-Status: No, score=-1.0 required=5.0 tests=ALL_TRUSTED, T_DKIM_INVALID autolearn=unavailable version=3.3.2 Received: from small (localhost [127.0.0.1]) by smtp.natisbad.org (Postfix) with ESMTP id 862062C03D0; Wed, 24 Apr 2013 00:06:20 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=simple/simple; d=natisbad.org; s=mail; t=1366754780; bh=9o6Rrm59uPrNQuxmE3KxQbaGW+NT366+oh5BiOEFTH4=; h=From:To:Cc:Subject:In-Reply-To:References:References:Date; b=BFxqe3TpqxOs4++V03ff6eZM0dTADHagSdZZknuAYeVZH009ch+KITw6n7bTC2PZM FGVRV0ojx1I7gtBfAOFxrDpNOfaaQNaSc2nKPL+jQqPCrmMZYmwM0rKwrW0xhIMqEz trfIfuLEAA4WXCgp8slb2NTtwPeE8vb3par09KiA= From: arno@natisbad.org (Arnaud Ebalard) To: Guenter Roeck Subject: [PATCHv1 3/3] hwmon: Add DT documentation for g762 driver In-Reply-To: References: <4f4a821bbc61e2da28fd70553fd717ada255097d.1366322287.git.arno@natisbad.org> <20130419043555.GA14124@roeck-us.net> References: Message-Id: <6ee748f450ba2a80c87aba08c0672105e2800f93.1366753420.git.arno@natisbad.org> X-PGP-Key-URL: http://natisbad.org/arno@natisbad.org.asc X-Fingerprint: D3A5 B68A 839B 38A5 815A 781B B77C 0748 A7AE 341B X-Hashcash: 1:20:130423:olivier.mouchet@gmail.com::ExpCwhdjL7QO/FYr:000000000000000000000000000000000000167l X-Hashcash: 1:20:130423:devicetree-discuss@lists.ozlabs.org::jEigHwkK6XBSVaLX:000000000000000000000000000cmy X-Hashcash: 1:20:130423:linux@roeck-us.net::4BOGSIfbKC46hcTH:00000000000000000000000000000000000000000001iim X-Hashcash: 1:20:130423:jason@lakedaemon.net::J5HFlPAh77sC9eN+:0000000000000000000000000000000000000000020kr X-Hashcash: 1:20:130423:rob.herring@calxeda.com::Ph2WmsqkW9VV4qBA:000000000000000000000000000000000000002AzF X-Hashcash: 1:20:130423:linux@arm.linux.org.uk::pDm6PmkRK4Y9jCrj:0000000000000000000000000000000000000002vR0 X-Hashcash: 1:20:130423:simon.guinot@sequanux.org::m3mL9UVy16J2f8Ji:0000000000000000000000000000000000003kNv X-Hashcash: 1:20:130423:linux-doc@vger.kernel.org::ACx0aKLHRmULB+pr:0000000000000000000000000000000000004Bo8 X-Hashcash: 1:20:130423:rob@landley.net::zV8+OW6TrHxjE+Vv:0051uT X-Hashcash: 1:20:130423:grant.likely@secretlab.ca::+8X0DYXtQGEKQfzO:0000000000000000000000000000000000005Qx8 X-Hashcash: 1:20:130423:andrew@lunn.ch::8dpVgGP1ZAVYQYun:0006aIq X-Hashcash: 1:20:130423:linux-arm-kernel@lists.infradead.org::0+8yR/6Yk29OLfL7:00000000000000000000000008VZ4 X-Hashcash: 1:20:130423:khali@linux-fr.org::SirokdDPyVgb4mJq:00000000000000000000000000000000000000000009YrQ X-Hashcash: 1:20:130423:lm-sensors@lm-sensors.org::4aj7lw0+gbo+92Q9:0000000000000000000000000000000000009iTV Date: Wed, 24 Apr 2013 00:06:20 +0200 User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.2 (gnu/linux) MIME-Version: 1.0 X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20130423_180930_474969_9A5A78F3 X-CRM114-Status: GOOD ( 12.98 ) X-Spam-Score: -1.0 (-) X-Spam-Report: SpamAssassin version 3.3.2 on merlin.infradead.org summary: Content analysis details: (-1.0 points) pts rule name description ---- ---------------------- -------------------------------------------------- -0.0 SPF_PASS SPF: sender matches SPF record -1.9 BAYES_00 BODY: Bayes spam probability is 0 to 1% [score: 0.0000] -0.1 DKIM_VALID_AU Message has a valid DKIM or DK signature from author's domain 0.1 DKIM_SIGNED Message has a DKIM or DK signature, not necessarily valid -0.1 DKIM_VALID Message has at least one valid DKIM or DK signature 1.0 RDNS_DYNAMIC Delivered to internal network by host with dynamic-looking rDNS Cc: Andrew Lunn , Russell King - ARM Linux , Jason Cooper , linux-doc@vger.kernel.org, devicetree-discuss@lists.ozlabs.org, Olivier Mouchet , Rob Herring , lm-sensors@lm-sensors.org, Grant Likely , Rob Landley , Jean Delvare , Linux ARM Kernel Mailing List , Simon Guinot X-BeenThere: linux-arm-kernel@lists.infradead.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: "linux-arm-kernel" Errors-To: linux-arm-kernel-bounces+patchwork-linux-arm=patchwork.kernel.org@lists.infradead.org Signed-off-by: Arnaud Ebalard --- Documentation/devicetree/bindings/hwmon/g762.txt | 57 ++++++++++++++++++++++ 1 file changed, 57 insertions(+) create mode 100644 Documentation/devicetree/bindings/hwmon/g762.txt diff --git a/Documentation/devicetree/bindings/hwmon/g762.txt b/Documentation/devicetree/bindings/hwmon/g762.txt new file mode 100644 index 0000000..87d7cf5 --- /dev/null +++ b/Documentation/devicetree/bindings/hwmon/g762.txt @@ -0,0 +1,57 @@ +GMT G762/G763 PWM Fan controller + +Required node properties: + + - "compatible": must be either "gmt,g762" or "gmt,g763" + - "reg": I2C bus address of the device + +Optional properties: + + - "pwm_mode": fan driving mode. 1 for PWM mode, 0 for linear. Default + value is 0, i.e. linear. + + - "pwm_enable": fan speed control. 1 for open-loop, 2 for closed-loop. + Default value is 2, i.e. closed-loop. + + - "pwm_freq": reference clock frequency for PWM mode in Hz. Default is + 32768. + + - "fan_pulses": number of pulses per fan revolution. Supported values + are 2 and 4. Default is 2. + + - "fan_div": fan clock frequency divisor value. Supported values are 1, + 2, 4 and 8. Default is 1. + + - "fan_target": initial target fan speed in RPM. By default, current + value is not modified. Only works in closed-loop fan speed + control, i.e. when pwm_enable has already been set to 2. + + - "fan_startv": fan startup voltage. Accepted values are 0, 1, 2 and 3. + Default value is 1. The higher the more. + + - "pwm_polarity": pwm polarity. Accepted values are 0 (positive duty) + and 1 (negative duty). Default is 0 i.e. positive duty. + + - "fan_gear_mode": fan gear mode. Supported values are 0, 1 and 2. + Default is 0. + + +Additional information on operational parameters for the device is available +in Documentation/hwmon/g762. A detailed datasheet for the device is available +at http://natisbad.org/NAS/refs/GMT_EDS-762_763-080710-0.2.pdf. + +Example g762 node: + + g762: g762@3e { + compatible = "gmt,g762"; + reg = <0x3e>; + pwm_mode = <1>; /* closed-loop control */ + pwm_enable = <2>; /* PWM mode */ + pwm_freq = <8192>; /* PWM reference clock freq */ + fan_pulses = <2>; /* 2 pulses per rev */ + fan_div = <2>; /* fan clock divisor */ + fan_target = <2000>; /* target fan speed at 2000 RPM */ + fan_gear_mode = <0>; /* default */ + fan_startv = <1>; /* default */ + pwm_polarity = <0>; /* default */ + };