blob: 99ce7b64e7c538968cae1c71d1771236bc371e90 [file] [log] [blame]
Simon Glassef5e3892022-04-24 23:31:06 -06001/* SPDX-License-Identifier: GPL-2.0+ */
2/*
3 * Standard U-Boot boot framework
4 *
5 * Copyright 2021 Google LLC
6 * Written by Simon Glass <sjg@chromium.org>
7 */
8
9#ifndef __bootstd_h
10#define __bootstd_h
11
Simon Glasse64c2952023-01-06 08:52:42 -060012#include <dm/ofnode_decl.h>
13
Simon Glassef5e3892022-04-24 23:31:06 -060014struct udevice;
15
16/**
17 * struct bootstd_priv - priv data for the bootstd driver
18 *
19 * This is attached to the (only) bootstd device, so there is only one instance
20 * of this struct. It provides overall information about bootdevs and bootflows.
21 *
22 * @prefixes: NULL-terminated list of prefixes to use for bootflow filenames,
23 * e.g. "/", "/boot/"; NULL if none
24 * @bootdev_order: Order to use for bootdevs (or NULL if none), with each item
Simon Glass6a6638f2023-01-17 10:47:15 -070025 * being a bootdev label, e.g. "mmc2", "mmc1" (NULL terminated)
26 * @env_order: Order as specified by the boot_targets env var (or NULL if none),
27 * with each item being a bootdev label, e.g. "mmc2", "mmc1" (NULL
28 * terminated)
Simon Glassef5e3892022-04-24 23:31:06 -060029 * @cur_bootdev: Currently selected bootdev (for commands)
30 * @cur_bootflow: Currently selected bootflow (for commands)
31 * @glob_head: Head for the global list of all bootflows across all bootdevs
32 * @bootmeth_count: Number of bootmeth devices in @bootmeth_order
33 * @bootmeth_order: List of bootmeth devices to use, in order, NULL-terminated
Simon Glass4c7418f2022-07-30 15:52:32 -060034 * @vbe_bootmeth: Currently selected VBE bootmeth, NULL if none
Simon Glasse64c2952023-01-06 08:52:42 -060035 * @theme: Node containing the theme information
Simon Glassbd90b092023-01-17 10:47:33 -070036 * @hunters_used: Bitmask of used hunters, indexed by their position in the
37 * linker list. The bit is set if the hunter has been used already
Simon Glassef5e3892022-04-24 23:31:06 -060038 */
39struct bootstd_priv {
40 const char **prefixes;
41 const char **bootdev_order;
Simon Glass6a6638f2023-01-17 10:47:15 -070042 const char **env_order;
Simon Glassef5e3892022-04-24 23:31:06 -060043 struct udevice *cur_bootdev;
44 struct bootflow *cur_bootflow;
45 struct list_head glob_head;
46 int bootmeth_count;
47 struct udevice **bootmeth_order;
Simon Glass4c7418f2022-07-30 15:52:32 -060048 struct udevice *vbe_bootmeth;
Simon Glasse64c2952023-01-06 08:52:42 -060049 ofnode theme;
Simon Glassbd90b092023-01-17 10:47:33 -070050 uint hunters_used;
Simon Glassef5e3892022-04-24 23:31:06 -060051};
52
53/**
54 * bootstd_get_bootdev_order() - Get the boot-order list
55 *
56 * This reads the boot order, e.g. {"mmc0", "mmc2", NULL}
57 *
58 * The list is alloced by the bootstd driver so should not be freed. That is the
59 * reason for all the const stuff in the function signature
60 *
Simon Glass6a6638f2023-01-17 10:47:15 -070061 * @dev: bootstd device
62 * @okp: returns true if OK, false if out of memory
63 * Return: list of string pointers, terminated by NULL; or NULL if no boot
64 * order. Note that this returns NULL in the case of an empty list
Simon Glassef5e3892022-04-24 23:31:06 -060065 */
Simon Glass6a6638f2023-01-17 10:47:15 -070066const char *const *const bootstd_get_bootdev_order(struct udevice *dev,
67 bool *okp);
Simon Glassef5e3892022-04-24 23:31:06 -060068
69/**
70 * bootstd_get_prefixes() - Get the filename-prefixes list
71 *
Julien Delbergue2c120672023-07-13 11:53:09 +020072 * This reads the prefixes, e.g. {"/", "/boot", NULL}
Simon Glassef5e3892022-04-24 23:31:06 -060073 *
74 * The list is alloced by the bootstd driver so should not be freed. That is the
75 * reason for all the const stuff in the function signature
76 *
77 * Return: list of string points, terminated by NULL; or NULL if no boot order
78 */
79const char *const *const bootstd_get_prefixes(struct udevice *dev);
80
81/**
82 * bootstd_get_priv() - Get the (single) state for the bootstd system
83 *
84 * The state holds a global list of all bootflows that have been found.
85 *
86 * Return: 0 if OK, -ve if the uclass does not exist
87 */
88int bootstd_get_priv(struct bootstd_priv **stdp);
89
90/**
91 * bootstd_clear_glob() - Clear the global list of bootflows
92 *
93 * This removes all bootflows globally and across all bootdevs.
94 */
95void bootstd_clear_glob(void);
96
Simon Glass1047b532023-11-18 14:05:19 -070097/**
98 * bootstd_prog_boot() - Run standard boot in a fully programmatic mode
99 *
100 * Attempts to boot without making any use of U-Boot commands
101 *
102 * Returns: -ve error value (does not return except on failure to boot)
103 */
104int bootstd_prog_boot(void);
105
Simon Glassef5e3892022-04-24 23:31:06 -0600106#endif