1 /* 2 * Copyright (C) 2008 The Android Open Source Project 3 * 4 * Licensed under the Apache License, Version 2.0 (the "License"); 5 * you may not use this file except in compliance with the License. 6 * You may obtain a copy of the License at 7 * 8 * http://www.apache.org/licenses/LICENSE-2.0 9 * 10 * Unless required by applicable law or agreed to in writing, software 11 * distributed under the License is distributed on an "AS IS" BASIS, 12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13 * See the License for the specific language governing permissions and 14 * limitations under the License. 15 */ 16 17 #ifndef ANDROID_INCLUDE_HARDWARE_HARDWARE_H 18 #define ANDROID_INCLUDE_HARDWARE_HARDWARE_H 19 20 #include <stdint.h> 21 #include <sys/cdefs.h> 22 23 #include <cutils/native_handle.h> 24 25 __BEGIN_DECLS 26 27 /* 28 * Value for the hw_module_t.tag field 29 */ 30 31 #define MAKE_TAG_CONSTANT(A,B,C,D) (((A) << 24) | ((B) << 16) | ((C) << 8) | (D)) 32 33 #define HARDWARE_MODULE_TAG MAKE_TAG_CONSTANT('H', 'W', 'M', 'T') 34 #define HARDWARE_DEVICE_TAG MAKE_TAG_CONSTANT('H', 'W', 'D', 'T') 35 36 struct hw_module_t; 37 struct hw_module_methods_t; 38 struct hw_device_t; 39 40 /** 41 * Every hardware module must have a data structure named HAL_MODULE_INFO_SYM 42 * and the fields of this data structure must begin with hw_module_t 43 * followed by module specific information. 44 */ 45 typedef struct hw_module_t { 46 /** tag must be initialized to HARDWARE_MODULE_TAG */ 47 uint32_t tag; 48 49 /** major version number for the module */ 50 uint16_t version_major; 51 52 /** minor version number of the module */ 53 uint16_t version_minor; 54 55 /** Identifier of module */ 56 const char *id; 57 58 /** Name of this module */ 59 const char *name; 60 61 /** Author/owner/implementor of the module */ 62 const char *author; 63 64 /** Modules methods */ 65 struct hw_module_methods_t* methods; 66 67 /** module's dso */ 68 void* dso; 69 70 /** padding to 128 bytes, reserved for future use */ 71 uint32_t reserved[32-7]; 72 73 } hw_module_t; 74 75 typedef struct hw_module_methods_t { 76 /** Open a specific device */ 77 int (*open)(const struct hw_module_t* module, const char* id, 78 struct hw_device_t** device); 79 80 } hw_module_methods_t; 81 82 /** 83 * Every device data structure must begin with hw_device_t 84 * followed by module specific public methods and attributes. 85 */ 86 typedef struct hw_device_t { 87 /** tag must be initialized to HARDWARE_DEVICE_TAG */ 88 uint32_t tag; 89 90 /** version number for hw_device_t */ 91 uint32_t version; 92 93 /** reference to the module this device belongs to */ 94 struct hw_module_t* module; 95 96 /** padding reserved for future use */ 97 uint32_t reserved[12]; 98 99 /** Close this device */ 100 int (*close)(struct hw_device_t* device); 101 102 } hw_device_t; 103 104 /** 105 * Name of the hal_module_info 106 */ 107 #define HAL_MODULE_INFO_SYM HMI 108 109 /** 110 * Name of the hal_module_info as a string 111 */ 112 #define HAL_MODULE_INFO_SYM_AS_STR "HMI" 113 114 /** 115 * Get the module info associated with a module by id. 116 * @return: 0 == success, <0 == error and *pHmi == NULL 117 */ 118 int hw_get_module(const char *id, const struct hw_module_t **module); 119 120 121 /** 122 * pixel format definitions 123 */ 124 125 enum { 126 HAL_PIXEL_FORMAT_RGBA_8888 = 1, 127 HAL_PIXEL_FORMAT_RGBX_8888 = 2, 128 HAL_PIXEL_FORMAT_RGB_888 = 3, 129 HAL_PIXEL_FORMAT_RGB_565 = 4, 130 HAL_PIXEL_FORMAT_BGRA_8888 = 5, 131 HAL_PIXEL_FORMAT_RGBA_5551 = 6, 132 HAL_PIXEL_FORMAT_RGBA_4444 = 7, 133 134 /* 0x8 - 0xFF range unavailable */ 135 136 /* 137 * 0x100 - 0x1FF 138 * 139 * This range is reserved for HAL implementations. OEMs can use 140 * any value in this range to communicate formats between their HAL 141 * modules 142 * 143 */ 144 145 /* 146 * Android YUV format: 147 * 148 * This format is exposed outside of the HAL to software 149 * decoders and applications. 150 * EGLImageKHR must support it in conjunction with the 151 * OES_EGL_image_external extension. 152 * 153 * YV12 is 4:2:0 YCrCb planar format comprised of a WxH Y plane followed 154 * by (W/2) x (H/2) Cr and Cb planes. 155 * 156 * This format assumes 157 * - an even width 158 * - an even height 159 * - a horizontal stride multiple of 16 pixels 160 * - a vertical stride equal to the height 161 * 162 * y_size = stride * height 163 * c_size = ALIGN(stride/2, 16) * height/2 164 * size = y_size + c_size * 2 165 * cr_offset = y_size 166 * cb_offset = y_size + c_size 167 * 168 */ 169 HAL_PIXEL_FORMAT_YV12 = 0x32315659, // YCrCb 4:2:0 Planar 170 171 172 173 /* Legacy formats (deprecated), used by ImageFormat.java */ 174 HAL_PIXEL_FORMAT_YCbCr_422_SP = 0x10, // NV16 175 HAL_PIXEL_FORMAT_YCrCb_420_SP = 0x11, // NV21 176 HAL_PIXEL_FORMAT_YCbCr_422_I = 0x14, // YUY2 177 }; 178 179 180 /** 181 * Transformation definitions 182 * 183 * IMPORTANT NOTE: 184 * HAL_TRANSFORM_ROT_90 is applied CLOCKWISE and AFTER HAL_TRANSFORM_FLIP_{H|V}. 185 * 186 */ 187 188 enum { 189 /* flip source image horizontally (around the vertical axis) */ 190 HAL_TRANSFORM_FLIP_H = 0x01, 191 /* flip source image vertically (around the horizontal axis)*/ 192 HAL_TRANSFORM_FLIP_V = 0x02, 193 /* rotate source image 90 degrees clockwise */ 194 HAL_TRANSFORM_ROT_90 = 0x04, 195 /* rotate source image 180 degrees */ 196 HAL_TRANSFORM_ROT_180 = 0x03, 197 /* rotate source image 270 degrees clockwise */ 198 HAL_TRANSFORM_ROT_270 = 0x07, 199 }; 200 201 __END_DECLS 202 203 #endif /* ANDROID_INCLUDE_HARDWARE_HARDWARE_H */ 204
