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