root/drivers/gpu/drm/msm/adreno/adreno_gpu.c
// SPDX-License-Identifier: GPL-2.0-only
/*
 * Copyright (C) 2013 Red Hat
 * Author: Rob Clark <robdclark@gmail.com>
 *
 * Copyright (c) 2014 The Linux Foundation. All rights reserved.
 */

#include <linux/ascii85.h>
#include <linux/interconnect.h>
#include <linux/firmware/qcom/qcom_scm.h>
#include <linux/kernel.h>
#include <linux/of_reserved_mem.h>
#include <linux/pm_opp.h>
#include <linux/slab.h>
#include <linux/soc/qcom/mdt_loader.h>
#include <linux/nvmem-consumer.h>
#include <soc/qcom/ocmem.h>
#include "adreno_gpu.h"
#include "a6xx_gpu.h"
#include "msm_gem.h"
#include "msm_mmu.h"

static u64 address_space_size = 0;
MODULE_PARM_DESC(address_space_size, "Override for size of processes private GPU address space");
module_param(address_space_size, ullong, 0600);

static bool zap_available = true;

static int zap_shader_load_mdt(struct msm_gpu *gpu, const char *fwname,
                u32 pasid)
{
        struct device *dev = &gpu->pdev->dev;
        const struct firmware *fw;
        const char *signed_fwname = NULL;
        struct device_node *np;
        struct resource r;
        phys_addr_t mem_phys;
        ssize_t mem_size;
        void *mem_region = NULL;
        int ret;

        if (!IS_ENABLED(CONFIG_ARCH_QCOM)) {
                zap_available = false;
                return -EINVAL;
        }

        np = of_get_available_child_by_name(dev->of_node, "zap-shader");
        if (!np) {
                zap_available = false;
                return -ENODEV;
        }

        ret = of_reserved_mem_region_to_resource(np, 0, &r);
        if (ret) {
                zap_available = false;
                return ret;
        }
        mem_phys = r.start;

        /*
         * Check for a firmware-name property.  This is the new scheme
         * to handle firmware that may be signed with device specific
         * keys, allowing us to have a different zap fw path for different
         * devices.
         *
         * If the firmware-name property is found, we bypass the
         * adreno_request_fw() mechanism, because we don't need to handle
         * the /lib/firmware/qcom/... vs /lib/firmware/... case.
         *
         * If the firmware-name property is not found, for backwards
         * compatibility we fall back to the fwname from the gpulist
         * table.
         */
        of_property_read_string_index(np, "firmware-name", 0, &signed_fwname);
        if (signed_fwname) {
                fwname = signed_fwname;
                ret = request_firmware_direct(&fw, fwname, gpu->dev->dev);
                if (ret)
                        fw = ERR_PTR(ret);
        } else if (fwname) {
                /* Request the MDT file from the default location: */
                fw = adreno_request_fw(to_adreno_gpu(gpu), fwname);
        } else {
                /*
                 * For new targets, we require the firmware-name property,
                 * if a zap-shader is required, rather than falling back
                 * to a firmware name specified in gpulist.
                 *
                 * Because the firmware is signed with a (potentially)
                 * device specific key, having the name come from gpulist
                 * was a bad idea, and is only provided for backwards
                 * compatibility for older targets.
                 */
                return -ENOENT;
        }

        if (IS_ERR(fw)) {
                DRM_DEV_ERROR(dev, "Unable to load %s\n", fwname);
                return PTR_ERR(fw);
        }

        /* Figure out how much memory we need */
        mem_size = qcom_mdt_get_size(fw);
        if (mem_size < 0) {
                ret = mem_size;
                goto out;
        }

        if (mem_size > resource_size(&r)) {
                DRM_DEV_ERROR(dev,
                        "memory region is too small to load the MDT\n");
                ret = -E2BIG;
                goto out;
        }

        /* Allocate memory for the firmware image */
        mem_region = memremap(mem_phys, mem_size,  MEMREMAP_WC);
        if (!mem_region) {
                ret = -ENOMEM;
                goto out;
        }

        /*
         * Load the rest of the MDT
         *
         * Note that we could be dealing with two different paths, since
         * with upstream linux-firmware it would be in a qcom/ subdir..
         * adreno_request_fw() handles this, but qcom_mdt_load() does
         * not.  But since we've already gotten through adreno_request_fw()
         * we know which of the two cases it is:
         */
        if (signed_fwname || (to_adreno_gpu(gpu)->fwloc == FW_LOCATION_LEGACY)) {
                ret = qcom_mdt_load(dev, fw, fwname, pasid,
                                mem_region, mem_phys, mem_size, NULL);
        } else {
                char *newname;

                newname = kasprintf(GFP_KERNEL, "qcom/%s", fwname);

                ret = qcom_mdt_load(dev, fw, newname, pasid,
                                mem_region, mem_phys, mem_size, NULL);
                kfree(newname);
        }
        if (ret)
                goto out;

        /* Send the image to the secure world */
        ret = qcom_scm_pas_auth_and_reset(pasid);

        /*
         * If the scm call returns -EOPNOTSUPP we assume that this target
         * doesn't need/support the zap shader so quietly fail
         */
        if (ret == -EOPNOTSUPP)
                zap_available = false;
        else if (ret)
                DRM_DEV_ERROR(dev, "Unable to authorize the image\n");

out:
        if (mem_region)
                memunmap(mem_region);

        release_firmware(fw);

        return ret;
}

