/* SPDX-License-Identifier: BSD-2-Clause */
/*
 * Copyright (C) 2017 The Android Open Source Project
 */

#ifndef __ANDROID_AB_H
#define __ANDROID_AB_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

/* CX_EMMC_AB_CONTROL from icumx_IPL */
#define DISK_BUFFER__IPL	(0xEB22E000U)
#define DISK_BUFFER_ADDR	(0x41DFE000U)

/* pass ab info from Cx_IPL to BL2 */
#define AB_INFO_FLAG__IPL	(0xEB22FFFCU)
#define AB_INFO_FLAG_ADDR	(0x41DFFFFCU)
#define AB_INFO_FLAG_INIT	(0xDEADBEEFU)
#define AB_INFO_SELECT_1st	(0x00000000U)
#define AB_INFO_SELECT_2nd	(0x10000000U)
#define AB_INFO_FLAG_STORE	(0x0BADF00DU)
#define AB_INFO_FLAG_OK		(0x00FACADEU)

/**
 * Select the slot where to boot from.
 *
 * 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.
 *
 * @param[in] dev_desc Place to store the device description pointer
 * @param[in] part_info Place to store the partition information
 * @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
    void
);

#endif /* __ANDROID_AB_H */
