From patchwork Sun Jun 2 20:14:43 2013 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Arnaud Ebalard X-Patchwork-Id: 2649921 Return-Path: X-Original-To: patchwork-linux-arm@patchwork.kernel.org Delivered-To: patchwork-process-083081@patchwork2.kernel.org Received: from casper.infradead.org (casper.infradead.org [85.118.1.10]) by patchwork2.kernel.org (Postfix) with ESMTP id 2247FDFB78 for ; Sun, 2 Jun 2013 20:18:12 +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 1UjEiY-0004eb-KE; Sun, 02 Jun 2013 20:17:31 +0000 Received: from localhost ([::1] helo=merlin.infradead.org) by merlin.infradead.org with esmtp (Exim 4.80.1 #2 (Red Hat Linux)) id 1UjEiO-0000Gv-2W; Sun, 02 Jun 2013 20:17:20 +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 1UjEiL-0000Fb-4g for linux-arm-kernel@lists.infradead.org; Sun, 02 Jun 2013 20:17:17 +0000 Received: by smtp.natisbad.org (Postfix, from userid 5001) id CBE622C0521; Sun, 2 Jun 2013 22:16:55 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=simple/simple; d=natisbad.org; s=mail; t=1370204215; bh=ggpTo0WHXwa1/qzRugL3nK3a2uBc9ryV/530igaqxVI=; h=From:To:Cc:Subject:In-Reply-To:References:Date; b=B7vRp4WkSdSy3csTZDmUSbA2ZBY6nJeMBMrG84xUsE1c2e3yMFUzI4hvctWq84cEs /0T7DY4mB6NFxFP5dWOWLXlZnAV5608iIYaWKrgLl2TDjB7uqhF4qTkHcaev0eLi3G EZGP5TiQ8eE2Vcv8qlb3hIq3qplAymXtc32IQ7ko= 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 F26162C057E; Sun, 2 Jun 2013 22:13:17 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=simple/simple; d=natisbad.org; s=mail; t=1370203998; bh=ggpTo0WHXwa1/qzRugL3nK3a2uBc9ryV/530igaqxVI=; h=From:To:Cc:Subject:In-Reply-To:References:Date; b=b9XxUJWtzsSHMgiRP9c/Jrr3/gM6pu0X98zRpk7sm8KQvV2TCVbe6sANT2tuOwywO L//ZBmnOvwZZ9Jcaj3LWCucy5XV+snDpD7jaC8J74PmO0bmGMcdK9YJ298eI5XY1Zv DjZz3kudSPU9lJXTTdzcQXL0Sf2hENIN2ZBSN4rk= X-Hashcash: 1:20:130602:linux@roeck-us.net::emndPlig7rFJNP1+:00000000000000000000000000000000000000000002DJW X-Hashcash: 1:20:130602:khali@linux-fr.org::Gd0e5Pja7tKd0v1i:00000000000000000000000000000000000000000002cY7 X-Hashcash: 1:20:130602:grant.likely@secretlab.ca::W2ckXTtwdSd09nOx:000000000000000000000000000000000000203I X-Hashcash: 1:20:130602:rob.herring@calxeda.com::7WB+XekhKd2a/1yf:000000000000000000000000000000000000001BbU X-Hashcash: 1:20:130602:lm-sensors@lm-sensors.org::sBTxWFo+tjo/q08Z:0000000000000000000000000000000000003Pue X-Hashcash: 1:20:130602:devicetree-discuss@lists.ozlabs.org::YtCjjWJegRB4M99h:00000000000000000000000000FB3B X-Hashcash: 1:20:130602:rob@landley.net::A1LiENQRjGehxxCx:008I5y X-Hashcash: 1:20:130602:linux-doc@vger.kernel.org::kAod/mFmxc4Gi5sf:0000000000000000000000000000000000002u2w X-Hashcash: 1:20:130602:linux-arm-kernel@lists.infradead.org::0loqxwIF3PQ263iu:00000000000000000000000003m+K X-Hashcash: 1:20:130602:linux@arm.linux.org.uk::dNcWb0Gd4cFz3hZ+:0000000000000000000000000000000000000006Q2T X-Hashcash: 1:20:130602:andrew@lunn.ch::98ZJgEScyHUShW6g:0004UyI X-Hashcash: 1:20:130602:jason@lakedaemon.net::9ZdbBPMC90oPvXlE:0000000000000000000000000000000000000000030+S X-Hashcash: 1:20:130602:simon.guinot@sequanux.org::ZVJCFZIR9Cqb57ZH:0000000000000000000000000000000000000/bE X-Hashcash: 1:20:130602:olivier.mouchet@gmail.com::iyeE63OqzadZDvQJ:0000000000000000000000000000000000004Zdk From: Arnaud Ebalard To: Guenter Roeck Subject: [PATCHv3 3/3] Add DT bindings documentation for g762 driver In-Reply-To: References: Message-Id: <4ba30c5af4e25c5d7d263b0f927aa9373a300bfa.1370202835.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 Date: Sun, 02 Jun 2013 22:14:43 +0200 User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.3 (gnu/linux) MIME-Version: 1.0 X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20130602_161717_454756_0AD4AFBA X-CRM114-Status: GOOD ( 13.39 ) 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 | 58 ++++++++++++++++++++++ 1 file changed, 58 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..3f7ccbf --- /dev/null +++ b/Documentation/devicetree/bindings/hwmon/g762.txt @@ -0,0 +1,58 @@ +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 DC mode. + + - "pwm_enable": fan speed control. 1 for open-loop, 2 for closed-loop. + + - "pwm_freq": reference clock frequency for PWM mode in Hz. If not set, + default value is 32768. + + - "fan_pulses": number of pulses per fan revolution. Supported values + are 2 and 4. + + - "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. 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. + The higher the more. + + - "pwm_polarity": pwm polarity. Accepted values are 0 (positive duty) + and 1 (negative duty). + + - "fan_gear_mode": fan gear mode. Supported values are 0, 1 and 2. + +If an optional property is not set in .dts file, then current value is kept +unmodified (e.g. u-boot installed value). + + +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>; /* chip default */ + fan_startv = <1>; /* chip default */ + pwm_polarity = <0>; /* chip default */ + }; +