int adreno_zap_shader_load(struct msm_gpu *gpu, u32 pasid)
{
        struct adreno_gpu *adreno_gpu = to_adreno_gpu(gpu);
        struct platform_device *pdev = gpu->pdev;

        /* Short cut if we determine the zap shader isn't available/needed */
        if (!zap_available)
                return -ENODEV;

        /* We need SCM to be able to load the firmware */
        if (!qcom_scm_is_available()) {
                DRM_DEV_ERROR(&pdev->dev, "SCM is not available\n");
                return -EPROBE_DEFER;
        }

        return zap_shader_load_mdt(gpu, adreno_gpu->info->zapfw, pasid);
}

struct drm_gpuvm *
adreno_create_vm(struct msm_gpu *gpu,
                 struct platform_device *pdev)
{
        return adreno_iommu_create_vm(gpu, pdev, 0);
}

struct drm_gpuvm *
adreno_iommu_create_vm(struct msm_gpu *gpu,
                       struct platform_device *pdev,
                       unsigned long quirks)
{
        struct iommu_domain_geometry *geometry;
        struct msm_mmu *mmu;
        struct drm_gpuvm *vm;
        u64 start, size;

        mmu = msm_iommu_gpu_new(&pdev->dev, gpu, quirks);
        if (IS_ERR(mmu))
                return ERR_CAST(mmu);

        geometry = msm_iommu_get_geometry(mmu);
        if (IS_ERR(geometry))
                return ERR_CAST(geometry);

        /*
         * Use the aperture start or SZ_16M, whichever is greater. This will
         * ensure that we align with the allocated pagetable range while still
         * allowing room in the lower 32 bits for GMEM and whatnot
         */
        start = max_t(u64, SZ_16M, geometry->aperture_start);
        size = geometry->aperture_end - start + 1;

        vm = msm_gem_vm_create(gpu->dev, mmu, "gpu", start & GENMASK_ULL(48, 0),
                               size, true);

        if (IS_ERR(vm) && !IS_ERR(mmu))
                mmu->funcs->destroy(mmu);

        return vm;
}

u64 adreno_private_vm_size(struct msm_gpu *gpu)
{
        struct adreno_gpu *adreno_gpu = to_adreno_gpu(gpu);
        struct adreno_smmu_priv *adreno_smmu = dev_get_drvdata(&gpu->pdev->dev);
        const struct io_pgtable_cfg *ttbr1_cfg;

        if (address_space_size)
                return address_space_size;

        if (adreno_gpu->info->quirks & ADRENO_QUIRK_4GB_VA)
                return SZ_4G;

        if (!adreno_smmu || !adreno_smmu->get_ttbr1_cfg)
                return SZ_4G;

        ttbr1_cfg = adreno_smmu->get_ttbr1_cfg(adreno_smmu->cookie);

        /*
         * Userspace VM is actually using TTBR0, but both are the same size,
         * with b48 (sign bit) selecting which TTBRn to use.  So if IAS is
         * 48, the total (kernel+user) address space size is effectively
         * 49 bits.  But what userspace is control of is the lower 48.
         */
        return BIT(ttbr1_cfg->ias) - ADRENO_VM_START;
}

void adreno_check_and_reenable_stall(struct adreno_gpu *adreno_gpu)
{
        struct msm_gpu *gpu = &adreno_gpu->base;
        struct msm_drm_private *priv = gpu->dev->dev_private;
        unsigned long flags;

        /*
         * Wait until the cooldown period has passed and we would actually
         * collect a crashdump to re-enable stall-on-fault.
         */
        spin_lock_irqsave(&priv->fault_stall_lock, flags);
        if (!priv->stall_enabled &&
                        ktime_after(ktime_get(), priv->stall_reenable_time) &&
                        !READ_ONCE(gpu->crashstate)) {
                struct msm_mmu *mmu = to_msm_vm(gpu->vm)->mmu;

                priv->stall_enabled = true;

                mmu->funcs->set_stall(mmu, true);
        }
        spin_unlock_irqrestore(&priv->fault_stall_lock, flags);
}

#define ARM_SMMU_FSR_TF                 BIT(1)
#define ARM_SMMU_FSR_PF                 BIT(3)
#define ARM_SMMU_FSR_EF                 BIT(4)
#define ARM_SMMU_FSR_SS                 BIT(30)

int adreno_fault_handler(struct msm_gpu *gpu, unsigned long iova, int flags,
                         struct adreno_smmu_fault_info *info, const char *block,
                         u32 scratch[4])
{
        struct adreno_gpu *adreno_gpu = container_of(gpu, struct adreno_gpu, base);
        struct msm_drm_private *priv = gpu->dev->dev_private;
        struct msm_mmu *mmu = to_msm_vm(gpu->vm)->mmu;
        const char *type = "UNKNOWN";
        bool do_devcoredump = info && (info->fsr & ARM_SMMU_FSR_SS) &&
                !READ_ONCE(gpu->crashstate);
        unsigned long irq_flags;

        /*
         * In case there is a subsequent storm of pagefaults, disable
         * stall-on-fault for at least half a second.
         */
        spin_lock_irqsave(&priv->fault_stall_lock, irq_flags);
        if (priv->stall_enabled) {
                priv->stall_enabled = false;

                mmu->funcs->set_stall(mmu, false);
        }

        priv->stall_reenable_time = ktime_add_ms(ktime_get(), 500);
        spin_unlock_irqrestore(&priv->fault_stall_lock, irq_flags);

        /*
         * Print a default message if we couldn't get the data from the
         * adreno-smmu-priv
         */
        if (!info) {
                pr_warn_ratelimited("*** gpu fault: iova=%.16lx flags=%d (%u,%u,%u,%u)\n",
                        iova, flags,
                        scratch[0], scratch[1], scratch[2], scratch[3]);

                return 0;
        }

        if (info->fsr & ARM_SMMU_FSR_TF)
                type = "TRANSLATION";
        else if (info->fsr & ARM_SMMU_FSR_PF)
                type = "PERMISSION";
        else if (info->fsr & ARM_SMMU_FSR_EF)
                type = "EXTERNAL";

        pr_warn_ratelimited("*** gpu fault: ttbr0=%.16llx iova=%.16lx dir=%s type=%s source=%s (%u,%u,%u,%u)\n",
                        info->ttbr0, iova,
                        flags & IOMMU_FAULT_WRITE ? "WRITE" : "READ",
                        type, block,
                        scratch[0], scratch[1], scratch[2], scratch[3]);

        if (do_devcoredump) {
                struct msm_gpu_fault_info fault_info = {};

                /* Turn off the hangcheck timer to keep it from bothering us */
                timer_delete(&gpu->hangcheck_timer);

                /* Let any concurrent GMU transactions know that the MMU may be
                 * blocked for a while and they should wait on us.
                 */
                reinit_completion(&adreno_gpu->fault_coredump_done);

                fault_info.ttbr0 = info->ttbr0;
                fault_info.iova  = iova;
                fault_info.flags = flags;
                fault_info.type  = type;
                fault_info.block = block;

                msm_gpu_fault_crashstate_capture(gpu, &fault_info);

                complete_all(&adreno_gpu->fault_coredump_done);
        }

        return 0;
}

