From: Brandon Cheo Fusi <fusibrandon13@gmail.com>
To: u.kleine-koenig@pengutronix.de
Cc: aou@eecs.berkeley.edu, bigunclemax@gmail.com,
conor+dt@kernel.org, contact@jookia.org,
cristian.ciocaltea@collabora.com, devicetree@vger.kernel.org,
fusibrandon13@gmail.com, jernej.skrabec@gmail.com,
krzysztof.kozlowski+dt@linaro.org,
linux-arm-kernel@lists.infradead.org,
linux-kernel@vger.kernel.org, linux-pwm@vger.kernel.org,
linux-riscv@lists.infradead.org, linux-sunxi@lists.linux.dev,
mkl@pengutronix.de, p.zabel@pengutronix.de, palmer@dabbelt.com,
paul.walmsley@sifive.com, privatesub2@gmail.com,
robh+dt@kernel.org, samuel@sholland.org, wens@csie.org
Subject: Re: [PATCH v8 2/3] pwm: Add Allwinner's D1/T113-S3/R329 SoCs PWM support
Date: Fri, 2 Feb 2024 18:32:01 +0100 [thread overview]
Message-ID: <20240202173201.2564726-1-fusibrandon13@gmail.com> (raw)
In-Reply-To: <eynkbikmzcffid2jft3b6pmjfcbvda6mpzu7l5mefrw3za3iwh@ctgn57kb7ard>
On Thu, Feb 1, 2024 at 9:49 AM Uwe Kleine-König <u.kleine-koenig@pengutronix.de> wrote:
>
> hello Aleksandr,
>
> On Wed, Jan 31, 2024 at 03:59:15PM +0300, Aleksandr Shubin wrote:
> > +#include <linux/bitfield.h>
> > +#include <linux/clk.h>
> > +#include <linux/err.h>
> > +#include <linux/io.h>
> > +#include <linux/module.h>
> > +#include <linux/of_device.h>
>
> Some time ago there was some effort by Rob Herring to detangle the
> headers platform_device.h, of_device.h and of.h. See for example commit
> 87e51b76c9db8c29cde573af0faf5a3e13e23960. I think you should use
> linux/of.h instead of linux/of_device.h.
>
> > +#include <linux/platform_device.h>
> > +#include <linux/pwm.h>
> > +#include <linux/reset.h>
> > +
> > +#define SUN20I_PWM_CLK_CFG(chan) (0x20 + (((chan) >> 1) * 0x4))
> > +#define SUN20I_PWM_CLK_CFG_SRC GENMASK(8, 7)
> > +#define SUN20I_PWM_CLK_CFG_DIV_M GENMASK(3, 0)
> > +#define SUN20I_PWM_CLK_DIV_M_MAX 8
>
> SUN20I_PWM_CLK_CFG_DIV_M_MAX?
>
Yes. The manuals mark [0x9, 0xF] as reserved
> > +#define SUN20I_PWM_CLK_GATE 0x40
> > +#define SUN20I_PWM_CLK_GATE_BYPASS(chan) BIT((chan) + 16)
> > +#define SUN20I_PWM_CLK_GATE_GATING(chan) BIT(chan)
> > +
> > +#define SUN20I_PWM_ENABLE 0x80
> > +#define SUN20I_PWM_ENABLE_EN(chan) BIT(chan)
> > +
> > +#define SUN20I_PWM_CTL(chan) (0x100 + (chan) * 0x20)
> > +#define SUN20I_PWM_CTL_ACT_STA BIT(8)
> > +#define UN20I_PWM_CTL_PRESCAL_K GENMASK(7, 0)
> > +#define SUN20I_PWM_CTL_PRESCAL_K_MAX 0xff
>
> This matches the theoretical maximum for GENMASK(7,0), so you could make
> use of field_max(SUN20I_PWM_CTL_PRESCAL_K) here.
>
> > +#define SUN20I_PWM_PERIOD(chan) (0x104 + (chan) * 0x20)
> > +#define SUN20I_PWM_PERIOD_ENTIRE_CYCLE GENMASK(31, 16)
> > +#define SUN20I_PWM_PERIOD_ACT_CYCLE GENMASK(15, 0)
> > +
> > +#define SUN20I_PWM_PCNTR_SIZE BIT(16)
> > +
> > +/**
> > + * SUN20I_PWM_MAGIC is used to quickly compute the values of the clock dividers
> > + * div_m (SUN20I_PWM_CLK_CFG_DIV_M) & prescale_k (SUN20I_PWM_CTL_PRESCAL_K)
> > + * without using a loop. These dividers limit the # of cycles in a period
> > + * to SUN20I_PWM_PCNTR_SIZE by applying a scaling factor of
> > + * 1/(div_m * (prescale_k + 1)) to the clock source.
> > + *
> > + * SUN20I_PWM_MAGIC is derived by solving for div_m and prescale_k
> > + * such that for a given requested period,
> > + *
> > + * i) div_m is minimized for any prescale_k ≤ SUN20I_PWM_CTL_PRESCAL_K_MAX,
> > + * ii) prescale_k is minimized.
> > + *
> > + * The derivation proceeds as follows, with val = # of cycles for reqested
>
> s/reqested/requested/
Nice catch.
> > + * period:
> > + *
> > + * for a given value of div_m we want the smallest prescale_k such that
> > + *
> > + * (val >> div_m) // (prescale_k + 1) ≤ 65536 (SUN20I_PWM_PCNTR_SIZE)
> > + *
> > + * This is equivalent to:
> > + *
> > + * (val >> div_m) ≤ 65536 * (prescale_k + 1) + prescale_k
> > + * ⟺ (val >> div_m) ≤ 65537 * prescale_k + 65536
> > + * ⟺ (val >> div_m) - 65536 ≤ 65537 * prescale_k
> > + * ⟺ ((val >> div_m) - 65536) / 65537 ≤ prescale_k
> > + *
> > + * As prescale_k is integer, this becomes
> > + *
> > + * ((val >> div_m) - 65536) // 65537 ≤ prescale_k
> > + *
> > + * And is minimized at
> > + *
> > + * ((val >> div_m) - 65536) // 65537
> > + *
> > + * Now we pick the smallest div_m that satifies prescale_k ≤ 255
> > + * (i.e SUN20I_PWM_CTL_PRESCAL_K_MAX),
> > + *
> > + * ((val >> div_m) - 65536) // 65537 ≤ 255
> > + * ⟺ (val >> div_m) - 65536 ≤ 255 * 65537 + 65536
> > + * ⟺ val >> div_m ≤ 255 * 65537 + 2 * 65536
> > + * ⟺ val >> div_m < (255 * 65537 + 2 * 65536 + 1)
> > + * ⟺ div_m = fls((val) / (255 * 65537 + 2 * 65536 + 1))
> > + *
> > + * Suggested by Uwe Kleine-König
>
> Good man, I assume this is all sane then :-)
Credit should be given where it is due :-)
> > + */
> > +#define SUN20I_PWM_MAGIC (255 * 65537 + 2 * 65536 + 1)
> > +
> > +struct sun20i_pwm_chip {
> > + struct clk *clk_bus, *clk_hosc, *clk_apb0;
> > + struct reset_control *rst;
> > + struct pwm_chip chip;
> > + void __iomem *base;
> > + /* Mutex to protect pwm apply state */
> > + struct mutex mutex;
> > +};
> > +
> > +static inline struct sun20i_pwm_chip *to_sun20i_pwm_chip(struct pwm_chip *chip)
> > +{
> > + return container_of(chip, struct sun20i_pwm_chip, chip);
> > +}
> > +
> > +static inline u32 sun20i_pwm_readl(struct sun20i_pwm_chip *chip,
> > + unsigned long offset)
> > +{
> > + return readl(chip->base + offset);
> > +}
> > +
> > +static inline void sun20i_pwm_writel(struct sun20i_pwm_chip *chip,
> > + u32 val, unsigned long offset)
> > +{
> > + writel(val, chip->base + offset);
> > +}
> > +
> > +static int sun20i_pwm_get_state(struct pwm_chip *chip,
> > + struct pwm_device *pwm,
> > + struct pwm_state *state)
> > +{
> > + struct sun20i_pwm_chip *sun20i_chip = to_sun20i_pwm_chip(chip);
> > + u16 ent_cycle, act_cycle, prescale_k;
> > + u64 clk_rate, tmp;
> > + u8 div_m;
> > + u32 val;
> > +
> > + mutex_lock(&sun20i_chip->mutex);
> > +
> > + val = sun20i_pwm_readl(sun20i_chip, SUN20I_PWM_CLK_CFG(pwm->hwpwm));
> > + div_m = FIELD_GET(SUN20I_PWM_CLK_CFG_DIV_M, val);
> > + if (div_m > SUN20I_PWM_CLK_DIV_M_MAX)
> > + div_m = SUN20I_PWM_CLK_DIV_M_MAX;
> > +
> > + if (FIELD_GET(SUN20I_PWM_CLK_CFG_SRC, val) == 0)
> > + clk_rate = clk_get_rate(sun20i_chip->clk_hosc);
> > + else
> > + clk_rate = clk_get_rate(sun20i_chip->clk_apb0);
> > +
> > + val = sun20i_pwm_readl(sun20i_chip, SUN20I_PWM_CTL(pwm->hwpwm));
> > + state->polarity = (SUN20I_PWM_CTL_ACT_STA & val) ?
> > + PWM_POLARITY_NORMAL : PWM_POLARITY_INVERSED;
> > +
> > + prescale_k = FIELD_GET(SUN20I_PWM_CTL_PRESCAL_K, val) + 1;
> > +
> > + val = sun20i_pwm_readl(sun20i_chip, SUN20I_PWM_ENABLE);
> > + state->enabled = (SUN20I_PWM_ENABLE_EN(pwm->hwpwm) & val) ? true : false;
> > +
> > + val = sun20i_pwm_readl(sun20i_chip, SUN20I_PWM_PERIOD(pwm->hwpwm));
> > +
> > + mutex_unlock(&sun20i_chip->mutex);
> > +
> > + act_cycle = FIELD_GET(SUN20I_PWM_PERIOD_ACT_CYCLE, val);
> > + ent_cycle = FIELD_GET(SUN20I_PWM_PERIOD_ENTIRE_CYCLE, val);
> > +
> > + /*
> > + * The duration of the active phase should not be longer
> > + * than the duration of the period
> > + */
> > + if (act_cycle > ent_cycle)
> > + act_cycle = ent_cycle;
> > +
> > + tmp = ((u64)(act_cycle) * prescale_k << div_m) * NSEC_PER_SEC;
> > + state->duty_cycle = DIV_ROUND_UP_ULL(tmp, clk_rate);
> > + tmp = ((u64)(ent_cycle) * prescale_k << div_m) * NSEC_PER_SEC;
> > + state->period = DIV_ROUND_UP_ULL(tmp, clk_rate);
>
> Please add a comment above this block that justifies assuming that the
> multiplication doesn't overflow. Something like:
>
> We have act_cycle <= ent_cycle <= 0xffff, prescale_k <= 0x100,
> div_m <= 8. So the multiplication fits into an u64 without
> overflow.
>
> > +
> > + return 0;
> > +}
> > +
> > +static int sun20i_pwm_apply(struct pwm_chip *chip, struct pwm_device *pwm,
> > + const struct pwm_state *state)
> > +{
> > +...
> > +}
>
> I didn't recheck all the logic in .apply in detail and will assume it is
> sane for this round.
Please do recheck. This thing is already on v8 and we want to make sure
everyone is happy with v9.
> > +static const struct pwm_ops sun20i_pwm_ops = {
> > + .apply = sun20i_pwm_apply,
> > + .get_state = sun20i_pwm_get_state,
> > +};
> > +
> > +static const struct of_device_id sun20i_pwm_dt_ids[] = {
> > + { .compatible = "allwinner,sun20i-d1-pwm" },
> > + { },
> > +};
> > +MODULE_DEVICE_TABLE(of, sun20i_pwm_dt_ids);
> > +
> > +static int sun20i_pwm_probe(struct platform_device *pdev)
> > +{
> > + struct sun20i_pwm_chip *sun20i_chip;
> > + int ret;
> > +
> > + sun20i_chip = devm_kzalloc(&pdev->dev, sizeof(*sun20i_chip), GFP_KERNEL);
> > + if (!sun20i_chip)
> > + return -ENOMEM;
> > +
> > + sun20i_chip->base = devm_platform_ioremap_resource(pdev, 0);
> > + if (IS_ERR(sun20i_chip->base))
> > + return PTR_ERR(sun20i_chip->base);
> > +
> > + sun20i_chip->clk_bus = devm_clk_get_enabled(&pdev->dev, "bus");
> > + if (IS_ERR(sun20i_chip->clk_bus))
> > + return dev_err_probe(&pdev->dev, PTR_ERR(sun20i_chip->clk_bus),
> > + "failed to get bus clock\n");
> > +
> > + sun20i_chip->clk_hosc = devm_clk_get_enabled(&pdev->dev, "hosc");
> > + if (IS_ERR(sun20i_chip->clk_hosc))
> > + return dev_err_probe(&pdev->dev, PTR_ERR(sun20i_chip->clk_hosc),
> > + "failed to get hosc clock\n");
> > +
> > + sun20i_chip->clk_apb0 = devm_clk_get_enabled(&pdev->dev, "apb0");
> > + if (IS_ERR(sun20i_chip->clk_apb0))
> > + return dev_err_probe(&pdev->dev, PTR_ERR(sun20i_chip->clk_apb0),
> > + "failed to get apb0 clock\n");
> > +
> > + sun20i_chip->rst = devm_reset_control_get_exclusive(&pdev->dev, NULL);
> > + if (IS_ERR(sun20i_chip->rst))
> > + return dev_err_probe(&pdev->dev, PTR_ERR(sun20i_chip->rst),
> > + "failed to get bus reset\n");
> > +
> > + ret = of_property_read_u32(pdev->dev.of_node, "allwinner,pwm-channels",
> > + &sun20i_chip->chip.npwm);
> > + if (ret)
> > + sun20i_chip->chip.npwm = 8;
> > +
> > + if (sun20i_chip->chip.npwm > 16)
> > + sun20i_chip->chip.npwm = 16;
>
> Is it worth to emit an error message here? Something like:
>
> Limiting number of PWM lines from %u to 16
>
> Best regards
> Uwe
>
> --
> Pengutronix e.K. | Uwe Kleine-König |
> Industrial Linux Solutions | https://www.pengutronix.de/ |
Brandon.
_______________________________________________
linux-arm-kernel mailing list
linux-arm-kernel@lists.infradead.org
http://lists.infradead.org/mailman/listinfo/linux-arm-kernel
next prev parent reply other threads:[~2024-02-02 17:32 UTC|newest]
Thread overview: 16+ messages / expand[flat|nested] mbox.gz Atom feed top
2024-01-31 12:59 [PATCH v8 0/3] Add support for Allwinner PWM on D1/T113s/R329 SoCs Aleksandr Shubin
2024-01-31 12:59 ` [PATCH v8 1/3] dt-bindings: pwm: Add binding for Allwinner D1/T113-S3/R329 PWM controller Aleksandr Shubin
2024-01-31 14:52 ` Andre Przywara
2024-01-31 21:22 ` Conor Dooley
2024-02-01 17:48 ` Andre Przywara
2024-02-01 18:59 ` Conor Dooley
2024-01-31 16:34 ` Maxim Kiselev
2024-05-09 20:32 ` Chris Morgan
2024-01-31 12:59 ` [PATCH v8 2/3] pwm: Add Allwinner's D1/T113-S3/R329 SoCs PWM support Aleksandr Shubin
2024-01-31 13:41 ` Philipp Zabel
2024-02-01 8:49 ` Uwe Kleine-König
2024-02-02 17:32 ` Brandon Cheo Fusi [this message]
2024-02-03 15:04 ` kernel test robot
2024-05-01 5:42 ` John Watts
2024-01-31 12:59 ` [PATCH v8 3/3] riscv: dts: allwinner: d1: Add pwm node Aleksandr Shubin
2024-01-31 14:50 ` Andre Przywara
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20240202173201.2564726-1-fusibrandon13@gmail.com \
--to=fusibrandon13@gmail.com \
--cc=aou@eecs.berkeley.edu \
--cc=bigunclemax@gmail.com \
--cc=conor+dt@kernel.org \
--cc=contact@jookia.org \
--cc=cristian.ciocaltea@collabora.com \
--cc=devicetree@vger.kernel.org \
--cc=jernej.skrabec@gmail.com \
--cc=krzysztof.kozlowski+dt@linaro.org \
--cc=linux-arm-kernel@lists.infradead.org \
--cc=linux-kernel@vger.kernel.org \
--cc=linux-pwm@vger.kernel.org \
--cc=linux-riscv@lists.infradead.org \
--cc=linux-sunxi@lists.linux.dev \
--cc=mkl@pengutronix.de \
--cc=p.zabel@pengutronix.de \
--cc=palmer@dabbelt.com \
--cc=paul.walmsley@sifive.com \
--cc=privatesub2@gmail.com \
--cc=robh+dt@kernel.org \
--cc=samuel@sholland.org \
--cc=u.kleine-koenig@pengutronix.de \
--cc=wens@csie.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).