hwc_utils.h revision 47377987cc4eef72ee3b0cdced8c3a15038b39eb 
1/*
2 * Copyright (C) 2010 The Android Open Source Project
3 * Copyright (C) 2012, The Linux Foundation. All rights reserved.
4 *
5 * Licensed under the Apache License, Version 2.0 (the "License");
6 * you may not use this file except in compliance with the License.
7 * You may obtain a copy of the License at
8 *
9 *      http://www.apache.org/licenses/LICENSE-2.0
10 *
11 * Unless required by applicable law or agreed to in writing, software
12 * distributed under the License is distributed on an "AS IS" BASIS,
13 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14 * See the License for the specific language governing permissions and
15 * limitations under the License.
16 */
17
18#ifndef HWC_UTILS_H
19#define HWC_UTILS_H
20
21#define HWC_REMOVE_DEPRECATED_VERSIONS 1
22#include <fcntl.h>
23#include <hardware/hwcomposer.h>
24#include <gr.h>
25#include <gralloc_priv.h>
26
27#define ALIGN_TO(x, align)     (((x) + ((align)-1)) & ~((align)-1))
28#define LIKELY( exp )       (__builtin_expect( (exp) != 0, true  ))
29#define UNLIKELY( exp )     (__builtin_expect( (exp) != 0, false ))
30#define FINAL_TRANSFORM_MASK 0x000F
31#define MAX_NUM_DISPLAYS 4 //Yes, this is ambitious
32#define MAX_NUM_LAYERS 32
33
34//Fwrd decls
35struct hwc_context_t;
36struct framebuffer_device_t;
37
38namespace qService {
39class QService;
40}
41
42namespace overlay {
43class Overlay;
44}
45
46namespace qhwc {
47//fwrd decl
48class QueuedBufferStore;
49class ExternalDisplay;
50
51struct MDPInfo {
52    int version;
53    char panel;
54    bool hasOverlay;
55};
56
57struct DisplayAttributes {
58    uint32_t vsync_period; //nanos
59    uint32_t xres;
60    uint32_t yres;
61    float xdpi;
62    float ydpi;
63    int fd;
64    bool connected; //Applies only to pluggable disp.
65    //Connected does not mean it ready to use.
66    //It should be active also. (UNBLANKED)
67    bool isActive;
68};
69
70struct ListStats {
71    int numAppLayers; //Total - 1, excluding FB layer.
72    int skipCount;
73    int fbLayerIndex; //Always last for now. = numAppLayers
74    //Video specific
75    int yuvCount;
76    int yuvIndex;
77};
78
79enum {
80    HWC_MDPCOMP = 0x00000002,
81    HWC_LAYER_RESERVED_0 = 0x00000004,
82    HWC_LAYER_RESERVED_1 = 0x00000008
83};
84
85class LayerCache {
86    public:
87    LayerCache() {
88        canUseLayerCache = false;
89        numHwLayers = 0;
90        for(uint32_t i = 0; i < MAX_NUM_LAYERS; i++) {
91            hnd[i] = NULL;
92        }
93    }
94    //LayerCache optimization
95    void updateLayerCache(hwc_display_contents_1_t* list);
96    void resetLayerCache(int num);
97    void markCachedLayersAsOverlay(hwc_display_contents_1_t* list);
98    private:
99    uint32_t numHwLayers;
100    bool canUseLayerCache;
101    buffer_handle_t hnd[MAX_NUM_LAYERS];
102
103};
104
105
106// -----------------------------------------------------------------------------
107// Utility functions - implemented in hwc_utils.cpp
108void dumpLayer(hwc_layer_1_t const* l);
109void setListStats(hwc_context_t *ctx, const hwc_display_contents_1_t *list,
110        int dpy);
111void initContext(hwc_context_t *ctx);
112void closeContext(hwc_context_t *ctx);
113//Crops source buffer against destination and FB boundaries
114void calculate_crop_rects(hwc_rect_t& crop, hwc_rect_t& dst,
115        const int fbWidth, const int fbHeight, int orient);
116
117bool isExternalActive(hwc_context_t* ctx);
118
119//Sync point impl.
120int hwc_sync(hwc_context_t *ctx, hwc_display_contents_1_t* list, int dpy);
121
122// Inline utility functions
123static inline bool isSkipLayer(const hwc_layer_1_t* l) {
124    return (UNLIKELY(l && (l->flags & HWC_SKIP_LAYER)));
125}
126
127// Returns true if the buffer is yuv
128static inline bool isYuvBuffer(const private_handle_t* hnd) {
129    return (hnd && (hnd->bufferType == BUFFER_TYPE_VIDEO));
130}
131
132// Returns true if the buffer is secure
133static inline bool isSecureBuffer(const private_handle_t* hnd) {
134    return (hnd && (private_handle_t::PRIV_FLAGS_SECURE_BUFFER & hnd->flags));
135}
136//Return true if buffer is marked locked
137static inline bool isBufferLocked(const private_handle_t* hnd) {
138    return (hnd && (private_handle_t::PRIV_FLAGS_HWC_LOCK & hnd->flags));
139}
140
141//Return true if buffer is for external display only
142static inline bool isExtOnly(const private_handle_t* hnd) {
143    return (hnd && (hnd->flags & private_handle_t::PRIV_FLAGS_EXTERNAL_ONLY));
144}
145
146//Return true if buffer is for external display only with a BLOCK flag.
147static inline bool isExtBlock(const private_handle_t* hnd) {
148    return (hnd && (hnd->flags & private_handle_t::PRIV_FLAGS_EXTERNAL_BLOCK));
149}
150
151//Return true if buffer is for external display only with a Close Caption flag.
152static inline bool isExtCC(const private_handle_t* hnd) {
153    return (hnd && (hnd->flags & private_handle_t::PRIV_FLAGS_EXTERNAL_CC));
154}
155
156// Initialize uevent thread
157void init_uevent_thread(hwc_context_t* ctx);
158// Initialize vsync thread
159void init_vsync_thread(hwc_context_t* ctx);
160
161inline void getLayerResolution(const hwc_layer_1_t* layer,
162                               int& width, int& height)
163{
164    hwc_rect_t displayFrame  = layer->displayFrame;
165    width = displayFrame.right - displayFrame.left;
166    height = displayFrame.bottom - displayFrame.top;
167}
168
169static inline int openFb(int dpy) {
170    int fd = -1;
171    const char *devtmpl = "/dev/graphics/fb%u";
172    char name[64] = {0};
173    snprintf(name, 64, devtmpl, dpy);
174    fd = open(name, O_RDWR);
175    return fd;
176}
177
178template <class T>
179inline void swap(T& a, T& b) {
180    T tmp = a;
181    a = b;
182    b = tmp;
183}
184
185}; //qhwc namespace
186
187struct vsync_state {
188    pthread_mutex_t lock;
189    pthread_cond_t  cond;
190    bool enable;
191};
192
193// -----------------------------------------------------------------------------
194// HWC context
195// This structure contains overall state
196struct hwc_context_t {
197    hwc_composer_device_1_t device;
198    const hwc_procs_t* proc;
199
200    //Framebuffer device
201    framebuffer_device_t *mFbDev;
202
203    //Overlay object - NULL for non overlay devices
204    overlay::Overlay *mOverlay;
205
206    //QService object
207    qService::QService *mQService;
208
209    // External display related information
210    qhwc::ExternalDisplay *mExtDisplay;
211
212    qhwc::MDPInfo mMDP;
213
214    qhwc::DisplayAttributes dpyAttr[HWC_NUM_DISPLAY_TYPES];
215
216    qhwc::ListStats listStats[HWC_NUM_DISPLAY_TYPES];
217
218    qhwc::LayerCache *mLayerCache;
219
220    //Securing in progress indicator
221    bool mSecuring;
222
223    //Display in secure mode indicator
224    bool mSecureMode;
225
226    //Lock to prevent set from being called while blanking
227    mutable Locker mBlankLock;
228    //Lock to protect set when detaching external disp
229    mutable Locker mExtSetLock;
230    //Vsync
231    struct vsync_state vstate;
232};
233
234#endif //HWC_UTILS_H
235