int adreno_get_param(struct msm_gpu *gpu, struct msm_context *ctx,
                     uint32_t param, uint64_t *value, uint32_t *len)
{
        struct adreno_gpu *adreno_gpu = to_adreno_gpu(gpu);
        struct drm_device *drm = gpu->dev;
        /* Note ctx can be NULL when called from rd_open(): */
        struct drm_gpuvm *vm = ctx ? msm_context_vm(drm, ctx) : NULL;

        /* No pointer params yet */
        if (*len != 0)
                return UERR(EINVAL, drm, "invalid len");

        switch (param) {
        case MSM_PARAM_GPU_ID:
                *value = adreno_gpu->info->revn;
                return 0;
        case MSM_PARAM_GMEM_SIZE:
                *value = adreno_gpu->info->gmem;
                return 0;
        case MSM_PARAM_GMEM_BASE:
                if (adreno_gpu->info->family >= ADRENO_6XX_GEN3)
                        *value = 0;
                else
                        *value = 0x100000;
                return 0;
        case MSM_PARAM_CHIP_ID:
                *value = adreno_gpu->chip_id;
                if (!adreno_gpu->info->revn)
                        *value |= ((uint64_t) adreno_gpu->speedbin) << 32;
                return 0;
        case MSM_PARAM_MAX_FREQ:
                *value = adreno_gpu->base.fast_rate;
                return 0;
        case MSM_PARAM_TIMESTAMP:
                if (adreno_gpu->funcs->get_timestamp) {
                        pm_runtime_get_sync(&gpu->pdev->dev);
                        *value = adreno_gpu->funcs->get_timestamp(gpu);
                        pm_runtime_put_autosuspend(&gpu->pdev->dev);

                        return 0;
                }
                return -EINVAL;
        case MSM_PARAM_PRIORITIES:
                *value = gpu->nr_rings * NR_SCHED_PRIORITIES;
                return 0;
        case MSM_PARAM_PP_PGTABLE:
                *value = 0;
                return 0;
        case MSM_PARAM_FAULTS:
                if (vm)
                        *value = gpu->global_faults + to_msm_vm(vm)->faults;
                else
                        *value = gpu->global_faults;
                return 0;
        case MSM_PARAM_SUSPENDS:
                *value = gpu->suspend_count;
                return 0;
        case MSM_PARAM_VA_START:
                if (vm == gpu->vm)
                        return UERR(EINVAL, drm, "requires per-process pgtables");
                *value = vm->mm_start;
                return 0;
        case MSM_PARAM_VA_SIZE:
                if (vm == gpu->vm)
                        return UERR(EINVAL, drm, "requires per-process pgtables");
                *value = vm->mm_range;
                return 0;
        case MSM_PARAM_HIGHEST_BANK_BIT:
                if (!adreno_gpu->ubwc_config)
                        return UERR(ENOENT, drm, "no UBWC on this platform");
                *value = adreno_gpu->ubwc_config->highest_bank_bit;
                return 0;
        case MSM_PARAM_RAYTRACING:
                *value = adreno_gpu->has_ray_tracing;
                return 0;
        case MSM_PARAM_UBWC_SWIZZLE:
                if (!adreno_gpu->ubwc_config)
                        return UERR(ENOENT, drm, "no UBWC on this platform");
                *value = qcom_ubwc_swizzle(adreno_gpu->ubwc_config);
                return 0;
        case MSM_PARAM_MACROTILE_MODE:
                if (!adreno_gpu->ubwc_config)
                        return UERR(ENOENT, drm, "no UBWC on this platform");
                *value = qcom_ubwc_macrotile_mode(adreno_gpu->ubwc_config);
                return 0;
        case MSM_PARAM_UCHE_TRAP_BASE:
                *value = adreno_gpu->uche_trap_base;
                return 0;
        case MSM_PARAM_HAS_PRR:
                *value = adreno_smmu_has_prr(gpu);
                return 0;
        case MSM_PARAM_AQE:
                *value = !!(adreno_gpu->funcs->aqe_is_enabled &&
                            adreno_gpu->funcs->aqe_is_enabled(adreno_gpu));
                return 0;
        default:
                return UERR(EINVAL, drm, "%s: invalid param: %u", gpu->name, param);
        }
}

