metee.h

Go to the documentation of this file.

/* SPDX-License-Identifier: Apache-2.0 */
/*
 * Copyright (C) 2014-2021 Intel Corporation
 */
#ifndef __METEE_H
#define __METEE_H
 
#ifdef __cplusplus
extern "C" {
#endif
 
#include <stddef.h>
#include <stdint.h>
#ifdef _WIN32
    #include <Windows.h>
    #include <initguid.h>
 
    #ifndef METEE_DLL
        #define METEE_DLL_API
    #else /* METEE_DLL */
        #ifdef METEE_DLL_EXPORT
            #define METEE_DLL_API __declspec(dllexport)
        #else
            #define METEE_DLL_API __declspec(dllimport)
        #endif /* METEE_DLL_EXPORT */
    #endif /* METEE_DLL */
    #define TEEAPI METEE_DLL_API __stdcall
    #define TEE_DEVICE_HANDLE HANDLE
    #define TEE_INVALID_DEVICE_HANDLE ((void*)0)
#else /* _WIN32 */
    #include <linux/uuid.h>
 
    #ifndef METEE_DLL
        #define METEE_DLL_API
    #else 
        #ifdef METEE_DLL_EXPORT
            #define METEE_DLL_API __attribute__((__visibility__("default")))
        #else
            #define METEE_DLL_API
        #endif /* METEE_DLL_EXPORT */
    #endif /* METEE_DLL */
    #define TEEAPI METEE_DLL_API
    #define GUID uuid_le
    #define DEFINE_GUID(name, l, w1, w2, b1, b2, b3, b4, b5, b6, b7, b8) \
        const uuid_le name = UUID_LE(l, w1, w2, b1, b2, b3, b4, b5, b6, b7, b8)
    #define TEE_DEVICE_HANDLE int
    #define TEE_INVALID_DEVICE_HANDLE (-1)
    #ifndef IN
        #define IN
    #endif
    #ifndef OUT
        #define OUT
    #endif
    #ifndef OPTIONAL
        #define OPTIONAL
    #endif
#endif /* _WIN32 */

typedef struct _TEEHANDLE {
 
    void    *handle;          
    size_t  maxMsgLen;        
    uint8_t protcolVer;       
} TEEHANDLE;

typedef TEEHANDLE *PTEEHANDLE;
 
 

#define TEEHANDLE_ZERO {0}
 
typedef uint16_t TEESTATUS; 
#define TEE_ERROR_BASE                    0x0000U
#define TEE_SUCCESS                       (TEE_ERROR_BASE + 0)
#define TEE_INTERNAL_ERROR                (TEE_ERROR_BASE + 1)
#define TEE_DEVICE_NOT_FOUND              (TEE_ERROR_BASE + 2)
#define TEE_DEVICE_NOT_READY              (TEE_ERROR_BASE + 3)
#define TEE_INVALID_PARAMETER             (TEE_ERROR_BASE + 4)
#define TEE_UNABLE_TO_COMPLETE_OPERATION  (TEE_ERROR_BASE + 5)
#define TEE_TIMEOUT                       (TEE_ERROR_BASE + 6)
#define TEE_NOTSUPPORTED                  (TEE_ERROR_BASE + 7)
#define TEE_CLIENT_NOT_FOUND              (TEE_ERROR_BASE + 8)
#define TEE_BUSY                          (TEE_ERROR_BASE + 9)
#define TEE_DISCONNECTED                  (TEE_ERROR_BASE + 10)
#define TEE_INSUFFICIENT_BUFFER           (TEE_ERROR_BASE + 11)
#define TEE_PERMISSION_DENIED             (TEE_ERROR_BASE + 12)

#define TEE_IS_SUCCESS(Status) (((TEESTATUS)(Status)) == TEE_SUCCESS)

TEESTATUS TEEAPI TeeInit(IN OUT PTEEHANDLE handle, IN const GUID *guid,
             IN OPTIONAL const char *device);
 
#ifdef _WIN32
TEESTATUS TEEAPI TeeInitGUID(IN OUT PTEEHANDLE handle, IN const GUID *guid,
                 IN OPTIONAL const GUID *device);
#endif /* _WIN32 */

TEESTATUS TEEAPI TeeInitHandle(IN OUT PTEEHANDLE handle, IN const GUID *guid,
                   IN const TEE_DEVICE_HANDLE device_handle);

TEESTATUS TEEAPI TeeConnect(OUT PTEEHANDLE handle);

TEESTATUS TEEAPI TeeRead(IN PTEEHANDLE handle, IN OUT void *buffer, IN size_t bufferSize,
             OUT OPTIONAL size_t *pNumOfBytesRead, IN OPTIONAL uint32_t timeout);

TEESTATUS TEEAPI TeeWrite(IN PTEEHANDLE handle, IN const void *buffer, IN size_t bufferSize,
              OUT OPTIONAL size_t *numberOfBytesWritten, IN OPTIONAL uint32_t timeout);

TEESTATUS TEEAPI TeeFWStatus(IN PTEEHANDLE handle,
                 IN uint32_t fwStatusNum, OUT uint32_t *fwStatus);

void TEEAPI TeeDisconnect(IN PTEEHANDLE handle);

TEE_DEVICE_HANDLE TEEAPI TeeGetDeviceHandle(IN PTEEHANDLE handle);

typedef struct {
    uint16_t major;  
    uint16_t minor;  
    uint16_t hotfix; 
    uint16_t build;  
} teeDriverVersion_t;

TEESTATUS TEEAPI GetDriverVersion(IN PTEEHANDLE handle, IN OUT teeDriverVersion_t *driverVersion);
 
#ifdef __cplusplus
}
#endif
 
#endif /* __METEE_H */