From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-16.8 required=3.0 tests=BAYES_00, HEADER_FROM_DIFFERENT_DOMAINS,INCLUDES_CR_TRAILER,INCLUDES_PATCH, MAILING_LIST_MULTI,SPF_HELO_NONE,SPF_PASS,USER_AGENT_GIT autolearn=unavailable autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id CF6C6C4320E for ; Tue, 31 Aug 2021 07:15:57 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by mail.kernel.org (Postfix) with ESMTP id B70DD60E98 for ; Tue, 31 Aug 2021 07:15:57 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S239727AbhHaHQu (ORCPT ); Tue, 31 Aug 2021 03:16:50 -0400 Received: from twspam01.aspeedtech.com ([211.20.114.71]:47246 "EHLO twspam01.aspeedtech.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S239550AbhHaHQ1 (ORCPT ); Tue, 31 Aug 2021 03:16:27 -0400 Received: from mail.aspeedtech.com ([192.168.0.24]) by twspam01.aspeedtech.com with ESMTP id 17V6sbmt028256; Tue, 31 Aug 2021 14:54:37 +0800 (GMT-8) (envelope-from billy_tsai@aspeedtech.com) Received: from BillyTsai-pc.aspeed.com (192.168.2.149) by TWMBX02.aspeed.com (192.168.0.24) with Microsoft SMTP Server (TLS) id 15.0.1497.2; Tue, 31 Aug 2021 15:13:34 +0800 From: Billy Tsai To: , , , , , , , , , , , , , CC: Subject: [v5 02/15] dt-bindings: iio: adc: Add ast2600-adc bindings Date: Tue, 31 Aug 2021 15:14:45 +0800 Message-ID: <20210831071458.2334-3-billy_tsai@aspeedtech.com> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20210831071458.2334-1-billy_tsai@aspeedtech.com> References: <20210831071458.2334-1-billy_tsai@aspeedtech.com> MIME-Version: 1.0 Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: 8bit X-Originating-IP: [192.168.2.149] X-ClientProxiedBy: TWMBX02.aspeed.com (192.168.0.24) To TWMBX02.aspeed.com (192.168.0.24) X-DNSRBL: X-MAIL: twspam01.aspeedtech.com 17V6sbmt028256 Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Add device tree bindings document for the aspeed ast2600 adc device driver. Signed-off-by: Billy Tsai --- .../bindings/iio/adc/aspeed,ast2600-adc.yaml | 100 ++++++++++++++++++ 1 file changed, 100 insertions(+) create mode 100644 Documentation/devicetree/bindings/iio/adc/aspeed,ast2600-adc.yaml diff --git a/Documentation/devicetree/bindings/iio/adc/aspeed,ast2600-adc.yaml b/Documentation/devicetree/bindings/iio/adc/aspeed,ast2600-adc.yaml new file mode 100644 index 000000000000..b283c8ca2bbf --- /dev/null +++ b/Documentation/devicetree/bindings/iio/adc/aspeed,ast2600-adc.yaml @@ -0,0 +1,100 @@ +# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/iio/adc/aspeed,ast2600-adc.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: ADC that forms part of an ASPEED server management processor. + +maintainers: + - Billy Tsai + +description: | + • 10-bits resolution for 16 voltage channels. + • The device split into two individual engine and each contains 8 voltage + channels. + • Channel scanning can be non-continuous. + • Programmable ADC clock frequency. + • Programmable upper and lower threshold for each channels. + • Interrupt when larger or less than threshold for each channels. + • Support hysteresis for each channels. + • Built-in a compensating method. + • Built-in a register to trim internal reference voltage. + • Internal or External reference voltage. + • Support 2 Internal reference voltage 1.2v or 2.5v. + • Integrate dividing circuit for battery sensing. + +properties: + compatible: + enum: + - aspeed,ast2600-adc0 + - aspeed,ast2600-adc1 + description: + Their trimming data, which is used to calibrate internal reference volage, + locates in different address of OTP. + + reg: + maxItems: 1 + + clocks: + maxItems: 1 + description: + Input clock used to derive the sample clock. Expected to be the + SoC's APB clock. + + resets: + maxItems: 1 + + "#io-channel-cells": + const: 1 + + vref-supply: + description: + The external regulator supply ADC reference voltage. + + aspeed,int-vref-microvolt: + enum: [1200000, 2500000] + description: + ADC internal reference voltage in microvolts. + + aspeed,battery-sensing: + type: boolean + description: + Inform the driver that last channel will be used to sensor battery. + + aspeed,trim-data-valid: + type: boolean + description: | + The ADC reference voltage can be calibrated to obtain the trimming + data which will be stored in otp. This property informs the driver that + the data store in the otp is valid. + +required: + - compatible + - reg + - clocks + - resets + - "#io-channel-cells" + +additionalProperties: false + +examples: + - | + #include + adc0: adc@1e6e9000 { + compatible = "aspeed,ast2600-adc0"; + reg = <0x1e6e9000 0x100>; + clocks = <&syscon ASPEED_CLK_APB2>; + resets = <&syscon ASPEED_RESET_ADC>; + #io-channel-cells = <1>; + aspeed,int-vref-microvolt = <2500000>; + }; + adc1: adc@1e6e9100 { + compatible = "aspeed,ast2600-adc1"; + reg = <0x1e6e9100 0x100>; + clocks = <&syscon ASPEED_CLK_APB2>; + resets = <&syscon ASPEED_RESET_ADC>; + #io-channel-cells = <1>; + aspeed,int-vref-microvolt = <2500000>; + }; +... -- 2.25.1 From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-17.1 required=3.0 tests=BAYES_00,DKIMWL_WL_HIGH, DKIM_SIGNED,DKIM_VALID,HEADER_FROM_DIFFERENT_DOMAINS,INCLUDES_CR_TRAILER, INCLUDES_PATCH,MAILING_LIST_MULTI,SPF_HELO_NONE,SPF_PASS,USER_AGENT_GIT autolearn=ham autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id 52F0FC432BE for ; Tue, 31 Aug 2021 07:18:09 +0000 (UTC) Received: from bombadil.infradead.org (bombadil.infradead.org [198.137.202.133]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.kernel.org (Postfix) with ESMTPS id 1429C60200 for ; Tue, 31 Aug 2021 07:18:09 +0000 (UTC) DMARC-Filter: OpenDMARC Filter v1.4.1 mail.kernel.org 1429C60200 Authentication-Results: mail.kernel.org; dmarc=none (p=none dis=none) header.from=aspeedtech.com Authentication-Results: mail.kernel.org; spf=none smtp.mailfrom=lists.infradead.org DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=lists.infradead.org; s=bombadil.20210309; h=Sender: Content-Transfer-Encoding:Content-Type:List-Subscribe:List-Help:List-Post: List-Archive:List-Unsubscribe:List-Id:MIME-Version:References:In-Reply-To: Message-ID:Date:Subject:CC:To:From:Reply-To:Content-ID:Content-Description: Resent-Date:Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID: List-Owner; bh=LV9AN8tEPHYZ8V7Z31pf5H33JilRWxVZMfgTHD1fB34=; b=cg6OLhYHVcgouG bclVZ5OgMv6+0krCc7ssiRsBPop9zakpJAkcq9YVDnIbKNZtq/xdGAZfvyV7YblWHIcs44FnoBGXC vTk6lIRpjw+USTmIHlHuSWEwmEd05BrXoMHdA0sJADcD5JjsGCeUW2VGIkhHydszAJoJn7wIs1cmJ RAYkyopsyz34JOHm49GbpYwWiVNeIMs3Y4f5P0lIoLAUYdEtcSIIykpT0ORT/4p7PzB9lxYaeRH15 zX1pNUonnfupi0bDf8FogRCZwNYvfn4hj+Yanuni4uMZOFJUWwXal7SNI882nmUWne1Gol7NTMqWa OMjx55DL6u5mQ8TSVERQ==; Received: from localhost ([::1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.94.2 #2 (Red Hat Linux)) id 1mKxzn-001YGo-HG; Tue, 31 Aug 2021 07:15:48 +0000 Received: from twspam01.aspeedtech.com ([211.20.114.71]) by bombadil.infradead.org with esmtps (Exim 4.94.2 #2 (Red Hat Linux)) id 1mKxy5-001XiE-7a for linux-arm-kernel@lists.infradead.org; Tue, 31 Aug 2021 07:14:07 +0000 Received: from mail.aspeedtech.com ([192.168.0.24]) by twspam01.aspeedtech.com with ESMTP id 17V6sbmt028256; Tue, 31 Aug 2021 14:54:37 +0800 (GMT-8) (envelope-from billy_tsai@aspeedtech.com) Received: from BillyTsai-pc.aspeed.com (192.168.2.149) by TWMBX02.aspeed.com (192.168.0.24) with Microsoft SMTP Server (TLS) id 15.0.1497.2; Tue, 31 Aug 2021 15:13:34 +0800 From: Billy Tsai To: , , , , , , , , , , , , , CC: Subject: [v5 02/15] dt-bindings: iio: adc: Add ast2600-adc bindings Date: Tue, 31 Aug 2021 15:14:45 +0800 Message-ID: <20210831071458.2334-3-billy_tsai@aspeedtech.com> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20210831071458.2334-1-billy_tsai@aspeedtech.com> References: <20210831071458.2334-1-billy_tsai@aspeedtech.com> MIME-Version: 1.0 X-Originating-IP: [192.168.2.149] X-ClientProxiedBy: TWMBX02.aspeed.com (192.168.0.24) To TWMBX02.aspeed.com (192.168.0.24) X-DNSRBL: X-MAIL: twspam01.aspeedtech.com 17V6sbmt028256 X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20210831_001401_732164_CE908429 X-CRM114-Status: GOOD ( 14.05 ) X-BeenThere: linux-arm-kernel@lists.infradead.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: base64 Sender: "linux-arm-kernel" Errors-To: linux-arm-kernel-bounces+linux-arm-kernel=archiver.kernel.org@lists.infradead.org QWRkIGRldmljZSB0cmVlIGJpbmRpbmdzIGRvY3VtZW50IGZvciB0aGUgYXNwZWVkIGFzdDI2MDAg YWRjIGRldmljZQpkcml2ZXIuCgpTaWduZWQtb2ZmLWJ5OiBCaWxseSBUc2FpIDxiaWxseV90c2Fp QGFzcGVlZHRlY2guY29tPgotLS0KIC4uLi9iaW5kaW5ncy9paW8vYWRjL2FzcGVlZCxhc3QyNjAw LWFkYy55YW1sICB8IDEwMCArKysrKysrKysrKysrKysrKysKIDEgZmlsZSBjaGFuZ2VkLCAxMDAg aW5zZXJ0aW9ucygrKQogY3JlYXRlIG1vZGUgMTAwNjQ0IERvY3VtZW50YXRpb24vZGV2aWNldHJl ZS9iaW5kaW5ncy9paW8vYWRjL2FzcGVlZCxhc3QyNjAwLWFkYy55YW1sCgpkaWZmIC0tZ2l0IGEv RG9jdW1lbnRhdGlvbi9kZXZpY2V0cmVlL2JpbmRpbmdzL2lpby9hZGMvYXNwZWVkLGFzdDI2MDAt YWRjLnlhbWwgYi9Eb2N1bWVudGF0aW9uL2RldmljZXRyZWUvYmluZGluZ3MvaWlvL2FkYy9hc3Bl ZWQsYXN0MjYwMC1hZGMueWFtbApuZXcgZmlsZSBtb2RlIDEwMDY0NAppbmRleCAwMDAwMDAwMDAw MDAuLmIyODNjOGNhMmJiZgotLS0gL2Rldi9udWxsCisrKyBiL0RvY3VtZW50YXRpb24vZGV2aWNl dHJlZS9iaW5kaW5ncy9paW8vYWRjL2FzcGVlZCxhc3QyNjAwLWFkYy55YW1sCkBAIC0wLDAgKzEs MTAwIEBACisjIFNQRFgtTGljZW5zZS1JZGVudGlmaWVyOiAoR1BMLTIuMCBPUiBCU0QtMi1DbGF1 c2UpCislWUFNTCAxLjIKKy0tLQorJGlkOiBodHRwOi8vZGV2aWNldHJlZS5vcmcvc2NoZW1hcy9p aW8vYWRjL2FzcGVlZCxhc3QyNjAwLWFkYy55YW1sIworJHNjaGVtYTogaHR0cDovL2RldmljZXRy ZWUub3JnL21ldGEtc2NoZW1hcy9jb3JlLnlhbWwjCisKK3RpdGxlOiBBREMgdGhhdCBmb3JtcyBw YXJ0IG9mIGFuIEFTUEVFRCBzZXJ2ZXIgbWFuYWdlbWVudCBwcm9jZXNzb3IuCisKK21haW50YWlu ZXJzOgorICAtIEJpbGx5IFRzYWkgPGJpbGx5X3RzYWlAYXNwZWVkdGVjaC5jb20+CisKK2Rlc2Ny aXB0aW9uOiB8CisgIOKAoiAxMC1iaXRzIHJlc29sdXRpb24gZm9yIDE2IHZvbHRhZ2UgY2hhbm5l bHMuCisgIOKAoiBUaGUgZGV2aWNlIHNwbGl0IGludG8gdHdvIGluZGl2aWR1YWwgZW5naW5lIGFu ZCBlYWNoIGNvbnRhaW5zIDggdm9sdGFnZQorICBjaGFubmVscy4KKyAg4oCiIENoYW5uZWwgc2Nh bm5pbmcgY2FuIGJlIG5vbi1jb250aW51b3VzLgorICDigKIgUHJvZ3JhbW1hYmxlIEFEQyBjbG9j ayBmcmVxdWVuY3kuCisgIOKAoiBQcm9ncmFtbWFibGUgdXBwZXIgYW5kIGxvd2VyIHRocmVzaG9s ZCBmb3IgZWFjaCBjaGFubmVscy4KKyAg4oCiIEludGVycnVwdCB3aGVuIGxhcmdlciBvciBsZXNz IHRoYW4gdGhyZXNob2xkIGZvciBlYWNoIGNoYW5uZWxzLgorICDigKIgU3VwcG9ydCBoeXN0ZXJl c2lzIGZvciBlYWNoIGNoYW5uZWxzLgorICDigKIgQnVpbHQtaW4gYSBjb21wZW5zYXRpbmcgbWV0 aG9kLgorICDigKIgQnVpbHQtaW4gYSByZWdpc3RlciB0byB0cmltIGludGVybmFsIHJlZmVyZW5j ZSB2b2x0YWdlLgorICDigKIgSW50ZXJuYWwgb3IgRXh0ZXJuYWwgcmVmZXJlbmNlIHZvbHRhZ2Uu CisgIOKAoiBTdXBwb3J0IDIgSW50ZXJuYWwgcmVmZXJlbmNlIHZvbHRhZ2UgMS4ydiBvciAyLjV2 LgorICDigKIgSW50ZWdyYXRlIGRpdmlkaW5nIGNpcmN1aXQgZm9yIGJhdHRlcnkgc2Vuc2luZy4K KworcHJvcGVydGllczoKKyAgY29tcGF0aWJsZToKKyAgICBlbnVtOgorICAgICAgLSBhc3BlZWQs YXN0MjYwMC1hZGMwCisgICAgICAtIGFzcGVlZCxhc3QyNjAwLWFkYzEKKyAgICBkZXNjcmlwdGlv bjoKKyAgICAgIFRoZWlyIHRyaW1taW5nIGRhdGEsIHdoaWNoIGlzIHVzZWQgdG8gY2FsaWJyYXRl IGludGVybmFsIHJlZmVyZW5jZSB2b2xhZ2UsCisgICAgICBsb2NhdGVzIGluIGRpZmZlcmVudCBh ZGRyZXNzIG9mIE9UUC4KKworICByZWc6CisgICAgbWF4SXRlbXM6IDEKKworICBjbG9ja3M6Cisg ICAgbWF4SXRlbXM6IDEKKyAgICBkZXNjcmlwdGlvbjoKKyAgICAgIElucHV0IGNsb2NrIHVzZWQg dG8gZGVyaXZlIHRoZSBzYW1wbGUgY2xvY2suIEV4cGVjdGVkIHRvIGJlIHRoZQorICAgICAgU29D J3MgQVBCIGNsb2NrLgorCisgIHJlc2V0czoKKyAgICBtYXhJdGVtczogMQorCisgICIjaW8tY2hh bm5lbC1jZWxscyI6CisgICAgY29uc3Q6IDEKKworICB2cmVmLXN1cHBseToKKyAgICBkZXNjcmlw dGlvbjoKKyAgICAgIFRoZSBleHRlcm5hbCByZWd1bGF0b3Igc3VwcGx5IEFEQyByZWZlcmVuY2Ug dm9sdGFnZS4KKworICBhc3BlZWQsaW50LXZyZWYtbWljcm92b2x0OgorICAgIGVudW06IFsxMjAw MDAwLCAyNTAwMDAwXQorICAgIGRlc2NyaXB0aW9uOgorICAgICAgQURDIGludGVybmFsIHJlZmVy ZW5jZSB2b2x0YWdlIGluIG1pY3Jvdm9sdHMuCisKKyAgYXNwZWVkLGJhdHRlcnktc2Vuc2luZzoK KyAgICB0eXBlOiBib29sZWFuCisgICAgZGVzY3JpcHRpb246CisgICAgICBJbmZvcm0gdGhlIGRy aXZlciB0aGF0IGxhc3QgY2hhbm5lbCB3aWxsIGJlIHVzZWQgdG8gc2Vuc29yIGJhdHRlcnkuCisK KyAgYXNwZWVkLHRyaW0tZGF0YS12YWxpZDoKKyAgICB0eXBlOiBib29sZWFuCisgICAgZGVzY3Jp cHRpb246IHwKKyAgICAgIFRoZSBBREMgcmVmZXJlbmNlIHZvbHRhZ2UgY2FuIGJlIGNhbGlicmF0 ZWQgdG8gb2J0YWluIHRoZSB0cmltbWluZworICAgICAgZGF0YSB3aGljaCB3aWxsIGJlIHN0b3Jl ZCBpbiBvdHAuIFRoaXMgcHJvcGVydHkgaW5mb3JtcyB0aGUgZHJpdmVyIHRoYXQKKyAgICAgIHRo ZSBkYXRhIHN0b3JlIGluIHRoZSBvdHAgaXMgdmFsaWQuCisKK3JlcXVpcmVkOgorICAtIGNvbXBh dGlibGUKKyAgLSByZWcKKyAgLSBjbG9ja3MKKyAgLSByZXNldHMKKyAgLSAiI2lvLWNoYW5uZWwt Y2VsbHMiCisKK2FkZGl0aW9uYWxQcm9wZXJ0aWVzOiBmYWxzZQorCitleGFtcGxlczoKKyAgLSB8 CisgICAgI2luY2x1ZGUgPGR0LWJpbmRpbmdzL2Nsb2NrL2FzdDI2MDAtY2xvY2suaD4KKyAgICBh ZGMwOiBhZGNAMWU2ZTkwMDAgeworICAgICAgICBjb21wYXRpYmxlID0gImFzcGVlZCxhc3QyNjAw LWFkYzAiOworICAgICAgICByZWcgPSA8MHgxZTZlOTAwMCAweDEwMD47CisgICAgICAgIGNsb2Nr cyA9IDwmc3lzY29uIEFTUEVFRF9DTEtfQVBCMj47CisgICAgICAgIHJlc2V0cyA9IDwmc3lzY29u IEFTUEVFRF9SRVNFVF9BREM+OworICAgICAgICAjaW8tY2hhbm5lbC1jZWxscyA9IDwxPjsKKyAg ICAgICAgYXNwZWVkLGludC12cmVmLW1pY3Jvdm9sdCA9IDwyNTAwMDAwPjsKKyAgICB9OworICAg IGFkYzE6IGFkY0AxZTZlOTEwMCB7CisgICAgICAgIGNvbXBhdGlibGUgPSAiYXNwZWVkLGFzdDI2 MDAtYWRjMSI7CisgICAgICAgIHJlZyA9IDwweDFlNmU5MTAwIDB4MTAwPjsKKyAgICAgICAgY2xv Y2tzID0gPCZzeXNjb24gQVNQRUVEX0NMS19BUEIyPjsKKyAgICAgICAgcmVzZXRzID0gPCZzeXNj b24gQVNQRUVEX1JFU0VUX0FEQz47CisgICAgICAgICNpby1jaGFubmVsLWNlbGxzID0gPDE+Owor ICAgICAgICBhc3BlZWQsaW50LXZyZWYtbWljcm92b2x0ID0gPDI1MDAwMDA+OworICAgIH07Cisu Li4KLS0gCjIuMjUuMQoKCl9fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19f X19fX19fCmxpbnV4LWFybS1rZXJuZWwgbWFpbGluZyBsaXN0CmxpbnV4LWFybS1rZXJuZWxAbGlz dHMuaW5mcmFkZWFkLm9yZwpodHRwOi8vbGlzdHMuaW5mcmFkZWFkLm9yZy9tYWlsbWFuL2xpc3Rp bmZvL2xpbnV4LWFybS1rZXJuZWwK