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

/*
 * include/media/smiapp.h
 *
 * Generic driver for SMIA/SMIA++ compliant camera modules
 *
 * Copyright (C) 2011--2012 Nokia Corporation
 * Contact: Sakari Ailus <sakari.ailus@iki.fi>
 *
 * This program is free software; you can redistribute it and/or
 * modify it under the terms of the GNU General Public License
 * version 2 as published by the Free Software Foundation.
 *
 * This program is distributed in the hope that it will be useful, but
 * WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program; if not, write to the Free Software
 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
 * 02110-1301 USA
 *
 */

#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

#define SMIAPP_NO_XSHUTDOWN	-1

/*
 * 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_platform_data {
	/*
	 * 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;

	int (*set_xclk)(struct v4l2_subdev *sd, int hz);
	int32_t xshutdown;		/* gpio or SMIAPP_NO_XSHUTDOWN */
};

#endif /* __SMIAPP_H_  */
Commit	Line	Data
ccfc97bd SA	1	/*
	2	* include/media/smiapp.h
	3	*
	4	* Generic driver for SMIA/SMIA++ compliant camera modules
	5	*
	6	* Copyright (C) 2011--2012 Nokia Corporation
8c5dff90	7	* Contact: Sakari Ailus <sakari.ailus@iki.fi>
ccfc97bd SA	8	*
	9	* This program is free software; you can redistribute it and/or
	10	* modify it under the terms of the GNU General Public License
	11	* version 2 as published by the Free Software Foundation.
	12	*
	13	* This program is distributed in the hope that it will be useful, but
	14	* WITHOUT ANY WARRANTY; without even the implied warranty of
	15	* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
	16	* General Public License for more details.
	17	*
	18	* You should have received a copy of the GNU General Public License
	19	* along with this program; if not, write to the Free Software
	20	* Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
	21	* 02110-1301 USA
	22	*
	23	*/
	24
	25	#ifndef __SMIAPP_H_
	26	#define __SMIAPP_H_
	27
	28	#include <media/v4l2-subdev.h>
	29
	30	#define SMIAPP_NAME "smiapp"
	31
	32	#define SMIAPP_DFL_I2C_ADDR (0x20 >> 1) /* Default I2C Address */
	33	#define SMIAPP_ALT_I2C_ADDR (0x6e >> 1) /* Alternate I2C Address */
	34
	35	#define SMIAPP_CSI_SIGNALLING_MODE_CCP2_DATA_CLOCK 0
	36	#define SMIAPP_CSI_SIGNALLING_MODE_CCP2_DATA_STROBE 1
	37	#define SMIAPP_CSI_SIGNALLING_MODE_CSI2 2
	38
	39	#define SMIAPP_NO_XSHUTDOWN -1
	40
	41	/*
	42	* Sometimes due to board layout considerations the camera module can be
	43	* mounted rotated. The typical rotation used is 180 degrees which can be
	44	* corrected by giving a default H-FLIP and V-FLIP in the sensor readout.
	45	* FIXME: rotation also changes the bayer pattern.
	46	*/
	47	enum smiapp_module_board_orient {
	48	SMIAPP_MODULE_BOARD_ORIENT_0 = 0,
	49	SMIAPP_MODULE_BOARD_ORIENT_180,
	50	};
	51
	52	struct smiapp_flash_strobe_parms {
	53	u8 mode;
	54	u32 strobe_width_high_us;
	55	u16 strobe_delay;
	56	u16 stobe_start_point;
	57	u8 trigger;
	58	};
	59
	60	struct smiapp_platform_data {
	61	/*
	62	* Change the cci address if i2c_addr_alt is set.
	63	* Both default and alternate cci addr need to be present
	64	*/
	65	unsigned short i2c_addr_dfl; /* Default i2c addr */
	66	unsigned short i2c_addr_alt; /* Alternate i2c addr */
	67
ec176a6f SA	68	uint32_t nvm_size; /* bytes */
ec176a6f SA	69	uint32_t ext_clk; /* sensor external clk */
ccfc97bd SA	70
ccfc97bd SA	71	unsigned int lanes; /* Number of CSI-2 lanes */
ec176a6f SA	72	uint32_t csi_signalling_mode; /* SMIAPP_CSI_SIGNALLING_MODE_* */
ec176a6f SA	73	uint64_t *op_sys_clock;
ccfc97bd SA	74
	75	enum smiapp_module_board_orient module_board_orient;
	76
	77	struct smiapp_flash_strobe_parms *strobe_setup;
	78
	79	int (set_xclk)(struct v4l2_subdev sd, int hz);
ec176a6f	80	int32_t xshutdown; /* gpio or SMIAPP_NO_XSHUTDOWN */
ccfc97bd SA	81	};
	82
	83	#endif /* __SMIAPP_H_ */