image_sensor.h

最新MTK手机软件源码

/*****************************************************************************
*  Copyright Statement:
*  --------------------
*  This software is protected by Copyright and the information contained
*  herein is confidential. The software may not be copied and the information
*  contained herein may not be used or disclosed except with the written
*  permission of MediaTek Inc. (C) 2005
*
*  BY OPENING THIS FILE, BUYER HEREBY UNEQUIVOCALLY ACKNOWLEDGES AND AGREES
*  THAT THE SOFTWARE/FIRMWARE AND ITS DOCUMENTATIONS ("MEDIATEK SOFTWARE")
*  RECEIVED FROM MEDIATEK AND/OR ITS REPRESENTATIVES ARE PROVIDED TO BUYER ON
*  AN "AS-IS" BASIS ONLY. MEDIATEK EXPRESSLY DISCLAIMS ANY AND ALL WARRANTIES,
*  EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE IMPLIED WARRANTIES OF
*  MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR NONINFRINGEMENT.
*  NEITHER DOES MEDIATEK PROVIDE ANY WARRANTY WHATSOEVER WITH RESPECT TO THE
*  SOFTWARE OF ANY THIRD PARTY WHICH MAY BE USED BY, INCORPORATED IN, OR
*  SUPPLIED WITH THE MEDIATEK SOFTWARE, AND BUYER AGREES TO LOOK ONLY TO SUCH
*  THIRD PARTY FOR ANY WARRANTY CLAIM RELATING THERETO. MEDIATEK SHALL ALSO
*  NOT BE RESPONSIBLE FOR ANY MEDIATEK SOFTWARE RELEASES MADE TO BUYER'S
*  SPECIFICATION OR TO CONFORM TO A PARTICULAR STANDARD OR OPEN FORUM.
*
*  BUYER'S SOLE AND EXCLUSIVE REMEDY AND MEDIATEK'S ENTIRE AND CUMULATIVE
*  LIABILITY WITH RESPECT TO THE MEDIATEK SOFTWARE RELEASED HEREUNDER WILL BE,
*  AT MEDIATEK'S OPTION, TO REVISE OR REPLACE THE MEDIATEK SOFTWARE AT ISSUE,
*  OR REFUND ANY SOFTWARE LICENSE FEES OR SERVICE CHARGE PAID BY BUYER TO
*  MEDIATEK FOR SUCH MEDIATEK SOFTWARE AT ISSUE. 
*
*  THE TRANSACTION CONTEMPLATED HEREUNDER SHALL BE CONSTRUED IN ACCORDANCE
*  WITH THE LAWS OF THE STATE OF CALIFORNIA, USA, EXCLUDING ITS CONFLICT OF
*  LAWS PRINCIPLES.  ANY DISPUTES, CONTROVERSIES OR CLAIMS ARISING THEREOF AND
*  RELATED THERETO SHALL BE SETTLED BY ARBITRATION IN SAN FRANCISCO, CA, UNDER
*  THE RULES OF THE INTERNATIONAL CHAMBER OF COMMERCE (ICC).
*
*****************************************************************************/

/*****************************************************************************
 *
 * Filename:
 * ---------
 *   image_sensor.h
 *
 * Project:
 * --------
 *   MT6219
 *
 * Description:
 * ------------
 *   CMOS sensor header file
 *
 * Author:
 * -------
 * -------
 *
 *============================================================================
 *             HISTORY
 * Below this line, this part is controlled by PVCS VM. DO NOT MODIFY!!
 *------------------------------------------------------------------------------
 * removed!
 * removed!
 * removed!
 *
 * removed!
 * removed!
 * removed!
 *
 * removed!
 * removed!
 * removed!
 *
 * removed!
 * removed!
 * removed!
 *
 * removed!
 * removed!
 * removed!
 *
 * removed!
 * removed!
 * removed!
 *
 * removed!
 * removed!
 * removed!
 *
 * removed!
 * removed!
 * removed!
 * removed!
 *
 * removed!
 * removed!
 * removed!
 * removed!
 *
 * removed!
 * removed!
 * removed!
 * removed!
 *
 * removed!
 * removed!
 * removed!
 *
 * removed!
 * removed!
 * removed!
 *
 * removed!
 * removed!
 * removed!
 *
 * removed!
 * removed!
 * removed!
 * removed!
 * removed!
 * removed!
 * removed!
 * removed!
 * removed!
 * removed!
 * removed!
 * removed!
 * removed!
 * removed!
 * removed!
 * removed!
 * removed!
 * removed!
 * removed!
 * removed!
 * removed!
 * removed!
 * removed!
 * removed!
 * removed!
 * removed!
 * removed!
 * removed!
 * removed!
 * removed!
 * removed!
 * removed!
 * removed!
 * removed!
 * removed!
 * removed!
 * removed!
 * removed!
 * removed!
 * removed!
 * removed!
 * removed!
 * removed!
 *
 * removed!
 * removed!
 *
 * removed!
 * removed!
 *
 * removed!
 * removed!
 *
 * removed!
 * removed!
 *
 * removed!
 * removed!
 *
 * removed!
 * removed!
 *
 * removed!
 * removed!
 *
 * removed!
 * removed!
 *
 * removed!
 * removed!
 *
 * removed!
 * removed!
 *
 * removed!
 * removed!
 *
 * removed!
 * removed!
 *
 * removed!
 * removed!
 *
 * removed!
 * removed!
 *
 * removed!
 * removed!
 *
 * removed!
 * removed!
 *
 * removed!
 * removed!
 *
 * removed!
 * removed!
 * removed!
 *
 * removed!
 * removed!
 * removed!
 *
 * removed!
 * removed!
 *
 * removed!
 * removed!
 * removed!
 *
 * removed!
 * removed!
 *
 *
 *------------------------------------------------------------------------------
 * Upper this line, this part is controlled by PVCS VM. DO NOT MODIFY!!
 *============================================================================
 ****************************************************************************/
