1c8d3328aSHung-ying Tyan /* 2c8d3328aSHung-ying Tyan * Chromium OS cros_ec driver - LPC interface 3c8d3328aSHung-ying Tyan * 4c8d3328aSHung-ying Tyan * Copyright (c) 2012 The Chromium OS Authors. 5c8d3328aSHung-ying Tyan * 61a459660SWolfgang Denk * SPDX-License-Identifier: GPL-2.0+ 7c8d3328aSHung-ying Tyan */ 8c8d3328aSHung-ying Tyan 9c8d3328aSHung-ying Tyan /* 10c8d3328aSHung-ying Tyan * The Matrix Keyboard Protocol driver handles talking to the keyboard 11c8d3328aSHung-ying Tyan * controller chip. Mostly this is for keyboard functions, but some other 12c8d3328aSHung-ying Tyan * things have slipped in, so we provide generic services to talk to the 13c8d3328aSHung-ying Tyan * KBC. 14c8d3328aSHung-ying Tyan */ 15c8d3328aSHung-ying Tyan 16c8d3328aSHung-ying Tyan #include <common.h> 17*72a38e06SSimon Glass #include <dm.h> 18c8d3328aSHung-ying Tyan #include <command.h> 19c8d3328aSHung-ying Tyan #include <cros_ec.h> 20c8d3328aSHung-ying Tyan #include <asm/io.h> 21c8d3328aSHung-ying Tyan 22c8d3328aSHung-ying Tyan #ifdef DEBUG_TRACE 23c8d3328aSHung-ying Tyan #define debug_trace(fmt, b...) debug(fmt, ##b) 24c8d3328aSHung-ying Tyan #else 25c8d3328aSHung-ying Tyan #define debug_trace(fmt, b...) 26c8d3328aSHung-ying Tyan #endif 27c8d3328aSHung-ying Tyan 28c8d3328aSHung-ying Tyan static int wait_for_sync(struct cros_ec_dev *dev) 29c8d3328aSHung-ying Tyan { 30c8d3328aSHung-ying Tyan unsigned long start; 31c8d3328aSHung-ying Tyan 32c8d3328aSHung-ying Tyan start = get_timer(0); 33c8d3328aSHung-ying Tyan while (inb(EC_LPC_ADDR_HOST_CMD) & EC_LPC_STATUS_BUSY_MASK) { 34c8d3328aSHung-ying Tyan if (get_timer(start) > 1000) { 35c8d3328aSHung-ying Tyan debug("%s: Timeout waiting for CROS_EC sync\n", 36c8d3328aSHung-ying Tyan __func__); 37c8d3328aSHung-ying Tyan return -1; 38c8d3328aSHung-ying Tyan } 39c8d3328aSHung-ying Tyan } 40c8d3328aSHung-ying Tyan 41c8d3328aSHung-ying Tyan return 0; 42c8d3328aSHung-ying Tyan } 43c8d3328aSHung-ying Tyan 44*72a38e06SSimon Glass #ifdef CONFIG_DM_CROS_EC 45*72a38e06SSimon Glass int cros_ec_lpc_command(struct udevice *udev, uint8_t cmd, int cmd_version, 46*72a38e06SSimon Glass const uint8_t *dout, int dout_len, 47*72a38e06SSimon Glass uint8_t **dinp, int din_len) 48*72a38e06SSimon Glass { 49*72a38e06SSimon Glass struct cros_ec_dev *dev = dev_get_uclass_priv(udev); 50*72a38e06SSimon Glass #else 51c8d3328aSHung-ying Tyan int cros_ec_lpc_command(struct cros_ec_dev *dev, uint8_t cmd, int cmd_version, 52c8d3328aSHung-ying Tyan const uint8_t *dout, int dout_len, 53c8d3328aSHung-ying Tyan uint8_t **dinp, int din_len) 54c8d3328aSHung-ying Tyan { 55*72a38e06SSimon Glass #endif 56c8d3328aSHung-ying Tyan const int cmd_addr = EC_LPC_ADDR_HOST_CMD; 57c8d3328aSHung-ying Tyan const int data_addr = EC_LPC_ADDR_HOST_DATA; 58c8d3328aSHung-ying Tyan const int args_addr = EC_LPC_ADDR_HOST_ARGS; 59c8d3328aSHung-ying Tyan const int param_addr = EC_LPC_ADDR_HOST_PARAM; 60c8d3328aSHung-ying Tyan 61c8d3328aSHung-ying Tyan struct ec_lpc_host_args args; 62c8d3328aSHung-ying Tyan uint8_t *d; 63c8d3328aSHung-ying Tyan int csum; 64c8d3328aSHung-ying Tyan int i; 65c8d3328aSHung-ying Tyan 66f1269925SSimon Glass if (dout_len > EC_PROTO2_MAX_PARAM_SIZE) { 67c8d3328aSHung-ying Tyan debug("%s: Cannot send %d bytes\n", __func__, dout_len); 68c8d3328aSHung-ying Tyan return -1; 69c8d3328aSHung-ying Tyan } 70c8d3328aSHung-ying Tyan 71c8d3328aSHung-ying Tyan /* Fill in args */ 72c8d3328aSHung-ying Tyan args.flags = EC_HOST_ARGS_FLAG_FROM_HOST; 73c8d3328aSHung-ying Tyan args.command_version = cmd_version; 74c8d3328aSHung-ying Tyan args.data_size = dout_len; 75c8d3328aSHung-ying Tyan 76c8d3328aSHung-ying Tyan /* Calculate checksum */ 77c8d3328aSHung-ying Tyan csum = cmd + args.flags + args.command_version + args.data_size; 78c8d3328aSHung-ying Tyan for (i = 0, d = (uint8_t *)dout; i < dout_len; i++, d++) 79c8d3328aSHung-ying Tyan csum += *d; 80c8d3328aSHung-ying Tyan 81c8d3328aSHung-ying Tyan args.checksum = (uint8_t)csum; 82c8d3328aSHung-ying Tyan 83c8d3328aSHung-ying Tyan if (wait_for_sync(dev)) { 84c8d3328aSHung-ying Tyan debug("%s: Timeout waiting ready\n", __func__); 85c8d3328aSHung-ying Tyan return -1; 86c8d3328aSHung-ying Tyan } 87c8d3328aSHung-ying Tyan 88c8d3328aSHung-ying Tyan /* Write args */ 89c8d3328aSHung-ying Tyan for (i = 0, d = (uint8_t *)&args; i < sizeof(args); i++, d++) 90c8d3328aSHung-ying Tyan outb(*d, args_addr + i); 91c8d3328aSHung-ying Tyan 92c8d3328aSHung-ying Tyan /* Write data, if any */ 93c8d3328aSHung-ying Tyan debug_trace("cmd: %02x, ver: %02x", cmd, cmd_version); 94c8d3328aSHung-ying Tyan for (i = 0, d = (uint8_t *)dout; i < dout_len; i++, d++) { 95c8d3328aSHung-ying Tyan outb(*d, param_addr + i); 96c8d3328aSHung-ying Tyan debug_trace("%02x ", *d); 97c8d3328aSHung-ying Tyan } 98c8d3328aSHung-ying Tyan 99c8d3328aSHung-ying Tyan outb(cmd, cmd_addr); 100c8d3328aSHung-ying Tyan debug_trace("\n"); 101c8d3328aSHung-ying Tyan 102c8d3328aSHung-ying Tyan if (wait_for_sync(dev)) { 103c8d3328aSHung-ying Tyan debug("%s: Timeout waiting for response\n", __func__); 104c8d3328aSHung-ying Tyan return -1; 105c8d3328aSHung-ying Tyan } 106c8d3328aSHung-ying Tyan 107c8d3328aSHung-ying Tyan /* Check result */ 108c8d3328aSHung-ying Tyan i = inb(data_addr); 109c8d3328aSHung-ying Tyan if (i) { 110c8d3328aSHung-ying Tyan debug("%s: CROS_EC result code %d\n", __func__, i); 111c8d3328aSHung-ying Tyan return -i; 112c8d3328aSHung-ying Tyan } 113c8d3328aSHung-ying Tyan 114c8d3328aSHung-ying Tyan /* Read back args */ 115c8d3328aSHung-ying Tyan for (i = 0, d = (uint8_t *)&args; i < sizeof(args); i++, d++) 116c8d3328aSHung-ying Tyan *d = inb(args_addr + i); 117c8d3328aSHung-ying Tyan 118c8d3328aSHung-ying Tyan /* 119c8d3328aSHung-ying Tyan * If EC didn't modify args flags, then somehow we sent a new-style 120c8d3328aSHung-ying Tyan * command to an old EC, which means it would have read its params 121c8d3328aSHung-ying Tyan * from the wrong place. 122c8d3328aSHung-ying Tyan */ 123c8d3328aSHung-ying Tyan if (!(args.flags & EC_HOST_ARGS_FLAG_TO_HOST)) { 124c8d3328aSHung-ying Tyan debug("%s: CROS_EC protocol mismatch\n", __func__); 125c8d3328aSHung-ying Tyan return -EC_RES_INVALID_RESPONSE; 126c8d3328aSHung-ying Tyan } 127c8d3328aSHung-ying Tyan 128c8d3328aSHung-ying Tyan if (args.data_size > din_len) { 129c8d3328aSHung-ying Tyan debug("%s: CROS_EC returned too much data %d > %d\n", 130c8d3328aSHung-ying Tyan __func__, args.data_size, din_len); 131c8d3328aSHung-ying Tyan return -EC_RES_INVALID_RESPONSE; 132c8d3328aSHung-ying Tyan } 133c8d3328aSHung-ying Tyan 134c8d3328aSHung-ying Tyan /* Read data, if any */ 135c8d3328aSHung-ying Tyan for (i = 0, d = (uint8_t *)dev->din; i < args.data_size; i++, d++) { 136c8d3328aSHung-ying Tyan *d = inb(param_addr + i); 137c8d3328aSHung-ying Tyan debug_trace("%02x ", *d); 138c8d3328aSHung-ying Tyan } 139c8d3328aSHung-ying Tyan debug_trace("\n"); 140c8d3328aSHung-ying Tyan 141c8d3328aSHung-ying Tyan /* Verify checksum */ 142c8d3328aSHung-ying Tyan csum = cmd + args.flags + args.command_version + args.data_size; 143c8d3328aSHung-ying Tyan for (i = 0, d = (uint8_t *)dev->din; i < args.data_size; i++, d++) 144c8d3328aSHung-ying Tyan csum += *d; 145c8d3328aSHung-ying Tyan 146c8d3328aSHung-ying Tyan if (args.checksum != (uint8_t)csum) { 147c8d3328aSHung-ying Tyan debug("%s: CROS_EC response has invalid checksum\n", __func__); 148c8d3328aSHung-ying Tyan return -EC_RES_INVALID_CHECKSUM; 149c8d3328aSHung-ying Tyan } 150c8d3328aSHung-ying Tyan *dinp = dev->din; 151c8d3328aSHung-ying Tyan 152c8d3328aSHung-ying Tyan /* Return actual amount of data received */ 153c8d3328aSHung-ying Tyan return args.data_size; 154c8d3328aSHung-ying Tyan } 155c8d3328aSHung-ying Tyan 156c8d3328aSHung-ying Tyan /** 157c8d3328aSHung-ying Tyan * Initialize LPC protocol. 158c8d3328aSHung-ying Tyan * 159c8d3328aSHung-ying Tyan * @param dev CROS_EC device 160c8d3328aSHung-ying Tyan * @param blob Device tree blob 161c8d3328aSHung-ying Tyan * @return 0 if ok, -1 on error 162c8d3328aSHung-ying Tyan */ 163c8d3328aSHung-ying Tyan int cros_ec_lpc_init(struct cros_ec_dev *dev, const void *blob) 164c8d3328aSHung-ying Tyan { 165c8d3328aSHung-ying Tyan int byte, i; 166c8d3328aSHung-ying Tyan 167c8d3328aSHung-ying Tyan /* See if we can find an EC at the other end */ 168c8d3328aSHung-ying Tyan byte = 0xff; 169c8d3328aSHung-ying Tyan byte &= inb(EC_LPC_ADDR_HOST_CMD); 170c8d3328aSHung-ying Tyan byte &= inb(EC_LPC_ADDR_HOST_DATA); 171f1269925SSimon Glass for (i = 0; i < EC_PROTO2_MAX_PARAM_SIZE && (byte == 0xff); i++) 172c8d3328aSHung-ying Tyan byte &= inb(EC_LPC_ADDR_HOST_PARAM + i); 173c8d3328aSHung-ying Tyan if (byte == 0xff) { 174c8d3328aSHung-ying Tyan debug("%s: CROS_EC device not found on LPC bus\n", 175c8d3328aSHung-ying Tyan __func__); 176c8d3328aSHung-ying Tyan return -1; 177c8d3328aSHung-ying Tyan } 178c8d3328aSHung-ying Tyan 179c8d3328aSHung-ying Tyan return 0; 180c8d3328aSHung-ying Tyan } 181c8d3328aSHung-ying Tyan 182c8d3328aSHung-ying Tyan /* 183c8d3328aSHung-ying Tyan * Test if LPC command args are supported. 184c8d3328aSHung-ying Tyan * 185c8d3328aSHung-ying Tyan * The cheapest way to do this is by looking for the memory-mapped 186c8d3328aSHung-ying Tyan * flag. This is faster than sending a new-style 'hello' command and 187c8d3328aSHung-ying Tyan * seeing whether the EC sets the EC_HOST_ARGS_FLAG_FROM_HOST flag 188c8d3328aSHung-ying Tyan * in args when it responds. 189c8d3328aSHung-ying Tyan */ 190*72a38e06SSimon Glass #ifdef CONFIG_DM_CROS_EC 191*72a38e06SSimon Glass static int cros_ec_lpc_check_version(struct udevice *dev) 192*72a38e06SSimon Glass #else 193c8d3328aSHung-ying Tyan int cros_ec_lpc_check_version(struct cros_ec_dev *dev) 194*72a38e06SSimon Glass #endif 195c8d3328aSHung-ying Tyan { 196c8d3328aSHung-ying Tyan if (inb(EC_LPC_ADDR_MEMMAP + EC_MEMMAP_ID) == 'E' && 197c8d3328aSHung-ying Tyan inb(EC_LPC_ADDR_MEMMAP + EC_MEMMAP_ID + 1) 198c8d3328aSHung-ying Tyan == 'C' && 199c8d3328aSHung-ying Tyan (inb(EC_LPC_ADDR_MEMMAP + 200c8d3328aSHung-ying Tyan EC_MEMMAP_HOST_CMD_FLAGS) & 201c8d3328aSHung-ying Tyan EC_HOST_CMD_FLAG_LPC_ARGS_SUPPORTED)) { 202c8d3328aSHung-ying Tyan return 0; 203c8d3328aSHung-ying Tyan } 2044ff9b461SVadim Bendebury 2054ff9b461SVadim Bendebury printf("%s: ERROR: old EC interface not supported\n", __func__); 2064ff9b461SVadim Bendebury return -1; 2074ff9b461SVadim Bendebury } 208*72a38e06SSimon Glass 209*72a38e06SSimon Glass #ifdef CONFIG_DM_CROS_EC 210*72a38e06SSimon Glass static int cros_ec_probe(struct udevice *dev) 211*72a38e06SSimon Glass { 212*72a38e06SSimon Glass return cros_ec_register(dev); 213*72a38e06SSimon Glass } 214*72a38e06SSimon Glass 215*72a38e06SSimon Glass static struct dm_cros_ec_ops cros_ec_ops = { 216*72a38e06SSimon Glass .command = cros_ec_lpc_command, 217*72a38e06SSimon Glass .check_version = cros_ec_lpc_check_version, 218*72a38e06SSimon Glass }; 219*72a38e06SSimon Glass 220*72a38e06SSimon Glass static const struct udevice_id cros_ec_ids[] = { 221*72a38e06SSimon Glass { .compatible = "google,cros-ec" }, 222*72a38e06SSimon Glass { } 223*72a38e06SSimon Glass }; 224*72a38e06SSimon Glass 225*72a38e06SSimon Glass U_BOOT_DRIVER(cros_ec_lpc) = { 226*72a38e06SSimon Glass .name = "cros_ec", 227*72a38e06SSimon Glass .id = UCLASS_CROS_EC, 228*72a38e06SSimon Glass .of_match = cros_ec_ids, 229*72a38e06SSimon Glass .probe = cros_ec_probe, 230*72a38e06SSimon Glass .ops = &cros_ec_ops, 231*72a38e06SSimon Glass }; 232*72a38e06SSimon Glass #endif 233