Home | History | Annotate | Download | only in libhwcomposer 
      1 /*
      2  * Copyright (C) 2010 The Android Open Source Project
      3  * Copyright (C)2012-2013, The Linux Foundation. All rights reserved.
      4  *
      5  * Not a Contribution, Apache license notifications and license are retained
      6  * for attribution purposes only.
      7  *
      8  * Licensed under the Apache License, Version 2.0 (the "License");
      9  * you may not use this file except in compliance with the License.
     10  * You may obtain a copy of the License at
     11  *
     12  *      http://www.apache.org/licenses/LICENSE-2.0
     13  *
     14  * Unless required by applicable law or agreed to in writing, software
     15  * distributed under the License is distributed on an "AS IS" BASIS,
     16  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
     17  * See the License for the specific language governing permissions and
     18  * limitations under the License.
     19  */
     20 
     21 #ifndef HWC_UTILS_H
     22 #define HWC_UTILS_H
     23 
     24 #define HWC_REMOVE_DEPRECATED_VERSIONS 1
     25 #include <fcntl.h>
     26 #include <math.h>
     27 #include <hardware/hwcomposer.h>
     28 #include <gr.h>
     29 #include <gralloc_priv.h>
     30 #include <utils/String8.h>
     31 #include <linux/fb.h>
     32 #include "qdMetaData.h"
     33 #include <overlayUtils.h>
     34 
     35 #define ALIGN_TO(x, align)     (((x) + ((align)-1)) & ~((align)-1))
     36 #define LIKELY( exp )       (__builtin_expect( (exp) != 0, true  ))
     37 #define UNLIKELY( exp )     (__builtin_expect( (exp) != 0, false ))
     38 #define MAX_NUM_APP_LAYERS 32
     39 
     40 // For support of virtual displays
     41 #define MAX_DISPLAYS            (HWC_NUM_DISPLAY_TYPES)
     42 
     43 //Fwrd decls
     44 struct hwc_context_t;
     45 
     46 namespace ovutils = overlay::utils;
     47 
     48 namespace overlay {
     49 class Overlay;
     50 class Rotator;
     51 class RotMgr;
     52 }
     53 
     54 namespace qhwc {
     55 //fwrd decl
     56 class QueuedBufferStore;
     57 class ExternalDisplay;
     58 class IFBUpdate;
     59 class IVideoOverlay;
     60 class MDPComp;
     61 class CopyBit;
     62 class AssertiveDisplay;
     63 
     64 
     65 struct MDPInfo {
     66     int version;
     67     char panel;
     68     bool hasOverlay;
     69 };
     70 
     71 struct DisplayAttributes {
     72     uint32_t vsync_period; //nanos
     73     uint32_t xres;
     74     uint32_t yres;
     75     uint32_t stride;
     76     float xdpi;
     77     float ydpi;
     78     int fd;
     79     bool connected; //Applies only to secondary displays
     80     //Connected does not mean it ready to use.
     81     //It should be active also. (UNBLANKED)
     82     bool isActive;
     83     // In pause state, composition is bypassed
     84     // used for WFD displays only
     85     bool isPause;
     86     //Secondary displays will have this set until they are able to acquire
     87     //pipes.
     88     bool isConfiguring;
     89 };
     90 
     91 struct ListStats {
     92     int numAppLayers; //Total - 1, excluding FB layer.
     93     int skipCount;
     94     int fbLayerIndex; //Always last for now. = numAppLayers
     95     //Video specific
     96     int yuvCount;
     97     int yuvIndices[MAX_NUM_APP_LAYERS];
     98     bool needsAlphaScale;
     99     bool preMultipliedAlpha;
    100     bool planeAlpha;
    101     bool isSecurePresent;
    102 };
    103 
    104 struct LayerProp {
    105     uint32_t mFlags; //qcom specific layer flags
    106     LayerProp():mFlags(0) {};
    107 };
    108 
    109 struct VsyncState {
    110     bool enable;
    111     bool fakevsync;
    112 };
    113 
    114 struct BwcPM {
    115     static void setBwc(hwc_context_t *ctx, const hwc_rect_t& crop,
    116             const hwc_rect_t& dst, const int& transform,
    117             ovutils::eMdpFlags& mdpFlags);
    118 };
    119 
    120 // LayerProp::flag values
    121 enum {
    122     HWC_MDPCOMP = 0x00000001,
    123     HWC_COPYBIT = 0x00000002,
    124 };
    125 
    126 class LayerRotMap {
    127 public:
    128     LayerRotMap() { reset(); }
    129     enum { MAX_SESS = 3 };
    130     void add(hwc_layer_1_t* layer, overlay::Rotator *rot);
    131     void reset();
    132     uint32_t getCount() const;
    133     hwc_layer_1_t* getLayer(uint32_t index) const;
    134     overlay::Rotator* getRot(uint32_t index) const;
    135     void setReleaseFd(const int& fence);
    136 private:
    137     hwc_layer_1_t* mLayer[MAX_SESS];
    138     overlay::Rotator* mRot[MAX_SESS];
    139     uint32_t mCount;
    140 };
    141 
    142 inline uint32_t LayerRotMap::getCount() const {
    143     return mCount;
    144 }
    145 
    146 inline hwc_layer_1_t* LayerRotMap::getLayer(uint32_t index) const {
    147     if(index >= mCount) return NULL;
    148     return mLayer[index];
    149 }
    150 
    151 inline overlay::Rotator* LayerRotMap::getRot(uint32_t index) const {
    152     if(index >= mCount) return NULL;
    153     return mRot[index];
    154 }
    155 
    156 inline hwc_rect_t integerizeSourceCrop(const hwc_frect_t& cropF) {
    157     hwc_rect_t cropI = {0};
    158     cropI.left = int(ceilf(cropF.left));
    159     cropI.top = int(ceilf(cropF.top));
    160     cropI.right = int(floorf(cropF.right));
    161     cropI.bottom = int(floorf(cropF.bottom));
    162     return cropI;
    163 }
    164 
    165 inline bool isNonIntegralSourceCrop(const hwc_frect_t& cropF) {
    166     if(cropF.left - roundf(cropF.left)     ||
    167        cropF.top - roundf(cropF.top)       ||
    168        cropF.right - roundf(cropF.right)   ||
    169        cropF.bottom - roundf(cropF.bottom))
    170         return true;
    171     else
    172         return false;
    173 }
    174 
    175 // -----------------------------------------------------------------------------
    176 // Utility functions - implemented in hwc_utils.cpp
    177 void dumpLayer(hwc_layer_1_t const* l);
    178 void setListStats(hwc_context_t *ctx, const hwc_display_contents_1_t *list,
    179         int dpy);
    180 void initContext(hwc_context_t *ctx);
    181 void closeContext(hwc_context_t *ctx);
    182 //Crops source buffer against destination and FB boundaries
    183 void calculate_crop_rects(hwc_rect_t& crop, hwc_rect_t& dst,
    184                          const hwc_rect_t& scissor, int orient);
    185 void getNonWormholeRegion(hwc_display_contents_1_t* list,
    186                               hwc_rect_t& nwr);
    187 bool isSecuring(hwc_context_t* ctx, hwc_layer_1_t const* layer);
    188 bool isSecureModePolicy(int mdpVersion);
    189 bool needsScaling(hwc_context_t* ctx, hwc_layer_1_t const* layer, const int& dpy);
    190 bool isAlphaPresent(hwc_layer_1_t const* layer);
    191 int hwc_vsync_control(hwc_context_t* ctx, int dpy, int enable);
    192 int getBlending(int blending);
    193 bool isGLESOnlyComp(hwc_context_t *ctx, const int& dpy);
    194 
    195 //Helper function to dump logs
    196 void dumpsys_log(android::String8& buf, const char* fmt, ...);
    197 
    198 /* Calculates the destination position based on the action safe rectangle */
    199 void getActionSafePosition(hwc_context_t *ctx, int dpy, uint32_t& x,
    200                                         uint32_t& y, uint32_t& w, uint32_t& h);
    201 
    202 //Close acquireFenceFds of all layers of incoming list
    203 void closeAcquireFds(hwc_display_contents_1_t* list, int dpy);
    204 
    205 //Sync point impl.
    206 int hwc_sync(hwc_context_t *ctx, hwc_display_contents_1_t* list, int dpy,
    207         int fd);
    208 
    209 //Trims a layer's source crop which is outside of screen boundary.
    210 void trimLayer(hwc_context_t *ctx, const int& dpy, const int& transform,
    211         hwc_rect_t& crop, hwc_rect_t& dst);
    212 
    213 //Sets appropriate mdp flags for a layer.
    214 void setMdpFlags(hwc_layer_1_t *layer,
    215         ovutils::eMdpFlags &mdpFlags,
    216         int rotDownscale);
    217 
    218 int configRotator(overlay::Rotator *rot, const ovutils::Whf& whf,
    219         hwc_rect_t& crop, const ovutils::eMdpFlags& mdpFlags,
    220         const ovutils::eTransform& orient, const int& downscale);
    221 
    222 int configMdp(overlay::Overlay *ov, const ovutils::PipeArgs& parg,
    223         const ovutils::eTransform& orient, const hwc_rect_t& crop,
    224         const hwc_rect_t& pos, const MetaData_t *metadata,
    225         const ovutils::eDest& dest);
    226 
    227 void updateSource(ovutils::eTransform& orient, ovutils::Whf& whf,
    228         hwc_rect_t& crop);
    229 
    230 //Routine to configure low resolution panels (<= 2048 width)
    231 int configureLowRes(hwc_context_t *ctx, hwc_layer_1_t *layer, const int& dpy,
    232         ovutils::eMdpFlags& mdpFlags, const ovutils::eZorder& z,
    233         const ovutils::eIsFg& isFg, const ovutils::eDest& dest,
    234         overlay::Rotator **rot);
    235 
    236 //Routine to configure high resolution panels (> 2048 width)
    237 int configureHighRes(hwc_context_t *ctx, hwc_layer_1_t *layer, const int& dpy,
    238         ovutils::eMdpFlags& mdpFlags, const ovutils::eZorder& z,
    239         const ovutils::eIsFg& isFg, const ovutils::eDest& lDest,
    240         const ovutils::eDest& rDest, overlay::Rotator **rot);
    241 
    242 //On certain targets DMA pipes are used for rotation and they won't be available
    243 //for line operations. On a per-target basis we can restrict certain use cases
    244 //from using rotator, since we know before-hand that such scenarios can lead to
    245 //extreme unavailability of pipes. This can also be done via hybrid calculations
    246 //also involving many more variables like number of write-back interfaces etc,
    247 //but the variety of scenarios is too high to warrant that.
    248 bool canUseRotator(hwc_context_t *ctx, int dpy);
    249 
    250 int getLeftSplit(hwc_context_t *ctx, const int& dpy);
    251 
    252 //Sets up composition objects for secondary displays when they are added.
    253 //Should be called with extlock held.
    254 void setupSecondaryObjs(hwc_context_t *ctx, const int& dpy);
    255 void clearSecondaryObjs(hwc_context_t *ctx, const int& dpy);
    256 
    257 // Inline utility functions
    258 static inline bool isSkipLayer(const hwc_layer_1_t* l) {
    259     return (UNLIKELY(l && (l->flags & HWC_SKIP_LAYER)));
    260 }
    261 
    262 // Returns true if the buffer is yuv
    263 static inline bool isYuvBuffer(const private_handle_t* hnd) {
    264     return (hnd && (hnd->bufferType == BUFFER_TYPE_VIDEO));
    265 }
    266 
    267 // Returns true if the buffer is secure
    268 static inline bool isSecureBuffer(const private_handle_t* hnd) {
    269     return (hnd && (private_handle_t::PRIV_FLAGS_SECURE_BUFFER & hnd->flags));
    270 }
    271 
    272 // Returns true if the buffer is marked for L3 DRM
    273 static inline bool isL3SecureBuffer(const private_handle_t* hnd) {
    274     return (hnd &&
    275             (private_handle_t::PRIV_FLAGS_L3_SECURE_BUFFER & hnd->flags));
    276 }
    277 //Return true if buffer is marked locked
    278 static inline bool isBufferLocked(const private_handle_t* hnd) {
    279     return (hnd && (private_handle_t::PRIV_FLAGS_HWC_LOCK & hnd->flags));
    280 }
    281 
    282 //Return true if buffer is for external display only
    283 static inline bool isExtOnly(const private_handle_t* hnd) {
    284     return (hnd && (hnd->flags & private_handle_t::PRIV_FLAGS_EXTERNAL_ONLY));
    285 }
    286 
    287 //Return true if buffer is for external display only with a BLOCK flag.
    288 static inline bool isExtBlock(const private_handle_t* hnd) {
    289     return (hnd && (hnd->flags & private_handle_t::PRIV_FLAGS_EXTERNAL_BLOCK));
    290 }
    291 
    292 //Return true if buffer is for external display only with a Close Caption flag.
    293 static inline bool isExtCC(const private_handle_t* hnd) {
    294     return (hnd && (hnd->flags & private_handle_t::PRIV_FLAGS_EXTERNAL_CC));
    295 }
    296 
    297 static inline int getWidth(const private_handle_t* hnd) {
    298     if(isYuvBuffer(hnd)) {
    299         MetaData_t *metadata = (MetaData_t *)hnd->base_metadata;
    300         if(metadata && metadata->operation & UPDATE_BUFFER_GEOMETRY) {
    301             return metadata->bufferDim.sliceWidth;
    302         }
    303     }
    304     return hnd->width;
    305 }
    306 
    307 static inline int getHeight(const private_handle_t* hnd) {
    308     if(isYuvBuffer(hnd)) {
    309         MetaData_t *metadata = (MetaData_t *)hnd->base_metadata;
    310         if(metadata && metadata->operation & UPDATE_BUFFER_GEOMETRY) {
    311             return metadata->bufferDim.sliceHeight;
    312         }
    313     }
    314     return hnd->height;
    315 }
    316 
    317 template<typename T> inline T max(T a, T b) { return (a > b) ? a : b; }
    318 template<typename T> inline T min(T a, T b) { return (a < b) ? a : b; }
    319 
    320 // Initialize uevent thread
    321 void init_uevent_thread(hwc_context_t* ctx);
    322 // Initialize vsync thread
    323 void init_vsync_thread(hwc_context_t* ctx);
    324 
    325 inline void getLayerResolution(const hwc_layer_1_t* layer,
    326                                int& width, int& height) {
    327     hwc_rect_t displayFrame  = layer->displayFrame;
    328     width = displayFrame.right - displayFrame.left;
    329     height = displayFrame.bottom - displayFrame.top;
    330 }
    331 
    332 static inline int openFb(int dpy) {
    333     int fd = -1;
    334     const char *devtmpl = "/dev/graphics/fb%u";
    335     char name[64] = {0};
    336     snprintf(name, 64, devtmpl, dpy);
    337     fd = open(name, O_RDWR);
    338     return fd;
    339 }
    340 
    341 template <class T>
    342 inline void swap(T& a, T& b) {
    343     T tmp = a;
    344     a = b;
    345     b = tmp;
    346 }
    347 
    348 }; //qhwc namespace
    349 
    350 // -----------------------------------------------------------------------------
    351 // HWC context
    352 // This structure contains overall state
    353 struct hwc_context_t {
    354     hwc_composer_device_1_t device;
    355     const hwc_procs_t* proc;
    356 
    357     //CopyBit objects
    358     qhwc::CopyBit *mCopyBit[MAX_DISPLAYS];
    359 
    360     //Overlay object - NULL for non overlay devices
    361     overlay::Overlay *mOverlay;
    362     //Holds a few rot objects
    363     overlay::RotMgr *mRotMgr;
    364 
    365     //Primary and external FB updater
    366     qhwc::IFBUpdate *mFBUpdate[MAX_DISPLAYS];
    367     // External display related information
    368     qhwc::ExternalDisplay *mExtDisplay;
    369     qhwc::MDPInfo mMDP;
    370     qhwc::VsyncState vstate;
    371     qhwc::DisplayAttributes dpyAttr[MAX_DISPLAYS];
    372     qhwc::ListStats listStats[MAX_DISPLAYS];
    373     qhwc::LayerProp *layerProp[MAX_DISPLAYS];
    374     qhwc::LayerRotMap *mLayerRotMap[MAX_DISPLAYS];
    375     qhwc::MDPComp *mMDPComp[MAX_DISPLAYS];
    376     qhwc::AssertiveDisplay *mAD;
    377 
    378     //Securing in progress indicator
    379     bool mSecuring;
    380     //Display in secure mode indicator
    381     bool mSecureMode;
    382     //Lock to protect drawing data structures
    383     mutable Locker mDrawLock;
    384     //Drawing round when we use GPU
    385     bool isPaddingRound;
    386     //Flags the transition of a video session
    387     bool mVideoTransFlag;
    388 };
    389 
    390 namespace qhwc {
    391 static inline bool isSkipPresent (hwc_context_t *ctx, int dpy) {
    392     return  ctx->listStats[dpy].skipCount;
    393 }
    394 
    395 static inline bool isYuvPresent (hwc_context_t *ctx, int dpy) {
    396     return  ctx->listStats[dpy].yuvCount;
    397 }
    398 
    399 static inline bool has90Transform(hwc_layer_1_t *layer) {
    400     return (layer->transform & HWC_TRANSFORM_ROT_90);
    401 }
    402 
    403 inline bool isSecurePresent(hwc_context_t *ctx, int dpy) {
    404     return ctx->listStats[dpy].isSecurePresent;
    405 }
    406 
    407 static inline bool isSecondaryConfiguring(hwc_context_t* ctx) {
    408     return (ctx->dpyAttr[HWC_DISPLAY_EXTERNAL].isConfiguring ||
    409             ctx->dpyAttr[HWC_DISPLAY_VIRTUAL].isConfiguring);
    410 }
    411 
    412 static inline bool isSecondaryConnected(hwc_context_t* ctx) {
    413     return (ctx->dpyAttr[HWC_DISPLAY_EXTERNAL].connected ||
    414             ctx->dpyAttr[HWC_DISPLAY_VIRTUAL].connected);
    415 }
    416 
    417 };
    418 
    419 #endif //HWC_UTILS_H
    420