1/*
2 * Copyright (C) 2011 Samsung Electronics Co., Ltd.
3 * MyungJoo Ham <myungjoo.ham@samsung.com>
4 *
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.
9 *
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.
13**/
14
15#define pr_fmt(fmt) KBUILD_MODNAME ": " fmt
16
17#include <linux/io.h>
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>
28#include <linux/of.h>
29#include <linux/thermal.h>
30
31/*
32 * Default termperature threshold for charging.
33 * Every temperature units are in tenth of centigrade.
34 */
35#define CM_DEFAULT_RECHARGE_TEMP_DIFF	50
36#define CM_DEFAULT_CHARGE_TEMP_MAX	500
37
38static 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"
48};
49
50/*
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
53 * without any delays.
54 */
55#define	CM_JIFFIES_SMALL	(2)
56
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))
59
60/*
61 * Regard CM_RTC_SMALL (sec) is small enough to ignore error in invoking
62 * rtc alarm. It should be 2 or larger
63 */
64#define CM_RTC_SMALL		(2)
65
66#define UEVENT_BUF_SIZE		32
67
68static LIST_HEAD(cm_list);
69static DEFINE_MUTEX(cm_list_mtx);
70
71/* About in-suspend (suspend-again) monitoring */
72static struct alarm *cm_timer;
73
74static bool cm_suspended;
75static bool cm_timer_set;
76static unsigned long cm_suspend_duration_ms;
77
78/* About normal (not suspended) monitoring */
79static unsigned long polling_jiffy = ULONG_MAX; /* ULONG_MAX: no polling */
80static unsigned long next_polling; /* Next appointed polling time */
81static struct workqueue_struct *cm_wq; /* init at driver add */
82static struct delayed_work cm_monitor_work; /* init at driver add */
83
84/**
85 * is_batt_present - See if the battery presents in place.
86 * @cm: the Charger Manager representing the battery.
87 */
88static bool is_batt_present(struct charger_manager *cm)
89{
90	union power_supply_propval val;
91	struct power_supply *psy;
92	bool present = false;
93	int i, ret;
94
95	switch (cm->desc->battery_present) {
96	case CM_BATTERY_PRESENT:
97		present = true;
98		break;
99	case CM_NO_BATTERY:
100		break;
101	case CM_FUEL_GAUGE:
102		psy = power_supply_get_by_name(cm->desc->psy_fuel_gauge);
103		if (!psy)
104			break;
105
106		ret = power_supply_get_property(psy, POWER_SUPPLY_PROP_PRESENT,
107				&val);
108		if (ret == 0 && val.intval)
109			present = true;
110		power_supply_put(psy);
111		break;
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]);
116			if (!psy) {
117				dev_err(cm->dev, "Cannot find power supply \"%s\"\n",
118					cm->desc->psy_charger_stat[i]);
119				continue;
120			}
121
122			ret = power_supply_get_property(psy,
123				POWER_SUPPLY_PROP_PRESENT, &val);
124			power_supply_put(psy);
125			if (ret == 0 && val.intval) {
126				present = true;
127				break;
128			}
129		}
130		break;
131	}
132
133	return present;
134}
135
136/**
137 * is_ext_pwr_online - See if an external power source is attached to charge
138 * @cm: the Charger Manager representing the battery.
139 *
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.
143 */
144static bool is_ext_pwr_online(struct charger_manager *cm)
145{
146	union power_supply_propval val;
147	struct power_supply *psy;
148	bool online = false;
149	int i, ret;
150
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]);
154		if (!psy) {
155			dev_err(cm->dev, "Cannot find power supply \"%s\"\n",
156					cm->desc->psy_charger_stat[i]);
157			continue;
158		}
159
160		ret = power_supply_get_property(psy, POWER_SUPPLY_PROP_ONLINE,
161				&val);
162		power_supply_put(psy);
163		if (ret == 0 && val.intval) {
164			online = true;
165			break;
166		}
167	}
168
169	return online;
170}
171
172/**
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.
176 *
177 * Returns 0 if there is no error.
178 * Returns a negative value on error.
179 */
180static int get_batt_uV(struct charger_manager *cm, int *uV)
181{
182	union power_supply_propval val;
183	struct power_supply *fuel_gauge;
184	int ret;
185
186	fuel_gauge = power_supply_get_by_name(cm->desc->psy_fuel_gauge);
187	if (!fuel_gauge)
188		return -ENODEV;
189
190	ret = power_supply_get_property(fuel_gauge,
191				POWER_SUPPLY_PROP_VOLTAGE_NOW, &val);
192	power_supply_put(fuel_gauge);
193	if (ret)
194		return ret;
195
196	*uV = val.intval;
197	return 0;
198}
199
200/**
201 * is_charging - Returns true if the battery is being charged.
202 * @cm: the Charger Manager representing the battery.
203 */
204static bool is_charging(struct charger_manager *cm)
205{
206	int i, ret;
207	bool charging = false;
208	struct power_supply *psy;
209	union power_supply_propval val;
210
211	/* If there is no battery, it cannot be charged */
212	if (!is_batt_present(cm))
213		return false;
214
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)
219			continue;
220		if (!cm->charger_enabled)
221			continue;
222
223		psy = power_supply_get_by_name(cm->desc->psy_charger_stat[i]);
224		if (!psy) {
225			dev_err(cm->dev, "Cannot find power supply \"%s\"\n",
226					cm->desc->psy_charger_stat[i]);
227			continue;
228		}
229
230		/* 2. The charger should be online (ext-power) */
231		ret = power_supply_get_property(psy, POWER_SUPPLY_PROP_ONLINE,
232				&val);
233		if (ret) {
234			dev_warn(cm->dev, "Cannot read ONLINE value from %s\n",
235				 cm->desc->psy_charger_stat[i]);
236			power_supply_put(psy);
237			continue;
238		}
239		if (val.intval == 0) {
240			power_supply_put(psy);
241			continue;
242		}
243
244		/*
245		 * 3. The charger should not be FULL, DISCHARGING,
246		 * or NOT_CHARGING.
247		 */
248		ret = power_supply_get_property(psy, POWER_SUPPLY_PROP_STATUS,
249				&val);
250		power_supply_put(psy);
251		if (ret) {
252			dev_warn(cm->dev, "Cannot read STATUS value from %s\n",
253				 cm->desc->psy_charger_stat[i]);
254			continue;
255		}
256		if (val.intval == POWER_SUPPLY_STATUS_FULL ||
257				val.intval == POWER_SUPPLY_STATUS_DISCHARGING ||
258				val.intval == POWER_SUPPLY_STATUS_NOT_CHARGING)
259			continue;
260
261		/* Then, this is charging. */
262		charging = true;
263		break;
264	}
265
266	return charging;
267}
268
269/**
270 * is_full_charged - Returns true if the battery is fully charged.
271 * @cm: the Charger Manager representing the battery.
272 */
273static bool is_full_charged(struct charger_manager *cm)
274{
275	struct charger_desc *desc = cm->desc;
276	union power_supply_propval val;
277	struct power_supply *fuel_gauge;
278	bool is_full = false;
279	int ret = 0;
280	int uV;
281
282	/* If there is no battery, it cannot be charged */
283	if (!is_batt_present(cm))
284		return false;
285
286	fuel_gauge = power_supply_get_by_name(cm->desc->psy_fuel_gauge);
287	if (!fuel_gauge)
288		return false;
289
290	if (desc->fullbatt_full_capacity > 0) {
291		val.intval = 0;
292
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) {
297			is_full = true;
298			goto out;
299		}
300	}
301
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) {
306			is_full = true;
307			goto out;
308		}
309	}
310
311	/* Full, if the capacity is more than fullbatt_soc */
312	if (desc->fullbatt_soc > 0) {
313		val.intval = 0;
314
315		ret = power_supply_get_property(fuel_gauge,
316				POWER_SUPPLY_PROP_CAPACITY, &val);
317		if (!ret && val.intval >= desc->fullbatt_soc) {
318			is_full = true;
319			goto out;
320		}
321	}
322
323out:
324	power_supply_put(fuel_gauge);
325	return is_full;
326}
327
328/**
329 * is_polling_required - Return true if need to continue polling for this CM.
330 * @cm: the Charger Manager representing the battery.
331 */
332static bool is_polling_required(struct charger_manager *cm)
333{
334	switch (cm->desc->polling_mode) {
335	case CM_POLL_DISABLE:
336		return false;
337	case CM_POLL_ALWAYS:
338		return true;
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);
343	default:
344		dev_warn(cm->dev, "Incorrect polling_mode (%d)\n",
345			 cm->desc->polling_mode);
346	}
347
348	return false;
349}
350
351/**
352 * try_charger_enable - Enable/Disable chargers altogether
353 * @cm: the Charger Manager representing the battery.
354 * @enable: true: enable / false: disable
355 *
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.
360 */
361static int try_charger_enable(struct charger_manager *cm, bool enable)
362{
363	int err = 0, i;
364	struct charger_desc *desc = cm->desc;
365
366	/* Ignore if it's redundent command */
367	if (enable == cm->charger_enabled)
368		return 0;
369
370	if (enable) {
371		if (cm->emergency_stop)
372			return -EAGAIN;
373
374		/*
375		 * Save start time of charging to limit
376		 * maximum possible charging time.
377		 */
378		cm->charging_start_time = ktime_to_ms(ktime_get());
379		cm->charging_end_time = 0;
380
381		for (i = 0 ; i < desc->num_charger_regulators ; i++) {
382			if (desc->charger_regulators[i].externally_control)
383				continue;
384
385			err = regulator_enable(desc->charger_regulators[i].consumer);
386			if (err < 0) {
387				dev_warn(cm->dev, "Cannot enable %s regulator\n",
388					 desc->charger_regulators[i].regulator_name);
389			}
390		}
391	} else {
392		/*
393		 * Save end time of charging to maintain fully charged state
394		 * of battery after full-batt.
395		 */
396		cm->charging_start_time = 0;
397		cm->charging_end_time = ktime_to_ms(ktime_get());
398
399		for (i = 0 ; i < desc->num_charger_regulators ; i++) {
400			if (desc->charger_regulators[i].externally_control)
401				continue;
402
403			err = regulator_disable(desc->charger_regulators[i].consumer);
404			if (err < 0) {
405				dev_warn(cm->dev, "Cannot disable %s regulator\n",
406					 desc->charger_regulators[i].regulator_name);
407			}
408		}
409
410		/*
411		 * Abnormal battery state - Stop charging forcibly,
412		 * even if charger was enabled at the other places
413		 */
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);
421			}
422		}
423	}
424
425	if (!err)
426		cm->charger_enabled = enable;
427
428	return err;
429}
430
431/**
432 * try_charger_restart - Restart charging.
433 * @cm: the Charger Manager representing the battery.
434 *
435 * Restart charging by turning off and on the charger.
436 */
437static int try_charger_restart(struct charger_manager *cm)
438{
439	int err;
440
441	if (cm->emergency_stop)
442		return -EAGAIN;
443
444	err = try_charger_enable(cm, false);
445	if (err)
446		return err;
447
448	return try_charger_enable(cm, true);
449}
450
451/**
452 * uevent_notify - Let users know something has changed.
453 * @cm: the Charger Manager representing the battery.
454 * @event: the event string.
455 *
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.
462 */
463static void uevent_notify(struct charger_manager *cm, const char *event)
464{
465	static char env_str[UEVENT_BUF_SIZE + 1] = "";
466	static char env_str_save[UEVENT_BUF_SIZE + 1] = "";
467
468	if (cm_suspended) {
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);
474			return;
475		}
476
477		if (!strncmp(env_str_save, event, UEVENT_BUF_SIZE))
478			return; /* Duplicated. */
479		strncpy(env_str_save, event, UEVENT_BUF_SIZE);
480		return;
481	}
482
483	if (event == NULL) {
484		/* No messages pending */
485		if (!env_str_save[0])
486			return;
487
488		strncpy(env_str, env_str_save, UEVENT_BUF_SIZE);
489		kobject_uevent(&cm->dev->kobj, KOBJ_CHANGE);
490		env_str_save[0] = 0;
491
492		return;
493	}
494
495	/* status not changed */
496	if (!strncmp(env_str, event, UEVENT_BUF_SIZE))
497		return;
498
499	/* save the status and notify the update */
500	strncpy(env_str, event, UEVENT_BUF_SIZE);
501	kobject_uevent(&cm->dev->kobj, KOBJ_CHANGE);
502
503	dev_info(cm->dev, "%s\n", event);
504}
505
506/**
507 * fullbatt_vchk - Check voltage drop some times after "FULL" event.
508 * @work: the work_struct appointing the function
509 *
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.
514 */
515static void fullbatt_vchk(struct work_struct *work)
516{
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;
522
523	/* remove the appointment for fullbatt_vchk */
524	cm->fullbatt_vchk_jiffies_at = 0;
525
526	if (!desc->fullbatt_vchkdrop_uV || !desc->fullbatt_vchkdrop_ms)
527		return;
528
529	err = get_batt_uV(cm, &batt_uV);
530	if (err) {
531		dev_err(cm->dev, "%s: get_batt_uV error(%d)\n", __func__, err);
532		return;
533	}
534
535	diff = desc->fullbatt_uV - batt_uV;
536	if (diff < 0)
537		return;
538
539	dev_info(cm->dev, "VBATT dropped %duV after full-batt\n", diff);
540
541	if (diff > desc->fullbatt_vchkdrop_uV) {
542		try_charger_restart(cm);
543		uevent_notify(cm, "Recharging");
544	}
545}
546
547/**
548 * check_charging_duration - Monitor charging/discharging duration
549 * @cm: the Charger Manager representing the battery.
550 *
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.
556 */
557static int check_charging_duration(struct charger_manager *cm)
558{
559	struct charger_desc *desc = cm->desc;
560	u64 curr = ktime_to_ms(ktime_get());
561	u64 duration;
562	int ret = false;
563
564	if (!desc->charging_max_duration_ms &&
565			!desc->discharging_max_duration_ms)
566		return ret;
567
568	if (cm->charger_enabled) {
569		duration = curr - cm->charging_start_time;
570
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);
576			ret = true;
577		}
578	} else if (is_ext_pwr_online(cm) && !cm->charger_enabled) {
579		duration = curr - cm->charging_end_time;
580
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);
587			ret = true;
588		}
589	}
590
591	return ret;
592}
593
594static int cm_get_battery_temperature_by_psy(struct charger_manager *cm,
595					int *temp)
596{
597	struct power_supply *fuel_gauge;
598	int ret;
599
600	fuel_gauge = power_supply_get_by_name(cm->desc->psy_fuel_gauge);
601	if (!fuel_gauge)
602		return -ENODEV;
603
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);
608
609	return ret;
610}
611
612static int cm_get_battery_temperature(struct charger_manager *cm,
613					int *temp)
614{
615	int ret;
616
617	if (!cm->desc->measure_battery_temp)
618		return -ENODEV;
619
620#ifdef CONFIG_THERMAL
621	if (cm->tzd_batt) {
622		ret = thermal_zone_get_temp(cm->tzd_batt, temp);
623		if (!ret)
624			/* Calibrate temperature unit */
625			*temp /= 100;
626	} else
627#endif
628	{
629		/* if-else continued from CONFIG_THERMAL */
630		ret = cm_get_battery_temperature_by_psy(cm, temp);
631	}
632
633	return ret;
634}
635
636static int cm_check_thermal_status(struct charger_manager *cm)
637{
638	struct charger_desc *desc = cm->desc;
639	int temp, upper_limit, lower_limit;
640	int ret = 0;
641
642	ret = cm_get_battery_temperature(cm, &temp);
643	if (ret) {
644		/* FIXME:
645		 * No information of battery temperature might
646		 * occur hazadous result. We have to handle it
647		 * depending on battery type.
648		 */
649		dev_err(cm->dev, "Failed to get battery temperature\n");
650		return 0;
651	}
652
653	upper_limit = desc->temp_max;
654	lower_limit = desc->temp_min;
655
656	if (cm->emergency_stop) {
657		upper_limit -= desc->temp_diff;
658		lower_limit += desc->temp_diff;
659	}
660
661	if (temp > upper_limit)
662		ret = CM_EVENT_BATT_OVERHEAT;
663	else if (temp < lower_limit)
664		ret = CM_EVENT_BATT_COLD;
665
666	return ret;
667}
668
669/**
670 * _cm_monitor - Monitor the temperature and return true for exceptions.
671 * @cm: the Charger Manager representing the battery.
672 *
673 * Returns true if there is an event to notify for the battery.
674 * (True if the status of "emergency_stop" changes)
675 */
676static bool _cm_monitor(struct charger_manager *cm)
677{
678	int temp_alrt;
679
680	temp_alrt = cm_check_thermal_status(cm);
681
682	/* It has been stopped already */
683	if (temp_alrt && cm->emergency_stop)
684		return false;
685
686	/*
687	 * Check temperature whether overheat or cold.
688	 * If temperature is out of range normal state, stop charging.
689	 */
690	if (temp_alrt) {
691		cm->emergency_stop = temp_alrt;
692		if (!try_charger_enable(cm, false))
693			uevent_notify(cm, default_event_names[temp_alrt]);
694
695	/*
696	 * Check whole charging duration and discharing duration
697	 * after full-batt.
698	 */
699	} else if (!cm->emergency_stop && check_charging_duration(cm)) {
700		dev_dbg(cm->dev,
701			"Charging/Discharging duration is out of range\n");
702	/*
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.
706	 */
707	} else if (!cm->emergency_stop && is_ext_pwr_online(cm) &&
708			!cm->charger_enabled) {
709		fullbatt_vchk(&cm->fullbatt_vchk_work.work);
710
711	/*
712	 * Check whether fully charged state to protect overcharge
713	 * if charger-manager is charging for battery.
714	 */
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]);
719
720		try_charger_enable(cm, false);
721
722		fullbatt_vchk(&cm->fullbatt_vchk_work.work);
723	} else {
724		cm->emergency_stop = 0;
725		if (is_ext_pwr_online(cm)) {
726			if (!try_charger_enable(cm, true))
727				uevent_notify(cm, "CHARGING");
728		}
729	}
730
731	return true;
732}
733
734/**
735 * cm_monitor - Monitor every battery.
736 *
737 * Returns true if there is an event to notify from any of the batteries.
738 * (True if the status of "emergency_stop" changes)
739 */
740static bool cm_monitor(void)
741{
742	bool stop = false;
743	struct charger_manager *cm;
744
745	mutex_lock(&cm_list_mtx);
746
747	list_for_each_entry(cm, &cm_list, entry) {
748		if (_cm_monitor(cm))
749			stop = true;
750	}
751
752	mutex_unlock(&cm_list_mtx);
753
754	return stop;
755}
756
757/**
758 * _setup_polling - Setup the next instance of polling.
759 * @work: work_struct of the function _setup_polling.
760 */
761static void _setup_polling(struct work_struct *work)
762{
763	unsigned long min = ULONG_MAX;
764	struct charger_manager *cm;
765	bool keep_polling = false;
766	unsigned long _next_polling;
767
768	mutex_lock(&cm_list_mtx);
769
770	list_for_each_entry(cm, &cm_list, entry) {
771		if (is_polling_required(cm) && cm->desc->polling_interval_ms) {
772			keep_polling = true;
773
774			if (min > cm->desc->polling_interval_ms)
775				min = cm->desc->polling_interval_ms;
776		}
777	}
778
779	polling_jiffy = msecs_to_jiffies(min);
780	if (polling_jiffy <= CM_JIFFIES_SMALL)
781		polling_jiffy = CM_JIFFIES_SMALL + 1;
782
783	if (!keep_polling)
784		polling_jiffy = ULONG_MAX;
785	if (polling_jiffy == ULONG_MAX)
786		goto out;
787
788	WARN(cm_wq == NULL, "charger-manager: workqueue not initialized"
789			    ". try it later. %s\n", __func__);
790
791	/*
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.
796	 */
797	_next_polling = jiffies + polling_jiffy;
798
799	if (time_before(_next_polling, next_polling)) {
800		mod_delayed_work(cm_wq, &cm_monitor_work, polling_jiffy);
801		next_polling = _next_polling;
802	} else {
803		if (queue_delayed_work(cm_wq, &cm_monitor_work, polling_jiffy))
804			next_polling = _next_polling;
805	}
806out:
807	mutex_unlock(&cm_list_mtx);
808}
809static DECLARE_WORK(setup_polling, _setup_polling);
810
811/**
812 * cm_monitor_poller - The Monitor / Poller.
813 * @work: work_struct of the function cm_monitor_poller
814 *
815 * During non-suspended state, cm_monitor_poller is used to poll and monitor
816 * the batteries.
817 */
818static void cm_monitor_poller(struct work_struct *work)
819{
820	cm_monitor();
821	schedule_work(&setup_polling);
822}
823
824/**
825 * fullbatt_handler - Event handler for CM_EVENT_BATT_FULL
826 * @cm: the Charger Manager representing the battery.
827 */
828static void fullbatt_handler(struct charger_manager *cm)
829{
830	struct charger_desc *desc = cm->desc;
831
832	if (!desc->fullbatt_vchkdrop_uV || !desc->fullbatt_vchkdrop_ms)
833		goto out;
834
835	if (cm_suspended)
836		device_set_wakeup_capable(cm->dev, true);
837
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);
842
843	if (cm->fullbatt_vchk_jiffies_at == 0)
844		cm->fullbatt_vchk_jiffies_at = 1;
845
846out:
847	dev_info(cm->dev, "EVENT_HANDLE: Battery Fully Charged\n");
848	uevent_notify(cm, default_event_names[CM_EVENT_BATT_FULL]);
849}
850
851/**
852 * battout_handler - Event handler for CM_EVENT_BATT_OUT
853 * @cm: the Charger Manager representing the battery.
854 */
855static void battout_handler(struct charger_manager *cm)
856{
857	if (cm_suspended)
858		device_set_wakeup_capable(cm->dev, true);
859
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]);
863	} else {
864		uevent_notify(cm, "Battery Reinserted?");
865	}
866}
867
868/**
869 * misc_event_handler - Handler for other evnets
870 * @cm: the Charger Manager representing the battery.
871 * @type: the Charger Manager representing the battery.
872 */
873static void misc_event_handler(struct charger_manager *cm,
874			enum cm_event_types type)
875{
876	if (cm_suspended)
877		device_set_wakeup_capable(cm->dev, true);
878
879	if (is_polling_required(cm) && cm->desc->polling_interval_ms)
880		schedule_work(&setup_polling);
881	uevent_notify(cm, default_event_names[type]);
882}
883
884static int charger_get_property(struct power_supply *psy,
885		enum power_supply_property psp,
886		union power_supply_propval *val)
887{
888	struct charger_manager *cm = power_supply_get_drvdata(psy);
889	struct charger_desc *desc = cm->desc;
890	struct power_supply *fuel_gauge = NULL;
891	int ret = 0;
892	int uV;
893
894	switch (psp) {
895	case POWER_SUPPLY_PROP_STATUS:
896		if (is_charging(cm))
897			val->intval = POWER_SUPPLY_STATUS_CHARGING;
898		else if (is_ext_pwr_online(cm))
899			val->intval = POWER_SUPPLY_STATUS_NOT_CHARGING;
900		else
901			val->intval = POWER_SUPPLY_STATUS_DISCHARGING;
902		break;
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;
908		else
909			val->intval = POWER_SUPPLY_HEALTH_GOOD;
910		break;
911	case POWER_SUPPLY_PROP_PRESENT:
912		if (is_batt_present(cm))
913			val->intval = 1;
914		else
915			val->intval = 0;
916		break;
917	case POWER_SUPPLY_PROP_VOLTAGE_NOW:
918		ret = get_batt_uV(cm, &val->intval);
919		break;
920	case POWER_SUPPLY_PROP_CURRENT_NOW:
921		fuel_gauge = power_supply_get_by_name(cm->desc->psy_fuel_gauge);
922		if (!fuel_gauge) {
923			ret = -ENODEV;
924			break;
925		}
926		ret = power_supply_get_property(fuel_gauge,
927				POWER_SUPPLY_PROP_CURRENT_NOW, val);
928		break;
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% */
935			val->intval = 100;
936			break;
937		}
938
939		fuel_gauge = power_supply_get_by_name(cm->desc->psy_fuel_gauge);
940		if (!fuel_gauge) {
941			ret = -ENODEV;
942			break;
943		}
944
945		ret = power_supply_get_property(fuel_gauge,
946					POWER_SUPPLY_PROP_CAPACITY, val);
947		if (ret)
948			break;
949
950		if (val->intval > 100) {
951			val->intval = 100;
952			break;
953		}
954		if (val->intval < 0)
955			val->intval = 0;
956
957		/* Do not adjust SOC when charging: voltage is overrated */
958		if (is_charging(cm))
959			break;
960
961		/*
962		 * If the capacity value is inconsistent, calibrate it base on
963		 * the battery voltage values and the thresholds given as desc
964		 */
965		ret = get_batt_uV(cm, &uV);
966		if (ret) {
967			/* Voltage information not available. No calibration */
968			ret = 0;
969			break;
970		}
971
972		if (desc->fullbatt_uV > 0 && uV >= desc->fullbatt_uV &&
973		    !is_charging(cm)) {
974			val->intval = 100;
975			break;
976		}
977
978		break;
979	case POWER_SUPPLY_PROP_ONLINE:
980		if (is_ext_pwr_online(cm))
981			val->intval = 1;
982		else
983			val->intval = 0;
984		break;
985	case POWER_SUPPLY_PROP_CHARGE_FULL:
986		if (is_full_charged(cm))
987			val->intval = 1;
988		else
989			val->intval = 0;
990		ret = 0;
991		break;
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);
996			if (!fuel_gauge) {
997				ret = -ENODEV;
998				break;
999			}
1000
1001			ret = power_supply_get_property(fuel_gauge,
1002						POWER_SUPPLY_PROP_CHARGE_NOW,
1003						val);
1004			if (ret) {
1005				val->intval = 1;
1006				ret = 0;
1007			} else {
1008				/* If CHARGE_NOW is supplied, use it */
1009				val->intval = (val->intval > 0) ?
1010						val->intval : 1;
1011			}
1012		} else {
1013			val->intval = 0;
1014		}
1015		break;
1016	default:
1017		return -EINVAL;
1018	}
1019	if (fuel_gauge)
1020		power_supply_put(fuel_gauge);
1021	return ret;
1022}
1023
1024#define NUM_CHARGER_PSY_OPTIONAL	(4)
1025static 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,
1034	/*
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,
1040	 */
1041};
1042
1043static const struct power_supply_desc psy_default = {
1044	.name = "battery",
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,
1049	.no_thermal = true,
1050};
1051
1052/**
1053 * cm_setup_timer - For in-suspend monitoring setup wakeup alarm
1054 *		    for suspend_again.
1055 *
1056 * Returns true if the alarm is set for Charger Manager to use.
1057 * Returns false if
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.
1061 */
1062static bool cm_setup_timer(void)
1063{
1064	struct charger_manager *cm;
1065	unsigned int wakeup_ms = UINT_MAX;
1066	int timer_req = 0;
1067
1068	if (time_after(next_polling, jiffies))
1069		CM_MIN_VALID(wakeup_ms,
1070			jiffies_to_msecs(next_polling - jiffies));
1071
1072	mutex_lock(&cm_list_mtx);
1073	list_for_each_entry(cm, &cm_list, entry) {
1074		unsigned int fbchk_ms = 0;
1075
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
1079						    - jiffies);
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);
1084				fbchk_ms = 0;
1085			}
1086		}
1087		CM_MIN_VALID(wakeup_ms, fbchk_ms);
1088
1089		/* Skip if polling is not required for this CM */
1090		if (!is_polling_required(cm) && !cm->emergency_stop)
1091			continue;
1092		timer_req++;
1093		if (cm->desc->polling_interval_ms == 0)
1094			continue;
1095		CM_MIN_VALID(wakeup_ms, cm->desc->polling_interval_ms);
1096	}
1097	mutex_unlock(&cm_list_mtx);
1098
1099	if (timer_req && cm_timer) {
1100		ktime_t now, add;
1101
1102		/*
1103		 * Set alarm with the polling interval (wakeup_ms)
1104		 * The alarm time should be NOW + CM_RTC_SMALL or later.
1105		 */
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;
1109
1110		pr_info("Charger Manager wakeup timer: %u ms\n", wakeup_ms);
1111
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));
1116
1117		cm_suspend_duration_ms = wakeup_ms;
1118
1119		return true;
1120	}
1121	return false;
1122}
1123
1124/**
1125 * charger_extcon_work - enable/diable charger according to the state
1126 *			of charger cable
1127 *
1128 * @work: work_struct of the function charger_extcon_work.
1129 */
1130static void charger_extcon_work(struct work_struct *work)
1131{
1132	struct charger_cable *cable =
1133			container_of(work, struct charger_cable, wq);
1134	int ret;
1135
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);
1139		if (ret < 0) {
1140			pr_err("Cannot set current limit of %s (%s)\n",
1141			       cable->charger->regulator_name, cable->name);
1142			return;
1143		}
1144
1145		pr_info("Set current limit of %s : %duA ~ %duA\n",
1146			cable->charger->regulator_name,
1147			cable->min_uA, cable->max_uA);
1148	}
1149
1150	try_charger_enable(cable->cm, cable->attached);
1151}
1152
1153/**
1154 * charger_extcon_notifier - receive the state of charger cable
1155 *			when registered cable is attached or detached.
1156 *
1157 * @self: the notifier block of the charger_extcon_notifier.
1158 * @event: the cable state.
1159 * @ptr: the data pointer of notifier block.
1160 */
1161static int charger_extcon_notifier(struct notifier_block *self,
1162			unsigned long event, void *ptr)
1163{
1164	struct charger_cable *cable =
1165		container_of(self, struct charger_cable, nb);
1166
1167	/*
1168	 * The newly state of charger cable.
1169	 * If cable is attached, cable->attached is true.
1170	 */
1171	cable->attached = event;
1172
1173	/*
1174	 * Setup monitoring to check battery state
1175	 * when charger cable is attached.
1176	 */
1177	if (cable->attached && is_polling_required(cable->cm)) {
1178		cancel_work_sync(&setup_polling);
1179		schedule_work(&setup_polling);
1180	}
1181
1182	/*
1183	 * Setup work for controlling charger(regulator)
1184	 * according to charger cable.
1185	 */
1186	schedule_work(&cable->wq);
1187
1188	return NOTIFY_DONE;
1189}
1190
1191/**
1192 * charger_extcon_init - register external connector to use it
1193 *			as the charger cable
1194 *
1195 * @cm: the Charger Manager representing the battery.
1196 * @cable: the Charger cable representing the external connector.
1197 */
1198static int charger_extcon_init(struct charger_manager *cm,
1199		struct charger_cable *cable)
1200{
1201	int ret = 0;
1202
1203	/*
1204	 * Charger manager use Extcon framework to identify
1205	 * the charger cable among various external connector
1206	 * cable (e.g., TA, USB, MHL, Dock).
1207	 */
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);
1212	if (ret < 0) {
1213		pr_info("Cannot register extcon_dev for %s(cable: %s)\n",
1214			cable->extcon_name, cable->name);
1215		ret = -EINVAL;
1216	}
1217
1218	return ret;
1219}
1220
1221/**
1222 * charger_manager_register_extcon - Register extcon device to recevie state
1223 *				     of charger cable.
1224 * @cm: the Charger Manager representing the battery.
1225 *
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.
1230 */
1231static int charger_manager_register_extcon(struct charger_manager *cm)
1232{
1233	struct charger_desc *desc = cm->desc;
1234	struct charger_regulator *charger;
1235	int ret = 0;
1236	int i;
1237	int j;
1238
1239	for (i = 0; i < desc->num_charger_regulators; i++) {
1240		charger = &desc->charger_regulators[i];
1241
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);
1248		}
1249		charger->cm = cm;
1250
1251		for (j = 0; j < charger->num_cables; j++) {
1252			struct charger_cable *cable = &charger->cables[j];
1253
1254			ret = charger_extcon_init(cm, cable);
1255			if (ret < 0) {
1256				dev_err(cm->dev, "Cannot initialize charger(%s)\n",
1257					charger->regulator_name);
1258				goto err;
1259			}
1260			cable->charger = charger;
1261			cable->cm = cm;
1262		}
1263	}
1264
1265err:
1266	return ret;
1267}
1268
1269/* help function of sysfs node to control charger(regulator) */
1270static ssize_t charger_name_show(struct device *dev,
1271				struct device_attribute *attr, char *buf)
1272{
1273	struct charger_regulator *charger
1274		= container_of(attr, struct charger_regulator, attr_name);
1275
1276	return sprintf(buf, "%s\n", charger->regulator_name);
1277}
1278
1279static ssize_t charger_state_show(struct device *dev,
1280				struct device_attribute *attr, char *buf)
1281{
1282	struct charger_regulator *charger
1283		= container_of(attr, struct charger_regulator, attr_state);
1284	int state = 0;
1285
1286	if (!charger->externally_control)
1287		state = regulator_is_enabled(charger->consumer);
1288
1289	return sprintf(buf, "%s\n", state ? "enabled" : "disabled");
1290}
1291
1292static ssize_t charger_externally_control_show(struct device *dev,
1293				struct device_attribute *attr, char *buf)
1294{
1295	struct charger_regulator *charger = container_of(attr,
1296			struct charger_regulator, attr_externally_control);
1297
1298	return sprintf(buf, "%d\n", charger->externally_control);
1299}
1300
1301static ssize_t charger_externally_control_store(struct device *dev,
1302				struct device_attribute *attr, const char *buf,
1303				size_t count)
1304{
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;
1310	int i;
1311	int ret;
1312	int externally_control;
1313	int chargers_externally_control = 1;
1314
1315	ret = sscanf(buf, "%d", &externally_control);
1316	if (ret == 0) {
1317		ret = -EINVAL;
1318		return ret;
1319	}
1320
1321	if (!externally_control) {
1322		charger->externally_control = 0;
1323		return count;
1324	}
1325
1326	for (i = 0; i < desc->num_charger_regulators; i++) {
1327		if (&desc->charger_regulators[i] != charger &&
1328			!desc->charger_regulators[i].externally_control) {
1329			/*
1330			 * At least, one charger is controlled by
1331			 * charger-manager
1332			 */
1333			chargers_externally_control = 0;
1334			break;
1335		}
1336	}
1337
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);
1343		} else {
1344			charger->externally_control = externally_control;
1345		}
1346	} else {
1347		dev_warn(cm->dev,
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);
1350	}
1351
1352	return count;
1353}
1354
1355/**
1356 * charger_manager_register_sysfs - Register sysfs entry for each charger
1357 * @cm: the Charger Manager representing the battery.
1358 *
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.
1367 */
1368static int charger_manager_register_sysfs(struct charger_manager *cm)
1369{
1370	struct charger_desc *desc = cm->desc;
1371	struct charger_regulator *charger;
1372	int chargers_externally_control = 1;
1373	char buf[11];
1374	char *str;
1375	int ret = 0;
1376	int i;
1377
1378	/* Create sysfs entry to control charger(regulator) */
1379	for (i = 0; i < desc->num_charger_regulators; i++) {
1380		charger = &desc->charger_regulators[i];
1381
1382		snprintf(buf, 10, "charger.%d", i);
1383		str = devm_kzalloc(cm->dev,
1384				sizeof(char) * (strlen(buf) + 1), GFP_KERNEL);
1385		if (!str) {
1386			ret = -ENOMEM;
1387			goto err;
1388		}
1389		strcpy(str, buf);
1390
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;
1397
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;
1402
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;
1407
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;
1416
1417		if (!desc->charger_regulators[i].externally_control ||
1418				!chargers_externally_control)
1419			chargers_externally_control = 0;
1420
1421		dev_info(cm->dev, "'%s' regulator's externally_control is %d\n",
1422			 charger->regulator_name, charger->externally_control);
1423
1424		ret = sysfs_create_group(&cm->charger_psy->dev.kobj,
1425					&charger->attr_g);
1426		if (ret < 0) {
1427			dev_err(cm->dev, "Cannot create sysfs entry of %s regulator\n",
1428				charger->regulator_name);
1429			ret = -EINVAL;
1430			goto err;
1431		}
1432	}
1433
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");
1436		ret = -EINVAL;
1437		goto err;
1438	}
1439
1440err:
1441	return ret;
1442}
1443
1444static int cm_init_thermal_data(struct charger_manager *cm,
1445		struct power_supply *fuel_gauge)
1446{
1447	struct charger_desc *desc = cm->desc;
1448	union power_supply_propval val;
1449	int ret;
1450
1451	/* Verify whether fuel gauge provides battery temperature */
1452	ret = power_supply_get_property(fuel_gauge,
1453					POWER_SUPPLY_PROP_TEMP, &val);
1454
1455	if (!ret) {
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;
1460	}
1461#ifdef CONFIG_THERMAL
1462	if (ret && desc->thermal_zone) {
1463		cm->tzd_batt =
1464			thermal_zone_get_zone_by_name(desc->thermal_zone);
1465		if (IS_ERR(cm->tzd_batt))
1466			return PTR_ERR(cm->tzd_batt);
1467
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;
1473		ret = 0;
1474	}
1475#endif
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;
1482	}
1483
1484	return ret;
1485}
1486
1487static const struct of_device_id charger_manager_match[] = {
1488	{
1489		.compatible = "charger-manager",
1490	},
1491	{},
1492};
1493
1494static struct charger_desc *of_cm_parse_desc(struct device *dev)
1495{
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;
1500	int num_chgs = 0;
1501
1502	desc = devm_kzalloc(dev, sizeof(*desc), GFP_KERNEL);
1503	if (!desc)
1504		return ERR_PTR(-ENOMEM);
1505
1506	of_property_read_string(np, "cm-name", &desc->psy_name);
1507
1508	of_property_read_u32(np, "cm-poll-mode", &poll_mode);
1509	desc->polling_mode = poll_mode;
1510
1511	of_property_read_u32(np, "cm-poll-interval",
1512				&desc->polling_interval_ms);
1513
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);
1522
1523	of_property_read_u32(np, "cm-battery-stat", &battery_stat);
1524	desc->battery_present = battery_stat;
1525
1526	/* chargers */
1527	of_property_read_u32(np, "cm-num-chargers", &num_chgs);
1528	if (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) {
1533			int i;
1534			for (i = 0; i < num_chgs; i++)
1535				of_property_read_string_index(np, "cm-chargers",
1536						i, &desc->psy_charger_stat[i]);
1537		} else {
1538			return ERR_PTR(-ENOMEM);
1539		}
1540	}
1541
1542	of_property_read_string(np, "cm-fuel-gauge", &desc->psy_fuel_gauge);
1543
1544	of_property_read_string(np, "cm-thermal-zone", &desc->thermal_zone);
1545
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);
1551
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);
1556
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;
1562
1563		chg_regs = devm_kzalloc(dev, sizeof(*chg_regs)
1564					* desc->num_charger_regulators,
1565					GFP_KERNEL);
1566		if (!chg_regs)
1567			return ERR_PTR(-ENOMEM);
1568
1569		desc->charger_regulators = chg_regs;
1570
1571		for_each_child_of_node(np, child) {
1572			struct charger_cable *cables;
1573			struct device_node *_child;
1574
1575			of_property_read_string(child, "cm-regulator-name",
1576					&chg_regs->regulator_name);
1577
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,
1583						GFP_KERNEL);
1584				if (!cables) {
1585					of_node_put(child);
1586					return ERR_PTR(-ENOMEM);
1587				}
1588
1589				chg_regs->cables = cables;
1590
1591				for_each_child_of_node(child, _child) {
1592					of_property_read_string(_child,
1593					"cm-cable-name", &cables->name);
1594					of_property_read_string(_child,
1595					"cm-cable-extcon",
1596					&cables->extcon_name);
1597					of_property_read_u32(_child,
1598					"cm-cable-min",
1599					&cables->min_uA);
1600					of_property_read_u32(_child,
1601					"cm-cable-max",
1602					&cables->max_uA);
1603					cables++;
1604				}
1605			}
1606			chg_regs++;
1607		}
1608	}
1609	return desc;
1610}
1611
1612static inline struct charger_desc *cm_get_drv_data(struct platform_device *pdev)
1613{
1614	if (pdev->dev.of_node)
1615		return of_cm_parse_desc(&pdev->dev);
1616	return dev_get_platdata(&pdev->dev);
1617}
1618
1619static enum alarmtimer_restart cm_timer_func(struct alarm *alarm, ktime_t now)
1620{
1621	cm_timer_set = false;
1622	return ALARMTIMER_NORESTART;
1623}
1624
1625static int charger_manager_probe(struct platform_device *pdev)
1626{
1627	struct charger_desc *desc = cm_get_drv_data(pdev);
1628	struct charger_manager *cm;
1629	int ret = 0, i = 0;
1630	int j = 0;
1631	union power_supply_propval val;
1632	struct power_supply *fuel_gauge;
1633	struct power_supply_config psy_cfg = {};
1634
1635	if (IS_ERR(desc)) {
1636		dev_err(&pdev->dev, "No platform data (desc) found\n");
1637		return -ENODEV;
1638	}
1639
1640	cm = devm_kzalloc(&pdev->dev,
1641			sizeof(struct charger_manager),	GFP_KERNEL);
1642	if (!cm)
1643		return -ENOMEM;
1644
1645	/* Basic Values. Unspecified are Null or 0 */
1646	cm->dev = &pdev->dev;
1647	cm->desc = desc;
1648	psy_cfg.drv_data = cm;
1649
1650	/* Initialize alarm timer */
1651	if (alarmtimer_get_rtcdev()) {
1652		cm_timer = devm_kzalloc(cm->dev, sizeof(*cm_timer), GFP_KERNEL);
1653		alarm_init(cm_timer, ALARM_BOOTTIME, cm_timer_func);
1654	}
1655
1656	/*
1657	 * The following two do not need to be errors.
1658	 * Users may intentionally ignore those two features.
1659	 */
1660	if (desc->fullbatt_uV == 0) {
1661		dev_info(&pdev->dev, "Ignoring full-battery voltage threshold as it is not supplied\n");
1662	}
1663	if (!desc->fullbatt_vchkdrop_ms || !desc->fullbatt_vchkdrop_uV) {
1664		dev_info(&pdev->dev, "Disabling full-battery voltage drop checking mechanism as it is not supplied\n");
1665		desc->fullbatt_vchkdrop_ms = 0;
1666		desc->fullbatt_vchkdrop_uV = 0;
1667	}
1668	if (desc->fullbatt_soc == 0) {
1669		dev_info(&pdev->dev, "Ignoring full-battery soc(state of charge) threshold as it is not supplied\n");
1670	}
1671	if (desc->fullbatt_full_capacity == 0) {
1672		dev_info(&pdev->dev, "Ignoring full-battery full capacity threshold as it is not supplied\n");
1673	}
1674
1675	if (!desc->charger_regulators || desc->num_charger_regulators < 1) {
1676		dev_err(&pdev->dev, "charger_regulators undefined\n");
1677		return -EINVAL;
1678	}
1679
1680	if (!desc->psy_charger_stat || !desc->psy_charger_stat[0]) {
1681		dev_err(&pdev->dev, "No power supply defined\n");
1682		return -EINVAL;
1683	}
1684
1685	if (!desc->psy_fuel_gauge) {
1686		dev_err(&pdev->dev, "No fuel gauge power supply defined\n");
1687		return -EINVAL;
1688	}
1689
1690	/* Counting index only */
1691	while (desc->psy_charger_stat[i])
1692		i++;
1693
1694	/* Check if charger's supplies are present at probe */
1695	for (i = 0; desc->psy_charger_stat[i]; i++) {
1696		struct power_supply *psy;
1697
1698		psy = power_supply_get_by_name(desc->psy_charger_stat[i]);
1699		if (!psy) {
1700			dev_err(&pdev->dev, "Cannot find power supply \"%s\"\n",
1701				desc->psy_charger_stat[i]);
1702			return -ENODEV;
1703		}
1704		power_supply_put(psy);
1705	}
1706
1707	if (desc->polling_interval_ms == 0 ||
1708	    msecs_to_jiffies(desc->polling_interval_ms) <= CM_JIFFIES_SMALL) {
1709		dev_err(&pdev->dev, "polling_interval_ms is too small\n");
1710		return -EINVAL;
1711	}
1712
1713	if (!desc->charging_max_duration_ms ||
1714			!desc->discharging_max_duration_ms) {
1715		dev_info(&pdev->dev, "Cannot limit charging duration checking mechanism to prevent overcharge/overheat and control discharging duration\n");
1716		desc->charging_max_duration_ms = 0;
1717		desc->discharging_max_duration_ms = 0;
1718	}
1719
1720	platform_set_drvdata(pdev, cm);
1721
1722	memcpy(&cm->charger_psy_desc, &psy_default, sizeof(psy_default));
1723
1724	if (!desc->psy_name)
1725		strncpy(cm->psy_name_buf, psy_default.name, PSY_NAME_MAX);
1726	else
1727		strncpy(cm->psy_name_buf, desc->psy_name, PSY_NAME_MAX);
1728	cm->charger_psy_desc.name = cm->psy_name_buf;
1729
1730	/* Allocate for psy properties because they may vary */
1731	cm->charger_psy_desc.properties = devm_kzalloc(&pdev->dev,
1732				sizeof(enum power_supply_property)
1733				* (ARRAY_SIZE(default_charger_props) +
1734				NUM_CHARGER_PSY_OPTIONAL), GFP_KERNEL);
1735	if (!cm->charger_psy_desc.properties)
1736		return -ENOMEM;
1737
1738	memcpy(cm->charger_psy_desc.properties, default_charger_props,
1739		sizeof(enum power_supply_property) *
1740		ARRAY_SIZE(default_charger_props));
1741	cm->charger_psy_desc.num_properties = psy_default.num_properties;
1742
1743	/* Find which optional psy-properties are available */
1744	fuel_gauge = power_supply_get_by_name(desc->psy_fuel_gauge);
1745	if (!fuel_gauge) {
1746		dev_err(&pdev->dev, "Cannot find power supply \"%s\"\n",
1747			desc->psy_fuel_gauge);
1748		return -ENODEV;
1749	}
1750	if (!power_supply_get_property(fuel_gauge,
1751					  POWER_SUPPLY_PROP_CHARGE_NOW, &val)) {
1752		cm->charger_psy_desc.properties[cm->charger_psy_desc.num_properties] =
1753				POWER_SUPPLY_PROP_CHARGE_NOW;
1754		cm->charger_psy_desc.num_properties++;
1755	}
1756	if (!power_supply_get_property(fuel_gauge,
1757					  POWER_SUPPLY_PROP_CURRENT_NOW,
1758					  &val)) {
1759		cm->charger_psy_desc.properties[cm->charger_psy_desc.num_properties] =
1760				POWER_SUPPLY_PROP_CURRENT_NOW;
1761		cm->charger_psy_desc.num_properties++;
1762	}
1763
1764	ret = cm_init_thermal_data(cm, fuel_gauge);
1765	if (ret) {
1766		dev_err(&pdev->dev, "Failed to initialize thermal data\n");
1767		cm->desc->measure_battery_temp = false;
1768	}
1769	power_supply_put(fuel_gauge);
1770
1771	INIT_DELAYED_WORK(&cm->fullbatt_vchk_work, fullbatt_vchk);
1772
1773	cm->charger_psy = power_supply_register(&pdev->dev,
1774						&cm->charger_psy_desc,
1775						&psy_cfg);
1776	if (IS_ERR(cm->charger_psy)) {
1777		dev_err(&pdev->dev, "Cannot register charger-manager with name \"%s\"\n",
1778			cm->charger_psy_desc.name);
1779		return PTR_ERR(cm->charger_psy);
1780	}
1781
1782	/* Register extcon device for charger cable */
1783	ret = charger_manager_register_extcon(cm);
1784	if (ret < 0) {
1785		dev_err(&pdev->dev, "Cannot initialize extcon device\n");
1786		goto err_reg_extcon;
1787	}
1788
1789	/* Register sysfs entry for charger(regulator) */
1790	ret = charger_manager_register_sysfs(cm);
1791	if (ret < 0) {
1792		dev_err(&pdev->dev,
1793			"Cannot initialize sysfs entry of regulator\n");
1794		goto err_reg_sysfs;
1795	}
1796
1797	/* Add to the list */
1798	mutex_lock(&cm_list_mtx);
1799	list_add(&cm->entry, &cm_list);
1800	mutex_unlock(&cm_list_mtx);
1801
1802	/*
1803	 * Charger-manager is capable of waking up the systme from sleep
1804	 * when event is happend through cm_notify_event()
1805	 */
1806	device_init_wakeup(&pdev->dev, true);
1807	device_set_wakeup_capable(&pdev->dev, false);
1808
1809	/*
1810	 * Charger-manager have to check the charging state right after
1811	 * tialization of charger-manager and then update current charging
1812	 * state.
1813	 */
1814	cm_monitor();
1815
1816	schedule_work(&setup_polling);
1817
1818	return 0;
1819
1820err_reg_sysfs:
1821	for (i = 0; i < desc->num_charger_regulators; i++) {
1822		struct charger_regulator *charger;
1823
1824		charger = &desc->charger_regulators[i];
1825		sysfs_remove_group(&cm->charger_psy->dev.kobj,
1826				&charger->attr_g);
1827	}
1828err_reg_extcon:
1829	for (i = 0; i < desc->num_charger_regulators; i++) {
1830		struct charger_regulator *charger;
1831
1832		charger = &desc->charger_regulators[i];
1833		for (j = 0; j < charger->num_cables; j++) {
1834			struct charger_cable *cable = &charger->cables[j];
1835			/* Remove notifier block if only edev exists */
1836			if (cable->extcon_dev.edev)
1837				extcon_unregister_interest(&cable->extcon_dev);
1838		}
1839
1840		regulator_put(desc->charger_regulators[i].consumer);
1841	}
1842
1843	power_supply_unregister(cm->charger_psy);
1844
1845	return ret;
1846}
1847
1848static int charger_manager_remove(struct platform_device *pdev)
1849{
1850	struct charger_manager *cm = platform_get_drvdata(pdev);
1851	struct charger_desc *desc = cm->desc;
1852	int i = 0;
1853	int j = 0;
1854
1855	/* Remove from the list */
1856	mutex_lock(&cm_list_mtx);
1857	list_del(&cm->entry);
1858	mutex_unlock(&cm_list_mtx);
1859
1860	cancel_work_sync(&setup_polling);
1861	cancel_delayed_work_sync(&cm_monitor_work);
1862
1863	for (i = 0 ; i < desc->num_charger_regulators ; i++) {
1864		struct charger_regulator *charger
1865				= &desc->charger_regulators[i];
1866		for (j = 0 ; j < charger->num_cables ; j++) {
1867			struct charger_cable *cable = &charger->cables[j];
1868			extcon_unregister_interest(&cable->extcon_dev);
1869		}
1870	}
1871
1872	for (i = 0 ; i < desc->num_charger_regulators ; i++)
1873		regulator_put(desc->charger_regulators[i].consumer);
1874
1875	power_supply_unregister(cm->charger_psy);
1876
1877	try_charger_enable(cm, false);
1878
1879	return 0;
1880}
1881
1882static const struct platform_device_id charger_manager_id[] = {
1883	{ "charger-manager", 0 },
1884	{ },
1885};
1886MODULE_DEVICE_TABLE(platform, charger_manager_id);
1887
1888static int cm_suspend_noirq(struct device *dev)
1889{
1890	int ret = 0;
1891
1892	if (device_may_wakeup(dev)) {
1893		device_set_wakeup_capable(dev, false);
1894		ret = -EAGAIN;
1895	}
1896
1897	return ret;
1898}
1899
1900static bool cm_need_to_awake(void)
1901{
1902	struct charger_manager *cm;
1903
1904	if (cm_timer)
1905		return false;
1906
1907	mutex_lock(&cm_list_mtx);
1908	list_for_each_entry(cm, &cm_list, entry) {
1909		if (is_charging(cm)) {
1910			mutex_unlock(&cm_list_mtx);
1911			return true;
1912		}
1913	}
1914	mutex_unlock(&cm_list_mtx);
1915
1916	return false;
1917}
1918
1919static int cm_suspend_prepare(struct device *dev)
1920{
1921	struct charger_manager *cm = dev_get_drvdata(dev);
1922
1923	if (cm_need_to_awake())
1924		return -EBUSY;
1925
1926	if (!cm_suspended)
1927		cm_suspended = true;
1928
1929	cm_timer_set = cm_setup_timer();
1930
1931	if (cm_timer_set) {
1932		cancel_work_sync(&setup_polling);
1933		cancel_delayed_work_sync(&cm_monitor_work);
1934		cancel_delayed_work(&cm->fullbatt_vchk_work);
1935	}
1936
1937	return 0;
1938}
1939
1940static void cm_suspend_complete(struct device *dev)
1941{
1942	struct charger_manager *cm = dev_get_drvdata(dev);
1943
1944	if (cm_suspended)
1945		cm_suspended = false;
1946
1947	if (cm_timer_set) {
1948		ktime_t remain;
1949
1950		alarm_cancel(cm_timer);
1951		cm_timer_set = false;
1952		remain = alarm_expires_remaining(cm_timer);
1953		cm_suspend_duration_ms -= ktime_to_ms(remain);
1954		schedule_work(&setup_polling);
1955	}
1956
1957	_cm_monitor(cm);
1958
1959	/* Re-enqueue delayed work (fullbatt_vchk_work) */
1960	if (cm->fullbatt_vchk_jiffies_at) {
1961		unsigned long delay = 0;
1962		unsigned long now = jiffies + CM_JIFFIES_SMALL;
1963
1964		if (time_after_eq(now, cm->fullbatt_vchk_jiffies_at)) {
1965			delay = (unsigned long)((long)now
1966				- (long)(cm->fullbatt_vchk_jiffies_at));
1967			delay = jiffies_to_msecs(delay);
1968		} else {
1969			delay = 0;
1970		}
1971
1972		/*
1973		 * Account for cm_suspend_duration_ms with assuming that
1974		 * timer stops in suspend.
1975		 */
1976		if (delay > cm_suspend_duration_ms)
1977			delay -= cm_suspend_duration_ms;
1978		else
1979			delay = 0;
1980
1981		queue_delayed_work(cm_wq, &cm->fullbatt_vchk_work,
1982				   msecs_to_jiffies(delay));
1983	}
1984	device_set_wakeup_capable(cm->dev, false);
1985}
1986
1987static const struct dev_pm_ops charger_manager_pm = {
1988	.prepare	= cm_suspend_prepare,
1989	.suspend_noirq	= cm_suspend_noirq,
1990	.complete	= cm_suspend_complete,
1991};
1992
1993static struct platform_driver charger_manager_driver = {
1994	.driver = {
1995		.name = "charger-manager",
1996		.pm = &charger_manager_pm,
1997		.of_match_table = charger_manager_match,
1998	},
1999	.probe = charger_manager_probe,
2000	.remove = charger_manager_remove,
2001	.id_table = charger_manager_id,
2002};
2003
2004static int __init charger_manager_init(void)
2005{
2006	cm_wq = create_freezable_workqueue("charger_manager");
2007	INIT_DELAYED_WORK(&cm_monitor_work, cm_monitor_poller);
2008
2009	return platform_driver_register(&charger_manager_driver);
2010}
2011late_initcall(charger_manager_init);
2012
2013static void __exit charger_manager_cleanup(void)
2014{
2015	destroy_workqueue(cm_wq);
2016	cm_wq = NULL;
2017
2018	platform_driver_unregister(&charger_manager_driver);
2019}
2020module_exit(charger_manager_cleanup);
2021
2022/**
2023 * find_power_supply - find the associated power_supply of charger
2024 * @cm: the Charger Manager representing the battery
2025 * @psy: pointer to instance of charger's power_supply
2026 */
2027static bool find_power_supply(struct charger_manager *cm,
2028			struct power_supply *psy)
2029{
2030	int i;
2031	bool found = false;
2032
2033	for (i = 0; cm->desc->psy_charger_stat[i]; i++) {
2034		if (!strcmp(psy->desc->name, cm->desc->psy_charger_stat[i])) {
2035			found = true;
2036			break;
2037		}
2038	}
2039
2040	return found;
2041}
2042
2043/**
2044 * cm_notify_event - charger driver notify Charger Manager of charger event
2045 * @psy: pointer to instance of charger's power_supply
2046 * @type: type of charger event
2047 * @msg: optional message passed to uevent_notify fuction
2048 */
2049void cm_notify_event(struct power_supply *psy, enum cm_event_types type,
2050		     char *msg)
2051{
2052	struct charger_manager *cm;
2053	bool found_power_supply = false;
2054
2055	if (psy == NULL)
2056		return;
2057
2058	mutex_lock(&cm_list_mtx);
2059	list_for_each_entry(cm, &cm_list, entry) {
2060		found_power_supply = find_power_supply(cm, psy);
2061		if (found_power_supply)
2062			break;
2063	}
2064	mutex_unlock(&cm_list_mtx);
2065
2066	if (!found_power_supply)
2067		return;
2068
2069	switch (type) {
2070	case CM_EVENT_BATT_FULL:
2071		fullbatt_handler(cm);
2072		break;
2073	case CM_EVENT_BATT_OUT:
2074		battout_handler(cm);
2075		break;
2076	case CM_EVENT_BATT_IN:
2077	case CM_EVENT_EXT_PWR_IN_OUT ... CM_EVENT_CHG_START_STOP:
2078		misc_event_handler(cm, type);
2079		break;
2080	case CM_EVENT_UNKNOWN:
2081	case CM_EVENT_OTHERS:
2082		uevent_notify(cm, msg ? msg : default_event_names[type]);
2083		break;
2084	default:
2085		dev_err(cm->dev, "%s: type not specified\n", __func__);
2086		break;
2087	}
2088}
2089EXPORT_SYMBOL_GPL(cm_notify_event);
2090
2091MODULE_AUTHOR("MyungJoo Ham <myungjoo.ham@samsung.com>");
2092MODULE_DESCRIPTION("Charger Manager");
2093MODULE_LICENSE("GPL");
2094