1 /* SPDX-License-Identifier: GPL-2.0 */
2 /*
3  * Rockchip Video Decoder driver
4  *
5  * Copyright (C) 2019 Collabora, Ltd.
6  *
7  * Based on rkvdec driver by Google LLC. (Tomasz Figa <tfiga@chromium.org>)
8  * Based on s5p-mfc driver by Samsung Electronics Co., Ltd.
9  * Copyright (C) 2011 Samsung Electronics Co., Ltd.
10  */
11 #ifndef RKVDEC_H_
12 #define RKVDEC_H_
13 
14 #include <linux/platform_device.h>
15 #include <linux/videodev2.h>
16 #include <linux/wait.h>
17 #include <linux/clk.h>
18 
19 #include <media/v4l2-ctrls.h>
20 #include <media/v4l2-device.h>
21 #include <media/v4l2-ioctl.h>
22 #include <media/videobuf2-core.h>
23 #include <media/videobuf2-dma-contig.h>
24 
25 struct rkvdec_ctx;
26 
27 struct rkvdec_ctrl_desc {
28 	u32 mandatory : 1;
29 	struct v4l2_ctrl_config cfg;
30 };
31 
32 struct rkvdec_ctrls {
33 	const struct rkvdec_ctrl_desc *ctrls;
34 	unsigned int num_ctrls;
35 };
36 
37 struct rkvdec_run {
38 	struct {
39 		struct vb2_v4l2_buffer *src;
40 		struct vb2_v4l2_buffer *dst;
41 	} bufs;
42 };
43 
44 struct rkvdec_vp9_decoded_buffer_info {
45 	/* Info needed when the decoded frame serves as a reference frame. */
46 	u16 width;
47 	u16 height;
48 	u32 bit_depth : 4;
49 };
50 
51 struct rkvdec_decoded_buffer {
52 	/* Must be the first field in this struct. */
53 	struct v4l2_m2m_buffer base;
54 };
55 
56 static inline struct rkvdec_decoded_buffer *
57 vb2_to_rkvdec_decoded_buf(struct vb2_buffer *buf)
58 {
59 	return container_of(buf, struct rkvdec_decoded_buffer,
60 			    base.vb.vb2_buf);
61 }
62 
63 struct rkvdec_coded_fmt_ops {
64 	int (*adjust_fmt)(struct rkvdec_ctx *ctx,
65 			  struct v4l2_format *f);
66 	int (*start)(struct rkvdec_ctx *ctx);
67 	void (*stop)(struct rkvdec_ctx *ctx);
68 	int (*run)(struct rkvdec_ctx *ctx);
69 	void (*done)(struct rkvdec_ctx *ctx, struct vb2_v4l2_buffer *src_buf,
70 		     struct vb2_v4l2_buffer *dst_buf,
71 		     enum vb2_buffer_state result);
72 };
73 
74 struct rkvdec_coded_fmt_desc {
75 	u32 fourcc;
76 	struct v4l2_frmsize_stepwise frmsize;
77 	const struct rkvdec_ctrls *ctrls;
78 	const struct rkvdec_coded_fmt_ops *ops;
79 	unsigned int num_decoded_fmts;
80 	const u32 *decoded_fmts;
81 };
82 
83 struct rkvdec_dev {
84 	struct v4l2_device v4l2_dev;
85 	struct media_device mdev;
86 	struct video_device vdev;
87 	struct v4l2_m2m_dev *m2m_dev;
88 	struct device *dev;
89 	struct clk_bulk_data *clocks;
90 	void __iomem *regs;
91 	struct mutex vdev_lock; /* serializes ioctls */
92 	struct delayed_work watchdog_work;
93 };
94 
95 struct rkvdec_ctx {
96 	struct v4l2_fh fh;
97 	struct v4l2_format coded_fmt;
98 	struct v4l2_format decoded_fmt;
99 	const struct rkvdec_coded_fmt_desc *coded_fmt_desc;
100 	struct v4l2_ctrl_handler ctrl_hdl;
101 	struct rkvdec_dev *dev;
102 	void *priv;
103 };
104 
105 static inline struct rkvdec_ctx *fh_to_rkvdec_ctx(struct v4l2_fh *fh)
106 {
107 	return container_of(fh, struct rkvdec_ctx, fh);
108 }
109 
110 struct rkvdec_aux_buf {
111 	void *cpu;
112 	dma_addr_t dma;
113 	size_t size;
114 };
115 
116 void rkvdec_run_preamble(struct rkvdec_ctx *ctx, struct rkvdec_run *run);
117 void rkvdec_run_postamble(struct rkvdec_ctx *ctx, struct rkvdec_run *run);
118 
119 extern const struct rkvdec_coded_fmt_ops rkvdec_h264_fmt_ops;
120 #endif /* RKVDEC_H_ */
121