From nobody Sat Feb 7 16:08:25 2026 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 010C1E7B5E1 for ; Wed, 4 Oct 2023 09:39:45 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S232956AbjJDJjq (ORCPT ); Wed, 4 Oct 2023 05:39:46 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:59238 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S242069AbjJDJjm (ORCPT ); Wed, 4 Oct 2023 05:39:42 -0400 Received: from smtp.kernel.org (relay.kernel.org [52.25.139.140]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 1F378BB; Wed, 4 Oct 2023 02:39:39 -0700 (PDT) Received: by smtp.kernel.org (Postfix) with ESMTPSA id EA5C8C433C9; Wed, 4 Oct 2023 09:39:36 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1696412378; bh=2KYQTHHdlxj8qqNgAA+KrAtJZX+1U+xrdvGAdks0XNs=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=utRM5di0La3cVCDAD+xziNd9r09uI+BdzTNkawHSEMsjrfMSGfdB9f8RbvFjsQA/C cBi28Tr4ExoqyTA7H2xEFRkAFSRrC9M19/IF3uPaIHOUK7xb0gN8+GAelTJQe8LvLP FsgOzK1tKxXwMKsZZ5XF8SG5hzhW6zWjj7H29K7h53DyvKcwW3oO9KUDPsXey2n7UC UZLgRJuFdx1wQOtURVCRzYnTvBH8OTDyLH/rsFH0m4UoVd25uvp7DgZtfcS7+VmVJQ F+ZM2UC6PGFlrzTeR8gbJ+mR0IKD2Pj96wn758sUIC7ysPapwJP8B1q9pXt8XPJ+Cj FDSHmhO9UmFOQ== From: Jisheng Zhang To: Thierry Reding , =?UTF-8?q?Uwe=20Kleine-K=C3=B6nig?= , Rob Herring , Krzysztof Kozlowski , Conor Dooley Cc: linux-pwm@vger.kernel.org, devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, linux-riscv@lists.infradead.org Subject: [PATCH v2 1/2] dt-bindings: pwm: Add T-HEAD PWM controller Date: Wed, 4 Oct 2023 17:27:30 +0800 Message-Id: <20231004092731.1362-2-jszhang@kernel.org> X-Mailer: git-send-email 2.40.0 In-Reply-To: <20231004092731.1362-1-jszhang@kernel.org> References: <20231004092731.1362-1-jszhang@kernel.org> 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" T-HEAD SoCs such as the TH1520 contain a PWM controller used to control the LCD backlight, fan and so on. Signed-off-by: Jisheng Zhang Reviewed-by: Rob Herring --- .../bindings/pwm/thead,th1520-pwm.yaml | 44 +++++++++++++++++++ 1 file changed, 44 insertions(+) create mode 100644 Documentation/devicetree/bindings/pwm/thead,th1520-pwm.= yaml diff --git a/Documentation/devicetree/bindings/pwm/thead,th1520-pwm.yaml b/= Documentation/devicetree/bindings/pwm/thead,th1520-pwm.yaml new file mode 100644 index 000000000000..b9c88f758a39 --- /dev/null +++ b/Documentation/devicetree/bindings/pwm/thead,th1520-pwm.yaml @@ -0,0 +1,44 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/pwm/thead,th1520-pwm.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: T-HEAD TH1520 PWM + +maintainers: + - Jisheng Zhang + +allOf: + - $ref: pwm.yaml# + +properties: + compatible: + enum: + - thead,th1520-pwm + + reg: + maxItems: 1 + + clocks: + maxItems: 1 + + "#pwm-cells": + const: 2 + +required: + - compatible + - reg + - clocks + +additionalProperties: false + +examples: + - | + + pwm@ec01c000 { + compatible =3D "thead,th1520-pwm"; + reg =3D <0xec01c000 0x1000>; + clocks =3D <&clk 1>; + #pwm-cells =3D <2>; + }; --=20 2.40.1 From nobody Sat Feb 7 16:08:25 2026 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 279BFE7B5E1 for ; Wed, 4 Oct 2023 09:39:50 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S242079AbjJDJjv (ORCPT ); Wed, 4 Oct 2023 05:39:51 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:59314 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S242080AbjJDJjq (ORCPT ); Wed, 4 Oct 2023 05:39:46 -0400 Received: from smtp.kernel.org (relay.kernel.org [52.25.139.140]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 5C7C0C1; Wed, 4 Oct 2023 02:39:41 -0700 (PDT) Received: by smtp.kernel.org (Postfix) with ESMTPSA id 30E46C433CA; Wed, 4 Oct 2023 09:39:39 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1696412381; bh=4ajcit5MVNwNqk7UmDG2b6bY1LbxWQvlNoVe1fvg9IA=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=Ims8XDRoyUD3oeLcgnPFMWaBeaAneh2h40MOP+L/ZTO2BzRApBMifys9j2It9KKel ePb+CjdRmn5NybVP+PE+LdLA1XXngctaQv70C267sNNj38HBZBV6/v0V5H56EUNmor CuGkP0jSls0xfBxhsrtq+3Eg39vjacxIxiPE4tw1MkVA9UBZYiK3E7U9v+blCywtS/ Ev/HWfP5AfOoxYTUgR0wskci9mSnfqxJtxEvO4RZ9dEtozDlWucf3129Fc8strtcKk Jb1dCDh/AcIIwLsDDXep9zBiCefa95e1mDIwM6/1h0qX0/0El+/Qi0+zt0XTNfusZl 7J3M2joDAim6w== From: Jisheng Zhang To: Thierry Reding , =?UTF-8?q?Uwe=20Kleine-K=C3=B6nig?= , Rob Herring , Krzysztof Kozlowski , Conor Dooley Cc: linux-pwm@vger.kernel.org, devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, linux-riscv@lists.infradead.org Subject: [PATCH v2 2/2] pwm: add T-HEAD PWM driver Date: Wed, 4 Oct 2023 17:27:31 +0800 Message-Id: <20231004092731.1362-3-jszhang@kernel.org> X-Mailer: git-send-email 2.40.0 In-Reply-To: <20231004092731.1362-1-jszhang@kernel.org> References: <20231004092731.1362-1-jszhang@kernel.org> 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" T-HEAD SoCs such as the TH1520 contain a PWM controller used to control the LCD backlight, fan and so on. Add driver for it. Signed-off-by: Jisheng Zhang --- MAINTAINERS | 1 + drivers/pwm/Kconfig | 11 ++ drivers/pwm/Makefile | 1 + drivers/pwm/pwm-thead.c | 274 ++++++++++++++++++++++++++++++++++++++++ 4 files changed, 287 insertions(+) create mode 100644 drivers/pwm/pwm-thead.c diff --git a/MAINTAINERS b/MAINTAINERS index d55e40060c46..86cf0926dbfc 100644 --- a/MAINTAINERS +++ b/MAINTAINERS @@ -18482,6 +18482,7 @@ L: linux-riscv@lists.infradead.org S: Maintained F: arch/riscv/boot/dts/thead/ F: drivers/usb/dwc3/dwc3-thead.c +F: drivers/pwm/pwm-thead.c =20 RNBD BLOCK DRIVERS M: Md. Haris Iqbal diff --git a/drivers/pwm/Kconfig b/drivers/pwm/Kconfig index 8ebcddf91f7b..428fa365a19a 100644 --- a/drivers/pwm/Kconfig +++ b/drivers/pwm/Kconfig @@ -637,6 +637,17 @@ config PWM_TEGRA To compile this driver as a module, choose M here: the module will be called pwm-tegra. =20 +config PWM_THEAD + tristate "T-HEAD PWM support" + depends on ARCH_THEAD || COMPILE_TEST + depends on HAS_IOMEM + help + Generic PWM framework driver for the PWFM controller found on THEAD + SoCs. + + To compile this driver as a module, choose M here: the module + will be called pwm-thead. + config PWM_TIECAP tristate "ECAP PWM support" depends on ARCH_OMAP2PLUS || ARCH_DAVINCI_DA8XX || ARCH_KEYSTONE || ARCH_= K3 || COMPILE_TEST diff --git a/drivers/pwm/Makefile b/drivers/pwm/Makefile index c822389c2a24..4c317e6316e8 100644 --- a/drivers/pwm/Makefile +++ b/drivers/pwm/Makefile @@ -59,6 +59,7 @@ obj-$(CONFIG_PWM_STMPE) +=3D pwm-stmpe.o obj-$(CONFIG_PWM_SUN4I) +=3D pwm-sun4i.o obj-$(CONFIG_PWM_SUNPLUS) +=3D pwm-sunplus.o obj-$(CONFIG_PWM_TEGRA) +=3D pwm-tegra.o +obj-$(CONFIG_PWM_THEAD) +=3D pwm-thead.o obj-$(CONFIG_PWM_TIECAP) +=3D pwm-tiecap.o obj-$(CONFIG_PWM_TIEHRPWM) +=3D pwm-tiehrpwm.o obj-$(CONFIG_PWM_TWL) +=3D pwm-twl.o diff --git a/drivers/pwm/pwm-thead.c b/drivers/pwm/pwm-thead.c new file mode 100644 index 000000000000..ba1e3a4f1027 --- /dev/null +++ b/drivers/pwm/pwm-thead.c @@ -0,0 +1,274 @@ +// SPDX-License-Identifier: GPL-2.0 +/* + * T-HEAD PWM driver + * + * Copyright (C) 2021 Alibaba Group Holding Limited. + * Copyright (C) 2023 Jisheng Zhang + * + * Limitations: + * - The THEAD_PWM_START bit is only effective when 0 -> 1, which is used = to + * start the channel, 1 -> 0 doesn't change anything. so 0 % duty cycle = is + * used to "disable" the channel. + * - The PWM_CFG_UPDATE atomically updates and only updates period and dut= y. + * - To update period and duty, PWM_CFG_UPDATE needs to go through 0 -> 1 = step, + * I.E if PWM_CFG_UPDATE is already 1, it's necessary to clear it to 0 + * beforehand. + * - Polarity can only be changed if never started before. + */ + +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include + +#define THEAD_PWM_MAX_NUM 6 +#define THEAD_PWM_MAX_PERIOD GENMASK(31, 0) +#define THEAD_PWM_MAX_DUTY GENMASK(31, 0) + +#define THEAD_PWM_CHN_BASE(n) ((n) * 0x20) +#define THEAD_PWM_CTRL(n) (THEAD_PWM_CHN_BASE(n) + 0x00) +#define THEAD_PWM_RPT(n) (THEAD_PWM_CHN_BASE(n) + 0x04) +#define THEAD_PWM_PER(n) (THEAD_PWM_CHN_BASE(n) + 0x08) +#define THEAD_PWM_FP(n) (THEAD_PWM_CHN_BASE(n) + 0x0c) +#define THEAD_PWM_STATUS(n) (THEAD_PWM_CHN_BASE(n) + 0x10) + +/* bit definition PWM_CTRL */ +#define THEAD_PWM_START BIT(0) +#define THEAD_PWM_SOFT_RST BIT(1) +#define THEAD_PWM_CFG_UPDATE BIT(2) +#define THEAD_PWM_INT_EN BIT(3) +#define THEAD_PWM_MODE_MASK GENMASK(5, 4) +#define THEAD_PWM_ONE_SHOT_MODE FIELD_PREP(THEAD_PWM_MODE_MASK, 1) +#define THEAD_PWM_CONTINUOUS_MODE FIELD_PREP(THEAD_PWM_MODE_MASK, 2) +#define THEAD_PWM_EVTRIG_MASK GENMASK(7, 6) +#define THEAD_PWM_FPOUT BIT(8) +#define THEAD_PWM_INFACTOUT BIT(9) + +struct thead_pwm_chip { + struct pwm_chip chip; + void __iomem *mmio_base; + struct clk *clk; + bool ever_started; +}; + +static inline struct thead_pwm_chip *thead_pwm_from_chip(struct pwm_chip *= chip) +{ + return container_of(chip, struct thead_pwm_chip, chip); +} + +static int thead_pwm_apply(struct pwm_chip *chip, struct pwm_device *pwm, + const struct pwm_state *state) +{ + struct thead_pwm_chip *priv =3D thead_pwm_from_chip(chip); + u64 period_cycle, duty_cycle, rate; + u32 val; + + /* if ever started, can't change the polarity */ + if (priv->ever_started && state->polarity !=3D pwm->state.polarity) + return -EINVAL; + + if (!state->enabled) { + if (pwm->state.enabled) { + val =3D readl(priv->mmio_base + THEAD_PWM_CTRL(pwm->hwpwm)); + val &=3D ~THEAD_PWM_CFG_UPDATE; + writel(val, priv->mmio_base + THEAD_PWM_CTRL(pwm->hwpwm)); + + writel(0, priv->mmio_base + THEAD_PWM_FP(pwm->hwpwm)); + + val |=3D THEAD_PWM_CFG_UPDATE; + writel(val, priv->mmio_base + THEAD_PWM_CTRL(pwm->hwpwm)); + } + return 0; + } + + if (!pwm->state.enabled) + pm_runtime_get_sync(chip->dev); + + val =3D readl(priv->mmio_base + THEAD_PWM_CTRL(pwm->hwpwm)); + val &=3D ~THEAD_PWM_CFG_UPDATE; + + if (state->polarity =3D=3D PWM_POLARITY_INVERSED) + val &=3D ~THEAD_PWM_FPOUT; + else + val |=3D THEAD_PWM_FPOUT; + + writel(val, priv->mmio_base + THEAD_PWM_CTRL(pwm->hwpwm)); + + rate =3D clk_get_rate(priv->clk); + /* + * The following calculations might overflow if clk is bigger + * than 1 GHz. In practise it's 24MHz, so this limitation + * is only theoretic. + */ + if (rate > (u64)NSEC_PER_SEC) + return -EINVAL; + + period_cycle =3D mul_u64_u64_div_u64(rate, state->period, NSEC_PER_SEC); + if (period_cycle > THEAD_PWM_MAX_PERIOD) + period_cycle =3D THEAD_PWM_MAX_PERIOD; + /* + * With limitation above we have period_cycle <=3D THEAD_PWM_MAX_PERIOD, + * so this cannot overflow. + */ + writel((u32)period_cycle, priv->mmio_base + THEAD_PWM_PER(pwm->hwpwm)); + + duty_cycle =3D mul_u64_u64_div_u64(rate, state->duty_cycle, NSEC_PER_SEC); + if (duty_cycle > THEAD_PWM_MAX_DUTY) + duty_cycle =3D THEAD_PWM_MAX_DUTY; + /* + * With limitation above we have duty_cycle <=3D THEAD_PWM_MAX_PERIOD, + * so this cannot overflow. + */ + writel((u32)duty_cycle, priv->mmio_base + THEAD_PWM_FP(pwm->hwpwm)); + + val |=3D THEAD_PWM_CFG_UPDATE; + writel(val, priv->mmio_base + THEAD_PWM_CTRL(pwm->hwpwm)); + + if (!pwm->state.enabled) { + val |=3D THEAD_PWM_START; + writel(val, priv->mmio_base + THEAD_PWM_CTRL(pwm->hwpwm)); + priv->ever_started =3D true; + } + + return 0; +} + +static int thead_pwm_get_state(struct pwm_chip *chip, struct pwm_device *p= wm, + struct pwm_state *state) +{ + struct thead_pwm_chip *priv =3D thead_pwm_from_chip(chip); + u64 rate =3D clk_get_rate(priv->clk); + u32 val; + + pm_runtime_get_sync(chip->dev); + + val =3D readl(priv->mmio_base + THEAD_PWM_CTRL(pwm->hwpwm)); + state->enabled =3D !!(val & THEAD_PWM_START); + if (val & THEAD_PWM_FPOUT) + state->polarity =3D PWM_POLARITY_NORMAL; + else + state->polarity =3D PWM_POLARITY_INVERSED; + + val =3D readl(priv->mmio_base + THEAD_PWM_PER(pwm->hwpwm)); + /* + * val 32 bits, multiply NSEC_PER_SEC, won't overflow. + */ + state->period =3D DIV64_U64_ROUND_UP((u64)val * NSEC_PER_SEC, rate); + + val =3D readl(priv->mmio_base + THEAD_PWM_FP(pwm->hwpwm)); + /* + * val 32 bits, multiply NSEC_PER_SEC, won't overflow. + */ + state->duty_cycle =3D DIV64_U64_ROUND_UP((u64)val * NSEC_PER_SEC, rate); + + pm_runtime_put_sync(chip->dev); + + return 0; +} + +static const struct pwm_ops thead_pwm_ops =3D { + .apply =3D thead_pwm_apply, + .get_state =3D thead_pwm_get_state, + .owner =3D THIS_MODULE, +}; + +static int __maybe_unused thead_pwm_runtime_suspend(struct device *dev) +{ + struct thead_pwm_chip *priv =3D dev_get_drvdata(dev); + + clk_disable_unprepare(priv->clk); + + return 0; +} + +static int __maybe_unused thead_pwm_runtime_resume(struct device *dev) +{ + struct thead_pwm_chip *priv =3D dev_get_drvdata(dev); + int ret; + + ret =3D clk_prepare_enable(priv->clk); + if (ret) { + dev_err(dev, "failed to enable pwm clock(%d)\n", ret); + return ret; + } + + return 0; +} + +static int thead_pwm_probe(struct platform_device *pdev) +{ + u32 val =3D THEAD_PWM_INFACTOUT | THEAD_PWM_FPOUT | THEAD_PWM_CONTINUOUS_= MODE; + struct thead_pwm_chip *priv; + int ret, i; + + priv =3D devm_kzalloc(&pdev->dev, sizeof(*priv), GFP_KERNEL); + if (!priv) + return -ENOMEM; + + platform_set_drvdata(pdev, priv); + + priv->mmio_base =3D devm_platform_ioremap_resource(pdev, 0); + if (IS_ERR(priv->mmio_base)) + return PTR_ERR(priv->mmio_base); + + priv->clk =3D devm_clk_get_enabled(&pdev->dev, NULL); + if (IS_ERR(priv->clk)) + return PTR_ERR(priv->clk); + + priv->chip.ops =3D &thead_pwm_ops; + priv->chip.dev =3D &pdev->dev; + priv->chip.npwm =3D THEAD_PWM_MAX_NUM; + + /* set normal polarity and other proper bits for all channels */ + for (i =3D 0; i < priv->chip.npwm; i++) + writel(val, priv->mmio_base + THEAD_PWM_CTRL(i)); + + ret =3D devm_pwmchip_add(&pdev->dev, &priv->chip); + if (ret) + return ret; + + pm_runtime_enable(&pdev->dev); + + return 0; +} + +static void thead_pwm_remove(struct platform_device *pdev) +{ + pm_runtime_disable(&pdev->dev); +} + +static const struct of_device_id thead_pwm_dt_ids[] =3D { + {.compatible =3D "thead,th1520-pwm",}, + {/* sentinel */} +}; +MODULE_DEVICE_TABLE(of, thead_pwm_dt_ids); + +static const struct dev_pm_ops thead_pwm_pm_ops =3D { + SET_RUNTIME_PM_OPS(thead_pwm_runtime_suspend, thead_pwm_runtime_resume, N= ULL) +}; + +static struct platform_driver thead_pwm_driver =3D { + .driver =3D { + .name =3D "thead-pwm", + .of_match_table =3D thead_pwm_dt_ids, + .pm =3D &thead_pwm_pm_ops, + }, + .probe =3D thead_pwm_probe, + .remove_new =3D thead_pwm_remove, +}; +module_platform_driver(thead_pwm_driver); + +MODULE_AUTHOR("Wei Liu "); +MODULE_AUTHOR("Jisheng Zhang "); +MODULE_DESCRIPTION("T-HEAD pwm driver"); +MODULE_LICENSE("GPL v2"); --=20 2.40.1