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