From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from smtp.kernel.org (aws-us-west-2-korg-mail-1.web.codeaurora.org [10.30.226.201]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 1C9EA1E89C; Wed, 18 Mar 2026 16:38:07 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=10.30.226.201 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1773851888; cv=none; b=SayCEDbA0wjQ+W7KshnpuMm1uYcw5THzYZxQgbzSCWNqwABdP2WXSmjrNwInFwhKio0iTGAwU3+IOdPlcjD/2geGGISgK1/y6L8qOOqDAn1I5DFP4Pb0bix4qHYjkij0ifAXREDkw4wbKP/JNCLFqh9m8RicIoUNNzjwiX5lsyI= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1773851888; c=relaxed/simple; bh=amkx/ONsWMzstbyqhsVJJD8kT0eG2xoRPQ4khwRvdAg=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=QNardPzRTtX2ndeMLIBLZlqKQszFfceOfhjNV7StUFdExAgnGkwWoL8uC/FY+oC/uYAo7KdqHXQEVdyxYcQkmWqd+UXYJWdUiSH5tQa2WsFgAe7FyW5+zdXSplPlzFLXZ/6QMhjzTjvrgCHnnJREbMov0k1KLiMpOS9eIDdBGe0= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=i3OFa3Za; arc=none smtp.client-ip=10.30.226.201 Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b="i3OFa3Za" Received: by smtp.kernel.org (Postfix) with ESMTPSA id 6A0D5C2BCB0; Wed, 18 Mar 2026 16:38:02 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1773851887; bh=amkx/ONsWMzstbyqhsVJJD8kT0eG2xoRPQ4khwRvdAg=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=i3OFa3Za6rrrUEIBwsbLbwdoJH2kYPRsXYGAhywxJe1IHfXHr6vokXtDCvkTSIBNc L8k04HBq+UayWM1sP90woWLew407rZnbY7qC4IqhKWqREt81Q/SKWykL+gyX9ZcSp4 yINvhqJx9Veg1UT9Sb1O+S+RArSsQaivpSLN6ivxEl2zWX7nOsTr9m7quObz5VKkle WaOIkYLfk7IJ+JggB7e3ozUUwlbJVwl2v1TY9L/uoPur6r+oXE4dOiqAu6BEqPBOLt qzzhUso6d1a+iHeBI7E0N/Slo/RaK0NNtCYA9p1v68as5QWFvwqVK2FZWmJe7FGbYX UtPu+zLGVKZdA== From: Conor Dooley To: netdev@vger.kernel.org Cc: conor@kernel.org, Conor Dooley , Valentina.FernandezAlanis@microchip.com, Andrew Lunn , "David S. Miller" , Eric Dumazet , Jakub Kicinski , Paolo Abeni , Rob Herring , Krzysztof Kozlowski , Conor Dooley , Daire McNamara , Paul Walmsley , Palmer Dabbelt , Albert Ou , Alexandre Ghiti , Nicolas Ferre , Claudiu Beznea , Richard Cochran , Samuel Holland , devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, linux-riscv@lists.infradead.org, Dave Stevenson , Sean Anderson , Vineeth Karumanchi , Abin Joseph , =?UTF-8?q?Th=C3=A9o=20Lebrun?= , Ryan.Wanner@microchip.com Subject: [PATCH net-next v4 03/13] dt-bindings: net: cdns,macb: replace cdns,refclk-ext with cdns,refclk-source Date: Wed, 18 Mar 2026 16:37:34 +0000 Message-ID: <20260318-mobilize-rule-d4a704468218@spud> X-Mailer: git-send-email 2.51.0 In-Reply-To: <20260318-surpass-puzzle-f94b46aa8808@spud> References: <20260318-surpass-puzzle-f94b46aa8808@spud> Precedence: bulk X-Mailing-List: netdev@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 X-Developer-Signature: v=1; a=openpgp-sha256; l=3141; i=conor.dooley@microchip.com; h=from:subject:message-id; bh=ylmEwtCLpeHVLaNpcJoaSjYuiY5zyWKQ8QvX+HMWzDw=; b=owGbwMvMwCVWscWwfUFT0iXG02pJDJm7rlzccv/2lBnhc/xPqEQv3lz89pL4BetHjVOdHh9jW HrVJTixqqOUhUGMi0FWTJEl8XZfi9T6Py47nHvewsxhZQIZwsDFKQAT0ZFh+J98oMH+kVxowq28 5z+c7vpEOKnMqnzFbxOzJ5v7/PzUOS6MDO9CJLWEHxq7s7f6mnxuCPqspNH/n0n/mp0M87Z7ASm 5TAA= X-Developer-Key: i=conor.dooley@microchip.com; a=openpgp; fpr=F9ECA03CF54F12CD01F1655722E2C55B37CF380C Content-Transfer-Encoding: 8bit From: Conor Dooley Ryan added cdns,refclk-ext with the intent of decoupling the source of the reference clock on sama7g5 (and related platforms) from the compatible. Unfortunately, the default for sama7g5-emac is an external reference clock, so this property had no effect there, so that compatibility with older devicetrees is preserved. Replace cdns,refclk-ext with one that supports both default states and therefore is usable for sama7g5-emac. For now, limit it to only the platforms that have USRIO controlled reference clock selection, but this could be generalised in the future. The existing property only works on devices that are compatible with sama7g5-gem, so mark it deprecated, and limit its use to that specific scenario. Signed-off-by: Conor Dooley --- .../devicetree/bindings/net/cdns,macb.yaml | 56 ++++++++++++++++++- 1 file changed, 53 insertions(+), 3 deletions(-) diff --git a/Documentation/devicetree/bindings/net/cdns,macb.yaml b/Documentation/devicetree/bindings/net/cdns,macb.yaml index cb14c35ba9969..f6df793c4af65 100644 --- a/Documentation/devicetree/bindings/net/cdns,macb.yaml +++ b/Documentation/devicetree/bindings/net/cdns,macb.yaml @@ -122,10 +122,23 @@ properties: cdns,refclk-ext: type: boolean + deprecated: true + description: | + This selects if the REFCLK for RMII is provided by an external source. + For RGMII mode this selects if the 125MHz REF clock is provided by an external + source. + + This property has been replaced by cdns,refclk-source, as it only works + for devices that use an internal reference clock by default. + + cdns,refclk-source: + $ref: /schemas/types.yaml#/definitions/string + enum: + - internal + - external description: - This selects if the REFCLK for RMII is provided by an external source. - For RGMII mode this selects if the 125MHz REF clock is provided by an external - source. + Select whether or not the refclk for RGMII or RMII is provided by an + internal or external source. The default is device specific. cdns,rx-watermark: $ref: /schemas/types.yaml#/definitions/uint32 @@ -196,6 +209,43 @@ allOf: required: - phys + - if: + not: + properties: + compatible: + contains: + enum: + - microchip,sama7g5-gem + - microchip,sama7g5-emac + then: + properties: + cdns,refclk-source: false + + - if: + not: + properties: + compatible: + contains: + const: microchip,sama7g5-gem + then: + properties: + cdns,refclk-ext: false + + - if: + properties: + compatible: + contains: + enum: + - microchip,sama7g5-emac + then: + properties: + cdns,refclk-source: + default: external + else: + properties: + cdns,refclk-source: + default: internal + unevaluatedProperties: false examples: -- 2.51.0