[deliverable/linux.git] / drivers / char / tpm / tpm.h

/*
 * Copyright (C) 2004 IBM Corporation
 *
 * Authors:
 * Leendert van Doorn <leendert@watson.ibm.com>
 * Dave Safford <safford@watson.ibm.com>
 * Reiner Sailer <sailer@watson.ibm.com>
 * Kylene Hall <kjhall@us.ibm.com>
 *
 * Maintained by: <tpmdd-devel@lists.sourceforge.net>
 *
 * Device driver for TCG/TCPA TPM (trusted platform module).
 * Specifications at www.trustedcomputinggroup.org	 
 *
 * This program is free software; you can redistribute it and/or
 * modify it under the terms of the GNU General Public License as
 * published by the Free Software Foundation, version 2 of the
 * License.
 * 
 */
#include <linux/module.h>
#include <linux/delay.h>
#include <linux/fs.h>
#include <linux/mutex.h>
#include <linux/sched.h>
#include <linux/miscdevice.h>
#include <linux/platform_device.h>
#include <linux/io.h>
#include <linux/tpm.h>

enum tpm_timeout {
	TPM_TIMEOUT = 5,	/* msecs */
};

/* TPM addresses */
enum tpm_addr {
	TPM_SUPERIO_ADDR = 0x2E,
	TPM_ADDR = 0x4E,
};

extern ssize_t tpm_show_pubek(struct device *, struct device_attribute *attr,
				char *);
extern ssize_t tpm_show_pcrs(struct device *, struct device_attribute *attr,
				char *);
extern ssize_t tpm_show_caps(struct device *, struct device_attribute *attr,
				char *);
extern ssize_t tpm_show_caps_1_2(struct device *, struct device_attribute *attr,
				char *);
extern ssize_t tpm_store_cancel(struct device *, struct device_attribute *attr,
				const char *, size_t);
extern ssize_t tpm_show_enabled(struct device *, struct device_attribute *attr,
				char *);
extern ssize_t tpm_show_active(struct device *, struct device_attribute *attr,
				char *);
extern ssize_t tpm_show_owned(struct device *, struct device_attribute *attr,
				char *);
extern ssize_t tpm_show_temp_deactivated(struct device *,
					 struct device_attribute *attr, char *);
extern ssize_t tpm_show_timeouts(struct device *,
				 struct device_attribute *attr, char *);

struct tpm_chip;

struct tpm_vendor_specific {
	const u8 req_complete_mask;
	const u8 req_complete_val;
	const u8 req_canceled;
	void __iomem *iobase;		/* ioremapped address */
	unsigned long base;		/* TPM base address */

	int irq;

	int region_size;
	int have_region;

	int (*recv) (struct tpm_chip *, u8 *, size_t);
	int (*send) (struct tpm_chip *, u8 *, size_t);
	void (*cancel) (struct tpm_chip *);
	u8 (*status) (struct tpm_chip *);
	void (*release) (struct device *);
	struct miscdevice miscdev;
	struct attribute_group *attr_group;
	struct list_head list;
	int locality;
	unsigned long timeout_a, timeout_b, timeout_c, timeout_d; /* jiffies */
	unsigned long duration[3]; /* jiffies */

	wait_queue_head_t read_queue;
	wait_queue_head_t int_queue;
};

struct tpm_chip {
	struct device *dev;	/* Device stuff */

	int dev_num;		/* /dev/tpm# */
	unsigned long is_open;	/* only one allowed */
	int time_expired;

	/* Data passed to and from the tpm via the read/write calls */
	u8 *data_buffer;
	atomic_t data_pending;
	struct mutex buffer_mutex;

	struct timer_list user_read_timer;	/* user needs to claim result */
	struct work_struct work;
	struct mutex tpm_mutex;	/* tpm is processing */

	struct tpm_vendor_specific vendor;

	struct dentry **bios_dir;

	struct list_head list;
	void (*release) (struct device *);
};

#define to_tpm_chip(n) container_of(n, struct tpm_chip, vendor)

static inline void tpm_chip_put(struct tpm_chip *chip)
{
	module_put(chip->dev->driver->owner);
}

static inline int tpm_read_index(int base, int index)
{
	outb(index, base);
	return inb(base+1) & 0xFF;
}

static inline void tpm_write_index(int base, int index, int value)
{
	outb(index, base);
	outb(value & 0xFF, base+1);
}
struct tpm_input_header {
	__be16	tag;
	__be32	length;
	__be32	ordinal;
}__attribute__((packed));

