[PATCH 1/3] dt-bindings: bus: simple-pm-bus: Make clocks and power-domains optional

From: Tony Lindgren
Date: Thu Oct 07 2021 - 08:49:13 EST


Clocks and power domains are not required by the simple-pm-bus driver.
There are buses with read-only registers for clocks and power domains
that are always on.

Even without clocks and power domains configured, simple-pm-bus is still
different from simple-bus as simple-pm-bus enables runtime PM for the bus
driver.

Let's update the binding accordingly as this remove the related warnings
for dt_binding_check for omaps.

Cc: Geert Uytterhoeven <geert+renesas@xxxxxxxxx>
Cc: Rob Herring <robh@xxxxxxxxxx>
Cc: Simon Horman <horms+renesas@xxxxxxxxxxxx>
Cc: Suman Anna <s-anna@xxxxxx>
Signed-off-by: Tony Lindgren <tony@xxxxxxxxxxx>
---
.../devicetree/bindings/bus/simple-pm-bus.yaml | 17 +++++------------
1 file changed, 5 insertions(+), 12 deletions(-)

diff --git a/Documentation/devicetree/bindings/bus/simple-pm-bus.yaml b/Documentation/devicetree/bindings/bus/simple-pm-bus.yaml
--- a/Documentation/devicetree/bindings/bus/simple-pm-bus.yaml
+++ b/Documentation/devicetree/bindings/bus/simple-pm-bus.yaml
@@ -13,10 +13,9 @@ description: |
A Simple Power-Managed Bus is a transparent bus that doesn't need a real
driver, as it's typically initialized by the boot loader.

- However, its bus controller is part of a PM domain, or under the control
- of a functional clock. Hence, the bus controller's PM domain and/or
- clock must be enabled for child devices connected to the bus (either
- on-SoC or externally) to function.
+ However, its bus controller is typically part of a PM domain, or under
+ the control of a functional clock. Without PM domain or functional clock,
+ it still enables runtime PM for the bus driver unlike "simple-bus".

While "simple-pm-bus" follows the "simple-bus" set of properties, as
specified in the Devicetree Specification, it is not an extension of
@@ -43,10 +42,10 @@ properties:

clocks: true
# Functional clocks
- # Required if power-domains is absent, optional otherwise
+ # Typically used if power-domains is absent

power-domains:
- # Required if clocks is absent, optional otherwise
+ # Typically used if clocks is absent
minItems: 1

required:
@@ -55,12 +54,6 @@ required:
- '#size-cells'
- ranges

-anyOf:
- - required:
- - clocks
- - required:
- - power-domains
-
additionalProperties: true

examples:
--
2.33.0