pwm: Add support for RZ/G2L GPT

RZ/G2L General PWM Timer (GPT) composed of 8 channels with 32-bit timer
(GPT32E). It supports the following functions
 * 32 bits x 8 channels
 * Up-counting or down-counting (saw waves) or up/down-counting
   (triangle waves) for each counter.
 * Clock sources independently selectable for each channel
 * Two I/O pins per channel
 * Two output compare/input capture registers per channel
 * For the two output compare/input capture registers of each channel,
   four registers are provided as buffer registers and are capable of
   operating as comparison registers when buffering is not in use.
 * In output compare operation, buffer switching can be at crests or
   troughs, enabling the generation of laterally asymmetric PWM waveforms.
 * Registers for setting up frame cycles in each channel (with capability
   for generating interrupts at overflow or underflow)
 * Generation of dead times in PWM operation
 * Synchronous starting, stopping and clearing counters for arbitrary
   channels
 * Starting, stopping, clearing and up/down counters in response to input
   level comparison
 * Starting, clearing, stopping and up/down counters in response to a
   maximum of four external triggers
 * Output pin disable function by dead time error and detected
   short-circuits between output pins
 * A/D converter start triggers can be generated (GPT32E0 to GPT32E3)
 * Enables the noise filter for input capture and external trigger
   operation

Add basic pwm support for RZ/G2L GPT driver by creating separate
logical channels for each IOs.

Signed-off-by: Biju Das <biju.das.jz@bp.renesas.com>
Link: https://lore.kernel.org/r/20250226144531.176819-4-biju.das.jz@bp.renesas.com
Signed-off-by: Uwe Kleine-König <ukleinek@kernel.org>
This commit is contained in:
Biju Das 2025-02-26 14:45:22 +00:00 committed by Uwe Kleine-König
parent 9549d22684
commit 061f087f5d
3 changed files with 455 additions and 0 deletions

View File

@ -552,6 +552,17 @@ config PWM_ROCKCHIP
Generic PWM framework driver for the PWM controller found on Generic PWM framework driver for the PWM controller found on
Rockchip SoCs. Rockchip SoCs.
config PWM_RZG2L_GPT
tristate "Renesas RZ/G2L General PWM Timer support"
depends on ARCH_RZG2L || COMPILE_TEST
depends on HAS_IOMEM
help
This driver exposes the General PWM Timer controller found in Renesas
RZ/G2L like chips through the PWM API.
To compile this driver as a module, choose M here: the module
will be called pwm-rzg2l-gpt.
config PWM_RZ_MTU3 config PWM_RZ_MTU3
tristate "Renesas RZ/G2L MTU3a PWM Timer support" tristate "Renesas RZ/G2L MTU3a PWM Timer support"
depends on RZ_MTU3 depends on RZ_MTU3

View File

@ -50,6 +50,7 @@ obj-$(CONFIG_PWM_RASPBERRYPI_POE) += pwm-raspberrypi-poe.o
obj-$(CONFIG_PWM_RCAR) += pwm-rcar.o obj-$(CONFIG_PWM_RCAR) += pwm-rcar.o
obj-$(CONFIG_PWM_RENESAS_TPU) += pwm-renesas-tpu.o obj-$(CONFIG_PWM_RENESAS_TPU) += pwm-renesas-tpu.o
obj-$(CONFIG_PWM_ROCKCHIP) += pwm-rockchip.o obj-$(CONFIG_PWM_ROCKCHIP) += pwm-rockchip.o
obj-$(CONFIG_PWM_RZG2L_GPT) += pwm-rzg2l-gpt.o
obj-$(CONFIG_PWM_RZ_MTU3) += pwm-rz-mtu3.o obj-$(CONFIG_PWM_RZ_MTU3) += pwm-rz-mtu3.o
obj-$(CONFIG_PWM_SAMSUNG) += pwm-samsung.o obj-$(CONFIG_PWM_SAMSUNG) += pwm-samsung.o
obj-$(CONFIG_PWM_SIFIVE) += pwm-sifive.o obj-$(CONFIG_PWM_SIFIVE) += pwm-sifive.o

