Battery: Compensate remaining charge to match full capacity

If remaining charge is more than x% of the full capacity, the
remaining charge is raised to the full capacity before it's
reported to the rest of the system.

Some batteries don't update full capacity timely or don't update it
at all. On such systems, compensation is required to guarantee
the remaining charge will be equal to the full capacity eventually.

On some systems, Rohm charger generates audio noise when the battery
is fully charged and AC is plugged. A workaround is to do charge-
discharge cycles between 93 and 100%. On such systems, compensation
was also applied to mask this cycle from users.

This used to be done in ACPI, thus, all software components except EC
was able to see the compensated charge. This patch is moving the logic
to EC. With this and the following changes, EC can see what the rest
of the system sees, thus, can control LEDs synchronously (to the
display percentage).

Another rationale of this move is EC can perform more granular and
precise compensation than ACPI since it has more knowledge about the
battery and the charger.

Signed-off-by: Daisuke Nojiri <dnojiri@chromium.org>

CQ-DEPEND=CL:3880010
BUG=b:109954565,b:80270446
BRANCH=none
TEST=Verify charge LED changes to white (full) on Sona synchronously
to the display percentage.
TEST=Verify charge LED changes to blinking white (low) on Sona
within 30 seconds synchronously to the display percentage.

Change-Id: I4e3f70efa39e62c91cb8894b603c551cd23511aa
Reviewed-on: https://chromium-review.googlesource.com/1312204
Commit-Ready: Daisuke Nojiri <dnojiri@chromium.org>
Tested-by: Daisuke Nojiri <dnojiri@chromium.org>
Reviewed-by: Daisuke Nojiri <dnojiri@chromium.org>
Reviewed-on: https://chromium-review.googlesource.com/c/chromiumos/platform/ec/+/3869317
Commit-Queue: Daisuke Nojiri <dnojiri@chromium.org>
Auto-Submit: Daisuke Nojiri <dnojiri@chromium.org>
Reviewed-by: Jett Rink <jettrink@chromium.org>

1 files changed, 22 insertions, 0 deletions

diff --git a/common/battery.c b/common/battery.c
index 9d7277479c..9d380efe86 100644
--- a/common/battery.c
+++ b/common/battery.c
@@ -21,6 +21,12 @@
 #define CPRINTF(format, args...) cprintf(CC_CHARGER, format, ## args)
 #define CPRINTS(format, args...) cprints(CC_CHARGER, format, ## args)
 
+/*
+ * See config.h for details.
+ * TODO: Allow host (powerd) to update it.
+ */
+static int batt_full_factor = CONFIG_BATT_FULL_FACTOR;
+
 #ifdef CONFIG_BATTERY_V2
 /*
  * Store battery information in these 2 structures. Main (lid) battery is always
@@ -557,6 +563,22 @@ DECLARE_HOOK(HOOK_INIT, battery_init, HOOK_PRIO_DEFAULT);
 #endif /* HAS_TASK_HOSTCMD */
 #endif /* CONFIG_BATTERY_V2 */
 
+void battery_compensate_params(struct batt_params *batt)
+{
+	int remain = batt->remaining_capacity;
+	int full = batt->full_capacity;
+
+	if ((batt->flags & BATT_FLAG_BAD_FULL_CAPACITY) ||
+			(batt->flags & BATT_FLAG_BAD_REMAINING_CAPACITY))
+		return;
+
+	if (remain <= 0 || full <= 0)
+		return;
+
+	if (remain * 100 > full * batt_full_factor)
+		batt->remaining_capacity = full;
+}
+
 __attribute__((weak)) int get_battery_manufacturer_name(char *dest, int size)
 {
 	strzcpy(dest, "<unkn>", size);