Prepare v2013.10-rc2
[nm-kernel:u-boot-nm.git] / Makefile
1 #
2 # (C) Copyright 2000-2013
3 # Wolfgang Denk, DENX Software Engineering, wd@denx.de.
4 #
5 # SPDX-License-Identifier:      GPL-2.0+
6 #
7
8 VERSION = 2013
9 PATCHLEVEL = 10
10 SUBLEVEL =
11 EXTRAVERSION = -rc2
12 ifneq "$(SUBLEVEL)" ""
13 U_BOOT_VERSION = $(VERSION).$(PATCHLEVEL).$(SUBLEVEL)$(EXTRAVERSION)
14 else
15 U_BOOT_VERSION = $(VERSION).$(PATCHLEVEL)$(EXTRAVERSION)
16 endif
17 TIMESTAMP_FILE = $(obj)include/generated/timestamp_autogenerated.h
18 VERSION_FILE = $(obj)include/generated/version_autogenerated.h
19
20 HOSTARCH := $(shell uname -m | \
21         sed -e s/i.86/x86/ \
22             -e s/sun4u/sparc64/ \
23             -e s/arm.*/arm/ \
24             -e s/sa110/arm/ \
25             -e s/ppc64/powerpc/ \
26             -e s/ppc/powerpc/ \
27             -e s/macppc/powerpc/\
28             -e s/sh.*/sh/)
29
30 HOSTOS := $(shell uname -s | tr '[:upper:]' '[:lower:]' | \
31             sed -e 's/\(cygwin\).*/cygwin/')
32
33 export  HOSTARCH HOSTOS
34
35 # Deal with colliding definitions from tcsh etc.
36 VENDOR=
37
38 #########################################################################
39 # Allow for silent builds
40 ifeq (,$(findstring s,$(MAKEFLAGS)))
41 XECHO = echo
42 else
43 XECHO = :
44 endif
45
46 #########################################################################
47 #
48 # U-boot build supports producing a object files to the separate external
49 # directory. Two use cases are supported:
50 #
51 # 1) Add O= to the make command line
52 # 'make O=/tmp/build all'
53 #
54 # 2) Set environement variable BUILD_DIR to point to the desired location
55 # 'export BUILD_DIR=/tmp/build'
56 # 'make'
57 #
58 # The second approach can also be used with a MAKEALL script
59 # 'export BUILD_DIR=/tmp/build'
60 # './MAKEALL'
61 #
62 # Command line 'O=' setting overrides BUILD_DIR environent variable.
63 #
64 # When none of the above methods is used the local build is performed and
65 # the object files are placed in the source directory.
66 #
67
68 ifdef O
69 ifeq ("$(origin O)", "command line")
70 BUILD_DIR := $(O)
71 endif
72 endif
73
74 # Call a source code checker (by default, "sparse") as part of the
75 # C compilation.
76 #
77 # Use 'make C=1' to enable checking of re-compiled files.
78 #
79 # See the linux kernel file "Documentation/sparse.txt" for more details,
80 # including where to get the "sparse" utility.
81
82 ifdef C
83 ifeq ("$(origin C)", "command line")
84 CHECKSRC := $(C)
85 endif
86 endif
87 ifndef CHECKSRC
88   CHECKSRC = 0
89 endif
90 export CHECKSRC
91
92 ifneq ($(BUILD_DIR),)
93 saved-output := $(BUILD_DIR)
94
95 # Attempt to create a output directory.
96 $(shell [ -d ${BUILD_DIR} ] || mkdir -p ${BUILD_DIR})
97
98 # Verify if it was successful.
99 BUILD_DIR := $(shell cd $(BUILD_DIR) && /bin/pwd)
100 $(if $(BUILD_DIR),,$(error output directory "$(saved-output)" does not exist))
101 endif # ifneq ($(BUILD_DIR),)
102
103 OBJTREE         := $(if $(BUILD_DIR),$(BUILD_DIR),$(CURDIR))
104 SPLTREE         := $(OBJTREE)/spl
105 TPLTREE         := $(OBJTREE)/tpl
106 SRCTREE         := $(CURDIR)
107 TOPDIR          := $(SRCTREE)
108 LNDIR           := $(OBJTREE)
109 export  TOPDIR SRCTREE OBJTREE SPLTREE TPLTREE
110
111 MKCONFIG        := $(SRCTREE)/mkconfig
112 export MKCONFIG
113
114 ifneq ($(OBJTREE),$(SRCTREE))
115 REMOTE_BUILD    := 1
116 export REMOTE_BUILD
117 endif
118
119 # $(obj) and (src) are defined in config.mk but here in main Makefile
120 # we also need them before config.mk is included which is the case for
121 # some targets like unconfig, clean, clobber, distclean, etc.
122 ifneq ($(OBJTREE),$(SRCTREE))
123 obj := $(OBJTREE)/
124 src := $(SRCTREE)/
125 else
126 obj :=
127 src :=
128 endif
129 export obj src
130
131 # Make sure CDPATH settings don't interfere
132 unexport CDPATH
133
134 #########################################################################
135
136 # The "tools" are needed early, so put this first
137 # Don't include stuff already done in $(LIBS)
138 # The "examples" conditionally depend on U-Boot (say, when USE_PRIVATE_LIBGCC
139 # is "yes"), so compile examples after U-Boot is compiled.
140 SUBDIR_TOOLS = tools
141 SUBDIR_EXAMPLES = examples/standalone examples/api
142 SUBDIRS = $(SUBDIR_TOOLS)
143
144 .PHONY : $(SUBDIRS) $(VERSION_FILE) $(TIMESTAMP_FILE)
145
146 ifeq ($(obj)include/config.mk,$(wildcard $(obj)include/config.mk))
147
148 # Include autoconf.mk before config.mk so that the config options are available
149 # to all top level build files.  We need the dummy all: target to prevent the
150 # dependency target in autoconf.mk.dep from being the default.
151 all:
152 sinclude $(obj)include/autoconf.mk.dep
153 sinclude $(obj)include/autoconf.mk
154
155 ifndef CONFIG_SANDBOX
156 SUBDIRS += $(SUBDIR_EXAMPLES)
157 endif
158
159 # load ARCH, BOARD, and CPU configuration
160 include $(obj)include/config.mk
161 export  ARCH CPU BOARD VENDOR SOC
162
163 # set default to nothing for native builds
164 ifeq ($(HOSTARCH),$(ARCH))
165 CROSS_COMPILE ?=
166 endif
167
168 # load other configuration
169 include $(TOPDIR)/config.mk
170
171 # Targets which don't build the source code
172 NON_BUILD_TARGETS = backup clean clobber distclean mkproper tidy unconfig
173
174 # Only do the generic board check when actually building, not configuring
175 ifeq ($(filter $(NON_BUILD_TARGETS),$(MAKECMDGOALS)),)
176 ifeq ($(findstring _config,$(MAKECMDGOALS)),)
177 $(CHECK_GENERIC_BOARD)
178 endif
179 endif
180
181 # If board code explicitly specified LDSCRIPT or CONFIG_SYS_LDSCRIPT, use
182 # that (or fail if absent).  Otherwise, search for a linker script in a
183 # standard location.
184
185 LDSCRIPT_MAKEFILE_DIR = $(dir $(LDSCRIPT))
186
187 ifndef LDSCRIPT
188         #LDSCRIPT := $(TOPDIR)/board/$(BOARDDIR)/u-boot.lds.debug
189         ifdef CONFIG_SYS_LDSCRIPT
190                 # need to strip off double quotes
191                 LDSCRIPT := $(subst ",,$(CONFIG_SYS_LDSCRIPT))
192         endif
193 endif
194
195 # If there is no specified link script, we look in a number of places for it
196 ifndef LDSCRIPT
197         ifeq ($(CONFIG_NAND_U_BOOT),y)
198                 LDSCRIPT := $(TOPDIR)/board/$(BOARDDIR)/u-boot-nand.lds
199                 ifeq ($(wildcard $(LDSCRIPT)),)
200                         LDSCRIPT := $(TOPDIR)/$(CPUDIR)/u-boot-nand.lds
201                 endif
202         endif
203         ifeq ($(wildcard $(LDSCRIPT)),)
204                 LDSCRIPT := $(TOPDIR)/board/$(BOARDDIR)/u-boot.lds
205         endif
206         ifeq ($(wildcard $(LDSCRIPT)),)
207                 LDSCRIPT := $(TOPDIR)/$(CPUDIR)/u-boot.lds
208         endif
209         ifeq ($(wildcard $(LDSCRIPT)),)
210                 LDSCRIPT := $(TOPDIR)/arch/$(ARCH)/cpu/u-boot.lds
211                 # We don't expect a Makefile here
212                 LDSCRIPT_MAKEFILE_DIR =
213         endif
214         ifeq ($(wildcard $(LDSCRIPT)),)
215 $(error could not find linker script)
216         endif
217 endif
218
219 #########################################################################
220 # U-Boot objects....order is important (i.e. start must be first)
221
222 OBJS  = $(CPUDIR)/start.o
223 ifeq ($(CPU),ppc4xx)
224 OBJS += $(CPUDIR)/resetvec.o
225 endif
226 ifeq ($(CPU),mpc85xx)
227 OBJS += $(CPUDIR)/resetvec.o
228 endif
229
230 OBJS := $(addprefix $(obj),$(OBJS))
231
232 HAVE_VENDOR_COMMON_LIB = $(if $(wildcard board/$(VENDOR)/common/Makefile),y,n)
233
234 LIBS-y += lib/libgeneric.o
235 LIBS-y += lib/rsa/librsa.o
236 LIBS-y += lib/lzma/liblzma.o
237 LIBS-y += lib/lzo/liblzo.o
238 LIBS-y += lib/zlib/libz.o
239 LIBS-$(CONFIG_TIZEN) += lib/tizen/libtizen.o
240 LIBS-$(HAVE_VENDOR_COMMON_LIB) += board/$(VENDOR)/common/lib$(VENDOR).o
241 LIBS-y += $(CPUDIR)/lib$(CPU).o
242 ifdef SOC
243 LIBS-y += $(CPUDIR)/$(SOC)/lib$(SOC).o
244 endif
245 ifeq ($(CPU),ixp)
246 LIBS-y += drivers/net/npe/libnpe.o
247 endif
248 LIBS-$(CONFIG_OF_EMBED) += dts/libdts.o
249 LIBS-y += arch/$(ARCH)/lib/lib$(ARCH).o
250 LIBS-y += fs/libfs.o \
251         fs/cbfs/libcbfs.o \
252         fs/cramfs/libcramfs.o \
253         fs/ext4/libext4fs.o \
254         fs/fat/libfat.o \
255         fs/fdos/libfdos.o \
256         fs/jffs2/libjffs2.o \
257         fs/reiserfs/libreiserfs.o \
258         fs/sandbox/libsandboxfs.o \
259         fs/ubifs/libubifs.o \
260         fs/yaffs2/libyaffs2.o \
261         fs/zfs/libzfs.o
262 LIBS-y += net/libnet.o
263 LIBS-y += disk/libdisk.o
264 LIBS-y += drivers/bios_emulator/libatibiosemu.o
265 LIBS-y += drivers/block/libblock.o
266 LIBS-$(CONFIG_BOOTCOUNT_LIMIT) += drivers/bootcount/libbootcount.o
267 LIBS-y += drivers/crypto/libcrypto.o
268 LIBS-y += drivers/dma/libdma.o
269 LIBS-y += drivers/fpga/libfpga.o
270 LIBS-y += drivers/gpio/libgpio.o
271 LIBS-y += drivers/hwmon/libhwmon.o
272 LIBS-y += drivers/i2c/libi2c.o
273 LIBS-y += drivers/input/libinput.o
274 LIBS-y += drivers/misc/libmisc.o
275 LIBS-y += drivers/mmc/libmmc.o
276 LIBS-y += drivers/mtd/libmtd.o
277 LIBS-y += drivers/mtd/nand/libnand.o
278 LIBS-y += drivers/mtd/onenand/libonenand.o
279 LIBS-y += drivers/mtd/ubi/libubi.o
280 LIBS-y += drivers/mtd/spi/libspi_flash.o
281 LIBS-y += drivers/net/libnet.o
282 LIBS-y += drivers/net/phy/libphy.o
283 LIBS-y += drivers/pci/libpci.o
284 LIBS-y += drivers/pcmcia/libpcmcia.o
285 LIBS-y += drivers/power/libpower.o \
286         drivers/power/fuel_gauge/libfuel_gauge.o \
287         drivers/power/pmic/libpmic.o \
288         drivers/power/battery/libbattery.o
289 LIBS-y += drivers/spi/libspi.o
290 LIBS-y += drivers/dfu/libdfu.o
291 ifeq ($(CPU),mpc83xx)
292 LIBS-y += drivers/qe/libqe.o
293 LIBS-y += arch/powerpc/cpu/mpc8xxx/ddr/libddr.o
294 LIBS-y += arch/powerpc/cpu/mpc8xxx/lib8xxx.o
295 endif
296 ifeq ($(CPU),mpc85xx)
297 LIBS-y += drivers/qe/libqe.o
298 LIBS-y += drivers/net/fm/libfm.o
299 LIBS-y += arch/powerpc/cpu/mpc8xxx/ddr/libddr.o
300 LIBS-y += arch/powerpc/cpu/mpc8xxx/lib8xxx.o
301 endif
302 ifeq ($(CPU),mpc86xx)
303 LIBS-y += arch/powerpc/cpu/mpc8xxx/ddr/libddr.o
304 LIBS-y += arch/powerpc/cpu/mpc8xxx/lib8xxx.o
305 endif
306 LIBS-y += drivers/rtc/librtc.o
307 LIBS-y += drivers/serial/libserial.o
308 LIBS-y += drivers/sound/libsound.o
309 LIBS-y += drivers/tpm/libtpm.o
310 LIBS-y += drivers/twserial/libtws.o
311 LIBS-y += drivers/usb/eth/libusb_eth.o
312 LIBS-y += drivers/usb/gadget/libusb_gadget.o
313 LIBS-y += drivers/usb/host/libusb_host.o
314 LIBS-y += drivers/usb/musb/libusb_musb.o
315 LIBS-y += drivers/usb/musb-new/libusb_musb-new.o
316 LIBS-y += drivers/usb/phy/libusb_phy.o
317 LIBS-y += drivers/usb/ulpi/libusb_ulpi.o
318 LIBS-y += drivers/video/libvideo.o
319 LIBS-y += drivers/watchdog/libwatchdog.o
320 LIBS-y += common/libcommon.o
321 LIBS-y += lib/libfdt/libfdt.o
322 LIBS-y += api/libapi.o
323 LIBS-y += post/libpost.o
324 LIBS-y += test/libtest.o
325
326 ifneq ($(CONFIG_OMAP_COMMON),)
327 LIBS-y += $(CPUDIR)/omap-common/libomap-common.o
328 endif
329
330 ifneq (,$(filter $(SOC), mx25 mx27 mx5 mx6 mx31 mx35 mxs vf610))
331 LIBS-y += arch/$(ARCH)/imx-common/libimx-common.o
332 endif
333
334 ifeq ($(SOC),s5pc1xx)
335 LIBS-y += $(CPUDIR)/s5p-common/libs5p-common.o
336 endif
337 ifeq ($(SOC),exynos)
338 LIBS-y += $(CPUDIR)/s5p-common/libs5p-common.o
339 endif
340 ifneq ($(CONFIG_TEGRA),)
341 LIBS-y += arch/$(ARCH)/cpu/$(SOC)-common/lib$(SOC)-common.o
342 LIBS-y += arch/$(ARCH)/cpu/tegra-common/libcputegra-common.o
343 LIBS-y += $(CPUDIR)/tegra-common/libtegra-common.o
344 endif
345
346 LIBS := $(addprefix $(obj),$(sort $(LIBS-y)))
347 .PHONY : $(LIBS)
348
349 LIBBOARD = board/$(BOARDDIR)/lib$(BOARD).o
350 LIBBOARD := $(addprefix $(obj),$(LIBBOARD))
351
352 # Add GCC lib
353 ifdef USE_PRIVATE_LIBGCC
354 ifeq ("$(USE_PRIVATE_LIBGCC)", "yes")
355 PLATFORM_LIBGCC = $(OBJTREE)/arch/$(ARCH)/lib/libgcc.o
356 else
357 PLATFORM_LIBGCC = -L $(USE_PRIVATE_LIBGCC) -lgcc
358 endif
359 else
360 PLATFORM_LIBGCC := -L $(shell dirname `$(CC) $(CFLAGS) -print-libgcc-file-name`) -lgcc
361 endif
362 PLATFORM_LIBS += $(PLATFORM_LIBGCC)
363 export PLATFORM_LIBS
364
365 # Special flags for CPP when processing the linker script.
366 # Pass the version down so we can handle backwards compatibility
367 # on the fly.
368 LDPPFLAGS += \
369         -include $(TOPDIR)/include/u-boot/u-boot.lds.h \
370         -DCPUDIR=$(CPUDIR) \
371         $(shell $(LD) --version | \
372           sed -ne 's/GNU ld version \([0-9][0-9]*\)\.\([0-9][0-9]*\).*/-DLD_MAJOR=\1 -DLD_MINOR=\2/p')
373
374 __OBJS := $(subst $(obj),,$(OBJS))
375 __LIBS := $(subst $(obj),,$(LIBS)) $(subst $(obj),,$(LIBBOARD))
376
377 #########################################################################
378 #########################################################################
379
380 ifneq ($(CONFIG_BOARD_SIZE_LIMIT),)
381 BOARD_SIZE_CHECK = \
382         @actual=`wc -c $@ | awk '{print $$1}'`; \
383         limit=`printf "%d" $(CONFIG_BOARD_SIZE_LIMIT)`; \
384         if test $$actual -gt $$limit; then \
385                 echo "$@ exceeds file size limit:" >&2 ; \
386                 echo "  limit:  $$limit bytes" >&2 ; \
387                 echo "  actual: $$actual bytes" >&2 ; \
388                 echo "  excess: $$((actual - limit)) bytes" >&2; \
389                 exit 1; \
390         fi
391 else
392 BOARD_SIZE_CHECK =
393 endif
394
395 # Always append ALL so that arch config.mk's can add custom ones
396 ALL-y += $(obj)u-boot.srec $(obj)u-boot.bin $(obj)System.map
397
398 ALL-$(CONFIG_NAND_U_BOOT) += $(obj)u-boot-nand.bin
399 ALL-$(CONFIG_ONENAND_U_BOOT) += $(obj)u-boot-onenand.bin
400 ALL-$(CONFIG_SPL) += $(obj)spl/u-boot-spl.bin
401 ALL-$(CONFIG_TPL) += $(obj)tpl/u-boot-tpl.bin
402 ALL-$(CONFIG_OF_SEPARATE) += $(obj)u-boot.dtb $(obj)u-boot-dtb.bin
403 ifneq ($(CONFIG_SPL_TARGET),)
404 ALL-$(CONFIG_SPL) += $(obj)$(subst ",,$(CONFIG_SPL_TARGET))
405 endif
406
407 # enable combined SPL/u-boot/dtb rules for tegra
408 ifneq ($(CONFIG_TEGRA),)
409 ifeq ($(CONFIG_OF_SEPARATE),y)
410 ALL-y += $(obj)u-boot-dtb-tegra.bin
411 else
412 ALL-y += $(obj)u-boot-nodtb-tegra.bin
413 endif
414 endif
415
416 all:            $(ALL-y) $(SUBDIR_EXAMPLES)
417
418 $(obj)u-boot.dtb:       checkdtc $(obj)u-boot
419                 $(MAKE) -C dts binary
420                 mv $(obj)dts/dt.dtb $@
421
422 $(obj)u-boot-dtb.bin:   $(obj)u-boot.bin $(obj)u-boot.dtb
423                 cat $^ >$@
424
425 $(obj)u-boot.hex:       $(obj)u-boot
426                 $(OBJCOPY) ${OBJCFLAGS} -O ihex $< $@
427
428 $(obj)u-boot.srec:      $(obj)u-boot
429                 $(OBJCOPY) -O srec $< $@
430
431 $(obj)u-boot.bin:       $(obj)u-boot
432                 $(OBJCOPY) ${OBJCFLAGS} -O binary $< $@
433                 $(BOARD_SIZE_CHECK)
434
435 $(obj)u-boot.ldr:       $(obj)u-boot
436                 $(CREATE_LDR_ENV)
437                 $(LDR) -T $(CONFIG_BFIN_CPU) -c $@ $< $(LDR_FLAGS)
438                 $(BOARD_SIZE_CHECK)
439
440 $(obj)u-boot.ldr.hex:   $(obj)u-boot.ldr
441                 $(OBJCOPY) ${OBJCFLAGS} -O ihex $< $@ -I binary
442
443 $(obj)u-boot.ldr.srec:  $(obj)u-boot.ldr
444                 $(OBJCOPY) ${OBJCFLAGS} -O srec $< $@ -I binary
445
446 #
447 # U-Boot entry point, needed for booting of full-blown U-Boot
448 # from the SPL U-Boot version.
449 #
450 ifndef CONFIG_SYS_UBOOT_START
451 CONFIG_SYS_UBOOT_START := 0
452 endif
453
454 $(obj)u-boot.img:       $(obj)u-boot.bin
455                 $(obj)tools/mkimage -A $(ARCH) -T firmware -C none \
456                 -O u-boot -a $(CONFIG_SYS_TEXT_BASE) \
457                 -e $(CONFIG_SYS_UBOOT_START) \
458                 -n $(shell sed -n -e 's/.*U_BOOT_VERSION//p' $(VERSION_FILE) | \
459                         sed -e 's/"[     ]*$$/ for $(BOARD) board"/') \
460                 -d $< $@
461
462 $(obj)u-boot.imx: $(obj)u-boot.bin depend
463                 $(MAKE) -C $(SRCTREE)/arch/arm/imx-common $(OBJTREE)/u-boot.imx
464
465 $(obj)u-boot.kwb:       $(obj)u-boot.bin
466                 $(obj)tools/mkimage -n $(CONFIG_SYS_KWD_CONFIG) -T kwbimage \
467                 -a $(CONFIG_SYS_TEXT_BASE) -e $(CONFIG_SYS_TEXT_BASE) -d $< $@
468
469 $(obj)u-boot.pbl:       $(obj)u-boot.bin
470                 $(obj)tools/mkimage -n $(CONFIG_PBLRCW_CONFIG) \
471                 -R $(CONFIG_PBLPBI_CONFIG) -T pblimage \
472                 -d $< $@
473
474 $(obj)u-boot.sha1:      $(obj)u-boot.bin
475                 $(obj)tools/ubsha1 $(obj)u-boot.bin
476
477 $(obj)u-boot.dis:       $(obj)u-boot
478                 $(OBJDUMP) -d $< > $@
479
480 # $@ is output, $(1) and $(2) are inputs, $(3) is padded intermediate,
481 # $(4) is pad-to
482 SPL_PAD_APPEND = \
483                 $(OBJCOPY) ${OBJCFLAGS} --pad-to=$(4) -I binary -O binary \
484                 $(1) $(obj)$(3); \
485                 cat $(obj)$(3) $(2) > $@; \
486                 rm $(obj)$(3)
487
488 ifdef CONFIG_TPL
489 SPL_PAYLOAD := $(obj)tpl/u-boot-with-tpl.bin
490 else
491 SPL_PAYLOAD := $(obj)u-boot.bin
492 endif
493
494 $(obj)u-boot-with-spl.bin: $(obj)spl/u-boot-spl.bin $(SPL_PAYLOAD)
495                 $(call SPL_PAD_APPEND,$<,$(SPL_PAYLOAD),spl/u-boot-spl-pad.bin,$(CONFIG_SPL_PAD_TO))
496
497 $(obj)tpl/u-boot-with-tpl.bin: $(obj)tpl/u-boot-tpl.bin $(obj)u-boot.bin
498                 $(call SPL_PAD_APPEND,$<,$(obj)u-boot.bin,tpl/u-boot-tpl-pad.bin,$(CONFIG_TPL_PAD_TO))
499
500 $(obj)u-boot-with-spl.imx: $(obj)spl/u-boot-spl.bin $(obj)u-boot.bin
501                 $(MAKE) -C $(SRCTREE)/arch/arm/imx-common \
502                         $(OBJTREE)/u-boot-with-spl.imx
503
504 $(obj)u-boot-with-nand-spl.imx: $(obj)spl/u-boot-spl.bin $(obj)u-boot.bin
505                 $(MAKE) -C $(SRCTREE)/arch/arm/imx-common \
506                         $(OBJTREE)/u-boot-with-nand-spl.imx
507
508 $(obj)u-boot.ubl:       $(obj)u-boot-with-spl.bin
509                 $(obj)tools/mkimage -n $(UBL_CONFIG) -T ublimage \
510                 -e $(CONFIG_SYS_TEXT_BASE) -d $< $(obj)u-boot.ubl
511
512 $(obj)u-boot.ais:       $(obj)spl/u-boot-spl.bin $(obj)u-boot.img
513                 $(obj)tools/mkimage -s -n $(if $(CONFIG_AIS_CONFIG_FILE),$(CONFIG_AIS_CONFIG_FILE),"/dev/null") \
514                         -T aisimage \
515                         -e $(CONFIG_SPL_TEXT_BASE) \
516                         -d $(obj)spl/u-boot-spl.bin \
517                         $(obj)spl/u-boot-spl.ais
518                 $(OBJCOPY) ${OBJCFLAGS} -I binary \
519                         --pad-to=$(CONFIG_SPL_MAX_SIZE) -O binary \
520                         $(obj)spl/u-boot-spl.ais $(obj)spl/u-boot-spl-pad.ais
521                 cat $(obj)spl/u-boot-spl-pad.ais $(obj)u-boot.img > \
522                         $(obj)u-boot.ais
523
524
525 $(obj)u-boot.sb:       $(obj)u-boot.bin $(obj)spl/u-boot-spl.bin
526                 $(MAKE) -C $(SRCTREE)/$(CPUDIR)/$(SOC)/ $(OBJTREE)/u-boot.sb
527
528 # On x600 (SPEAr600) U-Boot is appended to U-Boot SPL.
529 # Both images are created using mkimage (crc etc), so that the ROM
530 # bootloader can check its integrity. Padding needs to be done to the
531 # SPL image (with mkimage header) and not the binary. Otherwise the resulting image
532 # which is loaded/copied by the ROM bootloader to SRAM doesn't fit.
533 # The resulting image containing both U-Boot images is called u-boot.spr
534 $(obj)u-boot.spr:       $(obj)u-boot.img $(obj)spl/u-boot-spl.bin
535                 $(obj)tools/mkimage -A $(ARCH) -T firmware -C none \
536                 -a $(CONFIG_SPL_TEXT_BASE) -e $(CONFIG_SPL_TEXT_BASE) -n XLOADER \
537                 -d $(obj)spl/u-boot-spl.bin $(obj)spl/u-boot-spl.img
538                 tr "\000" "\377" < /dev/zero | dd ibs=1 count=$(CONFIG_SPL_PAD_TO) \
539                         of=$(obj)spl/u-boot-spl-pad.img 2>/dev/null
540                 dd if=$(obj)spl/u-boot-spl.img of=$(obj)spl/u-boot-spl-pad.img \
541                         conv=notrunc 2>/dev/null
542                 cat $(obj)spl/u-boot-spl-pad.img $(obj)u-boot.img > $@
543
544 ifneq ($(CONFIG_TEGRA),)
545 $(obj)u-boot-nodtb-tegra.bin: $(obj)spl/u-boot-spl.bin $(obj)u-boot.bin
546                 $(OBJCOPY) ${OBJCFLAGS} --pad-to=$(CONFIG_SYS_TEXT_BASE) -O binary $(obj)spl/u-boot-spl $(obj)spl/u-boot-spl-pad.bin
547                 cat $(obj)spl/u-boot-spl-pad.bin $(obj)u-boot.bin > $@
548                 rm $(obj)spl/u-boot-spl-pad.bin
549
550 ifeq ($(CONFIG_OF_SEPARATE),y)
551 $(obj)u-boot-dtb-tegra.bin: $(obj)u-boot-nodtb-tegra.bin $(obj)u-boot.dtb
552                 cat $(obj)u-boot-nodtb-tegra.bin $(obj)u-boot.dtb > $@
553 endif
554 endif
555
556 $(obj)u-boot-img.bin: $(obj)spl/u-boot-spl.bin $(obj)u-boot.img
557                 cat $(obj)spl/u-boot-spl.bin $(obj)u-boot.img > $@
558
559 # PPC4xx needs the SPL at the end of the image, since the reset vector
560 # is located at 0xfffffffc. So we can't use the "u-boot-img.bin" target
561 # and need to introduce a new build target with the full blown U-Boot
562 # at the start padded up to the start of the SPL image. And then concat
563 # the SPL image to the end.
564 $(obj)u-boot-img-spl-at-end.bin: $(obj)spl/u-boot-spl.bin $(obj)u-boot.img
565                 tr "\000" "\377" < /dev/zero | dd ibs=1 count=$(CONFIG_UBOOT_PAD_TO) \
566                         of=$(obj)u-boot-pad.img 2>/dev/null
567                 dd if=$(obj)u-boot.img of=$(obj)u-boot-pad.img \
568                         conv=notrunc 2>/dev/null
569                 cat $(obj)u-boot-pad.img $(obj)spl/u-boot-spl.bin > $@
570
571 ifeq ($(CONFIG_SANDBOX),y)
572 GEN_UBOOT = \
573                 cd $(LNDIR) && $(CC) $(SYMS) -T $(obj)u-boot.lds \
574                         -Wl,--start-group $(__LIBS) -Wl,--end-group \
575                         $(PLATFORM_LIBS) -Wl,-Map -Wl,u-boot.map -o u-boot
576 else
577 GEN_UBOOT = \
578                 cd $(LNDIR) && $(LD) $(LDFLAGS) $(LDFLAGS_$(@F)) \
579                         $(__OBJS) \
580                         --start-group $(__LIBS) --end-group $(PLATFORM_LIBS) \
581                         -Map u-boot.map -o u-boot
582 endif
583
584 $(obj)u-boot:   depend \
585                 $(SUBDIR_TOOLS) $(OBJS) $(LIBBOARD) $(LIBS) $(LDSCRIPT) $(obj)u-boot.lds
586                 $(GEN_UBOOT)
587 ifeq ($(CONFIG_KALLSYMS),y)
588                 smap=`$(call SYSTEM_MAP,$(obj)u-boot) | \
589                         awk '$$2 ~ /[tTwW]/ {printf $$1 $$3 "\\\\000"}'` ; \
590                 $(CC) $(CFLAGS) -DSYSTEM_MAP="\"$${smap}\"" \
591                         -c common/system_map.c -o $(obj)common/system_map.o
592                 $(GEN_UBOOT) $(obj)common/system_map.o
593 endif
594
595 $(OBJS):        depend
596                 $(MAKE) -C $(CPUDIR) $(if $(REMOTE_BUILD),$@,$(notdir $@))
597
598 $(LIBS):        depend $(SUBDIR_TOOLS)
599                 $(MAKE) -C $(dir $(subst $(obj),,$@))
600
601 $(LIBBOARD):    depend $(LIBS)
602                 $(MAKE) -C $(dir $(subst $(obj),,$@))
603
604 $(SUBDIRS):     depend
605                 $(MAKE) -C $@ all
606
607 $(SUBDIR_EXAMPLES): $(obj)u-boot
608
609 $(LDSCRIPT):    depend
610                 $(MAKE) -C $(dir $@) $(notdir $@)
611
612 $(obj)u-boot.lds: $(LDSCRIPT)
613                 $(CPP) $(CPPFLAGS) $(LDPPFLAGS) -ansi -D__ASSEMBLY__ -P - <$< >$@
614
615 nand_spl:       $(TIMESTAMP_FILE) $(VERSION_FILE) depend
616                 $(MAKE) -C nand_spl/board/$(BOARDDIR) all
617
618 $(obj)u-boot-nand.bin:  nand_spl $(obj)u-boot.bin
619                 cat $(obj)nand_spl/u-boot-spl-16k.bin $(obj)u-boot.bin > $(obj)u-boot-nand.bin
620
621 $(obj)spl/u-boot-spl.bin:       $(SUBDIR_TOOLS) depend
622                 $(MAKE) -C spl all
623
624 $(obj)tpl/u-boot-tpl.bin:       $(SUBDIR_TOOLS) depend
625                 $(MAKE) -C spl all CONFIG_TPL_BUILD=y
626
627 updater:
628                 $(MAKE) -C tools/updater all
629
630 # Explicitly make _depend in subdirs containing multiple targets to prevent
631 # parallel sub-makes creating .depend files simultaneously.
632 depend dep:     $(TIMESTAMP_FILE) $(VERSION_FILE) \
633                 $(obj)include/spl-autoconf.mk \
634                 $(obj)include/tpl-autoconf.mk \
635                 $(obj)include/autoconf.mk \
636                 $(obj)include/generated/generic-asm-offsets.h \
637                 $(obj)include/generated/asm-offsets.h
638                 for dir in $(SUBDIRS) $(CPUDIR) $(LDSCRIPT_MAKEFILE_DIR) ; do \
639                         $(MAKE) -C $$dir _depend ; done
640
641 TAG_SUBDIRS = $(SUBDIRS)
642 TAG_SUBDIRS += $(dir $(__LIBS))
643 TAG_SUBDIRS += include
644
645 FIND := find
646 FINDFLAGS := -L
647
648 checkstack:
649                 $(CROSS_COMPILE)objdump -d $(obj)u-boot \
650                         `$(FIND) $(obj) -name u-boot-spl -print` | \
651                         perl $(src)tools/checkstack.pl $(ARCH)
652
653 tags ctags:
654                 ctags -w -o $(obj)ctags `$(FIND) $(FINDFLAGS) $(TAG_SUBDIRS) \
655                                                 -name '*.[chS]' -print`
656
657 etags:
658                 etags -a -o $(obj)etags `$(FIND) $(FINDFLAGS) $(TAG_SUBDIRS) \
659                                                 -name '*.[chS]' -print`
660 cscope:
661                 $(FIND) $(FINDFLAGS) $(TAG_SUBDIRS) -name '*.[chS]' -print > \
662                                                 cscope.files
663                 cscope -b -q -k
664
665 SYSTEM_MAP = \
666                 $(NM) $1 | \
667                 grep -v '\(compiled\)\|\(\.o$$\)\|\( [aUw] \)\|\(\.\.ng$$\)\|\(LASH[RL]DI\)' | \
668                 LC_ALL=C sort
669 $(obj)System.map:       $(obj)u-boot
670                 @$(call SYSTEM_MAP,$<) > $(obj)System.map
671
672 checkthumb:
673         @if test $(call cc-version) -lt 0404; then \
674                 echo -n '*** Your GCC does not produce working '; \
675                 echo 'binaries in THUMB mode.'; \
676                 echo '*** Your board is configured for THUMB mode.'; \
677                 false; \
678         fi
679
680 # GCC 3.x is reported to have problems generating the type of relocation
681 # that U-Boot wants.
682 # See http://lists.denx.de/pipermail/u-boot/2012-September/135156.html
683 checkgcc4:
684         @if test $(call cc-version) -lt 0400; then \
685                 echo -n '*** Your GCC is too old, please upgrade to GCC 4.x or newer'; \
686                 false; \
687         fi
688
689 checkdtc:
690         @if test $(call dtc-version) -lt 0104; then \
691                 echo '*** Your dtc is too old, please upgrade to dtc 1.4 or newer'; \
692                 false; \
693         fi
694
695 #
696 # Auto-generate the autoconf.mk file (which is included by all makefiles)
697 #
698 # This target actually generates 2 files; autoconf.mk and autoconf.mk.dep.
699 # the dep file is only include in this top level makefile to determine when
700 # to regenerate the autoconf.mk file.
701 $(obj)include/autoconf.mk.dep: $(obj)include/config.h include/common.h
702         @$(XECHO) Generating $@ ; \
703         set -e ; \
704         : Generate the dependancies ; \
705         $(CC) -x c -DDO_DEPS_ONLY -M $(CFLAGS) $(CPPFLAGS) \
706                 -MQ $(obj)include/autoconf.mk include/common.h > $@
707
708 $(obj)include/autoconf.mk: $(obj)include/config.h
709         @$(XECHO) Generating $@ ; \
710         set -e ; \
711         : Extract the config macros ; \
712         $(CPP) $(CFLAGS) -DDO_DEPS_ONLY -dM include/common.h | \
713                 sed -n -f tools/scripts/define2mk.sed > $@.tmp && \
714         mv $@.tmp $@
715
716 # Auto-generate the spl-autoconf.mk file (which is included by all makefiles for SPL)
717 $(obj)include/tpl-autoconf.mk: $(obj)include/config.h
718         @$(XECHO) Generating $@ ; \
719         set -e ; \
720         : Extract the config macros ; \
721         $(CPP) $(CFLAGS) -DCONFIG_TPL_BUILD  -DCONFIG_SPL_BUILD\
722                         -DDO_DEPS_ONLY -dM include/common.h | \
723         sed -n -f tools/scripts/define2mk.sed > $@.tmp && \
724         mv $@.tmp $@
725
726 $(obj)include/spl-autoconf.mk: $(obj)include/config.h
727         @$(XECHO) Generating $@ ; \
728         set -e ; \
729         : Extract the config macros ; \
730         $(CPP) $(CFLAGS) -DCONFIG_SPL_BUILD -DDO_DEPS_ONLY -dM include/common.h | \
731         sed -n -f tools/scripts/define2mk.sed > $@.tmp && \
732         mv $@.tmp $@
733
734 $(obj)include/generated/generic-asm-offsets.h:  $(obj)include/autoconf.mk.dep \
735         $(obj)include/spl-autoconf.mk \
736         $(obj)include/tpl-autoconf.mk \
737         $(obj)lib/asm-offsets.s
738         @$(XECHO) Generating $@
739         tools/scripts/make-asm-offsets $(obj)lib/asm-offsets.s $@
740
741 $(obj)lib/asm-offsets.s:        $(obj)include/autoconf.mk.dep \
742         $(obj)include/spl-autoconf.mk \
743         $(obj)include/tpl-autoconf.mk \
744         $(src)lib/asm-offsets.c
745         @mkdir -p $(obj)lib
746         $(CC) -DDO_DEPS_ONLY \
747                 $(CFLAGS) $(CFLAGS_$(BCURDIR)/$(@F)) $(CFLAGS_$(BCURDIR)) \
748                 -o $@ $(src)lib/asm-offsets.c -c -S
749
750 $(obj)include/generated/asm-offsets.h:  $(obj)include/autoconf.mk.dep \
751         $(obj)include/spl-autoconf.mk \
752         $(obj)include/tpl-autoconf.mk \
753         $(obj)$(CPUDIR)/$(SOC)/asm-offsets.s
754         @$(XECHO) Generating $@
755         tools/scripts/make-asm-offsets $(obj)$(CPUDIR)/$(SOC)/asm-offsets.s $@
756
757 $(obj)$(CPUDIR)/$(SOC)/asm-offsets.s:   $(obj)include/autoconf.mk.dep \
758         $(obj)include/spl-autoconf.mk \
759         $(obj)include/tpl-autoconf.mk
760         @mkdir -p $(obj)$(CPUDIR)/$(SOC)
761         if [ -f $(src)$(CPUDIR)/$(SOC)/asm-offsets.c ];then \
762                 $(CC) -DDO_DEPS_ONLY \
763                 $(CFLAGS) $(CFLAGS_$(BCURDIR)/$(@F)) $(CFLAGS_$(BCURDIR)) \
764                         -o $@ $(src)$(CPUDIR)/$(SOC)/asm-offsets.c -c -S; \
765         else \
766                 touch $@; \
767         fi
768
769 #########################################################################
770 else    # !config.mk
771 all $(obj)u-boot.hex $(obj)u-boot.srec $(obj)u-boot.bin \
772 $(obj)u-boot.img $(obj)u-boot.dis $(obj)u-boot \
773 $(filter-out tools,$(SUBDIRS)) \
774 updater depend dep tags ctags etags cscope $(obj)System.map:
775         @echo "System not configured - see README" >&2
776         @ exit 1
777
778 tools: $(VERSION_FILE) $(TIMESTAMP_FILE)
779         $(MAKE) -C $@ all
780 endif   # config.mk
781
782 # ARM relocations should all be R_ARM_RELATIVE.
783 checkarmreloc: $(obj)u-boot
784         @if test "R_ARM_RELATIVE" != \
785                 "`$(CROSS_COMPILE)readelf -r $< | cut -d ' ' -f 4 | grep R_ARM | sort -u`"; \
786                 then echo "$< contains relocations other than \
787                 R_ARM_RELATIVE"; false; fi
788
789 $(VERSION_FILE):
790                 @mkdir -p $(dir $(VERSION_FILE))
791                 @( localvers='$(shell $(TOPDIR)/tools/setlocalversion $(TOPDIR))' ; \
792                    printf '#define PLAIN_VERSION "%s%s"\n' \
793                         "$(U_BOOT_VERSION)" "$${localvers}" ; \
794                    printf '#define U_BOOT_VERSION "U-Boot %s%s"\n' \
795                         "$(U_BOOT_VERSION)" "$${localvers}" ; \
796                 ) > $@.tmp
797                 @( printf '#define CC_VERSION_STRING "%s"\n' \
798                  '$(shell $(CC) --version | head -n 1)' )>>  $@.tmp
799                 @( printf '#define LD_VERSION_STRING "%s"\n' \
800                  '$(shell $(LD) -v | head -n 1)' )>>  $@.tmp
801                 @cmp -s $@ $@.tmp && rm -f $@.tmp || mv -f $@.tmp $@
802
803 $(TIMESTAMP_FILE):
804                 @mkdir -p $(dir $(TIMESTAMP_FILE))
805                 @LC_ALL=C date +'#define U_BOOT_DATE "%b %d %C%y"' > $@.tmp
806                 @LC_ALL=C date +'#define U_BOOT_TIME "%T"' >> $@.tmp
807                 @cmp -s $@ $@.tmp && rm -f $@.tmp || mv -f $@.tmp $@
808
809 easylogo env gdb:
810         $(MAKE) -C tools/$@ all MTD_VERSION=${MTD_VERSION}
811 gdbtools: gdb
812
813 xmldocs pdfdocs psdocs htmldocs mandocs: tools/kernel-doc/docproc
814         $(MAKE) U_BOOT_VERSION=$(U_BOOT_VERSION) -C doc/DocBook/ $@
815
816 tools-all: easylogo env gdb $(VERSION_FILE) $(TIMESTAMP_FILE)
817         $(MAKE) -C tools HOST_TOOLS_ALL=y
818
819 .PHONY : CHANGELOG
820 CHANGELOG:
821         git log --no-merges U-Boot-1_1_5.. | \
822         unexpand -a | sed -e 's/\s\s*$$//' > $@
823
824 include/license.h: tools/bin2header COPYING
825         cat COPYING | gzip -9 -c | ./tools/bin2header license_gzip > include/license.h
826 #########################################################################
827
828 unconfig:
829         @rm -f $(obj)include/config.h $(obj)include/config.mk \
830                 $(obj)board/*/config.tmp $(obj)board/*/*/config.tmp \
831                 $(obj)include/autoconf.mk $(obj)include/autoconf.mk.dep \
832                 $(obj)include/spl-autoconf.mk \
833                 $(obj)include/tpl-autoconf.mk
834
835 %_config::      unconfig
836         @$(MKCONFIG) -A $(@:_config=)
837
838 sinclude $(obj).boards.depend
839 $(obj).boards.depend:   boards.cfg
840         @awk '(NF && $$1 !~ /^#/) { print $$1 ": " $$1 "_config; $$(MAKE)" }' $< > $@
841
842 #
843 # Functions to generate common board directory names
844 #
845 lcname  = $(shell echo $(1) | sed -e 's/\(.*\)_config/\L\1/')
846 ucname  = $(shell echo $(1) | sed -e 's/\(.*\)_config/\U\1/')
847
848 #########################################################################
849 #########################################################################
850
851 clean:
852         @rm -f $(obj)examples/standalone/82559_eeprom                     \
853                $(obj)examples/standalone/atmel_df_pow2                    \
854                $(obj)examples/standalone/eepro100_eeprom                  \
855                $(obj)examples/standalone/hello_world                      \
856                $(obj)examples/standalone/interrupt                        \
857                $(obj)examples/standalone/mem_to_mem_idma2intr             \
858                $(obj)examples/standalone/sched                            \
859                $(obj)examples/standalone/smc911{11,x}_eeprom              \
860                $(obj)examples/standalone/test_burst                       \
861                $(obj)examples/standalone/timer
862         @rm -f $(obj)examples/api/demo{,.bin}
863         @rm -f $(obj)tools/bmp_logo        $(obj)tools/easylogo/easylogo  \
864                $(obj)tools/env/{fw_printenv,fw_setenv}                    \
865                $(obj)tools/envcrc                                         \
866                $(obj)tools/gdb/{astest,gdbcont,gdbsend}                   \
867                $(obj)tools/gen_eth_addr    $(obj)tools/img2srec           \
868                $(obj)tools/mk{env,}image   $(obj)tools/mpc86x_clk         \
869                $(obj)tools/mk{smdk5250,}spl                               \
870                $(obj)tools/mxsboot                                        \
871                $(obj)tools/ncb             $(obj)tools/ubsha1             \
872                $(obj)tools/kernel-doc/docproc                             \
873                $(obj)tools/proftool
874         @rm -f $(obj)board/cray/L1/{bootscript.c,bootscript.image}        \
875                $(obj)board/matrix_vision/*/bootscript.img                 \
876                $(obj)board/voiceblue/eeprom                               \
877                $(obj)u-boot.lds                                           \
878                $(obj)arch/blackfin/cpu/bootrom-asm-offsets.[chs]          \
879                $(obj)arch/blackfin/cpu/init.{lds,elf}
880         @rm -f $(obj)include/bmp_logo.h
881         @rm -f $(obj)include/bmp_logo_data.h
882         @rm -f $(obj)lib/asm-offsets.s
883         @rm -f $(obj)include/generated/asm-offsets.h
884         @rm -f $(obj)$(CPUDIR)/$(SOC)/asm-offsets.s
885         @rm -f $(TIMESTAMP_FILE) $(VERSION_FILE)
886         @$(MAKE) -s -C doc/DocBook/ cleandocs
887         @find $(OBJTREE) -type f \
888                 \( -name 'core' -o -name '*.bak' -o -name '*~' -o -name '*.su' \
889                 -o -name '*.o'  -o -name '*.a' -o -name '*.exe' \
890                 -o -name '*.cfgtmp' \) -print \
891                 | xargs rm -f
892
893 # Removes everything not needed for testing u-boot
894 tidy:   clean
895         @find $(OBJTREE) -type f \( -name '*.depend*' \) -print | xargs rm -f
896
897 clobber:        tidy
898         @find $(OBJTREE) -type f \( -name '*.srec' \
899                 -o -name '*.bin' -o -name u-boot.img \) \
900                 -print0 | xargs -0 rm -f
901         @rm -f $(OBJS) $(obj)*.bak $(obj)ctags $(obj)etags $(obj)TAGS \
902                 $(obj)cscope.* $(obj)*.*~
903         @rm -f $(obj)u-boot $(obj)u-boot.map $(obj)u-boot.hex $(ALL-y)
904         @rm -f $(obj)u-boot.kwb
905         @rm -f $(obj)u-boot.pbl
906         @rm -f $(obj)u-boot.imx
907         @rm -f $(obj)u-boot-with-spl.imx
908         @rm -f $(obj)u-boot-with-nand-spl.imx
909         @rm -f $(obj)u-boot.ubl
910         @rm -f $(obj)u-boot.ais
911         @rm -f $(obj)u-boot.dtb
912         @rm -f $(obj)u-boot.sb
913         @rm -f $(obj)u-boot.bd
914         @rm -f $(obj)u-boot.spr
915         @rm -f $(obj)nand_spl/{u-boot.{lds,lst},System.map}
916         @rm -f $(obj)nand_spl/{u-boot-nand_spl.lds,u-boot-spl,u-boot-spl.map}
917         @rm -f $(obj)spl/{u-boot-spl,u-boot-spl.bin,u-boot-spl.map}
918         @rm -f $(obj)spl/u-boot-spl.lds
919         @rm -f $(obj)tpl/{u-boot-tpl,u-boot-tpl.bin,u-boot-tpl.map}
920         @rm -f $(obj)tpl/u-boot-spl.lds
921         @rm -f $(obj)MLO MLO.byteswap
922         @rm -f $(obj)SPL
923         @rm -f $(obj)tools/xway-swap-bytes
924         @rm -f $(obj)arch/powerpc/cpu/mpc824x/bedbug_603e.c
925         @rm -f $(obj)arch/powerpc/cpu/mpc83xx/ddr-gen?.c
926         @rm -fr $(obj)include/asm/proc $(obj)include/asm/arch $(obj)include/asm
927         @rm -fr $(obj)include/generated
928         @[ ! -d $(obj)nand_spl ] || find $(obj)nand_spl -name "*" -type l -print | xargs rm -f
929         @rm -f $(obj)dts/*.tmp
930         @rm -f $(obj)spl/u-boot-spl{,-pad}.ais
931
932 mrproper \
933 distclean:      clobber unconfig
934 ifneq ($(OBJTREE),$(SRCTREE))
935         rm -rf $(obj)*
936 endif
937
938 backup:
939         F=`basename $(TOPDIR)` ; cd .. ; \
940         gtar --force-local -zcvf `LC_ALL=C date "+$$F-%Y-%m-%d-%T.tar.gz"` $$F
941
942 #########################################################################