struct tpm_output_header {
	__be16	tag;
	__be32	length;
	__be32	return_code;
}__attribute__((packed));

struct	stclear_flags_t {
	__be16	tag;
	u8	deactivated;
	u8	disableForceClear;
	u8	physicalPresence;
	u8	physicalPresenceLock;
	u8	bGlobalLock;
}__attribute__((packed));

struct	tpm_version_t {
	u8	Major;
	u8	Minor;
	u8	revMajor;
	u8	revMinor;
}__attribute__((packed));

struct	tpm_version_1_2_t {
	__be16	tag;
	u8	Major;
	u8	Minor;
	u8	revMajor;
	u8	revMinor;
}__attribute__((packed));

struct	timeout_t {
	__be32	a;
	__be32	b;
	__be32	c;
	__be32	d;
}__attribute__((packed));

struct duration_t {
	__be32	tpm_short;
	__be32	tpm_medium;
	__be32	tpm_long;
}__attribute__((packed));

struct permanent_flags_t {
	__be16	tag;
	u8	disable;
	u8	ownership;
	u8	deactivated;
	u8	readPubek;
	u8	disableOwnerClear;
	u8	allowMaintenance;
	u8	physicalPresenceLifetimeLock;
	u8	physicalPresenceHWEnable;
	u8	physicalPresenceCMDEnable;
	u8	CEKPUsed;
	u8	TPMpost;
	u8	TPMpostLock;
	u8	FIPS;
	u8	operator;
	u8	enableRevokeEK;
	u8	nvLocked;
	u8	readSRKPub;
	u8	tpmEstablished;
	u8	maintenanceDone;
	u8	disableFullDALogicInfo;
}__attribute__((packed));

typedef union {
	struct	permanent_flags_t perm_flags;
	struct	stclear_flags_t	stclear_flags;
	bool	owned;
	__be32	num_pcrs;
	struct	tpm_version_t	tpm_version;
	struct	tpm_version_1_2_t tpm_version_1_2;
	__be32	manufacturer_id;
	struct timeout_t  timeout;
	struct duration_t duration;
} cap_t;

struct	tpm_getcap_params_in {
	__be32	cap;
	__be32	subcap_size;
	__be32	subcap;
}__attribute__((packed));

struct	tpm_getcap_params_out {
	__be32	cap_size;
	cap_t	cap;
}__attribute__((packed));

struct	tpm_readpubek_params_out {
	u8	algorithm[4];
	u8	encscheme[2];
	u8	sigscheme[2];
	__be32	paramsize;
	u8	parameters[12]; /*assuming RSA*/
	__be32	keysize;
	u8	modulus[256];
	u8	checksum[20];
}__attribute__((packed));

typedef union {
	struct	tpm_input_header in;
	struct	tpm_output_header out;
} tpm_cmd_header;

#define TPM_DIGEST_SIZE 20
struct tpm_pcrread_out {
	u8	pcr_result[TPM_DIGEST_SIZE];
}__attribute__((packed));

struct tpm_pcrread_in {
	__be32	pcr_idx;
}__attribute__((packed));

struct tpm_pcrextend_in {
	__be32	pcr_idx;
	u8	hash[TPM_DIGEST_SIZE];
}__attribute__((packed));

typedef union {
	struct	tpm_getcap_params_out getcap_out;
	struct	tpm_readpubek_params_out readpubek_out;
	u8	readpubek_out_buffer[sizeof(struct tpm_readpubek_params_out)];
	struct	tpm_getcap_params_in getcap_in;
	struct	tpm_pcrread_in	pcrread_in;
	struct	tpm_pcrread_out	pcrread_out;
	struct	tpm_pcrextend_in pcrextend_in;
} tpm_cmd_params;

struct tpm_cmd_t {
	tpm_cmd_header	header;
	tpm_cmd_params	params;
}__attribute__((packed));

ssize_t	tpm_getcap(struct device *, __be32, cap_t *, const char *);

extern void tpm_get_timeouts(struct tpm_chip *);
extern void tpm_gen_interrupt(struct tpm_chip *);
extern void tpm_continue_selftest(struct tpm_chip *);
extern unsigned long tpm_calc_ordinal_duration(struct tpm_chip *, u32);
extern struct tpm_chip* tpm_register_hardware(struct device *,
				 const struct tpm_vendor_specific *);
extern int tpm_open(struct inode *, struct file *);
extern int tpm_release(struct inode *, struct file *);
extern void tpm_dev_vendor_release(struct tpm_chip *);
extern ssize_t tpm_write(struct file *, const char __user *, size_t,
			 loff_t *);
