drivers/char/tpm/tpm_tis_core.h

   1 /* SPDX-License-Identifier: GPL-2.0-only */
   2 /*
   3  * Copyright (C) 2005, 2006 IBM Corporation
   4  * Copyright (C) 2014, 2015 Intel Corporation
   5  *
   6  * Authors:
   7  * Leendert van Doorn <leendert@watson.ibm.com>
   8  * Kylene Hall <kjhall@us.ibm.com>
   9  *
  10  * Maintained by: <tpmdd-devel@lists.sourceforge.net>
  11  *
  12  * Device driver for TCG/TCPA TPM (trusted platform module).
  13  * Specifications at www.trustedcomputinggroup.org
  14  *
  15  * This device driver implements the TPM interface as defined in
  16  * the TCG TPM Interface Spec version 1.2, revision 1.0.
  17  */
  18
  19 #ifndef __TPM_TIS_CORE_H__
  20 #define __TPM_TIS_CORE_H__
  21
  22 #include "tpm.h"
  23
  24 enum tis_access {
  25         TPM_ACCESS_VALID = 0x80,
  26         TPM_ACCESS_ACTIVE_LOCALITY = 0x20,
  27         TPM_ACCESS_REQUEST_PENDING = 0x04,
  28         TPM_ACCESS_REQUEST_USE = 0x02,
  29 };
  30
  31 enum tis_status {
  32         TPM_STS_VALID = 0x80,
  33         TPM_STS_COMMAND_READY = 0x40,
  34         TPM_STS_GO = 0x20,
  35         TPM_STS_DATA_AVAIL = 0x10,
  36         TPM_STS_DATA_EXPECT = 0x08,
  37 };
  38
  39 enum tis_int_flags {
  40         TPM_GLOBAL_INT_ENABLE = 0x80000000,
  41         TPM_INTF_BURST_COUNT_STATIC = 0x100,
  42         TPM_INTF_CMD_READY_INT = 0x080,
  43         TPM_INTF_INT_EDGE_FALLING = 0x040,
  44         TPM_INTF_INT_EDGE_RISING = 0x020,
  45         TPM_INTF_INT_LEVEL_LOW = 0x010,
  46         TPM_INTF_INT_LEVEL_HIGH = 0x008,
  47         TPM_INTF_LOCALITY_CHANGE_INT = 0x004,
  48         TPM_INTF_STS_VALID_INT = 0x002,
  49         TPM_INTF_DATA_AVAIL_INT = 0x001,
  50 };
  51
  52 enum tis_defaults {
  53         TIS_MEM_LEN = 0x5000,
  54         TIS_SHORT_TIMEOUT = 750,        /* ms */
  55         TIS_LONG_TIMEOUT = 2000,        /* 2 sec */
  56 };
  57
  58 /* Some timeout values are needed before it is known whether the chip is
  59  * TPM 1.0 or TPM 2.0.
  60  */
  61 #define TIS_TIMEOUT_A_MAX       max_t(int, TIS_SHORT_TIMEOUT, TPM2_TIMEOUT_A)
  62 #define TIS_TIMEOUT_B_MAX       max_t(int, TIS_LONG_TIMEOUT, TPM2_TIMEOUT_B)
  63 #define TIS_TIMEOUT_C_MAX       max_t(int, TIS_SHORT_TIMEOUT, TPM2_TIMEOUT_C)
  64 #define TIS_TIMEOUT_D_MAX       max_t(int, TIS_SHORT_TIMEOUT, TPM2_TIMEOUT_D)
  65
  66 #define TPM_ACCESS(l)                   (0x0000 | ((l) << 12))
  67 #define TPM_INT_ENABLE(l)               (0x0008 | ((l) << 12))
  68 #define TPM_INT_VECTOR(l)               (0x000C | ((l) << 12))
  69 #define TPM_INT_STATUS(l)               (0x0010 | ((l) << 12))
  70 #define TPM_INTF_CAPS(l)                (0x0014 | ((l) << 12))
  71 #define TPM_STS(l)                      (0x0018 | ((l) << 12))
  72 #define TPM_STS3(l)                     (0x001b | ((l) << 12))
  73 #define TPM_DATA_FIFO(l)                (0x0024 | ((l) << 12))
  74
  75 #define TPM_DID_VID(l)                  (0x0F00 | ((l) << 12))
  76 #define TPM_RID(l)                      (0x0F04 | ((l) << 12))
  77
  78 #define LPC_CNTRL_OFFSET                0x84
  79 #define LPC_CLKRUN_EN                   (1 << 2)
  80 #define INTEL_LEGACY_BLK_BASE_ADDR      0xFED08000
  81 #define ILB_REMAP_SIZE                  0x100
  82
  83 enum tpm_tis_flags {
  84         TPM_TIS_ITPM_WORKAROUND         = BIT(0),
  85 };
  86
  87 struct tpm_tis_data {
  88         u16 manufacturer_id;
  89         int locality;
  90         int irq;
  91         bool irq_tested;
  92         unsigned int flags;
  93         void __iomem *ilb_base_addr;
  94         u16 clkrun_enabled;
  95         wait_queue_head_t int_queue;
  96         wait_queue_head_t read_queue;
  97         const struct tpm_tis_phy_ops *phy_ops;
  98         unsigned short rng_quality;
  99 };
 100
 101 struct tpm_tis_phy_ops {
 102         int (*read_bytes)(struct tpm_tis_data *data, u32 addr, u16 len,
 103                           u8 *result);
 104         int (*write_bytes)(struct tpm_tis_data *data, u32 addr, u16 len,
 105                            const u8 *value);
 106         int (*read16)(struct tpm_tis_data *data, u32 addr, u16 *result);
 107         int (*read32)(struct tpm_tis_data *data, u32 addr, u32 *result);
 108         int (*write32)(struct tpm_tis_data *data, u32 addr, u32 src);
 109 };
 110
 111 static inline int tpm_tis_read_bytes(struct tpm_tis_data *data, u32 addr,
 112                                      u16 len, u8 *result)
 113 {
 114         return data->phy_ops->read_bytes(data, addr, len, result);
 115 }
 116
 117 static inline int tpm_tis_read8(struct tpm_tis_data *data, u32 addr, u8 *result)
 118 {
 119         return data->phy_ops->read_bytes(data, addr, 1, result);
 120 }
 121
 122 static inline int tpm_tis_read16(struct tpm_tis_data *data, u32 addr,
 123                                  u16 *result)
 124 {
 125         return data->phy_ops->read16(data, addr, result);
 126 }
 127
 128 static inline int tpm_tis_read32(struct tpm_tis_data *data, u32 addr,
 129                                  u32 *result)
 130 {
 131         return data->phy_ops->read32(data, addr, result);
 132 }
 133
 134 static inline int tpm_tis_write_bytes(struct tpm_tis_data *data, u32 addr,
 135                                       u16 len, const u8 *value)
 136 {
 137         return data->phy_ops->write_bytes(data, addr, len, value);
 138 }
 139
 140 static inline int tpm_tis_write8(struct tpm_tis_data *data, u32 addr, u8 value)
 141 {
 142         return data->phy_ops->write_bytes(data, addr, 1, &value);
 143 }
 144
 145 static inline int tpm_tis_write32(struct tpm_tis_data *data, u32 addr,
 146                                   u32 value)
 147 {
 148         return data->phy_ops->write32(data, addr, value);
 149 }
 150
 151 static inline bool is_bsw(void)
 152 {
 153 #ifdef CONFIG_X86
 154         return ((boot_cpu_data.x86_model == INTEL_FAM6_ATOM_AIRMONT) ? 1 : 0);
 155 #else
 156         return false;
 157 #endif
 158 }
 159
 160 void tpm_tis_remove(struct tpm_chip *chip);
 161 int tpm_tis_core_init(struct device *dev, struct tpm_tis_data *priv, int irq,
 162                       const struct tpm_tis_phy_ops *phy_ops,
 163                       acpi_handle acpi_dev_handle);
 164
 165 #ifdef CONFIG_PM_SLEEP
 166 int tpm_tis_resume(struct device *dev);
 167 #endif
 168
 169 #endif