]> git.ipfire.org Git - people/ms/u-boot.git/blame - include/common.h
mips: move CONFIG_MIPS{32, 64} definition to config.mk
[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>
a821d08d 26#if defined(CONFIG_PCI) && defined(CONFIG_4xx)
e2211743
WD
27#include <pci.h>
28#endif
180d3f74 29#if defined(CONFIG_8xx)
e2211743 30#include <asm/8xx_immap.h>
d4ca31c4
WD
31#if defined(CONFIG_MPC852) || defined(CONFIG_MPC852T) || \
32 defined(CONFIG_MPC859) || defined(CONFIG_MPC859T) || \
33 defined(CONFIG_MPC859DSL) || \
34 defined(CONFIG_MPC866) || defined(CONFIG_MPC866T) || \
35 defined(CONFIG_MPC866P)
d0b8feef 36# define CONFIG_MPC866_FAMILY 1
180d3f74
WD
37#elif defined(CONFIG_MPC870) \
38 || defined(CONFIG_MPC875) \
39 || defined(CONFIG_MPC880) \
40 || defined(CONFIG_MPC885)
d0b8feef 41# define CONFIG_MPC885_FAMILY 1
180d3f74
WD
42#endif
43#if defined(CONFIG_MPC860) \
44 || defined(CONFIG_MPC860T) \
1114257c
WD
45 || defined(CONFIG_MPC866_FAMILY) \
46 || defined(CONFIG_MPC885_FAMILY)
d0b8feef 47# define CONFIG_MPC86x 1
2535d602 48#endif
0db5bca8
WD
49#elif defined(CONFIG_5xx)
50#include <asm/5xx_immap.h>
7e6bf358
WD
51#elif defined(CONFIG_MPC5xxx)
52#include <mpc5xxx.h>
8993e54b 53#elif defined(CONFIG_MPC512X)
8993e54b 54#include <asm/immap_512x.h>
e2211743 55#elif defined(CONFIG_8260)
04a85b3b
WD
56#if defined(CONFIG_MPC8247) \
57 || defined(CONFIG_MPC8248) \
58 || defined(CONFIG_MPC8271) \
59 || defined(CONFIG_MPC8272)
d0b8feef 60#define CONFIG_MPC8272_FAMILY 1
04a85b3b
WD
61#endif
62#if defined(CONFIG_MPC8272_FAMILY)
d0b8feef 63#define CONFIG_MPC8260 1
04a85b3b 64#endif
e2211743
WD
65#include <asm/immap_8260.h>
66#endif
debb7354
JL
67#ifdef CONFIG_MPC86xx
68#include <mpc86xx.h>
69#include <asm/immap_86xx.h>
70#endif
42d1f039
WD
71#ifdef CONFIG_MPC85xx
72#include <mpc85xx.h>
73#include <asm/immap_85xx.h>
74#endif
0f898604 75#ifdef CONFIG_MPC83xx
f046ccd1
EL
76#include <mpc83xx.h>
77#include <asm/immap_83xx.h>
78#endif
e2211743 79#ifdef CONFIG_4xx
b36df561 80#include <asm/ppc4xx.h>
e2211743
WD
81#endif
82#ifdef CONFIG_HYMOD
6dd652fa 83#include <board/hymod/hymod.h>
e2211743
WD
84#endif
85#ifdef CONFIG_ARM
86#define asmlinkage /* nothing */
87#endif
6cfcce67
MF
88#ifdef CONFIG_BLACKFIN
89#include <asm/blackfin.h>
90#endif
2819e136
SN
91#ifdef CONFIG_SOC_DA8XX
92#include <asm/arch/hardware.h>
93#endif
e2211743
WD
94
95#include <part.h>
96#include <flash.h>
97#include <image.h>
98
4d1fd7f1
YS
99#ifdef __LP64__
100#define CONFIG_SYS_SUPPORT_64BIT_DATA
101#endif
102
21726a7a 103#ifdef DEBUG
88a85fb9 104#define _DEBUG 1
21726a7a 105#else
88a85fb9 106#define _DEBUG 0
21726a7a
SG
107#endif
108
88a85fb9
MV
109/*
110 * Output a debug text when condition "cond" is met. The "cond" should be
111 * computed by a preprocessor in the best case, allowing for the best
112 * optimization.
113 */
114#define debug_cond(cond, fmt, args...) \
115 do { \
116 if (cond) \
117 printf(fmt, ##args); \
118 } while (0)
119
120#define debug(fmt, args...) \
121 debug_cond(_DEBUG, fmt, ##args)
122
21726a7a
SG
123/*
124 * An assertion is run-time check done in debug mode only. If DEBUG is not
125 * defined then it is skipped. If DEBUG is defined and the assertion fails,
126 * then it calls panic*( which may or may not reset/halt U-Boot (see
127 * CONFIG_PANIC_HANG), It is hoped that all failing assertions are found
128 * before release, and after release it is hoped that they don't matter. But
129 * in any case these failing assertions cannot be fixed with a reset (which
130 * may just do the same assertion again).
131 */
132void __assert_fail(const char *assertion, const char *file, unsigned line,
133 const char *function);
134#define assert(x) \
135 ({ if (!(x) && _DEBUG) \
136 __assert_fail(#x, __FILE__, __LINE__, __func__); })
137
594d57d0
MK
138#define error(fmt, args...) do { \
139 printf("ERROR: " fmt "\nat %s:%d/%s()\n", \
140 ##args, __FILE__, __LINE__, __func__); \
141} while (0)
142
cfa460ad 143#ifndef BUG
43835aac 144#define BUG() do { \
511d0c72 145 printf("BUG: failure at %s:%d/%s()!\n", __FILE__, __LINE__, __FUNCTION__); \
43835aac
DZ
146 panic("BUG!"); \
147} while (0)
148#define BUG_ON(condition) do { if (unlikely((condition)!=0)) BUG(); } while(0)
cfa460ad 149#endif /* BUG */
43835aac 150
c00e17c7
HS
151/* Force a compilation error if condition is true */
152#define BUILD_BUG_ON(condition) ((void)sizeof(char[1 - 2*!!(condition)]))
153
c83bf6a2 154typedef void (interrupt_handler_t)(void *);
e2211743 155
c83bf6a2 156#include <asm/u-boot.h> /* boot information for Linux kernel */
e2211743
WD
157#include <asm/global_data.h> /* global data used for startup functions */
158
71f95118
WD
159/*
160 * enable common handling for all TQM8xxL/M boards:
11d9eec4 161 * - CONFIG_TQM8xxM will be defined for all TQM8xxM boards
71f95118 162 * - CONFIG_TQM8xxL will be defined for all TQM8xxL _and_ TQM8xxM boards
11d9eec4 163 * and for the TQM885D board
71f95118
WD
164 */
165#if defined(CONFIG_TQM823M) || defined(CONFIG_TQM850M) || \
166 defined(CONFIG_TQM855M) || defined(CONFIG_TQM860M) || \
11d9eec4 167 defined(CONFIG_TQM862M) || defined(CONFIG_TQM866M)
71f95118
WD
168# ifndef CONFIG_TQM8xxM
169# define CONFIG_TQM8xxM
170# endif
171#endif
e2211743 172#if defined(CONFIG_TQM823L) || defined(CONFIG_TQM850L) || \
d126bfbd 173 defined(CONFIG_TQM855L) || defined(CONFIG_TQM860L) || \
11d9eec4
MK
174 defined(CONFIG_TQM862L) || defined(CONFIG_TQM8xxM) || \
175 defined(CONFIG_TQM885D)
e2211743
WD
176# ifndef CONFIG_TQM8xxL
177# define CONFIG_TQM8xxL
178# endif
179#endif
180
c7de829c
WD
181/*
182 * General Purpose Utilities
183 */
184#define min(X, Y) \
4f4eab4d
VG
185 ({ typeof(X) __x = (X); \
186 typeof(Y) __y = (Y); \
c7de829c
WD
187 (__x < __y) ? __x : __y; })
188
189#define max(X, Y) \
4f4eab4d
VG
190 ({ typeof(X) __x = (X); \
191 typeof(Y) __y = (Y); \
c7de829c
WD
192 (__x > __y) ? __x : __y; })
193
20d04774
AF
194#define MIN(x, y) min(x, y)
195#define MAX(x, y) max(x, y)
196
4f4eab4d
VG
197#define min3(X, Y, Z) \
198 ({ typeof(X) __x = (X); \
199 typeof(Y) __y = (Y); \
200 typeof(Z) __z = (Z); \
201 __x < __y ? (__x < __z ? __x : __z) : \
202 (__y < __z ? __y : __z); })
203
204#define max3(X, Y, Z) \
205 ({ typeof(X) __x = (X); \
206 typeof(Y) __y = (Y); \
207 typeof(Z) __z = (Z); \
208 __x > __y ? (__x > __z ? __x : __z) : \
209 (__y > __z ? __y : __z); })
210
211#define MIN3(x, y, z) min3(x, y, z)
212#define MAX3(x, y, z) max3(x, y, z)
213
a35925b8
SG
214/*
215 * Return the absolute value of a number.
216 *
217 * This handles unsigned and signed longs, ints, shorts and chars. For all
218 * input types abs() returns a signed long.
219 *
220 * For 64-bit types, use abs64()
221 */
222#define abs(x) ({ \
223 long ret; \
224 if (sizeof(x) == sizeof(long)) { \
225 long __x = (x); \
226 ret = (__x < 0) ? -__x : __x; \
227 } else { \
228 int __x = (x); \
229 ret = (__x < 0) ? -__x : __x; \
230 } \
231 ret; \
232 })
233
234#define abs64(x) ({ \
235 s64 __x = (x); \
236 (__x < 0) ? -__x : __x; \
237 })
238
3fbeeea6
HS
239#if defined(CONFIG_ENV_IS_EMBEDDED)
240#define TOTAL_MALLOC_LEN CONFIG_SYS_MALLOC_LEN
241#elif ( ((CONFIG_ENV_ADDR+CONFIG_ENV_SIZE) < CONFIG_SYS_MONITOR_BASE) || \
242 (CONFIG_ENV_ADDR >= (CONFIG_SYS_MONITOR_BASE + CONFIG_SYS_MONITOR_LEN)) ) || \
243 defined(CONFIG_ENV_IS_IN_NVRAM)
244#define TOTAL_MALLOC_LEN (CONFIG_SYS_MALLOC_LEN + CONFIG_ENV_SIZE)
245#else
246#define TOTAL_MALLOC_LEN CONFIG_SYS_MALLOC_LEN
247#endif
c7de829c 248
28901120
HS
249/**
250 * container_of - cast a member of a structure out to the containing structure
251 * @ptr: the pointer to the member.
252 * @type: the type of the container struct this is embedded in.
253 * @member: the name of the member within the struct.
254 *
255 */
256#define container_of(ptr, type, member) ({ \
257 const typeof( ((type *)0)->member ) *__mptr = (ptr); \
258 (type *)( (char *)__mptr - offsetof(type,member) );})
259
e2211743
WD
260/*
261 * Function Prototypes
262 */
263
c83bf6a2 264void hang (void) __attribute__ ((noreturn));
e2211743 265
f6c019c4
WD
266int timer_init(void);
267int cpu_init(void);
268
e2211743 269/* */
9973e3c6 270phys_size_t initdram (int);
c83bf6a2 271int display_options (void);
4b42c905 272void print_size(unsigned long long, const char *);
bda32ffc
SG
273int print_buffer(ulong addr, const void *data, uint width, uint count,
274 uint linelen);
e2211743
WD
275
276/* common/main.c */
277void main_loop (void);
009dde19 278int run_command(const char *cmd, int flag);
d51004a8
SG
279
280/**
281 * Run a list of commands separated by ; or even \0
282 *
283 * Note that if 'len' is not -1, then the command does not need to be nul
284 * terminated, Memory will be allocated for the command in that case.
285 *
286 * @param cmd List of commands to run, each separated bu semicolon
287 * @param len Length of commands excluding terminator if known (-1 if not)
288 * @param flag Execution flags (CMD_FLAG_...)
289 * @return 0 on success, or != 0 on error.
290 */
291int run_command_list(const char *cmd, int len, int flag);
e2211743 292int readline (const char *const prompt);
9c348311
HS
293int readline_into_buffer(const char *const prompt, char *buffer,
294 int timeout);
6636b62a 295int parse_line (char *, char *[]);
6dd652fa 296void init_cmd_timeout(void);
e2211743 297void reset_cmd_timeout(void);
e3150460 298extern char console_buffer[];
e2211743 299
ea0364f1 300/* arch/$(ARCH)/lib/board.c */
e05e5de7 301void board_init_f(ulong);
6d1b6f9f 302void board_init_r (gd_t *, ulong) __attribute__ ((noreturn));
e2211743
WD
303int checkboard (void);
304int checkflash (void);
305int checkdram (void);
e2211743 306int last_stage_init(void);
3b57fe0a 307extern ulong monitor_flash_len;
bea3f28d 308int mac_read_from_eeprom(void);
6ab6b2af 309extern u8 __dtb_dt_begin[]; /* embedded device tree blob */
8f5d4687 310int set_cpu_clk_info(void);
365475e6 311#if defined(CONFIG_DISPLAY_CPUINFO)
1938f4a5 312int print_cpuinfo(void);
365475e6
MY
313#else
314static inline int print_cpuinfo(void)
315{
316 return 0;
317}
318#endif
c2240d4d 319int update_flash_size(int flash_size);
e2211743 320
15a33e49
SG
321/**
322 * Show the DRAM size in a board-specific way
323 *
324 * This is used by boards to display DRAM information in their own way.
325 *
326 * @param size Size of DRAM (which should be displayed along with other info)
327 */
328void board_show_dram(ulong size);
329
13d06981
SG
330/**
331 * arch_fixup_memory_node() - Write arch-specific memory information to fdt
332 *
333 * Defined in arch/$(ARCH)/lib/bootm.c
334 *
335 * @blob: FDT blob to write to
336 * @return 0 if ok, or -ve FDT_ERR_... on failure
337 */
338int arch_fixup_memory_node(void *blob);
339
e2211743
WD
340/* common/flash.c */
341void flash_perror (int);
342
74de7aef
WD
343/* common/cmd_source.c */
344int source (ulong addr, const char *fit_uname);
e2211743 345
c83bf6a2 346extern ulong load_addr; /* Default Load Address */
1aec244a
SG
347extern ulong save_addr; /* Default Save Address */
348extern ulong save_size; /* Default Save Size */
e2211743 349
4394f9a8
WD
350/* common/cmd_doc.c */
351void doc_probe(unsigned long physadr);
352
06283a64
JH
353/* common/cmd_net.c */
354int do_tftpb(cmd_tbl_t *cmdtp, int flag, int argc, char * const argv[]);
355
669df7e4
RH
356/* common/cmd_fat.c */
357int do_fat_fsload(cmd_tbl_t *, int, int, char * const []);
358
359/* common/cmd_ext2.c */
360int do_ext2load(cmd_tbl_t *, int, int, char * const []);
361
e2211743
WD
362/* common/cmd_nvedit.c */
363int env_init (void);
364void env_relocate (void);
26a41790 365int envmatch (uchar *, int);
84b5e802
WD
366char *getenv (const char *);
367int getenv_f (const char *name, char *buf, unsigned len);
4a9b4131 368ulong getenv_ulong(const char *name, int base, ulong default_val);
76b8f79c
SG
369
370/**
371 * getenv_hex() - Return an environment variable as a hex value
372 *
373 * Decode an environment as a hex number (it may or may not have a 0x
374 * prefix). If the environment variable cannot be found, or does not start
375 * with hex digits, the default value is returned.
376 *
377 * @varname: Variable to decode
378 * @default_val: Value to return on error
379 */
380ulong getenv_hex(const char *varname, ulong default_val);
381
ec8a252c
JH
382/*
383 * Read an environment variable as a boolean
384 * Return -1 if variable does not exist (default to true)
385 */
386int getenv_yesno(const char *var);
c83bf6a2 387int saveenv (void);
84b5e802 388int setenv (const char *, const char *);
d67f10ce 389int setenv_ulong(const char *varname, ulong value);
bfc59966
SG
390int setenv_hex(const char *varname, ulong value);
391/**
392 * setenv_addr - Set an environment variable to an address in hex
393 *
1bce2aeb 394 * @varname: Environment variable to set
bfc59966
SG
395 * @addr: Value to set it to
396 * @return 0 if ok, 1 on error
397 */
398static inline int setenv_addr(const char *varname, const void *addr)
399{
400 return setenv_hex(varname, (ulong)addr);
401}
402
e2211743 403#ifdef CONFIG_ARM
96085e34 404# include <asm/mach-types.h>
b6e4c403 405# include <asm/setup.h>
e2211743
WD
406# include <asm/u-boot-arm.h> /* ARM version to be fixed! */
407#endif /* CONFIG_ARM */
fea25720
GR
408#ifdef CONFIG_X86 /* x86 version to be fixed! */
409# include <asm/u-boot-x86.h>
410#endif /* CONFIG_X86 */
744d9859
SG
411#ifdef CONFIG_SANDBOX
412# include <asm/u-boot-sandbox.h> /* TODO(sjg) what needs to be fixed? */
413#endif
e7083844
ML
414#ifdef CONFIG_NDS32
415# include <asm/mach-types.h>
e3c58b02 416# include <asm/setup.h>
e7083844
ML
417# include <asm/u-boot-nds32.h>
418#endif /* CONFIG_NDS32 */
e034ea3b
DS
419#ifdef CONFIG_MIPS
420# include <asm/u-boot-mips.h>
421#endif /* CONFIG_MIPS */
bc5d5428
AB
422#ifdef CONFIG_ARC
423# include <asm/u-boot-arc.h>
424#endif /* CONFIG_ARC */
e2211743 425
04a85b3b
WD
426#ifdef CONFIG_AUTO_COMPLETE
427int env_complete(char *var, int maxv, char *cmdv[], int maxsz, char *buf);
428#endif
2f70c49e 429int get_env_id (void);
04a85b3b 430
c83bf6a2
WD
431void pci_init (void);
432void pci_init_board(void);
433void pciinfo (int, int);
e2211743 434
a821d08d 435#if defined(CONFIG_PCI) && defined(CONFIG_4xx)
c71103f9
MF
436 int pci_pre_init (struct pci_controller *);
437 int is_pci_host (struct pci_controller *);
466fff1a
SR
438#endif
439
dbbd1257 440#if defined(CONFIG_PCI) && (defined(CONFIG_440) || defined(CONFIG_405EX))
6d0f6bcf 441# if defined(CONFIG_SYS_PCI_TARGET_INIT)
c83bf6a2 442 void pci_target_init (struct pci_controller *);
e2211743 443# endif
6d0f6bcf 444# if defined(CONFIG_SYS_PCI_MASTER_INIT)
c83bf6a2 445 void pci_master_init (struct pci_controller *);
e2211743 446# endif
6f2eb3f3
SR
447#if defined(CONFIG_440SPE) || \
448 defined(CONFIG_460EX) || defined(CONFIG_460GT) || \
449 defined(CONFIG_405EX)
7f191393 450 void pcie_setup_hoses(int busno);
692519b1 451#endif
e2211743
WD
452#endif
453
454int misc_init_f (void);
455int misc_init_r (void);
456
27b207fd
WD
457/* common/exports.c */
458void jumptable_init(void);
459
ecb1dc89
MF
460/* common/kallsysm.c */
461const char *symbol_lookup(unsigned long addr, unsigned long *caddr);
462
500856eb
RJ
463/* api/api.c */
464void api_init (void);
465
c83bf6a2 466/* common/memsize.c */
a55d23cc 467long get_ram_size (long *, long);
e3866163 468phys_size_t get_effective_memsize(void);
c83bf6a2 469
e2211743
WD
470/* $(BOARD)/$(BOARD).c */
471void reset_phy (void);
c83bf6a2 472void fdc_hw_init (void);
e2211743
WD
473
474/* $(BOARD)/eeprom.c */
475void eeprom_init (void);
6dd652fa
WD
476#ifndef CONFIG_SPI
477int eeprom_probe (unsigned dev_addr, unsigned offset);
478#endif
e2211743
WD
479int eeprom_read (unsigned dev_addr, unsigned offset, uchar *buffer, unsigned cnt);
480int eeprom_write (unsigned dev_addr, unsigned offset, uchar *buffer, unsigned cnt);
481#ifdef CONFIG_LWMON
482extern uchar pic_read (uchar reg);
483extern void pic_write (uchar reg, uchar val);
484#endif
485
486/*
487 * Set this up regardless of board
488 * type, to prevent errors.
489 */
6d0f6bcf
JCPV
490#if defined(CONFIG_SPI) || !defined(CONFIG_SYS_I2C_EEPROM_ADDR)
491# define CONFIG_SYS_DEF_EEPROM_ADDR 0
e2211743 492#else
548738b4 493#if !defined(CONFIG_ENV_EEPROM_IS_ON_I2C)
6d0f6bcf 494# define CONFIG_SYS_DEF_EEPROM_ADDR CONFIG_SYS_I2C_EEPROM_ADDR
548738b4 495#endif
6d0f6bcf 496#endif /* CONFIG_SPI || !defined(CONFIG_SYS_I2C_EEPROM_ADDR) */
e2211743 497
bdccc4fe 498#if defined(CONFIG_SPI)
e2211743
WD
499extern void spi_init_f (void);
500extern void spi_init_r (void);
c83bf6a2 501extern ssize_t spi_read (uchar *, int, uchar *, int);
e2211743
WD
502extern ssize_t spi_write (uchar *, int, uchar *, int);
503#endif
504
505#ifdef CONFIG_RPXCLASSIC
506void rpxclassic_init (void);
507#endif
508
e63c8ee3
WD
509void rpxlite_init (void);
510
e2211743
WD
511#ifdef CONFIG_MBX
512/* $(BOARD)/mbx8xx.c */
513void mbx_init (void);
514void board_serial_init (void);
515void board_ether_init (void);
516#endif
517
e2211743
WD
518#ifdef CONFIG_HERMES
519/* $(BOARD)/hermes.c */
520void hermes_start_lxt980 (int speed);
521#endif
522
523#ifdef CONFIG_EVB64260
524void evb64260_init(void);
525void debug_led(int, int);
526void display_mem_map(void);
527void perform_soft_reset(void);
528#endif
529
e2211743 530/* $(BOARD)/$(BOARD).c */
c837dcb1
WD
531int board_early_init_f (void);
532int board_late_init (void);
e2211743 533int board_postclk_init (void); /* after clocks/timebase, before env/serial */
c837dcb1 534int board_early_init_r (void);
e2211743
WD
535void board_poweroff (void);
536
6d0f6bcf 537#if defined(CONFIG_SYS_DRAM_TEST)
e2211743 538int testdram(void);
6d0f6bcf 539#endif /* CONFIG_SYS_DRAM_TEST */
e2211743
WD
540
541/* $(CPU)/start.S */
c83bf6a2 542#if defined(CONFIG_5xx) || \
0db5bca8 543 defined(CONFIG_8xx)
e2211743
WD
544uint get_immr (uint);
545#endif
c83bf6a2 546uint get_pir (void);
36c72877
WD
547#if defined(CONFIG_MPC5xxx)
548uint get_svr (void);
549#endif
e2211743 550uint get_pvr (void);
547b4cb2 551uint get_svr (void);
e2211743
WD
552uint rd_ic_cst (void);
553void wr_ic_cst (uint);
554void wr_ic_adr (uint);
555uint rd_dc_cst (void);
556void wr_dc_cst (uint);
557void wr_dc_adr (uint);
558int icache_status (void);
559void icache_enable (void);
560void icache_disable(void);
561int dcache_status (void);
562void dcache_enable (void);
563void dcache_disable(void);
2c451f78 564void mmu_disable(void);
5c6db120
BT
565#if defined(CONFIG_ARM)
566void relocate_code(ulong);
567#else
568void relocate_code(ulong, gd_t *, ulong) __attribute__ ((noreturn));
959eaa74 569#endif
e2211743
WD
570ulong get_endaddr (void);
571void trap_init (ulong);
572#if defined (CONFIG_4xx) || \
eeb1b77b 573 defined (CONFIG_MPC5xxx) || \
e2211743
WD
574 defined (CONFIG_74xx_7xx) || \
575 defined (CONFIG_74x) || \
576 defined (CONFIG_75x) || \
0ac6f8b7 577 defined (CONFIG_74xx) || \
cd94ba39 578 defined (CONFIG_MPC85xx) || \
debb7354 579 defined (CONFIG_MPC86xx) || \
0f898604 580 defined (CONFIG_MPC83xx)
c83bf6a2
WD
581unsigned char in8(unsigned int);
582void out8(unsigned int, unsigned char);
583unsigned short in16(unsigned int);
584unsigned short in16r(unsigned int);
585void out16(unsigned int, unsigned short value);
586void out16r(unsigned int, unsigned short value);
587unsigned long in32(unsigned int);
588unsigned long in32r(unsigned int);
589void out32(unsigned int, unsigned long value);
590void out32r(unsigned int, unsigned long value);
591void ppcDcbf(unsigned long value);
592void ppcDcbi(unsigned long value);
593void ppcSync(void);
0ac6f8b7 594void ppcDcbz(unsigned long value);
e2211743 595#endif
0643631a
MS
596#if defined (CONFIG_MICROBLAZE)
597unsigned short in16(unsigned int);
598void out16(unsigned int, unsigned short value);
599#endif
e2211743 600
0f898604 601#if defined (CONFIG_MPC83xx)
90f30a71
DL
602void ppcDWload(unsigned int *addr, unsigned int *ret);
603void ppcDWstore(unsigned int *addr, unsigned int *value);
7c6db910
HS
604void disable_addr_trans(void);
605void enable_addr_trans(void);
606#if defined(CONFIG_DDR_ECC) && !defined(CONFIG_ECC_INIT_VIA_DDRCONTROLLER)
607void ddr_enable_ecc(unsigned int dram_size);
608#endif
90f30a71
DL
609#endif
610
fc9ae1ba
RS
611/*
612 * Return the current value of a monotonically increasing microsecond timer.
613 * Granularity may be larger than 1us if hardware does not support this.
614 */
615ulong timer_get_us(void);
616
e2211743 617/* $(CPU)/cpu.c */
fbb9ecf7
TT
618static inline int cpumask_next(int cpu, unsigned int mask)
619{
620 for (cpu++; !((1 << cpu) & mask); cpu++)
621 ;
622
623 return cpu;
624}
625
626#define for_each_cpu(iter, cpu, num_cpus, mask) \
627 for (iter = 0, cpu = cpumask_next(-1, mask); \
628 iter < num_cpus; \
629 iter++, cpu = cpumask_next(cpu, mask)) \
630
0e870980 631int cpu_numcores (void);
fbb9ecf7
TT
632u32 cpu_mask (void);
633int is_core_valid (unsigned int);
0e870980 634int probecpu (void);
e2211743
WD
635int checkcpu (void);
636int checkicache (void);
637int checkdcache (void);
638void upmconfig (unsigned int, unsigned int *, unsigned int);
639ulong get_tbclk (void);
3ec924a3 640void reset_cpu (ulong addr);
6a16e0df
KP
641#if defined (CONFIG_OF_LIBFDT) && defined (CONFIG_OF_BOARD_SETUP)
642void ft_cpu_setup(void *blob, bd_t *bd);
643#ifdef CONFIG_PCI
644void ft_pci_setup(void *blob, bd_t *bd);
645#endif
646#endif
647
ba6a1698
AP
648void smp_set_core_boot_addr(unsigned long addr, int corenr);
649void smp_kick_all_cpus(void);
e2211743
WD
650
651/* $(CPU)/serial.c */
652int serial_init (void);
653void serial_setbrg (void);
654void serial_putc (const char);
756f586a 655void serial_putc_raw(const char);
e2211743 656void serial_puts (const char *);
e2211743
WD
657int serial_getc (void);
658int serial_tstc (void);
659
756f586a
WD
660void _serial_setbrg (const int);
661void _serial_putc (const char, const int);
662void _serial_putc_raw(const char, const int);
663void _serial_puts (const char *, const int);
664int _serial_getc (const int);
665int _serial_tstc (const int);
666
e2211743
WD
667/* $(CPU)/speed.c */
668int get_clocks (void);
c178d3da
WD
669int get_clocks_866 (void);
670int sdram_adjust_866 (void);
e9132ea9 671int adjust_sdram_tbs_8xx (void);
e2211743
WD
672#if defined(CONFIG_8260)
673int prt_8260_clks (void);
f046ccd1 674#elif defined(CONFIG_MPC5xxx)
945af8d7
WD
675int prt_mpc5xxx_clks (void);
676#endif
e2211743
WD
677#ifdef CONFIG_4xx
678ulong get_OPB_freq (void);
679ulong get_PCI_freq (void);
680#endif
ac67804f 681#if defined(CONFIG_S3C24X0) || \
682 defined(CONFIG_LH7A40X) || \
fcfb632b 683 defined(CONFIG_EP93XX)
e2211743
WD
684ulong get_FCLK (void);
685ulong get_HCLK (void);
686ulong get_PCLK (void);
687ulong get_UCLK (void);
688#endif
f39748ae
WD
689#if defined(CONFIG_LH7A40X)
690ulong get_PLLCLK (void);
691#endif
7cb22f97 692#if defined CONFIG_INCA_IP
c83bf6a2 693uint incaip_get_cpuclk (void);
7cb22f97 694#endif
281e00a3
WD
695#if defined(CONFIG_IMX)
696ulong get_systemPLLCLK(void);
697ulong get_FCLK(void);
698ulong get_HCLK(void);
699ulong get_BCLK(void);
700ulong get_PERCLK1(void);
701ulong get_PERCLK2(void);
702ulong get_PERCLK3(void);
703#endif
e2211743 704ulong get_bus_freq (ulong);
550650dd 705int get_serial_clock(void);
e2211743 706
d29d17d7
YS
707#if defined(CONFIG_MPC83xx) || defined(CONFIG_MPC85xx)
708ulong get_ddr_freq(ulong);
709#endif
42d1f039
WD
710#if defined(CONFIG_MPC85xx)
711typedef MPC85xx_SYS_INFO sys_info_t;
c83bf6a2 712void get_sys_info ( sys_info_t * );
871a57bb
MY
713# if defined(CONFIG_OF_LIBFDT)
714 void ft_fixup_cpu(void *, u64);
715 void ft_fixup_num_cores(void *);
716# endif
42d1f039 717#endif
debb7354
JL
718#if defined(CONFIG_MPC86xx)
719typedef MPC86xx_SYS_INFO sys_info_t;
720void get_sys_info ( sys_info_t * );
5df4b0ad
KG
721static inline ulong get_ddr_freq(ulong dummy)
722{
723 return get_bus_freq(dummy);
724}
debb7354 725#endif
42d1f039 726
99bcad18 727#if defined(CONFIG_4xx)
e2211743 728# if defined(CONFIG_440)
6c5879f3
MB
729# if defined(CONFIG_440SPE)
730 unsigned long determine_sysper(void);
731 unsigned long determine_pci_clock_per(void);
732# endif
e2211743 733# endif
087dfdb7 734typedef PPC4xx_SYS_INFO sys_info_t;
f31d38b9 735int ppc440spe_revB(void);
c83bf6a2 736void get_sys_info ( sys_info_t * );
e2211743
WD
737#endif
738
739/* $(CPU)/cpu_init.c */
740#if defined(CONFIG_8xx) || defined(CONFIG_8260)
741void cpu_init_f (volatile immap_t *immr);
742#endif
debb7354 743#if defined(CONFIG_4xx) || defined(CONFIG_MPC85xx) || defined(CONFIG_MCF52x2) ||defined(CONFIG_MPC86xx)
e2211743
WD
744void cpu_init_f (void);
745#endif
bf9e3b38 746
e2211743
WD
747int cpu_init_r (void);
748#if defined(CONFIG_8260)
749int prt_8260_rsr (void);
0f898604 750#elif defined(CONFIG_MPC83xx)
9be39a67 751int prt_83xx_rsr (void);
e2211743
WD
752#endif
753
754/* $(CPU)/interrupts.c */
c83bf6a2
WD
755int interrupt_init (void);
756void timer_interrupt (struct pt_regs *);
e2211743
WD
757void external_interrupt (struct pt_regs *);
758void irq_install_handler(int, interrupt_handler_t *, void *);
759void irq_free_handler (int);
760void reset_timer (void);
761ulong get_timer (ulong base);
b2e16a85
SG
762
763/* Return value of monotonic microsecond timer */
764unsigned long timer_get_us(void);
765
e2211743
WD
766void enable_interrupts (void);
767int disable_interrupts (void);
768
769/* $(CPU)/.../commproc.c */
770int dpram_init (void);
771uint dpram_base(void);
772uint dpram_base_align(uint align);
773uint dpram_alloc(uint size);
774uint dpram_alloc_align(uint size,uint align);
bdccc4fe
WD
775void bootcount_store (ulong);
776ulong bootcount_load (void);
777#define BOOTCOUNT_MAGIC 0xB001C041
e2211743
WD
778
779/* $(CPU)/.../<eth> */
c5bded3c 780void mii_init (void);
e2211743
WD
781
782/* $(CPU)/.../lcd.c */
783ulong lcd_setmem (ulong);
784
e2211743
WD
785/* $(CPU)/.../video.c */
786ulong video_setmem (ulong);
787
ea0364f1 788/* arch/$(ARCH)/lib/cache.c */
cba4b180 789void enable_caches(void);
e2211743 790void flush_cache (unsigned long, unsigned long);
2c451f78 791void flush_dcache_all(void);
03d3bfb0
SR
792void flush_dcache_range(unsigned long start, unsigned long stop);
793void invalidate_dcache_range(unsigned long start, unsigned long stop);
2c451f78
A
794void invalidate_dcache_all(void);
795void invalidate_icache_all(void);
0db5bca8 796
ea0364f1 797/* arch/$(ARCH)/lib/ticks.S */
e2211743
WD
798unsigned long long get_ticks(void);
799void wait_ticks (unsigned long);
800
ea0364f1 801/* arch/$(ARCH)/lib/time.c */
3eb90bad 802void __udelay (unsigned long);
e2211743
WD
803ulong usec2ticks (unsigned long usec);
804ulong ticks2usec (unsigned long ticks);
805int init_timebase (void);
806
78acc472 807/* lib/gunzip.c */
87d93a1b
WW
808int gunzip(void *, int, unsigned char *, unsigned long *);
809int zunzip(void *dst, int dstlen, unsigned char *src, unsigned long *lenp,
810 int stoponerr, int offset);
811
54c6977e
WD
812/* lib/qsort.c */
813void qsort(void *base, size_t nmemb, size_t size,
814 int(*compar)(const void *, const void *));
560d424b 815int strcmp_compar(const void *, const void *);
54c6977e 816
78acc472 817/* lib/time.c */
3eb90bad 818void udelay (unsigned long);
c4c9fbeb 819void mdelay(unsigned long);
3eb90bad 820
e11938ea
JH
821/* lib/uuid.c */
822void uuid_str_to_bin(const char *uuid, unsigned char *out);
823int uuid_str_valid(const char *uuid);
824
78acc472 825/* lib/vsprintf.c */
9785c905 826#include <vsprintf.h>
e2211743 827
78acc472 828/* lib/strmhz.c */
55f7934d 829char * strmhz(char *buf, unsigned long hz);
0768b7a8 830
78acc472 831/* lib/crc32.c */
449609f5 832#include <u-boot/crc.h>
e2211743 833
9acf1ca5 834/* lib/rand.c */
99e139d5
MW
835#if defined(CONFIG_RANDOM_MACADDR) || \
836 defined(CONFIG_BOOTP_RANDOM_DELAY) || \
837 defined(CONFIG_CMD_LINK_LOCAL)
9acf1ca5
MW
838#define RAND_MAX -1U
839void srand(unsigned int seed);
840unsigned int rand(void);
841unsigned int rand_r(unsigned int *seedp);
842#endif
843
e2211743 844/* common/console.c */
e2211743
WD
845int console_init_f(void); /* Before relocation; uses the serial stuff */
846int console_init_r(void); /* After relocation; uses the console stuff */
d7be3056 847int console_assign(int file, const char *devname); /* Assign the console */
e2211743
WD
848int ctrlc (void);
849int had_ctrlc (void); /* have we had a Control-C since last clear? */
850void clear_ctrlc (void); /* clear the Control-C condition */
851int disable_ctrlc (int); /* 1 to disable, 0 to enable Control-C detect */
852
853/*
854 * STDIO based functions (can always be used)
855 */
e2211743 856/* serial stuff */
d9c27253 857int serial_printf (const char *fmt, ...)
dc4b0b38 858 __attribute__ ((format (__printf__, 1, 2)));
e2211743
WD
859/* stdin */
860int getc(void);
861int tstc(void);
862
863/* stdout */
864void putc(const char c);
865void puts(const char *s);
d9c27253 866int printf(const char *fmt, ...)
dc4b0b38 867 __attribute__ ((format (__printf__, 1, 2)));
d9c27253 868int vprintf(const char *fmt, va_list args);
e2211743
WD
869
870/* stderr */
871#define eputc(c) fputc(stderr, c)
872#define eputs(s) fputs(stderr, s)
873#define eprintf(fmt,args...) fprintf(stderr,fmt ,##args)
874
875/*
876 * FILE based functions (can only be used AFTER relocation!)
877 */
e2211743
WD
878#define stdin 0
879#define stdout 1
880#define stderr 2
881#define MAX_FILES 3
882
d9c27253 883int fprintf(int file, const char *fmt, ...)
dc4b0b38 884 __attribute__ ((format (__printf__, 2, 3)));
e2211743
WD
885void fputs(int file, const char *s);
886void fputc(int file, const char c);
887int ftstc(int file);
888int fgetc(int file);
889
88d52c6a
LW
890/* lib/gzip.c */
891int gzip(void *dst, unsigned long *lenp,
892 unsigned char *src, unsigned long srclen);
893int zzip(void *dst, unsigned long *lenp, unsigned char *src,
894 unsigned long srclen, int stoponerr,
895 int (*func)(unsigned long, unsigned long));
896
4ef8d53c
JH
897/* lib/net_utils.c */
898#include <net.h>
899static inline IPaddr_t getenv_IPaddr(char *var)
900{
901 return string_to_ip(getenv(var));
902}
903
16a28ef2
GJ
904/*
905 * CONSOLE multiplexing.
906 */
907#ifdef CONFIG_CONSOLE_MUX
908#include <iomux.h>
909#endif
910
e2211743
WD
911int pcmcia_init (void);
912
fb364bec
WD
913#ifdef CONFIG_STATUS_LED
914# include <status_led.h>
915#endif
097e1783
SG
916
917#include <bootstage.h>
e2211743 918
48522bb5
JH
919#ifdef CONFIG_SHOW_ACTIVITY
920void show_activity(int arg);
921#endif
922
fcd3c87e
WD
923/* Multicore arch functions */
924#ifdef CONFIG_MP
925int cpu_status(int nr);
926int cpu_reset(int nr);
4194b366 927int cpu_disable(int nr);
54841ab5 928int cpu_release(int nr, int argc, char * const argv[]);
fcd3c87e
WD
929#endif
930
4213fc29
SG
931/* Define a null map_sysmem() if the architecture doesn't use it */
932# ifndef CONFIG_ARCH_MAP_SYSMEM
933static inline void *map_sysmem(phys_addr_t paddr, unsigned long len)
934{
935 return (void *)(uintptr_t)paddr;
936}
937
938static inline void unmap_sysmem(const void *vaddr)
939{
940}
781adb57 941
ed072b96 942static inline phys_addr_t map_to_sysmem(const void *ptr)
781adb57
SG
943{
944 return (phys_addr_t)(uintptr_t)ptr;
945}
4213fc29
SG
946# endif
947
fcd3c87e
WD
948#endif /* __ASSEMBLY__ */
949
13e95e42
SR
950#ifdef CONFIG_PPC
951/*
952 * Has to be included outside of the #ifndef __ASSEMBLY__ section.
953 * Otherwise might lead to compilation errors in assembler files.
954 */
955#include <asm/cache.h>
956#endif
957
fcd3c87e
WD
958/* Put only stuff here that the assembler can digest */
959
960#ifdef CONFIG_POST
961#define CONFIG_HAS_POST
800eb096
MZ
962#ifndef CONFIG_POST_ALT_LIST
963#define CONFIG_POST_STD_LIST
964#endif
fcd3c87e
WD
965#endif
966
8aa1a2d1 967#ifdef CONFIG_INIT_CRITICAL
2f6fa46d 968#error CONFIG_INIT_CRITICAL is deprecated!
8aa1a2d1
WD
969#error Read section CONFIG_SKIP_LOWLEVEL_INIT in README.
970#endif
971
3cfb0c51
KG
972#define ARRAY_SIZE(x) (sizeof(x) / sizeof((x)[0]))
973
155cfb5e 974#define ROUND(a,b) (((a) + (b) - 1) & ~((b) - 1))
d50c7d4b
WD
975#define DIV_ROUND(n,d) (((n) + ((d)/2)) / (d))
976#define DIV_ROUND_UP(n,d) (((n) + (d) - 1) / (d))
977#define roundup(x, y) ((((x) + ((y) - 1)) / (y)) * (y))
022f1216 978
23d5c738
SB
979/*
980 * Divide positive or negative dividend by positive divisor and round
981 * to closest integer. Result is undefined for negative divisors and
982 * for negative dividends if the divisor variable type is unsigned.
983 */
984#define DIV_ROUND_CLOSEST(x, divisor)( \
985{ \
986 typeof(x) __x = x; \
987 typeof(divisor) __d = divisor; \
988 (((typeof(x))-1) > 0 || \
989 ((typeof(divisor))-1) > 0 || (__x) > 0) ? \
990 (((__x) + ((__d) / 2)) / (__d)) : \
991 (((__x) - ((__d) / 2)) / (__d)); \
992} \
993)
994
4b03ac8b
AF
995#define ALIGN(x,a) __ALIGN_MASK((x),(typeof(x))(a)-1)
996#define __ALIGN_MASK(x,mask) (((x)+(mask))&~(mask))
997
1e41f5ad
AS
998/*
999 * ARCH_DMA_MINALIGN is defined in asm/cache.h for each architecture. It
1000 * is used to align DMA buffers.
1001 */
1002#ifndef __ASSEMBLY__
1003#include <asm/cache.h>
1004#endif
1005
46a6d51c
A
1006/*
1007 * The ALLOC_CACHE_ALIGN_BUFFER macro is used to allocate a buffer on the
1008 * stack that meets the minimum architecture alignment requirements for DMA.
1009 * Such a buffer is useful for DMA operations where flushing and invalidating
1010 * the cache before and after a read and/or write operation is required for
1011 * correct operations.
1012 *
1013 * When called the macro creates an array on the stack that is sized such
1014 * that:
1015 *
1016 * 1) The beginning of the array can be advanced enough to be aligned.
1017 *
1018 * 2) The size of the aligned portion of the array is a multiple of the minimum
1019 * architecture alignment required for DMA.
1020 *
1021 * 3) The aligned portion contains enough space for the original number of
1022 * elements requested.
1023 *
1024 * The macro then creates a pointer to the aligned portion of this array and
1025 * assigns to the pointer the address of the first element in the aligned
1026 * portion of the array.
1027 *
1028 * Calling the macro as:
1029 *
1030 * ALLOC_CACHE_ALIGN_BUFFER(uint32_t, buffer, 1024);
1031 *
1032 * Will result in something similar to saying:
1033 *
1034 * uint32_t buffer[1024];
1035 *
1036 * The following differences exist:
1037 *
1038 * 1) The resulting buffer is guaranteed to be aligned to the value of
1039 * ARCH_DMA_MINALIGN.
1040 *
1041 * 2) The buffer variable created by the macro is a pointer to the specified
1042 * type, and NOT an array of the specified type. This can be very important
1043 * if you want the address of the buffer, which you probably do, to pass it
1044 * to the DMA hardware. The value of &buffer is different in the two cases.
1045 * In the macro case it will be the address of the pointer, not the address
1046 * of the space reserved for the buffer. However, in the second case it
1047 * would be the address of the buffer. So if you are replacing hard coded
1048 * stack buffers with this macro you need to make sure you remove the & from
1049 * the locations where you are taking the address of the buffer.
1050 *
1051 * Note that the size parameter is the number of array elements to allocate,
1052 * not the number of bytes.
1053 *
1054 * This macro can not be used outside of function scope, or for the creation
1055 * of a function scoped static buffer. It can not be used to create a cache
1056 * line aligned global buffer.
1057 */
e8232fea 1058#define PAD_COUNT(s, pad) (((s) - 1) / (pad) + 1)
ae1768a7
EE
1059#define PAD_SIZE(s, pad) (PAD_COUNT(s, pad) * pad)
1060#define ALLOC_ALIGN_BUFFER_PAD(type, name, size, align, pad) \
e8232fea 1061 char __##name[ROUND(PAD_SIZE((size) * sizeof(type), pad), align) \
ae1768a7 1062 + (align - 1)]; \
de4d1135
MV
1063 \
1064 type *name = (type *) ALIGN((uintptr_t)__##name, align)
ae1768a7
EE
1065#define ALLOC_ALIGN_BUFFER(type, name, size, align) \
1066 ALLOC_ALIGN_BUFFER_PAD(type, name, size, align, 1)
1067#define ALLOC_CACHE_ALIGN_BUFFER_PAD(type, name, size, pad) \
1068 ALLOC_ALIGN_BUFFER_PAD(type, name, size, ARCH_DMA_MINALIGN, pad)
46a6d51c 1069#define ALLOC_CACHE_ALIGN_BUFFER(type, name, size) \
de4d1135
MV
1070 ALLOC_ALIGN_BUFFER(type, name, size, ARCH_DMA_MINALIGN)
1071
1072/*
1073 * DEFINE_CACHE_ALIGN_BUFFER() is similar to ALLOC_CACHE_ALIGN_BUFFER, but it's
1074 * purpose is to allow allocating aligned buffers outside of function scope.
1075 * Usage of this macro shall be avoided or used with extreme care!
1076 */
1077#define DEFINE_ALIGN_BUFFER(type, name, size, align) \
1078 static char __##name[roundup(size * sizeof(type), align)] \
d7ea4d4d 1079 __aligned(align); \
46a6d51c 1080 \
de4d1135
MV
1081 static type *name = (type *)__##name
1082#define DEFINE_CACHE_ALIGN_BUFFER(type, name, size) \
1083 DEFINE_ALIGN_BUFFER(type, name, size, ARCH_DMA_MINALIGN)
46a6d51c 1084
c3eb3fe4
MF
1085/* Pull in stuff for the build system */
1086#ifdef DO_DEPS_ONLY
1087# include <environment.h>
1088#endif
1089
e2211743 1090#endif /* __COMMON_H_ */