drivers/media/platform/s5p-jpeg/jpeg-core.h

   1 /* linux/drivers/media/platform/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 <linux/interrupt.h>
  17 #include <media/v4l2-device.h>
  18 #include <media/v4l2-fh.h>
  19 #include <media/v4l2-ctrls.h>
  20
  21 #define S5P_JPEG_M2M_NAME               "s5p-jpeg"
  22
  23 #define JPEG_MAX_CLOCKS                 4
  24
  25 /* JPEG compression quality setting */
  26 #define S5P_JPEG_COMPR_QUAL_BEST        0
  27 #define S5P_JPEG_COMPR_QUAL_WORST       3
  28
  29 /* JPEG RGB to YCbCr conversion matrix coefficients */
  30 #define S5P_JPEG_COEF11                 0x4d
  31 #define S5P_JPEG_COEF12                 0x97
  32 #define S5P_JPEG_COEF13                 0x1e
  33 #define S5P_JPEG_COEF21                 0x2c
  34 #define S5P_JPEG_COEF22                 0x57
  35 #define S5P_JPEG_COEF23                 0x83
  36 #define S5P_JPEG_COEF31                 0x83
  37 #define S5P_JPEG_COEF32                 0x6e
  38 #define S5P_JPEG_COEF33                 0x13
  39
  40 #define EXYNOS3250_IRQ_TIMEOUT          0x10000000
  41
  42 /* a selection of JPEG markers */
  43 #define TEM                             0x01
  44 #define SOF0                            0xc0
  45 #define DHT                             0xc4
  46 #define RST                             0xd0
  47 #define SOI                             0xd8
  48 #define EOI                             0xd9
  49 #define SOS                             0xda
  50 #define DQT                             0xdb
  51 #define DHP                             0xde
  52
  53 /* Flags that indicate a format can be used for capture/output */
  54 #define SJPEG_FMT_FLAG_ENC_CAPTURE      (1 << 0)
  55 #define SJPEG_FMT_FLAG_ENC_OUTPUT       (1 << 1)
  56 #define SJPEG_FMT_FLAG_DEC_CAPTURE      (1 << 2)
  57 #define SJPEG_FMT_FLAG_DEC_OUTPUT       (1 << 3)
  58 #define SJPEG_FMT_FLAG_S5P              (1 << 4)
  59 #define SJPEG_FMT_FLAG_EXYNOS3250       (1 << 5)
  60 #define SJPEG_FMT_FLAG_EXYNOS4          (1 << 6)
  61 #define SJPEG_FMT_RGB                   (1 << 7)
  62 #define SJPEG_FMT_NON_RGB               (1 << 8)
  63
  64 #define S5P_JPEG_ENCODE         0
  65 #define S5P_JPEG_DECODE         1
  66
  67 #define FMT_TYPE_OUTPUT         0
  68 #define FMT_TYPE_CAPTURE        1
  69
  70 #define SJPEG_SUBSAMPLING_444   0x11
  71 #define SJPEG_SUBSAMPLING_422   0x21
  72 #define SJPEG_SUBSAMPLING_420   0x22
  73
  74 #define S5P_JPEG_MAX_MARKER     4
  75
  76 /* Version numbers */
  77 enum sjpeg_version {
  78         SJPEG_S5P,
  79         SJPEG_EXYNOS3250,
  80         SJPEG_EXYNOS4,
  81         SJPEG_EXYNOS5420,
  82         SJPEG_EXYNOS5433,
  83 };
  84
  85 enum exynos4_jpeg_result {
  86         OK_ENC_OR_DEC,
  87         ERR_PROT,
  88         ERR_DEC_INVALID_FORMAT,
  89         ERR_MULTI_SCAN,
  90         ERR_FRAME,
  91         ERR_UNKNOWN,
  92 };
  93
  94 enum  exynos4_jpeg_img_quality_level {
  95         QUALITY_LEVEL_1 = 0,    /* high */
  96         QUALITY_LEVEL_2,
  97         QUALITY_LEVEL_3,
  98         QUALITY_LEVEL_4,        /* low */
  99 };
 100
 101 enum s5p_jpeg_ctx_state {
 102         JPEGCTX_RUNNING = 0,
 103         JPEGCTX_RESOLUTION_CHANGE,
 104 };
 105
 106 /**
 107  * struct s5p_jpeg - JPEG IP abstraction
 108  * @lock:               the mutex protecting this structure
 109  * @slock:              spinlock protecting the device contexts
 110  * @v4l2_dev:           v4l2 device for mem2mem mode
 111  * @vfd_encoder:        video device node for encoder mem2mem mode
 112  * @vfd_decoder:        video device node for decoder mem2mem mode
 113  * @m2m_dev:            v4l2 mem2mem device data
 114  * @regs:               JPEG IP registers mapping
 115  * @irq:                JPEG IP irq
 116  * @clocks:             JPEG IP clock(s)
 117  * @dev:                JPEG IP struct device
 118  * @variant:            driver variant to be used
 119  * @irq_status          interrupt flags set during single encode/decode
 120                         operation
 121
 122  */
 123 struct s5p_jpeg {
 124         struct mutex            lock;
 125         spinlock_t              slock;
 126
 127         struct v4l2_device      v4l2_dev;
 128         struct video_device     *vfd_encoder;
 129         struct video_device     *vfd_decoder;
 130         struct v4l2_m2m_dev     *m2m_dev;
 131
 132         void __iomem            *regs;
 133         unsigned int            irq;
 134         enum exynos4_jpeg_result irq_ret;
 135         struct clk              *clocks[JPEG_MAX_CLOCKS];
 136         struct device           *dev;
 137         struct s5p_jpeg_variant *variant;
 138         u32                     irq_status;
 139 };
 140
 141 struct s5p_jpeg_variant {
 142         unsigned int            version;
 143         unsigned int            fmt_ver_flag;
 144         unsigned int            hw3250_compat:1;
 145         unsigned int            htbl_reinit:1;
 146         unsigned int            hw_ex4_compat:1;
 147         struct v4l2_m2m_ops     *m2m_ops;
 148         irqreturn_t             (*jpeg_irq)(int irq, void *priv);
 149         const char              *clk_names[JPEG_MAX_CLOCKS];
 150         int                     num_clocks;
 151 };
 152
 153 /**
 154  * struct jpeg_fmt - driver's internal color format data
 155  * @name:       format descritpion
 156  * @fourcc:     the fourcc code, 0 if not applicable
 157  * @depth:      number of bits per pixel
 158  * @colplanes:  number of color planes (1 for packed formats)
 159  * @h_align:    horizontal alignment order (align to 2^h_align)
 160  * @v_align:    vertical alignment order (align to 2^v_align)
 161  * @flags:      flags describing format applicability
 162  */
 163 struct s5p_jpeg_fmt {
 164         char    *name;
 165         u32     fourcc;
 166         int     depth;
 167         int     colplanes;
 168         int     memplanes;
 169         int     h_align;
 170         int     v_align;
 171         int     subsampling;
 172         u32     flags;
 173 };
 174
 175 /**
 176  * s5p_jpeg_marker - collection of markers from jpeg header
 177  * @marker:     markers' positions relative to the buffer beginning
 178  * @len:        markers' payload lengths (without length field)
 179  * @n:          number of markers in collection
 180  */
 181 struct s5p_jpeg_marker {
 182         u32     marker[S5P_JPEG_MAX_MARKER];
 183         u32     len[S5P_JPEG_MAX_MARKER];
 184         u32     n;
 185 };
 186
 187 /**
 188  * s5p_jpeg_q_data - parameters of one queue
 189  * @fmt:        driver-specific format of this queue
 190  * @w:          image width
 191  * @h:          image height
 192  * @sos:        SOS marker's position relative to the buffer beginning
 193  * @dht:        DHT markers' positions relative to the buffer beginning
 194  * @dqt:        DQT markers' positions relative to the buffer beginning
 195  * @sof:        SOF0 marker's postition relative to the buffer beginning
 196  * @sof_len:    SOF0 marker's payload length (without length field itself)
 197  * @components: number of image components
 198  * @size:       image buffer size in bytes
 199  */
 200 struct s5p_jpeg_q_data {
 201         struct s5p_jpeg_fmt     *fmt;
 202         u32                     w;
 203         u32                     h;
 204         u32                     sos;
 205         struct s5p_jpeg_marker  dht;
 206         struct s5p_jpeg_marker  dqt;
 207         u32                     sof;
 208         u32                     sof_len;
 209         u32                     components;
 210         u32                     size;
 211 };
 212
 213 /**
 214  * s5p_jpeg_ctx - the device context data
 215  * @jpeg:               JPEG IP device for this context
 216  * @mode:               compression (encode) operation or decompression (decode)
 217  * @compr_quality:      destination image quality in compression (encode) mode
 218  * @restart_interval:   JPEG restart interval for JPEG encoding
 219  * @subsampling:        subsampling of a raw format or a JPEG
 220  * @out_q:              source (output) queue information
 221  * @cap_q:              destination (capture) queue queue information
 222  * @scale_factor:       scale factor for JPEG decoding
 223  * @crop_rect:          a rectangle representing crop area of the output buffer
 224  * @fh:                 V4L2 file handle
 225  * @hdr_parsed:         set if header has been parsed during decompression
 226  * @crop_altered:       set if crop rectangle has been altered by the user space
 227  * @ctrl_handler:       controls handler
 228  * @state:              state of the context
 229  */
 230 struct s5p_jpeg_ctx {
 231         struct s5p_jpeg         *jpeg;
 232         unsigned int            mode;
 233         unsigned short          compr_quality;
 234         unsigned short          restart_interval;
 235         unsigned short          subsampling;
 236         struct s5p_jpeg_q_data  out_q;
 237         struct s5p_jpeg_q_data  cap_q;
 238         unsigned int            scale_factor;
 239         struct v4l2_rect        crop_rect;
 240         struct v4l2_fh          fh;
 241         bool                    hdr_parsed;
 242         bool                    crop_altered;
 243         struct v4l2_ctrl_handler ctrl_handler;
 244         enum s5p_jpeg_ctx_state state;
 245 };
 246
 247 /**
 248  * s5p_jpeg_buffer - description of memory containing input JPEG data
 249  * @size:       buffer size
 250  * @curr:       current position in the buffer
 251  * @data:       pointer to the data
 252  */
 253 struct s5p_jpeg_buffer {
 254         unsigned long size;
 255         unsigned long curr;
 256         unsigned long data;
 257 };
 258
 259 /**
 260  * struct s5p_jpeg_addr - JPEG converter physical address set for DMA
 261  * @y:   luminance plane physical address
 262  * @cb:  Cb plane physical address
 263  * @cr:  Cr plane physical address
 264  */
 265 struct s5p_jpeg_addr {
 266         u32     y;
 267         u32     cb;
 268         u32     cr;
 269 };
 270
 271 #endif /* JPEG_CORE_H */