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 
14 struct vsp1_device;
15 struct vsp1_dl_body;
16 struct vsp1_dl_body_pool;
17 struct vsp1_dl_list;
18 struct vsp1_dl_manager;
19 
20 #define VSP1_DL_FRAME_END_COMPLETED		BIT(0)
21 #define VSP1_DL_FRAME_END_INTERNAL		BIT(1)
22 
23 /**
24  * struct vsp1_dl_ext_cmd - Extended Display command
25  * @pool: pool to which this command belongs
26  * @free: entry in the pool of free commands list
27  * @opcode: command type opcode
28  * @flags: flags used by the command
29  * @cmds: array of command bodies for this extended cmd
30  * @num_cmds: quantity of commands in @cmds array
31  * @cmd_dma: DMA address of the command body
32  * @data: memory allocation for command-specific data
33  * @data_dma: DMA address for command-specific data
34  */
35 struct vsp1_dl_ext_cmd {
36 	struct vsp1_dl_cmd_pool *pool;
37 	struct list_head free;
38 
39 	u8 opcode;
40 	u32 flags;
41 
42 	struct vsp1_pre_ext_dl_body *cmds;
43 	unsigned int num_cmds;
44 	dma_addr_t cmd_dma;
45 
46 	void *data;
47 	dma_addr_t data_dma;
48 };
49 
50 void vsp1_dlm_setup(struct vsp1_device *vsp1);
51 
52 struct vsp1_dl_manager *vsp1_dlm_create(struct vsp1_device *vsp1,
53 					unsigned int index,
54 					unsigned int prealloc);
55 void vsp1_dlm_destroy(struct vsp1_dl_manager *dlm);
56 void vsp1_dlm_reset(struct vsp1_dl_manager *dlm);
57 unsigned int vsp1_dlm_irq_frame_end(struct vsp1_dl_manager *dlm);
58 struct vsp1_dl_body *vsp1_dlm_dl_body_get(struct vsp1_dl_manager *dlm);
59 
60 struct vsp1_dl_list *vsp1_dl_list_get(struct vsp1_dl_manager *dlm);
61 void vsp1_dl_list_put(struct vsp1_dl_list *dl);
62 struct vsp1_dl_body *vsp1_dl_list_get_body0(struct vsp1_dl_list *dl);
63 struct vsp1_dl_ext_cmd *vsp1_dl_get_pre_cmd(struct vsp1_dl_list *dl);
64 void vsp1_dl_list_commit(struct vsp1_dl_list *dl, bool internal);
65 
66 struct vsp1_dl_body_pool *
67 vsp1_dl_body_pool_create(struct vsp1_device *vsp1, unsigned int num_bodies,
68 			 unsigned int num_entries, size_t extra_size);
69 void vsp1_dl_body_pool_destroy(struct vsp1_dl_body_pool *pool);
70 struct vsp1_dl_body *vsp1_dl_body_get(struct vsp1_dl_body_pool *pool);
71 void vsp1_dl_body_put(struct vsp1_dl_body *dlb);
72 
73 void vsp1_dl_body_write(struct vsp1_dl_body *dlb, u32 reg, u32 data);
74 int vsp1_dl_list_add_body(struct vsp1_dl_list *dl, struct vsp1_dl_body *dlb);
75 int vsp1_dl_list_add_chain(struct vsp1_dl_list *head, struct vsp1_dl_list *dl);
76 
77 #endif /* __VSP1_DL_H__ */
78