int adreno_set_param(struct msm_gpu *gpu, struct msm_context *ctx,
                     uint32_t param, uint64_t value, uint32_t len)
{
        struct drm_device *drm = gpu->dev;

        switch (param) {
        case MSM_PARAM_COMM:
        case MSM_PARAM_CMDLINE:
                /* kstrdup_quotable_cmdline() limits to PAGE_SIZE, so
                 * that should be a reasonable upper bound
                 */
                if (len > PAGE_SIZE)
                        return UERR(EINVAL, drm, "invalid len");
                break;
        default:
                if (len != 0)
                        return UERR(EINVAL, drm, "invalid len");
        }

        switch (param) {
        case MSM_PARAM_COMM:
        case MSM_PARAM_CMDLINE: {
                char *str, **paramp;

                str = memdup_user_nul(u64_to_user_ptr(value), len);
                if (IS_ERR(str))
                        return PTR_ERR(str);

                mutex_lock(&gpu->lock);

                if (param == MSM_PARAM_COMM) {
                        paramp = &ctx->comm;
                } else {
                        paramp = &ctx->cmdline;
                }

                kfree(*paramp);
                *paramp = str;

                mutex_unlock(&gpu->lock);

                return 0;
        }
        case MSM_PARAM_SYSPROF:
                if (!perfmon_capable())
                        return UERR(EPERM, drm, "invalid permissions");
                return msm_context_set_sysprof(ctx, gpu, value);
        case MSM_PARAM_EN_VM_BIND:
                /* We can only support VM_BIND with per-process pgtables: */
                if (ctx->vm == gpu->vm)
                        return UERR(EINVAL, drm, "requires per-process pgtables");

                /*
                 * We can only swtich to VM_BIND mode if the VM has not yet
                 * been created:
                 */
                if (ctx->vm)
                        return UERR(EBUSY, drm, "VM already created");

                ctx->userspace_managed_vm = value;

                return 0;
        default:
                return UERR(EINVAL, drm, "%s: invalid param: %u", gpu->name, param);
        }
}

const struct firmware *
adreno_request_fw(struct adreno_gpu *adreno_gpu, const char *fwname)
{
        struct drm_device *drm = adreno_gpu->base.dev;
        const struct firmware *fw = NULL;
        char *newname;
        int ret;

        newname = kasprintf(GFP_KERNEL, "qcom/%s", fwname);
        if (!newname)
                return ERR_PTR(-ENOMEM);

        /*
         * Try first to load from qcom/$fwfile using a direct load (to avoid
         * a potential timeout waiting for usermode helper)
         */
        if ((adreno_gpu->fwloc == FW_LOCATION_UNKNOWN) ||
            (adreno_gpu->fwloc == FW_LOCATION_NEW)) {

                ret = request_firmware_direct(&fw, newname, drm->dev);
                if (!ret) {
                        DRM_DEV_INFO(drm->dev, "loaded %s from new location\n",
                                newname);
                        adreno_gpu->fwloc = FW_LOCATION_NEW;
                        goto out;
                } else if (adreno_gpu->fwloc != FW_LOCATION_UNKNOWN) {
                        DRM_DEV_ERROR(drm->dev, "failed to load %s: %d\n",
                                newname, ret);
                        fw = ERR_PTR(ret);
                        goto out;
                }
        }

        /*
         * Then try the legacy location without qcom/ prefix
         */
        if ((adreno_gpu->fwloc == FW_LOCATION_UNKNOWN) ||
            (adreno_gpu->fwloc == FW_LOCATION_LEGACY)) {

                ret = request_firmware_direct(&fw, fwname, drm->dev);
                if (!ret) {
                        DRM_DEV_INFO(drm->dev, "loaded %s from legacy location\n",
                                fwname);
                        adreno_gpu->fwloc = FW_LOCATION_LEGACY;
                        goto out;
                } else if (adreno_gpu->fwloc != FW_LOCATION_UNKNOWN) {
                        DRM_DEV_ERROR(drm->dev, "failed to load %s: %d\n",
                                fwname, ret);
                        fw = ERR_PTR(ret);
                        goto out;
                }
        }

        /*
         * Finally fall back to request_firmware() for cases where the
         * usermode helper is needed (I think mainly android)
         */
        if ((adreno_gpu->fwloc == FW_LOCATION_UNKNOWN) ||
            (adreno_gpu->fwloc == FW_LOCATION_HELPER)) {

                ret = request_firmware(&fw, newname, drm->dev);
                if (!ret) {
                        DRM_DEV_INFO(drm->dev, "loaded %s with helper\n",
                                newname);
                        adreno_gpu->fwloc = FW_LOCATION_HELPER;
                        goto out;
                } else if (adreno_gpu->fwloc != FW_LOCATION_UNKNOWN) {
                        DRM_DEV_ERROR(drm->dev, "failed to load %s: %d\n",
                                newname, ret);
                        fw = ERR_PTR(ret);
                        goto out;
                }
        }

        DRM_DEV_ERROR(drm->dev, "failed to load %s\n", fwname);
        fw = ERR_PTR(-ENOENT);
out:
        kfree(newname);
        return fw;
}

int adreno_load_fw(struct adreno_gpu *adreno_gpu)
{
        int i;

        for (i = 0; i < ARRAY_SIZE(adreno_gpu->info->fw); i++) {
                const struct firmware *fw;

                if (!adreno_gpu->info->fw[i])
                        continue;

                /* Skip loading GMU firmware with GMU Wrapper */
                if (adreno_has_gmu_wrapper(adreno_gpu) && i == ADRENO_FW_GMU)
                        continue;

                /* Skip if the firmware has already been loaded */
                if (adreno_gpu->fw[i])
                        continue;

                fw = adreno_request_fw(adreno_gpu, adreno_gpu->info->fw[i]);
                if (IS_ERR(fw))
                        return PTR_ERR(fw);

                adreno_gpu->fw[i] = fw;
        }

        return 0;
}

