From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from foss.arm.com (foss.arm.com [217.140.110.172]) by smtp.subspace.kernel.org (Postfix) with ESMTP id B9D3E2367C0; Mon, 12 May 2025 22:56:35 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=217.140.110.172 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1747090598; cv=none; b=LUtEmlp9f+ddFNdtgG/5SVTubQLipfEUhnHkl8j98nZ9ZYBx78TL3ACwG6/+VHrWcXIa3k8ruFLR2gX0ZZBn1femQhcETn9cQGycjbiRBRsXc26uUOhcuRU+1bn6wdz83eLO0n1yE9z+ZQxpzqrLKtuy+J9zK8ey6YcjN+2Tfm0= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1747090598; c=relaxed/simple; bh=7DxAso8OUL7kvLO+cW3DmSZK6j8XiMcRUZqvHAuI/M0=; h=Date:From:To:Cc:Subject:Message-ID:In-Reply-To:References: MIME-Version:Content-Type; b=TW9NkgsPQGeqAxo2s7+aYkuLX59RHf6hwiW0BTREzvotoBZkv2RzjK2lNokj2yzUaB2DxCGP2aoj2aiO6O/+6XvDoKAOMdfJvjxbp1lGjsLjz3HwVRo3xcZ5qtJ50jAQ0DzzXUHdk9cg51YE9Q9fqPrKY6ZDlbB4PuIFxSEfnGw= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=arm.com; spf=pass smtp.mailfrom=arm.com; arc=none smtp.client-ip=217.140.110.172 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=arm.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=arm.com Received: from usa-sjc-imap-foss1.foss.arm.com (unknown [10.121.207.14]) by usa-sjc-mx-foss1.foss.arm.com (Postfix) with ESMTP id 022FC150C; Mon, 12 May 2025 15:56:24 -0700 (PDT) Received: from minigeek.lan (usa-sjc-mx-foss1.foss.arm.com [172.31.20.19]) by usa-sjc-imap-foss1.foss.arm.com (Postfix) with ESMTPSA id 666963F673; Mon, 12 May 2025 15:56:32 -0700 (PDT) Date: Mon, 12 May 2025 23:56:19 +0100 From: Andre Przywara To: Aleksandr Shubin Cc: linux-kernel@vger.kernel.org, Conor Dooley , Uwe =?UTF-8?B?S2xlaW5lLUvDtm5pZw==?= , Rob Herring , Krzysztof Kozlowski , Conor Dooley , Chen-Yu Tsai , Jernej Skrabec , Samuel Holland , Paul Walmsley , Palmer Dabbelt , Albert Ou , Alexandre Ghiti , Philipp Zabel , Cheo Fusi , linux-pwm@vger.kernel.org, devicetree@vger.kernel.org, linux-arm-kernel@lists.infradead.org, linux-sunxi@lists.linux.dev, linux-riscv@lists.infradead.org Subject: Re: [PATCH v12 1/3] dt-bindings: pwm: Add binding for Allwinner D1/T113-S3/R329 PWM controller Message-ID: <20250512235619.30cff739@minigeek.lan> In-Reply-To: <20250427142500.151925-2-privatesub2@gmail.com> References: <20250427142500.151925-1-privatesub2@gmail.com> <20250427142500.151925-2-privatesub2@gmail.com> Organization: Arm Ltd. X-Mailer: Claws Mail 4.2.0 (GTK 3.24.31; x86_64-slackware-linux-gnu) Precedence: bulk X-Mailing-List: devicetree@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit On Sun, 27 Apr 2025 17:24:53 +0300 Aleksandr Shubin wrote: Hi, > Allwinner's D1, T113-S3 and R329 SoCs have a new pwm > controller witch is different from the previous pwm-sun4i. > > The D1 and T113 are identical in terms of peripherals, > they differ only in the architecture of the CPU core, and > even share the majority of their DT. Because of that, > using the same compatible makes sense. > The R329 is a different SoC though, and should have > a different compatible string added, especially as there > is a difference in the number of channels. > > D1 and T113s SoCs have one PWM controller with 8 channels. > R329 SoC has two PWM controllers in both power domains, one of > them has 9 channels (CPUX one) and the other has 6 (CPUS one). > > Add a device tree binding for them. > > Reviewed-by: Conor Dooley > Signed-off-by: Aleksandr Shubin > --- > .../bindings/pwm/allwinner,sun20i-pwm.yaml | 84 +++++++++++++++++++ > 1 file changed, 84 insertions(+) > create mode 100644 Documentation/devicetree/bindings/pwm/allwinner,sun20i-pwm.yaml > > diff --git a/Documentation/devicetree/bindings/pwm/allwinner,sun20i-pwm.yaml b/Documentation/devicetree/bindings/pwm/allwinner,sun20i-pwm.yaml > new file mode 100644 > index 000000000000..4b25e94a8e46 > --- /dev/null > +++ b/Documentation/devicetree/bindings/pwm/allwinner,sun20i-pwm.yaml > @@ -0,0 +1,84 @@ > +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) > +%YAML 1.2 > +--- > +$id: http://devicetree.org/schemas/pwm/allwinner,sun20i-pwm.yaml# > +$schema: http://devicetree.org/meta-schemas/core.yaml# > + > +title: Allwinner D1, T113-S3 and R329 PWM > + > +maintainers: > + - Aleksandr Shubin > + - Brandon Cheo Fusi > + > +properties: > + compatible: > + oneOf: > + - const: allwinner,sun20i-d1-pwm > + - items: > + - const: allwinner,sun50i-r329-pwm > + - const: allwinner,sun20i-d1-pwm > + > + reg: > + maxItems: 1 > + > + "#pwm-cells": > + const: 3 > + > + clocks: > + items: > + - description: Bus clock > + - description: 24 MHz oscillator > + - description: APB clock > + > + clock-names: > + items: > + - const: bus > + - const: hosc > + - const: apb > + > + resets: > + maxItems: 1 > + > + allwinner,npwms: > + $ref: /schemas/types.yaml#/definitions/uint32 > + description: The number of PWM channels configured for this instance > + enum: [6, 8, 9] Do we really need to be so restrictive here? The IP has an "architectural" limit of 16 channels (due to the MMIO register layout and status/control bits usage in some registers), so can't we just leave this value to be anything between 1 and 16 here? If people configure this wrongly, it's their fault, I'd say? Without confining this further based on the respective compatible strings this enum is less useful anyway, I think. The Allwinner A523 uses the same IP, and supports all 16 channels, the V853 implements 12, that's what I quickly found already, and there might be more examples in the future, so I'd rather open this up. > + > +allOf: > + - $ref: pwm.yaml# > + > + - if: > + properties: > + compatible: > + contains: > + const: allwinner,sun50i-r329-pwm > + > + then: > + required: > + - allwinner,npwms Can't we just simplify this by always requiring this property? As mentioned, there will be more SoCs with different values, so just omitting this for the D1 seems odd. Cheers, Andre > + > +unevaluatedProperties: false > + > +required: > + - compatible > + - reg > + - "#pwm-cells" > + - clocks > + - clock-names > + - resets > + > +examples: > + - | > + #include > + #include > + > + pwm: pwm@2000c00 { > + compatible = "allwinner,sun20i-d1-pwm"; > + reg = <0x02000c00 0x400>; > + clocks = <&ccu CLK_BUS_PWM>, <&dcxo>, <&ccu CLK_APB0>; > + clock-names = "bus", "hosc", "apb"; > + resets = <&ccu RST_BUS_PWM>; > + #pwm-cells = <0x3>; > + }; > + > +...