/* * Copyright 2016 The Chromium OS Authors. All rights reserved. * Use of this source code is governed by a BSD-style license that can be * found in the LICENSE file. */ #ifndef DRV_H_ #define DRV_H_ #ifdef __cplusplus extern "C" { #endif #include #include #include #include #define DRV_MAX_PLANES 4 // clang-format off /* Use flags */ #define BO_USE_NONE 0 #define BO_USE_SCANOUT (1ull << 0) #define BO_USE_CURSOR (1ull << 1) #define BO_USE_CURSOR_64X64 BO_USE_CURSOR #define BO_USE_RENDERING (1ull << 2) /* Skip for GBM_BO_USE_WRITE */ #define BO_USE_LINEAR (1ull << 4) #define BO_USE_TEXTURE (1ull << 5) #define BO_USE_CAMERA_WRITE (1ull << 6) #define BO_USE_CAMERA_READ (1ull << 7) #define BO_USE_PROTECTED (1ull << 8) #define BO_USE_SW_READ_OFTEN (1ull << 9) #define BO_USE_SW_READ_RARELY (1ull << 10) #define BO_USE_SW_WRITE_OFTEN (1ull << 11) #define BO_USE_SW_WRITE_RARELY (1ull << 12) #define BO_USE_HW_VIDEO_DECODER (1ull << 13) #define BO_USE_HW_VIDEO_ENCODER (1ull << 14) #define BO_USE_TEST_ALLOC (1ull << 15) #define BO_USE_FRONT_RENDERING (1ull << 16) #define BO_USE_RENDERSCRIPT (1ull << 17) #define BO_USE_GPU_DATA_BUFFER (1ull << 18) #define BO_USE_SENSOR_DIRECT_DATA (1ull << 19) #define BO_USE_ARC_SCREEN_CAP_PROBED (1ull << 63) /* Quirks for allocating a buffer. */ #define BO_QUIRK_NONE 0 #define BO_QUIRK_DUMB32BPP (1ull << 0) /* Map flags */ #define BO_MAP_NONE 0 #define BO_MAP_READ (1 << 0) #define BO_MAP_WRITE (1 << 1) #define BO_MAP_READ_WRITE (BO_MAP_READ | BO_MAP_WRITE) /* This is our extension to . We need to make sure we don't step * on the namespace of already defined formats, which can be done by using invalid * fourcc codes. */ #define DRM_FORMAT_NONE fourcc_code('0', '0', '0', '0') #define DRM_FORMAT_YVU420_ANDROID fourcc_code('9', '9', '9', '7') #define DRM_FORMAT_FLEX_IMPLEMENTATION_DEFINED fourcc_code('9', '9', '9', '8') #define DRM_FORMAT_FLEX_YCbCr_420_888 fourcc_code('9', '9', '9', '9') #ifndef DRM_FORMAT_DEPTH16 #define DRM_FORMAT_DEPTH16 fourcc_code('D', '1', '6', ' ') #define DRM_FORMAT_DEPTH24 fourcc_code('D', '2', '4', 'X') #define DRM_FORMAT_DEPTH24_STENCIL8 fourcc_code('D', '2', '4', 'S') #define DRM_FORMAT_DEPTH32 fourcc_code('D', '3', '2', 'F') #define DRM_FORMAT_DEPTH32_STENCIL8 fourcc_code('D', 'F', 'S', '8') #endif /* This is a 10-bit bayer format for private reprocessing on MediaTek ISP. It's * a private RAW format that other DRM drivers will never support and thus * making it not upstreamable (i.e., defined in official DRM headers). */ #define DRM_FORMAT_MTISP_SXYZW10 fourcc_code('M', 'B', '1', '0') // TODO(crbug.com/958181): remove this definition once drm_fourcc.h contains it. #ifndef DRM_FORMAT_P010 #define DRM_FORMAT_P010 fourcc_code('P', '0', '1', '0') #endif //TODO: remove this defination once drm_fourcc.h contains it. #ifndef I915_FORMAT_MOD_Y_TILED_GEN12_RC_CCS #define I915_FORMAT_MOD_Y_TILED_GEN12_RC_CCS fourcc_mod_code(INTEL, 6) #endif //TODO: remove this defination once drm_fourcc.h contains it. #ifndef I915_FORMAT_MOD_4_TILED #define I915_FORMAT_MOD_4_TILED fourcc_mod_code(INTEL, 9) #endif #ifndef I915_FORMAT_MOD_4_TILED_MTL_RC_CCS //TODO: remove this defination once drm_fourcc.h contains it. /* * Intel color control surfaces (CCS) for display ver 14 render compression. * * The main surface is tile4 and at plane index 0, the CCS is linear and * at index 1. A 64B CCS cache line corresponds to an area of 4x1 tiles in * main surface. In other words, 4 bits in CCS map to a main surface cache * line pair. The main surface pitch is required to be a multiple of four * tile4 widths. */ #define I915_FORMAT_MOD_4_TILED_MTL_RC_CCS fourcc_mod_code(INTEL, 13) #endif // clang-format on struct driver; struct bo; struct combination; union bo_handle { void *ptr; int32_t s32; uint32_t u32; int64_t s64; uint64_t u64; }; struct drv_import_fd_data { int fds[DRV_MAX_PLANES]; uint32_t strides[DRV_MAX_PLANES]; uint32_t offsets[DRV_MAX_PLANES]; uint64_t format_modifier; uint32_t width; uint32_t height; uint32_t format; uint32_t tiling; uint64_t use_flags; }; struct vma { void *addr; size_t length; uint32_t handle; uint32_t map_flags; int32_t refcount; uint32_t map_strides[DRV_MAX_PLANES]; void *priv; }; struct rectangle { uint32_t x; uint32_t y; uint32_t width; uint32_t height; }; struct mapping { struct vma *vma; struct rectangle rect; uint32_t refcount; }; void drv_preload(bool load); struct driver *drv_create(int fd); void drv_destroy(struct driver *drv); int drv_get_fd(struct driver *drv); const char *drv_get_name(struct driver *drv); struct combination *drv_get_combination(struct driver *drv, uint32_t format, uint64_t use_flags); struct bo *drv_bo_new(struct driver *drv, uint32_t width, uint32_t height, uint32_t format, uint64_t use_flags, bool is_test_buffer); struct bo *drv_bo_create(struct driver *drv, uint32_t width, uint32_t height, uint32_t format, uint64_t use_flags); struct bo *drv_bo_create_with_modifiers(struct driver *drv, uint32_t width, uint32_t height, uint32_t format, const uint64_t *modifiers, uint32_t count); void drv_bo_destroy(struct bo *bo); struct bo *drv_bo_import(struct driver *drv, struct drv_import_fd_data *data); void *drv_bo_map(struct bo *bo, const struct rectangle *rect, uint32_t map_flags, struct mapping **map_data, size_t plane); int drv_bo_unmap(struct bo *bo, struct mapping *mapping); bool drv_bo_cached(struct bo *bo); int drv_bo_invalidate(struct bo *bo, struct mapping *mapping); int drv_bo_flush(struct bo *bo, struct mapping *mapping); int drv_bo_flush_or_unmap(struct bo *bo, struct mapping *mapping); uint32_t drv_bo_get_width(struct bo *bo); uint32_t drv_bo_get_height(struct bo *bo); size_t drv_bo_get_num_planes(struct bo *bo); union bo_handle drv_bo_get_plane_handle(struct bo *bo, size_t plane); int drv_bo_get_plane_fd(struct bo *bo, size_t plane); uint32_t drv_bo_get_plane_offset(struct bo *bo, size_t plane); uint32_t drv_bo_get_plane_size(struct bo *bo, size_t plane); uint32_t drv_bo_get_plane_stride(struct bo *bo, size_t plane); uint64_t drv_bo_get_format_modifier(struct bo *bo); uint32_t drv_bo_get_format(struct bo *bo); uint32_t drv_bo_get_tiling(struct bo *bo); uint64_t drv_bo_get_use_flags(struct bo *bo); size_t drv_bo_get_total_size(struct bo *bo); void drv_bo_log_info(const struct bo *bo, const char *prefix); uint32_t drv_get_standard_fourcc(uint32_t fourcc_internal); uint32_t drv_bytes_per_pixel_from_format(uint32_t format, size_t plane); uint32_t drv_stride_from_format(uint32_t format, uint32_t width, size_t plane); void drv_resolve_format_and_use_flags(struct driver *drv, uint32_t format, uint64_t use_flags, uint32_t *out_format, uint64_t *out_use_flags); uint64_t drv_resolve_use_flags(struct driver *drv, uint32_t format, uint64_t use_flags); size_t drv_num_planes_from_format(uint32_t format); size_t drv_num_planes_from_modifier(struct driver *drv, uint32_t format, uint64_t modifier); int drv_resource_info(struct bo *bo, uint32_t strides[DRV_MAX_PLANES], uint32_t offsets[DRV_MAX_PLANES], uint64_t *format_modifier); uint32_t drv_get_max_texture_2d_size(struct driver *drv); enum drv_log_level { DRV_LOGV, DRV_LOGD, DRV_LOGI, DRV_LOGE, }; #define _drv_log(level, format, ...) \ do { \ drv_log_prefix(level, "minigbm", __func__, __LINE__, format, ##__VA_ARGS__); \ } while (0) #define drv_loge(format, ...) _drv_log(DRV_LOGE, format, ##__VA_ARGS__) #ifdef NDEBUG #define drv_logv(format, ...) #else #define drv_logv(format, ...) _drv_log(DRV_LOGV, format, ##__VA_ARGS__) #endif #define drv_logd(format, ...) _drv_log(DRV_LOGD, format, ##__VA_ARGS__) #define drv_logi(format, ...) _drv_log(DRV_LOGI, format, ##__VA_ARGS__) __attribute__((format(printf, 5, 6))) void drv_log_prefix(enum drv_log_level level, const char *prefix, const char *file, int line, const char *format, ...); #ifdef __cplusplus } #endif #endif