struct drm_gem_object *adreno_fw_create_bo(struct msm_gpu *gpu,
                const struct firmware *fw, u64 *iova)
{
        struct drm_gem_object *bo;
        void *ptr;

        ptr = msm_gem_kernel_new(gpu->dev, fw->size - 4,
                MSM_BO_WC | MSM_BO_GPU_READONLY, gpu->vm, &bo, iova);

        if (IS_ERR(ptr))
                return ERR_CAST(ptr);

        memcpy(ptr, &fw->data[4], fw->size - 4);

        msm_gem_put_vaddr(bo);

        return bo;
}

int adreno_hw_init(struct msm_gpu *gpu)
{
        struct adreno_gpu *adreno_gpu = to_adreno_gpu(gpu);
        int ret;

        VERB("%s", gpu->name);

        if (adreno_gpu->info->family >= ADRENO_6XX_GEN1 &&
            qcom_scm_set_gpu_smmu_aperture_is_available()) {
                /* We currently always use context bank 0, so hard code this */
                ret = qcom_scm_set_gpu_smmu_aperture(0);
                if (ret)
                        DRM_DEV_ERROR(gpu->dev->dev, "unable to set SMMU aperture: %d\n", ret);
        }

        for (int i = 0; i < gpu->nr_rings; i++) {
                struct msm_ringbuffer *ring = gpu->rb[i];

                if (!ring)
                        continue;

                ring->cur = ring->start;
                ring->next = ring->start;
                ring->memptrs->rptr = 0;
                ring->memptrs->bv_fence = ring->fctx->completed_fence;

                /* Detect and clean up an impossible fence, ie. if GPU managed
                 * to scribble something invalid, we don't want that to confuse
                 * us into mistakingly believing that submits have completed.
                 */
                if (fence_before(ring->fctx->last_fence, ring->memptrs->fence)) {
                        ring->memptrs->fence = ring->fctx->last_fence;
                }
        }

        return 0;
}

/* Use this helper to read rptr, since a430 doesn't update rptr in memory */
static uint32_t get_rptr(struct adreno_gpu *adreno_gpu,
                struct msm_ringbuffer *ring)
{
        struct msm_gpu *gpu = &adreno_gpu->base;

        return gpu->funcs->get_rptr(gpu, ring);
}

struct msm_ringbuffer *adreno_active_ring(struct msm_gpu *gpu)
{
        return gpu->rb[0];
}

void adreno_recover(struct msm_gpu *gpu)
{
        struct drm_device *dev = gpu->dev;
        int ret;

        msm_perfcntr_suspend(gpu);
        gpu->funcs->pm_suspend(gpu);
        gpu->funcs->pm_resume(gpu);
        msm_perfcntr_resume(gpu);

        ret = msm_gpu_hw_init(gpu);
        if (ret) {
                DRM_DEV_ERROR(dev->dev, "gpu hw init failed: %d\n", ret);
                /* hmm, oh well? */
        }
}

void adreno_flush(struct msm_gpu *gpu, struct msm_ringbuffer *ring, u32 reg)
{
        uint32_t wptr;

        /* Copy the shadow to the actual register */
        ring->cur = ring->next;

        /*
         * Mask wptr value that we calculate to fit in the HW range. This is
         * to account for the possibility that the last command fit exactly into
         * the ringbuffer and rb->next hasn't wrapped to zero yet
         */
        wptr = get_wptr(ring);

        /* ensure writes to ringbuffer have hit system memory: */
        mb();

        gpu_write(gpu, reg, wptr);
}

bool adreno_idle(struct msm_gpu *gpu, struct msm_ringbuffer *ring)
{
        struct adreno_gpu *adreno_gpu = to_adreno_gpu(gpu);
        uint32_t wptr = get_wptr(ring);

        /* wait for CP to drain ringbuffer: */
        if (!spin_until(get_rptr(adreno_gpu, ring) == wptr))
                return true;

        /* TODO maybe we need to reset GPU here to recover from hang? */
        DRM_ERROR("%s: timeout waiting to drain ringbuffer %d rptr/wptr = %X/%X\n",
                gpu->name, ring->id, get_rptr(adreno_gpu, ring), wptr);

        return false;
}

int adreno_gpu_state_get(struct msm_gpu *gpu, struct msm_gpu_state *state)
{
        struct adreno_gpu *adreno_gpu = to_adreno_gpu(gpu);
        int i, count = 0;

        WARN_ON(!mutex_is_locked(&gpu->lock));

        kref_init(&state->ref);

        ktime_get_real_ts64(&state->time);

        for (i = 0; i < gpu->nr_rings; i++) {
                int size = 0, j;

                state->ring[i].fence = gpu->rb[i]->memptrs->fence;
                state->ring[i].iova = gpu->rb[i]->iova;
                state->ring[i].seqno = gpu->rb[i]->fctx->last_fence;
                state->ring[i].rptr = get_rptr(adreno_gpu, gpu->rb[i]);
                state->ring[i].wptr = get_wptr(gpu->rb[i]);

                /* Copy at least 'wptr' dwords of the data */
                size = state->ring[i].wptr;

                /* After wptr find the last non zero dword to save space */
                for (j = state->ring[i].wptr; j < MSM_GPU_RINGBUFFER_SZ >> 2; j++)
                        if (gpu->rb[i]->start[j])
                                size = j + 1;

                if (size) {
                        state->ring[i].data = kvmemdup(gpu->rb[i]->start, size << 2, GFP_KERNEL);
                        if (state->ring[i].data)
                                state->ring[i].data_size = size << 2;
                }
        }

        /* Some targets prefer to collect their own registers */
        if (!adreno_gpu->registers)
                return 0;

        /* Count the number of registers */
        for (i = 0; adreno_gpu->registers[i] != ~0; i += 2)
                count += adreno_gpu->registers[i + 1] -
                        adreno_gpu->registers[i] + 1;

        state->registers = kcalloc(count * 2, sizeof(u32), GFP_KERNEL);
        if (state->registers) {
                int pos = 0;

                for (i = 0; adreno_gpu->registers[i] != ~0; i += 2) {
                        u32 start = adreno_gpu->registers[i];
                        u32 end   = adreno_gpu->registers[i + 1];
                        u32 addr;

                        for (addr = start; addr <= end; addr++) {
                                state->registers[pos++] = addr;
                                state->registers[pos++] = gpu_read(gpu, addr);
                        }
                }

                state->nr_registers = count;
        }

        return 0;
}

