1 /* SPDX-License-Identifier: GPL-2.0 */
2 /*
3  * i.MX8QXP/i.MX8QM JPEG encoder/decoder v4l2 driver
4  *
5  * Copyright 2018-2019 NXP
6  */
7 
8 #include <media/v4l2-ctrls.h>
9 #include <media/v4l2-device.h>
10 #include <media/v4l2-fh.h>
11 
12 #ifndef _MXC_JPEG_CORE_H
13 #define _MXC_JPEG_CORE_H
14 
15 #define MXC_JPEG_NAME			"mxc-jpeg"
16 #define MXC_JPEG_FMT_TYPE_ENC		0
17 #define MXC_JPEG_FMT_TYPE_RAW		1
18 #define MXC_JPEG_DEFAULT_WIDTH		1280
19 #define MXC_JPEG_DEFAULT_HEIGHT		720
20 #define MXC_JPEG_DEFAULT_PFMT		V4L2_PIX_FMT_BGR24
21 #define MXC_JPEG_MIN_WIDTH		64
22 #define MXC_JPEG_MIN_HEIGHT		64
23 #define MXC_JPEG_MAX_WIDTH		0x2000
24 #define MXC_JPEG_MAX_HEIGHT		0x2000
25 #define MXC_JPEG_MAX_CFG_STREAM		0x1000
26 #define MXC_JPEG_H_ALIGN		3
27 #define MXC_JPEG_W_ALIGN		3
28 #define MXC_JPEG_MAX_SIZEIMAGE		0xFFFFFC00
29 #define MXC_JPEG_MAX_PLANES		2
30 
31 enum mxc_jpeg_enc_state {
32 	MXC_JPEG_ENCODING	= 0, /* jpeg encode phase */
33 	MXC_JPEG_ENC_CONF	= 1, /* jpeg encoder config phase */
34 };
35 
36 enum mxc_jpeg_mode {
37 	MXC_JPEG_DECODE	= 0, /* jpeg decode mode */
38 	MXC_JPEG_ENCODE	= 1, /* jpeg encode mode */
39 };
40 
41 /**
42  * struct mxc_jpeg_fmt - driver's internal color format data
43  * @name:	format description
44  * @fourcc:	fourcc code, 0 if not applicable
45  * @subsampling: subsampling of jpeg components
46  * @nc:		number of color components
47  * @depth:	number of bits per pixel
48  * @mem_planes:	number of memory planes (1 for packed formats)
49  * @comp_planes:number of component planes, which includes the alpha plane (1 to 4).
50  * @h_align:	horizontal alignment order (align to 2^h_align)
51  * @v_align:	vertical alignment order (align to 2^v_align)
52  * @flags:	flags describing format applicability
53  * @precision:  jpeg sample precision
54  * @is_rgb:     is an RGB pixel format
55  */
56 struct mxc_jpeg_fmt {
57 	const char				*name;
58 	u32					fourcc;
59 	enum v4l2_jpeg_chroma_subsampling	subsampling;
60 	int					nc;
61 	int					depth;
62 	int					mem_planes;
63 	int					comp_planes;
64 	int					h_align;
65 	int					v_align;
66 	u32					flags;
67 	u8					precision;
68 	u8					is_rgb;
69 };
70 
71 struct mxc_jpeg_desc {
72 	u32 next_descpt_ptr;
73 	u32 buf_base0;
74 	u32 buf_base1;
75 	u32 line_pitch;
76 	u32 stm_bufbase;
77 	u32 stm_bufsize;
78 	u32 imgsize;
79 	u32 stm_ctrl;
80 } __packed;
81 
82 struct mxc_jpeg_q_data {
83 	const struct mxc_jpeg_fmt	*fmt;
84 	u32				sizeimage[MXC_JPEG_MAX_PLANES];
85 	u32				bytesperline[MXC_JPEG_MAX_PLANES];
86 	int				w;
87 	int				w_adjusted;
88 	int				h;
89 	int				h_adjusted;
90 	unsigned int			sequence;
91 	struct v4l2_rect		crop;
92 };
93 
94 struct mxc_jpeg_ctx {
95 	struct mxc_jpeg_dev		*mxc_jpeg;
96 	struct mxc_jpeg_q_data		out_q;
97 	struct mxc_jpeg_q_data		cap_q;
98 	struct v4l2_fh			fh;
99 	enum mxc_jpeg_enc_state		enc_state;
100 	unsigned int			slot;
101 	unsigned int			source_change;
102 	bool				header_parsed;
103 	struct v4l2_ctrl_handler	ctrl_handler;
104 	u8				jpeg_quality;
105 	struct delayed_work		task_timer;
106 };
107 
108 struct mxc_jpeg_slot_data {
109 	bool used;
110 	struct mxc_jpeg_desc *desc; // enc/dec descriptor
111 	struct mxc_jpeg_desc *cfg_desc; // configuration descriptor
112 	void *cfg_stream_vaddr; // configuration bitstream virtual address
113 	unsigned int cfg_stream_size;
114 	dma_addr_t desc_handle;
115 	dma_addr_t cfg_desc_handle; // configuration descriptor dma address
116 	dma_addr_t cfg_stream_handle; // configuration bitstream dma address
117 };
118 
119 struct mxc_jpeg_dev {
120 	spinlock_t			hw_lock; /* hardware access lock */
121 	unsigned int			mode;
122 	struct mutex			lock; /* v4l2 ioctls serialization */
123 	struct clk_bulk_data		*clks;
124 	int				num_clks;
125 	struct platform_device		*pdev;
126 	struct device			*dev;
127 	void __iomem			*base_reg;
128 	struct v4l2_device		v4l2_dev;
129 	struct v4l2_m2m_dev		*m2m_dev;
130 	struct video_device		*dec_vdev;
131 	struct mxc_jpeg_slot_data	slot_data[MXC_MAX_SLOTS];
132 	int				num_domains;
133 	struct device			**pd_dev;
134 	struct device_link		**pd_link;
135 };
136 
137 /**
138  * struct mxc_jpeg_sof_comp - JPEG Start Of Frame component fields
139  * @id:				component id
140  * @v:				vertical sampling
141  * @h:				horizontal sampling
142  * @quantization_table_no:	id of quantization table
143  */
144 struct mxc_jpeg_sof_comp {
145 	u8 id;
146 	u8 v :4;
147 	u8 h :4;
148 	u8 quantization_table_no;
149 } __packed;
150 
151 #define MXC_JPEG_MAX_COMPONENTS 4
152 /**
153  * struct mxc_jpeg_sof - JPEG Start Of Frame marker fields
154  * @length:		Start of Frame length
155  * @precision:		precision (bits per pixel per color component)
156  * @height:		image height
157  * @width:		image width
158  * @components_no:	number of color components
159  * @comp:		component fields for each color component
160  */
161 struct mxc_jpeg_sof {
162 	u16 length;
163 	u8 precision;
164 	u16 height, width;
165 	u8 components_no;
166 	struct mxc_jpeg_sof_comp comp[MXC_JPEG_MAX_COMPONENTS];
167 } __packed;
168 
169 /**
170  * struct mxc_jpeg_sos_comp - JPEG Start Of Scan component fields
171  * @id:			component id
172  * @huffman_table_no:	id of the Huffman table
173  */
174 struct mxc_jpeg_sos_comp {
175 	u8 id; /*component id*/
176 	u8 huffman_table_no;
177 } __packed;
178 
179 /**
180  * struct mxc_jpeg_sos - JPEG Start Of Scan marker fields
181  * @length:		Start of Frame length
182  * @components_no:	number of color components
183  * @comp:		SOS component fields for each color component
184  * @ignorable_bytes:	ignorable bytes
185  */
186 struct mxc_jpeg_sos {
187 	u16 length;
188 	u8 components_no;
189 	struct mxc_jpeg_sos_comp comp[MXC_JPEG_MAX_COMPONENTS];
190 	u8 ignorable_bytes[3];
191 } __packed;
192 
193 #endif
194