Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) client-ip=2620:137:e000::1:20;
Received-SPF: Pass (protection.outlook.com: domain of topicproducts.com
 designates 13.93.42.39 as permitted sender) receiver=protection.outlook.com;
 client-ip=13.93.42.39; helo=westeu12-emailsignatures-cloud.codetwo.com; pr=C
Authentication-Results-Original: dkim=none (message not signed)
 header.d=none;dmarc=none action=none header.from=topic.nl;
From:   Mike Looijmans <mike.looijmans@topic.nl>
To:     devicetree@vger.kernel.org, linux-usb@vger.kernel.org
CC:     Mike Looijmans <mike.looijmans@topic.nl>,
        Greg Kroah-Hartman <gregkh@linuxfoundation.org>,
        Krzysztof Kozlowski <krzysztof.kozlowski+dt@linaro.org>,
        Rob Herring <robh+dt@kernel.org>, linux-kernel@vger.kernel.org
Subject: [PATCH v3 1/2] dt-bindings: usb: Add microchip USB5807 HUB
Date:   Mon, 22 May 2023 09:45:09 +0200
Message-ID: <20230522074510.16367-1-mike.looijmans@topic.nl>
Content-Type: text/plain
MIME-Version: 1.0
X-Microsoft-Antispam-Message-Info-Original: liUOlVoAy9eFPBrp0J0zuID6Qw4YwlKLWksH/175w6ZqjEQRF0kAT+DX7gLiZ9RqApPhfBPSiAUgZfA/Kjx1oB+YlAq+1Mq92VI9RTQZ5+/Rqw1rcKMOHpECksxwkNf+/1OBtc1icfVw3U0fyN2AxV6ixP7GhJhfWwc1sNKv3LsJaBhserBrzVYePOGLYuPUEoOqTvH9iJpoqXLYZn/L6pFMBKzbqe1V87ry2IfS1U2H1MvTCY6lqill5WBXwZpzs3AormdUpuuWKnWv0Qr99JUDW+VFcs6chYtaM5e66hXAWslTS6sNTaxmKDpYaE8jgpC6aPv3IqSgbmfNG/mN0f8pMqcL2jw8qahstKZP6TxNcYYlEpsTzcm9gY99E0+nDWnIY6dCcob2V37ewNW2f+lro6o5yn9P7M4amQITwY8NQasRuSlxB38Nn8PXjDRhAbFpLJjRETehBygtEUjEg2jWUTur6yuQnXzlm4sgUW7u07L0mAguyCD/vazCDlKpxVXXLZKiXwD6iT8vCG5IRz2hJ/LPnJwC4FR+t2Kj3OoXvmuur0LK78b3odHhKRTXVjZEE9yfnyV7VIjgyRG1GwE70PudQLqE2YwoUnmzXwM=
X-Forefront-Antispam-Report-Untrusted: CIP:255.255.255.255;CTRY:;LANG:en;SCL:1;SRV:;IPV:NLI;SFV:NSPM;H:DB8PR04MB6523.eurprd04.prod.outlook.com;PTR:;CAT:NONE;SFS:(13230028)(4636009)(366004)(376002)(136003)(39840400004)(396003)(346002)(451199021)(83170400001)(38350700002)(38100700002)(36756003)(44832011)(6512007)(6506007)(1076003)(8936002)(8676002)(42882007)(2616005)(2906002)(54906003)(478600001)(186003)(316002)(4326008)(26005)(41300700001)(5660300002)(66476007)(6666004)(6486002)(966005)(52116002)(66556008)(66946007);DIR:OUT;SFP:1101;
X-MS-Exchange-Transport-CrossTenantHeadersStamped: DB9PR04MB9626
X-CodeTwo-MessageID: 14021261-a616-414b-9a72-3ce360b2298e.20230522074521@westeu12-emailsignatures-cloud.codetwo.com
X-CodeTwoProcessed: true
References: <1b153bce-a66a-45ee-a5c6-963ea6fb1c82.949ef384-8293-46b8-903f-40a477c056ae.656f2a13-85bf-42a3-8490-f97f2538d8c3@emailsignatures365.codetwo.com>
Content-Transfer-Encoding: quoted-printable
X-EOPAttributedMessage: 0
X-MS-Exchange-Transport-CrossTenantHeadersStripped: HE1EUR01FT074.eop-EUR01.prod.protection.outlook.com
X-MS-PublicTrafficType: Email
X-MS-Office365-Filtering-Correlation-Id-Prvs: b9f7fe40-4b5d-4c41-bbaf-08db5a987c2c
X-Microsoft-Antispam: BCL:0;
X-Microsoft-Antispam-Message-Info: /d23Jea/N9zhT2qnSAU1td8arnhslNPyAxsTHfBAattyMXyySw1dwsA0jAlwLIehwlC/6DIeQv7D01a2+FdtDZxYr5nW1ms4yAsPsDYO52OfUhdHPTNXAOZYr8irKLCG4MRixMyiwyQJ9mtvPzaZL3VxFOwhMOZcNjSohckvwRRNRK/4JcmnEsbrRoDj5BB6iXfmyfjNQy36RwcKoPS1OIbSnHSHPirEJpYBow7icakmAZNwirl/Zy+w1B8j4qG9C0wPX0pPnhQX2mx1TVtZZ1ODd9qrZbVj+yeVDbwPYigP0aBuBMoWO5/yQxf0PGzhfIb5Ki6stIPj/CWL+x5J1wH6FZ2sPI7WCO6ch8ocCzjGZBVHozsZCM8XDSekxW6ebh6Ewqsw/D40bW4ttdkQEqhKiHMa3CPyIdrd172TrcVS8XY5iA0aTX5p1xHNr9NZQSwTgVaPw8wGJDuSemOoS8Hivj8L3E8ni/ltzqv3qfnfPESQqk5auLImlZh96JQWY8e9Tda/dojkVCUILk6GWlgcWp176VXF+qVsAPF1qARhpMc/VtuRw0z5kgGHt7MgoMnB5+imFmvPBVZv5Q3HeFQ37mfnXCVivxM22y6RsoO8agUrl90STfE6iojbk9ACZuQShw4zEcITvuyWatEkQzrFsyqwdlnpqNfhIIwJ9qoFBRUiXTg1IIq531/SZGJF
X-Forefront-Antispam-Report: CIP:13.93.42.39;CTRY:NL;LANG:en;SCL:1;SRV:;IPV:NLI;SFV:NSPM;H:westeu12-emailsignatures-cloud.codetwo.com;PTR:westeu12-emailsignatures-cloud.codetwo.com;CAT:NONE;SFS:(13230028)(4636009)(376002)(346002)(136003)(396003)(39840400004)(451199021)(46966006)(36840700001)(478600001)(186003)(54906003)(5660300002)(41300700001)(26005)(6666004)(966005)(6486002)(316002)(4326008)(44832011)(6512007)(1076003)(6506007)(336012)(8936002)(8676002)(2906002)(47076005)(42882007)(2616005)(36860700001)(70206006)(70586007)(83170400001)(356005)(7636003)(7596003)(36756003)(82310400005)(40480700001)(15974865002);DIR:OUT;SFP:1101;
X-OriginatorOrg: topic.nl
X-MS-Exchange-CrossTenant-OriginalArrivalTime: 22 May 2023 07:45:22.8575
 (UTC)
