xref: /freebsd/sys/dev/tpm/tpm20.h (revision 405c3050f102b8c74782f0366c8ead927bd07b68)
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$");
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 
96 struct 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 
121 int tpm20_suspend(device_t dev);
122 int tpm20_shutdown(device_t dev);
123 int32_t tpm20_get_timeout(uint32_t command);
124 int tpm20_init(struct tpm_sc *sc);
125 void tpm20_release(struct tpm_sc *sc);
126 
127 d_open_t	tpm20_open;
128 d_close_t	tpm20_close;
129 d_read_t	tpm20_read;
130 d_write_t	tpm20_write;
131 d_ioctl_t	tpm20_ioctl;
132 
133 static struct cdevsw tpm_cdevsw = {
134 	.d_version = D_VERSION,
135 	.d_open = tpm20_open,
136 	.d_close = tpm20_close,
137 	.d_read = tpm20_read,
138 	.d_write = tpm20_write,
139 	.d_ioctl = tpm20_ioctl,
140 	.d_name = "tpm20",
141 };
142 
143 /* Small helper routines for io ops */
144 static inline uint8_t
145 RD1(struct tpm_sc *sc, bus_size_t off)
146 {
147 
148 	return (bus_read_1(sc->mem_res, off));
149 }
150 static inline uint32_t
151 RD4(struct tpm_sc *sc, bus_size_t off)
152 {
153 
154 	return (bus_read_4(sc->mem_res, off));
155 }
156 static inline uint64_t
157 RD8(struct tpm_sc *sc, bus_size_t off)
158 {
159 
160 	return (bus_read_8(sc->mem_res, off));
161 }
162 static inline void
163 WR1(struct tpm_sc *sc, bus_size_t off, uint8_t val)
164 {
165 
166 	bus_write_1(sc->mem_res, off, val);
167 }
168 static inline void
169 WR4(struct tpm_sc *sc, bus_size_t off, uint32_t val)
170 {
171 
172 	bus_write_4(sc->mem_res, off, val);
173 }
174 static inline void
175 AND4(struct tpm_sc *sc, bus_size_t off, uint32_t val)
176 {
177 
178 	WR4(sc, off, RD4(sc, off) & val);
179 }
180 static inline void
181 OR1(struct tpm_sc *sc, bus_size_t off, uint8_t val)
182 {
183 
184 	WR1(sc, off, RD1(sc, off) | val);
185 }
186 static inline void
187 OR4(struct tpm_sc *sc, bus_size_t off, uint32_t val)
188 {
189 
190 	WR4(sc, off, RD4(sc, off) | val);
191 }
192 #endif	/* _TPM20_H_ */
193