root/drivers/pmdomain/sunxi/sun55i-pck600.c
// SPDX-License-Identifier: GPL-2.0-only
/*
 * Allwinner PCK-600 power domain support
 *
 * Copyright (c) 2025 Chen-Yu Tsai <wens@csie.org>
 *
 * The hardware is likely based on the Arm PCK-600 IP, since some of
 * the registers match Arm's documents, with additional delay controls
 * that are in registers listed as reserved.
 *
 * Documents include:
 * - "Arm CoreLink PCK-600 Power Control Kit" TRM
 * - "Arm Power Policy Unit" architecture specification (DEN0051E)
 */

#include <linux/bitfield.h>
#include <linux/clk.h>
#include <linux/container_of.h>
#include <linux/device.h>
#include <linux/dev_printk.h>
#include <linux/err.h>
#include <linux/io.h>
#include <linux/iopoll.h>
#include <linux/module.h>
#include <linux/of.h>
#include <linux/platform_device.h>
#include <linux/pm_domain.h>
#include <linux/reset.h>
#include <linux/slab.h>
#include <linux/string_choices.h>

#define PPU_PWPR    0x0
#define PPU_PWSR    0x8
#define PPU_DCDR0   0x170
#define PPU_DCDR1   0x174

/* shared definition for PPU_PWPR and PPU_PWSR */
#define PPU_PWR_STATUS  GENMASK(3, 0)
#define PPU_POWER_MODE_ON       0x8
#define PPU_POWER_MODE_OFF      0x0

#define PPU_REG_SIZE    0x1000

struct sunxi_pck600_desc {
        const char * const *pd_names;
        unsigned int num_domains;
        u32 logic_power_switch0_delay_offset;
        u32 logic_power_switch1_delay_offset;
        u32 off2on_delay_offset;
        u32 device_ctrl0_delay;
        u32 device_ctrl1_delay;
        u32 logic_power_switch0_delay;
        u32 logic_power_switch1_delay;
        u32 off2on_delay;
};

struct sunxi_pck600_pd {
        struct generic_pm_domain genpd;
        struct sunxi_pck600 *pck;
        void __iomem *base;
};

struct sunxi_pck600 {
        struct device *dev;
        struct genpd_onecell_data genpd_data;
        struct sunxi_pck600_pd pds[];
};

#define to_sunxi_pd(gpd) container_of(gpd, struct sunxi_pck600_pd, genpd)

static int sunxi_pck600_pd_set_power(struct sunxi_pck600_pd *pd, bool on)
{
        struct sunxi_pck600 *pck = pd->pck;
        struct generic_pm_domain *genpd = &pd->genpd;
        int ret;
        u32 val, reg;

        val = on ? PPU_POWER_MODE_ON : PPU_POWER_MODE_OFF;

        reg = readl(pd->base + PPU_PWPR);
        FIELD_MODIFY(PPU_PWR_STATUS, &reg, val);
        writel(reg, pd->base + PPU_PWPR);

        /* push write out to hardware */
        reg = readl(pd->base + PPU_PWPR);

        ret = readl_poll_timeout_atomic(pd->base + PPU_PWSR, reg,
                                        FIELD_GET(PPU_PWR_STATUS, reg) == val,
                                        0, 10000);
        if (ret)
                dev_err(pck->dev, "failed to turn domain \"%s\" %s: %d\n",
                        genpd->name, str_on_off(on), ret);

        return ret;
}

static int sunxi_pck600_power_on(struct generic_pm_domain *domain)
{
        struct sunxi_pck600_pd *pd = to_sunxi_pd(domain);

        return sunxi_pck600_pd_set_power(pd, true);
}

static int sunxi_pck600_power_off(struct generic_pm_domain *domain)
{
        struct sunxi_pck600_pd *pd = to_sunxi_pd(domain);

        return sunxi_pck600_pd_set_power(pd, false);
}

static void sunxi_pck600_pd_setup(struct sunxi_pck600_pd *pd,
                                  const struct sunxi_pck600_desc *desc)
{
        writel(desc->device_ctrl0_delay, pd->base + PPU_DCDR0);
        writel(desc->device_ctrl1_delay, pd->base + PPU_DCDR1);
        writel(desc->logic_power_switch0_delay,
               pd->base + desc->logic_power_switch0_delay_offset);
        writel(desc->logic_power_switch1_delay,
               pd->base + desc->logic_power_switch1_delay_offset);
        writel(desc->off2on_delay, pd->base + desc->off2on_delay_offset);
}

