linux/drivers/media/platform/coda/coda.h
<<
>>
Prefs
   1/* SPDX-License-Identifier: GPL-2.0-or-later */
   2/*
   3 * Coda multi-standard codec IP
   4 *
   5 * Copyright (C) 2012 Vista Silicon S.L.
   6 *    Javier Martin, <javier.martin@vista-silicon.com>
   7 *    Xavier Duret
   8 * Copyright (C) 2012-2014 Philipp Zabel, Pengutronix
   9 */
  10
  11#ifndef __CODA_H__
  12#define __CODA_H__
  13
  14#include <linux/debugfs.h>
  15#include <linux/idr.h>
  16#include <linux/irqreturn.h>
  17#include <linux/mutex.h>
  18#include <linux/kfifo.h>
  19#include <linux/videodev2.h>
  20
  21#include <media/v4l2-ctrls.h>
  22#include <media/v4l2-device.h>
  23#include <media/v4l2-fh.h>
  24#include <media/videobuf2-v4l2.h>
  25
  26#include "coda_regs.h"
  27
  28#define CODA_MAX_FRAMEBUFFERS   19
  29#define FMO_SLICE_SAVE_BUF_SIZE (32)
  30
  31enum {
  32        V4L2_M2M_SRC = 0,
  33        V4L2_M2M_DST = 1,
  34};
  35
  36enum coda_inst_type {
  37        CODA_INST_ENCODER,
  38        CODA_INST_DECODER,
  39};
  40
  41enum coda_product {
  42        CODA_DX6 = 0xf001,
  43        CODA_HX4 = 0xf00a,
  44        CODA_7541 = 0xf012,
  45        CODA_960 = 0xf020,
  46};
  47
  48struct coda_video_device;
  49
  50struct coda_devtype {
  51        char                    *firmware[3];
  52        enum coda_product       product;
  53        const struct coda_codec *codecs;
  54        unsigned int            num_codecs;
  55        const struct coda_video_device **vdevs;
  56        unsigned int            num_vdevs;
  57        size_t                  workbuf_size;
  58        size_t                  tempbuf_size;
  59        size_t                  iram_size;
  60};
  61
  62struct coda_aux_buf {
  63        void                    *vaddr;
  64        dma_addr_t              paddr;
  65        u32                     size;
  66        struct debugfs_blob_wrapper blob;
  67        struct dentry           *dentry;
  68};
  69
  70struct coda_dev {
  71        struct v4l2_device      v4l2_dev;
  72        struct video_device     vfd[5];
  73        struct device           *dev;
  74        const struct coda_devtype *devtype;
  75        int                     firmware;
  76        struct vdoa_data        *vdoa;
  77
  78        void __iomem            *regs_base;
  79        struct clk              *clk_per;
  80        struct clk              *clk_ahb;
  81        struct reset_control    *rstc;
  82
  83        struct coda_aux_buf     codebuf;
  84        struct coda_aux_buf     tempbuf;
  85        struct coda_aux_buf     workbuf;
  86        struct gen_pool         *iram_pool;
  87        struct coda_aux_buf     iram;
  88
  89        spinlock_t              irqlock;
  90        struct mutex            dev_mutex;
  91        struct mutex            coda_mutex;
  92        struct workqueue_struct *workqueue;
  93        struct v4l2_m2m_dev     *m2m_dev;
  94        struct ida              ida;
  95        struct dentry           *debugfs_root;
  96};
  97
  98struct coda_codec {
  99        u32 mode;
 100        u32 src_fourcc;
 101        u32 dst_fourcc;
 102        u32 max_w;
 103        u32 max_h;
 104};
 105
 106struct coda_huff_tab;
 107
 108struct coda_params {
 109        u8                      rot_mode;
 110        u8                      h264_intra_qp;
 111        u8                      h264_inter_qp;
 112        u8                      h264_min_qp;
 113        u8                      h264_max_qp;
 114        u8                      h264_disable_deblocking_filter_idc;
 115        s8                      h264_slice_alpha_c0_offset_div2;
 116        s8                      h264_slice_beta_offset_div2;
 117        bool                    h264_constrained_intra_pred_flag;
 118        s8                      h264_chroma_qp_index_offset;
 119        u8                      h264_profile_idc;
 120        u8                      h264_level_idc;
 121        u8                      mpeg2_profile_idc;
 122        u8                      mpeg2_level_idc;
 123        u8                      mpeg4_intra_qp;
 124        u8                      mpeg4_inter_qp;
 125        u8                      gop_size;
 126        int                     intra_refresh;
 127        u8                      jpeg_quality;
 128        u8                      jpeg_restart_interval;
 129        u8                      *jpeg_qmat_tab[3];
 130        int                     codec_mode;
 131        int                     codec_mode_aux;
 132        enum v4l2_mpeg_video_multi_slice_mode slice_mode;
 133        u32                     framerate;
 134        u16                     bitrate;
 135        u16                     vbv_delay;
 136        u32                     vbv_size;
 137        u32                     slice_max_bits;
 138        u32                     slice_max_mb;
 139        bool                    force_ipicture;
 140        bool                    gop_size_changed;
 141        bool                    bitrate_changed;
 142        bool                    framerate_changed;
 143        bool                    h264_intra_qp_changed;
 144        bool                    intra_refresh_changed;
 145        bool                    slice_mode_changed;
 146};
 147
 148struct coda_buffer_meta {
 149        struct list_head        list;
 150        u32                     sequence;
 151        struct v4l2_timecode    timecode;
 152        u64                     timestamp;
 153        unsigned int            start;
 154        unsigned int            end;
 155        bool                    last;
 156};
 157
 158/* Per-queue, driver-specific private data */
 159struct coda_q_data {
 160        unsigned int            width;
 161        unsigned int            height;
 162        unsigned int            bytesperline;
 163        unsigned int            sizeimage;
 164        unsigned int            fourcc;
 165        struct v4l2_rect        rect;
 166};
 167
 168struct coda_iram_info {
 169        u32             axi_sram_use;
 170        phys_addr_t     buf_bit_use;
 171        phys_addr_t     buf_ip_ac_dc_use;
 172        phys_addr_t     buf_dbk_y_use;
 173        phys_addr_t     buf_dbk_c_use;
 174        phys_addr_t     buf_ovl_use;
 175        phys_addr_t     buf_btp_use;
 176        phys_addr_t     search_ram_paddr;
 177        int             search_ram_size;
 178        int             remaining;
 179        phys_addr_t     next_paddr;
 180};
 181
 182#define GDI_LINEAR_FRAME_MAP 0
 183#define GDI_TILED_FRAME_MB_RASTER_MAP 1
 184
 185struct coda_ctx;
 186
 187struct coda_context_ops {
 188        int (*queue_init)(void *priv, struct vb2_queue *src_vq,
 189                          struct vb2_queue *dst_vq);
 190        int (*reqbufs)(struct coda_ctx *ctx, struct v4l2_requestbuffers *rb);
 191        int (*start_streaming)(struct coda_ctx *ctx);
 192        int (*prepare_run)(struct coda_ctx *ctx);
 193        void (*finish_run)(struct coda_ctx *ctx);
 194        void (*run_timeout)(struct coda_ctx *ctx);
 195        void (*seq_init_work)(struct work_struct *work);
 196        void (*seq_end_work)(struct work_struct *work);
 197        void (*release)(struct coda_ctx *ctx);
 198};
 199
 200struct coda_internal_frame {
 201        struct coda_aux_buf             buf;
 202        struct coda_buffer_meta         meta;
 203        u32                             type;
 204        u32                             error;
 205};
 206
 207struct coda_ctx {
 208        struct coda_dev                 *dev;
 209        struct mutex                    buffer_mutex;
 210        struct work_struct              pic_run_work;
 211        struct work_struct              seq_init_work;
 212        struct work_struct              seq_end_work;
 213        struct completion               completion;
 214        const struct coda_video_device  *cvd;
 215        const struct coda_context_ops   *ops;
 216        int                             aborting;
 217        int                             initialized;
 218        int                             streamon_out;
 219        int                             streamon_cap;
 220        u32                             qsequence;
 221        u32                             osequence;
 222        u32                             sequence_offset;
 223        struct coda_q_data              q_data[2];
 224        enum coda_inst_type             inst_type;
 225        const struct coda_codec         *codec;
 226        enum v4l2_colorspace            colorspace;
 227        enum v4l2_xfer_func             xfer_func;
 228        enum v4l2_ycbcr_encoding        ycbcr_enc;
 229        enum v4l2_quantization          quantization;
 230        struct coda_params              params;
 231        struct v4l2_ctrl_handler        ctrls;
 232        struct v4l2_ctrl                *h264_profile_ctrl;
 233        struct v4l2_ctrl                *h264_level_ctrl;
 234        struct v4l2_ctrl                *mpeg2_profile_ctrl;
 235        struct v4l2_ctrl                *mpeg2_level_ctrl;
 236        struct v4l2_ctrl                *mpeg4_profile_ctrl;
 237        struct v4l2_ctrl                *mpeg4_level_ctrl;
 238        struct v4l2_fh                  fh;
 239        int                             gopcounter;
 240        int                             runcounter;
 241        char                            vpu_header[3][64];
 242        int                             vpu_header_size[3];
 243        struct kfifo                    bitstream_fifo;
 244        struct mutex                    bitstream_mutex;
 245        struct coda_aux_buf             bitstream;
 246        bool                            hold;
 247        struct coda_aux_buf             parabuf;
 248        struct coda_aux_buf             psbuf;
 249        struct coda_aux_buf             slicebuf;
 250        struct coda_internal_frame      internal_frames[CODA_MAX_FRAMEBUFFERS];
 251        struct list_head                buffer_meta_list;
 252        spinlock_t                      buffer_meta_lock;
 253        int                             num_metas;
 254        struct coda_aux_buf             workbuf;
 255        int                             num_internal_frames;
 256        int                             idx;
 257        int                             reg_idx;
 258        struct coda_iram_info           iram_info;
 259        int                             tiled_map_type;
 260        u32                             bit_stream_param;
 261        u32                             frm_dis_flg;
 262        u32                             frame_mem_ctrl;
 263        u32                             para_change;
 264        int                             display_idx;
 265        struct dentry                   *debugfs_entry;
 266        bool                            use_bit;
 267        bool                            use_vdoa;
 268        struct vdoa_ctx                 *vdoa;
 269        /*
 270         * wakeup mutex used to serialize encoder stop command and finish_run,
 271         * ensures that finish_run always either flags the last returned buffer
 272         * or wakes up the capture queue to signal EOS afterwards.
 273         */
 274        struct mutex                    wakeup_mutex;
 275};
 276
 277extern int coda_debug;
 278
 279#define coda_dbg(level, ctx, fmt, arg...)                               \
 280        do {                                                            \
 281                if (coda_debug >= (level))                              \
 282                        v4l2_dbg((level), coda_debug, &(ctx)->dev->v4l2_dev, \
 283                         "%u: " fmt, (ctx)->idx, ##arg);                \
 284        } while (0)
 285
 286void coda_write(struct coda_dev *dev, u32 data, u32 reg);
 287unsigned int coda_read(struct coda_dev *dev, u32 reg);
 288void coda_write_base(struct coda_ctx *ctx, struct coda_q_data *q_data,
 289                     struct vb2_v4l2_buffer *buf, unsigned int reg_y);
 290
 291int coda_alloc_aux_buf(struct coda_dev *dev, struct coda_aux_buf *buf,
 292                       size_t size, const char *name, struct dentry *parent);
 293void coda_free_aux_buf(struct coda_dev *dev, struct coda_aux_buf *buf);
 294
 295int coda_encoder_queue_init(void *priv, struct vb2_queue *src_vq,
 296                            struct vb2_queue *dst_vq);
 297int coda_decoder_queue_init(void *priv, struct vb2_queue *src_vq,
 298                            struct vb2_queue *dst_vq);
 299
 300int coda_hw_reset(struct coda_ctx *ctx);
 301
 302void coda_fill_bitstream(struct coda_ctx *ctx, struct list_head *buffer_list);
 303
 304void coda_set_gdi_regs(struct coda_ctx *ctx);
 305
 306static inline struct coda_q_data *get_q_data(struct coda_ctx *ctx,
 307                                             enum v4l2_buf_type type)
 308{
 309        switch (type) {
 310        case V4L2_BUF_TYPE_VIDEO_OUTPUT:
 311                return &(ctx->q_data[V4L2_M2M_SRC]);
 312        case V4L2_BUF_TYPE_VIDEO_CAPTURE:
 313                return &(ctx->q_data[V4L2_M2M_DST]);
 314        default:
 315                return NULL;
 316        }
 317}
 318
 319const char *coda_product_name(int product);
 320
 321int coda_check_firmware(struct coda_dev *dev);
 322
 323static inline unsigned int coda_get_bitstream_payload(struct coda_ctx *ctx)
 324{
 325        return kfifo_len(&ctx->bitstream_fifo);
 326}
 327
 328/*
 329 * The bitstream prefetcher needs to read at least 2 256 byte periods past
 330 * the desired bitstream position for all data to reach the decoder.
 331 */
 332static inline bool coda_bitstream_can_fetch_past(struct coda_ctx *ctx,
 333                                                 unsigned int pos)
 334{
 335        return (int)(ctx->bitstream_fifo.kfifo.in - ALIGN(pos, 256)) > 512;
 336}
 337
 338bool coda_bitstream_can_fetch_past(struct coda_ctx *ctx, unsigned int pos);
 339int coda_bitstream_flush(struct coda_ctx *ctx);
 340
 341void coda_bit_stream_end_flag(struct coda_ctx *ctx);
 342
 343void coda_m2m_buf_done(struct coda_ctx *ctx, struct vb2_v4l2_buffer *buf,
 344                       enum vb2_buffer_state state);
 345
 346int coda_h264_filler_nal(int size, char *p);
 347int coda_h264_padding(int size, char *p);
 348int coda_h264_profile(int profile_idc);
 349int coda_h264_level(int level_idc);
 350int coda_sps_parse_profile(struct coda_ctx *ctx, struct vb2_buffer *vb);
 351int coda_h264_sps_fixup(struct coda_ctx *ctx, int width, int height, char *buf,
 352                        int *size, int max_size);
 353
 354int coda_mpeg2_profile(int profile_idc);
 355int coda_mpeg2_level(int level_idc);
 356u32 coda_mpeg2_parse_headers(struct coda_ctx *ctx, u8 *buf, u32 size);
 357int coda_mpeg4_profile(int profile_idc);
 358int coda_mpeg4_level(int level_idc);
 359u32 coda_mpeg4_parse_headers(struct coda_ctx *ctx, u8 *buf, u32 size);
 360
 361void coda_update_profile_level_ctrls(struct coda_ctx *ctx, u8 profile_idc,
 362                                     u8 level_idc);
 363
 364bool coda_jpeg_check_buffer(struct coda_ctx *ctx, struct vb2_buffer *vb);
 365int coda_jpeg_write_tables(struct coda_ctx *ctx);
 366void coda_set_jpeg_compression_quality(struct coda_ctx *ctx, int quality);
 367
 368extern const struct coda_context_ops coda_bit_encode_ops;
 369extern const struct coda_context_ops coda_bit_decode_ops;
 370
 371irqreturn_t coda_irq_handler(int irq, void *data);
 372
 373#endif /* __CODA_H__ */
 374