LXR linux/drivers/media/platform/rcar-vin/rcar-vin.h

   1/*
   2 * Driver for Renesas R-Car VIN
   3 *
   4 * Copyright (C) 2016 Renesas Electronics Corp.
   5 * Copyright (C) 2011-2013 Renesas Solutions Corp.
   6 * Copyright (C) 2013 Cogent Embedded, Inc., <source@cogentembedded.com>
   7 * Copyright (C) 2008 Magnus Damm
   8 *
   9 * Based on the soc-camera rcar_vin driver
  10 *
  11 * This program is free software; you can redistribute  it and/or modify it
  12 * under  the terms of  the GNU General  Public License as published by the
  13 * Free Software Foundation;  either version 2 of the  License, or (at your
  14 * option) any later version.
  15 */
  16
  17#ifndef __RCAR_VIN__
  18#define __RCAR_VIN__
  19
  20#include <media/v4l2-async.h>
  21#include <media/v4l2-ctrls.h>
  22#include <media/v4l2-dev.h>
  23#include <media/v4l2-device.h>
  24#include <media/videobuf2-v4l2.h>
  25
  26/* Number of HW buffers */
  27#define HW_BUFFER_NUM 3
  28
  29/* Address alignment mask for HW buffers */
  30#define HW_BUFFER_MASK 0x7f
  31
  32enum chip_id {
  33        RCAR_H1,
  34        RCAR_M1,
  35        RCAR_GEN2,
  36};
  37
  38/**
  39 * STOPPED  - No operation in progress
  40 * RUNNING  - Operation in progress have buffers
  41 * STALLED  - No operation in progress have no buffers
  42 * STOPPING - Stopping operation
  43 */
  44enum rvin_dma_state {
  45        STOPPED = 0,
  46        RUNNING,
  47        STALLED,
  48        STOPPING,
  49};
  50
  51/**
  52 * struct rvin_source_fmt - Source information
  53 * @width:      Width from source
  54 * @height:     Height from source
  55 */
  56struct rvin_source_fmt {
  57        u32 width;
  58        u32 height;
  59};
  60
  61/**
  62 * struct rvin_video_format - Data format stored in memory
  63 * @fourcc:     Pixelformat
  64 * @bpp:        Bytes per pixel
  65 */
  66struct rvin_video_format {
  67        u32 fourcc;
  68        u8 bpp;
  69};
  70
  71/**
  72 * struct rvin_graph_entity - Video endpoint from async framework
  73 * @asd:        sub-device descriptor for async framework
  74 * @subdev:     subdevice matched using async framework
  75 * @code:       Media bus format from source
  76 * @mbus_cfg:   Media bus format from DT
  77 * @source_pad: source pad of remote subdevice
  78 * @sink_pad:   sink pad of remote subdevice
  79 */
  80struct rvin_graph_entity {
  81        struct v4l2_async_subdev asd;
  82        struct v4l2_subdev *subdev;
  83
  84        u32 code;
  85        struct v4l2_mbus_config mbus_cfg;
  86
  87        unsigned int source_pad;
  88        unsigned int sink_pad;
  89};
  90
  91/**
  92 * struct rvin_dev - Renesas VIN device structure
  93 * @dev:                (OF) device
  94 * @base:               device I/O register space remapped to virtual memory
  95 * @chip:               type of VIN chip
  96 *
  97 * @vdev:               V4L2 video device associated with VIN
  98 * @v4l2_dev:           V4L2 device
  99 * @ctrl_handler:       V4L2 control handler
 100 * @notifier:           V4L2 asynchronous subdevs notifier
 101 * @digital:            entity in the DT for local digital subdevice
 102 *
 103 * @lock:               protects @queue
 104 * @queue:              vb2 buffers queue
 105 *
 106 * @qlock:              protects @queue_buf, @buf_list, @continuous, @sequence
 107 *                      @state
 108 * @queue_buf:          Keeps track of buffers given to HW slot
 109 * @buf_list:           list of queued buffers
 110 * @continuous:         tracks if active operation is continuous or single mode
 111 * @sequence:           V4L2 buffers sequence number
 112 * @state:              keeps track of operation state
 113 *
 114 * @source:             active format from the video source
 115 * @format:             active V4L2 pixel format
 116 *
 117 * @crop:               active cropping
 118 * @compose:            active composing
 119 */
 120struct rvin_dev {
 121        struct device *dev;
 122        void __iomem *base;
 123        enum chip_id chip;
 124
 125        struct video_device vdev;
 126        struct v4l2_device v4l2_dev;
 127        struct v4l2_ctrl_handler ctrl_handler;
 128        struct v4l2_async_notifier notifier;
 129        struct rvin_graph_entity digital;
 130
 131        struct mutex lock;
 132        struct vb2_queue queue;
 133
 134        spinlock_t qlock;
 135        struct vb2_v4l2_buffer *queue_buf[HW_BUFFER_NUM];
 136        struct list_head buf_list;
 137        bool continuous;
 138        unsigned int sequence;
 139        enum rvin_dma_state state;
 140
 141        struct rvin_source_fmt source;
 142        struct v4l2_pix_format format;
 143
 144        struct v4l2_rect crop;
 145        struct v4l2_rect compose;
 146};
 147
 148#define vin_to_source(vin)              vin->digital.subdev
 149
 150/* Debug */
 151#define vin_dbg(d, fmt, arg...)         dev_dbg(d->dev, fmt, ##arg)
 152#define vin_info(d, fmt, arg...)        dev_info(d->dev, fmt, ##arg)
 153#define vin_warn(d, fmt, arg...)        dev_warn(d->dev, fmt, ##arg)
 154#define vin_err(d, fmt, arg...)         dev_err(d->dev, fmt, ##arg)
 155
 156int rvin_dma_probe(struct rvin_dev *vin, int irq);
 157void rvin_dma_remove(struct rvin_dev *vin);
 158
 159int rvin_v4l2_probe(struct rvin_dev *vin);
 160void rvin_v4l2_remove(struct rvin_dev *vin);
 161
 162const struct rvin_video_format *rvin_format_from_pixel(u32 pixelformat);
 163
 164/* Cropping, composing and scaling */
 165void rvin_scale_try(struct rvin_dev *vin, struct v4l2_pix_format *pix,
 166                    u32 width, u32 height);
 167void rvin_crop_scale_comp(struct rvin_dev *vin);
 168
 169#endif
 170