443
drivers/pwm/pwm-rzg2l-gpt.c Normal file
View File

@ -0,0 +1,443 @@
// SPDX-License-Identifier: GPL-2.0
/*
* Renesas RZ/G2L General PWM Timer (GPT) driver
*
* Copyright (C) 2025 Renesas Electronics Corporation
*
* Hardware manual for this IP can be found here
* https://www.renesas.com/eu/en/document/mah/rzg2l-group-rzg2lc-group-users-manual-hardware-0?language=en
*
* Limitations:
* - Counter must be stopped before modifying Mode and Prescaler.
* - When PWM is disabled, the output is driven to inactive.
* - While the hardware supports both polarities, the driver (for now)
* only handles normal polarity.
* - General PWM Timer (GPT) has 8 HW channels for PWM operations and
* each HW channel have 2 IOs.
* - Each IO is modelled as an independent PWM channel.
* - When both channels are used, disabling the channel on one stops the
* other.
* - When both channels are used, the period of both IOs in the HW channel
* must be same (for now).
*/
#include <linux/bitfield.h>
#include <linux/clk.h>
#include <linux/io.h>
#include <linux/limits.h>
#include <linux/module.h>
#include <linux/of.h>
#include <linux/platform_device.h>
#include <linux/pwm.h>
#include <linux/reset.h>
#include <linux/time.h>
#include <linux/units.h>
#define RZG2L_GET_CH(hwpwm) ((hwpwm) / 2)
#define RZG2L_GET_CH_OFFS(ch) (0x100 * (ch))
#define RZG2L_GTCR(ch) (0x2c + RZG2L_GET_CH_OFFS(ch))
#define RZG2L_GTUDDTYC(ch) (0x30 + RZG2L_GET_CH_OFFS(ch))
#define RZG2L_GTIOR(ch) (0x34 + RZG2L_GET_CH_OFFS(ch))
#define RZG2L_GTBER(ch) (0x40 + RZG2L_GET_CH_OFFS(ch))
#define RZG2L_GTCNT(ch) (0x48 + RZG2L_GET_CH_OFFS(ch))
#define RZG2L_GTCCR(ch, sub_ch) (0x4c + RZG2L_GET_CH_OFFS(ch) + 4 * (sub_ch))
#define RZG2L_GTPR(ch) (0x64 + RZG2L_GET_CH_OFFS(ch))
#define RZG2L_GTCR_CST BIT(0)
#define RZG2L_GTCR_MD GENMASK(18, 16)
#define RZG2L_GTCR_TPCS GENMASK(26, 24)
#define RZG2L_GTCR_MD_SAW_WAVE_PWM_MODE FIELD_PREP(RZG2L_GTCR_MD, 0)
#define RZG2L_GTUDDTYC_UP BIT(0)
#define RZG2L_GTUDDTYC_UDF BIT(1)
#define RZG2L_GTUDDTYC_UP_COUNTING (RZG2L_GTUDDTYC_UP | RZG2L_GTUDDTYC_UDF)
#define RZG2L_GTIOR_GTIOA GENMASK(4, 0)
#define RZG2L_GTIOR_GTIOB GENMASK(20, 16)
#define RZG2L_GTIOR_GTIOx(sub_ch) ((sub_ch) ? RZG2L_GTIOR_GTIOB : RZG2L_GTIOR_GTIOA)
#define RZG2L_GTIOR_OAE BIT(8)
#define RZG2L_GTIOR_OBE BIT(24)
#define RZG2L_GTIOR_OxE(sub_ch) ((sub_ch) ? RZG2L_GTIOR_OBE : RZG2L_GTIOR_OAE)
#define RZG2L_INIT_OUT_HI_OUT_HI_END_TOGGLE 0x1b
#define RZG2L_GTIOR_GTIOA_OUT_HI_END_TOGGLE_CMP_MATCH \
(RZG2L_INIT_OUT_HI_OUT_HI_END_TOGGLE | RZG2L_GTIOR_OAE)
#define RZG2L_GTIOR_GTIOB_OUT_HI_END_TOGGLE_CMP_MATCH \
(FIELD_PREP(RZG2L_GTIOR_GTIOB, RZG2L_INIT_OUT_HI_OUT_HI_END_TOGGLE) | RZG2L_GTIOR_OBE)
#define RZG2L_GTIOR_GTIOx_OUT_HI_END_TOGGLE_CMP_MATCH(sub_ch) \
((sub_ch) ? RZG2L_GTIOR_GTIOB_OUT_HI_END_TOGGLE_CMP_MATCH : \
RZG2L_GTIOR_GTIOA_OUT_HI_END_TOGGLE_CMP_MATCH)
#define RZG2L_MAX_HW_CHANNELS 8
#define RZG2L_CHANNELS_PER_IO 2
#define RZG2L_MAX_PWM_CHANNELS (RZG2L_MAX_HW_CHANNELS * RZG2L_CHANNELS_PER_IO)
#define RZG2L_MAX_SCALE_FACTOR 1024
#define RZG2L_MAX_TICKS ((u64)U32_MAX * RZG2L_MAX_SCALE_FACTOR)
struct rzg2l_gpt_chip {
void __iomem *mmio;
struct mutex lock; /* lock to protect shared channel resources */
unsigned long rate_khz;
u32 period_ticks[RZG2L_MAX_HW_CHANNELS];
u32 channel_request_count[RZG2L_MAX_HW_CHANNELS];
u32 channel_enable_count[RZG2L_MAX_HW_CHANNELS];
};
static inline struct rzg2l_gpt_chip *to_rzg2l_gpt_chip(struct pwm_chip *chip)
{
return pwmchip_get_drvdata(chip);
}
static inline unsigned int rzg2l_gpt_subchannel(unsigned int hwpwm)
{
return hwpwm & 0x1;
}
static void rzg2l_gpt_write(struct rzg2l_gpt_chip *rzg2l_gpt, u32 reg, u32 data)
{
writel(data, rzg2l_gpt->mmio + reg);
}
static u32 rzg2l_gpt_read(struct rzg2l_gpt_chip *rzg2l_gpt, u32 reg)
{
return readl(rzg2l_gpt->mmio + reg);
}
static void rzg2l_gpt_modify(struct rzg2l_gpt_chip *rzg2l_gpt, u32 reg, u32 clr,
u32 set)
{
rzg2l_gpt_write(rzg2l_gpt, reg,
(rzg2l_gpt_read(rzg2l_gpt, reg) & ~clr) | set);
}
static u8 rzg2l_gpt_calculate_prescale(struct rzg2l_gpt_chip *rzg2l_gpt,
u64 period_ticks)
{
u32 prescaled_period_ticks;
u8 prescale;
prescaled_period_ticks = period_ticks >> 32;
if (prescaled_period_ticks >= 256)
prescale = 5;
else
prescale = (fls(prescaled_period_ticks) + 1) / 2;
return prescale;
}
static int rzg2l_gpt_request(struct pwm_chip *chip, struct pwm_device *pwm)
{
struct rzg2l_gpt_chip *rzg2l_gpt = to_rzg2l_gpt_chip(chip);
u32 ch = RZG2L_GET_CH(pwm->hwpwm);
guard(mutex)(&rzg2l_gpt->lock);
rzg2l_gpt->channel_request_count[ch]++;
return 0;
}
static void rzg2l_gpt_free(struct pwm_chip *chip, struct pwm_device *pwm)
{
struct rzg2l_gpt_chip *rzg2l_gpt = to_rzg2l_gpt_chip(chip);
u32 ch = RZG2L_GET_CH(pwm->hwpwm);
guard(mutex)(&rzg2l_gpt->lock);
rzg2l_gpt->channel_request_count[ch]--;
}
static bool rzg2l_gpt_is_ch_enabled(struct rzg2l_gpt_chip *rzg2l_gpt, u8 hwpwm)
{
u8 ch = RZG2L_GET_CH(hwpwm);
u32 val;
val = rzg2l_gpt_read(rzg2l_gpt, RZG2L_GTCR(ch));
if (!(val & RZG2L_GTCR_CST))
return false;
val = rzg2l_gpt_read(rzg2l_gpt, RZG2L_GTIOR(ch));
return val & RZG2L_GTIOR_OxE(rzg2l_gpt_subchannel(hwpwm));
}
/* Caller holds the lock while calling rzg2l_gpt_enable() */
static void rzg2l_gpt_enable(struct rzg2l_gpt_chip *rzg2l_gpt,
struct pwm_device *pwm)
{
u8 sub_ch = rzg2l_gpt_subchannel(pwm->hwpwm);
u32 val = RZG2L_GTIOR_GTIOx(sub_ch) | RZG2L_GTIOR_OxE(sub_ch);
u8 ch = RZG2L_GET_CH(pwm->hwpwm);
/* Enable pin output */
rzg2l_gpt_modify(rzg2l_gpt, RZG2L_GTIOR(ch), val,
RZG2L_GTIOR_GTIOx_OUT_HI_END_TOGGLE_CMP_MATCH(sub_ch));
if (!rzg2l_gpt->channel_enable_count[ch])
rzg2l_gpt_modify(rzg2l_gpt, RZG2L_GTCR(ch), 0, RZG2L_GTCR_CST);
rzg2l_gpt->channel_enable_count[ch]++;
}
/* Caller holds the lock while calling rzg2l_gpt_disable() */
static void rzg2l_gpt_disable(struct rzg2l_gpt_chip *rzg2l_gpt,
struct pwm_device *pwm)
{
u8 sub_ch = rzg2l_gpt_subchannel(pwm->hwpwm);
u8 ch = RZG2L_GET_CH(pwm->hwpwm);
/* Stop count, Output low on GTIOCx pin when counting stops */
rzg2l_gpt->channel_enable_count[ch]--;
if (!rzg2l_gpt->channel_enable_count[ch])
rzg2l_gpt_modify(rzg2l_gpt, RZG2L_GTCR(ch), RZG2L_GTCR_CST, 0);
/* Disable pin output */
rzg2l_gpt_modify(rzg2l_gpt, RZG2L_GTIOR(ch), RZG2L_GTIOR_OxE(sub_ch), 0);
}
static u64 rzg2l_gpt_calculate_period_or_duty(struct rzg2l_gpt_chip *rzg2l_gpt,
u32 val, u8 prescale)
{
u64 tmp;
/*
* The calculation doesn't overflow an u64 because prescale 5 and so
* tmp = val << (2 * prescale) * USEC_PER_SEC
* < 2^32 * 2^10 * 10^6
* < 2^32 * 2^10 * 2^20
* = 2^62
*/
tmp = (u64)val << (2 * prescale);
tmp *= USEC_PER_SEC;
return DIV64_U64_ROUND_UP(tmp, rzg2l_gpt->rate_khz);
}
static int rzg2l_gpt_get_state(struct pwm_chip *chip, struct pwm_device *pwm,
struct pwm_state *state)
{
struct rzg2l_gpt_chip *rzg2l_gpt = to_rzg2l_gpt_chip(chip);
state->enabled = rzg2l_gpt_is_ch_enabled(rzg2l_gpt, pwm->hwpwm);
if (state->enabled) {
u32 sub_ch = rzg2l_gpt_subchannel(pwm->hwpwm);
u32 ch = RZG2L_GET_CH(pwm->hwpwm);
u8 prescale;
u32 val;
val = rzg2l_gpt_read(rzg2l_gpt, RZG2L_GTCR(ch));
prescale = FIELD_GET(RZG2L_GTCR_TPCS, val);
val = rzg2l_gpt_read(rzg2l_gpt, RZG2L_GTPR(ch));
state->period = rzg2l_gpt_calculate_period_or_duty(rzg2l_gpt, val, prescale);
val = rzg2l_gpt_read(rzg2l_gpt, RZG2L_GTCCR(ch, sub_ch));
state->duty_cycle = rzg2l_gpt_calculate_period_or_duty(rzg2l_gpt, val, prescale);
if (state->duty_cycle > state->period)
state->duty_cycle = state->period;
}
state->polarity = PWM_POLARITY_NORMAL;
return 0;
}
static u32 rzg2l_gpt_calculate_pv_or_dc(u64 period_or_duty_cycle, u8 prescale)
{
return min_t(u64, DIV_ROUND_DOWN_ULL(period_or_duty_cycle, 1 << (2 * prescale)),
U32_MAX);
}
/* Caller holds the lock while calling rzg2l_gpt_config() */
static int rzg2l_gpt_config(struct pwm_chip *chip, struct pwm_device *pwm,
const struct pwm_state *state)
{
struct rzg2l_gpt_chip *rzg2l_gpt = to_rzg2l_gpt_chip(chip);
u8 sub_ch = rzg2l_gpt_subchannel(pwm->hwpwm);
u8 ch = RZG2L_GET_CH(pwm->hwpwm);
u64 period_ticks, duty_ticks;
unsigned long pv, dc;
u8 prescale;
/* Limit period/duty cycle to max value supported by the HW */
period_ticks = mul_u64_u64_div_u64(state->period, rzg2l_gpt->rate_khz, USEC_PER_SEC);
if (period_ticks > RZG2L_MAX_TICKS)
period_ticks = RZG2L_MAX_TICKS;
/*
* GPT counter is shared by the two IOs of a single channel, so
* prescale and period can NOT be modified when there are multiple IOs
* in use with different settings.
*/
if (rzg2l_gpt->channel_request_count[ch] > 1 && period_ticks != rzg2l_gpt->period_ticks[ch])
return -EBUSY;
prescale = rzg2l_gpt_calculate_prescale(rzg2l_gpt, period_ticks);
pv = rzg2l_gpt_calculate_pv_or_dc(period_ticks, prescale);
duty_ticks = mul_u64_u64_div_u64(state->duty_cycle, rzg2l_gpt->rate_khz, USEC_PER_SEC);
if (duty_ticks > RZG2L_MAX_TICKS)
duty_ticks = RZG2L_MAX_TICKS;
dc = rzg2l_gpt_calculate_pv_or_dc(duty_ticks, prescale);
/*
* GPT counter is shared by multiple channels, we cache the period ticks
* from the first enabled channel and use the same value for both
* channels.
*/
rzg2l_gpt->period_ticks[ch] = period_ticks;
/*
* Counter must be stopped before modifying mode, prescaler, timer
* counter and buffer enable registers. These registers are shared
* between both channels. So allow updating these registers only for the
* first enabled channel.
*/
if (rzg2l_gpt->channel_enable_count[ch] <= 1) {
rzg2l_gpt_modify(rzg2l_gpt, RZG2L_GTCR(ch), RZG2L_GTCR_CST, 0);
/* GPT set operating mode (saw-wave up-counting) */
rzg2l_gpt_modify(rzg2l_gpt, RZG2L_GTCR(ch), RZG2L_GTCR_MD,
RZG2L_GTCR_MD_SAW_WAVE_PWM_MODE);
/* Set count direction */
rzg2l_gpt_write(rzg2l_gpt, RZG2L_GTUDDTYC(ch), RZG2L_GTUDDTYC_UP_COUNTING);
/* Select count clock */
rzg2l_gpt_modify(rzg2l_gpt, RZG2L_GTCR(ch), RZG2L_GTCR_TPCS,
FIELD_PREP(RZG2L_GTCR_TPCS, prescale));
/* Set period */
rzg2l_gpt_write(rzg2l_gpt, RZG2L_GTPR(ch), pv);
}
/* Set duty cycle */
rzg2l_gpt_write(rzg2l_gpt, RZG2L_GTCCR(ch, sub_ch), dc);
if (rzg2l_gpt->channel_enable_count[ch] <= 1) {
/* Set initial value for counter */
rzg2l_gpt_write(rzg2l_gpt, RZG2L_GTCNT(ch), 0);
/* Set no buffer operation */
rzg2l_gpt_write(rzg2l_gpt, RZG2L_GTBER(ch), 0);
/* Restart the counter after updating the registers */
rzg2l_gpt_modify(rzg2l_gpt, RZG2L_GTCR(ch),
RZG2L_GTCR_CST, RZG2L_GTCR_CST);
}
return 0;
}
static int rzg2l_gpt_apply(struct pwm_chip *chip, struct pwm_device *pwm,
const struct pwm_state *state)
{
struct rzg2l_gpt_chip *rzg2l_gpt = to_rzg2l_gpt_chip(chip);
bool enabled = pwm->state.enabled;
int ret;
if (state->polarity != PWM_POLARITY_NORMAL)
return -EINVAL;
guard(mutex)(&rzg2l_gpt->lock);
if (!state->enabled) {
if (enabled)
rzg2l_gpt_disable(rzg2l_gpt, pwm);
return 0;
}
ret = rzg2l_gpt_config(chip, pwm, state);
if (!ret && !enabled)
rzg2l_gpt_enable(rzg2l_gpt, pwm);
return ret;
}
static const struct pwm_ops rzg2l_gpt_ops = {
.request = rzg2l_gpt_request,
.free = rzg2l_gpt_free,
.get_state = rzg2l_gpt_get_state,
.apply = rzg2l_gpt_apply,
};
static int rzg2l_gpt_probe(struct platform_device *pdev)
{
struct rzg2l_gpt_chip *rzg2l_gpt;
struct device *dev = &pdev->dev;
struct reset_control *rstc;
struct pwm_chip *chip;
unsigned long rate;
struct clk *clk;
int ret;
chip = devm_pwmchip_alloc(dev, RZG2L_MAX_PWM_CHANNELS, sizeof(*rzg2l_gpt));
if (IS_ERR(chip))
return PTR_ERR(chip);
rzg2l_gpt = to_rzg2l_gpt_chip(chip);
rzg2l_gpt->mmio = devm_platform_ioremap_resource(pdev, 0);
if (IS_ERR(rzg2l_gpt->mmio))
return PTR_ERR(rzg2l_gpt->mmio);
rstc = devm_reset_control_get_exclusive_deasserted(dev, NULL);
if (IS_ERR(rstc))
return dev_err_probe(dev, PTR_ERR(rstc), "Cannot deassert reset control\n");
clk = devm_clk_get_enabled(dev, NULL);
if (IS_ERR(clk))
return dev_err_probe(dev, PTR_ERR(clk), "Cannot get clock\n");
ret = devm_clk_rate_exclusive_get(dev, clk);
if (ret)
return ret;
rate = clk_get_rate(clk);
if (!rate)
return dev_err_probe(dev, -EINVAL, "The gpt clk rate is 0");
/*
* Refuse clk rates > 1 GHz to prevent overflow later for computing
* period and duty cycle.
*/
if (rate > NSEC_PER_SEC)
return dev_err_probe(dev, -EINVAL, "The gpt clk rate is > 1GHz");
/*
* Rate is in MHz and is always integer for peripheral clk
* 2^32 * 2^10 (prescalar) * 10^6 (rate_khz) < 2^64
* So make sure rate is multiple of 1000.
*/
rzg2l_gpt->rate_khz = rate / KILO;
if (rzg2l_gpt->rate_khz * KILO != rate)
return dev_err_probe(dev, -EINVAL, "Rate is not multiple of 1000");
mutex_init(&rzg2l_gpt->lock);
chip->ops = &rzg2l_gpt_ops;
ret = devm_pwmchip_add(dev, chip);
if (ret)
return dev_err_probe(dev, ret, "Failed to add PWM chip\n");
return 0;
}
static const struct of_device_id rzg2l_gpt_of_table[] = {
{ .compatible = "renesas,rzg2l-gpt", },
{ /* Sentinel */ }
};
MODULE_DEVICE_TABLE(of, rzg2l_gpt_of_table);
static struct platform_driver rzg2l_gpt_driver = {
.driver = {
.name = "pwm-rzg2l-gpt",
.of_match_table = rzg2l_gpt_of_table,
},
.probe = rzg2l_gpt_probe,
};
module_platform_driver(rzg2l_gpt_driver);
MODULE_AUTHOR("Biju Das <biju.das.jz@bp.renesas.com>");
MODULE_DESCRIPTION("Renesas RZ/G2L General PWM Timer (GPT) Driver");
MODULE_LICENSE("GPL");