media: video: tegra: ov5640: move MCLK into sensor
[linux-3.10.git] / include / media / max77665-flash.h
1 /*
2  * Copyright (c) 2012, NVIDIA CORPORATION.  All rights reserved.
3
4  * This program is free software; you can redistribute it and/or modify it
5  * under the terms and conditions of the GNU General Public License,
6  * version 2, as published by the Free Software Foundation.
7
8  * This program is distributed in the hope it will be useful, but WITHOUT
9  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
10  * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for
11  * more details.
12
13  * You should have received a copy of the GNU General Public License
14  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
15  */
16
17 #ifndef __MAX77665_H__
18 #define __MAX77665_H__
19
20 #include <media/nvc_torch.h>
21
22 struct max77665_f_power_rail {
23         /* to enable the module power */
24         struct regulator *vbus;
25         /* to enable the host interface power */
26         struct regulator *vio;
27         /* to enable the power on i2c bus */
28         struct regulator *i2c;
29 };
30
31 struct max77665_f_led_config {
32         u16 color_setting;
33         u16 flash_torch_ratio;  /* max flash to max torch ratio, in 1/1000 */
34         u16 granularity;        /* 1, 10, 100, ... to carry float settings */
35         u16 flash_levels;       /* calibrated flash levels < 32 */
36         /* this table contains the calibrated flash level - luminance pair */
37         struct nvc_torch_lumi_level_v1 *lumi_levels;
38 };
39
40 struct max77665_f_config {
41         u32 led_mask;           /* led(s) enabled, 1/2/3 - left/right/both */
42         bool synchronized_led;  /* if both leds enabled, consider as one. */
43         bool flash_on_torch;    /* true=high level on the torch_en pin will
44                                    turn on flash */
45         u16 flash_mode;         /* 1=one_shot_mode, flash is triggerred on the
46                                    rising edge of FLASHEN/TORCHEN/I2C_bit, and
47                                    terminated based on the flash safety timer
48                                    value.
49                                    0, 2=run for MAX timer, flash is triggerred
50                                    on the rising edge of FLASHEN/TORCHEN/I2C,
51                                    and terminated based on the falling edge of
52                                    FLASHEN/TORCHEN/I2C_bit and flash safety
53                                    timer value, whichever comes first.*/
54         u16 torch_trigger_mode; /* 0, 3=torch is triggered via i2c interface.
55                                    1=high level on the flash_en pin will turn
56                                    the torch on.
57                                    2=high level on the torch_en pin will turn
58                                    the torch on. */
59         u16 torch_mode;         /* 1=torch safety timer disabled, torch is
60                                    controlled solely by the FLASHEN/TORCHEN/I2C.
61                                    2=one_shot_mode, torch is triggerred on the
62                                    rising edge of FLASHEN/TORCHEN/I2C_bit, and
63                                    terminated based on the torch safety timer
64                                    setting.
65                                    0, 3=run MAX timer, torch is triggerred on
66                                    the rising edge of FLASHEN/TORCHEN/I2C_bit,
67                                    and terminated based on the falling edge of
68                                    FLASHEN/TORCHEN/ I2C_bit and torch safety
69                                    timer setting, whichever comes first.*/
70         u16 adaptive_mode;      /* 1=fix mode, 2=adaptive mode
71                                 The BYP starts from BOOST_VOUT_FLASH value.
72                                 Then increment by 100mV steps until there is
73                                 full programmed current across the LED(s).
74                                 Fixed mode otherwise: the BYP stays at
75                                 BOOST_VOUT_FLASH value */
76         u16 boost_vout_flash_mV;        /* BOOST_VOUT_FLASH value */
77         /* LED configuration, two identical leds must be connected. */
78         u16 max_total_current_mA; /* Both leds' maximum peak current in mA */
79         u16 max_peak_current_mA; /* This led's maximum peak current in mA */
80         u16 max_torch_current_mA; /* This leds maximum torch current in mA */
81         u16 max_peak_duration_ms; /* the maximum duration max_peak_current_mA
82                                      can be applied */
83         u16 max_flash_threshold_mV;  /* low battery detection threshold.
84                                         2400mV ~ 3400mV. */
85         u16 max_flash_hysteresis_mV; /* low battery detection hysteresis.
86                                         100mV ~ 300mV */
87         u16 max_flash_lbdly_f_uS; /* Low battery delay timer for falling edge
88                                         detection. Adjustable from 256uS to
89                                         2048uS in 256uS steps. */
90         u16 max_flash_lbdly_r_uS; /* Low battery delay timer for raising edge
91                                         detection. Adjustable from 256uS to
92                                         2048uS in 256uS steps. */
93         struct max77665_f_led_config led_config[2];
94 };
95
96 struct max77665_f_platform_data {
97         struct max77665_f_config config;
98         unsigned cfg; /* use the NVC_CFG_ defines */
99         unsigned num; /* see implementation notes in driver */
100         unsigned sync; /* see implementation notes in driver */
101         const char *dev_name; /* see implementation notes in driver */
102         struct nvc_torch_pin_state pinstate; /* see notes in driver */
103         unsigned gpio_strobe; /* GPIO connected to the ACT signal */
104         struct edp_client edpc_config;
105
106         int (*poweron_callback)(struct max77665_f_power_rail *pw);
107         int (*poweroff_callback)(struct max77665_f_power_rail *pw);
108 };
109
110 #endif
111 /* __MAX77665_H__ */