tpm20.h revision 346721
1/*-
2 * Copyright (c) 2018 Stormshield.
3 * Copyright (c) 2018 Semihalf.
4 * All rights reserved.
5 *
6 * Redistribution and use in source and binary forms, with or without
7 * modification, are permitted provided that the following conditions
8 * are met:
9 * 1. Redistributions of source code must retain the above copyright
10 *    notice, this list of conditions and the following disclaimer.
11 * 2. Redistributions in binary form must reproduce the above copyright
12 *    notice, this list of conditions and the following disclaimer in the
13 *    documentation and/or other materials provided with the distribution.
14 *
15 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
16 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
17 * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
18 * DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT,
19 * INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
20 * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
21 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
22 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
23 * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
24 * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
25 * POSSIBILITY OF SUCH DAMAGE.
26 */
27
28#ifndef _TPM20_H_
29#define _TPM20_H_
30
31#include <sys/cdefs.h>
32__FBSDID("$FreeBSD: stable/11/sys/dev/tpm/tpm20.h 346721 2019-04-26 01:02:24Z mw $");
33
34#include <sys/endian.h>
35#include <sys/param.h>
36#include <sys/kernel.h>
37#include <sys/malloc.h>
38#include <sys/proc.h>
39#include <sys/systm.h>
40
41#include <sys/bus.h>
42#include <sys/callout.h>
43#include <sys/conf.h>
44#include <sys/module.h>
45#include <sys/rman.h>
46#include <sys/sx.h>
47#include <sys/uio.h>
48
49#include <machine/bus.h>
50#include <machine/md_var.h>
51#include <machine/resource.h>
52
53#include <contrib/dev/acpica/include/acpi.h>
54#include <contrib/dev/acpica/include/accommon.h>
55#include <dev/acpica/acpivar.h>
56#include "opt_acpi.h"
57
58#define	BIT(x) (1 << (x))
59
60/* Timeouts in us */
61#define	TPM_TIMEOUT_A		750000
62#define	TPM_TIMEOUT_B		2000000
63#define	TPM_TIMEOUT_C		200000
64#define	TPM_TIMEOUT_D		30000
65
66/*
67 * Generating RSA key pair takes ~(10-20s), which is significantly longer than
68 * any timeout defined in spec. Because of that we need a new one.
69 */
70#define	TPM_TIMEOUT_LONG	40000000
71
72/* List of commands that require TPM_TIMEOUT_LONG time to complete */
73#define	TPM_CC_CreatePrimary	0x00000131
74#define	TPM_CC_Create			0x00000153
75#define	TPM_CC_CreateLoaded		0x00000191
76
77/* List of commands that require only TPM_TIMEOUT_C time to complete */
78#define TPM_CC_SequenceComplete			0x0000013e
79#define TPM_CC_Startup					0x00000144
80#define TPM_CC_SequenceUpdate			0x0000015c
81#define TPM_CC_GetCapability			0x0000017a
82#define TPM_CC_PCR_Extend				0x00000182
83#define TPM_CC_EventSequenceComplete	0x00000185
84#define TPM_CC_HashSequenceStart		0x00000186
85
86/* Timeout before data in read buffer is discarded */
87#define	TPM_READ_TIMEOUT	500000
88
89#define	TPM_BUFSIZE		0x1000
90
91#define	TPM_HEADER_SIZE		10
92
93#define	TPM_CDEV_NAME		"tpm0"
94#define	TPM_CDEV_PERM_FLAG	0600
95
96struct tpm_sc {
97	device_t	dev;
98
99	struct resource	*mem_res;
100	struct resource	*irq_res;
101	int		mem_rid;
102	int		irq_rid;
103
104	struct cdev	*sc_cdev;
105
106	struct sx 	dev_lock;
107	struct cv	buf_cv;
108
109	void 		*intr_cookie;
110	int 		intr_type;	/* Current event type */
111	bool 		interrupts;
112
113	uint8_t 	*buf;
114	size_t		pending_data_length;
115
116	struct callout 	discard_buffer_callout;
117
118	int		(*transmit)(struct tpm_sc *, size_t);
119};
120
121int tpm20_suspend(device_t dev);
122int tpm20_shutdown(device_t dev);
123int32_t tpm20_get_timeout(uint32_t command);
124int tpm20_init(struct tpm_sc *sc);
125void tpm20_release(struct tpm_sc *sc);
126
127/* Small helper routines for io ops */
128static inline uint8_t
129RD1(struct tpm_sc *sc, bus_size_t off)
130{
131
132	return (bus_read_1(sc->mem_res, off));
133}
134static inline uint32_t
135RD4(struct tpm_sc *sc, bus_size_t off)
136{
137
138	return (bus_read_4(sc->mem_res, off));
139}
140#ifdef __amd64__
141static inline uint64_t
142RD8(struct tpm_sc *sc, bus_size_t off)
143{
144
145	return (bus_read_8(sc->mem_res, off));
146}
147#endif
148static inline void
149WR1(struct tpm_sc *sc, bus_size_t off, uint8_t val)
150{
151
152	bus_write_1(sc->mem_res, off, val);
153}
154static inline void
155WR4(struct tpm_sc *sc, bus_size_t off, uint32_t val)
156{
157
158	bus_write_4(sc->mem_res, off, val);
159}
160static inline void
161AND4(struct tpm_sc *sc, bus_size_t off, uint32_t val)
162{
163
164	WR4(sc, off, RD4(sc, off) & val);
165}
166static inline void
167OR1(struct tpm_sc *sc, bus_size_t off, uint8_t val)
168{
169
170	WR1(sc, off, RD1(sc, off) | val);
171}
172static inline void
173OR4(struct tpm_sc *sc, bus_size_t off, uint32_t val)
174{
175
176	WR4(sc, off, RD4(sc, off) | val);
177}
178#endif	/* _TPM20_H_ */
179