Received-SPF: pass (google.com: domain of linux-kernel+bounces-142125-linux.lists.archive=gmail.com@vger.kernel.org designates 2604:1380:4601:e00::3 as permitted sender) client-ip=2604:1380:4601:e00::3;
From: Inochi Amaoto <inochiama@outlook.com>
To: Vinod Koul <vkoul@kernel.org>,
	Kishon Vijay Abraham I <kishon@kernel.org>,
	Rob Herring <robh@kernel.org>,
	Krzysztof Kozlowski <krzysztof.kozlowski+dt@linaro.org>,
	Conor Dooley <conor+dt@kernel.org>,
	Chen Wang <unicorn_wang@outlook.com>,
	Inochi Amaoto <inochiama@outlook.com>,
	Paul Walmsley <paul.walmsley@sifive.com>,
	Palmer Dabbelt <palmer@dabbelt.com>,
	Albert Ou <aou@eecs.berkeley.edu>
Cc: Jisheng Zhang <jszhang@kernel.org>,
	Liu Gui <kenneth.liu@sophgo.com>,
	Jingbao Qiu <qiujingbao.dlmu@gmail.com>,
	dlan@gentoo.org,
	linux-phy@lists.infradead.org,
	devicetree@vger.kernel.org,
	linux-kernel@vger.kernel.org,
	linux-riscv@lists.infradead.org
Subject: [PATCH 1/2] dt-bindings: phy: Add Sophgo CV1800 USB phy
Date: Fri, 12 Apr 2024 15:22:24 +0800
Message-ID:
 <IA1PR20MB4953040232A4D41E41F2D2A9BB042@IA1PR20MB4953.namprd20.prod.outlook.com>
In-Reply-To: <IA1PR20MB4953780F4617823F7173B6D6BB042@IA1PR20MB4953.namprd20.prod.outlook.com>
References: <IA1PR20MB4953780F4617823F7173B6D6BB042@IA1PR20MB4953.namprd20.prod.outlook.com>
Content-Transfer-Encoding: 8bit
Content-Type: text/plain
Precedence: bulk
MIME-Version: 1.0
X-MS-Exchange-MessageSentRepresentingType: 1
X-MS-PublicTrafficType: Email
X-MS-TrafficTypeDiagnostic: IA1PR20MB4953:EE_|SN7PR20MB5795:EE_
X-MS-Office365-Filtering-Correlation-Id: 5941c22b-5411-47df-13b7-08dc5ac14524
X-MS-Exchange-SLBlob-MailProps:
	iS5pQZgsAQDmFN0yKEpvbPDpAvl+/SbOPR3B5EqMNpdvaFjcuntyOEwE3y8XB9AvtEJxpjkfn0VgABu0Lq2RbDavDUvzmSQVh8Aqb0/NB5HTUnNXQOdfmeXlPGzzz9HC+qBSUNMUO29Qp5vuhrGcMJ+u/DKx4c8xdAuSmQ/8x4nCQ6U7NA6Ensb3QnrGPB0VQ2UATb/gBBqfBJw0clOF4NpFE0p3g4w+CpIe4RALtihY4Hk4kN3vwrzMpz31iLMhBEueYtjX56aR4zQKpdA5TarKjK/6S8leNF84skql7v1MAkesY5zzxfKpf5ZafSzvC0y2dj5j3UaWdnd4Q9QrUfohoEGRSQ1viQdD2yMDyTPLrX3/69UQI/ok2rajS2bRiInw/kbN+8Z5YslnRuYPj7MR/Y4ZO49Tk7rL7/cwW3Sxkt4qZ+5CrcOXBUCA0qzHhstI6yYfUUtUPchINocXtxU4r+NBo2I1cnUKg1AzX0kjtD9uikqyGee/b/4PWMeQbbk88L/X6tBM6D9IO2z+UIhI6N+K86h0fUctNErSDUr67NcPuKIV1Qs+n7Hh7WWmrZ2litD8Ixi63AdTv1hmct5bYjEn99fS8S1IG+C2Rzw4ANpcgD8BONbh+4Vg0h+QPTZcbKWB8MzbJgwtK42PJkXfgqkqFldc5Kz089vhgRUVXD2JRGp6Pa+fqLgVsxriT63lMT+w2kR7G1fieRuC4WZIU3S08tTfVN30HBKIYmnU2buSRE9zob6YQZPe7TYh5oRcQJPcPZt/4r1Pc75t1Dg2paHN1I265bIxl0GclMHiUc4N4ZsNtfMApjd+BlHB
