Samsung Internal API reference  2.0
tees_tui.h File Reference

The Trusted User Interface API permits the display of screens to the user and achieves three objectives: More...

Go to the source code of this file.

Data Structures

struct  TEES_TUIScreenInfo
 Structure that represents information on the requested screen. More...
 
struct  TEES_TUITouchInfo
 Structure that represents information of touch event (touch position, touch type). More...
 
struct  TEES_TUIMTInfo
 Structure that represents information of touch event (touch position, touch type). More...
 
struct  TEES_TUI_MT_Info
 Structure that represents all the information of touch events. More...
 
struct  TEES_TUIImage
 Structure that represents properties of image and buffers. More...
 

Macros

#define MT_INFO_MAX_EVENT   10
 
#define MIN_FONT_SIZE   20
 
#define MAX_FONT_SIZE   160
 

Enumerations

enum  TEES_Result {
  TEES_SUCCESS = 0x00000000, TEES_ERROR_TUI_GENERIC = 0xFFFF0000, TEES_ERROR_TUI_CANCEL = 0xFFFF0002, TEES_ERROR_TUI_BAD_FORMAT = 0xFFFF0005,
  TEES_ERROR_TUI_INVAL_PARAM = 0xFFFF0006, TEES_ERROR_TUI_BAD_STATE = 0xFFFF0007, TEES_ERROR_NOT_IMPLEMENTED = 0xFFFF0009, TEES_ERROR_NOT_SUPPORTED = 0xFFFF000A,
  TEES_ERROR_TUI_OUT_OF_MEMORY = 0xFFFF000C, TEES_ERROR_TUI_BUSY = 0xFFFF000D, TEES_ERROR_SHORT_BUFFER = 0xFFFF0010, TEES_ERROR_TUI_TIMEOUT = 0xFFFF3001
}
 TEES result codes. More...
 
enum  TEES_TUITouchTypes { TEES_TOUCH_PRESSED, TEES_TOUCH_RELEASED }
 Internal, touch event type. More...
 
enum  TEES_bool { TEES_FALSE = 0, TEES_TRUE = 1 }
 Internal, bool type. More...
 

Functions

TEES_Result TEES_TUIGetScreenInfo (TEES_TUIScreenInfo *screenInfo)
 Retrieves information about the screen. More...
 
TEES_Result TEES_TUIOpenSession (void)
 Claims an exclusive access to TUI resources. More...
 
TEES_Result TEES_TUICloseSession (void)
 Releases TUI resources. More...
 
TEES_Result TEES_TUIDrawImage (TEES_TUIImage *image, uint32_t posX, uint32_t posY)
 Display an image on screen. More...
 
TEES_Result TEES_TUIGetTouchEvent (TEES_TUITouchInfo *touchInfo, uint32_t timeout)
 Get a touch event. More...
 
TEES_Result TEES_TUIGetMTEvent (TEES_TUI_MT_Info *touchInfo, uint32_t timeout)
 Get Multi touch event events. More...
 
TEES_Result TEES_TUICheckTextFormat (char *inputText, uint32_t textSize, uint32_t *width, uint32_t *height, uint32_t *lastIndex)
 Checks validity of the string and Retrieves its width and height. More...
 
TEES_Result TEES_TUIPrintString (char *inputText, uint32_t textSize, uint32_t posX, uint32_t posY, uint8_t redColorValue, uint8_t greenColorValue, uint8_t blueColorValue, bool rotation90)
 Print string on the screen. More...
 
TEES_Result TEES_TUIRefreshScreen (void)
 Refresh display controller. More...
 
TEES_Result TEES_TUIGetBuffer (uint32_t *buffer, uint32_t posX, uint32_t posY, uint32_t W, uint32_t H)
 Copy a rectangle from screen to buffer. More...
 
TEES_Result TEES_TUIDrawBuffer (uint32_t *buffer, uint32_t posX, uint32_t posY, uint32_t W, uint32_t H)
 Copy a rectangle from buffer to screen. More...
 
TEES_Result TEES_TUIDrawImageToBuff (TEES_TUIImage *image, void *buff, uint32_t *buf_size)
 Unpack png picture to bitmap in buffer. More...
 
TEES_Result TEES_TUIDrawImageFromBuff (uint32_t posX, uint32_t posY, uint32_t W, uint32_t H, void *buff, uint32_t buf_size)
 Draw unpacked bitmap from buffer on display. More...
 

Detailed Description

The Trusted User Interface API permits the display of screens to the user and achieves three objectives:

  • Secure Display - Information displayed to the user cannot be accessed, modified, or obscured by any software within the REE or by an unauthorized application in the TEE.
  • Secure Input - Information entered by the user cannot be derived or modified by any software within the REE or by an unauthorized application in the TEE.
  • Secure Indicator - The user can be confident that the screen displayed is actually a screen displayed by a TA.