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