mirror of
				https://github.com/smaeul/u-boot.git
				synced 2025-11-03 21:48:15 +00:00 
			
		
		
		
	It's really helpful to have the ability to dump BCB block for debugging A/B logic on the board supported this partition schema. Command 'bcb ab_dump' prints all fields of bootloader_control struct including slot_metadata for all presented slots. Output example: ===== > board# bcb ab_dump ubi 0#misc > Read 512 bytes from volume misc to 000000000bf07580 > Read 512 bytes from volume misc to 000000000bf42f40 > Bootloader Control: [misc] > Active Slot: _a > Magic Number: 0x42414342 > Version: 1 > Number of Slots: 2 > Recovery Tries Remaining: 0 > CRC: 0x2c8b50bc (Valid) > > Slot[0] Metadata: > - Priority: 15 > - Tries Remaining: 0 > - Successful Boot: 1 > - Verity Corrupted: 0 > > Slot[1] Metadata: > - Priority: 14 > - Tries Remaining: 7 > - Successful Boot: 0 > - Verity Corrupted: 0 ==== The ab_dump command allows you to display ABC data directly on the U-Boot console. During an A/B test execution, this test verifies the accuracy of each field within the ABC data. Signed-off-by: Dmitry Rokosov <ddrokosov@salutedevices.com> Reviewed-by: Mattijs Korpershoek <mkorpershoek@baylibre.com> Tested-by: Mattijs Korpershoek <mkorpershoek@baylibre.com> # vim3_android Link: https://lore.kernel.org/r/20241017-android_ab_master-v5-5-43bfcc096d95@salutedevices.com Signed-off-by: Mattijs Korpershoek <mkorpershoek@baylibre.com>
		
			
				
	
	
		
			50 lines
		
	
	
		
			1.5 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
			
		
		
	
	
			50 lines
		
	
	
		
			1.5 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);
 | 
						|
 | 
						|
/**
 | 
						|
 * ab_dump_abc() - Dump ABC information for specific partition.
 | 
						|
 *
 | 
						|
 * @dev_desc: Device description pointer
 | 
						|
 * @part_info: Partition information
 | 
						|
 *
 | 
						|
 * Return: 0 on success, or a negative on error
 | 
						|
 */
 | 
						|
int ab_dump_abc(struct blk_desc *dev_desc, struct disk_partition *part_info);
 | 
						|
 | 
						|
#endif /* __ANDROID_AB_H */
 |