[<prev] [next>] [<thread-prev] [thread-next>] [day] [month] [year] [list]
Message-Id: <20250507-batt_ops-v2-1-8d06130bffe6@google.com>
Date: Wed, 07 May 2025 18:00:22 -0700
From: Amit Sunil Dhamne via B4 Relay <devnull+amitsd.google.com@...nel.org>
To: Rob Herring <robh@...nel.org>, Krzysztof Kozlowski <krzk+dt@...nel.org>,
Conor Dooley <conor+dt@...nel.org>,
Greg Kroah-Hartman <gregkh@...uxfoundation.org>,
Badhri Jagan Sridharan <badhri@...gle.com>,
Sebastian Reichel <sre@...nel.org>,
Heikki Krogerus <heikki.krogerus@...ux.intel.com>,
"Rafael J. Wysocki" <rafael@...nel.org>, Len Brown <len.brown@...el.com>,
Pavel Machek <pavel@...nel.org>
Cc: Kyle Tso <kyletso@...gle.com>, devicetree@...r.kernel.org,
linux-kernel@...r.kernel.org, linux-usb@...r.kernel.org,
linux-pm@...r.kernel.org, Amit Sunil Dhamne <amitsd@...gle.com>
Subject: [PATCH v2 1/5] dt-bindings: connector: extend ports property to
model power connections
From: Amit Sunil Dhamne <amitsd@...gle.com>
Extend ports property to model power lines going between connector to
charger or battery/batteries. As an example, connector VBUS can supply
power in & out of the battery for a DRP.
Additionally, add ports property to maxim,max33359 controller example.
Signed-off-by: Amit Sunil Dhamne <amitsd@...gle.com>
---
.../bindings/connector/usb-connector.yaml | 20 +++++++++++------
.../devicetree/bindings/usb/maxim,max33359.yaml | 25 ++++++++++++++++++++++
2 files changed, 38 insertions(+), 7 deletions(-)
diff --git a/Documentation/devicetree/bindings/connector/usb-connector.yaml b/Documentation/devicetree/bindings/connector/usb-connector.yaml
index 11e40d225b9f3a0d0aeea7bf764f1c00a719d615..706094f890026d324e6ece8b0c1e831d04d51eb7 100644
--- a/Documentation/devicetree/bindings/connector/usb-connector.yaml
+++ b/Documentation/devicetree/bindings/connector/usb-connector.yaml
@@ -181,16 +181,16 @@ properties:
port:
$ref: /schemas/graph.yaml#/properties/port
- description: OF graph bindings modeling a data bus to the connector, e.g.
- there is a single High Speed (HS) port present in this connector. If there
- is more than one bus (several port, with 'reg' property), they can be grouped
- under 'ports'.
+ description: OF graph binding to model a logical connection between a device
+ and connector. This connection may represent a data bus or power line. For
+ e.g. a High Speed (HS) data port present in this connector or VBUS line.
+ If there is more than one connection (several port, with 'reg' property),
+ they can be grouped under 'ports'.
ports:
$ref: /schemas/graph.yaml#/properties/ports
- description: OF graph bindings modeling any data bus to the connector
- unless the bus is between parent node and the connector. Since a single
- connector can have multiple data buses every bus has an assigned OF graph
+ description: OF graph bindings to model multiple "port". Since a connector
+ may have multiple logical connections each one has an assigned OF graph
port number as described below.
properties:
@@ -207,6 +207,12 @@ properties:
description: Sideband Use (SBU), present in USB-C. This describes the
alternate mode connection of which SBU is a part.
+ port@3:
+ $ref: /schemas/graph.yaml#/properties/port
+ description: VBUS/VCHGIN present in USB-C connector to model power line
+ going in and/or out of the charger/battery. If there are multiple
+ batteries then this port should contain those many endpoints.
+
required:
- port@0
diff --git a/Documentation/devicetree/bindings/usb/maxim,max33359.yaml b/Documentation/devicetree/bindings/usb/maxim,max33359.yaml
index 3de4dc40b79192b60443421b557bd2fb18683bf7..730d5c1cc9ddf1ddeff055c00ee172745297633d 100644
--- a/Documentation/devicetree/bindings/usb/maxim,max33359.yaml
+++ b/Documentation/devicetree/bindings/usb/maxim,max33359.yaml
@@ -75,6 +75,31 @@ examples:
PDO_FIXED(9000, 2000, 0)>;
sink-bc12-completion-time-ms = <500>;
pd-revision = /bits/ 8 <0x03 0x01 0x01 0x08>;
+ ports {
+ #address-cells = <1>;
+ #size-cells = <0>;
+
+ port@0 {
+ reg = <0>;
+ usbc0_orien_sw: endpoint {
+ remote-endpoint = <&usbdrd31_phy_orien_switch>;
+ };
+ };
+
+ port@1 {
+ reg = <1>;
+ usbc0_role_sw: endpoint {
+ remote-endpoint = <&usbdrd31_dwc3_role_switch>;
+ };
+ };
+
+ port@3 {
+ reg = <3>;
+ vbus_batt: endpoint {
+ remote-endpoint = <&max17201_fg>;
+ };
+ };
+ };
};
};
};
--
2.49.0.987.g0cc8ee98dc-goog
Powered by blists - more mailing lists