提交: 3b083e7c940d144eebf75ae63816fbe266a10875 - system-hardware-interfaces (git)

system/hardware/interfaces

Commit MetaInfo

• 修订版: 3b083e7c940d144eebf75ae63816fbe266a10875 (tree)
• 时间: 2018-08-15 09:32:14
• 作者: Tri Vo <trong@goog...>
• Commiter: Tri Vo

Log Message

System suspend HAL interface.

Bug: 78888165
Test: SystemSuspendV1_0UnitTest
Change-Id: I3c3537a72dac65d316aeb77fd7b2d7cff4fb67e5
Merged-In: I3c3537a72dac65d316aeb77fd7b2d7cff4fb67e5
(cherry picked from commit 2fbf967c4f47b7f3977893fd4a2988d32eff4c27)

更改概述

• add: suspend/1.0/Android.bp
• add: suspend/1.0/ISystemSuspend.hal
• add: suspend/1.0/IWakeLock.hal

差异

--- /dev/null
+++ b/suspend/1.0/Android.bp
@@ -0,0 +1,16 @@
+hidl_interface {
+    name: "android.system.suspend@1.0",
+    root: "android.system",
+    vndk: {
+        enabled: true,
+    },
+    srcs: [
+        "ISystemSuspend.hal",
+        "IWakeLock.hal",
+    ],
+    interfaces: [
+        "android.hidl.base@1.0",
+    ],
+    gen_java: false,
+}
+

--- /dev/null
+++ b/suspend/1.0/ISystemSuspend.hal
@@ -0,0 +1,37 @@
+/*
+ * Copyright (C) 2018 The Android Open Source Project
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package android.system.suspend@1.0;
+
+import IWakeLock;
+
+interface ISystemSuspend {
+    /**
+     * Starts automatic system suspension.
+     *
+     * @return status true on success, false otherwise.
+     */
+    enableAutosuspend() generates (bool success);
+
+    /**
+     * Acquires an IWakeLock instance. Any allocated IWakeLock must block the
+     * device from suspending. This method must be able to be called
+     * independently of enableAutosuspend().
+     *
+     * @return lock the interface for the created wake lock.
+     */
+    acquireWakeLock() generates (IWakeLock lock);
+};

--- /dev/null
+++ b/suspend/1.0/IWakeLock.hal
@@ -0,0 +1,23 @@
+/*
+ * Copyright (C) 2018 The Android Open Source Project
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package android.system.suspend@1.0;
+
+/**
+ * Allocating an IWakeLock instance must block system suspend. Deallocating an
+ * IWakeLock must initiate system suspend if no other wake lock is allocated.
+ */
+interface IWakeLock {};