X-Microsoft-Antispam: BCL:0;
X-Microsoft-Antispam-Message-Info:
	QXW3bLiEDSUj+EUwDOTcbLGgrA9JJxMlYlqpX5ysHR7O/QrYLndE7S9nWqTB21iEoSpIJy/zpEKwlwuaDgbPXsEjEzKN9XIRAOG5yh5FS+lHu9FQ6w3pIgzT8q46Gd4Fx6zjHtyO6Q2Yl3213xwP50dqVbPXmiwPb7LIuhAH/xQkXtSLtaTAjJMubaLXEs8IecvrdmcQ0osCD2n0/3WY9YU8fv1W5S+x+lqN63yQT1RTsG+vM0pHF47aR8maEuBpQwaVoQArNzJXSCRYcuEvm2WNJSB9G174xHoE1Hpf1GfIEYE+Cfuc40XbH2ywR/jRDQ720KejKiZsBQwuDdyHaKhRbJvVAp4+ATRAQvJWpYkWTXjJPBzcgxNA0reyzEpYrZ/4YDqKHic0fTaMR3FDnx8TUb0oto4Ej4mBP/q4ubrs5bqE6XQBL2rOYrKlyn99E6Z2ZmEjY8WqV+OsPnHDm0pOHf+2UXN3GytVxeZ1zz83UIIET5YB7XL0JwHDAlwGF4JNc5r8wrvj7AkmMcWyy5CKv9yRgPwqx3neS/zl0YNY510BnbHgWbVbdzIwjdlvtbPR0D/knlgxiFxFt6sbE2oTpo6qME2IttlCtCPxhx8eFkW7xtHCFd57+Z4rHvf5SIvNFHhBdQ1BDEkW+2tEqd2VW1mdNWHv86R7A7VxLEwK/v+XrCKu7YpzfFp2zDoN
X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1
X-MS-Exchange-AntiSpam-MessageData-0:
	=?us-ascii?Q?e+eZXE/m1HaLa0MG9ICHO98Wk9N8zv5tXnyG3SR+uCJVMP9DdzdME10WrQQw?=
 =?us-ascii?Q?rSkf/iKkiMmhn4btZMi/YsETiR9M/qZLLUdEdpkmvLsIaL5CYTHB0NA/IGks?=
 =?us-ascii?Q?zHgZqOMo48njppmJZKpUKMS5CXFXOrFRniVLVT9dlGV3CKSd2ldDrx5yFGyo?=
 =?us-ascii?Q?x7cnOqQHlJgC/VsXj1YimYrd16z98iw1JhA77EUau644c1tXHwj8uQ6DI7Vz?=
 =?us-ascii?Q?Q3lZPkf3RhjxqJWz02nSFeuI7/GZFySfgAw9tOKyBQX4cO2sngCGpdGsd44L?=
 =?us-ascii?Q?2LGDAP7lNHbFV1Foq3EeQA45dI2da5BKSfvdFpNx4fqCCFfm1+0NHpXOd6HC?=
 =?us-ascii?Q?T85IXE57XGzOGZ3lr58Oj2kgJqzTUS3uW0h6KIRHfsceDDIqCO7aAQN84a9F?=
 =?us-ascii?Q?yVmjKwD/SpJNZPJdgJF6sABzN66hTtv+w1qthI5NcLueYShhPIoSYGx02QDQ?=
 =?us-ascii?Q?AtZ3ECroU3YgDXetfQvhzJoFJrlQLtVQUKARSRhPdndItINqzvWmiymKkBRw?=
 =?us-ascii?Q?/xSLvU8H6YTHVaef2bYa9ZQGQlPpCZT9lPdt+9PG/uecFTvwLHjRmujNuMFm?=
 =?us-ascii?Q?6kamYxtLVcIYyGnJxRoz2d6Es0ypdoKKR+CCF/8o6nxmYAWNUPt+p9AU5Az3?=
 =?us-ascii?Q?ammNtadZivOQVvNNDb4PXvvSDyCtJRe64YG+qejcOO2+Qx86jDj71ayM2IM6?=
 =?us-ascii?Q?lBCn7U0jyhqlRUpjUpqjxLVvuf6DjFGfLpOk2FnRcSZKdIkpl78twHa+X8FF?=
 =?us-ascii?Q?ybqZeponISWiPYCO08ItB5jqCsl+xfgYxVUQCTb4g41pzDHjLLqblvU1tsGW?=
 =?us-ascii?Q?L4dcRphB3ZinLCjTWmV/AKakoc+SnOwRsLX1VV9J3yqd1F4LVOvNlz1MLKQl?=
 =?us-ascii?Q?zO5eoKftr0pxYanreRPtB9tec5lIUbs1UVxJQRml4MCtud5yxRpvGfekfUVb?=
 =?us-ascii?Q?NInYXE/UJnTori21vqKnVCp0+RFpHXsIOiFxPDAga9D0Z1Ic3yjydSfYI1J6?=
 =?us-ascii?Q?6XtZg49/Mts0pqTF1jUFYUNPPn/rFxEX6gkwaJMuv99Hjcvuif0ipUdcXjoQ?=
 =?us-ascii?Q?k7O9nuPhxpu+7XipDts12InXLqP0sa1aJN/dRW1Ps0NAHW/ArVvtJjnpfije?=
 =?us-ascii?Q?VVMMDJZB2YQmlKMl4DFTt9JX2aKMeHR8w2rusArblbvhSJsI4+XpNb1CwNzp?=
 =?us-ascii?Q?uauJwEVl8r7s+5eHg0M1UEFMXUnz1P6ceMZPjhhDkgTj0NKEa9NG/DqmgRRp?=
 =?us-ascii?Q?zyK3al599YEuvOe3fix5?=
