xref: /aosp_15_r20/hardware/interfaces/boot/1.2/IBootControl.hal (revision 4d7e907c777eeecc4c5bd7cf640a754fac206ff7)
1*4d7e907cSAndroid Build Coastguard Worker/*
2*4d7e907cSAndroid Build Coastguard Worker * Copyright 2020 The Android Open Source Project
3*4d7e907cSAndroid Build Coastguard Worker *
4*4d7e907cSAndroid Build Coastguard Worker * Licensed under the Apache License, Version 2.0 (the "License");
5*4d7e907cSAndroid Build Coastguard Worker * you may not use this file except in compliance with the License.
6*4d7e907cSAndroid Build Coastguard Worker * You may obtain a copy of the License at
7*4d7e907cSAndroid Build Coastguard Worker *
8*4d7e907cSAndroid Build Coastguard Worker *      http://www.apache.org/licenses/LICENSE-2.0
9*4d7e907cSAndroid Build Coastguard Worker *
10*4d7e907cSAndroid Build Coastguard Worker * Unless required by applicable law or agreed to in writing, software
11*4d7e907cSAndroid Build Coastguard Worker * distributed under the License is distributed on an "AS IS" BASIS,
12*4d7e907cSAndroid Build Coastguard Worker * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13*4d7e907cSAndroid Build Coastguard Worker * See the License for the specific language governing permissions and
14*4d7e907cSAndroid Build Coastguard Worker * limitations under the License.
15*4d7e907cSAndroid Build Coastguard Worker */
16*4d7e907cSAndroid Build Coastguard Worker
17*4d7e907cSAndroid Build Coastguard Workerpackage [email protected];
18*4d7e907cSAndroid Build Coastguard Worker
19*4d7e907cSAndroid Build Coastguard Workerimport @1.0::IBootControl;
20*4d7e907cSAndroid Build Coastguard Workerimport @1.0::Slot;
21*4d7e907cSAndroid Build Coastguard Workerimport @1.1::IBootControl;
22*4d7e907cSAndroid Build Coastguard Worker
23*4d7e907cSAndroid Build Coastguard Workerinterface IBootControl extends @1.1::IBootControl {
24*4d7e907cSAndroid Build Coastguard Worker
25*4d7e907cSAndroid Build Coastguard Worker  /**
26*4d7e907cSAndroid Build Coastguard Worker   * Returns the active slot to boot into on the next boot. If
27*4d7e907cSAndroid Build Coastguard Worker   * setActiveBootSlot() has been called, the getter function should return the
28*4d7e907cSAndroid Build Coastguard Worker   * same slot as the one provided in the last setActiveBootSlot() call.
29*4d7e907cSAndroid Build Coastguard Worker   * The returned value is always guaranteed to be strictly less than the
30*4d7e907cSAndroid Build Coastguard Worker   * value returned by getNumberSlots. Slots start at 0 and finish at
31*4d7e907cSAndroid Build Coastguard Worker   * getNumberSlots() - 1. For instance, a system with A/B must return 0 or 1.
32*4d7e907cSAndroid Build Coastguard Worker   */
33*4d7e907cSAndroid Build Coastguard Worker   getActiveBootSlot() generates (Slot slot);
34*4d7e907cSAndroid Build Coastguard Worker};
35*4d7e907cSAndroid Build Coastguard Worker
36