1 /* SPDX-License-Identifier: GPL-2.0 */
2 /*
3  * Copyright (c) 2016 MediaTek Inc.
4  * Author: PC Chen <pc.chen@mediatek.com>
5  *         Tiffany Lin <tiffany.lin@mediatek.com>
6  */
7 
8 #ifndef _MTK_VCODEC_DEC_H_
9 #define _MTK_VCODEC_DEC_H_
10 
11 #include <media/videobuf2-core.h>
12 #include <media/v4l2-mem2mem.h>
13 
14 #define VCODEC_DEC_ALIGNED_64 64
15 #define VCODEC_CAPABILITY_4K_DISABLED	0x10
16 #define VCODEC_DEC_4K_CODED_WIDTH	4096U
17 #define VCODEC_DEC_4K_CODED_HEIGHT	2304U
18 #define MTK_VDEC_MAX_W	2048U
19 #define MTK_VDEC_MAX_H	1088U
20 #define MTK_VDEC_MIN_W	64U
21 #define MTK_VDEC_MIN_H	64U
22 
23 #define MTK_VDEC_IRQ_STATUS_DEC_SUCCESS        0x10000
24 
25 /**
26  * struct vdec_fb  - decoder frame buffer
27  * @base_y	: Y plane memory info
28  * @base_c	: C plane memory info
29  * @status      : frame buffer status (vdec_fb_status)
30  */
31 struct vdec_fb {
32 	struct mtk_vcodec_mem	base_y;
33 	struct mtk_vcodec_mem	base_c;
34 	unsigned int	status;
35 };
36 
37 /**
38  * struct mtk_video_dec_buf - Private data related to each VB2 buffer.
39  * @m2m_buf:	M2M buffer
40  * @list:	link list
41  * @used:	Capture buffer contain decoded frame data and keep in
42  *			codec data structure
43  * @queued_in_vb2:	Capture buffer is queue in vb2
44  * @queued_in_v4l2:	Capture buffer is in v4l2 driver, but not in vb2
45  *			queue yet
46  * @error:		An unrecoverable error occurs on this buffer.
47  * @frame_buffer:	Decode status, and buffer information of Capture buffer
48  * @bs_buffer:	Output buffer info
49  *
50  * Note : These status information help us track and debug buffer state
51  */
52 struct mtk_video_dec_buf {
53 	struct v4l2_m2m_buffer	m2m_buf;
54 
55 	bool	used;
56 	bool	queued_in_vb2;
57 	bool	queued_in_v4l2;
58 	bool	error;
59 
60 	union {
61 		struct vdec_fb	frame_buffer;
62 		struct mtk_vcodec_mem	bs_buffer;
63 	};
64 };
65 
66 extern const struct v4l2_ioctl_ops mtk_vdec_ioctl_ops;
67 extern const struct v4l2_m2m_ops mtk_vdec_m2m_ops;
68 extern const struct media_device_ops mtk_vcodec_media_ops;
69 extern const struct mtk_vcodec_dec_pdata mtk_vdec_8173_pdata;
70 extern const struct mtk_vcodec_dec_pdata mtk_vdec_8183_pdata;
71 extern const struct mtk_vcodec_dec_pdata mtk_lat_sig_core_pdata;
72 extern const struct mtk_vcodec_dec_pdata mtk_vdec_single_core_pdata;
73 
74 
75 /*
76  * mtk_vdec_lock/mtk_vdec_unlock are for ctx instance to
77  * get/release lock before/after access decoder hw.
78  * mtk_vdec_lock get decoder hw lock and set curr_ctx
79  * to ctx instance that get lock
80  */
81 void mtk_vdec_unlock(struct mtk_vcodec_ctx *ctx);
82 void mtk_vdec_lock(struct mtk_vcodec_ctx *ctx);
83 int mtk_vcodec_dec_queue_init(void *priv, struct vb2_queue *src_vq,
84 			   struct vb2_queue *dst_vq);
85 void mtk_vcodec_dec_set_default_params(struct mtk_vcodec_ctx *ctx);
86 void mtk_vcodec_dec_release(struct mtk_vcodec_ctx *ctx);
87 
88 /*
89  * VB2 ops
90  */
91 int vb2ops_vdec_queue_setup(struct vb2_queue *vq, unsigned int *nbuffers,
92 			    unsigned int *nplanes, unsigned int sizes[],
93 			    struct device *alloc_devs[]);
94 int vb2ops_vdec_buf_prepare(struct vb2_buffer *vb);
95 void vb2ops_vdec_buf_finish(struct vb2_buffer *vb);
96 int vb2ops_vdec_buf_init(struct vb2_buffer *vb);
97 int vb2ops_vdec_start_streaming(struct vb2_queue *q, unsigned int count);
98 void vb2ops_vdec_stop_streaming(struct vb2_queue *q);
99 
100 
101 #endif /* _MTK_VCODEC_DEC_H_ */
102