LXR linux/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
  32struct dma_chan;
  33struct ispstat;
  34
  35struct 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
  46struct 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
  76enum ispstat_state_t {
  77        ISPSTAT_DISABLED = 0,
  78        ISPSTAT_DISABLING,
  79        ISPSTAT_ENABLED,
  80        ISPSTAT_ENABLING,
  81        ISPSTAT_SUSPENDED,
  82};
  83
  84struct 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
 116struct 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
 127int omap3isp_stat_config(struct ispstat *stat, void *new_conf);
 128int omap3isp_stat_request_statistics(struct ispstat *stat,
 129                                     struct omap3isp_stat_data *data);
 130int omap3isp_stat_request_statistics_time32(struct ispstat *stat,
 131                                     struct omap3isp_stat_data_time32 *data);
 132int omap3isp_stat_init(struct ispstat *stat, const char *name,
 133                       const struct v4l2_subdev_ops *sd_ops);
 134void omap3isp_stat_cleanup(struct ispstat *stat);
 135int omap3isp_stat_subscribe_event(struct v4l2_subdev *subdev,
 136                                  struct v4l2_fh *fh,
 137                                  struct v4l2_event_subscription *sub);
 138int omap3isp_stat_unsubscribe_event(struct v4l2_subdev *subdev,
 139                                    struct v4l2_fh *fh,
 140                                    struct v4l2_event_subscription *sub);
 141int omap3isp_stat_s_stream(struct v4l2_subdev *subdev, int enable);
 142
 143int omap3isp_stat_busy(struct ispstat *stat);
 144int omap3isp_stat_pcr_busy(struct ispstat *stat);
 145void omap3isp_stat_suspend(struct ispstat *stat);
 146void omap3isp_stat_resume(struct ispstat *stat);
 147int omap3isp_stat_enable(struct ispstat *stat, u8 enable);
 148void omap3isp_stat_sbl_overflow(struct ispstat *stat);
 149void omap3isp_stat_isr(struct ispstat *stat);
 150void omap3isp_stat_isr_frame_sync(struct ispstat *stat);
 151void omap3isp_stat_dma_isr(struct ispstat *stat);
 152int omap3isp_stat_register_entities(struct ispstat *stat,
 153                                    struct v4l2_device *vdev);
 154void omap3isp_stat_unregister_entities(struct ispstat *stat);
 155
 156#endif /* OMAP3_ISP_STAT_H */
 157