/* SPDX-License-Identifier: ((GPL-2.0+ WITH Linux-syscall-note) OR BSD-3-Clause) */
/*
 * bcm2835-isp.h
 *
 * BCM2835 ISP driver - user space header file.
 *
 * Copyright © 2019-2020 Raspberry Pi (Trading) Ltd.
 *
 * Author: Naushir Patuck (naush@raspberrypi.com)
 *
 */

#ifndef __BCM2835_ISP_H_
#define __BCM2835_ISP_H_

#include <linux/v4l2-controls.h>

#define V4L2_CID_USER_BCM2835_ISP_CC_MATRIX	\
				(V4L2_CID_USER_BCM2835_ISP_BASE + 0x0001)
#define V4L2_CID_USER_BCM2835_ISP_LENS_SHADING	\
				(V4L2_CID_USER_BCM2835_ISP_BASE + 0x0002)
#define V4L2_CID_USER_BCM2835_ISP_BLACK_LEVEL	\
				(V4L2_CID_USER_BCM2835_ISP_BASE + 0x0003)
#define V4L2_CID_USER_BCM2835_ISP_GEQ		\
				(V4L2_CID_USER_BCM2835_ISP_BASE + 0x0004)
#define V4L2_CID_USER_BCM2835_ISP_GAMMA		\
				(V4L2_CID_USER_BCM2835_ISP_BASE + 0x0005)
#define V4L2_CID_USER_BCM2835_ISP_DENOISE	\
				(V4L2_CID_USER_BCM2835_ISP_BASE + 0x0006)
#define V4L2_CID_USER_BCM2835_ISP_SHARPEN	\
				(V4L2_CID_USER_BCM2835_ISP_BASE + 0x0007)
#define V4L2_CID_USER_BCM2835_ISP_DPC		\
				(V4L2_CID_USER_BCM2835_ISP_BASE + 0x0008)
#define V4L2_CID_USER_BCM2835_ISP_CDN \
				(V4L2_CID_USER_BCM2835_ISP_BASE + 0x0009)
/*
 * All structs below are directly mapped onto the equivalent structs in
 * drivers/staging/vc04_services/vchiq-mmal/mmal-parameters.h
 * for convenience.
 */

/**
 * struct bcm2835_isp_rational - Rational value type.
 *
 * @num:	Numerator.
 * @den:	Denominator.
 */
struct bcm2835_isp_rational {
	__s32 num;
	__u32 den;
};

/**
 * struct bcm2835_isp_ccm - Colour correction matrix.
 *
 * @ccm:	3x3 correction matrix coefficients.
 * @offsets:	1x3 correction offsets.
 */
struct bcm2835_isp_ccm {
	struct bcm2835_isp_rational ccm[3][3];
	__s32 offsets[3];
};

/**
 * struct bcm2835_isp_custom_ccm - Custom CCM applied with the
 *				   V4L2_CID_USER_BCM2835_ISP_CC_MATRIX ctrl.
 *
 * @enabled:	Enable custom CCM.
 * @ccm:	Custom CCM coefficients and offsets.
 */
struct bcm2835_isp_custom_ccm {
	__u32 enabled;
	struct bcm2835_isp_ccm ccm;
};

/**
 * enum bcm2835_isp_gain_format - format of the gains in the lens shading
 *				  tables used with the
 *				  V4L2_CID_USER_BCM2835_ISP_LENS_SHADING ctrl.
 *
 * @GAIN_FORMAT_U0P8_1:		Gains are u0.8 format, starting at 1.0
 * @GAIN_FORMAT_U1P7_0:		Gains are u1.7 format, starting at 0.0
 * @GAIN_FORMAT_U1P7_1:		Gains are u1.7 format, starting at 1.0
 * @GAIN_FORMAT_U2P6_0:		Gains are u2.6 format, starting at 0.0
 * @GAIN_FORMAT_U2P6_1:		Gains are u2.6 format, starting at 1.0
 * @GAIN_FORMAT_U3P5_0:		Gains are u3.5 format, starting at 0.0
 * @GAIN_FORMAT_U3P5_1:		Gains are u3.5 format, starting at 1.0
 * @GAIN_FORMAT_U4P10:		Gains are u4.10 format, starting at 0.0
 */
