From patchwork Tue Feb 28 20:14:03 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Rick Altherr X-Patchwork-Id: 9596813 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 442C860429 for ; Tue, 28 Feb 2017 21:01:13 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 3646928583 for ; Tue, 28 Feb 2017 21:01:13 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id 2A2CB28588; Tue, 28 Feb 2017 21:01:13 +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_ADSP_CUSTOM_MED, 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 B982028583 for ; Tue, 28 Feb 2017 21:01:12 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1751531AbdB1Uqr (ORCPT ); Tue, 28 Feb 2017 15:46:47 -0500 Received: from mail-pg0-f46.google.com ([74.125.83.46]:34424 "EHLO mail-pg0-f46.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1751378AbdB1Uqp (ORCPT ); Tue, 28 Feb 2017 15:46:45 -0500 Received: by mail-pg0-f46.google.com with SMTP id p5so10146116pga.1 for ; Tue, 28 Feb 2017 12:45:35 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=20161025; h=from:to:subject:date:message-id; bh=JTaVhHaLtf/YvRh8hdQ0sS2L4f/TVjLqq4zBe2Pb9N4=; b=WWyZt7kBNb7Hqn1KnbhCdxRWtQajpiUIPEN6TM9SW8aXvmHJhJ0ywNxVfTzIMk+l9I EQacjQf494P1/F5CnTFeVnHp+UQczLO8BjT9jMIWYgQsUVCPpEAbHHpNeNYqI8XE2GoC nfLPvI3+wBpOJutbCGGPRtFgZN8EdRqTe7lvvRMX5oDKdHMXtO4dC+kuXW0Tdh4flKL9 f/ASSRc3WMkihNhOO2DtXfxY+xUUxDZCICV0oAHE08fQj7heZ0MS9eSy5pHhfg3CE8m8 JLNoI+2qIPyM4XWdAK5GvxGrFoyhJwI07g5Ilgf7PZo8bBpyP//uYeKS9LAZZTPbf1OE J2yw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:subject:date:message-id; bh=JTaVhHaLtf/YvRh8hdQ0sS2L4f/TVjLqq4zBe2Pb9N4=; b=hSVn8HcdsFHfxJ5bNm30XXN8m4F8HNvrjyFaHaFgxI9CmmcYVZ8y1yRk/1IWUY/dyy uS7lg1tu46/r+jWfvd9JBVV7EWJoPoBP/BI4ipfXHTgZkDWWhKuwxn0MjeHWeS8LSG5Q O6bYZ9HO+rpvi6e2z35xaXVH76WZWkhq//yvNMghxyYr3xPjQqAXLs+dGhexnhzyYnao lcJTRiHC3cf9//6KGuTMXHPJqJ2Ki4BoNo8ycoPMklOhpVgKZfxhcRG5HIFyaloeCBRn bHKreEVGBpafHU+Kj9soM1rWKTj9s2V3qWCdvYXNragSyQn+HFZVZQJyEiBNmgJVTbsc 9x8A== X-Gm-Message-State: AMke39ljJiV9VMwdEntWGFUj3Bs6SFKTCw6nnVQCL4N5DPWwazxuvZfiQaxlNnN/NAUAn/6z X-Received: by 10.99.99.1 with SMTP id x1mr4438661pgb.134.1488312846721; Tue, 28 Feb 2017 12:14:06 -0800 (PST) Received: from raltherr-linux.svl.corp.google.com ([100.123.242.49]) by smtp.gmail.com with ESMTPSA id m12sm5877895pgc.46.2017.02.28.12.14.05 (version=TLS1_2 cipher=ECDHE-RSA-AES128-SHA bits=128/128); Tue, 28 Feb 2017 12:14:06 -0800 (PST) From: Rick Altherr To: robh+dt@kernel.org, mark.rutland@arm.com, devicetree@vger.kernel.org, jdelvare@suse.com, linux@roeck-us.net, joel@jms.id.au, linux-hwmon@vger.kernel.org, linux-kernel@vger.kernel.org Subject: [PATCH 1/2] Documentation: dt-bindings: Document bindings for Aspeed AST2400/AST2500 ADC Date: Tue, 28 Feb 2017 12:14:03 -0800 Message-Id: <20170228201404.32125-1-raltherr@google.com> X-Mailer: git-send-email 2.11.0.483.g087da7b7c-goog 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: Rick Altherr Acked-by: Joel Stanley --- .../devicetree/bindings/hwmon/aspeed_adc.txt | 48 ++++++++++++++++++++++ 1 file changed, 48 insertions(+) create mode 100644 Documentation/devicetree/bindings/hwmon/aspeed_adc.txt diff --git a/Documentation/devicetree/bindings/hwmon/aspeed_adc.txt b/Documentation/devicetree/bindings/hwmon/aspeed_adc.txt new file mode 100644 index 000000000000..9e481668c4d3 --- /dev/null +++ b/Documentation/devicetree/bindings/hwmon/aspeed_adc.txt @@ -0,0 +1,48 @@ +Aspeed AST2400/2500 ADC + +This device is a 10-bit converter for 16 voltage channels. All inputs are +single ended. Each channel can be individually enabled to allow for use of +alternate pin functions. + +1) adc node + + Required properties: + - compatible : Should be one of + "aspeed,ast2400-adc" + "aspeed,ast2500-adc" + - reg : memory window mapping address and length + - #address-cells : must be <1> corresponding to the channel child binding + - #size-cells : must be <0> corresponding to the channel child binding + - clocks : Input clock used to derive the sample clock. Expected to be the + SoC's APB clock. + - update-interval-ms : initial time between updates on a channel + + The node contains child nodes for each channel that the platform uses. + + Example adc node: + adc@1e6e9000 { + #address-cells = <1>; + #size-cells = <0>; + compatible = "aspeed,ast2400-adc"; + reg = <0x1e6e9000 0xB0>; + clocks = <&clk_apb>; + update-interval-ms = <100>; + + [ child node definitions... ] + }; + +2) channel nodes + + Optional properties: + - status: indicates the operational status of the device. + Value must be either "disabled" or "okay". + - label : string describing the monitored value + + Example channel node: + channel@1 { + status = "okay"; + label = "3V3 rail"; + + pinctrl-names = "default"; + pinctrl-0 = <&pinctrl_adc0_default>; + };