Received-SPF: pass (google.com: domain of linux-kernel+bounces-135236-linux.lists.archive=gmail.com@vger.kernel.org designates 139.178.88.99 as permitted sender) client-ip=139.178.88.99;
Date: Mon, 8 Apr 2024 12:51:09 +0200
From: Pavel Machek <pavel@ucw.cz>
To: phone-devel@vger.kernel.org, kernel list <linux-kernel@vger.kernel.org>,
	fiona.klute@gmx.de, martijn@brixit.nl, samuel@sholland.org,
	heikki.krogerus@linux.intel.com, gregkh@linuxfoundation.org,
	linux-usb@vger.kernel.org, robh+dt@kernel.org,
	krzysztof.kozlowski+dt@linaro.org, devicetree@vger.kernel.org,
	megi@xff.cz
Subject: [PATCHv3 1/2] dt-bindings: usb: typec: anx7688: start a binding
 document
Message-ID: <ZhPMHdt6r/4D99Zg@duo.ucw.cz>
Precedence: bulk
MIME-Version: 1.0
Content-Type: multipart/signed; micalg=pgp-sha1;
	protocol="application/pgp-signature"; boundary="xcc0rfiKI+Y+ldks"
Content-Disposition: inline


--xcc0rfiKI+Y+ldks
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable

Add binding for anx7688 usb type-c bridge. I don't have a datasheet,
but I did best I could.

Signed-off-by: Pavel Machek <pavel@ucw.cz>

---

v2: implement review feedback
v3: fix single character pointed by robot

diff --git a/Documentation/devicetree/bindings/usb/analogix,anx7688.yaml b/=
Documentation/devicetree/bindings/usb/analogix,anx7688.yaml
new file mode 100644
index 000000000000..48b9ae936cb5
--- /dev/null
+++ b/Documentation/devicetree/bindings/usb/analogix,anx7688.yaml
@@ -0,0 +1,127 @@
+# SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/usb/analogix,anx7688.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+# Pin names can be deduced from
+# https://files.pine64.org/doc/PinePhone/PinePhone%20v1.2b%20Released%20Sc=
hematic.pdf
+
+title: Analogix ANX7688 Type-C controller
+
+maintainers:
+  - Pavel Machek <pavel@ucw.cz>
+
+properties:
+  compatible:
+    enum:
+      - analogix,anx7688
+
+  reg:
+    maxItems: 1
+
+  interrupts:
+    maxItems: 1
+
+  reset-gpios:
+    maxItems: 1
+    description: GPIO controlling RESET_N (B7) pin.
+
+  enable-gpios:
+    maxItems: 1
+    description: GPIO controlling POWER_EN (D2) pin.
+
+  cabledet-gpios:
+    maxItems: 1
+    description: GPIO controlling CABLE_DET (C3) pin.
+
+  avdd10-supply:
+    description: 1.0V power supply going to AVDD10 (A4, ...) pins
+
+  dvdd10-supply:
+    description: 1.0V power supply going to DVDD10 (D6, ...) pins
+
+  avdd18-supply:
+    description: 1.8V power supply going to AVDD18 (E3, ...) pins
+
+  dvdd18-supply:
+    description: 1.8V power supply going to DVDD18 (G4, ...) pins
+
+  avdd33-supply:
+    description: 3.3V power supply going to AVDD33 (C4, ...) pins
+
+  i2c-supply: true
+  vconn-supply: true
+  hdmi-vt-supply: true
+  vbus-supply: true
+  vbus-in-supply: true
+
+  connector:
+    type: object
+    $ref: /schemas/connector/usb-connector.yaml
+
+    description:
+      Properties for usb c connector.
+
+    properties:
+      compatible:
+        const: usb-c-connector
+
+required:
+  - compatible
+  - reg
+  - connector
+
+additionalProperties: false
+
+examples:
+  - |
+    #include <dt-bindings/interrupt-controller/irq.h>
+    #include <dt-bindings/gpio/gpio.h>
+
+    i2c {
+        #address-cells =3D <1>;
+        #size-cells =3D <0>;
+
+        typec@2c {
+            compatible =3D "analogix,anx7688";
+            reg =3D <0x2c>;
+            interrupts =3D <8 IRQ_TYPE_EDGE_FALLING>;
+            interrupt-parent =3D <&gpio0>;
+
+            enable-gpios =3D <&pio 3 10 GPIO_ACTIVE_LOW>; /* PD10 */
+            reset-gpios =3D <&pio 3 6 GPIO_ACTIVE_HIGH>; /* PD6 */
+            cabledet-gpios =3D <&r_pio 0 8 GPIO_ACTIVE_HIGH>; /* PL8 */
+
+            avdd10-supply =3D <&reg_anx1v0>;
+            dvdd10-supply =3D <&reg_anx1v0>;
+            avdd18-supply =3D <&reg_ldo_io1>;
+            dvdd18-supply =3D <&reg_ldo_io1>;
+            avdd33-supply =3D <&reg_dcdc1>;
+            i2c-supply =3D <&reg_ldo_io0>;
+            vconn-supply =3D <&reg_vconn5v0>;
+            hdmi-vt-supply =3D <&reg_dldo1>;
+
+            vbus-supply =3D <&reg_usb_5v>;
+            vbus-in-supply =3D <&usb_power_supply>;
+
+            typec_con: connector {
+                compatible =3D "usb-c-connector";
+                power-role =3D "dual";
+                data-role =3D "dual";
+                try-power-role =3D "source";
+
+                ports {
+                    #address-cells =3D <1>;
+                    #size-cells =3D <0>;
+                    port@0 {
+                        reg =3D <0>;
+                        typec_con_ep: endpoint {
+                            remote-endpoint =3D <&usbotg_hs_ep>;
+                        };
+                    };
+                };
+            };
+        };
+    };
+...

--=20
People of Russia, stop Putin before his war on Ukraine escalates.

--xcc0rfiKI+Y+ldks
Content-Type: application/pgp-signature; name="signature.asc"

-----BEGIN PGP SIGNATURE-----

iF0EABECAB0WIQRPfPO7r0eAhk010v0w5/Bqldv68gUCZhPMHQAKCRAw5/Bqldv6
8mgEAKCH0WaaYBpVAsICPL+hNTVY03fJUQCeJnxEc/yyn0UbqcQhtLbCTmOMLPw=
=jiaK
-----END PGP SIGNATURE-----

--xcc0rfiKI+Y+ldks--