2 * Copyright (C) 2011 Samsung Electronics Co., Ltd.
3 * MyungJoo Ham <myungjoo.ham@samsung.com>
5 * This driver enables to monitor battery health and control charger
6 * during suspend-to-mem.
7 * Charger manager depends on other devices. register this later than
8 * the depending devices.
10 * This program is free software; you can redistribute it and/or modify
11 * it under the terms of the GNU General Public License version 2 as
12 * published by the Free Software Foundation.
15 #define pr_fmt(fmt) KBUILD_MODNAME ": " fmt
18 #include <linux/module.h>
19 #include <linux/irq.h>
20 #include <linux/interrupt.h>
21 #include <linux/rtc.h>
22 #include <linux/slab.h>
23 #include <linux/workqueue.h>
24 #include <linux/platform_device.h>
25 #include <linux/power/charger-manager.h>
26 #include <linux/regulator/consumer.h>
27 #include <linux/sysfs.h>
29 #include <linux/thermal.h>
32 * Default termperature threshold for charging.
33 * Every temperature units are in tenth of centigrade.
35 #define CM_DEFAULT_RECHARGE_TEMP_DIFF 50
36 #define CM_DEFAULT_CHARGE_TEMP_MAX 500
38 static const char * const default_event_names
[] = {
39 [CM_EVENT_UNKNOWN
] = "Unknown",
40 [CM_EVENT_BATT_FULL
] = "Battery Full",
41 [CM_EVENT_BATT_IN
] = "Battery Inserted",
42 [CM_EVENT_BATT_OUT
] = "Battery Pulled Out",
43 [CM_EVENT_BATT_OVERHEAT
] = "Battery Overheat",
44 [CM_EVENT_BATT_COLD
] = "Battery Cold",
45 [CM_EVENT_EXT_PWR_IN_OUT
] = "External Power Attach/Detach",
46 [CM_EVENT_CHG_START_STOP
] = "Charging Start/Stop",
47 [CM_EVENT_OTHERS
] = "Other battery events"
51 * Regard CM_JIFFIES_SMALL jiffies is small enough to ignore for
52 * delayed works so that we can run delayed works with CM_JIFFIES_SMALL
55 #define CM_JIFFIES_SMALL (2)
57 /* If y is valid (> 0) and smaller than x, do x = y */
58 #define CM_MIN_VALID(x, y) x = (((y > 0) && ((x) > (y))) ? (y) : (x))
61 * Regard CM_RTC_SMALL (sec) is small enough to ignore error in invoking
62 * rtc alarm. It should be 2 or larger
64 #define CM_RTC_SMALL (2)
66 #define UEVENT_BUF_SIZE 32
68 static LIST_HEAD(cm_list
);
69 static DEFINE_MUTEX(cm_list_mtx
);
71 /* About in-suspend (suspend-again) monitoring */
72 static struct alarm
*cm_timer
;
74 static bool cm_suspended
;
75 static bool cm_timer_set
;
76 static unsigned long cm_suspend_duration_ms
;
78 /* About normal (not suspended) monitoring */
79 static unsigned long polling_jiffy
= ULONG_MAX
; /* ULONG_MAX: no polling */
80 static unsigned long next_polling
; /* Next appointed polling time */
81 static struct workqueue_struct
*cm_wq
; /* init at driver add */
82 static struct delayed_work cm_monitor_work
; /* init at driver add */
85 * is_batt_present - See if the battery presents in place.
86 * @cm: the Charger Manager representing the battery.
88 static bool is_batt_present(struct charger_manager
*cm
)
90 union power_supply_propval val
;
91 struct power_supply
*psy
;
95 switch (cm
->desc
->battery_present
) {
96 case CM_BATTERY_PRESENT
:
102 psy
= power_supply_get_by_name(cm
->desc
->psy_fuel_gauge
);
106 ret
= power_supply_get_property(psy
, POWER_SUPPLY_PROP_PRESENT
,
108 if (ret
== 0 && val
.intval
)
110 power_supply_put(psy
);
112 case CM_CHARGER_STAT
:
113 for (i
= 0; cm
->desc
->psy_charger_stat
[i
]; i
++) {
114 psy
= power_supply_get_by_name(
115 cm
->desc
->psy_charger_stat
[i
]);
117 dev_err(cm
->dev
, "Cannot find power supply \"%s\"\n",
118 cm
->desc
->psy_charger_stat
[i
]);
122 ret
= power_supply_get_property(psy
,
123 POWER_SUPPLY_PROP_PRESENT
, &val
);
124 power_supply_put(psy
);
125 if (ret
== 0 && val
.intval
) {
137 * is_ext_pwr_online - See if an external power source is attached to charge
138 * @cm: the Charger Manager representing the battery.
140 * Returns true if at least one of the chargers of the battery has an external
141 * power source attached to charge the battery regardless of whether it is
142 * actually charging or not.
144 static bool is_ext_pwr_online(struct charger_manager
*cm
)
146 union power_supply_propval val
;
147 struct power_supply
*psy
;
151 /* If at least one of them has one, it's yes. */
152 for (i
= 0; cm
->desc
->psy_charger_stat
[i
]; i
++) {
153 psy
= power_supply_get_by_name(cm
->desc
->psy_charger_stat
[i
]);
155 dev_err(cm
->dev
, "Cannot find power supply \"%s\"\n",
156 cm
->desc
->psy_charger_stat
[i
]);
160 ret
= power_supply_get_property(psy
, POWER_SUPPLY_PROP_ONLINE
,
162 power_supply_put(psy
);
163 if (ret
== 0 && val
.intval
) {
173 * get_batt_uV - Get the voltage level of the battery
174 * @cm: the Charger Manager representing the battery.
175 * @uV: the voltage level returned.
177 * Returns 0 if there is no error.
178 * Returns a negative value on error.
180 static int get_batt_uV(struct charger_manager
*cm
, int *uV
)
182 union power_supply_propval val
;
183 struct power_supply
*fuel_gauge
;
186 fuel_gauge
= power_supply_get_by_name(cm
->desc
->psy_fuel_gauge
);
190 ret
= power_supply_get_property(fuel_gauge
,
191 POWER_SUPPLY_PROP_VOLTAGE_NOW
, &val
);
192 power_supply_put(fuel_gauge
);
201 * is_charging - Returns true if the battery is being charged.
202 * @cm: the Charger Manager representing the battery.
204 static bool is_charging(struct charger_manager
*cm
)
207 bool charging
= false;
208 struct power_supply
*psy
;
209 union power_supply_propval val
;
211 /* If there is no battery, it cannot be charged */
212 if (!is_batt_present(cm
))
215 /* If at least one of the charger is charging, return yes */
216 for (i
= 0; cm
->desc
->psy_charger_stat
[i
]; i
++) {
217 /* 1. The charger sholuld not be DISABLED */
218 if (cm
->emergency_stop
)
220 if (!cm
->charger_enabled
)
223 psy
= power_supply_get_by_name(cm
->desc
->psy_charger_stat
[i
]);
225 dev_err(cm
->dev
, "Cannot find power supply \"%s\"\n",
226 cm
->desc
->psy_charger_stat
[i
]);
230 /* 2. The charger should be online (ext-power) */
231 ret
= power_supply_get_property(psy
, POWER_SUPPLY_PROP_ONLINE
,
234 dev_warn(cm
->dev
, "Cannot read ONLINE value from %s\n",
235 cm
->desc
->psy_charger_stat
[i
]);
236 power_supply_put(psy
);
239 if (val
.intval
== 0) {
240 power_supply_put(psy
);
245 * 3. The charger should not be FULL, DISCHARGING,
248 ret
= power_supply_get_property(psy
, POWER_SUPPLY_PROP_STATUS
,
250 power_supply_put(psy
);
252 dev_warn(cm
->dev
, "Cannot read STATUS value from %s\n",
253 cm
->desc
->psy_charger_stat
[i
]);
256 if (val
.intval
== POWER_SUPPLY_STATUS_FULL
||
257 val
.intval
== POWER_SUPPLY_STATUS_DISCHARGING
||
258 val
.intval
== POWER_SUPPLY_STATUS_NOT_CHARGING
)
261 /* Then, this is charging. */
270 * is_full_charged - Returns true if the battery is fully charged.
271 * @cm: the Charger Manager representing the battery.
273 static bool is_full_charged(struct charger_manager
*cm
)
275 struct charger_desc
*desc
= cm
->desc
;
276 union power_supply_propval val
;
277 struct power_supply
*fuel_gauge
;
278 bool is_full
= false;
282 /* If there is no battery, it cannot be charged */
283 if (!is_batt_present(cm
))
286 fuel_gauge
= power_supply_get_by_name(cm
->desc
->psy_fuel_gauge
);
290 if (desc
->fullbatt_full_capacity
> 0) {
293 /* Not full if capacity of fuel gauge isn't full */
294 ret
= power_supply_get_property(fuel_gauge
,
295 POWER_SUPPLY_PROP_CHARGE_FULL
, &val
);
296 if (!ret
&& val
.intval
> desc
->fullbatt_full_capacity
) {
302 /* Full, if it's over the fullbatt voltage */
303 if (desc
->fullbatt_uV
> 0) {
304 ret
= get_batt_uV(cm
, &uV
);
305 if (!ret
&& uV
>= desc
->fullbatt_uV
) {
311 /* Full, if the capacity is more than fullbatt_soc */
312 if (desc
->fullbatt_soc
> 0) {
315 ret
= power_supply_get_property(fuel_gauge
,
316 POWER_SUPPLY_PROP_CAPACITY
, &val
);
317 if (!ret
&& val
.intval
>= desc
->fullbatt_soc
) {
324 power_supply_put(fuel_gauge
);
329 * is_polling_required - Return true if need to continue polling for this CM.
330 * @cm: the Charger Manager representing the battery.
332 static bool is_polling_required(struct charger_manager
*cm
)
334 switch (cm
->desc
->polling_mode
) {
335 case CM_POLL_DISABLE
:
339 case CM_POLL_EXTERNAL_POWER_ONLY
:
340 return is_ext_pwr_online(cm
);
341 case CM_POLL_CHARGING_ONLY
:
342 return is_charging(cm
);
344 dev_warn(cm
->dev
, "Incorrect polling_mode (%d)\n",
345 cm
->desc
->polling_mode
);
352 * try_charger_enable - Enable/Disable chargers altogether
353 * @cm: the Charger Manager representing the battery.
354 * @enable: true: enable / false: disable
356 * Note that Charger Manager keeps the charger enabled regardless whether
357 * the charger is charging or not (because battery is full or no external
358 * power source exists) except when CM needs to disable chargers forcibly
359 * bacause of emergency causes; when the battery is overheated or too cold.
361 static int try_charger_enable(struct charger_manager
*cm
, bool enable
)
364 struct charger_desc
*desc
= cm
->desc
;
366 /* Ignore if it's redundent command */
367 if (enable
== cm
->charger_enabled
)
371 if (cm
->emergency_stop
)
375 * Save start time of charging to limit
376 * maximum possible charging time.
378 cm
->charging_start_time
= ktime_to_ms(ktime_get());
379 cm
->charging_end_time
= 0;
381 for (i
= 0 ; i
< desc
->num_charger_regulators
; i
++) {
382 if (desc
->charger_regulators
[i
].externally_control
)
385 err
= regulator_enable(desc
->charger_regulators
[i
].consumer
);
387 dev_warn(cm
->dev
, "Cannot enable %s regulator\n",
388 desc
->charger_regulators
[i
].regulator_name
);
393 * Save end time of charging to maintain fully charged state
394 * of battery after full-batt.
396 cm
->charging_start_time
= 0;
397 cm
->charging_end_time
= ktime_to_ms(ktime_get());
399 for (i
= 0 ; i
< desc
->num_charger_regulators
; i
++) {
400 if (desc
->charger_regulators
[i
].externally_control
)
403 err
= regulator_disable(desc
->charger_regulators
[i
].consumer
);
405 dev_warn(cm
->dev
, "Cannot disable %s regulator\n",
406 desc
->charger_regulators
[i
].regulator_name
);
411 * Abnormal battery state - Stop charging forcibly,
412 * even if charger was enabled at the other places
414 for (i
= 0; i
< desc
->num_charger_regulators
; i
++) {
415 if (regulator_is_enabled(
416 desc
->charger_regulators
[i
].consumer
)) {
417 regulator_force_disable(
418 desc
->charger_regulators
[i
].consumer
);
419 dev_warn(cm
->dev
, "Disable regulator(%s) forcibly\n",
420 desc
->charger_regulators
[i
].regulator_name
);
426 cm
->charger_enabled
= enable
;
432 * try_charger_restart - Restart charging.
433 * @cm: the Charger Manager representing the battery.
435 * Restart charging by turning off and on the charger.
437 static int try_charger_restart(struct charger_manager
*cm
)
441 if (cm
->emergency_stop
)
444 err
= try_charger_enable(cm
, false);
448 return try_charger_enable(cm
, true);
452 * uevent_notify - Let users know something has changed.
453 * @cm: the Charger Manager representing the battery.
454 * @event: the event string.
456 * If @event is null, it implies that uevent_notify is called
457 * by resume function. When called in the resume function, cm_suspended
458 * should be already reset to false in order to let uevent_notify
459 * notify the recent event during the suspend to users. While
460 * suspended, uevent_notify does not notify users, but tracks
461 * events so that uevent_notify can notify users later after resumed.
463 static void uevent_notify(struct charger_manager
*cm
, const char *event
)
465 static char env_str
[UEVENT_BUF_SIZE
+ 1] = "";
466 static char env_str_save
[UEVENT_BUF_SIZE
+ 1] = "";
469 /* Nothing in suspended-event buffer */
470 if (env_str_save
[0] == 0) {
471 if (!strncmp(env_str
, event
, UEVENT_BUF_SIZE
))
472 return; /* status not changed */
473 strncpy(env_str_save
, event
, UEVENT_BUF_SIZE
);
477 if (!strncmp(env_str_save
, event
, UEVENT_BUF_SIZE
))
478 return; /* Duplicated. */
479 strncpy(env_str_save
, event
, UEVENT_BUF_SIZE
);
484 /* No messages pending */
485 if (!env_str_save
[0])
488 strncpy(env_str
, env_str_save
, UEVENT_BUF_SIZE
);
489 kobject_uevent(&cm
->dev
->kobj
, KOBJ_CHANGE
);
495 /* status not changed */
496 if (!strncmp(env_str
, event
, UEVENT_BUF_SIZE
))
499 /* save the status and notify the update */
500 strncpy(env_str
, event
, UEVENT_BUF_SIZE
);
501 kobject_uevent(&cm
->dev
->kobj
, KOBJ_CHANGE
);
503 dev_info(cm
->dev
, "%s\n", event
);
507 * fullbatt_vchk - Check voltage drop some times after "FULL" event.
508 * @work: the work_struct appointing the function
510 * If a user has designated "fullbatt_vchkdrop_ms/uV" values with
511 * charger_desc, Charger Manager checks voltage drop after the battery
512 * "FULL" event. It checks whether the voltage has dropped more than
513 * fullbatt_vchkdrop_uV by calling this function after fullbatt_vchkrop_ms.
515 static void fullbatt_vchk(struct work_struct
*work
)
517 struct delayed_work
*dwork
= to_delayed_work(work
);
518 struct charger_manager
*cm
= container_of(dwork
,
519 struct charger_manager
, fullbatt_vchk_work
);
520 struct charger_desc
*desc
= cm
->desc
;
521 int batt_uV
, err
, diff
;
523 /* remove the appointment for fullbatt_vchk */
524 cm
->fullbatt_vchk_jiffies_at
= 0;
526 if (!desc
->fullbatt_vchkdrop_uV
|| !desc
->fullbatt_vchkdrop_ms
)
529 err
= get_batt_uV(cm
, &batt_uV
);
531 dev_err(cm
->dev
, "%s: get_batt_uV error(%d)\n", __func__
, err
);
535 diff
= desc
->fullbatt_uV
- batt_uV
;
539 dev_info(cm
->dev
, "VBATT dropped %duV after full-batt\n", diff
);
541 if (diff
> desc
->fullbatt_vchkdrop_uV
) {
542 try_charger_restart(cm
);
543 uevent_notify(cm
, "Recharging");
548 * check_charging_duration - Monitor charging/discharging duration
549 * @cm: the Charger Manager representing the battery.
551 * If whole charging duration exceed 'charging_max_duration_ms',
552 * cm stop charging to prevent overcharge/overheat. If discharging
553 * duration exceed 'discharging _max_duration_ms', charger cable is
554 * attached, after full-batt, cm start charging to maintain fully
555 * charged state for battery.
557 static int check_charging_duration(struct charger_manager
*cm
)
559 struct charger_desc
*desc
= cm
->desc
;
560 u64 curr
= ktime_to_ms(ktime_get());
564 if (!desc
->charging_max_duration_ms
&&
565 !desc
->discharging_max_duration_ms
)
568 if (cm
->charger_enabled
) {
569 duration
= curr
- cm
->charging_start_time
;
571 if (duration
> desc
->charging_max_duration_ms
) {
572 dev_info(cm
->dev
, "Charging duration exceed %ums\n",
573 desc
->charging_max_duration_ms
);
574 uevent_notify(cm
, "Discharging");
575 try_charger_enable(cm
, false);
578 } else if (is_ext_pwr_online(cm
) && !cm
->charger_enabled
) {
579 duration
= curr
- cm
->charging_end_time
;
581 if (duration
> desc
->charging_max_duration_ms
&&
582 is_ext_pwr_online(cm
)) {
583 dev_info(cm
->dev
, "Discharging duration exceed %ums\n",
584 desc
->discharging_max_duration_ms
);
585 uevent_notify(cm
, "Recharging");
586 try_charger_enable(cm
, true);
594 static int cm_get_battery_temperature_by_psy(struct charger_manager
*cm
,
597 struct power_supply
*fuel_gauge
;
600 fuel_gauge
= power_supply_get_by_name(cm
->desc
->psy_fuel_gauge
);
604 ret
= power_supply_get_property(fuel_gauge
,
605 POWER_SUPPLY_PROP_TEMP
,
606 (union power_supply_propval
*)temp
);
607 power_supply_put(fuel_gauge
);
612 static int cm_get_battery_temperature(struct charger_manager
*cm
,
617 if (!cm
->desc
->measure_battery_temp
)
620 #ifdef CONFIG_THERMAL
622 ret
= thermal_zone_get_temp(cm
->tzd_batt
, (unsigned long *)temp
);
624 /* Calibrate temperature unit */
629 /* if-else continued from CONFIG_THERMAL */
630 ret
= cm_get_battery_temperature_by_psy(cm
, temp
);
636 static int cm_check_thermal_status(struct charger_manager
*cm
)
638 struct charger_desc
*desc
= cm
->desc
;
639 int temp
, upper_limit
, lower_limit
;
642 ret
= cm_get_battery_temperature(cm
, &temp
);
645 * No information of battery temperature might
646 * occur hazadous result. We have to handle it
647 * depending on battery type.
649 dev_err(cm
->dev
, "Failed to get battery temperature\n");
653 upper_limit
= desc
->temp_max
;
654 lower_limit
= desc
->temp_min
;
656 if (cm
->emergency_stop
) {
657 upper_limit
-= desc
->temp_diff
;
658 lower_limit
+= desc
->temp_diff
;
661 if (temp
> upper_limit
)
662 ret
= CM_EVENT_BATT_OVERHEAT
;
663 else if (temp
< lower_limit
)
664 ret
= CM_EVENT_BATT_COLD
;
670 * _cm_monitor - Monitor the temperature and return true for exceptions.
671 * @cm: the Charger Manager representing the battery.
673 * Returns true if there is an event to notify for the battery.
674 * (True if the status of "emergency_stop" changes)
676 static bool _cm_monitor(struct charger_manager
*cm
)
680 temp_alrt
= cm_check_thermal_status(cm
);
682 /* It has been stopped already */
683 if (temp_alrt
&& cm
->emergency_stop
)
687 * Check temperature whether overheat or cold.
688 * If temperature is out of range normal state, stop charging.
691 cm
->emergency_stop
= temp_alrt
;
692 if (!try_charger_enable(cm
, false))
693 uevent_notify(cm
, default_event_names
[temp_alrt
]);
696 * Check whole charging duration and discharing duration
699 } else if (!cm
->emergency_stop
&& check_charging_duration(cm
)) {
701 "Charging/Discharging duration is out of range\n");
703 * Check dropped voltage of battery. If battery voltage is more
704 * dropped than fullbatt_vchkdrop_uV after fully charged state,
705 * charger-manager have to recharge battery.
707 } else if (!cm
->emergency_stop
&& is_ext_pwr_online(cm
) &&
708 !cm
->charger_enabled
) {
709 fullbatt_vchk(&cm
->fullbatt_vchk_work
.work
);
712 * Check whether fully charged state to protect overcharge
713 * if charger-manager is charging for battery.
715 } else if (!cm
->emergency_stop
&& is_full_charged(cm
) &&
716 cm
->charger_enabled
) {
717 dev_info(cm
->dev
, "EVENT_HANDLE: Battery Fully Charged\n");
718 uevent_notify(cm
, default_event_names
[CM_EVENT_BATT_FULL
]);
720 try_charger_enable(cm
, false);
722 fullbatt_vchk(&cm
->fullbatt_vchk_work
.work
);
724 cm
->emergency_stop
= 0;
725 if (is_ext_pwr_online(cm
)) {
726 if (!try_charger_enable(cm
, true))
727 uevent_notify(cm
, "CHARGING");
735 * cm_monitor - Monitor every battery.
737 * Returns true if there is an event to notify from any of the batteries.
738 * (True if the status of "emergency_stop" changes)
740 static bool cm_monitor(void)
743 struct charger_manager
*cm
;
745 mutex_lock(&cm_list_mtx
);
747 list_for_each_entry(cm
, &cm_list
, entry
) {
752 mutex_unlock(&cm_list_mtx
);
758 * _setup_polling - Setup the next instance of polling.
759 * @work: work_struct of the function _setup_polling.
761 static void _setup_polling(struct work_struct
*work
)
763 unsigned long min
= ULONG_MAX
;
764 struct charger_manager
*cm
;
765 bool keep_polling
= false;
766 unsigned long _next_polling
;
768 mutex_lock(&cm_list_mtx
);
770 list_for_each_entry(cm
, &cm_list
, entry
) {
771 if (is_polling_required(cm
) && cm
->desc
->polling_interval_ms
) {
774 if (min
> cm
->desc
->polling_interval_ms
)
775 min
= cm
->desc
->polling_interval_ms
;
779 polling_jiffy
= msecs_to_jiffies(min
);
780 if (polling_jiffy
<= CM_JIFFIES_SMALL
)
781 polling_jiffy
= CM_JIFFIES_SMALL
+ 1;
784 polling_jiffy
= ULONG_MAX
;
785 if (polling_jiffy
== ULONG_MAX
)
788 WARN(cm_wq
== NULL
, "charger-manager: workqueue not initialized"
789 ". try it later. %s\n", __func__
);
792 * Use mod_delayed_work() iff the next polling interval should
793 * occur before the currently scheduled one. If @cm_monitor_work
794 * isn't active, the end result is the same, so no need to worry
795 * about stale @next_polling.
797 _next_polling
= jiffies
+ polling_jiffy
;
799 if (time_before(_next_polling
, next_polling
)) {
800 mod_delayed_work(cm_wq
, &cm_monitor_work
, polling_jiffy
);
801 next_polling
= _next_polling
;
803 if (queue_delayed_work(cm_wq
, &cm_monitor_work
, polling_jiffy
))
804 next_polling
= _next_polling
;
807 mutex_unlock(&cm_list_mtx
);
809 static DECLARE_WORK(setup_polling
, _setup_polling
);
812 * cm_monitor_poller - The Monitor / Poller.
813 * @work: work_struct of the function cm_monitor_poller
815 * During non-suspended state, cm_monitor_poller is used to poll and monitor
818 static void cm_monitor_poller(struct work_struct
*work
)
821 schedule_work(&setup_polling
);
825 * fullbatt_handler - Event handler for CM_EVENT_BATT_FULL
826 * @cm: the Charger Manager representing the battery.
828 static void fullbatt_handler(struct charger_manager
*cm
)
830 struct charger_desc
*desc
= cm
->desc
;
832 if (!desc
->fullbatt_vchkdrop_uV
|| !desc
->fullbatt_vchkdrop_ms
)
836 device_set_wakeup_capable(cm
->dev
, true);
838 mod_delayed_work(cm_wq
, &cm
->fullbatt_vchk_work
,
839 msecs_to_jiffies(desc
->fullbatt_vchkdrop_ms
));
840 cm
->fullbatt_vchk_jiffies_at
= jiffies
+ msecs_to_jiffies(
841 desc
->fullbatt_vchkdrop_ms
);
843 if (cm
->fullbatt_vchk_jiffies_at
== 0)
844 cm
->fullbatt_vchk_jiffies_at
= 1;
847 dev_info(cm
->dev
, "EVENT_HANDLE: Battery Fully Charged\n");
848 uevent_notify(cm
, default_event_names
[CM_EVENT_BATT_FULL
]);
852 * battout_handler - Event handler for CM_EVENT_BATT_OUT
853 * @cm: the Charger Manager representing the battery.
855 static void battout_handler(struct charger_manager
*cm
)
858 device_set_wakeup_capable(cm
->dev
, true);
860 if (!is_batt_present(cm
)) {
861 dev_emerg(cm
->dev
, "Battery Pulled Out!\n");
862 uevent_notify(cm
, default_event_names
[CM_EVENT_BATT_OUT
]);
864 uevent_notify(cm
, "Battery Reinserted?");
869 * misc_event_handler - Handler for other evnets
870 * @cm: the Charger Manager representing the battery.
871 * @type: the Charger Manager representing the battery.
873 static void misc_event_handler(struct charger_manager
*cm
,
874 enum cm_event_types type
)
877 device_set_wakeup_capable(cm
->dev
, true);
879 if (is_polling_required(cm
) && cm
->desc
->polling_interval_ms
)
880 schedule_work(&setup_polling
);
881 uevent_notify(cm
, default_event_names
[type
]);
884 static int charger_get_property(struct power_supply
*psy
,
885 enum power_supply_property psp
,
886 union power_supply_propval
*val
)
888 struct charger_manager
*cm
= power_supply_get_drvdata(psy
);
889 struct charger_desc
*desc
= cm
->desc
;
890 struct power_supply
*fuel_gauge
= NULL
;
895 case POWER_SUPPLY_PROP_STATUS
:
897 val
->intval
= POWER_SUPPLY_STATUS_CHARGING
;
898 else if (is_ext_pwr_online(cm
))
899 val
->intval
= POWER_SUPPLY_STATUS_NOT_CHARGING
;
901 val
->intval
= POWER_SUPPLY_STATUS_DISCHARGING
;
903 case POWER_SUPPLY_PROP_HEALTH
:
904 if (cm
->emergency_stop
> 0)
905 val
->intval
= POWER_SUPPLY_HEALTH_OVERHEAT
;
906 else if (cm
->emergency_stop
< 0)
907 val
->intval
= POWER_SUPPLY_HEALTH_COLD
;
909 val
->intval
= POWER_SUPPLY_HEALTH_GOOD
;
911 case POWER_SUPPLY_PROP_PRESENT
:
912 if (is_batt_present(cm
))
917 case POWER_SUPPLY_PROP_VOLTAGE_NOW
:
918 ret
= get_batt_uV(cm
, &val
->intval
);
920 case POWER_SUPPLY_PROP_CURRENT_NOW
:
921 fuel_gauge
= power_supply_get_by_name(cm
->desc
->psy_fuel_gauge
);
926 ret
= power_supply_get_property(fuel_gauge
,
927 POWER_SUPPLY_PROP_CURRENT_NOW
, val
);
929 case POWER_SUPPLY_PROP_TEMP
:
930 case POWER_SUPPLY_PROP_TEMP_AMBIENT
:
931 return cm_get_battery_temperature(cm
, &val
->intval
);
932 case POWER_SUPPLY_PROP_CAPACITY
:
933 if (!is_batt_present(cm
)) {
934 /* There is no battery. Assume 100% */
939 fuel_gauge
= power_supply_get_by_name(cm
->desc
->psy_fuel_gauge
);
945 ret
= power_supply_get_property(fuel_gauge
,
946 POWER_SUPPLY_PROP_CAPACITY
, val
);
950 if (val
->intval
> 100) {
957 /* Do not adjust SOC when charging: voltage is overrated */
962 * If the capacity value is inconsistent, calibrate it base on
963 * the battery voltage values and the thresholds given as desc
965 ret
= get_batt_uV(cm
, &uV
);
967 /* Voltage information not available. No calibration */
972 if (desc
->fullbatt_uV
> 0 && uV
>= desc
->fullbatt_uV
&&
979 case POWER_SUPPLY_PROP_ONLINE
:
980 if (is_ext_pwr_online(cm
))
985 case POWER_SUPPLY_PROP_CHARGE_FULL
:
986 if (is_full_charged(cm
))
992 case POWER_SUPPLY_PROP_CHARGE_NOW
:
993 if (is_charging(cm
)) {
994 fuel_gauge
= power_supply_get_by_name(
995 cm
->desc
->psy_fuel_gauge
);
1001 ret
= power_supply_get_property(fuel_gauge
,
1002 POWER_SUPPLY_PROP_CHARGE_NOW
,
1008 /* If CHARGE_NOW is supplied, use it */
1009 val
->intval
= (val
->intval
> 0) ?
1020 power_supply_put(fuel_gauge
);
1024 #define NUM_CHARGER_PSY_OPTIONAL (4)
1025 static enum power_supply_property default_charger_props
[] = {
1026 /* Guaranteed to provide */
1027 POWER_SUPPLY_PROP_STATUS
,
1028 POWER_SUPPLY_PROP_HEALTH
,
1029 POWER_SUPPLY_PROP_PRESENT
,
1030 POWER_SUPPLY_PROP_VOLTAGE_NOW
,
1031 POWER_SUPPLY_PROP_CAPACITY
,
1032 POWER_SUPPLY_PROP_ONLINE
,
1033 POWER_SUPPLY_PROP_CHARGE_FULL
,
1035 * Optional properties are:
1036 * POWER_SUPPLY_PROP_CHARGE_NOW,
1037 * POWER_SUPPLY_PROP_CURRENT_NOW,
1038 * POWER_SUPPLY_PROP_TEMP, and
1039 * POWER_SUPPLY_PROP_TEMP_AMBIENT,
1043 static const struct power_supply_desc psy_default
= {
1045 .type
= POWER_SUPPLY_TYPE_BATTERY
,
1046 .properties
= default_charger_props
,
1047 .num_properties
= ARRAY_SIZE(default_charger_props
),
1048 .get_property
= charger_get_property
,
1053 * cm_setup_timer - For in-suspend monitoring setup wakeup alarm
1054 * for suspend_again.
1056 * Returns true if the alarm is set for Charger Manager to use.
1058 * cm_setup_timer fails to set an alarm,
1059 * cm_setup_timer does not need to set an alarm for Charger Manager,
1060 * or an alarm previously configured is to be used.
1062 static bool cm_setup_timer(void)
1064 struct charger_manager
*cm
;
1065 unsigned int wakeup_ms
= UINT_MAX
;
1068 if (time_after(next_polling
, jiffies
))
1069 CM_MIN_VALID(wakeup_ms
,
1070 jiffies_to_msecs(next_polling
- jiffies
));
1072 mutex_lock(&cm_list_mtx
);
1073 list_for_each_entry(cm
, &cm_list
, entry
) {
1074 unsigned int fbchk_ms
= 0;
1076 /* fullbatt_vchk is required. setup timer for that */
1077 if (cm
->fullbatt_vchk_jiffies_at
) {
1078 fbchk_ms
= jiffies_to_msecs(cm
->fullbatt_vchk_jiffies_at
1080 if (time_is_before_eq_jiffies(
1081 cm
->fullbatt_vchk_jiffies_at
) ||
1082 msecs_to_jiffies(fbchk_ms
) < CM_JIFFIES_SMALL
) {
1083 fullbatt_vchk(&cm
->fullbatt_vchk_work
.work
);
1087 CM_MIN_VALID(wakeup_ms
, fbchk_ms
);
1089 /* Skip if polling is not required for this CM */
1090 if (!is_polling_required(cm
) && !cm
->emergency_stop
)
1093 if (cm
->desc
->polling_interval_ms
== 0)
1095 CM_MIN_VALID(wakeup_ms
, cm
->desc
->polling_interval_ms
);
1097 mutex_unlock(&cm_list_mtx
);
1099 if (timer_req
&& cm_timer
) {
1103 * Set alarm with the polling interval (wakeup_ms)
1104 * The alarm time should be NOW + CM_RTC_SMALL or later.
1106 if (wakeup_ms
== UINT_MAX
||
1107 wakeup_ms
< CM_RTC_SMALL
* MSEC_PER_SEC
)
1108 wakeup_ms
= 2 * CM_RTC_SMALL
* MSEC_PER_SEC
;
1110 pr_info("Charger Manager wakeup timer: %u ms\n", wakeup_ms
);
1112 now
= ktime_get_boottime();
1113 add
= ktime_set(wakeup_ms
/ MSEC_PER_SEC
,
1114 (wakeup_ms
% MSEC_PER_SEC
) * NSEC_PER_MSEC
);
1115 alarm_start(cm_timer
, ktime_add(now
, add
));
1117 cm_suspend_duration_ms
= wakeup_ms
;
1125 * charger_extcon_work - enable/diable charger according to the state
1128 * @work: work_struct of the function charger_extcon_work.
1130 static void charger_extcon_work(struct work_struct
*work
)
1132 struct charger_cable
*cable
=
1133 container_of(work
, struct charger_cable
, wq
);
1136 if (cable
->attached
&& cable
->min_uA
!= 0 && cable
->max_uA
!= 0) {
1137 ret
= regulator_set_current_limit(cable
->charger
->consumer
,
1138 cable
->min_uA
, cable
->max_uA
);
1140 pr_err("Cannot set current limit of %s (%s)\n",
1141 cable
->charger
->regulator_name
, cable
->name
);
1145 pr_info("Set current limit of %s : %duA ~ %duA\n",
1146 cable
->charger
->regulator_name
,
1147 cable
->min_uA
, cable
->max_uA
);
1150 try_charger_enable(cable
->cm
, cable
->attached
);
1154 * charger_extcon_notifier - receive the state of charger cable
1155 * when registered cable is attached or detached.
1157 * @self: the notifier block of the charger_extcon_notifier.
1158 * @event: the cable state.
1159 * @ptr: the data pointer of notifier block.
1161 static int charger_extcon_notifier(struct notifier_block
*self
,
1162 unsigned long event
, void *ptr
)
1164 struct charger_cable
*cable
=
1165 container_of(self
, struct charger_cable
, nb
);
1168 * The newly state of charger cable.
1169 * If cable is attached, cable->attached is true.
1171 cable
->attached
= event
;
1174 * Setup monitoring to check battery state
1175 * when charger cable is attached.
1177 if (cable
->attached
&& is_polling_required(cable
->cm
)) {
1178 cancel_work_sync(&setup_polling
);
1179 schedule_work(&setup_polling
);
1183 * Setup work for controlling charger(regulator)
1184 * according to charger cable.
1186 schedule_work(&cable
->wq
);
1192 * charger_extcon_init - register external connector to use it
1193 * as the charger cable
1195 * @cm: the Charger Manager representing the battery.
1196 * @cable: the Charger cable representing the external connector.
1198 static int charger_extcon_init(struct charger_manager
*cm
,
1199 struct charger_cable
*cable
)
1204 * Charger manager use Extcon framework to identify
1205 * the charger cable among various external connector
1206 * cable (e.g., TA, USB, MHL, Dock).
1208 INIT_WORK(&cable
->wq
, charger_extcon_work
);
1209 cable
->nb
.notifier_call
= charger_extcon_notifier
;
1210 ret
= extcon_register_interest(&cable
->extcon_dev
,
1211 cable
->extcon_name
, cable
->name
, &cable
->nb
);
1213 pr_info("Cannot register extcon_dev for %s(cable: %s)\n",
1214 cable
->extcon_name
, cable
->name
);
1222 * charger_manager_register_extcon - Register extcon device to recevie state
1224 * @cm: the Charger Manager representing the battery.
1226 * This function support EXTCON(External Connector) subsystem to detect the
1227 * state of charger cables for enabling or disabling charger(regulator) and
1228 * select the charger cable for charging among a number of external cable
1229 * according to policy of H/W board.
1231 static int charger_manager_register_extcon(struct charger_manager
*cm
)
1233 struct charger_desc
*desc
= cm
->desc
;
1234 struct charger_regulator
*charger
;
1239 for (i
= 0; i
< desc
->num_charger_regulators
; i
++) {
1240 charger
= &desc
->charger_regulators
[i
];
1242 charger
->consumer
= regulator_get(cm
->dev
,
1243 charger
->regulator_name
);
1244 if (IS_ERR(charger
->consumer
)) {
1245 dev_err(cm
->dev
, "Cannot find charger(%s)\n",
1246 charger
->regulator_name
);
1247 return PTR_ERR(charger
->consumer
);
1251 for (j
= 0; j
< charger
->num_cables
; j
++) {
1252 struct charger_cable
*cable
= &charger
->cables
[j
];
1254 ret
= charger_extcon_init(cm
, cable
);
1256 dev_err(cm
->dev
, "Cannot initialize charger(%s)\n",
1257 charger
->regulator_name
);
1260 cable
->charger
= charger
;
1269 /* help function of sysfs node to control charger(regulator) */
1270 static ssize_t
charger_name_show(struct device
*dev
,
1271 struct device_attribute
*attr
, char *buf
)
1273 struct charger_regulator
*charger
1274 = container_of(attr
, struct charger_regulator
, attr_name
);
1276 return sprintf(buf
, "%s\n", charger
->regulator_name
);
1279 static ssize_t
charger_state_show(struct device
*dev
,
1280 struct device_attribute
*attr
, char *buf
)
1282 struct charger_regulator
*charger
1283 = container_of(attr
, struct charger_regulator
, attr_state
);
1286 if (!charger
->externally_control
)
1287 state
= regulator_is_enabled(charger
->consumer
);
1289 return sprintf(buf
, "%s\n", state
? "enabled" : "disabled");
1292 static ssize_t
charger_externally_control_show(struct device
*dev
,
1293 struct device_attribute
*attr
, char *buf
)
1295 struct charger_regulator
*charger
= container_of(attr
,
1296 struct charger_regulator
, attr_externally_control
);
1298 return sprintf(buf
, "%d\n", charger
->externally_control
);
1301 static ssize_t
charger_externally_control_store(struct device
*dev
,
1302 struct device_attribute
*attr
, const char *buf
,
1305 struct charger_regulator
*charger
1306 = container_of(attr
, struct charger_regulator
,
1307 attr_externally_control
);
1308 struct charger_manager
*cm
= charger
->cm
;
1309 struct charger_desc
*desc
= cm
->desc
;
1312 int externally_control
;
1313 int chargers_externally_control
= 1;
1315 ret
= sscanf(buf
, "%d", &externally_control
);
1321 if (!externally_control
) {
1322 charger
->externally_control
= 0;
1326 for (i
= 0; i
< desc
->num_charger_regulators
; i
++) {
1327 if (&desc
->charger_regulators
[i
] != charger
&&
1328 !desc
->charger_regulators
[i
].externally_control
) {
1330 * At least, one charger is controlled by
1333 chargers_externally_control
= 0;
1338 if (!chargers_externally_control
) {
1339 if (cm
->charger_enabled
) {
1340 try_charger_enable(charger
->cm
, false);
1341 charger
->externally_control
= externally_control
;
1342 try_charger_enable(charger
->cm
, true);
1344 charger
->externally_control
= externally_control
;
1348 "'%s' regulator should be controlled in charger-manager because charger-manager must need at least one charger for charging\n",
1349 charger
->regulator_name
);
1356 * charger_manager_register_sysfs - Register sysfs entry for each charger
1357 * @cm: the Charger Manager representing the battery.
1359 * This function add sysfs entry for charger(regulator) to control charger from
1360 * user-space. If some development board use one more chargers for charging
1361 * but only need one charger on specific case which is dependent on user
1362 * scenario or hardware restrictions, the user enter 1 or 0(zero) to '/sys/
1363 * class/power_supply/battery/charger.[index]/externally_control'. For example,
1364 * if user enter 1 to 'sys/class/power_supply/battery/charger.[index]/
1365 * externally_control, this charger isn't controlled from charger-manager and
1366 * always stay off state of regulator.
1368 static int charger_manager_register_sysfs(struct charger_manager
*cm
)
1370 struct charger_desc
*desc
= cm
->desc
;
1371 struct charger_regulator
*charger
;
1372 int chargers_externally_control
= 1;
1378 /* Create sysfs entry to control charger(regulator) */
1379 for (i
= 0; i
< desc
->num_charger_regulators
; i
++) {
1380 charger
= &desc
->charger_regulators
[i
];
1382 snprintf(buf
, 10, "charger.%d", i
);
1383 str
= devm_kzalloc(cm
->dev
,
1384 sizeof(char) * (strlen(buf
) + 1), GFP_KERNEL
);
1391 charger
->attrs
[0] = &charger
->attr_name
.attr
;
1392 charger
->attrs
[1] = &charger
->attr_state
.attr
;
1393 charger
->attrs
[2] = &charger
->attr_externally_control
.attr
;
1394 charger
->attrs
[3] = NULL
;
1395 charger
->attr_g
.name
= str
;
1396 charger
->attr_g
.attrs
= charger
->attrs
;
1398 sysfs_attr_init(&charger
->attr_name
.attr
);
1399 charger
->attr_name
.attr
.name
= "name";
1400 charger
->attr_name
.attr
.mode
= 0444;
1401 charger
->attr_name
.show
= charger_name_show
;
1403 sysfs_attr_init(&charger
->attr_state
.attr
);
1404 charger
->attr_state
.attr
.name
= "state";
1405 charger
->attr_state
.attr
.mode
= 0444;
1406 charger
->attr_state
.show
= charger_state_show
;
1408 sysfs_attr_init(&charger
->attr_externally_control
.attr
);
1409 charger
->attr_externally_control
.attr
.name
1410 = "externally_control";
1411 charger
->attr_externally_control
.attr
.mode
= 0644;
1412 charger
->attr_externally_control
.show
1413 = charger_externally_control_show
;
1414 charger
->attr_externally_control
.store
1415 = charger_externally_control_store
;
1417 if (!desc
->charger_regulators
[i
].externally_control
||
1418 !chargers_externally_control
)
1419 chargers_externally_control
= 0;
1421 dev_info(cm
->dev
, "'%s' regulator's externally_control is %d\n",
1422 charger
->regulator_name
, charger
->externally_control
);
1424 ret
= sysfs_create_group(&cm
->charger_psy
->dev
.kobj
,
1427 dev_err(cm
->dev
, "Cannot create sysfs entry of %s regulator\n",
1428 charger
->regulator_name
);
1434 if (chargers_externally_control
) {
1435 dev_err(cm
->dev
, "Cannot register regulator because charger-manager must need at least one charger for charging battery\n");
1444 static int cm_init_thermal_data(struct charger_manager
*cm
,
1445 struct power_supply
*fuel_gauge
)
1447 struct charger_desc
*desc
= cm
->desc
;
1448 union power_supply_propval val
;
1451 /* Verify whether fuel gauge provides battery temperature */
1452 ret
= power_supply_get_property(fuel_gauge
,
1453 POWER_SUPPLY_PROP_TEMP
, &val
);
1456 cm
->charger_psy_desc
.properties
[cm
->charger_psy_desc
.num_properties
] =
1457 POWER_SUPPLY_PROP_TEMP
;
1458 cm
->charger_psy_desc
.num_properties
++;
1459 cm
->desc
->measure_battery_temp
= true;
1461 #ifdef CONFIG_THERMAL
1462 if (ret
&& desc
->thermal_zone
) {
1464 thermal_zone_get_zone_by_name(desc
->thermal_zone
);
1465 if (IS_ERR(cm
->tzd_batt
))
1466 return PTR_ERR(cm
->tzd_batt
);
1468 /* Use external thermometer */
1469 cm
->charger_psy_desc
.properties
[cm
->charger_psy_desc
.num_properties
] =
1470 POWER_SUPPLY_PROP_TEMP_AMBIENT
;
1471 cm
->charger_psy_desc
.num_properties
++;
1472 cm
->desc
->measure_battery_temp
= true;
1476 if (cm
->desc
->measure_battery_temp
) {
1477 /* NOTICE : Default allowable minimum charge temperature is 0 */
1478 if (!desc
->temp_max
)
1479 desc
->temp_max
= CM_DEFAULT_CHARGE_TEMP_MAX
;
1480 if (!desc
->temp_diff
)
1481 desc
->temp_diff
= CM_DEFAULT_RECHARGE_TEMP_DIFF
;
1487 static const struct of_device_id charger_manager_match
[] = {
1489 .compatible
= "charger-manager",
1494 static struct charger_desc
*of_cm_parse_desc(struct device
*dev
)
1496 struct charger_desc
*desc
;
1497 struct device_node
*np
= dev
->of_node
;
1498 u32 poll_mode
= CM_POLL_DISABLE
;
1499 u32 battery_stat
= CM_NO_BATTERY
;
1502 desc
= devm_kzalloc(dev
, sizeof(*desc
), GFP_KERNEL
);
1504 return ERR_PTR(-ENOMEM
);
1506 of_property_read_string(np
, "cm-name", &desc
->psy_name
);
1508 of_property_read_u32(np
, "cm-poll-mode", &poll_mode
);
1509 desc
->polling_mode
= poll_mode
;
1511 of_property_read_u32(np
, "cm-poll-interval",
1512 &desc
->polling_interval_ms
);
1514 of_property_read_u32(np
, "cm-fullbatt-vchkdrop-ms",
1515 &desc
->fullbatt_vchkdrop_ms
);
1516 of_property_read_u32(np
, "cm-fullbatt-vchkdrop-volt",
1517 &desc
->fullbatt_vchkdrop_uV
);
1518 of_property_read_u32(np
, "cm-fullbatt-voltage", &desc
->fullbatt_uV
);
1519 of_property_read_u32(np
, "cm-fullbatt-soc", &desc
->fullbatt_soc
);
1520 of_property_read_u32(np
, "cm-fullbatt-capacity",
1521 &desc
->fullbatt_full_capacity
);
1523 of_property_read_u32(np
, "cm-battery-stat", &battery_stat
);
1524 desc
->battery_present
= battery_stat
;
1527 of_property_read_u32(np
, "cm-num-chargers", &num_chgs
);
1529 /* Allocate empty bin at the tail of array */
1530 desc
->psy_charger_stat
= devm_kzalloc(dev
, sizeof(char *)
1531 * (num_chgs
+ 1), GFP_KERNEL
);
1532 if (desc
->psy_charger_stat
) {
1534 for (i
= 0; i
< num_chgs
; i
++)
1535 of_property_read_string_index(np
, "cm-chargers",
1536 i
, &desc
->psy_charger_stat
[i
]);
1538 return ERR_PTR(-ENOMEM
);
1542 of_property_read_string(np
, "cm-fuel-gauge", &desc
->psy_fuel_gauge
);
1544 of_property_read_string(np
, "cm-thermal-zone", &desc
->thermal_zone
);
1546 of_property_read_u32(np
, "cm-battery-cold", &desc
->temp_min
);
1547 if (of_get_property(np
, "cm-battery-cold-in-minus", NULL
))
1548 desc
->temp_min
*= -1;
1549 of_property_read_u32(np
, "cm-battery-hot", &desc
->temp_max
);
1550 of_property_read_u32(np
, "cm-battery-temp-diff", &desc
->temp_diff
);
1552 of_property_read_u32(np
, "cm-charging-max",
1553 &desc
->charging_max_duration_ms
);
1554 of_property_read_u32(np
, "cm-discharging-max",
1555 &desc
->discharging_max_duration_ms
);
1557 /* battery charger regualtors */
1558 desc
->num_charger_regulators
= of_get_child_count(np
);
1559 if (desc
->num_charger_regulators
) {
1560 struct charger_regulator
*chg_regs
;
1561 struct device_node
*child
;
1563 chg_regs
= devm_kzalloc(dev
, sizeof(*chg_regs
)
1564 * desc
->num_charger_regulators
,
1567 return ERR_PTR(-ENOMEM
);
1569 desc
->charger_regulators
= chg_regs
;
1571 for_each_child_of_node(np
, child
) {
1572 struct charger_cable
*cables
;
1573 struct device_node
*_child
;
1575 of_property_read_string(child
, "cm-regulator-name",
1576 &chg_regs
->regulator_name
);
1578 /* charger cables */
1579 chg_regs
->num_cables
= of_get_child_count(child
);
1580 if (chg_regs
->num_cables
) {
1581 cables
= devm_kzalloc(dev
, sizeof(*cables
)
1582 * chg_regs
->num_cables
,
1585 return ERR_PTR(-ENOMEM
);
1587 chg_regs
->cables
= cables
;
1589 for_each_child_of_node(child
, _child
) {
1590 of_property_read_string(_child
,
1591 "cm-cable-name", &cables
->name
);
1592 of_property_read_string(_child
,
1594 &cables
->extcon_name
);
1595 of_property_read_u32(_child
,
1598 of_property_read_u32(_child
,
1610 static inline struct charger_desc
*cm_get_drv_data(struct platform_device
*pdev
)
1612 if (pdev
->dev
.of_node
)
1613 return of_cm_parse_desc(&pdev
->dev
);
1614 return dev_get_platdata(&pdev
->dev
);
1617 static enum alarmtimer_restart
cm_timer_func(struct alarm
*alarm
, ktime_t now
)
1619 cm_timer_set
= false;
1620 return ALARMTIMER_NORESTART
;
1623 static int charger_manager_probe(struct platform_device
*pdev
)
1625 struct charger_desc
*desc
= cm_get_drv_data(pdev
);
1626 struct charger_manager
*cm
;
1629 union power_supply_propval val
;
1630 struct power_supply
*fuel_gauge
;
1631 struct power_supply_config psy_cfg
= {};
1634 dev_err(&pdev
->dev
, "No platform data (desc) found\n");
1638 cm
= devm_kzalloc(&pdev
->dev
,
1639 sizeof(struct charger_manager
), GFP_KERNEL
);
1643 /* Basic Values. Unspecified are Null or 0 */
1644 cm
->dev
= &pdev
->dev
;
1646 psy_cfg
.drv_data
= cm
;
1648 /* Initialize alarm timer */
1649 if (alarmtimer_get_rtcdev()) {
1650 cm_timer
= devm_kzalloc(cm
->dev
, sizeof(*cm_timer
), GFP_KERNEL
);
1651 alarm_init(cm_timer
, ALARM_BOOTTIME
, cm_timer_func
);
1655 * The following two do not need to be errors.
1656 * Users may intentionally ignore those two features.
1658 if (desc
->fullbatt_uV
== 0) {
1659 dev_info(&pdev
->dev
, "Ignoring full-battery voltage threshold as it is not supplied\n");
1661 if (!desc
->fullbatt_vchkdrop_ms
|| !desc
->fullbatt_vchkdrop_uV
) {
1662 dev_info(&pdev
->dev
, "Disabling full-battery voltage drop checking mechanism as it is not supplied\n");
1663 desc
->fullbatt_vchkdrop_ms
= 0;
1664 desc
->fullbatt_vchkdrop_uV
= 0;
1666 if (desc
->fullbatt_soc
== 0) {
1667 dev_info(&pdev
->dev
, "Ignoring full-battery soc(state of charge) threshold as it is not supplied\n");
1669 if (desc
->fullbatt_full_capacity
== 0) {
1670 dev_info(&pdev
->dev
, "Ignoring full-battery full capacity threshold as it is not supplied\n");
1673 if (!desc
->charger_regulators
|| desc
->num_charger_regulators
< 1) {
1674 dev_err(&pdev
->dev
, "charger_regulators undefined\n");
1678 if (!desc
->psy_charger_stat
|| !desc
->psy_charger_stat
[0]) {
1679 dev_err(&pdev
->dev
, "No power supply defined\n");
1683 if (!desc
->psy_fuel_gauge
) {
1684 dev_err(&pdev
->dev
, "No fuel gauge power supply defined\n");
1688 /* Counting index only */
1689 while (desc
->psy_charger_stat
[i
])
1692 /* Check if charger's supplies are present at probe */
1693 for (i
= 0; desc
->psy_charger_stat
[i
]; i
++) {
1694 struct power_supply
*psy
;
1696 psy
= power_supply_get_by_name(desc
->psy_charger_stat
[i
]);
1698 dev_err(&pdev
->dev
, "Cannot find power supply \"%s\"\n",
1699 desc
->psy_charger_stat
[i
]);
1702 power_supply_put(psy
);
1705 if (desc
->polling_interval_ms
== 0 ||
1706 msecs_to_jiffies(desc
->polling_interval_ms
) <= CM_JIFFIES_SMALL
) {
1707 dev_err(&pdev
->dev
, "polling_interval_ms is too small\n");
1711 if (!desc
->charging_max_duration_ms
||
1712 !desc
->discharging_max_duration_ms
) {
1713 dev_info(&pdev
->dev
, "Cannot limit charging duration checking mechanism to prevent overcharge/overheat and control discharging duration\n");
1714 desc
->charging_max_duration_ms
= 0;
1715 desc
->discharging_max_duration_ms
= 0;
1718 platform_set_drvdata(pdev
, cm
);
1720 memcpy(&cm
->charger_psy_desc
, &psy_default
, sizeof(psy_default
));
1722 if (!desc
->psy_name
)
1723 strncpy(cm
->psy_name_buf
, psy_default
.name
, PSY_NAME_MAX
);
1725 strncpy(cm
->psy_name_buf
, desc
->psy_name
, PSY_NAME_MAX
);
1726 cm
->charger_psy_desc
.name
= cm
->psy_name_buf
;
1728 /* Allocate for psy properties because they may vary */
1729 cm
->charger_psy_desc
.properties
= devm_kzalloc(&pdev
->dev
,
1730 sizeof(enum power_supply_property
)
1731 * (ARRAY_SIZE(default_charger_props
) +
1732 NUM_CHARGER_PSY_OPTIONAL
), GFP_KERNEL
);
1733 if (!cm
->charger_psy_desc
.properties
)
1736 memcpy(cm
->charger_psy_desc
.properties
, default_charger_props
,
1737 sizeof(enum power_supply_property
) *
1738 ARRAY_SIZE(default_charger_props
));
1739 cm
->charger_psy_desc
.num_properties
= psy_default
.num_properties
;
1741 /* Find which optional psy-properties are available */
1742 fuel_gauge
= power_supply_get_by_name(desc
->psy_fuel_gauge
);
1744 dev_err(&pdev
->dev
, "Cannot find power supply \"%s\"\n",
1745 desc
->psy_fuel_gauge
);
1748 if (!power_supply_get_property(fuel_gauge
,
1749 POWER_SUPPLY_PROP_CHARGE_NOW
, &val
)) {
1750 cm
->charger_psy_desc
.properties
[cm
->charger_psy_desc
.num_properties
] =
1751 POWER_SUPPLY_PROP_CHARGE_NOW
;
1752 cm
->charger_psy_desc
.num_properties
++;
1754 if (!power_supply_get_property(fuel_gauge
,
1755 POWER_SUPPLY_PROP_CURRENT_NOW
,
1757 cm
->charger_psy_desc
.properties
[cm
->charger_psy_desc
.num_properties
] =
1758 POWER_SUPPLY_PROP_CURRENT_NOW
;
1759 cm
->charger_psy_desc
.num_properties
++;
1762 ret
= cm_init_thermal_data(cm
, fuel_gauge
);
1764 dev_err(&pdev
->dev
, "Failed to initialize thermal data\n");
1765 cm
->desc
->measure_battery_temp
= false;
1767 power_supply_put(fuel_gauge
);
1769 INIT_DELAYED_WORK(&cm
->fullbatt_vchk_work
, fullbatt_vchk
);
1771 cm
->charger_psy
= power_supply_register(NULL
, &cm
->charger_psy_desc
,
1773 if (IS_ERR(cm
->charger_psy
)) {
1774 dev_err(&pdev
->dev
, "Cannot register charger-manager with name \"%s\"\n",
1775 cm
->charger_psy_desc
.name
);
1776 return PTR_ERR(cm
->charger_psy
);
1779 /* Register extcon device for charger cable */
1780 ret
= charger_manager_register_extcon(cm
);
1782 dev_err(&pdev
->dev
, "Cannot initialize extcon device\n");
1783 goto err_reg_extcon
;
1786 /* Register sysfs entry for charger(regulator) */
1787 ret
= charger_manager_register_sysfs(cm
);
1790 "Cannot initialize sysfs entry of regulator\n");
1794 /* Add to the list */
1795 mutex_lock(&cm_list_mtx
);
1796 list_add(&cm
->entry
, &cm_list
);
1797 mutex_unlock(&cm_list_mtx
);
1800 * Charger-manager is capable of waking up the systme from sleep
1801 * when event is happend through cm_notify_event()
1803 device_init_wakeup(&pdev
->dev
, true);
1804 device_set_wakeup_capable(&pdev
->dev
, false);
1807 * Charger-manager have to check the charging state right after
1808 * tialization of charger-manager and then update current charging
1813 schedule_work(&setup_polling
);
1818 for (i
= 0; i
< desc
->num_charger_regulators
; i
++) {
1819 struct charger_regulator
*charger
;
1821 charger
= &desc
->charger_regulators
[i
];
1822 sysfs_remove_group(&cm
->charger_psy
->dev
.kobj
,
1826 for (i
= 0; i
< desc
->num_charger_regulators
; i
++) {
1827 struct charger_regulator
*charger
;
1829 charger
= &desc
->charger_regulators
[i
];
1830 for (j
= 0; j
< charger
->num_cables
; j
++) {
1831 struct charger_cable
*cable
= &charger
->cables
[j
];
1832 /* Remove notifier block if only edev exists */
1833 if (cable
->extcon_dev
.edev
)
1834 extcon_unregister_interest(&cable
->extcon_dev
);
1837 regulator_put(desc
->charger_regulators
[i
].consumer
);
1840 power_supply_unregister(cm
->charger_psy
);
1845 static int charger_manager_remove(struct platform_device
*pdev
)
1847 struct charger_manager
*cm
= platform_get_drvdata(pdev
);
1848 struct charger_desc
*desc
= cm
->desc
;
1852 /* Remove from the list */
1853 mutex_lock(&cm_list_mtx
);
1854 list_del(&cm
->entry
);
1855 mutex_unlock(&cm_list_mtx
);
1857 cancel_work_sync(&setup_polling
);
1858 cancel_delayed_work_sync(&cm_monitor_work
);
1860 for (i
= 0 ; i
< desc
->num_charger_regulators
; i
++) {
1861 struct charger_regulator
*charger
1862 = &desc
->charger_regulators
[i
];
1863 for (j
= 0 ; j
< charger
->num_cables
; j
++) {
1864 struct charger_cable
*cable
= &charger
->cables
[j
];
1865 extcon_unregister_interest(&cable
->extcon_dev
);
1869 for (i
= 0 ; i
< desc
->num_charger_regulators
; i
++)
1870 regulator_put(desc
->charger_regulators
[i
].consumer
);
1872 power_supply_unregister(cm
->charger_psy
);
1874 try_charger_enable(cm
, false);
1879 static const struct platform_device_id charger_manager_id
[] = {
1880 { "charger-manager", 0 },
1883 MODULE_DEVICE_TABLE(platform
, charger_manager_id
);
1885 static int cm_suspend_noirq(struct device
*dev
)
1889 if (device_may_wakeup(dev
)) {
1890 device_set_wakeup_capable(dev
, false);
1897 static bool cm_need_to_awake(void)
1899 struct charger_manager
*cm
;
1904 mutex_lock(&cm_list_mtx
);
1905 list_for_each_entry(cm
, &cm_list
, entry
) {
1906 if (is_charging(cm
)) {
1907 mutex_unlock(&cm_list_mtx
);
1911 mutex_unlock(&cm_list_mtx
);
1916 static int cm_suspend_prepare(struct device
*dev
)
1918 struct charger_manager
*cm
= dev_get_drvdata(dev
);
1920 if (cm_need_to_awake())
1924 cm_suspended
= true;
1926 cm_timer_set
= cm_setup_timer();
1929 cancel_work_sync(&setup_polling
);
1930 cancel_delayed_work_sync(&cm_monitor_work
);
1931 cancel_delayed_work(&cm
->fullbatt_vchk_work
);
1937 static void cm_suspend_complete(struct device
*dev
)
1939 struct charger_manager
*cm
= dev_get_drvdata(dev
);
1942 cm_suspended
= false;
1947 alarm_cancel(cm_timer
);
1948 cm_timer_set
= false;
1949 remain
= alarm_expires_remaining(cm_timer
);
1950 cm_suspend_duration_ms
-= ktime_to_ms(remain
);
1951 schedule_work(&setup_polling
);
1956 /* Re-enqueue delayed work (fullbatt_vchk_work) */
1957 if (cm
->fullbatt_vchk_jiffies_at
) {
1958 unsigned long delay
= 0;
1959 unsigned long now
= jiffies
+ CM_JIFFIES_SMALL
;
1961 if (time_after_eq(now
, cm
->fullbatt_vchk_jiffies_at
)) {
1962 delay
= (unsigned long)((long)now
1963 - (long)(cm
->fullbatt_vchk_jiffies_at
));
1964 delay
= jiffies_to_msecs(delay
);
1970 * Account for cm_suspend_duration_ms with assuming that
1971 * timer stops in suspend.
1973 if (delay
> cm_suspend_duration_ms
)
1974 delay
-= cm_suspend_duration_ms
;
1978 queue_delayed_work(cm_wq
, &cm
->fullbatt_vchk_work
,
1979 msecs_to_jiffies(delay
));
1981 device_set_wakeup_capable(cm
->dev
, false);
1984 static const struct dev_pm_ops charger_manager_pm
= {
1985 .prepare
= cm_suspend_prepare
,
1986 .suspend_noirq
= cm_suspend_noirq
,
1987 .complete
= cm_suspend_complete
,
1990 static struct platform_driver charger_manager_driver
= {
1992 .name
= "charger-manager",
1993 .pm
= &charger_manager_pm
,
1994 .of_match_table
= charger_manager_match
,
1996 .probe
= charger_manager_probe
,
1997 .remove
= charger_manager_remove
,
1998 .id_table
= charger_manager_id
,
2001 static int __init
charger_manager_init(void)
2003 cm_wq
= create_freezable_workqueue("charger_manager");
2004 INIT_DELAYED_WORK(&cm_monitor_work
, cm_monitor_poller
);
2006 return platform_driver_register(&charger_manager_driver
);
2008 late_initcall(charger_manager_init
);
2010 static void __exit
charger_manager_cleanup(void)
2012 destroy_workqueue(cm_wq
);
2015 platform_driver_unregister(&charger_manager_driver
);
2017 module_exit(charger_manager_cleanup
);
2020 * find_power_supply - find the associated power_supply of charger
2021 * @cm: the Charger Manager representing the battery
2022 * @psy: pointer to instance of charger's power_supply
2024 static bool find_power_supply(struct charger_manager
*cm
,
2025 struct power_supply
*psy
)
2030 for (i
= 0; cm
->desc
->psy_charger_stat
[i
]; i
++) {
2031 if (!strcmp(psy
->desc
->name
, cm
->desc
->psy_charger_stat
[i
])) {
2041 * cm_notify_event - charger driver notify Charger Manager of charger event
2042 * @psy: pointer to instance of charger's power_supply
2043 * @type: type of charger event
2044 * @msg: optional message passed to uevent_notify fuction
2046 void cm_notify_event(struct power_supply
*psy
, enum cm_event_types type
,
2049 struct charger_manager
*cm
;
2050 bool found_power_supply
= false;
2055 mutex_lock(&cm_list_mtx
);
2056 list_for_each_entry(cm
, &cm_list
, entry
) {
2057 found_power_supply
= find_power_supply(cm
, psy
);
2058 if (found_power_supply
)
2061 mutex_unlock(&cm_list_mtx
);
2063 if (!found_power_supply
)
2067 case CM_EVENT_BATT_FULL
:
2068 fullbatt_handler(cm
);
2070 case CM_EVENT_BATT_OUT
:
2071 battout_handler(cm
);
2073 case CM_EVENT_BATT_IN
:
2074 case CM_EVENT_EXT_PWR_IN_OUT
... CM_EVENT_CHG_START_STOP
:
2075 misc_event_handler(cm
, type
);
2077 case CM_EVENT_UNKNOWN
:
2078 case CM_EVENT_OTHERS
:
2079 uevent_notify(cm
, msg
? msg
: default_event_names
[type
]);
2082 dev_err(cm
->dev
, "%s: type not specified\n", __func__
);
2086 EXPORT_SYMBOL_GPL(cm_notify_event
);
2088 MODULE_AUTHOR("MyungJoo Ham <myungjoo.ham@samsung.com>");
2089 MODULE_DESCRIPTION("Charger Manager");
2090 MODULE_LICENSE("GPL");