From nobody Wed Sep 10 02:47:07 2025 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id 1FA23EE49A3 for ; Wed, 23 Aug 2023 13:23:52 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S235772AbjHWNXw (ORCPT ); Wed, 23 Aug 2023 09:23:52 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:55718 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S230143AbjHWNXu (ORCPT ); Wed, 23 Aug 2023 09:23:50 -0400 Received: from mail-wr1-x433.google.com (mail-wr1-x433.google.com [IPv6:2a00:1450:4864:20::433]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 4DAD8E75; Wed, 23 Aug 2023 06:23:18 -0700 (PDT) Received: by mail-wr1-x433.google.com with SMTP id ffacd0b85a97d-317c3ac7339so4836248f8f.0; Wed, 23 Aug 2023 06:23:18 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20221208; t=1692796968; x=1693401768; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:from:to:cc:subject:date:message-id:reply-to; bh=Pzn+5bTpnSMNwUuNyyowNMIJDQZpkAi+7c7mgKTYoME=; b=r6cn6rzIz0BUUjfTlEntcGmnQ1emT1LcuHfH0giUjqFalgnkFVgfmPmYn4JnZIGvGd 8vq36GiD1N7HPhbhCHGX/Vxtvs65nKwerH03TLGgA3Jh5i1/nmPkBqtxZiXkbYi8oD6w K1UDpRQ5E5lLyAgjOBLJlKxACcWjaQUsQW2UVrjreVK0Idl3G7ovSzSNA8ZESvKUFo0M ecZOdNlHkEQ4Ydi6elupAad5t7dKX48Z6n1ZhtAKWKVyVA57ib5L1rjRAO57N1NXxj7E p7WSuw7k1/I+LKkLYV9HyAAmeIPbanf8mZR+mwtRVA4R9Ttdiuz3m5nwzUIsTQZjLgj4 FRTw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20221208; t=1692796968; x=1693401768; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:x-gm-message-state:from:to:cc:subject:date:message-id :reply-to; bh=Pzn+5bTpnSMNwUuNyyowNMIJDQZpkAi+7c7mgKTYoME=; b=TtCByPA6kzGkHy6R4HEjqHuLQAzA+YyJiTpd5DvuvXWzixhOctoIpGKFRtUgBmSXGL JAqWTVdGPdXlNsmH0ms+sVmZV7DQqJvS2zngIwMQY9RKSP/IgTfmnPPuqKATBKyi+VFZ opaHJTAbd0SCZEG/0JmRSXQV1I87wx91qZ9SphJvcF4Da/ec+a9+b1XyDSsY3Quqc/ug ES39q88ik1oGfYe5kEj1Fi934heXIgIP8uZhQqXtvpOIbRDcR/jBQ1TVETALQykLmq04 VMO6RxtqnpzVYxbglZrvmDLAIHBj0AnOMX32fS2LNeStwSSw4xwub/8JpLVMRhCEikbB +x1Q== X-Gm-Message-State: AOJu0YwIRFFj8MeN+m8Hm1DP/ZWbZu7eUu1KoHMGhPzZiKXb+VL/nvFs LpOji0I6nGkYHAXqJgG1wRM= X-Google-Smtp-Source: AGHT+IE1gUkkpuMyRPjYkQSA46YH3/bOWjgb5ixYadB1u37Wfo9A/dssTd2q0MBm9JbD7/LteuPZ8g== X-Received: by 2002:a5d:4573:0:b0:315:ad1a:5abc with SMTP id a19-20020a5d4573000000b00315ad1a5abcmr9228900wrc.5.1692796967751; Wed, 23 Aug 2023 06:22:47 -0700 (PDT) Received: from localhost ([37.174.115.23]) by smtp.gmail.com with ESMTPSA id p6-20020a5d68c6000000b00317f70240afsm19353163wrw.27.2023.08.23.06.22.47 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 23 Aug 2023 06:22:47 -0700 (PDT) From: Raphael Gallais-Pou To: Vinod Koul , Kishon Vijay Abraham I , Rob Herring , Krzysztof Kozlowski , Conor Dooley , Patrice Chotard Cc: linux-phy@lists.infradead.org, devicetree@vger.kernel.org, linux-kernel@vger.kernel.org Subject: [PATCH v3] dt-bindings: phy: st: convert phy-stih407-usb to DT schema Date: Wed, 23 Aug 2023 15:22:24 +0200 Message-ID: <20230823132224.111326-1-rgallaispou@gmail.com> X-Mailer: git-send-email 2.41.0 MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Type: text/plain; charset="utf-8" Convert the st,stih407-usb2-phy binding to DT schema format. Signed-off-by: Raphael Gallais-Pou Reviewed-by: Krzysztof Kozlowski --- Changes in v2: * Removed quotes surrounding $ref * Removed quotes surrounding const properties * Changed 'st,syscfg' $ref value to phandle-array * Changed authorship to my oss email address Changes in v3: * Remove driver references * Dropped obvious description * Dropped label and set simpler node name --- .../bindings/phy/phy-stih407-usb.txt | 24 ------- .../bindings/phy/st,stih407-usb2-phy.yaml | 63 +++++++++++++++++++ 2 files changed, 63 insertions(+), 24 deletions(-) delete mode 100644 Documentation/devicetree/bindings/phy/phy-stih407-usb.t= xt create mode 100644 Documentation/devicetree/bindings/phy/st,stih407-usb2-p= hy.yaml diff --git a/Documentation/devicetree/bindings/phy/phy-stih407-usb.txt b/Do= cumentation/devicetree/bindings/phy/phy-stih407-usb.txt deleted file mode 100644 index 35f03df00130..000000000000 --- a/Documentation/devicetree/bindings/phy/phy-stih407-usb.txt +++ /dev/null @@ -1,24 +0,0 @@ -ST STiH407 USB PHY controller - -This file documents the dt bindings for the usb picoPHY driver which is th= e PHY for both USB2 and USB3 -host controllers (when controlling usb2/1.1 devices) available on STiH407 = SoC family from STMicroelectronics. - -Required properties: -- compatible : should be "st,stih407-usb2-phy" -- st,syscfg : phandle of sysconfig bank plus integer array containing phy= param and phyctrl register offsets -- resets : list of phandle and reset specifier pairs. There should be two= entries, one - for the whole phy and one for the port -- reset-names : list of reset signal names. Should be "global" and "port" -See: Documentation/devicetree/bindings/reset/st,stih407-powerdown.yaml -See: Documentation/devicetree/bindings/reset/reset.txt - -Example: - -usb2_picophy0: usbpicophy@f8 { - compatible =3D "st,stih407-usb2-phy"; - #phy-cells =3D <0>; - st,syscfg =3D <&syscfg_core 0x100 0xf4>; - resets =3D <&softreset STIH407_PICOPHY_SOFTRESET>, - <&picophyreset STIH407_PICOPHY0_RESET>; - reset-names =3D "global", "port"; -}; diff --git a/Documentation/devicetree/bindings/phy/st,stih407-usb2-phy.yaml= b/Documentation/devicetree/bindings/phy/st,stih407-usb2-phy.yaml new file mode 100644 index 000000000000..e45cdd98aab2 --- /dev/null +++ b/Documentation/devicetree/bindings/phy/st,stih407-usb2-phy.yaml @@ -0,0 +1,63 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/phy/st,stih407-usb2-phy.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: STMicroelectronics STiH407 USB PHY controller + +maintainers: + - Patrice Chotard + +description: + The USB picoPHY device is the PHY for both USB2 and USB3 host controllers + (when controlling usb2/1.1 devices) available on STiH407 SoC family from + STMicroelectronics. + +properties: + compatible: + const: st,stih407-usb2-phy + + st,syscfg: + description: Phandle to the syscfg bank + $ref: /schemas/types.yaml#/definitions/phandle-array + items: + - items: + - description: phandle to syscfg + - description: phyparam register offset + - description: phyctrl register offset + + resets: + items: + - description: Phandle and reset specifier pair for the whole phy. + - description: Phandle and reset specifier pair for the port. + + reset-names: + items: + - const: global + - const: port + + "#phy-cells": + const: 0 + +required: + - compatible + - st,syscfg + - resets + - reset-names + - "#phy-cells" + +additionalProperties: false + +examples: + - | + #include + usb-phy { + compatible =3D "st,stih407-usb2-phy"; + #phy-cells =3D <0>; + st,syscfg =3D <&syscfg_core 0x100 0xf4>; + resets =3D <&softreset STIH407_PICOPHY_SOFTRESET>, + <&picophyreset STIH407_PICOPHY0_RESET>; + reset-names =3D "global", "port"; + }; +... --=20 2.41.0