include/tis.h

   1 /*
   2  * Copyright (c) 2011 The Chromium OS Authors.
   3  *
   4  * SPDX-License-Identifier:     GPL-2.0+
   5  */
   6
   7 #ifndef __TIS_H
   8 #define __TIS_H
   9
  10 #include <common.h>
  11
  12 /* Low-level interface to access TPM */
  13
  14 /*
  15  * tis_init()
  16  *
  17  * Initialize the TPM device. Returns 0 on success or -1 on
  18  * failure (in case device probing did not succeed).
  19  */
  20 int tis_init(void);
  21
  22 /*
  23  * tis_open()
  24  *
  25  * Requests access to locality 0 for the caller. After all commands have been
  26  * completed the caller is supposed to call tis_close().
  27  *
  28  * Returns 0 on success, -1 on failure.
  29  */
  30 int tis_open(void);
  31
  32 /*
  33  * tis_close()
  34  *
  35  * terminate the currect session with the TPM by releasing the locked
  36  * locality. Returns 0 on success of -1 on failure (in case lock
  37  * removal did not succeed).
  38  */
  39 int tis_close(void);
  40
  41 /*
  42  * tis_sendrecv()
  43  *
  44  * Send the requested data to the TPM and then try to get its response
  45  *
  46  * @sendbuf - buffer of the data to send
  47  * @send_size size of the data to send
  48  * @recvbuf - memory to save the response to
  49  * @recv_len - pointer to the size of the response buffer
  50  *
  51  * Returns 0 on success (and places the number of response bytes at recv_len)
  52  * or -1 on failure.
  53  */
  54 int tis_sendrecv(const uint8_t *sendbuf, size_t send_size, uint8_t *recvbuf,
  55                         size_t *recv_len);
  56
  57 #endif /* __TIS_H */