2 * Copyright (C) 2008 The Android Open Source Project
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
8 * http://www.apache.org/licenses/LICENSE-2.0
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.
17 #ifndef ANDROID_INCLUDE_HARDWARE_HARDWARE_H
18 #define ANDROID_INCLUDE_HARDWARE_HARDWARE_H
21 #include <sys/cdefs.h>
23 #include <cutils/native_handle.h>
28 * Value for the hw_module_t.tag field
31 #define MAKE_TAG_CONSTANT(A,B,C,D) (((A) << 24) | ((B) << 16) | ((C) << 8) | (D))
33 #define HARDWARE_MODULE_TAG MAKE_TAG_CONSTANT('H', 'W', 'M', 'T')
34 #define HARDWARE_DEVICE_TAG MAKE_TAG_CONSTANT('H', 'W', 'D', 'T')
37 struct hw_module_methods_t;
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.
45 typedef struct hw_module_t {
46 /** tag must be initialized to HARDWARE_MODULE_TAG */
49 /** major version number for the module */
50 uint16_t version_major;
52 /** minor version number of the module */
53 uint16_t version_minor;
55 /** Identifier of module */
58 /** Name of this module */
61 /** Author/owner/implementor of the module */
64 /** Modules methods */
65 struct hw_module_methods_t* methods;
70 /** padding to 128 bytes, reserved for future use */
71 uint32_t reserved[32-7];
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);
80 } hw_module_methods_t;
83 * Every device data structure must begin with hw_device_t
84 * followed by module specific public methods and attributes.
86 typedef struct hw_device_t {
87 /** tag must be initialized to HARDWARE_DEVICE_TAG */
90 /** version number for hw_device_t */
93 /** reference to the module this device belongs to */
94 struct hw_module_t* module;
96 /** padding reserved for future use */
97 uint32_t reserved[12];
99 /** Close this device */
100 int (*close)(struct hw_device_t* device);
105 * Name of the hal_module_info
107 #define HAL_MODULE_INFO_SYM HMI
110 * Name of the hal_module_info as a string
112 #define HAL_MODULE_INFO_SYM_AS_STR "HMI"
115 * Get the module info associated with a module by id.
116 * @return: 0 == success, <0 == error and *pHmi == NULL
118 int hw_get_module(const char *id, const struct hw_module_t **module);
122 * pixel format definitions
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 HAL_PIXEL_FORMAT_YCbCr_422_SP = 0x10,
134 HAL_PIXEL_FORMAT_YCrCb_420_SP = 0x11,
135 HAL_PIXEL_FORMAT_YCbCr_422_P = 0x12,
136 HAL_PIXEL_FORMAT_YCbCr_420_P = 0x13,
137 HAL_PIXEL_FORMAT_YCbCr_422_I = 0x14,
138 HAL_PIXEL_FORMAT_YCbCr_420_I = 0x15,
139 HAL_PIXEL_FORMAT_CbYCrY_422_I = 0x16,
140 HAL_PIXEL_FORMAT_CbYCrY_420_I = 0x17,
141 HAL_PIXEL_FORMAT_YCbCr_420_SP_TILED = 0x20,
142 HAL_PIXEL_FORMAT_YCbCr_420_SP = 0x21,
143 HAL_PIXEL_FORMAT_YCrCb_420_SP_TILED = 0x22,
144 HAL_PIXEL_FORMAT_YCrCb_422_SP = 0x23,
149 * Transformation definitions
153 /* flip source image horizontally */
154 HAL_TRANSFORM_FLIP_H = 0x01,
155 /* flip source image vertically */
156 HAL_TRANSFORM_FLIP_V = 0x02,
157 /* rotate source image 90 degrees */
158 HAL_TRANSFORM_ROT_90 = 0x04,
159 /* rotate source image 180 degrees */
160 HAL_TRANSFORM_ROT_180 = 0x03,
161 /* rotate source image 270 degrees */
162 HAL_TRANSFORM_ROT_270 = 0x07,
167 #endif /* ANDROID_INCLUDE_HARDWARE_HARDWARE_H */