drivers/gpu/drm/imagination/pvr_queue.h

root/drivers/gpu/drm/imagination/pvr_queue.h
/* SPDX-License-Identifier: GPL-2.0-only OR MIT */
/* Copyright (c) 2023 Imagination Technologies Ltd. */

#ifndef PVR_QUEUE_H
#define PVR_QUEUE_H

#include <drm/gpu_scheduler.h>
#include <linux/workqueue.h>

#include "pvr_cccb.h"
#include "pvr_device.h"

struct pvr_context;
struct pvr_queue;

/**
 * struct pvr_queue_fence_ctx - Queue fence context
 *
 * Used to implement dma_fence_ops for pvr_job::{done,cccb}_fence.
 */
struct pvr_queue_fence_ctx {
        /** @id: Fence context ID allocated with dma_fence_context_alloc(). */
        u64 id;

        /** @seqno: Sequence number incremented each time a fence is created. */
        atomic_t seqno;

        /** @lock: Lock used to synchronize access to fences allocated by this context. */
        spinlock_t lock;
};

/**
 * struct pvr_queue_cccb_fence_ctx - CCCB fence context
 *
 * Context used to manage fences controlling access to the CCCB. No fences are
 * issued if there's enough space in the CCCB to push job commands.
 */
struct pvr_queue_cccb_fence_ctx {
        /** @base: Base queue fence context. */
        struct pvr_queue_fence_ctx base;

        /**
         * @job: Job waiting for CCCB space.
         *
         * Thanks to the serializationg done at the drm_sched_entity level,
         * there's no more than one job waiting for CCCB at a given time.
         *
         * This field is NULL if no jobs are currently waiting for CCCB space.
         *
         * Must be accessed with @job_lock held.
         */
        struct pvr_job *job;

        /** @job_lock: Lock protecting access to the job object. */
        struct mutex job_lock;
};

/**
 * struct pvr_queue_fence - Queue fence object
 */
struct pvr_queue_fence {
        /** @base: Base dma_fence. */
        struct dma_fence base;

        /** @queue: Queue that created this fence. */
        struct pvr_queue *queue;

        /** @release_work: Fence release work structure. */
        struct work_struct release_work;
};

/**
 * struct pvr_queue - Job queue
 *
 * Used to queue and track execution of pvr_job objects.
 */
struct pvr_queue {
        /** @scheduler: Single entity scheduler use to push jobs to this queue. */
        struct drm_gpu_scheduler scheduler;

        /** @entity: Scheduling entity backing this queue. */
        struct drm_sched_entity entity;

        /** @type: Type of jobs queued to this queue. */
        enum drm_pvr_job_type type;

        /** @ctx: Context object this queue is bound to. */
        struct pvr_context *ctx;

        /** @node: Used to add the queue to the active/idle queue list. */
        struct list_head node;

        /**
         * @in_flight_job_count: Number of jobs submitted to the CCCB that
         * have not been processed yet.
         */
        atomic_t in_flight_job_count;

        /**
         * @cccb_fence_ctx: CCCB fence context.
         *
         * Used to control access to the CCCB is full, such that we don't
         * end up trying to push commands to the CCCB if there's not enough
         * space to receive all commands needed for a job to complete.
         */
        struct pvr_queue_cccb_fence_ctx cccb_fence_ctx;

        /** @job_fence_ctx: Job fence context object. */
        struct pvr_queue_fence_ctx job_fence_ctx;

        /** @timeline_ufo: Timeline UFO for the context queue. */
        struct {
                /** @fw_obj: FW object representing the UFO value. */
                struct pvr_fw_object *fw_obj;

                /** @value: CPU mapping of the UFO value. */
                u32 *value;
        } timeline_ufo;

        /**
         * @last_queued_job_scheduled_fence: The scheduled fence of the last
         * job queued to this queue.
         *
         * We use it to insert frag -> geom dependencies when issuing combined
         * geom+frag jobs, to guarantee that the fragment job that's part of
         * the combined operation comes after all fragment jobs that were queued
         * before it.
         */
        struct dma_fence *last_queued_job_scheduled_fence;

        /** @cccb: Client Circular Command Buffer. */
        struct pvr_cccb cccb;

        /** @reg_state_obj: FW object representing the register state of this queue. */
        struct pvr_fw_object *reg_state_obj;

        /** @ctx_offset: Offset of the queue context in the FW context object. */
        u32 ctx_offset;

        /** @callstack_addr: Initial call stack address for register state object. */
        u64 callstack_addr;
};

bool pvr_queue_fence_is_native(struct dma_fence *f);

int pvr_queue_job_init(struct pvr_job *job, u64 drm_client_id);

void pvr_queue_job_cleanup(struct pvr_job *job);

void pvr_queue_job_push(struct pvr_job *job);

struct dma_fence *pvr_queue_job_arm(struct pvr_job *job);

struct pvr_queue *pvr_queue_create(struct pvr_context *ctx,
                                   enum drm_pvr_job_type type,
                                   struct drm_pvr_ioctl_create_context_args *args,
                                   void *fw_ctx_map);

void pvr_queue_kill(struct pvr_queue *queue);

void pvr_queue_destroy(struct pvr_queue *queue, bool cleanup_queue_entity);

void pvr_queue_process(struct pvr_queue *queue);

void pvr_queue_device_pre_reset(struct pvr_device *pvr_dev);

void pvr_queue_device_post_reset(struct pvr_device *pvr_dev);

int pvr_queue_device_init(struct pvr_device *pvr_dev);

void pvr_queue_device_fini(struct pvr_device *pvr_dev);

#endif /* PVR_QUEUE_H */
Linux
