drv.h

   1 /*
   2  * Copyright 2016 The Chromium OS Authors. All rights reserved.
   3  * Use of this source code is governed by a BSD-style license that can be
   4  * found in the LICENSE file.
   5  */
   6
   7 #ifndef DRV_H_
   8 #define DRV_H_
   9
  10 #ifdef __cplusplus
  11 extern "C" {
  12 #endif
  13
  14 #include <drm_fourcc.h>
  15 #include <stdint.h>
  16
  17 #define DRV_MAX_PLANES 4
  18
  19 // clang-format off
  20 /* Use flags */
  21 #define BO_USE_NONE                     0
  22 #define BO_USE_SCANOUT                  (1ull << 0)
  23 #define BO_USE_CURSOR                   (1ull << 1)
  24 #define BO_USE_CURSOR_64X64             BO_USE_CURSOR
  25 #define BO_USE_RENDERING                (1ull << 2)
  26 #define BO_USE_LINEAR                   (1ull << 3)
  27 #define BO_USE_SW_READ_NEVER            (1ull << 4)
  28 #define BO_USE_SW_READ_RARELY           (1ull << 5)
  29 #define BO_USE_SW_READ_OFTEN            (1ull << 6)
  30 #define BO_USE_SW_WRITE_NEVER           (1ull << 7)
  31 #define BO_USE_SW_WRITE_RARELY          (1ull << 8)
  32 #define BO_USE_SW_WRITE_OFTEN           (1ull << 9)
  33 #define BO_USE_EXTERNAL_DISP            (1ull << 10)
  34 #define BO_USE_PROTECTED                (1ull << 11)
  35 #define BO_USE_HW_VIDEO_ENCODER         (1ull << 12)
  36 #define BO_USE_CAMERA_WRITE             (1ull << 13)
  37 #define BO_USE_CAMERA_READ              (1ull << 14)
  38 #define BO_USE_RENDERSCRIPT             (1ull << 16)
  39 #define BO_USE_TEXTURE                  (1ull << 17)
  40
  41 /* Map flags */
  42 #define BO_MAP_NONE 0
  43 #define BO_MAP_READ (1 << 0)
  44 #define BO_MAP_WRITE (1 << 1)
  45 #define BO_MAP_READ_WRITE (BO_MAP_READ | BO_MAP_WRITE)
  46
  47 /* This is our extension to <drm_fourcc.h>.  We need to make sure we don't step
  48  * on the namespace of already defined formats, which can be done by using invalid
  49  * fourcc codes.
  50  */
  51
  52 #define DRM_FORMAT_NONE                         fourcc_code('0', '0', '0', '0')
  53 #define DRM_FORMAT_YVU420_ANDROID               fourcc_code('9', '9', '9', '7')
  54 #define DRM_FORMAT_FLEX_IMPLEMENTATION_DEFINED  fourcc_code('9', '9', '9', '8')
  55 #define DRM_FORMAT_FLEX_YCbCr_420_888           fourcc_code('9', '9', '9', '9')
  56
  57 // clang-format on
  58 struct driver;
  59 struct bo;
  60 struct combination;
  61
  62 union bo_handle {
  63         void *ptr;
  64         int32_t s32;
  65         uint32_t u32;
  66         int64_t s64;
  67         uint64_t u64;
  68 };
  69
  70 struct drv_import_fd_data {
  71         int fds[DRV_MAX_PLANES];
  72         uint32_t strides[DRV_MAX_PLANES];
  73         uint32_t offsets[DRV_MAX_PLANES];
  74         uint64_t format_modifiers[DRV_MAX_PLANES];
  75         uint32_t width;
  76         uint32_t height;
  77         uint32_t format;
  78         uint64_t use_flags;
  79 };
  80
  81 struct map_info {
  82         void *addr;
  83         size_t length;
  84         uint32_t handle;
  85         uint32_t map_flags;
  86         int32_t refcount;
  87         void *priv;
  88 };
  89
  90 struct driver *drv_create(int fd);
  91
  92 void drv_destroy(struct driver *drv);
  93
  94 int drv_get_fd(struct driver *drv);
  95
  96 const char *drv_get_name(struct driver *drv);
  97
  98 struct combination *drv_get_combination(struct driver *drv, uint32_t format, uint64_t use_flags);
  99
 100 struct bo *drv_bo_new(struct driver *drv, uint32_t width, uint32_t height, uint32_t format,
 101                       uint64_t use_flags);
 102
 103 struct bo *drv_bo_create(struct driver *drv, uint32_t width, uint32_t height, uint32_t format,
 104                          uint64_t use_flags);
 105
 106 struct bo *drv_bo_create_with_modifiers(struct driver *drv, uint32_t width, uint32_t height,
 107                                         uint32_t format, const uint64_t *modifiers, uint32_t count);
 108
 109 void drv_bo_destroy(struct bo *bo);
 110
 111 struct bo *drv_bo_import(struct driver *drv, struct drv_import_fd_data *data);
 112
 113 void *drv_bo_map(struct bo *bo, uint32_t x, uint32_t y, uint32_t width, uint32_t height,
 114                  uint32_t map_flags, struct map_info **map_data, size_t plane);
 115
 116 int drv_bo_unmap(struct bo *bo, struct map_info *data);
 117
 118 int drv_bo_invalidate(struct bo *bo, struct map_info *data);
 119
 120 int drv_bo_flush(struct bo *bo, struct map_info *data);
 121
 122 uint32_t drv_bo_get_width(struct bo *bo);
 123
 124 uint32_t drv_bo_get_height(struct bo *bo);
 125
 126 uint32_t drv_bo_get_stride_or_tiling(struct bo *bo);
 127
 128 size_t drv_bo_get_num_planes(struct bo *bo);
 129
 130 union bo_handle drv_bo_get_plane_handle(struct bo *bo, size_t plane);
 131
 132 int drv_bo_get_plane_fd(struct bo *bo, size_t plane);
 133
 134 uint32_t drv_bo_get_plane_offset(struct bo *bo, size_t plane);
 135
 136 uint32_t drv_bo_get_plane_size(struct bo *bo, size_t plane);
 137
 138 uint32_t drv_bo_get_plane_stride(struct bo *bo, size_t plane);
 139
 140 uint64_t drv_bo_get_plane_format_modifier(struct bo *bo, size_t plane);
 141
 142 uint32_t drv_bo_get_format(struct bo *bo);
 143
 144 uint32_t drv_bo_get_stride_in_pixels(struct bo *bo);
 145
 146 uint32_t drv_resolve_format(struct driver *drv, uint32_t format, uint64_t use_flags);
 147
 148 size_t drv_num_planes_from_format(uint32_t format);
 149
 150 uint32_t drv_num_buffers_per_bo(struct bo *bo);
 151
 152 #ifdef __cplusplus
 153 }
 154 #endif
 155
 156 #endif