29f2b258c8
The speakers start up muted, and the EC must be told by the BIOS to unmute it. This helps prevent popping noises on boot/resume. Change-Id: I693f1d01e46e19362ef8fd0d5b3f4930967b5a12 Signed-off-by: Duncan Laurie <dlaurie@google.com> Reviewed-on: https://review.coreboot.org/29203 Reviewed-by: Aaron Durbin <adurbin@chromium.org> Tested-by: build bot (Jenkins) <no-reply@coreboot.org>
239 lines
6.3 KiB
C
239 lines
6.3 KiB
C
/*
|
|
* This file is part of the coreboot project.
|
|
*
|
|
* Copyright 2018 Google LLC
|
|
*
|
|
* 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.
|
|
*/
|
|
|
|
#ifndef EC_GOOGLE_WILCO_COMMANDS_H
|
|
#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,
|
|
/* Save PS/2 data before S3 suspend */
|
|
KB_SAVE = 0x2f,
|
|
/* Restore PS/2 data after S3 resume */
|
|
KB_RESTORE = 0x30,
|
|
/* 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,
|
|
/* Manage the EC control of speaker mute */
|
|
KB_HW_MUTE_CONTROL = 0x60,
|
|
/* Inform the EC that the host is about to enter S3 */
|
|
KB_SLP_EN = 0x64,
|
|
/* Inform the EC about BIOS boot progress */
|
|
KB_BIOS_PROGRESS = 0xc2,
|
|
};
|
|
|
|
enum set_acpi_mode_cmd {
|
|
ACPI_OFF = 0,
|
|
ACPI_ON
|
|
};
|
|
|
|
enum bios_progress_code {
|
|
BIOS_PROGRESS_MEMORY_INIT = 0x01,
|
|
BIOS_PROGRESS_VIDEO_INIT = 0x02,
|
|
BIOS_PROGRESS_LOGO_DISPLAYED = 0x03,
|
|
BIOS_PROGRESS_POST_COMPLETE = 0x04,
|
|
};
|
|
|
|
enum ec_audio_mute {
|
|
AUDIO_MUTE = 0, /* Mute speakers immediately */
|
|
AUDIO_UNMUTE_125MS, /* Unmute in 125ms */
|
|
};
|
|
|
|
/*
|
|
* EC Information
|
|
*/
|
|
|
|
enum get_ec_info_cmd {
|
|
GET_EC_LABEL = 0,
|
|
GET_EC_SVN_REV,
|
|
GET_EC_MODEL_NO,
|
|
GET_EC_BUILD_DATE
|
|
};
|
|
|
|
#define EC_INFO_MAX_SIZE 9
|
|
struct ec_response_get_ec_info {
|
|
char data[EC_INFO_MAX_SIZE]; /* ASCII NUL terminated string */
|
|
};
|
|
|
|
/**
|
|
* wilco_ec_get_info
|
|
*
|
|
* Read a specific information string from the EC and return it in
|
|
* the caller-provided buffer of at least EC_INFO_MAX_SIZE bytes.
|
|
*
|
|
* @cmd: Information to retrieve
|
|
* @info: Character array of EC_INFO_MAX_SIZE bytes
|
|
*
|
|
* Returns 0 if successful and resulting string is in 'info'
|
|
* Returns -1 if the EC command fails
|
|
*/
|
|
int wilco_ec_get_info(enum get_ec_info_cmd cmd, char *info);
|
|
|
|
/**
|
|
* wilco_ec_print_all_info
|
|
*
|
|
* Retrieve and print all the information strings from the EC:
|
|
*
|
|
* GET_EC_LABEL
|
|
* GET_EC_SVN_REV
|
|
* GET_EC_MODEL_NO
|
|
* GET_EC_BUILD_DATE
|
|
*/
|
|
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 */
|