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_ */