void adreno_gpu_state_destroy(struct msm_gpu_state *state)
{
        int i;

        for (i = 0; i < ARRAY_SIZE(state->ring); i++)
                kvfree(state->ring[i].data);

        for (i = 0; state->bos && i < state->nr_bos; i++)
                kvfree(state->bos[i].data);

        kfree(state->vm_logs);
        kfree(state->bos);
        kfree(state->comm);
        kfree(state->cmd);
        kfree(state->registers);
}

static void adreno_gpu_state_kref_destroy(struct kref *kref)
{
        struct msm_gpu_state *state = container_of(kref,
                struct msm_gpu_state, ref);

        adreno_gpu_state_destroy(state);
        kfree(state);
}

int adreno_gpu_state_put(struct msm_gpu_state *state)
{
        if (IS_ERR_OR_NULL(state))
                return 1;

        return kref_put(&state->ref, adreno_gpu_state_kref_destroy);
}

#if defined(CONFIG_DEBUG_FS) || defined(CONFIG_DEV_COREDUMP)

static char *adreno_gpu_ascii85_encode(u32 *src, size_t len)
{
        void *buf;
        size_t buf_itr = 0, buffer_size;
        char out[ASCII85_BUFSZ];
        long l;
        int i;

        if (!src || !len)
                return NULL;

        l = ascii85_encode_len(len);

        /*
         * Ascii85 outputs either a 5 byte string or a 1 byte string. So we
         * account for the worst case of 5 bytes per dword plus the 1 for '\0'
         */
        buffer_size = (l * 5) + 1;

        buf = kvmalloc(buffer_size, GFP_KERNEL);
        if (!buf)
                return NULL;

        for (i = 0; i < l; i++)
                buf_itr += scnprintf(buf + buf_itr, buffer_size - buf_itr, "%s",
                                ascii85_encode(src[i], out));

        return buf;
}

/* len is expected to be in bytes
 *
 * WARNING: *ptr should be allocated with kvmalloc or friends.  It can be free'd
 * with kvfree() and replaced with a newly kvmalloc'd buffer on the first call
 * when the unencoded raw data is encoded
 */
void adreno_show_object(struct drm_printer *p, void **ptr, int len,
                bool *encoded)
{
        if (!*ptr || !len)
                return;

        if (!*encoded) {
                long datalen, i;
                u32 *buf = *ptr;

                /*
                 * Only dump the non-zero part of the buffer - rarely will
                 * any data completely fill the entire allocated size of
                 * the buffer.
                 */
                for (datalen = 0, i = 0; i < len >> 2; i++)
                        if (buf[i])
                                datalen = ((i + 1) << 2);

                /*
                 * If we reach here, then the originally captured binary buffer
                 * will be replaced with the ascii85 encoded string
                 */
                *ptr = adreno_gpu_ascii85_encode(buf, datalen);

                kvfree(buf);

                *encoded = true;
        }

        if (!*ptr)
                return;

        drm_puts(p, "    data: !!ascii85 |\n");
        drm_puts(p, "     ");

        drm_puts(p, *ptr);

        drm_puts(p, "\n");
}

void adreno_show(struct msm_gpu *gpu, struct msm_gpu_state *state,
                struct drm_printer *p)
{
        struct adreno_gpu *adreno_gpu = to_adreno_gpu(gpu);
        int i;

        if (IS_ERR_OR_NULL(state))
                return;

        drm_printf(p, "revision: %u (%"ADRENO_CHIPID_FMT")\n",
                        adreno_gpu->info->revn,
                        ADRENO_CHIPID_ARGS(adreno_gpu->chip_id));
        /*
         * If this is state collected due to iova fault, so fault related info
         *
         * TTBR0 would not be zero, so this is a good way to distinguish
         */
        if (state->fault_info.ttbr0) {
                const struct msm_gpu_fault_info *info = &state->fault_info;

                drm_puts(p, "fault-info:\n");
                drm_printf(p, "  - ttbr0=%.16llx\n", info->ttbr0);
                drm_printf(p, "  - iova=%.16lx\n", info->iova);
                drm_printf(p, "  - dir=%s\n", info->flags & IOMMU_FAULT_WRITE ? "WRITE" : "READ");
                drm_printf(p, "  - type=%s\n", info->type);
                drm_printf(p, "  - source=%s\n", info->block);

                /* Information extracted from what we think are the current
                 * pgtables.  Hopefully the TTBR0 matches what we've extracted
                 * from the SMMU registers in smmu_info!
                 */
                drm_puts(p, "pgtable-fault-info:\n");
                drm_printf(p, "  - ttbr0: %.16llx\n", (u64)info->pgtbl_ttbr0);
                drm_printf(p, "  - asid: %d\n", info->asid);
                drm_printf(p, "  - ptes: %.16llx %.16llx %.16llx %.16llx\n",
                           info->ptes[0], info->ptes[1], info->ptes[2], info->ptes[3]);
        }

