From patchwork Tue Apr 4 19:20:34 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: John Muir X-Patchwork-Id: 9662481 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 1F7B86032D for ; Tue, 4 Apr 2017 19:21:18 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 1203728507 for ; Tue, 4 Apr 2017 19:21:18 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id 06E6528546; Tue, 4 Apr 2017 19:21:18 +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.3 required=2.0 tests=BAYES_00,DKIM_SIGNED, RCVD_IN_DNSWL_HI, RCVD_IN_SORBS_SPAM, T_DKIM_INVALID autolearn=ham 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 77B2728507 for ; Tue, 4 Apr 2017 19:21:17 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1755251AbdDDTVR (ORCPT ); Tue, 4 Apr 2017 15:21:17 -0400 Received: from mail-pg0-f67.google.com ([74.125.83.67]:33195 "EHLO mail-pg0-f67.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1755272AbdDDTVP (ORCPT ); Tue, 4 Apr 2017 15:21:15 -0400 Received: by mail-pg0-f67.google.com with SMTP id 79so39261662pgf.0 for ; Tue, 04 Apr 2017 12:21:15 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=jmuir.com; s=jmuirsoft; h=from:to:cc:subject:date:message-id:in-reply-to:references; bh=3K0PZyzLepbT30ieqkf20U4ekIyrk1giaZNbZeYjmmE=; b=WpFpuh73EL+ez6a3syYbill1IhPQY84eIzoojBxLJZqb7mgHaei4gS+o6DzgiBfvxV Oi/wCRb4turfC2k56PnUoksRPNlx5qWMdkWCvEl1E4nndLjdPV91l4wryfuiVKgN4jdO FzsT69nD+R+Xu9wbvSWkRXghSl+II/RalFrsc= X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references; bh=3K0PZyzLepbT30ieqkf20U4ekIyrk1giaZNbZeYjmmE=; b=XtUdxcZ1gOsKD16ba6klhyIjvVksAhc3A/OE2RCBApclqEfRUbz2ByWAgNtyn515oL k8R8oEk80DOT+rcghalWkGkRMy8IbJJ5cBpkQSkccYj4zTfxwtNxThq822qeXjagO13y QRiecNhN5KUL6QnWViZaVi08rA9EmZcNCsySzJe/mHYpBe+/7Y9sy8hJXRa/jgOnSYt3 hDjXK40x90sS4mXBeZQG8QDZcxWII29eM8hDthhr/wRifhgxkhK11eOArxJNveiQKQQW 2E1NFPTid066pP/P7SzWzz+uzg2g84BwVivPH8qZ6aXuCJAU73Wf3x0XDIgBvi3Qc5zL xMgQ== X-Gm-Message-State: AFeK/H2mqSM2AZoRwJ4k+NCx5+Ywz02GN9OKBPdBhQLlM1WpVBuC53YYyzN+v9T8MZV+Ag== X-Received: by 10.84.129.195 with SMTP id b61mr30970289plb.83.1491333674665; Tue, 04 Apr 2017 12:21:14 -0700 (PDT) Received: from muirj2.mtv.corp.google.com ([172.22.140.82]) by smtp.gmail.com with ESMTPSA id w129sm33113411pfb.130.2017.04.04.12.21.13 (version=TLS1_2 cipher=ECDHE-RSA-AES128-SHA bits=128/128); Tue, 04 Apr 2017 12:21:14 -0700 (PDT) From: John Muir To: Jean Delvare , Guenter Roeck , Jonathan Corbet , Rob Herring , Pawel Moll , Ian Campbell , Kumar Gala , devicetree@vger.kernel.org, linux-hwmon@vger.kernel.org, linux-doc@vger.kernel.org Cc: John Muir , Anatol Pomazau , Mark Segal Subject: [PATCH 2/2] devicetree: Document the max31760 device binding. Date: Tue, 4 Apr 2017 12:20:34 -0700 Message-Id: <20170404192034.158901-3-john@jmuir.com> X-Mailer: git-send-email 2.12.2.715.g7642488e1d-goog In-Reply-To: <20170404192034.158901-1-john@jmuir.com> References: <20170404192034.158901-1-john@jmuir.com> 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 Signed-off-by: John Muir --- .../devicetree/bindings/hwmon/max31760.txt | 58 ++++++++++++++++++++++ 1 file changed, 58 insertions(+) create mode 100644 Documentation/devicetree/bindings/hwmon/max31760.txt diff --git a/Documentation/devicetree/bindings/hwmon/max31760.txt b/Documentation/devicetree/bindings/hwmon/max31760.txt new file mode 100644 index 000000000000..43787a77c322 --- /dev/null +++ b/Documentation/devicetree/bindings/hwmon/max31760.txt @@ -0,0 +1,58 @@ +MAX31760 fan controller +----------------------- + +This device supports I2C only. Many properties of this device are configurable +thorugh the hwmon interface. See also Documentation/hwmon/max31760. + +Required node properties: +- compatible : "maxim,max31760" +- reg : The I2C address of the device. This is 0x50 - 0x57 depending on the + hardware configuration. + +Optional node properties: +- maxim,fan1-enabled - 1 to enable, 0 to disable. Default: 1. +- maxim,fan2-enabled - 1 to enable, 0 to disable. Default: 1. +- maxim,fan1-label - String: Hwmon fan1_label. +- maxim,fan2-label - String: Hwmon fan2_label. +- maxim,fan-fail-full-only - Set to 1 to assert a fan failure only when the + PWM is at 100%. Default: 0. +- maxim,fan-rd-signal - Set to 1 if fan(s) provide a rotation + detection (RD) signal, or 0 if the fan + generates square-wave pulses. Default: 0. +- maxim,fan-rd-polarity - 0: RD is low when the fan is running. + 1: RD is high when the fan is running. + Only relevant when fan-rd-signal is 1. + Default: 0. +- maxim,fan-signal-enabled - Set to 1 if externally driving FF/FS low + should force PWM output to 100%. Default: 0. +- maxim,fan-spin-up-enabled - For fan startup: Set to 1 to set the PWM to + 100% until tach is detected or two seconds + have passed before reducing to the target + value. Default: 0. +- maxim,pwm-polarity - 0: 100% PWM is when PWM is high. + 1: 100% PWM is when PWM is low. + Default: 0. +- maxim,pwm-pulse-stretch-enabled + - 1 to enable PWM pulse stretching, 0 to + disable. Default: 0. +- maxim,pwm-zero-fan-can-fail - 0: Fan failure detection disabled when PWM is + ramping to 0%. + 1: Fan failure detection enabled for all PWM + values. + Default: 0. +- maxim,temp1-label - String: Hwmon temp1_label. +- maxim,temp2-label - String: Hwmon temp2_label. +- maxim,temp2-ideality - Set ideality factor for the remote temperature + sensor. Integer with range 0 to 63, + representing a multiplication factor of 0.9844 + to 1.0489. Default: 24 (1.0080). + +Example: + max31760@50 { + compatible = "maxim,max31760"; + reg = <0x50>; + maxim,fan1-label = "Left"; + maxim,fan2-label = "Right"; + maxim,fan-spin-up-enabled = <1>; + maxim,temp2-label = "CPU"; + };