HWComposer.cpp revision 6b44267a3beb457e220cad0666c039d3a765cdb2 
1/*
2 * Copyright (C) 2010 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#define ATRACE_TAG ATRACE_TAG_GRAPHICS
18
19// Uncomment this to remove support for HWC_DEVICE_API_VERSION_0_3 and older
20#define HWC_REMOVE_DEPRECATED_VERSIONS 1
21
22#include <stdint.h>
23#include <stdio.h>
24#include <stdlib.h>
25#include <string.h>
26#include <sys/types.h>
27#include <math.h>
28
29#include <utils/CallStack.h>
30#include <utils/Errors.h>
31#include <utils/misc.h>
32#include <utils/String8.h>
33#include <utils/Thread.h>
34#include <utils/Trace.h>
35#include <utils/Vector.h>
36
37#include <ui/GraphicBuffer.h>
38
39#include <hardware/hardware.h>
40#include <hardware/hwcomposer.h>
41
42#include <android/configuration.h>
43
44#include <cutils/log.h>
45#include <cutils/properties.h>
46
47#include "HWComposer.h"
48
49#include "../Layer.h"           // needed only for debugging
50#include "../SurfaceFlinger.h"
51
52namespace android {
53
54// This is not a real HWC version. It's used for in-development features that
55// haven't been committed to a specific real HWC version.
56#define HWC_DEVICE_API_VERSION_1_EXP HARDWARE_DEVICE_API_VERSION_2(1, 0xFF, HWC_HEADER_VERSION)
57
58#define MIN_HWC_HEADER_VERSION HWC_HEADER_VERSION
59
60#define NUM_PHYSICAL_DISPLAYS HWC_NUM_DISPLAY_TYPES
61#define VIRTUAL_DISPLAY_ID_BASE HWC_NUM_DISPLAY_TYPES
62
63static uint32_t hwcApiVersion(const hwc_composer_device_1_t* hwc) {
64    uint32_t hwcVersion = hwc->common.version;
65    return hwcVersion & HARDWARE_API_VERSION_2_MAJ_MIN_MASK;
66}
67
68static uint32_t hwcHeaderVersion(const hwc_composer_device_1_t* hwc) {
69    uint32_t hwcVersion = hwc->common.version;
70    return hwcVersion & HARDWARE_API_VERSION_2_HEADER_MASK;
71}
72
73static bool hwcHasApiVersion(const hwc_composer_device_1_t* hwc,
74        uint32_t version) {
75    return hwcApiVersion(hwc) >= (version & HARDWARE_API_VERSION_2_MAJ_MIN_MASK);
76}
77
78// ---------------------------------------------------------------------------
79
80struct HWComposer::cb_context {
81    struct callbacks : public hwc_procs_t {
82        // these are here to facilitate the transition when adding
83        // new callbacks (an implementation can check for NULL before
84        // calling a new callback).
85        void (*zero[4])(void);
86    };
87    callbacks procs;
88    HWComposer* hwc;
89};
90
91// ---------------------------------------------------------------------------
92
93HWComposer::HWComposer(
94        const sp<SurfaceFlinger>& flinger,
95        EventHandler& handler)
96    : mFlinger(flinger),
97      mFbDev(0), mHwc(0), mNumDisplays(1),
98      mCBContext(new cb_context),
99      mEventHandler(handler),
100      mVSyncCount(0), mDebugForceFakeVSync(false)
101{
102    for (size_t i =0 ; i<MAX_DISPLAYS ; i++) {
103        mLists[i] = 0;
104    }
105
106    char value[PROPERTY_VALUE_MAX];
107    property_get("debug.sf.no_hw_vsync", value, "0");
108    mDebugForceFakeVSync = atoi(value);
109
110    bool needVSyncThread = true;
111
112    // Note: some devices may insist that the FB HAL be opened before HWC.
113    int fberr = loadFbHalModule();
114    loadHwcModule();
115
116    if (mFbDev && mHwc && hwcHasApiVersion(mHwc, HWC_DEVICE_API_VERSION_1_1)) {
117        // close FB HAL if we don't needed it.
118        // FIXME: this is temporary until we're not forced to open FB HAL
119        // before HWC.
120        framebuffer_close(mFbDev);
121        mFbDev = NULL;
122    }
123
124    // If we have no HWC, or a pre-1.1 HWC, an FB dev is mandatory.
125    if ((!mHwc || !hwcHasApiVersion(mHwc, HWC_DEVICE_API_VERSION_1_1))
126            && !mFbDev) {
127        ALOGE("ERROR: failed to open framebuffer (%s), aborting",
128                strerror(-fberr));
129        abort();
130    }
131
132    // these display IDs are always reserved
133    for (size_t i=0 ; i<NUM_PHYSICAL_DISPLAYS ; i++) {
134        mAllocatedDisplayIDs.markBit(i);
135    }
136
137    if (mHwc) {
138        ALOGI("Using %s version %u.%u", HWC_HARDWARE_COMPOSER,
139              (hwcApiVersion(mHwc) >> 24) & 0xff,
140              (hwcApiVersion(mHwc) >> 16) & 0xff);
141        if (mHwc->registerProcs) {
142            mCBContext->hwc = this;
143            mCBContext->procs.invalidate = &hook_invalidate;
144            mCBContext->procs.vsync = &hook_vsync;
145            if (hwcHasApiVersion(mHwc, HWC_DEVICE_API_VERSION_1_1))
146                mCBContext->procs.hotplug = &hook_hotplug;
147            else
148                mCBContext->procs.hotplug = NULL;
149            memset(mCBContext->procs.zero, 0, sizeof(mCBContext->procs.zero));
150            mHwc->registerProcs(mHwc, &mCBContext->procs);
151        }
152
153        // don't need a vsync thread if we have a hardware composer
154        needVSyncThread = false;
155        // always turn vsync off when we start
156        eventControl(HWC_DISPLAY_PRIMARY, HWC_EVENT_VSYNC, 0);
157
158        // the number of displays we actually have depends on the
159        // hw composer version
160        if (hwcHasApiVersion(mHwc, HWC_DEVICE_API_VERSION_1_EXP)) {
161            // 1.?? adds support for virtual displays
162            mNumDisplays = MAX_DISPLAYS;
163        } else if (hwcHasApiVersion(mHwc, HWC_DEVICE_API_VERSION_1_1)) {
164            // 1.1 adds support for multiple displays
165            mNumDisplays = NUM_PHYSICAL_DISPLAYS;
166        } else {
167            mNumDisplays = 1;
168        }
169    }
170
171    if (mFbDev) {
172        ALOG_ASSERT(!(mHwc && hwcHasApiVersion(mHwc, HWC_DEVICE_API_VERSION_1_1)),
173                "should only have fbdev if no hwc or hwc is 1.0");
174
175        DisplayData& disp(mDisplayData[HWC_DISPLAY_PRIMARY]);
176        disp.connected = true;
177        disp.width = mFbDev->width;
178        disp.height = mFbDev->height;
179        disp.format = mFbDev->format;
180        disp.xdpi = mFbDev->xdpi;
181        disp.ydpi = mFbDev->ydpi;
182        if (disp.refresh == 0) {
183            disp.refresh = nsecs_t(1e9 / mFbDev->fps);
184            ALOGW("getting VSYNC period from fb HAL: %lld", disp.refresh);
185        }
186        if (disp.refresh == 0) {
187            disp.refresh = nsecs_t(1e9 / 60.0);
188            ALOGW("getting VSYNC period from thin air: %lld",
189                    mDisplayData[HWC_DISPLAY_PRIMARY].refresh);
190        }
191    } else if (mHwc) {
192        // here we're guaranteed to have at least HWC 1.1
193        for (size_t i =0 ; i<NUM_PHYSICAL_DISPLAYS ; i++) {
194            queryDisplayProperties(i);
195        }
196    }
197
198    if (needVSyncThread) {
199        // we don't have VSYNC support, we need to fake it
200        mVSyncThread = new VSyncThread(*this);
201    }
202}
203
204HWComposer::~HWComposer() {
205    if (mHwc) {
206        eventControl(HWC_DISPLAY_PRIMARY, HWC_EVENT_VSYNC, 0);
207    }
208    if (mVSyncThread != NULL) {
209        mVSyncThread->requestExitAndWait();
210    }
211    if (mHwc) {
212        hwc_close_1(mHwc);
213    }
214    if (mFbDev) {
215        framebuffer_close(mFbDev);
216    }
217    delete mCBContext;
218}
219
220// Load and prepare the hardware composer module.  Sets mHwc.
221void HWComposer::loadHwcModule()
222{
223    hw_module_t const* module;
224
225    if (hw_get_module(HWC_HARDWARE_MODULE_ID, &module) != 0) {
226        ALOGE("%s module not found", HWC_HARDWARE_MODULE_ID);
227        return;
228    }
229
230    int err = hwc_open_1(module, &mHwc);
231    if (err) {
232        ALOGE("%s device failed to initialize (%s)",
233              HWC_HARDWARE_COMPOSER, strerror(-err));
234        return;
235    }
236
237    if (!hwcHasApiVersion(mHwc, HWC_DEVICE_API_VERSION_1_0) ||
238            hwcHeaderVersion(mHwc) < MIN_HWC_HEADER_VERSION ||
239            hwcHeaderVersion(mHwc) > HWC_HEADER_VERSION) {
240        ALOGE("%s device version %#x unsupported, will not be used",
241              HWC_HARDWARE_COMPOSER, mHwc->common.version);
242        hwc_close_1(mHwc);
243        mHwc = NULL;
244        return;
245    }
246}
247
248// Load and prepare the FB HAL, which uses the gralloc module.  Sets mFbDev.
249int HWComposer::loadFbHalModule()
250{
251    hw_module_t const* module;
252
253    int err = hw_get_module(GRALLOC_HARDWARE_MODULE_ID, &module);
254    if (err != 0) {
255        ALOGE("%s module not found", GRALLOC_HARDWARE_MODULE_ID);
256        return err;
257    }
258
259    return framebuffer_open(module, &mFbDev);
260}
261
262status_t HWComposer::initCheck() const {
263    return mHwc ? NO_ERROR : NO_INIT;
264}
265
266void HWComposer::hook_invalidate(const struct hwc_procs* procs) {
267    cb_context* ctx = reinterpret_cast<cb_context*>(
268            const_cast<hwc_procs_t*>(procs));
269    ctx->hwc->invalidate();
270}
271
272void HWComposer::hook_vsync(const struct hwc_procs* procs, int disp,
273        int64_t timestamp) {
274    cb_context* ctx = reinterpret_cast<cb_context*>(
275            const_cast<hwc_procs_t*>(procs));
276    ctx->hwc->vsync(disp, timestamp);
277}
278
279void HWComposer::hook_hotplug(const struct hwc_procs* procs, int disp,
280        int connected) {
281    cb_context* ctx = reinterpret_cast<cb_context*>(
282            const_cast<hwc_procs_t*>(procs));
283    ctx->hwc->hotplug(disp, connected);
284}
285
286void HWComposer::invalidate() {
287    mFlinger->repaintEverything();
288}
289
290void HWComposer::vsync(int disp, int64_t timestamp) {
291    ATRACE_INT("VSYNC", ++mVSyncCount&1);
292    mEventHandler.onVSyncReceived(disp, timestamp);
293    Mutex::Autolock _l(mLock);
294    mLastHwVSync = timestamp;
295}
296
297void HWComposer::hotplug(int disp, int connected) {
298    if (disp == HWC_DISPLAY_PRIMARY || disp >= VIRTUAL_DISPLAY_ID_BASE) {
299        ALOGE("hotplug event received for invalid display: disp=%d connected=%d",
300                disp, connected);
301        return;
302    }
303    queryDisplayProperties(disp);
304    mEventHandler.onHotplugReceived(disp, bool(connected));
305}
306
307static float getDefaultDensity(uint32_t height) {
308    if (height >= 1080) return ACONFIGURATION_DENSITY_XHIGH;
309    else                return ACONFIGURATION_DENSITY_TV;
310}
311
312static const uint32_t DISPLAY_ATTRIBUTES[] = {
313    HWC_DISPLAY_VSYNC_PERIOD,
314    HWC_DISPLAY_WIDTH,
315    HWC_DISPLAY_HEIGHT,
316    HWC_DISPLAY_DPI_X,
317    HWC_DISPLAY_DPI_Y,
318    HWC_DISPLAY_NO_ATTRIBUTE,
319};
320#define NUM_DISPLAY_ATTRIBUTES (sizeof(DISPLAY_ATTRIBUTES) / sizeof(DISPLAY_ATTRIBUTES)[0])
321
322status_t HWComposer::queryDisplayProperties(int disp) {
323
324    LOG_ALWAYS_FATAL_IF(!mHwc || !hwcHasApiVersion(mHwc, HWC_DEVICE_API_VERSION_1_1));
325
326    // use zero as default value for unspecified attributes
327    int32_t values[NUM_DISPLAY_ATTRIBUTES - 1];
328    memset(values, 0, sizeof(values));
329
330    uint32_t config;
331    size_t numConfigs = 1;
332    status_t err = mHwc->getDisplayConfigs(mHwc, disp, &config, &numConfigs);
333    if (err != NO_ERROR) {
334        // this can happen if an unpluggable display is not connected
335        mDisplayData[disp].connected = false;
336        return err;
337    }
338
339    err = mHwc->getDisplayAttributes(mHwc, disp, config, DISPLAY_ATTRIBUTES, values);
340    if (err != NO_ERROR) {
341        // we can't get this display's info. turn it off.
342        mDisplayData[disp].connected = false;
343        return err;
344    }
345
346    int32_t w = 0, h = 0;
347    for (size_t i = 0; i < NUM_DISPLAY_ATTRIBUTES - 1; i++) {
348        switch (DISPLAY_ATTRIBUTES[i]) {
349        case HWC_DISPLAY_VSYNC_PERIOD:
350            mDisplayData[disp].refresh = nsecs_t(values[i]);
351            break;
352        case HWC_DISPLAY_WIDTH:
353            mDisplayData[disp].width = values[i];
354            break;
355        case HWC_DISPLAY_HEIGHT:
356            mDisplayData[disp].height = values[i];
357            break;
358        case HWC_DISPLAY_DPI_X:
359            mDisplayData[disp].xdpi = values[i] / 1000.0f;
360            break;
361        case HWC_DISPLAY_DPI_Y:
362            mDisplayData[disp].ydpi = values[i] / 1000.0f;
363            break;
364        default:
365            ALOG_ASSERT(false, "unknown display attribute[%d] %#x",
366                    i, DISPLAY_ATTRIBUTES[i]);
367            break;
368        }
369    }
370
371    // FIXME: what should we set the format to?
372    mDisplayData[disp].format = HAL_PIXEL_FORMAT_RGBA_8888;
373    mDisplayData[disp].connected = true;
374    if (mDisplayData[disp].xdpi == 0.0f || mDisplayData[disp].ydpi == 0.0f) {
375        float dpi = getDefaultDensity(h);
376        mDisplayData[disp].xdpi = dpi;
377        mDisplayData[disp].ydpi = dpi;
378    }
379    return NO_ERROR;
380}
381
382status_t HWComposer::setVirtualDisplayProperties(int32_t id,
383        uint32_t w, uint32_t h, uint32_t format) {
384    if (id < VIRTUAL_DISPLAY_ID_BASE || id >= int32_t(mNumDisplays) ||
385            !mAllocatedDisplayIDs.hasBit(id)) {
386        return BAD_INDEX;
387    }
388    mDisplayData[id].width = w;
389    mDisplayData[id].height = h;
390    mDisplayData[id].format = format;
391    mDisplayData[id].xdpi = mDisplayData[id].ydpi = getDefaultDensity(h);
392    return NO_ERROR;
393}
394
395int32_t HWComposer::allocateDisplayId() {
396    if (mAllocatedDisplayIDs.count() >= mNumDisplays) {
397        return NO_MEMORY;
398    }
399    int32_t id = mAllocatedDisplayIDs.firstUnmarkedBit();
400    mAllocatedDisplayIDs.markBit(id);
401    mDisplayData[id].connected = true;
402    return id;
403}
404
405status_t HWComposer::freeDisplayId(int32_t id) {
406    if (id < NUM_PHYSICAL_DISPLAYS) {
407        // cannot free the reserved IDs
408        return BAD_VALUE;
409    }
410    if (uint32_t(id)>31 || !mAllocatedDisplayIDs.hasBit(id)) {
411        return BAD_INDEX;
412    }
413    mAllocatedDisplayIDs.clearBit(id);
414    mDisplayData[id].connected = false;
415    return NO_ERROR;
416}
417
418nsecs_t HWComposer::getRefreshPeriod(int disp) const {
419    return mDisplayData[disp].refresh;
420}
421
422nsecs_t HWComposer::getRefreshTimestamp(int disp) const {
423    // this returns the last refresh timestamp.
424    // if the last one is not available, we estimate it based on
425    // the refresh period and whatever closest timestamp we have.
426    Mutex::Autolock _l(mLock);
427    nsecs_t now = systemTime(CLOCK_MONOTONIC);
428    return now - ((now - mLastHwVSync) %  mDisplayData[disp].refresh);
429}
430
431sp<Fence> HWComposer::getDisplayFence(int disp) const {
432    return mDisplayData[disp].lastDisplayFence;
433}
434
435uint32_t HWComposer::getWidth(int disp) const {
436    return mDisplayData[disp].width;
437}
438
439uint32_t HWComposer::getHeight(int disp) const {
440    return mDisplayData[disp].height;
441}
442
443uint32_t HWComposer::getFormat(int disp) const {
444    return mDisplayData[disp].format;
445}
446
447float HWComposer::getDpiX(int disp) const {
448    return mDisplayData[disp].xdpi;
449}
450
451float HWComposer::getDpiY(int disp) const {
452    return mDisplayData[disp].ydpi;
453}
454
455bool HWComposer::isConnected(int disp) const {
456    return mDisplayData[disp].connected;
457}
458
459void HWComposer::eventControl(int disp, int event, int enabled) {
460    if (uint32_t(disp)>31 || !mAllocatedDisplayIDs.hasBit(disp)) {
461        ALOGD("eventControl ignoring event %d on unallocated disp %d (en=%d)",
462              event, disp, enabled);
463        return;
464    }
465    if (event != EVENT_VSYNC) {
466        ALOGW("eventControl got unexpected event %d (disp=%d en=%d)",
467              event, disp, enabled);
468        return;
469    }
470    status_t err = NO_ERROR;
471    if (mHwc && !mDebugForceFakeVSync) {
472        // NOTE: we use our own internal lock here because we have to call
473        // into the HWC with the lock held, and we want to make sure
474        // that even if HWC blocks (which it shouldn't), it won't
475        // affect other threads.
476        Mutex::Autolock _l(mEventControlLock);
477        const int32_t eventBit = 1UL << event;
478        const int32_t newValue = enabled ? eventBit : 0;
479        const int32_t oldValue = mDisplayData[disp].events & eventBit;
480        if (newValue != oldValue) {
481            ATRACE_CALL();
482            err = mHwc->eventControl(mHwc, disp, event, enabled);
483            if (!err) {
484                int32_t& events(mDisplayData[disp].events);
485                events = (events & ~eventBit) | newValue;
486            }
487        }
488        // error here should not happen -- not sure what we should
489        // do if it does.
490        ALOGE_IF(err, "eventControl(%d, %d) failed %s",
491                event, enabled, strerror(-err));
492    }
493
494    if (err == NO_ERROR && mVSyncThread != NULL) {
495        mVSyncThread->setEnabled(enabled);
496    }
497}
498
499status_t HWComposer::createWorkList(int32_t id, size_t numLayers) {
500    if (uint32_t(id)>31 || !mAllocatedDisplayIDs.hasBit(id)) {
501        return BAD_INDEX;
502    }
503
504    if (mHwc) {
505        DisplayData& disp(mDisplayData[id]);
506        if (hwcHasApiVersion(mHwc, HWC_DEVICE_API_VERSION_1_1)) {
507            // we need space for the HWC_FRAMEBUFFER_TARGET
508            numLayers++;
509        }
510        if (disp.capacity < numLayers || disp.list == NULL) {
511            size_t size = sizeof(hwc_display_contents_1_t)
512                    + numLayers * sizeof(hwc_layer_1_t);
513            free(disp.list);
514            disp.list = (hwc_display_contents_1_t*)malloc(size);
515            disp.capacity = numLayers;
516        }
517        if (hwcHasApiVersion(mHwc, HWC_DEVICE_API_VERSION_1_1)) {
518            disp.framebufferTarget = &disp.list->hwLayers[numLayers - 1];
519            memset(disp.framebufferTarget, 0, sizeof(hwc_layer_1_t));
520            const hwc_rect_t r = { 0, 0, (int) disp.width, (int) disp.height };
521            disp.framebufferTarget->compositionType = HWC_FRAMEBUFFER_TARGET;
522            disp.framebufferTarget->hints = 0;
523            disp.framebufferTarget->flags = 0;
524            disp.framebufferTarget->handle = disp.fbTargetHandle;
525            disp.framebufferTarget->transform = 0;
526            disp.framebufferTarget->blending = HWC_BLENDING_PREMULT;
527            disp.framebufferTarget->sourceCrop = r;
528            disp.framebufferTarget->displayFrame = r;
529            disp.framebufferTarget->visibleRegionScreen.numRects = 1;
530            disp.framebufferTarget->visibleRegionScreen.rects =
531                &disp.framebufferTarget->displayFrame;
532            disp.framebufferTarget->acquireFenceFd = -1;
533            disp.framebufferTarget->releaseFenceFd = -1;
534            disp.framebufferTarget->planeAlpha = 0xFF;
535        }
536        disp.list->retireFenceFd = -1;
537        disp.list->flags = HWC_GEOMETRY_CHANGED;
538        disp.list->numHwLayers = numLayers;
539    }
540    return NO_ERROR;
541}
542
543status_t HWComposer::setFramebufferTarget(int32_t id,
544        const sp<Fence>& acquireFence, const sp<GraphicBuffer>& buf) {
545    if (uint32_t(id)>31 || !mAllocatedDisplayIDs.hasBit(id)) {
546        return BAD_INDEX;
547    }
548    DisplayData& disp(mDisplayData[id]);
549    if (!disp.framebufferTarget) {
550        // this should never happen, but apparently eglCreateWindowSurface()
551        // triggers a Surface::queueBuffer()  on some
552        // devices (!?) -- log and ignore.
553        ALOGE("HWComposer: framebufferTarget is null");
554        return NO_ERROR;
555    }
556
557    int acquireFenceFd = -1;
558    if (acquireFence->isValid()) {
559        acquireFenceFd = acquireFence->dup();
560    }
561
562    // ALOGD("fbPost: handle=%p, fence=%d", buf->handle, acquireFenceFd);
563    disp.fbTargetHandle = buf->handle;
564    disp.framebufferTarget->handle = disp.fbTargetHandle;
565    disp.framebufferTarget->acquireFenceFd = acquireFenceFd;
566    return NO_ERROR;
567}
568
569status_t HWComposer::prepare() {
570    for (size_t i=0 ; i<mNumDisplays ; i++) {
571        DisplayData& disp(mDisplayData[i]);
572        if (disp.framebufferTarget) {
573            // make sure to reset the type to HWC_FRAMEBUFFER_TARGET
574            // DO NOT reset the handle field to NULL, because it's possible
575            // that we have nothing to redraw (eg: eglSwapBuffers() not called)
576            // in which case, we should continue to use the same buffer.
577            LOG_FATAL_IF(disp.list == NULL);
578            disp.framebufferTarget->compositionType = HWC_FRAMEBUFFER_TARGET;
579        }
580        if (!disp.connected && disp.list != NULL) {
581            ALOGW("WARNING: disp %d: connected, non-null list, layers=%d",
582                  i, disp.list->numHwLayers);
583        }
584        mLists[i] = disp.list;
585        if (mLists[i]) {
586            if (hwcHasApiVersion(mHwc, HWC_DEVICE_API_VERSION_1_EXP)) {
587                mLists[i]->outbuf = NULL;
588                mLists[i]->outbufAcquireFenceFd = -1;
589            } else if (hwcHasApiVersion(mHwc, HWC_DEVICE_API_VERSION_1_1)) {
590                // garbage data to catch improper use
591                mLists[i]->dpy = (hwc_display_t)0xDEADBEEF;
592                mLists[i]->sur = (hwc_surface_t)0xDEADBEEF;
593            } else {
594                mLists[i]->dpy = EGL_NO_DISPLAY;
595                mLists[i]->sur = EGL_NO_SURFACE;
596            }
597        }
598    }
599
600    int err = mHwc->prepare(mHwc, mNumDisplays, mLists);
601    ALOGE_IF(err, "HWComposer: prepare failed (%s)", strerror(-err));
602
603    if (err == NO_ERROR) {
604        // here we're just making sure that "skip" layers are set
605        // to HWC_FRAMEBUFFER and we're also counting how many layers
606        // we have of each type.
607        for (size_t i=0 ; i<mNumDisplays ; i++) {
608            DisplayData& disp(mDisplayData[i]);
609            disp.hasFbComp = false;
610            disp.hasOvComp = false;
611            if (disp.list) {
612                for (size_t i=0 ; i<disp.list->numHwLayers ; i++) {
613                    hwc_layer_1_t& l = disp.list->hwLayers[i];
614
615                    //ALOGD("prepare: %d, type=%d, handle=%p",
616                    //        i, l.compositionType, l.handle);
617
618                    if (l.flags & HWC_SKIP_LAYER) {
619                        l.compositionType = HWC_FRAMEBUFFER;
620                    }
621                    if (l.compositionType == HWC_FRAMEBUFFER) {
622                        disp.hasFbComp = true;
623                    }
624                    if (l.compositionType == HWC_OVERLAY) {
625                        disp.hasOvComp = true;
626                    }
627                }
628            }
629        }
630    }
631    return (status_t)err;
632}
633
634bool HWComposer::hasHwcComposition(int32_t id) const {
635    if (!mHwc || uint32_t(id)>31 || !mAllocatedDisplayIDs.hasBit(id))
636        return false;
637    return mDisplayData[id].hasOvComp;
638}
639
640bool HWComposer::hasGlesComposition(int32_t id) const {
641    if (!mHwc || uint32_t(id)>31 || !mAllocatedDisplayIDs.hasBit(id))
642        return true;
643    return mDisplayData[id].hasFbComp;
644}
645
646sp<Fence> HWComposer::getAndResetReleaseFence(int32_t id) {
647    if (uint32_t(id)>31 || !mAllocatedDisplayIDs.hasBit(id))
648        return Fence::NO_FENCE;
649
650    int fd = INVALID_OPERATION;
651    if (mHwc && hwcHasApiVersion(mHwc, HWC_DEVICE_API_VERSION_1_1)) {
652        const DisplayData& disp(mDisplayData[id]);
653        if (disp.framebufferTarget) {
654            fd = disp.framebufferTarget->releaseFenceFd;
655            disp.framebufferTarget->acquireFenceFd = -1;
656            disp.framebufferTarget->releaseFenceFd = -1;
657        }
658    }
659    return fd >= 0 ? new Fence(fd) : Fence::NO_FENCE;
660}
661
662status_t HWComposer::commit() {
663    int err = NO_ERROR;
664    if (mHwc) {
665        if (!hwcHasApiVersion(mHwc, HWC_DEVICE_API_VERSION_1_1)) {
666            // On version 1.0, the OpenGL ES target surface is communicated
667            // by the (dpy, sur) fields and we are guaranteed to have only
668            // a single display.
669            mLists[0]->dpy = eglGetCurrentDisplay();
670            mLists[0]->sur = eglGetCurrentSurface(EGL_DRAW);
671        }
672
673        for (size_t i=VIRTUAL_DISPLAY_ID_BASE; i<mNumDisplays; i++) {
674            DisplayData& disp(mDisplayData[i]);
675            if (disp.outbufHandle) {
676                mLists[i]->outbuf = disp.outbufHandle;
677                mLists[i]->outbufAcquireFenceFd =
678                        disp.outbufAcquireFence->dup();
679            }
680        }
681
682        err = mHwc->set(mHwc, mNumDisplays, mLists);
683
684        for (size_t i=0 ; i<mNumDisplays ; i++) {
685            DisplayData& disp(mDisplayData[i]);
686            disp.lastDisplayFence = disp.lastRetireFence;
687            disp.lastRetireFence = Fence::NO_FENCE;
688            if (disp.list) {
689                if (disp.list->retireFenceFd != -1) {
690                    disp.lastRetireFence = new Fence(disp.list->retireFenceFd);
691                    disp.list->retireFenceFd = -1;
692                }
693                disp.list->flags &= ~HWC_GEOMETRY_CHANGED;
694            }
695        }
696    }
697    return (status_t)err;
698}
699
700status_t HWComposer::release(int disp) {
701    LOG_FATAL_IF(disp >= VIRTUAL_DISPLAY_ID_BASE);
702    if (mHwc) {
703        eventControl(disp, HWC_EVENT_VSYNC, 0);
704        return (status_t)mHwc->blank(mHwc, disp, 1);
705    }
706    return NO_ERROR;
707}
708
709status_t HWComposer::acquire(int disp) {
710    LOG_FATAL_IF(disp >= VIRTUAL_DISPLAY_ID_BASE);
711    if (mHwc) {
712        return (status_t)mHwc->blank(mHwc, disp, 0);
713    }
714    return NO_ERROR;
715}
716
717void HWComposer::disconnectDisplay(int disp) {
718    LOG_ALWAYS_FATAL_IF(disp < 0 || disp == HWC_DISPLAY_PRIMARY);
719    DisplayData& dd(mDisplayData[disp]);
720    free(dd.list);
721    dd.list = NULL;
722    dd.framebufferTarget = NULL;    // points into dd.list
723    dd.fbTargetHandle = NULL;
724    dd.outbufHandle = NULL;
725    dd.lastRetireFence = Fence::NO_FENCE;
726    dd.lastDisplayFence = Fence::NO_FENCE;
727    dd.outbufAcquireFence = Fence::NO_FENCE;
728}
729
730int HWComposer::getVisualID() const {
731    if (mHwc && hwcHasApiVersion(mHwc, HWC_DEVICE_API_VERSION_1_1)) {
732        // FIXME: temporary hack until HAL_PIXEL_FORMAT_IMPLEMENTATION_DEFINED
733        // is supported by the implementation. we can only be in this case
734        // if we have HWC 1.1
735        return HAL_PIXEL_FORMAT_RGBA_8888;
736        //return HAL_PIXEL_FORMAT_IMPLEMENTATION_DEFINED;
737    } else {
738        return mFbDev->format;
739    }
740}
741
742bool HWComposer::supportsFramebufferTarget() const {
743    return (mHwc && hwcHasApiVersion(mHwc, HWC_DEVICE_API_VERSION_1_1));
744}
745
746int HWComposer::fbPost(int32_t id,
747        const sp<Fence>& acquireFence, const sp<GraphicBuffer>& buffer) {
748    if (mHwc && hwcHasApiVersion(mHwc, HWC_DEVICE_API_VERSION_1_1)) {
749        return setFramebufferTarget(id, acquireFence, buffer);
750    } else {
751        acquireFence->waitForever("HWComposer::fbPost");
752        return mFbDev->post(mFbDev, buffer->handle);
753    }
754}
755
756int HWComposer::fbCompositionComplete() {
757    if (mHwc && hwcHasApiVersion(mHwc, HWC_DEVICE_API_VERSION_1_1))
758        return NO_ERROR;
759
760    if (mFbDev->compositionComplete) {
761        return mFbDev->compositionComplete(mFbDev);
762    } else {
763        return INVALID_OPERATION;
764    }
765}
766
767void HWComposer::fbDump(String8& result) {
768    if (mFbDev && mFbDev->common.version >= 1 && mFbDev->dump) {
769        const size_t SIZE = 4096;
770        char buffer[SIZE];
771        mFbDev->dump(mFbDev, buffer, SIZE);
772        result.append(buffer);
773    }
774}
775
776status_t HWComposer::setOutputBuffer(int32_t id, const sp<Fence>& acquireFence,
777        const sp<GraphicBuffer>& buf) {
778    if (uint32_t(id)>31 || !mAllocatedDisplayIDs.hasBit(id))
779        return BAD_INDEX;
780    if (id < VIRTUAL_DISPLAY_ID_BASE)
781        return INVALID_OPERATION;
782
783    DisplayData& disp(mDisplayData[id]);
784    disp.outbufHandle = buf->handle;
785    disp.outbufAcquireFence = acquireFence;
786    return NO_ERROR;
787}
788
789sp<Fence> HWComposer::getLastRetireFence(int32_t id) {
790    if (uint32_t(id)>31 || !mAllocatedDisplayIDs.hasBit(id))
791        return Fence::NO_FENCE;
792    return mDisplayData[id].lastRetireFence;
793}
794
795/*
796 * Helper template to implement a concrete HWCLayer
797 * This holds the pointer to the concrete hwc layer type
798 * and implements the "iterable" side of HWCLayer.
799 */
800template<typename CONCRETE, typename HWCTYPE>
801class Iterable : public HWComposer::HWCLayer {
802protected:
803    HWCTYPE* const mLayerList;
804    HWCTYPE* mCurrentLayer;
805    Iterable(HWCTYPE* layer) : mLayerList(layer), mCurrentLayer(layer) { }
806    inline HWCTYPE const * getLayer() const { return mCurrentLayer; }
807    inline HWCTYPE* getLayer() { return mCurrentLayer; }
808    virtual ~Iterable() { }
809private:
810    // returns a copy of ourselves
811    virtual HWComposer::HWCLayer* dup() {
812        return new CONCRETE( static_cast<const CONCRETE&>(*this) );
813    }
814    virtual status_t setLayer(size_t index) {
815        mCurrentLayer = &mLayerList[index];
816        return NO_ERROR;
817    }
818};
819
820/*
821 * Concrete implementation of HWCLayer for HWC_DEVICE_API_VERSION_1_0.
822 * This implements the HWCLayer side of HWCIterableLayer.
823 */
824class HWCLayerVersion1 : public Iterable<HWCLayerVersion1, hwc_layer_1_t> {
825    struct hwc_composer_device_1* mHwc;
826public:
827    HWCLayerVersion1(struct hwc_composer_device_1* hwc, hwc_layer_1_t* layer)
828        : Iterable<HWCLayerVersion1, hwc_layer_1_t>(layer), mHwc(hwc) { }
829
830    virtual int32_t getCompositionType() const {
831        return getLayer()->compositionType;
832    }
833    virtual uint32_t getHints() const {
834        return getLayer()->hints;
835    }
836    virtual sp<Fence> getAndResetReleaseFence() {
837        int fd = getLayer()->releaseFenceFd;
838        getLayer()->releaseFenceFd = -1;
839        return fd >= 0 ? new Fence(fd) : Fence::NO_FENCE;
840    }
841    virtual void setAcquireFenceFd(int fenceFd) {
842        getLayer()->acquireFenceFd = fenceFd;
843    }
844    virtual void setPerFrameDefaultState() {
845        //getLayer()->compositionType = HWC_FRAMEBUFFER;
846    }
847    virtual void setPlaneAlpha(uint8_t alpha) {
848        if (hwcHasApiVersion(mHwc, HWC_DEVICE_API_VERSION_1_2)) {
849            getLayer()->planeAlpha = alpha;
850        } else {
851            if (alpha < 0xFF) {
852                getLayer()->flags |= HWC_SKIP_LAYER;
853            }
854        }
855    }
856    virtual void setDefaultState() {
857        hwc_layer_1_t* const l = getLayer();
858        l->compositionType = HWC_FRAMEBUFFER;
859        l->hints = 0;
860        l->flags = HWC_SKIP_LAYER;
861        l->handle = 0;
862        l->transform = 0;
863        l->blending = HWC_BLENDING_NONE;
864        l->visibleRegionScreen.numRects = 0;
865        l->visibleRegionScreen.rects = NULL;
866        l->acquireFenceFd = -1;
867        l->releaseFenceFd = -1;
868        l->planeAlpha = 0xFF;
869    }
870    virtual void setSkip(bool skip) {
871        if (skip) {
872            getLayer()->flags |= HWC_SKIP_LAYER;
873        } else {
874            getLayer()->flags &= ~HWC_SKIP_LAYER;
875        }
876    }
877    virtual void setBlending(uint32_t blending) {
878        getLayer()->blending = blending;
879    }
880    virtual void setTransform(uint32_t transform) {
881        getLayer()->transform = transform;
882    }
883    virtual void setFrame(const Rect& frame) {
884        getLayer()->displayFrame = reinterpret_cast<hwc_rect_t const&>(frame);
885    }
886    virtual void setCrop(const FloatRect& crop) {
887        if (hwcHasApiVersion(mHwc, HWC_DEVICE_API_VERSION_1_3)) {
888            getLayer()->sourceCropf = reinterpret_cast<hwc_frect_t const&>(crop);
889        } else {
890            /*
891             * Since h/w composer didn't support a flot crop rect before version 1.3,
892             * using integer coordinates instead produces a different output from the GL code in
893             * Layer::drawWithOpenGL(). The difference can be large if the buffer crop to
894             * window size ratio is large and a window crop is defined
895             * (i.e.: if we scale the buffer a lot and we also crop it with a window crop).
896             */
897            hwc_rect_t& r = getLayer()->sourceCrop;
898            r.left  = int(ceilf(crop.left));
899            r.top   = int(ceilf(crop.top));
900            r.right = int(floorf(crop.right));
901            r.bottom= int(floorf(crop.bottom));
902        }
903    }
904    virtual void setVisibleRegionScreen(const Region& reg) {
905        // Region::getSharedBuffer creates a reference to the underlying
906        // SharedBuffer of this Region, this reference is freed
907        // in onDisplayed()
908        hwc_region_t& visibleRegion = getLayer()->visibleRegionScreen;
909        SharedBuffer const* sb = reg.getSharedBuffer(&visibleRegion.numRects);
910        visibleRegion.rects = reinterpret_cast<hwc_rect_t const *>(sb->data());
911    }
912    virtual void setBuffer(const sp<GraphicBuffer>& buffer) {
913        if (buffer == 0 || buffer->handle == 0) {
914            getLayer()->compositionType = HWC_FRAMEBUFFER;
915            getLayer()->flags |= HWC_SKIP_LAYER;
916            getLayer()->handle = 0;
917        } else {
918            getLayer()->handle = buffer->handle;
919        }
920    }
921    virtual void onDisplayed() {
922        hwc_region_t& visibleRegion = getLayer()->visibleRegionScreen;
923        SharedBuffer const* sb = SharedBuffer::bufferFromData(visibleRegion.rects);
924        if (sb) {
925            sb->release();
926            // not technically needed but safer
927            visibleRegion.numRects = 0;
928            visibleRegion.rects = NULL;
929        }
930
931        getLayer()->acquireFenceFd = -1;
932    }
933};
934
935/*
936 * returns an iterator initialized at a given index in the layer list
937 */
938HWComposer::LayerListIterator HWComposer::getLayerIterator(int32_t id, size_t index) {
939    if (uint32_t(id)>31 || !mAllocatedDisplayIDs.hasBit(id)) {
940        return LayerListIterator();
941    }
942    const DisplayData& disp(mDisplayData[id]);
943    if (!mHwc || !disp.list || index > disp.list->numHwLayers) {
944        return LayerListIterator();
945    }
946    return LayerListIterator(new HWCLayerVersion1(mHwc, disp.list->hwLayers), index);
947}
948
949/*
950 * returns an iterator on the beginning of the layer list
951 */
952HWComposer::LayerListIterator HWComposer::begin(int32_t id) {
953    return getLayerIterator(id, 0);
954}
955
956/*
957 * returns an iterator on the end of the layer list
958 */
959HWComposer::LayerListIterator HWComposer::end(int32_t id) {
960    size_t numLayers = 0;
961    if (uint32_t(id) <= 31 && mAllocatedDisplayIDs.hasBit(id)) {
962        const DisplayData& disp(mDisplayData[id]);
963        if (mHwc && disp.list) {
964            numLayers = disp.list->numHwLayers;
965            if (hwcHasApiVersion(mHwc, HWC_DEVICE_API_VERSION_1_1)) {
966                // with HWC 1.1, the last layer is always the HWC_FRAMEBUFFER_TARGET,
967                // which we ignore when iterating through the layer list.
968                ALOGE_IF(!numLayers, "mDisplayData[%d].list->numHwLayers is 0", id);
969                if (numLayers) {
970                    numLayers--;
971                }
972            }
973        }
974    }
975    return getLayerIterator(id, numLayers);
976}
977
978void HWComposer::dump(String8& result) const {
979    if (mHwc) {
980        result.appendFormat("Hardware Composer state (version %8x):\n", hwcApiVersion(mHwc));
981        result.appendFormat("  mDebugForceFakeVSync=%d\n", mDebugForceFakeVSync);
982        for (size_t i=0 ; i<mNumDisplays ; i++) {
983            const DisplayData& disp(mDisplayData[i]);
984            if (!disp.connected)
985                continue;
986
987            const Vector< sp<Layer> >& visibleLayersSortedByZ =
988                    mFlinger->getLayerSortedByZForHwcDisplay(i);
989
990            result.appendFormat(
991                    "  Display[%d] : %ux%u, xdpi=%f, ydpi=%f, refresh=%lld\n",
992                    i, disp.width, disp.height, disp.xdpi, disp.ydpi, disp.refresh);
993
994            if (disp.list) {
995                result.appendFormat(
996                        "  numHwLayers=%u, flags=%08x\n",
997                        disp.list->numHwLayers, disp.list->flags);
998
999                result.append(
1000                        "    type    |  handle  |   hints  |   flags  | tr | blend |  format  |       source crop         |           frame           name \n"
1001                        "------------+----------+----------+----------+----+-------+----------+---------------------------+--------------------------------\n");
1002                //      " __________ | ________ | ________ | ________ | __ | _____ | ________ | [_____,_____,_____,_____] | [_____,_____,_____,_____]
1003                for (size_t i=0 ; i<disp.list->numHwLayers ; i++) {
1004                    const hwc_layer_1_t&l = disp.list->hwLayers[i];
1005                    int32_t format = -1;
1006                    String8 name("unknown");
1007
1008                    if (i < visibleLayersSortedByZ.size()) {
1009                        const sp<Layer>& layer(visibleLayersSortedByZ[i]);
1010                        const sp<GraphicBuffer>& buffer(
1011                                layer->getActiveBuffer());
1012                        if (buffer != NULL) {
1013                            format = buffer->getPixelFormat();
1014                        }
1015                        name = layer->getName();
1016                    }
1017
1018                    int type = l.compositionType;
1019                    if (type == HWC_FRAMEBUFFER_TARGET) {
1020                        name = "HWC_FRAMEBUFFER_TARGET";
1021                        format = disp.format;
1022                    }
1023
1024                    static char const* compositionTypeName[] = {
1025                            "GLES",
1026                            "HWC",
1027                            "BACKGROUND",
1028                            "FB TARGET",
1029                            "UNKNOWN"};
1030                    if (type >= NELEM(compositionTypeName))
1031                        type = NELEM(compositionTypeName) - 1;
1032
1033                    result.appendFormat(
1034                            " %10s | %08x | %08x | %08x | %02x | %05x | %08x | [%5d,%5d,%5d,%5d] | [%5d,%5d,%5d,%5d] %s\n",
1035                                    compositionTypeName[type],
1036                                    intptr_t(l.handle), l.hints, l.flags, l.transform, l.blending, format,
1037                                    l.sourceCrop.left, l.sourceCrop.top, l.sourceCrop.right, l.sourceCrop.bottom,
1038                                    l.displayFrame.left, l.displayFrame.top, l.displayFrame.right, l.displayFrame.bottom,
1039                                    name.string());
1040                }
1041            }
1042        }
1043    }
1044
1045    if (mHwc && mHwc->dump) {
1046        const size_t SIZE = 4096;
1047        char buffer[SIZE];
1048        mHwc->dump(mHwc, buffer, SIZE);
1049        result.append(buffer);
1050    }
1051}
1052
1053// ---------------------------------------------------------------------------
1054
1055HWComposer::VSyncThread::VSyncThread(HWComposer& hwc)
1056    : mHwc(hwc), mEnabled(false),
1057      mNextFakeVSync(0),
1058      mRefreshPeriod(hwc.getRefreshPeriod(HWC_DISPLAY_PRIMARY))
1059{
1060}
1061
1062void HWComposer::VSyncThread::setEnabled(bool enabled) {
1063    Mutex::Autolock _l(mLock);
1064    if (mEnabled != enabled) {
1065        mEnabled = enabled;
1066        mCondition.signal();
1067    }
1068}
1069
1070void HWComposer::VSyncThread::onFirstRef() {
1071    run("VSyncThread", PRIORITY_URGENT_DISPLAY + PRIORITY_MORE_FAVORABLE);
1072}
1073
1074bool HWComposer::VSyncThread::threadLoop() {
1075    { // scope for lock
1076        Mutex::Autolock _l(mLock);
1077        while (!mEnabled) {
1078            mCondition.wait(mLock);
1079        }
1080    }
1081
1082    const nsecs_t period = mRefreshPeriod;
1083    const nsecs_t now = systemTime(CLOCK_MONOTONIC);
1084    nsecs_t next_vsync = mNextFakeVSync;
1085    nsecs_t sleep = next_vsync - now;
1086    if (sleep < 0) {
1087        // we missed, find where the next vsync should be
1088        sleep = (period - ((now - next_vsync) % period));
1089        next_vsync = now + sleep;
1090    }
1091    mNextFakeVSync = next_vsync + period;
1092
1093    struct timespec spec;
1094    spec.tv_sec  = next_vsync / 1000000000;
1095    spec.tv_nsec = next_vsync % 1000000000;
1096
1097    int err;
1098    do {
1099        err = clock_nanosleep(CLOCK_MONOTONIC, TIMER_ABSTIME, &spec, NULL);
1100    } while (err<0 && errno == EINTR);
1101
1102    if (err == 0) {
1103        mHwc.mEventHandler.onVSyncReceived(0, next_vsync);
1104    }
1105
1106    return true;
1107}
1108
1109HWComposer::DisplayData::DisplayData()
1110:   width(0), height(0), format(0),
1111    xdpi(0.0f), ydpi(0.0f),
1112    refresh(0),
1113    connected(false),
1114    hasFbComp(false), hasOvComp(false),
1115    capacity(0), list(NULL),
1116    framebufferTarget(NULL), fbTargetHandle(0),
1117    lastRetireFence(Fence::NO_FENCE), lastDisplayFence(Fence::NO_FENCE),
1118    outbufHandle(NULL), outbufAcquireFence(Fence::NO_FENCE),
1119    events(0)
1120{}
1121
1122HWComposer::DisplayData::~DisplayData() {
1123    free(list);
1124}
1125
1126// ---------------------------------------------------------------------------
1127}; // namespace android
1128