1/* SPDX-License-Identifier: GPL-2.0+ */ 2/* 3 * Verified Boot for Embedded (VBE) support 4 * See doc/develop/vbe.rst 5 * 6 * Copyright 2022 Google LLC 7 * Written by Simon Glass <sjg@chromium.org> 8 */ 9 10#ifndef __VBE_H 11#define __VBE_H 12 13/** 14 * enum vbe_phase_t - current phase of VBE 15 * 16 * VBE operates in two distinct phases. In VPL it has to choose which firmware 17 * to run (SPL, U-Boot, OP-TEE, etc.). It then carries on running until it gets 18 * to U-Boot, where it decides which OS to run 19 * 20 * @VBE_PHASE_FIRMWARE: Selecting the firmware to run 21 * @VBE_PHASE_OS: Selecting the Operating System to run 22 */ 23enum vbe_phase_t { 24 VBE_PHASE_FIRMWARE, 25 VBE_PHASE_OS, 26}; 27 28/** 29 * struct vbe_handoff - information about VBE progress 30 * 31 * @phases: Indicates which phases used the VBE bootmeth (1 << PHASE_...) 32 */ 33struct vbe_handoff { 34 u8 phases; 35}; 36 37/** 38 * vbe_phase() - get current VBE phase 39 * 40 * Returns: Current VBE phase 41 */ 42static inline enum vbe_phase_t vbe_phase(void) 43{ 44 if (IS_ENABLED(CONFIG_SPL_BUILD)) 45 return VBE_PHASE_FIRMWARE; 46 47 return VBE_PHASE_OS; 48} 49 50/** 51 * vbe_list() - List the VBE bootmeths 52 * 53 * This shows a list of the VBE bootmeth devices 54 * 55 * @return 0 (always) 56 */ 57int vbe_list(void); 58 59/** 60 * vbe_find_by_any() - Find a VBE bootmeth by name or sequence 61 * 62 * @name: name (e.g. "vbe-simple"), or sequence ("2") to find 63 * @devp: returns the device found, on success 64 * Return: 0 if OK, -ve on error 65 */ 66int vbe_find_by_any(const char *name, struct udevice **devp); 67 68/** 69 * vbe_find_first_device() - Find the first VBE bootmeth 70 * 71 * @devp: Returns first available VBE bootmeth, or NULL if none 72 * Returns: 0 (always) 73 */ 74int vbe_find_first_device(struct udevice **devp); 75 76/** 77 * vbe_find_next_device() - Find the next available VBE bootmeth 78 * 79 * @devp: Previous device to start from. Returns next available VBE bootmeth, 80 * or NULL if none 81 * Returns: 0 (always) 82 */ 83int vbe_find_next_device(struct udevice **devp); 84 85#endif 86