1 /* SPDX-License-Identifier: GPL-2.0 */
3 * i.MX8QXP/i.MX8QM JPEG encoder/decoder v4l2 driver
5 * Copyright 2018-2019 NXP
8 #include <media/v4l2-ctrls.h>
9 #include <media/v4l2-device.h>
10 #include <media/v4l2-fh.h>
12 #ifndef _MXC_JPEG_CORE_H
13 #define _MXC_JPEG_CORE_H
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
31 enum mxc_jpeg_enc_state {
32 MXC_JPEG_ENCODING = 0, /* jpeg encode phase */
33 MXC_JPEG_ENC_CONF = 1, /* jpeg encoder config phase */
37 MXC_JPEG_DECODE = 0, /* jpeg decode mode */
38 MXC_JPEG_ENCODE = 1, /* jpeg encode mode */
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 * @colplanes: number of color planes (1 for packed formats)
49 * @h_align: horizontal alignment order (align to 2^h_align)
50 * @v_align: vertical alignment order (align to 2^v_align)
51 * @flags: flags describing format applicability
52 * @precision: jpeg sample precision
57 enum v4l2_jpeg_chroma_subsampling subsampling;
67 struct mxc_jpeg_desc {
78 struct mxc_jpeg_q_data {
79 const struct mxc_jpeg_fmt *fmt;
80 u32 sizeimage[MXC_JPEG_MAX_PLANES];
81 u32 bytesperline[MXC_JPEG_MAX_PLANES];
86 unsigned int sequence;
90 struct mxc_jpeg_dev *mxc_jpeg;
91 struct mxc_jpeg_q_data out_q;
92 struct mxc_jpeg_q_data cap_q;
94 enum mxc_jpeg_enc_state enc_state;
96 unsigned int source_change;
98 struct v4l2_ctrl_handler ctrl_handler;
102 struct mxc_jpeg_slot_data {
104 struct mxc_jpeg_desc *desc; // enc/dec descriptor
105 struct mxc_jpeg_desc *cfg_desc; // configuration descriptor
106 void *cfg_stream_vaddr; // configuration bitstream virtual address
107 unsigned int cfg_stream_size;
108 dma_addr_t desc_handle;
109 dma_addr_t cfg_desc_handle; // configuration descriptor dma address
110 dma_addr_t cfg_stream_handle; // configuration bitstream dma address
113 struct mxc_jpeg_dev {
114 spinlock_t hw_lock; /* hardware access lock */
116 struct mutex lock; /* v4l2 ioctls serialization */
119 struct platform_device *pdev;
121 void __iomem *base_reg;
122 struct v4l2_device v4l2_dev;
123 struct v4l2_m2m_dev *m2m_dev;
124 struct video_device *dec_vdev;
125 struct mxc_jpeg_slot_data slot_data[MXC_MAX_SLOTS];
127 struct device **pd_dev;
128 struct device_link **pd_link;
132 * struct mxc_jpeg_sof_comp - JPEG Start Of Frame component fields
134 * @v: vertical sampling
135 * @h: horizontal sampling
136 * @quantization_table_no: id of quantization table
138 struct mxc_jpeg_sof_comp {
142 u8 quantization_table_no;
145 #define MXC_JPEG_MAX_COMPONENTS 4
147 * struct mxc_jpeg_sof - JPEG Start Of Frame marker fields
148 * @length: Start of Frame length
149 * @precision: precision (bits per pixel per color component)
150 * @height: image height
151 * @width: image width
152 * @components_no: number of color components
153 * @comp: component fields for each color component
155 struct mxc_jpeg_sof {
160 struct mxc_jpeg_sof_comp comp[MXC_JPEG_MAX_COMPONENTS];
164 * struct mxc_jpeg_sos_comp - JPEG Start Of Scan component fields
166 * @huffman_table_no: id of the Huffman table
168 struct mxc_jpeg_sos_comp {
169 u8 id; /*component id*/
174 * struct mxc_jpeg_sos - JPEG Start Of Scan marker fields
175 * @length: Start of Frame length
176 * @components_no: number of color components
177 * @comp: SOS component fields for each color component
178 * @ignorable_bytes: ignorable bytes
180 struct mxc_jpeg_sos {
183 struct mxc_jpeg_sos_comp comp[MXC_JPEG_MAX_COMPONENTS];
184 u8 ignorable_bytes[3];