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