2 * Copyright (C) 2015 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 LOG_TAG "hwc-drm-display-composition"
19 #include "drmdisplaycomposition.h"
20 #include "drmdisplaycompositor.h"
23 #include "drmresources.h"
29 #include <unordered_set>
33 #include <sync/sync.h>
34 #include <xf86drmMode.h>
38 DrmDisplayComposition::~DrmDisplayComposition() {
39 if (timeline_fd_ >= 0) {
40 SignalCompositionDone();
45 int DrmDisplayComposition::Init(DrmResources *drm, DrmCrtc *crtc,
46 Importer *importer, Planner *planner,
49 crtc_ = crtc; // Can be NULL if we haven't modeset yet
54 int ret = sw_sync_timeline_create();
56 ALOGE("Failed to create sw sync timeline %d", ret);
63 bool DrmDisplayComposition::validate_composition_type(DrmCompositionType des) {
64 return type_ == DRM_COMPOSITION_TYPE_EMPTY || type_ == des;
67 int DrmDisplayComposition::CreateNextTimelineFence() {
69 return sw_sync_fence_create(timeline_fd_, "hwc drm display composition fence",
73 int DrmDisplayComposition::IncreaseTimelineToPoint(int point) {
74 int timeline_increase = point - timeline_current_;
75 if (timeline_increase <= 0)
78 int ret = sw_sync_timeline_inc(timeline_fd_, timeline_increase);
80 ALOGE("Failed to increment sync timeline %d", ret);
82 timeline_current_ = point;
87 int DrmDisplayComposition::SetLayers(DrmHwcLayer *layers, size_t num_layers,
88 bool geometry_changed) {
89 if (!validate_composition_type(DRM_COMPOSITION_TYPE_FRAME))
92 geometry_changed_ = geometry_changed;
94 for (size_t layer_index = 0; layer_index < num_layers; layer_index++) {
95 layers_.emplace_back(std::move(layers[layer_index]));
98 type_ = DRM_COMPOSITION_TYPE_FRAME;
102 int DrmDisplayComposition::SetDpmsMode(uint32_t dpms_mode) {
103 if (!validate_composition_type(DRM_COMPOSITION_TYPE_DPMS))
105 dpms_mode_ = dpms_mode;
106 type_ = DRM_COMPOSITION_TYPE_DPMS;
110 int DrmDisplayComposition::SetDisplayMode(const DrmMode &display_mode) {
111 if (!validate_composition_type(DRM_COMPOSITION_TYPE_MODESET))
113 display_mode_ = display_mode;
114 dpms_mode_ = DRM_MODE_DPMS_ON;
115 type_ = DRM_COMPOSITION_TYPE_MODESET;
119 int DrmDisplayComposition::AddPlaneDisable(DrmPlane *plane) {
120 composition_planes_.emplace_back(DrmCompositionPlane::Type::kDisable, plane,
125 static std::vector<size_t> SetBitsToVector(
126 uint64_t in, const std::vector<size_t> &index_map) {
127 std::vector<size_t> out;
128 size_t msb = sizeof(in) * 8 - 1;
129 uint64_t mask = (uint64_t)1 << msb;
130 for (size_t i = msb; mask != (uint64_t)0; i--, mask >>= 1)
132 out.push_back(index_map[i]);
136 int DrmDisplayComposition::AddPlaneComposition(DrmCompositionPlane plane) {
137 composition_planes_.emplace_back(std::move(plane));
141 void DrmDisplayComposition::SeparateLayers(DrmHwcRect<int> *exclude_rects,
142 size_t num_exclude_rects) {
143 DrmCompositionPlane *comp = NULL;
144 std::vector<size_t> dedicated_layers;
146 // Go through the composition and find the precomp layer as well as any
147 // layers that have a dedicated plane located below the precomp layer.
148 for (auto &i : composition_planes_) {
149 if (i.type() == DrmCompositionPlane::Type::kLayer) {
150 dedicated_layers.insert(dedicated_layers.end(), i.source_layers().begin(),
151 i.source_layers().end());
152 } else if (i.type() == DrmCompositionPlane::Type::kPrecomp) {
160 const std::vector<size_t> &comp_layers = comp->source_layers();
161 if (comp_layers.size() > 64) {
162 ALOGE("Failed to separate layers because there are more than 64");
166 // Index at which the actual layers begin
167 size_t layer_offset = num_exclude_rects + dedicated_layers.size();
168 if (comp_layers.size() + layer_offset > 64) {
170 "Exclusion rectangles are being truncated to make the rectangle count "
172 num_exclude_rects = 64 - comp_layers.size() - dedicated_layers.size();
175 // We inject all the exclude rects into the rects list. Any resulting rect
176 // that includes ANY of the first num_exclude_rects is rejected. After the
177 // exclude rects, we add the lower layers. The rects that intersect with
178 // these layers will be inspected and only those which are to be composited
179 // above the layer will be included in the composition regions.
180 std::vector<DrmHwcRect<int>> layer_rects(comp_layers.size() + layer_offset);
181 std::copy(exclude_rects, exclude_rects + num_exclude_rects,
182 layer_rects.begin());
184 dedicated_layers.begin(), dedicated_layers.end(),
185 layer_rects.begin() + num_exclude_rects,
186 [=](size_t layer_index) { return layers_[layer_index].display_frame; });
187 std::transform(comp_layers.begin(), comp_layers.end(),
188 layer_rects.begin() + layer_offset, [=](size_t layer_index) {
189 return layers_[layer_index].display_frame;
192 std::vector<separate_rects::RectSet<uint64_t, int>> separate_regions;
193 separate_rects::separate_rects_64(layer_rects, &separate_regions);
194 uint64_t exclude_mask = ((uint64_t)1 << num_exclude_rects) - 1;
195 uint64_t dedicated_mask = (((uint64_t)1 << dedicated_layers.size()) - 1)
196 << num_exclude_rects;
198 for (separate_rects::RectSet<uint64_t, int> ®ion : separate_regions) {
199 if (region.id_set.getBits() & exclude_mask)
202 // If a rect intersects one of the dedicated layers, we need to remove the
203 // layers from the composition region which appear *below* the dedicated
204 // layer. This effectively punches a hole through the composition layer such
205 // that the dedicated layer can be placed below the composition and not
207 uint64_t dedicated_intersect = region.id_set.getBits() & dedicated_mask;
208 for (size_t i = 0; dedicated_intersect && i < dedicated_layers.size();
210 // Only exclude layers if they intersect this particular dedicated layer
211 if (!(dedicated_intersect & (1 << (i + num_exclude_rects))))
214 for (size_t j = 0; j < comp_layers.size(); ++j) {
215 if (comp_layers[j] < dedicated_layers[i])
216 region.id_set.subtract(j + layer_offset);
219 if (!(region.id_set.getBits() >> layer_offset))
222 pre_comp_regions_.emplace_back(DrmCompositionRegion{
224 SetBitsToVector(region.id_set.getBits() >> layer_offset, comp_layers)});
228 int DrmDisplayComposition::CreateAndAssignReleaseFences() {
229 std::unordered_set<DrmHwcLayer *> squash_layers;
230 std::unordered_set<DrmHwcLayer *> pre_comp_layers;
231 std::unordered_set<DrmHwcLayer *> comp_layers;
233 for (const DrmCompositionRegion ®ion : squash_regions_) {
234 for (size_t source_layer_index : region.source_layers) {
235 DrmHwcLayer *source_layer = &layers_[source_layer_index];
236 squash_layers.emplace(source_layer);
240 for (const DrmCompositionRegion ®ion : pre_comp_regions_) {
241 for (size_t source_layer_index : region.source_layers) {
242 DrmHwcLayer *source_layer = &layers_[source_layer_index];
243 pre_comp_layers.emplace(source_layer);
244 squash_layers.erase(source_layer);
248 for (const DrmCompositionPlane &plane : composition_planes_) {
249 if (plane.type() == DrmCompositionPlane::Type::kLayer) {
250 for (auto i : plane.source_layers()) {
251 DrmHwcLayer *source_layer = &layers_[i];
252 comp_layers.emplace(source_layer);
253 pre_comp_layers.erase(source_layer);
258 for (DrmHwcLayer *layer : squash_layers) {
259 if (!layer->release_fence)
261 int ret = layer->release_fence.Set(CreateNextTimelineFence());
263 ALOGE("Failed to set the release fence (squash) %d", ret);
267 timeline_squash_done_ = timeline_;
269 for (DrmHwcLayer *layer : pre_comp_layers) {
270 if (!layer->release_fence)
272 int ret = layer->release_fence.Set(CreateNextTimelineFence());
276 timeline_pre_comp_done_ = timeline_;
278 for (DrmHwcLayer *layer : comp_layers) {
279 if (!layer->release_fence)
281 int ret = layer->release_fence.Set(CreateNextTimelineFence());
283 ALOGE("Failed to set the release fence (comp) %d", ret);
291 int DrmDisplayComposition::Plan(SquashState *squash,
292 std::vector<DrmPlane *> *primary_planes,
293 std::vector<DrmPlane *> *overlay_planes) {
294 if (type_ != DRM_COMPOSITION_TYPE_FRAME)
297 // Used to track which layers should be sent to the planner. We exclude layers
298 // that are entirely squashed so the planner can provision a precomposition
299 // layer as appropriate (ex: if 5 layers are squashed and 1 is not, we don't
300 // want to plan a precomposition layer that will be comprised of the already
302 std::map<size_t, DrmHwcLayer *> to_composite;
304 bool use_squash_framebuffer = false;
305 // Used to determine which layers were entirely squashed
306 std::vector<int> layer_squash_area(layers_.size(), 0);
307 // Used to avoid rerendering regions that were squashed
308 std::vector<DrmHwcRect<int>> exclude_rects;
309 if (squash != NULL) {
310 if (geometry_changed_) {
311 squash->Init(layers_.data(), layers_.size());
313 std::vector<bool> changed_regions;
314 squash->GenerateHistory(layers_.data(), layers_.size(), changed_regions);
316 std::vector<bool> stable_regions;
317 squash->StableRegionsWithMarginalHistory(changed_regions, stable_regions);
319 // Only if SOME region is stable
320 use_squash_framebuffer =
321 std::find(stable_regions.begin(), stable_regions.end(), true) !=
322 stable_regions.end();
324 squash->RecordHistory(layers_.data(), layers_.size(), changed_regions);
326 // Changes in which regions are squashed triggers a rerender via
328 bool render_squash = squash->RecordAndCompareSquashed(stable_regions);
330 for (size_t region_index = 0; region_index < stable_regions.size();
332 const SquashState::Region ®ion = squash->regions()[region_index];
333 if (!stable_regions[region_index])
336 exclude_rects.emplace_back(region.rect);
339 squash_regions_.emplace_back();
340 squash_regions_.back().frame = region.rect;
343 int frame_area = region.rect.area();
344 // Source layers are sorted front to back i.e. top layer has lowest
346 for (size_t layer_index = layers_.size();
347 layer_index-- > 0; // Yes, I double checked this
348 /* See condition */) {
349 if (!region.layer_refs[layer_index])
351 layer_squash_area[layer_index] += frame_area;
353 squash_regions_.back().source_layers.push_back(layer_index);
358 for (size_t i = 0; i < layers_.size(); ++i) {
359 if (layer_squash_area[i] < layers_[i].display_frame.area())
360 to_composite.emplace(std::make_pair(i, &layers_[i]));
363 for (size_t i = 0; i < layers_.size(); ++i)
364 to_composite.emplace(std::make_pair(i, &layers_[i]));
368 std::vector<DrmCompositionPlane> plan;
369 std::tie(ret, composition_planes_) =
370 planner_->ProvisionPlanes(to_composite, use_squash_framebuffer, crtc_,
371 primary_planes, overlay_planes);
373 ALOGE("Planner failed provisioning planes ret=%d", ret);
377 // Remove the planes we used from the pool before returning. This ensures they
378 // won't be reused by another display in the composition.
379 for (auto &i : composition_planes_) {
383 // make sure that source layers are ordered based on zorder
384 std::sort(i.source_layers().begin(), i.source_layers().end());
386 std::vector<DrmPlane *> *container;
387 if (i.plane()->type() == DRM_PLANE_TYPE_PRIMARY)
388 container = primary_planes;
390 container = overlay_planes;
391 for (auto j = container->begin(); j != container->end(); ++j) {
392 if (*j == i.plane()) {
399 return FinalizeComposition(exclude_rects.data(), exclude_rects.size());
402 int DrmDisplayComposition::FinalizeComposition() {
403 return FinalizeComposition(NULL, 0);
406 int DrmDisplayComposition::FinalizeComposition(DrmHwcRect<int> *exclude_rects,
407 size_t num_exclude_rects) {
408 SeparateLayers(exclude_rects, num_exclude_rects);
409 return CreateAndAssignReleaseFences();
412 static const char *DrmCompositionTypeToString(DrmCompositionType type) {
414 case DRM_COMPOSITION_TYPE_EMPTY:
416 case DRM_COMPOSITION_TYPE_FRAME:
418 case DRM_COMPOSITION_TYPE_DPMS:
420 case DRM_COMPOSITION_TYPE_MODESET:
427 static const char *DPMSModeToString(int dpms_mode) {
429 case DRM_MODE_DPMS_ON:
431 case DRM_MODE_DPMS_OFF:
438 static void DumpBuffer(const DrmHwcBuffer &buffer, std::ostringstream *out) {
440 *out << "buffer=<invalid>";
444 *out << "buffer[w/h/format]=";
445 *out << buffer->width << "/" << buffer->height << "/" << buffer->format;
448 static void DumpTransform(uint32_t transform, std::ostringstream *out) {
454 bool separator = false;
455 if (transform & DrmHwcTransform::kFlipH) {
459 if (transform & DrmHwcTransform::kFlipV) {
465 if (transform & DrmHwcTransform::kRotate90) {
471 if (transform & DrmHwcTransform::kRotate180) {
477 if (transform & DrmHwcTransform::kRotate270) {
484 uint32_t valid_bits = DrmHwcTransform::kFlipH | DrmHwcTransform::kFlipH |
485 DrmHwcTransform::kRotate90 |
486 DrmHwcTransform::kRotate180 |
487 DrmHwcTransform::kRotate270;
488 if (transform & ~valid_bits) {
496 static const char *BlendingToString(DrmHwcBlending blending) {
498 case DrmHwcBlending::kNone:
500 case DrmHwcBlending::kPreMult:
502 case DrmHwcBlending::kCoverage:
509 static void DumpRegion(const DrmCompositionRegion ®ion,
510 std::ostringstream *out) {
512 region.frame.Dump(out);
513 *out << " source_layers=(";
515 const std::vector<size_t> &source_layers = region.source_layers;
516 for (size_t i = 0; i < source_layers.size(); i++) {
517 *out << source_layers[i];
518 if (i < source_layers.size() - 1) {
526 void DrmDisplayComposition::Dump(std::ostringstream *out) const {
527 *out << "----DrmDisplayComposition"
528 << " crtc=" << (crtc_ ? crtc_->id() : -1)
529 << " type=" << DrmCompositionTypeToString(type_);
532 case DRM_COMPOSITION_TYPE_DPMS:
533 *out << " dpms_mode=" << DPMSModeToString(dpms_mode_);
535 case DRM_COMPOSITION_TYPE_MODESET:
536 *out << " display_mode=" << display_mode_.h_display() << "x"
537 << display_mode_.v_display();
543 *out << " timeline[current/squash/pre-comp/done]=" << timeline_current_ << "/"
544 << timeline_squash_done_ << "/" << timeline_pre_comp_done_ << "/"
545 << timeline_ << "\n";
547 *out << " Layers: count=" << layers_.size() << "\n";
548 for (size_t i = 0; i < layers_.size(); i++) {
549 const DrmHwcLayer &layer = layers_[i];
550 *out << " [" << i << "] ";
552 DumpBuffer(layer.buffer, out);
554 if (layer.protected_usage())
555 *out << " protected";
557 *out << " transform=";
558 DumpTransform(layer.transform, out);
559 *out << " blending[a=" << (int)layer.alpha
560 << "]=" << BlendingToString(layer.blending) << " source_crop";
561 layer.source_crop.Dump(out);
562 *out << " display_frame";
563 layer.display_frame.Dump(out);
568 *out << " Planes: count=" << composition_planes_.size() << "\n";
569 for (size_t i = 0; i < composition_planes_.size(); i++) {
570 const DrmCompositionPlane &comp_plane = composition_planes_[i];
571 *out << " [" << i << "]"
572 << " plane=" << (comp_plane.plane() ? comp_plane.plane()->id() : -1)
574 switch (comp_plane.type()) {
575 case DrmCompositionPlane::Type::kDisable:
578 case DrmCompositionPlane::Type::kLayer:
581 case DrmCompositionPlane::Type::kPrecomp:
584 case DrmCompositionPlane::Type::kSquash:
592 *out << " source_layer=";
593 for (auto i : comp_plane.source_layers()) {
599 *out << " Squash Regions: count=" << squash_regions_.size() << "\n";
600 for (size_t i = 0; i < squash_regions_.size(); i++) {
601 *out << " [" << i << "] ";
602 DumpRegion(squash_regions_[i], out);
606 *out << " Pre-Comp Regions: count=" << pre_comp_regions_.size() << "\n";
607 for (size_t i = 0; i < pre_comp_regions_.size(); i++) {
608 *out << " [" << i << "] ";
609 DumpRegion(pre_comp_regions_[i], out);