Re: [PATCH v12 1/4] drm/imagination: Use pwrseq for TH1520 GPU power management

[Matt Coster <Matt.Coster@imgtec.com>]

[-- Attachment #1.1: Type: text/plain, Size: 14157 bytes --]

On 20/08/2025 18:08, Ulf Hansson wrote:
> On Wed, 20 Aug 2025 at 10:56, Michal Wilczynski
> <m.wilczynski@samsung.com> wrote:
>>
>> Update the Imagination PVR DRM driver to leverage the pwrseq framework
>> for managing the complex power sequence of the GPU on the T-HEAD TH1520
>> SoC.
>>
>> To cleanly separate platform-specific logic from the generic driver,
>> this patch introduces an `init` callback to the `pwr_power_sequence_ops`
>> struct. This allows for different power management strategies to be
>> selected at probe time based on the device's compatible string.
>>
>> A `pvr_device_data` struct, associated with each compatible in the
>> of_device_id table, points to the appropriate ops table (manual or
>> pwrseq).
>>
>> At probe time, the driver now calls the `->init()` op. For pwrseq-based
>> platforms, this callback calls `devm_pwrseq_get("gpu-power")`, deferring
>> probe if the sequencer is not yet available. For other platforms, it
>> falls back to the existing manual clock and reset handling. The runtime
>> PM callbacks continue to call the appropriate functions via the ops
>> table.
>>
>> Signed-off-by: Michal Wilczynski <m.wilczynski@samsung.com>
>> ---
>>  drivers/gpu/drm/imagination/pvr_device.c |  22 +---
>>  drivers/gpu/drm/imagination/pvr_device.h |  22 ++++
>>  drivers/gpu/drm/imagination/pvr_drv.c    |  27 ++++-
>>  drivers/gpu/drm/imagination/pvr_power.c  | 174 ++++++++++++++++++++++++-------
>>  drivers/gpu/drm/imagination/pvr_power.h  |  15 +++
>>  5 files changed, 201 insertions(+), 59 deletions(-)
>>
>> diff --git a/drivers/gpu/drm/imagination/pvr_device.c b/drivers/gpu/drm/imagination/pvr_device.c
>> index 8b9ba4983c4cb5bc40342fcafc4259078bc70547..294b6019b4155bb7fdb7de73ccf7fa8ad867811f 100644
>> --- a/drivers/gpu/drm/imagination/pvr_device.c
>> +++ b/drivers/gpu/drm/imagination/pvr_device.c
>> @@ -23,6 +23,7 @@
>>  #include <linux/firmware.h>
>>  #include <linux/gfp.h>
>>  #include <linux/interrupt.h>
>> +#include <linux/of.h>
>>  #include <linux/platform_device.h>
>>  #include <linux/pm_runtime.h>
>>  #include <linux/reset.h>
>> @@ -121,21 +122,6 @@ static int pvr_device_clk_init(struct pvr_device *pvr_dev)
>>         return 0;
>>  }
>>
>> -static int pvr_device_reset_init(struct pvr_device *pvr_dev)
>> -{
>> -       struct drm_device *drm_dev = from_pvr_device(pvr_dev);
>> -       struct reset_control *reset;
>> -
>> -       reset = devm_reset_control_get_optional_exclusive(drm_dev->dev, NULL);
>> -       if (IS_ERR(reset))
>> -               return dev_err_probe(drm_dev->dev, PTR_ERR(reset),
>> -                                    "failed to get gpu reset line\n");
>> -
>> -       pvr_dev->reset = reset;
>> -
>> -       return 0;
>> -}
>> -
>>  /**
>>   * pvr_device_process_active_queues() - Process all queue related events.
>>   * @pvr_dev: PowerVR device to check
>> @@ -618,6 +604,9 @@ pvr_device_init(struct pvr_device *pvr_dev)
>>         struct device *dev = drm_dev->dev;
>>         int err;
>>
>> +       /* Get the platform-specific data based on the compatible string. */
>> +       pvr_dev->device_data = of_device_get_match_data(dev);
>> +
>>         /*
>>          * Setup device parameters. We do this first in case other steps
>>          * depend on them.
>> @@ -631,8 +620,7 @@ pvr_device_init(struct pvr_device *pvr_dev)
>>         if (err)
>>                 return err;
>>
>> -       /* Get the reset line for the GPU */
>> -       err = pvr_device_reset_init(pvr_dev);
>> +       err = pvr_dev->device_data->pwr_ops->init(pvr_dev);
>>         if (err)
>>                 return err;
>>
>> diff --git a/drivers/gpu/drm/imagination/pvr_device.h b/drivers/gpu/drm/imagination/pvr_device.h
>> index 7cb01c38d2a9c3fc71effe789d4dfe54eddd93ee..0c970255f90805a569d7d19e35ec5f4ca7f02f7a 100644
>> --- a/drivers/gpu/drm/imagination/pvr_device.h
>> +++ b/drivers/gpu/drm/imagination/pvr_device.h
>> @@ -37,6 +37,9 @@ struct clk;
>>  /* Forward declaration from <linux/firmware.h>. */
>>  struct firmware;
>>
>> +/* Forward declaration from <linux/pwrseq/consumer.h> */
>> +struct pwrseq_desc;
>> +
>>  /**
>>   * struct pvr_gpu_id - Hardware GPU ID information for a PowerVR device
>>   * @b: Branch ID.
>> @@ -57,6 +60,14 @@ struct pvr_fw_version {
>>         u16 major, minor;
>>  };
>>
>> +/**
>> + * struct pvr_device_data - Platform specific data associated with a compatible string.
>> + * @pwr_ops: Pointer to a structure with platform-specific power functions.
>> + */
>> +struct pvr_device_data {
>> +       const struct pvr_power_sequence_ops *pwr_ops;
>> +};
>> +
>>  /**
>>   * struct pvr_device - powervr-specific wrapper for &struct drm_device
>>   */
>> @@ -98,6 +109,9 @@ struct pvr_device {
>>         /** @fw_version: Firmware version detected at runtime. */
>>         struct pvr_fw_version fw_version;
>>
>> +       /** @device_data: Pointer to platform-specific data. */
>> +       const struct pvr_device_data *device_data;
>> +
>>         /** @regs_resource: Resource representing device control registers. */
>>         struct resource *regs_resource;
>>
>> @@ -148,6 +162,14 @@ struct pvr_device {
>>          */
>>         struct reset_control *reset;
>>
>> +       /**
>> +        * @pwrseq: Pointer to a power sequencer, if one is used.
>> +        *
>> +        * Note: This member should only be accessed when
>> +        * IS_ENABLED(CONFIG_POWER_SEQUENCING) is true.
>> +        */
> 
> This looks like something that should be taken care of by the pwrseq interface?
> 
> Ideally there should be stub functions, when CONFIG_POWER_SEQUENCING
> is unset, right?

This one is my fault, I was just reviewing from the patches when I
requested that note and didn't appreciate that the pwrseq header
includes stubbed-out functions already. Lesson learned.

> 
>> +       struct pwrseq_desc *pwrseq;
>> +
>>         /** @irq: IRQ number. */
>>         int irq;
>>
>> diff --git a/drivers/gpu/drm/imagination/pvr_drv.c b/drivers/gpu/drm/imagination/pvr_drv.c
>> index b058ec183bb30ab5c3db17ebaadf2754520a2a1f..af830e565646daf19555197df492438ef48d5e44 100644
>> --- a/drivers/gpu/drm/imagination/pvr_drv.c
>> +++ b/drivers/gpu/drm/imagination/pvr_drv.c
>> @@ -1480,15 +1480,37 @@ static void pvr_remove(struct platform_device *plat_dev)
>>         pvr_power_domains_fini(pvr_dev);
>>  }
>>
>> +static const struct pvr_device_data pvr_device_data_manual = {
>> +       .pwr_ops = &pvr_power_sequence_ops_manual,
>> +};
>> +
>> +#if IS_ENABLED(CONFIG_POWER_SEQUENCING)
> 
> Ditto.
> 
>> +static const struct pvr_device_data pvr_device_data_pwrseq = {
>> +       .pwr_ops = &pvr_power_sequence_ops_pwrseq,
>> +};
>> +#endif
>> +
>>  static const struct of_device_id dt_match[] = {
>> -       { .compatible = "img,img-rogue", .data = NULL },
>> +#if IS_ENABLED(CONFIG_POWER_SEQUENCING)
> 
> Ditto.
> 
> I don't see anything wrong with allowing the driver to probe with the
> compatible below.
> 
> When it then tries to hook up a pwrseq handle and fails, then the
> probe function should fail. Right?
> 
>> +       {
>> +               .compatible = "thead,th1520-gpu",
>> +               .data = &pvr_device_data_pwrseq,
>> +       },
>> +#endif
>> +       {
>> +               .compatible = "img,img-rogue",
>> +               .data = &pvr_device_data_manual,
>> +       },
>>
>>         /*
>>          * This legacy compatible string was introduced early on before the more generic
>>          * "img,img-rogue" was added. Keep it around here for compatibility, but never use
>>          * "img,img-axe" in new devicetrees.
>>          */
>> -       { .compatible = "img,img-axe", .data = NULL },
>> +       {
>> +               .compatible = "img,img-axe",
>> +               .data = &pvr_device_data_manual,
>> +       },
>>         {}
>>  };
>>  MODULE_DEVICE_TABLE(of, dt_match);
>> @@ -1513,4 +1535,5 @@ MODULE_DESCRIPTION(PVR_DRIVER_DESC);
>>  MODULE_LICENSE("Dual MIT/GPL");
>>  MODULE_IMPORT_NS("DMA_BUF");
>>  MODULE_FIRMWARE("powervr/rogue_33.15.11.3_v1.fw");
>> +MODULE_FIRMWARE("powervr/rogue_36.52.104.182_v1.fw");
>>  MODULE_FIRMWARE("powervr/rogue_36.53.104.796_v1.fw");
>> diff --git a/drivers/gpu/drm/imagination/pvr_power.c b/drivers/gpu/drm/imagination/pvr_power.c
>> index 187a07e0bd9adb2f0713ac2c8e091229f4027354..58e0e812894de19c834e1dfca427208b343eaa1c 100644
>> --- a/drivers/gpu/drm/imagination/pvr_power.c
>> +++ b/drivers/gpu/drm/imagination/pvr_power.c
>> @@ -18,6 +18,9 @@
>>  #include <linux/platform_device.h>
>>  #include <linux/pm_domain.h>
>>  #include <linux/pm_runtime.h>
>> +#if IS_ENABLED(CONFIG_POWER_SEQUENCING)
>> +#include <linux/pwrseq/consumer.h>
>> +#endif
>>  #include <linux/reset.h>
>>  #include <linux/timer.h>
>>  #include <linux/types.h>
>> @@ -234,6 +237,132 @@ pvr_watchdog_init(struct pvr_device *pvr_dev)
>>         return 0;
>>  }
>>
>> +static int pvr_power_init_manual(struct pvr_device *pvr_dev)
>> +{
>> +       struct drm_device *drm_dev = from_pvr_device(pvr_dev);
>> +       struct reset_control *reset;
>> +
>> +       reset = devm_reset_control_get_optional_exclusive(drm_dev->dev, NULL);
>> +       if (IS_ERR(reset))
>> +               return dev_err_probe(drm_dev->dev, PTR_ERR(reset),
>> +                                    "failed to get gpu reset line\n");
>> +
>> +       pvr_dev->reset = reset;
>> +
>> +       return 0;
>> +}
>> +
>> +static int pvr_power_on_sequence_manual(struct pvr_device *pvr_dev)
>> +{
>> +       int err;
>> +
>> +       err = clk_prepare_enable(pvr_dev->core_clk);
>> +       if (err)
>> +               return err;
>> +
>> +       err = clk_prepare_enable(pvr_dev->sys_clk);
>> +       if (err)
>> +               goto err_core_clk_disable;
>> +
>> +       err = clk_prepare_enable(pvr_dev->mem_clk);
>> +       if (err)
>> +               goto err_sys_clk_disable;
>> +
>> +       /*
>> +        * According to the hardware manual, a delay of at least 32 clock
>> +        * cycles is required between de-asserting the clkgen reset and
>> +        * de-asserting the GPU reset. Assuming a worst-case scenario with
>> +        * a very high GPU clock frequency, a delay of 1 microsecond is
>> +        * sufficient to ensure this requirement is met across all
>> +        * feasible GPU clock speeds.
>> +        */
>> +       udelay(1);
>> +
>> +       err = reset_control_deassert(pvr_dev->reset);
>> +       if (err)
>> +               goto err_mem_clk_disable;
>> +
>> +       return 0;
>> +
>> +err_mem_clk_disable:
>> +       clk_disable_unprepare(pvr_dev->mem_clk);
>> +
>> +err_sys_clk_disable:
>> +       clk_disable_unprepare(pvr_dev->sys_clk);
>> +
>> +err_core_clk_disable:
>> +       clk_disable_unprepare(pvr_dev->core_clk);
>> +
>> +       return err;
>> +}
>> +
>> +static int pvr_power_off_sequence_manual(struct pvr_device *pvr_dev)
>> +{
>> +       int err;
>> +
>> +       err = reset_control_assert(pvr_dev->reset);
>> +
>> +       clk_disable_unprepare(pvr_dev->mem_clk);
>> +       clk_disable_unprepare(pvr_dev->sys_clk);
>> +       clk_disable_unprepare(pvr_dev->core_clk);
>> +
>> +       return err;
>> +}
>> +
>> +const struct pvr_power_sequence_ops pvr_power_sequence_ops_manual = {
>> +       .init = pvr_power_init_manual,
>> +       .power_on = pvr_power_on_sequence_manual,
>> +       .power_off = pvr_power_off_sequence_manual,
>> +};
>> +
>> +#if IS_ENABLED(CONFIG_POWER_SEQUENCING)
> 
> Again, this should not be needed. Instead, the call to
> devm_pwrseq_get() should return an error from a stub function if
> CONFIG_POWER_SEQUENCING is not set, right?
> 
> The similar should apply to pwrseq_power_on|off(), right?
> 
>> +static int pvr_power_init_pwrseq(struct pvr_device *pvr_dev)
>> +{
>> +       struct device *dev = from_pvr_device(pvr_dev)->dev;
>> +
>> +       pvr_dev->pwrseq = devm_pwrseq_get(dev, "gpu-power");
>> +       if (IS_ERR(pvr_dev->pwrseq)) {
>> +               /*
>> +                * This platform requires a sequencer. If we can't get it, we
>> +                * must return the error (including -EPROBE_DEFER to wait for
>> +                * the provider to appear)
>> +                */
>> +               return dev_err_probe(dev, PTR_ERR(pvr_dev->pwrseq),
>> +                                    "Failed to get required power sequencer\n");
>> +       }
>> +
>> +       return 0;
>> +}
>> +
>> +static int pvr_power_on_sequence_pwrseq(struct pvr_device *pvr_dev)
>> +{
>> +       return pwrseq_power_on(pvr_dev->pwrseq);
>> +}
>> +
>> +static int pvr_power_off_sequence_pwrseq(struct pvr_device *pvr_dev)
>> +{
>> +       return pwrseq_power_off(pvr_dev->pwrseq);
>> +}
>> +
>> +const struct pvr_power_sequence_ops pvr_power_sequence_ops_pwrseq = {
>> +       .init = pvr_power_init_pwrseq,
>> +       .power_on = pvr_power_on_sequence_pwrseq,
>> +       .power_off = pvr_power_off_sequence_pwrseq,
>> +};
>> +#else /* IS_ENABLED(CONFIG_POWER_SEQUENCING) */
>> +static int pvr_power_sequence_stub(struct pvr_device *pvr_dev)
>> +{
>> +       WARN_ONCE(1, "pwrseq support not enabled in kernel config\n");
>> +       return -EOPNOTSUPP;
>> +}
>> +
>> +const struct pvr_power_sequence_ops pvr_power_sequence_ops_pwrseq = {
>> +       .init = pvr_power_sequence_stub,
>> +       .power_on = pvr_power_sequence_stub,
>> +       .power_off = pvr_power_sequence_stub,
>> +};
>> +#endif /* IS_ENABLED(CONFIG_POWER_SEQUENCING) */
> 
> Yeah, this looks really messy to me.
> 
> If there is something missing in the pwrseq interface to make this
> simpler, let's add that instead of having to keep this if/def hacks
> around.

Agreed (now that I've actually done my homework), I see no reason to
keep the IS_ENABLED(...) checks around.

Cheers,
Matt

> 
> [...]
> 
> Other than the if/def hacks, I think this looks good to me!
> 
> Kind regards
> Uffe


-- 
Matt Coster
E: matt.coster@imgtec.com

[-- Attachment #2: OpenPGP digital signature --]
[-- Type: application/pgp-signature, Size: 236 bytes --]