X-MS-Exchange-CrossTenant-Network-Message-Id: 32fcbe29-22d6-4272-580a-08db5a988040
X-MS-Exchange-CrossTenant-Id: 449607a5-3517-482d-8d16-41dd868cbda3
X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp: TenantId=449607a5-3517-482d-8d16-41dd868cbda3;Ip=[13.93.42.39];Helo=[westeu12-emailsignatures-cloud.codetwo.com]
X-MS-Exchange-CrossTenant-AuthSource: HE1EUR01FT074.eop-EUR01.prod.protection.outlook.com
X-MS-Exchange-CrossTenant-AuthAs: Anonymous
X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem
X-MS-Exchange-Transport-CrossTenantHeadersStamped: DUZPR04MB9848
X-Spam-Status: No, score=-1.8 required=5.0 tests=BAYES_00,DKIM_SIGNED,
        DKIM_VALID,DKIM_VALID_AU,HEADER_FROM_DIFFERENT_DOMAINS,
        RCVD_IN_DNSWL_NONE,RCVD_IN_MSPIKE_H2,SPF_HELO_PASS,SPF_PASS,
        T_SCC_BODY_TEXT_LINE autolearn=no autolearn_force=no version=3.4.6
X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on
        lindbergh.monkeyblade.net
Precedence: bulk
List-ID: <linux-kernel.vger.kernel.org>
X-Mailing-List: linux-kernel@vger.kernel.org

