src/tbm_bufmgr_int.h

   1 /**************************************************************************
   2
   3 libtbm
   4
   5 Copyright 2012 Samsung Electronics co., Ltd. All Rights Reserved.
   6
   7 Contact: SooChan Lim <sc1.lim@samsung.com>, Sangjin Lee <lsj119@samsung.com>
   8 Boram Park <boram1288.park@samsung.com>, Changyeon Lee <cyeon.lee@samsung.com>
   9
  10 Permission is hereby granted, free of charge, to any person obtaining a
  11 copy of this software and associated documentation files (the
  12 "Software"), to deal in the Software without restriction, including
  13 without limitation the rights to use, copy, modify, merge, publish,
  14 distribute, sub license, and/or sell copies of the Software, and to
  15 permit persons to whom the Software is furnished to do so, subject to
  16 the following conditions:
  17
  18 The above copyright notice and this permission notice (including the
  19 next paragraph) shall be included in all copies or substantial portions
  20 of the Software.
  21
  22 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
  23 OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
  24 MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT.
  25 IN NO EVENT SHALL PRECISION INSIGHT AND/OR ITS SUPPLIERS BE LIABLE FOR
  26 ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
  27 TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
  28 SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
  29
  30 **************************************************************************/
  31
  32 #ifndef _TBM_BUFMGR_INT_H_
  33 #define _TBM_BUFMGR_INT_H_
  34
  35 #include <sys/time.h>
  36 #include <unistd.h>
  37 #include <limits.h>
  38 #include <stdlib.h>
  39 #include <stdio.h>
  40 #include <string.h>
  41 #include <sys/ioctl.h>
  42 #include <sys/types.h>
  43 #include <sys/stat.h>
  44 #include <fcntl.h>
  45 #include <dlfcn.h>
  46 #include <dirent.h>
  47 #include <string.h>
  48 #include <errno.h>
  49 #include <assert.h>
  50 #include <pthread.h>
  51 #include <dlog.h>
  52 #include <tbm_bufmgr.h>
  53 #include <tbm_bo.h>
  54 #include <tbm_surface.h>
  55 #include <tbm_surface_internal.h>
  56 #include <tbm_surface_queue.h>
  57 #include <tbm_log.h>
  58 #include <tbm_error.h>
  59 #include "tbm_module.h"
  60
  61 extern tbm_bufmgr gBufMgr;
  62 extern int b_dump_queue;
  63 extern int trace_mask;
  64
  65 #define TBM_BO_MAGIC 0xBF011234
  66
  67 #define C(b, m)                (((b) >> (m)) & 0xFF)
  68 #define B(c, s)                ((((unsigned int)(c)) & 0xff) << (s))
  69 #define FOURCC(a, b, c, d)     (B(d, 24) | B(c, 16) | B(b, 8) | B(a, 0))
  70 #define FOURCC_STR(id)         C(id, 0), C(id, 8), C(id, 16), C(id, 24)
  71 #define FOURCC_ID(str)         FOURCC(((char*)str)[0], ((char*)str)[1], ((char*)str)[2], ((char*)str)[3])
  72
  73 /* check flags */
  74 #define RETURN_CHECK_FLAG(cond) {\
  75         if ((cond)) {\
  76                 return;\
  77         } \
  78 }
  79 #define RETURN_VAL_CHECK_FLAG(cond, val) {\
  80         if ((cond)) {\
  81                 return val;\
  82         } \
  83 }
  84
  85 #define TBM_TRACE_BO(fmt, args...) \
  86         do { \
  87                 if (trace_mask&TBM_BUFGMR_DEBUG_TRACE_BO) { \
  88                         struct timespec ts; \
  89                         clock_gettime(CLOCK_MONOTONIC, &ts); \
  90                         tbm_log_print(TBM_LOG_LEVEL_INFO, "[%5d.%06d][%d][%s %d](TRACE)"fmt, \
  91                                                   (int)ts.tv_sec, (int)ts.tv_nsec / 1000, \
  92                                                   (int)syscall(SYS_gettid), __FUNCTION__, __LINE__, ##args);  \
  93                 } \
  94         } while (0)
  95
  96 #define TBM_TRACE_SURFACE_INTERNAL(fmt, args...) \
  97         do { \
  98                 if (trace_mask&TBM_BUFGMR_DEBUG_TRACE_SURFACE_INTERNAL) { \
  99                         struct timespec ts; \
 100                         clock_gettime(CLOCK_MONOTONIC, &ts); \
 101                         tbm_log_print(TBM_LOG_LEVEL_INFO, "[%5d.%06d][%d][%s %d](TRACE)"fmt, \
 102                                                   (int)ts.tv_sec, (int)ts.tv_nsec / 1000, \
 103                                                   (int)syscall(SYS_gettid), __FUNCTION__, __LINE__, ##args);  \
 104                 } \
 105         } while (0)
 106
 107 #define TBM_TRACE_SURFACE(fmt, args...) \
 108         do { \
 109                 if (trace_mask&TBM_BUFGMR_DEBUG_TRACE_SURFACE) { \
 110                         struct timespec ts; \
 111                         clock_gettime(CLOCK_MONOTONIC, &ts); \
 112                         tbm_log_print(TBM_LOG_LEVEL_INFO, "[%5d.%06d][%d][%s %d](TRACE)"fmt, \
 113                                                   (int)ts.tv_sec, (int)ts.tv_nsec / 1000, \
 114                                                   (int)syscall(SYS_gettid), __FUNCTION__, __LINE__, ##args);  \
 115                 } \
 116         } while (0)
 117
 118 #define TBM_TRACE_SURFACE_QUEUE(fmt, args...) \
 119         do { \
 120                 if (trace_mask&TBM_BUFGMR_DEBUG_TRACE_SURFACE_QUEUE) { \
 121                         struct timespec ts; \
 122                         clock_gettime(CLOCK_MONOTONIC, &ts); \
 123                         tbm_log_print(TBM_LOG_LEVEL_INFO, "[%5d.%06d][%d][%s %d](TRACE)"fmt, \
 124                                                   (int)ts.tv_sec, (int)ts.tv_nsec / 1000, \
 125                                                   (int)syscall(SYS_gettid), __FUNCTION__, __LINE__, ##args);  \
 126                 } \
 127         } while (0)
 128
 129 #define TBM_TRACE(fmt, args...) \
 130         do { \
 131                 if (trace_mask&0x1) { \
 132                         struct timespec ts; \
 133                         clock_gettime(CLOCK_MONOTONIC, &ts); \
 134                         tbm_log_print(TBM_LOG_LEVEL_INFO, "[%5d.%06d][%d][%s %d](TRACE)"fmt, \
 135                                                   (int)ts.tv_sec, (int)ts.tv_nsec / 1000, \
 136                                                   (int)syscall(SYS_gettid), __FUNCTION__, __LINE__, ##args);  \
 137                 } \
 138         } while (0)
 139
 140
 141 /* check validation */
 142 #define TBM_BUFMGR_IS_VALID(mgr) (mgr && mgr == gBufMgr)
 143 #define TBM_BO_IS_VALID(bo) (bo && \
 144                             TBM_BUFMGR_IS_VALID(bo->bufmgr) && \
 145                             bo->item_link.next && \
 146                             bo->item_link.next->prev == &bo->item_link)
 147 #define TBM_SURFACE_IS_VALID(surf) (surf && \
 148                                    TBM_BUFMGR_IS_VALID(surf->bufmgr) && \
 149                                    surf->item_link.next && \
 150                                    surf->item_link.next->prev == &surf->item_link)
 151
 152
 153 #define TBM_SNRPRINTF(p, len, count, fmt, ARG...)  \
 154         do { \
 155                 if (p) { \
 156                         int rest = len - count; \
 157                         int s = snprintf(&p[count], rest, fmt, ##ARG); \
 158                         while (s >= rest) { \
 159                                 len *= 2; \
 160                                 p = realloc(p, len); \
 161                                 rest = len - count; \
 162                                 s = snprintf(&p[count], rest, fmt, ##ARG); \
 163                         } \
 164                         count += s; \
 165                 } \
 166         } while (0)
 167
 168 struct list_head {
 169         struct list_head *prev;
 170         struct list_head *next;
 171 };
 172
 173 /**
 174  * @brief tbm_bo : buffer object of Tizen Buffer Manager
 175  */
 176 struct _tbm_bo {
 177         unsigned int magic;              /* tbm bo magic number */
 178         tbm_bufmgr bufmgr;               /* tbm buffer manager */
 179         int ref_cnt;                     /* ref count of bo */
 180         int flags;                       /* TBM_BO_FLAGS :bo memory type */
 181         struct list_head user_data_list; /* list of the user_date in bo */
 182         struct list_head item_link;      /* link of bo */
 183         tbm_surface_h surface;           /* tbm_surface */
 184         int lock_cnt;                    /* lock count of bo */
 185         unsigned int map_cnt;            /* device map count */
 186
 187         tbm_bo_data *bo_data;            /* bo data of the module */
 188         int get_from_surface_data;       /* bo_data has be detroyed by surface_data */
 189 };
 190
 191 /**
 192  * @brief tbm_bufmgr : structure for tizen buffer manager
 193  *
 194  */
 195 struct _tbm_bufmgr {
 196         int ref_count;                    /* reference count */
 197         int fd;                           /* bufmgr fd */
 198         tbm_bufmgr_bo_lock_type bo_lock_type;  /* lock_type of bufmgr */
 199         int capabilities;                 /* capabilities of bufmgr */
 200         int display_server;               /* used by display server */
 201         unsigned int bo_cnt;              /* number of bos */
 202         struct list_head bo_list;         /* list of bos belonging to bufmgr */
 203         struct list_head surf_list;       /* list of surfaces belonging to bufmgr */
 204         struct list_head surf_queue_list; /* list of surface queues belonging to bufmgr */
 205         struct list_head debug_key_list;  /* list of debug data key list belonging to bufmgr */
 206
 207         tbm_module *module;               /* tbm module information */
 208 };
 209
 210 /**
 211  * @brief tbm_surface : structure for tizen buffer surface
 212  *
 213  */
 214 struct _tbm_surface {
 215         unsigned int magic;         /* tbm surface magic number */
 216
 217         tbm_bufmgr bufmgr;                      /* tbm buffer manager */
 218
 219         tbm_surface_info_s info;        /* tbm surface information */
 220
 221         int flags;
 222
 223         int num_bos;                            /* the number of buffer objects */
 224
 225         tbm_bo bos[4];
 226
 227         int num_planes;                         /* the number of buffer objects */
 228
 229         int planes_bo_idx[TBM_SURF_PLANE_MAX];
 230
 231         int refcnt;
 232
 233         unsigned int debug_pid;
 234
 235         struct list_head item_link; /* link of surface */
 236
 237         struct list_head user_data_list;        /* list of the user_data in surface */
 238
 239         struct list_head debug_data_list;       /* list of debug data */
 240
 241         struct list_head destroy_funcs; /* list of destory callback function */
 242
 243         struct {
 244                 int x;
 245                 int y;
 246                 int width;
 247                 int height;
 248         } damage;
 249
 250         tbm_surface_data *surface_data; /* surface data of the module */
 251 };
 252
 253 typedef struct {
 254         unsigned long key;
 255         void *data;
 256         tbm_data_free free_func;
 257
 258         /* link of user_data */
 259         struct list_head item_link;
 260 } tbm_user_data;
 261
 262 typedef struct {
 263         char *key;
 264         char *value;
 265
 266         /* link of user_data */
 267         struct list_head item_link;
 268 } tbm_surface_debug_data;
 269
 270 typedef struct _tbm_surface_destroy_func_info {
 271         tbm_surface_internal_destroy_handler destroy_func;
 272         void *user_data;
 273
 274         struct list_head item_link;
 275 } tbm_surface_destroy_func_info;
 276
 277 tbm_bufmgr _tbm_bufmgr_get_bufmgr(void);
 278 int _tbm_bo_set_surface(tbm_bo bo, tbm_surface_h surface);
 279 int _tbm_surface_is_valid(tbm_surface_h surface);
 280 void _tbm_bo_free(tbm_bo bo);
 281
 282 int tbm_surface_internal_get_info(tbm_surface_h surface, int opt,
 283                                   tbm_surface_info_s *info, int map);
 284 void tbm_surface_internal_unmap(tbm_surface_h surface);
 285 unsigned int tbm_surface_internal_get_width(tbm_surface_h surface);
 286 unsigned int tbm_surface_internal_get_height(tbm_surface_h surface);
 287 tbm_format tbm_surface_internal_get_format(tbm_surface_h surface);
 288 unsigned int _tbm_surface_internal_get_debug_pid(tbm_surface_h surface);
 289 char *_tbm_surface_internal_format_to_str(tbm_format format);
 290 char * _tbm_surface_internal_get_debug_data(tbm_surface_h surface, char *key);
 291
 292 tbm_user_data *user_data_lookup(struct list_head *user_data_list,
 293                                 unsigned long key);
 294 tbm_user_data *user_data_create(unsigned long key,
 295                                 tbm_data_free data_free_func);
 296 void user_data_delete(tbm_user_data *user_data);
 297
 298 int tbm_bufmgr_get_fd_limit(void);
 299 tbm_bufmgr tbm_bufmgr_get(void);
 300
 301 void _tbm_set_last_result(tbm_error_e err);
 302
 303 char *_tbm_flag_to_str(int f);
 304
 305 /* functions for mutex */
 306 void _tbm_bufmgr_mutex_lock(void);
 307 void _tbm_bufmgr_mutex_unlock(void);
 308 tbm_bo tbm_bufmgr_internal_find_bo(tbm_bufmgr bufmgr, tbm_bo bo);
 309
 310 tbm_bo tbm_bufmgr_internal_alloc_bo(tbm_bufmgr bufmgr, int size, int flags);
 311 tbm_bo tbm_bufmgr_internal_alloc_bo_with_format(tbm_bufmgr bufmgr, int format, int bo_idx, int width, int bpp, int height, tbm_bo_memory_type flags, tbm_error_e *error);
 312 tbm_bo tbm_bufmgr_internal_alloc_bo_with_bo_data(tbm_bufmgr bufmgr, tbm_bo_data *bo_data, int flags, tbm_error_e *error);
 313 tbm_bo tbm_bufmgr_internal_import_bo_with_key(tbm_bufmgr bufmgr, tbm_key key);
 314 tbm_bo tbm_bufmgr_internal_import_bo_with_fd(tbm_bufmgr bufmgr, tbm_fd fd);
 315
 316 #endif /* _TBM_BUFMGR_INT_H_ */