2 * Copyright (C) 2010 The Android Open Source Project
4 * Licensed under the Apache License, Version 2.0 (the "License");
5 * you may not use this file except in compliance with the License.
6 * You may obtain a copy of the License at
8 * http://www.apache.org/licenses/LICENSE-2.0
10 * Unless required by applicable law or agreed to in writing, software
11 * distributed under the License is distributed on an "AS IS" BASIS,
12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 * See the License for the specific language governing permissions and
14 * limitations under the License.
17 #define ATRACE_TAG ATRACE_TAG_GRAPHICS
25 #include <sys/types.h>
27 #include <utils/Errors.h>
28 #include <utils/misc.h>
29 #include <utils/NativeHandle.h>
30 #include <utils/String8.h>
31 #include <utils/Thread.h>
32 #include <utils/Trace.h>
33 #include <utils/Vector.h>
35 #include <ui/GraphicBuffer.h>
37 #include <hardware/hardware.h>
38 #include <hardware/hwcomposer.h>
40 #include <android/configuration.h>
42 #include <cutils/log.h>
43 #include <cutils/properties.h>
45 #include "HWComposer.h"
47 #include "../Layer.h" // needed only for debugging
48 #include "../SurfaceFlinger.h"
52 #define MIN_HWC_HEADER_VERSION HWC_HEADER_VERSION
54 static uint32_t hwcApiVersion(const hwc_composer_device_1_t* hwc) {
55 uint32_t hwcVersion = hwc->common.version;
56 return hwcVersion & HARDWARE_API_VERSION_2_MAJ_MIN_MASK;
59 static uint32_t hwcHeaderVersion(const hwc_composer_device_1_t* hwc) {
60 uint32_t hwcVersion = hwc->common.version;
61 return hwcVersion & HARDWARE_API_VERSION_2_HEADER_MASK;
64 static bool hwcHasApiVersion(const hwc_composer_device_1_t* hwc,
66 return hwcApiVersion(hwc) >= (version & HARDWARE_API_VERSION_2_MAJ_MIN_MASK);
69 // ---------------------------------------------------------------------------
71 struct HWComposer::cb_context {
72 struct callbacks : public hwc_procs_t {
73 // these are here to facilitate the transition when adding
74 // new callbacks (an implementation can check for NULL before
75 // calling a new callback).
76 void (*zero[4])(void);
82 // ---------------------------------------------------------------------------
84 HWComposer::HWComposer(
85 const sp<SurfaceFlinger>& flinger,
86 EventHandler& handler)
88 mFbDev(0), mHwc(0), mNumDisplays(1),
89 mCBContext(new cb_context),
90 mEventHandler(handler),
91 mDebugForceFakeVSync(false)
93 for (size_t i =0 ; i<MAX_HWC_DISPLAYS ; i++) {
97 for (size_t i=0 ; i<HWC_NUM_PHYSICAL_DISPLAY_TYPES ; i++) {
102 char value[PROPERTY_VALUE_MAX];
103 property_get("debug.sf.no_hw_vsync", value, "0");
104 mDebugForceFakeVSync = atoi(value);
106 bool needVSyncThread = true;
108 // Note: some devices may insist that the FB HAL be opened before HWC.
109 int fberr = loadFbHalModule();
112 if (mFbDev && mHwc && hwcHasApiVersion(mHwc, HWC_DEVICE_API_VERSION_1_1)) {
113 // close FB HAL if we don't needed it.
114 // FIXME: this is temporary until we're not forced to open FB HAL
116 framebuffer_close(mFbDev);
120 // If we have no HWC, or a pre-1.1 HWC, an FB dev is mandatory.
121 if ((!mHwc || !hwcHasApiVersion(mHwc, HWC_DEVICE_API_VERSION_1_1))
123 ALOGE("ERROR: failed to open framebuffer (%s), aborting",
128 // these display IDs are always reserved
129 for (size_t i=0 ; i<NUM_BUILTIN_DISPLAYS ; i++) {
130 mAllocatedDisplayIDs.markBit(i);
134 ALOGI("Using %s version %u.%u", HWC_HARDWARE_COMPOSER,
135 (hwcApiVersion(mHwc) >> 24) & 0xff,
136 (hwcApiVersion(mHwc) >> 16) & 0xff);
137 if (mHwc->registerProcs) {
138 mCBContext->hwc = this;
139 mCBContext->procs.invalidate = &hook_invalidate;
140 mCBContext->procs.vsync = &hook_vsync;
141 if (hwcHasApiVersion(mHwc, HWC_DEVICE_API_VERSION_1_1))
142 mCBContext->procs.hotplug = &hook_hotplug;
144 mCBContext->procs.hotplug = NULL;
145 memset(mCBContext->procs.zero, 0, sizeof(mCBContext->procs.zero));
146 mHwc->registerProcs(mHwc, &mCBContext->procs);
149 // don't need a vsync thread if we have a hardware composer
150 needVSyncThread = false;
151 // always turn vsync off when we start
152 eventControl(HWC_DISPLAY_PRIMARY, HWC_EVENT_VSYNC, 0);
154 // the number of displays we actually have depends on the
155 // hw composer version
156 if (hwcHasApiVersion(mHwc, HWC_DEVICE_API_VERSION_1_3)) {
157 // 1.3 adds support for virtual displays
158 mNumDisplays = MAX_HWC_DISPLAYS;
159 } else if (hwcHasApiVersion(mHwc, HWC_DEVICE_API_VERSION_1_1)) {
160 // 1.1 adds support for multiple displays
161 mNumDisplays = NUM_BUILTIN_DISPLAYS;
168 ALOG_ASSERT(!(mHwc && hwcHasApiVersion(mHwc, HWC_DEVICE_API_VERSION_1_1)),
169 "should only have fbdev if no hwc or hwc is 1.0");
171 DisplayData& disp(mDisplayData[HWC_DISPLAY_PRIMARY]);
172 disp.connected = true;
173 disp.format = mFbDev->format;
174 DisplayConfig config = DisplayConfig();
175 config.width = mFbDev->width;
176 config.height = mFbDev->height;
177 config.xdpi = mFbDev->xdpi;
178 config.ydpi = mFbDev->ydpi;
179 config.refresh = nsecs_t(1e9 / mFbDev->fps);
180 disp.configs.push_back(config);
181 disp.currentConfig = 0;
183 // here we're guaranteed to have at least HWC 1.1
184 for (size_t i =0 ; i<NUM_BUILTIN_DISPLAYS ; i++) {
185 queryDisplayProperties(i);
189 if (needVSyncThread) {
190 // we don't have VSYNC support, we need to fake it
191 mVSyncThread = new VSyncThread(*this);
195 HWComposer::~HWComposer() {
197 eventControl(HWC_DISPLAY_PRIMARY, HWC_EVENT_VSYNC, 0);
199 if (mVSyncThread != NULL) {
200 mVSyncThread->requestExitAndWait();
206 framebuffer_close(mFbDev);
211 // Load and prepare the hardware composer module. Sets mHwc.
212 void HWComposer::loadHwcModule()
214 hw_module_t const* module;
216 if (hw_get_module(HWC_HARDWARE_MODULE_ID, &module) != 0) {
217 ALOGE("%s module not found", HWC_HARDWARE_MODULE_ID);
221 int err = hwc_open_1(module, &mHwc);
223 ALOGE("%s device failed to initialize (%s)",
224 HWC_HARDWARE_COMPOSER, strerror(-err));
228 if (!hwcHasApiVersion(mHwc, HWC_DEVICE_API_VERSION_1_0) ||
229 hwcHeaderVersion(mHwc) < MIN_HWC_HEADER_VERSION ||
230 hwcHeaderVersion(mHwc) > HWC_HEADER_VERSION) {
231 ALOGE("%s device version %#x unsupported, will not be used",
232 HWC_HARDWARE_COMPOSER, mHwc->common.version);
239 // Load and prepare the FB HAL, which uses the gralloc module. Sets mFbDev.
240 int HWComposer::loadFbHalModule()
242 hw_module_t const* module;
244 int err = hw_get_module(GRALLOC_HARDWARE_MODULE_ID, &module);
246 ALOGE("%s module not found", GRALLOC_HARDWARE_MODULE_ID);
250 return framebuffer_open(module, &mFbDev);
253 status_t HWComposer::initCheck() const {
254 return mHwc ? NO_ERROR : NO_INIT;
257 void HWComposer::hook_invalidate(const struct hwc_procs* procs) {
258 cb_context* ctx = reinterpret_cast<cb_context*>(
259 const_cast<hwc_procs_t*>(procs));
260 ctx->hwc->invalidate();
263 void HWComposer::hook_vsync(const struct hwc_procs* procs, int disp,
265 cb_context* ctx = reinterpret_cast<cb_context*>(
266 const_cast<hwc_procs_t*>(procs));
267 ctx->hwc->vsync(disp, timestamp);
270 void HWComposer::hook_hotplug(const struct hwc_procs* procs, int disp,
272 cb_context* ctx = reinterpret_cast<cb_context*>(
273 const_cast<hwc_procs_t*>(procs));
274 ctx->hwc->hotplug(disp, connected);
277 void HWComposer::invalidate() {
278 mFlinger->repaintEverything();
281 void HWComposer::vsync(int disp, int64_t timestamp) {
282 if (uint32_t(disp) < HWC_NUM_PHYSICAL_DISPLAY_TYPES) {
284 Mutex::Autolock _l(mLock);
286 // There have been reports of HWCs that signal several vsync events
287 // with the same timestamp when turning the display off and on. This
288 // is a bug in the HWC implementation, but filter the extra events
289 // out here so they don't cause havoc downstream.
290 if (timestamp == mLastHwVSync[disp]) {
291 ALOGW("Ignoring duplicate VSYNC event from HWC (t=%" PRId64 ")",
296 mLastHwVSync[disp] = timestamp;
300 snprintf(tag, sizeof(tag), "HW_VSYNC_%1u", disp);
301 ATRACE_INT(tag, ++mVSyncCounts[disp] & 1);
303 mEventHandler.onVSyncReceived(disp, timestamp);
307 void HWComposer::hotplug(int disp, int connected) {
308 if (disp >= VIRTUAL_DISPLAY_ID_BASE) {
309 ALOGE("hotplug event received for invalid display: disp=%d connected=%d",
313 queryDisplayProperties(disp);
314 // Do not teardown or recreate the primary display
315 if (disp != HWC_DISPLAY_PRIMARY) {
316 mEventHandler.onHotplugReceived(disp, bool(connected));
320 static float getDefaultDensity(uint32_t width, uint32_t height) {
321 // Default density is based on TVs: 1080p displays get XHIGH density,
322 // lower-resolution displays get TV density. Maybe eventually we'll need
323 // to update it for 4K displays, though hopefully those just report
324 // accurate DPI information to begin with. This is also used for virtual
325 // displays and even primary displays with older hwcomposers, so be
326 // careful about orientation.
328 uint32_t h = width < height ? width : height;
329 if (h >= 1080) return ACONFIGURATION_DENSITY_XHIGH;
330 else return ACONFIGURATION_DENSITY_TV;
333 static const uint32_t DISPLAY_ATTRIBUTES[] = {
334 HWC_DISPLAY_VSYNC_PERIOD,
339 HWC_DISPLAY_COLOR_TRANSFORM,
340 HWC_DISPLAY_NO_ATTRIBUTE,
342 #define NUM_DISPLAY_ATTRIBUTES (sizeof(DISPLAY_ATTRIBUTES) / sizeof(DISPLAY_ATTRIBUTES)[0])
344 static const uint32_t PRE_HWC15_DISPLAY_ATTRIBUTES[] = {
345 HWC_DISPLAY_VSYNC_PERIOD,
350 HWC_DISPLAY_NO_ATTRIBUTE,
353 status_t HWComposer::queryDisplayProperties(int disp) {
355 LOG_ALWAYS_FATAL_IF(!mHwc || !hwcHasApiVersion(mHwc, HWC_DEVICE_API_VERSION_1_1));
357 // use zero as default value for unspecified attributes
358 int32_t values[NUM_DISPLAY_ATTRIBUTES - 1];
359 memset(values, 0, sizeof(values));
361 const size_t MAX_NUM_CONFIGS = 128;
362 uint32_t configs[MAX_NUM_CONFIGS] = {0};
363 size_t numConfigs = MAX_NUM_CONFIGS;
364 status_t err = mHwc->getDisplayConfigs(mHwc, disp, configs, &numConfigs);
365 if (err != NO_ERROR) {
366 // this can happen if an unpluggable display is not connected
367 mDisplayData[disp].connected = false;
371 mDisplayData[disp].currentConfig = 0;
372 for (size_t c = 0; c < numConfigs; ++c) {
373 err = mHwc->getDisplayAttributes(mHwc, disp, configs[c],
374 DISPLAY_ATTRIBUTES, values);
375 // If this is a pre-1.5 HWC, it may not know about color transform, so
376 // try again with a smaller set of attributes
377 if (err != NO_ERROR) {
378 err = mHwc->getDisplayAttributes(mHwc, disp, configs[c],
379 PRE_HWC15_DISPLAY_ATTRIBUTES, values);
381 if (err != NO_ERROR) {
382 // we can't get this display's info. turn it off.
383 mDisplayData[disp].connected = false;
387 DisplayConfig config = DisplayConfig();
388 for (size_t i = 0; i < NUM_DISPLAY_ATTRIBUTES - 1; i++) {
389 switch (DISPLAY_ATTRIBUTES[i]) {
390 case HWC_DISPLAY_VSYNC_PERIOD:
391 config.refresh = nsecs_t(values[i]);
393 case HWC_DISPLAY_WIDTH:
394 config.width = values[i];
396 case HWC_DISPLAY_HEIGHT:
397 config.height = values[i];
399 case HWC_DISPLAY_DPI_X:
400 config.xdpi = values[i] / 1000.0f;
402 case HWC_DISPLAY_DPI_Y:
403 config.ydpi = values[i] / 1000.0f;
405 case HWC_DISPLAY_COLOR_TRANSFORM:
406 config.colorTransform = values[i];
409 ALOG_ASSERT(false, "unknown display attribute[%zu] %#x",
410 i, DISPLAY_ATTRIBUTES[i]);
415 if (config.xdpi == 0.0f || config.ydpi == 0.0f) {
416 float dpi = getDefaultDensity(config.width, config.height);
421 mDisplayData[disp].configs.push_back(config);
424 // FIXME: what should we set the format to?
425 mDisplayData[disp].format = HAL_PIXEL_FORMAT_RGBA_8888;
426 mDisplayData[disp].connected = true;
430 status_t HWComposer::setVirtualDisplayProperties(int32_t id,
431 uint32_t w, uint32_t h, uint32_t format) {
432 if (id < VIRTUAL_DISPLAY_ID_BASE || id >= int32_t(mNumDisplays) ||
433 !mAllocatedDisplayIDs.hasBit(id)) {
436 size_t configId = mDisplayData[id].currentConfig;
437 mDisplayData[id].format = format;
438 DisplayConfig& config = mDisplayData[id].configs.editItemAt(configId);
441 config.xdpi = config.ydpi = getDefaultDensity(w, h);
445 int32_t HWComposer::allocateDisplayId() {
446 if (mAllocatedDisplayIDs.count() >= mNumDisplays) {
449 int32_t id = mAllocatedDisplayIDs.firstUnmarkedBit();
450 mAllocatedDisplayIDs.markBit(id);
451 mDisplayData[id].connected = true;
452 mDisplayData[id].configs.resize(1);
453 mDisplayData[id].currentConfig = 0;
457 status_t HWComposer::freeDisplayId(int32_t id) {
458 if (id < NUM_BUILTIN_DISPLAYS) {
459 // cannot free the reserved IDs
462 if (uint32_t(id)>31 || !mAllocatedDisplayIDs.hasBit(id)) {
465 mAllocatedDisplayIDs.clearBit(id);
466 mDisplayData[id].connected = false;
470 nsecs_t HWComposer::getRefreshTimestamp(int disp) const {
471 // this returns the last refresh timestamp.
472 // if the last one is not available, we estimate it based on
473 // the refresh period and whatever closest timestamp we have.
474 Mutex::Autolock _l(mLock);
475 nsecs_t now = systemTime(CLOCK_MONOTONIC);
476 size_t configId = mDisplayData[disp].currentConfig;
477 return now - ((now - mLastHwVSync[disp]) %
478 mDisplayData[disp].configs[configId].refresh);
481 sp<Fence> HWComposer::getDisplayFence(int disp) const {
482 return mDisplayData[disp].lastDisplayFence;
485 uint32_t HWComposer::getFormat(int disp) const {
486 if (static_cast<uint32_t>(disp) >= MAX_HWC_DISPLAYS || !mAllocatedDisplayIDs.hasBit(disp)) {
487 return HAL_PIXEL_FORMAT_RGBA_8888;
489 return mDisplayData[disp].format;
493 bool HWComposer::isConnected(int disp) const {
494 return mDisplayData[disp].connected;
497 uint32_t HWComposer::getWidth(int disp) const {
498 size_t currentConfig = mDisplayData[disp].currentConfig;
499 return mDisplayData[disp].configs[currentConfig].width;
502 uint32_t HWComposer::getHeight(int disp) const {
503 size_t currentConfig = mDisplayData[disp].currentConfig;
504 return mDisplayData[disp].configs[currentConfig].height;
507 float HWComposer::getDpiX(int disp) const {
508 size_t currentConfig = mDisplayData[disp].currentConfig;
509 return mDisplayData[disp].configs[currentConfig].xdpi;
512 float HWComposer::getDpiY(int disp) const {
513 size_t currentConfig = mDisplayData[disp].currentConfig;
514 return mDisplayData[disp].configs[currentConfig].ydpi;
517 nsecs_t HWComposer::getRefreshPeriod(int disp) const {
518 size_t currentConfig = mDisplayData[disp].currentConfig;
519 return mDisplayData[disp].configs[currentConfig].refresh;
522 const Vector<HWComposer::DisplayConfig>& HWComposer::getConfigs(int disp) const {
523 return mDisplayData[disp].configs;
526 size_t HWComposer::getCurrentConfig(int disp) const {
527 return mDisplayData[disp].currentConfig;
530 void HWComposer::eventControl(int disp, int event, int enabled) {
531 if (uint32_t(disp)>31 || !mAllocatedDisplayIDs.hasBit(disp)) {
532 ALOGD("eventControl ignoring event %d on unallocated disp %d (en=%d)",
533 event, disp, enabled);
536 if (event != EVENT_VSYNC) {
537 ALOGW("eventControl got unexpected event %d (disp=%d en=%d)",
538 event, disp, enabled);
541 status_t err = NO_ERROR;
542 if (mHwc && !mDebugForceFakeVSync) {
543 // NOTE: we use our own internal lock here because we have to call
544 // into the HWC with the lock held, and we want to make sure
545 // that even if HWC blocks (which it shouldn't), it won't
546 // affect other threads.
547 Mutex::Autolock _l(mEventControlLock);
548 const int32_t eventBit = 1UL << event;
549 const int32_t newValue = enabled ? eventBit : 0;
550 const int32_t oldValue = mDisplayData[disp].events & eventBit;
551 if (newValue != oldValue) {
553 err = mHwc->eventControl(mHwc, disp, event, enabled);
555 int32_t& events(mDisplayData[disp].events);
556 events = (events & ~eventBit) | newValue;
559 snprintf(tag, sizeof(tag), "HW_VSYNC_ON_%1u", disp);
560 ATRACE_INT(tag, enabled);
563 // error here should not happen -- not sure what we should
565 ALOGE_IF(err, "eventControl(%d, %d) failed %s",
566 event, enabled, strerror(-err));
569 if (err == NO_ERROR && mVSyncThread != NULL) {
570 mVSyncThread->setEnabled(enabled);
574 status_t HWComposer::createWorkList(int32_t id, size_t numLayers) {
575 if (uint32_t(id)>31 || !mAllocatedDisplayIDs.hasBit(id)) {
580 DisplayData& disp(mDisplayData[id]);
581 if (hwcHasApiVersion(mHwc, HWC_DEVICE_API_VERSION_1_1)) {
582 // we need space for the HWC_FRAMEBUFFER_TARGET
585 if (disp.capacity < numLayers || disp.list == NULL) {
586 size_t size = sizeof(hwc_display_contents_1_t)
587 + numLayers * sizeof(hwc_layer_1_t);
589 disp.list = (hwc_display_contents_1_t*)malloc(size);
590 disp.capacity = numLayers;
592 if (hwcHasApiVersion(mHwc, HWC_DEVICE_API_VERSION_1_1)) {
593 disp.framebufferTarget = &disp.list->hwLayers[numLayers - 1];
594 memset(disp.framebufferTarget, 0, sizeof(hwc_layer_1_t));
595 const DisplayConfig& currentConfig =
596 disp.configs[disp.currentConfig];
597 const hwc_rect_t r = { 0, 0,
598 (int) currentConfig.width, (int) currentConfig.height };
599 disp.framebufferTarget->compositionType = HWC_FRAMEBUFFER_TARGET;
600 disp.framebufferTarget->hints = 0;
601 disp.framebufferTarget->flags = 0;
602 disp.framebufferTarget->handle = disp.fbTargetHandle;
603 disp.framebufferTarget->transform = 0;
604 disp.framebufferTarget->blending = HWC_BLENDING_PREMULT;
605 if (hwcHasApiVersion(mHwc, HWC_DEVICE_API_VERSION_1_3)) {
606 disp.framebufferTarget->sourceCropf.left = 0;
607 disp.framebufferTarget->sourceCropf.top = 0;
608 disp.framebufferTarget->sourceCropf.right =
610 disp.framebufferTarget->sourceCropf.bottom =
611 currentConfig.height;
613 disp.framebufferTarget->sourceCrop = r;
615 disp.framebufferTarget->displayFrame = r;
616 disp.framebufferTarget->visibleRegionScreen.numRects = 1;
617 disp.framebufferTarget->visibleRegionScreen.rects =
618 &disp.framebufferTarget->displayFrame;
619 disp.framebufferTarget->acquireFenceFd = -1;
620 disp.framebufferTarget->releaseFenceFd = -1;
621 disp.framebufferTarget->planeAlpha = 0xFF;
623 disp.list->retireFenceFd = -1;
624 disp.list->flags = HWC_GEOMETRY_CHANGED;
625 disp.list->numHwLayers = numLayers;
630 status_t HWComposer::setFramebufferTarget(int32_t id,
631 const sp<Fence>& acquireFence, const sp<GraphicBuffer>& buf) {
632 if (uint32_t(id)>31 || !mAllocatedDisplayIDs.hasBit(id)) {
635 DisplayData& disp(mDisplayData[id]);
636 if (!disp.framebufferTarget) {
637 // this should never happen, but apparently eglCreateWindowSurface()
638 // triggers a Surface::queueBuffer() on some
639 // devices (!?) -- log and ignore.
640 ALOGE("HWComposer: framebufferTarget is null");
644 int acquireFenceFd = -1;
645 if (acquireFence->isValid()) {
646 acquireFenceFd = acquireFence->dup();
649 // ALOGD("fbPost: handle=%p, fence=%d", buf->handle, acquireFenceFd);
650 disp.fbTargetHandle = buf->handle;
651 disp.framebufferTarget->handle = disp.fbTargetHandle;
652 disp.framebufferTarget->acquireFenceFd = acquireFenceFd;
656 status_t HWComposer::prepare() {
657 Mutex::Autolock _l(mDisplayLock);
658 for (size_t i=0 ; i<mNumDisplays ; i++) {
659 DisplayData& disp(mDisplayData[i]);
660 if (disp.framebufferTarget) {
661 // make sure to reset the type to HWC_FRAMEBUFFER_TARGET
662 // DO NOT reset the handle field to NULL, because it's possible
663 // that we have nothing to redraw (eg: eglSwapBuffers() not called)
664 // in which case, we should continue to use the same buffer.
665 LOG_FATAL_IF(disp.list == NULL);
666 disp.framebufferTarget->compositionType = HWC_FRAMEBUFFER_TARGET;
668 if (!disp.connected && disp.list != NULL) {
669 ALOGW("WARNING: disp %zu: connected, non-null list, layers=%zu",
670 i, disp.list->numHwLayers);
672 mLists[i] = disp.list;
674 if (hwcHasApiVersion(mHwc, HWC_DEVICE_API_VERSION_1_3)) {
675 mLists[i]->outbuf = disp.outbufHandle;
676 mLists[i]->outbufAcquireFenceFd = -1;
677 } else if (hwcHasApiVersion(mHwc, HWC_DEVICE_API_VERSION_1_1)) {
678 // garbage data to catch improper use
679 mLists[i]->dpy = (hwc_display_t)0xDEADBEEF;
680 mLists[i]->sur = (hwc_surface_t)0xDEADBEEF;
682 mLists[i]->dpy = EGL_NO_DISPLAY;
683 mLists[i]->sur = EGL_NO_SURFACE;
688 int err = mHwc->prepare(mHwc, mNumDisplays, mLists);
689 ALOGE_IF(err, "HWComposer: prepare failed (%s)", strerror(-err));
691 if (err == NO_ERROR) {
692 // here we're just making sure that "skip" layers are set
693 // to HWC_FRAMEBUFFER and we're also counting how many layers
694 // we have of each type.
696 // If there are no window layers, we treat the display has having FB
697 // composition, because SurfaceFlinger will use GLES to draw the
699 for (size_t i=0 ; i<mNumDisplays ; i++) {
700 DisplayData& disp(mDisplayData[i]);
701 disp.hasFbComp = false;
702 disp.hasOvComp = false;
704 for (size_t i=0 ; i<disp.list->numHwLayers ; i++) {
705 hwc_layer_1_t& l = disp.list->hwLayers[i];
707 //ALOGD("prepare: %d, type=%d, handle=%p",
708 // i, l.compositionType, l.handle);
710 if (l.flags & HWC_SKIP_LAYER) {
711 l.compositionType = HWC_FRAMEBUFFER;
713 if (l.compositionType == HWC_FRAMEBUFFER) {
714 disp.hasFbComp = true;
716 if (l.compositionType == HWC_OVERLAY) {
717 disp.hasOvComp = true;
719 if (l.compositionType == HWC_CURSOR_OVERLAY) {
720 disp.hasOvComp = true;
723 if (disp.list->numHwLayers == (disp.framebufferTarget ? 1 : 0)) {
724 disp.hasFbComp = true;
727 disp.hasFbComp = true;
731 return (status_t)err;
734 bool HWComposer::hasHwcComposition(int32_t id) const {
735 if (!mHwc || uint32_t(id)>31 || !mAllocatedDisplayIDs.hasBit(id))
737 return mDisplayData[id].hasOvComp;
740 bool HWComposer::hasGlesComposition(int32_t id) const {
741 if (!mHwc || uint32_t(id)>31 || !mAllocatedDisplayIDs.hasBit(id))
743 return mDisplayData[id].hasFbComp;
746 sp<Fence> HWComposer::getAndResetReleaseFence(int32_t id) {
747 if (uint32_t(id)>31 || !mAllocatedDisplayIDs.hasBit(id))
748 return Fence::NO_FENCE;
750 int fd = INVALID_OPERATION;
751 if (mHwc && hwcHasApiVersion(mHwc, HWC_DEVICE_API_VERSION_1_1)) {
752 const DisplayData& disp(mDisplayData[id]);
753 if (disp.framebufferTarget) {
754 fd = disp.framebufferTarget->releaseFenceFd;
755 disp.framebufferTarget->acquireFenceFd = -1;
756 disp.framebufferTarget->releaseFenceFd = -1;
759 return fd >= 0 ? new Fence(fd) : Fence::NO_FENCE;
762 status_t HWComposer::commit() {
765 if (!hwcHasApiVersion(mHwc, HWC_DEVICE_API_VERSION_1_1)) {
766 // On version 1.0, the OpenGL ES target surface is communicated
767 // by the (dpy, sur) fields and we are guaranteed to have only
769 mLists[0]->dpy = eglGetCurrentDisplay();
770 mLists[0]->sur = eglGetCurrentSurface(EGL_DRAW);
773 for (size_t i=VIRTUAL_DISPLAY_ID_BASE; i<mNumDisplays; i++) {
774 DisplayData& disp(mDisplayData[i]);
775 if (disp.outbufHandle) {
776 mLists[i]->outbuf = disp.outbufHandle;
777 mLists[i]->outbufAcquireFenceFd =
778 disp.outbufAcquireFence->dup();
782 err = mHwc->set(mHwc, mNumDisplays, mLists);
784 for (size_t i=0 ; i<mNumDisplays ; i++) {
785 DisplayData& disp(mDisplayData[i]);
786 disp.lastDisplayFence = disp.lastRetireFence;
787 disp.lastRetireFence = Fence::NO_FENCE;
789 if (disp.list->retireFenceFd != -1) {
790 disp.lastRetireFence = new Fence(disp.list->retireFenceFd);
791 disp.list->retireFenceFd = -1;
793 disp.list->flags &= ~HWC_GEOMETRY_CHANGED;
797 return (status_t)err;
800 status_t HWComposer::setPowerMode(int disp, int mode) {
801 LOG_FATAL_IF(disp >= VIRTUAL_DISPLAY_ID_BASE);
803 if (mode == HWC_POWER_MODE_OFF) {
804 eventControl(disp, HWC_EVENT_VSYNC, 0);
806 if (hwcHasApiVersion(mHwc, HWC_DEVICE_API_VERSION_1_4)) {
807 return (status_t)mHwc->setPowerMode(mHwc, disp, mode);
809 return (status_t)mHwc->blank(mHwc, disp,
810 mode == HWC_POWER_MODE_OFF ? 1 : 0);
816 status_t HWComposer::setActiveConfig(int disp, int mode) {
817 LOG_FATAL_IF(disp >= VIRTUAL_DISPLAY_ID_BASE);
818 DisplayData& dd(mDisplayData[disp]);
819 dd.currentConfig = mode;
820 if (mHwc && hwcHasApiVersion(mHwc, HWC_DEVICE_API_VERSION_1_4)) {
821 return (status_t)mHwc->setActiveConfig(mHwc, disp, mode);
823 LOG_FATAL_IF(mode != 0);
828 void HWComposer::disconnectDisplay(int disp) {
829 LOG_ALWAYS_FATAL_IF(disp < 0 || disp == HWC_DISPLAY_PRIMARY);
830 DisplayData& dd(mDisplayData[disp]);
833 dd.framebufferTarget = NULL; // points into dd.list
834 dd.fbTargetHandle = NULL;
835 dd.outbufHandle = NULL;
836 dd.lastRetireFence = Fence::NO_FENCE;
837 dd.lastDisplayFence = Fence::NO_FENCE;
838 dd.outbufAcquireFence = Fence::NO_FENCE;
839 // clear all the previous configs and repopulate when a new
844 int HWComposer::getVisualID() const {
845 if (mHwc && hwcHasApiVersion(mHwc, HWC_DEVICE_API_VERSION_1_1)) {
846 // FIXME: temporary hack until HAL_PIXEL_FORMAT_IMPLEMENTATION_DEFINED
847 // is supported by the implementation. we can only be in this case
848 // if we have HWC 1.1
849 return HAL_PIXEL_FORMAT_RGBA_8888;
850 //return HAL_PIXEL_FORMAT_IMPLEMENTATION_DEFINED;
852 return mFbDev->format;
856 bool HWComposer::supportsFramebufferTarget() const {
857 return (mHwc && hwcHasApiVersion(mHwc, HWC_DEVICE_API_VERSION_1_1));
860 int HWComposer::fbPost(int32_t id,
861 const sp<Fence>& acquireFence, const sp<GraphicBuffer>& buffer) {
862 if (mHwc && hwcHasApiVersion(mHwc, HWC_DEVICE_API_VERSION_1_1)) {
863 return setFramebufferTarget(id, acquireFence, buffer);
865 acquireFence->waitForever("HWComposer::fbPost");
866 return mFbDev->post(mFbDev, buffer->handle);
870 int HWComposer::fbCompositionComplete() {
871 if (mHwc && hwcHasApiVersion(mHwc, HWC_DEVICE_API_VERSION_1_1))
874 if (mFbDev->compositionComplete) {
875 return mFbDev->compositionComplete(mFbDev);
877 return INVALID_OPERATION;
881 void HWComposer::fbDump(String8& result) {
882 if (mFbDev && mFbDev->common.version >= 1 && mFbDev->dump) {
883 const size_t SIZE = 4096;
885 mFbDev->dump(mFbDev, buffer, SIZE);
886 result.append(buffer);
890 status_t HWComposer::setOutputBuffer(int32_t id, const sp<Fence>& acquireFence,
891 const sp<GraphicBuffer>& buf) {
892 if (uint32_t(id)>31 || !mAllocatedDisplayIDs.hasBit(id))
894 if (id < VIRTUAL_DISPLAY_ID_BASE)
895 return INVALID_OPERATION;
897 DisplayData& disp(mDisplayData[id]);
898 disp.outbufHandle = buf->handle;
899 disp.outbufAcquireFence = acquireFence;
903 sp<Fence> HWComposer::getLastRetireFence(int32_t id) const {
904 if (uint32_t(id)>31 || !mAllocatedDisplayIDs.hasBit(id))
905 return Fence::NO_FENCE;
906 return mDisplayData[id].lastRetireFence;
909 status_t HWComposer::setCursorPositionAsync(int32_t id, const Rect& pos)
911 if (mHwc->setCursorPositionAsync) {
912 return (status_t)mHwc->setCursorPositionAsync(mHwc, id, pos.left, pos.top);
920 * Helper template to implement a concrete HWCLayer
921 * This holds the pointer to the concrete hwc layer type
922 * and implements the "iterable" side of HWCLayer.
924 template<typename CONCRETE, typename HWCTYPE>
925 class Iterable : public HWComposer::HWCLayer {
927 HWCTYPE* const mLayerList;
928 HWCTYPE* mCurrentLayer;
929 Iterable(HWCTYPE* layer) : mLayerList(layer), mCurrentLayer(layer) { }
930 inline HWCTYPE const * getLayer() const { return mCurrentLayer; }
931 inline HWCTYPE* getLayer() { return mCurrentLayer; }
932 virtual ~Iterable() { }
934 // returns a copy of ourselves
935 virtual HWComposer::HWCLayer* dup() {
936 return new CONCRETE( static_cast<const CONCRETE&>(*this) );
938 virtual status_t setLayer(size_t index) {
939 mCurrentLayer = &mLayerList[index];
945 * Concrete implementation of HWCLayer for HWC_DEVICE_API_VERSION_1_0.
946 * This implements the HWCLayer side of HWCIterableLayer.
948 class HWCLayerVersion1 : public Iterable<HWCLayerVersion1, hwc_layer_1_t> {
949 struct hwc_composer_device_1* mHwc;
951 HWCLayerVersion1(struct hwc_composer_device_1* hwc, hwc_layer_1_t* layer)
952 : Iterable<HWCLayerVersion1, hwc_layer_1_t>(layer), mHwc(hwc) { }
954 virtual int32_t getCompositionType() const {
955 return getLayer()->compositionType;
957 virtual uint32_t getHints() const {
958 return getLayer()->hints;
960 virtual sp<Fence> getAndResetReleaseFence() {
961 int fd = getLayer()->releaseFenceFd;
962 getLayer()->releaseFenceFd = -1;
963 return fd >= 0 ? new Fence(fd) : Fence::NO_FENCE;
965 virtual void setAcquireFenceFd(int fenceFd) {
966 getLayer()->acquireFenceFd = fenceFd;
968 virtual void setPerFrameDefaultState() {
969 //getLayer()->compositionType = HWC_FRAMEBUFFER;
971 virtual void setPlaneAlpha(uint8_t alpha) {
972 if (hwcHasApiVersion(mHwc, HWC_DEVICE_API_VERSION_1_2)) {
973 getLayer()->planeAlpha = alpha;
976 getLayer()->flags |= HWC_SKIP_LAYER;
980 virtual void setDefaultState() {
981 hwc_layer_1_t* const l = getLayer();
982 l->compositionType = HWC_FRAMEBUFFER;
984 l->flags = HWC_SKIP_LAYER;
987 l->blending = HWC_BLENDING_NONE;
988 l->visibleRegionScreen.numRects = 0;
989 l->visibleRegionScreen.rects = NULL;
990 l->acquireFenceFd = -1;
991 l->releaseFenceFd = -1;
992 l->planeAlpha = 0xFF;
994 virtual void setSkip(bool skip) {
996 getLayer()->flags |= HWC_SKIP_LAYER;
998 getLayer()->flags &= ~HWC_SKIP_LAYER;
1001 virtual void setIsCursorLayerHint(bool isCursor) {
1002 if (hwcHasApiVersion(mHwc, HWC_DEVICE_API_VERSION_1_4)) {
1004 getLayer()->flags |= HWC_IS_CURSOR_LAYER;
1007 getLayer()->flags &= ~HWC_IS_CURSOR_LAYER;
1011 virtual void setBlending(uint32_t blending) {
1012 getLayer()->blending = blending;
1014 virtual void setTransform(uint32_t transform) {
1015 getLayer()->transform = transform;
1017 virtual void setFrame(const Rect& frame) {
1018 getLayer()->displayFrame = reinterpret_cast<hwc_rect_t const&>(frame);
1020 virtual void setCrop(const FloatRect& crop) {
1021 if (hwcHasApiVersion(mHwc, HWC_DEVICE_API_VERSION_1_3)) {
1022 getLayer()->sourceCropf = reinterpret_cast<hwc_frect_t const&>(crop);
1025 * Since h/w composer didn't support a flot crop rect before version 1.3,
1026 * using integer coordinates instead produces a different output from the GL code in
1027 * Layer::drawWithOpenGL(). The difference can be large if the buffer crop to
1028 * window size ratio is large and a window crop is defined
1029 * (i.e.: if we scale the buffer a lot and we also crop it with a window crop).
1031 hwc_rect_t& r = getLayer()->sourceCrop;
1032 r.left = int(ceilf(crop.left));
1033 r.top = int(ceilf(crop.top));
1034 r.right = int(floorf(crop.right));
1035 r.bottom= int(floorf(crop.bottom));
1038 virtual void setVisibleRegionScreen(const Region& reg) {
1039 hwc_region_t& visibleRegion = getLayer()->visibleRegionScreen;
1040 mVisibleRegion = reg;
1041 visibleRegion.rects = reinterpret_cast<hwc_rect_t const *>(
1042 mVisibleRegion.getArray(&visibleRegion.numRects));
1044 virtual void setSurfaceDamage(const Region& reg) {
1045 if (!hwcHasApiVersion(mHwc, HWC_DEVICE_API_VERSION_1_5)) {
1048 hwc_region_t& surfaceDamage = getLayer()->surfaceDamage;
1049 // We encode default full-screen damage as INVALID_RECT upstream, but as
1050 // 0 rects for HWComposer
1051 if (reg.isRect() && reg.getBounds() == Rect::INVALID_RECT) {
1052 surfaceDamage.numRects = 0;
1053 surfaceDamage.rects = NULL;
1056 mSurfaceDamage = reg;
1057 surfaceDamage.rects = reinterpret_cast<hwc_rect_t const *>(
1058 mSurfaceDamage.getArray(&surfaceDamage.numRects));
1060 virtual void setSidebandStream(const sp<NativeHandle>& stream) {
1061 ALOG_ASSERT(stream->handle() != NULL);
1062 getLayer()->compositionType = HWC_SIDEBAND;
1063 getLayer()->sidebandStream = stream->handle();
1065 virtual void setBuffer(const sp<GraphicBuffer>& buffer) {
1066 if (buffer == 0 || buffer->handle == 0) {
1067 getLayer()->compositionType = HWC_FRAMEBUFFER;
1068 getLayer()->flags |= HWC_SKIP_LAYER;
1069 getLayer()->handle = 0;
1071 if (getLayer()->compositionType == HWC_SIDEBAND) {
1072 // If this was a sideband layer but the stream was removed, reset
1073 // it to FRAMEBUFFER. The HWC can change it to OVERLAY in prepare.
1074 getLayer()->compositionType = HWC_FRAMEBUFFER;
1076 getLayer()->handle = buffer->handle;
1079 virtual void onDisplayed() {
1080 getLayer()->acquireFenceFd = -1;
1084 // We need to hold "copies" of these for memory management purposes. The
1085 // actual hwc_layer_1_t holds pointers to the memory within. Vector<>
1086 // internally doesn't copy the memory unless one of the copies is modified.
1087 Region mVisibleRegion;
1088 Region mSurfaceDamage;
1092 * returns an iterator initialized at a given index in the layer list
1094 HWComposer::LayerListIterator HWComposer::getLayerIterator(int32_t id, size_t index) {
1095 if (uint32_t(id)>31 || !mAllocatedDisplayIDs.hasBit(id)) {
1096 return LayerListIterator();
1098 const DisplayData& disp(mDisplayData[id]);
1099 if (!mHwc || !disp.list || index > disp.list->numHwLayers) {
1100 return LayerListIterator();
1102 return LayerListIterator(new HWCLayerVersion1(mHwc, disp.list->hwLayers), index);
1106 * returns an iterator on the beginning of the layer list
1108 HWComposer::LayerListIterator HWComposer::begin(int32_t id) {
1109 return getLayerIterator(id, 0);
1113 * returns an iterator on the end of the layer list
1115 HWComposer::LayerListIterator HWComposer::end(int32_t id) {
1116 size_t numLayers = 0;
1117 if (uint32_t(id) <= 31 && mAllocatedDisplayIDs.hasBit(id)) {
1118 const DisplayData& disp(mDisplayData[id]);
1119 if (mHwc && disp.list) {
1120 numLayers = disp.list->numHwLayers;
1121 if (hwcHasApiVersion(mHwc, HWC_DEVICE_API_VERSION_1_1)) {
1122 // with HWC 1.1, the last layer is always the HWC_FRAMEBUFFER_TARGET,
1123 // which we ignore when iterating through the layer list.
1124 ALOGE_IF(!numLayers, "mDisplayData[%d].list->numHwLayers is 0", id);
1131 return getLayerIterator(id, numLayers);
1134 // Converts a PixelFormat to a human-readable string. Max 11 chars.
1135 // (Could use a table of prefab String8 objects.)
1136 static String8 getFormatStr(PixelFormat format) {
1138 case PIXEL_FORMAT_RGBA_8888: return String8("RGBA_8888");
1139 case PIXEL_FORMAT_RGBX_8888: return String8("RGBx_8888");
1140 case PIXEL_FORMAT_RGB_888: return String8("RGB_888");
1141 case PIXEL_FORMAT_RGB_565: return String8("RGB_565");
1142 case PIXEL_FORMAT_BGRA_8888: return String8("BGRA_8888");
1143 case HAL_PIXEL_FORMAT_IMPLEMENTATION_DEFINED:
1144 return String8("ImplDef");
1147 result.appendFormat("? %08x", format);
1152 void HWComposer::dump(String8& result) const {
1153 Mutex::Autolock _l(mDisplayLock);
1155 result.appendFormat("Hardware Composer state (version %08x):\n", hwcApiVersion(mHwc));
1156 result.appendFormat(" mDebugForceFakeVSync=%d\n", mDebugForceFakeVSync);
1157 for (size_t i=0 ; i<mNumDisplays ; i++) {
1158 const DisplayData& disp(mDisplayData[i]);
1159 if (!disp.connected)
1162 const Vector< sp<Layer> >& visibleLayersSortedByZ =
1163 mFlinger->getLayerSortedByZForHwcDisplay(i);
1166 result.appendFormat(" Display[%zd] configurations (* current):\n", i);
1167 for (size_t c = 0; c < disp.configs.size(); ++c) {
1168 const DisplayConfig& config(disp.configs[c]);
1169 result.appendFormat(" %s%zd: %ux%u, xdpi=%f, ydpi=%f"
1170 ", refresh=%" PRId64 ", colorTransform=%d\n",
1171 c == disp.currentConfig ? "* " : "", c,
1172 config.width, config.height, config.xdpi, config.ydpi,
1173 config.refresh, config.colorTransform);
1177 result.appendFormat(
1178 " numHwLayers=%zu, flags=%08x\n",
1179 disp.list->numHwLayers, disp.list->flags);
1182 " type | handle | hint | flag | tr | blnd | format | source crop (l,t,r,b) | frame | name \n"
1183 "-----------+----------+------+------+----+------+-------------+--------------------------------+------------------------+------\n");
1184 // " _________ | ________ | ____ | ____ | __ | ____ | ___________ |_____._,_____._,_____._,_____._ |_____,_____,_____,_____ | ___...
1185 for (size_t i=0 ; i<disp.list->numHwLayers ; i++) {
1186 const hwc_layer_1_t&l = disp.list->hwLayers[i];
1187 int32_t format = -1;
1188 String8 name("unknown");
1190 if (i < visibleLayersSortedByZ.size()) {
1191 const sp<Layer>& layer(visibleLayersSortedByZ[i]);
1192 const sp<GraphicBuffer>& buffer(
1193 layer->getActiveBuffer());
1194 if (buffer != NULL) {
1195 format = buffer->getPixelFormat();
1197 name = layer->getName();
1200 int type = l.compositionType;
1201 if (type == HWC_FRAMEBUFFER_TARGET) {
1202 name = "HWC_FRAMEBUFFER_TARGET";
1203 format = disp.format;
1206 static char const* compositionTypeName[] = {
1214 if (type >= NELEM(compositionTypeName))
1215 type = NELEM(compositionTypeName) - 1;
1217 String8 formatStr = getFormatStr(format);
1218 if (hwcHasApiVersion(mHwc, HWC_DEVICE_API_VERSION_1_3)) {
1219 result.appendFormat(
1220 " %9s | %08" PRIxPTR " | %04x | %04x | %02x | %04x | %-11s |%7.1f,%7.1f,%7.1f,%7.1f |%5d,%5d,%5d,%5d | %s\n",
1221 compositionTypeName[type],
1222 intptr_t(l.handle), l.hints, l.flags, l.transform, l.blending, formatStr.string(),
1223 l.sourceCropf.left, l.sourceCropf.top, l.sourceCropf.right, l.sourceCropf.bottom,
1224 l.displayFrame.left, l.displayFrame.top, l.displayFrame.right, l.displayFrame.bottom,
1227 result.appendFormat(
1228 " %9s | %08" PRIxPTR " | %04x | %04x | %02x | %04x | %-11s |%7d,%7d,%7d,%7d |%5d,%5d,%5d,%5d | %s\n",
1229 compositionTypeName[type],
1230 intptr_t(l.handle), l.hints, l.flags, l.transform, l.blending, formatStr.string(),
1231 l.sourceCrop.left, l.sourceCrop.top, l.sourceCrop.right, l.sourceCrop.bottom,
1232 l.displayFrame.left, l.displayFrame.top, l.displayFrame.right, l.displayFrame.bottom,
1240 if (mHwc && mHwc->dump) {
1241 const size_t SIZE = 4096;
1243 mHwc->dump(mHwc, buffer, SIZE);
1244 result.append(buffer);
1248 // ---------------------------------------------------------------------------
1250 HWComposer::VSyncThread::VSyncThread(HWComposer& hwc)
1251 : mHwc(hwc), mEnabled(false),
1253 mRefreshPeriod(hwc.getRefreshPeriod(HWC_DISPLAY_PRIMARY))
1257 void HWComposer::VSyncThread::setEnabled(bool enabled) {
1258 Mutex::Autolock _l(mLock);
1259 if (mEnabled != enabled) {
1261 mCondition.signal();
1265 void HWComposer::VSyncThread::onFirstRef() {
1266 run("VSyncThread", PRIORITY_URGENT_DISPLAY + PRIORITY_MORE_FAVORABLE);
1269 bool HWComposer::VSyncThread::threadLoop() {
1271 Mutex::Autolock _l(mLock);
1273 mCondition.wait(mLock);
1277 const nsecs_t period = mRefreshPeriod;
1278 const nsecs_t now = systemTime(CLOCK_MONOTONIC);
1279 nsecs_t next_vsync = mNextFakeVSync;
1280 nsecs_t sleep = next_vsync - now;
1282 // we missed, find where the next vsync should be
1283 sleep = (period - ((now - next_vsync) % period));
1284 next_vsync = now + sleep;
1286 mNextFakeVSync = next_vsync + period;
1288 struct timespec spec;
1289 spec.tv_sec = next_vsync / 1000000000;
1290 spec.tv_nsec = next_vsync % 1000000000;
1294 err = clock_nanosleep(CLOCK_MONOTONIC, TIMER_ABSTIME, &spec, NULL);
1295 } while (err<0 && errno == EINTR);
1298 mHwc.mEventHandler.onVSyncReceived(0, next_vsync);
1304 HWComposer::DisplayData::DisplayData()
1307 format(HAL_PIXEL_FORMAT_RGBA_8888),
1309 hasFbComp(false), hasOvComp(false),
1310 capacity(0), list(NULL),
1311 framebufferTarget(NULL), fbTargetHandle(0),
1312 lastRetireFence(Fence::NO_FENCE), lastDisplayFence(Fence::NO_FENCE),
1313 outbufHandle(NULL), outbufAcquireFence(Fence::NO_FENCE),
1317 HWComposer::DisplayData::~DisplayData() {
1321 // ---------------------------------------------------------------------------
1322 }; // namespace android