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