xref: /rk3399_rockchip-uboot/include/common.h (revision 9f3183d2d69f6d392fb943d249934f8648531e7e)
1e2211743Swdenk /*
23b74e7ecSWolfgang Denk  * (C) Copyright 2000-2009
3e2211743Swdenk  * Wolfgang Denk, DENX Software Engineering, wd@denx.de.
4e2211743Swdenk  *
51a459660SWolfgang Denk  * SPDX-License-Identifier:	GPL-2.0+
6e2211743Swdenk  */
7e2211743Swdenk 
8e2211743Swdenk #ifndef __COMMON_H_
9d0b8feefSWolfgang Denk #define __COMMON_H_	1
10e2211743Swdenk 
11fcd3c87eSWolfgang Denk #ifndef __ASSEMBLY__		/* put C only stuff in this section */
12fcd3c87eSWolfgang Denk 
13e2211743Swdenk typedef unsigned char		uchar;
14e2211743Swdenk typedef volatile unsigned long	vu_long;
15e2211743Swdenk typedef volatile unsigned short vu_short;
16e2211743Swdenk typedef volatile unsigned char	vu_char;
17e2211743Swdenk 
18e2211743Swdenk #include <config.h>
1925ddd1fbSWolfgang Denk #include <asm-offsets.h>
20e2211743Swdenk #include <linux/bitops.h>
21e2211743Swdenk #include <linux/types.h>
22e2211743Swdenk #include <linux/string.h>
239aed5080SMarek Vasut #include <linux/stringify.h>
24e2211743Swdenk #include <asm/ptrace.h>
25e2211743Swdenk #include <stdarg.h>
26cba1da49SMasahiro Yamada #include <linux/kernel.h>
27a821d08dSStefan Roese #if defined(CONFIG_PCI) && defined(CONFIG_4xx)
28e2211743Swdenk #include <pci.h>
29e2211743Swdenk #endif
30180d3f74Swdenk #if defined(CONFIG_8xx)
31e2211743Swdenk #include <asm/8xx_immap.h>
3203f9d7d1SMasahiro Yamada #if defined(CONFIG_MPC859)	|| defined(CONFIG_MPC859T)	|| \
3303f9d7d1SMasahiro Yamada     defined(CONFIG_MPC866)	|| \
34d4ca31c4Swdenk     defined(CONFIG_MPC866P)
35d0b8feefSWolfgang Denk # define CONFIG_MPC866_FAMILY 1
360ace4d9dSMasahiro Yamada #elif defined(CONFIG_MPC885)
37d0b8feefSWolfgang Denk # define CONFIG_MPC885_FAMILY   1
38180d3f74Swdenk #endif
39180d3f74Swdenk #if   defined(CONFIG_MPC860)	   \
40180d3f74Swdenk    || defined(CONFIG_MPC860T)	   \
411114257cSwdenk    || defined(CONFIG_MPC866_FAMILY) \
421114257cSwdenk    || defined(CONFIG_MPC885_FAMILY)
43d0b8feefSWolfgang Denk # define CONFIG_MPC86x 1
442535d602Swdenk #endif
450db5bca8Swdenk #elif defined(CONFIG_5xx)
460db5bca8Swdenk #include <asm/5xx_immap.h>
477e6bf358Swdenk #elif defined(CONFIG_MPC5xxx)
487e6bf358Swdenk #include <mpc5xxx.h>
498993e54bSRafal Jaworowski #elif defined(CONFIG_MPC512X)
508993e54bSRafal Jaworowski #include <asm/immap_512x.h>
5158dac327SMasahiro Yamada #elif defined(CONFIG_MPC8260)
5204a85b3bSwdenk #if   defined(CONFIG_MPC8247) \
5304a85b3bSwdenk    || defined(CONFIG_MPC8272)
54d0b8feefSWolfgang Denk #define CONFIG_MPC8272_FAMILY	1
5504a85b3bSwdenk #endif
56e2211743Swdenk #include <asm/immap_8260.h>
57e2211743Swdenk #endif
58debb7354SJon Loeliger #ifdef CONFIG_MPC86xx
59debb7354SJon Loeliger #include <mpc86xx.h>
60debb7354SJon Loeliger #include <asm/immap_86xx.h>
61debb7354SJon Loeliger #endif
6242d1f039Swdenk #ifdef CONFIG_MPC85xx
6342d1f039Swdenk #include <mpc85xx.h>
6442d1f039Swdenk #include <asm/immap_85xx.h>
6542d1f039Swdenk #endif
660f898604SPeter Tyser #ifdef CONFIG_MPC83xx
67f046ccd1SEran Liberty #include <mpc83xx.h>
68f046ccd1SEran Liberty #include <asm/immap_83xx.h>
69f046ccd1SEran Liberty #endif
70e2211743Swdenk #ifdef	CONFIG_4xx
71b36df561SStefan Roese #include <asm/ppc4xx.h>
72e2211743Swdenk #endif
736cfcce67SMike Frysinger #ifdef CONFIG_BLACKFIN
746cfcce67SMike Frysinger #include <asm/blackfin.h>
756cfcce67SMike Frysinger #endif
762819e136SSekhar Nori #ifdef CONFIG_SOC_DA8XX
772819e136SSekhar Nori #include <asm/arch/hardware.h>
782819e136SSekhar Nori #endif
79*9f3183d2SMingkai Hu #ifdef CONFIG_FSL_LSCH3
80*9f3183d2SMingkai Hu #include <asm/arch/immap_lsch3.h>
81*9f3183d2SMingkai Hu #endif
82e2211743Swdenk 
83e2211743Swdenk #include <part.h>
84e2211743Swdenk #include <flash.h>
85e2211743Swdenk #include <image.h>
86e2211743Swdenk 
874166ecb2SGabe Black /* Bring in printf format macros if inttypes.h is included */
884166ecb2SGabe Black #define __STDC_FORMAT_MACROS
894166ecb2SGabe Black 
904d1fd7f1SYork Sun #ifdef __LP64__
914d1fd7f1SYork Sun #define CONFIG_SYS_SUPPORT_64BIT_DATA
924d1fd7f1SYork Sun #endif
934d1fd7f1SYork Sun 
94e2211743Swdenk #ifdef DEBUG
9521726a7aSSimon Glass #define _DEBUG	1
9621726a7aSSimon Glass #else
9721726a7aSSimon Glass #define _DEBUG	0
9821726a7aSSimon Glass #endif
9921726a7aSSimon Glass 
100be25d875SThierry Reding #ifndef pr_fmt
101be25d875SThierry Reding #define pr_fmt(fmt) fmt
102be25d875SThierry Reding #endif
103be25d875SThierry Reding 
10421726a7aSSimon Glass /*
10588a85fb9SMarek Vasut  * Output a debug text when condition "cond" is met. The "cond" should be
10688a85fb9SMarek Vasut  * computed by a preprocessor in the best case, allowing for the best
10788a85fb9SMarek Vasut  * optimization.
10888a85fb9SMarek Vasut  */
10988a85fb9SMarek Vasut #define debug_cond(cond, fmt, args...)			\
11088a85fb9SMarek Vasut 	do {						\
11188a85fb9SMarek Vasut 		if (cond)				\
112be25d875SThierry Reding 			printf(pr_fmt(fmt), ##args);	\
11388a85fb9SMarek Vasut 	} while (0)
11488a85fb9SMarek Vasut 
11588a85fb9SMarek Vasut #define debug(fmt, args...)			\
11688a85fb9SMarek Vasut 	debug_cond(_DEBUG, fmt, ##args)
11788a85fb9SMarek Vasut 
11888a85fb9SMarek Vasut /*
11921726a7aSSimon Glass  * An assertion is run-time check done in debug mode only. If DEBUG is not
12021726a7aSSimon Glass  * defined then it is skipped. If DEBUG is defined and the assertion fails,
12121726a7aSSimon Glass  * then it calls panic*( which may or may not reset/halt U-Boot (see
12221726a7aSSimon Glass  * CONFIG_PANIC_HANG), It is hoped that all failing assertions are found
12321726a7aSSimon Glass  * before release, and after release it is hoped that they don't matter. But
12421726a7aSSimon Glass  * in any case these failing assertions cannot be fixed with a reset (which
12521726a7aSSimon Glass  * may just do the same assertion again).
12621726a7aSSimon Glass  */
12721726a7aSSimon Glass void __assert_fail(const char *assertion, const char *file, unsigned line,
12821726a7aSSimon Glass 		   const char *function);
12921726a7aSSimon Glass #define assert(x) \
13021726a7aSSimon Glass 	({ if (!(x) && _DEBUG) \
13121726a7aSSimon Glass 		__assert_fail(#x, __FILE__, __LINE__, __func__); })
13221726a7aSSimon Glass 
133594d57d0SMatthias Kaehlcke #define error(fmt, args...) do {					\
134be25d875SThierry Reding 		printf("ERROR: " pr_fmt(fmt) "\nat %s:%d/%s()\n",	\
135594d57d0SMatthias Kaehlcke 			##args, __FILE__, __LINE__, __func__);		\
136594d57d0SMatthias Kaehlcke } while (0)
137594d57d0SMatthias Kaehlcke 
138cfa460adSWilliam Juul #ifndef BUG
13943835aacSDetlev Zundel #define BUG() do { \
14043835aacSDetlev Zundel 	printf("BUG: failure at %s:%d/%s()!\n", __FILE__, __LINE__, __FUNCTION__); \
14143835aacSDetlev Zundel 	panic("BUG!"); \
14243835aacSDetlev Zundel } while (0)
14343835aacSDetlev Zundel #define BUG_ON(condition) do { if (unlikely((condition)!=0)) BUG(); } while(0)
144cfa460adSWilliam Juul #endif /* BUG */
14543835aacSDetlev Zundel 
146c00e17c7SHeiko Schocher /* Force a compilation error if condition is true */
147c00e17c7SHeiko Schocher #define BUILD_BUG_ON(condition) ((void)sizeof(char[1 - 2*!!(condition)]))
148c00e17c7SHeiko Schocher 
149e2211743Swdenk typedef void (interrupt_handler_t)(void *);
150e2211743Swdenk 
151e2211743Swdenk #include <asm/u-boot.h> /* boot information for Linux kernel */
152e2211743Swdenk #include <asm/global_data.h>	/* global data used for startup functions */
153e2211743Swdenk 
15471f95118Swdenk /*
15571f95118Swdenk  * enable common handling for all TQM8xxL/M boards:
15611d9eec4SMartin Krause  * - CONFIG_TQM8xxM will be defined for all TQM8xxM boards
15771f95118Swdenk  * - CONFIG_TQM8xxL will be defined for all TQM8xxL _and_ TQM8xxM boards
15811d9eec4SMartin Krause  *                  and for the TQM885D board
15971f95118Swdenk  */
16071f95118Swdenk #if defined(CONFIG_TQM823M) || defined(CONFIG_TQM850M) || \
16171f95118Swdenk     defined(CONFIG_TQM855M) || defined(CONFIG_TQM860M) || \
16211d9eec4SMartin Krause     defined(CONFIG_TQM862M) || defined(CONFIG_TQM866M)
16371f95118Swdenk # ifndef CONFIG_TQM8xxM
16471f95118Swdenk #  define CONFIG_TQM8xxM
16571f95118Swdenk # endif
16671f95118Swdenk #endif
167e2211743Swdenk #if defined(CONFIG_TQM823L) || defined(CONFIG_TQM850L) || \
168d126bfbdSwdenk     defined(CONFIG_TQM855L) || defined(CONFIG_TQM860L) || \
16911d9eec4SMartin Krause     defined(CONFIG_TQM862L) || defined(CONFIG_TQM8xxM) || \
17011d9eec4SMartin Krause     defined(CONFIG_TQM885D)
171e2211743Swdenk # ifndef CONFIG_TQM8xxL
172e2211743Swdenk #  define CONFIG_TQM8xxL
173e2211743Swdenk # endif
174e2211743Swdenk #endif
175e2211743Swdenk 
1763fbeeea6SHeiko Schocher #if defined(CONFIG_ENV_IS_EMBEDDED)
1773fbeeea6SHeiko Schocher #define TOTAL_MALLOC_LEN	CONFIG_SYS_MALLOC_LEN
1783fbeeea6SHeiko Schocher #elif ( ((CONFIG_ENV_ADDR+CONFIG_ENV_SIZE) < CONFIG_SYS_MONITOR_BASE) || \
1793fbeeea6SHeiko Schocher 	(CONFIG_ENV_ADDR >= (CONFIG_SYS_MONITOR_BASE + CONFIG_SYS_MONITOR_LEN)) ) || \
1803fbeeea6SHeiko Schocher       defined(CONFIG_ENV_IS_IN_NVRAM)
1813fbeeea6SHeiko Schocher #define	TOTAL_MALLOC_LEN	(CONFIG_SYS_MALLOC_LEN + CONFIG_ENV_SIZE)
1823fbeeea6SHeiko Schocher #else
1833fbeeea6SHeiko Schocher #define	TOTAL_MALLOC_LEN	CONFIG_SYS_MALLOC_LEN
1843fbeeea6SHeiko Schocher #endif
185c7de829cSwdenk 
186c7de829cSwdenk /*
187e2211743Swdenk  * Function Prototypes
188e2211743Swdenk  */
1890267ba5dSMichal Simek int dram_init(void);
190e2211743Swdenk 
191e2211743Swdenk void	hang		(void) __attribute__ ((noreturn));
192e2211743Swdenk 
193f6c019c4SWolfgang Denk int	timer_init(void);
194f6c019c4SWolfgang Denk int	cpu_init(void);
195f6c019c4SWolfgang Denk 
196e2211743Swdenk /* */
1979973e3c6SBecky Bruce phys_size_t initdram (int);
198c6da9ae8SSimon Glass 
1992ea09c83SSimon Glass #include <display_options.h>
200e2211743Swdenk 
201e2211743Swdenk /* common/main.c */
202e2211743Swdenk void	main_loop	(void);
203009dde19SSimon Glass int run_command(const char *cmd, int flag);
2041d43bfd2SThomas Betker int run_command_repeatable(const char *cmd, int flag);
205d51004a8SSimon Glass 
206d51004a8SSimon Glass /**
207d51004a8SSimon Glass  * Run a list of commands separated by ; or even \0
208d51004a8SSimon Glass  *
209d51004a8SSimon Glass  * Note that if 'len' is not -1, then the command does not need to be nul
210d51004a8SSimon Glass  * terminated, Memory will be allocated for the command in that case.
211d51004a8SSimon Glass  *
212d51004a8SSimon Glass  * @param cmd	List of commands to run, each separated bu semicolon
213d51004a8SSimon Glass  * @param len	Length of commands excluding terminator if known (-1 if not)
214d51004a8SSimon Glass  * @param flag	Execution flags (CMD_FLAG_...)
215d51004a8SSimon Glass  * @return 0 on success, or != 0 on error.
216d51004a8SSimon Glass  */
217d51004a8SSimon Glass int run_command_list(const char *cmd, int len, int flag);
218e3150460SIgor Grinberg extern char console_buffer[];
219e2211743Swdenk 
220ea0364f1SPeter Tyser /* arch/$(ARCH)/lib/board.c */
221e05e5de7SAlbert ARIBAUD void board_init_f(ulong);
2226d1b6f9fSMike Frysinger void board_init_r(gd_t *, ulong) __attribute__ ((noreturn));
2231fed87dbSSimon Glass 
2241fed87dbSSimon Glass /**
2251fed87dbSSimon Glass  * board_init_f_mem() - Allocate global data and set stack position
2261fed87dbSSimon Glass  *
2271fed87dbSSimon Glass  * This function is called by each architecture very early in the start-up
2281fed87dbSSimon Glass  * code to set up the environment for board_init_f(). It allocates space for
2291fed87dbSSimon Glass  * global_data (see include/asm-generic/global_data.h) and places the stack
2301fed87dbSSimon Glass  * below this.
2311fed87dbSSimon Glass  *
2321fed87dbSSimon Glass  * This function requires a stack[1] Normally this is at @top. The function
2331fed87dbSSimon Glass  * starts allocating space from 64 bytes below @top. First it creates space
2341fed87dbSSimon Glass  * for global_data. Then it calls arch_setup_gd() which sets gd to point to
2351fed87dbSSimon Glass  * the global_data space and can reserve additional bytes of space if
2361fed87dbSSimon Glass  * required). Finally it allocates early malloc() memory
2371fed87dbSSimon Glass  * (CONFIG_SYS_MALLOC_F_LEN). The new top of the stack is just below this,
2381fed87dbSSimon Glass  * and it returned by this function.
2391fed87dbSSimon Glass  *
2401fed87dbSSimon Glass  * [1] Strictly speaking it would be possible to implement this function
2411fed87dbSSimon Glass  * in C on many archs such that it does not require a stack. However this
2421fed87dbSSimon Glass  * does not seem hugely important as only 64 byte are wasted. The 64 bytes
2431fed87dbSSimon Glass  * are used to handle the calling standard which generally requires pushing
2441fed87dbSSimon Glass  * addresses or registers onto the stack. We should be able to get away with
2451fed87dbSSimon Glass  * less if this becomes important.
2461fed87dbSSimon Glass  *
2471fed87dbSSimon Glass  * @top:	Top of available memory, also normally the top of the stack
2481fed87dbSSimon Glass  * @return:	New stack location
2491fed87dbSSimon Glass  */
2501fed87dbSSimon Glass ulong board_init_f_mem(ulong top);
2511fed87dbSSimon Glass 
2521fed87dbSSimon Glass /**
2531fed87dbSSimon Glass  * arch_setup_gd() - Set up the global_data pointer
2541fed87dbSSimon Glass  *
2551fed87dbSSimon Glass  * This pointer is special in some architectures and cannot easily be assigned
2561fed87dbSSimon Glass  * to. For example on x86 it is implemented by adding a specific record to its
2571fed87dbSSimon Glass  * Global Descriptor Table! So we we provide a function to carry out this task.
2581fed87dbSSimon Glass  * For most architectures this can simply be:
2591fed87dbSSimon Glass  *
2601fed87dbSSimon Glass  *    gd = gd_ptr;
2611fed87dbSSimon Glass  *
2621fed87dbSSimon Glass  * @gd_ptr:	Pointer to global data
2631fed87dbSSimon Glass  */
2641fed87dbSSimon Glass void arch_setup_gd(gd_t *gd_ptr);
2651fed87dbSSimon Glass 
266e2211743Swdenk int checkboard(void);
2670365ffccSMasahiro Yamada int show_board_info(void);
268e2211743Swdenk int checkflash(void);
269e2211743Swdenk int checkdram(void);
270e2211743Swdenk int last_stage_init(void);
2713b57fe0aSwdenk extern ulong monitor_flash_len;
272bea3f28dSHaiying Wang int mac_read_from_eeprom(void);
2736ab6b2afSMasahiro Yamada extern u8 __dtb_dt_begin[];	/* embedded device tree blob */
2748f5d4687SHadli, Manjunath int set_cpu_clk_info(void);
2759272a9b4SSimon Glass int mdm_init(void);
276365475e6SMasahiro Yamada #if defined(CONFIG_DISPLAY_CPUINFO)
2771938f4a5SSimon Glass int print_cpuinfo(void);
278365475e6SMasahiro Yamada #else
279365475e6SMasahiro Yamada static inline int print_cpuinfo(void)
280365475e6SMasahiro Yamada {
281365475e6SMasahiro Yamada 	return 0;
282365475e6SMasahiro Yamada }
283365475e6SMasahiro Yamada #endif
284c2240d4dSSimon Glass int update_flash_size(int flash_size);
2852c072c95SSimon Glass int arch_early_init_r(void);
286e2211743Swdenk 
28715a33e49SSimon Glass /**
288d4c671ccSSimon Glass  * arch_cpu_init_dm() - init CPU after driver model is available
289d4c671ccSSimon Glass  *
290d4c671ccSSimon Glass  * This is called immediately after driver model is available before
291d4c671ccSSimon Glass  * relocation. This is similar to arch_cpu_init() but is able to reference
292d4c671ccSSimon Glass  * devices
293d4c671ccSSimon Glass  *
294d4c671ccSSimon Glass  * @return 0 if OK, -ve on error
295d4c671ccSSimon Glass  */
296d4c671ccSSimon Glass int arch_cpu_init_dm(void);
297d4c671ccSSimon Glass 
298d4c671ccSSimon Glass /**
29968145d4cSAndreas Bießmann  * Reserve all necessary stacks
30068145d4cSAndreas Bießmann  *
30168145d4cSAndreas Bießmann  * This is used in generic board init sequence in common/board_f.c. Each
30268145d4cSAndreas Bießmann  * architecture could provide this function to tailor the required stacks.
30368145d4cSAndreas Bießmann  *
30468145d4cSAndreas Bießmann  * On entry gd->start_addr_sp is pointing to the suggested top of the stack.
30568145d4cSAndreas Bießmann  * The callee ensures gd->start_add_sp is 16-byte aligned, so architectures
30668145d4cSAndreas Bießmann  * require only this can leave it untouched.
30768145d4cSAndreas Bießmann  *
30868145d4cSAndreas Bießmann  * On exit gd->start_addr_sp and gd->irq_sp should be set to the respective
30968145d4cSAndreas Bießmann  * positions of the stack. The stack pointer(s) will be set to this later.
31068145d4cSAndreas Bießmann  * gd->irq_sp is only required, if the architecture needs it.
31168145d4cSAndreas Bießmann  *
31268145d4cSAndreas Bießmann  * @return 0 if no error
31368145d4cSAndreas Bießmann  */
31468145d4cSAndreas Bießmann __weak int arch_reserve_stacks(void);
31568145d4cSAndreas Bießmann 
31668145d4cSAndreas Bießmann /**
31715a33e49SSimon Glass  * Show the DRAM size in a board-specific way
31815a33e49SSimon Glass  *
31915a33e49SSimon Glass  * This is used by boards to display DRAM information in their own way.
32015a33e49SSimon Glass  *
32115a33e49SSimon Glass  * @param size	Size of DRAM (which should be displayed along with other info)
32215a33e49SSimon Glass  */
323ea11b401SAndrew Bradford void board_show_dram(phys_size_t size);
32415a33e49SSimon Glass 
32513d06981SSimon Glass /**
326e29607edSMa Haijun  * arch_fixup_fdt() - Write arch-specific information to fdt
32713d06981SSimon Glass  *
328e29607edSMa Haijun  * Defined in arch/$(ARCH)/lib/bootm-fdt.c
32913d06981SSimon Glass  *
33013d06981SSimon Glass  * @blob:	FDT blob to write to
33113d06981SSimon Glass  * @return 0 if ok, or -ve FDT_ERR_... on failure
33213d06981SSimon Glass  */
333e29607edSMa Haijun int arch_fixup_fdt(void *blob);
33413d06981SSimon Glass 
335e2211743Swdenk /* common/flash.c */
336e2211743Swdenk void flash_perror (int);
337e2211743Swdenk 
33874de7aefSWolfgang Denk /* common/cmd_source.c */
33974de7aefSWolfgang Denk int	source (ulong addr, const char *fit_uname);
340e2211743Swdenk 
341e2211743Swdenk extern ulong load_addr;		/* Default Load Address */
3421aec244aSSimon Glass extern ulong save_addr;		/* Default Save Address */
3431aec244aSSimon Glass extern ulong save_size;		/* Default Save Size */
344e2211743Swdenk 
3454394f9a8SWolfgang Denk /* common/cmd_doc.c */
3464394f9a8SWolfgang Denk void	doc_probe(unsigned long physadr);
3474394f9a8SWolfgang Denk 
34806283a64SJason Hobbs /* common/cmd_net.c */
34906283a64SJason Hobbs int do_tftpb(cmd_tbl_t *cmdtp, int flag, int argc, char * const argv[]);
35006283a64SJason Hobbs 
351669df7e4SRob Herring /* common/cmd_fat.c */
352669df7e4SRob Herring int do_fat_fsload(cmd_tbl_t *, int, int, char * const []);
353669df7e4SRob Herring 
354669df7e4SRob Herring /* common/cmd_ext2.c */
355669df7e4SRob Herring int do_ext2load(cmd_tbl_t *, int, int, char * const []);
356669df7e4SRob Herring 
357e2211743Swdenk /* common/cmd_nvedit.c */
358e2211743Swdenk int	env_init     (void);
359e2211743Swdenk void	env_relocate (void);
36026a41790SRafal Jaworowski int	envmatch     (uchar *, int);
36120f86a0aSSimon Glass 
36220f86a0aSSimon Glass /* Avoid unfortunate conflict with libc's getenv() */
36320f86a0aSSimon Glass #ifdef CONFIG_SANDBOX
36420f86a0aSSimon Glass #define getenv uboot_getenv
36520f86a0aSSimon Glass #endif
36684b5e802SWolfgang Denk char	*getenv	     (const char *);
36784b5e802SWolfgang Denk int	getenv_f     (const char *name, char *buf, unsigned len);
3684a9b4131SSimon Glass ulong getenv_ulong(const char *name, int base, ulong default_val);
36976b8f79cSSimon Glass 
37076b8f79cSSimon Glass /**
37176b8f79cSSimon Glass  * getenv_hex() - Return an environment variable as a hex value
37276b8f79cSSimon Glass  *
37376b8f79cSSimon Glass  * Decode an environment as a hex number (it may or may not have a 0x
37476b8f79cSSimon Glass  * prefix). If the environment variable cannot be found, or does not start
37576b8f79cSSimon Glass  * with hex digits, the default value is returned.
37676b8f79cSSimon Glass  *
37776b8f79cSSimon Glass  * @varname:		Variable to decode
37876b8f79cSSimon Glass  * @default_val:	Value to return on error
37976b8f79cSSimon Glass  */
38076b8f79cSSimon Glass ulong getenv_hex(const char *varname, ulong default_val);
38176b8f79cSSimon Glass 
382ec8a252cSJoe Hershberger /*
383ec8a252cSJoe Hershberger  * Read an environment variable as a boolean
384ec8a252cSJoe Hershberger  * Return -1 if variable does not exist (default to true)
385ec8a252cSJoe Hershberger  */
386ec8a252cSJoe Hershberger int getenv_yesno(const char *var);
387e2211743Swdenk int	saveenv	     (void);
38884b5e802SWolfgang Denk int	setenv	     (const char *, const char *);
389d67f10ceSSimon Glass int setenv_ulong(const char *varname, ulong value);
390bfc59966SSimon Glass int setenv_hex(const char *varname, ulong value);
391bfc59966SSimon Glass /**
392bfc59966SSimon Glass  * setenv_addr - Set an environment variable to an address in hex
393bfc59966SSimon Glass  *
3941bce2aebSRobert P. J. Day  * @varname:	Environment variable to set
395bfc59966SSimon Glass  * @addr:	Value to set it to
396bfc59966SSimon Glass  * @return 0 if ok, 1 on error
397bfc59966SSimon Glass  */
398bfc59966SSimon Glass static inline int setenv_addr(const char *varname, const void *addr)
399bfc59966SSimon Glass {
400bfc59966SSimon Glass 	return setenv_hex(varname, (ulong)addr);
401bfc59966SSimon Glass }
402bfc59966SSimon Glass 
403e2211743Swdenk #ifdef CONFIG_ARM
40496085e34Swdenk # include <asm/mach-types.h>
405b6e4c403Swdenk # include <asm/setup.h>
406e2211743Swdenk # include <asm/u-boot-arm.h>	/* ARM version to be fixed! */
407e2211743Swdenk #endif /* CONFIG_ARM */
408fea25720SGraeme Russ #ifdef CONFIG_X86		/* x86 version to be fixed! */
409fea25720SGraeme Russ # include <asm/u-boot-x86.h>
410fea25720SGraeme Russ #endif /* CONFIG_X86 */
411744d9859SSimon Glass #ifdef CONFIG_SANDBOX
412744d9859SSimon Glass # include <asm/u-boot-sandbox.h>	/* TODO(sjg) what needs to be fixed? */
413744d9859SSimon Glass #endif
414e7083844SMacpaul Lin #ifdef CONFIG_NDS32
415e7083844SMacpaul Lin # include <asm/mach-types.h>
416e3c58b02Sken kuo # include <asm/setup.h>
417e7083844SMacpaul Lin # include <asm/u-boot-nds32.h>
418e7083844SMacpaul Lin #endif /* CONFIG_NDS32 */
419e034ea3bSDaniel Schwierzeck #ifdef CONFIG_MIPS
420e034ea3bSDaniel Schwierzeck # include <asm/u-boot-mips.h>
421e034ea3bSDaniel Schwierzeck #endif /* CONFIG_MIPS */
422bc5d5428SAlexey Brodkin #ifdef CONFIG_ARC
423bc5d5428SAlexey Brodkin # include <asm/u-boot-arc.h>
424bc5d5428SAlexey Brodkin #endif /* CONFIG_ARC */
425e2211743Swdenk 
42604a85b3bSwdenk #ifdef CONFIG_AUTO_COMPLETE
42704a85b3bSwdenk int env_complete(char *var, int maxv, char *cmdv[], int maxsz, char *buf);
42804a85b3bSwdenk #endif
4292f70c49eSHeiko Schocher int get_env_id (void);
43004a85b3bSwdenk 
431e2211743Swdenk void	pci_init      (void);
432ad10dd9aSstroese void	pci_init_board(void);
433e2211743Swdenk void	pciinfo	      (int, int);
434e2211743Swdenk 
435a821d08dSStefan Roese #if defined(CONFIG_PCI) && defined(CONFIG_4xx)
436e2211743Swdenk     int	   pci_pre_init	       (struct pci_controller *);
437c71103f9SMatthias Fuchs     int	   is_pci_host	       (struct pci_controller *);
438e2211743Swdenk #endif
439466fff1aSStefan Roese 
440dbbd1257SStefan Roese #if defined(CONFIG_PCI) && (defined(CONFIG_440) || defined(CONFIG_405EX))
4416d0f6bcfSJean-Christophe PLAGNIOL-VILLARD #   if defined(CONFIG_SYS_PCI_TARGET_INIT)
442e2211743Swdenk 	void	pci_target_init	     (struct pci_controller *);
443e2211743Swdenk #   endif
4446d0f6bcfSJean-Christophe PLAGNIOL-VILLARD #   if defined(CONFIG_SYS_PCI_MASTER_INIT)
445e2211743Swdenk 	void	pci_master_init	     (struct pci_controller *);
446e2211743Swdenk #   endif
4476f2eb3f3SStefan Roese #if defined(CONFIG_440SPE) || \
4486f2eb3f3SStefan Roese     defined(CONFIG_460EX) || defined(CONFIG_460GT) || \
4496f2eb3f3SStefan Roese     defined(CONFIG_405EX)
4507f191393SGrzegorz Bernacki    void pcie_setup_hoses(int busno);
451692519b1SRafal Jaworowski #endif
452e2211743Swdenk #endif
453e2211743Swdenk 
454e2211743Swdenk int	misc_init_f   (void);
455e2211743Swdenk int	misc_init_r   (void);
456e2211743Swdenk 
45727b207fdSwdenk /* common/exports.c */
45827b207fdSwdenk void	jumptable_init(void);
45927b207fdSwdenk 
460ecb1dc89SMike Frysinger /* common/kallsysm.c */
461ecb1dc89SMike Frysinger const char *symbol_lookup(unsigned long addr, unsigned long *caddr);
462ecb1dc89SMike Frysinger 
463500856ebSRafal Jaworowski /* api/api.c */
464500856ebSRafal Jaworowski void	api_init (void);
465500856ebSRafal Jaworowski 
466c83bf6a2Swdenk /* common/memsize.c */
467a55d23ccSAlbert ARIBAUD long	get_ram_size  (long *, long);
468e3866163SYork Sun phys_size_t get_effective_memsize(void);
469c83bf6a2Swdenk 
470e2211743Swdenk /* $(BOARD)/$(BOARD).c */
471e2211743Swdenk void	reset_phy     (void);
4727f6c2cbcSwdenk void	fdc_hw_init   (void);
473e2211743Swdenk 
474e2211743Swdenk /* $(BOARD)/eeprom.c */
475e2211743Swdenk void eeprom_init  (void);
4766dd652faSwdenk #ifndef CONFIG_SPI
4776dd652faSwdenk int  eeprom_probe (unsigned dev_addr, unsigned offset);
4786dd652faSwdenk #endif
479e2211743Swdenk int  eeprom_read  (unsigned dev_addr, unsigned offset, uchar *buffer, unsigned cnt);
480e2211743Swdenk int  eeprom_write (unsigned dev_addr, unsigned offset, uchar *buffer, unsigned cnt);
481e2211743Swdenk 
482e2211743Swdenk /*
483e2211743Swdenk  * Set this up regardless of board
484e2211743Swdenk  * type, to prevent errors.
485e2211743Swdenk  */
4866d0f6bcfSJean-Christophe PLAGNIOL-VILLARD #if defined(CONFIG_SPI) || !defined(CONFIG_SYS_I2C_EEPROM_ADDR)
4876d0f6bcfSJean-Christophe PLAGNIOL-VILLARD # define CONFIG_SYS_DEF_EEPROM_ADDR 0
488e2211743Swdenk #else
489548738b4SHeiko Schocher #if !defined(CONFIG_ENV_EEPROM_IS_ON_I2C)
4906d0f6bcfSJean-Christophe PLAGNIOL-VILLARD # define CONFIG_SYS_DEF_EEPROM_ADDR CONFIG_SYS_I2C_EEPROM_ADDR
491548738b4SHeiko Schocher #endif
4926d0f6bcfSJean-Christophe PLAGNIOL-VILLARD #endif /* CONFIG_SPI || !defined(CONFIG_SYS_I2C_EEPROM_ADDR) */
493e2211743Swdenk 
494bdccc4feSwdenk #if defined(CONFIG_SPI)
495e2211743Swdenk extern void spi_init_f (void);
496e2211743Swdenk extern void spi_init_r (void);
497e2211743Swdenk extern ssize_t spi_read	 (uchar *, int, uchar *, int);
498e2211743Swdenk extern ssize_t spi_write (uchar *, int, uchar *, int);
499e2211743Swdenk #endif
500e2211743Swdenk 
501e2211743Swdenk /* $(BOARD)/$(BOARD).c */
502c837dcb1Swdenk int board_early_init_f (void);
503c837dcb1Swdenk int board_late_init (void);
504e2211743Swdenk int board_postclk_init (void); /* after clocks/timebase, before env/serial */
505c837dcb1Swdenk int board_early_init_r (void);
506e2211743Swdenk void board_poweroff (void);
507e2211743Swdenk 
5086d0f6bcfSJean-Christophe PLAGNIOL-VILLARD #if defined(CONFIG_SYS_DRAM_TEST)
509e2211743Swdenk int testdram(void);
5106d0f6bcfSJean-Christophe PLAGNIOL-VILLARD #endif /* CONFIG_SYS_DRAM_TEST */
511e2211743Swdenk 
512e2211743Swdenk /* $(CPU)/start.S */
5130db5bca8Swdenk #if defined(CONFIG_5xx) || \
5140db5bca8Swdenk     defined(CONFIG_8xx)
515e2211743Swdenk uint	get_immr      (uint);
516e2211743Swdenk #endif
51736c72877Swdenk #if defined(CONFIG_MPC5xxx)
51836c72877Swdenk uint	get_svr       (void);
51936c72877Swdenk #endif
520e2211743Swdenk uint	get_pvr	      (void);
521547b4cb2Swdenk uint	get_svr	      (void);
522e2211743Swdenk uint	rd_ic_cst     (void);
523e2211743Swdenk void	wr_ic_cst     (uint);
524e2211743Swdenk void	wr_ic_adr     (uint);
525e2211743Swdenk uint	rd_dc_cst     (void);
526e2211743Swdenk void	wr_dc_cst     (uint);
527e2211743Swdenk void	wr_dc_adr     (uint);
528e2211743Swdenk int	icache_status (void);
529e2211743Swdenk void	icache_enable (void);
530e2211743Swdenk void	icache_disable(void);
531e2211743Swdenk int	dcache_status (void);
532e2211743Swdenk void	dcache_enable (void);
533e2211743Swdenk void	dcache_disable(void);
5342c451f78SAneesh V void	mmu_disable(void);
5355c6db120SBenoît Thébaudeau #if defined(CONFIG_ARM)
5365c6db120SBenoît Thébaudeau void	relocate_code(ulong);
5375c6db120SBenoît Thébaudeau #else
5385c6db120SBenoît Thébaudeau void	relocate_code(ulong, gd_t *, ulong) __attribute__ ((noreturn));
539959eaa74SBenoît Thébaudeau #endif
540e2211743Swdenk ulong	get_endaddr   (void);
541e2211743Swdenk void	trap_init     (ulong);
542e2211743Swdenk #if defined (CONFIG_4xx)	|| \
543eeb1b77bSwdenk     defined (CONFIG_MPC5xxx)	|| \
544cd94ba39SMarian Balakowicz     defined (CONFIG_MPC85xx)	|| \
545debb7354SJon Loeliger     defined (CONFIG_MPC86xx)	|| \
5460f898604SPeter Tyser     defined (CONFIG_MPC83xx)
547e2211743Swdenk unsigned char	in8(unsigned int);
548e2211743Swdenk void		out8(unsigned int, unsigned char);
549e2211743Swdenk unsigned short	in16(unsigned int);
550e2211743Swdenk unsigned short	in16r(unsigned int);
551e2211743Swdenk void		out16(unsigned int, unsigned short value);
552e2211743Swdenk void		out16r(unsigned int, unsigned short value);
553e2211743Swdenk unsigned long	in32(unsigned int);
554e2211743Swdenk unsigned long	in32r(unsigned int);
555e2211743Swdenk void		out32(unsigned int, unsigned long value);
556e2211743Swdenk void		out32r(unsigned int, unsigned long value);
557e2211743Swdenk void		ppcDcbf(unsigned long value);
558e2211743Swdenk void		ppcDcbi(unsigned long value);
559e2211743Swdenk void		ppcSync(void);
5600ac6f8b7Swdenk void		ppcDcbz(unsigned long value);
561e2211743Swdenk #endif
5620643631aSMichal Simek #if defined (CONFIG_MICROBLAZE)
5630643631aSMichal Simek unsigned short	in16(unsigned int);
5640643631aSMichal Simek void		out16(unsigned int, unsigned short value);
5650643631aSMichal Simek #endif
566e2211743Swdenk 
5670f898604SPeter Tyser #if defined (CONFIG_MPC83xx)
56890f30a71SDave Liu void		ppcDWload(unsigned int *addr, unsigned int *ret);
56990f30a71SDave Liu void		ppcDWstore(unsigned int *addr, unsigned int *value);
5707c6db910SHeiko Schocher void disable_addr_trans(void);
5717c6db910SHeiko Schocher void enable_addr_trans(void);
5727c6db910SHeiko Schocher #if defined(CONFIG_DDR_ECC) && !defined(CONFIG_ECC_INIT_VIA_DDRCONTROLLER)
5737c6db910SHeiko Schocher void ddr_enable_ecc(unsigned int dram_size);
5747c6db910SHeiko Schocher #endif
57590f30a71SDave Liu #endif
57690f30a71SDave Liu 
577fc9ae1baSRajeshwari Shinde /*
578fc9ae1baSRajeshwari Shinde  * Return the current value of a monotonically increasing microsecond timer.
579fc9ae1baSRajeshwari Shinde  * Granularity may be larger than 1us if hardware does not support this.
580fc9ae1baSRajeshwari Shinde  */
581fc9ae1baSRajeshwari Shinde ulong timer_get_us(void);
582fc9ae1baSRajeshwari Shinde 
583e2211743Swdenk /* $(CPU)/cpu.c */
584fbb9ecf7STimur Tabi static inline int cpumask_next(int cpu, unsigned int mask)
585fbb9ecf7STimur Tabi {
586fbb9ecf7STimur Tabi 	for (cpu++; !((1 << cpu) & mask); cpu++)
587fbb9ecf7STimur Tabi 		;
588fbb9ecf7STimur Tabi 
589fbb9ecf7STimur Tabi 	return cpu;
590fbb9ecf7STimur Tabi }
591fbb9ecf7STimur Tabi 
592fbb9ecf7STimur Tabi #define for_each_cpu(iter, cpu, num_cpus, mask) \
593fbb9ecf7STimur Tabi 	for (iter = 0, cpu = cpumask_next(-1, mask); \
594fbb9ecf7STimur Tabi 		iter < num_cpus; \
595fbb9ecf7STimur Tabi 		iter++, cpu = cpumask_next(cpu, mask)) \
596fbb9ecf7STimur Tabi 
5970e870980SPoonam Aggrwal int	cpu_numcores  (void);
598b8bf0adcSShaveta Leekha int	cpu_num_dspcores(void);
599fbb9ecf7STimur Tabi u32	cpu_mask      (void);
600b8bf0adcSShaveta Leekha u32	cpu_dsp_mask(void);
601fbb9ecf7STimur Tabi int	is_core_valid (unsigned int);
6020e870980SPoonam Aggrwal int	probecpu      (void);
603e2211743Swdenk int	checkcpu      (void);
604e2211743Swdenk int	checkicache   (void);
605e2211743Swdenk int	checkdcache   (void);
606e2211743Swdenk void	upmconfig     (unsigned int, unsigned int *, unsigned int);
607e2211743Swdenk ulong	get_tbclk     (void);
6081fb4dab2SPrzemyslaw Marczak void	reset_misc    (void);
6093ec924a3Swdenk void	reset_cpu     (ulong addr);
6106a16e0dfSKim Phillips #if defined (CONFIG_OF_LIBFDT) && defined (CONFIG_OF_BOARD_SETUP)
6116a16e0dfSKim Phillips void ft_cpu_setup(void *blob, bd_t *bd);
6126a16e0dfSKim Phillips #ifdef CONFIG_PCI
6136a16e0dfSKim Phillips void ft_pci_setup(void *blob, bd_t *bd);
6146a16e0dfSKim Phillips #endif
6156a16e0dfSKim Phillips #endif
6166a16e0dfSKim Phillips 
617ba6a1698SAndre Przywara void smp_set_core_boot_addr(unsigned long addr, int corenr);
618ba6a1698SAndre Przywara void smp_kick_all_cpus(void);
619e2211743Swdenk 
620e2211743Swdenk /* $(CPU)/serial.c */
621e2211743Swdenk int	serial_init   (void);
622e2211743Swdenk void	serial_setbrg (void);
623e2211743Swdenk void	serial_putc   (const char);
624756f586aSwdenk void	serial_putc_raw(const char);
625e2211743Swdenk void	serial_puts   (const char *);
626e2211743Swdenk int	serial_getc   (void);
627e2211743Swdenk int	serial_tstc   (void);
628e2211743Swdenk 
629709ea543SSimon Glass /* These versions take a stdio_dev pointer */
630709ea543SSimon Glass struct stdio_dev;
631709ea543SSimon Glass int serial_stub_getc(struct stdio_dev *sdev);
632709ea543SSimon Glass int serial_stub_tstc(struct stdio_dev *sdev);
633709ea543SSimon Glass 
634e2211743Swdenk /* $(CPU)/speed.c */
635e2211743Swdenk int	get_clocks (void);
636c178d3daSwdenk int	get_clocks_866 (void);
637c178d3daSwdenk int	sdram_adjust_866 (void);
638e9132ea9Swdenk int	adjust_sdram_tbs_8xx (void);
63958dac327SMasahiro Yamada #if defined(CONFIG_MPC8260)
640e2211743Swdenk int	prt_8260_clks (void);
641f046ccd1SEran Liberty #elif defined(CONFIG_MPC5xxx)
642945af8d7Swdenk int	prt_mpc5xxx_clks (void);
643945af8d7Swdenk #endif
644e2211743Swdenk #ifdef CONFIG_4xx
645e2211743Swdenk ulong	get_OPB_freq (void);
646e2211743Swdenk ulong	get_PCI_freq (void);
647e2211743Swdenk #endif
648ac67804fSkevin.morfitt@fearnside-systems.co.uk #if defined(CONFIG_S3C24X0) || \
649ac67804fSkevin.morfitt@fearnside-systems.co.uk     defined(CONFIG_LH7A40X) || \
650fcfb632bSMatthias Kaehlcke     defined(CONFIG_EP93XX)
651e2211743Swdenk ulong	get_FCLK (void);
652e2211743Swdenk ulong	get_HCLK (void);
653e2211743Swdenk ulong	get_PCLK (void);
654e2211743Swdenk ulong	get_UCLK (void);
655e2211743Swdenk #endif
656f39748aeSwdenk #if defined(CONFIG_LH7A40X)
657f39748aeSwdenk ulong	get_PLLCLK (void);
658f39748aeSwdenk #endif
659281e00a3Swdenk #if defined(CONFIG_IMX)
660281e00a3Swdenk ulong get_systemPLLCLK(void);
661281e00a3Swdenk ulong get_FCLK(void);
662281e00a3Swdenk ulong get_HCLK(void);
663281e00a3Swdenk ulong get_BCLK(void);
664281e00a3Swdenk ulong get_PERCLK1(void);
665281e00a3Swdenk ulong get_PERCLK2(void);
666281e00a3Swdenk ulong get_PERCLK3(void);
667281e00a3Swdenk #endif
668e2211743Swdenk ulong	get_bus_freq  (ulong);
669550650ddSStefan Roese int get_serial_clock(void);
670e2211743Swdenk 
67142d1f039Swdenk #if defined(CONFIG_MPC85xx)
67242d1f039Swdenk typedef MPC85xx_SYS_INFO sys_info_t;
67342d1f039Swdenk void	get_sys_info  ( sys_info_t * );
674871a57bbSMiao Yan #  if defined(CONFIG_OF_LIBFDT)
675871a57bbSMiao Yan 	void ft_fixup_cpu(void *, u64);
676871a57bbSMiao Yan 	void ft_fixup_num_cores(void *);
677871a57bbSMiao Yan #  endif
67842d1f039Swdenk #endif
679debb7354SJon Loeliger #if defined(CONFIG_MPC86xx)
680debb7354SJon Loeliger typedef MPC86xx_SYS_INFO sys_info_t;
681debb7354SJon Loeliger void   get_sys_info  ( sys_info_t * );
6825df4b0adSKumar Gala static inline ulong get_ddr_freq(ulong dummy)
6835df4b0adSKumar Gala {
6845df4b0adSKumar Gala 	return get_bus_freq(dummy);
6855df4b0adSKumar Gala }
6862f78eae5SYork Sun #else
6872f78eae5SYork Sun ulong get_ddr_freq(ulong);
688debb7354SJon Loeliger #endif
68942d1f039Swdenk 
69099bcad18SStefan Roese #if defined(CONFIG_4xx)
691e2211743Swdenk #  if defined(CONFIG_440)
6926c5879f3SMarian Balakowicz #	if defined(CONFIG_440SPE)
6936c5879f3SMarian Balakowicz 	 unsigned long determine_sysper(void);
6946c5879f3SMarian Balakowicz 	 unsigned long determine_pci_clock_per(void);
6956c5879f3SMarian Balakowicz #	endif
696e2211743Swdenk #  endif
697087dfdb7SStefan Roese typedef PPC4xx_SYS_INFO sys_info_t;
698f31d38b9SStefan Roese int	ppc440spe_revB(void);
699e2211743Swdenk void	get_sys_info  ( sys_info_t * );
700e2211743Swdenk #endif
701e2211743Swdenk 
702e2211743Swdenk /* $(CPU)/cpu_init.c */
70358dac327SMasahiro Yamada #if defined(CONFIG_8xx) || defined(CONFIG_MPC8260)
704e2211743Swdenk void	cpu_init_f    (volatile immap_t *immr);
705e2211743Swdenk #endif
706701e6401SYork Sun #if defined(CONFIG_4xx) || defined(CONFIG_MCF52x2) || defined(CONFIG_MPC86xx)
707e2211743Swdenk void	cpu_init_f    (void);
708e2211743Swdenk #endif
709701e6401SYork Sun #ifdef CONFIG_MPC85xx
710701e6401SYork Sun ulong cpu_init_f(void);
711701e6401SYork Sun #endif
712bf9e3b38Swdenk 
713e2211743Swdenk int	cpu_init_r    (void);
71458dac327SMasahiro Yamada #if defined(CONFIG_MPC8260)
715e2211743Swdenk int	prt_8260_rsr  (void);
7160f898604SPeter Tyser #elif defined(CONFIG_MPC83xx)
7179be39a67SDave Liu int	prt_83xx_rsr  (void);
718e2211743Swdenk #endif
719e2211743Swdenk 
720e2211743Swdenk /* $(CPU)/interrupts.c */
721e2211743Swdenk int	interrupt_init	   (void);
722e2211743Swdenk void	timer_interrupt	   (struct pt_regs *);
723e2211743Swdenk void	external_interrupt (struct pt_regs *);
724e2211743Swdenk void	irq_install_handler(int, interrupt_handler_t *, void *);
725e2211743Swdenk void	irq_free_handler   (int);
726e2211743Swdenk void	reset_timer	   (void);
727e2211743Swdenk ulong	get_timer	   (ulong base);
728b2e16a85SSimon Glass 
729b2e16a85SSimon Glass /* Return value of monotonic microsecond timer */
730b2e16a85SSimon Glass unsigned long timer_get_us(void);
731b2e16a85SSimon Glass 
732e2211743Swdenk void	enable_interrupts  (void);
733e2211743Swdenk int	disable_interrupts (void);
734e2211743Swdenk 
735e2211743Swdenk /* $(CPU)/.../commproc.c */
736e2211743Swdenk int	dpram_init (void);
737e2211743Swdenk uint	dpram_base(void);
738e2211743Swdenk uint	dpram_base_align(uint align);
739e2211743Swdenk uint	dpram_alloc(uint size);
740e2211743Swdenk uint	dpram_alloc_align(uint size,uint align);
741bdccc4feSwdenk void	bootcount_store (ulong);
742bdccc4feSwdenk ulong	bootcount_load (void);
743bdccc4feSwdenk #define BOOTCOUNT_MAGIC		0xB001C041
744e2211743Swdenk 
745e2211743Swdenk /* $(CPU)/.../<eth> */
746c5bded3cSWolfgang Denk void mii_init (void);
747e2211743Swdenk 
748e2211743Swdenk /* $(CPU)/.../lcd.c */
749e2211743Swdenk ulong	lcd_setmem (ulong);
750e2211743Swdenk 
751e2211743Swdenk /* $(CPU)/.../video.c */
752e2211743Swdenk ulong	video_setmem (ulong);
753e2211743Swdenk 
754ea0364f1SPeter Tyser /* arch/$(ARCH)/lib/cache.c */
755cba4b180SAneesh V void	enable_caches(void);
756e2211743Swdenk void	flush_cache   (unsigned long, unsigned long);
7572c451f78SAneesh V void	flush_dcache_all(void);
75803d3bfb0SStefan Roese void	flush_dcache_range(unsigned long start, unsigned long stop);
75903d3bfb0SStefan Roese void	invalidate_dcache_range(unsigned long start, unsigned long stop);
7602c451f78SAneesh V void	invalidate_dcache_all(void);
7612c451f78SAneesh V void	invalidate_icache_all(void);
7620db5bca8Swdenk 
7634d24a11eSSimon Glass enum {
7644d24a11eSSimon Glass 	/* Disable caches (else flush caches but leave them active) */
7654d24a11eSSimon Glass 	CBL_DISABLE_CACHES		= 1 << 0,
7664d24a11eSSimon Glass 	CBL_SHOW_BOOTSTAGE_REPORT	= 1 << 1,
7674d24a11eSSimon Glass 
7684d24a11eSSimon Glass 	CBL_ALL				= 3,
7694d24a11eSSimon Glass };
7704d24a11eSSimon Glass 
7714d24a11eSSimon Glass /**
7724d24a11eSSimon Glass  * Clean up ready for linux
7734d24a11eSSimon Glass  *
7744d24a11eSSimon Glass  * @param flags		Flags to control what is done
7754d24a11eSSimon Glass  */
7764d24a11eSSimon Glass int cleanup_before_linux_select(int flags);
7774d24a11eSSimon Glass 
778ea0364f1SPeter Tyser /* arch/$(ARCH)/lib/ticks.S */
77919ea4678SSimon Glass uint64_t get_ticks(void);
780e2211743Swdenk void	wait_ticks    (unsigned long);
781e2211743Swdenk 
782ea0364f1SPeter Tyser /* arch/$(ARCH)/lib/time.c */
7833eb90badSIngo van Lil void	__udelay      (unsigned long);
784e2211743Swdenk ulong	usec2ticks    (unsigned long usec);
785e2211743Swdenk ulong	ticks2usec    (unsigned long ticks);
786e2211743Swdenk int	init_timebase (void);
787e2211743Swdenk 
78878acc472SPeter Tyser /* lib/gunzip.c */
78987d93a1bSWolfgang Wegner int gunzip(void *, int, unsigned char *, unsigned long *);
79087d93a1bSWolfgang Wegner int zunzip(void *dst, int dstlen, unsigned char *src, unsigned long *lenp,
79187d93a1bSWolfgang Wegner 						int stoponerr, int offset);
79287d93a1bSWolfgang Wegner 
793918e9ebbSEric Nelson /**
794918e9ebbSEric Nelson  * gzwrite progress indicators: defined weak to allow board-specific
795918e9ebbSEric Nelson  * overrides:
796918e9ebbSEric Nelson  *
797918e9ebbSEric Nelson  *	gzwrite_progress_init called on startup
798918e9ebbSEric Nelson  *	gzwrite_progress called during decompress/write loop
799918e9ebbSEric Nelson  *	gzwrite_progress_finish called at end of loop to
800918e9ebbSEric Nelson  *		indicate success (retcode=0) or failure
801918e9ebbSEric Nelson  */
802918e9ebbSEric Nelson void gzwrite_progress_init(u64 expected_size);
803918e9ebbSEric Nelson 
804918e9ebbSEric Nelson void gzwrite_progress(int iteration,
805918e9ebbSEric Nelson 		     u64 bytes_written,
806918e9ebbSEric Nelson 		     u64 total_bytes);
807918e9ebbSEric Nelson 
808918e9ebbSEric Nelson void gzwrite_progress_finish(int retcode,
809918e9ebbSEric Nelson 			     u64 totalwritten,
810918e9ebbSEric Nelson 			     u64 totalsize,
811918e9ebbSEric Nelson 			     u32 expected_crc,
812918e9ebbSEric Nelson 			     u32 calculated_crc);
813918e9ebbSEric Nelson 
814918e9ebbSEric Nelson /**
815918e9ebbSEric Nelson  * decompress and write gzipped image from memory to block device
816918e9ebbSEric Nelson  *
817918e9ebbSEric Nelson  * @param	src		compressed image address
818918e9ebbSEric Nelson  * @param	len		compressed image length in bytes
819918e9ebbSEric Nelson  * @param	dev		block device descriptor
820918e9ebbSEric Nelson  * @param	szwritebuf	bytes per write (pad to erase size)
821918e9ebbSEric Nelson  * @param	startoffs	offset in bytes of first write
822918e9ebbSEric Nelson  * @param	szexpected	expected uncompressed length
823918e9ebbSEric Nelson  *				may be zero to use gzip trailer
824918e9ebbSEric Nelson  *				for files under 4GiB
825918e9ebbSEric Nelson  */
826918e9ebbSEric Nelson int gzwrite(unsigned char *src, int len,
827918e9ebbSEric Nelson 	    struct block_dev_desc *dev,
828918e9ebbSEric Nelson 	    unsigned long szwritebuf,
829918e9ebbSEric Nelson 	    u64 startoffs,
830918e9ebbSEric Nelson 	    u64 szexpected);
831918e9ebbSEric Nelson 
832027b728dSJulius Werner /* lib/lz4_wrapper.c */
833027b728dSJulius Werner int ulz4fn(const void *src, size_t srcn, void *dst, size_t *dstn);
834027b728dSJulius Werner 
83554c6977eSWolfgang Denk /* lib/qsort.c */
83654c6977eSWolfgang Denk void qsort(void *base, size_t nmemb, size_t size,
83754c6977eSWolfgang Denk 	   int(*compar)(const void *, const void *));
838560d424bSMike Frysinger int strcmp_compar(const void *, const void *);
83954c6977eSWolfgang Denk 
84078acc472SPeter Tyser /* lib/time.c */
8413eb90badSIngo van Lil void	udelay        (unsigned long);
842c4c9fbebSAnatolij Gustschin void mdelay(unsigned long);
8433eb90badSIngo van Lil 
844e11938eaSJason Hobbs /* lib/uuid.c */
845d718ded0SPrzemyslaw Marczak #include <uuid.h>
846e11938eaSJason Hobbs 
84778acc472SPeter Tyser /* lib/vsprintf.c */
8489785c905SSimon Glass #include <vsprintf.h>
849e2211743Swdenk 
85078acc472SPeter Tyser /* lib/strmhz.c */
85155f7934dSEd Swarthout char *	strmhz(char *buf, unsigned long hz);
8520768b7a8SHaavard Skinnemoen 
85378acc472SPeter Tyser /* lib/crc32.c */
854449609f5SPrafulla Wadaskar #include <u-boot/crc.h>
855e2211743Swdenk 
8569acf1ca5SMichael Walle /* lib/rand.c */
8579acf1ca5SMichael Walle #define RAND_MAX -1U
8589acf1ca5SMichael Walle void srand(unsigned int seed);
8599acf1ca5SMichael Walle unsigned int rand(void);
8609acf1ca5SMichael Walle unsigned int rand_r(unsigned int *seedp);
8619acf1ca5SMichael Walle 
862e2211743Swdenk /* common/console.c */
863e2211743Swdenk int	console_init_f(void);	/* Before relocation; uses the serial  stuff	*/
864e2211743Swdenk int	console_init_r(void);	/* After  relocation; uses the console stuff	*/
865d7be3056SMike Frysinger int	console_assign(int file, const char *devname);	/* Assign the console	*/
866e2211743Swdenk int	ctrlc (void);
867e2211743Swdenk int	had_ctrlc (void);	/* have we had a Control-C since last clear? */
868e2211743Swdenk void	clear_ctrlc (void);	/* clear the Control-C condition */
869e2211743Swdenk int	disable_ctrlc (int);	/* 1 to disable, 0 to enable Control-C detect */
870a5dffa4bSPierre Aubert int confirm_yesno(void);        /*  1 if input is "y", "Y", "yes" or "YES" */
871e2211743Swdenk /*
872e2211743Swdenk  * STDIO based functions (can always be used)
873e2211743Swdenk  */
874e2211743Swdenk /* serial stuff */
875d9c27253SWolfgang Denk int	serial_printf (const char *fmt, ...)
876dc4b0b38SAndrew Klossner 		__attribute__ ((format (__printf__, 1, 2)));
877e2211743Swdenk /* stdin */
878e2211743Swdenk int	getc(void);
879e2211743Swdenk int	tstc(void);
880e2211743Swdenk 
881e2211743Swdenk /* stdout */
88280402f34SHeiko Schocher #if defined(CONFIG_SPL_BUILD) && !defined(CONFIG_SPL_SERIAL_SUPPORT)
88380402f34SHeiko Schocher #define	putc(...) do { } while (0)
88480402f34SHeiko Schocher #define puts(...) do { } while (0)
88580402f34SHeiko Schocher #define printf(...) do { } while (0)
88680402f34SHeiko Schocher #define vprintf(...) do { } while (0)
88780402f34SHeiko Schocher #else
888e2211743Swdenk void	putc(const char c);
889e2211743Swdenk void	puts(const char *s);
890d9c27253SWolfgang Denk int	printf(const char *fmt, ...)
891dc4b0b38SAndrew Klossner 		__attribute__ ((format (__printf__, 1, 2)));
892d9c27253SWolfgang Denk int	vprintf(const char *fmt, va_list args);
89380402f34SHeiko Schocher #endif
894e2211743Swdenk 
895e2211743Swdenk /* stderr */
896e2211743Swdenk #define eputc(c)		fputc(stderr, c)
897e2211743Swdenk #define eputs(s)		fputs(stderr, s)
898e2211743Swdenk #define eprintf(fmt,args...)	fprintf(stderr,fmt ,##args)
899e2211743Swdenk 
900e2211743Swdenk /*
901e2211743Swdenk  * FILE based functions (can only be used AFTER relocation!)
902e2211743Swdenk  */
903e2211743Swdenk #define stdin		0
904e2211743Swdenk #define stdout		1
905e2211743Swdenk #define stderr		2
906e2211743Swdenk #define MAX_FILES	3
907e2211743Swdenk 
908d9c27253SWolfgang Denk int	fprintf(int file, const char *fmt, ...)
909dc4b0b38SAndrew Klossner 		__attribute__ ((format (__printf__, 2, 3)));
910e2211743Swdenk void	fputs(int file, const char *s);
911e2211743Swdenk void	fputc(int file, const char c);
912e2211743Swdenk int	ftstc(int file);
913e2211743Swdenk int	fgetc(int file);
914e2211743Swdenk 
91588d52c6aSLei Wen /* lib/gzip.c */
91688d52c6aSLei Wen int gzip(void *dst, unsigned long *lenp,
91788d52c6aSLei Wen 		unsigned char *src, unsigned long srclen);
91888d52c6aSLei Wen int zzip(void *dst, unsigned long *lenp, unsigned char *src,
91988d52c6aSLei Wen 		unsigned long srclen, int stoponerr,
92088d52c6aSLei Wen 		int (*func)(unsigned long, unsigned long));
92188d52c6aSLei Wen 
9224ef8d53cSJoe Hershberger /* lib/net_utils.c */
9234ef8d53cSJoe Hershberger #include <net.h>
924049a95a7SJoe Hershberger static inline struct in_addr getenv_ip(char *var)
9254ef8d53cSJoe Hershberger {
9264ef8d53cSJoe Hershberger 	return string_to_ip(getenv(var));
9274ef8d53cSJoe Hershberger }
9284ef8d53cSJoe Hershberger 
92916a28ef2SGary Jennejohn /*
93016a28ef2SGary Jennejohn  * CONSOLE multiplexing.
93116a28ef2SGary Jennejohn  */
93216a28ef2SGary Jennejohn #ifdef CONFIG_CONSOLE_MUX
93316a28ef2SGary Jennejohn #include <iomux.h>
93416a28ef2SGary Jennejohn #endif
93516a28ef2SGary Jennejohn 
936e2211743Swdenk int	pcmcia_init (void);
937e2211743Swdenk 
938fb364becSWolfgang Denk #ifdef CONFIG_STATUS_LED
939fb364becSWolfgang Denk # include <status_led.h>
940fb364becSWolfgang Denk #endif
941097e1783SSimon Glass 
942097e1783SSimon Glass #include <bootstage.h>
943e2211743Swdenk 
94448522bb5SJoe Hershberger #ifdef CONFIG_SHOW_ACTIVITY
94548522bb5SJoe Hershberger void show_activity(int arg);
94648522bb5SJoe Hershberger #endif
94748522bb5SJoe Hershberger 
948fcd3c87eSWolfgang Denk /* Multicore arch functions */
949fcd3c87eSWolfgang Denk #ifdef CONFIG_MP
950fcd3c87eSWolfgang Denk int cpu_status(int nr);
951fcd3c87eSWolfgang Denk int cpu_reset(int nr);
9524194b366SKumar Gala int cpu_disable(int nr);
95354841ab5SWolfgang Denk int cpu_release(int nr, int argc, char * const argv[]);
954fcd3c87eSWolfgang Denk #endif
955fcd3c87eSWolfgang Denk 
956fcd3c87eSWolfgang Denk #endif /* __ASSEMBLY__ */
957fcd3c87eSWolfgang Denk 
95813e95e42SStefan Roese #ifdef CONFIG_PPC
95913e95e42SStefan Roese /*
96013e95e42SStefan Roese  * Has to be included outside of the #ifndef __ASSEMBLY__ section.
96113e95e42SStefan Roese  * Otherwise might lead to compilation errors in assembler files.
96213e95e42SStefan Roese  */
96313e95e42SStefan Roese #include <asm/cache.h>
96413e95e42SStefan Roese #endif
96513e95e42SStefan Roese 
966fcd3c87eSWolfgang Denk /* Put only stuff here that the assembler can digest */
967fcd3c87eSWolfgang Denk 
968fcd3c87eSWolfgang Denk #ifdef CONFIG_POST
969fcd3c87eSWolfgang Denk #define CONFIG_HAS_POST
970800eb096SMichael Zaidman #ifndef CONFIG_POST_ALT_LIST
971800eb096SMichael Zaidman #define CONFIG_POST_STD_LIST
972800eb096SMichael Zaidman #endif
973fcd3c87eSWolfgang Denk #endif
974fcd3c87eSWolfgang Denk 
9758aa1a2d1Swdenk #ifdef CONFIG_INIT_CRITICAL
9762f6fa46dSWolfgang Denk #error CONFIG_INIT_CRITICAL is deprecated!
9778aa1a2d1Swdenk #error Read section CONFIG_SKIP_LOWLEVEL_INIT in README.
9788aa1a2d1Swdenk #endif
9798aa1a2d1Swdenk 
980155cfb5eSAnton Staaf #define ROUND(a,b)		(((a) + (b) - 1) & ~((b) - 1))
9814b03ac8bSAndy Fleming 
9821e41f5adSAnton Staaf /*
983c9689ca3SSimon Glass  * check_member() - Check the offset of a structure member
984c9689ca3SSimon Glass  *
985c9689ca3SSimon Glass  * @structure:	Name of structure (e.g. global_data)
986c9689ca3SSimon Glass  * @member:	Name of member (e.g. baudrate)
987c9689ca3SSimon Glass  * @offset:	Expected offset in bytes
988c9689ca3SSimon Glass  */
989c9689ca3SSimon Glass #define check_member(structure, member, offset) _Static_assert( \
990c9689ca3SSimon Glass 	offsetof(struct structure, member) == offset, \
991c9689ca3SSimon Glass 	"`struct " #structure "` offset for `" #member "` is not " #offset)
992c9689ca3SSimon Glass 
993476476e7SSimon Glass /* Avoid using CONFIG_EFI_STUB directly as we may boot from other loaders */
994476476e7SSimon Glass #ifdef CONFIG_EFI_STUB
995476476e7SSimon Glass #define ll_boot_init()	false
996476476e7SSimon Glass #else
997476476e7SSimon Glass #define ll_boot_init()	true
998476476e7SSimon Glass #endif
999476476e7SSimon Glass 
1000c3eb3fe4SMike Frysinger /* Pull in stuff for the build system */
1001c3eb3fe4SMike Frysinger #ifdef DO_DEPS_ONLY
1002c3eb3fe4SMike Frysinger # include <environment.h>
1003c3eb3fe4SMike Frysinger #endif
1004c3eb3fe4SMike Frysinger 
1005e2211743Swdenk #endif	/* __COMMON_H_ */
1006