ec: Add support for EC used on Purism Librem laptops

This adds basic ACPI support for the EC used on Purism Librem laptops.
The EC firmware appears to use the topstar laptop interface that has
support in the linux kernel for handling the special keys.

Supported functions:
- Battery information
- AC presence
- Lid switch
- Special keys (after loading topstar-laptop driver in linux)
- EC events for turbo enable/disable when on AC power

Things it does not do:
- EC SMI handling
- Fan is left under EC control

This was developed and tested on a Librem 13 laptop, and has not
been directly tested on an Librem 15.

Change-Id: Ib85a24e4cc8ab09b14147060043cff372863c2d1
Signed-off-by: Duncan Laurie <dlaurie@google.com>
Reviewed-on: https://review.coreboot.org/13025
Tested-by: build bot (Jenkins)
Reviewed-by: Stefan Reinauer <stefan.reinauer@coreboot.org>
Reviewed-by: Martin Roth <martinroth@google.com>

1 files changed, 211 insertions, 0 deletions

diff --git a/src/ec/purism/librem/acpi/battery.asl b/src/ec/purism/librem/acpi/battery.asl
new file mode 100644
index 0000000000..a090b7c2a8
--- /dev/null
+++ b/src/ec/purism/librem/acpi/battery.asl
@@ -0,0 +1,211 @@
+/*
+ * This file is part of the coreboot project.
+ *
+ * Copyright (C) 2016 Google Inc.
+ *
+ * This program is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU General Public License as
+ * published by the Free Software Foundation; version 2 of the License.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ */
+
+Device (BAT)
+{
+	Name (_HID, EisaId ("PNP0C0A"))
+	Name (_UID, 1)
+	Name (_PCL, Package () { \_SB })
+
+	Name (PBIF, Package () {
+		0x00000001,  /* 0x00: Power Unit: mAh */
+		0xFFFFFFFF,  /* 0x01: Design Capacity */
+		0xFFFFFFFF,  /* 0x02: Last Full Charge Capacity */
+		0x00000001,  /* 0x03: Battery Technology: Rechargeable */
+		0xFFFFFFFF,  /* 0x04: Design Voltage */
+		0x00000003,  /* 0x05: Design Capacity of Warning */
+		0xFFFFFFFF,  /* 0x06: Design Capacity of Low */
+		0x00000001,  /* 0x07: Capacity Granularity 1 */
+		0x00000001,  /* 0x08: Capacity Granularity 2 */
+		"S10",       /* 0x09: Model Number */
+		"",          /* 0x0a: Serial Number */
+		"LION",      /* 0x0b: Battery Type */
+		"TPS"        /* 0x0c: OEM Information */
+	})
+
+	Name (PBIX, Package () {
+		0x00000000,  // 0x00: Revision
+		0x00000001,  // 0x01: Power Unit: mAh
+		0xFFFFFFFF,  // 0x02: Design Capacity
+		0xFFFFFFFF,  // 0x03: Last Full Charge Capacity
+		0x00000001,  // 0x04: Battery Technology: Rechargeable
+		0xFFFFFFFF,  // 0x05: Design Voltage
+		0x00000003,  // 0x06: Design Capacity of Warning
+		0xFFFFFFFF,  // 0x07: Design Capacity of Low
+		0x00000000,  // 0x08: Cycle Count
+		0x00018000,  // 0x09: Measurement Accuracy (98.3%?)
+		0x000001F4,  // 0x0a: Max Sampling Time (500ms)
+		0x0000000a,  // 0x0b: Min Sampling Time (10ms)
+		0xFFFFFFFF,  // 0x0c: Max Averaging Interval
+		0xFFFFFFFF,  // 0x0d: Min Averaging Interval
+		0x00000001,  // 0x0e: Capacity Granularity 1
+		0x00000001,  // 0x0f: Capacity Granularity 2
+		"S10",       // 0x10: Model Number
+		"",          // 0x11: Serial Number
+		"LION",      // 0x12: Battery Type
+		"TPS"        // 0x13: OEM Information
+	})
+
+	Name (PBST, Package () {
+		0x00000000,  /* 0x00: Battery State */
+		0xFFFFFFFF,  /* 0x01: Battery Present Rate */
+		0xFFFFFFFF,  /* 0x02: Battery Remaining Capacity */
+		0xFFFFFFFF,  /* 0x03: Battery Present Voltage */
+	})
+	Name (BSTP, Zero)
+
+	/* Battery Capacity warning at 15% */
+	Name (DWRN, 15)
+
+	/* Battery Capacity low at 10% */
+	Name (DLOW, 10)
+
+	/* Workaround for full battery status, enabled by default */
+	Name (BFWK, One)
+
+	/* Method to enable full battery workaround */
+	Method (BFWE)
+	{
+		Store (One, BFWK)
+	}
+
+	/* Method to disable full battery workaround */
+	Method (BFWD)
+	{
+		Store (Zero, BFWK)
+	}
+
+	Method (_STA, 0, Serialized)
+	{
+		If (BTEX) {
+			Return (0x1F)
+		} Else {
+			Return (0x0F)
+		}
+	}
+
+	Method (_BIF, 0, Serialized)
+	{
+		/* Last Full Charge Capacity */
+		Store (BTDF, Index (PBIF, 2))
+
+		/* Design Voltage */
+		Store (BTDV, Index (PBIF, 4))
+
+		/* Design Capacity */
+		Store (BTDA, Local0)
+		Store (Local0, Index (PBIF, 1))
+
+		/* Design Capacity of Warning */
+		Divide (Multiply (Local0, DWRN), 100, , Local2)
+		Store (Local2, Index (PBIF, 5))
+
+		/* Design Capacity of Low */
+		Divide (Multiply (Local0, DLOW), 100, , Local2)
+		Store (Local2, Index (PBIF, 6))
+
+		Return (PBIF)
+	}
+
+	Method (_BIX, 0, Serialized)
+	{
+		/* Last Full Charge Capacity */
+		Store (BTDF, Index (PBIX, 3))
+
+		/* Design Voltage */
+		Store (BTDV, Index (PBIX, 5))
+
+		/* Design Capacity */
+		Store (BTDA, Local0)
+		Store (Local0, Index (PBIX, 2))
+
+		/* Design Capacity of Warning */
+		Divide (Multiply (Local0, DWRN), 100, , Local2)
+		Store (Local2, Index (PBIX, 6))
+
+		/* Design Capacity of Low */
+		Divide (Multiply (Local0, DLOW), 100, , Local2)
+		Store (Local2, Index (PBIX, 7))
+
+		Return (PBIX)
+	}
+
+	Method (_BST, 0, Serialized)
+	{
+		/*
+		 * 0: BATTERY STATE
+		 *
+		 * bit 0 = discharging
+		 * bit 1 = charging
+		 * bit 2 = critical level
+		 */
+
+		/* Check if AC is present */
+		If (ACEX) {
+			/* Read battery status from EC */
+			Store (BSTS, Local0)
+		} Else {
+			/* Always discharging when on battery power */
+			Store (0x01, Local0)
+		}
+
+		/* Check for critical battery level */
+		If (BFCR) {
+			Or (Local0, 0x04, Local0)
+		}
+		Store (Local0, Index (PBST, 0))
+
+		/* Notify if battery state has changed since last time */
+		If (LNotEqual (Local0, BSTP)) {
+			Store (Local0, BSTP)
+			Notify (BAT, 0x80)
+		}
+
+		/*
+		 * 1: BATTERY PRESENT RATE
+		 */
+		Store (BTPR, Local1)
+		If (And (Local1, 0x8000)) {
+			And (Not (Local1), 0x7FFF, Local0)
+			Increment (Local0)
+		} Else {
+			And (Local1, 0x7FFF, Local0)
+		}
+
+		/*
+		 * 2: BATTERY REMAINING CAPACITY
+		 */
+		Store (BTRA, Local0)
+		If (LAnd (BFWK, LAnd (ACEX, LNot (BSTS)))) {
+			Store (BTDF, Local1)
+
+			/* See if within ~6% of full */
+			ShiftRight (Local1, 4, Local2)
+			If (LAnd (LGreater (Local0, Subtract (Local1, Local2)),
+			          LLess (Local0, Add (Local1, Local2))))
+			{
+				Store (Local1, Local0)
+			}
+		}
+		Store (Local0, Index (PBST, 2))
+
+		/*
+		 * 3: BATTERY PRESENT VOLTAGE
+		 */
+		Store (BTVO, Index (PBST, 3))
+
+		Return (PBST)
+	}
+}