1 /*
2  * Copyright (C) 2020 The Android Open Source Project
3  *
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
7  *
8  *      http://www.apache.org/licenses/LICENSE-2.0
9  *
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.
15  */
16 
17 package android.system.suspend.internal;
18 
19 import android.system.suspend.internal.SuspendInfo;
20 import android.system.suspend.internal.WakeLockInfo;
21 import android.system.suspend.internal.WakeupInfo;
22 
23 /**
24  * Interface exposed by the suspend hal that allows framework to toggle the suspend loop and
25  * monitor native wakelocks.
26  * @hide
27  */
28 interface ISuspendControlServiceInternal {
29     /**
30      * Starts automatic system suspension.
31      *
32      * @return true on success, false otherwise.
33      */
enableAutosuspend()34     boolean enableAutosuspend();
35 
36     /**
37      * Suspends the system even if there are wakelocks being held.
38      */
forceSuspend()39     boolean forceSuspend();
40 
41     /**
42      * Returns a list of wake lock stats.
43      */
getWakeLockStats()44     WakeLockInfo[] getWakeLockStats();
45 
46     /**
47      * Returns a list of wakeup stats.
48      */
getWakeupStats()49     WakeupInfo[] getWakeupStats();
50 
51     /**
52      * Returns stats related to suspend.
53      */
getSuspendStats()54     SuspendInfo getSuspendStats();
55 }
56