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_s_stream(struct v4l2_subdev *subdev, int enable);
139
140int omap3isp_stat_busy(struct ispstat *stat);
141int omap3isp_stat_pcr_busy(struct ispstat *stat);
142void omap3isp_stat_suspend(struct ispstat *stat);
143void omap3isp_stat_resume(struct ispstat *stat);
144int omap3isp_stat_enable(struct ispstat *stat, u8 enable);
145void omap3isp_stat_sbl_overflow(struct ispstat *stat);
146void omap3isp_stat_isr(struct ispstat *stat);
147void omap3isp_stat_isr_frame_sync(struct ispstat *stat);
148void omap3isp_stat_dma_isr(struct ispstat *stat);
149int omap3isp_stat_register_entities(struct ispstat *stat,
150				    struct v4l2_device *vdev);
151void omap3isp_stat_unregister_entities(struct ispstat *stat);
152
153#endif /* OMAP3_ISP_STAT_H */