extern ssize_t tpm_read(struct file *, char __user *, size_t, loff_t *);
extern void tpm_remove_hardware(struct device *);
extern int tpm_pm_suspend(struct device *, pm_message_t);
extern int tpm_pm_resume(struct device *);

#ifdef CONFIG_ACPI
extern struct dentry ** tpm_bios_log_setup(char *);
extern void tpm_bios_log_teardown(struct dentry **);
#else
static inline struct dentry ** tpm_bios_log_setup(char *name)
{
	return NULL;
}
static inline void tpm_bios_log_teardown(struct dentry **dir)
{
}
#endif
Commit	Line	Data
1da177e4 LT	1	/*
	2	* Copyright (C) 2004 IBM Corporation
	3	*
	4	* Authors:
	5	* Leendert van Doorn <leendert@watson.ibm.com>
	6	* Dave Safford <safford@watson.ibm.com>
	7	* Reiner Sailer <sailer@watson.ibm.com>
	8	* Kylene Hall <kjhall@us.ibm.com>
	9	*
8e81cc13	10	* Maintained by: <tpmdd-devel@lists.sourceforge.net>
1da177e4 LT	11	*
	12	* Device driver for TCG/TCPA TPM (trusted platform module).
	13	* Specifications at www.trustedcomputinggroup.org
	14	*
	15	* This program is free software; you can redistribute it and/or
	16	* modify it under the terms of the GNU General Public License as
	17	* published by the Free Software Foundation, version 2 of the
	18	* License.
	19	*
	20	*/
	21	#include <linux/module.h>
1da177e4 LT	22	#include <linux/delay.h>
1da177e4 LT	23	#include <linux/fs.h>
d081d470	24	#include <linux/mutex.h>
914e2637	25	#include <linux/sched.h>
1da177e4	26	#include <linux/miscdevice.h>
bbc5b212	27	#include <linux/platform_device.h>
276ad0c1	28	#include <linux/io.h>
659aaf2b	29	#include <linux/tpm.h>
1da177e4	30
3122a88a KH	31	enum tpm_timeout {
	32	TPM_TIMEOUT = 5, /* msecs */
	33	};
1da177e4 LT	34
1da177e4 LT	35	/* TPM addresses */
3122a88a	36	enum tpm_addr {
daacdfa6	37	TPM_SUPERIO_ADDR = 0x2E,
3122a88a	38	TPM_ADDR = 0x4E,
3122a88a KH	39	};
3122a88a KH	40
6659ca2a KH	41	extern ssize_t tpm_show_pubek(struct device , struct device_attribute attr,
	42	char *);
	43	extern ssize_t tpm_show_pcrs(struct device , struct device_attribute attr,
	44	char *);
	45	extern ssize_t tpm_show_caps(struct device , struct device_attribute attr,
	46	char *);
08e96e48 KJH	47	extern ssize_t tpm_show_caps_1_2(struct device , struct device_attribute attr,
08e96e48 KJH	48	char *);
6659ca2a KH	49	extern ssize_t tpm_store_cancel(struct device , struct device_attribute attr,
6659ca2a KH	50	const char *, size_t);
08e96e48 KJH	51	extern ssize_t tpm_show_enabled(struct device , struct device_attribute attr,
	52	char *);
	53	extern ssize_t tpm_show_active(struct device , struct device_attribute attr,
	54	char *);
	55	extern ssize_t tpm_show_owned(struct device , struct device_attribute attr,
	56	char *);
	57	extern ssize_t tpm_show_temp_deactivated(struct device *,
	58	struct device_attribute attr, char );