The USB5807 is a 7-port USB 3.1 hub that can be configured by I2C.
This driver resets the chip, optionally allows D+/D- lines to be
swapped in the devicetree config, and then sends an ATTACH command to
put the device in operational mode.

Signed-off-by: Mike Looijmans <mike.looijmans@topic.nl>

---

Changes in v3:
Add minItems

Changes in v2:
Rename to microchip,usb5807.yaml
Remove reset-gpios description
Add maxItems
Add vddXX-supply properties

 .../bindings/usb/microchip,usb5807.yaml       | 58 +++++++++++++++++++
 1 file changed, 58 insertions(+)
 create mode 100644 Documentation/devicetree/bindings/usb/microchip,usb5807=
.yaml

diff --git a/Documentation/devicetree/bindings/usb/microchip,usb5807.yaml b=
/Documentation/devicetree/bindings/usb/microchip,usb5807.yaml
new file mode 100644
index 000000000000..0a92b2f9802e
--- /dev/null
+++ b/Documentation/devicetree/bindings/usb/microchip,usb5807.yaml
@@ -0,0 +1,58 @@
+# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/usb/microchip,usb5807.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: Microchip USB 3.1 SuperSpeed Hub Controller
+
+maintainers:
+  - Mike Looijmans <mike.looijmans@topic.nl>
+
+properties:
+  compatible:
+    enum:
+      - microchip,usb5807
+
+  reg:
+    maxItems: 1
+
+  reset-gpios:
+    maxItems: 1
+
+  vdd12-supply:
+    description: core power supply (1.2V)
+
+  vdd33-supply:
+    description: main power supply (3.3V)
+
+  swap-dx-lanes:
+    $ref: /schemas/types.yaml#/definitions/uint32-array
+    minItems: 1
+    maxItems: 8
+    description:
+      Specifies the ports which will swap the differential-pair (D+/D-),
+      default is not-swapped.
+
+additionalProperties: false
+
+required:
+  - compatible
+  - reg
+
+examples:
+  - |
+    #include <dt-bindings/gpio/gpio.h>
+
+    i2c {
+      #address-cells =3D <1>;
+      #size-cells =3D <0>;
+
+      usb-hub@2d {
+        compatible =3D "microchip,usb5807";
+        reg =3D <0x2d>;
+        reset-gpios =3D <&gpio1 4 GPIO_ACTIVE_LOW>;
+        /* Swapped D+/D- on port 0 */
+        swap-dx-lanes =3D <0>;
+      };
+    };
--=20
2.17.1


Met vriendelijke groet / kind regards,=0A=
=0A=
Mike Looijmans=0A=
System Expert=0A=
=0A=
=0A=
TOPIC Embedded Products B.V.=0A=
Materiaalweg 4, 5681 RJ Best=0A=
The Netherlands=0A=
=0A=
T: +31 (0) 499 33 69 69=0A=
E: mike.looijmans@topicproducts.com=0A=
W: www.topic.nl=0A=
=0A=
Please consider the environment before printing this e-mail=0A=