From patchwork Mon Nov 18 06:53:57 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Matti Vaittinen X-Patchwork-Id: 1196533 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Authentication-Results: ozlabs.org; spf=none (no SPF record) smtp.mailfrom=vger.kernel.org (client-ip=209.132.180.67; helo=vger.kernel.org; envelope-from=linux-rtc-owner@vger.kernel.org; receiver=) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=fi.rohmeurope.com Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by ozlabs.org (Postfix) with ESMTP id 47Gfnb0SJbz9sPj for ; Mon, 18 Nov 2019 17:54:10 +1100 (AEDT) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1726826AbfKRGyI (ORCPT ); Mon, 18 Nov 2019 01:54:08 -0500 Received: from mail-lf1-f66.google.com ([209.85.167.66]:38842 "EHLO mail-lf1-f66.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1726476AbfKRGyH (ORCPT ); Mon, 18 Nov 2019 01:54:07 -0500 Received: by mail-lf1-f66.google.com with SMTP id q28so12853002lfa.5; Sun, 17 Nov 2019 22:54:04 -0800 (PST) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:date:from:to:cc:subject:message-id:references :mime-version:content-disposition:in-reply-to:user-agent; bh=ahLvsdtkxH4r9o1n1ZB2HO2oyc7ZYN5pHqG+YF1HOJg=; b=EVkRA5fevranwkUcSWoLgb6Xy1M9o7hALfW9PsEqvurryU1/J7g2aa2p5sbqvzrCYi +rMH0zwv72A0w6PRkO4O/F4/VBebMQr3Y99lBPONPyj3BNSfiJdK4HqJ7uSul75YzTuf qAFcrfHWIb6Fk74PGpmlSgCq9sISQNSr9Gm6CXnNDptzs6CG+96fg9nO6Zmba6iLPJs1 PUOHNwAvGM55ncLRiYMVhk/81AgjyG6KHHdFCyBGMkDsypDQl4f70n6CVPTqq0LLlftp YIp0g3BFpDtRwcjI3vtjQfgm05lOr5Lv3slMf/X0Z8g0O/0YEw/iEea07Etema0UQqDM rIJA== X-Gm-Message-State: APjAAAWHJ8ptqRRL5KFN4d2IFG/Mi/TreUr4i0DqQ35lwtDzCMawgoBG lQ8NyMw554YlzE50OGVn6W8= X-Google-Smtp-Source: APXvYqy0xSSKUleLxXJU4EQM5lRUL/0uQ7/HXhiCgmcEJAoeL5Yw8yn6297cFzl3yLPXhxEnfT+35g== X-Received: by 2002:a19:be92:: with SMTP id o140mr19781083lff.40.1574060043791; Sun, 17 Nov 2019 22:54:03 -0800 (PST) Received: from localhost.localdomain ([213.255.186.46]) by smtp.gmail.com with ESMTPSA id a11sm7697083ljp.97.2019.11.17.22.54.01 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 17 Nov 2019 22:54:03 -0800 (PST) Date: Mon, 18 Nov 2019 08:53:57 +0200 From: Matti Vaittinen To: matti.vaittinen@fi.rohmeurope.com, mazziesaccount@gmail.com Cc: Lee Jones , Jacek Anaszewski , Pavel Machek , Dan Murphy , Rob Herring , Mark Rutland , Liam Girdwood , Mark Brown , Jonathan Corbet , Michael Turquette , Stephen Boyd , Linus Walleij , Bartosz Golaszewski , Alessandro Zummo , Alexandre Belloni , Mauro Carvalho Chehab , Jeff Kirsher , Wolfram Sang , Marek Szyprowski , Heiner Kallweit , Nicholas Mc Guire , Phil Edworthy , linux-leds@vger.kernel.org, devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, linux-doc@vger.kernel.org, linux-clk@vger.kernel.org, linux-gpio@vger.kernel.org, linux-rtc@vger.kernel.org Subject: [PATCH v5 01/16] dt-bindings: regulator: Document ROHM BD71282 regulator bindings Message-ID: References: MIME-Version: 1.0 Content-Disposition: inline In-Reply-To: User-Agent: Mutt/1.12.1 (2019-06-15) Sender: linux-rtc-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-rtc@vger.kernel.org Document ROHM BD71828 PMIC regulator device tree bindings. Signed-off-by: Matti Vaittinen --- No changes from v4 .../regulator/rohm,bd71828-regulator.yaml | 122 ++++++++++++++++++ 1 file changed, 122 insertions(+) create mode 100644 Documentation/devicetree/bindings/regulator/rohm,bd71828-regulator.yaml diff --git a/Documentation/devicetree/bindings/regulator/rohm,bd71828-regulator.yaml b/Documentation/devicetree/bindings/regulator/rohm,bd71828-regulator.yaml new file mode 100644 index 000000000000..c23ec4d8584b --- /dev/null +++ b/Documentation/devicetree/bindings/regulator/rohm,bd71828-regulator.yaml @@ -0,0 +1,122 @@ +# SPDX-License-Identifier: GPL-2.0-only +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/regulator/rohm,bd71828-regulator.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: ROHM BD71828 Power Management Integrated Circuit regulators + +maintainers: + - Matti Vaittinen + +description: | + This module is part of the ROHM BD71828 MFD device. For more details + see Documentation/devicetree/bindings/mfd/rohm,bd71828-pmic.yaml. + + The regulator controller is represented as a sub-node of the PMIC node + on the device tree. + + Regulator nodes should be named to BUCK_ and LDO_. + The valid names for BD71828 regulator nodes are + BUCK1, BUCK2, BUCK3, BUCK4, BUCK5, BUCK6, BUCK7 + LDO1, LDO2, LDO3, LDO4, LDO5, LDO6, LDO7 + +patternProperties: + "^LDO[1-7]$": + type: object + allOf: + - $ref: regulator.yaml# + description: + Properties for single LDO regulator. + + properties: + #Is there a nice way to check the name is same as node name but lower case + regulator-name: + pattern: "^ldo[1-7]$" + description: + should be "ldo1", ..., "ldo7" + + "^BUCK[1-7]$": + type: object + allOf: + - $ref: regulator.yaml# + description: + Properties for single BUCK regulator. + + properties: + #Is there a nice way to check the name is same as node name but lower case + regulator-name: + pattern: "^buck[1-7]$" + description: + should be "buck1", ..., "buck7" + + rohm,dvs-run-voltage: + allOf: + - $ref: "/schemas/types.yaml#/definitions/uint32" + - minimum: 0 + maximum: 3300000 + description: + PMIC default "RUN" state voltage in uV. See below table for + bucks which support this. 0 means disabled. + + rohm,dvs-idle-voltage: + allOf: + - $ref: "/schemas/types.yaml#/definitions/uint32" + - minimum: 0 + maximum: 3300000 + description: + PMIC default "IDLE" state voltage in uV. See below table for + bucks which support this. 0 means disabled. + + rohm,dvs-suspend-voltage: + allOf: + - $ref: "/schemas/types.yaml#/definitions/uint32" + - minimum: 0 + maximum: 3300000 + description: + PMIC default "SUSPEND" state voltage in uV. See below table for + bucks which support this. 0 means disabled. + + rohm,dvs-lpsr-voltage: + allOf: + - $ref: "/schemas/types.yaml#/definitions/uint32" + - minimum: 0 + maximum: 3300000 + description: + PMIC default "LPSR" state voltage in uV. See below table for + bucks which support this. 0 means disabled. + +#Supported default DVS states: +#buck | run | idle | suspend | lpsr +#---------------------------------------------------------------------------- +#1, 2, 6, and 7 | supported | supported | supported (*) +#---------------------------------------------------------------------------- +#3, 4, and 5 | supported (**) +#---------------------------------------------------------------------------- +#(*) LPSR and SUSPEND states use same voltage but both states have own enable / +# disable settings. Voltage 0 can be specified for a state to make regulator +# disabled on that state. +#(**) All states use same voltage but have own enable / disable settings. +# Voltage 0 can be specified for a state to make regulator disabled on that +# state. + + rohm,dvs-runlvl-ctrl: + description: | + buck control is done based on run-level. Regulator is not + individually controllable. See ../mfd/rohm,bd71828-pmic.yaml for + how to specify run-level control mechanism. Only bucks 1, 2, 6 + and 7 support this. + type: boolean + + rohm,dvs-runlevel-microvolts: + minimum: 0 + maximum: 2000000 + maxItems: 4 + description: + Array of voltages for run-levels. First value is for run-level 0, + second for run-level 1 etc. Microvolts. + + required: + - regulator-name + additionalProperties: false +additionalProperties: false