Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) client-ip=23.128.96.18;
From:   Sean Anderson <sean.anderson@seco.com>
To:     Greg Kroah-Hartman <gregkh@linuxfoundation.org>,
        linux-usb@vger.kernel.org
Cc:     Robert Hancock <robert.hancock@calian.com>,
        Baruch Siach <baruch@tkos.co.il>,
        Felipe Balbi <balbi@kernel.org>,
        Thinh Nguyen <Thinh.Nguyen@synopsys.com>,
        linux-kernel@vger.kernel.org,
        Balaji Prakash J <bjagadee@codeaurora.org>,
        Sean Anderson <sean.anderson@seco.com>,
        Rob Herring <robh+dt@kernel.org>, devicetree@vger.kernel.org
Subject: [PATCH v3 1/7] dt-bindings: usb: dwc3: Deprecate snps,ref-clock-period-ns
Date:   Thu, 27 Jan 2022 15:06:30 -0500
Message-Id: <20220127200636.1456175-2-sean.anderson@seco.com>
In-Reply-To: <20220127200636.1456175-1-sean.anderson@seco.com>
References: <20220127200636.1456175-1-sean.anderson@seco.com>
Content-Transfer-Encoding: 8bit
Content-Type: text/plain
MIME-Version: 1.0
X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1
X-MS-Exchange-AntiSpam-MessageData-0: =?us-ascii?Q?dg9i1cwKlWCGlGmv34bjA7XuhivQWRO5eFDzaamrkKP4sIt48NR8FpYNZ+Dw?=
 =?us-ascii?Q?dY2HmIbhth/oP21rs9zMOV6yviqQwfriiJedH7mS2DWeBwtDlQSxzkWyFDXk?=
 =?us-ascii?Q?8zRt6lTmXp+a++XeNY8CypwsD6bEyZkeiptJ4slQrky4QC1iVWforFBdzDUZ?=
 =?us-ascii?Q?wunMT3vYhzT93UsUsyvGudR48KIltEb2EIAGvTrVt5g9rwF0v+pyY6WxUT+V?=
 =?us-ascii?Q?UcCJlAP5nkukpLjwouutMJLCdB7uoaITag4YfMarS8ewEfIFXdwY817puIQE?=
 =?us-ascii?Q?AAOK5QoZSAe5exc8lh4XNqDVqmHKeUltEjLmiailwRMRdJQIdW0IAp1E+jvs?=
 =?us-ascii?Q?X9+/1qcB3Hmw40czHG6ujnqmBYme04jcfH43A2IXUS6Gb3dykdTUFuIIFXNH?=
 =?us-ascii?Q?1SstcVapYwLwJlW+UmcvUcTP6Zshljyb5FZNxb/IVbdWF7+t7DVZ4kvTnFGF?=
 =?us-ascii?Q?ufZjovEIfbEuQTOwc2B3mloJaUNqUy19eaf6F4lTpIvmnfA/35Z7W9+Sc53L?=
 =?us-ascii?Q?cc2G5E0Y2I15N9kokJgoZtvdnsBZWsg4w78lRa3y90ewZQB+REmo+w1mQqkZ?=
 =?us-ascii?Q?NM2GaqLyXTYne7vQBijwvzYr2s3Pqgphz2QEKhD3jmvNfwzDtugFvD5PVJME?=
 =?us-ascii?Q?vvh0xQ9p4kXU0l4YZQZquJaxLGfvrmyRlaj+OTOZDrA5ASPd4wwG1ANXj2/4?=
 =?us-ascii?Q?8h8QnOCwF0hTXGD/QqYifPss2KeHrJp915UXAflj6mtNDWT3Bq9HCsm5FCnO?=
 =?us-ascii?Q?RdYSMIl4xCKQpAe2Kb45Y7rxJDJz4aoN/XCh+SrVBU48zVgoF41MryCabmvW?=
 =?us-ascii?Q?O92mub2U9f9+/A1jSzrdpujKKpy4I4FgN0dUK3/uPsvXLW0XEDQuC5dwGfBg?=
 =?us-ascii?Q?9D+EjNMWM3CluMN1DMQ97KIjfOrzr24eOmDu9r91KgDPxoP0WNz1Oh9h6rVB?=
 =?us-ascii?Q?nRhaLCJrGOz2jWb7MzZK2QkTXxFobavI3F/9YHwqMBR88oHaB6MFyGjHxV2N?=
 =?us-ascii?Q?3KcSNwHUOw+mNDy8JuObwxG32i8qbNxlVvn/rSVJagfzpoEONFXDEgDvq+cA?=
 =?us-ascii?Q?eIZD/FO+6Bnbq0+R3tkyyhVXNMrECYrvuS7UDuGAfGTJXzpsafgTFkk5/opL?=
 =?us-ascii?Q?0LUHrsySOO7MuL/Ec7vQc+spzjbZ9bPcRiX196xEMVtufh5SbomT/tjTxd5+?=
 =?us-ascii?Q?wPQBx4FTsW+Hff4ddXJMbj7RMRBTh3M0wETiWeinqj+AXuvdtCA3017WwqR8?=
 =?us-ascii?Q?YxYpl2NZO2r/64Y/7XCQPS+k0Vjq9rPhCLX66kXybxof0Cy+3IFMeTJf4hzS?=
 =?us-ascii?Q?NNv8wtLlK2mt2RkngRolT8gQLzj0Y8at+hrYldBO551rGAvf2zVEr3Ua3XqB?=
 =?us-ascii?Q?7XzMgBVra5i0GYAHWNEviX6qb0g/yBjncvLrX42Td2kVI45u4LCpxqM6w3Qx?=
 =?us-ascii?Q?uhREOpe6SO3mQhLerPPTYUq+O0+deNwr+3bQ5EKF7Mw9f9h2cRvY8S6m3cWo?=
 =?us-ascii?Q?gFM879zmvsNnu+U2MY7vilVtcXDd98tdEAg2jKYnG5NBR6j2ZZ/f0ub0uYAr?=
 =?us-ascii?Q?QgSs6iATLRQX4HDGe9NMcTCsXMyvldL3YisWB15ESthn6MH6FB4t2mFpGr3E?=
 =?us-ascii?Q?1x2ccpoB49GG8x1tra/eLg8=3D?=
