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 <unistd.h>
24 #include "gr_priv_handle.h"
25 
26 #define GRALLOC_PROP_PREFIX  "vendor.gralloc."
27 #define GRALLOC_PROP(prop_name) GRALLOC_PROP_PREFIX prop_name
28 
29 #define DISABLE_UBWC_PROP                    GRALLOC_PROP("disable_ubwc")
30 #define ENABLE_FB_UBWC_PROP                  GRALLOC_PROP("enable_fb_ubwc")
31 #define MAP_FB_MEMORY_PROP                   GRALLOC_PROP("map_fb_memory")
32 
33 #define ROUND_UP_PAGESIZE(x) roundUpToPageSize(x)
roundUpToPageSize(int x)34 inline int roundUpToPageSize(int x) {
35     return (x + (getpagesize()-1)) & ~(getpagesize()-1);
36 }
37 
38 /* Gralloc usage bits indicating the type of allocation that should be used */
39 /* Refer gralloc1_producer_usage_t & gralloc1_consumer_usage-t in gralloc1.h */
40 
41 /* Producer flags */
42 /* Non linear, Universal Bandwidth Compression */
43 #define GRALLOC1_PRODUCER_USAGE_PRIVATE_ALLOC_UBWC  GRALLOC1_PRODUCER_USAGE_PRIVATE_0
44 
45 /* Set this for allocating uncached memory (using O_DSYNC),
46  * cannot be used with noncontiguous heaps */
47 #define GRALLOC1_PRODUCER_USAGE_PRIVATE_UNCACHED    GRALLOC1_PRODUCER_USAGE_PRIVATE_1
48 
49 /* CAMERA heap is a carveout heap for camera, is not secured */
50 #define GRALLOC1_PRODUCER_USAGE_PRIVATE_CAMERA_HEAP GRALLOC1_PRODUCER_USAGE_PRIVATE_2
51 
52 /* ADSP heap is a carveout heap, is not secured */
53 #define GRALLOC1_PRODUCER_USAGE_PRIVATE_ADSP_HEAP   GRALLOC1_PRODUCER_USAGE_PRIVATE_3
54 
55 /* IOMMU heap comes from manually allocated pages, can be cached/uncached, is not secured */
56 #define GRALLOC1_PRODUCER_USAGE_PRIVATE_IOMMU_HEAP  GRALLOC1_PRODUCER_USAGE_PRIVATE_4
57 
58 /* MM heap is a carveout heap for video, can be secured */
59 #define GRALLOC1_PRODUCER_USAGE_PRIVATE_MM_HEAP     GRALLOC1_PRODUCER_USAGE_PRIVATE_5
60 
61 /* Use legacy ZSL definition until we know the correct usage on gralloc1 */
62 #define GRALLOC1_PRODUCER_USAGE_PRIVATE_CAMERA_ZSL  GRALLOC_USAGE_HW_CAMERA_ZSL
63 
64 
65 /* Consumer flags */
66 /* TODO(user): Fix when producer and consumer flags are actually separated */
67 /* This flag is set for WFD usecase */
68 #define GRALLOC1_CONSUMER_USAGE_PRIVATE_WFD            (UINT32_C(1) << 21)
69 
70 /* This flag is used for SECURE display usecase */
71 #define GRALLOC1_CONSUMER_USAGE_PRIVATE_SECURE_DISPLAY (UINT32_C(1) << 31)
72 
73 /* Buffer content should be displayed on a primary display only */
74 #define GRALLOC1_CONSUMER_USAGE_PRIVATE_INTERNAL_ONLY  0x04000000
75 
76 /* Buffer content should be displayed on an external display only */
77 #define GRALLOC1_CONSUMER_USAGE_PRIVATE_EXTERNAL_ONLY  0x08000000
78 
79 
80 /* Legacy gralloc0.x definitions */
81 /* Some clients may still be using the old flags */
82 #define GRALLOC_USAGE_PRIVATE_ALLOC_UBWC GRALLOC1_PRODUCER_USAGE_PRIVATE_ALLOC_UBWC
83 #define GRALLOC_USAGE_PRIVATE_UNCACHED GRALLOC1_PRODUCER_USAGE_PRIVATE_UNCACHED
84 #define GRALLOC_USAGE_PRIVATE_IOMMU_HEAP GRALLOC1_PRODUCER_USAGE_PRIVATE_IOMMU_HEAP
85 #define GRALLOC_USAGE_PRIVATE_WFD GRALLOC1_CONSUMER_USAGE_PRIVATE_WFD
86 #define GRALLOC_USAGE_PRIVATE_CAMERA_HEAP GRALLOC1_PRODUCER_USAGE_PRIVATE_CAMERA_HEAP
87 #define GRALLOC_USAGE_PRIVATE_SECURE_DISPLAY GRALLOC1_CONSUMER_USAGE_PRIVATE_SECURE_DISPLAY
88 #define GRALLOC_USAGE_PRIVATE_MM_HEAP 0x0
89 
90 
91 
92 // for PERFORM API :
93 #define GRALLOC_MODULE_PERFORM_CREATE_HANDLE_FROM_BUFFER 1
94 #define GRALLOC_MODULE_PERFORM_GET_STRIDE 2
95 #define GRALLOC_MODULE_PERFORM_GET_CUSTOM_STRIDE_FROM_HANDLE 3
96 #define GRALLOC_MODULE_PERFORM_GET_CUSTOM_STRIDE_AND_HEIGHT_FROM_HANDLE 4
97 #define GRALLOC_MODULE_PERFORM_GET_ATTRIBUTES 5
98 #define GRALLOC_MODULE_PERFORM_GET_COLOR_SPACE_FROM_HANDLE 6
99 #define GRALLOC_MODULE_PERFORM_GET_YUV_PLANE_INFO 7
100 #define GRALLOC_MODULE_PERFORM_GET_MAP_SECURE_BUFFER_INFO 8
101 #define GRALLOC_MODULE_PERFORM_GET_UBWC_FLAG 9
102 #define GRALLOC_MODULE_PERFORM_GET_RGB_DATA_ADDRESS 10
103 #define GRALLOC_MODULE_PERFORM_GET_IGC 11
104 #define GRALLOC_MODULE_PERFORM_SET_IGC 12
105 #define GRALLOC_MODULE_PERFORM_SET_SINGLE_BUFFER_MODE 13
106 #define GRALLOC1_MODULE_PERFORM_GET_BUFFER_SIZE_AND_DIMENSIONS 14
107 #define GRALLOC1_MODULE_PERFORM_ALLOCATE_BUFFER 15
108 #define GRALLOC1_MODULE_PERFORM_GET_INTERLACE_FLAG 16
109 
110 // OEM specific HAL formats
111 #define HAL_PIXEL_FORMAT_RGBA_5551 6
112 #define HAL_PIXEL_FORMAT_RGBA_4444 7
113 #define HAL_PIXEL_FORMAT_NV12_ENCODEABLE 0x102
114 #define HAL_PIXEL_FORMAT_YCbCr_420_SP_VENUS 0x7FA30C04
115 #define HAL_PIXEL_FORMAT_YCbCr_420_SP_TILED 0x7FA30C03
116 #define HAL_PIXEL_FORMAT_YCbCr_420_SP 0x109
117 #define HAL_PIXEL_FORMAT_YCrCb_420_SP_ADRENO 0x7FA30C01
118 #define HAL_PIXEL_FORMAT_YCrCb_422_SP 0x10B
119 #define HAL_PIXEL_FORMAT_R_8 0x10D
120 #define HAL_PIXEL_FORMAT_RG_88 0x10E
121 #define HAL_PIXEL_FORMAT_YCbCr_444_SP 0x10F
122 #define HAL_PIXEL_FORMAT_YCrCb_444_SP 0x110
123 #define HAL_PIXEL_FORMAT_YCrCb_422_I 0x111
124 #define HAL_PIXEL_FORMAT_BGRX_8888 0x112
125 #define HAL_PIXEL_FORMAT_NV21_ZSL 0x113
126 #define HAL_PIXEL_FORMAT_YCrCb_420_SP_VENUS 0x114
127 #define HAL_PIXEL_FORMAT_BGR_565 0x115
128 #define HAL_PIXEL_FORMAT_RAW8 0x123
129 
130 // 10 bit
131 #define HAL_PIXEL_FORMAT_ARGB_2101010 0x117
132 #define HAL_PIXEL_FORMAT_RGBX_1010102 0x118
133 #define HAL_PIXEL_FORMAT_XRGB_2101010 0x119
134 #define HAL_PIXEL_FORMAT_BGRA_1010102 0x11A
135 #define HAL_PIXEL_FORMAT_ABGR_2101010 0x11B
136 #define HAL_PIXEL_FORMAT_BGRX_1010102 0x11C
137 #define HAL_PIXEL_FORMAT_XBGR_2101010 0x11D
138 #define HAL_PIXEL_FORMAT_YCbCr_420_P010 0x11F
139 #define HAL_PIXEL_FORMAT_YCbCr_420_P010_UBWC 0x124
140 
141 #define HAL_PIXEL_FORMAT_CbYCrY_422_I            0x120
142 #define HAL_PIXEL_FORMAT_BGR_888                 0x121
143 
144 #define HAL_PIXEL_FORMAT_INTERLACE 0x180
145 
146 // v4l2_fourcc('Y', 'U', 'Y', 'L'). 24 bpp YUYV 4:2:2 10 bit per component
147 #define HAL_PIXEL_FORMAT_YCbCr_422_I_10BIT 0x4C595559
148 
149 // v4l2_fourcc('Y', 'B', 'W', 'C'). 10 bit per component. This compressed
150 // format reduces the memory access bandwidth
151 #define HAL_PIXEL_FORMAT_YCbCr_422_I_10BIT_COMPRESSED 0x43574259
152 
153 // UBWC aligned Venus format
154 #define HAL_PIXEL_FORMAT_YCbCr_420_SP_VENUS_UBWC 0x7FA30C06
155 #define HAL_PIXEL_FORMAT_YCbCr_420_TP10_UBWC     0x7FA30C09
156 
157 // Khronos ASTC formats
158 #define HAL_PIXEL_FORMAT_COMPRESSED_RGBA_ASTC_4x4_KHR 0x93B0
159 #define HAL_PIXEL_FORMAT_COMPRESSED_RGBA_ASTC_5x4_KHR 0x93B1
160 #define HAL_PIXEL_FORMAT_COMPRESSED_RGBA_ASTC_5x5_KHR 0x93B2
161 #define HAL_PIXEL_FORMAT_COMPRESSED_RGBA_ASTC_6x5_KHR 0x93B3
162 #define HAL_PIXEL_FORMAT_COMPRESSED_RGBA_ASTC_6x6_KHR 0x93B4
163 #define HAL_PIXEL_FORMAT_COMPRESSED_RGBA_ASTC_8x5_KHR 0x93B5
164 #define HAL_PIXEL_FORMAT_COMPRESSED_RGBA_ASTC_8x6_KHR 0x93B6
165 #define HAL_PIXEL_FORMAT_COMPRESSED_RGBA_ASTC_8x8_KHR 0x93B7
166 #define HAL_PIXEL_FORMAT_COMPRESSED_RGBA_ASTC_10x5_KHR 0x93B8
167 #define HAL_PIXEL_FORMAT_COMPRESSED_RGBA_ASTC_10x6_KHR 0x93B9
168 #define HAL_PIXEL_FORMAT_COMPRESSED_RGBA_ASTC_10x8_KHR 0x93BA
169 #define HAL_PIXEL_FORMAT_COMPRESSED_RGBA_ASTC_10x10_KHR 0x93BB
170 #define HAL_PIXEL_FORMAT_COMPRESSED_RGBA_ASTC_12x10_KHR 0x93BC
171 #define HAL_PIXEL_FORMAT_COMPRESSED_RGBA_ASTC_12x12_KHR 0x93BD
172 #define HAL_PIXEL_FORMAT_COMPRESSED_SRGB8_ALPHA8_ASTC_4x4_KHR 0x93D0
173 #define HAL_PIXEL_FORMAT_COMPRESSED_SRGB8_ALPHA8_ASTC_5x4_KHR 0x93D1
174 #define HAL_PIXEL_FORMAT_COMPRESSED_SRGB8_ALPHA8_ASTC_5x5_KHR 0x93D2
175 #define HAL_PIXEL_FORMAT_COMPRESSED_SRGB8_ALPHA8_ASTC_6x5_KHR 0x93D3
176 #define HAL_PIXEL_FORMAT_COMPRESSED_SRGB8_ALPHA8_ASTC_6x6_KHR 0x93D4
177 #define HAL_PIXEL_FORMAT_COMPRESSED_SRGB8_ALPHA8_ASTC_8x5_KHR 0x93D5
178 #define HAL_PIXEL_FORMAT_COMPRESSED_SRGB8_ALPHA8_ASTC_8x6_KHR 0x93D6
179 #define HAL_PIXEL_FORMAT_COMPRESSED_SRGB8_ALPHA8_ASTC_8x8_KHR 0x93D7
180 #define HAL_PIXEL_FORMAT_COMPRESSED_SRGB8_ALPHA8_ASTC_10x5_KHR 0x93D8
181 #define HAL_PIXEL_FORMAT_COMPRESSED_SRGB8_ALPHA8_ASTC_10x6_KHR 0x93D9
182 #define HAL_PIXEL_FORMAT_COMPRESSED_SRGB8_ALPHA8_ASTC_10x8_KHR 0x93DA
183 #define HAL_PIXEL_FORMAT_COMPRESSED_SRGB8_ALPHA8_ASTC_10x10_KHR 0x93DB
184 #define HAL_PIXEL_FORMAT_COMPRESSED_SRGB8_ALPHA8_ASTC_12x10_KHR 0x93DC
185 #define HAL_PIXEL_FORMAT_COMPRESSED_SRGB8_ALPHA8_ASTC_12x12_KHR 0x93DD
186 
187 /* possible values for inverse gamma correction */
188 #define HAL_IGC_NOT_SPECIFIED 0
189 #define HAL_IGC_s_RGB 1
190 
191 /* Color Space: Values maps to ColorSpace_t in qdMetadata.h */
192 #define HAL_CSC_ITU_R_601         0
193 #define HAL_CSC_ITU_R_601_FR      1
194 #define HAL_CSC_ITU_R_709         2
195 #define HAL_CSC_ITU_R_2020        3
196 #define HAL_CSC_ITU_R_2020_FR     4
197 
198 /* possible formats for 3D content*/
199 enum {
200   HAL_NO_3D = 0x0,
201   HAL_3D_SIDE_BY_SIDE_L_R = 0x1,
202   HAL_3D_SIDE_BY_SIDE_R_L = 0x2,
203   HAL_3D_TOP_BOTTOM = 0x4,
204   HAL_3D_IN_SIDE_BY_SIDE_L_R = 0x10000,  // unused legacy format
205 };
206 
207 enum { BUFFER_TYPE_UI = 0, BUFFER_TYPE_VIDEO };
208 
209 #endif  // __GRALLOC_PRIV_H__
210