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  8
40 #define NSEC_PER_MSEC 1000000LLU
41 
42 class QCameraDisplay {
43 public:
44     QCameraDisplay();
45     ~QCameraDisplay();
46     static int   vsyncEventReceiverCamera(int fd, int events, void* data);
47     static void* vsyncThreadCamera(void * data);
48     void         computeAverageVsyncInterval(nsecs_t currentVsyncTimeStamp);
49     nsecs_t      computePresentationTimeStamp(nsecs_t frameTimeStamp);
50 
51 private:
52     pthread_t mVsyncThreadCameraHandle;
53     nsecs_t   mVsyncTimeStamp;
54     nsecs_t   mAvgVsyncInterval;
55     nsecs_t   mOldTimeStamp;
56     nsecs_t   mVsyncIntervalHistory[CAMERA_NUM_VSYNC_INTERVAL_HISTORY];
57     nsecs_t   mVsyncHistoryIndex;
58     nsecs_t   mAdditionalVsyncOffsetForWiggle;
59     uint32_t  mThreadExit;
60     // Tunable property. Increasing this will increase the frame delay and will loose
61     // the real time display.
62     uint32_t  mNum_vsync_from_vfe_isr_to_presentation_timestamp;
63     // Tunable property. Set the time stamp x ns prior to expected vsync so that
64     // it will be picked in that vsync
65     nsecs_t  mSet_timestamp_num_ns_prior_to_vsync;
66     // Tunable property for filtering timestamp wiggle when VFE ISR crosses
67     // over MDP ISR over a period. Typical scenario is VFE is running at
68     // 30.2 fps vs display running at 60 fps.
69     nsecs_t  mVfe_and_mdp_freq_wiggle_filter_max_ns;
70     nsecs_t  mVfe_and_mdp_freq_wiggle_filter_min_ns;
71 
72     android::DisplayEventReceiver  mDisplayEventReceiver;
73 };
74 
75 }; // namespace qcamera
76 
77 #endif /* __QCAMERADISPLAY_H__ */
78