#ifndef _IMAGE_SENSOR_H
#define _IMAGE_SENSOR_H

	#include "isp_if.h"

	//------------------------Engineer mode---------------------------------
	#define FACTORY_START_ADDR 0
	#define ENGINEER_START_ADDR 24
	
	typedef enum group_enum {
	   PRE_GAIN=0,
	   CMMCLK_CURRENT,
	   FRAME_RATE_LIMITATION,
	   REGISTER_EDITOR,
	   GROUP_TOTAL_NUMS
	} FACTORY_GROUP_ENUM;
	
	typedef enum register_index {
	   SENSOR_BASEGAIN=FACTORY_START_ADDR,
	   PRE_GAIN_R_INDEX,
	   PRE_GAIN_Gr_INDEX,
	   PRE_GAIN_Gb_INDEX,
	   PRE_GAIN_B_INDEX,	   
	   FACTORY_END_ADDR
	} FACTORY_REGISTER_INDEX;
	
	typedef enum engineer_index {
	   CMMCLK_CURRENT_INDEX=ENGINEER_START_ADDR,
	   ENGINEER_END
	} FACTORY_ENGINEER_INDEX;
	typedef struct
	{
	   kal_uint8   item_name_ptr[50];         // item name
	   kal_int32	item_value;                // item value
	   kal_bool    is_true_false;             // is this item for enable/disable functions
	   kal_bool	   is_read_only;              // is this item read only
	   kal_bool	   is_need_restart;           // after set this item need restart
	   kal_int32	min;                       // min value of item value	
	   kal_int32	max;                       // max value of item value	
	} ENG_sensor_info; 
	
	// API FOR ENGINEER FACTORY MODE
	void  get_sensor_group_count(kal_int32* sensor_count_ptr);
	void  get_sensor_group_info(kal_uint16 group_idx, kal_int8* group_name_ptr, kal_int32* item_count_ptr);
	void  get_sensor_item_info(kal_uint16 group_idx,kal_uint16 item_idx, ENG_sensor_info* info_ptr);
	kal_bool set_sensor_item_info(kal_uint16 group_idx, kal_uint16 item_idx, kal_int32 item_value);
	
	//------------------------Engineer mode---------------------------------
	
	// write camera_para to sensor register 
	void camera_para_to_sensor(void);
	// update camera_para from sensor register 
	void sensor_to_camera_para(void);
	// config sensor callback function 
	void image_sensor_func_config(void);
	// Compact Image Sensor Module Power ON/OFF
	void cis_module_power_on(kal_bool on);
	// Flash Light Power ON/OFF
	void flashlight_power_on(kal_bool on);
	
	/* HW PRODUCE I2C SIGNAL TO CONTROL SENSOR REGISTER */
	//#define HW_SCCB
	#define SCCB_16BIT

	typedef struct {
		kal_uint32	addr;
		kal_uint32	para;
	} sensor_reg_struct;
		
	typedef struct {
		sensor_reg_struct	reg[ENGINEER_END];
	   sensor_reg_struct	cct[FACTORY_END_ADDR];
	} sensor_data_struct;
	
	typedef enum _SENSOR_TYPE {
		CMOS_SENSOR=0,
		CCD_SENSOR
	} SENSOR_TYPE;

	typedef struct {
		kal_uint16		id;
		SENSOR_TYPE		type;
	} SensorInfo;

	/* MAXIMUM EXPLOSURE LINES USED BY AE */
	extern kal_uint16 MAX_EXPOSURE_LINES;
	extern kal_uint8  MIN_EXPOSURE_LINES;

	/* DEFINITION USED BY CCT */
	extern SensorInfo	g_CCT_MainSensor;
	extern kal_uint8	g_CCT_FirstGrabColor;

	#define SET_FIRST_GRAB_COLOR(n)			REG_ISP_PREPROCESS_CTRL1 &= ~REG_PREPROCESS1_PID_POLARITY_BIT;\
														REG_ISP_PREPROCESS_CTRL1 &= ~REG_PREPROCESS1_LID_POLARITY_BIT;\
														REG_ISP_PREPROCESS_CTRL1 |= (n<<12);

	
	/* FIRST GRAB COLOR */
	#define FIRST_GRAB_COLOR					BAYER_B		
	
	// CURRENT MAIN SENSOR 
	#define CURRENT_MAIN_SENSOR				MT9D011_MICRON

	/* START GRAB PIXEL OFFSET */
	#define IMAGE_SENSOR_START_GRAB_X		0	// 0 or 1 recommended
	#define IMAGE_SENSOR_START_GRAB_Y		0	// 0 or 1 recommended

	/* MAX/MIN FRAME RATE (FRAMES PER SEC.) */
	#define MAX_FRAME_RATE								15		// Limitation for MPEG4 Encode Only
	#define MIN_FRAME_RATE								12

	/* SENSOR GLOBAL GAIN AT NIGHT MODE */
	#define SENSOR_NIGHT_MODE_GAIN					0xC0

	/* SENSOR FULL SIZE */
	#define IMAGE_SENSOR_FULL_WIDTH					1600	
	#define IMAGE_SENSOR_FULL_HEIGHT					1200	

	/* SENSOR PV SIZE */
	#define IMAGE_SENSOR_PV_WIDTH					800
	#define IMAGE_SENSOR_PV_HEIGHT					600

	/* SENSOR HORIZONTAL/VERTICAL BLANKING */	
	#define IMAGE_SENSOR_FULL_HBLANKING				(324)	//(0x015C+0x100), min: 286/324, when use external(324+400)
	#define IMAGE_SENSOR_FULL_VBLANKING				(48)			//(0x0020), 26.5fps
	#define IMAGE_SENSOR_PV_HBLANKING				(324)	
	#define IMAGE_SENSOR_PV_VBLANKING				(48)			

	/* SENSOR PIXEL/LINE NUMBERS IN ONE PERIOD */
	#define FULL_ACTIVE_PIXEL_NUMS					(IMAGE_SENSOR_FULL_WIDTH+32)	// 32 , 0 boder
	#define FULL_ACTIVE_LINE_NUMS						(IMAGE_SENSOR_FULL_HEIGHT+42)	// 42 , 0 boder
	#define PV_ACTIVE_PIXEL_NUMS						(FULL_ACTIVE_PIXEL_NUMS>>1)	// 32 , 0 boder
	#define PV_ACTIVE_LINE_NUMS						(FULL_ACTIVE_LINE_NUMS>>1)		// 42 , 0 boder

	#define FULL_PERIOD_PIXEL_NUMS					(FULL_ACTIVE_PIXEL_NUMS+IMAGE_SENSOR_FULL_HBLANKING)
	#define FULL_PERIOD_LINE_NUMS						(FULL_ACTIVE_LINE_NUMS+IMAGE_SENSOR_FULL_VBLANKING)
	#define PV_PERIOD_PIXEL_NUMS						(PV_ACTIVE_PIXEL_NUMS+IMAGE_SENSOR_PV_HBLANKING)
	#define PV_PERIOD_LINE_NUMS						(PV_ACTIVE_LINE_NUMS+IMAGE_SENSOR_PV_VBLANKING)

	/* DUMMY NEEDS TO BE INSERTED */
	/* SETUP TIME NEED TO BE INSERTED */
	#define IMAGE_SENSOR_PV_INSERTED_PIXELS		0	// Sync, Nosync=2
	#define IMAGE_SENSOR_PV_INSERTED_LINES			2

	#define IMAGE_SENSOR_FULL_INSERTED_PIXELS		0
	#define IMAGE_SENSOR_FULL_INSERTED_LINES		2

	/* SENSOR READ/WRITE ID */
	#define MT9D011_WRITE_ID							0x90
	#define MT9D011_READ_ID								0x91
	#define MT9D011_WRITE_8BIT_ID						0x90
	#define MT9D011_READ_8BIT_ID						0x91
	#define MT9D011_READ_REG_ID						0xF1

	/* SENSOR CHIP VERSION */
	#define MT9D011_SENSOR_ID							0x1511
#endif /* _IMAGE_SENSOR_H */