1 /* Copyright (c) 2015-2016, The Linux Foundation. All rights reserved.
2  *
3  * Redistribution and use in source and binary forms, with or without
4  * modification, are permitted provided that the following conditions are
5  * met:
6  *     * Redistributions of source code must retain the above copyright
7  *       notice, this list of conditions and the following disclaimer.
8  *     * Redistributions in binary form must reproduce the above
9  *       copyright notice, this list of conditions and the following
10  *       disclaimer in the documentation and/or other materials provided
11  *       with the distribution.
12  *     * Neither the name of The Linux Foundation nor the names of its
13  *       contributors may be used to endorse or promote products derived
14  *       from this software without specific prior written permission.
15  *
16  * THIS SOFTWARE IS PROVIDED "AS IS" AND ANY EXPRESS OR IMPLIED
17  * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
18  * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT
19  * ARE DISCLAIMED.  IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS
20  * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
21  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
22  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
23  * BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
24  * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE
25  * OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
26  * IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
27  *
28  */
29 
30 #ifndef __QCAMERADISPLAY_H__
31 #define __QCAMERADISPLAY_H__
32 
33 #include <gui/DisplayEventReceiver.h>
34 #include <android/looper.h>
35 #include <utils/Looper.h>
36 
37 namespace qcamera {
38 
39 #define CAMERA_NUM_VSYNC_INTERVAL_HISTORY  6
40 
41 class QCameraDisplay {
42 public:
43     QCameraDisplay();
44     ~QCameraDisplay();
45     static int   vsyncEventReceiverCamera(int fd, int events, void* data);
46     static void* vsyncThreadCamera(void * data);
47     void         computeAverageVsyncInterval(nsecs_t currentVsyncTimeStamp);
48     nsecs_t      computePresentationTimeStamp(nsecs_t frameTimeStamp);
49 
50 private:
51     pthread_t mVsyncThreadCameraHandle;
52     nsecs_t   mVsyncTimeStamp;
53     nsecs_t   mAvgVsyncInterval;
54     nsecs_t   mOldTimeStamp;
55     nsecs_t   mVsyncIntervalHistory[CAMERA_NUM_VSYNC_INTERVAL_HISTORY];
56     nsecs_t   mVsyncHistoryIndex;
57     nsecs_t   mAdditionalVsyncOffsetForWiggle;
58     uint32_t  mThreadExit;
59     // Tunable property. Increasing this will increase the frame delay and will loose
60     // the real time display.
61     uint32_t  mNum_vsync_from_vfe_isr_to_presentation_timestamp;
62     // Tunable property. Set the time stamp x ms prior to expected vsync so that
63     // it will be picked in that vsync
64     uint32_t  mSet_timestamp_num_ms_prior_to_vsync;
65     // Tunable property for filtering timestamp wiggle when VFE ISR crosses
66     // over MDP ISR over a period. Typical scenario is VFE is running at
67     // 30.2 fps vs display running at 60 fps.
68     uint32_t  mVfe_and_mdp_freq_wiggle_filter_max_ms;
69     uint32_t  mVfe_and_mdp_freq_wiggle_filter_min_ms;
70 
71     android::DisplayEventReceiver  mDisplayEventReceiver;
72 };
73 
74 }; // namespace qcamera
75 
76 #endif /* __QCAMERADISPLAY_H__ */
77