Commit | Line | Data |
---|---|---|
ed1a230f BR |
1 | /* |
2 | * Summit Microelectronics SMB347 Battery Charger Driver | |
3 | * | |
4 | * Copyright (C) 2011, Intel Corporation | |
5 | * | |
6 | * Authors: Bruce E. Robertson <bruce.e.robertson@intel.com> | |
7 | * Mika Westerberg <mika.westerberg@linux.intel.com> | |
8 | * | |
9 | * This program is free software; you can redistribute it and/or modify | |
10 | * it under the terms of the GNU General Public License version 2 as | |
11 | * published by the Free Software Foundation. | |
12 | */ | |
13 | ||
14 | #ifndef SMB347_CHARGER_H | |
15 | #define SMB347_CHARGER_H | |
16 | ||
17 | #include <linux/types.h> | |
18 | #include <linux/power_supply.h> | |
19 | ||
20 | enum { | |
21 | /* use the default compensation method */ | |
22 | SMB347_SOFT_TEMP_COMPENSATE_DEFAULT = -1, | |
23 | ||
24 | SMB347_SOFT_TEMP_COMPENSATE_NONE, | |
25 | SMB347_SOFT_TEMP_COMPENSATE_CURRENT, | |
26 | SMB347_SOFT_TEMP_COMPENSATE_VOLTAGE, | |
27 | }; | |
28 | ||
29 | /* Use default factory programmed value for hard/soft temperature limit */ | |
30 | #define SMB347_TEMP_USE_DEFAULT -273 | |
31 | ||
32 | /* | |
33 | * Charging enable can be controlled by software (via i2c) by | |
34 | * smb347-charger driver or by EN pin (active low/high). | |
35 | */ | |
36 | enum smb347_chg_enable { | |
37 | SMB347_CHG_ENABLE_SW, | |
38 | SMB347_CHG_ENABLE_PIN_ACTIVE_LOW, | |
39 | SMB347_CHG_ENABLE_PIN_ACTIVE_HIGH, | |
40 | }; | |
41 | ||
42 | /** | |
43 | * struct smb347_charger_platform_data - platform data for SMB347 charger | |
44 | * @battery_info: Information about the battery | |
45 | * @max_charge_current: maximum current (in uA) the battery can be charged | |
46 | * @max_charge_voltage: maximum voltage (in uV) the battery can be charged | |
47 | * @pre_charge_current: current (in uA) to use in pre-charging phase | |
48 | * @termination_current: current (in uA) used to determine when the | |
49 | * charging cycle terminates | |
50 | * @pre_to_fast_voltage: voltage (in uV) treshold used for transitioning to | |
51 | * pre-charge to fast charge mode | |
52 | * @mains_current_limit: maximum input current drawn from AC/DC input (in uA) | |
53 | * @usb_hc_current_limit: maximum input high current (in uA) drawn from USB | |
54 | * input | |
55 | * @chip_temp_threshold: die temperature where device starts limiting charge | |
56 | * current [%100 - %130] (in degree C) | |
57 | * @soft_cold_temp_limit: soft cold temperature limit [%0 - %15] (in degree C), | |
58 | * granularity is 5 deg C. | |
59 | * @soft_hot_temp_limit: soft hot temperature limit [%40 - %55] (in degree C), | |
60 | * granularity is 5 deg C. | |
61 | * @hard_cold_temp_limit: hard cold temperature limit [%-5 - %10] (in degree C), | |
62 | * granularity is 5 deg C. | |
63 | * @hard_hot_temp_limit: hard hot temperature limit [%50 - %65] (in degree C), | |
64 | * granularity is 5 deg C. | |
65 | * @suspend_on_hard_temp_limit: suspend charging when hard limit is hit | |
66 | * @soft_temp_limit_compensation: compensation method when soft temperature | |
67 | * limit is hit | |
68 | * @charge_current_compensation: current (in uA) for charging compensation | |
69 | * current when temperature hits soft limits | |
70 | * @use_mains: AC/DC input can be used | |
71 | * @use_usb: USB input can be used | |
72 | * @use_usb_otg: USB OTG output can be used (not implemented yet) | |
73 | * @irq_gpio: GPIO number used for interrupts (%-1 if not used) | |
74 | * @enable_control: how charging enable/disable is controlled | |
75 | * (driver/pin controls) | |
76 | * | |
77 | * @use_main, @use_usb, and @use_usb_otg are means to enable/disable | |
78 | * hardware support for these. This is useful when we want to have for | |
79 | * example OTG charging controlled via OTG transceiver driver and not by | |
80 | * the SMB347 hardware. | |
81 | * | |
82 | * Hard and soft temperature limit values are given as described in the | |
83 | * device data sheet and assuming NTC beta value is %3750. Even if this is | |
84 | * not the case, these values should be used. They can be mapped to the | |
85 | * corresponding NTC beta values with the help of table %2 in the data | |
86 | * sheet. So for example if NTC beta is %3375 and we want to program hard | |
87 | * hot limit to be %53 deg C, @hard_hot_temp_limit should be set to %50. | |
88 | * | |
89 | * If zero value is given in any of the current and voltage values, the | |
90 | * factory programmed default will be used. For soft/hard temperature | |
91 | * values, pass in %SMB347_TEMP_USE_DEFAULT instead. | |
92 | */ | |
93 | struct smb347_charger_platform_data { | |
94 | struct power_supply_info battery_info; | |
95 | unsigned int max_charge_current; | |
96 | unsigned int max_charge_voltage; | |
97 | unsigned int pre_charge_current; | |
98 | unsigned int termination_current; | |
99 | unsigned int pre_to_fast_voltage; | |
100 | unsigned int mains_current_limit; | |
101 | unsigned int usb_hc_current_limit; | |
102 | unsigned int chip_temp_threshold; | |
103 | int soft_cold_temp_limit; | |
104 | int soft_hot_temp_limit; | |
105 | int hard_cold_temp_limit; | |
106 | int hard_hot_temp_limit; | |
107 | bool suspend_on_hard_temp_limit; | |
108 | unsigned int soft_temp_limit_compensation; | |
109 | unsigned int charge_current_compensation; | |
110 | bool use_mains; | |
111 | bool use_usb; | |
112 | bool use_usb_otg; | |
113 | int irq_gpio; | |
114 | enum smb347_chg_enable enable_control; | |
115 | }; | |
116 | ||
117 | #endif /* SMB347_CHARGER_H */ |