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> 17c8d3328aSHung-ying Tyan #include <command.h> 18c8d3328aSHung-ying Tyan #include <cros_ec.h> 19c8d3328aSHung-ying Tyan #include <asm/io.h> 20c8d3328aSHung-ying Tyan 21c8d3328aSHung-ying Tyan #ifdef DEBUG_TRACE 22c8d3328aSHung-ying Tyan #define debug_trace(fmt, b...) debug(fmt, ##b) 23c8d3328aSHung-ying Tyan #else 24c8d3328aSHung-ying Tyan #define debug_trace(fmt, b...) 25c8d3328aSHung-ying Tyan #endif 26c8d3328aSHung-ying Tyan 27c8d3328aSHung-ying Tyan static int wait_for_sync(struct cros_ec_dev *dev) 28c8d3328aSHung-ying Tyan { 29c8d3328aSHung-ying Tyan unsigned long start; 30c8d3328aSHung-ying Tyan 31c8d3328aSHung-ying Tyan start = get_timer(0); 32c8d3328aSHung-ying Tyan while (inb(EC_LPC_ADDR_HOST_CMD) & EC_LPC_STATUS_BUSY_MASK) { 33c8d3328aSHung-ying Tyan if (get_timer(start) > 1000) { 34c8d3328aSHung-ying Tyan debug("%s: Timeout waiting for CROS_EC sync\n", 35c8d3328aSHung-ying Tyan __func__); 36c8d3328aSHung-ying Tyan return -1; 37c8d3328aSHung-ying Tyan } 38c8d3328aSHung-ying Tyan } 39c8d3328aSHung-ying Tyan 40c8d3328aSHung-ying Tyan return 0; 41c8d3328aSHung-ying Tyan } 42c8d3328aSHung-ying Tyan 43c8d3328aSHung-ying Tyan int cros_ec_lpc_command(struct cros_ec_dev *dev, uint8_t cmd, int cmd_version, 44c8d3328aSHung-ying Tyan const uint8_t *dout, int dout_len, 45c8d3328aSHung-ying Tyan uint8_t **dinp, int din_len) 46c8d3328aSHung-ying Tyan { 47c8d3328aSHung-ying Tyan const int cmd_addr = EC_LPC_ADDR_HOST_CMD; 48c8d3328aSHung-ying Tyan const int data_addr = EC_LPC_ADDR_HOST_DATA; 49c8d3328aSHung-ying Tyan const int args_addr = EC_LPC_ADDR_HOST_ARGS; 50c8d3328aSHung-ying Tyan const int param_addr = EC_LPC_ADDR_HOST_PARAM; 51c8d3328aSHung-ying Tyan 52c8d3328aSHung-ying Tyan struct ec_lpc_host_args args; 53c8d3328aSHung-ying Tyan uint8_t *d; 54c8d3328aSHung-ying Tyan int csum; 55c8d3328aSHung-ying Tyan int i; 56c8d3328aSHung-ying Tyan 57c8d3328aSHung-ying Tyan if (dout_len > EC_HOST_PARAM_SIZE) { 58c8d3328aSHung-ying Tyan debug("%s: Cannot send %d bytes\n", __func__, dout_len); 59c8d3328aSHung-ying Tyan return -1; 60c8d3328aSHung-ying Tyan } 61c8d3328aSHung-ying Tyan 62c8d3328aSHung-ying Tyan /* Fill in args */ 63c8d3328aSHung-ying Tyan args.flags = EC_HOST_ARGS_FLAG_FROM_HOST; 64c8d3328aSHung-ying Tyan args.command_version = cmd_version; 65c8d3328aSHung-ying Tyan args.data_size = dout_len; 66c8d3328aSHung-ying Tyan 67c8d3328aSHung-ying Tyan /* Calculate checksum */ 68c8d3328aSHung-ying Tyan csum = cmd + args.flags + args.command_version + args.data_size; 69c8d3328aSHung-ying Tyan for (i = 0, d = (uint8_t *)dout; i < dout_len; i++, d++) 70c8d3328aSHung-ying Tyan csum += *d; 71c8d3328aSHung-ying Tyan 72c8d3328aSHung-ying Tyan args.checksum = (uint8_t)csum; 73c8d3328aSHung-ying Tyan 74c8d3328aSHung-ying Tyan if (wait_for_sync(dev)) { 75c8d3328aSHung-ying Tyan debug("%s: Timeout waiting ready\n", __func__); 76c8d3328aSHung-ying Tyan return -1; 77c8d3328aSHung-ying Tyan } 78c8d3328aSHung-ying Tyan 79c8d3328aSHung-ying Tyan /* Write args */ 80c8d3328aSHung-ying Tyan for (i = 0, d = (uint8_t *)&args; i < sizeof(args); i++, d++) 81c8d3328aSHung-ying Tyan outb(*d, args_addr + i); 82c8d3328aSHung-ying Tyan 83c8d3328aSHung-ying Tyan /* Write data, if any */ 84c8d3328aSHung-ying Tyan debug_trace("cmd: %02x, ver: %02x", cmd, cmd_version); 85c8d3328aSHung-ying Tyan for (i = 0, d = (uint8_t *)dout; i < dout_len; i++, d++) { 86c8d3328aSHung-ying Tyan outb(*d, param_addr + i); 87c8d3328aSHung-ying Tyan debug_trace("%02x ", *d); 88c8d3328aSHung-ying Tyan } 89c8d3328aSHung-ying Tyan 90c8d3328aSHung-ying Tyan outb(cmd, cmd_addr); 91c8d3328aSHung-ying Tyan debug_trace("\n"); 92c8d3328aSHung-ying Tyan 93c8d3328aSHung-ying Tyan if (wait_for_sync(dev)) { 94c8d3328aSHung-ying Tyan debug("%s: Timeout waiting for response\n", __func__); 95c8d3328aSHung-ying Tyan return -1; 96c8d3328aSHung-ying Tyan } 97c8d3328aSHung-ying Tyan 98c8d3328aSHung-ying Tyan /* Check result */ 99c8d3328aSHung-ying Tyan i = inb(data_addr); 100c8d3328aSHung-ying Tyan if (i) { 101c8d3328aSHung-ying Tyan debug("%s: CROS_EC result code %d\n", __func__, i); 102c8d3328aSHung-ying Tyan return -i; 103c8d3328aSHung-ying Tyan } 104c8d3328aSHung-ying Tyan 105c8d3328aSHung-ying Tyan /* Read back args */ 106c8d3328aSHung-ying Tyan for (i = 0, d = (uint8_t *)&args; i < sizeof(args); i++, d++) 107c8d3328aSHung-ying Tyan *d = inb(args_addr + i); 108c8d3328aSHung-ying Tyan 109c8d3328aSHung-ying Tyan /* 110c8d3328aSHung-ying Tyan * If EC didn't modify args flags, then somehow we sent a new-style 111c8d3328aSHung-ying Tyan * command to an old EC, which means it would have read its params 112c8d3328aSHung-ying Tyan * from the wrong place. 113c8d3328aSHung-ying Tyan */ 114c8d3328aSHung-ying Tyan if (!(args.flags & EC_HOST_ARGS_FLAG_TO_HOST)) { 115c8d3328aSHung-ying Tyan debug("%s: CROS_EC protocol mismatch\n", __func__); 116c8d3328aSHung-ying Tyan return -EC_RES_INVALID_RESPONSE; 117c8d3328aSHung-ying Tyan } 118c8d3328aSHung-ying Tyan 119c8d3328aSHung-ying Tyan if (args.data_size > din_len) { 120c8d3328aSHung-ying Tyan debug("%s: CROS_EC returned too much data %d > %d\n", 121c8d3328aSHung-ying Tyan __func__, args.data_size, din_len); 122c8d3328aSHung-ying Tyan return -EC_RES_INVALID_RESPONSE; 123c8d3328aSHung-ying Tyan } 124c8d3328aSHung-ying Tyan 125c8d3328aSHung-ying Tyan /* Read data, if any */ 126c8d3328aSHung-ying Tyan for (i = 0, d = (uint8_t *)dev->din; i < args.data_size; i++, d++) { 127c8d3328aSHung-ying Tyan *d = inb(param_addr + i); 128c8d3328aSHung-ying Tyan debug_trace("%02x ", *d); 129c8d3328aSHung-ying Tyan } 130c8d3328aSHung-ying Tyan debug_trace("\n"); 131c8d3328aSHung-ying Tyan 132c8d3328aSHung-ying Tyan /* Verify checksum */ 133c8d3328aSHung-ying Tyan csum = cmd + args.flags + args.command_version + args.data_size; 134c8d3328aSHung-ying Tyan for (i = 0, d = (uint8_t *)dev->din; i < args.data_size; i++, d++) 135c8d3328aSHung-ying Tyan csum += *d; 136c8d3328aSHung-ying Tyan 137c8d3328aSHung-ying Tyan if (args.checksum != (uint8_t)csum) { 138c8d3328aSHung-ying Tyan debug("%s: CROS_EC response has invalid checksum\n", __func__); 139c8d3328aSHung-ying Tyan return -EC_RES_INVALID_CHECKSUM; 140c8d3328aSHung-ying Tyan } 141c8d3328aSHung-ying Tyan *dinp = dev->din; 142c8d3328aSHung-ying Tyan 143c8d3328aSHung-ying Tyan /* Return actual amount of data received */ 144c8d3328aSHung-ying Tyan return args.data_size; 145c8d3328aSHung-ying Tyan } 146c8d3328aSHung-ying Tyan 147c8d3328aSHung-ying Tyan /** 148c8d3328aSHung-ying Tyan * Initialize LPC protocol. 149c8d3328aSHung-ying Tyan * 150c8d3328aSHung-ying Tyan * @param dev CROS_EC device 151c8d3328aSHung-ying Tyan * @param blob Device tree blob 152c8d3328aSHung-ying Tyan * @return 0 if ok, -1 on error 153c8d3328aSHung-ying Tyan */ 154c8d3328aSHung-ying Tyan int cros_ec_lpc_init(struct cros_ec_dev *dev, const void *blob) 155c8d3328aSHung-ying Tyan { 156c8d3328aSHung-ying Tyan int byte, i; 157c8d3328aSHung-ying Tyan 158c8d3328aSHung-ying Tyan /* See if we can find an EC at the other end */ 159c8d3328aSHung-ying Tyan byte = 0xff; 160c8d3328aSHung-ying Tyan byte &= inb(EC_LPC_ADDR_HOST_CMD); 161c8d3328aSHung-ying Tyan byte &= inb(EC_LPC_ADDR_HOST_DATA); 162c8d3328aSHung-ying Tyan for (i = 0; i < EC_HOST_PARAM_SIZE && (byte == 0xff); i++) 163c8d3328aSHung-ying Tyan byte &= inb(EC_LPC_ADDR_HOST_PARAM + i); 164c8d3328aSHung-ying Tyan if (byte == 0xff) { 165c8d3328aSHung-ying Tyan debug("%s: CROS_EC device not found on LPC bus\n", 166c8d3328aSHung-ying Tyan __func__); 167c8d3328aSHung-ying Tyan return -1; 168c8d3328aSHung-ying Tyan } 169c8d3328aSHung-ying Tyan 170c8d3328aSHung-ying Tyan return 0; 171c8d3328aSHung-ying Tyan } 172c8d3328aSHung-ying Tyan 173c8d3328aSHung-ying Tyan /* 174c8d3328aSHung-ying Tyan * Test if LPC command args are supported. 175c8d3328aSHung-ying Tyan * 176c8d3328aSHung-ying Tyan * The cheapest way to do this is by looking for the memory-mapped 177c8d3328aSHung-ying Tyan * flag. This is faster than sending a new-style 'hello' command and 178c8d3328aSHung-ying Tyan * seeing whether the EC sets the EC_HOST_ARGS_FLAG_FROM_HOST flag 179c8d3328aSHung-ying Tyan * in args when it responds. 180c8d3328aSHung-ying Tyan */ 181c8d3328aSHung-ying Tyan int cros_ec_lpc_check_version(struct cros_ec_dev *dev) 182c8d3328aSHung-ying Tyan { 183c8d3328aSHung-ying Tyan if (inb(EC_LPC_ADDR_MEMMAP + EC_MEMMAP_ID) == 'E' && 184c8d3328aSHung-ying Tyan inb(EC_LPC_ADDR_MEMMAP + EC_MEMMAP_ID + 1) 185c8d3328aSHung-ying Tyan == 'C' && 186c8d3328aSHung-ying Tyan (inb(EC_LPC_ADDR_MEMMAP + 187c8d3328aSHung-ying Tyan EC_MEMMAP_HOST_CMD_FLAGS) & 188c8d3328aSHung-ying Tyan EC_HOST_CMD_FLAG_LPC_ARGS_SUPPORTED)) { 189c8d3328aSHung-ying Tyan return 0; 190c8d3328aSHung-ying Tyan } 191*4ff9b461SVadim Bendebury 192*4ff9b461SVadim Bendebury printf("%s: ERROR: old EC interface not supported\n", __func__); 193*4ff9b461SVadim Bendebury return -1; 194*4ff9b461SVadim Bendebury } 195