Blame view
include/tpm-common.h
7.97 KB
d677bfe2f tpm: disociate TP... |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 |
/* SPDX-License-Identifier: GPL-2.0+ */ /* * Copyright (c) 2013 The Chromium OS Authors. * Coypright (c) 2013 Guntermann & Drunck GmbH */ #ifndef __TPM_COMMON_H #define __TPM_COMMON_H enum tpm_duration { TPM_SHORT = 0, TPM_MEDIUM = 1, TPM_LONG = 2, TPM_UNDEFINED, TPM_DURATION_COUNT, }; /* * Here is a partial implementation of TPM commands. Please consult TCG Main * Specification for definitions of TPM commands. */ #define TPM_HEADER_SIZE 10 /* Max buffer size supported by our tpm */ #define TPM_DEV_BUFSIZE 1260 |
07e127d85 tpm: Add a consta... |
28 |
#define TPM_PCR_MINIMUM_DIGEST_SIZE 20 |
d677bfe2f tpm: disociate TP... |
29 |
/** |
2a2096ea6 tpm: allow TPM v1... |
30 31 32 33 34 35 36 37 38 39 |
* enum tpm_version - The version of the TPM stack to be used * @TPM_V1: Use TPM v1.x stack * @TPM_V2: Use TPM v2.x stack */ enum tpm_version { TPM_V1 = 0, TPM_V2, }; /** |
d677bfe2f tpm: disociate TP... |
40 41 42 43 44 45 |
* struct tpm_chip_priv - Information about a TPM, stored by the uclass * * These values must be set up by the device's probe() method before * communcation is attempted. If the device has an xfer() method, this is * not needed. There is no need to set up @buf. * |
2a2096ea6 tpm: allow TPM v1... |
46 |
* @version: TPM stack to be used |
d677bfe2f tpm: disociate TP... |
47 48 |
* @duration_ms: Length of each duration type in milliseconds * @retry_time_ms: Time to wait before retrying receive |
2a2096ea6 tpm: allow TPM v1... |
49 |
* @buf: Buffer used during the exchanges with the chip |
ff32245bb tpm: prepare supp... |
50 51 |
* @pcr_count: Number of PCR per bank * @pcr_select_min: Minimum size in bytes of the pcrSelect array |
d677bfe2f tpm: disociate TP... |
52 53 |
*/ struct tpm_chip_priv { |
2a2096ea6 tpm: allow TPM v1... |
54 |
enum tpm_version version; |
d677bfe2f tpm: disociate TP... |
55 56 |
uint duration_ms[TPM_DURATION_COUNT]; uint retry_time_ms; |
2a2096ea6 tpm: allow TPM v1... |
57 58 59 |
u8 buf[TPM_DEV_BUFSIZE + sizeof(u8)]; /* Max buffer size + addr */ /* TPM v2 specific data */ |
ff32245bb tpm: prepare supp... |
60 61 |
uint pcr_count; uint pcr_select_min; |
d677bfe2f tpm: disociate TP... |
62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 |
}; /** * struct tpm_ops - low-level TPM operations * * These are designed to avoid loops and delays in the driver itself. These * should be handled in the uclass. * * In gneral you should implement everything except xfer(). Where you need * complete control of the transfer, then xfer() can be provided and will * override the other methods. * * This interface is for low-level TPM access. It does not understand the * concept of localities or the various TPM messages. That interface is * defined in the functions later on in this file, but they all translate * to bytes which are sent and received. */ struct tpm_ops { /** * open() - Request access to locality 0 for the caller * * After all commands have been completed the caller should call * close(). * |
350988ff1 tpm: fix typo in ... |
86 |
* @dev: Device to open |
d677bfe2f tpm: disociate TP... |
87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 |
* @return 0 ok OK, -ve on error */ int (*open)(struct udevice *dev); /** * close() - Close the current session * * Releasing the locked locality. Returns 0 on success, -ve 1 on * failure (in case lock removal did not succeed). * * @dev: Device to close * @return 0 ok OK, -ve on error */ int (*close)(struct udevice *dev); /** * get_desc() - Get a text description of the TPM * * @dev: Device to check * @buf: Buffer to put the string * @size: Maximum size of buffer * @return length of string, or -ENOSPC it no space */ int (*get_desc)(struct udevice *dev, char *buf, int size); /** * send() - send data to the TPM * * @dev: Device to talk to * @sendbuf: Buffer of the data to send * @send_size: Size of the data to send * * Returns 0 on success or -ve on failure. */ int (*send)(struct udevice *dev, const u8 *sendbuf, size_t send_size); /** * recv() - receive a response from the TPM * * @dev: Device to talk to * @recvbuf: Buffer to save the response to * @max_size: Maximum number of bytes to receive * * Returns number of bytes received on success, -EAGAIN if the TPM * response is not ready, -EINTR if cancelled, or other -ve value on * failure. */ int (*recv)(struct udevice *dev, u8 *recvbuf, size_t max_size); /** * cleanup() - clean up after an operation in progress * * This is called if receiving times out. The TPM may need to abort * the current transaction if it did not complete, and make itself * ready for another. * * @dev: Device to talk to */ int (*cleanup)(struct udevice *dev); /** * xfer() - send data to the TPM and get response * * This method is optional. If it exists it is used in preference * to send(), recv() and cleanup(). It should handle all aspects of * TPM communication for a single transfer. * * @dev: Device to talk to * @sendbuf: Buffer of the data to send * @send_size: Size of the data to send * @recvbuf: Buffer to save the response to * @recv_size: Pointer to the size of the response buffer * * Returns 0 on success (and places the number of response bytes at * recv_size) or -ve on failure. */ int (*xfer)(struct udevice *dev, const u8 *sendbuf, size_t send_size, u8 *recvbuf, size_t *recv_size); }; #define tpm_get_ops(dev) ((struct tpm_ops *)device_get_ops(dev)) #define MAKE_TPM_CMD_ENTRY(cmd) \ U_BOOT_CMD_MKENT(cmd, 0, 1, do_tpm_ ## cmd, "", "") #define TPM_COMMAND_NO_ARG(cmd) \ int do_##cmd(cmd_tbl_t *cmdtp, int flag, \ int argc, char * const argv[]) \ { \ |
abdc7b8a2 tpm: Convert to u... |
176 177 178 179 180 181 |
struct udevice *dev; \ int rc; \ \ rc = get_tpm(&dev); \ if (rc) \ return rc; \ |
d677bfe2f tpm: disociate TP... |
182 183 |
if (argc != 1) \ return CMD_RET_USAGE; \ |
abdc7b8a2 tpm: Convert to u... |
184 |
return report_return_code(cmd(dev)); \ |
d677bfe2f tpm: disociate TP... |
185 186 187 |
} /** |
51f00c170 tpm: Export the o... |
188 189 190 191 192 |
* tpm_open() - Request access to locality 0 for the caller * * After all commands have been completed the caller is supposed to * call tpm_close(). * |
abdc7b8a2 tpm: Convert to u... |
193 |
* @dev - TPM device |
51f00c170 tpm: Export the o... |
194 195 196 197 198 199 200 201 202 |
* Returns 0 on success, -ve on failure. */ int tpm_open(struct udevice *dev); /** * tpm_close() - Close the current session * * Releasing the locked locality. Returns 0 on success, -ve 1 on * failure (in case lock removal did not succeed). |
abdc7b8a2 tpm: Convert to u... |
203 204 205 |
* * @dev - TPM device * Returns 0 on success, -ve on failure. |
51f00c170 tpm: Export the o... |
206 207 208 209 |
*/ int tpm_close(struct udevice *dev); /** |
5e69b8bc0 tpm: Export tpm_c... |
210 211 212 213 214 215 216 217 |
* tpm_clear_and_reenable() - Force clear the TPM and reenable it * * @dev: TPM device * @return 0 on success, -ve on failure */ u32 tpm_clear_and_reenable(struct udevice *dev); /** |
d677bfe2f tpm: disociate TP... |
218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 |
* tpm_get_desc() - Get a text description of the TPM * * @dev: Device to check * @buf: Buffer to put the string * @size: Maximum size of buffer * @return length of string, or -ENOSPC it no space */ int tpm_get_desc(struct udevice *dev, char *buf, int size); /** * tpm_xfer() - send data to the TPM and get response * * This first uses the device's send() method to send the bytes. Then it calls * recv() to get the reply. If recv() returns -EAGAIN then it will delay a * short time and then call recv() again. * * Regardless of whether recv() completes successfully, it will then call * cleanup() to finish the transaction. * * Note that the outgoing data is inspected to determine command type * (ordinal) and a timeout is used for that command type. * |
abdc7b8a2 tpm: Convert to u... |
240 |
* @dev - TPM device |
d677bfe2f tpm: disociate TP... |
241 242 243 244 245 246 247 248 249 250 251 252 253 254 |
* @sendbuf - buffer of the data to send * @send_size size of the data to send * @recvbuf - memory to save the response to * @recv_len - pointer to the size of the response buffer * * Returns 0 on success (and places the number of response bytes at * recv_len) or -ve on failure. */ int tpm_xfer(struct udevice *dev, const u8 *sendbuf, size_t send_size, u8 *recvbuf, size_t *recv_size); /** * Initialize TPM device. It must be called before any TPM commands. * |
abdc7b8a2 tpm: Convert to u... |
255 |
* @dev - TPM device |
d677bfe2f tpm: disociate TP... |
256 257 |
* @return 0 on success, non-0 on error. */ |
abdc7b8a2 tpm: Convert to u... |
258 |
int tpm_init(struct udevice *dev); |
d677bfe2f tpm: disociate TP... |
259 260 |
/** |
2a2096ea6 tpm: allow TPM v1... |
261 |
* Retrieve the array containing all the v1 (resp. v2) commands. |
d677bfe2f tpm: disociate TP... |
262 263 264 |
* * @return a cmd_tbl_t array. */ |
2a2096ea6 tpm: allow TPM v1... |
265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 |
#if defined(CONFIG_TPM_V1) cmd_tbl_t *get_tpm1_commands(unsigned int *size); #else static inline cmd_tbl_t *get_tpm1_commands(unsigned int *size) { return NULL; } #endif #if defined(CONFIG_TPM_V2) cmd_tbl_t *get_tpm2_commands(unsigned int *size); #else static inline cmd_tbl_t *get_tpm2_commands(unsigned int *size) { return NULL; } #endif |
d677bfe2f tpm: disociate TP... |
281 |
|
0a60a0a65 tpm: Remove use o... |
282 283 284 285 286 287 288 289 290 291 |
/** * tpm_get_version() - Find the version of a TPM * * This checks the uclass data for a TPM device and returns the version number * it supports. * * @dev: TPM device * @return version number (TPM_V1 or TPMV2) */ enum tpm_version tpm_get_version(struct udevice *dev); |
bb3f47eb7 tpm: add a helper... |
292 293 |
/* Iterate on all TPM devices */ #define for_each_tpm_device(dev) uclass_foreach_dev_probe(UCLASS_TPM, (dev)) |
d677bfe2f tpm: disociate TP... |
294 |
#endif /* __TPM_COMMON_H */ |