[mirror_ubuntu-focal-kernel.git] / include / media / i2c / smiapp.h

/* SPDX-License-Identifier: GPL-2.0-only */
/*
 * include/media/i2c/smiapp.h
 *
 * Generic driver for SMIA/SMIA++ compliant camera modules
 *
 * Copyright (C) 2011--2012 Nokia Corporation
 * Contact: Sakari Ailus <sakari.ailus@iki.fi>
 */

#ifndef __SMIAPP_H_
#define __SMIAPP_H_

#include <media/v4l2-subdev.h>

#define SMIAPP_NAME		"smiapp"

#define SMIAPP_DFL_I2C_ADDR	(0x20 >> 1) /* Default I2C Address */
#define SMIAPP_ALT_I2C_ADDR	(0x6e >> 1) /* Alternate I2C Address */

#define SMIAPP_CSI_SIGNALLING_MODE_CCP2_DATA_CLOCK	0
#define SMIAPP_CSI_SIGNALLING_MODE_CCP2_DATA_STROBE	1
#define SMIAPP_CSI_SIGNALLING_MODE_CSI2			2

/*
 * Sometimes due to board layout considerations the camera module can be
 * mounted rotated. The typical rotation used is 180 degrees which can be
 * corrected by giving a default H-FLIP and V-FLIP in the sensor readout.
 * FIXME: rotation also changes the bayer pattern.
 */
enum smiapp_module_board_orient {
	SMIAPP_MODULE_BOARD_ORIENT_0 = 0,
	SMIAPP_MODULE_BOARD_ORIENT_180,
};

struct smiapp_flash_strobe_parms {
	u8 mode;
	u32 strobe_width_high_us;
	u16 strobe_delay;
	u16 stobe_start_point;
	u8 trigger;
};

struct smiapp_hwconfig {
	/*
	 * Change the cci address if i2c_addr_alt is set.
	 * Both default and alternate cci addr need to be present
	 */
	unsigned short i2c_addr_dfl;	/* Default i2c addr */
	unsigned short i2c_addr_alt;	/* Alternate i2c addr */

	uint32_t nvm_size;		/* bytes */
	uint32_t ext_clk;		/* sensor external clk */

	unsigned int lanes;		/* Number of CSI-2 lanes */
	uint32_t csi_signalling_mode;	/* SMIAPP_CSI_SIGNALLING_MODE_* */
	uint64_t *op_sys_clock;

	enum smiapp_module_board_orient module_board_orient;

	struct smiapp_flash_strobe_parms *strobe_setup;
};

#endif /* __SMIAPP_H_  */
Commit	Line	Data
1802d0be	1	/* SPDX-License-Identifier: GPL-2.0-only */
ccfc97bd	2	/*
b5dcee22	3	* include/media/i2c/smiapp.h
ccfc97bd SA	4	*
	5	* Generic driver for SMIA/SMIA++ compliant camera modules
	6	*
	7	* Copyright (C) 2011--2012 Nokia Corporation
8c5dff90	8	* Contact: Sakari Ailus <sakari.ailus@iki.fi>
ccfc97bd SA	9	*/
	10
	11	#ifndef __SMIAPP_H_
	12	#define __SMIAPP_H_
	13
	14	#include <media/v4l2-subdev.h>
	15
	16	#define SMIAPP_NAME "smiapp"
	17
	18	#define SMIAPP_DFL_I2C_ADDR (0x20 >> 1) /* Default I2C Address */
	19	#define SMIAPP_ALT_I2C_ADDR (0x6e >> 1) /* Alternate I2C Address */
	20
	21	#define SMIAPP_CSI_SIGNALLING_MODE_CCP2_DATA_CLOCK 0
	22	#define SMIAPP_CSI_SIGNALLING_MODE_CCP2_DATA_STROBE 1
	23	#define SMIAPP_CSI_SIGNALLING_MODE_CSI2 2
	24
ccfc97bd SA	25	/*
	26	* Sometimes due to board layout considerations the camera module can be
	27	* mounted rotated. The typical rotation used is 180 degrees which can be
	28	* corrected by giving a default H-FLIP and V-FLIP in the sensor readout.
	29	* FIXME: rotation also changes the bayer pattern.
	30	*/
	31	enum smiapp_module_board_orient {
	32	SMIAPP_MODULE_BOARD_ORIENT_0 = 0,
	33	SMIAPP_MODULE_BOARD_ORIENT_180,
	34	};
	35
	36	struct smiapp_flash_strobe_parms {
	37	u8 mode;
	38	u32 strobe_width_high_us;
	39	u16 strobe_delay;
	40	u16 stobe_start_point;
	41	u8 trigger;
	42	};
	43
697a521f	44	struct smiapp_hwconfig {
ccfc97bd SA	45	/*
	46	* Change the cci address if i2c_addr_alt is set.
	47	* Both default and alternate cci addr need to be present
	48	*/
	49	unsigned short i2c_addr_dfl; /* Default i2c addr */
	50	unsigned short i2c_addr_alt; /* Alternate i2c addr */
	51
ec176a6f SA	52	uint32_t nvm_size; /* bytes */
ec176a6f SA	53	uint32_t ext_clk; /* sensor external clk */
ccfc97bd SA	54
ccfc97bd SA	55	unsigned int lanes; /* Number of CSI-2 lanes */
ec176a6f SA	56	uint32_t csi_signalling_mode; /* SMIAPP_CSI_SIGNALLING_MODE_* */
ec176a6f SA	57	uint64_t *op_sys_clock;
ccfc97bd SA	58
	59	enum smiapp_module_board_orient module_board_orient;
	60
	61	struct smiapp_flash_strobe_parms *strobe_setup;
ccfc97bd SA	62	};
	63
	64	#endif /* __SMIAPP_H_ */