xref: /OK3568_Linux_fs/u-boot/include/common.h (revision 4882a59341e53eb6f0b4789bf948001014eff981)
1 /*
2  * (C) Copyright 2000-2009
3  * Wolfgang Denk, DENX Software Engineering, wd@denx.de.
4  *
5  * SPDX-License-Identifier:	GPL-2.0+
6  */
7 
8 #ifndef __COMMON_H_
9 #define __COMMON_H_	1
10 
11 #ifndef __ASSEMBLY__		/* put C only stuff in this section */
12 
13 typedef unsigned char		uchar;
14 typedef volatile unsigned long	vu_long;
15 typedef volatile unsigned short vu_short;
16 typedef volatile unsigned char	vu_char;
17 
18 /* Allow sharing constants with type modifiers between C and assembly. */
19 #define _AC(X, Y)       (X##Y)
20 
21 #include <config.h>
22 #include <errno.h>
23 #include <time.h>
24 #include <asm-offsets.h>
25 #include <linux/bitops.h>
26 #include <linux/bug.h>
27 #include <linux/delay.h>
28 #include <linux/types.h>
29 #include <linux/printk.h>
30 #include <linux/string.h>
31 #include <linux/stringify.h>
32 #include <asm/ptrace.h>
33 #include <stdarg.h>
34 #include <stdio.h>
35 #include <linux/kernel.h>
36 
37 #include <part.h>
38 #include <flash.h>
39 #include <image.h>
40 #include <stacktrace.h>
41 
42 /* Bring in printf format macros if inttypes.h is included */
43 #define __STDC_FORMAT_MACROS
44 
45 #ifdef __LP64__
46 #define CONFIG_SYS_SUPPORT_64BIT_DATA
47 #endif
48 
49 #include <log.h>
50 
51 #if (__STDC_VERSION__ >= 201112L) || defined(__cplusplus)
52 # undef static_assert
53 # define static_assert _Static_assert
54 #endif
55 
56 #if !CONFIG_IS_ENABLED(IRQ)
57 typedef void (interrupt_handler_t)(void *);
58 #else
59 typedef void (interrupt_handler_t)(int, void *);
60 #endif
61 
62 #include <asm/u-boot.h> /* boot information for Linux kernel */
63 #include <asm/global_data.h>	/* global data used for startup functions */
64 
65 #if defined(CONFIG_ENV_IS_EMBEDDED)
66 #define TOTAL_MALLOC_LEN	CONFIG_SYS_MALLOC_LEN
67 #elif ( ((CONFIG_ENV_ADDR+CONFIG_ENV_SIZE) < CONFIG_SYS_MONITOR_BASE) || \
68 	(CONFIG_ENV_ADDR >= (CONFIG_SYS_MONITOR_BASE + CONFIG_SYS_MONITOR_LEN)) ) || \
69       defined(CONFIG_ENV_IS_IN_NVRAM)
70 #define	TOTAL_MALLOC_LEN	(CONFIG_SYS_MALLOC_LEN + CONFIG_ENV_SIZE)
71 #else
72 #define	TOTAL_MALLOC_LEN	CONFIG_SYS_MALLOC_LEN
73 #endif
74 
75 /*
76  * Function Prototypes
77  */
78 int dram_init(void);
79 
80 /**
81  * dram_init_banksize() - Set up DRAM bank sizes
82  *
83  * This can be implemented by boards to set up the DRAM bank information in
84  * gd->bd->bi_dram(). It is called just before relocation, after dram_init()
85  * is called.
86  *
87  * If this is not provided, a default implementation will try to set up a
88  * single bank. It will do this if CONFIG_NR_DRAM_BANKS and
89  * CONFIG_SYS_SDRAM_BASE are set. The bank will have a start address of
90  * CONFIG_SYS_SDRAM_BASE and the size will be determined by a call to
91  * get_effective_memsize().
92  *
93  * @return 0 if OK, -ve on error
94  */
95 int dram_init_banksize(void);
96 
97 void	hang		(void) __attribute__ ((noreturn));
98 
99 int	timer_init(void);
100 int	cpu_init(void);
101 
102 #include <display_options.h>
103 
104 /* common/main.c */
105 void	main_loop	(void);
106 void autoboot_command_fail_handle(void);
107 int run_command(const char *cmd, int flag);
108 int run_command_repeatable(const char *cmd, int flag);
109 
110 /**
111  * Run a list of commands separated by ; or even \0
112  *
113  * Note that if 'len' is not -1, then the command does not need to be nul
114  * terminated, Memory will be allocated for the command in that case.
115  *
116  * @param cmd	List of commands to run, each separated bu semicolon
117  * @param len	Length of commands excluding terminator if known (-1 if not)
118  * @param flag	Execution flags (CMD_FLAG_...)
119  * @return 0 on success, or != 0 on error.
120  */
121 int run_command_list(const char *cmd, int len, int flag);
122 
123 /* arch/$(ARCH)/lib/board.c */
124 void board_init_f(ulong);
125 void board_init_r(gd_t *, ulong) __attribute__ ((noreturn));
126 
127 /**
128  * ulong board_init_f_alloc_reserve - allocate reserved area
129  *
130  * This function is called by each architecture very early in the start-up
131  * code to allow the C runtime to reserve space on the stack for writable
132  * 'globals' such as GD and the malloc arena.
133  *
134  * @top:	top of the reserve area, growing down.
135  * @return:	bottom of reserved area
136  */
137 ulong board_init_f_alloc_reserve(ulong top);
138 
139 /**
140  * board_init_f_init_reserve - initialize the reserved area(s)
141  *
142  * This function is called once the C runtime has allocated the reserved
143  * area on the stack. It must initialize the GD at the base of that area.
144  *
145  * @base:	top from which reservation was done
146  */
147 void board_init_f_init_reserve(ulong base);
148 
149 /*
150  * Board-specific Platform code can init serial earlier if needed
151  */
152 __weak int board_init_f_boot_flags(void);
153 
154 /**
155  * arch_setup_gd() - Set up the global_data pointer
156  *
157  * This pointer is special in some architectures and cannot easily be assigned
158  * to. For example on x86 it is implemented by adding a specific record to its
159  * Global Descriptor Table! So we we provide a function to carry out this task.
160  * For most architectures this can simply be:
161  *
162  *    gd = gd_ptr;
163  *
164  * @gd_ptr:	Pointer to global data
165  */
166 void arch_setup_gd(gd_t *gd_ptr);
167 
168 int checkboard(void);
169 int show_board_info(void);
170 int checkflash(void);
171 int checkdram(void);
172 int last_stage_init(void);
173 extern ulong monitor_flash_len;
174 int mac_read_from_eeprom(void);
175 extern u8 __dtb_dt_begin[];	/* embedded device tree blob */
176 extern u8 __dtb_dt_spl_begin[];	/* embedded device tree blob for SPL/TPL */
177 int set_cpu_clk_info(void);
178 int mdm_init(void);
179 int print_cpuinfo(void);
180 int update_flash_size(int flash_size);
181 int arch_early_init_r(void);
182 
183 /*
184  * setup_board_extra() - Fill in extra details in the bd_t structure
185  *
186  * @return 0 if OK, -ve on error
187  */
188 int setup_board_extra(void);
189 
190 /**
191  * arch_fsp_init() - perform firmware support package init
192  *
193  * Where U-Boot relies on binary blobs to handle part of the system init, this
194  * function can be used to set up the blobs. This is used on some Intel
195  * platforms.
196  */
197 int arch_fsp_init(void);
198 
199 /**
200  * arch_cpu_init_dm() - init CPU after driver model is available
201  *
202  * This is called immediately after driver model is available before
203  * relocation. This is similar to arch_cpu_init() but is able to reference
204  * devices
205  *
206  * @return 0 if OK, -ve on error
207  */
208 int arch_cpu_init_dm(void);
209 
210 /**
211  * Reserve all necessary stacks
212  *
213  * This is used in generic board init sequence in common/board_f.c. Each
214  * architecture could provide this function to tailor the required stacks.
215  *
216  * On entry gd->start_addr_sp is pointing to the suggested top of the stack.
217  * The callee ensures gd->start_add_sp is 16-byte aligned, so architectures
218  * require only this can leave it untouched.
219  *
220  * On exit gd->start_addr_sp and gd->irq_sp should be set to the respective
221  * positions of the stack. The stack pointer(s) will be set to this later.
222  * gd->irq_sp is only required, if the architecture needs it.
223  *
224  * @return 0 if no error
225  */
226 __weak int arch_reserve_stacks(void);
227 
228 /**
229  * Show the DRAM size in a board-specific way
230  *
231  * This is used by boards to display DRAM information in their own way.
232  *
233  * @param size	Size of DRAM (which should be displayed along with other info)
234  */
235 void board_show_dram(phys_size_t size);
236 
237 /**
238  * arch_fixup_fdt() - Write arch-specific information to fdt
239  *
240  * Defined in arch/$(ARCH)/lib/bootm-fdt.c
241  *
242  * @blob:	FDT blob to write to
243  * @return 0 if ok, or -ve FDT_ERR_... on failure
244  */
245 int arch_fixup_fdt(void *blob);
246 
247 int reserve_mmu(void);
248 /* common/flash.c */
249 void flash_perror (int);
250 
251 /* common/cmd_source.c */
252 int	source (ulong addr, const char *fit_uname);
253 
254 extern ulong load_addr;		/* Default Load Address */
255 extern ulong save_addr;		/* Default Save Address */
256 extern ulong save_size;		/* Default Save Size */
257 
258 /* common/cmd_net.c */
259 int do_tftpb(cmd_tbl_t *cmdtp, int flag, int argc, char * const argv[]);
260 
261 /* common/cmd_fat.c */
262 int do_fat_fsload(cmd_tbl_t *, int, int, char * const []);
263 
264 /* common/cmd_ext2.c */
265 int do_ext2load(cmd_tbl_t *, int, int, char * const []);
266 
267 /* common/cmd_nvedit.c */
268 int	env_init     (void);
269 void	env_relocate (void);
270 int	envmatch     (uchar *, int);
271 
272 /**
273  * env_get() - Look up the value of an environment variable
274  *
275  * In U-Boot proper this can be called before relocation (which is when the
276  * environment is loaded from storage, i.e. GD_FLG_ENV_READY is 0). In that
277  * case this function calls env_get_f().
278  *
279  * @varname:	Variable to look up
280  * @return value of variable, or NULL if not found
281  */
282 char *env_get(const char *varname);
283 
284 /**
285  * env_get_f() - Look up the value of an environment variable (early)
286  *
287  * This function is called from env_get() if the environment has not been
288  * loaded yet (GD_FLG_ENV_READY flag is 0). Some environment locations will
289  * support reading the value (slowly) and some will not.
290  *
291  * @varname:	Variable to look up
292  * @return value of variable, or NULL if not found
293  */
294 int env_get_f(const char *name, char *buf, unsigned len);
295 
296 /**
297  * env_get_ulong() - Return an environment variable as an integer value
298  *
299  * Most U-Boot environment variables store hex values. For those which store
300  * (e.g.) base-10 integers, this function can be used to read the value.
301  *
302  * @name:	Variable to look up
303  * @base:	Base to use (e.g. 10 for base 10, 2 for binary)
304  * @default_val: Default value to return if no value is found
305  * @return the value found, or @default_val if none
306  */
307 ulong env_get_ulong(const char *name, int base, ulong default_val);
308 
309 /**
310  * env_get_hex() - Return an environment variable as a hex value
311  *
312  * Decode an environment as a hex number (it may or may not have a 0x
313  * prefix). If the environment variable cannot be found, or does not start
314  * with hex digits, the default value is returned.
315  *
316  * @varname:		Variable to decode
317  * @default_val:	Value to return on error
318  */
319 ulong env_get_hex(const char *varname, ulong default_val);
320 
321 /*
322  * Read an environment variable as a boolean
323  * Return -1 if variable does not exist (default to true)
324  */
325 int env_get_yesno(const char *var);
326 
327 /**
328  * env_set() - set an environment variable
329  *
330  * This sets or deletes the value of an environment variable. For setting the
331  * value the variable is created if it does not already exist.
332  *
333  * @varname: Variable to adjust
334  * @value: Value to set for the variable, or NULL or "" to delete the variable
335  * @return 0 if OK, 1 on error
336  */
337 int env_set(const char *varname, const char *value);
338 
339 /**
340  * env_update() - update sub value of an environment variable
341  *
342  * This add/append/replace the sub value of an environment variable.
343  *
344  * @varname: Variable to adjust
345  * @valude: Value to append/replace
346  * @ignore: Value to be ignore if in varvalue
347  * @return 0 if OK, 1 on error
348  */
349 int env_update_filter(const char *varname, const char *varvalue,
350 		      const char *ignore);
351 
352 /**
353  * env_update_extract_subset() - extract subset value from an environment variable
354  *
355  * This extract subset value from an environment variable
356  *
357  * @varname: Parent Variable where to extract subset value, the subset value
358  *	     will be removed from it.
359  * @subset_varname: Variable to save subset value
360  * @subset_key: Key value to find out subset value
361  * @return 0 if OK, 1 on error
362  */
363 int env_update_extract_subset(const char *varname,
364 			      const char *subset_varname,
365 			      const char *subset_key);
366 /**
367  * env_update() - update sub value of an environment variable
368  *
369  * This add/append/replace the sub value of an environment variable.
370  *
371  * @varname: Variable to adjust
372  * @valude: Value to append/replace
373  * @return 0 if OK, 1 on error
374  */
375 int env_update(const char *varname, const char *varvalue);
376 
377 /**
378  * env_exist() - check sub value of an environment variable is exist or not
379  *
380  * @varname: Variable to look up
381  * @value: Value to check
382  * @return posItion of varvalue if exist, otherwise NULL
383  */
384 char *env_exist(const char *varname, const char *varvalue);
385 
386 /**
387  * env_delete() - delete sub value of an environment variable
388  *
389  * @varname: Variable to look up
390  * @value: Item head of value to delete
391  * @complete_match: complete match whole words
392  * @return 0 if ok, 1 on error
393  */
394 int env_delete(const char *varname, const char *varvalue, int complete_match);
395 
396 /**
397  * env_set_ulong() - set an environment variable to an integer
398  *
399  * @varname: Variable to adjust
400  * @value: Value to set for the variable (will be converted to a string)
401  * @return 0 if OK, 1 on error
402  */
403 int env_set_ulong(const char *varname, ulong value);
404 
405 /**
406  * env_set_hex() - set an environment variable to a hex value
407  *
408  * @varname: Variable to adjust
409  * @value: Value to set for the variable (will be converted to a hex string)
410  * @return 0 if OK, 1 on error
411  */
412 int env_set_hex(const char *varname, ulong value);
413 
414 /**
415  * env_set_addr - Set an environment variable to an address in hex
416  *
417  * @varname:	Environment variable to set
418  * @addr:	Value to set it to
419  * @return 0 if ok, 1 on error
420  */
env_set_addr(const char * varname,const void * addr)421 static inline int env_set_addr(const char *varname, const void *addr)
422 {
423 	return env_set_hex(varname, (ulong)addr);
424 }
425 
426 #ifdef CONFIG_AUTO_COMPLETE
427 int env_complete(char *var, int maxv, char *cmdv[], int maxsz, char *buf);
428 #endif
429 int get_env_id (void);
430 
431 void	pci_init      (void);
432 void	pci_init_board(void);
433 
434 #if defined(CONFIG_DTB_RESELECT)
435 int	embedded_dtb_select(void);
436 #endif
437 
438 int	misc_init_f   (void);
439 int	misc_init_r   (void);
440 
441 /* common/exports.c */
442 void	jumptable_init(void);
443 
444 /* common/kallsysm.c */
445 const char *symbol_lookup(unsigned long addr, unsigned long *caddr);
446 
447 /* common/memsize.c */
448 long	get_ram_size  (long *, long);
449 phys_size_t get_effective_memsize(void);
450 
451 /* $(BOARD)/$(BOARD).c */
452 void	reset_phy     (void);
453 void	fdc_hw_init   (void);
454 
455 /* $(BOARD)/eeprom.c */
456 #ifdef CONFIG_CMD_EEPROM
457 void eeprom_init  (int bus);
458 int  eeprom_read  (unsigned dev_addr, unsigned offset, uchar *buffer, unsigned cnt);
459 int  eeprom_write (unsigned dev_addr, unsigned offset, uchar *buffer, unsigned cnt);
460 #else
461 /*
462  * Some EEPROM code is depecated because it used the legacy I2C interface. Add
463  * some macros here so we don't have to touch every one of those uses
464  */
465 #define eeprom_init(bus)
466 #define eeprom_read(dev_addr, offset, buffer, cnt) ((void)-ENOSYS)
467 #define eeprom_write(dev_addr, offset, buffer, cnt) ((void)-ENOSYS)
468 #endif
469 
470 #if !defined(CONFIG_ENV_EEPROM_IS_ON_I2C) && defined(CONFIG_SYS_I2C_EEPROM_ADDR)
471 # define CONFIG_SYS_DEF_EEPROM_ADDR CONFIG_SYS_I2C_EEPROM_ADDR
472 #endif
473 
474 #if defined(CONFIG_MPC8XX_SPI)
475 extern void spi_init_f (void);
476 extern void spi_init_r (void);
477 extern ssize_t spi_read	 (uchar *, int, uchar *, int);
478 extern ssize_t spi_write (uchar *, int, uchar *, int);
479 #endif
480 
481 /* $(BOARD)/$(BOARD).c */
482 int board_early_init_f (void);
483 int board_fix_fdt (void *rw_fdt_blob); /* manipulate the U-Boot fdt before its relocation */
484 int board_late_init (void);
485 int board_postclk_init (void); /* after clocks/timebase, before env/serial */
486 int board_early_init_r (void);
487 void board_poweroff (void);
488 void board_env_fixup(void);
489 
490 #if defined(CONFIG_SYS_DRAM_TEST)
491 int testdram(void);
492 #endif /* CONFIG_SYS_DRAM_TEST */
493 
494 /* $(CPU)/start.S */
495 int	icache_status (void);
496 void	icache_enable (void);
497 void	icache_disable(void);
498 int	dcache_status (void);
499 void	dcache_enable (void);
500 void	dcache_disable(void);
501 void	mmu_disable(void);
502 #if defined(CONFIG_ARM)
503 void	relocate_code(ulong);
504 #else
505 void	relocate_code(ulong, gd_t *, ulong) __attribute__ ((noreturn));
506 #endif
507 ulong	get_endaddr   (void);
508 void	trap_init     (ulong);
509 
510 /* $(CPU)/cpu.c */
cpumask_next(int cpu,unsigned int mask)511 static inline int cpumask_next(int cpu, unsigned int mask)
512 {
513 	for (cpu++; !((1 << cpu) & mask); cpu++)
514 		;
515 
516 	return cpu;
517 }
518 
519 #define for_each_cpu(iter, cpu, num_cpus, mask) \
520 	for (iter = 0, cpu = cpumask_next(-1, mask); \
521 		iter < num_cpus; \
522 		iter++, cpu = cpumask_next(cpu, mask)) \
523 
524 int	cpu_numcores  (void);
525 int	cpu_num_dspcores(void);
526 u32	cpu_mask      (void);
527 u32	cpu_dsp_mask(void);
528 int	is_core_valid (unsigned int);
529 
530 /**
531  * arch_cpu_init() - basic cpu-dependent setup for an architecture
532  *
533  * This is called after early malloc is available. It should handle any
534  * CPU- or SoC- specific init needed to continue the init sequence. See
535  * board_f.c for where it is called. If this is not provided, a default
536  * version (which does nothing) will be used.
537  */
538 int arch_cpu_init(void);
539 
540 void s_init(void);
541 
542 int	checkcpu      (void);
543 int	checkicache   (void);
544 int	checkdcache   (void);
545 void	upmconfig     (unsigned int, unsigned int *, unsigned int);
546 ulong	get_tbclk     (void);
547 void	reset_misc    (void);
548 void	reset_cpu     (ulong addr);
549 void ft_cpu_setup(void *blob, bd_t *bd);
550 void ft_pci_setup(void *blob, bd_t *bd);
551 
552 void smp_set_core_boot_addr(unsigned long addr, int corenr);
553 void smp_kick_all_cpus(void);
554 
555 /* $(CPU)/serial.c */
556 int	serial_init   (void);
557 void	serial_setbrg (void);
558 void	serial_putc   (const char);
559 void	serial_clear  (void);
560 void	serial_putc_raw(const char);
561 void	serial_puts   (const char *);
562 int	serial_getc   (void);
563 int	serial_tstc   (void);
564 
565 /* $(CPU)/speed.c */
566 int	get_clocks (void);
567 ulong	get_bus_freq  (ulong);
568 int get_serial_clock(void);
569 
570 int	cpu_init_r    (void);
571 
572 /* $(CPU)/interrupts.c */
573 int	interrupt_init	   (void);
574 void	timer_interrupt	   (struct pt_regs *);
575 void	external_interrupt (struct pt_regs *);
576 void	irq_install_handler(int, interrupt_handler_t *, void *);
577 void	irq_free_handler   (int);
578 void	reset_timer	   (void);
579 
580 /* Return value of monotonic microsecond timer */
581 unsigned long timer_get_us(void);
582 
583 void	enable_interrupts  (void);
584 int	disable_interrupts (void);
585 
586 /* $(CPU)/.../commproc.c */
587 int	dpram_init (void);
588 uint	dpram_base(void);
589 uint	dpram_base_align(uint align);
590 uint	dpram_alloc(uint size);
591 uint	dpram_alloc_align(uint size,uint align);
592 void	bootcount_store (ulong);
593 ulong	bootcount_load (void);
594 #define BOOTCOUNT_MAGIC		0xB001C041
595 
596 /* $(CPU)/.../<eth> */
597 void mii_init (void);
598 
599 /* $(CPU)/.../lcd.c */
600 ulong	lcd_setmem (ulong);
601 
602 /* $(CPU)/.../video.c */
603 ulong	video_setmem (ulong);
604 
605 /* arch/$(ARCH)/lib/cache.c */
606 void	enable_caches(void);
607 void	flush_cache   (unsigned long, unsigned long);
608 void	flush_dcache_all(void);
609 void	flush_dcache_range(unsigned long start, unsigned long stop);
610 void	invalidate_dcache_range(unsigned long start, unsigned long stop);
611 void	invalidate_dcache_all(void);
612 void	invalidate_icache_all(void);
613 
614 enum {
615 	/* Disable caches (else flush caches but leave them active) */
616 	CBL_DISABLE_CACHES		= 1 << 0,
617 	CBL_SHOW_BOOTSTAGE_REPORT	= 1 << 1,
618 
619 	CBL_ALL				= 3,
620 };
621 
622 /**
623  * Clean up ready for linux
624  *
625  * @param flags		Flags to control what is done
626  */
627 int cleanup_before_linux_select(int flags);
628 
629 /* arch/$(ARCH)/lib/ticks.S */
630 uint64_t get_ticks(void);
631 void	wait_ticks    (unsigned long);
632 
633 /* arch/$(ARCH)/lib/time.c */
634 ulong	usec2ticks    (unsigned long usec);
635 ulong	ticks2usec    (unsigned long ticks);
636 
637 /* lib/gunzip.c */
638 int gzip_parse_header(const unsigned char *src, unsigned long len);
639 int gunzip(void *, int, unsigned char *, unsigned long *);
640 int zunzip(void *dst, int dstlen, unsigned char *src, unsigned long *lenp,
641 						int stoponerr, int offset);
642 
643 /**
644  * gzwrite progress indicators: defined weak to allow board-specific
645  * overrides:
646  *
647  *	gzwrite_progress_init called on startup
648  *	gzwrite_progress called during decompress/write loop
649  *	gzwrite_progress_finish called at end of loop to
650  *		indicate success (retcode=0) or failure
651  */
652 void gzwrite_progress_init(u64 expected_size);
653 
654 void gzwrite_progress(int iteration,
655 		     u64 bytes_written,
656 		     u64 total_bytes);
657 
658 void gzwrite_progress_finish(int retcode,
659 			     u64 totalwritten,
660 			     u64 totalsize,
661 			     u32 expected_crc,
662 			     u32 calculated_crc);
663 
664 /**
665  * decompress and write gzipped image from memory to block device
666  *
667  * @param	src		compressed image address
668  * @param	len		compressed image length in bytes
669  * @param	dev		block device descriptor
670  * @param	szwritebuf	bytes per write (pad to erase size)
671  * @param	startoffs	offset in bytes of first write
672  * @param	szexpected	expected uncompressed length
673  *				may be zero to use gzip trailer
674  *				for files under 4GiB
675  */
676 int gzwrite(unsigned char *src, int len,
677 	    struct blk_desc *dev,
678 	    unsigned long szwritebuf,
679 	    u64 startoffs,
680 	    u64 szexpected);
681 
682 #include <u-boot/lz4.h>
683 
684 /* lib/qsort.c */
685 void qsort(void *base, size_t nmemb, size_t size,
686 	   int(*compar)(const void *, const void *));
687 int strcmp_compar(const void *, const void *);
688 
689 /* lib/uuid.c */
690 #include <uuid.h>
691 
692 /* lib/vsprintf.c */
693 #include <vsprintf.h>
694 
695 /* lib/strmhz.c */
696 char *	strmhz(char *buf, unsigned long hz);
697 
698 /* lib/crc32.c */
699 #include <u-boot/crc.h>
700 
701 /* lib/rand.c */
702 #define RAND_MAX -1U
703 void srand(unsigned int seed);
704 unsigned int rand(void);
705 unsigned int rand_r(unsigned int *seedp);
706 
707 /*
708  * STDIO based functions (can always be used)
709  */
710 /* serial stuff */
711 int	serial_printf (const char *fmt, ...)
712 		__attribute__ ((format (__printf__, 1, 2)));
713 
714 /* lib/gzip.c */
715 int gzip(void *dst, unsigned long *lenp,
716 		unsigned char *src, unsigned long srclen);
717 int zzip(void *dst, unsigned long *lenp, unsigned char *src,
718 		unsigned long srclen, int stoponerr,
719 		int (*func)(unsigned long, unsigned long));
720 
721 /* lib/net_utils.c */
722 #include <net.h>
env_get_ip(char * var)723 static inline struct in_addr env_get_ip(char *var)
724 {
725 	return string_to_ip(env_get(var));
726 }
727 
728 int	pcmcia_init (void);
729 
730 #ifdef CONFIG_LED_STATUS
731 # include <status_led.h>
732 #endif
733 
734 #include <bootstage.h>
735 
736 #ifdef CONFIG_SHOW_ACTIVITY
737 void show_activity(int arg);
738 #endif
739 
740 /* Multicore arch functions */
741 #ifdef CONFIG_MP
742 int cpu_status(int nr);
743 int cpu_reset(int nr);
744 int cpu_disable(int nr);
745 int cpu_release(int nr, int argc, char * const argv[]);
746 #endif
747 
748 #else	/* __ASSEMBLY__ */
749 
750 /* Drop a C type modifier (like in 3UL) for constants used in assembly. */
751 #define _AC(X, Y)       X
752 
753 #endif	/* __ASSEMBLY__ */
754 
755 /* Put only stuff here that the assembler can digest */
756 
757 /* Declare an unsigned long constant digestable both by C and an assembler. */
758 #define UL(x)           _AC(x, UL)
759 
760 #ifdef CONFIG_POST
761 #define CONFIG_HAS_POST
762 #ifndef CONFIG_POST_ALT_LIST
763 #define CONFIG_POST_STD_LIST
764 #endif
765 #endif
766 
767 #ifdef CONFIG_INIT_CRITICAL
768 #error CONFIG_INIT_CRITICAL is deprecated!
769 #error Read section CONFIG_SKIP_LOWLEVEL_INIT in README.
770 #endif
771 
772 #define ROUND(a,b)		(((a) + (b) - 1) & ~((b) - 1))
773 
774 /*
775  * check_member() - Check the offset of a structure member
776  *
777  * @structure:	Name of structure (e.g. global_data)
778  * @member:	Name of member (e.g. baudrate)
779  * @offset:	Expected offset in bytes
780  */
781 #define check_member(structure, member, offset) _Static_assert( \
782 	offsetof(struct structure, member) == offset, \
783 	"`struct " #structure "` offset for `" #member "` is not " #offset)
784 
785 /* Avoid using CONFIG_EFI_STUB directly as we may boot from other loaders */
786 #ifdef CONFIG_EFI_STUB
787 #define ll_boot_init()	false
788 #else
789 #define ll_boot_init()	true
790 #endif
791 
792 /* Pull in stuff for the build system */
793 #ifdef DO_DEPS_ONLY
794 # include <environment.h>
795 #endif
796 
797 #endif	/* __COMMON_H_ */
798