From mboxrd@z Thu Jan 1 00:00:00 1970 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 bombadil.infradead.org (bombadil.infradead.org [198.137.202.133]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.lore.kernel.org (Postfix) with ESMTPS id 1C7AFC3DA4B for ; Mon, 15 Jul 2024 18:02:11 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=lists.infradead.org; s=bombadil.20210309; h=Sender:List-Subscribe:List-Help :List-Post:List-Archive:List-Unsubscribe:List-Id:Content-Transfer-Encoding: Content-Type:Message-ID:References:In-Reply-To:Subject:Cc:To:From:Date: MIME-Version:Reply-To:Content-ID:Content-Description:Resent-Date:Resent-From: Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID:List-Owner; bh=yeO8aJl/IzUQi8xRcxq4p918nJT45vn5xNQbkPy3aAY=; b=Cuf3QUdqQF3FR25Bn0DFGmjodb omD2xoMLQefuODPDuxEiHWXphX7Sr7Ocj3Sq7NskTf8Hrc1hNzkNxQvyT2OzD/n2aPopkzHUOFEXV 5GvbitQmS9R1jc839Nl/iq9D2qOP/eU0+bxcrSb/EjJLtgI0ymGRApBoBVZMyeOUE4F4GT0mcWkJk 9F/zJjaYuZ7XDYjO5esJGxzIK87MbDfZ5DFz2W1rup0cxZIpg0aP0kL2VxFKELXgYLNd9ahG5ifA4 feB5B7NOWXXywICjw558mfXkLjH0hyeAxJgmbNRWvALSTlE3kpTPojVSUB0Z03xk2NPbOYrDVeAOz LzZKfZiw==; Received: from localhost ([::1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.97.1 #2 (Red Hat Linux)) id 1sTQ1P-00000007wvV-2aG4; Mon, 15 Jul 2024 18:01:59 +0000 Received: from mail.manjaro.org ([2a01:4f8:c0c:51f3::1]) by bombadil.infradead.org with esmtps (Exim 4.97.1 #2 (Red Hat Linux)) id 1sTQ15-00000007wpX-2Szc; Mon, 15 Jul 2024 18:01:41 +0000 MIME-Version: 1.0 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=manjaro.org; s=2021; t=1721066495; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=yeO8aJl/IzUQi8xRcxq4p918nJT45vn5xNQbkPy3aAY=; b=UbThJeP6VidW1MFNuqSAV0zqSYP2j81Zj8faTffFzPVYMWh92MH0YsqWXggiXNaovhU7Ck 8XNRTUywPPp6shDoExSB/o0OYowSbwYCu0laFqHnnnhcgTDEg3ZjVKlmxRPkGcrcrlNMQA ejnu8WA2fp5ZAorGvARIqlKiKNya1oqsRYeHSEo3xBGSTqPif22YWr8GrDug2MCMOTJCgf zlhtLEP7ylC7HdCofQntvYqSn6WYHT6svy1DZEs/GSo3xJa570SPrn7FclnS7fc2BdZIrB BSZ6SLJB8FIk/3EZVOGMN0q55vEnWc0MAzUGSkGZ+R6HrkIRDF00xv/lwRUHCA== Date: Mon, 15 Jul 2024 20:01:35 +0200 From: Dragan Simic To: =?UTF-8?Q?Heiko_St=C3=BCbner?= Cc: mturquette@baylibre.com, sboyd@kernel.org, robh@kernel.org, krzk+dt@kernel.org, conor+dt@kernel.org, linux-clk@vger.kernel.org, devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, linux-arm-kernel@lists.infradead.org, linux-rockchip@lists.infradead.org Subject: Re: [PATCH v2 1/3] dt-bindings: clocks: add binding for voltage-controlled-oscillators In-Reply-To: <2832997.XrmoMso0CX@diego> References: <20240715110251.261844-1-heiko@sntech.de> <20240715110251.261844-2-heiko@sntech.de> <2832997.XrmoMso0CX@diego> Message-ID: <3f0c241d39c5fedb674d7f9808d0be8f@manjaro.org> X-Sender: dsimic@manjaro.org Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 8bit Authentication-Results: ORIGINATING; auth=pass smtp.auth=dsimic@manjaro.org smtp.mailfrom=dsimic@manjaro.org X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20240715_110139_950421_9862411B X-CRM114-Status: GOOD ( 29.69 ) X-BeenThere: linux-arm-kernel@lists.infradead.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: "linux-arm-kernel" Errors-To: linux-arm-kernel-bounces+linux-arm-kernel=archiver.kernel.org@lists.infradead.org On 2024-07-15 19:46, Heiko Stübner wrote: > Am Montag, 15. Juli 2024, 17:15:45 CEST schrieb Dragan Simic: >> On 2024-07-15 13:02, Heiko Stuebner wrote: >> > In contrast to fixed clocks that are described as ungateable, boards >> > sometimes use additional oscillators for things like PCIe reference >> > clocks, that need actual supplies to get enabled and enable-gpios to be >> > toggled for them to work. >> > >> > This adds a binding for such oscillators that are not configurable >> > themself, but need to handle supplies for them to work. >> > >> > In schematics they often can be seen as >> > >> > ---------------- >> > Enable - | 100MHz,3.3V, | - VDD >> > | 3225 | >> > GND - | | - OUT >> > ---------------- >> > >> > or similar. The enable pin might be separate but can also just be tied >> > to the vdd supply, hence it is optional in the binding. >> > >> > Signed-off-by: Heiko Stuebner >> > --- >> > .../bindings/clock/voltage-oscillator.yaml | 49 +++++++++++++++++++ >> > 1 file changed, 49 insertions(+) >> > create mode 100644 >> > Documentation/devicetree/bindings/clock/voltage-oscillator.yaml >> > >> > diff --git >> > a/Documentation/devicetree/bindings/clock/voltage-oscillator.yaml >> > b/Documentation/devicetree/bindings/clock/voltage-oscillator.yaml >> > new file mode 100644 >> > index 0000000000000..8bff6b0fd582e >> > --- /dev/null >> > +++ b/Documentation/devicetree/bindings/clock/voltage-oscillator.yaml >> > @@ -0,0 +1,49 @@ >> > +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) >> > +%YAML 1.2 >> > +--- >> > +$id: http://devicetree.org/schemas/clock/voltage-oscillator.yaml# >> > +$schema: http://devicetree.org/meta-schemas/core.yaml# >> > + >> > +title: Voltage controlled oscillator >> >> Frankly, I find the "voltage-oscillator" and "voltage controlled >> oscillator" names awkward. In general, "clock" is used throughout >> the entire kernel, when it comes to naming files and defining >> "compatible" strings. Thus, I'd suggest that "clock" is used here >> instead of "oscillator", because it's consistent and shorter. >> >> How about using "gated-clock" for the "compatible" string, and >> "Simple gated clock generator" instead of "voltage controlled >> oscillator"? Besides sounding awkward, "voltage controlled >> oscillator" may suggest that the clock generator can be adjusted >> or programmed somehow by applying the voltage, while it can only >> be enabled or disabled that way, which is by definition clock >> gating. Thus, "gated-clock" and "Simple gated clock generator" >> would fit very well. > > The naming came from Stephen - one of the clock maintainers ;-) > See discussion in v1. Who also described these things as > "voltage-controlled-oscillators". > > And from that discussion I also got the impression we should aim for > more specific naming - especially when talking about dt-bindings, for > this > "usage in the Linux kernel" actually isn't a suitable metric and > "gated-clock" is probably way too generic I think. I see, thanks for the clarification. Though, the generic nature of "gated-clock" as the name may actually make this driver a bit more future-proof, by allowing some other features to be added to it at some point in the future, avoiding that way the need for yet another kernel driver. > Though I'm not attached to any specific naming, so we'll simply > wait for the clock- and dt-maintainers to weigh in ;-)