1 /*
2  * Copyright (c) 2011-2018, The Linux Foundation. All rights reserved.
3  * Not a Contribution
4  *
5  * Copyright (C) 2008 The Android Open Source Project
6  *
7  * Licensed under the Apache License, Version 2.0 (the "License");
8  * you may not use this file except in compliance with the License.
9  * You may obtain a copy of the License at
10  *
11  *      http://www.apache.org/licenses/LICENSE-2.0
12  *
13  * Unless required by applicable law or agreed to in writing, software
14  * distributed under the License is distributed on an "AS IS" BASIS,
15  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
16  * See the License for the specific language governing permissions and
17  * limitations under the License.
18  */
19 
20 #ifndef __GRALLOC_PRIV_H__
21 #define __GRALLOC_PRIV_H__
22 
23 #include <errno.h>
24 #include <unistd.h>
25 #include "gr_priv_handle.h"
26 
27 #define GRALLOC_PROP_PREFIX  "vendor.gralloc."
28 #define GRALLOC_PROP(prop_name) GRALLOC_PROP_PREFIX prop_name
29 
30 #define DISABLE_UBWC_PROP                    GRALLOC_PROP("disable_ubwc")
31 #define DISABLE_AHARDWAREBUFFER_PROP         GRALLOC_PROP("disable_ahardware_buffer")
32 #define ENABLE_FB_UBWC_PROP                  GRALLOC_PROP("enable_fb_ubwc")
33 #define MAP_FB_MEMORY_PROP                   GRALLOC_PROP("map_fb_memory")
34 
35 #define ROUND_UP_PAGESIZE(x) roundUpToPageSize(x)
roundUpToPageSize(int x)36 inline int roundUpToPageSize(int x) {
37   return (x + (getpagesize() - 1)) & ~(getpagesize() - 1);
38 }
39 
40 /* Gralloc usage bits indicating the type of allocation that should be used */
41 /* Refer to BufferUsage in hardware/interfaces/graphics/common/<ver>/types.hal */
42 
43 /* The bits below are in officially defined vendor space
44  * i.e bits 28-31 and 48-63*/
45 /* Non linear, Universal Bandwidth Compression */
46 #define GRALLOC_USAGE_PRIVATE_ALLOC_UBWC (UINT32_C(1) << 28)
47 
48 /* Set this for allocating uncached memory (using O_DSYNC),
49  * cannot be used with noncontiguous heaps */
50 #define GRALLOC_USAGE_PRIVATE_UNCACHED (UINT32_C(1) << 29)
51 
52 /* This flag is used to indicate P010 format */
53 #define GRALLOC_USAGE_PRIVATE_10BIT (UINT32_C(1) << 30)
54 
55 /* This flag is used for SECURE display usecase */
56 #define GRALLOC_USAGE_PRIVATE_SECURE_DISPLAY (UINT32_C(1) << 31)
57 /* unused legacy flags */
58 #define GRALLOC_USAGE_PRIVATE_MM_HEAP 0
59 #define GRALLOC_USAGE_PRIVATE_IOMMU_HEAP 0
60 
61 /* TODO(user): move these to use sanctioned vendor bits
62  * once end to end 64-bit support is available */
63 /* This flag is set for WFD usecase */
64 #define GRALLOC_USAGE_PRIVATE_WFD (UINT32_C(1) << 21)
65 
66 /* This flag is used to indicate 10-bit tight pack format (e.g. TP10) */
67 #define GRALLOC_USAGE_PRIVATE_10BIT_TP (UINT32_C(1) << 27)
68 
69 /* Legacy gralloc1 definitions */
70 /* Some clients may still be using the old flags */
71 #define GRALLOC1_PRODUCER_USAGE_PRIVATE_ADSP_HEAP GRALLOC_USAGE_PRIVATE_ADSP_HEAP
72 #define GRALLOC1_PRODUCER_USAGE_PRIVATE_ALLOC_UBWC GRALLOC_USAGE_PRIVATE_ALLOC_UBWC
73 #define GRALLOC1_PRODUCER_USAGE_PRIVATE_UNCACHED GRALLOC_USAGE_PRIVATE_UNCACHED
74 #define GRALLOC1_CONSUMER_USAGE_PRIVATE_SECURE_DISPLAY GRALLOC_USAGE_PRIVATE_SECURE_DISPLAY
75 #define GRALLOC1_PRODUCER_USAGE_PRIVATE_MM_HEAP GRALLOC_USAGE_PRIVATE_MM_HEAP
76 #define GRALLOC1_PRODUCER_USAGE_PRIVATE_10BIT GRALLOC_USAGE_PRIVATE_10BIT
77 #define GRALLOC1_PRODUCER_USAGE_PRIVATE_10BIT_TP GRALLOC_USAGE_PRIVATE_10BIT_TP
78 #define GRALLOC1_CONSUMER_USAGE_PRIVATE_10BIT_TP GRALLOC_USAGE_PRIVATE_10BIT_TP
79 
80 // for PERFORM API :
81 #define GRALLOC_MODULE_PERFORM_CREATE_HANDLE_FROM_BUFFER 1
82 #define GRALLOC_MODULE_PERFORM_GET_STRIDE 2
83 #define GRALLOC_MODULE_PERFORM_GET_CUSTOM_STRIDE_FROM_HANDLE 3
84 #define GRALLOC_MODULE_PERFORM_GET_CUSTOM_STRIDE_AND_HEIGHT_FROM_HANDLE 4
85 #define GRALLOC_MODULE_PERFORM_GET_ATTRIBUTES 5
86 #define GRALLOC_MODULE_PERFORM_GET_COLOR_SPACE_FROM_HANDLE 6
87 #define GRALLOC_MODULE_PERFORM_GET_YUV_PLANE_INFO 7
88 #define GRALLOC_MODULE_PERFORM_GET_MAP_SECURE_BUFFER_INFO 8
89 #define GRALLOC_MODULE_PERFORM_GET_UBWC_FLAG 9
90 #define GRALLOC_MODULE_PERFORM_GET_RGB_DATA_ADDRESS 10
91 #define GRALLOC_MODULE_PERFORM_GET_IGC 11
92 #define GRALLOC_MODULE_PERFORM_SET_IGC 12
93 #define GRALLOC_MODULE_PERFORM_SET_SINGLE_BUFFER_MODE 13
94 #define GRALLOC1_MODULE_PERFORM_GET_BUFFER_SIZE_AND_DIMENSIONS 14
95 #define GRALLOC1_MODULE_PERFORM_GET_INTERLACE_FLAG 15
96 #define GRALLOC_MODULE_PERFORM_GET_GRAPHICS_METADATA 16
97 
98 // OEM specific HAL formats
99 #define HAL_PIXEL_FORMAT_RGBA_5551 6
100 #define HAL_PIXEL_FORMAT_RGBA_4444 7
101 #define HAL_PIXEL_FORMAT_NV12_ENCODEABLE 0x102
102 #define HAL_PIXEL_FORMAT_NV21_ENCODEABLE 0x7FA30C00
103 #define HAL_PIXEL_FORMAT_YCbCr_420_SP_VENUS 0x7FA30C04
104 #define HAL_PIXEL_FORMAT_YCbCr_420_SP_TILED 0x7FA30C03
105 #define HAL_PIXEL_FORMAT_YCbCr_420_SP 0x109
106 #define HAL_PIXEL_FORMAT_YCrCb_420_SP_ADRENO 0x7FA30C01
107 #define HAL_PIXEL_FORMAT_YCrCb_422_SP 0x10B
108 #define HAL_PIXEL_FORMAT_R_8 0x10D
109 #define HAL_PIXEL_FORMAT_RG_88 0x10E
110 #define HAL_PIXEL_FORMAT_YCbCr_444_SP 0x10F
111 #define HAL_PIXEL_FORMAT_YCrCb_444_SP 0x110
112 #define HAL_PIXEL_FORMAT_YCrCb_422_I 0x111
113 #define HAL_PIXEL_FORMAT_BGRX_8888 0x112
114 #define HAL_PIXEL_FORMAT_NV21_ZSL 0x113
115 #define HAL_PIXEL_FORMAT_YCrCb_420_SP_VENUS 0x114
116 #define HAL_PIXEL_FORMAT_BGR_565 0x115
117 #define HAL_PIXEL_FORMAT_RAW8 0x123
118 
119 // 10 bit
120 #define HAL_PIXEL_FORMAT_ARGB_2101010 0x117
121 #define HAL_PIXEL_FORMAT_RGBX_1010102 0x118
122 #define HAL_PIXEL_FORMAT_XRGB_2101010 0x119
123 #define HAL_PIXEL_FORMAT_BGRA_1010102 0x11A
124 #define HAL_PIXEL_FORMAT_ABGR_2101010 0x11B
125 #define HAL_PIXEL_FORMAT_BGRX_1010102 0x11C
126 #define HAL_PIXEL_FORMAT_XBGR_2101010 0x11D
127 #define HAL_PIXEL_FORMAT_YCbCr_420_P010 0x11F
128 #define HAL_PIXEL_FORMAT_YCbCr_420_P010_UBWC 0x124
129 #define HAL_PIXEL_FORMAT_YCbCr_420_P010_VENUS 0x7FA30C0A
130 
131 #define HAL_PIXEL_FORMAT_CbYCrY_422_I 0x120
132 #define HAL_PIXEL_FORMAT_BGR_888 0x121
133 
134 #define HAL_PIXEL_FORMAT_INTERLACE 0x180
135 
136 // v4l2_fourcc('Y', 'U', 'Y', 'L'). 24 bpp YUYV 4:2:2 10 bit per component
137 #define HAL_PIXEL_FORMAT_YCbCr_422_I_10BIT 0x4C595559
138 
139 // v4l2_fourcc('Y', 'B', 'W', 'C'). 10 bit per component. This compressed
140 // format reduces the memory access bandwidth
141 #define HAL_PIXEL_FORMAT_YCbCr_422_I_10BIT_COMPRESSED 0x43574259
142 
143 // UBWC aligned Venus format
144 #define HAL_PIXEL_FORMAT_YCbCr_420_SP_VENUS_UBWC 0x7FA30C06
145 #define HAL_PIXEL_FORMAT_YCbCr_420_TP10_UBWC 0x7FA30C09
146 
147 // Khronos ASTC formats
148 #define HAL_PIXEL_FORMAT_COMPRESSED_RGBA_ASTC_4x4_KHR 0x93B0
149 #define HAL_PIXEL_FORMAT_COMPRESSED_RGBA_ASTC_5x4_KHR 0x93B1
150 #define HAL_PIXEL_FORMAT_COMPRESSED_RGBA_ASTC_5x5_KHR 0x93B2
151 #define HAL_PIXEL_FORMAT_COMPRESSED_RGBA_ASTC_6x5_KHR 0x93B3
152 #define HAL_PIXEL_FORMAT_COMPRESSED_RGBA_ASTC_6x6_KHR 0x93B4
153 #define HAL_PIXEL_FORMAT_COMPRESSED_RGBA_ASTC_8x5_KHR 0x93B5
154 #define HAL_PIXEL_FORMAT_COMPRESSED_RGBA_ASTC_8x6_KHR 0x93B6
155 #define HAL_PIXEL_FORMAT_COMPRESSED_RGBA_ASTC_8x8_KHR 0x93B7
156 #define HAL_PIXEL_FORMAT_COMPRESSED_RGBA_ASTC_10x5_KHR 0x93B8
157 #define HAL_PIXEL_FORMAT_COMPRESSED_RGBA_ASTC_10x6_KHR 0x93B9
158 #define HAL_PIXEL_FORMAT_COMPRESSED_RGBA_ASTC_10x8_KHR 0x93BA
159 #define HAL_PIXEL_FORMAT_COMPRESSED_RGBA_ASTC_10x10_KHR 0x93BB
160 #define HAL_PIXEL_FORMAT_COMPRESSED_RGBA_ASTC_12x10_KHR 0x93BC
161 #define HAL_PIXEL_FORMAT_COMPRESSED_RGBA_ASTC_12x12_KHR 0x93BD
162 #define HAL_PIXEL_FORMAT_COMPRESSED_SRGB8_ALPHA8_ASTC_4x4_KHR 0x93D0
163 #define HAL_PIXEL_FORMAT_COMPRESSED_SRGB8_ALPHA8_ASTC_5x4_KHR 0x93D1
164 #define HAL_PIXEL_FORMAT_COMPRESSED_SRGB8_ALPHA8_ASTC_5x5_KHR 0x93D2
165 #define HAL_PIXEL_FORMAT_COMPRESSED_SRGB8_ALPHA8_ASTC_6x5_KHR 0x93D3
166 #define HAL_PIXEL_FORMAT_COMPRESSED_SRGB8_ALPHA8_ASTC_6x6_KHR 0x93D4
167 #define HAL_PIXEL_FORMAT_COMPRESSED_SRGB8_ALPHA8_ASTC_8x5_KHR 0x93D5
168 #define HAL_PIXEL_FORMAT_COMPRESSED_SRGB8_ALPHA8_ASTC_8x6_KHR 0x93D6
169 #define HAL_PIXEL_FORMAT_COMPRESSED_SRGB8_ALPHA8_ASTC_8x8_KHR 0x93D7
170 #define HAL_PIXEL_FORMAT_COMPRESSED_SRGB8_ALPHA8_ASTC_10x5_KHR 0x93D8
171 #define HAL_PIXEL_FORMAT_COMPRESSED_SRGB8_ALPHA8_ASTC_10x6_KHR 0x93D9
172 #define HAL_PIXEL_FORMAT_COMPRESSED_SRGB8_ALPHA8_ASTC_10x8_KHR 0x93DA
173 #define HAL_PIXEL_FORMAT_COMPRESSED_SRGB8_ALPHA8_ASTC_10x10_KHR 0x93DB
174 #define HAL_PIXEL_FORMAT_COMPRESSED_SRGB8_ALPHA8_ASTC_12x10_KHR 0x93DC
175 #define HAL_PIXEL_FORMAT_COMPRESSED_SRGB8_ALPHA8_ASTC_12x12_KHR 0x93DD
176 
177 /* possible values for inverse gamma correction */
178 #define HAL_IGC_NOT_SPECIFIED 0
179 #define HAL_IGC_s_RGB 1
180 
181 /* Color Space: Values maps to ColorSpace_t in qdMetadata.h */
182 #define HAL_CSC_ITU_R_601 0
183 #define HAL_CSC_ITU_R_601_FR 1
184 #define HAL_CSC_ITU_R_709 2
185 #define HAL_CSC_ITU_R_2020 3
186 #define HAL_CSC_ITU_R_2020_FR 4
187 
188 /* possible formats for 3D content*/
189 enum {
190   HAL_NO_3D = 0x0,
191   HAL_3D_SIDE_BY_SIDE_L_R = 0x1,
192   HAL_3D_SIDE_BY_SIDE_R_L = 0x2,
193   HAL_3D_TOP_BOTTOM = 0x4,
194   HAL_3D_IN_SIDE_BY_SIDE_L_R = 0x10000,  // unused legacy format
195 };
196 
197 enum { BUFFER_TYPE_UI = 0, BUFFER_TYPE_VIDEO };
198 
199 #endif  // __GRALLOC_PRIV_H__
200