/* * This file is part of the coreboot project. * * Copyright (C) 2012 The Chromium OS Authors. All rights reserved. * * 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. * * You should have received a copy of the GNU General Public License * along with this program; if not, write to the Free Software * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA */ #include #include #include #include #include #include #ifndef __PRE_RAM__ #include #include #include #include #include #include "chip.h" #endif #include "ec.h" #include "ec_commands.h" #include /* an internal API to send a command to the EC and wait for response. */ struct chromeec_command { u8 cmd_code; /* command code in, status out */ u8 cmd_version; /* command version */ const void* cmd_data_in; /* command data, if any */ void* cmd_data_out; /* command response, if any */ u16 cmd_size_in; /* size of command data */ u16 cmd_size_out; /* expected size of command response in, * actual received size out */ }; static int google_chromeec_wait_ready(u16 port) { u8 ec_status = inb(port); u32 time_count = 0; /* * One second is more than plenty for any EC operation to complete * (and the bus accessing/code execution) overhead will make the * timeout even longer. */ #define MAX_EC_TIMEOUT_US 1000000 while (ec_status & (EC_LPC_CMDR_PENDING | EC_LPC_CMDR_BUSY)) { udelay(1); if (time_count++ == MAX_EC_TIMEOUT_US) return -1; ec_status = inb(port); } return 0; } static int google_chromeec_cmd_args_supported(void) { if (inb(EC_LPC_ADDR_MEMMAP + EC_MEMMAP_ID) == 'E' && inb(EC_LPC_ADDR_MEMMAP + EC_MEMMAP_ID + 1) == 'C' && (inb(EC_LPC_ADDR_MEMMAP + EC_MEMMAP_HOST_CMD_FLAGS) & EC_HOST_CMD_FLAG_LPC_ARGS_SUPPORTED)) return 1; return 0; } static int google_chromeec_command_old(struct chromeec_command *cec_command) { int i; if (cec_command->cmd_version) { printk(BIOS_ERR, "Invalid version for command protocol!\n"); return 1; } if (google_chromeec_wait_ready(EC_LPC_ADDR_HOST_CMD)) { printk(BIOS_ERR, "Timeout waiting for EC ready!\n"); return 1; } /* Copy command data, if any. */ for (i = 0; i < cec_command->cmd_size_in; i++) outb(((char*)cec_command->cmd_data_in)[i], EC_LPC_ADDR_OLD_PARAM + i); /* Issue the command. */ outb(cec_command->cmd_code, EC_LPC_ADDR_HOST_CMD); if (google_chromeec_wait_ready(EC_LPC_ADDR_HOST_CMD)) { printk(BIOS_ERR, "Timeout waiting for EC process command %d!\n", cec_command->cmd_code); return 1; } for (i = 0; i < cec_command->cmd_size_out; i++) ((char*)cec_command->cmd_data_out)[i] = inb(EC_LPC_ADDR_OLD_PARAM + i); cec_command->cmd_code = inb(EC_LPC_ADDR_HOST_DATA); return 0; } static int google_chromeec_command(struct chromeec_command *cec_command) { struct ec_lpc_host_args args; const u8 *d; u8 *dout; u8 cmd_code = cec_command->cmd_code; int csum; int i; /* Fall back to old command protocol if necessary */ if (!google_chromeec_cmd_args_supported()) return google_chromeec_command_old(cec_command); /* Fill in args */ args.flags = EC_HOST_ARGS_FLAG_FROM_HOST; args.command_version = cec_command->cmd_version; args.data_size = cec_command->cmd_size_in; /* Initialize checksum */ csum = cmd_code + args.flags + args.command_version + args.data_size; /* Write data and update checksum */ for (i = 0, d = (const u8 *)cec_command->cmd_data_in; i < cec_command->cmd_size_in; i++, d++) { outb(*d, EC_LPC_ADDR_HOST_PARAM + i); csum += *d; } /* Finalize checksum and write args */ args.checksum = (u8)csum; for (i = 0, d = (const u8 *)&args; i < sizeof(args); i++, d++) outb(*d, EC_LPC_ADDR_HOST_ARGS + i); /* Issue the command */ outb(cmd_code, EC_LPC_ADDR_HOST_CMD); if (google_chromeec_wait_ready(EC_LPC_ADDR_HOST_CMD)) { printk(BIOS_ERR, "Timeout waiting for EC process command %d!\n", cec_command->cmd_code); return 1; } /* Check result */ cec_command->cmd_code = inb(EC_LPC_ADDR_HOST_DATA); if (cec_command->cmd_code) return 1; /* Read back args */ for (i = 0, dout = (u8 *)&args; i < sizeof(args); i++, dout++) *dout = inb(EC_LPC_ADDR_HOST_ARGS + i); /* * If EC didn't modify args flags, then somehow we sent a new-style * command to an old EC, which means it would have read its params * from the wrong place. */ if (!(args.flags & EC_HOST_ARGS_FLAG_TO_HOST)) { printk(BIOS_ERR, "EC protocol mismatch\n"); return 1; } if (args.data_size > cec_command->cmd_size_out) { printk(BIOS_ERR, "EC returned too much data\n"); return 1; } cec_command->cmd_size_out = args.data_size; /* Start calculating response checksum */ csum = cmd_code + args.flags + args.command_version + args.data_size; /* Read data, if any */ for (i = 0, dout = (u8 *)cec_command->cmd_data_out; i < args.data_size; i++, dout++) { *dout = inb(EC_LPC_ADDR_HOST_PARAM + i); csum += *dout; } /* Verify checksum */ if (args.checksum != (u8)csum) { printk(BIOS_ERR, "EC response has invalid checksum\n"); return 1; } return 0; } int google_chromeec_kbbacklight(int percent) { struct chromeec_command cec_cmd; struct ec_params_pwm_set_keyboard_backlight cmd_backlight; struct ec_response_pwm_get_keyboard_backlight rsp_backlight; /* if they were dumb, help them out */ percent = percent % 101; cec_cmd.cmd_code = EC_CMD_PWM_SET_KEYBOARD_BACKLIGHT; cec_cmd.cmd_version = 0; cmd_backlight.percent = percent; cec_cmd.cmd_data_in = &cmd_backlight; cec_cmd.cmd_data_out = &rsp_backlight; cec_cmd.cmd_size_in = sizeof(cmd_backlight); cec_cmd.cmd_size_out = sizeof(rsp_backlight); google_chromeec_command(&cec_cmd); printk(BIOS_DEBUG, "Google Chrome set keyboard backlight: %x status (%x)\n", rsp_backlight.percent, cec_cmd.cmd_code); return cec_cmd.cmd_code; } void google_chromeec_post(u8 postcode) { /* backlight is a percent. postcode is a u8. * Convert the u8 to %. */ postcode = (postcode/4) + (postcode/8); google_chromeec_kbbacklight(postcode); } /* * Query the EC for specified mask indicating enabled events. * The EC maintains separate event masks for SMI, SCI and WAKE. */ static u32 google_chromeec_get_mask(u8 type) { struct ec_params_host_event_mask req; struct ec_response_host_event_mask rsp; struct chromeec_command cmd; cmd.cmd_code = type; cmd.cmd_version = 0; cmd.cmd_data_in = &req; cmd.cmd_size_in = sizeof(req); cmd.cmd_data_out = &rsp; cmd.cmd_size_out = sizeof(rsp); if (google_chromeec_command(&cmd) == 0) return rsp.mask; return 0; } u32 google_chromeec_get_events_b(void) { return google_chromeec_get_mask(EC_CMD_HOST_EVENT_GET_B); } #ifndef __PRE_RAM__ static int google_chromeec_set_mask(u8 type, u32 mask) { struct ec_params_host_event_mask req; struct ec_response_host_event_mask rsp; struct chromeec_command cmd; req.mask = mask; cmd.cmd_code = type; cmd.cmd_version = 0; cmd.cmd_data_in = &req; cmd.cmd_size_in = sizeof(req); cmd.cmd_data_out = &rsp; cmd.cmd_size_out = sizeof(rsp); return google_chromeec_command(&cmd); } int google_chromeec_set_sci_mask(u32 mask) { printk(BIOS_DEBUG, "Chrome EC: Set SCI mask to 0x%08x\n", mask); return google_chromeec_set_mask( EC_CMD_HOST_EVENT_SET_SCI_MASK, mask); } int google_chromeec_set_smi_mask(u32 mask) { printk(BIOS_DEBUG, "Chrome EC: Set SMI mask to 0x%08x\n", mask); return google_chromeec_set_mask( EC_CMD_HOST_EVENT_SET_SMI_MASK, mask); } int google_chromeec_set_wake_mask(u32 mask) { printk(BIOS_DEBUG, "Chrome EC: Set WAKE mask to 0x%08x\n", mask); return google_chromeec_set_mask( EC_CMD_HOST_EVENT_SET_WAKE_MASK, mask); } u32 google_chromeec_get_wake_mask(void) { return google_chromeec_get_mask( EC_CMD_HOST_EVENT_GET_WAKE_MASK); } #if CONFIG_ELOG /* Find the last port80 code from the previous boot */ static u16 google_chromeec_get_port80_last_boot(void) { struct ec_response_port80_last_boot rsp; struct chromeec_command cmd = { .cmd_code = EC_CMD_PORT80_LAST_BOOT, .cmd_data_out = &rsp, .cmd_size_out = sizeof(rsp), }; /* Get last port80 code */ if (google_chromeec_command(&cmd) == 0) return rsp.code; return 0; } #endif void google_chromeec_log_events(u32 mask) { #if CONFIG_ELOG u8 event; u16 code; /* Find the last port80 code */ code = google_chromeec_get_port80_last_boot(); /* Log the last post code only if it is abornmal */ if (code > 0 && code != POST_OS_BOOT && code != POST_OS_RESUME) printk(BIOS_DEBUG, "Chrome EC: Last POST code was 0x%02x\n", code); while ((event = google_chromeec_get_event()) != 0) { if (EC_HOST_EVENT_MASK(event) & mask) elog_add_event_byte(ELOG_TYPE_EC_EVENT, event); } #endif } u8 google_chromeec_get_event(void) { if (google_chromeec_wait_ready(EC_LPC_ADDR_ACPI_CMD)) { printk(BIOS_ERR, "Timeout waiting for EC ready!\n"); return 1; } /* Issue the ACPI query-event command */ outb(EC_CMD_ACPI_QUERY_EVENT, EC_LPC_ADDR_ACPI_CMD); if (google_chromeec_wait_ready(EC_LPC_ADDR_ACPI_CMD)) { printk(BIOS_ERR, "Timeout waiting for EC QUERY_EVENT!\n"); return 0; } /* Event (or 0 if none) is returned directly in the data byte */ return inb(EC_LPC_ADDR_ACPI_DATA); } u16 google_chromeec_get_board_version(void) { struct chromeec_command cmd; struct ec_response_board_version board_v; cmd.cmd_code = EC_CMD_GET_BOARD_VERSION; cmd.cmd_version = 0; cmd.cmd_size_in = 0; cmd.cmd_size_out = sizeof(board_v); cmd.cmd_data_out = &board_v; if (google_chromeec_command(&cmd) != 0) return 0; return board_v.board_version; } int google_chromeec_set_usb_charge_mode(u8 port_id, enum usb_charge_mode mode) { struct chromeec_command cmd; struct ec_params_usb_charge_set_mode set_mode = { .usb_port_id = port_id, .mode = mode, }; cmd.cmd_code = EC_CMD_USB_CHARGE_SET_MODE; cmd.cmd_version = 0; cmd.cmd_size_in = sizeof(set_mode); cmd.cmd_data_in = &set_mode; cmd.cmd_size_out = 0; cmd.cmd_data_out = NULL; return google_chromeec_command(&cmd); } #ifndef __SMM__ static int google_chromeec_hello(void) { struct chromeec_command cec_cmd; struct ec_params_hello cmd_hello; struct ec_response_hello rsp_hello; cmd_hello.in_data = 0x10203040; cec_cmd.cmd_code = EC_CMD_HELLO; cec_cmd.cmd_version = 0; cec_cmd.cmd_data_in = &cmd_hello.in_data; cec_cmd.cmd_data_out = &rsp_hello.out_data; cec_cmd.cmd_size_in = sizeof(cmd_hello.in_data); cec_cmd.cmd_size_out = sizeof(rsp_hello.out_data); google_chromeec_command(&cec_cmd); printk(BIOS_DEBUG, "Google Chrome EC: Hello got back %x status (%x)\n", rsp_hello.out_data, cec_cmd.cmd_code); return cec_cmd.cmd_code; } static int ec_image_type; /* Cached EC image type (ro or rw). */ static void google_chromeec_init(device_t dev) { struct chromeec_command cec_cmd; struct ec_google_chromeec_config *conf = dev->chip_info; struct ec_response_get_version lpcv_cmd; if (!dev->enabled) return; printk(BIOS_DEBUG, "Google Chrome EC: Initializing keyboard.\n"); pc_keyboard_init(&conf->keyboard); google_chromeec_hello(); memset(&lpcv_cmd, 0, sizeof(lpcv_cmd)); cec_cmd.cmd_code = EC_CMD_GET_VERSION; cec_cmd.cmd_version = 0; cec_cmd.cmd_data_out = &lpcv_cmd; cec_cmd.cmd_size_in = 0; cec_cmd.cmd_size_out = sizeof(lpcv_cmd); google_chromeec_command(&cec_cmd); if (cec_cmd.cmd_code) { printk(BIOS_DEBUG, "Google Chrome EC: version command failed!\n"); } else { printk(BIOS_DEBUG, "Google Chrome EC: version:\n"); printk(BIOS_DEBUG, " ro: %s\n", lpcv_cmd.version_string_ro); printk(BIOS_DEBUG, " rw: %s\n", lpcv_cmd.version_string_rw); printk(BIOS_DEBUG, " running image: %d\n", lpcv_cmd.current_image); ec_image_type = lpcv_cmd.current_image; } if (cec_cmd.cmd_code || (recovery_mode_enabled() && (lpcv_cmd.current_image != EC_IMAGE_RO))) { struct ec_params_reboot_ec reboot_ec; /* Reboot the EC and make it come back in RO mode */ reboot_ec.cmd = EC_REBOOT_COLD; reboot_ec.flags = 0; cec_cmd.cmd_code = EC_CMD_REBOOT_EC; cec_cmd.cmd_version = 0; cec_cmd.cmd_data_in = &reboot_ec; cec_cmd.cmd_size_in = sizeof(reboot_ec); cec_cmd.cmd_size_out = 0; /* ignore response, if any */ printk(BIOS_DEBUG, "Rebooting with EC in RO mode:\n"); google_chromeec_command(&cec_cmd); udelay(1000); hard_reset(); hlt(); } } static void google_chromeec_read_resources(device_t dev) { /* Nothing, but this function avoids an error on serial console. */ } static void google_chromeec_enable_resources(device_t dev) { /* Nothing, but this function avoids an error on serial console. */ } static struct device_operations ops = { .init = google_chromeec_init, .read_resources = google_chromeec_read_resources, .enable_resources = google_chromeec_enable_resources }; static struct pnp_info pnp_dev_info[] = { { &ops, 0, 0, { 0, 0 }, } }; static void enable_dev(device_t dev) { pnp_enable_devices(dev, &pnp_ops, ARRAY_SIZE(pnp_dev_info), pnp_dev_info); } struct chip_operations ec_google_chromeec_ops = { CHIP_NAME("Google Chrome EC") .enable_dev = enable_dev, }; int google_ec_running_ro(void) { return (ec_image_type == EC_IMAGE_RO); } #endif /* ! __SMM__ */ #endif /* ! __PRE_RAM__ */