]> git.ipfire.org Git - people/ms/u-boot.git/blame - include/common.h
arm: socfpga: arria5-socdk: Remove Micrel PHY configuration
[people/ms/u-boot.git] / include / common.h
CommitLineData
e2211743 1/*
3b74e7ec 2 * (C) Copyright 2000-2009
e2211743
WD
3 * Wolfgang Denk, DENX Software Engineering, wd@denx.de.
4 *
3765b3e7 5 * SPDX-License-Identifier: GPL-2.0+
e2211743
WD
6 */
7
8#ifndef __COMMON_H_
d0b8feef 9#define __COMMON_H_ 1
e2211743 10
fcd3c87e
WD
11#ifndef __ASSEMBLY__ /* put C only stuff in this section */
12
e2211743
WD
13typedef unsigned char uchar;
14typedef volatile unsigned long vu_long;
180d3f74 15typedef volatile unsigned short vu_short;
e2211743
WD
16typedef volatile unsigned char vu_char;
17
18#include <config.h>
25ddd1fb 19#include <asm-offsets.h>
e2211743
WD
20#include <linux/bitops.h>
21#include <linux/types.h>
22#include <linux/string.h>
9aed5080 23#include <linux/stringify.h>
e2211743
WD
24#include <asm/ptrace.h>
25#include <stdarg.h>
cba1da49 26#include <linux/kernel.h>
a821d08d 27#if defined(CONFIG_PCI) && defined(CONFIG_4xx)
e2211743
WD
28#include <pci.h>
29#endif
180d3f74 30#if defined(CONFIG_8xx)
e2211743 31#include <asm/8xx_immap.h>
03f9d7d1
MY
32#if defined(CONFIG_MPC859) || defined(CONFIG_MPC859T) || \
33 defined(CONFIG_MPC866) || \
d4ca31c4 34 defined(CONFIG_MPC866P)
d0b8feef 35# define CONFIG_MPC866_FAMILY 1
0ace4d9d 36#elif defined(CONFIG_MPC885)
d0b8feef 37# define CONFIG_MPC885_FAMILY 1
180d3f74
WD
38#endif
39#if defined(CONFIG_MPC860) \
40 || defined(CONFIG_MPC860T) \
1114257c
WD
41 || defined(CONFIG_MPC866_FAMILY) \
42 || defined(CONFIG_MPC885_FAMILY)
d0b8feef 43# define CONFIG_MPC86x 1
2535d602 44#endif
0db5bca8
WD
45#elif defined(CONFIG_5xx)
46#include <asm/5xx_immap.h>
7e6bf358
WD
47#elif defined(CONFIG_MPC5xxx)
48#include <mpc5xxx.h>
8993e54b 49#elif defined(CONFIG_MPC512X)
8993e54b 50#include <asm/immap_512x.h>
58dac327 51#elif defined(CONFIG_MPC8260)
04a85b3b 52#if defined(CONFIG_MPC8247) \
04a85b3b 53 || defined(CONFIG_MPC8272)
d0b8feef 54#define CONFIG_MPC8272_FAMILY 1
04a85b3b 55#endif
e2211743
WD
56#include <asm/immap_8260.h>
57#endif
debb7354
JL
58#ifdef CONFIG_MPC86xx
59#include <mpc86xx.h>
60#include <asm/immap_86xx.h>
61#endif
42d1f039
WD
62#ifdef CONFIG_MPC85xx
63#include <mpc85xx.h>
64#include <asm/immap_85xx.h>
65#endif
0f898604 66#ifdef CONFIG_MPC83xx
f046ccd1
EL
67#include <mpc83xx.h>
68#include <asm/immap_83xx.h>
69#endif
e2211743 70#ifdef CONFIG_4xx
b36df561 71#include <asm/ppc4xx.h>
e2211743 72#endif
6cfcce67
MF
73#ifdef CONFIG_BLACKFIN
74#include <asm/blackfin.h>
75#endif
2819e136
SN
76#ifdef CONFIG_SOC_DA8XX
77#include <asm/arch/hardware.h>
78#endif
9f3183d2
MH
79#ifdef CONFIG_FSL_LSCH3
80#include <asm/arch/immap_lsch3.h>
81#endif
8281c58f
MH
82#ifdef CONFIG_FSL_LSCH2
83#include <asm/arch/immap_lsch2.h>
84#endif
e2211743
WD
85
86#include <part.h>
87#include <flash.h>
88#include <image.h>
89
4166ecb2
GB
90/* Bring in printf format macros if inttypes.h is included */
91#define __STDC_FORMAT_MACROS
92
4d1fd7f1
YS
93#ifdef __LP64__
94#define CONFIG_SYS_SUPPORT_64BIT_DATA
95#endif
96
21726a7a 97#ifdef DEBUG
88a85fb9 98#define _DEBUG 1
21726a7a 99#else
88a85fb9 100#define _DEBUG 0
21726a7a
SG
101#endif
102
be25d875
TR
103#ifndef pr_fmt
104#define pr_fmt(fmt) fmt
105#endif
106
88a85fb9
MV
107/*
108 * Output a debug text when condition "cond" is met. The "cond" should be
109 * computed by a preprocessor in the best case, allowing for the best
110 * optimization.
111 */
be25d875
TR
112#define debug_cond(cond, fmt, args...) \
113 do { \
114 if (cond) \
115 printf(pr_fmt(fmt), ##args); \
88a85fb9
MV
116 } while (0)
117
118#define debug(fmt, args...) \
119 debug_cond(_DEBUG, fmt, ##args)
120
21726a7a
SG
121/*
122 * An assertion is run-time check done in debug mode only. If DEBUG is not
123 * defined then it is skipped. If DEBUG is defined and the assertion fails,
124 * then it calls panic*( which may or may not reset/halt U-Boot (see
125 * CONFIG_PANIC_HANG), It is hoped that all failing assertions are found
126 * before release, and after release it is hoped that they don't matter. But
127 * in any case these failing assertions cannot be fixed with a reset (which
128 * may just do the same assertion again).
129 */
130void __assert_fail(const char *assertion, const char *file, unsigned line,
131 const char *function);
132#define assert(x) \
133 ({ if (!(x) && _DEBUG) \
134 __assert_fail(#x, __FILE__, __LINE__, __func__); })
135
594d57d0 136#define error(fmt, args...) do { \
be25d875 137 printf("ERROR: " pr_fmt(fmt) "\nat %s:%d/%s()\n", \
594d57d0
MK
138 ##args, __FILE__, __LINE__, __func__); \
139} while (0)
140
cfa460ad 141#ifndef BUG
43835aac 142#define BUG() do { \
511d0c72 143 printf("BUG: failure at %s:%d/%s()!\n", __FILE__, __LINE__, __FUNCTION__); \
43835aac
DZ
144 panic("BUG!"); \
145} while (0)
146#define BUG_ON(condition) do { if (unlikely((condition)!=0)) BUG(); } while(0)
cfa460ad 147#endif /* BUG */
43835aac 148
c00e17c7
HS
149/* Force a compilation error if condition is true */
150#define BUILD_BUG_ON(condition) ((void)sizeof(char[1 - 2*!!(condition)]))
151
c83bf6a2 152typedef void (interrupt_handler_t)(void *);
e2211743 153
c83bf6a2 154#include <asm/u-boot.h> /* boot information for Linux kernel */
e2211743
WD
155#include <asm/global_data.h> /* global data used for startup functions */
156
71f95118
WD
157/*
158 * enable common handling for all TQM8xxL/M boards:
11d9eec4 159 * - CONFIG_TQM8xxM will be defined for all TQM8xxM boards
71f95118 160 * - CONFIG_TQM8xxL will be defined for all TQM8xxL _and_ TQM8xxM boards
11d9eec4 161 * and for the TQM885D board
71f95118
WD
162 */
163#if defined(CONFIG_TQM823M) || defined(CONFIG_TQM850M) || \
164 defined(CONFIG_TQM855M) || defined(CONFIG_TQM860M) || \
11d9eec4 165 defined(CONFIG_TQM862M) || defined(CONFIG_TQM866M)
71f95118
WD
166# ifndef CONFIG_TQM8xxM
167# define CONFIG_TQM8xxM
168# endif
169#endif
e2211743 170#if defined(CONFIG_TQM823L) || defined(CONFIG_TQM850L) || \
d126bfbd 171 defined(CONFIG_TQM855L) || defined(CONFIG_TQM860L) || \
11d9eec4
MK
172 defined(CONFIG_TQM862L) || defined(CONFIG_TQM8xxM) || \
173 defined(CONFIG_TQM885D)
e2211743
WD
174# ifndef CONFIG_TQM8xxL
175# define CONFIG_TQM8xxL
176# endif
177#endif
178
3fbeeea6
HS
179#if defined(CONFIG_ENV_IS_EMBEDDED)
180#define TOTAL_MALLOC_LEN CONFIG_SYS_MALLOC_LEN
181#elif ( ((CONFIG_ENV_ADDR+CONFIG_ENV_SIZE) < CONFIG_SYS_MONITOR_BASE) || \
182 (CONFIG_ENV_ADDR >= (CONFIG_SYS_MONITOR_BASE + CONFIG_SYS_MONITOR_LEN)) ) || \
183 defined(CONFIG_ENV_IS_IN_NVRAM)
184#define TOTAL_MALLOC_LEN (CONFIG_SYS_MALLOC_LEN + CONFIG_ENV_SIZE)
185#else
186#define TOTAL_MALLOC_LEN CONFIG_SYS_MALLOC_LEN
187#endif
c7de829c 188
e2211743
WD
189/*
190 * Function Prototypes
191 */
0267ba5d 192int dram_init(void);
e2211743 193
c83bf6a2 194void hang (void) __attribute__ ((noreturn));
e2211743 195
f6c019c4
WD
196int timer_init(void);
197int cpu_init(void);
198
e2211743 199/* */
9973e3c6 200phys_size_t initdram (int);
c6da9ae8 201
2ea09c83 202#include <display_options.h>
e2211743
WD
203
204/* common/main.c */
205void main_loop (void);
009dde19 206int run_command(const char *cmd, int flag);
1d43bfd2 207int run_command_repeatable(const char *cmd, int flag);
d51004a8
SG
208
209/**
210 * Run a list of commands separated by ; or even \0
211 *
212 * Note that if 'len' is not -1, then the command does not need to be nul
213 * terminated, Memory will be allocated for the command in that case.
214 *
215 * @param cmd List of commands to run, each separated bu semicolon
216 * @param len Length of commands excluding terminator if known (-1 if not)
217 * @param flag Execution flags (CMD_FLAG_...)
218 * @return 0 on success, or != 0 on error.
219 */
220int run_command_list(const char *cmd, int len, int flag);
e2211743 221
ea0364f1 222/* arch/$(ARCH)/lib/board.c */
0365ffcc
MY
223void board_init_f(ulong);
224void board_init_r(gd_t *, ulong) __attribute__ ((noreturn));
1fed87db
SG
225
226/**
227 * board_init_f_mem() - Allocate global data and set stack position
228 *
229 * This function is called by each architecture very early in the start-up
230 * code to set up the environment for board_init_f(). It allocates space for
231 * global_data (see include/asm-generic/global_data.h) and places the stack
232 * below this.
233 *
234 * This function requires a stack[1] Normally this is at @top. The function
235 * starts allocating space from 64 bytes below @top. First it creates space
236 * for global_data. Then it calls arch_setup_gd() which sets gd to point to
237 * the global_data space and can reserve additional bytes of space if
238 * required). Finally it allocates early malloc() memory
239 * (CONFIG_SYS_MALLOC_F_LEN). The new top of the stack is just below this,
240 * and it returned by this function.
241 *
242 * [1] Strictly speaking it would be possible to implement this function
243 * in C on many archs such that it does not require a stack. However this
244 * does not seem hugely important as only 64 byte are wasted. The 64 bytes
245 * are used to handle the calling standard which generally requires pushing
246 * addresses or registers onto the stack. We should be able to get away with
247 * less if this becomes important.
248 *
249 * @top: Top of available memory, also normally the top of the stack
250 * @return: New stack location
251 */
252ulong board_init_f_mem(ulong top);
253
254/**
255 * arch_setup_gd() - Set up the global_data pointer
256 *
257 * This pointer is special in some architectures and cannot easily be assigned
258 * to. For example on x86 it is implemented by adding a specific record to its
259 * Global Descriptor Table! So we we provide a function to carry out this task.
260 * For most architectures this can simply be:
261 *
262 * gd = gd_ptr;
263 *
264 * @gd_ptr: Pointer to global data
265 */
266void arch_setup_gd(gd_t *gd_ptr);
267
0365ffcc
MY
268int checkboard(void);
269int show_board_info(void);
270int checkflash(void);
271int checkdram(void);
272int last_stage_init(void);
3b57fe0a 273extern ulong monitor_flash_len;
bea3f28d 274int mac_read_from_eeprom(void);
6ab6b2af 275extern u8 __dtb_dt_begin[]; /* embedded device tree blob */
8f5d4687 276int set_cpu_clk_info(void);
9272a9b4 277int mdm_init(void);
365475e6 278#if defined(CONFIG_DISPLAY_CPUINFO)
1938f4a5 279int print_cpuinfo(void);
365475e6
MY
280#else
281static inline int print_cpuinfo(void)
282{
283 return 0;
284}
285#endif
c2240d4d 286int update_flash_size(int flash_size);
2c072c95 287int arch_early_init_r(void);
e2211743 288
d4c671cc
SG
289/**
290 * arch_cpu_init_dm() - init CPU after driver model is available
291 *
292 * This is called immediately after driver model is available before
293 * relocation. This is similar to arch_cpu_init() but is able to reference
294 * devices
295 *
296 * @return 0 if OK, -ve on error
297 */
298int arch_cpu_init_dm(void);
299
68145d4c
AB
300/**
301 * Reserve all necessary stacks
302 *
303 * This is used in generic board init sequence in common/board_f.c. Each
304 * architecture could provide this function to tailor the required stacks.
305 *
306 * On entry gd->start_addr_sp is pointing to the suggested top of the stack.
307 * The callee ensures gd->start_add_sp is 16-byte aligned, so architectures
308 * require only this can leave it untouched.
309 *
310 * On exit gd->start_addr_sp and gd->irq_sp should be set to the respective
311 * positions of the stack. The stack pointer(s) will be set to this later.
312 * gd->irq_sp is only required, if the architecture needs it.
313 *
314 * @return 0 if no error
315 */
316__weak int arch_reserve_stacks(void);
317
15a33e49
SG
318/**
319 * Show the DRAM size in a board-specific way
320 *
321 * This is used by boards to display DRAM information in their own way.
322 *
323 * @param size Size of DRAM (which should be displayed along with other info)
324 */
ea11b401 325void board_show_dram(phys_size_t size);
15a33e49 326
13d06981 327/**
e29607ed 328 * arch_fixup_fdt() - Write arch-specific information to fdt
13d06981 329 *
e29607ed 330 * Defined in arch/$(ARCH)/lib/bootm-fdt.c
13d06981
SG
331 *
332 * @blob: FDT blob to write to
333 * @return 0 if ok, or -ve FDT_ERR_... on failure
334 */
e29607ed 335int arch_fixup_fdt(void *blob);
13d06981 336
e2211743
WD
337/* common/flash.c */
338void flash_perror (int);
339
74de7aef
WD
340/* common/cmd_source.c */
341int source (ulong addr, const char *fit_uname);
e2211743 342
c83bf6a2 343extern ulong load_addr; /* Default Load Address */
1aec244a
SG
344extern ulong save_addr; /* Default Save Address */
345extern ulong save_size; /* Default Save Size */
e2211743 346
4394f9a8
WD
347/* common/cmd_doc.c */
348void doc_probe(unsigned long physadr);
349
06283a64
JH
350/* common/cmd_net.c */
351int do_tftpb(cmd_tbl_t *cmdtp, int flag, int argc, char * const argv[]);
352
669df7e4
RH
353/* common/cmd_fat.c */
354int do_fat_fsload(cmd_tbl_t *, int, int, char * const []);
355
356/* common/cmd_ext2.c */
357int do_ext2load(cmd_tbl_t *, int, int, char * const []);
358
e2211743
WD
359/* common/cmd_nvedit.c */
360int env_init (void);
361void env_relocate (void);
26a41790 362int envmatch (uchar *, int);
20f86a0a
SG
363
364/* Avoid unfortunate conflict with libc's getenv() */
365#ifdef CONFIG_SANDBOX
366#define getenv uboot_getenv
367#endif
84b5e802
WD
368char *getenv (const char *);
369int getenv_f (const char *name, char *buf, unsigned len);
4a9b4131 370ulong getenv_ulong(const char *name, int base, ulong default_val);
76b8f79c
SG
371
372/**
373 * getenv_hex() - Return an environment variable as a hex value
374 *
375 * Decode an environment as a hex number (it may or may not have a 0x
376 * prefix). If the environment variable cannot be found, or does not start
377 * with hex digits, the default value is returned.
378 *
379 * @varname: Variable to decode
380 * @default_val: Value to return on error
381 */
382ulong getenv_hex(const char *varname, ulong default_val);
383
ec8a252c
JH
384/*
385 * Read an environment variable as a boolean
386 * Return -1 if variable does not exist (default to true)
387 */
388int getenv_yesno(const char *var);
c83bf6a2 389int saveenv (void);
84b5e802 390int setenv (const char *, const char *);
d67f10ce 391int setenv_ulong(const char *varname, ulong value);
bfc59966
SG
392int setenv_hex(const char *varname, ulong value);
393/**
394 * setenv_addr - Set an environment variable to an address in hex
395 *
1bce2aeb 396 * @varname: Environment variable to set
bfc59966
SG
397 * @addr: Value to set it to
398 * @return 0 if ok, 1 on error
399 */
400static inline int setenv_addr(const char *varname, const void *addr)
401{
402 return setenv_hex(varname, (ulong)addr);
403}
404
e2211743 405#ifdef CONFIG_ARM
96085e34 406# include <asm/mach-types.h>
b6e4c403 407# include <asm/setup.h>
e2211743
WD
408# include <asm/u-boot-arm.h> /* ARM version to be fixed! */
409#endif /* CONFIG_ARM */
fea25720
GR
410#ifdef CONFIG_X86 /* x86 version to be fixed! */
411# include <asm/u-boot-x86.h>
412#endif /* CONFIG_X86 */
744d9859
SG
413#ifdef CONFIG_SANDBOX
414# include <asm/u-boot-sandbox.h> /* TODO(sjg) what needs to be fixed? */
415#endif
e7083844
ML
416#ifdef CONFIG_NDS32
417# include <asm/mach-types.h>
e3c58b02 418# include <asm/setup.h>
e7083844
ML
419# include <asm/u-boot-nds32.h>
420#endif /* CONFIG_NDS32 */
e034ea3b
DS
421#ifdef CONFIG_MIPS
422# include <asm/u-boot-mips.h>
423#endif /* CONFIG_MIPS */
bc5d5428
AB
424#ifdef CONFIG_ARC
425# include <asm/u-boot-arc.h>
426#endif /* CONFIG_ARC */
e2211743 427
04a85b3b
WD
428#ifdef CONFIG_AUTO_COMPLETE
429int env_complete(char *var, int maxv, char *cmdv[], int maxsz, char *buf);
430#endif
2f70c49e 431int get_env_id (void);
04a85b3b 432
c83bf6a2
WD
433void pci_init (void);
434void pci_init_board(void);
e2211743 435
a821d08d 436#if defined(CONFIG_PCI) && defined(CONFIG_4xx)
c71103f9
MF
437 int pci_pre_init (struct pci_controller *);
438 int is_pci_host (struct pci_controller *);
466fff1a
SR
439#endif
440
dbbd1257 441#if defined(CONFIG_PCI) && (defined(CONFIG_440) || defined(CONFIG_405EX))
6d0f6bcf 442# if defined(CONFIG_SYS_PCI_TARGET_INIT)
c83bf6a2 443 void pci_target_init (struct pci_controller *);
e2211743 444# endif
6d0f6bcf 445# if defined(CONFIG_SYS_PCI_MASTER_INIT)
c83bf6a2 446 void pci_master_init (struct pci_controller *);
e2211743 447# endif
6f2eb3f3
SR
448#if defined(CONFIG_440SPE) || \
449 defined(CONFIG_460EX) || defined(CONFIG_460GT) || \
450 defined(CONFIG_405EX)
7f191393 451 void pcie_setup_hoses(int busno);
692519b1 452#endif
e2211743
WD
453#endif
454
455int misc_init_f (void);
456int misc_init_r (void);
457
27b207fd
WD
458/* common/exports.c */
459void jumptable_init(void);
460
ecb1dc89
MF
461/* common/kallsysm.c */
462const char *symbol_lookup(unsigned long addr, unsigned long *caddr);
463
500856eb
RJ
464/* api/api.c */
465void api_init (void);
466
c83bf6a2 467/* common/memsize.c */
a55d23cc 468long get_ram_size (long *, long);
e3866163 469phys_size_t get_effective_memsize(void);
c83bf6a2 470
e2211743
WD
471/* $(BOARD)/$(BOARD).c */
472void reset_phy (void);
c83bf6a2 473void fdc_hw_init (void);
e2211743
WD
474
475/* $(BOARD)/eeprom.c */
354e3ed7 476void eeprom_init (int bus);
e2211743
WD
477int eeprom_read (unsigned dev_addr, unsigned offset, uchar *buffer, unsigned cnt);
478int eeprom_write (unsigned dev_addr, unsigned offset, uchar *buffer, unsigned cnt);
e2211743
WD
479
480/*
481 * Set this up regardless of board
482 * type, to prevent errors.
483 */
6d0f6bcf
JCPV
484#if defined(CONFIG_SPI) || !defined(CONFIG_SYS_I2C_EEPROM_ADDR)
485# define CONFIG_SYS_DEF_EEPROM_ADDR 0
e2211743 486#else
548738b4 487#if !defined(CONFIG_ENV_EEPROM_IS_ON_I2C)
6d0f6bcf 488# define CONFIG_SYS_DEF_EEPROM_ADDR CONFIG_SYS_I2C_EEPROM_ADDR
548738b4 489#endif
6d0f6bcf 490#endif /* CONFIG_SPI || !defined(CONFIG_SYS_I2C_EEPROM_ADDR) */
e2211743 491
bdccc4fe 492#if defined(CONFIG_SPI)
e2211743
WD
493extern void spi_init_f (void);
494extern void spi_init_r (void);
c83bf6a2 495extern ssize_t spi_read (uchar *, int, uchar *, int);
e2211743
WD
496extern ssize_t spi_write (uchar *, int, uchar *, int);
497#endif
498
e2211743 499/* $(BOARD)/$(BOARD).c */
c837dcb1
WD
500int board_early_init_f (void);
501int board_late_init (void);
e2211743 502int board_postclk_init (void); /* after clocks/timebase, before env/serial */
c837dcb1 503int board_early_init_r (void);
e2211743
WD
504void board_poweroff (void);
505
6d0f6bcf 506#if defined(CONFIG_SYS_DRAM_TEST)
e2211743 507int testdram(void);
6d0f6bcf 508#endif /* CONFIG_SYS_DRAM_TEST */
e2211743
WD
509
510/* $(CPU)/start.S */
c83bf6a2 511#if defined(CONFIG_5xx) || \
0db5bca8 512 defined(CONFIG_8xx)
e2211743
WD
513uint get_immr (uint);
514#endif
36c72877
WD
515#if defined(CONFIG_MPC5xxx)
516uint get_svr (void);
517#endif
e2211743 518uint get_pvr (void);
547b4cb2 519uint get_svr (void);
e2211743
WD
520uint rd_ic_cst (void);
521void wr_ic_cst (uint);
522void wr_ic_adr (uint);
523uint rd_dc_cst (void);
524void wr_dc_cst (uint);
525void wr_dc_adr (uint);
526int icache_status (void);
527void icache_enable (void);
528void icache_disable(void);
529int dcache_status (void);
530void dcache_enable (void);
531void dcache_disable(void);
2c451f78 532void mmu_disable(void);
5c6db120
BT
533#if defined(CONFIG_ARM)
534void relocate_code(ulong);
535#else
536void relocate_code(ulong, gd_t *, ulong) __attribute__ ((noreturn));
959eaa74 537#endif
e2211743
WD
538ulong get_endaddr (void);
539void trap_init (ulong);
540#if defined (CONFIG_4xx) || \
eeb1b77b 541 defined (CONFIG_MPC5xxx) || \
cd94ba39 542 defined (CONFIG_MPC85xx) || \
debb7354 543 defined (CONFIG_MPC86xx) || \
0f898604 544 defined (CONFIG_MPC83xx)
c83bf6a2
WD
545unsigned char in8(unsigned int);
546void out8(unsigned int, unsigned char);
547unsigned short in16(unsigned int);
548unsigned short in16r(unsigned int);
549void out16(unsigned int, unsigned short value);
550void out16r(unsigned int, unsigned short value);
551unsigned long in32(unsigned int);
552unsigned long in32r(unsigned int);
553void out32(unsigned int, unsigned long value);
554void out32r(unsigned int, unsigned long value);
555void ppcDcbf(unsigned long value);
556void ppcDcbi(unsigned long value);
557void ppcSync(void);
0ac6f8b7 558void ppcDcbz(unsigned long value);
e2211743 559#endif
0643631a
MS
560#if defined (CONFIG_MICROBLAZE)
561unsigned short in16(unsigned int);
562void out16(unsigned int, unsigned short value);
563#endif
e2211743 564
0f898604 565#if defined (CONFIG_MPC83xx)
90f30a71
DL
566void ppcDWload(unsigned int *addr, unsigned int *ret);
567void ppcDWstore(unsigned int *addr, unsigned int *value);
7c6db910
HS
568void disable_addr_trans(void);
569void enable_addr_trans(void);
570#if defined(CONFIG_DDR_ECC) && !defined(CONFIG_ECC_INIT_VIA_DDRCONTROLLER)
571void ddr_enable_ecc(unsigned int dram_size);
572#endif
90f30a71
DL
573#endif
574
fc9ae1ba
RS
575/*
576 * Return the current value of a monotonically increasing microsecond timer.
577 * Granularity may be larger than 1us if hardware does not support this.
578 */
579ulong timer_get_us(void);
580
e2211743 581/* $(CPU)/cpu.c */
fbb9ecf7
TT
582static inline int cpumask_next(int cpu, unsigned int mask)
583{
584 for (cpu++; !((1 << cpu) & mask); cpu++)
585 ;
586
587 return cpu;
588}
589
590#define for_each_cpu(iter, cpu, num_cpus, mask) \
591 for (iter = 0, cpu = cpumask_next(-1, mask); \
592 iter < num_cpus; \
593 iter++, cpu = cpumask_next(cpu, mask)) \
594
0e870980 595int cpu_numcores (void);
b8bf0adc 596int cpu_num_dspcores(void);
fbb9ecf7 597u32 cpu_mask (void);
b8bf0adc 598u32 cpu_dsp_mask(void);
fbb9ecf7 599int is_core_valid (unsigned int);
0e870980 600int probecpu (void);
e2211743
WD
601int checkcpu (void);
602int checkicache (void);
603int checkdcache (void);
604void upmconfig (unsigned int, unsigned int *, unsigned int);
605ulong get_tbclk (void);
1fb4dab2 606void reset_misc (void);
3ec924a3 607void reset_cpu (ulong addr);
6a16e0df
KP
608#if defined (CONFIG_OF_LIBFDT) && defined (CONFIG_OF_BOARD_SETUP)
609void ft_cpu_setup(void *blob, bd_t *bd);
610#ifdef CONFIG_PCI
611void ft_pci_setup(void *blob, bd_t *bd);
612#endif
613#endif
614
ba6a1698
AP
615void smp_set_core_boot_addr(unsigned long addr, int corenr);
616void smp_kick_all_cpus(void);
e2211743
WD
617
618/* $(CPU)/serial.c */
619int serial_init (void);
620void serial_setbrg (void);
621void serial_putc (const char);
756f586a 622void serial_putc_raw(const char);
e2211743 623void serial_puts (const char *);
e2211743
WD
624int serial_getc (void);
625int serial_tstc (void);
626
709ea543
SG
627/* These versions take a stdio_dev pointer */
628struct stdio_dev;
629int serial_stub_getc(struct stdio_dev *sdev);
630int serial_stub_tstc(struct stdio_dev *sdev);
631
e2211743
WD
632/* $(CPU)/speed.c */
633int get_clocks (void);
c178d3da
WD
634int get_clocks_866 (void);
635int sdram_adjust_866 (void);
e9132ea9 636int adjust_sdram_tbs_8xx (void);
58dac327 637#if defined(CONFIG_MPC8260)
e2211743 638int prt_8260_clks (void);
f046ccd1 639#elif defined(CONFIG_MPC5xxx)
945af8d7
WD
640int prt_mpc5xxx_clks (void);
641#endif
e2211743
WD
642#ifdef CONFIG_4xx
643ulong get_OPB_freq (void);
644ulong get_PCI_freq (void);
645#endif
ac67804f 646#if defined(CONFIG_S3C24X0) || \
647 defined(CONFIG_LH7A40X) || \
fcfb632b 648 defined(CONFIG_EP93XX)
e2211743
WD
649ulong get_FCLK (void);
650ulong get_HCLK (void);
651ulong get_PCLK (void);
652ulong get_UCLK (void);
653#endif
f39748ae
WD
654#if defined(CONFIG_LH7A40X)
655ulong get_PLLCLK (void);
656#endif
281e00a3
WD
657#if defined(CONFIG_IMX)
658ulong get_systemPLLCLK(void);
659ulong get_FCLK(void);
660ulong get_HCLK(void);
661ulong get_BCLK(void);
662ulong get_PERCLK1(void);
663ulong get_PERCLK2(void);
664ulong get_PERCLK3(void);
665#endif
e2211743 666ulong get_bus_freq (ulong);
550650dd 667int get_serial_clock(void);
e2211743 668
42d1f039
WD
669#if defined(CONFIG_MPC85xx)
670typedef MPC85xx_SYS_INFO sys_info_t;
c83bf6a2 671void get_sys_info ( sys_info_t * );
871a57bb
MY
672# if defined(CONFIG_OF_LIBFDT)
673 void ft_fixup_cpu(void *, u64);
674 void ft_fixup_num_cores(void *);
675# endif
42d1f039 676#endif
debb7354
JL
677#if defined(CONFIG_MPC86xx)
678typedef MPC86xx_SYS_INFO sys_info_t;
679void get_sys_info ( sys_info_t * );
5df4b0ad
KG
680static inline ulong get_ddr_freq(ulong dummy)
681{
682 return get_bus_freq(dummy);
683}
2f78eae5
YS
684#else
685ulong get_ddr_freq(ulong);
debb7354 686#endif
42d1f039 687
99bcad18 688#if defined(CONFIG_4xx)
e2211743 689# if defined(CONFIG_440)
6c5879f3
MB
690# if defined(CONFIG_440SPE)
691 unsigned long determine_sysper(void);
692 unsigned long determine_pci_clock_per(void);
693# endif
e2211743 694# endif
087dfdb7 695typedef PPC4xx_SYS_INFO sys_info_t;
f31d38b9 696int ppc440spe_revB(void);
c83bf6a2 697void get_sys_info ( sys_info_t * );
e2211743
WD
698#endif
699
700/* $(CPU)/cpu_init.c */
58dac327 701#if defined(CONFIG_8xx) || defined(CONFIG_MPC8260)
e2211743
WD
702void cpu_init_f (volatile immap_t *immr);
703#endif
701e6401 704#if defined(CONFIG_4xx) || defined(CONFIG_MCF52x2) || defined(CONFIG_MPC86xx)
e2211743
WD
705void cpu_init_f (void);
706#endif
701e6401
YS
707#ifdef CONFIG_MPC85xx
708ulong cpu_init_f(void);
709#endif
bf9e3b38 710
e2211743 711int cpu_init_r (void);
58dac327 712#if defined(CONFIG_MPC8260)
e2211743 713int prt_8260_rsr (void);
0f898604 714#elif defined(CONFIG_MPC83xx)
9be39a67 715int prt_83xx_rsr (void);
e2211743
WD
716#endif
717
718/* $(CPU)/interrupts.c */
c83bf6a2
WD
719int interrupt_init (void);
720void timer_interrupt (struct pt_regs *);
e2211743
WD
721void external_interrupt (struct pt_regs *);
722void irq_install_handler(int, interrupt_handler_t *, void *);
723void irq_free_handler (int);
724void reset_timer (void);
725ulong get_timer (ulong base);
b2e16a85
SG
726
727/* Return value of monotonic microsecond timer */
728unsigned long timer_get_us(void);
729
e2211743
WD
730void enable_interrupts (void);
731int disable_interrupts (void);
732
733/* $(CPU)/.../commproc.c */
734int dpram_init (void);
735uint dpram_base(void);
736uint dpram_base_align(uint align);
737uint dpram_alloc(uint size);
738uint dpram_alloc_align(uint size,uint align);
bdccc4fe
WD
739void bootcount_store (ulong);
740ulong bootcount_load (void);
741#define BOOTCOUNT_MAGIC 0xB001C041
e2211743
WD
742
743/* $(CPU)/.../<eth> */
c5bded3c 744void mii_init (void);
e2211743
WD
745
746/* $(CPU)/.../lcd.c */
747ulong lcd_setmem (ulong);
748
e2211743
WD
749/* $(CPU)/.../video.c */
750ulong video_setmem (ulong);
751
ea0364f1 752/* arch/$(ARCH)/lib/cache.c */
cba4b180 753void enable_caches(void);
e2211743 754void flush_cache (unsigned long, unsigned long);
2c451f78 755void flush_dcache_all(void);
03d3bfb0
SR
756void flush_dcache_range(unsigned long start, unsigned long stop);
757void invalidate_dcache_range(unsigned long start, unsigned long stop);
2c451f78
A
758void invalidate_dcache_all(void);
759void invalidate_icache_all(void);
0db5bca8 760
4d24a11e
SG
761enum {
762 /* Disable caches (else flush caches but leave them active) */
763 CBL_DISABLE_CACHES = 1 << 0,
764 CBL_SHOW_BOOTSTAGE_REPORT = 1 << 1,
765
766 CBL_ALL = 3,
767};
768
769/**
770 * Clean up ready for linux
771 *
772 * @param flags Flags to control what is done
773 */
774int cleanup_before_linux_select(int flags);
775
ea0364f1 776/* arch/$(ARCH)/lib/ticks.S */
19ea4678 777uint64_t get_ticks(void);
e2211743
WD
778void wait_ticks (unsigned long);
779
ea0364f1 780/* arch/$(ARCH)/lib/time.c */
3eb90bad 781void __udelay (unsigned long);
e2211743
WD
782ulong usec2ticks (unsigned long usec);
783ulong ticks2usec (unsigned long ticks);
784int init_timebase (void);
785
78acc472 786/* lib/gunzip.c */
87d93a1b
WW
787int gunzip(void *, int, unsigned char *, unsigned long *);
788int zunzip(void *dst, int dstlen, unsigned char *src, unsigned long *lenp,
789 int stoponerr, int offset);
790
918e9ebb
EN
791/**
792 * gzwrite progress indicators: defined weak to allow board-specific
793 * overrides:
794 *
795 * gzwrite_progress_init called on startup
796 * gzwrite_progress called during decompress/write loop
797 * gzwrite_progress_finish called at end of loop to
798 * indicate success (retcode=0) or failure
799 */
800void gzwrite_progress_init(u64 expected_size);
801
802void gzwrite_progress(int iteration,
803 u64 bytes_written,
804 u64 total_bytes);
805
806void gzwrite_progress_finish(int retcode,
807 u64 totalwritten,
808 u64 totalsize,
809 u32 expected_crc,
810 u32 calculated_crc);
811
812/**
813 * decompress and write gzipped image from memory to block device
814 *
815 * @param src compressed image address
816 * @param len compressed image length in bytes
817 * @param dev block device descriptor
818 * @param szwritebuf bytes per write (pad to erase size)
819 * @param startoffs offset in bytes of first write
820 * @param szexpected expected uncompressed length
821 * may be zero to use gzip trailer
822 * for files under 4GiB
823 */
824int gzwrite(unsigned char *src, int len,
825 struct block_dev_desc *dev,
826 unsigned long szwritebuf,
827 u64 startoffs,
828 u64 szexpected);
829
027b728d
JW
830/* lib/lz4_wrapper.c */
831int ulz4fn(const void *src, size_t srcn, void *dst, size_t *dstn);
832
54c6977e
WD
833/* lib/qsort.c */
834void qsort(void *base, size_t nmemb, size_t size,
835 int(*compar)(const void *, const void *));
560d424b 836int strcmp_compar(const void *, const void *);
54c6977e 837
78acc472 838/* lib/time.c */
3eb90bad 839void udelay (unsigned long);
c4c9fbeb 840void mdelay(unsigned long);
3eb90bad 841
e11938ea 842/* lib/uuid.c */
d718ded0 843#include <uuid.h>
e11938ea 844
78acc472 845/* lib/vsprintf.c */
9785c905 846#include <vsprintf.h>
e2211743 847
78acc472 848/* lib/strmhz.c */
55f7934d 849char * strmhz(char *buf, unsigned long hz);
0768b7a8 850
78acc472 851/* lib/crc32.c */
449609f5 852#include <u-boot/crc.h>
e2211743 853
9acf1ca5 854/* lib/rand.c */
9acf1ca5
MW
855#define RAND_MAX -1U
856void srand(unsigned int seed);
857unsigned int rand(void);
858unsigned int rand_r(unsigned int *seedp);
9acf1ca5 859
e2211743
WD
860/*
861 * STDIO based functions (can always be used)
862 */
e2211743 863/* serial stuff */
d9c27253 864int serial_printf (const char *fmt, ...)
dc4b0b38 865 __attribute__ ((format (__printf__, 1, 2)));
e2211743
WD
866/* stdin */
867int getc(void);
868int tstc(void);
869
870/* stdout */
80402f34
HS
871#if defined(CONFIG_SPL_BUILD) && !defined(CONFIG_SPL_SERIAL_SUPPORT)
872#define putc(...) do { } while (0)
873#define puts(...) do { } while (0)
874#define printf(...) do { } while (0)
875#define vprintf(...) do { } while (0)
876#else
e2211743
WD
877void putc(const char c);
878void puts(const char *s);
d9c27253 879int printf(const char *fmt, ...)
dc4b0b38 880 __attribute__ ((format (__printf__, 1, 2)));
d9c27253 881int vprintf(const char *fmt, va_list args);
80402f34 882#endif
e2211743
WD
883
884/* stderr */
885#define eputc(c) fputc(stderr, c)
886#define eputs(s) fputs(stderr, s)
887#define eprintf(fmt,args...) fprintf(stderr,fmt ,##args)
888
889/*
890 * FILE based functions (can only be used AFTER relocation!)
891 */
e2211743
WD
892#define stdin 0
893#define stdout 1
894#define stderr 2
895#define MAX_FILES 3
896
d9c27253 897int fprintf(int file, const char *fmt, ...)
dc4b0b38 898 __attribute__ ((format (__printf__, 2, 3)));
e2211743
WD
899void fputs(int file, const char *s);
900void fputc(int file, const char c);
901int ftstc(int file);
902int fgetc(int file);
903
88d52c6a
LW
904/* lib/gzip.c */
905int gzip(void *dst, unsigned long *lenp,
906 unsigned char *src, unsigned long srclen);
907int zzip(void *dst, unsigned long *lenp, unsigned char *src,
908 unsigned long srclen, int stoponerr,
909 int (*func)(unsigned long, unsigned long));
910
4ef8d53c
JH
911/* lib/net_utils.c */
912#include <net.h>
049a95a7 913static inline struct in_addr getenv_ip(char *var)
4ef8d53c
JH
914{
915 return string_to_ip(getenv(var));
916}
917
e2211743
WD
918int pcmcia_init (void);
919
fb364bec
WD
920#ifdef CONFIG_STATUS_LED
921# include <status_led.h>
922#endif
097e1783
SG
923
924#include <bootstage.h>
e2211743 925
48522bb5
JH
926#ifdef CONFIG_SHOW_ACTIVITY
927void show_activity(int arg);
928#endif
929
fcd3c87e
WD
930/* Multicore arch functions */
931#ifdef CONFIG_MP
932int cpu_status(int nr);
933int cpu_reset(int nr);
4194b366 934int cpu_disable(int nr);
54841ab5 935int cpu_release(int nr, int argc, char * const argv[]);
fcd3c87e
WD
936#endif
937
938#endif /* __ASSEMBLY__ */
939
13e95e42
SR
940#ifdef CONFIG_PPC
941/*
942 * Has to be included outside of the #ifndef __ASSEMBLY__ section.
943 * Otherwise might lead to compilation errors in assembler files.
944 */
945#include <asm/cache.h>
946#endif
947
fcd3c87e
WD
948/* Put only stuff here that the assembler can digest */
949
950#ifdef CONFIG_POST
951#define CONFIG_HAS_POST
800eb096
MZ
952#ifndef CONFIG_POST_ALT_LIST
953#define CONFIG_POST_STD_LIST
954#endif
fcd3c87e
WD
955#endif
956
8aa1a2d1 957#ifdef CONFIG_INIT_CRITICAL
2f6fa46d 958#error CONFIG_INIT_CRITICAL is deprecated!
8aa1a2d1
WD
959#error Read section CONFIG_SKIP_LOWLEVEL_INIT in README.
960#endif
961
155cfb5e 962#define ROUND(a,b) (((a) + (b) - 1) & ~((b) - 1))
4b03ac8b 963
c9689ca3
SG
964/*
965 * check_member() - Check the offset of a structure member
966 *
967 * @structure: Name of structure (e.g. global_data)
968 * @member: Name of member (e.g. baudrate)
969 * @offset: Expected offset in bytes
970 */
971#define check_member(structure, member, offset) _Static_assert( \
972 offsetof(struct structure, member) == offset, \
973 "`struct " #structure "` offset for `" #member "` is not " #offset)
974
476476e7
SG
975/* Avoid using CONFIG_EFI_STUB directly as we may boot from other loaders */
976#ifdef CONFIG_EFI_STUB
977#define ll_boot_init() false
978#else
979#define ll_boot_init() true
980#endif
981
c3eb3fe4
MF
982/* Pull in stuff for the build system */
983#ifdef DO_DEPS_ONLY
984# include <environment.h>
985#endif
986
e2211743 987#endif /* __COMMON_H_ */