]>
Commit | Line | Data |
---|---|---|
c609719b WD |
1 | /* |
2 | * (C) Copyright 2002 | |
3 | * Wolfgang Denk, DENX Software Engineering, wd@denx.de. | |
4 | * | |
1a459660 | 5 | * SPDX-License-Identifier: GPL-2.0+ |
c609719b WD |
6 | */ |
7 | ||
8 | #ifndef _ENVIRONMENT_H_ | |
6f403bad | 9 | #define _ENVIRONMENT_H_ |
c609719b | 10 | |
fb1c43cc MR |
11 | #include <linux/kconfig.h> |
12 | ||
c609719b WD |
13 | /************************************************************************** |
14 | * | |
15 | * The "environment" is stored as a list of '\0' terminated | |
16 | * "name=value" strings. The end of the list is marked by a double | |
17 | * '\0'. New entries are always added at the end. Deleting an entry | |
18 | * shifts the remaining entries to the front. Replacing an entry is a | |
19 | * combination of deleting the old value and adding the new one. | |
20 | * | |
fc0b5948 | 21 | * The environment is preceded by a 32 bit CRC over the data part. |
c609719b | 22 | * |
fc0b5948 | 23 | *************************************************************************/ |
c609719b | 24 | |
5a1aceb0 | 25 | #if defined(CONFIG_ENV_IS_IN_FLASH) |
507651d6 IG |
26 | # ifndef CONFIG_ENV_ADDR |
27 | # define CONFIG_ENV_ADDR (CONFIG_SYS_FLASH_BASE + CONFIG_ENV_OFFSET) | |
c609719b | 28 | # endif |
507651d6 IG |
29 | # ifndef CONFIG_ENV_OFFSET |
30 | # define CONFIG_ENV_OFFSET (CONFIG_ENV_ADDR - CONFIG_SYS_FLASH_BASE) | |
c609719b | 31 | # endif |
0e8d1586 | 32 | # if !defined(CONFIG_ENV_ADDR_REDUND) && defined(CONFIG_ENV_OFFSET_REDUND) |
507651d6 IG |
33 | # define CONFIG_ENV_ADDR_REDUND \ |
34 | (CONFIG_SYS_FLASH_BASE + CONFIG_ENV_OFFSET_REDUND) | |
c609719b | 35 | # endif |
0e8d1586 | 36 | # if defined(CONFIG_ENV_SECT_SIZE) || defined(CONFIG_ENV_SIZE) |
507651d6 IG |
37 | # ifndef CONFIG_ENV_SECT_SIZE |
38 | # define CONFIG_ENV_SECT_SIZE CONFIG_ENV_SIZE | |
500545cc | 39 | # endif |
507651d6 IG |
40 | # ifndef CONFIG_ENV_SIZE |
41 | # define CONFIG_ENV_SIZE CONFIG_ENV_SECT_SIZE | |
500545cc WD |
42 | # endif |
43 | # else | |
0e8d1586 | 44 | # error "Both CONFIG_ENV_SECT_SIZE and CONFIG_ENV_SIZE undefined" |
c609719b | 45 | # endif |
0e8d1586 JCPV |
46 | # if defined(CONFIG_ENV_ADDR_REDUND) && !defined(CONFIG_ENV_SIZE_REDUND) |
47 | # define CONFIG_ENV_SIZE_REDUND CONFIG_ENV_SIZE | |
c609719b | 48 | # endif |
507651d6 IG |
49 | # if (CONFIG_ENV_ADDR >= CONFIG_SYS_MONITOR_BASE) && \ |
50 | (CONFIG_ENV_ADDR + CONFIG_ENV_SIZE) <= \ | |
51 | (CONFIG_SYS_MONITOR_BASE + CONFIG_SYS_MONITOR_LEN) | |
6f403bad | 52 | # define ENV_IS_EMBEDDED |
c609719b | 53 | # endif |
0e8d1586 | 54 | # if defined(CONFIG_ENV_ADDR_REDUND) || defined(CONFIG_ENV_OFFSET_REDUND) |
6f403bad | 55 | # define CONFIG_SYS_REDUNDAND_ENVIRONMENT |
c609719b | 56 | # endif |
0a9e4e77 MF |
57 | # ifdef CONFIG_ENV_IS_EMBEDDED |
58 | # error "do not define CONFIG_ENV_IS_EMBEDDED in your board config" | |
59 | # error "it is calculated automatically for you" | |
60 | # endif | |
5a1aceb0 | 61 | #endif /* CONFIG_ENV_IS_IN_FLASH */ |
c609719b | 62 | |
5707df77 BS |
63 | #if defined(CONFIG_ENV_IS_IN_MMC) |
64 | # ifdef CONFIG_ENV_OFFSET_REDUND | |
65 | # define CONFIG_SYS_REDUNDAND_ENVIRONMENT | |
66 | # endif | |
67 | #endif | |
68 | ||
51bfee19 | 69 | #if defined(CONFIG_ENV_IS_IN_NAND) |
c9f7351b BG |
70 | # if defined(CONFIG_ENV_OFFSET_OOB) |
71 | # ifdef CONFIG_ENV_OFFSET_REDUND | |
72 | # error "CONFIG_ENV_OFFSET_REDUND is not supported when CONFIG_ENV_OFFSET_OOB" | |
73 | # error "is set" | |
74 | # endif | |
75 | extern unsigned long nand_env_oob_offset; | |
76 | # define CONFIG_ENV_OFFSET nand_env_oob_offset | |
77 | # else | |
78 | # ifndef CONFIG_ENV_OFFSET | |
79 | # error "Need to define CONFIG_ENV_OFFSET when using CONFIG_ENV_IS_IN_NAND" | |
80 | # endif | |
81 | # ifdef CONFIG_ENV_OFFSET_REDUND | |
82 | # define CONFIG_SYS_REDUNDAND_ENVIRONMENT | |
83 | # endif | |
84 | # endif /* CONFIG_ENV_OFFSET_OOB */ | |
0e8d1586 JCPV |
85 | # ifndef CONFIG_ENV_SIZE |
86 | # error "Need to define CONFIG_ENV_SIZE when using CONFIG_ENV_IS_IN_NAND" | |
e443c944 | 87 | # endif |
51bfee19 | 88 | #endif /* CONFIG_ENV_IS_IN_NAND */ |
e443c944 | 89 | |
2b74433f JH |
90 | #if defined(CONFIG_ENV_IS_IN_UBI) |
91 | # ifndef CONFIG_ENV_UBI_PART | |
92 | # error "Need to define CONFIG_ENV_UBI_PART when using CONFIG_ENV_IS_IN_UBI" | |
93 | # endif | |
94 | # ifndef CONFIG_ENV_UBI_VOLUME | |
95 | # error "Need to define CONFIG_ENV_UBI_VOLUME when using CONFIG_ENV_IS_IN_UBI" | |
96 | # endif | |
785881f7 JH |
97 | # if defined(CONFIG_ENV_UBI_VOLUME_REDUND) |
98 | # define CONFIG_SYS_REDUNDAND_ENVIRONMENT | |
99 | # endif | |
2b74433f JH |
100 | # ifndef CONFIG_ENV_SIZE |
101 | # error "Need to define CONFIG_ENV_SIZE when using CONFIG_ENV_IS_IN_UBI" | |
102 | # endif | |
103 | # ifndef CONFIG_CMD_UBI | |
104 | # error "Need to define CONFIG_CMD_UBI when using CONFIG_ENV_IS_IN_UBI" | |
105 | # endif | |
106 | #endif /* CONFIG_ENV_IS_IN_UBI */ | |
107 | ||
0a9e4e77 MF |
108 | /* Embedded env is only supported for some flash types */ |
109 | #ifdef CONFIG_ENV_IS_EMBEDDED | |
507651d6 IG |
110 | # if !defined(CONFIG_ENV_IS_IN_FLASH) && \ |
111 | !defined(CONFIG_ENV_IS_IN_NAND) && \ | |
112 | !defined(CONFIG_ENV_IS_IN_ONENAND) && \ | |
113 | !defined(CONFIG_ENV_IS_IN_SPI_FLASH) | |
0a9e4e77 MF |
114 | # error "CONFIG_ENV_IS_EMBEDDED not supported for your flash type" |
115 | # endif | |
116 | #endif | |
117 | ||
118 | /* | |
119 | * For the flash types where embedded env is supported, but it cannot be | |
120 | * calculated automatically (i.e. NAND), take the board opt-in. | |
121 | */ | |
122 | #if defined(CONFIG_ENV_IS_EMBEDDED) && !defined(ENV_IS_EMBEDDED) | |
6f403bad | 123 | # define ENV_IS_EMBEDDED |
0a9e4e77 MF |
124 | #endif |
125 | ||
126 | /* The build system likes to know if the env is embedded */ | |
127 | #ifdef DO_DEPS_ONLY | |
128 | # ifdef ENV_IS_EMBEDDED | |
33a6b9e9 WD |
129 | # ifndef CONFIG_ENV_IS_EMBEDDED |
130 | # define CONFIG_ENV_IS_EMBEDDED | |
131 | # endif | |
0a9e4e77 MF |
132 | # endif |
133 | #endif | |
134 | ||
37566090 | 135 | #include "compiler.h" |
c609719b | 136 | |
6d0f6bcf | 137 | #ifdef CONFIG_SYS_REDUNDAND_ENVIRONMENT |
89cdab78 | 138 | # define ENV_HEADER_SIZE (sizeof(uint32_t) + 1) |
b218ccb5 WD |
139 | |
140 | # define ACTIVE_FLAG 1 | |
141 | # define OBSOLETE_FLAG 0 | |
c609719b | 142 | #else |
89cdab78 | 143 | # define ENV_HEADER_SIZE (sizeof(uint32_t)) |
c609719b WD |
144 | #endif |
145 | ||
0e8d1586 | 146 | #define ENV_SIZE (CONFIG_ENV_SIZE - ENV_HEADER_SIZE) |
c609719b | 147 | |
507651d6 | 148 | typedef struct environment_s { |
89cdab78 | 149 | uint32_t crc; /* CRC32 over data bytes */ |
6d0f6bcf | 150 | #ifdef CONFIG_SYS_REDUNDAND_ENVIRONMENT |
c609719b WD |
151 | unsigned char flags; /* active/obsolete flags */ |
152 | #endif | |
153 | unsigned char data[ENV_SIZE]; /* Environment data */ | |
c6831c74 | 154 | } env_t; |
c609719b | 155 | |
994bc671 IG |
156 | #ifdef ENV_IS_EMBEDDED |
157 | extern env_t environment; | |
158 | #endif /* ENV_IS_EMBEDDED */ | |
159 | ||
d1459f0f | 160 | extern const unsigned char default_environment[]; |
27aafe98 IG |
161 | extern env_t *env_ptr; |
162 | ||
27aafe98 IG |
163 | #if defined(CONFIG_NEEDS_MANUAL_RELOC) |
164 | extern void env_reloc(void); | |
165 | #endif | |
d1459f0f | 166 | |
ac77f42d DL |
167 | #ifdef CONFIG_ENV_IS_IN_MMC |
168 | #include <mmc.h> | |
169 | ||
170 | extern int mmc_get_env_addr(struct mmc *mmc, int copy, u32 *env_addr); | |
6e7b7df4 DL |
171 | # ifdef CONFIG_SYS_MMC_ENV_PART |
172 | extern uint mmc_get_env_part(struct mmc *mmc); | |
173 | # endif | |
ac77f42d DL |
174 | #endif |
175 | ||
2eb1573f MF |
176 | #ifndef DO_DEPS_ONLY |
177 | ||
170ab110 JH |
178 | #include <env_attr.h> |
179 | #include <env_callback.h> | |
2598090b | 180 | #include <env_flags.h> |
2eb1573f MF |
181 | #include <search.h> |
182 | ||
203e94f6 SG |
183 | /* Value for environment validity */ |
184 | enum env_valid { | |
185 | ENV_INVALID, /* No valid environment */ | |
186 | ENV_VALID, /* First or only environment is valid */ | |
187 | ENV_REDUND, /* Redundant environment is valid */ | |
188 | }; | |
189 | ||
4415f1d1 | 190 | enum env_location { |
4415f1d1 SG |
191 | ENVL_EEPROM, |
192 | ENVL_EXT4, | |
193 | ENVL_FAT, | |
194 | ENVL_FLASH, | |
195 | ENVL_MMC, | |
196 | ENVL_NAND, | |
197 | ENVL_NVRAM, | |
198 | ENVL_ONENAND, | |
199 | ENVL_REMOTE, | |
200 | ENVL_SPI_FLASH, | |
201 | ENVL_UBI, | |
202 | ENVL_NOWHERE, | |
203 | ||
204 | ENVL_COUNT, | |
205 | ENVL_UNKNOWN, | |
206 | }; | |
207 | ||
8a3a7e22 MR |
208 | /* value for the various operations we want to perform on the env */ |
209 | enum env_operation { | |
210 | ENVOP_GET_CHAR, /* we want to call the get_char function */ | |
211 | ENVOP_INIT, /* we want to call the init function */ | |
212 | ENVOP_LOAD, /* we want to call the load function */ | |
213 | ENVOP_SAVE, /* we want to call the save function */ | |
214 | }; | |
215 | ||
4415f1d1 | 216 | struct env_driver { |
ac358beb | 217 | const char *name; |
4415f1d1 SG |
218 | enum env_location location; |
219 | ||
220 | /** | |
221 | * get_char() - Read a character from the environment | |
222 | * | |
223 | * This method is optional. If not provided, a default implementation | |
224 | * will read from gd->env_addr. | |
225 | * | |
226 | * @index: Index of character to read (0=first) | |
21f63944 | 227 | * @return character read, or -ve on error |
4415f1d1 | 228 | */ |
21f63944 | 229 | int (*get_char)(int index); |
4415f1d1 SG |
230 | |
231 | /** | |
232 | * load() - Load the environment from storage | |
233 | * | |
234 | * This method is optional. If not provided, no environment will be | |
235 | * loaded. | |
c5951991 SG |
236 | * |
237 | * @return 0 if OK, -ve on error | |
4415f1d1 | 238 | */ |
c5951991 | 239 | int (*load)(void); |
4415f1d1 SG |
240 | |
241 | /** | |
242 | * save() - Save the environment to storage | |
243 | * | |
244 | * This method is required for 'saveenv' to work. | |
245 | * | |
246 | * @return 0 if OK, -ve on error | |
247 | */ | |
248 | int (*save)(void); | |
249 | ||
250 | /** | |
251 | * init() - Set up the initial pre-relocation environment | |
252 | * | |
253 | * This method is optional. | |
254 | * | |
7938822a SG |
255 | * @return 0 if OK, -ENOENT if no initial environment could be found, |
256 | * other -ve on error | |
4415f1d1 SG |
257 | */ |
258 | int (*init)(void); | |
259 | }; | |
260 | ||
261 | /* Declare a new environment location driver */ | |
262 | #define U_BOOT_ENV_LOCATION(__name) \ | |
263 | ll_entry_declare(struct env_driver, __name, env_driver) | |
264 | ||
ac358beb SG |
265 | /* Declare the name of a location */ |
266 | #ifdef CONFIG_CMD_SAVEENV | |
267 | #define ENV_NAME(_name) .name = _name, | |
268 | #else | |
269 | #define ENV_NAME(_name) | |
270 | #endif | |
271 | ||
4415f1d1 SG |
272 | #ifdef CONFIG_CMD_SAVEENV |
273 | #define env_save_ptr(x) x | |
274 | #else | |
275 | #define env_save_ptr(x) NULL | |
276 | #endif | |
277 | ||
2eb1573f MF |
278 | extern struct hsearch_data env_htab; |
279 | ||
a8409f4f | 280 | /* Function that updates CRC of the enironment */ |
507651d6 | 281 | void env_crc_update(void); |
a8409f4f | 282 | |
267541f7 | 283 | /* Look up the variable from the default environment */ |
723806cc | 284 | char *env_get_default(const char *name); |
267541f7 | 285 | |
5bb12dbd | 286 | /* [re]set to the default environment */ |
ea882baf WD |
287 | void set_default_env(const char *s); |
288 | ||
b64b7c3d GF |
289 | /* [re]set individual variables to their value in the default environment */ |
290 | int set_default_vars(int nvars, char * const vars[]); | |
291 | ||
ea882baf WD |
292 | /* Import from binary representation into hash table */ |
293 | int env_import(const char *buf, int check); | |
5bb12dbd | 294 | |
7ce1526e MV |
295 | /* Export from hash table into binary representation */ |
296 | int env_export(env_t *env_out); | |
297 | ||
76768f5f FA |
298 | #ifdef CONFIG_SYS_REDUNDAND_ENVIRONMENT |
299 | /* Select and import one of two redundant environments */ | |
31f044bd SG |
300 | int env_import_redund(const char *buf1, int buf1_status, |
301 | const char *buf2, int buf2_status); | |
76768f5f FA |
302 | #endif |
303 | ||
a69d0f60 SG |
304 | /** |
305 | * env_get_char() - Get a character from the early environment | |
306 | * | |
307 | * This reads from the pre-relocation environemnt | |
308 | * | |
309 | * @index: Index of character to read (0 = first) | |
310 | * @return character read, or -ve on error | |
311 | */ | |
312 | int env_get_char(int index); | |
313 | ||
310fb14b SG |
314 | /** |
315 | * env_load() - Load the environment from storage | |
316 | * | |
317 | * @return 0 if OK, -ve on error | |
318 | */ | |
319 | int env_load(void); | |
320 | ||
01510091 SG |
321 | /** |
322 | * env_save() - Save the environment to storage | |
323 | * | |
324 | * @return 0 if OK, -ve on error | |
325 | */ | |
326 | int env_save(void); | |
327 | ||
507651d6 | 328 | #endif /* DO_DEPS_ONLY */ |
2eb1573f | 329 | |
507651d6 | 330 | #endif /* _ENVIRONMENT_H_ */ |