9b29050f SB	59	extern ssize_t tpm_show_timeouts(struct device *,
9b29050f SB	60	struct device_attribute attr, char );
1da177e4 LT	61
	62	struct tpm_chip;
	63
	64	struct tpm_vendor_specific {
e0dd03ca KJH	65	const u8 req_complete_mask;
	66	const u8 req_complete_val;
	67	const u8 req_canceled;
ad5ea3cc KJH	68	void __iomem iobase; / ioremapped address */
	69	unsigned long base; /* TPM base address */
	70
27084efe LD	71	int irq;
27084efe LD	72
ad5ea3cc KJH	73	int region_size;
ad5ea3cc KJH	74	int have_region;
1da177e4 LT	75
	76	int (recv) (struct tpm_chip , u8 *, size_t);
	77	int (send) (struct tpm_chip , u8 *, size_t);
	78	void (cancel) (struct tpm_chip );
b4ed3e3c	79	u8 (status) (struct tpm_chip );
5bd91f18	80	void (release) (struct device );
1da177e4	81	struct miscdevice miscdev;
6659ca2a	82	struct attribute_group *attr_group;
27084efe LD	83	struct list_head list;
27084efe LD	84	int locality;
36b20020 KJH	85	unsigned long timeout_a, timeout_b, timeout_c, timeout_d; /* jiffies */
36b20020 KJH	86	unsigned long duration[3]; /* jiffies */
27084efe LD	87
	88	wait_queue_head_t read_queue;
	89	wait_queue_head_t int_queue;
1da177e4 LT	90	};
	91
	92	struct tpm_chip {
e659a3fe	93	struct device dev; / Device stuff */
1da177e4 LT	94
1da177e4 LT	95	int dev_num; /* /dev/tpm# */
dc36d32c	96	unsigned long is_open; /* only one allowed */
1da177e4 LT	97	int time_expired;
	98
	99	/* Data passed to and from the tpm via the read/write calls */
	100	u8 *data_buffer;
	101	atomic_t data_pending;
d081d470	102	struct mutex buffer_mutex;
1da177e4 LT	103
1da177e4 LT	104	struct timer_list user_read_timer; /* user needs to claim result */
09e12f9f	105	struct work_struct work;
d081d470	106	struct mutex tpm_mutex; /* tpm is processing */
1da177e4	107
90dda520	108	struct tpm_vendor_specific vendor;
1da177e4	109
55a82ab3 KJH	110	struct dentry **bios_dir;
55a82ab3 KJH	111
1da177e4	112	struct list_head list;
5bd91f18	113	void (release) (struct device );
1da177e4 LT	114	};
1da177e4 LT	115
27084efe LD	116	#define to_tpm_chip(n) container_of(n, struct tpm_chip, vendor)
27084efe LD	117
a0e39349 MZ	118	static inline void tpm_chip_put(struct tpm_chip *chip)
	119	{
	120	module_put(chip->dev->driver->owner);
	121	}
	122
daacdfa6	123	static inline int tpm_read_index(int base, int index)
1da177e4	124	{
daacdfa6 KJH	125	outb(index, base);
daacdfa6 KJH	126	return inb(base+1) & 0xFF;
1da177e4 LT	127	}
1da177e4 LT	128
daacdfa6	129	static inline void tpm_write_index(int base, int index, int value)
1da177e4	130	{
daacdfa6 KJH	131	outb(index, base);
daacdfa6 KJH	132	outb(value & 0xFF, base+1);
1da177e4	133	}
08837438 RA	134	struct tpm_input_header {
	135	__be16 tag;
	136	__be32 length;
	137	__be32 ordinal;
	138	}__attribute__((packed));
	139
	140	struct tpm_output_header {
	141	__be16 tag;
	142	__be32 length;
	143	__be32 return_code;
	144	}__attribute__((packed));
	145
	146	struct stclear_flags_t {
	147	__be16 tag;
	148	u8 deactivated;
	149	u8 disableForceClear;
	150	u8 physicalPresence;
	151	u8 physicalPresenceLock;
	152	u8 bGlobalLock;
	153	}__attribute__((packed));
	154
	155	struct tpm_version_t {
	156	u8 Major;
	157	u8 Minor;
	158	u8 revMajor;
	159	u8 revMinor;
	160	}__attribute__((packed));
	161
	162	struct tpm_version_1_2_t {
	163	__be16 tag;
	164	u8 Major;
	165	u8 Minor;
	166	u8 revMajor;
	167	u8 revMinor;
	168	}__attribute__((packed));
	169
	170	struct timeout_t {
	171	__be32 a;
	172	__be32 b;
	173	__be32 c;
	174	__be32 d;
	175	}__attribute__((packed));
	176
	177	struct duration_t {
	178	__be32 tpm_short;
	179	__be32 tpm_medium;
	180	__be32 tpm_long;
	181	}__attribute__((packed));
	182
	183	struct permanent_flags_t {
	184	__be16 tag;
	185	u8 disable;
	186	u8 ownership;
	187	u8 deactivated;
	188	u8 readPubek;
	189	u8 disableOwnerClear;
	190	u8 allowMaintenance;
	191	u8 physicalPresenceLifetimeLock;
	192	u8 physicalPresenceHWEnable;
	193	u8 physicalPresenceCMDEnable;
	194	u8 CEKPUsed;
	195	u8 TPMpost;
	196	u8 TPMpostLock;
	197	u8 FIPS;
198	u8 operator;
199	u8 enableRevokeEK;
200	u8 nvLocked;
201	u8 readSRKPub;
202	u8 tpmEstablished;
203	u8 maintenanceDone;
204	u8 disableFullDALogicInfo;
205	}__attribute__((packed));
206
207	typedef union {
208	struct permanent_flags_t perm_flags;
209	struct stclear_flags_t stclear_flags;
210	bool owned;
211	__be32 num_pcrs;
212	struct tpm_version_t tpm_version;
213	struct tpm_version_1_2_t tpm_version_1_2;
214	__be32 manufacturer_id;
215	struct timeout_t timeout;
216	struct duration_t duration;
217	} cap_t;
218
219	struct tpm_getcap_params_in {
220	__be32 cap;
221	__be32 subcap_size;
222	__be32 subcap;
223	}__attribute__((packed));
224
225	struct tpm_getcap_params_out {
226	__be32 cap_size;
227	cap_t cap;
228	}__attribute__((packed));
229
230	struct tpm_readpubek_params_out {
231	u8 algorithm[4];
232	u8 encscheme[2];
233	u8 sigscheme[2];
02a077c5	234	__be32 paramsize;
08837438 RA	235	u8 parameters[12]; /assuming RSA/
	236	__be32 keysize;
	237	u8 modulus[256];
	238	u8 checksum[20];
	239	}__attribute__((packed));
	240
	241	typedef union {
	242	struct tpm_input_header in;
	243	struct tpm_output_header out;
	244	} tpm_cmd_header;
	245