        if (state->vm_logs) {
                drm_puts(p, "vm-log:\n");
                for (i = 0; i < state->nr_vm_logs; i++) {
                        struct msm_gem_vm_log_entry *e = &state->vm_logs[i];
                        drm_printf(p, "  - %s:%d: 0x%016llx-0x%016llx\n",
                                   e->op, e->queue_id, e->iova,
                                   e->iova + e->range);
                }
        }

        drm_printf(p, "rbbm-status: 0x%08x\n", state->rbbm_status);

        drm_puts(p, "ringbuffer:\n");

        for (i = 0; i < gpu->nr_rings; i++) {
                drm_printf(p, "  - id: %d\n", i);
                drm_printf(p, "    iova: 0x%016llx\n", state->ring[i].iova);
                drm_printf(p, "    last-fence: %u\n", state->ring[i].seqno);
                drm_printf(p, "    retired-fence: %u\n", state->ring[i].fence);
                drm_printf(p, "    rptr: %u\n", state->ring[i].rptr);
                drm_printf(p, "    wptr: %u\n", state->ring[i].wptr);
                drm_printf(p, "    size: %u\n", MSM_GPU_RINGBUFFER_SZ);

                adreno_show_object(p, &state->ring[i].data,
                        state->ring[i].data_size, &state->ring[i].encoded);
        }

        if (state->bos) {
                drm_puts(p, "bos:\n");

                for (i = 0; i < state->nr_bos; i++) {
                        drm_printf(p, "  - iova: 0x%016llx\n",
                                state->bos[i].iova);
                        drm_printf(p, "    size: %zd\n", state->bos[i].size);
                        drm_printf(p, "    flags: 0x%x\n", state->bos[i].flags);
                        drm_printf(p, "    name: %-32s\n", state->bos[i].name);

                        adreno_show_object(p, &state->bos[i].data,
                                state->bos[i].size, &state->bos[i].encoded);
                }
        }

        if (state->nr_registers) {
                drm_puts(p, "registers:\n");

                for (i = 0; i < state->nr_registers; i++) {
                        drm_printf(p, "  - { offset: 0x%04x, value: 0x%08x }\n",
                                state->registers[i * 2] << 2,
                                state->registers[(i * 2) + 1]);
                }
        }
}
#endif

/* Dump common gpu status and scratch registers on any hang, to make
 * the hangcheck logs more useful.  The scratch registers seem always
 * safe to read when GPU has hung (unlike some other regs, depending
 * on how the GPU hung), and they are useful to match up to cmdstream
 * dumps when debugging hangs:
 */
void adreno_dump_info(struct msm_gpu *gpu)
{
        struct adreno_gpu *adreno_gpu = to_adreno_gpu(gpu);
        int i;

        printk("revision: %u (%"ADRENO_CHIPID_FMT")\n",
                        adreno_gpu->info->revn,
                        ADRENO_CHIPID_ARGS(adreno_gpu->chip_id));

        for (i = 0; i < gpu->nr_rings; i++) {
                struct msm_ringbuffer *ring = gpu->rb[i];

                printk("rb %d: fence:    %d/%d\n", i,
                        ring->memptrs->fence,
                        ring->fctx->last_fence);

                printk("rptr:     %d\n", get_rptr(adreno_gpu, ring));
                printk("rb wptr:  %d\n", get_wptr(ring));
        }
}

/* would be nice to not have to duplicate the _show() stuff with printk(): */
void adreno_dump(struct msm_gpu *gpu)
{
        struct adreno_gpu *adreno_gpu = to_adreno_gpu(gpu);
        int i;

        if (!adreno_gpu->registers)
                return;

        /* dump these out in a form that can be parsed by demsm: */
        printk("IO:region %s 00000000 00020000\n", gpu->name);
        for (i = 0; adreno_gpu->registers[i] != ~0; i += 2) {
                uint32_t start = adreno_gpu->registers[i];
                uint32_t end   = adreno_gpu->registers[i+1];
                uint32_t addr;

                for (addr = start; addr <= end; addr++) {
                        uint32_t val = gpu_read(gpu, addr);
                        printk("IO:R %08x %08x\n", addr<<2, val);
                }
        }
}

static uint32_t ring_freewords(struct msm_ringbuffer *ring)
{
        struct adreno_gpu *adreno_gpu = to_adreno_gpu(ring->gpu);
        uint32_t size = MSM_GPU_RINGBUFFER_SZ >> 2;
        /* Use ring->next to calculate free size */
        uint32_t wptr = ring->next - ring->start;
        uint32_t rptr = get_rptr(adreno_gpu, ring);
        return (rptr + (size - 1) - wptr) % size;
}

void adreno_wait_ring(struct msm_ringbuffer *ring, uint32_t ndwords)
{
        if (spin_until(ring_freewords(ring) >= ndwords))
                DRM_DEV_ERROR(ring->gpu->dev->dev,
                        "timeout waiting for space in ringbuffer %d\n",
                        ring->id);
}

static int adreno_get_pwrlevels(struct device *dev,
                struct msm_gpu *gpu)
{
        struct adreno_gpu *adreno_gpu = to_adreno_gpu(gpu);
        unsigned long freq = ULONG_MAX;
        struct dev_pm_opp *opp;
        int ret;

        gpu->fast_rate = 0;

