tpm_tis: Return TPM_VERSION_UNSPEC in case of BE failure
[qemu/ar7.git] / hw / tpm / tpm_tis.c
blobfec2fc617a39c380f49f8b766c60fd6df9867b70
1 /*
2 * tpm_tis.c - QEMU's TPM TIS interface emulator
4 * Copyright (C) 2006,2010-2013 IBM Corporation
6 * Authors:
7 * Stefan Berger <stefanb@us.ibm.com>
8 * David Safford <safford@us.ibm.com>
10 * Xen 4 support: Andrease Niederl <andreas.niederl@iaik.tugraz.at>
12 * This work is licensed under the terms of the GNU GPL, version 2 or later.
13 * See the COPYING file in the top-level directory.
15 * Implementation of the TIS interface according to specs found at
16 * http://www.trustedcomputinggroup.org. This implementation currently
17 * supports version 1.3, 21 March 2013
18 * In the developers menu choose the PC Client section then find the TIS
19 * specification.
21 * TPM TIS for TPM 2 implementation following TCG PC Client Platform
22 * TPM Profile (PTP) Specification, Familiy 2.0, Revision 00.43
25 #include "qemu/osdep.h"
26 #include "hw/isa/isa.h"
27 #include "sysemu/tpm_backend.h"
28 #include "tpm_int.h"
29 #include "sysemu/block-backend.h"
30 #include "exec/address-spaces.h"
31 #include "hw/hw.h"
32 #include "hw/i386/pc.h"
33 #include "hw/pci/pci_ids.h"
34 #include "qapi/error.h"
35 #include "qemu-common.h"
36 #include "qemu/main-loop.h"
37 #include "hw/acpi/tpm.h"
39 #define TPM_TIS_NUM_LOCALITIES 5 /* per spec */
40 #define TPM_TIS_LOCALITY_SHIFT 12
41 #define TPM_TIS_NO_LOCALITY 0xff
43 #define TPM_TIS_IS_VALID_LOCTY(x) ((x) < TPM_TIS_NUM_LOCALITIES)
45 #define TPM_TIS_BUFFER_MAX 4096
47 typedef enum {
48 TPM_TIS_STATE_IDLE = 0,
49 TPM_TIS_STATE_READY,
50 TPM_TIS_STATE_COMPLETION,
51 TPM_TIS_STATE_EXECUTION,
52 TPM_TIS_STATE_RECEPTION,
53 } TPMTISState;
55 typedef struct TPMSizedBuffer {
56 uint32_t size;
57 uint8_t *buffer;
58 } TPMSizedBuffer;
60 /* locality data -- all fields are persisted */
61 typedef struct TPMLocality {
62 TPMTISState state;
63 uint8_t access;
64 uint32_t sts;
65 uint32_t iface_id;
66 uint32_t inte;
67 uint32_t ints;
69 uint16_t w_offset;
70 uint16_t r_offset;
71 TPMSizedBuffer w_buffer;
72 TPMSizedBuffer r_buffer;
73 } TPMLocality;
75 struct TPMState {
76 ISADevice busdev;
77 MemoryRegion mmio;
79 QEMUBH *bh;
80 uint32_t offset;
81 uint8_t buf[TPM_TIS_BUFFER_MAX];
83 uint8_t active_locty;
84 uint8_t aborting_locty;
85 uint8_t next_locty;
87 TPMLocality loc[TPM_TIS_NUM_LOCALITIES];
89 qemu_irq irq;
90 uint32_t irq_num;
92 uint8_t locty_number;
93 TPMBackendCmd cmd;
95 char *backend;
96 TPMBackend *be_driver;
97 TPMVersion be_tpm_version;
100 #define TPM(obj) OBJECT_CHECK(TPMState, (obj), TYPE_TPM_TIS)
102 #define DEBUG_TIS 0
104 #define DPRINTF(fmt, ...) do { \
105 if (DEBUG_TIS) { \
106 printf(fmt, ## __VA_ARGS__); \
108 } while (0);
110 /* tis registers */
111 #define TPM_TIS_REG_ACCESS 0x00
112 #define TPM_TIS_REG_INT_ENABLE 0x08
113 #define TPM_TIS_REG_INT_VECTOR 0x0c
114 #define TPM_TIS_REG_INT_STATUS 0x10
115 #define TPM_TIS_REG_INTF_CAPABILITY 0x14
116 #define TPM_TIS_REG_STS 0x18
117 #define TPM_TIS_REG_DATA_FIFO 0x24
118 #define TPM_TIS_REG_INTERFACE_ID 0x30
119 #define TPM_TIS_REG_DATA_XFIFO 0x80
120 #define TPM_TIS_REG_DATA_XFIFO_END 0xbc
121 #define TPM_TIS_REG_DID_VID 0xf00
122 #define TPM_TIS_REG_RID 0xf04
124 /* vendor-specific registers */
125 #define TPM_TIS_REG_DEBUG 0xf90
127 #define TPM_TIS_STS_TPM_FAMILY_MASK (0x3 << 26)/* TPM 2.0 */
128 #define TPM_TIS_STS_TPM_FAMILY1_2 (0 << 26) /* TPM 2.0 */
129 #define TPM_TIS_STS_TPM_FAMILY2_0 (1 << 26) /* TPM 2.0 */
130 #define TPM_TIS_STS_RESET_ESTABLISHMENT_BIT (1 << 25) /* TPM 2.0 */
131 #define TPM_TIS_STS_COMMAND_CANCEL (1 << 24) /* TPM 2.0 */
133 #define TPM_TIS_STS_VALID (1 << 7)
134 #define TPM_TIS_STS_COMMAND_READY (1 << 6)
135 #define TPM_TIS_STS_TPM_GO (1 << 5)
136 #define TPM_TIS_STS_DATA_AVAILABLE (1 << 4)
137 #define TPM_TIS_STS_EXPECT (1 << 3)
138 #define TPM_TIS_STS_SELFTEST_DONE (1 << 2)
139 #define TPM_TIS_STS_RESPONSE_RETRY (1 << 1)
141 #define TPM_TIS_BURST_COUNT_SHIFT 8
142 #define TPM_TIS_BURST_COUNT(X) \
143 ((X) << TPM_TIS_BURST_COUNT_SHIFT)
145 #define TPM_TIS_ACCESS_TPM_REG_VALID_STS (1 << 7)
146 #define TPM_TIS_ACCESS_ACTIVE_LOCALITY (1 << 5)
147 #define TPM_TIS_ACCESS_BEEN_SEIZED (1 << 4)
148 #define TPM_TIS_ACCESS_SEIZE (1 << 3)
149 #define TPM_TIS_ACCESS_PENDING_REQUEST (1 << 2)
150 #define TPM_TIS_ACCESS_REQUEST_USE (1 << 1)
151 #define TPM_TIS_ACCESS_TPM_ESTABLISHMENT (1 << 0)
153 #define TPM_TIS_INT_ENABLED (1 << 31)
154 #define TPM_TIS_INT_DATA_AVAILABLE (1 << 0)
155 #define TPM_TIS_INT_STS_VALID (1 << 1)
156 #define TPM_TIS_INT_LOCALITY_CHANGED (1 << 2)
157 #define TPM_TIS_INT_COMMAND_READY (1 << 7)
159 #define TPM_TIS_INT_POLARITY_MASK (3 << 3)
160 #define TPM_TIS_INT_POLARITY_LOW_LEVEL (1 << 3)
162 #define TPM_TIS_INTERRUPTS_SUPPORTED (TPM_TIS_INT_LOCALITY_CHANGED | \
163 TPM_TIS_INT_DATA_AVAILABLE | \
164 TPM_TIS_INT_STS_VALID | \
165 TPM_TIS_INT_COMMAND_READY)
167 #define TPM_TIS_CAP_INTERFACE_VERSION1_3 (2 << 28)
168 #define TPM_TIS_CAP_INTERFACE_VERSION1_3_FOR_TPM2_0 (3 << 28)
169 #define TPM_TIS_CAP_DATA_TRANSFER_64B (3 << 9)
170 #define TPM_TIS_CAP_DATA_TRANSFER_LEGACY (0 << 9)
171 #define TPM_TIS_CAP_BURST_COUNT_DYNAMIC (0 << 8)
172 #define TPM_TIS_CAP_INTERRUPT_LOW_LEVEL (1 << 4) /* support is mandatory */
173 #define TPM_TIS_CAPABILITIES_SUPPORTED1_3 \
174 (TPM_TIS_CAP_INTERRUPT_LOW_LEVEL | \
175 TPM_TIS_CAP_BURST_COUNT_DYNAMIC | \
176 TPM_TIS_CAP_DATA_TRANSFER_64B | \
177 TPM_TIS_CAP_INTERFACE_VERSION1_3 | \
178 TPM_TIS_INTERRUPTS_SUPPORTED)
180 #define TPM_TIS_CAPABILITIES_SUPPORTED2_0 \
181 (TPM_TIS_CAP_INTERRUPT_LOW_LEVEL | \
182 TPM_TIS_CAP_BURST_COUNT_DYNAMIC | \
183 TPM_TIS_CAP_DATA_TRANSFER_64B | \
184 TPM_TIS_CAP_INTERFACE_VERSION1_3_FOR_TPM2_0 | \
185 TPM_TIS_INTERRUPTS_SUPPORTED)
187 #define TPM_TIS_IFACE_ID_INTERFACE_TIS1_3 (0xf) /* TPM 2.0 */
188 #define TPM_TIS_IFACE_ID_INTERFACE_FIFO (0x0) /* TPM 2.0 */
189 #define TPM_TIS_IFACE_ID_INTERFACE_VER_FIFO (0 << 4) /* TPM 2.0 */
190 #define TPM_TIS_IFACE_ID_CAP_5_LOCALITIES (1 << 8) /* TPM 2.0 */
191 #define TPM_TIS_IFACE_ID_CAP_TIS_SUPPORTED (1 << 13) /* TPM 2.0 */
192 #define TPM_TIS_IFACE_ID_INT_SEL_LOCK (1 << 19) /* TPM 2.0 */
194 #define TPM_TIS_IFACE_ID_SUPPORTED_FLAGS1_3 \
195 (TPM_TIS_IFACE_ID_INTERFACE_TIS1_3 | \
196 (~0u << 4)/* all of it is don't care */)
198 /* if backend was a TPM 2.0: */
199 #define TPM_TIS_IFACE_ID_SUPPORTED_FLAGS2_0 \
200 (TPM_TIS_IFACE_ID_INTERFACE_FIFO | \
201 TPM_TIS_IFACE_ID_INTERFACE_VER_FIFO | \
202 TPM_TIS_IFACE_ID_CAP_5_LOCALITIES | \
203 TPM_TIS_IFACE_ID_CAP_TIS_SUPPORTED)
205 #define TPM_TIS_TPM_DID 0x0001
206 #define TPM_TIS_TPM_VID PCI_VENDOR_ID_IBM
207 #define TPM_TIS_TPM_RID 0x0001
209 #define TPM_TIS_NO_DATA_BYTE 0xff
211 /* local prototypes */
213 static uint64_t tpm_tis_mmio_read(void *opaque, hwaddr addr,
214 unsigned size);
216 /* utility functions */
218 static uint8_t tpm_tis_locality_from_addr(hwaddr addr)
220 return (uint8_t)((addr >> TPM_TIS_LOCALITY_SHIFT) & 0x7);
223 static uint32_t tpm_tis_get_size_from_buffer(const TPMSizedBuffer *sb)
225 return be32_to_cpu(*(uint32_t *)&sb->buffer[2]);
228 static void tpm_tis_show_buffer(const TPMSizedBuffer *sb, const char *string)
230 #ifdef DEBUG_TIS
231 uint32_t len, i;
233 len = tpm_tis_get_size_from_buffer(sb);
234 DPRINTF("tpm_tis: %s length = %d\n", string, len);
235 for (i = 0; i < len; i++) {
236 if (i && !(i % 16)) {
237 DPRINTF("\n");
239 DPRINTF("%.2X ", sb->buffer[i]);
241 DPRINTF("\n");
242 #endif
246 * Set the given flags in the STS register by clearing the register but
247 * preserving the SELFTEST_DONE and TPM_FAMILY_MASK flags and then setting
248 * the new flags.
250 * The SELFTEST_DONE flag is acquired from the backend that determines it by
251 * peeking into TPM commands.
253 * A VM suspend/resume will preserve the flag by storing it into the VM
254 * device state, but the backend will not remember it when QEMU is started
255 * again. Therefore, we cache the flag here. Once set, it will not be unset
256 * except by a reset.
258 static void tpm_tis_sts_set(TPMLocality *l, uint32_t flags)
260 l->sts &= TPM_TIS_STS_SELFTEST_DONE | TPM_TIS_STS_TPM_FAMILY_MASK;
261 l->sts |= flags;
265 * Send a request to the TPM.
267 static void tpm_tis_tpm_send(TPMState *s, uint8_t locty)
269 TPMLocality *locty_data = &s->loc[locty];
271 tpm_tis_show_buffer(&s->loc[locty].w_buffer, "tpm_tis: To TPM");
274 * w_offset serves as length indicator for length of data;
275 * it's reset when the response comes back
277 s->loc[locty].state = TPM_TIS_STATE_EXECUTION;
279 s->cmd = (TPMBackendCmd) {
280 .locty = locty,
281 .in = locty_data->w_buffer.buffer,
282 .in_len = locty_data->w_offset,
283 .out = locty_data->r_buffer.buffer,
284 .out_len = locty_data->r_buffer.size
287 tpm_backend_deliver_request(s->be_driver, &s->cmd);
290 /* raise an interrupt if allowed */
291 static void tpm_tis_raise_irq(TPMState *s, uint8_t locty, uint32_t irqmask)
293 if (!TPM_TIS_IS_VALID_LOCTY(locty)) {
294 return;
297 if ((s->loc[locty].inte & TPM_TIS_INT_ENABLED) &&
298 (s->loc[locty].inte & irqmask)) {
299 DPRINTF("tpm_tis: Raising IRQ for flag %08x\n", irqmask);
300 qemu_irq_raise(s->irq);
301 s->loc[locty].ints |= irqmask;
305 static uint32_t tpm_tis_check_request_use_except(TPMState *s, uint8_t locty)
307 uint8_t l;
309 for (l = 0; l < TPM_TIS_NUM_LOCALITIES; l++) {
310 if (l == locty) {
311 continue;
313 if ((s->loc[l].access & TPM_TIS_ACCESS_REQUEST_USE)) {
314 return 1;
318 return 0;
321 static void tpm_tis_new_active_locality(TPMState *s, uint8_t new_active_locty)
323 bool change = (s->active_locty != new_active_locty);
324 bool is_seize;
325 uint8_t mask;
327 if (change && TPM_TIS_IS_VALID_LOCTY(s->active_locty)) {
328 is_seize = TPM_TIS_IS_VALID_LOCTY(new_active_locty) &&
329 s->loc[new_active_locty].access & TPM_TIS_ACCESS_SEIZE;
331 if (is_seize) {
332 mask = ~(TPM_TIS_ACCESS_ACTIVE_LOCALITY);
333 } else {
334 mask = ~(TPM_TIS_ACCESS_ACTIVE_LOCALITY|
335 TPM_TIS_ACCESS_REQUEST_USE);
337 /* reset flags on the old active locality */
338 s->loc[s->active_locty].access &= mask;
340 if (is_seize) {
341 s->loc[s->active_locty].access |= TPM_TIS_ACCESS_BEEN_SEIZED;
345 s->active_locty = new_active_locty;
347 DPRINTF("tpm_tis: Active locality is now %d\n", s->active_locty);
349 if (TPM_TIS_IS_VALID_LOCTY(new_active_locty)) {
350 /* set flags on the new active locality */
351 s->loc[new_active_locty].access |= TPM_TIS_ACCESS_ACTIVE_LOCALITY;
352 s->loc[new_active_locty].access &= ~(TPM_TIS_ACCESS_REQUEST_USE |
353 TPM_TIS_ACCESS_SEIZE);
356 if (change) {
357 tpm_tis_raise_irq(s, s->active_locty, TPM_TIS_INT_LOCALITY_CHANGED);
361 /* abort -- this function switches the locality */
362 static void tpm_tis_abort(TPMState *s, uint8_t locty)
364 s->loc[locty].r_offset = 0;
365 s->loc[locty].w_offset = 0;
367 DPRINTF("tpm_tis: tis_abort: new active locality is %d\n", s->next_locty);
370 * Need to react differently depending on who's aborting now and
371 * which locality will become active afterwards.
373 if (s->aborting_locty == s->next_locty) {
374 s->loc[s->aborting_locty].state = TPM_TIS_STATE_READY;
375 tpm_tis_sts_set(&s->loc[s->aborting_locty],
376 TPM_TIS_STS_COMMAND_READY);
377 tpm_tis_raise_irq(s, s->aborting_locty, TPM_TIS_INT_COMMAND_READY);
380 /* locality after abort is another one than the current one */
381 tpm_tis_new_active_locality(s, s->next_locty);
383 s->next_locty = TPM_TIS_NO_LOCALITY;
384 /* nobody's aborting a command anymore */
385 s->aborting_locty = TPM_TIS_NO_LOCALITY;
388 /* prepare aborting current command */
389 static void tpm_tis_prep_abort(TPMState *s, uint8_t locty, uint8_t newlocty)
391 uint8_t busy_locty;
393 s->aborting_locty = locty;
394 s->next_locty = newlocty; /* locality after successful abort */
397 * only abort a command using an interrupt if currently executing
398 * a command AND if there's a valid connection to the vTPM.
400 for (busy_locty = 0; busy_locty < TPM_TIS_NUM_LOCALITIES; busy_locty++) {
401 if (s->loc[busy_locty].state == TPM_TIS_STATE_EXECUTION) {
403 * request the backend to cancel. Some backends may not
404 * support it
406 tpm_backend_cancel_cmd(s->be_driver);
407 return;
411 tpm_tis_abort(s, locty);
414 static void tpm_tis_receive_bh(void *opaque)
416 TPMState *s = opaque;
417 uint8_t locty = s->cmd.locty;
419 tpm_tis_sts_set(&s->loc[locty],
420 TPM_TIS_STS_VALID | TPM_TIS_STS_DATA_AVAILABLE);
421 s->loc[locty].state = TPM_TIS_STATE_COMPLETION;
422 s->loc[locty].r_offset = 0;
423 s->loc[locty].w_offset = 0;
425 tpm_tis_show_buffer(&s->loc[locty].r_buffer, "tpm_tis: From TPM");
427 if (TPM_TIS_IS_VALID_LOCTY(s->next_locty)) {
428 tpm_tis_abort(s, locty);
431 tpm_tis_raise_irq(s, locty,
432 TPM_TIS_INT_DATA_AVAILABLE | TPM_TIS_INT_STS_VALID);
435 static void tpm_tis_request_completed(TPMIf *ti)
437 TPMState *s = TPM(ti);
439 bool is_selftest_done = s->cmd.selftest_done;
440 uint8_t locty = s->cmd.locty;
441 uint8_t l;
443 if (is_selftest_done) {
444 for (l = 0; l < TPM_TIS_NUM_LOCALITIES; l++) {
445 s->loc[locty].sts |= TPM_TIS_STS_SELFTEST_DONE;
449 qemu_bh_schedule(s->bh);
453 * Read a byte of response data
455 static uint32_t tpm_tis_data_read(TPMState *s, uint8_t locty)
457 uint32_t ret = TPM_TIS_NO_DATA_BYTE;
458 uint16_t len;
460 if ((s->loc[locty].sts & TPM_TIS_STS_DATA_AVAILABLE)) {
461 len = tpm_tis_get_size_from_buffer(&s->loc[locty].r_buffer);
463 ret = s->loc[locty].r_buffer.buffer[s->loc[locty].r_offset++];
464 if (s->loc[locty].r_offset >= len) {
465 /* got last byte */
466 tpm_tis_sts_set(&s->loc[locty], TPM_TIS_STS_VALID);
467 tpm_tis_raise_irq(s, locty, TPM_TIS_INT_STS_VALID);
469 DPRINTF("tpm_tis: tpm_tis_data_read byte 0x%02x [%d]\n",
470 ret, s->loc[locty].r_offset - 1);
473 return ret;
476 #ifdef DEBUG_TIS
477 static void tpm_tis_dump_state(void *opaque, hwaddr addr)
479 static const unsigned regs[] = {
480 TPM_TIS_REG_ACCESS,
481 TPM_TIS_REG_INT_ENABLE,
482 TPM_TIS_REG_INT_VECTOR,
483 TPM_TIS_REG_INT_STATUS,
484 TPM_TIS_REG_INTF_CAPABILITY,
485 TPM_TIS_REG_STS,
486 TPM_TIS_REG_DID_VID,
487 TPM_TIS_REG_RID,
488 0xfff};
489 int idx;
490 uint8_t locty = tpm_tis_locality_from_addr(addr);
491 hwaddr base = addr & ~0xfff;
492 TPMState *s = opaque;
494 DPRINTF("tpm_tis: active locality : %d\n"
495 "tpm_tis: state of locality %d : %d\n"
496 "tpm_tis: register dump:\n",
497 s->active_locty,
498 locty, s->loc[locty].state);
500 for (idx = 0; regs[idx] != 0xfff; idx++) {
501 DPRINTF("tpm_tis: 0x%04x : 0x%08x\n", regs[idx],
502 (int)tpm_tis_mmio_read(opaque, base + regs[idx], 4));
505 DPRINTF("tpm_tis: read offset : %d\n"
506 "tpm_tis: result buffer : ",
507 s->loc[locty].r_offset);
508 for (idx = 0;
509 idx < tpm_tis_get_size_from_buffer(&s->loc[locty].r_buffer);
510 idx++) {
511 DPRINTF("%c%02x%s",
512 s->loc[locty].r_offset == idx ? '>' : ' ',
513 s->loc[locty].r_buffer.buffer[idx],
514 ((idx & 0xf) == 0xf) ? "\ntpm_tis: " : "");
516 DPRINTF("\n"
517 "tpm_tis: write offset : %d\n"
518 "tpm_tis: request buffer: ",
519 s->loc[locty].w_offset);
520 for (idx = 0;
521 idx < tpm_tis_get_size_from_buffer(&s->loc[locty].w_buffer);
522 idx++) {
523 DPRINTF("%c%02x%s",
524 s->loc[locty].w_offset == idx ? '>' : ' ',
525 s->loc[locty].w_buffer.buffer[idx],
526 ((idx & 0xf) == 0xf) ? "\ntpm_tis: " : "");
528 DPRINTF("\n");
530 #endif
533 * Read a register of the TIS interface
534 * See specs pages 33-63 for description of the registers
536 static uint64_t tpm_tis_mmio_read(void *opaque, hwaddr addr,
537 unsigned size)
539 TPMState *s = opaque;
540 uint16_t offset = addr & 0xffc;
541 uint8_t shift = (addr & 0x3) * 8;
542 uint32_t val = 0xffffffff;
543 uint8_t locty = tpm_tis_locality_from_addr(addr);
544 uint32_t avail;
545 uint8_t v;
547 if (tpm_backend_had_startup_error(s->be_driver)) {
548 return val;
551 switch (offset) {
552 case TPM_TIS_REG_ACCESS:
553 /* never show the SEIZE flag even though we use it internally */
554 val = s->loc[locty].access & ~TPM_TIS_ACCESS_SEIZE;
555 /* the pending flag is always calculated */
556 if (tpm_tis_check_request_use_except(s, locty)) {
557 val |= TPM_TIS_ACCESS_PENDING_REQUEST;
559 val |= !tpm_backend_get_tpm_established_flag(s->be_driver);
560 break;
561 case TPM_TIS_REG_INT_ENABLE:
562 val = s->loc[locty].inte;
563 break;
564 case TPM_TIS_REG_INT_VECTOR:
565 val = s->irq_num;
566 break;
567 case TPM_TIS_REG_INT_STATUS:
568 val = s->loc[locty].ints;
569 break;
570 case TPM_TIS_REG_INTF_CAPABILITY:
571 switch (s->be_tpm_version) {
572 case TPM_VERSION_UNSPEC:
573 val = 0;
574 break;
575 case TPM_VERSION_1_2:
576 val = TPM_TIS_CAPABILITIES_SUPPORTED1_3;
577 break;
578 case TPM_VERSION_2_0:
579 val = TPM_TIS_CAPABILITIES_SUPPORTED2_0;
580 break;
582 break;
583 case TPM_TIS_REG_STS:
584 if (s->active_locty == locty) {
585 if ((s->loc[locty].sts & TPM_TIS_STS_DATA_AVAILABLE)) {
586 val = TPM_TIS_BURST_COUNT(
587 tpm_tis_get_size_from_buffer(&s->loc[locty].r_buffer)
588 - s->loc[locty].r_offset) | s->loc[locty].sts;
589 } else {
590 avail = s->loc[locty].w_buffer.size
591 - s->loc[locty].w_offset;
593 * byte-sized reads should not return 0x00 for 0x100
594 * available bytes.
596 if (size == 1 && avail > 0xff) {
597 avail = 0xff;
599 val = TPM_TIS_BURST_COUNT(avail) | s->loc[locty].sts;
602 break;
603 case TPM_TIS_REG_DATA_FIFO:
604 case TPM_TIS_REG_DATA_XFIFO ... TPM_TIS_REG_DATA_XFIFO_END:
605 if (s->active_locty == locty) {
606 if (size > 4 - (addr & 0x3)) {
607 /* prevent access beyond FIFO */
608 size = 4 - (addr & 0x3);
610 val = 0;
611 shift = 0;
612 while (size > 0) {
613 switch (s->loc[locty].state) {
614 case TPM_TIS_STATE_COMPLETION:
615 v = tpm_tis_data_read(s, locty);
616 break;
617 default:
618 v = TPM_TIS_NO_DATA_BYTE;
619 break;
621 val |= (v << shift);
622 shift += 8;
623 size--;
625 shift = 0; /* no more adjustments */
627 break;
628 case TPM_TIS_REG_INTERFACE_ID:
629 val = s->loc[locty].iface_id;
630 break;
631 case TPM_TIS_REG_DID_VID:
632 val = (TPM_TIS_TPM_DID << 16) | TPM_TIS_TPM_VID;
633 break;
634 case TPM_TIS_REG_RID:
635 val = TPM_TIS_TPM_RID;
636 break;
637 #ifdef DEBUG_TIS
638 case TPM_TIS_REG_DEBUG:
639 tpm_tis_dump_state(opaque, addr);
640 break;
641 #endif
644 if (shift) {
645 val >>= shift;
648 DPRINTF("tpm_tis: read.%u(%08x) = %08x\n", size, (int)addr, (int)val);
650 return val;
654 * Write a value to a register of the TIS interface
655 * See specs pages 33-63 for description of the registers
657 static void tpm_tis_mmio_write(void *opaque, hwaddr addr,
658 uint64_t val, unsigned size)
660 TPMState *s = opaque;
661 uint16_t off = addr & 0xffc;
662 uint8_t shift = (addr & 0x3) * 8;
663 uint8_t locty = tpm_tis_locality_from_addr(addr);
664 uint8_t active_locty, l;
665 int c, set_new_locty = 1;
666 uint16_t len;
667 uint32_t mask = (size == 1) ? 0xff : ((size == 2) ? 0xffff : ~0);
669 DPRINTF("tpm_tis: write.%u(%08x) = %08x\n", size, (int)addr, (int)val);
671 if (locty == 4) {
672 DPRINTF("tpm_tis: Access to locality 4 only allowed from hardware\n");
673 return;
676 if (tpm_backend_had_startup_error(s->be_driver)) {
677 return;
680 val &= mask;
682 if (shift) {
683 val <<= shift;
684 mask <<= shift;
687 mask ^= 0xffffffff;
689 switch (off) {
690 case TPM_TIS_REG_ACCESS:
692 if ((val & TPM_TIS_ACCESS_SEIZE)) {
693 val &= ~(TPM_TIS_ACCESS_REQUEST_USE |
694 TPM_TIS_ACCESS_ACTIVE_LOCALITY);
697 active_locty = s->active_locty;
699 if ((val & TPM_TIS_ACCESS_ACTIVE_LOCALITY)) {
700 /* give up locality if currently owned */
701 if (s->active_locty == locty) {
702 DPRINTF("tpm_tis: Releasing locality %d\n", locty);
704 uint8_t newlocty = TPM_TIS_NO_LOCALITY;
705 /* anybody wants the locality ? */
706 for (c = TPM_TIS_NUM_LOCALITIES - 1; c >= 0; c--) {
707 if ((s->loc[c].access & TPM_TIS_ACCESS_REQUEST_USE)) {
708 DPRINTF("tpm_tis: Locality %d requests use.\n", c);
709 newlocty = c;
710 break;
713 DPRINTF("tpm_tis: TPM_TIS_ACCESS_ACTIVE_LOCALITY: "
714 "Next active locality: %d\n",
715 newlocty);
717 if (TPM_TIS_IS_VALID_LOCTY(newlocty)) {
718 set_new_locty = 0;
719 tpm_tis_prep_abort(s, locty, newlocty);
720 } else {
721 active_locty = TPM_TIS_NO_LOCALITY;
723 } else {
724 /* not currently the owner; clear a pending request */
725 s->loc[locty].access &= ~TPM_TIS_ACCESS_REQUEST_USE;
729 if ((val & TPM_TIS_ACCESS_BEEN_SEIZED)) {
730 s->loc[locty].access &= ~TPM_TIS_ACCESS_BEEN_SEIZED;
733 if ((val & TPM_TIS_ACCESS_SEIZE)) {
735 * allow seize if a locality is active and the requesting
736 * locality is higher than the one that's active
737 * OR
738 * allow seize for requesting locality if no locality is
739 * active
741 while ((TPM_TIS_IS_VALID_LOCTY(s->active_locty) &&
742 locty > s->active_locty) ||
743 !TPM_TIS_IS_VALID_LOCTY(s->active_locty)) {
744 bool higher_seize = FALSE;
746 /* already a pending SEIZE ? */
747 if ((s->loc[locty].access & TPM_TIS_ACCESS_SEIZE)) {
748 break;
751 /* check for ongoing seize by a higher locality */
752 for (l = locty + 1; l < TPM_TIS_NUM_LOCALITIES; l++) {
753 if ((s->loc[l].access & TPM_TIS_ACCESS_SEIZE)) {
754 higher_seize = TRUE;
755 break;
759 if (higher_seize) {
760 break;
763 /* cancel any seize by a lower locality */
764 for (l = 0; l < locty - 1; l++) {
765 s->loc[l].access &= ~TPM_TIS_ACCESS_SEIZE;
768 s->loc[locty].access |= TPM_TIS_ACCESS_SEIZE;
769 DPRINTF("tpm_tis: TPM_TIS_ACCESS_SEIZE: "
770 "Locality %d seized from locality %d\n",
771 locty, s->active_locty);
772 DPRINTF("tpm_tis: TPM_TIS_ACCESS_SEIZE: Initiating abort.\n");
773 set_new_locty = 0;
774 tpm_tis_prep_abort(s, s->active_locty, locty);
775 break;
779 if ((val & TPM_TIS_ACCESS_REQUEST_USE)) {
780 if (s->active_locty != locty) {
781 if (TPM_TIS_IS_VALID_LOCTY(s->active_locty)) {
782 s->loc[locty].access |= TPM_TIS_ACCESS_REQUEST_USE;
783 } else {
784 /* no locality active -> make this one active now */
785 active_locty = locty;
790 if (set_new_locty) {
791 tpm_tis_new_active_locality(s, active_locty);
794 break;
795 case TPM_TIS_REG_INT_ENABLE:
796 if (s->active_locty != locty) {
797 break;
800 s->loc[locty].inte &= mask;
801 s->loc[locty].inte |= (val & (TPM_TIS_INT_ENABLED |
802 TPM_TIS_INT_POLARITY_MASK |
803 TPM_TIS_INTERRUPTS_SUPPORTED));
804 break;
805 case TPM_TIS_REG_INT_VECTOR:
806 /* hard wired -- ignore */
807 break;
808 case TPM_TIS_REG_INT_STATUS:
809 if (s->active_locty != locty) {
810 break;
813 /* clearing of interrupt flags */
814 if (((val & TPM_TIS_INTERRUPTS_SUPPORTED)) &&
815 (s->loc[locty].ints & TPM_TIS_INTERRUPTS_SUPPORTED)) {
816 s->loc[locty].ints &= ~val;
817 if (s->loc[locty].ints == 0) {
818 qemu_irq_lower(s->irq);
819 DPRINTF("tpm_tis: Lowering IRQ\n");
822 s->loc[locty].ints &= ~(val & TPM_TIS_INTERRUPTS_SUPPORTED);
823 break;
824 case TPM_TIS_REG_STS:
825 if (s->active_locty != locty) {
826 break;
829 if (s->be_tpm_version == TPM_VERSION_2_0) {
830 /* some flags that are only supported for TPM 2 */
831 if (val & TPM_TIS_STS_COMMAND_CANCEL) {
832 if (s->loc[locty].state == TPM_TIS_STATE_EXECUTION) {
834 * request the backend to cancel. Some backends may not
835 * support it
837 tpm_backend_cancel_cmd(s->be_driver);
841 if (val & TPM_TIS_STS_RESET_ESTABLISHMENT_BIT) {
842 if (locty == 3 || locty == 4) {
843 tpm_backend_reset_tpm_established_flag(s->be_driver, locty);
848 val &= (TPM_TIS_STS_COMMAND_READY | TPM_TIS_STS_TPM_GO |
849 TPM_TIS_STS_RESPONSE_RETRY);
851 if (val == TPM_TIS_STS_COMMAND_READY) {
852 switch (s->loc[locty].state) {
854 case TPM_TIS_STATE_READY:
855 s->loc[locty].w_offset = 0;
856 s->loc[locty].r_offset = 0;
857 break;
859 case TPM_TIS_STATE_IDLE:
860 tpm_tis_sts_set(&s->loc[locty], TPM_TIS_STS_COMMAND_READY);
861 s->loc[locty].state = TPM_TIS_STATE_READY;
862 tpm_tis_raise_irq(s, locty, TPM_TIS_INT_COMMAND_READY);
863 break;
865 case TPM_TIS_STATE_EXECUTION:
866 case TPM_TIS_STATE_RECEPTION:
867 /* abort currently running command */
868 DPRINTF("tpm_tis: %s: Initiating abort.\n",
869 __func__);
870 tpm_tis_prep_abort(s, locty, locty);
871 break;
873 case TPM_TIS_STATE_COMPLETION:
874 s->loc[locty].w_offset = 0;
875 s->loc[locty].r_offset = 0;
876 /* shortcut to ready state with C/R set */
877 s->loc[locty].state = TPM_TIS_STATE_READY;
878 if (!(s->loc[locty].sts & TPM_TIS_STS_COMMAND_READY)) {
879 tpm_tis_sts_set(&s->loc[locty],
880 TPM_TIS_STS_COMMAND_READY);
881 tpm_tis_raise_irq(s, locty, TPM_TIS_INT_COMMAND_READY);
883 s->loc[locty].sts &= ~(TPM_TIS_STS_DATA_AVAILABLE);
884 break;
887 } else if (val == TPM_TIS_STS_TPM_GO) {
888 switch (s->loc[locty].state) {
889 case TPM_TIS_STATE_RECEPTION:
890 if ((s->loc[locty].sts & TPM_TIS_STS_EXPECT) == 0) {
891 tpm_tis_tpm_send(s, locty);
893 break;
894 default:
895 /* ignore */
896 break;
898 } else if (val == TPM_TIS_STS_RESPONSE_RETRY) {
899 switch (s->loc[locty].state) {
900 case TPM_TIS_STATE_COMPLETION:
901 s->loc[locty].r_offset = 0;
902 tpm_tis_sts_set(&s->loc[locty],
903 TPM_TIS_STS_VALID|
904 TPM_TIS_STS_DATA_AVAILABLE);
905 break;
906 default:
907 /* ignore */
908 break;
911 break;
912 case TPM_TIS_REG_DATA_FIFO:
913 case TPM_TIS_REG_DATA_XFIFO ... TPM_TIS_REG_DATA_XFIFO_END:
914 /* data fifo */
915 if (s->active_locty != locty) {
916 break;
919 if (s->loc[locty].state == TPM_TIS_STATE_IDLE ||
920 s->loc[locty].state == TPM_TIS_STATE_EXECUTION ||
921 s->loc[locty].state == TPM_TIS_STATE_COMPLETION) {
922 /* drop the byte */
923 } else {
924 DPRINTF("tpm_tis: Data to send to TPM: %08x (size=%d)\n",
925 (int)val, size);
926 if (s->loc[locty].state == TPM_TIS_STATE_READY) {
927 s->loc[locty].state = TPM_TIS_STATE_RECEPTION;
928 tpm_tis_sts_set(&s->loc[locty],
929 TPM_TIS_STS_EXPECT | TPM_TIS_STS_VALID);
932 val >>= shift;
933 if (size > 4 - (addr & 0x3)) {
934 /* prevent access beyond FIFO */
935 size = 4 - (addr & 0x3);
938 while ((s->loc[locty].sts & TPM_TIS_STS_EXPECT) && size > 0) {
939 if (s->loc[locty].w_offset < s->loc[locty].w_buffer.size) {
940 s->loc[locty].w_buffer.
941 buffer[s->loc[locty].w_offset++] = (uint8_t)val;
942 val >>= 8;
943 size--;
944 } else {
945 tpm_tis_sts_set(&s->loc[locty], TPM_TIS_STS_VALID);
949 /* check for complete packet */
950 if (s->loc[locty].w_offset > 5 &&
951 (s->loc[locty].sts & TPM_TIS_STS_EXPECT)) {
952 /* we have a packet length - see if we have all of it */
953 bool need_irq = !(s->loc[locty].sts & TPM_TIS_STS_VALID);
955 len = tpm_tis_get_size_from_buffer(&s->loc[locty].w_buffer);
956 if (len > s->loc[locty].w_offset) {
957 tpm_tis_sts_set(&s->loc[locty],
958 TPM_TIS_STS_EXPECT | TPM_TIS_STS_VALID);
959 } else {
960 /* packet complete */
961 tpm_tis_sts_set(&s->loc[locty], TPM_TIS_STS_VALID);
963 if (need_irq) {
964 tpm_tis_raise_irq(s, locty, TPM_TIS_INT_STS_VALID);
968 break;
969 case TPM_TIS_REG_INTERFACE_ID:
970 if (val & TPM_TIS_IFACE_ID_INT_SEL_LOCK) {
971 for (l = 0; l < TPM_TIS_NUM_LOCALITIES; l++) {
972 s->loc[l].iface_id |= TPM_TIS_IFACE_ID_INT_SEL_LOCK;
975 break;
979 static const MemoryRegionOps tpm_tis_memory_ops = {
980 .read = tpm_tis_mmio_read,
981 .write = tpm_tis_mmio_write,
982 .endianness = DEVICE_LITTLE_ENDIAN,
983 .valid = {
984 .min_access_size = 1,
985 .max_access_size = 4,
989 static int tpm_tis_do_startup_tpm(TPMState *s)
991 return tpm_backend_startup_tpm(s->be_driver);
994 static void tpm_tis_realloc_buffer(TPMSizedBuffer *sb)
996 size_t wanted_size = 4096; /* Linux tpm.c buffer size */
998 if (sb->size != wanted_size) {
999 sb->buffer = g_realloc(sb->buffer, wanted_size);
1000 sb->size = wanted_size;
1005 * Get the TPMVersion of the backend device being used
1007 TPMVersion tpm_tis_get_tpm_version(Object *obj)
1009 TPMState *s = TPM(obj);
1011 if (tpm_backend_had_startup_error(s->be_driver)) {
1012 return TPM_VERSION_UNSPEC;
1015 return tpm_backend_get_tpm_version(s->be_driver);
1019 * This function is called when the machine starts, resets or due to
1020 * S3 resume.
1022 static void tpm_tis_reset(DeviceState *dev)
1024 TPMState *s = TPM(dev);
1025 int c;
1027 s->be_tpm_version = tpm_backend_get_tpm_version(s->be_driver);
1029 tpm_backend_reset(s->be_driver);
1031 s->active_locty = TPM_TIS_NO_LOCALITY;
1032 s->next_locty = TPM_TIS_NO_LOCALITY;
1033 s->aborting_locty = TPM_TIS_NO_LOCALITY;
1035 for (c = 0; c < TPM_TIS_NUM_LOCALITIES; c++) {
1036 s->loc[c].access = TPM_TIS_ACCESS_TPM_REG_VALID_STS;
1037 switch (s->be_tpm_version) {
1038 case TPM_VERSION_UNSPEC:
1039 break;
1040 case TPM_VERSION_1_2:
1041 s->loc[c].sts = TPM_TIS_STS_TPM_FAMILY1_2;
1042 s->loc[c].iface_id = TPM_TIS_IFACE_ID_SUPPORTED_FLAGS1_3;
1043 break;
1044 case TPM_VERSION_2_0:
1045 s->loc[c].sts = TPM_TIS_STS_TPM_FAMILY2_0;
1046 s->loc[c].iface_id = TPM_TIS_IFACE_ID_SUPPORTED_FLAGS2_0;
1047 break;
1049 s->loc[c].inte = TPM_TIS_INT_POLARITY_LOW_LEVEL;
1050 s->loc[c].ints = 0;
1051 s->loc[c].state = TPM_TIS_STATE_IDLE;
1053 s->loc[c].w_offset = 0;
1054 tpm_tis_realloc_buffer(&s->loc[c].w_buffer);
1055 s->loc[c].r_offset = 0;
1056 tpm_tis_realloc_buffer(&s->loc[c].r_buffer);
1059 tpm_tis_do_startup_tpm(s);
1062 static const VMStateDescription vmstate_tpm_tis = {
1063 .name = "tpm",
1064 .unmigratable = 1,
1067 static Property tpm_tis_properties[] = {
1068 DEFINE_PROP_UINT32("irq", TPMState, irq_num, TPM_TIS_IRQ),
1069 DEFINE_PROP_STRING("tpmdev", TPMState, backend),
1070 DEFINE_PROP_END_OF_LIST(),
1073 static void tpm_tis_realizefn(DeviceState *dev, Error **errp)
1075 TPMState *s = TPM(dev);
1077 s->be_driver = qemu_find_tpm(s->backend);
1078 if (!s->be_driver) {
1079 error_setg(errp, "tpm_tis: backend driver with id %s could not be "
1080 "found", s->backend);
1081 return;
1084 s->be_driver->fe_model = TPM_MODEL_TPM_TIS;
1086 if (tpm_backend_init(s->be_driver, s)) {
1087 error_setg(errp, "tpm_tis: backend driver with id %s could not be "
1088 "initialized", s->backend);
1089 return;
1092 if (s->irq_num > 15) {
1093 error_setg(errp, "tpm_tis: IRQ %d for TPM TIS is outside valid range "
1094 "of 0 to 15", s->irq_num);
1095 return;
1098 s->bh = qemu_bh_new(tpm_tis_receive_bh, s);
1100 isa_init_irq(&s->busdev, &s->irq, s->irq_num);
1102 memory_region_add_subregion(isa_address_space(ISA_DEVICE(dev)),
1103 TPM_TIS_ADDR_BASE, &s->mmio);
1106 static void tpm_tis_initfn(Object *obj)
1108 TPMState *s = TPM(obj);
1110 memory_region_init_io(&s->mmio, OBJECT(s), &tpm_tis_memory_ops,
1111 s, "tpm-tis-mmio",
1112 TPM_TIS_NUM_LOCALITIES << TPM_TIS_LOCALITY_SHIFT);
1115 static void tpm_tis_class_init(ObjectClass *klass, void *data)
1117 DeviceClass *dc = DEVICE_CLASS(klass);
1118 TPMIfClass *tc = TPM_IF_CLASS(klass);
1120 dc->realize = tpm_tis_realizefn;
1121 dc->props = tpm_tis_properties;
1122 dc->reset = tpm_tis_reset;
1123 dc->vmsd = &vmstate_tpm_tis;
1124 tc->request_completed = tpm_tis_request_completed;
1127 static const TypeInfo tpm_tis_info = {
1128 .name = TYPE_TPM_TIS,
1129 .parent = TYPE_ISA_DEVICE,
1130 .instance_size = sizeof(TPMState),
1131 .instance_init = tpm_tis_initfn,
1132 .class_init = tpm_tis_class_init,
1133 .interfaces = (InterfaceInfo[]) {
1134 { TYPE_TPM_IF },
1139 static void tpm_tis_register(void)
1141 type_register_static(&tpm_tis_info);
1142 tpm_register_model(TPM_MODEL_TPM_TIS);
1145 type_init(tpm_tis_register)