X-OriginatorOrg: seco.com
X-MS-Exchange-CrossTenant-Network-Message-Id: 1c9f9522-0ada-4588-7550-08d9e1d08dac
X-MS-Exchange-CrossTenant-AuthSource: DB7PR03MB4523.eurprd03.prod.outlook.com
X-MS-Exchange-CrossTenant-AuthAs: Internal
X-MS-Exchange-CrossTenant-OriginalArrivalTime: 27 Jan 2022 20:06:49.8003
 (UTC)
X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted
X-MS-Exchange-CrossTenant-Id: bebe97c3-6438-442e-ade3-ff17aa50e733
X-MS-Exchange-CrossTenant-MailboxType: HOSTED
X-MS-Exchange-CrossTenant-UserPrincipalName: mKUlRb58TOkKAs59Umczkh0Q1xOwojRx/g+Una0+EGVprL9GORLhwF9vN7CK9/yh+nD/jSpRKggYTOeH+5b7Cw==
X-MS-Exchange-Transport-CrossTenantHeadersStamped: AM0PR03MB3747
Precedence: bulk
List-ID: <linux-kernel.vger.kernel.org>
X-Mailing-List: linux-kernel@vger.kernel.org

This property is redundant because we can determine the correct value for
REFCLKPER based on the "ref" clock. Deprecate it, and encourage users to
provide a clock instead. This also restricts the minimum and maximum to the
values documented in the register reference [1].

[1] https://www.xilinx.com/html_docs/registers/ug1087/usb3_xhci___guctl.html

Signed-off-by: Sean Anderson <sean.anderson@seco.com>
---

(no changes since v1)

 Documentation/devicetree/bindings/usb/snps,dwc3.yaml | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/Documentation/devicetree/bindings/usb/snps,dwc3.yaml b/Documentation/devicetree/bindings/usb/snps,dwc3.yaml
index d29ffcd27472..4f2b0913ad9f 100644
--- a/Documentation/devicetree/bindings/usb/snps,dwc3.yaml
+++ b/Documentation/devicetree/bindings/usb/snps,dwc3.yaml
@@ -263,8 +263,11 @@ properties:
       Value for REFCLKPER field of GUCTL register for reference clock period in
       nanoseconds, when the hardware set default does not match the actual
       clock.
-    minimum: 1
-    maximum: 0x3ff
+
+      This binding is deprecated. Instead, provide an appropriate reference clock.
+    minimum: 8
+    maximum: 62
+    deprecated: true
 
   snps,rx-thr-num-pkt-prd:
     description:
-- 
2.25.1