1 // SPDX-License-Identifier: GPL-2.0+
3 * Copyright (C) 2017 Google, Inc
4 * Written by Simon Glass <sjg@chromium.org>
9 #include <env_internal.h>
11 #include <linux/bitops.h>
12 #include <linux/bug.h>
14 DECLARE_GLOBAL_DATA_PTR;
16 #if defined(CONFIG_NEEDS_MANUAL_RELOC)
17 void env_fix_drivers(void)
19 struct env_driver *drv;
20 const int n_ents = ll_entry_count(struct env_driver, env_driver);
21 struct env_driver *entry;
23 drv = ll_entry_start(struct env_driver, env_driver);
24 for (entry = drv; entry != drv + n_ents; entry++) {
26 entry->name += gd->reloc_off;
28 entry->load += gd->reloc_off;
30 entry->save += gd->reloc_off;
32 entry->erase += gd->reloc_off;
34 entry->init += gd->reloc_off;
39 static struct env_driver *_env_driver_lookup(enum env_location loc)
41 struct env_driver *drv;
42 const int n_ents = ll_entry_count(struct env_driver, env_driver);
43 struct env_driver *entry;
45 drv = ll_entry_start(struct env_driver, env_driver);
46 for (entry = drv; entry != drv + n_ents; entry++) {
47 if (loc == entry->location)
55 static enum env_location env_locations[] = {
56 #ifdef CONFIG_ENV_IS_IN_EEPROM
59 #ifdef CONFIG_ENV_IS_IN_EXT4
62 #ifdef CONFIG_ENV_IS_IN_FAT
65 #ifdef CONFIG_ENV_IS_IN_FLASH
68 #ifdef CONFIG_ENV_IS_IN_MMC
71 #ifdef CONFIG_ENV_IS_IN_NAND
74 #ifdef CONFIG_ENV_IS_IN_NVRAM
77 #ifdef CONFIG_ENV_IS_IN_REMOTE
80 #ifdef CONFIG_ENV_IS_IN_SATA
83 #ifdef CONFIG_ENV_IS_IN_SPI_FLASH
86 #ifdef CONFIG_ENV_IS_IN_UBI
89 #ifdef CONFIG_ENV_IS_NOWHERE
94 static bool env_has_inited(enum env_location location)
96 return gd->env_has_init & BIT(location);
99 static void env_set_inited(enum env_location location)
102 * We're using a 32-bits bitmask stored in gd (env_has_init)
103 * using the above enum value as the bit index. We need to
104 * make sure that we're not overflowing it.
106 BUILD_BUG_ON(ENVL_COUNT > BITS_PER_LONG);
108 gd->env_has_init |= BIT(location);
112 * env_get_location() - Returns the best env location for a board
113 * @op: operations performed on the environment
114 * @prio: priority between the multiple environments, 0 being the
117 * This will return the preferred environment for the given priority.
118 * This is overridable by boards if they need to.
120 * All implementations are free to use the operation, the priority and
121 * any other data relevant to their choice, but must take into account
122 * the fact that the lowest prority (0) is the most important location
123 * in the system. The following locations should be returned by order
124 * of descending priorities, from the highest to the lowest priority.
127 * an enum env_location value on success, a negative error code otherwise
129 __weak enum env_location env_get_location(enum env_operation op, int prio)
131 if (prio >= ARRAY_SIZE(env_locations))
134 return env_locations[prio];
139 * env_driver_lookup() - Finds the most suited environment location
140 * @op: operations performed on the environment
141 * @prio: priority between the multiple environments, 0 being the
144 * This will try to find the available environment with the highest
145 * priority in the system.
148 * NULL on error, a pointer to a struct env_driver otherwise
150 static struct env_driver *env_driver_lookup(enum env_operation op, int prio)
152 enum env_location loc = env_get_location(op, prio);
153 struct env_driver *drv;
155 if (loc == ENVL_UNKNOWN)
158 drv = _env_driver_lookup(loc);
160 debug("%s: No environment driver for location %d\n", __func__,
168 __weak int env_get_char_spec(int index)
170 return *(uchar *)(gd->env_addr + index);
173 int env_get_char(int index)
175 if (gd->env_valid == ENV_INVALID)
176 return default_environment[index];
178 return env_get_char_spec(index);
183 struct env_driver *drv;
187 for (prio = 0; (drv = env_driver_lookup(ENVOP_LOAD, prio)); prio++) {
190 if (!env_has_inited(drv->location))
193 printf("Loading Environment from %s... ", drv->name);
195 * In error case, the error message must be printed during
196 * drv->load() in some underlying API, and it must be exactly
202 gd->env_load_prio = prio;
205 } else if (ret == -ENOMSG) {
206 /* Handle "bad CRC" case */
210 debug("Failed (%d)\n", ret);
215 * In case of invalid environment, we set the 'default' env location
216 * to the best choice, i.e.:
217 * 1. Environment location with bad CRC, if such location was found
218 * 2. Otherwise use the location with highest priority
220 * This way, next calls to env_save() will restore the environment
221 * at the right place.
224 debug("Selecting environment with bad CRC\n");
228 gd->env_load_prio = best_prio;
235 struct env_driver *drv;
237 drv = env_driver_lookup(ENVOP_LOAD, gd->env_load_prio);
241 printf("Loading Environment from %s... ", drv->name);
243 if (!env_has_inited(drv->location)) {
244 printf("not initialized\n");
250 printf("Failed (%d)\n", ret);
263 struct env_driver *drv;
265 drv = env_driver_lookup(ENVOP_SAVE, gd->env_load_prio);
269 printf("Saving Environment to %s... ", drv->name);
271 printf("not possible\n");
275 if (!env_has_inited(drv->location)) {
276 printf("not initialized\n");
282 printf("Failed (%d)\n", ret);
295 struct env_driver *drv;
297 drv = env_driver_lookup(ENVOP_ERASE, gd->env_load_prio);
304 if (!env_has_inited(drv->location))
307 printf("Erasing Environment on %s... ", drv->name);
310 printf("Failed (%d)\n", ret);
323 struct env_driver *drv;
327 for (prio = 0; (drv = env_driver_lookup(ENVOP_INIT, prio)); prio++) {
328 if (!drv->init || !(ret = drv->init()))
329 env_set_inited(drv->location);
331 debug("%s: Environment %s init done (ret=%d)\n", __func__,
338 if (ret == -ENOENT) {
339 gd->env_addr = (ulong)&default_environment[0];
340 gd->env_valid = ENV_VALID;
348 int env_select(const char *name)
350 struct env_driver *drv;
351 const int n_ents = ll_entry_count(struct env_driver, env_driver);
352 struct env_driver *entry;
356 printf("Select Environment on %s: ", name);
358 /* search ENV driver by name */
359 drv = ll_entry_start(struct env_driver, env_driver);
360 for (entry = drv; entry != drv + n_ents; entry++) {
361 if (!strcmp(entry->name, name)) {
368 printf("driver not found\n");
372 /* search priority by driver */
373 for (prio = 0; (drv = env_driver_lookup(ENVOP_INIT, prio)); prio++) {
374 if (entry->location == env_get_location(ENVOP_LOAD, prio)) {
375 /* when priority change, reset the ENV flags */
376 if (gd->env_load_prio != prio) {
377 gd->env_load_prio = prio;
378 gd->env_valid = ENV_INVALID;
379 gd->flags &= ~GD_FLG_ENV_DEFAULT;
385 printf("priority not found\n");