1 // SPDX-License-Identifier: GPL-2.0+
3 * Copyright (C) 2017 Google, Inc
4 * Written by Simon Glass <sjg@chromium.org>
8 #include <environment.h>
10 DECLARE_GLOBAL_DATA_PTR
;
12 #if defined(CONFIG_NEEDS_MANUAL_RELOC)
13 void env_fix_drivers(void)
15 struct env_driver
*drv
;
16 const int n_ents
= ll_entry_count(struct env_driver
, env_driver
);
17 struct env_driver
*entry
;
19 drv
= ll_entry_start(struct env_driver
, env_driver
);
20 for (entry
= drv
; entry
!= drv
+ n_ents
; entry
++) {
22 entry
->name
+= gd
->reloc_off
;
24 entry
->load
+= gd
->reloc_off
;
26 entry
->save
+= gd
->reloc_off
;
28 entry
->init
+= gd
->reloc_off
;
33 static struct env_driver
*_env_driver_lookup(enum env_location loc
)
35 struct env_driver
*drv
;
36 const int n_ents
= ll_entry_count(struct env_driver
, env_driver
);
37 struct env_driver
*entry
;
39 drv
= ll_entry_start(struct env_driver
, env_driver
);
40 for (entry
= drv
; entry
!= drv
+ n_ents
; entry
++) {
41 if (loc
== entry
->location
)
49 static enum env_location env_locations
[] = {
50 #ifdef CONFIG_ENV_IS_IN_EEPROM
53 #ifdef CONFIG_ENV_IS_IN_EXT4
56 #ifdef CONFIG_ENV_IS_IN_FAT
59 #ifdef CONFIG_ENV_IS_IN_FLASH
62 #ifdef CONFIG_ENV_IS_IN_MMC
65 #ifdef CONFIG_ENV_IS_IN_NAND
68 #ifdef CONFIG_ENV_IS_IN_NVRAM
71 #ifdef CONFIG_ENV_IS_IN_REMOTE
74 #ifdef CONFIG_ENV_IS_IN_SPI_FLASH
77 #ifdef CONFIG_ENV_IS_IN_UBI
80 #ifdef CONFIG_ENV_IS_NOWHERE
85 static bool env_has_inited(enum env_location location
)
87 return gd
->env_has_init
& BIT(location
);
90 static void env_set_inited(enum env_location location
)
93 * We're using a 32-bits bitmask stored in gd (env_has_init)
94 * using the above enum value as the bit index. We need to
95 * make sure that we're not overflowing it.
97 BUILD_BUG_ON(ARRAY_SIZE(env_locations
) > BITS_PER_LONG
);
99 gd
->env_has_init
|= BIT(location
);
103 * env_get_location() - Returns the best env location for a board
104 * @op: operations performed on the environment
105 * @prio: priority between the multiple environments, 0 being the
108 * This will return the preferred environment for the given priority.
109 * This is overridable by boards if they need to.
111 * All implementations are free to use the operation, the priority and
112 * any other data relevant to their choice, but must take into account
113 * the fact that the lowest prority (0) is the most important location
114 * in the system. The following locations should be returned by order
115 * of descending priorities, from the highest to the lowest priority.
118 * an enum env_location value on success, a negative error code otherwise
120 __weak
enum env_location
env_get_location(enum env_operation op
, int prio
)
122 if (prio
>= ARRAY_SIZE(env_locations
))
125 gd
->env_load_prio
= prio
;
127 return env_locations
[prio
];
132 * env_driver_lookup() - Finds the most suited environment location
133 * @op: operations performed on the environment
134 * @prio: priority between the multiple environments, 0 being the
137 * This will try to find the available environment with the highest
138 * priority in the system.
141 * NULL on error, a pointer to a struct env_driver otherwise
143 static struct env_driver
*env_driver_lookup(enum env_operation op
, int prio
)
145 enum env_location loc
= env_get_location(op
, prio
);
146 struct env_driver
*drv
;
148 if (loc
== ENVL_UNKNOWN
)
151 drv
= _env_driver_lookup(loc
);
153 debug("%s: No environment driver for location %d\n", __func__
,
161 __weak
int env_get_char_spec(int index
)
163 return *(uchar
*)(gd
->env_addr
+ index
);
166 int env_get_char(int index
)
168 if (gd
->env_valid
== ENV_INVALID
)
169 return default_environment
[index
];
171 return env_get_char_spec(index
);
176 struct env_driver
*drv
;
179 for (prio
= 0; (drv
= env_driver_lookup(ENVOP_LOAD
, prio
)); prio
++) {
185 if (!env_has_inited(drv
->location
))
188 printf("Loading Environment from %s... ", drv
->name
);
190 * In error case, the error message must be printed during
191 * drv->load() in some underlying API, and it must be exactly
196 debug("Failed (%d)\n", ret
);
204 * In case of invalid environment, we set the 'default' env location
205 * to the highest priority. In this way, next calls to env_save()
206 * will restore the environment at the right place.
208 env_get_location(ENVOP_LOAD
, 0);
215 struct env_driver
*drv
;
217 drv
= env_driver_lookup(ENVOP_SAVE
, gd
->env_load_prio
);
224 if (!env_has_inited(drv
->location
))
227 printf("Saving Environment to %s... ", drv
->name
);
230 printf("Failed (%d)\n", ret
);
243 struct env_driver
*drv
;
247 for (prio
= 0; (drv
= env_driver_lookup(ENVOP_INIT
, prio
)); prio
++) {
248 if (!drv
->init
|| !(ret
= drv
->init()))
249 env_set_inited(drv
->location
);
251 debug("%s: Environment %s init done (ret=%d)\n", __func__
,
258 if (ret
== -ENOENT
) {
259 gd
->env_addr
= (ulong
)&default_environment
[0];
260 gd
->env_valid
= ENV_VALID
;