1 /* linux/drivers/media/video/s5p-jpeg/jpeg-core.h 2 * 3 * Copyright (c) 2011 Samsung Electronics Co., Ltd. 4 * http://www.samsung.com 5 * 6 * Author: Andrzej Pietrasiewicz <andrzej.p@samsung.com> 7 * 8 * This program is free software; you can redistribute it and/or modify 9 * it under the terms of the GNU General Public License version 2 as 10 * published by the Free Software Foundation. 11 */ 12 13 #ifndef JPEG_CORE_H_ 14 #define JPEG_CORE_H_ 15 16 #include <media/v4l2-device.h> 17 #include <media/v4l2-fh.h> 18 #include <media/v4l2-ctrls.h> 19 20 #define S5P_JPEG_M2M_NAME "s5p-jpeg" 21 22 /* JPEG compression quality setting */ 23 #define S5P_JPEG_COMPR_QUAL_BEST 0 24 #define S5P_JPEG_COMPR_QUAL_WORST 3 25 26 /* JPEG RGB to YCbCr conversion matrix coefficients */ 27 #define S5P_JPEG_COEF11 0x4d 28 #define S5P_JPEG_COEF12 0x97 29 #define S5P_JPEG_COEF13 0x1e 30 #define S5P_JPEG_COEF21 0x2c 31 #define S5P_JPEG_COEF22 0x57 32 #define S5P_JPEG_COEF23 0x83 33 #define S5P_JPEG_COEF31 0x83 34 #define S5P_JPEG_COEF32 0x6e 35 #define S5P_JPEG_COEF33 0x13 36 37 /* a selection of JPEG markers */ 38 #define TEM 0x01 39 #define SOF0 0xc0 40 #define RST 0xd0 41 #define SOI 0xd8 42 #define EOI 0xd9 43 #define DHP 0xde 44 45 /* Flags that indicate a format can be used for capture/output */ 46 #define MEM2MEM_CAPTURE (1 << 0) 47 #define MEM2MEM_OUTPUT (1 << 1) 48 49 /** 50 * struct s5p_jpeg - JPEG IP abstraction 51 * @lock: the mutex protecting this structure 52 * @slock: spinlock protecting the device contexts 53 * @v4l2_dev: v4l2 device for mem2mem mode 54 * @vfd_encoder: video device node for encoder mem2mem mode 55 * @vfd_decoder: video device node for decoder mem2mem mode 56 * @m2m_dev: v4l2 mem2mem device data 57 * @ioarea: JPEG IP memory region 58 * @regs: JPEG IP registers mapping 59 * @irq: JPEG IP irq 60 * @clk: JPEG IP clock 61 * @dev: JPEG IP struct device 62 * @alloc_ctx: videobuf2 memory allocator's context 63 */ 64 struct s5p_jpeg { 65 struct mutex lock; 66 struct spinlock slock; 67 68 struct v4l2_device v4l2_dev; 69 struct video_device *vfd_encoder; 70 struct video_device *vfd_decoder; 71 struct v4l2_m2m_dev *m2m_dev; 72 73 struct resource *ioarea; 74 void __iomem *regs; 75 unsigned int irq; 76 struct clk *clk; 77 struct device *dev; 78 void *alloc_ctx; 79 }; 80 81 /** 82 * struct jpeg_fmt - driver's internal color format data 83 * @name: format descritpion 84 * @fourcc: the fourcc code, 0 if not applicable 85 * @depth: number of bits per pixel 86 * @colplanes: number of color planes (1 for packed formats) 87 * @h_align: horizontal alignment order (align to 2^h_align) 88 * @v_align: vertical alignment order (align to 2^v_align) 89 * @types: types of queue this format is applicable to 90 */ 91 struct s5p_jpeg_fmt { 92 char *name; 93 u32 fourcc; 94 int depth; 95 int colplanes; 96 int h_align; 97 int v_align; 98 u32 types; 99 }; 100 101 /** 102 * s5p_jpeg_q_data - parameters of one queue 103 * @fmt: driver-specific format of this queue 104 * @w: image width 105 * @h: image height 106 * @size: image buffer size in bytes 107 */ 108 struct s5p_jpeg_q_data { 109 struct s5p_jpeg_fmt *fmt; 110 u32 w; 111 u32 h; 112 u32 size; 113 }; 114 115 /** 116 * s5p_jpeg_ctx - the device context data 117 * @jpeg: JPEG IP device for this context 118 * @mode: compression (encode) operation or decompression (decode) 119 * @compr_quality: destination image quality in compression (encode) mode 120 * @m2m_ctx: mem2mem device context 121 * @out_q: source (output) queue information 122 * @cap_fmt: destination (capture) queue queue information 123 * @hdr_parsed: set if header has been parsed during decompression 124 * @ctrl_handler: controls handler 125 */ 126 struct s5p_jpeg_ctx { 127 struct s5p_jpeg *jpeg; 128 unsigned int mode; 129 unsigned short compr_quality; 130 unsigned short restart_interval; 131 unsigned short subsampling; 132 struct v4l2_m2m_ctx *m2m_ctx; 133 struct s5p_jpeg_q_data out_q; 134 struct s5p_jpeg_q_data cap_q; 135 struct v4l2_fh fh; 136 bool hdr_parsed; 137 struct v4l2_ctrl_handler ctrl_handler; 138 }; 139 140 /** 141 * s5p_jpeg_buffer - description of memory containing input JPEG data 142 * @size: buffer size 143 * @curr: current position in the buffer 144 * @data: pointer to the data 145 */ 146 struct s5p_jpeg_buffer { 147 unsigned long size; 148 unsigned long curr; 149 unsigned long data; 150 }; 151 152 #endif /* JPEG_CORE_H */ 153