mirror of
https://github.com/u-boot/u-boot.git
synced 2025-04-19 11:24:42 +00:00

There are new function documentation requirements in U-Boot, so apply these changes for android_ab. Reviewed-by: Mattijs Korpershoek <mkorpershoek@baylibre.com> Reviewed-by: Simon Glass <sjg@chromium.org> Tested-by: Guillaume La Roque <glaroque@baylibre.com> Signed-off-by: Dmitry Rokosov <ddrokosov@salutedevices.com> Tested-by: Mattijs Korpershoek <mkorpershoek@baylibre.com> # vim3_android Link: https://lore.kernel.org/r/20241017-android_ab_master-v5-1-43bfcc096d95@salutedevices.com Signed-off-by: Mattijs Korpershoek <mkorpershoek@baylibre.com>
39 lines
1.2 KiB
C
39 lines
1.2 KiB
C
/* SPDX-License-Identifier: BSD-2-Clause */
|
|
/*
|
|
* Copyright (C) 2017 The Android Open Source Project
|
|
*/
|
|
|
|
#ifndef __ANDROID_AB_H
|
|
#define __ANDROID_AB_H
|
|
|
|
#include <stdbool.h>
|
|
|
|
struct blk_desc;
|
|
struct disk_partition;
|
|
|
|
/* Android standard boot slot names are 'a', 'b', 'c', ... */
|
|
#define BOOT_SLOT_NAME(slot_num) ('a' + (slot_num))
|
|
|
|
/* Number of slots */
|
|
#define NUM_SLOTS 2
|
|
|
|
/**
|
|
* ab_select_slot() - Select the slot where to boot from.
|
|
*
|
|
* @dev_desc: Place to store the device description pointer
|
|
* @part_info: Place to store the partition information
|
|
*
|
|
* On Android devices with more than one boot slot (multiple copies of the
|
|
* kernel and system images) selects which slot should be used to boot from and
|
|
* registers the boot attempt. This is used in by the new A/B update model where
|
|
* one slot is updated in the background while running from the other slot. If
|
|
* the selected slot did not successfully boot in the past, a boot attempt is
|
|
* registered before returning from this function so it isn't selected
|
|
* indefinitely.
|
|
*
|
|
* Return: The slot number (>= 0) on success, or a negative on error
|
|
*/
|
|
int ab_select_slot(struct blk_desc *dev_desc, struct disk_partition *part_info,
|
|
bool dec_tries);
|
|
|
|
#endif /* __ANDROID_AB_H */
|