X-OriginatorOrg: outlook.com
X-MS-Exchange-CrossTenant-Network-Message-Id: 5941c22b-5411-47df-13b7-08dc5ac14524
X-MS-Exchange-CrossTenant-AuthSource: IA1PR20MB4953.namprd20.prod.outlook.com
X-MS-Exchange-CrossTenant-AuthAs: Internal
X-MS-Exchange-CrossTenant-OriginalArrivalTime: 12 Apr 2024 07:22:11.6444
 (UTC)
X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted
X-MS-Exchange-CrossTenant-Id: 84df9e7f-e9f6-40af-b435-aaaaaaaaaaaa
X-MS-Exchange-CrossTenant-RMS-PersistedConsumerOrg:
	00000000-0000-0000-0000-000000000000
X-MS-Exchange-Transport-CrossTenantHeadersStamped: SN7PR20MB5795

The USB phy of Sophgo CV18XX series SoC needs to sense a pin called
"VBUS_DET" to get the right operation mode. If this pin is not
connected, it only supports setting the mode manually.

Add USB phy bindings for Sophgo CV18XX/SG200X series SoC.

Signed-off-by: Inochi Amaoto <inochiama@outlook.com>
---
 .../bindings/phy/sophgo,cv1800-usb-phy.yaml   | 90 +++++++++++++++++++
 1 file changed, 90 insertions(+)
 create mode 100644 Documentation/devicetree/bindings/phy/sophgo,cv1800-usb-phy.yaml

diff --git a/Documentation/devicetree/bindings/phy/sophgo,cv1800-usb-phy.yaml b/Documentation/devicetree/bindings/phy/sophgo,cv1800-usb-phy.yaml
new file mode 100644
index 000000000000..cb394ac5d8c4
--- /dev/null
+++ b/Documentation/devicetree/bindings/phy/sophgo,cv1800-usb-phy.yaml
@@ -0,0 +1,90 @@
+# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/phy/sophgo,cv1800-usb-phy.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: Sophgo CV18XX/SG200X USB 2.0 PHY
+
+maintainers:
+  - Inochi Amaoto <inochiama@outlook.com>
+
+properties:
+  compatible:
+    const: sophgo,cv1800-usb-phy
+
+  reg:
+    maxItems: 1
+
+  "#phy-cells":
+    const: 0
+
+  clocks:
+    items:
+      - description: PHY clock
+      - description: PHY app clock
+      - description: PHY stb clock
+      - description: PHY lpm clock
+
+  clock-names:
+    items:
+      - const: phy
+      - const: app
+      - const: stb
+      - const: lpm
+
+  dr_mode:
+    description: PHY device mode when initing.
+    enum: [host, peripheral, otg]
+
+  vbus_det-gpios:
+    description: GPIO to the USB OTG VBUS detect pin. This should not be
+      defined if vbus_det gpio and switch gpio are connected.
+    maxItems: 1
+
+  sophgo,switch-gpios:
+    description: GPIO for the phy to control connected switch.
+    maxItems: 2
+
+required:
+  - compatible
+  - "#phy-cells"
+  - clocks
+  - clock-names
+  - dr_mode
+
+allOf:
+  - if:
+      properties:
+        dr_mode:
+          const: otg
+    then:
+      required:
+        - vbus_det-gpios
+
+additionalProperties: false
+
+examples:
+  - |
+    phy@48 {
+      compatible = "sophgo,cv1800-usb-phy";
+      reg = <0x48 0x4>;
+      #phy-cells = <0>;
+      clocks = <&clk 92>, <&clk 93>,
+               <&clk 94>, <&clk 95>;
+      clock-names = "phy", "app", "stb", "lpm";
+      dr_mode = "host";
+    };
+  - |
+    #include <dt-bindings/gpio/gpio.h>
+
+    phy@54 {
+      compatible = "sophgo,cv1800-usb-phy";
+      reg = <0x54 0x4>;
+      #phy-cells = <0>;
+      clocks = <&clk 92>, <&clk 93>,
+               <&clk 94>, <&clk 95>;
+      clock-names = "phy", "app", "stb", "lpm";
+      dr_mode = "otg";
+      vbus_det-gpios = <&portb 6 GPIO_ACTIVE_HIGH>;
+    };
--
2.44.0