projects / linux-2.6-block.git / blame
| 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 */ |