/*
 * Copyright (C) 2019 Alyssa Rosenzweig
 * Copyright (C) 2014-2017 Broadcom
 *
 * Permission is hereby granted, free of charge, to any person obtaining a
 * copy of this software and associated documentation files (the "Software"),
 * to deal in the Software without restriction, including without limitation
 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
 * and/or sell copies of the Software, and to permit persons to whom the
 * Software is furnished to do so, subject to the following conditions:
 *
 * The above copyright notice and this permission notice (including the next
 * paragraph) shall be included in all copies or substantial portions of the
 * Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 * SOFTWARE.
 *
 */

#ifndef __PAN_JOB_H__
#define __PAN_JOB_H__

#include "pipe/p_state.h"
#include "util/u_dynarray.h"
#include "pan_cs.h"
#include "pan_mempool.h"
#include "pan_resource.h"
#include "pan_scoreboard.h"

/* Simple tri-state data structure. In the default "don't care" state, the value
 * may be set to true or false. However, once the value is set, it must not be
 * changed. Declared inside of a struct to prevent casting to bool, which is an
 * error. The getter needs to be used instead.
 */
struct pan_tristate {
   enum {
      PAN_TRISTATE_DONTCARE,
      PAN_TRISTATE_FALSE,
      PAN_TRISTATE_TRUE,
   } v;
};

/*
 * Try to set a tristate value to a desired boolean value. Returns whether the
 * operation is successful.
 */
static bool
pan_tristate_set(struct pan_tristate *state, bool value)
{
   switch (state->v) {
   case PAN_TRISTATE_DONTCARE:
      state->v = value ? PAN_TRISTATE_TRUE : PAN_TRISTATE_FALSE;
      return true;

   case PAN_TRISTATE_FALSE:
      return (value == false);

   case PAN_TRISTATE_TRUE:
      return (value == true);

   default:
      unreachable("Invalid tristate value");
   }
}

/*
 * Read the boolean value of a tristate. Return value undefined in the don't
 * care state.
 */
static bool
pan_tristate_get(struct pan_tristate state)
{
   return (state.v == PAN_TRISTATE_TRUE);
}

/* A panfrost_batch corresponds to a bound FBO we're rendering to,
 * collecting over multiple draws. */

struct panfrost_batch {
   struct panfrost_context *ctx;
   struct pipe_framebuffer_state key;

   /* Sequence number used to implement LRU eviction when all batch slots are
    * used */
   uint64_t seqnum;

   /* Buffers cleared (PIPE_CLEAR_* bitmask) */
   unsigned clear;

   /* Buffers drawn */
   unsigned draws;

   /* Buffers read */
   unsigned read;

   /* Buffers needing resolve to memory */
   unsigned resolve;

   /* Packed clear values, indexed by both render target as well as word.
    * Essentially, a single pixel is packed, with some padding to bring it
    * up to a 32-bit interval; that pixel is then duplicated over to fill
    * all 16-bytes */

   uint32_t clear_color[PIPE_MAX_COLOR_BUFS][4];
   float clear_depth;
   unsigned clear_stencil;

   /* Amount of thread local storage required per thread */
   unsigned stack_size;

   /* Amount of shared memory needed per workgroup (for compute) */
   unsigned shared_size;

   /* The bounding box covered by this job, taking scissors into account.
    * Basically, the bounding box we have to run fragment shaders for */

   unsigned minx, miny;
   unsigned maxx, maxy;

   /* Acts as a rasterizer discard */
   bool scissor_culls_everything;

   /* BOs referenced not in the pool */
   unsigned num_bos;
   struct util_dynarray bos;

   /* Pool owned by this batch (released when the batch is released) used for
    * temporary descriptors */
   struct panfrost_pool pool;

   /* Pool also owned by this batch that is not CPU mapped (created as
    * INVISIBLE) used for private GPU-internal structures, particularly
    * varyings */
   struct panfrost_pool invisible_pool;

   /* Job scoreboarding state */
   struct pan_scoreboard scoreboard;

   /* Polygon list bound to the batch, or NULL if none bound yet */
   struct panfrost_bo *polygon_list;

   /* Scratchpad BO bound to the batch, or NULL if none bound yet */
   struct panfrost_bo *scratchpad;

