From patchwork Sat Jan 30 16:38:50 2016 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Laxman Dewangan X-Patchwork-Id: 576046 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from mail-ig0-x23c.google.com (mail-ig0-x23c.google.com [IPv6:2607:f8b0:4001:c05::23c]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id E9F9F140BFB for ; Sun, 31 Jan 2016 03:50:56 +1100 (AEDT) Authentication-Results: ozlabs.org; dkim=pass (2048-bit key; unprotected) header.d=googlegroups.com header.i=@googlegroups.com header.b=lxFLv6Ud; dkim-atps=neutral Received: by mail-ig0-x23c.google.com with SMTP id rs1sf2464182igb.0 for ; Sat, 30 Jan 2016 08:50:56 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=googlegroups.com; s=20120806; h=from:to:cc:subject:date:message-id:in-reply-to:references :mime-version:content-type:x-original-sender :x-original-authentication-results:reply-to:precedence:mailing-list :list-id:x-spam-checked-in-group:list-post:list-help:list-archive :sender:list-subscribe:list-unsubscribe; bh=h2XaSuzFdSr/G6JQld3E3z0kCmZaKNv7ogAULs5+MaQ=; b=lxFLv6UdqBtcBdho2C78hEJsaWdZB44TAlCr6JhFD6aJK7yujos+vzdqi7FWFjvJbr 65jjVTu83R5Vewpm4NPKI5apF+SbeHQdlve0aXyB/Q0weNXTiG2QWRG9ErQeVTONlc9F HE9zIiZIMsmUlCu/yVYiAjy+c597yPlB0nvySdDELyDsNbiGtKUN2b9um6SWNf3QF+bo KTt+0R12hd3K6ESjGyPINXLaD7c/LGX9btIZ3bDtFp5jg7m4bCZw7iIIqmOL0l/CLwJc Vvzwe3GkJreSLsgdUnIbWuEfX8ua1cXLjIS/GN4fut6VTTqZEK99G5TxbYSUvssX7UHv QuQA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references:mime-version:content-type:x-original-sender :x-original-authentication-results:reply-to:precedence:mailing-list :list-id:x-spam-checked-in-group:list-post:list-help:list-archive :sender:list-subscribe:list-unsubscribe; bh=h2XaSuzFdSr/G6JQld3E3z0kCmZaKNv7ogAULs5+MaQ=; b=QXmG/XxicITaVBtEbIUJyEg4Ig15IamDln2a092wYKMwb4C8l0xMZsQ1mcPG41XITH Dt1Qs1LwJYIeEHbEtrtFHmTLM10P56E9t+ZXRaQf78hXDJPEMHoQukBFusyYQGKIGP9z qL4S4pmTMe53ZY/OcqXVsgu9RoQG+k/DWsxck/Khgb1tKpDP5CkWA+WlLnI5WxP8FsxR /GxkR0/x8LFQgL3rMLt+ISwRmIND8UosG7cFLTB+pJLnP6IeBf0vGMCbIiDC64U4lI7H gLLyqMRRfRLaLDuO2lmzGf8+TPBKuVKQB8BKjm+eu1MirOzk48pp6w3m27DWvHaPynlU B/ZQ== X-Gm-Message-State: AG10YOS0tyeREcVmBVK8UkioPCTQf0XZ6Ei4w7UwLeoX2KANlZthe21w4zoBZoqjTsXb6g== X-Received: by 10.50.41.5 with SMTP id b5mr61921igl.8.1454172655277; Sat, 30 Jan 2016 08:50:55 -0800 (PST) X-BeenThere: rtc-linux@googlegroups.com Received: by 10.107.12.167 with SMTP id 39ls1648760iom.103.gmail; Sat, 30 Jan 2016 08:50:55 -0800 (PST) X-Received: by 10.107.2.19 with SMTP id 19mr15104844ioc.23.1454172655022; Sat, 30 Jan 2016 08:50:55 -0800 (PST) Received: from hqemgate16.nvidia.com (hqemgate16.nvidia.com. [216.228.121.65]) by gmr-mx.google.com with ESMTPS id 190si2386969pfb.1.2016.01.30.08.50.54 for (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Sat, 30 Jan 2016 08:50:54 -0800 (PST) Received-SPF: pass (google.com: domain of ldewangan@nvidia.com designates 216.228.121.65 as permitted sender) client-ip=216.228.121.65; Received: from hqnvupgp07.nvidia.com (Not Verified[216.228.121.13]) by hqemgate16.nvidia.com id ; Sat, 30 Jan 2016 08:51:01 -0800 Received: from hqemhub03.nvidia.com ([172.20.12.94]) by hqnvupgp07.nvidia.com (PGP Universal service); Sat, 30 Jan 2016 08:51:18 -0800 X-PGP-Universal: processed; by hqnvupgp07.nvidia.com on Sat, 30 Jan 2016 08:51:18 -0800 Received: from ldewanganubuntu-System-Product-Name.nvidia.com (172.20.144.16) by hqemhub03.nvidia.com (172.20.150.15) with Microsoft SMTP Server (TLS) id 8.3.406.0; Sat, 30 Jan 2016 08:50:53 -0800 From: Laxman Dewangan To: , , , , , , , , , , CC: , , , , , , , , , Laxman Dewangan Subject: [rtc-linux] [PATCH V7 7/8] regulator: add DT binding doc for regulator of PMIC max77620/max20024 Date: Sat, 30 Jan 2016 22:08:50 +0530 Message-ID: <1454171931-27752-8-git-send-email-ldewangan@nvidia.com> X-Mailer: git-send-email 2.1.4 In-Reply-To: <1454171931-27752-1-git-send-email-ldewangan@nvidia.com> References: <1454171931-27752-1-git-send-email-ldewangan@nvidia.com> MIME-Version: 1.0 X-Original-Sender: ldewangan@nvidia.com X-Original-Authentication-Results: gmr-mx.google.com; spf=pass (google.com: domain of ldewangan@nvidia.com designates 216.228.121.65 as permitted sender) smtp.mailfrom=ldewangan@nvidia.com Reply-To: rtc-linux@googlegroups.com Precedence: list Mailing-list: list rtc-linux@googlegroups.com; contact rtc-linux+owners@googlegroups.com List-ID: X-Spam-Checked-In-Group: rtc-linux@googlegroups.com X-Google-Group-Id: 712029733259 List-Post: , List-Help: , List-Archive: , List-Unsubscribe: , Maxim Semiconductor's PMIC MAX77620/MAX20024 has multiple DCDCs and LDOs. Add DT binding document to support these regulators via regulator framework. Signed-off-by: Laxman Dewangan Acked-by: Rob Herring --- Changes from V4: - Separate out from regulator driver Changes from V6: - Starting patch tile with regulator instead of DT:regulator - Move all ldo supply to device node level from regulator sub node. .../bindings/regulator/regulator-max77620.txt | 163 +++++++++++++++++++++ 1 file changed, 163 insertions(+) create mode 100644 Documentation/devicetree/bindings/regulator/regulator-max77620.txt diff --git a/Documentation/devicetree/bindings/regulator/regulator-max77620.txt b/Documentation/devicetree/bindings/regulator/regulator-max77620.txt new file mode 100644 index 0000000..caa8255 --- /dev/null +++ b/Documentation/devicetree/bindings/regulator/regulator-max77620.txt @@ -0,0 +1,163 @@ +Regulator DT binding for MAX77620 Power management IC from Maxim Semiconductor. + +Device has multiple DCDC(sd[0-3] and LDOs(ldo[0-8]). The input supply +of these regulators are defined under parent device node and details +of regulator properties are defined under the sub node "regulators" +of parent node. + +Please refer file +for common regulator bindings used by client. + +Following are properties of parent node related to regulators. + +Optional properties: +------------------- +The input supply of regulators are the optional properties on the +parent device node. The input supply of these regulators are provided +through following properties: +in-sd0-supply: Input supply for SD0, INA-SD0 or INB-SD0 pins. +in-sd1-supply: Input supply for SD1. +in-sd2-supply: Input supply for SD2. +in-sd3-supply: Input supply for SD3. +in-ldo0-1-supply: Input supply for LDO0 and LDO1. +in-ldo2-supply: Input supply for LDO2. +in-ldo3-5-supply: Input supply for LDO3 and LDO5 +in-ldo4-6-supply: Input supply for LDO4 and LDO6. +in-ldo7-8-supply: Input supply for LDO7 and LDO8. + + +Optional sub nodes for regulators under "regulators" subnode: +------------------------------------------------------------ +The subnodes name is the name of regulator and it must be one of: + sd[0-3], ldo[0-8] + +Each sub-node should contain the constraints and initialization +information for that regulator. The definition for each of these +nodes is defined using the standard binding for regulators found at +. + +Theres is also additional properties for SD/LDOs. +The properties are required to configure SDs/LDOs FPS parameters +when system is in "active" state or in "suspend" state. +Here "active" state means system is UP and working normally. +"suspend" state means system enters into the suspend state. + +- maxim,active-fps-source: FPS source for the gpios in active state + of the GPIO. Valid values are FPS_SRC_0, + FPS_SRC_1, FPS_SRC_2 and FPS_SRC_NONE. + Absence of this property will leave the pin + on default. +- maxim,active-fps-power-up-slot: Power up slot on given FPS for active state. + Valid values are 0 to 7. +- maxim,active-fps-power-down-slot: Power down slot on given FPS for active + state. Valid values are 0 to 7. +- maxim,suspend-fps-source: Suspend state FPS source. Valid values are + same as maxim,active-fps-source. +- maxim,suspend-fps-power-down-slot: Suspend state power down slot. Valid + values are 0 to 7. +- maxim,suspend-fps-power-up-slot: Suspend state power up slot. Valid values + are 0 to 7. + +Example: +-------- +#include +... +max77620@3c { + in-ldo0-1-supply = <&max77620_sd2>; + in-ldo7-8-supply = <&max77620_sd2>; + regulators { + sd0 { + regulator-name = "vdd-core"; + regulator-min-microvolt = <600000>; + regulator-max-microvolt = <1400000>; + regulator-boot-on; + regulator-always-on; + maxim,active-fps-source = ; + }; + + sd1 { + regulator-name = "vddio-ddr"; + regulator-min-microvolt = <1200000>; + regulator-max-microvolt = <1200000>; + regulator-always-on; + regulator-boot-on; + maxim,active-fps-source = ; + }; + + sd2 { + regulator-name = "vdd-pre-reg"; + regulator-min-microvolt = <1350000>; + regulator-max-microvolt = <1350000>; + }; + + sd3 { + regulator-name = "vdd-1v8"; + regulator-min-microvolt = <1800000>; + regulator-max-microvolt = <1800000>; + regulator-always-on; + regulator-boot-on; + }; + + ldo0 { + regulator-name = "avdd-sys"; + regulator-min-microvolt = <1200000>; + regulator-max-microvolt = <1200000>; + regulator-always-on; + regulator-boot-on; + }; + + ldo1 { + regulator-name = "vdd-pex"; + regulator-min-microvolt = <1050000>; + regulator-max-microvolt = <1050000>; + }; + + ldo2 { + regulator-name = "vddio-sdmmc3"; + regulator-min-microvolt = <1800000>; + regulator-max-microvolt = <3300000>; + }; + + ldo3 { + regulator-name = "vdd-cam-hv"; + regulator-min-microvolt = <2800000>; + regulator-max-microvolt = <2800000>; + }; + + ldo4 { + regulator-name = "vdd-rtc"; + regulator-min-microvolt = <1250000>; + regulator-max-microvolt = <1250000>; + regulator-always-on; + regulator-boot-on; + }; + + ldo5 { + regulator-name = "avdd-ts-hv"; + regulator-min-microvolt = <3000000>; + regulator-max-microvolt = <3000000>; + }; + + ldo6 { + regulator-name = "vdd-ts"; + regulator-min-microvolt = <1800000>; + regulator-max-microvolt = <1800000>; + regulator-always-on; + regulator-boot-on; + }; + + ldo7 { + regulator-name = "vdd-gen-pll-edp"; + regulator-min-microvolt = <1050000>; + regulator-max-microvolt = <1050000>; + regulator-always-on; + regulator-boot-on; + }; + + ldo8 { + regulator-name = "vdd-hdmi-dp"; + regulator-min-microvolt = <1050000>; + regulator-max-microvolt = <1050000>; + }; + }; +};