enum bcm2835_isp_gain_format {
	GAIN_FORMAT_U0P8_1 = 0,
	GAIN_FORMAT_U1P7_0 = 1,
	GAIN_FORMAT_U1P7_1 = 2,
	GAIN_FORMAT_U2P6_0 = 3,
	GAIN_FORMAT_U2P6_1 = 4,
	GAIN_FORMAT_U3P5_0 = 5,
	GAIN_FORMAT_U3P5_1 = 6,
	GAIN_FORMAT_U4P10  = 7,
};

/**
 * struct bcm2835_isp_lens_shading - Lens shading tables supplied with the
 *				     V4L2_CID_USER_BCM2835_ISP_LENS_SHADING
 *				     ctrl.
 *
 * @enabled:		Enable lens shading.
 * @grid_cell_size:	Size of grid cells in samples (16, 32, 64, 128 or 256).
 * @grid_width:		Width of lens shading tables in grid cells.
 * @grid_stride:	Row to row distance (in grid cells) between grid cells
 *			in the same horizontal location.
 * @grid_height:	Height of lens shading tables in grid cells.
 * @dmabuf:		dmabuf file handle containing the table.
 * @ref_transform:	Reference transform - unsupported, please pass zero.
 * @corner_sampled:	Whether the gains are sampled at the corner points
 *			of the grid cells or in the cell centres.
 * @gain_format:	Format of the gains (see enum &bcm2835_isp_gain_format).
 */
struct bcm2835_isp_lens_shading {
	__u32 enabled;
	__u32 grid_cell_size;
	__u32 grid_width;
	__u32 grid_stride;
	__u32 grid_height;
	__s32 dmabuf;
	__u32 ref_transform;
	__u32 corner_sampled;
	__u32 gain_format;
};

/**
 * struct bcm2835_isp_black_level - Sensor black level set with the
 *				    V4L2_CID_USER_BCM2835_ISP_BLACK_LEVEL ctrl.
 *
 * @enabled:		Enable black level.
 * @black_level_r:	Black level for red channel.
 * @black_level_g:	Black level for green channels.
 * @black_level_b:	Black level for blue channel.
 */
struct bcm2835_isp_black_level {
	__u32 enabled;
	__u16 black_level_r;
	__u16 black_level_g;
	__u16 black_level_b;
	__u8 padding[2]; /* Unused */
};

/**
 * struct bcm2835_isp_geq - Green equalisation parameters set with the
 *			    V4L2_CID_USER_BCM2835_ISP_GEQ ctrl.
 *
 * @enabled:	Enable green equalisation.
 * @offset:	Fixed offset of the green equalisation threshold.
 * @slope:	Slope of the green equalisation threshold.
 */
struct bcm2835_isp_geq {
	__u32 enabled;
	__u32 offset;
	struct bcm2835_isp_rational slope;
};

#define BCM2835_NUM_GAMMA_PTS 33

/**
 * struct bcm2835_isp_gamma - Gamma parameters set with the
 *			      V4L2_CID_USER_BCM2835_ISP_GAMMA ctrl.
 *
 * @enabled:	Enable gamma adjustment.
 * @X:		X values of the points defining the gamma curve.
 *		Values should be scaled to 16 bits.
 * @Y:		Y values of the points defining the gamma curve.
 *		Values should be scaled to 16 bits.
 */
struct bcm2835_isp_gamma {
	__u32 enabled;
	__u16 x[BCM2835_NUM_GAMMA_PTS];
	__u16 y[BCM2835_NUM_GAMMA_PTS];
};

/**
 * enum bcm2835_isp_cdn_mode - Mode of operation for colour denoise.
 *
  * @CDN_MODE_FAST:		Fast (but lower quality) colour denoise
 *				algorithm, typically used for video recording.
 * @CDN_HIGH_QUALITY:		High quality (but slower) colour denoise
 *				algorithm, typically used for stills capture.
 */