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 <stdbool.h>
  16 #include <stdint.h>
  17
  18 #define DRV_MAX_PLANES 4
  19
  20 // clang-format off
  21 /* Use flags */
  22 #define BO_USE_NONE                     0
  23 #define BO_USE_SCANOUT                  (1ull << 0)
  24 #define BO_USE_CURSOR                   (1ull << 1)
  25 #define BO_USE_CURSOR_64X64             BO_USE_CURSOR
  26 #define BO_USE_RENDERING                (1ull << 2)
  27 /* Skip for GBM_BO_USE_WRITE */
  28 #define BO_USE_LINEAR                   (1ull << 4)
  29 #define BO_USE_TEXTURE                  (1ull << 5)
  30 #define BO_USE_CAMERA_WRITE             (1ull << 6)
  31 #define BO_USE_CAMERA_READ              (1ull << 7)
  32 #define BO_USE_PROTECTED                (1ull << 8)
  33 #define BO_USE_SW_READ_OFTEN            (1ull << 9)
  34 #define BO_USE_SW_READ_RARELY           (1ull << 10)
  35 #define BO_USE_SW_WRITE_OFTEN           (1ull << 11)
  36 #define BO_USE_SW_WRITE_RARELY          (1ull << 12)
  37 #define BO_USE_HW_VIDEO_DECODER         (1ull << 13)
  38 #define BO_USE_HW_VIDEO_ENCODER         (1ull << 14)
  39 #define BO_USE_TEST_ALLOC               (1ull << 15)
  40 #define BO_USE_RENDERSCRIPT             (1ull << 16)
  41 /* #define BO_USE_TEXTURE                       (1ull << 17) */
  42 /* #define BO_USE_HW_VIDEO_DECODER              (1ull << 18) */
  43 #define BO_USE_FRAMEBUFFER              (1ull << 19)
  44
  45 /* Quirks for allocating a buffer. */
  46 #define BO_QUIRK_NONE                   0
  47 #define BO_QUIRK_DUMB32BPP              (1ull << 0)
  48
  49 /* Map flags */
  50 #define BO_MAP_NONE 0
  51 #define BO_MAP_READ (1 << 0)
  52 #define BO_MAP_WRITE (1 << 1)
  53 #define BO_MAP_READ_WRITE (BO_MAP_READ | BO_MAP_WRITE)
  54
  55 /* This is our extension to <drm_fourcc.h>.  We need to make sure we don't step
  56  * on the namespace of already defined formats, which can be done by using invalid
  57  * fourcc codes.
  58  */
  59 #define DRM_FORMAT_NONE                         fourcc_code('0', '0', '0', '0')
  60 #define DRM_FORMAT_YVU420_ANDROID               fourcc_code('9', '9', '9', '7')
  61 #define DRM_FORMAT_FLEX_IMPLEMENTATION_DEFINED  fourcc_code('9', '9', '9', '8')
  62 #define DRM_FORMAT_FLEX_YCbCr_420_888           fourcc_code('9', '9', '9', '9')
  63
  64 /* This is a 10-bit bayer format for private reprocessing on MediaTek ISP. It's
  65  * a private RAW format that other DRM drivers will never support and thus
  66  * making it not upstreamable (i.e., defined in official DRM headers). */
  67 #define DRM_FORMAT_MTISP_SXYZW10                fourcc_code('M', 'B', '1', '0')
  68
  69 // TODO(crbug.com/958181): remove this definition once drm_fourcc.h contains it.
  70 #ifndef DRM_FORMAT_P010
  71 #define DRM_FORMAT_P010 fourcc_code('P', '0', '1', '0')
  72 #endif
  73
  74 // clang-format on
  75 struct driver;
  76 struct bo;
  77 struct combination;
  78
  79 union bo_handle {
  80         void *ptr;
  81         int32_t s32;
  82         uint32_t u32;
  83         int64_t s64;
  84         uint64_t u64;
  85 };
  86
  87 struct drv_import_fd_data {
  88         int fds[DRV_MAX_PLANES];
  89         uint32_t strides[DRV_MAX_PLANES];
  90         uint32_t offsets[DRV_MAX_PLANES];
  91         uint64_t format_modifiers[DRV_MAX_PLANES];
  92         uint32_t width;
  93         uint32_t height;
  94         uint32_t format;
  95         uint32_t tiling;
  96         uint64_t use_flags;
  97 };
  98
  99 struct vma {
 100         void *addr;
 101         size_t length;
 102         uint32_t handle;
 103         uint32_t map_flags;
 104         int32_t refcount;
 105         uint32_t map_strides[DRV_MAX_PLANES];
 106         void *priv;
 107 };
 108
 109 struct rectangle {
 110         uint32_t x;
 111         uint32_t y;
 112         uint32_t width;
 113         uint32_t height;
 114 };
 115
 116 struct mapping {
 117         struct vma *vma;
 118         struct rectangle rect;
 119         uint32_t refcount;
 120 };
 121
 122 struct driver *drv_create(int fd, bool try_generic);
 123
 124 void drv_destroy(struct driver *drv);
 125
 126 int drv_get_fd(struct driver *drv);
 127
 128 const char *drv_get_name(struct driver *drv);
 129
 130 struct combination *drv_get_combination(struct driver *drv, uint32_t format, uint64_t use_flags);
 131
 132 struct bo *drv_bo_new(struct driver *drv, uint32_t width, uint32_t height, uint32_t format,
 133                       uint64_t use_flags, bool is_test_buffer);
 134
 135 struct bo *drv_bo_create(struct driver *drv, uint32_t width, uint32_t height, uint32_t format,
 136                          uint64_t use_flags);
 137
 138 struct bo *drv_bo_create_with_modifiers(struct driver *drv, uint32_t width, uint32_t height,
 139                                         uint32_t format, const uint64_t *modifiers, uint32_t count);
 140
 141 void drv_bo_destroy(struct bo *bo);
 142
 143 struct bo *drv_bo_import(struct driver *drv, struct drv_import_fd_data *data);
 144
 145 void *drv_bo_map(struct bo *bo, const struct rectangle *rect, uint32_t map_flags,
 146                  struct mapping **map_data, size_t plane);
 147
 148 int drv_bo_unmap(struct bo *bo, struct mapping *mapping);
 149
 150 int drv_bo_invalidate(struct bo *bo, struct mapping *mapping);
 151
 152 int drv_bo_flush(struct bo *bo, struct mapping *mapping);
 153
 154 int drv_bo_flush_or_unmap(struct bo *bo, struct mapping *mapping);
 155
 156 uint32_t drv_bo_get_width(struct bo *bo);
 157
 158 uint32_t drv_bo_get_height(struct bo *bo);
 159
 160 size_t drv_bo_get_num_planes(struct bo *bo);
 161
 162 union bo_handle drv_bo_get_plane_handle(struct bo *bo, size_t plane);
 163
 164 int drv_bo_get_plane_fd(struct bo *bo, size_t plane);
 165
 166 uint32_t drv_bo_get_plane_offset(struct bo *bo, size_t plane);
 167
 168 uint32_t drv_bo_get_plane_size(struct bo *bo, size_t plane);
 169
 170 uint32_t drv_bo_get_plane_stride(struct bo *bo, size_t plane);
 171
 172 uint64_t drv_bo_get_plane_format_modifier(struct bo *bo, size_t plane);
 173
 174 uint32_t drv_bo_get_format(struct bo *bo);
 175
 176 uint32_t drv_bytes_per_pixel_from_format(uint32_t format, size_t plane);
 177
 178 uint32_t drv_stride_from_format(uint32_t format, uint32_t width, size_t plane);
 179
 180 uint32_t drv_resolve_format(struct driver *drv, uint32_t format, uint64_t use_flags);
 181
 182 size_t drv_num_planes_from_format(uint32_t format);
 183
 184 size_t drv_num_planes_from_modifier(struct driver *drv, uint32_t format, uint64_t modifier);
 185
 186 uint32_t drv_num_buffers_per_bo(struct bo *bo);
 187
 188 int drv_resource_info(struct bo *bo, uint32_t strides[DRV_MAX_PLANES],
 189                       uint32_t offsets[DRV_MAX_PLANES]);
 190
 191 #define drv_log(format, ...)                                                                       \
 192         do {                                                                                       \
 193                 drv_log_prefix("minigbm", __FILE__, __LINE__, format, ##__VA_ARGS__);              \
 194         } while (0)
 195
 196 __attribute__((format(printf, 4, 5))) void drv_log_prefix(const char *prefix, const char *file,
 197                                                           int line, const char *format, ...);
 198
 199 #ifdef __cplusplus
 200 }
 201 #endif
 202
 203 #endif