drivers/media/platform/omap3isp/ispstat.h

   1 /* SPDX-License-Identifier: GPL-2.0-only */
   2 /*
   3  * ispstat.h
   4  *
   5  * TI OMAP3 ISP - Statistics core
   6  *
   7  * Copyright (C) 2010 Nokia Corporation
   8  * Copyright (C) 2009 Texas Instruments, Inc
   9  *
  10  * Contacts: David Cohen <dacohen@gmail.com>
  11  *           Laurent Pinchart <laurent.pinchart@ideasonboard.com>
  12  *           Sakari Ailus <sakari.ailus@iki.fi>
  13  */
  14
  15 #ifndef OMAP3_ISP_STAT_H
  16 #define OMAP3_ISP_STAT_H
  17
  18 #include <linux/types.h>
  19 #include <linux/omap3isp.h>
  20 #include <media/v4l2-event.h>
  21
  22 #include "isp.h"
  23 #include "ispvideo.h"
  24
  25 #define STAT_MAX_BUFS           5
  26 #define STAT_NEVENTS            8
  27
  28 #define STAT_BUF_DONE           0       /* Buffer is ready */
  29 #define STAT_NO_BUF             1       /* An error has occurred */
  30 #define STAT_BUF_WAITING_DMA    2       /* Histogram only: DMA is running */
  31
  32 struct dma_chan;
  33 struct ispstat;
  34
  35 struct ispstat_buffer {
  36         struct sg_table sgt;
  37         void *virt_addr;
  38         dma_addr_t dma_addr;
  39         struct timespec64 ts;
  40         u32 buf_size;
  41         u32 frame_number;
  42         u16 config_counter;
  43         u8 empty;
  44 };
  45
  46 struct ispstat_ops {
  47         /*
  48          * Validate new params configuration.
  49          * new_conf->buf_size value must be changed to the exact buffer size
  50          * necessary for the new configuration if it's smaller.
  51          */
  52         int (*validate_params)(struct ispstat *stat, void *new_conf);
  53
  54         /*
  55          * Save new params configuration.
  56          * stat->priv->buf_size value must be set to the exact buffer size for
  57          * the new configuration.
  58          * stat->update is set to 1 if new configuration is different than
  59          * current one.
  60          */
  61         void (*set_params)(struct ispstat *stat, void *new_conf);
  62
  63         /* Apply stored configuration. */
  64         void (*setup_regs)(struct ispstat *stat, void *priv);
  65
  66         /* Enable/Disable module. */
  67         void (*enable)(struct ispstat *stat, int enable);
  68
  69         /* Verify is module is busy. */
  70         int (*busy)(struct ispstat *stat);
  71
  72         /* Used for specific operations during generic buf process task. */
  73         int (*buf_process)(struct ispstat *stat);
  74 };
  75
  76 enum ispstat_state_t {
  77         ISPSTAT_DISABLED = 0,
  78         ISPSTAT_DISABLING,
  79         ISPSTAT_ENABLED,
  80         ISPSTAT_ENABLING,
  81         ISPSTAT_SUSPENDED,
  82 };
  83
  84 struct ispstat {
  85         struct v4l2_subdev subdev;
  86         struct media_pad pad;   /* sink pad */
  87
  88         /* Control */
  89         unsigned configured:1;
  90         unsigned update:1;
  91         unsigned buf_processing:1;
  92         unsigned sbl_ovl_recover:1;
  93         u8 inc_config;
  94         atomic_t buf_err;
  95         enum ispstat_state_t state;     /* enabling/disabling state */
  96         struct isp_device *isp;
  97         void *priv;             /* pointer to priv config struct */
  98         void *recover_priv;     /* pointer to recover priv configuration */
  99         struct mutex ioctl_lock; /* serialize private ioctl */
 100
 101         const struct ispstat_ops *ops;
 102
 103         /* Buffer */
 104         u8 wait_acc_frames;
 105         u16 config_counter;
 106         u32 frame_number;
 107         u32 buf_size;
 108         u32 buf_alloc_size;
 109         struct dma_chan *dma_ch;
 110         unsigned long event_type;
 111         struct ispstat_buffer *buf;
 112         struct ispstat_buffer *active_buf;
 113         struct ispstat_buffer *locked_buf;
 114 };
 115
 116 struct ispstat_generic_config {
 117         /*
 118          * Fields must be in the same order as in:
 119          *  - omap3isp_h3a_aewb_config
 120          *  - omap3isp_h3a_af_config
 121          *  - omap3isp_hist_config
 122          */
 123         u32 buf_size;
 124         u16 config_counter;
 125 };
 126
 127 int omap3isp_stat_config(struct ispstat *stat, void *new_conf);
 128 int omap3isp_stat_request_statistics(struct ispstat *stat,
 129                                      struct omap3isp_stat_data *data);
 130 int omap3isp_stat_request_statistics_time32(struct ispstat *stat,
 131                                      struct omap3isp_stat_data_time32 *data);
 132 int omap3isp_stat_init(struct ispstat *stat, const char *name,
 133                        const struct v4l2_subdev_ops *sd_ops);
 134 void omap3isp_stat_cleanup(struct ispstat *stat);
 135 int omap3isp_stat_subscribe_event(struct v4l2_subdev *subdev,
 136                                   struct v4l2_fh *fh,
 137                                   struct v4l2_event_subscription *sub);
 138 int omap3isp_stat_unsubscribe_event(struct v4l2_subdev *subdev,
 139                                     struct v4l2_fh *fh,
 140                                     struct v4l2_event_subscription *sub);
 141 int omap3isp_stat_s_stream(struct v4l2_subdev *subdev, int enable);
 142
 143 int omap3isp_stat_busy(struct ispstat *stat);
 144 int omap3isp_stat_pcr_busy(struct ispstat *stat);
 145 void omap3isp_stat_suspend(struct ispstat *stat);
 146 void omap3isp_stat_resume(struct ispstat *stat);
 147 int omap3isp_stat_enable(struct ispstat *stat, u8 enable);
 148 void omap3isp_stat_sbl_overflow(struct ispstat *stat);
 149 void omap3isp_stat_isr(struct ispstat *stat);
 150 void omap3isp_stat_isr_frame_sync(struct ispstat *stat);
 151 void omap3isp_stat_dma_isr(struct ispstat *stat);
 152 int omap3isp_stat_register_entities(struct ispstat *stat,
 153                                     struct v4l2_device *vdev);
 154 void omap3isp_stat_unregister_entities(struct ispstat *stat);
 155
 156 #endif /* OMAP3_ISP_STAT_H */