659aaf2b RA	246	#define TPM_DIGEST_SIZE 20
	247	struct tpm_pcrread_out {
	248	u8 pcr_result[TPM_DIGEST_SIZE];
	249	}__attribute__((packed));
	250
	251	struct tpm_pcrread_in {
	252	__be32 pcr_idx;
	253	}__attribute__((packed));
	254
	255	struct tpm_pcrextend_in {
	256	__be32 pcr_idx;
	257	u8 hash[TPM_DIGEST_SIZE];
	258	}__attribute__((packed));
	259
08837438 RA	260	typedef union {
	261	struct tpm_getcap_params_out getcap_out;
	262	struct tpm_readpubek_params_out readpubek_out;
	263	u8 readpubek_out_buffer[sizeof(struct tpm_readpubek_params_out)];
	264	struct tpm_getcap_params_in getcap_in;
659aaf2b RA	265	struct tpm_pcrread_in pcrread_in;
	266	struct tpm_pcrread_out pcrread_out;
	267	struct tpm_pcrextend_in pcrextend_in;
08837438 RA	268	} tpm_cmd_params;
	269
	270	struct tpm_cmd_t {
	271	tpm_cmd_header header;
	272	tpm_cmd_params params;
	273	}__attribute__((packed));
	274
	275	ssize_t tpm_getcap(struct device , __be32, cap_t , const char *);
1da177e4	276
08e96e48 KJH	277	extern void tpm_get_timeouts(struct tpm_chip *);
	278	extern void tpm_gen_interrupt(struct tpm_chip *);
	279	extern void tpm_continue_selftest(struct tpm_chip *);
9e18ee19	280	extern unsigned long tpm_calc_ordinal_duration(struct tpm_chip *, u32);
e0dd03ca KJH	281	extern struct tpm_chip* tpm_register_hardware(struct device *,
e0dd03ca KJH	282	const struct tpm_vendor_specific *);
1da177e4 LT	283	extern int tpm_open(struct inode , struct file );
1da177e4 LT	284	extern int tpm_release(struct inode , struct file );
253115b7	285	extern void tpm_dev_vendor_release(struct tpm_chip *);
1da177e4 LT	286	extern ssize_t tpm_write(struct file , const char __user , size_t,
	287	loff_t *);
	288	extern ssize_t tpm_read(struct file , char __user , size_t, loff_t *);
e659a3fe	289	extern void tpm_remove_hardware(struct device *);
ce2c87d4 KJH	290	extern int tpm_pm_suspend(struct device *, pm_message_t);
ce2c87d4 KJH	291	extern int tpm_pm_resume(struct device *);
55a82ab3 KJH	292
	293	#ifdef CONFIG_ACPI
	294	extern struct dentry ** tpm_bios_log_setup(char *);
	295	extern void tpm_bios_log_teardown(struct dentry **);
	296	#else
bb53a761	297	static inline struct dentry ** tpm_bios_log_setup(char *name)
55a82ab3 KJH	298	{
	299	return NULL;
	300	}
	301	static inline void tpm_bios_log_teardown(struct dentry **dir)
	302	{
	303	}
	304	#endif