   /* Shared memory BO bound to the batch, or NULL if none bound yet */
   struct panfrost_bo *shared_memory;

   /* Framebuffer descriptor. */
   struct panfrost_ptr framebuffer;

   /* Thread local storage descriptor. */
   struct panfrost_ptr tls;

   /* Tiler context */
   struct pan_tiler_context tiler_ctx;

   /* Keep the num_work_groups sysval around for indirect dispatch */
   mali_ptr num_wg_sysval[3];

   /* Cached descriptors */
   mali_ptr viewport;
   mali_ptr rsd[PIPE_SHADER_TYPES];
   mali_ptr textures[PIPE_SHADER_TYPES];
   mali_ptr samplers[PIPE_SHADER_TYPES];
   mali_ptr attribs[PIPE_SHADER_TYPES];
   mali_ptr attrib_bufs[PIPE_SHADER_TYPES];
   mali_ptr uniform_buffers[PIPE_SHADER_TYPES];
   mali_ptr push_uniforms[PIPE_SHADER_TYPES];
   mali_ptr depth_stencil;
   mali_ptr blend;

   unsigned nr_push_uniforms[PIPE_SHADER_TYPES];
   unsigned nr_uniform_buffers[PIPE_SHADER_TYPES];

   /* Valhall: struct mali_scissor_packed */
   unsigned scissor[2];
   float minimum_z, maximum_z;

   /* Used on Valhall only. Midgard includes attributes in-band with
    * attributes, wildly enough.
    */
   mali_ptr images[PIPE_SHADER_TYPES];

   /* On Valhall, these are properties of the batch. On Bifrost, they are
    * per draw.
    */
   struct pan_tristate sprite_coord_origin;
   struct pan_tristate first_provoking_vertex;
};

/* Functions for managing the above */

struct panfrost_batch *panfrost_get_batch_for_fbo(struct panfrost_context *ctx);

struct panfrost_batch *
panfrost_get_fresh_batch_for_fbo(struct panfrost_context *ctx,
                                 const char *reason);

void panfrost_batch_add_bo(struct panfrost_batch *batch, struct panfrost_bo *bo,
                           enum pipe_shader_type stage);

void panfrost_batch_read_rsrc(struct panfrost_batch *batch,
                              struct panfrost_resource *rsrc,
                              enum pipe_shader_type stage);

void panfrost_batch_write_rsrc(struct panfrost_batch *batch,
                               struct panfrost_resource *rsrc,
                               enum pipe_shader_type stage);

bool panfrost_any_batch_reads_rsrc(struct panfrost_context *ctx,
                                   struct panfrost_resource *rsrc);

bool panfrost_any_batch_writes_rsrc(struct panfrost_context *ctx,
                                    struct panfrost_resource *rsrc);

struct panfrost_bo *panfrost_batch_create_bo(struct panfrost_batch *batch,
                                             size_t size, uint32_t create_flags,
                                             enum pipe_shader_type stage,
                                             const char *label);

void panfrost_flush_all_batches(struct panfrost_context *ctx,
                                const char *reason);

void panfrost_flush_batches_accessing_rsrc(struct panfrost_context *ctx,
                                           struct panfrost_resource *rsrc,
                                           const char *reason);

void panfrost_flush_writer(struct panfrost_context *ctx,
                           struct panfrost_resource *rsrc, const char *reason);

void panfrost_batch_adjust_stack_size(struct panfrost_batch *batch);

struct panfrost_bo *panfrost_batch_get_scratchpad(struct panfrost_batch *batch,
                                                  unsigned size,
                                                  unsigned thread_tls_alloc,
                                                  unsigned core_id_range);

struct panfrost_bo *
panfrost_batch_get_shared_memory(struct panfrost_batch *batch, unsigned size,
                                 unsigned workgroup_count);

void panfrost_batch_clear(struct panfrost_batch *batch, unsigned buffers,
                          const union pipe_color_union *color, double depth,
                          unsigned stencil);

void panfrost_batch_union_scissor(struct panfrost_batch *batch, unsigned minx,
                                  unsigned miny, unsigned maxx, unsigned maxy);

bool panfrost_batch_skip_rasterization(struct panfrost_batch *batch);

#endif
