blob: c48e5bc11bf5b7ffe1d6f4314a17aa431b247b9a [file] [log] [blame]
wdenke2211742002-11-02 23:30:20 +00001/*
Wolfgang Denk3b74e7e2009-05-16 10:47:45 +02002 * (C) Copyright 2000-2009
wdenke2211742002-11-02 23:30:20 +00003 * Wolfgang Denk, DENX Software Engineering, wd@denx.de.
4 *
Wolfgang Denk3765b3e2013-10-07 13:07:26 +02005 * SPDX-License-Identifier: GPL-2.0+
wdenke2211742002-11-02 23:30:20 +00006 */
7
8#ifndef __COMMON_H_
Wolfgang Denkd0b8fee2012-01-06 07:36:44 +01009#define __COMMON_H_ 1
wdenke2211742002-11-02 23:30:20 +000010
Wolfgang Denkfcd3c872009-07-24 00:17:48 +020011#ifndef __ASSEMBLY__ /* put C only stuff in this section */
12
wdenke2211742002-11-02 23:30:20 +000013typedef unsigned char uchar;
14typedef volatile unsigned long vu_long;
wdenk180d3f72004-01-04 16:28:35 +000015typedef volatile unsigned short vu_short;
wdenke2211742002-11-02 23:30:20 +000016typedef volatile unsigned char vu_char;
17
18#include <config.h>
Wolfgang Denk25ddd1f2010-10-26 14:34:52 +020019#include <asm-offsets.h>
wdenke2211742002-11-02 23:30:20 +000020#include <linux/bitops.h>
21#include <linux/types.h>
22#include <linux/string.h>
Marek Vasut9aed5082012-09-27 17:08:15 +020023#include <linux/stringify.h>
wdenke2211742002-11-02 23:30:20 +000024#include <asm/ptrace.h>
25#include <stdarg.h>
Masahiro Yamadacba1da42014-11-07 03:03:28 +090026#include <linux/kernel.h>
Stefan Roesea821d082012-09-19 15:18:52 +020027#if defined(CONFIG_PCI) && defined(CONFIG_4xx)
wdenke2211742002-11-02 23:30:20 +000028#include <pci.h>
29#endif
wdenk180d3f72004-01-04 16:28:35 +000030#if defined(CONFIG_8xx)
wdenke2211742002-11-02 23:30:20 +000031#include <asm/8xx_immap.h>
Masahiro Yamada03f9d7d2014-06-20 13:54:55 +090032#if defined(CONFIG_MPC859) || defined(CONFIG_MPC859T) || \
33 defined(CONFIG_MPC866) || \
wdenkd4ca31c2004-01-02 14:00:00 +000034 defined(CONFIG_MPC866P)
Wolfgang Denkd0b8fee2012-01-06 07:36:44 +010035# define CONFIG_MPC866_FAMILY 1
Masahiro Yamada0ace4d92014-08-06 12:59:51 +090036#elif defined(CONFIG_MPC885)
Wolfgang Denkd0b8fee2012-01-06 07:36:44 +010037# define CONFIG_MPC885_FAMILY 1
wdenk180d3f72004-01-04 16:28:35 +000038#endif
39#if defined(CONFIG_MPC860) \
40 || defined(CONFIG_MPC860T) \
wdenk11142572004-06-06 21:35:06 +000041 || defined(CONFIG_MPC866_FAMILY) \
42 || defined(CONFIG_MPC885_FAMILY)
Wolfgang Denkd0b8fee2012-01-06 07:36:44 +010043# define CONFIG_MPC86x 1
wdenk2535d602003-07-17 23:16:40 +000044#endif
wdenk0db5bca2003-03-31 17:27:09 +000045#elif defined(CONFIG_5xx)
46#include <asm/5xx_immap.h>
wdenk7e6bf352004-12-12 22:06:17 +000047#elif defined(CONFIG_MPC5xxx)
48#include <mpc5xxx.h>
Rafal Jaworowski8993e542007-07-27 14:43:59 +020049#elif defined(CONFIG_MPC512X)
Rafal Jaworowski8993e542007-07-27 14:43:59 +020050#include <asm/immap_512x.h>
Masahiro Yamada58dac322014-03-05 17:40:10 +090051#elif defined(CONFIG_MPC8260)
wdenk04a85b32004-04-15 18:22:41 +000052#if defined(CONFIG_MPC8247) \
wdenk04a85b32004-04-15 18:22:41 +000053 || defined(CONFIG_MPC8272)
Wolfgang Denkd0b8fee2012-01-06 07:36:44 +010054#define CONFIG_MPC8272_FAMILY 1
wdenk04a85b32004-04-15 18:22:41 +000055#endif
wdenke2211742002-11-02 23:30:20 +000056#include <asm/immap_8260.h>
57#endif
Jon Loeligerdebb7352006-04-26 17:58:56 -050058#ifdef CONFIG_MPC86xx
59#include <mpc86xx.h>
60#include <asm/immap_86xx.h>
61#endif
wdenk42d1f032003-10-15 23:53:47 +000062#ifdef CONFIG_MPC85xx
63#include <mpc85xx.h>
64#include <asm/immap_85xx.h>
65#endif
Peter Tyser0f898602009-05-22 17:23:24 -050066#ifdef CONFIG_MPC83xx
Eran Libertyf046ccd2005-07-28 10:08:46 -050067#include <mpc83xx.h>
68#include <asm/immap_83xx.h>
69#endif
wdenke2211742002-11-02 23:30:20 +000070#ifdef CONFIG_4xx
Stefan Roeseb36df562010-09-09 19:18:00 +020071#include <asm/ppc4xx.h>
wdenke2211742002-11-02 23:30:20 +000072#endif
Mike Frysinger6cfcce62008-02-04 19:26:54 -050073#ifdef CONFIG_BLACKFIN
74#include <asm/blackfin.h>
75#endif
Sekhar Nori2819e132009-11-12 11:09:25 -050076#ifdef CONFIG_SOC_DA8XX
77#include <asm/arch/hardware.h>
78#endif
wdenke2211742002-11-02 23:30:20 +000079
80#include <part.h>
81#include <flash.h>
82#include <image.h>
83
Gabe Black4166ecb2014-10-15 04:38:31 -060084/* Bring in printf format macros if inttypes.h is included */
85#define __STDC_FORMAT_MACROS
86
York Sun4d1fd7f2014-02-26 17:03:19 -080087#ifdef __LP64__
88#define CONFIG_SYS_SUPPORT_64BIT_DATA
89#endif
90
Simon Glass21726a72011-06-29 09:49:34 +000091#ifdef DEBUG
Marek Vasut88a85fb2011-10-24 23:41:42 +000092#define _DEBUG 1
Simon Glass21726a72011-06-29 09:49:34 +000093#else
Marek Vasut88a85fb2011-10-24 23:41:42 +000094#define _DEBUG 0
Simon Glass21726a72011-06-29 09:49:34 +000095#endif
96
Thierry Redingbe25d872014-11-12 18:26:50 -070097#ifndef pr_fmt
98#define pr_fmt(fmt) fmt
99#endif
100
Simon Glass21726a72011-06-29 09:49:34 +0000101/*
Marek Vasut88a85fb2011-10-24 23:41:42 +0000102 * Output a debug text when condition "cond" is met. The "cond" should be
103 * computed by a preprocessor in the best case, allowing for the best
104 * optimization.
105 */
Thierry Redingbe25d872014-11-12 18:26:50 -0700106#define debug_cond(cond, fmt, args...) \
107 do { \
108 if (cond) \
109 printf(pr_fmt(fmt), ##args); \
Marek Vasut88a85fb2011-10-24 23:41:42 +0000110 } while (0)
111
112#define debug(fmt, args...) \
113 debug_cond(_DEBUG, fmt, ##args)
114
115/*
Simon Glass21726a72011-06-29 09:49:34 +0000116 * An assertion is run-time check done in debug mode only. If DEBUG is not
117 * defined then it is skipped. If DEBUG is defined and the assertion fails,
118 * then it calls panic*( which may or may not reset/halt U-Boot (see
119 * CONFIG_PANIC_HANG), It is hoped that all failing assertions are found
120 * before release, and after release it is hoped that they don't matter. But
121 * in any case these failing assertions cannot be fixed with a reset (which
122 * may just do the same assertion again).
123 */
124void __assert_fail(const char *assertion, const char *file, unsigned line,
125 const char *function);
126#define assert(x) \
127 ({ if (!(x) && _DEBUG) \
128 __assert_fail(#x, __FILE__, __LINE__, __func__); })
129
Matthias Kaehlcke594d57d2010-01-31 17:39:49 +0100130#define error(fmt, args...) do { \
Thierry Redingbe25d872014-11-12 18:26:50 -0700131 printf("ERROR: " pr_fmt(fmt) "\nat %s:%d/%s()\n", \
Matthias Kaehlcke594d57d2010-01-31 17:39:49 +0100132 ##args, __FILE__, __LINE__, __func__); \
133} while (0)
134
William Juulcfa460a2007-10-31 13:53:06 +0100135#ifndef BUG
Detlev Zundel43835aa2006-09-01 11:59:23 +0200136#define BUG() do { \
Wolfgang Denk511d0c72006-10-09 00:42:01 +0200137 printf("BUG: failure at %s:%d/%s()!\n", __FILE__, __LINE__, __FUNCTION__); \
Detlev Zundel43835aa2006-09-01 11:59:23 +0200138 panic("BUG!"); \
139} while (0)
140#define BUG_ON(condition) do { if (unlikely((condition)!=0)) BUG(); } while(0)
William Juulcfa460a2007-10-31 13:53:06 +0100141#endif /* BUG */
Detlev Zundel43835aa2006-09-01 11:59:23 +0200142
Heiko Schocherc00e17c2011-06-08 23:07:05 +0000143/* Force a compilation error if condition is true */
144#define BUILD_BUG_ON(condition) ((void)sizeof(char[1 - 2*!!(condition)]))
145
wdenkc83bf6a2004-01-06 22:38:14 +0000146typedef void (interrupt_handler_t)(void *);
wdenke2211742002-11-02 23:30:20 +0000147
wdenkc83bf6a2004-01-06 22:38:14 +0000148#include <asm/u-boot.h> /* boot information for Linux kernel */
wdenke2211742002-11-02 23:30:20 +0000149#include <asm/global_data.h> /* global data used for startup functions */
150
wdenk71f95112003-06-15 22:40:42 +0000151/*
152 * enable common handling for all TQM8xxL/M boards:
Martin Krause11d9eec2007-09-26 17:55:56 +0200153 * - CONFIG_TQM8xxM will be defined for all TQM8xxM boards
wdenk71f95112003-06-15 22:40:42 +0000154 * - CONFIG_TQM8xxL will be defined for all TQM8xxL _and_ TQM8xxM boards
Martin Krause11d9eec2007-09-26 17:55:56 +0200155 * and for the TQM885D board
wdenk71f95112003-06-15 22:40:42 +0000156 */
157#if defined(CONFIG_TQM823M) || defined(CONFIG_TQM850M) || \
158 defined(CONFIG_TQM855M) || defined(CONFIG_TQM860M) || \
Martin Krause11d9eec2007-09-26 17:55:56 +0200159 defined(CONFIG_TQM862M) || defined(CONFIG_TQM866M)
wdenk71f95112003-06-15 22:40:42 +0000160# ifndef CONFIG_TQM8xxM
161# define CONFIG_TQM8xxM
162# endif
163#endif
wdenke2211742002-11-02 23:30:20 +0000164#if defined(CONFIG_TQM823L) || defined(CONFIG_TQM850L) || \
wdenkd126bfb2003-04-10 11:18:18 +0000165 defined(CONFIG_TQM855L) || defined(CONFIG_TQM860L) || \
Martin Krause11d9eec2007-09-26 17:55:56 +0200166 defined(CONFIG_TQM862L) || defined(CONFIG_TQM8xxM) || \
167 defined(CONFIG_TQM885D)
wdenke2211742002-11-02 23:30:20 +0000168# ifndef CONFIG_TQM8xxL
169# define CONFIG_TQM8xxL
170# endif
171#endif
172
Heiko Schocher3fbeeea2010-09-17 13:10:34 +0200173#if defined(CONFIG_ENV_IS_EMBEDDED)
174#define TOTAL_MALLOC_LEN CONFIG_SYS_MALLOC_LEN
175#elif ( ((CONFIG_ENV_ADDR+CONFIG_ENV_SIZE) < CONFIG_SYS_MONITOR_BASE) || \
176 (CONFIG_ENV_ADDR >= (CONFIG_SYS_MONITOR_BASE + CONFIG_SYS_MONITOR_LEN)) ) || \
177 defined(CONFIG_ENV_IS_IN_NVRAM)
178#define TOTAL_MALLOC_LEN (CONFIG_SYS_MALLOC_LEN + CONFIG_ENV_SIZE)
179#else
180#define TOTAL_MALLOC_LEN CONFIG_SYS_MALLOC_LEN
181#endif
wdenkc7de8292002-11-19 11:04:11 +0000182
183/*
wdenke2211742002-11-02 23:30:20 +0000184 * Function Prototypes
185 */
Michal Simek0267ba52015-01-30 10:51:46 +0100186int dram_init(void);
wdenke2211742002-11-02 23:30:20 +0000187
wdenkc83bf6a2004-01-06 22:38:14 +0000188void hang (void) __attribute__ ((noreturn));
wdenke2211742002-11-02 23:30:20 +0000189
Wolfgang Denkf6c019c2011-07-30 12:32:45 +0000190int timer_init(void);
191int cpu_init(void);
192
wdenke2211742002-11-02 23:30:20 +0000193/* */
Becky Bruce9973e3c2008-06-09 16:03:40 -0500194phys_size_t initdram (int);
Simon Glassc6da9ae2014-10-15 04:38:35 -0600195
Simon Glass2ea09c82015-04-28 20:25:07 -0600196#include <display_options.h>
wdenke2211742002-11-02 23:30:20 +0000197
198/* common/main.c */
199void main_loop (void);
Simon Glass009dde12012-02-14 19:59:20 +0000200int run_command(const char *cmd, int flag);
Thomas Betker1d43bfd2014-06-05 20:07:57 +0200201int run_command_repeatable(const char *cmd, int flag);
Simon Glassd51004a2012-03-30 21:30:55 +0000202
203/**
204 * Run a list of commands separated by ; or even \0
205 *
206 * Note that if 'len' is not -1, then the command does not need to be nul
207 * terminated, Memory will be allocated for the command in that case.
208 *
209 * @param cmd List of commands to run, each separated bu semicolon
210 * @param len Length of commands excluding terminator if known (-1 if not)
211 * @param flag Execution flags (CMD_FLAG_...)
212 * @return 0 on success, or != 0 on error.
213 */
214int run_command_list(const char *cmd, int len, int flag);
Igor Grinberge3150462011-11-07 01:13:56 +0000215extern char console_buffer[];
wdenke2211742002-11-02 23:30:20 +0000216
Peter Tyserea0364f2010-04-12 22:28:04 -0500217/* arch/$(ARCH)/lib/board.c */
Masahiro Yamada0365ffc2015-01-14 17:07:05 +0900218void board_init_f(ulong);
219void board_init_r(gd_t *, ulong) __attribute__ ((noreturn));
Simon Glass1fed87d2015-08-10 20:44:30 -0600220
221/**
222 * board_init_f_mem() - Allocate global data and set stack position
223 *
224 * This function is called by each architecture very early in the start-up
225 * code to set up the environment for board_init_f(). It allocates space for
226 * global_data (see include/asm-generic/global_data.h) and places the stack
227 * below this.
228 *
229 * This function requires a stack[1] Normally this is at @top. The function
230 * starts allocating space from 64 bytes below @top. First it creates space
231 * for global_data. Then it calls arch_setup_gd() which sets gd to point to
232 * the global_data space and can reserve additional bytes of space if
233 * required). Finally it allocates early malloc() memory
234 * (CONFIG_SYS_MALLOC_F_LEN). The new top of the stack is just below this,
235 * and it returned by this function.
236 *
237 * [1] Strictly speaking it would be possible to implement this function
238 * in C on many archs such that it does not require a stack. However this
239 * does not seem hugely important as only 64 byte are wasted. The 64 bytes
240 * are used to handle the calling standard which generally requires pushing
241 * addresses or registers onto the stack. We should be able to get away with
242 * less if this becomes important.
243 *
244 * @top: Top of available memory, also normally the top of the stack
245 * @return: New stack location
246 */
247ulong board_init_f_mem(ulong top);
248
249/**
250 * arch_setup_gd() - Set up the global_data pointer
251 *
252 * This pointer is special in some architectures and cannot easily be assigned
253 * to. For example on x86 it is implemented by adding a specific record to its
254 * Global Descriptor Table! So we we provide a function to carry out this task.
255 * For most architectures this can simply be:
256 *
257 * gd = gd_ptr;
258 *
259 * @gd_ptr: Pointer to global data
260 */
261void arch_setup_gd(gd_t *gd_ptr);
262
Masahiro Yamada0365ffc2015-01-14 17:07:05 +0900263int checkboard(void);
264int show_board_info(void);
265int checkflash(void);
266int checkdram(void);
267int last_stage_init(void);
wdenk3b57fe02003-05-30 12:48:29 +0000268extern ulong monitor_flash_len;
Haiying Wangbea3f282006-07-12 10:48:05 -0400269int mac_read_from_eeprom(void);
Masahiro Yamada6ab6b2a2014-02-05 11:28:25 +0900270extern u8 __dtb_dt_begin[]; /* embedded device tree blob */
Hadli, Manjunath8f5d4682012-02-06 00:30:44 +0000271int set_cpu_clk_info(void);
Simon Glass9272a9b2014-04-10 20:01:32 -0600272int mdm_init(void);
Masahiro Yamada365475e2014-02-13 18:30:26 +0900273#if defined(CONFIG_DISPLAY_CPUINFO)
Simon Glass1938f4a2013-03-11 06:49:53 +0000274int print_cpuinfo(void);
Masahiro Yamada365475e2014-02-13 18:30:26 +0900275#else
276static inline int print_cpuinfo(void)
277{
278 return 0;
279}
280#endif
Simon Glassc2240d42013-03-14 07:20:12 +0000281int update_flash_size(int flash_size);
Simon Glass2c072c92014-02-27 13:26:25 -0700282int arch_early_init_r(void);
wdenke2211742002-11-02 23:30:20 +0000283
Simon Glass15a33e42012-11-30 13:01:20 +0000284/**
Simon Glassd4c671c2015-03-05 12:25:16 -0700285 * arch_cpu_init_dm() - init CPU after driver model is available
286 *
287 * This is called immediately after driver model is available before
288 * relocation. This is similar to arch_cpu_init() but is able to reference
289 * devices
290 *
291 * @return 0 if OK, -ve on error
292 */
293int arch_cpu_init_dm(void);
294
295/**
Andreas Bießmann68145d42015-02-06 23:06:45 +0100296 * Reserve all necessary stacks
297 *
298 * This is used in generic board init sequence in common/board_f.c. Each
299 * architecture could provide this function to tailor the required stacks.
300 *
301 * On entry gd->start_addr_sp is pointing to the suggested top of the stack.
302 * The callee ensures gd->start_add_sp is 16-byte aligned, so architectures
303 * require only this can leave it untouched.
304 *
305 * On exit gd->start_addr_sp and gd->irq_sp should be set to the respective
306 * positions of the stack. The stack pointer(s) will be set to this later.
307 * gd->irq_sp is only required, if the architecture needs it.
308 *
309 * @return 0 if no error
310 */
311__weak int arch_reserve_stacks(void);
312
313/**
Simon Glass15a33e42012-11-30 13:01:20 +0000314 * Show the DRAM size in a board-specific way
315 *
316 * This is used by boards to display DRAM information in their own way.
317 *
318 * @param size Size of DRAM (which should be displayed along with other info)
319 */
Andrew Bradfordea11b402015-05-22 08:30:14 -0400320void board_show_dram(phys_size_t size);
Simon Glass15a33e42012-11-30 13:01:20 +0000321
Simon Glass13d06982013-05-08 08:06:01 +0000322/**
Ma Haijune29607e2014-07-12 14:24:06 +0100323 * arch_fixup_fdt() - Write arch-specific information to fdt
Simon Glass13d06982013-05-08 08:06:01 +0000324 *
Ma Haijune29607e2014-07-12 14:24:06 +0100325 * Defined in arch/$(ARCH)/lib/bootm-fdt.c
Simon Glass13d06982013-05-08 08:06:01 +0000326 *
327 * @blob: FDT blob to write to
328 * @return 0 if ok, or -ve FDT_ERR_... on failure
329 */
Ma Haijune29607e2014-07-12 14:24:06 +0100330int arch_fixup_fdt(void *blob);
Simon Glass13d06982013-05-08 08:06:01 +0000331
wdenke2211742002-11-02 23:30:20 +0000332/* common/flash.c */
333void flash_perror (int);
334
Wolfgang Denk74de7ae2009-04-01 23:34:12 +0200335/* common/cmd_source.c */
336int source (ulong addr, const char *fit_uname);
wdenke2211742002-11-02 23:30:20 +0000337
wdenkc83bf6a2004-01-06 22:38:14 +0000338extern ulong load_addr; /* Default Load Address */
Simon Glass1aec2442011-10-21 18:51:38 +0000339extern ulong save_addr; /* Default Save Address */
340extern ulong save_size; /* Default Save Size */
wdenke2211742002-11-02 23:30:20 +0000341
Wolfgang Denk4394f9a2008-09-08 22:37:45 +0200342/* common/cmd_doc.c */
343void doc_probe(unsigned long physadr);
344
Jason Hobbs06283a62011-08-31 10:37:30 -0500345/* common/cmd_net.c */
346int do_tftpb(cmd_tbl_t *cmdtp, int flag, int argc, char * const argv[]);
347
Rob Herring669df7e2012-05-25 10:47:39 +0000348/* common/cmd_fat.c */
349int do_fat_fsload(cmd_tbl_t *, int, int, char * const []);
350
351/* common/cmd_ext2.c */
352int do_ext2load(cmd_tbl_t *, int, int, char * const []);
353
wdenke2211742002-11-02 23:30:20 +0000354/* common/cmd_nvedit.c */
355int env_init (void);
356void env_relocate (void);
Rafal Jaworowski26a41792008-01-09 18:05:27 +0100357int envmatch (uchar *, int);
Simon Glass20f86a02014-02-27 13:26:21 -0700358
359/* Avoid unfortunate conflict with libc's getenv() */
360#ifdef CONFIG_SANDBOX
361#define getenv uboot_getenv
362#endif
Wolfgang Denk84b5e802011-07-29 14:42:18 +0200363char *getenv (const char *);
364int getenv_f (const char *name, char *buf, unsigned len);
Simon Glass4a9b4132011-10-14 13:25:18 +0000365ulong getenv_ulong(const char *name, int base, ulong default_val);
Simon Glass76b8f792013-04-20 08:42:43 +0000366
367/**
368 * getenv_hex() - Return an environment variable as a hex value
369 *
370 * Decode an environment as a hex number (it may or may not have a 0x
371 * prefix). If the environment variable cannot be found, or does not start
372 * with hex digits, the default value is returned.
373 *
374 * @varname: Variable to decode
375 * @default_val: Value to return on error
376 */
377ulong getenv_hex(const char *varname, ulong default_val);
378
Joe Hershbergerec8a2522012-12-11 22:16:22 -0600379/*
380 * Read an environment variable as a boolean
381 * Return -1 if variable does not exist (default to true)
382 */
383int getenv_yesno(const char *var);
wdenkc83bf6a2004-01-06 22:38:14 +0000384int saveenv (void);
Wolfgang Denk84b5e802011-07-29 14:42:18 +0200385int setenv (const char *, const char *);
Simon Glassd67f10c2011-10-24 17:59:59 +0000386int setenv_ulong(const char *varname, ulong value);
Simon Glassbfc59962013-02-24 17:33:21 +0000387int setenv_hex(const char *varname, ulong value);
388/**
389 * setenv_addr - Set an environment variable to an address in hex
390 *
Robert P. J. Day1bce2ae2013-09-16 07:15:45 -0400391 * @varname: Environment variable to set
Simon Glassbfc59962013-02-24 17:33:21 +0000392 * @addr: Value to set it to
393 * @return 0 if ok, 1 on error
394 */
395static inline int setenv_addr(const char *varname, const void *addr)
396{
397 return setenv_hex(varname, (ulong)addr);
398}
399
wdenke2211742002-11-02 23:30:20 +0000400#ifdef CONFIG_ARM
wdenk96085e32004-12-13 09:49:01 +0000401# include <asm/mach-types.h>
wdenkb6e4c402004-01-02 16:05:07 +0000402# include <asm/setup.h>
wdenke2211742002-11-02 23:30:20 +0000403# include <asm/u-boot-arm.h> /* ARM version to be fixed! */
404#endif /* CONFIG_ARM */
Graeme Russfea25722011-04-13 19:43:28 +1000405#ifdef CONFIG_X86 /* x86 version to be fixed! */
406# include <asm/u-boot-x86.h>
407#endif /* CONFIG_X86 */
Simon Glass744d9852011-10-10 08:22:14 +0000408#ifdef CONFIG_SANDBOX
409# include <asm/u-boot-sandbox.h> /* TODO(sjg) what needs to be fixed? */
410#endif
Macpaul Line7083842011-10-19 20:41:04 +0000411#ifdef CONFIG_NDS32
412# include <asm/mach-types.h>
ken kuoe3c58b02013-06-08 11:14:12 +0800413# include <asm/setup.h>
Macpaul Line7083842011-10-19 20:41:04 +0000414# include <asm/u-boot-nds32.h>
415#endif /* CONFIG_NDS32 */
Daniel Schwierzecke034ea32012-06-03 23:46:04 +0200416#ifdef CONFIG_MIPS
417# include <asm/u-boot-mips.h>
418#endif /* CONFIG_MIPS */
Alexey Brodkinbc5d5422014-02-04 12:56:16 +0400419#ifdef CONFIG_ARC
420# include <asm/u-boot-arc.h>
421#endif /* CONFIG_ARC */
wdenke2211742002-11-02 23:30:20 +0000422
wdenk04a85b32004-04-15 18:22:41 +0000423#ifdef CONFIG_AUTO_COMPLETE
424int env_complete(char *var, int maxv, char *cmdv[], int maxsz, char *buf);
425#endif
Heiko Schocher2f70c492009-02-10 09:38:52 +0100426int get_env_id (void);
wdenk04a85b32004-04-15 18:22:41 +0000427
wdenkc83bf6a2004-01-06 22:38:14 +0000428void pci_init (void);
429void pci_init_board(void);
430void pciinfo (int, int);
wdenke2211742002-11-02 23:30:20 +0000431
Stefan Roesea821d082012-09-19 15:18:52 +0200432#if defined(CONFIG_PCI) && defined(CONFIG_4xx)
Matthias Fuchsc71103f2009-07-08 13:43:23 +0200433 int pci_pre_init (struct pci_controller *);
434 int is_pci_host (struct pci_controller *);
Stefan Roese466fff12007-06-25 15:57:39 +0200435#endif
436
Stefan Roesedbbd1252007-10-05 17:10:59 +0200437#if defined(CONFIG_PCI) && (defined(CONFIG_440) || defined(CONFIG_405EX))
Jean-Christophe PLAGNIOL-VILLARD6d0f6bc2008-10-16 15:01:15 +0200438# if defined(CONFIG_SYS_PCI_TARGET_INIT)
wdenkc83bf6a2004-01-06 22:38:14 +0000439 void pci_target_init (struct pci_controller *);
wdenke2211742002-11-02 23:30:20 +0000440# endif
Jean-Christophe PLAGNIOL-VILLARD6d0f6bc2008-10-16 15:01:15 +0200441# if defined(CONFIG_SYS_PCI_MASTER_INIT)
wdenkc83bf6a2004-01-06 22:38:14 +0000442 void pci_master_init (struct pci_controller *);
wdenke2211742002-11-02 23:30:20 +0000443# endif
Stefan Roese6f2eb3f2008-03-11 15:11:18 +0100444#if defined(CONFIG_440SPE) || \
445 defined(CONFIG_460EX) || defined(CONFIG_460GT) || \
446 defined(CONFIG_405EX)
Grzegorz Bernacki7f191392007-09-07 18:20:23 +0200447 void pcie_setup_hoses(int busno);
Rafal Jaworowski692519b2006-08-10 12:43:17 +0200448#endif
wdenke2211742002-11-02 23:30:20 +0000449#endif
450
451int misc_init_f (void);
452int misc_init_r (void);
453
wdenk27b207f2003-07-24 23:38:38 +0000454/* common/exports.c */
455void jumptable_init(void);
456
Mike Frysingerecb1dc82009-05-20 04:35:14 -0400457/* common/kallsysm.c */
458const char *symbol_lookup(unsigned long addr, unsigned long *caddr);
459
Rafal Jaworowski500856e2008-01-09 19:39:36 +0100460/* api/api.c */
461void api_init (void);
462
wdenkc83bf6a2004-01-06 22:38:14 +0000463/* common/memsize.c */
Albert ARIBAUDa55d23c2011-07-03 05:55:33 +0000464long get_ram_size (long *, long);
York Sune3866162014-02-11 11:57:26 -0800465phys_size_t get_effective_memsize(void);
wdenkc83bf6a2004-01-06 22:38:14 +0000466
wdenke2211742002-11-02 23:30:20 +0000467/* $(BOARD)/$(BOARD).c */
468void reset_phy (void);
wdenkc83bf6a2004-01-06 22:38:14 +0000469void fdc_hw_init (void);
wdenke2211742002-11-02 23:30:20 +0000470
471/* $(BOARD)/eeprom.c */
472void eeprom_init (void);
wdenk6dd652f2003-06-19 23:40:20 +0000473#ifndef CONFIG_SPI
474int eeprom_probe (unsigned dev_addr, unsigned offset);
475#endif
wdenke2211742002-11-02 23:30:20 +0000476int eeprom_read (unsigned dev_addr, unsigned offset, uchar *buffer, unsigned cnt);
477int eeprom_write (unsigned dev_addr, unsigned offset, uchar *buffer, unsigned cnt);
wdenke2211742002-11-02 23:30:20 +0000478
479/*
480 * Set this up regardless of board
481 * type, to prevent errors.
482 */
Jean-Christophe PLAGNIOL-VILLARD6d0f6bc2008-10-16 15:01:15 +0200483#if defined(CONFIG_SPI) || !defined(CONFIG_SYS_I2C_EEPROM_ADDR)
484# define CONFIG_SYS_DEF_EEPROM_ADDR 0
wdenke2211742002-11-02 23:30:20 +0000485#else
Heiko Schocher548738b2010-01-07 08:55:40 +0100486#if !defined(CONFIG_ENV_EEPROM_IS_ON_I2C)
Jean-Christophe PLAGNIOL-VILLARD6d0f6bc2008-10-16 15:01:15 +0200487# define CONFIG_SYS_DEF_EEPROM_ADDR CONFIG_SYS_I2C_EEPROM_ADDR
Heiko Schocher548738b2010-01-07 08:55:40 +0100488#endif
Jean-Christophe PLAGNIOL-VILLARD6d0f6bc2008-10-16 15:01:15 +0200489#endif /* CONFIG_SPI || !defined(CONFIG_SYS_I2C_EEPROM_ADDR) */
wdenke2211742002-11-02 23:30:20 +0000490
wdenkbdccc4f2003-08-05 17:43:17 +0000491#if defined(CONFIG_SPI)
wdenke2211742002-11-02 23:30:20 +0000492extern void spi_init_f (void);
493extern void spi_init_r (void);
wdenkc83bf6a2004-01-06 22:38:14 +0000494extern ssize_t spi_read (uchar *, int, uchar *, int);
wdenke2211742002-11-02 23:30:20 +0000495extern ssize_t spi_write (uchar *, int, uchar *, int);
496#endif
497
wdenke2211742002-11-02 23:30:20 +0000498/* $(BOARD)/$(BOARD).c */
wdenkc837dcb2004-01-20 23:12:12 +0000499int board_early_init_f (void);
500int board_late_init (void);
wdenke2211742002-11-02 23:30:20 +0000501int board_postclk_init (void); /* after clocks/timebase, before env/serial */
wdenkc837dcb2004-01-20 23:12:12 +0000502int board_early_init_r (void);
wdenke2211742002-11-02 23:30:20 +0000503void board_poweroff (void);
504
Jean-Christophe PLAGNIOL-VILLARD6d0f6bc2008-10-16 15:01:15 +0200505#if defined(CONFIG_SYS_DRAM_TEST)
wdenke2211742002-11-02 23:30:20 +0000506int testdram(void);
Jean-Christophe PLAGNIOL-VILLARD6d0f6bc2008-10-16 15:01:15 +0200507#endif /* CONFIG_SYS_DRAM_TEST */
wdenke2211742002-11-02 23:30:20 +0000508
509/* $(CPU)/start.S */
wdenkc83bf6a2004-01-06 22:38:14 +0000510#if defined(CONFIG_5xx) || \
wdenk0db5bca2003-03-31 17:27:09 +0000511 defined(CONFIG_8xx)
wdenke2211742002-11-02 23:30:20 +0000512uint get_immr (uint);
513#endif
wdenk36c72872004-06-09 17:45:32 +0000514#if defined(CONFIG_MPC5xxx)
515uint get_svr (void);
516#endif
wdenke2211742002-11-02 23:30:20 +0000517uint get_pvr (void);
wdenk547b4cb2004-06-09 00:51:50 +0000518uint get_svr (void);
wdenke2211742002-11-02 23:30:20 +0000519uint rd_ic_cst (void);
520void wr_ic_cst (uint);
521void wr_ic_adr (uint);
522uint rd_dc_cst (void);
523void wr_dc_cst (uint);
524void wr_dc_adr (uint);
525int icache_status (void);
526void icache_enable (void);
527void icache_disable(void);
528int dcache_status (void);
529void dcache_enable (void);
530void dcache_disable(void);
Aneesh V2c451f72011-06-16 23:30:47 +0000531void mmu_disable(void);
Benoît Thébaudeau5c6db122013-04-11 09:35:53 +0000532#if defined(CONFIG_ARM)
533void relocate_code(ulong);
534#else
535void relocate_code(ulong, gd_t *, ulong) __attribute__ ((noreturn));
Benoît Thébaudeau959eaa72013-04-11 09:35:43 +0000536#endif
wdenke2211742002-11-02 23:30:20 +0000537ulong get_endaddr (void);
538void trap_init (ulong);
539#if defined (CONFIG_4xx) || \
wdenkeeb1b772004-03-23 22:53:55 +0000540 defined (CONFIG_MPC5xxx) || \
Marian Balakowiczcd94ba32006-03-14 16:02:31 +0100541 defined (CONFIG_MPC85xx) || \
Jon Loeligerdebb7352006-04-26 17:58:56 -0500542 defined (CONFIG_MPC86xx) || \
Peter Tyser0f898602009-05-22 17:23:24 -0500543 defined (CONFIG_MPC83xx)
wdenkc83bf6a2004-01-06 22:38:14 +0000544unsigned char in8(unsigned int);
545void out8(unsigned int, unsigned char);
546unsigned short in16(unsigned int);
547unsigned short in16r(unsigned int);
548void out16(unsigned int, unsigned short value);
549void out16r(unsigned int, unsigned short value);
550unsigned long in32(unsigned int);
551unsigned long in32r(unsigned int);
552void out32(unsigned int, unsigned long value);
553void out32r(unsigned int, unsigned long value);
554void ppcDcbf(unsigned long value);
555void ppcDcbi(unsigned long value);
556void ppcSync(void);
wdenk0ac6f8b2004-07-09 23:27:13 +0000557void ppcDcbz(unsigned long value);
wdenke2211742002-11-02 23:30:20 +0000558#endif
Michal Simek06436312007-04-21 21:02:40 +0200559#if defined (CONFIG_MICROBLAZE)
560unsigned short in16(unsigned int);
561void out16(unsigned int, unsigned short value);
562#endif
wdenke2211742002-11-02 23:30:20 +0000563
Peter Tyser0f898602009-05-22 17:23:24 -0500564#if defined (CONFIG_MPC83xx)
Dave Liu90f30a72006-11-02 18:05:50 -0600565void ppcDWload(unsigned int *addr, unsigned int *ret);
566void ppcDWstore(unsigned int *addr, unsigned int *value);
Heiko Schocher7c6db912011-03-15 12:30:47 +0100567void disable_addr_trans(void);
568void enable_addr_trans(void);
569#if defined(CONFIG_DDR_ECC) && !defined(CONFIG_ECC_INIT_VIA_DDRCONTROLLER)
570void ddr_enable_ecc(unsigned int dram_size);
571#endif
Dave Liu90f30a72006-11-02 18:05:50 -0600572#endif
573
Rajeshwari Shindefc9ae1b2013-10-08 16:20:03 +0530574/*
575 * Return the current value of a monotonically increasing microsecond timer.
576 * Granularity may be larger than 1us if hardware does not support this.
577 */
578ulong timer_get_us(void);
579
wdenke2211742002-11-02 23:30:20 +0000580/* $(CPU)/cpu.c */
Timur Tabifbb9ecf2011-08-05 16:15:24 -0500581static inline int cpumask_next(int cpu, unsigned int mask)
582{
583 for (cpu++; !((1 << cpu) & mask); cpu++)
584 ;
585
586 return cpu;
587}
588
589#define for_each_cpu(iter, cpu, num_cpus, mask) \
590 for (iter = 0, cpu = cpumask_next(-1, mask); \
591 iter < num_cpus; \
592 iter++, cpu = cpumask_next(cpu, mask)) \
593
Poonam Aggrwal0e870982009-07-31 12:08:14 +0530594int cpu_numcores (void);
Shaveta Leekhab8bf0ad2015-01-19 12:46:54 +0530595int cpu_num_dspcores(void);
Timur Tabifbb9ecf2011-08-05 16:15:24 -0500596u32 cpu_mask (void);
Shaveta Leekhab8bf0ad2015-01-19 12:46:54 +0530597u32 cpu_dsp_mask(void);
Timur Tabifbb9ecf2011-08-05 16:15:24 -0500598int is_core_valid (unsigned int);
Poonam Aggrwal0e870982009-07-31 12:08:14 +0530599int probecpu (void);
wdenke2211742002-11-02 23:30:20 +0000600int checkcpu (void);
601int checkicache (void);
602int checkdcache (void);
603void upmconfig (unsigned int, unsigned int *, unsigned int);
604ulong get_tbclk (void);
Przemyslaw Marczak1fb4dab2014-09-01 13:50:48 +0200605void reset_misc (void);
wdenk3ec924a2005-04-03 17:23:39 +0000606void reset_cpu (ulong addr);
Kim Phillips6a16e0d2007-08-15 22:30:26 -0500607#if defined (CONFIG_OF_LIBFDT) && defined (CONFIG_OF_BOARD_SETUP)
608void ft_cpu_setup(void *blob, bd_t *bd);
609#ifdef CONFIG_PCI
610void ft_pci_setup(void *blob, bd_t *bd);
611#endif
612#endif
613
Andre Przywaraba6a1692013-09-19 18:06:44 +0200614void smp_set_core_boot_addr(unsigned long addr, int corenr);
615void smp_kick_all_cpus(void);
wdenke2211742002-11-02 23:30:20 +0000616
617/* $(CPU)/serial.c */
618int serial_init (void);
619void serial_setbrg (void);
620void serial_putc (const char);
wdenk756f5862005-04-03 15:51:42 +0000621void serial_putc_raw(const char);
wdenke2211742002-11-02 23:30:20 +0000622void serial_puts (const char *);
wdenke2211742002-11-02 23:30:20 +0000623int serial_getc (void);
624int serial_tstc (void);
625
Simon Glass709ea542014-07-23 06:54:59 -0600626/* These versions take a stdio_dev pointer */
627struct stdio_dev;
628int serial_stub_getc(struct stdio_dev *sdev);
629int serial_stub_tstc(struct stdio_dev *sdev);
630
wdenke2211742002-11-02 23:30:20 +0000631/* $(CPU)/speed.c */
632int get_clocks (void);
wdenkc178d3d2004-01-24 20:25:54 +0000633int get_clocks_866 (void);
634int sdram_adjust_866 (void);
wdenke9132ea2004-04-24 23:23:30 +0000635int adjust_sdram_tbs_8xx (void);
Masahiro Yamada58dac322014-03-05 17:40:10 +0900636#if defined(CONFIG_MPC8260)
wdenke2211742002-11-02 23:30:20 +0000637int prt_8260_clks (void);
Eran Libertyf046ccd2005-07-28 10:08:46 -0500638#elif defined(CONFIG_MPC5xxx)
wdenk945af8d2003-07-16 21:53:01 +0000639int prt_mpc5xxx_clks (void);
640#endif
wdenke2211742002-11-02 23:30:20 +0000641#ifdef CONFIG_4xx
642ulong get_OPB_freq (void);
643ulong get_PCI_freq (void);
644#endif
kevin.morfitt@fearnside-systems.co.ukac678042009-11-17 18:30:34 +0900645#if defined(CONFIG_S3C24X0) || \
646 defined(CONFIG_LH7A40X) || \
Matthias Kaehlckefcfb6322010-02-01 21:29:39 +0100647 defined(CONFIG_EP93XX)
wdenke2211742002-11-02 23:30:20 +0000648ulong get_FCLK (void);
649ulong get_HCLK (void);
650ulong get_PCLK (void);
651ulong get_UCLK (void);
652#endif
wdenkf39748a2004-06-09 13:37:52 +0000653#if defined(CONFIG_LH7A40X)
654ulong get_PLLCLK (void);
655#endif
wdenk281e00a2004-08-01 22:48:16 +0000656#if defined(CONFIG_IMX)
657ulong get_systemPLLCLK(void);
658ulong get_FCLK(void);
659ulong get_HCLK(void);
660ulong get_BCLK(void);
661ulong get_PERCLK1(void);
662ulong get_PERCLK2(void);
663ulong get_PERCLK3(void);
664#endif
wdenke2211742002-11-02 23:30:20 +0000665ulong get_bus_freq (ulong);
Stefan Roese550650d2010-09-20 16:05:31 +0200666int get_serial_clock(void);
wdenke2211742002-11-02 23:30:20 +0000667
wdenk42d1f032003-10-15 23:53:47 +0000668#if defined(CONFIG_MPC85xx)
669typedef MPC85xx_SYS_INFO sys_info_t;
wdenkc83bf6a2004-01-06 22:38:14 +0000670void get_sys_info ( sys_info_t * );
Miao Yan871a57b2013-11-28 17:51:38 +0800671# if defined(CONFIG_OF_LIBFDT)
672 void ft_fixup_cpu(void *, u64);
673 void ft_fixup_num_cores(void *);
674# endif
wdenk42d1f032003-10-15 23:53:47 +0000675#endif
Jon Loeligerdebb7352006-04-26 17:58:56 -0500676#if defined(CONFIG_MPC86xx)
677typedef MPC86xx_SYS_INFO sys_info_t;
678void get_sys_info ( sys_info_t * );
Kumar Gala5df4b0a2011-01-31 20:36:02 -0600679static inline ulong get_ddr_freq(ulong dummy)
680{
681 return get_bus_freq(dummy);
682}
York Sun2f78eae2014-06-23 15:15:54 -0700683#else
684ulong get_ddr_freq(ulong);
Jon Loeligerdebb7352006-04-26 17:58:56 -0500685#endif
wdenk42d1f032003-10-15 23:53:47 +0000686
Stefan Roese99bcad12012-09-19 14:33:52 +0200687#if defined(CONFIG_4xx)
wdenke2211742002-11-02 23:30:20 +0000688# if defined(CONFIG_440)
Marian Balakowicz6c5879f2006-06-30 16:30:46 +0200689# if defined(CONFIG_440SPE)
690 unsigned long determine_sysper(void);
691 unsigned long determine_pci_clock_per(void);
692# endif
wdenke2211742002-11-02 23:30:20 +0000693# endif
Stefan Roese087dfdb2007-10-21 08:12:41 +0200694typedef PPC4xx_SYS_INFO sys_info_t;
Stefan Roesef31d38b2007-11-16 14:16:54 +0100695int ppc440spe_revB(void);
wdenkc83bf6a2004-01-06 22:38:14 +0000696void get_sys_info ( sys_info_t * );
wdenke2211742002-11-02 23:30:20 +0000697#endif
698
699/* $(CPU)/cpu_init.c */
Masahiro Yamada58dac322014-03-05 17:40:10 +0900700#if defined(CONFIG_8xx) || defined(CONFIG_MPC8260)
wdenke2211742002-11-02 23:30:20 +0000701void cpu_init_f (volatile immap_t *immr);
702#endif
York Sun701e6402014-04-30 14:43:47 -0700703#if defined(CONFIG_4xx) || defined(CONFIG_MCF52x2) || defined(CONFIG_MPC86xx)
wdenke2211742002-11-02 23:30:20 +0000704void cpu_init_f (void);
705#endif
York Sun701e6402014-04-30 14:43:47 -0700706#ifdef CONFIG_MPC85xx
707ulong cpu_init_f(void);
708#endif
wdenkbf9e3b32004-02-12 00:47:09 +0000709
wdenke2211742002-11-02 23:30:20 +0000710int cpu_init_r (void);
Masahiro Yamada58dac322014-03-05 17:40:10 +0900711#if defined(CONFIG_MPC8260)
wdenke2211742002-11-02 23:30:20 +0000712int prt_8260_rsr (void);
Peter Tyser0f898602009-05-22 17:23:24 -0500713#elif defined(CONFIG_MPC83xx)
Dave Liu9be39a62007-06-25 10:41:56 +0800714int prt_83xx_rsr (void);
wdenke2211742002-11-02 23:30:20 +0000715#endif
716
717/* $(CPU)/interrupts.c */
wdenkc83bf6a2004-01-06 22:38:14 +0000718int interrupt_init (void);
719void timer_interrupt (struct pt_regs *);
wdenke2211742002-11-02 23:30:20 +0000720void external_interrupt (struct pt_regs *);
721void irq_install_handler(int, interrupt_handler_t *, void *);
722void irq_free_handler (int);
723void reset_timer (void);
724ulong get_timer (ulong base);
Simon Glassb2e16a82013-06-11 11:14:39 -0700725
726/* Return value of monotonic microsecond timer */
727unsigned long timer_get_us(void);
728
wdenke2211742002-11-02 23:30:20 +0000729void enable_interrupts (void);
730int disable_interrupts (void);
731
732/* $(CPU)/.../commproc.c */
733int dpram_init (void);
734uint dpram_base(void);
735uint dpram_base_align(uint align);
736uint dpram_alloc(uint size);
737uint dpram_alloc_align(uint size,uint align);
wdenkbdccc4f2003-08-05 17:43:17 +0000738void bootcount_store (ulong);
739ulong bootcount_load (void);
740#define BOOTCOUNT_MAGIC 0xB001C041
wdenke2211742002-11-02 23:30:20 +0000741
742/* $(CPU)/.../<eth> */
Wolfgang Denkc5bded32007-08-29 14:05:30 +0200743void mii_init (void);
wdenke2211742002-11-02 23:30:20 +0000744
745/* $(CPU)/.../lcd.c */
746ulong lcd_setmem (ulong);
747
wdenke2211742002-11-02 23:30:20 +0000748/* $(CPU)/.../video.c */
749ulong video_setmem (ulong);
750
Peter Tyserea0364f2010-04-12 22:28:04 -0500751/* arch/$(ARCH)/lib/cache.c */
Aneesh Vcba4b182011-08-16 04:33:05 +0000752void enable_caches(void);
wdenke2211742002-11-02 23:30:20 +0000753void flush_cache (unsigned long, unsigned long);
Aneesh V2c451f72011-06-16 23:30:47 +0000754void flush_dcache_all(void);
Stefan Roese03d3bfb2009-01-21 17:20:20 +0100755void flush_dcache_range(unsigned long start, unsigned long stop);
756void invalidate_dcache_range(unsigned long start, unsigned long stop);
Aneesh V2c451f72011-06-16 23:30:47 +0000757void invalidate_dcache_all(void);
758void invalidate_icache_all(void);
wdenk0db5bca2003-03-31 17:27:09 +0000759
Simon Glass4d24a112015-05-13 07:02:25 -0600760enum {
761 /* Disable caches (else flush caches but leave them active) */
762 CBL_DISABLE_CACHES = 1 << 0,
763 CBL_SHOW_BOOTSTAGE_REPORT = 1 << 1,
764
765 CBL_ALL = 3,
766};
767
768/**
769 * Clean up ready for linux
770 *
771 * @param flags Flags to control what is done
772 */
773int cleanup_before_linux_select(int flags);
774
Peter Tyserea0364f2010-04-12 22:28:04 -0500775/* arch/$(ARCH)/lib/ticks.S */
Simon Glass19ea4672014-10-15 04:38:33 -0600776uint64_t get_ticks(void);
wdenke2211742002-11-02 23:30:20 +0000777void wait_ticks (unsigned long);
778
Peter Tyserea0364f2010-04-12 22:28:04 -0500779/* arch/$(ARCH)/lib/time.c */
Ingo van Lil3eb90ba2009-11-24 14:09:21 +0100780void __udelay (unsigned long);
wdenke2211742002-11-02 23:30:20 +0000781ulong usec2ticks (unsigned long usec);
782ulong ticks2usec (unsigned long ticks);
783int init_timebase (void);
784
Peter Tyser78acc472010-04-12 22:28:05 -0500785/* lib/gunzip.c */
Wolfgang Wegner87d93a12009-12-09 15:16:47 +0100786int gunzip(void *, int, unsigned char *, unsigned long *);
787int zunzip(void *dst, int dstlen, unsigned char *src, unsigned long *lenp,
788 int stoponerr, int offset);
789
Eric Nelson918e9eb2015-02-17 11:30:30 -0700790/**
791 * gzwrite progress indicators: defined weak to allow board-specific
792 * overrides:
793 *
794 * gzwrite_progress_init called on startup
795 * gzwrite_progress called during decompress/write loop
796 * gzwrite_progress_finish called at end of loop to
797 * indicate success (retcode=0) or failure
798 */
799void gzwrite_progress_init(u64 expected_size);
800
801void gzwrite_progress(int iteration,
802 u64 bytes_written,
803 u64 total_bytes);
804
805void gzwrite_progress_finish(int retcode,
806 u64 totalwritten,
807 u64 totalsize,
808 u32 expected_crc,
809 u32 calculated_crc);
810
811/**
812 * decompress and write gzipped image from memory to block device
813 *
814 * @param src compressed image address
815 * @param len compressed image length in bytes
816 * @param dev block device descriptor
817 * @param szwritebuf bytes per write (pad to erase size)
818 * @param startoffs offset in bytes of first write
819 * @param szexpected expected uncompressed length
820 * may be zero to use gzip trailer
821 * for files under 4GiB
822 */
823int gzwrite(unsigned char *src, int len,
824 struct block_dev_desc *dev,
825 unsigned long szwritebuf,
826 u64 startoffs,
827 u64 szexpected);
828
Wolfgang Denk54c69772010-06-13 01:45:10 +0200829/* lib/qsort.c */
830void qsort(void *base, size_t nmemb, size_t size,
831 int(*compar)(const void *, const void *));
Mike Frysinger560d4242010-12-17 16:51:59 -0500832int strcmp_compar(const void *, const void *);
Wolfgang Denk54c69772010-06-13 01:45:10 +0200833
Peter Tyser78acc472010-04-12 22:28:05 -0500834/* lib/time.c */
Ingo van Lil3eb90ba2009-11-24 14:09:21 +0100835void udelay (unsigned long);
Anatolij Gustschinc4c9fbe2011-10-12 02:31:39 +0000836void mdelay(unsigned long);
Ingo van Lil3eb90ba2009-11-24 14:09:21 +0100837
Jason Hobbse11938e2011-08-23 11:06:56 +0000838/* lib/uuid.c */
Przemyslaw Marczakd718ded2014-04-02 10:20:03 +0200839#include <uuid.h>
Jason Hobbse11938e2011-08-23 11:06:56 +0000840
Peter Tyser78acc472010-04-12 22:28:05 -0500841/* lib/vsprintf.c */
Simon Glass9785c902011-11-02 09:52:07 +0000842#include <vsprintf.h>
wdenke2211742002-11-02 23:30:20 +0000843
Peter Tyser78acc472010-04-12 22:28:05 -0500844/* lib/strmhz.c */
Ed Swarthout55f79342011-03-05 10:28:17 -0600845char * strmhz(char *buf, unsigned long hz);
Haavard Skinnemoen0768b7a2008-08-18 13:41:27 +0200846
Peter Tyser78acc472010-04-12 22:28:05 -0500847/* lib/crc32.c */
Prafulla Wadaskar449609f2009-08-16 05:28:19 +0530848#include <u-boot/crc.h>
wdenke2211742002-11-02 23:30:20 +0000849
Michael Walle9acf1ca2012-06-05 11:33:14 +0000850/* lib/rand.c */
Michael Walle9acf1ca2012-06-05 11:33:14 +0000851#define RAND_MAX -1U
852void srand(unsigned int seed);
853unsigned int rand(void);
854unsigned int rand_r(unsigned int *seedp);
Michael Walle9acf1ca2012-06-05 11:33:14 +0000855
wdenke2211742002-11-02 23:30:20 +0000856/* common/console.c */
wdenke2211742002-11-02 23:30:20 +0000857int console_init_f(void); /* Before relocation; uses the serial stuff */
858int console_init_r(void); /* After relocation; uses the console stuff */
Mike Frysingerd7be3052010-10-20 07:18:03 -0400859int console_assign(int file, const char *devname); /* Assign the console */
wdenke2211742002-11-02 23:30:20 +0000860int ctrlc (void);
861int had_ctrlc (void); /* have we had a Control-C since last clear? */
862void clear_ctrlc (void); /* clear the Control-C condition */
863int disable_ctrlc (int); /* 1 to disable, 0 to enable Control-C detect */
Pierre Auberta5dffa42014-04-24 10:30:07 +0200864int confirm_yesno(void); /* 1 if input is "y", "Y", "yes" or "YES" */
wdenke2211742002-11-02 23:30:20 +0000865/*
866 * STDIO based functions (can always be used)
867 */
wdenke2211742002-11-02 23:30:20 +0000868/* serial stuff */
Wolfgang Denkd9c27252010-06-20 17:14:14 +0200869int serial_printf (const char *fmt, ...)
Andrew Klossnerdc4b0b32008-07-07 06:41:14 -0700870 __attribute__ ((format (__printf__, 1, 2)));
wdenke2211742002-11-02 23:30:20 +0000871/* stdin */
872int getc(void);
873int tstc(void);
874
875/* stdout */
Heiko Schocher80402f32015-06-29 09:10:46 +0200876#if defined(CONFIG_SPL_BUILD) && !defined(CONFIG_SPL_SERIAL_SUPPORT)
877#define putc(...) do { } while (0)
878#define puts(...) do { } while (0)
879#define printf(...) do { } while (0)
880#define vprintf(...) do { } while (0)
881#else
wdenke2211742002-11-02 23:30:20 +0000882void putc(const char c);
883void puts(const char *s);
Wolfgang Denkd9c27252010-06-20 17:14:14 +0200884int printf(const char *fmt, ...)
Andrew Klossnerdc4b0b32008-07-07 06:41:14 -0700885 __attribute__ ((format (__printf__, 1, 2)));
Wolfgang Denkd9c27252010-06-20 17:14:14 +0200886int vprintf(const char *fmt, va_list args);
Heiko Schocher80402f32015-06-29 09:10:46 +0200887#endif
wdenke2211742002-11-02 23:30:20 +0000888
889/* stderr */
890#define eputc(c) fputc(stderr, c)
891#define eputs(s) fputs(stderr, s)
892#define eprintf(fmt,args...) fprintf(stderr,fmt ,##args)
893
894/*
895 * FILE based functions (can only be used AFTER relocation!)
896 */
wdenke2211742002-11-02 23:30:20 +0000897#define stdin 0
898#define stdout 1
899#define stderr 2
900#define MAX_FILES 3
901
Wolfgang Denkd9c27252010-06-20 17:14:14 +0200902int fprintf(int file, const char *fmt, ...)
Andrew Klossnerdc4b0b32008-07-07 06:41:14 -0700903 __attribute__ ((format (__printf__, 2, 3)));
wdenke2211742002-11-02 23:30:20 +0000904void fputs(int file, const char *s);
905void fputc(int file, const char c);
906int ftstc(int file);
907int fgetc(int file);
908
Lei Wen88d52c62012-09-28 04:26:46 +0000909/* lib/gzip.c */
910int gzip(void *dst, unsigned long *lenp,
911 unsigned char *src, unsigned long srclen);
912int zzip(void *dst, unsigned long *lenp, unsigned char *src,
913 unsigned long srclen, int stoponerr,
914 int (*func)(unsigned long, unsigned long));
915
Joe Hershberger4ef8d532012-05-23 08:01:04 +0000916/* lib/net_utils.c */
917#include <net.h>
Joe Hershberger049a95a2015-04-08 01:41:01 -0500918static inline struct in_addr getenv_ip(char *var)
Joe Hershberger4ef8d532012-05-23 08:01:04 +0000919{
920 return string_to_ip(getenv(var));
921}
922
Gary Jennejohn16a28ef2008-11-06 15:04:23 +0100923/*
924 * CONSOLE multiplexing.
925 */
926#ifdef CONFIG_CONSOLE_MUX
927#include <iomux.h>
928#endif
929
wdenke2211742002-11-02 23:30:20 +0000930int pcmcia_init (void);
931
Wolfgang Denkfb364be2009-07-27 09:58:14 +0200932#ifdef CONFIG_STATUS_LED
933# include <status_led.h>
934#endif
Simon Glass097e1782012-01-14 15:24:44 +0000935
936#include <bootstage.h>
wdenke2211742002-11-02 23:30:20 +0000937
Joe Hershberger48522bb2012-05-15 08:59:08 +0000938#ifdef CONFIG_SHOW_ACTIVITY
939void show_activity(int arg);
940#endif
941
Wolfgang Denkfcd3c872009-07-24 00:17:48 +0200942/* Multicore arch functions */
943#ifdef CONFIG_MP
944int cpu_status(int nr);
945int cpu_reset(int nr);
Kumar Gala4194b362010-01-12 11:42:43 -0600946int cpu_disable(int nr);
Wolfgang Denk54841ab2010-06-28 22:00:46 +0200947int cpu_release(int nr, int argc, char * const argv[]);
Wolfgang Denkfcd3c872009-07-24 00:17:48 +0200948#endif
949
950#endif /* __ASSEMBLY__ */
951
Stefan Roese13e95e42011-10-07 01:05:34 +0000952#ifdef CONFIG_PPC
953/*
954 * Has to be included outside of the #ifndef __ASSEMBLY__ section.
955 * Otherwise might lead to compilation errors in assembler files.
956 */
957#include <asm/cache.h>
958#endif
959
Wolfgang Denkfcd3c872009-07-24 00:17:48 +0200960/* Put only stuff here that the assembler can digest */
961
962#ifdef CONFIG_POST
963#define CONFIG_HAS_POST
Michael Zaidman800eb092010-09-20 08:51:53 +0200964#ifndef CONFIG_POST_ALT_LIST
965#define CONFIG_POST_STD_LIST
966#endif
Wolfgang Denkfcd3c872009-07-24 00:17:48 +0200967#endif
968
wdenk8aa1a2d2005-04-04 12:44:11 +0000969#ifdef CONFIG_INIT_CRITICAL
Wolfgang Denk2f6fa462006-08-14 23:17:47 +0200970#error CONFIG_INIT_CRITICAL is deprecated!
wdenk8aa1a2d2005-04-04 12:44:11 +0000971#error Read section CONFIG_SKIP_LOWLEVEL_INIT in README.
972#endif
973
Anton Staaf155cfb52011-09-02 13:45:28 +0000974#define ROUND(a,b) (((a) + (b) - 1) & ~((b) - 1))
Andy Fleming4b03ac82008-06-16 13:58:53 -0500975
Anton Staaf1e41f5a2011-10-17 16:46:13 -0700976/*
977 * ARCH_DMA_MINALIGN is defined in asm/cache.h for each architecture. It
978 * is used to align DMA buffers.
979 */
980#ifndef __ASSEMBLY__
981#include <asm/cache.h>
982#endif
983
Anton staaf46a6d512011-10-12 13:55:59 +0000984/*
985 * The ALLOC_CACHE_ALIGN_BUFFER macro is used to allocate a buffer on the
986 * stack that meets the minimum architecture alignment requirements for DMA.
987 * Such a buffer is useful for DMA operations where flushing and invalidating
988 * the cache before and after a read and/or write operation is required for
989 * correct operations.
990 *
991 * When called the macro creates an array on the stack that is sized such
992 * that:
993 *
994 * 1) The beginning of the array can be advanced enough to be aligned.
995 *
996 * 2) The size of the aligned portion of the array is a multiple of the minimum
997 * architecture alignment required for DMA.
998 *
999 * 3) The aligned portion contains enough space for the original number of
1000 * elements requested.
1001 *
1002 * The macro then creates a pointer to the aligned portion of this array and
1003 * assigns to the pointer the address of the first element in the aligned
1004 * portion of the array.
1005 *
1006 * Calling the macro as:
1007 *
1008 * ALLOC_CACHE_ALIGN_BUFFER(uint32_t, buffer, 1024);
1009 *
1010 * Will result in something similar to saying:
1011 *
1012 * uint32_t buffer[1024];
1013 *
1014 * The following differences exist:
1015 *
1016 * 1) The resulting buffer is guaranteed to be aligned to the value of
1017 * ARCH_DMA_MINALIGN.
1018 *
1019 * 2) The buffer variable created by the macro is a pointer to the specified
1020 * type, and NOT an array of the specified type. This can be very important
1021 * if you want the address of the buffer, which you probably do, to pass it
1022 * to the DMA hardware. The value of &buffer is different in the two cases.
1023 * In the macro case it will be the address of the pointer, not the address
1024 * of the space reserved for the buffer. However, in the second case it
1025 * would be the address of the buffer. So if you are replacing hard coded
1026 * stack buffers with this macro you need to make sure you remove the & from
1027 * the locations where you are taking the address of the buffer.
1028 *
1029 * Note that the size parameter is the number of array elements to allocate,
1030 * not the number of bytes.
1031 *
1032 * This macro can not be used outside of function scope, or for the creation
1033 * of a function scoped static buffer. It can not be used to create a cache
1034 * line aligned global buffer.
1035 */
Mischa Jonkere8232fe2013-07-26 16:18:41 +02001036#define PAD_COUNT(s, pad) (((s) - 1) / (pad) + 1)
Egbert Eichae1768a2013-04-09 06:03:36 +00001037#define PAD_SIZE(s, pad) (PAD_COUNT(s, pad) * pad)
1038#define ALLOC_ALIGN_BUFFER_PAD(type, name, size, align, pad) \
Mischa Jonkere8232fe2013-07-26 16:18:41 +02001039 char __##name[ROUND(PAD_SIZE((size) * sizeof(type), pad), align) \
Egbert Eichae1768a2013-04-09 06:03:36 +00001040 + (align - 1)]; \
Anton staaf46a6d512011-10-12 13:55:59 +00001041 \
Marek Vasutde4d1132012-07-15 04:43:47 +00001042 type *name = (type *) ALIGN((uintptr_t)__##name, align)
Egbert Eichae1768a2013-04-09 06:03:36 +00001043#define ALLOC_ALIGN_BUFFER(type, name, size, align) \
1044 ALLOC_ALIGN_BUFFER_PAD(type, name, size, align, 1)
1045#define ALLOC_CACHE_ALIGN_BUFFER_PAD(type, name, size, pad) \
1046 ALLOC_ALIGN_BUFFER_PAD(type, name, size, ARCH_DMA_MINALIGN, pad)
Marek Vasutde4d1132012-07-15 04:43:47 +00001047#define ALLOC_CACHE_ALIGN_BUFFER(type, name, size) \
1048 ALLOC_ALIGN_BUFFER(type, name, size, ARCH_DMA_MINALIGN)
1049
1050/*
1051 * DEFINE_CACHE_ALIGN_BUFFER() is similar to ALLOC_CACHE_ALIGN_BUFFER, but it's
1052 * purpose is to allow allocating aligned buffers outside of function scope.
1053 * Usage of this macro shall be avoided or used with extreme care!
1054 */
1055#define DEFINE_ALIGN_BUFFER(type, name, size, align) \
Masahiro Yamada111396c2014-11-07 03:03:30 +09001056 static char __##name[ALIGN(size * sizeof(type), align)] \
Egbert Eichd7ea4d42013-04-09 21:11:54 +00001057 __aligned(align); \
Marek Vasutde4d1132012-07-15 04:43:47 +00001058 \
1059 static type *name = (type *)__##name
1060#define DEFINE_CACHE_ALIGN_BUFFER(type, name, size) \
1061 DEFINE_ALIGN_BUFFER(type, name, size, ARCH_DMA_MINALIGN)
Anton staaf46a6d512011-10-12 13:55:59 +00001062
Simon Glassc9689ca2015-06-23 15:38:31 -06001063/*
1064 * check_member() - Check the offset of a structure member
1065 *
1066 * @structure: Name of structure (e.g. global_data)
1067 * @member: Name of member (e.g. baudrate)
1068 * @offset: Expected offset in bytes
1069 */
1070#define check_member(structure, member, offset) _Static_assert( \
1071 offsetof(struct structure, member) == offset, \
1072 "`struct " #structure "` offset for `" #member "` is not " #offset)
1073
Simon Glass476476e2015-08-04 12:33:52 -06001074/* Avoid using CONFIG_EFI_STUB directly as we may boot from other loaders */
1075#ifdef CONFIG_EFI_STUB
1076#define ll_boot_init() false
1077#else
1078#define ll_boot_init() true
1079#endif
1080
Mike Frysingerc3eb3fe2011-07-08 10:44:25 +00001081/* Pull in stuff for the build system */
1082#ifdef DO_DEPS_ONLY
1083# include <environment.h>
1084#endif
1085
wdenke2211742002-11-02 23:30:20 +00001086#endif /* __COMMON_H_ */