static int sunxi_pck600_probe(struct platform_device *pdev)
{
        struct device *dev = &pdev->dev;
        const struct sunxi_pck600_desc *desc;
        struct genpd_onecell_data *genpds;
        struct sunxi_pck600 *pck;
        struct reset_control *rst;
        struct clk *clk;
        void __iomem *base;
        int i, ret;

        desc = of_device_get_match_data(dev);

        pck = devm_kzalloc(dev, struct_size(pck, pds, desc->num_domains), GFP_KERNEL);
        if (!pck)
                return -ENOMEM;

        pck->dev = &pdev->dev;
        platform_set_drvdata(pdev, pck);

        genpds = &pck->genpd_data;
        genpds->num_domains = desc->num_domains;
        genpds->domains = devm_kcalloc(dev, desc->num_domains,
                                       sizeof(*genpds->domains), GFP_KERNEL);
        if (!genpds->domains)
                return -ENOMEM;

        base = devm_platform_ioremap_resource(pdev, 0);
        if (IS_ERR(base))
                return PTR_ERR(base);

        rst = devm_reset_control_get_exclusive_released(dev, NULL);
        if (IS_ERR(rst))
                return dev_err_probe(dev, PTR_ERR(rst), "failed to get reset control\n");

        clk = devm_clk_get_enabled(dev, NULL);
        if (IS_ERR(clk))
                return dev_err_probe(dev, PTR_ERR(clk), "failed to get clock\n");

        for (i = 0; i < desc->num_domains; i++) {
                struct sunxi_pck600_pd *pd = &pck->pds[i];

                pd->genpd.name = desc->pd_names[i];
                pd->genpd.power_off = sunxi_pck600_power_off;
                pd->genpd.power_on = sunxi_pck600_power_on;
                pd->base = base + PPU_REG_SIZE * i;

                sunxi_pck600_pd_setup(pd, desc);
                ret = pm_genpd_init(&pd->genpd, NULL, false);
                if (ret) {
                        dev_err_probe(dev, ret, "failed to initialize power domain\n");
                        goto err_remove_pds;
                }

                genpds->domains[i] = &pd->genpd;
        }

        ret = of_genpd_add_provider_onecell(dev_of_node(dev), genpds);
        if (ret) {
                dev_err_probe(dev, ret, "failed to add PD provider\n");
                goto err_remove_pds;
        }

        return 0;

err_remove_pds:
        for (i--; i >= 0; i--)
                pm_genpd_remove(genpds->domains[i]);

        return ret;
}

static const char * const sun55i_a523_pck600_pd_names[] = {
        "VE", "GPU", "VI", "VO0", "VO1", "DE", "NAND", "PCIE"
};

static const struct sunxi_pck600_desc sun55i_a523_pck600_desc = {
        .pd_names = sun55i_a523_pck600_pd_names,
        .num_domains = ARRAY_SIZE(sun55i_a523_pck600_pd_names),
        .logic_power_switch0_delay_offset = 0xc00,
        .logic_power_switch1_delay_offset = 0xc04,
        .off2on_delay_offset = 0xc10,
        .device_ctrl0_delay = 0xffffff,
        .device_ctrl1_delay = 0xffff,
        .logic_power_switch0_delay = 0x8080808,
        .logic_power_switch1_delay = 0x808,
        .off2on_delay = 0x8
};

static const struct of_device_id sunxi_pck600_of_match[] = {
        {
                .compatible     = "allwinner,sun55i-a523-pck-600",
                .data           = &sun55i_a523_pck600_desc,
        },
        {}
};
MODULE_DEVICE_TABLE(of, sunxi_pck600_of_match);

static struct platform_driver sunxi_pck600_driver = {
        .probe = sunxi_pck600_probe,
        .driver = {
                .name   = "sunxi-pck-600",
                .of_match_table = sunxi_pck600_of_match,
                /* Power domains cannot be removed if in use. */
                .suppress_bind_attrs = true,
        },
};
module_platform_driver(sunxi_pck600_driver);

MODULE_DESCRIPTION("Allwinner PCK-600 power domain driver");
MODULE_AUTHOR("Chen-Yu Tsai <wens@csie.org>");
MODULE_LICENSE("GPL");