LXR linux/drivers/media/platform/vsp1/vsp1

   1/* SPDX-License-Identifier: GPL-2.0+ */
   2/*
   3 * vsp1_dl.h  --  R-Car VSP1 Display List
   4 *
   5 * Copyright (C) 2015 Renesas Corporation
   6 *
   7 * Contact: Laurent Pinchart (laurent.pinchart@ideasonboard.com)
   8 */
   9#ifndef __VSP1_DL_H__
  10#define __VSP1_DL_H__
  11
  12#include <linux/types.h>
  13
  14struct vsp1_device;
  15struct vsp1_dl_body;
  16struct vsp1_dl_body_pool;
  17struct vsp1_dl_list;
  18struct vsp1_dl_manager;
  19
  20/* Keep these flags in sync with VSP1_DU_STATUS_* in include/media/vsp1.h. */
  21#define VSP1_DL_FRAME_END_COMPLETED             BIT(0)
  22#define VSP1_DL_FRAME_END_WRITEBACK             BIT(1)
  23#define VSP1_DL_FRAME_END_INTERNAL              BIT(2)
  24
  25/**
  26 * struct vsp1_dl_ext_cmd - Extended Display command
  27 * @pool: pool to which this command belongs
  28 * @free: entry in the pool of free commands list
  29 * @opcode: command type opcode
  30 * @flags: flags used by the command
  31 * @cmds: array of command bodies for this extended cmd
  32 * @num_cmds: quantity of commands in @cmds array
  33 * @cmd_dma: DMA address of the command body
  34 * @data: memory allocation for command-specific data
  35 * @data_dma: DMA address for command-specific data
  36 */
  37struct vsp1_dl_ext_cmd {
  38        struct vsp1_dl_cmd_pool *pool;
  39        struct list_head free;
  40
  41        u8 opcode;
  42        u32 flags;
  43
  44        struct vsp1_pre_ext_dl_body *cmds;
  45        unsigned int num_cmds;
  46        dma_addr_t cmd_dma;
  47
  48        void *data;
  49        dma_addr_t data_dma;
  50};
  51
  52void vsp1_dlm_setup(struct vsp1_device *vsp1);
  53
  54struct vsp1_dl_manager *vsp1_dlm_create(struct vsp1_device *vsp1,
  55                                        unsigned int index,
  56                                        unsigned int prealloc);
  57void vsp1_dlm_destroy(struct vsp1_dl_manager *dlm);
  58void vsp1_dlm_reset(struct vsp1_dl_manager *dlm);
  59unsigned int vsp1_dlm_irq_frame_end(struct vsp1_dl_manager *dlm);
  60struct vsp1_dl_body *vsp1_dlm_dl_body_get(struct vsp1_dl_manager *dlm);
  61
  62struct vsp1_dl_list *vsp1_dl_list_get(struct vsp1_dl_manager *dlm);
  63void vsp1_dl_list_put(struct vsp1_dl_list *dl);
  64struct vsp1_dl_body *vsp1_dl_list_get_body0(struct vsp1_dl_list *dl);
  65struct vsp1_dl_ext_cmd *vsp1_dl_get_pre_cmd(struct vsp1_dl_list *dl);
  66void vsp1_dl_list_commit(struct vsp1_dl_list *dl, unsigned int dl_flags);
  67
  68struct vsp1_dl_body_pool *
  69vsp1_dl_body_pool_create(struct vsp1_device *vsp1, unsigned int num_bodies,
  70                         unsigned int num_entries, size_t extra_size);
  71void vsp1_dl_body_pool_destroy(struct vsp1_dl_body_pool *pool);
  72struct vsp1_dl_body *vsp1_dl_body_get(struct vsp1_dl_body_pool *pool);
  73void vsp1_dl_body_put(struct vsp1_dl_body *dlb);
  74
  75void vsp1_dl_body_write(struct vsp1_dl_body *dlb, u32 reg, u32 data);
  76int vsp1_dl_list_add_body(struct vsp1_dl_list *dl, struct vsp1_dl_body *dlb);
  77int vsp1_dl_list_add_chain(struct vsp1_dl_list *head, struct vsp1_dl_list *dl);
  78
  79#endif /* __VSP1_DL_H__ */
  80