        /* devm_pm_opp_of_add_table may error out but will still create an OPP table */
        ret = devm_pm_opp_of_add_table(dev);
        if (ret == -ENODEV) {
                /* Special cases for ancient hw with ancient DT bindings */
                if (adreno_is_a2xx(adreno_gpu)) {
                        dev_warn(dev, "Unable to find the OPP table. Falling back to 200 MHz.\n");
                        dev_pm_opp_add(dev, 200000000, 0);
                } else if (adreno_is_a320(adreno_gpu)) {
                        dev_warn(dev, "Unable to find the OPP table. Falling back to 450 MHz.\n");
                        dev_pm_opp_add(dev, 450000000, 0);
                } else {
                        DRM_DEV_ERROR(dev, "Unable to find the OPP table\n");
                        return -ENODEV;
                }
        } else if (ret) {
                DRM_DEV_ERROR(dev, "Unable to set the OPP table\n");
                return ret;
        }

        /* Find the fastest defined rate */
        opp = dev_pm_opp_find_freq_floor(dev, &freq);
        if (IS_ERR(opp))
                return PTR_ERR(opp);

        gpu->fast_rate = freq;
        dev_pm_opp_put(opp);

        DBG("fast_rate=%u, slow_rate=27000000", gpu->fast_rate);

        return 0;
}

int adreno_gpu_ocmem_init(struct device *dev, struct adreno_gpu *adreno_gpu,
                          struct adreno_ocmem *adreno_ocmem)
{
        struct ocmem_buf *ocmem_hdl;
        struct ocmem *ocmem;

        ocmem = of_get_ocmem(dev);
        if (IS_ERR(ocmem)) {
                if (PTR_ERR(ocmem) == -ENODEV) {
                        /*
                         * Return success since either the ocmem property was
                         * not specified in device tree, or ocmem support is
                         * not compiled into the kernel.
                         */
                        return 0;
                }

                return PTR_ERR(ocmem);
        }

        ocmem_hdl = ocmem_allocate(ocmem, OCMEM_GRAPHICS, adreno_gpu->info->gmem);
        if (IS_ERR(ocmem_hdl))
                return PTR_ERR(ocmem_hdl);

        adreno_ocmem->ocmem = ocmem;
        adreno_ocmem->base = ocmem_hdl->addr;
        adreno_ocmem->hdl = ocmem_hdl;

        if (WARN_ON(ocmem_hdl->len != adreno_gpu->info->gmem))
                return -ENOMEM;

        return 0;
}

void adreno_gpu_ocmem_cleanup(struct adreno_ocmem *adreno_ocmem)
{
        if (adreno_ocmem && adreno_ocmem->base)
                ocmem_free(adreno_ocmem->ocmem, OCMEM_GRAPHICS,
                           adreno_ocmem->hdl);
}

int adreno_read_speedbin(struct device *dev, u32 *speedbin)
{
        return nvmem_cell_read_variable_le_u32(dev, "speed_bin", speedbin);
}

int adreno_gpu_init(struct drm_device *drm, struct platform_device *pdev,
                struct adreno_gpu *adreno_gpu,
                const struct adreno_gpu_funcs *funcs, int nr_rings)
{
        struct device *dev = &pdev->dev;
        struct adreno_platform_config *config = dev->platform_data;
        struct msm_gpu_config adreno_gpu_config  = { 0 };
        struct msm_gpu *gpu = &adreno_gpu->base;
        const char *gpu_name;
        int ret;

        adreno_gpu->funcs = funcs;
        adreno_gpu->info = config->info;
        adreno_gpu->chip_id = config->chip_id;

        gpu->allow_relocs = config->info->family < ADRENO_6XX_GEN1;
        gpu->pdev = pdev;

        /* Only handle the core clock when GMU is not in use (or is absent). */
        if (adreno_has_gmu_wrapper(adreno_gpu) ||
            adreno_has_rgmu(adreno_gpu) ||
            adreno_gpu->info->family < ADRENO_6XX_GEN1) {
                /*
                 * This can only be done before devm_pm_opp_of_add_table(), or
                 * dev_pm_opp_set_config() will WARN_ON()
                 */
                if (IS_ERR(devm_clk_get(dev, "core"))) {
                        /*
                         * If "core" is absent, go for the legacy clock name.
                         * If we got this far in probing, it's a given one of
                         * them exists.
                         */
                        devm_pm_opp_set_clkname(dev, "core_clk");
                } else
                        devm_pm_opp_set_clkname(dev, "core");
        }

        gpu_name = devm_kasprintf(dev, GFP_KERNEL, "%"ADRENO_CHIPID_FMT,
                        ADRENO_CHIPID_ARGS(config->chip_id));
        if (!gpu_name)
                return -ENOMEM;

        adreno_gpu_config.ioname = "kgsl_3d0_reg_memory";

        adreno_gpu_config.nr_rings = nr_rings;

        ret = adreno_get_pwrlevels(dev, gpu);
        if (ret)
                return ret;

        init_completion(&adreno_gpu->fault_coredump_done);
        complete_all(&adreno_gpu->fault_coredump_done);

        pm_runtime_set_autosuspend_delay(dev,
                adreno_gpu->info->inactive_period);
        pm_runtime_use_autosuspend(dev);

        return msm_gpu_init(drm, pdev, &adreno_gpu->base, &funcs->base,
                        gpu_name, &adreno_gpu_config);
}

void adreno_gpu_cleanup(struct adreno_gpu *adreno_gpu)
{
        struct msm_gpu *gpu = &adreno_gpu->base;
        struct msm_drm_private *priv = gpu->dev ? gpu->dev->dev_private : NULL;
        unsigned int i;

        for (i = 0; i < ARRAY_SIZE(adreno_gpu->info->fw); i++)
                release_firmware(adreno_gpu->fw[i]);

        if (priv && pm_runtime_enabled(&priv->gpu_pdev->dev))
                pm_runtime_disable(&priv->gpu_pdev->dev);

        msm_gpu_cleanup(&adreno_gpu->base);
}