ec/google/wilco: Add power related mailbox commands
Add EC mailbox commands that are related to the power and state of the
system. These commands include:
- read the power status registers from the EC
- read & clear the power status registers
- helper function to read the current lid state
- tell the EC why the host is about to power off
- tell the EC that the host is about to enter a sleep state
Change-Id: Iaa7051b4006e3c1687933e0384d962516220621f
Signed-off-by: Duncan Laurie <dlaurie@google.com>
Reviewed-on: https://review.coreboot.org/29116
Reviewed-by: Aaron Durbin <adurbin@chromium.org>
Tested-by: build bot (Jenkins) <no-reply@coreboot.org>
diff --git a/src/ec/google/wilco/commands.c b/src/ec/google/wilco/commands.c
index 9ea8936..1767a01 100644
--- a/src/ec/google/wilco/commands.c
+++ b/src/ec/google/wilco/commands.c
@@ -50,3 +50,102 @@
if (!wilco_ec_get_info(GET_EC_BUILD_DATE, info))
printk(BIOS_INFO, "EC Build Date : %s\n", info);
}
+
+static int wilco_ec_get_power_smi(struct ec_pm_event_state *pm)
+{
+ struct ec_response_power_smi {
+ uint8_t pm_event_1;
+ uint8_t pm_state_1;
+ uint8_t hotkey;
+ uint8_t pm_state_2;
+ uint8_t pm_state_3;
+ uint8_t pm_state_4;
+ uint8_t pm_state_5;
+ uint8_t pm_event_2;
+ uint8_t pm_state_6;
+ } __packed rsp;
+
+ if (!pm)
+ return -1;
+ if (wilco_ec_sendrecv_noargs(KB_POWER_SMI, &rsp, sizeof(rsp)) < 0)
+ return -1;
+
+ pm->event[0] = rsp.pm_event_1;
+ pm->event[1] = rsp.pm_event_2;
+ pm->state[0] = rsp.pm_state_1;
+ pm->state[1] = rsp.pm_state_2;
+ pm->state[2] = rsp.pm_state_3;
+ pm->state[3] = rsp.pm_state_4;
+ pm->state[4] = rsp.pm_state_5;
+ pm->state[5] = rsp.pm_state_6;
+ pm->hotkey = rsp.hotkey;
+
+ return 0;
+}
+
+static int wilco_ec_get_power_status(struct ec_pm_event_state *pm)
+{
+ struct ec_response_power_status {
+ uint8_t pm_state_1;
+ uint8_t pm_state_2;
+ uint8_t pm_state_3;
+ uint8_t pm_state_4;
+ uint8_t pm_state_5;
+ uint8_t ac_type_lsb;
+ uint8_t pm_state_6;
+ uint8_t pm_event_2;
+ uint8_t ac_type_msb;
+ } __packed rsp;
+
+ if (!pm)
+ return -1;
+ if (wilco_ec_sendrecv_noargs(KB_POWER_STATUS, &rsp, sizeof(rsp)) < 0)
+ return -1;
+
+ pm->hotkey = 0;
+ pm->event[0] = 0;
+ pm->event[1] = rsp.pm_event_2;
+ pm->state[0] = rsp.pm_state_1;
+ pm->state[1] = rsp.pm_state_2;
+ pm->state[2] = rsp.pm_state_3;
+ pm->state[3] = rsp.pm_state_4;
+ pm->state[4] = rsp.pm_state_5;
+ pm->state[5] = rsp.pm_state_6;
+ pm->ac_type = rsp.ac_type_msb << 8 | rsp.ac_type_lsb;
+
+ return 0;
+}
+
+int wilco_ec_get_pm(struct ec_pm_event_state *pm, bool clear)
+{
+ if (clear)
+ return wilco_ec_get_power_smi(pm);
+ else
+ return wilco_ec_get_power_status(pm);
+}
+
+int wilco_ec_get_lid_state(void)
+{
+ struct ec_pm_event_state pm;
+
+ if (wilco_ec_get_power_status(&pm) < 0)
+ return -1;
+
+ return !!(pm.state[0] & EC_PM1_LID_OPEN);
+}
+
+void wilco_ec_slp_en(void)
+{
+ /* EC does not respond to this command */
+ if (wilco_ec_mailbox(WILCO_EC_MSG_NO_RESPONSE,
+ KB_SLP_EN, NULL, 0, NULL, 0) < 0)
+ printk(BIOS_ERR, "%s: command failed\n", __func__);
+}
+
+void wilco_ec_power_off(enum ec_power_off_reason reason)
+{
+ /* EC does not respond to this command */
+ if (wilco_ec_mailbox(WILCO_EC_MSG_NO_RESPONSE,
+ KB_POWER_OFF, &reason, 1, NULL, 0) < 0)
+ printk(BIOS_ERR, "%s: command failed\n", __func__);
+}
diff --git a/src/ec/google/wilco/commands.h b/src/ec/google/wilco/commands.h
index dff86aa..492900d 100644
--- a/src/ec/google/wilco/commands.h
+++ b/src/ec/google/wilco/commands.h
@@ -17,14 +17,23 @@
#define EC_GOOGLE_WILCO_COMMANDS_H
#include <stdint.h>
+#include <types.h>
enum {
+ /* Read and clear power state information */
+ KB_POWER_SMI = 0x04,
+ /* Read but do not clear power state information */
+ KB_POWER_STATUS = 0x05,
+ /* Inform the EC aboout the reason host is turning off */
+ KB_POWER_OFF = 0x08,
/* Retrieve information about the EC */
KB_EC_INFO = 0x38,
/* Set ACPI mode on or off */
KB_ACPI = 0x3a,
/* Manage the EC power button passthru to the host */
KB_POWER_BUTTON_TO_HOST = 0x3e,
+ /* Inform the EC that the host is about to enter S3 */
+ KB_SLP_EN = 0x64,
};
enum set_acpi_mode_cmd {
@@ -74,4 +83,137 @@
*/
void wilco_ec_print_all_info(void);
+/*
+ * EC Power State
+ */
+
+enum ec_power_off_reason {
+ EC_PWROFF_FLASH = 0x11,
+ EC_PWROFF_AC_REMOVED = 0x12,
+ EC_PWROFF_BAT_REMOVED = 0x13,
+ EC_PWROFF_LOBAT = 0x15,
+ EC_PWROFF_PWRB_IN_POST = 0x16,
+ EC_PWROFF_FORCE_IMMEDIATE = 0x18,
+ EC_PWROFF_WDT = 0x1b,
+ EC_PWROFF_FORCE_THERMAL = 0x22,
+ EC_PWROFF_ERR_CODE = 0x23,
+ EC_PWROFF_PAID_PWRGD = 0x27,
+ EC_PWROFF_PAID_CPU = 0x28,
+ EC_PWROFF_PAID_GFX = 0x29,
+ EC_PWROFF_PAID_CLK = 0x2a,
+ EC_PWROFF_PAID_NOMEMORY = 0x2b,
+ EC_PWROFF_PAID_MEMORY_ERR = 0x2c,
+ EC_PWROFF_PAID_MEMORY_SPD = 0x2d,
+ EC_SWOFF_ACPI = 0x31,
+ EC_SWOFF_BOOT_PASSWORD = 0x33,
+ EC_SWOFF_DISK_PASSWORD = 0x34,
+ EC_SWOFF_POWER_CYCLE = 0x37,
+ EC_SWOFF_HARD_RESET = 0x3b,
+ EC_SWOFF_FSMI = 0x3f,
+ EC_PWRLOG_THERMTRIP = 0x41,
+ EC_PWRLOG_NO_S5 = 0x42,
+ EC_PWROFF_4S_PWRB = 0x44,
+ EC_PWROFF_ASF2_FORCEOFF = 0x45,
+ EC_PWROFF_PWRB_THERMAL = 0x48,
+ EC_PWROFF_AOAC_TIMER = 0x4b,
+};
+
+/**
+ * wilco_ec_power_off
+ *
+ * Tell the EC why the host is about to power off.
+*/
+void wilco_ec_power_off(enum ec_power_off_reason reason);
+
+/**
+ * wilco_ec_slp_en
+ *
+ * Tell the EC that the host is entering a sleep state.
+ */
+void wilco_ec_slp_en(void);
+
+enum ec_pm1_state {
+ EC_PM1_AC_AVAIL = BIT(0), /* AC available */
+ EC_PM1_BAT_AVAIL = BIT(1), /* Battery available */
+ EC_PM1_LO_BAT1 = BIT(2), /* Battery 1 low */
+ EC_PM1_LO_BAT2 = BIT(3), /* Battery 2 low */
+ EC_PM1_LID_OPEN = BIT(4), /* Lid is open */
+ EC_PM1_LCD_POWER = BIT(5), /* LCD is powered */
+ EC_PM1_OVER_TEMP = BIT(6), /* CPU is over temperature */
+ EC_PM1_DOCKED = BIT(7), /* System is docked */
+};
+
+enum ec_pm2_state {
+ EC_PM2_SYS_MB_PCIE = BIT(0), /* MB has PCIe */
+ EC_PM2_SYS_MB_SATA = BIT(1), /* MB has SATA */
+ EC_PM2_PWRB_PRESSED = BIT(2), /* Power button is pressed */
+ EC_PM2_TURBO_MODE = BIT(3), /* Turbo mode */
+};
+
+enum ec_pm3_state {
+ EC_PM3_BAT1_PRES = BIT(2), /* Battery 1 is present */
+ EC_PM3_BAT2_PRES = BIT(3), /* Battery 2 is present */
+ EC_PM3_LOWER_PSTATE = BIT(6), /* EC requests lower P-state */
+ EC_PM3_CPU_THROTTLE = BIT(7), /* EC requests CPU throttle */
+};
+
+enum ec_pm4_state {
+ EC_PM4_BAT1_CHG = BIT(0), /* Battery 1 is being charged */
+ EC_PM4_BAT2_CHG = BIT(1), /* Battery 2 is being charged */
+ EC_PM4_BAT1_PWR = BIT(2), /* Battery 1 is powering the system */
+ EC_PM4_BAT2_PWR = BIT(3), /* Battery 2 is powering the system */
+ EC_PM4_PANEL_STATE = BIT(5), /* Panel power state */
+};
+
+enum ec_pm5_state {
+ EC_PM5_INT_HD_SATA = BIT(7), /* Internal SATA HDD */
+};
+
+enum ec_pm6_state {
+ EC_PM6_WLAN_SWITCH = BIT(0), /* Wireless switch */
+ EC_PM6_SYS_MB_MODEM = BIT(1), /* MB has modem */
+ EC_PM6_ETH_STATE = BIT(2), /* Ethernet cable state */
+ EC_PM6_AC_UPDATE = BIT(3), /* Update AC information */
+};
+
+enum ec_pm1_event {
+ EC_EV1_PWRB_PRESSED = BIT(0), /* Power button was pressed */
+ EC_EV1_HOTKEY_PRESSED = BIT(1), /* Hotkey was pressed */
+ EC_EV1_STATE_CHANGED = BIT(2), /* PMx state changed */
+};
+
+enum ec_pm2_event {
+ EC_EV2_ACPI_MONSWITCH = BIT(0), /* Monitor switch status */
+};
+
+struct ec_pm_event_state {
+ uint8_t event[2]; /* ec_pm{1,2}_event */
+ uint8_t state[6]; /* ec_pm{1,2,3,4,5,6}_state */
+ uint8_t hotkey; /* Hotkey, if pressed */
+ uint16_t ac_type; /* AC adapter information */
+};
+
+/**
+ * wilco_ec_get_pm
+ *
+ * Retrieve power and event information from the EC.
+ *
+ * @pm: Power event state structure to fill out
+ * @clear: Clear EC event state after reading
+ *
+ * Returns 0 if EC command was successful
+ * Returns -1 if EC command failed
+ */
+int wilco_ec_get_pm(struct ec_pm_event_state *pm, bool clear);
+
+/**
+ * wilco_ec_get_lid_state
+ *
+ * Retrieve the lid state without clearing it in the EC.
+ *
+ * Returns 1 if the lid is open, 0 if it is closed
+ * Returns -1 if the EC command failed
+ */
+int wilco_ec_get_lid_state(void);
+
#endif /* EC_GOOGLE_WILCO_COMMANDS_H */