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 *clk_ipg; 124 struct clk *clk_per; 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