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